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

package/dist/api/sitemap.js

@@ -0,0 +1,201 @@
+import { contentfulAllArticleLinks, contentfulAllArticleTypeLinks, contentfulAllPageLinks, contentfulAllPersonLinks, contentfulAllTagLinks, } from './links.js';
+// ============================================================================
+// Sitemap Entry Helpers
+// ============================================================================
+/**
+ * Helper function to convert internal links to sitemap entries.
+ * Filters to only include indexed and non-hidden entries.
+ *
+ * The .href values already incorporate the project's UrlCalculators (called during link conversion).
+ *
+ * @param links - Array of internal links with metadata
+ * @param sitemapConfig - Configuration for priority and change frequency
+ * @returns Array of sitemap entries
+ */
+function linksToSitemapEntries(links, sitemapConfig) {
+    return links
+        .filter((link) => link.indexed !== false && link.hidden !== true && link.href)
+        .map((link) => ({
+        url: link.href,
+        lastModified: link.lastModified,
+        changeFrequency: sitemapConfig?.changeFrequency,
+        priority: sitemapConfig?.priority,
+    }));
+}
+// ============================================================================
+// Sitemap Entry Fetchers
+// ============================================================================
+/**
+ * Fetches all page sitemap entries from Contentful.
+ * Only includes pages that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ *
+ * @example
+ * ```ts
+ * const { data: entries } = await contentfulPageSitemapEntries(
+ *   context,
+ *   config,
+ *   { priority: 0.8, changeFrequency: 'weekly' },
+ *   { next: { revalidate: 3600 } }
+ * );
+ * ```
+ */
+export async function contentfulPageSitemapEntries(context, config, sitemapConfig, options) {
+    const response = await contentfulAllPageLinks(context, config, options);
+    return {
+        data: linksToSitemapEntries(response.data, sitemapConfig),
+        errors: response.errors,
+    };
+}
+/**
+ * Fetches all article sitemap entries from Contentful.
+ * Only includes articles that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ *
+ * @example
+ * ```ts
+ * const { data: entries } = await contentfulArticleSitemapEntries(
+ *   context,
+ *   config,
+ *   { priority: 0.6, changeFrequency: 'monthly' },
+ *   { next: { revalidate: 3600 } }
+ * );
+ * ```
+ */
+export async function contentfulArticleSitemapEntries(context, config, sitemapConfig, options) {
+    const response = await contentfulAllArticleLinks(context, config, options);
+    return {
+        data: linksToSitemapEntries(response.data, sitemapConfig),
+        errors: response.errors,
+    };
+}
+/**
+ * Fetches all article type sitemap entries from Contentful.
+ * Only includes article types that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ */
+export async function contentfulArticleTypeSitemapEntries(context, config, sitemapConfig, options) {
+    const response = await contentfulAllArticleTypeLinks(context, config, options);
+    return {
+        data: linksToSitemapEntries(response.data, sitemapConfig),
+        errors: response.errors,
+    };
+}
+/**
+ * Fetches all tag sitemap entries from Contentful.
+ * Only includes tags that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ */
+export async function contentfulTagSitemapEntries(context, config, sitemapConfig, options) {
+    const response = await contentfulAllTagLinks(context, config, options);
+    return {
+        data: linksToSitemapEntries(response.data, sitemapConfig),
+        errors: response.errors,
+    };
+}
+/**
+ * Fetches all person sitemap entries from Contentful.
+ * Only includes people that are indexed and not hidden.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Optional sitemap configuration (priority, changeFrequency)
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with array of sitemap entries
+ */
+export async function contentfulPersonSitemapEntries(context, config, sitemapConfig, options) {
+    const response = await contentfulAllPersonLinks(context, config, options);
+    return {
+        data: linksToSitemapEntries(response.data, sitemapConfig),
+        errors: response.errors,
+    };
+}
+// ============================================================================
+// Sitemap Registry Functions
+// ============================================================================
+/**
+ * Collects sitemap entries from multiple providers.
+ * This allows projects to register custom content types for sitemap generation.
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param sitemapConfig - Configuration with array of provider functions
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to CmsResponse with all sitemap entries combined
+ *
+ * @example
+ * ```ts
+ * const { data: entries, errors } = await getAllSitemapEntries(
+ *   context,
+ *   config,
+ *   {
+ *     providers: [
+ *       (ctx, cfg, opts) => contentfulPageSitemapEntries(ctx, cfg, { priority: 0.8 }, opts),
+ *       (ctx, cfg, opts) => contentfulArticleSitemapEntries(ctx, cfg, { priority: 0.6 }, opts),
+ *       // Custom content type provider
+ *       async (ctx, cfg, opts) => {
+ *         const links = await fetchCustomContentLinks(ctx, cfg, opts);
+ *         return { data: links.map(l => ({ url: l.href, lastModified: l.lastModified })), errors: [] };
+ *       },
+ *     ],
+ *   },
+ *   { next: { revalidate: 3600 } }
+ * );
+ * ```
+ */
+export async function getAllSitemapEntries(context, config, sitemapConfig, options) {
+    const allEntries = [];
+    const allErrors = [];
+    // Fetch from all providers in parallel for better performance
+    const results = await Promise.all(sitemapConfig.providers.map((provider) => provider(context, config, options)));
+    // Combine all results
+    for (const result of results) {
+        allEntries.push(...result.data);
+        allErrors.push(...result.errors);
+    }
+    return { data: allEntries, errors: allErrors };
+}
+/**
+ * Creates a sitemap entry provider with pre-configured options.
+ * Useful for creating providers with specific priority and changeFrequency settings.
+ *
+ * @param fetcher - The sitemap entry fetcher function to wrap
+ * @param sitemapConfig - Configuration for priority and change frequency
+ * @returns A sitemap entry provider function
+ *
+ * @example
+ * ```ts
+ * const pageProvider = createSitemapProvider(
+ *   contentfulPageSitemapEntries,
+ *   { priority: 0.8, changeFrequency: 'weekly' }
+ * );
+ *
+ * const { data: entries } = await getAllSitemapEntries(context, config, {
+ *   providers: [pageProvider, articleProvider],
+ * });
+ * ```
+ */
+export function createSitemapProvider(fetcher, sitemapConfig) {
+    return (context, config, options) => fetcher(context, config, sitemapConfig, options);
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/api/sitemap.js.map

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

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

@@ -0,0 +1,32 @@
+import type { IBaseTagType } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+export interface TagTypeFetchOptions extends FetchOptions {
+    customType?: string;
+}
+/**
+ * Fetches a tag type from Contentful by slug
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Tag type slug to fetch
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IBaseTagType or null if not found
+ *
+ * @example
+ * ```ts
+ * const tagType = await contentfulTagTypeRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'category',
+ *   {
+ *     customType: 'topics',
+ *   }
+ * );
+ * ```
+ */
+export declare function contentfulTagTypeRest(context: BaseConverterContext, config: ContentfulConfig, slug: string, options: TagTypeFetchOptions): Promise<CmsResponse<IBaseTagType | null>>;
+//# sourceMappingURL=tag-type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag-type.d.ts","sourceRoot":"","sources":["../../src/api/tag-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAY,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AActF,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CA0I3C"}

package/dist/api/tag-type.js

@@ -0,0 +1,123 @@
+import { getContentfulClient } from '../client.js';
+import { enrichAllAssets } from '../converters/enrichAssets.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 tag type from Contentful by slug
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Tag type slug to fetch
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IBaseTagType or null if not found
+ *
+ * @example
+ * ```ts
+ * const tagType = await contentfulTagTypeRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'category',
+ *   {
+ *     customType: 'topics',
+ *   }
+ * );
+ * ```
+ */
+export async function contentfulTagTypeRest(context, config, slug, options) {
+    const client = getContentfulClient(config, options.preview);
+    const tagTypeCacheTags = getCacheTags('tagType', slug, options?.preview);
+    const customTypeCacheTags = options?.customType
+        ? getCacheTags('customType', options.customType, options?.preview)
+        : [];
+    const requestOptions = {
+        ...options,
+        next: {
+            ...options?.next,
+            tags: [...tagTypeCacheTags, ...customTypeCacheTags],
+        },
+    };
+    const fetchFn = async () => {
+        const fetchProfile = options.fetchProfile ?? 'page';
+        const bundleCustomType = fetchProfile === 'page' && !!options?.customType;
+        const tagTypeInclude = resolveIncludeDepth('tagType', options);
+        const listingSelect = fetchProfile === 'listing' ? getSingleEntityListingSelect('tagType') : undefined;
+        const tagTypePromise = withCmsQueryContext({ operation: operationLabel('tagType'), identifier: slug }, () => client.getEntries({
+            content_type: 'tagType',
+            'fields.slug': slug,
+            include: tagTypeInclude,
+            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 [tagTypeResponse, customTypeResponse] = await Promise.all([
+            tagTypePromise,
+            customTypePromise,
+        ]);
+        const tagTypeEntry = tagTypeResponse.items[0];
+        if (!tagTypeEntry?.fields) {
+            return { data: null, errors: [] };
+        }
+        const customTypeEntry = customTypeResponse?.items[0];
+        try {
+            const assets = convertAllAssets(tagTypeResponse, context);
+            const rawAssets = convertAllRawAssets(tagTypeResponse);
+            const includes = convertAllIncludes(tagTypeResponse);
+            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);
+            const converted = context.tagTypeResolver(fullContext, tagTypeEntry, bundleCustomType ? customTypeEntry : undefined);
+            if (fullContext.errors.length > 0 &&
+                typeof process !== 'undefined' &&
+                process.env?.NODE_ENV === 'production') {
+                console.error(`CMS conversion errors for tagType:`, {
+                    entryId: tagTypeEntry.sys.id,
+                    slug,
+                    errors: fullContext.errors,
+                });
+            }
+            return { data: converted, errors: fullContext.errors };
+        }
+        catch (error) {
+            const entryId = tagTypeEntry?.sys.id || 'unknown';
+            const entryType = tagTypeEntry?.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] };
+        }
+    };
+    if (options?.retry) {
+        return await withRetry(fetchFn, options.retry);
+    }
+    return await fetchFn();
+}
+//# sourceMappingURL=tag-type.js.map

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

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

package/dist/api/tag.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/api/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAM3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE,OAAO,KAAK,EAAY,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AActF,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CA8IvC"}

package/dist/api/tag.js

@@ -0,0 +1,132 @@
+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 tag from Contentful by slug
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param slug - Tag slug to fetch
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IBaseTag or null if not found
+ *
+ * @example
+ * ```ts
+ * const tag = await contentfulTagRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'my-tag',
+ *   {
+ *     locale: 'en-US',
+ *     cache: {
+ *       tags: ['my-tag'],
+ *       revalidate: 3600
+ *     },
+ *     customType: 'topics' // Optional custom type
+ *   }
+ * );
+ * ```
+ */
+export async function contentfulTagRest(context, config, slug, options) {
+    const client = getContentfulClient(config, options.preview);
+    // Set cache tags for this request
+    const tagCacheTags = getCacheTags('tag', slug, options?.preview);
+    const customTypeCacheTags = options?.customType
+        ? getCacheTags('customType', options.customType, options?.preview)
+        : [];
+    const requestOptions = {
+        ...options,
+        next: {
+            ...options?.next,
+            tags: [...tagCacheTags, ...customTypeCacheTags],
+        },
+    };
+    const fetchFn = async () => {
+        const fetchProfile = options.fetchProfile ?? 'page';
+        const bundleCustomType = fetchProfile === 'page' && !!options?.customType;
+        const tagInclude = resolveIncludeDepth('tag', options);
+        const listingSelect = fetchProfile === 'listing' ? getSingleEntityListingSelect('tag') : undefined;
+        const tagPromise = withCmsQueryContext({ operation: operationLabel('tag'), identifier: slug }, () => client.getEntries({
+            content_type: 'tag',
+            'fields.slug': slug,
+            include: tagInclude,
+            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 [tagResponse, customTypeResponse] = await Promise.all([tagPromise, customTypePromise]);
+        const tagEntry = tagResponse.items[0];
+        if (!tagEntry?.fields) {
+            return { data: null, errors: [] };
+        }
+        const customTypeEntry = customTypeResponse?.items[0];
+        try {
+            const assets = convertAllAssets(tagResponse, context);
+            const rawAssets = convertAllRawAssets(tagResponse);
+            const includes = convertAllIncludes(tagResponse);
+            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.tagResolver(fullContext, tagEntry, 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 tag:`, {
+                    entryId: tagEntry.sys.id,
+                    slug,
+                    errors: fullContext.errors,
+                });
+            }
+            return { data: converted, errors: fullContext.errors };
+        }
+        catch (error) {
+            const entryId = tagEntry?.sys.id || 'unknown';
+            const entryType = tagEntry?.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=tag.js.map

package/dist/api/tag.js.map

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

package/dist/api/template.d.ts

@@ -0,0 +1,61 @@
+import type { EntryMeta, INavigation, ISchema, ISvgImage, ITyped } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { BaseTemplateSkeleton } from '../baseTypes/baseTemplate';
+import type { BaseConverterContext, ConverterContext } from '../converters/helpers';
+import type { CmsResponse, ContentfulConfig, FetchOptions } from '../types';
+import type { DefaultChainModifier } from './types';
+/**
+ * Fetched template data structure
+ * Extends the resolved template with id and label for direct fetching
+ */
+export interface IFetchedTemplate {
+    id: string;
+    cmsLabel: string;
+    preContent: ReadonlyArray<ITyped>;
+    postContent: ReadonlyArray<ITyped>;
+    menu?: INavigation;
+    footer?: INavigation;
+    backgroundColour?: string;
+    textColour?: string;
+    stickyNav: boolean;
+    icons?: ReadonlyArray<ISvgImage>;
+    /** Schema.org Mustache templates linked on the template (parity with page resolveTemplate). */
+    structuredData: ReadonlyArray<ISchema>;
+    /** Parsed template `meta` JSON (defaults for pages using this template). */
+    meta?: EntryMeta;
+}
+/**
+ * Converts a template entry to IFetchedTemplate (includes resolved structuredData).
+ * Exported for unit tests; used by {@link contentfulTemplateRest}.
+ */
+export declare function convertTemplateEntry(context: ConverterContext, entry: Entry<BaseTemplateSkeleton, DefaultChainModifier, string>): IFetchedTemplate;
+/**
+ * Fetches a template from Contentful by cmsLabel
+ *
+ * @param context - Converter context
+ * @param config - Contentful configuration
+ * @param cmsLabel - Template cmsLabel to fetch (e.g., '404')
+ * @param options - Fetch options (locale, preview, caching, etc.)
+ * @returns Promise resolving to IFetchedTemplate or null if not found
+ *
+ * @example
+ * ```ts
+ * const template = await contentfulTemplateRest(
+ *   context,
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   '404',
+ *   {
+ *     locale: 'en-US',
+ *     cache: {
+ *       tags: ['template#404'],
+ *       revalidate: 3600
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export declare function contentfulTemplateRest(context: BaseConverterContext, config: ContentfulConfig, cmsLabel: string, options: FetchOptions): Promise<CmsResponse<IFetchedTemplate | null>>;
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/api/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,SAAS,EACT,MAAM,EACP,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIpF,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,+FAA+F;IAC/F,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACvC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC/D,gBAAgB,CAwDlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAc/C"}