@se-studio/contentful-rest-api 0.0.0-next16-20260822103555

package/dist/api/links.js

@@ -0,0 +1,307 @@
+import { getContentfulClient } from '../client.js';
+import { baseArticleLinkConverter, baseArticleTypeLinkConverter, } from '../converters/article.js';
+import { baseCustomTypeLinkConverter } from '../converters/customType.js';
+import { basePageLinkConverter, basePageVariantLinkConverter } from '../converters/page.js';
+import { basePersonLinkConverter } from '../converters/person.js';
+import { baseTagLinkConverter } from '../converters/tag.js';
+import { baseTagTypeLinkConverter } from '../converters/tagType.js';
+import { buildListingLinkCacheOptions } from '../navigation/cacheOptions.js';
+import { withListingLinkRequestMemo } from '../navigation/requestCache.js';
+import { getCacheTags } from '../revalidation/utils.js';
+import { withRetry } from '../utils/index.js';
+import { ARTICLE_LINK_FIELDS, fetchAllLinks, getListingLinkFetchParams, mergeFetchCacheTags, } from './helpers.js';
+import { TAG_TYPE_LINK_FIELDS, TAG_TYPE_MINIMAL_FIELDS } from './listing-fetch-params.js';
+function isContentfulMissingFieldError(error, fieldId) {
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    const candidate = error;
+    return (candidate.statusCode === 422 &&
+        (candidate.message?.includes(`No field with id "${fieldId}"`) ?? false));
+}
+/**
+ * Fetches all page links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of page links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllPageLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful page links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export async function contentfulAllPageLinks(context, config, options) {
+    return withListingLinkRequestMemo('page', config, options, () => fetchAllPageLinksUncached(context, config, options));
+}
+async function fetchAllPageLinksUncached(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    const client = getContentfulClient(config, cacheOptions.preview);
+    const pageTags = getCacheTags('page', undefined, cacheOptions?.preview);
+    const variantTags = getCacheTags('pageVariant', undefined, cacheOptions?.preview);
+    const cacheTags = [...new Set([...pageTags, ...variantTags])];
+    const requestOptions = {
+        ...cacheOptions,
+        next: mergeFetchCacheTags(cacheOptions, cacheTags),
+    };
+    const { select, include } = getListingLinkFetchParams('page');
+    const pageSize = cacheOptions.pageSize ?? 100;
+    const listingOptions = requestOptions;
+    const fetchFn = async () => {
+        const [pageRes, variantRes] = await Promise.all([
+            fetchAllLinks('page', client, listingOptions, basePageLinkConverter, context, pageSize, select, include),
+            fetchAllLinks('pageVariant', client, listingOptions, basePageVariantLinkConverter, context, pageSize, select, include),
+        ]);
+        const pageSlugs = new Set(pageRes.data.map((l) => l.slug));
+        const variantLinks = variantRes.data.filter((link) => !pageSlugs.has(link.slug));
+        return {
+            data: [...pageRes.data, ...variantLinks],
+            errors: [...pageRes.errors, ...variantRes.errors],
+        };
+    };
+    if (cacheOptions?.retry) {
+        return await withRetry(fetchFn, cacheOptions.retry);
+    }
+    return await fetchFn();
+}
+/**
+ * Fetches all article links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of article links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllArticleLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful article links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export async function contentfulAllArticleLinks(context, config, options) {
+    return withListingLinkRequestMemo('article', config, options, () => fetchAllArticleLinksUncached(context, config, options));
+}
+async function fetchAllArticleLinksUncached(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    const client = getContentfulClient(config, cacheOptions.preview);
+    const cacheTags = getCacheTags('article', undefined, cacheOptions?.preview);
+    const requestOptions = {
+        ...cacheOptions,
+        next: mergeFetchCacheTags(cacheOptions, cacheTags),
+    };
+    const { select, include } = getListingLinkFetchParams('article');
+    const pageSize = cacheOptions.pageSize ?? 100;
+    const fetchFn = () => fetchAllLinks('article', client, requestOptions, baseArticleLinkConverter, context, pageSize, select, include);
+    if (cacheOptions?.retry) {
+        return await withRetry(fetchFn, cacheOptions.retry);
+    }
+    return await fetchFn();
+}
+/**
+ * Fetches all article links with body-content fields for smoke/integrity checks.
+ * Uses {@link ARTICLE_LINK_FIELDS} so `hasBodyContent` and href rules match production
+ * without a second presence query.
+ */
+export async function contentfulAllArticleLinksForIntegrity(context, config, options) {
+    const client = getContentfulClient(config, options.preview);
+    const { include } = getListingLinkFetchParams('article');
+    const pageSize = options.pageSize ?? 1000;
+    const requestOptions = {
+        cache: 'no-store',
+        skipAssetEnrichment: true,
+        ...options,
+        fetchProfile: 'listing',
+    };
+    const fetchFn = () => fetchAllLinks('article', client, requestOptions, baseArticleLinkConverter, context, pageSize, ARTICLE_LINK_FIELDS, include);
+    if (options.retry) {
+        return await withRetry(fetchFn, options.retry);
+    }
+    return await fetchFn();
+}
+/**
+ * Fetches all tag links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of tag links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllTagLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful tag links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export async function contentfulAllTagLinks(context, config, options) {
+    return withListingLinkRequestMemo('tag', config, options, () => fetchAllTagLinksUncached(context, config, options));
+}
+async function fetchAllTagLinksUncached(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    const client = getContentfulClient(config, cacheOptions.preview);
+    const cacheTags = getCacheTags('tag', undefined, cacheOptions?.preview);
+    const requestOptions = {
+        ...cacheOptions,
+        next: mergeFetchCacheTags(cacheOptions, cacheTags),
+    };
+    const { select, include } = getListingLinkFetchParams('tag');
+    const pageSize = cacheOptions.pageSize ?? 100;
+    const fetchFn = () => fetchAllLinks('tag', client, requestOptions, baseTagLinkConverter, context, pageSize, select, include);
+    if (cacheOptions?.retry) {
+        return await withRetry(fetchFn, cacheOptions.retry);
+    }
+    return await fetchFn();
+}
+/**
+ * Fetches all person links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of person links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllPersonLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful person links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export async function contentfulAllPersonLinks(context, config, options) {
+    return withListingLinkRequestMemo('person', config, options, () => fetchAllPersonLinksUncached(context, config, options));
+}
+async function fetchAllPersonLinksUncached(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    const client = getContentfulClient(config, cacheOptions.preview);
+    const cacheTags = getCacheTags('person', undefined, cacheOptions?.preview);
+    const requestOptions = {
+        ...cacheOptions,
+        next: mergeFetchCacheTags(cacheOptions, cacheTags),
+    };
+    const { select, include } = getListingLinkFetchParams('person');
+    const pageSize = cacheOptions.pageSize ?? 100;
+    const fetchFn = () => fetchAllLinks('person', client, requestOptions, basePersonLinkConverter, context, pageSize, select, include);
+    if (cacheOptions?.retry) {
+        return await withRetry(fetchFn, cacheOptions.retry);
+    }
+    return await fetchFn();
+}
+/**
+ * Fetches all article type links from Contentful for static params generation.
+ * Includes lastModified metadata from sys.updatedAt for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of article type links (with metadata) and any errors
+ *
+ * @example
+ * ```ts
+ * const response = await contentfulAllArticleTypeLinks(
+ *   context,
+ *   config,
+ *   { preview: false }
+ * );
+ * console.log(response.data); // successful article type links with lastModified
+ * console.log(response.errors); // any conversion errors
+ * ```
+ */
+export async function contentfulAllArticleTypeLinks(context, config, options) {
+    return withListingLinkRequestMemo('articleType', config, options, () => fetchAllArticleTypeLinksUncached(context, config, options));
+}
+async function fetchAllArticleTypeLinksUncached(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    const client = getContentfulClient(config, cacheOptions.preview);
+    const cacheTags = getCacheTags('articleType', undefined, cacheOptions?.preview);
+    const requestOptions = {
+        ...cacheOptions,
+        next: mergeFetchCacheTags(cacheOptions, cacheTags),
+    };
+    const { select, include } = getListingLinkFetchParams('articleType');
+    const pageSize = cacheOptions.pageSize ?? 100;
+    const fetchFn = () => fetchAllLinks('articleType', client, requestOptions, baseArticleTypeLinkConverter, context, pageSize, select, include);
+    if (cacheOptions?.retry) {
+        return await withRetry(fetchFn, cacheOptions.retry);
+    }
+    return await fetchFn();
+}
+/**
+ * Fetches all custom type links from Contentful for static params generation.
+ */
+export async function contentfulAllCustomTypeLinks(context, config, options) {
+    return withListingLinkRequestMemo('customType', config, options, () => fetchAllCustomTypeLinksUncached(context, config, options));
+}
+async function fetchAllCustomTypeLinksUncached(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    const client = getContentfulClient(config, cacheOptions.preview);
+    const cacheTags = getCacheTags('customType', undefined, cacheOptions?.preview);
+    const requestOptions = {
+        ...cacheOptions,
+        next: mergeFetchCacheTags(cacheOptions, cacheTags),
+    };
+    const { select, include } = getListingLinkFetchParams('customType');
+    const pageSize = cacheOptions.pageSize ?? 100;
+    const fetchFn = () => fetchAllLinks('customType', client, requestOptions, baseCustomTypeLinkConverter, context, pageSize, select, include);
+    if (cacheOptions?.retry) {
+        return await withRetry(fetchFn, cacheOptions.retry);
+    }
+    return await fetchFn();
+}
+/**
+ * Fetches all tag type links from Contentful for static params generation.
+ */
+export async function contentfulAllTagTypeLinks(context, config, options) {
+    return withListingLinkRequestMemo('tagType', config, options, () => fetchAllTagTypeLinksUncached(context, config, options));
+}
+async function fetchAllTagTypeLinksUncached(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    const client = getContentfulClient(config, cacheOptions.preview);
+    const cacheTags = getCacheTags('tagType', undefined, cacheOptions?.preview);
+    const requestOptions = {
+        ...cacheOptions,
+        next: mergeFetchCacheTags(cacheOptions, cacheTags),
+    };
+    const { include } = getListingLinkFetchParams('tagType');
+    const pageSize = cacheOptions.pageSize ?? 100;
+    const fetchWithSelect = (select) => fetchAllLinks('tagType', client, requestOptions, baseTagTypeLinkConverter, context, pageSize, select, include);
+    const fetchFn = async () => {
+        try {
+            return await fetchWithSelect(TAG_TYPE_LINK_FIELDS);
+        }
+        catch (error) {
+            if (isContentfulMissingFieldError(error, 'slug')) {
+                return await fetchWithSelect(TAG_TYPE_MINIMAL_FIELDS);
+            }
+            throw error;
+        }
+    };
+    if (cacheOptions?.retry) {
+        return await withRetry(fetchFn, cacheOptions.retry);
+    }
+    return await fetchFn();
+}
+//# sourceMappingURL=links.js.map

