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

package/dist/converters/template.js

@@ -0,0 +1,53 @@
+import { resolvedMeta } from '@se-studio/core-data-types';
+import { resolveNavigationOrStub } from './navigationItem.js';
+import { resolvePageContent, resolveSchema } from './resolver.js';
+/**
+ * Resolves a template entry from an unresolved link
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param link - Unresolved link to template entry
+ * @returns Resolved template data with content arrays and navigation
+ */
+export function resolveTemplate(context, link) {
+    const id = link.sys.id;
+    const possibleEntry = context.includes.get(id);
+    if (possibleEntry?.type !== 'template') {
+        return null;
+    }
+    const entry = possibleEntry.entry;
+    const { fields } = entry;
+    if (!fields) {
+        return null;
+    }
+    // Resolve content arrays
+    const preContent = fields.preContent
+        ?.map((content) => resolvePageContent(context, id, content))
+        .filter((item) => item !== null) ?? [];
+    const postContent = fields.postContent
+        ?.map((content) => resolvePageContent(context, id, content))
+        .filter((item) => item !== null) ?? [];
+    const contentContainer = fields.contentContainer
+        ? resolvePageContent(context, id, fields.contentContainer)
+        : undefined;
+    const menu = resolveNavigationOrStub(context, fields.menu);
+    const footer = resolveNavigationOrStub(context, fields.footer);
+    // Check for sticky nav flag
+    const stickyNav = fields.flags?.includes('Sticky nav') ?? false;
+    const { backgroundColour, textColour } = fields;
+    const structuredData = fields.structuredData
+        ?.map((link) => resolveSchema(context, id, link))
+        .filter((item) => item != null) ?? [];
+    return {
+        preContent,
+        postContent,
+        contentContainer: contentContainer ?? undefined,
+        menu,
+        footer,
+        backgroundColour,
+        textColour,
+        stickyNav,
+        structuredData,
+        meta: resolvedMeta(fields.meta),
+    };
+}
+//# sourceMappingURL=template.js.map

package/dist/converters/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/converters/template.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB/D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAyB,EACzB,IAA6B;IAE7B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACvB,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAE/C,IAAI,aAAa,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,KAAkE,CAAC;IAC/F,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GACd,MAAM,CAAC,UAAU;QACf,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;SAC3D,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;IAE3D,MAAM,WAAW,GACf,MAAM,CAAC,WAAW;QAChB,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;SAC3D,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;IAE3D,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB;QAC9C,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAE/D,4BAA4B;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;IAEhE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAEhD,MAAM,cAAc,GAClB,MAAM,CAAC,cAAc;QACnB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,IAAI,EAAmB,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAE3D,OAAO;QACL,UAAU;QACV,WAAW;QACX,gBAAgB,EAAE,gBAAgB,IAAI,SAAS;QAC/C,IAAI;QACJ,MAAM;QACN,gBAAgB;QAChB,UAAU;QACV,SAAS;QACT,cAAc;QACd,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/converters/videoEnricher.d.ts

@@ -0,0 +1,14 @@
+import 'server-only';
+import type { IVisual } from '@se-studio/core-data-types';
+/**
+ * Enriches all local/full video visuals in the assets Map with pixel dimensions
+ * fetched from the ImageKit metadata API. Mutates width/height in place so the
+ * correct values are available throughout conversion (e.g. for aspect-ratio
+ * calculations in client components like ArticleBrowserImagesView).
+ *
+ * This is a no-op if IMAGEKIT_URL or IMAGEKIT_PRIVATE_KEY are not set.
+ *
+ * @param assets - The Map<assetId, IVisual> built by convertAllAssets
+ */
+export declare function imagekitEnrichVideoAssets(assets: Map<string, IVisual>): Promise<void>;
+//# sourceMappingURL=videoEnricher.d.ts.map

package/dist/converters/videoEnricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoEnricher.d.ts","sourceRoot":"","sources":["../../src/converters/videoEnricher.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,EAA2B,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAsEnF;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC3F"}

package/dist/converters/videoEnricher.js

