TypeScript API / @contentia/astro/loader / DocumentsLoaderOptions
Interface: DocumentsLoaderOptions
Extends
Properties
catalog?
catalog?: CatalogChoice;Which catalog maps a collection to a directory. Defaults to 'convention'. Ignored when repositories is given.
Inherited from
ContentiaRepositoryOptions.catalog
collection?
collection?: string;The Contentia collection key. Defaults to the Astro collection name.
configKey?
configKey?: string;Where the Decap config lives, for catalog: 'decap'. Defaults to 'config'.
Inherited from
ContentiaRepositoryOptions.configKey
defaultExtension?
defaultExtension?: string;File extension applied to keys without one. Defaults to 'json'.
Inherited from
ContentiaRepositoryOptions.defaultExtension
dir?
dir?: string;Directory the default filesystem repository reads, resolved relative to the Astro project root. Ignored when storage or repositories is given. Defaults to 'content'.
Inherited from
ContentiaRepositoryOptions.dir
documents?
documents?: DocumentsRepository;The documents repository to read. Highest precedence — when given, no repository is constructed and the rest of ContentiaRepositoryOptions is ignored. This is how you read from a remote Contentia server: pass a DocumentsJsonApiProxyRepository.
entry?
entry?: EntryOptions;name?
name?: string;Loader name, which is what refreshContent({ loaders }) targets. Defaults to 'contentia'.
render?
render?: RenderOptions;repositories?
repositories?: any;Bring your own repositories. Highest precedence — nothing else in this struct is read when it is set.
Inherited from
ContentiaRepositoryOptions.repositories
root?
root?: string;Astro project root, for resolving a relative dir before load runs.
select?
select?: DocumentSelectOptions;serializers?
serializers?: StorageSerializerRegistry;Serializer registry for the default filesystem repository.
Inherited from
ContentiaRepositoryOptions.serializers
storage?
storage?: StorageRepository;Provide only the storage repository; the documents and assets repositories are derived from it via Catalog. Ignored when repositories is given.
Inherited from
ContentiaRepositoryOptions.storage
sync?
sync?: SyncOptions;z?
z?: ZodNamespace;The z from astro:content.
Supplying it — together with an explicit collection and a catalog that can describe the collection's fields — lets the loader derive the collection schema from the catalog instead of you restating it here. Astro also generates entry types from it, so entry.data stays fully typed.
Omit it and the collection is unvalidated unless you pass your own schema to defineCollection.