package/dist/api/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/api/links.ts"],"names":[],"mappings":"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"}

package/dist/api/listing-fetch-params.d.ts

@@ -0,0 +1,70 @@
+import type { CmsFetchProfile, FetchOptions, NavigationResolution } from '../types';
+/**
+ * Golden listing field selects for bulk link/index fetches (`fetchProfile: 'listing'`).
+ *
+ * These lists match the core Contentful model in this repo (`Base*Skeleton` types). Consumer
+ * spaces that omit optional fields will 422 when a select requests a missing field — trim fields
+ * per content type in the consumer, or omit `select` for registry-style flat fetches.
+ *
+ * | Content type | Constant | Notes |
+ * |--------------|----------|-------|
+ * | page | PAGE_LINK_FIELDS | Includes tags for article filters |
+ * | article | ARTICLE_LISTING_FIELDS | Light article rows; not full body |
+ * | articleType | ARTICLE_TYPE_LINK_FIELDS | |
+ * | tag | TAG_LINK_FIELDS | include≥2 resolves tagType slug for filters |
+ * | tag (single-entity listing) | TAG_LISTING_FIELDS | Extends TAG_LINK_FIELDS with description; no fields.title |
+ * | tagType | TAG_TYPE_LINK_FIELDS | Falls back to TAG_TYPE_MINIMAL_FIELDS when slug absent |
+ * | person | PERSON_LINK_FIELDS | |
+ * | customType | CUSTOM_TYPE_LINK_FIELDS | Uses indexPageName not cmsLabel |
+ *
+ * Flat navigation registry fetches do **not** use these selects — they load full entries so each
+ * space returns whatever fields its model defines.
+ */
+/** Contentful content types used for include-depth defaults and field selects. */
+export type CmsContentType = 'page' | 'article' | 'articleType' | 'tag' | 'tagType' | 'person' | 'customType';
+export interface ConverterResolutionScope {
+    resolveNavigation: boolean;
+    resolveContents: boolean;
+}
+export declare const PAGE_RESOLUTION_SCOPE: ConverterResolutionScope;
+export declare const LISTING_RESOLUTION_SCOPE: ConverterResolutionScope;
+/** Page body + template without bundled nav tree walks (flat nav assembled post-convert). */
+export declare const PAGE_CONTENT_SCOPE: ConverterResolutionScope;
+export declare function getResolutionScope(profile?: CmsFetchProfile, navigationResolution?: NavigationResolution): ConverterResolutionScope;
+export declare function getResolutionScopeFromOptions(options: Pick<FetchOptions, 'fetchProfile' | 'navigationResolution'>): ConverterResolutionScope;
+/** Bundled customType parallel fetch uses a lower include when page profile (template inheritance). */
+export declare const PAGE_BUNDLED_CUSTOM_TYPE_INCLUDE = 5;
+/**
+ * Resolve include depth: explicit options.include wins, then project override (caller), then profile default.
+ */
+export declare function getDefaultInclude(contentType: CmsContentType, profile?: CmsFetchProfile): number;
+export declare function resolveIncludeDepth(contentType: CmsContentType, options: {
+    include?: number;
+    fetchProfile?: CmsFetchProfile;
+}, projectOverride?: number): number;
+export declare const PAGE_LINK_FIELDS = "sys,fields.cmsLabel,fields.title,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.tags";
+export declare const ARTICLE_LISTING_FIELDS = "sys,fields.cmsLabel,fields.title,fields.subtitle,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.tags,fields.articleType,fields.date,fields.author,fields.authors,fields.externalLink,fields.download,fields.visuals,fields.description,fields.summary,fields.icon";
+/** @deprecated Full article link fields including body content trees. Bulk fetches use ARTICLE_LISTING_FIELDS. */
+export declare const ARTICLE_LINK_FIELDS = "sys,fields.cmsLabel,fields.title,fields.subtitle,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.tags,fields.articleType,fields.date,fields.author,fields.authors,fields.externalLink,fields.download,fields.visuals,fields.description,fields.summary,fields.icon,fields.topContent,fields.content,fields.bottomContent";
+export declare const ARTICLE_TYPE_LINK_FIELDS = "sys,fields.name,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden";
+export declare const TAG_LINK_FIELDS = "sys,fields.cmsLabel,fields.name,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.show,fields.tagType";
+export declare const PERSON_LINK_FIELDS = "sys,fields.name,fields.slug,fields.media,fields.bio,fields.jobTitle,fields.phoneNumber,fields.emailAddress,fields.location,fields.linkedIn,fields.twitter,fields.website,fields.quote,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden";
+export declare const CUSTOM_TYPE_LINK_FIELDS = "sys,fields.name,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.indexPageName";
+/** Fields present on every tagType schema (see BaseTagTypeSkeleton). */
+export declare const TAG_TYPE_MINIMAL_FIELDS = "sys,fields.name,fields.show";
+/** Golden schema: includes slug. Spaces without slug fall back to {@link TAG_TYPE_MINIMAL_FIELDS}. */
+export declare const TAG_TYPE_LINK_FIELDS = "sys,fields.name,fields.slug,fields.show";
+/** Scalar fields for listing-profile single-entity fetches (metadata / composite routes). */
+export declare const TAG_LISTING_FIELDS = "sys,fields.cmsLabel,fields.name,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.show,fields.tagType,fields.description";
+export declare const ARTICLE_TYPE_LISTING_FIELDS = "sys,fields.name,fields.slug,fields.indexPageName,fields.indexPageDescription,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden";
+export declare const CUSTOM_TYPE_LISTING_FIELDS = "sys,fields.name,fields.slug,fields.indexPageName,fields.indexPageDescription,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden";
+export declare const TAG_TYPE_LISTING_FIELDS = "sys,fields.name,fields.show";
+export declare const PAGE_LISTING_FIELDS = "sys,fields.cmsLabel,fields.title,fields.slug,fields.description,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden";
+export declare const ARTICLE_LISTING_SINGLE_FIELDS = "sys,fields.cmsLabel,fields.title,fields.subtitle,fields.slug,fields.description,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.articleType,fields.date,fields.author,fields.authors,fields.icon";
+export declare const PERSON_LISTING_FIELDS = "sys,fields.name,fields.slug,fields.description,fields.jobTitle,fields.media,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden";
+export declare function getListingLinkFetchParams(contentType: CmsContentType): {
+    select: string;
+    include: number;
+};
+export declare function getSingleEntityListingSelect(contentType: CmsContentType): string | undefined;
+//# sourceMappingURL=listing-fetch-params.d.ts.map