@@ -0,0 +1,85 @@
+import 'server-only';
+import { unstable_cache } from 'next/cache';
+/**
+ * Raw HTTP fetch — called only on cache miss.
+ * Note: Next.js automatically excludes fetch calls with Authorization headers from its
+ * Data Cache, so caching is handled by the unstable_cache wrapper in fetchVideoMetadata.
+ */
+async function fetchFromImageKit(src, privateKey) {
+    const request = `https://api.imagekit.io/v1/metadata?url=${encodeURIComponent(src)}`;
+    if (process.env.LOG_IMAGEKIT)
+        console.log(`[ImageKit] cache miss — fetching url=${src}`);
+    const response = await fetch(request, {
+        method: 'GET',
+        headers: {
+            authorization: `Basic ${Buffer.from(`${privateKey}:`).toString('base64')}`,
+        },
+    });
+    if (response.ok) {
+        if (process.env.LOG_IMAGEKIT)
+            console.log(`[ImageKit] metadata ok status=${response.status}`);
+        return (await response.json());
+    }
+    console.warn(`[ImageKit] metadata failed status=${response.status} url=${src}`);
+    return undefined;
+}
+/**
+ * Fetches video metadata (width/height) from the ImageKit metadata API, with caching.
+ * Uses unstable_cache (not fetch's next:{} options) because Next.js automatically opts
+ * fetch calls with Authorization headers out of the Data Cache.
+ *
+ * Cached for 1 day; can be invalidated on-demand via the asset's Contentful webhook tag.
+ *
+ * @param videoUrl - Contentful CDN URL for the video asset
+ * @param assetId - Contentful asset ID for cache tagging
+ * @param imagekitUrl - ImageKit origin URL (IMAGEKIT_URL env var)
+ * @param privateKey - ImageKit private key (IMAGEKIT_PRIVATE_KEY env var)
+ */
+async function fetchVideoMetadata(videoUrl, assetId, imagekitUrl, privateKey) {
+    const fullUrl = new URL(videoUrl);
+    const src = `${imagekitUrl}${fullUrl.pathname}/ik-video.mp4`;
+    const getCached = unstable_cache(() => fetchFromImageKit(src, privateKey), ['imagekit-metadata', assetId], { revalidate: 86400 });
+    return getCached();
+}
+/**
+ * Enriches all local/full video visuals in the assets Map with pixel dimensions
+ * fetched from the ImageKit metadata API. Mutates width/height in place so the
+ * correct values are available throughout conversion (e.g. for aspect-ratio
+ * calculations in client components like ArticleBrowserImagesView).
+ *
+ * This is a no-op if IMAGEKIT_URL or IMAGEKIT_PRIVATE_KEY are not set.
+ *
+ * @param assets - The Map<assetId, IVisual> built by convertAllAssets
+ */
+export async function imagekitEnrichVideoAssets(assets) {
+    const imagekitUrl = process.env.IMAGEKIT_URL;
+    const privateKey = process.env.IMAGEKIT_PRIVATE_KEY;
+    if (!imagekitUrl || !privateKey) {
+        if (process.env.LOG_IMAGEKIT)
+            console.log('[ImageKit] skipping video enrichment — IMAGEKIT_URL or IMAGEKIT_PRIVATE_KEY not set');
+        return;
+    }
+    const videoEntries = Array.from(assets.entries()).filter(([, visual]) => visual.video?.type === 'Local video' || visual.video?.type === 'Full video');
+    if (videoEntries.length === 0)
+        return;
+    await Promise.all(videoEntries.map(async ([assetId, visual]) => {
+        const video = visual.video;
+        const videoUrl = video.type === 'Full video'
+            ? (video.full?.videoUrl ?? video.preview?.videoUrl)
+            : video.preview.videoUrl;
+        if (!videoUrl)
+            return;
+        try {
+            const metadata = await fetchVideoMetadata(videoUrl, assetId, imagekitUrl, privateKey);
+            if (metadata?.width && metadata?.height) {
+                video.width = metadata.width;
+                video.height = metadata.height;
+            }
+        }
+        catch (err) {
+            console.error(`[ImageKit] metadata fetch threw assetId=${assetId}`, err);
+            // Leave width/height undefined — components handle missing dimensions gracefully
+        }
+    }));
+}
+//# sourceMappingURL=videoEnricher.js.map

package/dist/converters/videoEnricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoEnricher.js","sourceRoot":"","sources":["../../src/converters/videoEnricher.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAW5C;;;;GAIG;AACH,KAAK,UAAU,iBAAiB,CAC9B,GAAW,EACX,UAAkB;IAElB,MAAM,OAAO,GAAG,2CAA2C,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;IACrF,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;QAAE,OAAO,CAAC,GAAG,CAAC,wCAAwC,GAAG,EAAE,CAAC,CAAC;IAEzF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;QACpC,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,aAAa,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;SAC3E;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;YAAE,OAAO,CAAC,GAAG,CAAC,iCAAiC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,qCAAqC,QAAQ,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC;IAChF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,kBAAkB,CAC/B,QAAgB,EAChB,OAAe,EACf,WAAmB,EACnB,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,WAAW,GAAG,OAAO,CAAC,QAAQ,eAAe,CAAC;IAE7D,MAAM,SAAS,GAAG,cAAc,CAC9B,GAAG,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,EACxC,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC9B,EAAE,UAAU,EAAE,KAAK,EAAE,CACtB,CAAC;IAEF,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,MAA4B;IAC1E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACpD,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;YAC1B,OAAO,CAAC,GAAG,CACT,qFAAqF,CACtF,CAAC;QACJ,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CACtD,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,KAAK,aAAa,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,CAC1B,CAAC;IAEpE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,MAAM,OAAO,CAAC,GAAG,CACf,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,QAAQ,GACZ,KAAK,CAAC,IAAI,KAAK,YAAY;YACzB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;YACnD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAE7B,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YACtF,IAAI,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACxC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;gBAC7B,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;YACzE,iFAAiF;QACnF,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/icons/rebuildIconSprite.d.ts

