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

package/dist/api/article-type.d.ts

@@ -0,0 +1,37 @@
+import type { IBaseArticleType } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+export interface ArticleTypeFetchOptions extends FetchOptions {
+    customType?: string;
+}
+/**
+ * Fetches an article type from Contentful by slug
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Article type slug to fetch
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IBaseArticleType or null if not found
+ *
+ * @example
+ * ```ts
+ * const articleType = await contentfulArticleTypeRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'blog',
+ *   {
+ *     locale: 'en-US',
+ *     cache: {
+ *       tags: ['blog-article-type'],
+ *       revalidate: 3600
+ *     },
+ *     customType: 'blog' // Optional custom type
+ *   }
+ * );
+ * ```
+ */
+export declare function contentfulArticleTypeRest(context: BaseConverterContext, config: ContentfulConfig, slug: string, options: ArticleTypeFetchOptions): Promise<CmsResponse<IBaseArticleType | null>>;
+//# sourceMappingURL=article-type.d.ts.map

package/dist/api/article-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-type.d.ts","sourceRoot":"","sources":["../../src/api/article-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAMnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE,OAAO,KAAK,EAAY,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AActF,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CA0J/C"}

package/dist/api/article-type.js

@@ -0,0 +1,140 @@
+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 an article type from Contentful by slug
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Article type slug to fetch
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IBaseArticleType or null if not found
+ *
+ * @example
+ * ```ts
+ * const articleType = await contentfulArticleTypeRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'blog',
+ *   {
+ *     locale: 'en-US',
+ *     cache: {
+ *       tags: ['blog-article-type'],
+ *       revalidate: 3600
+ *     },
+ *     customType: 'blog' // Optional custom type
+ *   }
+ * );
+ * ```
+ */
+export async function contentfulArticleTypeRest(context, config, slug, options) {
+    const client = getContentfulClient(config, options.preview);
+    // Set cache tags for this request
+    const articleTypeCacheTags = getCacheTags('articleType', slug, options?.preview);
+    const customTypeCacheTags = options?.customType
+        ? getCacheTags('customType', options.customType, options?.preview)
+        : [];
+    const requestOptions = {
+        ...options,
+        next: {
+            ...options?.next,
+            tags: [...articleTypeCacheTags, ...customTypeCacheTags],
+        },
+    };
+    const fetchFn = async () => {
+        const fetchProfile = options.fetchProfile ?? 'page';
+        const bundleCustomType = fetchProfile === 'page' && !!options?.customType;
+        const articleTypeInclude = resolveIncludeDepth('articleType', options);
+        const customTypeInclude = options.include ?? PAGE_BUNDLED_CUSTOM_TYPE_INCLUDE;
+        const listingSelect = fetchProfile === 'listing' ? getSingleEntityListingSelect('articleType') : undefined;
+        const articleTypePromise = withCmsQueryContext({ operation: operationLabel('articleType'), identifier: slug }, () => client.getEntries({
+            content_type: 'articleType',
+            'fields.slug': slug,
+            include: articleTypeInclude,
+            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: customTypeInclude,
+                locale: options?.locale,
+                limit: 1,
+            }, requestOptions))
+            : Promise.resolve(null);
+        const [articleTypeResponse, customTypeResponse] = await Promise.all([
+            articleTypePromise,
+            customTypePromise,
+        ]);
+        if (process.env.LOG_CMS) {
+            const entryCount = (articleTypeResponse.includes?.Entry?.length ?? 0) + articleTypeResponse.items.length;
+            console.debug(`[CMS] articleType fetch: include=${articleTypeInclude}, customType include=${customTypeInclude}, entries in includes=${entryCount}`);
+        }
+        const articleTypeEntry = articleTypeResponse.items[0];
+        if (!articleTypeEntry?.fields) {
+            return { data: null, errors: [] };
+        }
+        const customTypeEntry = customTypeResponse?.items[0];
+        try {
+            const assets = convertAllAssets(articleTypeResponse, context);
+            const rawAssets = convertAllRawAssets(articleTypeResponse);
+            const includes = convertAllIncludes(articleTypeResponse);
+            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.articleTypeResolver(fullContext, articleTypeEntry, 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 articleType:`, {
+                    entryId: articleTypeEntry.sys.id,
+                    slug,
+                    errors: fullContext.errors,
+                });
+            }
+            return { data: converted, errors: fullContext.errors };
+        }
+        catch (error) {
+            const entryId = articleTypeEntry?.sys.id || 'unknown';
+            const entryType = articleTypeEntry?.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=article-type.js.map

package/dist/api/article-type.js.map

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

package/dist/api/article.d.ts

@@ -0,0 +1,32 @@
+import type { IBaseArticle } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+/**
+ * Fetches an article from Contentful by slug and article type slug.
+ *
+ * @param context - Base converter context for content transformation
+ * @param config - Contentful configuration (spaceId, accessToken, environment)
+ * @param slug - Article slug to fetch
+ * @param articleTypeSlug - Article type slug (e.g., 'blog', 'news')
+ * @param options - Optional fetch options (locale, preview, caching, retry)
+ * @returns Promise resolving to article data or null if not found, with any conversion errors
+ *
+ * @example
+ * ```ts
+ * const article = await contentfulArticleRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'my-article',
+ *   'blog',
+ *   {
+ *     locale: 'en-US',
+ *     cache: { tags: ['article#my-article'], revalidate: 3600 }
+ *   }
+ * );
+ * ```
+ */
+export declare function contentfulArticleRest(context: BaseConverterContext, config: ContentfulConfig, slug: string, articleTypeSlug: string, options: FetchOptions): Promise<CmsResponse<IBaseArticle | null>>;
+//# sourceMappingURL=article.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"article.d.ts","sourceRoot":"","sources":["../../src/api/article.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG5E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAkB3C"}

package/dist/api/article.js

@@ -0,0 +1,43 @@
+import { fetchSingleEntity } from './helpers.js';
+/**
+ * Fetches an article from Contentful by slug and article type slug.
+ *
+ * @param context - Base converter context for content transformation
+ * @param config - Contentful configuration (spaceId, accessToken, environment)
+ * @param slug - Article slug to fetch
+ * @param articleTypeSlug - Article type slug (e.g., 'blog', 'news')
+ * @param options - Optional fetch options (locale, preview, caching, retry)
+ * @returns Promise resolving to article data or null if not found, with any conversion errors
+ *
+ * @example
+ * ```ts
+ * const article = await contentfulArticleRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'my-article',
+ *   'blog',
+ *   {
+ *     locale: 'en-US',
+ *     cache: { tags: ['article#my-article'], revalidate: 3600 }
+ *   }
+ * );
+ * ```
+ */
+export async function contentfulArticleRest(context, config, slug, articleTypeSlug, options) {
+    return fetchSingleEntity(context, config, {
+        contentType: 'article',
+        cacheTagType: 'article',
+        cacheTagIdentifier: slug,
+        query: {
+            'fields.slug': slug,
+            'fields.articleType.sys.contentType.sys.id': 'articleType',
+            'fields.articleType.fields.slug': articleTypeSlug,
+        },
+        resolver: (ctx, entry) => ctx.articleResolver(ctx, entry),
+        errorLogContext: { slug, articleTypeSlug },
+    }, options);
+}
+//# sourceMappingURL=article.js.map

package/dist/api/article.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.js","sourceRoot":"","sources":["../../src/api/article.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA6B,EAC7B,MAAwB,EACxB,IAAY,EACZ,eAAuB,EACvB,OAAqB;IAErB,OAAO,iBAAiB,CACtB,OAAO,EACP,MAAM,EACN;QACE,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,SAAS;QACvB,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE;YACL,aAAa,EAAE,IAAI;YACnB,2CAA2C,EAAE,aAAa;YAC1D,gCAAgC,EAAE,eAAe;SAClD;QACD,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC;QACzD,eAAe,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;KAC3C,EACD,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/api/asset.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Contentful Asset API Module
+ *
+ * Provides functions for fetching and serving Contentful assets
+ * with proper caching and Content-Disposition handling.
+ */
+import { type ContentfulAssetResponse } from '../client';
+import type { ContentfulConfig, FetchOptions } from '../types';
+/**
+ * Check if a content type can be displayed inline in the browser.
+ * Returns true for PDFs, images, videos, and common text formats.
+ *
+ * @param contentType - MIME type to check
+ * @returns true if the browser can display this content type inline
+ */
+export declare function isBrowserViewable(contentType: string): boolean;
+/**
+ * Fetch asset metadata from Contentful by asset ID.
+ * Uses the shared Contentful client with rate limiting and retry logic.
+ *
+ * @param config - Contentful configuration
+ * @param assetId - The Contentful asset ID
+ * @param options - Optional fetch options (preview, cache settings)
+ * @returns The asset response or null if not found
+ */
+export declare function contentfulAssetRest(config: ContentfulConfig, assetId: string, options: FetchOptions): Promise<ContentfulAssetResponse | null>;
+export { assetToMediaLibraryItem, buildAssetThumbUrl, clampMediaLibraryLimit, clampMediaLibraryPage, contentfulAssetsPageRest, isAnimationAsset, isMediaLibraryKind, listAnimationsPage, listMediaLibraryPage, MEDIA_LIBRARY_DEFAULT_LIMIT, MEDIA_LIBRARY_KINDS, MEDIA_LIBRARY_MAX_LIMIT, MEDIA_LIBRARY_THUMB_WIDTH, type MediaLibraryItem, type MediaLibraryKind, type MediaLibraryPage, mediaLibraryKindForAsset, mediaLibraryPageToMarkdown, } from './media-library';
+//# sourceMappingURL=asset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../src/api/asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,uBAAuB,EAAuB,MAAM,WAAW,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAc/D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO9D;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAazC;AAED,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC"}

package/dist/api/asset.js

@@ -0,0 +1,56 @@
+/**
+ * Contentful Asset API Module
+ *
+ * Provides functions for fetching and serving Contentful assets
+ * with proper caching and Content-Disposition handling.
+ */
+import { getContentfulClient } from '../client.js';
+import { getCacheTags } from '../revalidation/utils.js';
+/**
+ * Content types that browsers can display inline
+ */
+const BROWSER_VIEWABLE_TYPES = [
+    'application/pdf',
+    'text/plain',
+    'text/html',
+    'text/css',
+    'text/javascript',
+    'application/json',
+];
+/**
+ * Check if a content type can be displayed inline in the browser.
+ * Returns true for PDFs, images, videos, and common text formats.
+ *
+ * @param contentType - MIME type to check
+ * @returns true if the browser can display this content type inline
+ */
+export function isBrowserViewable(contentType) {
+    // All images and videos are viewable
+    if (contentType.startsWith('image/') || contentType.startsWith('video/')) {
+        return true;
+    }
+    return BROWSER_VIEWABLE_TYPES.includes(contentType);
+}
+/**
+ * Fetch asset metadata from Contentful by asset ID.
+ * Uses the shared Contentful client with rate limiting and retry logic.
+ *
+ * @param config - Contentful configuration
+ * @param assetId - The Contentful asset ID
+ * @param options - Optional fetch options (preview, cache settings)
+ * @returns The asset response or null if not found
+ */
+export async function contentfulAssetRest(config, assetId, options) {
+    const client = getContentfulClient(config, options.preview);
+    // Get cache tags for this asset
+    const cacheTags = getCacheTags('asset', assetId, options?.preview);
+    return client.getAsset(assetId, {
+        ...options,
+        next: {
+            revalidate: options?.next?.revalidate ?? 86400, // Default 24 hours
+            tags: [...cacheTags, ...(options?.next?.tags ?? [])],
+        },
+    });
+}
+export { assetToMediaLibraryItem, buildAssetThumbUrl, clampMediaLibraryLimit, clampMediaLibraryPage, contentfulAssetsPageRest, isAnimationAsset, isMediaLibraryKind, listAnimationsPage, listMediaLibraryPage, MEDIA_LIBRARY_DEFAULT_LIMIT, MEDIA_LIBRARY_KINDS, MEDIA_LIBRARY_MAX_LIMIT, MEDIA_LIBRARY_THUMB_WIDTH, mediaLibraryKindForAsset, mediaLibraryPageToMarkdown, } from './media-library.js';
+//# sourceMappingURL=asset.js.map

package/dist/api/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sourceRoot":"","sources":["../../src/api/asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgC,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD;;GAEG;AACH,MAAM,sBAAsB,GAAG;IAC7B,iBAAiB;IACjB,YAAY;IACZ,WAAW;IACX,UAAU;IACV,iBAAiB;IACjB,kBAAkB;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,qCAAqC;IACrC,IAAI,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,OAAe,EACf,OAAqB;IAErB,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5D,gCAAgC;IAChC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAEnE,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;QAC9B,GAAG,OAAO;QACV,IAAI,EAAE;YACJ,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,IAAI,KAAK,EAAE,mBAAmB;YACnE,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;SACrD;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EAIzB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC"}

package/dist/api/banner.d.ts

@@ -0,0 +1,8 @@
+import type { IBanner } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+/**
+ * Fetches all banners from Contentful
+ */
+export declare function contentfulBannerRest(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<CmsResponse<IBanner[] | null>>;
+//# sourceMappingURL=banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/api/banner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAI1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAY,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAStF;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CA6GxC"}

package/dist/api/banner.js

@@ -0,0 +1,96 @@
+import { getContentfulClient } from '../client.js';
+import { enrichAllAssets } from '../converters/enrichAssets.js';
+import { getCacheTags } from '../revalidation/index.js';
+import { withCmsQueryContext } from '../telemetry/queryContext.js';
+import { withRetry } from '../utils/index.js';
+import { convertAllAssets, convertAllIncludes, convertAllRawAssets, createFullConverterContext, } from './helpers.js';
+/**
+ * Fetches all banners from Contentful
+ */
+export async function contentfulBannerRest(context, config, options) {
+    const client = getContentfulClient(config, options.preview);
+    // Set cache tags for this request
+    const bannerCacheTags = getCacheTags('banner', undefined, options.preview);
+    const requestOptions = {
+        ...options,
+        next: {
+            ...options?.next,
+            tags: bannerCacheTags,
+        },
+    };
+    const allBanners = [];
+    const errors = [];
+    const pageSize = 100;
+    let skip = 0;
+    let hasMore = true;
+    const fetchFn = async () => {
+        while (hasMore) {
+            try {
+                const page = Math.floor(skip / pageSize) + 1;
+                const operation = page > 1 ? `Reading all banners (page ${page})` : 'Reading all banners';
+                const bannerResponse = await withCmsQueryContext({ operation }, () => client.getEntries({
+                    content_type: 'banner',
+                    include: 2,
+                    locale: options?.locale,
+                    limit: pageSize,
+                    skip,
+                }, requestOptions));
+                if (!bannerResponse.items.length) {
+                    hasMore = false;
+                    break;
+                }
+                const includes = convertAllIncludes(bannerResponse);
+                const assets = convertAllAssets(bannerResponse, context);
+                const rawAssets = convertAllRawAssets(bannerResponse);
+                const externalVideoEmbeds = await enrichAllAssets(assets, includes, options);
+                const fullContext = createFullConverterContext(context, includes, assets, rawAssets, externalVideoEmbeds, options);
+                for (const bannerEntry of bannerResponse.items) {
+                    if (!bannerEntry.fields)
+                        continue;
+                    try {
+                        const converted = context.bannerResolver(fullContext, bannerEntry);
+                        allBanners.push(converted);
+                    }
+                    catch (error) {
+                        const entryId = bannerEntry.sys.id;
+                        const entryType = bannerEntry.sys.contentType?.sys?.id;
+                        const errorMessage = error instanceof Error ? error.message : 'Unknown conversion error';
+                        errors.push({
+                            entryId,
+                            entryType,
+                            message: errorMessage,
+                            error,
+                        });
+                    }
+                }
+                // Log errors in production
+                if (fullContext.errors.length > 0 &&
+                    typeof process !== 'undefined' &&
+                    process.env?.NODE_ENV === 'production') {
+                    console.error(`CMS conversion errors for banner:`, {
+                        errors: fullContext.errors,
+                    });
+                }
+            }
+            catch (error) {
+                const entryId = 'unknown';
+                const entryType = 'banner';
+                const errorMessage = error instanceof Error ? error.message : 'Unknown conversion error';
+                const cmsError = {
+                    entryId,
+                    entryType,
+                    message: errorMessage,
+                    error,
+                };
+                errors.push(cmsError);
+            }
+            skip += pageSize;
+        }
+        return { data: allBanners, errors };
+    };
+    if (options.retry) {
+        return await withRetry(fetchFn, options.retry);
+    }
+    return await fetchFn();
+}
+//# sourceMappingURL=banner.js.map

package/dist/api/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/api/banner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA6B,EAC7B,MAAwB,EACxB,OAAqB;IAErB,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,kCAAkC;IAClC,MAAM,eAAe,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3E,MAAM,cAAc,GAAG;QACrB,GAAG,OAAO;QACV,IAAI,EAAE;YACJ,GAAG,OAAO,EAAE,IAAI;YAChB,IAAI,EAAE,eAAe;SACtB;KACF,CAAC;IAEF,MAAM,UAAU,GAAc,EAAE,CAAC;IACjC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC;IACrB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,OAAO,OAAO,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC;gBAE1F,MAAM,cAAc,GAAG,MAAM,mBAAmB,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,CACnE,MAAM,CAAC,UAAU,CACf;oBACE,YAAY,EAAE,QAAQ;oBACtB,OAAO,EAAE,CAAC;oBACV,MAAM,EAAE,OAAO,EAAE,MAAM;oBACvB,KAAK,EAAE,QAAQ;oBACf,IAAI;iBACL,EACD,cAAc,CACf,CACF,CAAC;gBAEF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,OAAO,GAAG,KAAK,CAAC;oBAChB,MAAM;gBACR,CAAC;gBAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,gBAAgB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACzD,MAAM,SAAS,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;gBACtD,MAAM,mBAAmB,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC7E,MAAM,WAAW,GAAG,0BAA0B,CAC5C,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,mBAAmB,EACnB,OAAO,CACR,CAAC;gBAEF,KAAK,MAAM,WAAW,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;oBAC/C,IAAI,CAAC,WAAW,CAAC,MAAM;wBAAE,SAAS;oBAClC,IAAI,CAAC;wBACH,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;wBACnE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC7B,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;wBACnC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC;wBACvD,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC;wBACtE,MAAM,CAAC,IAAI,CAAC;4BACV,OAAO;4BACP,SAAS;4BACT,OAAO,EAAE,YAAY;4BACrB,KAAK;yBACN,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,2BAA2B;gBAC3B,IACE,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBAC7B,OAAO,OAAO,KAAK,WAAW;oBAC9B,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,EACtC,CAAC;oBACD,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE;wBACjD,MAAM,EAAE,WAAW,CAAC,MAAM;qBAC3B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,SAAS,CAAC;gBAC1B,MAAM,SAAS,GAAG,QAAQ,CAAC;gBAC3B,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC;gBAEzF,MAAM,QAAQ,GAAa;oBACzB,OAAO;oBACP,SAAS;oBACT,OAAO,EAAE,YAAY;oBACrB,KAAK;iBACN,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;YACD,IAAI,IAAI,QAAQ,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC,CAAC;IAEF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,OAAO,EAAE,CAAC;AACzB,CAAC"}

package/dist/api/breadcrumb.d.ts

@@ -0,0 +1,40 @@
+import type { BaseConverterContext } from '../converters/helpers';
+import type { ContentfulConfig, FetchOptions } from '../types';
+/**
+ * Entry in the breadcrumb lookup map.
+ * Maps a normalized path (e.g. "/locations/new-york/") to title and optional override.
+ */
+export interface BreadcrumbLookupEntry {
+    title: string;
+    breadcrumbLabel?: string | null;
+}
+/**
+ * Map of normalized path (href with trailing slash) to breadcrumb label info.
+ * Used to resolve breadcrumb segment labels from URL paths.
+ */
+export type BreadcrumbLookup = Map<string, BreadcrumbLookupEntry>;
+/**
+ * Fetches all link data and builds a breadcrumb lookup map.
+ * Keys are normalized paths (e.g. "/locations/new-york/"); values are title and optional breadcrumb override.
+ *
+ * Uses force-cache with revalidate 3600. Cache invalidation is driven by the
+ * underlying link fetches (page, article, articleType, tag, tagType, person tags).
+ * Safe to call on every request; responses are cached.
+ *
+ * @param context - Converter context with urlCalculators
+ * @param config - Contentful configuration
+ * @param options - Fetch options (preview, cache, etc.)
+ * @returns Promise resolving to BreadcrumbLookup map
+ *
+ * @example
+ * ```ts
+ * const lookup = await getBreadcrumbLookup(context, config, {
+ *   preview: false,
+ *   next: { revalidate: 3600 }
+ * });
+ * const label = lookup.get('/locations/new-york/')?.breadcrumbLabel
+ *   ?? lookup.get('/locations/new-york/')?.title;
+ * ```
+ */
+export declare function getBreadcrumbLookup(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<BreadcrumbLookup>;
+//# sourceMappingURL=breadcrumb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../src/api/breadcrumb.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAU/D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAoBlE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAuB3B"}

package/dist/api/breadcrumb.js

@@ -0,0 +1,60 @@
+import { buildListingLinkCacheOptions } from '../navigation/cacheOptions.js';
+import { contentfulAllArticleLinks, contentfulAllArticleTypeLinks, contentfulAllPageLinks, contentfulAllPersonLinks, contentfulAllTagLinks, contentfulAllTagTypeLinks, } from './links.js';
+function normalizeHref(href) {
+    if (!href)
+        return '/';
+    return href.startsWith('/') ? (href.endsWith('/') ? href : `${href}/`) : `/${href}/`;
+}
+function addLinksToLookup(lookup, links) {
+    for (const link of links) {
+        const normalized = normalizeHref(link.href);
+        lookup.set(normalized, {
+            title: link.title,
+            breadcrumbLabel: link.breadcrumbTitle ?? undefined,
+        });
+    }
+}
+/**
+ * Fetches all link data and builds a breadcrumb lookup map.
+ * Keys are normalized paths (e.g. "/locations/new-york/"); values are title and optional breadcrumb override.
+ *
+ * Uses force-cache with revalidate 3600. Cache invalidation is driven by the
+ * underlying link fetches (page, article, articleType, tag, tagType, person tags).
+ * Safe to call on every request; responses are cached.
+ *
+ * @param context - Converter context with urlCalculators
+ * @param config - Contentful configuration
+ * @param options - Fetch options (preview, cache, etc.)
+ * @returns Promise resolving to BreadcrumbLookup map
+ *
+ * @example
+ * ```ts
+ * const lookup = await getBreadcrumbLookup(context, config, {
+ *   preview: false,
+ *   next: { revalidate: 3600 }
+ * });
+ * const label = lookup.get('/locations/new-york/')?.breadcrumbLabel
+ *   ?? lookup.get('/locations/new-york/')?.title;
+ * ```
+ */
+export async function getBreadcrumbLookup(context, config, options) {
+    const cacheOptions = buildListingLinkCacheOptions(options);
+    // Breadcrumbs need routable entry links — not customType or link wrappers.
+    const [pages, articles, articleTypes, tags, tagTypes, persons] = await Promise.all([
+        contentfulAllPageLinks(context, config, cacheOptions),
+        contentfulAllArticleLinks(context, config, cacheOptions),
+        contentfulAllArticleTypeLinks(context, config, cacheOptions),
+        contentfulAllTagLinks(context, config, cacheOptions),
+        contentfulAllTagTypeLinks(context, config, cacheOptions),
+        contentfulAllPersonLinks(context, config, cacheOptions),
+    ]);
+    const lookup = new Map();
+    addLinksToLookup(lookup, pages.data);
+    addLinksToLookup(lookup, articles.data);
+    addLinksToLookup(lookup, articleTypes.data);
+    addLinksToLookup(lookup, tags.data);
+    addLinksToLookup(lookup, tagTypes.data);
+    addLinksToLookup(lookup, persons.data);
+    return lookup;
+}
+//# sourceMappingURL=breadcrumb.js.map

package/dist/api/breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.js","sourceRoot":"","sources":["../../src/api/breadcrumb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAiBjB,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACtB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;AACvF,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAwB,EACxB,KAA4D;IAE5D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS;SACnD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA6B,EAC7B,MAAwB,EACxB,OAAqB;IAErB,MAAM,YAAY,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAE3D,2EAA2E;IAC3E,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjF,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QACrD,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QACxD,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QAC5D,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QACpD,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QACxD,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;KACxD,CAAC,CAAC;IAEH,MAAM,MAAM,GAAqB,IAAI,GAAG,EAAE,CAAC;IAE3C,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxC,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC;AAChB,CAAC"}