package/dist/api/listing-fetch-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-fetch-params.d.ts","sourceRoot":"","sources":["../../src/api/listing-fetch-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,kFAAkF;AAClF,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,aAAa,GACb,KAAK,GACL,SAAS,GACT,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,qBAAqB,EAAE,wBAGnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,wBAGtC,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,EAAE,wBAGhC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,eAAwB,EACjC,oBAAoB,GAAE,oBAAgC,GACrD,wBAAwB,CAQ1B;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,sBAAsB,CAAC,GACnE,wBAAwB,CAK1B;AAsBD,uGAAuG;AACvG,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,cAAc,EAC3B,OAAO,GAAE,eAAwB,GAChC,MAAM,CAGR;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,eAAe,CAAA;CAAE,EAC7D,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAQR;AAED,eAAO,MAAM,gBAAgB,gLACkJ,CAAC;AAEhL,eAAO,MAAM,sBAAsB,6VACyT,CAAC;AAE7V,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,mZAAoF,CAAC;AAErH,eAAO,MAAM,wBAAwB,mJAC6G,CAAC;AAEnJ,eAAO,MAAM,eAAe,8LACiK,CAAC;AAE9L,eAAO,MAAM,kBAAkB,iQACiO,CAAC;AAEjQ,eAAO,MAAM,uBAAuB,wKACmI,CAAC;AAExK,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAErE,sGAAsG;AACtG,eAAO,MAAM,oBAAoB,4CAA4C,CAAC;AAE9E,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,iNAA0C,CAAC;AAE1E,eAAO,MAAM,2BAA2B,6KACoI,CAAC;AAE7K,eAAO,MAAM,0BAA0B,6KACqI,CAAC;AAE7K,eAAO,MAAM,uBAAuB,gCAA0B,CAAC;AAE/D,eAAO,MAAM,mBAAmB,gKAC+H,CAAC;AAEhK,eAAO,MAAM,6BAA6B,wPAC6M,CAAC;AAExP,eAAO,MAAM,qBAAqB,uJACoH,CAAC;AAEvJ,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,cAAc,GAAG;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAqBA;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAmB5F"}