@@ -0,0 +1,8 @@
+import type { INavigation, ISvgImage, ITyped } from '@se-studio/core-data-types';
+export { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, processIconsForSprite, } from '../converters/iconCollector';
+/**
+ * Rebuild the SVG icon sprite from page contents and assembled navigation trees.
+ * Use after custom layout assembly when icons were collected before menu/footer were final.
+ */
+export declare function rebuildIconSpriteFromLayout(contents: ReadonlyArray<ITyped> | undefined, menu?: INavigation, footer?: INavigation): Promise<ReadonlyArray<ISvgImage> | undefined>;
+//# sourceMappingURL=rebuildIconSprite.d.ts.map

package/dist/icons/rebuildIconSprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuildIconSprite.d.ts","sourceRoot":"","sources":["../../src/icons/rebuildIconSprite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAQjF,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAC3C,IAAI,CAAC,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAa/C"}

package/dist/icons/rebuildIconSprite.js

@@ -0,0 +1,15 @@
+import { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, processIconsForSprite, } from '../converters/iconCollector.js';
+export { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, processIconsForSprite, } from '../converters/iconCollector.js';
+/**
+ * Rebuild the SVG icon sprite from page contents and assembled navigation trees.
+ * Use after custom layout assembly when icons were collected before menu/footer were final.
+ */
+export async function rebuildIconSpriteFromLayout(contents, menu, footer) {
+    const mergedIcons = deduplicateIcons(collectIconsFromContent(contents ?? []), collectIconsFromNavigation(menu), collectIconsFromNavigation(footer));
+    if (!mergedIcons || mergedIcons.length === 0) {
+        return undefined;
+    }
+    const processedIcons = await processIconsForSprite(mergedIcons);
+    return processedIcons.length > 0 ? processedIcons : undefined;
+}
+//# sourceMappingURL=rebuildIconSprite.js.map

