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

package/dist/api/media-library.js

@@ -0,0 +1,315 @@
+/**
+ * CMS media library — list all space assets/entries for cms-dev inventory pages.
+ */
+import { isMediaLibraryKind, MEDIA_LIBRARY_KINDS, } from '@se-studio/core-data-types';
+import { getContentfulClient, } from '../client.js';
+export { isMediaLibraryKind, MEDIA_LIBRARY_KINDS, };
+export const MEDIA_LIBRARY_DEFAULT_LIMIT = 50;
+export const MEDIA_LIBRARY_MAX_LIMIT = 100;
+export const MEDIA_LIBRARY_THUMB_WIDTH = 320;
+const DEFAULT_ORDER = '-sys.updatedAt';
+const CACHE_TAG = 'cms-media-library';
+const DEFAULT_REVALIDATE = 300;
+/** Contentful max assets per request. */
+const ANIMATION_SCAN_PAGE_SIZE = 1000;
+/** Safety only — 100 × 1000 = 100k assets. Beyond this, set truncated. */
+const ANIMATION_SCAN_MAX_PAGES = 100;
+export function clampMediaLibraryLimit(limit) {
+    if (limit == null || Number.isNaN(limit) || limit < 1) {
+        return MEDIA_LIBRARY_DEFAULT_LIMIT;
+    }
+    return Math.min(Math.floor(limit), MEDIA_LIBRARY_MAX_LIMIT);
+}
+export function clampMediaLibraryPage(page) {
+    if (page == null || Number.isNaN(page) || page < 1) {
+        return 1;
+    }
+    return Math.floor(page);
+}
+/**
+ * True when an asset looks like a Lottie / DotLottie animation source.
+ * Non-Lottie JSON may still match application/json (shown as possible animations).
+ */
+export function isAnimationAsset(contentType, fileName) {
+    const name = (fileName ?? '').toLowerCase();
+    if (name.endsWith('.lottie'))
+        return true;
+    // Exclude npm package manifests that sometimes land in media spaces
+    if (name === 'package.json' || name.endsWith('package-lock.json')) {
+        return false;
+    }
+    const mime = (contentType ?? '').toLowerCase();
+    if (mime === 'application/json')
+        return true;
+    if (name.endsWith('.json') &&
+        (mime === '' || mime === 'text/plain' || mime.startsWith('application/'))) {
+        return true;
+    }
+    return false;
+}
+export function mediaLibraryKindForAsset(contentType, fileName) {
+    const mime = (contentType ?? '').toLowerCase();
+    if (mime.startsWith('image/'))
+        return 'images';
+    if (mime.startsWith('video/'))
+        return 'videos';
+    if (isAnimationAsset(contentType, fileName))
+        return 'animations';
+    return null;
+}
+/**
+ * Build a Contentful Images API thumbnail URL. Only for images.ctfassets.net hosts.
+ */
+export function buildAssetThumbUrl(rawUrl, width = MEDIA_LIBRARY_THUMB_WIDTH) {
+    if (!rawUrl)
+        return null;
+    const absolute = rawUrl.startsWith('//') ? `https:${rawUrl}` : rawUrl;
+    let parsed;
+    try {
+        parsed = new URL(absolute);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed.hostname.endsWith('ctfassets.net')) {
+        return absolute;
+    }
+    // Images API only applies to images.ctfassets.net
+    if (!parsed.hostname.startsWith('images.')) {
+        return null;
+    }
+    parsed.searchParams.set('w', String(width));
+    parsed.searchParams.set('h', String(width));
+    parsed.searchParams.set('fit', 'fill');
+    parsed.searchParams.set('f', 'faces');
+    parsed.searchParams.set('q', '75');
+    return parsed.toString();
+}
+function normalizeAssetUrl(url) {
+    if (!url)
+        return null;
+    return url.startsWith('//') ? `https:${url}` : url;
+}
+export function assetToMediaLibraryItem(asset, kind) {
+    const file = asset.fields?.file;
+    const contentType = file?.contentType ?? null;
+    const fileName = file?.fileName ?? null;
+    const url = normalizeAssetUrl(file?.url);
+    const width = file?.details?.image?.width ?? null;
+    const height = file?.details?.image?.height ?? null;
+    const sizeBytes = file?.details?.size ?? null;
+    return {
+        kind,
+        id: asset.sys.id,
+        title: asset.fields?.title ?? null,
+        fileName,
+        description: asset.fields?.description ?? null,
+        contentType,
+        url,
+        thumbUrl: kind === 'images' ? buildAssetThumbUrl(url) : null,
+        width,
+        height,
+        sizeBytes,
+        updatedAt: asset.sys.updatedAt ?? null,
+    };
+}
+function listFetchOptions(preview, options) {
+    // Preview drafts must not stick in the Next Data Cache for minutes without webhook tags.
+    const cache = options?.cache ?? (preview ? 'no-store' : 'force-cache');
+    return {
+        preview,
+        cache,
+        next: {
+            revalidate: options?.next?.revalidate ?? (preview ? false : DEFAULT_REVALIDATE),
+            tags: [CACHE_TAG, ...(options?.next?.tags ?? [])],
+        },
+    };
+}
+/**
+ * One page of Contentful assets (CDA/CPA `/assets`).
+ */
+export async function contentfulAssetsPageRest(config, options = {}) {
+    const preview = options.preview ?? true;
+    const client = getContentfulClient(config, preview);
+    const limit = options.limit ?? MEDIA_LIBRARY_DEFAULT_LIMIT;
+    const skip = options.skip ?? 0;
+    const query = {
+        limit,
+        skip,
+        order: options.order ?? DEFAULT_ORDER,
+    };
+    if (options.mimetypeGroup) {
+        query.mimetype_group = options.mimetypeGroup;
+    }
+    return client.getAssets(query, listFetchOptions(preview, options.fetchOptions));
+}
+function assetMapFromIncludes(includes) {
+    const map = new Map();
+    for (const asset of includes?.Asset ?? []) {
+        if (asset?.sys?.id) {
+            map.set(asset.sys.id, asset);
+        }
+    }
+    return map;
+}
+/**
+ * List one page of the media library for a given kind.
+ */
+export async function listMediaLibraryPage(config, kind, options = {}) {
+    const page = clampMediaLibraryPage(options.page);
+    const limit = clampMediaLibraryLimit(options.limit);
+    const preview = options.preview ?? true;
+    const skip = (page - 1) * limit;
+    const generatedAt = new Date().toISOString();
+    if (kind === 'external-videos') {
+        return listExternalVideosPage(config, {
+            page,
+            limit,
+            skip,
+            preview,
+            generatedAt,
+            fetchOptions: options.fetchOptions,
+        });
+    }
+    if (kind === 'images' || kind === 'videos') {
+        const mimetypeGroup = kind === 'images' ? 'image' : 'video';
+        const response = await contentfulAssetsPageRest(config, {
+            preview,
+            limit,
+            skip,
+            mimetypeGroup,
+            fetchOptions: options.fetchOptions,
+        });
+        const items = response.items.map((asset) => assetToMediaLibraryItem(asset, kind));
+        return {
+            kind,
+            page,
+            limit,
+            total: response.total,
+            items,
+            generatedAt,
+        };
+    }
+    // animations — scan all asset pages and filter (no reliable mimetype_group)
+    return listAnimationsPage(config, {
+        page,
+        limit,
+        skip,
+        preview,
+        generatedAt,
+        fetchOptions: options.fetchOptions,
+    });
+}
+/** Exported for unit tests — scan all assets, filter animations, slice page. */
+export async function listAnimationsPage(config, opts) {
+    const matched = [];
+    let scanned = 0;
+    let totalAssets = 0;
+    let truncated = false;
+    for (let p = 0; p < ANIMATION_SCAN_MAX_PAGES; p++) {
+        const response = await contentfulAssetsPageRest(config, {
+            preview: opts.preview,
+            limit: ANIMATION_SCAN_PAGE_SIZE,
+            skip: p * ANIMATION_SCAN_PAGE_SIZE,
+            fetchOptions: opts.fetchOptions,
+        });
+        totalAssets = response.total;
+        if (response.items.length === 0)
+            break;
+        for (const asset of response.items) {
+            const file = asset.fields?.file;
+            if (!isAnimationAsset(file?.contentType, file?.fileName))
+                continue;
+            matched.push(assetToMediaLibraryItem(asset, 'animations'));
+        }
+        scanned += response.items.length;
+        if (scanned >= totalAssets)
+            break;
+        // Hit safety cap without finishing the space
+        if (p === ANIMATION_SCAN_MAX_PAGES - 1 && scanned < totalAssets) {
+            truncated = true;
+        }
+    }
+    const items = matched.slice(opts.skip, opts.skip + opts.limit);
+    return {
+        kind: 'animations',
+        page: opts.page,
+        limit: opts.limit,
+        total: matched.length,
+        items,
+        generatedAt: opts.generatedAt,
+        ...(truncated ? { truncated: true } : {}),
+    };
+}
+async function listExternalVideosPage(config, opts) {
+    const client = getContentfulClient(config, opts.preview);
+    const response = await client.getEntries({
+        content_type: 'externalVideo',
+        limit: opts.limit,
+        skip: opts.skip,
+        order: DEFAULT_ORDER,
+        include: 1,
+    }, listFetchOptions(opts.preview, opts.fetchOptions));
+    const assets = assetMapFromIncludes(response.includes);
+    const items = response.items.map((entry) => {
+        const posterId = entry.fields?.posterImage?.sys?.id;
+        const poster = posterId ? assets.get(posterId) : undefined;
+        const posterFile = poster?.fields?.file;
+        const posterUrl = normalizeAssetUrl(posterFile?.url);
+        return {
+            kind: 'external-videos',
+            id: entry.sys.id,
+            title: entry.fields?.name ?? null,
+            fileName: null,
+            description: null,
+            contentType: 'externalVideo',
+            url: entry.fields?.url ?? null,
+            thumbUrl: buildAssetThumbUrl(posterUrl),
+            width: posterFile?.details?.image?.width ?? null,
+            height: posterFile?.details?.image?.height ?? null,
+            sizeBytes: null,
+            updatedAt: entry.sys.updatedAt ?? null,
+            externalUrl: entry.fields?.url ?? null,
+        };
+    });
+    return {
+        kind: 'external-videos',
+        page: opts.page,
+        limit: opts.limit,
+        total: response.total,
+        items,
+        generatedAt: opts.generatedAt,
+    };
+}
+/**
+ * Render a media library page as Markdown for agents.
+ */
+export function mediaLibraryPageToMarkdown(page) {
+    const totalPages = Math.max(1, Math.ceil(page.total / page.limit) || 1);
+    const lines = [
+        `# CMS media — ${page.kind} (page ${page.page}/${totalPages}, total ${page.total})`,
+        '',
+        `Generated: ${page.generatedAt}`,
+    ];
+    if (page.truncated) {
+        lines.push('');
+        lines.push('> **truncated:** asset scan hit the safety cap; `total` may under-count animations.');
+    }
+    lines.push('', '| id | title | fileName | description | dimensions | contentType | url |', '|----|-------|----------|-------------|------------|-------------|-----|');
+    for (const item of page.items) {
+        const dims = item.width != null && item.height != null ? `${item.width}×${item.height}` : '—';
+        lines.push(`| ${escapeMdCell(item.id)} | ${escapeMdCell(item.title)} | ${escapeMdCell(item.fileName)} | ${escapeMdCell(item.description)} | ${dims} | ${escapeMdCell(item.contentType)} | ${escapeMdCell(item.externalUrl ?? item.url)} |`);
+    }
+    if (page.items.length === 0) {
+        lines.push('');
+        lines.push('_No items on this page._');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function escapeMdCell(value) {
+    if (value == null || value === '')
+        return '—';
+    return value.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ').trim();
+}
+//# sourceMappingURL=media-library.js.map

package/dist/api/media-library.js.map

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

package/dist/api/navigation.d.ts

@@ -0,0 +1,10 @@
+import type { INavigation } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { ContentfulConfig, FetchOptions } from '../types';
+export { buildFlatNavigationCacheOptions, FLAT_NAV_CACHE_TAGS, FLAT_NAV_TIME_REVALIDATE_SECONDS, } from '../navigation/cacheOptions';
+export { withFlatNavRequestCache } from '../navigation/requestCache';
+/**
+ * Fetches flat navigation caches and assembles a navigation tree by root entry id.
+ */
+export declare function getNavigation(navigationId: string, context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<INavigation | undefined>;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/api/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/api/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAKlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D,OAAO,EACL,+BAA+B,EAC/B,mBAAmB,EACnB,gCAAgC,GACjC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CASlC"}

package/dist/api/navigation.js

@@ -0,0 +1,18 @@
+import { assembleNavigationById } from '../navigation/assembly.js';
+import { buildFlatNavigationCacheOptions } from '../navigation/cacheOptions.js';
+import { getInternalLinkIndex } from '../navigation/linkIndex.js';
+import { getNavigationRegistry } from '../navigation/registry.js';
+export { buildFlatNavigationCacheOptions, FLAT_NAV_CACHE_TAGS, FLAT_NAV_TIME_REVALIDATE_SECONDS, } from '../navigation/cacheOptions.js';
+export { withFlatNavRequestCache } from '../navigation/requestCache.js';
+/**
+ * Fetches flat navigation caches and assembles a navigation tree by root entry id.
+ */
+export async function getNavigation(navigationId, context, config, options) {
+    const cacheOptions = buildFlatNavigationCacheOptions(options);
+    const [registry, linkIndex] = await Promise.all([
+        getNavigationRegistry(context, config, cacheOptions),
+        getInternalLinkIndex(context, config, cacheOptions),
+    ]);
+    return assembleNavigationById(navigationId, registry, linkIndex);
+}
+//# sourceMappingURL=navigation.js.map

package/dist/api/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/api/navigation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EACL,+BAA+B,EAC/B,mBAAmB,EACnB,gCAAgC,GACjC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,YAAoB,EACpB,OAA6B,EAC7B,MAAwB,EACxB,OAAqB;IAErB,MAAM,YAAY,GAAG,+BAA+B,CAAC,OAAO,CAAC,CAAC;IAE9D,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9C,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QACpD,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;KACpD,CAAC,CAAC;IAEH,OAAO,sBAAsB,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AACnE,CAAC"}

package/dist/api/page.d.ts

@@ -0,0 +1,15 @@
+import type { IBasePage } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+/**
+ * Fetches a page from Contentful by slug, or a **page variant** merged onto its original page
+ * when no standalone page exists for that slug.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Page or page variant slug
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IBasePage or null if not found
+ */
+export declare function contentfulPageRest(context: BaseConverterContext, config: ContentfulConfig, slug: string, options: FetchOptions): Promise<CmsResponse<IBasePage | null>>;
+//# sourceMappingURL=page.d.ts.map

package/dist/api/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/api/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG5E;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAsCxC"}

package/dist/api/page.js

@@ -0,0 +1,39 @@
+import { buildMergedPageFromVariantEntry } from '../converters/pageVariantMerge.js';
+import { fetchSingleEntity } from './helpers.js';
+/**
+ * Fetches a page from Contentful by slug, or a **page variant** merged onto its original page
+ * when no standalone page exists for that slug.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Page or page variant slug
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IBasePage or null if not found
+ */
+export async function contentfulPageRest(context, config, slug, options) {
+    const pageResponse = await fetchSingleEntity(context, config, {
+        contentType: 'page',
+        cacheTagType: 'page',
+        cacheTagIdentifier: slug,
+        query: { 'fields.slug': slug },
+        resolver: (ctx, entry) => ctx.pageResolver(ctx, entry),
+        errorLogContext: { slug },
+    }, options);
+    if (pageResponse.data) {
+        return pageResponse;
+    }
+    const variantResponse = await fetchSingleEntity(context, config, {
+        contentType: 'pageVariant',
+        cacheTagType: 'pageVariant',
+        cacheTagIdentifier: slug,
+        query: { 'fields.slug': slug },
+        resolver: (ctx, entry) => buildMergedPageFromVariantEntry(ctx, entry),
+        errorLogContext: { slug, contentType: 'pageVariant' },
+        logOperation: 'Reading page variant',
+    }, { ...options, include: options.include ?? 8 });
+    return {
+        data: variantResponse.data,
+        errors: [...pageResponse.errors, ...variantResponse.errors],
+    };
+}
+//# sourceMappingURL=page.js.map

package/dist/api/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/api/page.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA6B,EAC7B,MAAwB,EACxB,IAAY,EACZ,OAAqB;IAErB,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAC1C,OAAO,EACP,MAAM,EACN;QACE,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,MAAM;QACpB,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9B,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC;QACtD,eAAe,EAAE,EAAE,IAAI,EAAE;KAC1B,EACD,OAAO,CACR,CAAC;IAEF,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,iBAAiB,CAC7C,OAAO,EACP,MAAM,EACN;QACE,WAAW,EAAE,aAAa;QAC1B,YAAY,EAAE,aAAa;QAC3B,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;QAC9B,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,+BAA+B,CAAC,GAAG,EAAE,KAAK,CAAC;QACrE,eAAe,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE;QACrD,YAAY,EAAE,sBAAsB;KACrC,EACD,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,CAC9C,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,eAAe,CAAC,IAAI;QAC1B,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/api/person.d.ts

@@ -0,0 +1,37 @@
+import type { BaseConverterContext } from '../converters/helpers';
+import type { IContentfulPerson } from '../converters/person';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+export interface PersonFetchOptions extends FetchOptions {
+    customType?: string;
+}
+/**
+ * Fetches a person from Contentful by slug
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Person slug to fetch
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IContentfulPerson or null if not found
+ *
+ * @example
+ * ```ts
+ * const person = await contentfulPersonRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'john-doe',
+ *   {
+ *     locale: 'en-US',
+ *     cache: {
+ *       tags: ['person#john-doe'],
+ *       revalidate: 3600
+ *     },
+ *     customType: 'team-member' // Optional custom type for templates
+ *   }
+ * );
+ * ```
+ */
+export declare function contentfulPersonRest(context: BaseConverterContext, config: ContentfulConfig, slug: string, options: PersonFetchOptions): Promise<CmsResponse<IContentfulPerson | null>>;
+//# sourceMappingURL=person.d.ts.map

package/dist/api/person.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"person.d.ts","sourceRoot":"","sources":["../../src/api/person.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,OAAO,KAAK,EAAY,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AActF,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC,CAiJhD"}

package/dist/api/person.js

@@ -0,0 +1,135 @@
+import { getContentfulClient } from '../client.js';
+import { enrichAllAssets } from '../converters/enrichAssets.js';
+import { finalizeModelIconsAndNavigation } from '../navigation/enrichModelNavigation.js';
+import { getCacheTags } from '../revalidation/utils.js';
+import { withCmsQueryContext } from '../telemetry/queryContext.js';
+import { withRetry } from '../utils/index.js';
+import { convertAllAssets, convertAllIncludes, convertAllRawAssets, createFullConverterContext, operationLabel, PAGE_BUNDLED_CUSTOM_TYPE_INCLUDE, resolveIncludeDepth, } from './helpers.js';
+import { getSingleEntityListingSelect } from './listing-fetch-params.js';
+/**
+ * Fetches a person from Contentful by slug
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Person slug to fetch
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IContentfulPerson or null if not found
+ *
+ * @example
+ * ```ts
+ * const person = await contentfulPersonRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'john-doe',
+ *   {
+ *     locale: 'en-US',
+ *     cache: {
+ *       tags: ['person#john-doe'],
+ *       revalidate: 3600
+ *     },
+ *     customType: 'team-member' // Optional custom type for templates
+ *   }
+ * );
+ * ```
+ */
+export async function contentfulPersonRest(context, config, slug, options) {
+    const client = getContentfulClient(config, options.preview);
+    // Set cache tags for this request
+    const personCacheTags = getCacheTags('person', slug, options?.preview);
+    const customTypeCacheTags = options?.customType
+        ? getCacheTags('customType', options.customType, options?.preview)
+        : [];
+    const requestOptions = {
+        ...options,
+        next: {
+            ...options?.next,
+            tags: [...personCacheTags, ...customTypeCacheTags],
+        },
+    };
+    const fetchFn = async () => {
+        const fetchProfile = options.fetchProfile ?? 'page';
+        const bundleCustomType = fetchProfile === 'page' && !!options?.customType;
+        const personInclude = resolveIncludeDepth('person', options);
+        const listingSelect = fetchProfile === 'listing' ? getSingleEntityListingSelect('person') : undefined;
+        const personPromise = withCmsQueryContext({ operation: operationLabel('person'), identifier: slug }, () => client.getEntries({
+            content_type: 'person',
+            'fields.slug': slug,
+            include: personInclude,
+            locale: options?.locale,
+            limit: 1,
+            ...(listingSelect && { select: listingSelect }),
+        }, requestOptions));
+        const customTypePromise = bundleCustomType
+            ? withCmsQueryContext({ operation: operationLabel('customType'), identifier: options.customType }, () => client.getEntries({
+                content_type: 'customType',
+                'fields.slug': options.customType,
+                include: options.include ?? PAGE_BUNDLED_CUSTOM_TYPE_INCLUDE,
+                locale: options?.locale,
+                limit: 1,
+            }, requestOptions))
+            : Promise.resolve(null);
+        const [personResponse, customTypeResponse] = await Promise.all([
+            personPromise,
+            customTypePromise,
+        ]);
+        const personEntry = personResponse.items[0];
+        if (!personEntry?.fields) {
+            return { data: null, errors: [] };
+        }
+        const customTypeEntry = customTypeResponse?.items[0];
+        try {
+            const assets = convertAllAssets(personResponse, context);
+            const rawAssets = convertAllRawAssets(personResponse);
+            const includes = convertAllIncludes(personResponse);
+            if (customTypeResponse) {
+                const customAssets = convertAllAssets(customTypeResponse, context);
+                const customRawAssets = convertAllRawAssets(customTypeResponse);
+                const customIncludes = convertAllIncludes(customTypeResponse);
+                for (const [key, value] of customAssets)
+                    assets.set(key, value);
+                for (const [key, value] of customRawAssets)
+                    rawAssets.set(key, value);
+                for (const [key, value] of customIncludes)
+                    includes.set(key, value);
+            }
+            const externalVideoEmbeds = await enrichAllAssets(assets, includes, options);
+            const fullContext = createFullConverterContext(context, includes, assets, rawAssets, externalVideoEmbeds, options);
+            let converted = context.personResolver(fullContext, personEntry, bundleCustomType ? customTypeEntry : undefined);
+            if (converted) {
+                converted = await finalizeModelIconsAndNavigation(converted, context, config, options);
+            }
+            // Log errors in production
+            if (fullContext.errors.length > 0 &&
+                typeof process !== 'undefined' &&
+                process.env?.NODE_ENV === 'production') {
+                console.error(`CMS conversion errors for person:`, {
+                    entryId: personEntry.sys.id,
+                    slug,
+                    errors: fullContext.errors,
+                });
+            }
+            return { data: converted, errors: fullContext.errors };
+        }
+        catch (error) {
+            const entryId = personEntry?.sys.id || 'unknown';
+            const entryType = personEntry?.sys.contentType?.sys?.id;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown conversion error';
+            const cmsError = {
+                entryId,
+                entryType,
+                message: errorMessage,
+                error,
+            };
+            return { data: null, errors: [cmsError] };
+        }
+    };
+    // Apply retry logic if configured
+    if (options?.retry) {
+        return await withRetry(fetchFn, options.retry);
+    }
+    return await fetchFn();
+}
+//# sourceMappingURL=person.js.map

package/dist/api/person.js.map

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