package/dist/api/listing-fetch-params.js

@@ -0,0 +1,124 @@
+export const PAGE_RESOLUTION_SCOPE = {
+    resolveNavigation: true,
+    resolveContents: true,
+};
+export const LISTING_RESOLUTION_SCOPE = {
+    resolveNavigation: false,
+    resolveContents: false,
+};
+/** Page body + template without bundled nav tree walks (flat nav assembled post-convert). */
+export const PAGE_CONTENT_SCOPE = {
+    resolveNavigation: false,
+    resolveContents: true,
+};
+export function getResolutionScope(profile = 'page', navigationResolution = 'bundled') {
+    if (profile === 'listing') {
+        return LISTING_RESOLUTION_SCOPE;
+    }
+    if (navigationResolution === 'flat') {
+        return PAGE_CONTENT_SCOPE;
+    }
+    return PAGE_RESOLUTION_SCOPE;
+}
+export function getResolutionScopeFromOptions(options) {
+    return getResolutionScope(options.fetchProfile ?? 'page', options.navigationResolution ?? 'bundled');
+}
+const PAGE_DEFAULT_INCLUDES = {
+    page: 7,
+    article: 8,
+    articleType: 7,
+    tag: 3,
+    tagType: 5,
+    person: 6,
+    customType: 6,
+};
+const LISTING_DEFAULT_INCLUDES = {
+    page: 1,
+    article: 2,
+    articleType: 1,
+    tag: 2,
+    tagType: 1,
+    person: 2,
+    customType: 1,
+};
+/** Bundled customType parallel fetch uses a lower include when page profile (template inheritance). */
+export const PAGE_BUNDLED_CUSTOM_TYPE_INCLUDE = 5;
+/**
+ * Resolve include depth: explicit options.include wins, then project override (caller), then profile default.
+ */
+export function getDefaultInclude(contentType, profile = 'page') {
+    const table = profile === 'listing' ? LISTING_DEFAULT_INCLUDES : PAGE_DEFAULT_INCLUDES;
+    return table[contentType];
+}
+export function resolveIncludeDepth(contentType, options, projectOverride) {
+    if (options.include !== undefined) {
+        return options.include;
+    }
+    if (projectOverride !== undefined) {
+        return projectOverride;
+    }
+    return getDefaultInclude(contentType, options.fetchProfile ?? 'page');
+}
+export const PAGE_LINK_FIELDS = 'sys,fields.cmsLabel,fields.title,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.tags';
+export const ARTICLE_LISTING_FIELDS = 'sys,fields.cmsLabel,fields.title,fields.subtitle,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.tags,fields.articleType,fields.date,fields.author,fields.authors,fields.externalLink,fields.download,fields.visuals,fields.description,fields.summary,fields.icon';
+/** @deprecated Full article link fields including body content trees. Bulk fetches use ARTICLE_LISTING_FIELDS. */
+export const ARTICLE_LINK_FIELDS = `${ARTICLE_LISTING_FIELDS},fields.topContent,fields.content,fields.bottomContent`;
+export const ARTICLE_TYPE_LINK_FIELDS = 'sys,fields.name,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden';
+export const TAG_LINK_FIELDS = 'sys,fields.cmsLabel,fields.name,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.show,fields.tagType';
+export const PERSON_LINK_FIELDS = 'sys,fields.name,fields.slug,fields.media,fields.bio,fields.jobTitle,fields.phoneNumber,fields.emailAddress,fields.location,fields.linkedIn,fields.twitter,fields.website,fields.quote,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden';
+export const CUSTOM_TYPE_LINK_FIELDS = 'sys,fields.name,fields.slug,fields.breadcrumbTitle,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.indexPageName';
+/** Fields present on every tagType schema (see BaseTagTypeSkeleton). */
+export const TAG_TYPE_MINIMAL_FIELDS = 'sys,fields.name,fields.show';
+/** Golden schema: includes slug. Spaces without slug fall back to {@link TAG_TYPE_MINIMAL_FIELDS}. */
+export const TAG_TYPE_LINK_FIELDS = 'sys,fields.name,fields.slug,fields.show';
+/** Scalar fields for listing-profile single-entity fetches (metadata / composite routes). */
+export const TAG_LISTING_FIELDS = `${TAG_LINK_FIELDS},fields.description`;
+export const ARTICLE_TYPE_LISTING_FIELDS = 'sys,fields.name,fields.slug,fields.indexPageName,fields.indexPageDescription,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden';
+export const CUSTOM_TYPE_LISTING_FIELDS = 'sys,fields.name,fields.slug,fields.indexPageName,fields.indexPageDescription,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden';
+export const TAG_TYPE_LISTING_FIELDS = TAG_TYPE_MINIMAL_FIELDS;
+export const PAGE_LISTING_FIELDS = 'sys,fields.cmsLabel,fields.title,fields.slug,fields.description,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden';
+export const ARTICLE_LISTING_SINGLE_FIELDS = 'sys,fields.cmsLabel,fields.title,fields.subtitle,fields.slug,fields.description,fields.featuredImage,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden,fields.articleType,fields.date,fields.author,fields.authors,fields.icon';
+export const PERSON_LISTING_FIELDS = 'sys,fields.name,fields.slug,fields.description,fields.jobTitle,fields.media,fields.backgroundColour,fields.textColour,fields.indexed,fields.hidden';
+export function getListingLinkFetchParams(contentType) {
+    switch (contentType) {
+        case 'page':
+            return { select: PAGE_LINK_FIELDS, include: LISTING_DEFAULT_INCLUDES.page };
+        case 'article':
+            return { select: ARTICLE_LISTING_FIELDS, include: LISTING_DEFAULT_INCLUDES.article };
+        case 'articleType':
+            return { select: ARTICLE_TYPE_LINK_FIELDS, include: LISTING_DEFAULT_INCLUDES.articleType };
+        case 'tag':
+            return { select: TAG_LINK_FIELDS, include: LISTING_DEFAULT_INCLUDES.tag };
+        case 'person':
+            return { select: PERSON_LINK_FIELDS, include: LISTING_DEFAULT_INCLUDES.person };
+        case 'customType':
+            return { select: CUSTOM_TYPE_LINK_FIELDS, include: LISTING_DEFAULT_INCLUDES.customType };
+        case 'tagType':
+            return { select: TAG_TYPE_LINK_FIELDS, include: LISTING_DEFAULT_INCLUDES.tagType };
+        default: {
+            const _exhaustive = contentType;
+            return _exhaustive;
+        }
+    }
+}
+export function getSingleEntityListingSelect(contentType) {
+    switch (contentType) {
+        case 'tag':
+            return TAG_LISTING_FIELDS;
+        case 'articleType':
+            return ARTICLE_TYPE_LISTING_FIELDS;
+        case 'customType':
+            return CUSTOM_TYPE_LISTING_FIELDS;
+        case 'tagType':
+            return TAG_TYPE_LISTING_FIELDS;
+        case 'page':
+            return PAGE_LISTING_FIELDS;
+        case 'article':
+            return ARTICLE_LISTING_SINGLE_FIELDS;
+        case 'person':
+            return PERSON_LISTING_FIELDS;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=listing-fetch-params.js.map

package/dist/api/listing-fetch-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-fetch-params.js","sourceRoot":"","sources":["../../src/api/listing-fetch-params.ts"],"names":[],"mappings":"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"}

package/dist/api/media-library.d.ts

@@ -0,0 +1,59 @@
+/**
+ * CMS media library — list all space assets/entries for cms-dev inventory pages.
+ */
+import { isMediaLibraryKind, MEDIA_LIBRARY_KINDS, type MediaLibraryItem, type MediaLibraryKind, type MediaLibraryPage } from '@se-studio/core-data-types';
+import { type ContentfulAssetResponse, type ContentfulResponse } from '../client';
+import type { ContentfulConfig, FetchOptions } from '../types';
+export { isMediaLibraryKind, MEDIA_LIBRARY_KINDS, type MediaLibraryItem, type MediaLibraryKind, type MediaLibraryPage, };
+export declare const MEDIA_LIBRARY_DEFAULT_LIMIT = 50;
+export declare const MEDIA_LIBRARY_MAX_LIMIT = 100;
+export declare const MEDIA_LIBRARY_THUMB_WIDTH = 320;
+export declare function clampMediaLibraryLimit(limit: number | undefined): number;
+export declare function clampMediaLibraryPage(page: number | undefined): number;
+/**
+ * True when an asset looks like a Lottie / DotLottie animation source.
+ * Non-Lottie JSON may still match application/json (shown as possible animations).
+ */
+export declare function isAnimationAsset(contentType: string | null | undefined, fileName: string | null | undefined): boolean;
+export declare function mediaLibraryKindForAsset(contentType: string | null | undefined, fileName: string | null | undefined): Exclude<MediaLibraryKind, 'external-videos'> | null;
+/**
+ * Build a Contentful Images API thumbnail URL. Only for images.ctfassets.net hosts.
+ */
+export declare function buildAssetThumbUrl(rawUrl: string | null | undefined, width?: number): string | null;
+export declare function assetToMediaLibraryItem(asset: ContentfulAssetResponse, kind: Exclude<MediaLibraryKind, 'external-videos'>): MediaLibraryItem;
+export type ContentfulAssetsPageOptions = {
+    preview?: boolean;
+    limit?: number;
+    skip?: number;
+    /** Contentful mimetype_group: image | video | … */
+    mimetypeGroup?: string;
+    order?: string;
+    fetchOptions?: Partial<FetchOptions>;
+};
+/**
+ * One page of Contentful assets (CDA/CPA `/assets`).
+ */
+export declare function contentfulAssetsPageRest(config: ContentfulConfig, options?: ContentfulAssetsPageOptions): Promise<ContentfulResponse<ContentfulAssetResponse>>;
+/**
+ * List one page of the media library for a given kind.
+ */
+export declare function listMediaLibraryPage(config: ContentfulConfig, kind: MediaLibraryKind, options?: {
+    page?: number;
+    limit?: number;
+    preview?: boolean;
+    fetchOptions?: Partial<FetchOptions>;
+}): Promise<MediaLibraryPage>;
+/** Exported for unit tests — scan all assets, filter animations, slice page. */
+export declare function listAnimationsPage(config: ContentfulConfig, opts: {
+    page: number;
+    limit: number;
+    skip: number;
+    preview: boolean;
+    generatedAt: string;
+    fetchOptions?: Partial<FetchOptions>;
+}): Promise<MediaLibraryPage>;
+/**
+ * Render a media library page as Markdown for agents.
+ */
+export declare function mediaLibraryPageToMarkdown(page: MediaLibraryPage): string;
+//# sourceMappingURL=media-library.d.ts.map

package/dist/api/media-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.d.ts","sourceRoot":"","sources":["../../src/api/media-library.ts"],"names":[],"mappings":"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"}