package/dist/icons/rebuildIconSprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuildIconSprite.js","sourceRoot":"","sources":["../../src/icons/rebuildIconSprite.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAA2C,EAC3C,IAAkB,EAClB,MAAoB;IAEpB,MAAM,WAAW,GAAG,gBAAgB,CAClC,uBAAuB,CAAC,QAAQ,IAAI,EAAE,CAAC,EACvC,0BAA0B,CAAC,IAAI,CAAC,EAChC,0BAA0B,CAAC,MAAM,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAChE,OAAO,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @se-studio/contentful-rest-api
+ *
+ * Type-safe Contentful REST API client with caching and rate limiting
+ * for Next.js applications.
+ *
+ * @example
+ * ```ts
+ * import { contentfulPageRest, createContentfulClient } from '@se-studio/contentful-rest-api';
+ *
+ * const page = await contentfulPageRest(
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'home'
+ * );
+ * ```
+ */
+export type { EntryMeta } from '@se-studio/core-data-types';
+export { interpolateMetaTokens, mergeMeta, parseMeta, resolvedMeta, resolveMetaFromPageContext, } from '@se-studio/core-data-types';
+export { type AnyEntryRestResult, type ArticleTypeFetchOptions, assetToMediaLibraryItem, type BreadcrumbLookup, type BreadcrumbLookupEntry, type BuiltinPreviewContentType, buildAssetThumbUrl, buildFetchOptions, buildFlatNavigationCacheOptions, type CmsContentType, type CmsFetchProfile, type ConverterResolutionScope, clampMediaLibraryLimit, clampMediaLibraryPage, contentfulAllArticleLinks, contentfulAllArticleLinksForIntegrity, contentfulAllArticleTypeLinks, contentfulAllCustomTypeLinks, contentfulAllPageLinks, contentfulAllPersonLinks, contentfulAllTagLinks, contentfulAllTagTypeLinks, contentfulAnyEntryRest, contentfulArticleRest, contentfulArticleSitemapEntries, contentfulArticleTypeRest, contentfulArticleTypeSitemapEntries, contentfulAssetRest, contentfulAssetsPageRest, contentfulBannerRest, contentfulComponentRest, contentfulCustomTypeRest, contentfulDocumentsRest, contentfulPageRest, contentfulPageSitemapEntries, contentfulPersonRest, contentfulPersonSitemapEntries, contentfulRedirectsRest, contentfulTagRest, contentfulTagSitemapEntries, contentfulTagTypeRest, contentfulTemplateRest, coreGetContentfulConfig, createBaseConverterContext, createSitemapProvider, type DefaultChainModifier, FLAT_NAV_CACHE_TAGS, FLAT_NAV_TIME_REVALIDATE_SECONDS, filterRelatedArticles, getAllSitemapEntries, getBreadcrumbLookup, getDefaultInclude, getListingLinkFetchParams, getNavigation, getPreviewEntryInfo, getResolutionScope, getResolutionScopeFromOptions, type IContentfulRichText, type IFetchedTemplate, type ISitemapEntry, isAnimationAsset, isBrowserViewable, isMediaLibraryKind, LISTING_RESOLUTION_SCOPE, 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, PAGE_CONTENT_SCOPE, PAGE_RESOLUTION_SCOPE, type PersonFetchOptions, type PreviewContentType, type PreviewEntryInclude, type PreviewEntryInfo, type PreviewEntryResolveInput, type PreviewEntryResolver, type RelatedArticlesOptions, resolveIncludeDepth, type SitemapChangeFrequency, type SitemapConfig, type SitemapContentTypeConfig, type SitemapEntryProvider, slugPreviewResolver, type TagFetchOptions, type TagTypeFetchOptions, withFlatNavRequestCache, } from './api';
+export type { ContentfulFetchClient as ContentfulClient } from './client';
+export { type ContentfulFetchClient, createContentfulClient, createContentfulPreviewClient, getContentfulClient, } from './client';
+export type { ContentResolverFunction } from './converters';
+export { type BaseConverterContext, baseCollectionConverter, baseComponentConverter, baseDocumentConverter, baseExternalComponentConverter, baseNavigationItemConverter, basePageConverter, type ConverterContext, calculatePageHref, calculatePageVariantHref, createResponsiveVisual, type IContentfulArticle, type IContentfulArticleLink, type IContentfulCollection, type IContentfulComponent, type IContentfulExternalComponent, type IContentfulPerson, lookupAsset, mergeAlternatePageContentsInTree, navigationStubFromLink, resolveAlternateReplacements, resolveLink, resolveLinks, resolveNavigation, resolveNavigationOrStub, resolveRichTextDocument, type UrlCalculators, } from './converters';
+export { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, processIconsForSprite, rebuildIconSpriteFromLayout, } from './icons/rebuildIconSprite';
+export { AllTags, ArticleTag, ArticleTypeTag, AssetTag, articleTag, articleTypeIndexTag, articleTypeTag, assetTag, BannerTag, CustomTypeTag, customTypeTag, DocumentTag, GlobalTag, getCacheTags, getCacheTagsForPreview, getCacheTagsForProduction, LinkTag, LocationTag, locationTag, NavigationItemTag, NavigationTag, PageTag, PageVariantTag, PersonTag, pageTag, pageVariantTag, personTag, REVALIDATION_WEBHOOK_ENTRY_CONTENT_TYPES, REVALIDATION_WEBHOOK_ENTRY_CONTENT_TYPES_CSV, TagTag, TagTypeTag, TemplateTag, tagTag, templateTag, } from './revalidation';
+export { createMarketingSiteUrlCalculators, type MarketingSiteRoutingOptions, } from './routing';
+export type { CmsError, CmsResponse, ContentfulConfig, FetchOptions, NavigationResolution, RetryConfig, } from './types';
+export { type ArticleForTagSelection, AuthenticationError, arrayOrUndefined, ContentfulError, calculateBackoffDelay, EntryNotFoundError, filterVisibleTags, getPrimaryTag, getRetryAfter, isContentfulError, isRateLimitError, isRetryableError, isTagShowEnabled, isTagVisible, isValidDate, notEmpty, type PrimaryTagSelector, RateLimitError, RateLimiter, safeDate, type TagVisibilityFields, ValidationError, withRetry, } from './utils';
+export { buildRedirectMap, filterSitemapEntriesExcludingRedirects, type RedirectMap, type RedirectMapEntry, } from './utils/redirectMap';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,42 @@
+/**
+ * @se-studio/contentful-rest-api
+ *
+ * Type-safe Contentful REST API client with caching and rate limiting
+ * for Next.js applications.
+ *
+ * @example
+ * ```ts
+ * import { contentfulPageRest, createContentfulClient } from '@se-studio/contentful-rest-api';
+ *
+ * const page = await contentfulPageRest(
+ *   {
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   },
+ *   'home'
+ * );
+ * ```
+ */
+export { interpolateMetaTokens, mergeMeta, parseMeta, resolvedMeta, resolveMetaFromPageContext, } from '@se-studio/core-data-types';
+// API functions
+export { 
+// Asset/download + media library
+assetToMediaLibraryItem, buildAssetThumbUrl, buildFetchOptions, buildFlatNavigationCacheOptions, clampMediaLibraryLimit, clampMediaLibraryPage, contentfulAllArticleLinks, contentfulAllArticleLinksForIntegrity, contentfulAllArticleTypeLinks, contentfulAllCustomTypeLinks, contentfulAllPageLinks, contentfulAllPersonLinks, contentfulAllTagLinks, contentfulAllTagTypeLinks, contentfulAnyEntryRest, contentfulArticleRest, contentfulArticleSitemapEntries, contentfulArticleTypeRest, contentfulArticleTypeSitemapEntries, contentfulAssetRest, contentfulAssetsPageRest, contentfulBannerRest, contentfulComponentRest, contentfulCustomTypeRest, contentfulDocumentsRest, contentfulPageRest, contentfulPageSitemapEntries, contentfulPersonRest, contentfulPersonSitemapEntries, contentfulRedirectsRest, contentfulTagRest, contentfulTagSitemapEntries, contentfulTagTypeRest, contentfulTemplateRest, coreGetContentfulConfig, createBaseConverterContext, createSitemapProvider, FLAT_NAV_CACHE_TAGS, FLAT_NAV_TIME_REVALIDATE_SECONDS, filterRelatedArticles, getAllSitemapEntries, getBreadcrumbLookup, getDefaultInclude, getListingLinkFetchParams, getNavigation, 
+// Preview
+getPreviewEntryInfo, getResolutionScope, getResolutionScopeFromOptions, isAnimationAsset, isBrowserViewable, isMediaLibraryKind, LISTING_RESOLUTION_SCOPE, listAnimationsPage, listMediaLibraryPage, MEDIA_LIBRARY_DEFAULT_LIMIT, MEDIA_LIBRARY_KINDS, MEDIA_LIBRARY_MAX_LIMIT, MEDIA_LIBRARY_THUMB_WIDTH, mediaLibraryKindForAsset, mediaLibraryPageToMarkdown, PAGE_CONTENT_SCOPE, PAGE_RESOLUTION_SCOPE, resolveIncludeDepth, slugPreviewResolver, withFlatNavRequestCache, } from './api/index.js';
+// Client exports
+export { createContentfulClient, createContentfulPreviewClient, getContentfulClient, } from './client.js';
+// Converter exports
+export { baseCollectionConverter, baseComponentConverter, baseDocumentConverter, baseExternalComponentConverter, baseNavigationItemConverter, basePageConverter, calculatePageHref, calculatePageVariantHref, createResponsiveVisual, lookupAsset, mergeAlternatePageContentsInTree, navigationStubFromLink, resolveAlternateReplacements, resolveLink, resolveLinks, resolveNavigation, resolveNavigationOrStub, resolveRichTextDocument, } from './converters/index.js';
+export { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, processIconsForSprite, rebuildIconSpriteFromLayout, } from './icons/rebuildIconSprite.js';
+// Revalidation utilities
+export { AllTags, ArticleTag, ArticleTypeTag, AssetTag, articleTag, articleTypeIndexTag, articleTypeTag, assetTag, BannerTag, CustomTypeTag, customTypeTag, DocumentTag, GlobalTag, getCacheTags, 
+// Utility functions
+getCacheTagsForPreview, getCacheTagsForProduction, LinkTag, LocationTag, locationTag, NavigationItemTag, NavigationTag, 
+// Tag constants and functions
+PageTag, PageVariantTag, PersonTag, pageTag, pageVariantTag, personTag, REVALIDATION_WEBHOOK_ENTRY_CONTENT_TYPES, REVALIDATION_WEBHOOK_ENTRY_CONTENT_TYPES_CSV, TagTag, TagTypeTag, TemplateTag, tagTag, templateTag, } from './revalidation/index.js';
+export { createMarketingSiteUrlCalculators, } from './routing/index.js';
+// Error handling and retry utilities
+export { AuthenticationError, arrayOrUndefined, ContentfulError, calculateBackoffDelay, EntryNotFoundError, filterVisibleTags, getPrimaryTag, getRetryAfter, isContentfulError, isRateLimitError, isRetryableError, isTagShowEnabled, isTagVisible, isValidDate, notEmpty, RateLimitError, RateLimiter, safeDate, ValidationError, withRetry, } from './utils/index.js';
+export { buildRedirectMap, filterSitemapEntriesExcludingRedirects, } from './utils/redirectMap.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/navigation/assembly.d.ts

