TypeScript API / @contentia/astro/loader / ContentiaCollectionsOptions
Interface: ContentiaCollectionsOptions
Extends
Properties
allowEmpty?
allowEmpty?: boolean;Return {} instead of throwing when the catalog enumerates nothing. Off by default: an empty collections export is almost always a misconfiguration, and failing loudly beats a site that silently has no content.
catalog?
catalog?: CatalogChoice;Which catalog maps a collection to a directory. Defaults to 'convention'. Ignored when repositories is given.
Inherited from
ContentiaRepositoryOptions.catalog
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
exclude?
exclude?: string[];Skip these collections.
include?
include?: string[];Only these collections. Defaults to every document collection in the catalog.
overrides?
overrides?: Record<string, CollectionOverride>;Per-collection overrides.
render?
render?: RenderOptions;Applied to every collection; a per-collection override wins.
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. Defaults to process.cwd().
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
z?
z?: ZodNamespace;The z from astro:content. Supply it to derive a schema per collection from the catalog's fields. Omit it and collections are created without a schema — content still loads, it is just not validated.