@@ -0,0 +1,8 @@
+import type { IInternalLink, ILinkProps, INavigation, INavigationItem } from '@se-studio/core-data-types';
+import type { InternalLinkIndex, NavItemRecord, NavigationRegistry, NavigationRootRecord } from './types';
+export declare function createNavItemLink(record: NavItemRecord, linkIndex: InternalLinkIndex): ILinkProps | undefined;
+export declare function assembleNavigationItem(id: string, registry: NavigationRegistry, linkIndex: InternalLinkIndex, visiting?: Set<string>): INavigationItem | undefined;
+export declare function assembleNavigation(root: NavigationRootRecord, registry: NavigationRegistry, linkIndex: InternalLinkIndex): INavigation;
+export declare function assembleNavigationById(navigationId: string, registry: NavigationRegistry, linkIndex: InternalLinkIndex): INavigation | undefined;
+export declare function addLinkToIndex(index: InternalLinkIndex, link: IInternalLink): void;
+//# sourceMappingURL=assembly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../src/navigation/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,UAAU,EACV,WAAW,EACX,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,iBAAiB,GAC3B,UAAU,GAAG,SAAS,CAoFxB;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,GAAG,CAAC,MAAM,CAAa,GAChC,eAAe,GAAG,SAAS,CA0B7B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,iBAAiB,GAC3B,WAAW,CAab;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,iBAAiB,GAC3B,WAAW,GAAG,SAAS,CAMzB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAOlF"}

package/dist/navigation/assembly.js

@@ -0,0 +1,115 @@
+import { resolveBuildYear } from '../converters/helpers.js';
+export function createNavItemLink(record, linkIndex) {
+    const { id, title, externalLink, text, internalId, icon, useTitle, variant, size, trackingEventName, longText, isButton, isOutlined, backgroundColour, textColour, } = record;
+    const trackingInfo = trackingEventName ? { trackingEventName } : undefined;
+    const realText = useTitle ? resolveBuildYear(title) : text ? resolveBuildYear(text) : undefined;
+    const styleProps = {
+        ...(isButton !== undefined ? { isButton } : {}),
+        ...(isOutlined !== undefined ? { isOutlined } : {}),
+        ...(backgroundColour !== undefined ? { backgroundColour } : {}),
+        ...(textColour !== undefined ? { textColour } : {}),
+    };
+    if (externalLink) {
+        return {
+            type: 'External link',
+            id,
+            href: externalLink,
+            icon,
+            name: title,
+            ...styleProps,
+            longText,
+            variant,
+            size,
+            text: realText,
+            ...(trackingInfo && { trackingInfo }),
+        };
+    }
+    if (internalId) {
+        const resolved = linkIndex.get(internalId);
+        if (resolved) {
+            return {
+                ...resolved,
+                ...styleProps,
+                longText,
+                icon,
+                visual: icon?.visual ?? resolved.visual,
+                id,
+                text: realText,
+                variant,
+                size,
+                ...(trackingInfo && {
+                    trackingInfo: { ...resolved.trackingInfo, ...trackingInfo },
+                }),
+            };
+        }
+        if (process.env.LOG_CMS) {
+            console.warn(`[CMS] Navigation item ${id} internal target ${internalId} not in link index (${linkIndex.size} links loaded)`);
+        }
+    }
+    const blank = {
+        type: 'Blank link',
+        nick: true,
+        id,
+        name: title,
+        ...styleProps,
+        longText,
+        variant,
+        size,
+        icon,
+        text: realText,
+        ...(trackingInfo && { trackingInfo }),
+    };
+    return blank;
+}
+export function assembleNavigationItem(id, registry, linkIndex, visiting = new Set()) {
+    if (visiting.has(id)) {
+        return undefined;
+    }
+    const record = registry.items.get(id);
+    if (!record) {
+        return undefined;
+    }
+    visiting.add(id);
+    const link = createNavItemLink(record, linkIndex);
+    const entries = record.childIds
+        .map((childId) => assembleNavigationItem(childId, registry, linkIndex, visiting))
+        .filter((item) => item !== undefined);
+    visiting.delete(id);
+    const result = {
+        id,
+        link,
+        entries: entries.length > 0 ? entries : undefined,
+        ...(record.adminLabel ? { adminLabel: record.adminLabel } : {}),
+    };
+    return result;
+}
+export function assembleNavigation(root, registry, linkIndex) {
+    const entries = root.entryIds
+        .map((id) => assembleNavigationItem(id, registry, linkIndex))
+        .filter((item) => item !== undefined);
+    return {
+        id: root.id,
+        name: root.name,
+        entries,
+        ...(root.adminLabel ? { adminLabel: root.adminLabel } : {}),
+        ...(root.backgroundColour ? { backgroundColour: root.backgroundColour } : {}),
+        ...(root.textColour ? { textColour: root.textColour } : {}),
+    };
+}
+export function assembleNavigationById(navigationId, registry, linkIndex) {
+    const root = registry.roots.get(navigationId);
+    if (!root) {
+        return undefined;
+    }
+    return assembleNavigation(root, registry, linkIndex);
+}
+export function addLinkToIndex(index, link) {
+    index.set(link.internalId, link);
+    if (link.linkEntryId) {
+        index.set(link.linkEntryId, link);
+    }
+    else {
+        index.set(link.id, link);
+    }
+}
+//# sourceMappingURL=assembly.js.map

package/dist/navigation/assembly.js.map

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

package/dist/navigation/cacheOptions.d.ts

@@ -0,0 +1,17 @@
+import type { FetchOptions } from '../types';
+/**
+ * Time-based ISR fallback (seconds) when a Contentful webhook does not invalidate cache tags.
+ * Primary invalidation is tag-based via {@link FLAT_NAV_CACHE_TAGS} on each sub-fetch.
+ * Apps may override with `options.next.revalidate` (set `false` for tag-only caching).
+ */
+export declare const FLAT_NAV_TIME_REVALIDATE_SECONDS = 3600;
+/**
+ * Collection-level Next.js cache tags for flat navigation fetches.
+ * Webhook handlers must revalidate these when the corresponding content type publishes.
+ */
+export declare const FLAT_NAV_CACHE_TAGS: readonly ["navigation", "navigationItem", "page", "pageVariant", "article", "articleType", "customType", "tag", "tagType", "person", "link"];
+/** Merge default flat-nav cache settings without clobbering app-provided `next` fields. */
+export declare function buildFlatNavigationCacheOptions(options: FetchOptions): FetchOptions;
+/** Listing bulk link fetches share flat-nav cache tags and listing fetch profile. */
+export declare function buildListingLinkCacheOptions(options: FetchOptions): FetchOptions;
+//# sourceMappingURL=cacheOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cacheOptions.d.ts","sourceRoot":"","sources":["../../src/navigation/cacheOptions.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8IAYtB,CAAC;AAEX,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAYnF;AAED,qFAAqF;AACrF,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAKhF"}

package/dist/navigation/cacheOptions.js

@@ -0,0 +1,45 @@
+import { ArticleTag, ArticleTypeTag, CustomTypeTag, LinkTag, NavigationItemTag, NavigationTag, PageTag, PageVariantTag, PersonTag, TagTag, TagTypeTag, } from '../revalidation/tags.js';
+/**
+ * Time-based ISR fallback (seconds) when a Contentful webhook does not invalidate cache tags.
+ * Primary invalidation is tag-based via {@link FLAT_NAV_CACHE_TAGS} on each sub-fetch.
+ * Apps may override with `options.next.revalidate` (set `false` for tag-only caching).
+ */
+export const FLAT_NAV_TIME_REVALIDATE_SECONDS = 3600;
+/**
+ * Collection-level Next.js cache tags for flat navigation fetches.
+ * Webhook handlers must revalidate these when the corresponding content type publishes.
+ */
+export const FLAT_NAV_CACHE_TAGS = [
+    NavigationTag,
+    NavigationItemTag,
+    PageTag,
+    PageVariantTag,
+    ArticleTag,
+    ArticleTypeTag,
+    CustomTypeTag,
+    TagTag,
+    TagTypeTag,
+    PersonTag,
+    LinkTag,
+];
+/** Merge default flat-nav cache settings without clobbering app-provided `next` fields. */
+export function buildFlatNavigationCacheOptions(options) {
+    const { revalidate, tags, ...restNext } = options.next ?? {};
+    return {
+        ...options,
+        cache: options.cache ?? 'force-cache',
+        next: {
+            ...restNext,
+            revalidate: revalidate ?? FLAT_NAV_TIME_REVALIDATE_SECONDS,
+            tags: [...new Set([...FLAT_NAV_CACHE_TAGS, ...(tags ?? [])])],
+        },
+    };
+}
+/** Listing bulk link fetches share flat-nav cache tags and listing fetch profile. */
+export function buildListingLinkCacheOptions(options) {
+    return {
+        ...buildFlatNavigationCacheOptions(options),
+        fetchProfile: 'listing',
+    };
+}
+//# sourceMappingURL=cacheOptions.js.map

package/dist/navigation/cacheOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheOptions.js","sourceRoot":"","sources":["../../src/navigation/cacheOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,cAAc,EACd,SAAS,EACT,MAAM,EACN,UAAU,GACX,MAAM,sBAAsB,CAAC;AAG9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa;IACb,iBAAiB;IACjB,OAAO;IACP,cAAc;IACd,UAAU;IACV,cAAc;IACd,aAAa;IACb,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;CACC,CAAC;AAEX,2FAA2F;AAC3F,MAAM,UAAU,+BAA+B,CAAC,OAAqB;IACnE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7D,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa;QACrC,IAAI,EAAE;YACJ,GAAG,QAAQ;YACX,UAAU,EAAE,UAAU,IAAI,gCAAgC;YAC1D,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,mBAAmB,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SAC9D;KACF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,4BAA4B,CAAC,OAAqB;IAChE,OAAO;QACL,GAAG,+BAA+B,CAAC,OAAO,CAAC;QAC3C,YAAY,EAAE,SAAS;KACxB,CAAC;AACJ,CAAC"}

package/dist/navigation/enrichModelNavigation.d.ts

@@ -0,0 +1,17 @@
+import type { INavigation, ISvgImage, ITyped } from '@se-studio/core-data-types';
+import type { BaseConverterContext } from '../converters/helpers';
+import type { ContentfulConfig, FetchOptions } from '../types';
+export interface LayoutBearingModel {
+    menu?: INavigation;
+    footer?: INavigation;
+    icons?: ReadonlyArray<ISvgImage>;
+    contents?: ReadonlyArray<ITyped>;
+}
+/**
+ * When `navigationResolution` is `flat`, replace nav stubs with registry-assembled trees
+ * and rebuild the icon sprite set from content + flat navigation.
+ */
+export declare function enrichModelNavigation<T extends LayoutBearingModel>(model: T, context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<T>;
+/** Flat-nav enrichment or bundled icon sprite processing after entity conversion. */
+export declare function finalizeModelIconsAndNavigation<T extends LayoutBearingModel>(model: T, context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<T>;
+//# sourceMappingURL=enrichModelNavigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enrichModelNavigation.d.ts","sourceRoot":"","sources":["../../src/navigation/enrichModelNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAM/D,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,EACtE,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CA8BZ;AAED,qFAAqF;AACrF,wBAAsB,+BAA+B,CAAC,CAAC,SAAS,kBAAkB,EAChF,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/navigation/enrichModelNavigation.js

@@ -0,0 +1,46 @@
+import { processIconsForSprite } from '../converters/iconCollector.js';
+import { rebuildIconSpriteFromLayout } from '../icons/rebuildIconSprite.js';
+import { assembleNavigationById } from './assembly.js';
+import { buildFlatNavigationCacheOptions } from './cacheOptions.js';
+import { getInternalLinkIndex } from './linkIndex.js';
+import { getNavigationRegistry } from './registry.js';
+/**
+ * When `navigationResolution` is `flat`, replace nav stubs with registry-assembled trees
+ * and rebuild the icon sprite set from content + flat navigation.
+ */
+export async function enrichModelNavigation(model, context, config, options) {
+    if (options.navigationResolution !== 'flat') {
+        return model;
+    }
+    const menuId = model.menu?.id;
+    const footerId = model.footer?.id;
+    const cacheOptions = buildFlatNavigationCacheOptions(options);
+    const [registry, linkIndex] = await Promise.all([
+        getNavigationRegistry(context, config, cacheOptions),
+        getInternalLinkIndex(context, config, cacheOptions),
+    ]);
+    const menu = menuId ? assembleNavigationById(menuId, registry, linkIndex) : undefined;
+    const footer = footerId ? assembleNavigationById(footerId, registry, linkIndex) : undefined;
+    const enriched = {
+        ...model,
+        ...(menu ? { menu } : {}),
+        ...(footer ? { footer } : {}),
+    };
+    enriched.icons = await rebuildIconSpriteFromLayout(model.contents, menu ?? model.menu, footer ?? model.footer);
+    return enriched;
+}
+/** Flat-nav enrichment or bundled icon sprite processing after entity conversion. */
+export async function finalizeModelIconsAndNavigation(model, context, config, options) {
+    if (options.navigationResolution === 'flat') {
+        return enrichModelNavigation(model, context, config, options);
+    }
+    if (model.icons && model.icons.length > 0) {
+        const processedIcons = await processIconsForSprite(model.icons);
+        return {
+            ...model,
+            icons: processedIcons.length > 0 ? processedIcons : undefined,
+        };
+    }
+    return model;
+}
+//# sourceMappingURL=enrichModelNavigation.js.map

package/dist/navigation/enrichModelNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichModelNavigation.js","sourceRoot":"","sources":["../../src/navigation/enrichModelNavigation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AASnD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAQ,EACR,OAA6B,EAC7B,MAAwB,EACxB,OAAqB;IAErB,IAAI,OAAO,CAAC,oBAAoB,KAAK,MAAM,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;IAClC,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,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5F,MAAM,QAAQ,GAAM;QAClB,GAAG,KAAK;QACR,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC;IAEF,QAAQ,CAAC,KAAK,GAAG,MAAM,2BAA2B,CAChD,KAAK,CAAC,QAAQ,EACd,IAAI,IAAI,KAAK,CAAC,IAAI,EAClB,MAAM,IAAI,KAAK,CAAC,MAAM,CACvB,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAAQ,EACR,OAA6B,EAC7B,MAAwB,EACxB,OAAqB;IAErB,IAAI,OAAO,CAAC,oBAAoB,KAAK,MAAM,EAAE,CAAC;QAC5C,OAAO,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChE,OAAO;YACL,GAAG,KAAK;YACR,KAAK,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/navigation/linkIndex.d.ts

@@ -0,0 +1,10 @@
+import type { BaseConverterContext } from '../converters/helpers';
+import type { ContentfulConfig, FetchOptions } from '../types';
+import type { InternalLinkIndex } from './types';
+/**
+ * Fetches all routable entry links and builds an entry-id keyed index for navigation assembly.
+ * Includes link wrapper entries keyed by wrapper id and target id.
+ * Results are deduped per request and while in-flight.
+ */
+export declare function getInternalLinkIndex(context: BaseConverterContext, config: ContentfulConfig, options: FetchOptions): Promise<InternalLinkIndex>;
+//# sourceMappingURL=linkIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkIndex.d.ts","sourceRoot":"","sources":["../../src/navigation/linkIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAuBjD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}