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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pictureBlurEnricher.d.ts","sourceRoot":"","sources":["../../src/converters/pictureBlurEnricher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAkEpE;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/F"}

package/dist/converters/pictureBlurEnricher.js

@@ -0,0 +1,79 @@
+import { assetTag } from '../revalidation/tags.js';
+/**
+ * Tiny raster width for LQIP-style blur data URLs. Kept small to limit fetch size and base64 payload.
+ */
+const BLUR_TARGET_WIDTH_PX = 24;
+/** Output format for the placeholder fetch (JPEG compresses well at low dimensions). */
+const BLUR_FORMAT = 'jpg';
+/** JPEG quality for the placeholder (low = smaller file). */
+const BLUR_QUALITY = 20;
+function isContentfulImageHost(hostname) {
+    return (hostname === 'images.ctfassets.net' ||
+        hostname === 'assets.ctfassets.net' ||
+        hostname.endsWith('.ctfassets.net'));
+}
+/**
+ * Builds a Contentful Images API URL for a small JPEG suitable for `blurDataURL`.
+ * Returns undefined if the source is not a Contentful delivery host or cannot be parsed.
+ */
+function buildTinyBlurFetchUrl(src) {
+    if (!src)
+        return undefined;
+    try {
+        const parsed = new URL(src);
+        if (!isContentfulImageHost(parsed.hostname))
+            return undefined;
+        parsed.searchParams.set('w', String(BLUR_TARGET_WIDTH_PX));
+        parsed.searchParams.set('fm', BLUR_FORMAT);
+        parsed.searchParams.set('q', String(BLUR_QUALITY));
+        return parsed.toString();
+    }
+    catch {
+        return undefined;
+    }
+}
+async function fetchPictureBlurDataURL(pictureSrc, assetId) {
+    const url = buildTinyBlurFetchUrl(pictureSrc);
+    if (!url)
+        return undefined;
+    try {
+        const response = await fetch(url, {
+            cache: 'force-cache',
+            next: {
+                tags: [assetTag(assetId)],
+            },
+        });
+        if (!response.ok)
+            return undefined;
+        const mimeType = response.headers.get('content-type')?.split(';')[0]?.trim() || 'image/jpeg';
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.length === 0)
+            return undefined;
+        const base64 = Buffer.from(bytes).toString('base64');
+        return `data:${mimeType};base64,${base64}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Enriches raster pictures in the assets map with `blurDataURL` by fetching a tiny CDN variant.
+ * Mutates each `IPicture` in place. Skips non-Contentful hosts, SVG, existing `blurDataURL`, and failures.
+ *
+ * @param assets - Map from asset id to visual (from `convertAllAssets`)
+ */
+export async function enrichPictureBlurPlaceholders(assets) {
+    const pictureEntries = Array.from(assets.entries()).filter(([, visual]) => visual.image?.type === 'Picture');
+    if (pictureEntries.length === 0)
+        return;
+    await Promise.all(pictureEntries.map(async ([assetId, visual]) => {
+        const picture = visual.image;
+        if (picture.blurDataURL)
+            return;
+        const blurDataURL = await fetchPictureBlurDataURL(picture.src, assetId);
+        if (!blurDataURL)
+            return;
+        visual.image = { ...picture, blurDataURL };
+    }));
+}
+//# sourceMappingURL=pictureBlurEnricher.js.map

package/dist/converters/pictureBlurEnricher.js.map

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

package/dist/converters/redirect.d.ts

@@ -0,0 +1,20 @@
+import type { IRedirect } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { BaseRedirectSkeleton } from '../baseTypes/baseRedirect';
+import type { ConverterContext } from './helpers';
+/**
+ * Converts a Contentful redirect entry to an IRedirect object.
+ *
+ * The effective `fromPath` and `to` are always concrete strings:
+ * - If the single `fromInternal` / `toInternal` reference is populated, its
+ *   resolved IInternalLink.href is used (this is what makes picking a page/article/tagType
+ *   etc. work for non-technical editors without them typing slugs).
+ * - Otherwise the raw `fromPath` / `toPath` symbol is used (for old/vanity URLs,
+ *   external targets, etc.).
+ *
+ * Internal reference wins over raw when both are supplied (editors should normally
+ * use one or the other; the UI help text will guide them).
+ */
+export declare function baseRedirectConverter(context: ConverterContext, entry: Entry<BaseRedirectSkeleton, DefaultChainModifier, string>): IRedirect;
+//# sourceMappingURL=redirect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../src/converters/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAsB,MAAM,4BAA4B,CAAC;AAC/F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC/D,SAAS,CAoDX"}

package/dist/converters/redirect.js

@@ -0,0 +1,50 @@
+import { resolveLink } from './resolver.js';
+/**
+ * Converts a Contentful redirect entry to an IRedirect object.
+ *
+ * The effective `fromPath` and `to` are always concrete strings:
+ * - If the single `fromInternal` / `toInternal` reference is populated, its
+ *   resolved IInternalLink.href is used (this is what makes picking a page/article/tagType
+ *   etc. work for non-technical editors without them typing slugs).
+ * - Otherwise the raw `fromPath` / `toPath` symbol is used (for old/vanity URLs,
+ *   external targets, etc.).
+ *
+ * Internal reference wins over raw when both are supplied (editors should normally
+ * use one or the other; the UI help text will guide them).
+ */
+export function baseRedirectConverter(context, entry) {
+    const { sys, fields } = entry;
+    if (sys.contentType.sys.id !== 'redirect') {
+        throw new Error(`Invalid content type: expected "redirect", got "${sys.contentType.sys.id}"`);
+    }
+    const id = sys.id;
+    const { fromPath: rawFromPath, fromInternal: rawFromInternal, toPath: rawToPath, toInternal: rawToInternal, statusCode, active, note, ...simpleFields } = fields;
+    // Resolve the (at most one) internal reference on each side. These carry the correct
+    // .href computed by the project's urlCalculators via the link converters.
+    const fromInternal = rawFromInternal
+        ? resolveLink(context, id, rawFromInternal)
+        : undefined;
+    const toInternal = rawToInternal
+        ? resolveLink(context, id, rawToInternal)
+        : undefined;
+    // Effective fromPath: prefer the internal reference's href, fall back to raw symbol.
+    const fromPath = fromInternal?.href || rawFromPath || '';
+    // Effective to: prefer internal reference href, fall back to raw (which may be a full external URL).
+    const to = toInternal?.href || rawToPath || '';
+    const normalizedStatus = statusCode
+        ? Number.parseInt(statusCode, 10)
+        : 301;
+    return {
+        type: 'Redirect',
+        id,
+        fromPath: fromPath || rawFromPath || '',
+        to: to || rawToPath || '',
+        statusCode: normalizedStatus,
+        active: active ?? true,
+        note: note ?? null,
+        ...(fromInternal ? { fromInternal } : {}),
+        ...(toInternal ? { toInternal } : {}),
+        ...simpleFields,
+    };
+}
+//# sourceMappingURL=redirect.js.map

package/dist/converters/redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.js","sourceRoot":"","sources":["../../src/converters/redirect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAyB,EACzB,KAAgE;IAEhE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9B,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,mDAAmD,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;IAElB,MAAM,EACJ,QAAQ,EAAE,WAAW,EACrB,YAAY,EAAE,eAAe,EAC7B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,aAAa,EACzB,UAAU,EACV,MAAM,EACN,IAAI,EACJ,GAAG,YAAY,EAChB,GAAG,MAAM,CAAC;IAEX,qFAAqF;IACrF,0EAA0E;IAC1E,MAAM,YAAY,GAAG,eAAe;QAClC,CAAC,CAAE,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,eAAe,CAA+B;QAC1E,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,UAAU,GAAG,aAAa;QAC9B,CAAC,CAAE,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,aAAa,CAA+B;QACxE,CAAC,CAAC,SAAS,CAAC;IAEd,qFAAqF;IACrF,MAAM,QAAQ,GAAG,YAAY,EAAE,IAAI,IAAK,WAAkC,IAAI,EAAE,CAAC;IAEjF,qGAAqG;IACrG,MAAM,EAAE,GAAG,UAAU,EAAE,IAAI,IAAK,SAAgC,IAAI,EAAE,CAAC;IAEvE,MAAM,gBAAgB,GAAG,UAAU;QACjC,CAAC,CAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAwB;QACzD,CAAC,CAAC,GAAG,CAAC;IAER,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,EAAE;QACF,QAAQ,EAAE,QAAQ,IAAK,WAAsB,IAAI,EAAE;QACnD,EAAE,EAAE,EAAE,IAAK,SAAoB,IAAI,EAAE;QACrC,UAAU,EAAE,gBAAgB;QAC5B,MAAM,EAAE,MAAM,IAAI,IAAI;QACtB,IAAI,EAAG,IAA2B,IAAI,IAAI;QAC1C,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,YAAY;KAChB,CAAC;AACJ,CAAC"}

package/dist/converters/resolver.d.ts

@@ -0,0 +1,26 @@
+import { type Document } from '@contentful/rich-text-types';
+import type { BaseCollectionContent, IInternalLink, INavigationItem, ISchema, ITyped } from '@se-studio/core-data-types';
+import type { UnresolvedLink } from 'contentful';
+import type { ConverterContext } from './helpers';
+export declare function resolveSchema(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): ISchema | undefined;
+export declare function resolveLink(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): IInternalLink | undefined;
+export declare function resolveLinks(context: ConverterContext, fromId: string, entries: UnresolvedLink<'Entry'>[] | undefined): readonly IInternalLink[] | undefined;
+export declare function resolveNavigationItem(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): INavigationItem | undefined;
+export declare function resolveCollectionContent(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): BaseCollectionContent | null;
+/**
+ * Resolves a PageContent entry from an unresolved link
+ * PageContent can be: Component, Collection, ExternalComponent, Visual (media/externalVideo), or PersonLink
+ */
+export declare function resolvePageContent(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): ITyped | null;
+/**
+ * Resolves all embedded entries and assets within a rich text document
+ * Recursively traverses the document tree and resolves link references
+ *
+ * @param context - The converter context with includes and assets maps
+ * @param richText - The unresolved rich text document from Contentful
+ * @returns The rich text document with all embedded content resolved
+ */
+export declare function resolveRichTextDocument(context: ConverterContext, fromId: string, richText: Document | undefined): {
+    json: Document;
+} | undefined;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/converters/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAId,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,OAAO,EACP,MAAM,EACP,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAA4B,cAAc,EAAE,MAAM,YAAY,CAAC;AAY3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAuDlD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,OAAO,GAAG,SAAS,CAOrB;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,aAAa,GAAG,SAAS,CAI3B;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,GAC7C,SAAS,aAAa,EAAE,GAAG,SAAS,CAMtC;AAgBD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,eAAe,GAAG,SAAS,CAO7B;AAGD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,qBAAqB,GAAG,IAAI,CA2E9B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,MAAM,GAAG,IAAI,CA+Hf;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,SAAS;UA0KH,QAAQ;cACpC"}

package/dist/converters/resolver.js

@@ -0,0 +1,383 @@
+import { INLINES, } from '@contentful/rich-text-types';
+import { arrayOrUndefined } from '../utils/index.js';
+import { convertExternalVideoEntryToVisual, convertMediaEntryToVisual } from './asset.js';
+import { lookupAsset, lookupDownloadAsset } from './helpers.js';
+import { baseSchemaConverter } from './schema.js';
+function resolveHelper(context, fromId, entry, getResolver) {
+    const id = entry.sys.id;
+    const possibleEntry = context.includes.get(id);
+    if (!possibleEntry) {
+        const message = `[CMS UNRESOLVED] entry ${id} (referenced from ${fromId}) not in includes map (${context.includes.size} entries loaded)`;
+        if (process.env.LOG_CMS) {
+            console.warn(message);
+        }
+        context.errors.push({ entryId: id, entryType: 'unknown', message, error: new Error(message) });
+        return undefined;
+    }
+    if (!possibleEntry.resolved) {
+        const resolver = getResolver(possibleEntry.type);
+        if (!resolver) {
+            const message = `No resolver found for link type ${possibleEntry.type} (id: ${id})`;
+            if (process.env.LOG_CMS) {
+                console.warn(message);
+            }
+            context.errors.push({
+                entryId: id,
+                entryType: possibleEntry.type,
+                message,
+                error: new Error(message),
+            });
+            return undefined;
+        }
+        const resolved = resolver(context, possibleEntry.entry);
+        possibleEntry.resolved = resolved;
+        return resolved;
+    }
+    return possibleEntry.resolved;
+}
+export function resolveSchema(context, fromId, entry) {
+    return resolveHelper(context, fromId, entry, () => baseSchemaConverter);
+}
+export function resolveLink(context, fromId, entry) {
+    return resolveHelper(context, fromId, entry, (type) => context.linkResolver.get(type));
+}
+export function resolveLinks(context, fromId, entries) {
+    return arrayOrUndefined(entries
+        ?.map((entry) => resolveLink(context, fromId, entry))
+        .filter((l) => l != null));
+}
+function resolveContent(context, fromId, entry) {
+    return resolveHelper(context, fromId, entry, (type) => {
+        const resolver = context.contentResolver.get(type);
+        return resolver;
+    });
+}
+export function resolveNavigationItem(context, fromId, entry) {
+    return resolveHelper(context, fromId, entry, () => context.navigationItemResolver);
+}
+export function resolveCollectionContent(context, fromId, entry) {
+    const id = entry.sys.id;
+    const possibleEntry = context.includes.get(id);
+    if (!possibleEntry) {
+        const message = `[CMS UNRESOLVED] collection entry ${id} (referenced from ${fromId}) not in includes map`;
+        if (process.env.LOG_CMS) {
+            console.warn(message);
+        }
+        context.errors.push({ entryId: id, entryType: 'unknown', message, error: new Error(message) });
+        return null;
+    }
+    // Return cached resolved entry if available
+    if (possibleEntry.resolved) {
+        return possibleEntry.resolved;
+    }
+    const { type } = possibleEntry;
+    // Handle Media - convert to IVisual
+    if (type === 'media') {
+        const visual = convertMediaEntryToVisual(context, possibleEntry.entry);
+        if (!visual) {
+            const message = `Failed to convert media entry with id ${id}`;
+            context.errors.push({ entryId: id, entryType: type, message, error: new Error(message) });
+            return null;
+        }
+        possibleEntry.resolved = visual;
+        return visual;
+    }
+    // Handle ExternalVideo - convert to IVisual
+    if (type === 'externalVideo') {
+        const visual = convertExternalVideoEntryToVisual(context, possibleEntry.entry);
+        if (!visual) {
+            const message = `Failed to convert externalVideo entry with id ${id}`;
+            context.errors.push({ entryId: id, entryType: type, message, error: new Error(message) });
+            return null;
+        }
+        possibleEntry.resolved = visual;
+        return visual;
+    }
+    // Fall back to resolver lookup for other types
+    return (resolveHelper(context, fromId, entry, (resolverType) => {
+        const resolver = context.contentResolver.get(resolverType);
+        if (resolver) {
+            return resolver;
+        }
+        const linkResolver = context.linkResolver.get(resolverType);
+        if (linkResolver) {
+            return linkResolver;
+        }
+        return undefined;
+    }) ?? null);
+}
+/**
+ * Resolves a PageContent entry from an unresolved link
+ * PageContent can be: Component, Collection, ExternalComponent, Visual (media/externalVideo), or PersonLink
+ */
+export function resolvePageContent(context, fromId, entry) {
+    const id = entry.sys.id;
+    const possibleEntry = context.includes.get(id);
+    if (!possibleEntry) {
+        const errorMessage = `Cannot find included entry for content from ${fromId} with id ${id}`;
+        const cmsError = {
+            entryId: id,
+            entryType: 'unknown',
+            message: errorMessage,
+            error: new Error(errorMessage),
+        };
+        context.errors.push(cmsError);
+        console.error(errorMessage);
+        return null;
+    }
+    const { type } = possibleEntry;
+    // Handle Media - convert to IVisual
+    if (type === 'media') {
+        try {
+            const visual = convertMediaEntryToVisual(context, possibleEntry.entry);
+            if (!visual) {
+                const errorMessage = `Failed to convert media entry with id ${id}`;
+                const cmsError = {
+                    entryId: id,
+                    entryType: type,
+                    message: errorMessage,
+                    error: new Error(errorMessage),
+                };
+                context.errors.push(cmsError);
+                console.error(errorMessage);
+                return null;
+            }
+            return visual;
+        }
+        catch (error) {
+            const errorMessage = `Error converting media entry with id ${id}: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            const cmsError = {
+                entryId: id,
+                entryType: type,
+                message: errorMessage,
+                error,
+            };
+            context.errors.push(cmsError);
+            console.error(errorMessage);
+            return null;
+        }
+    }
+    // Handle ExternalVideo - convert to IVisual
+    if (type === 'externalVideo') {
+        try {
+            const visual = convertExternalVideoEntryToVisual(context, possibleEntry.entry);
+            if (!visual) {
+                const errorMessage = `Failed to convert externalVideo entry with id ${id}`;
+                const cmsError = {
+                    entryId: id,
+                    entryType: type,
+                    message: errorMessage,
+                    error: new Error(errorMessage),
+                };
+                context.errors.push(cmsError);
+                console.error(errorMessage);
+                return null;
+            }
+            return visual;
+        }
+        catch (error) {
+            const errorMessage = `Error converting externalVideo entry with id ${id}: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            const cmsError = {
+                entryId: id,
+                entryType: type,
+                message: errorMessage,
+                error,
+            };
+            context.errors.push(cmsError);
+            console.error(errorMessage);
+            return null;
+        }
+    }
+    // // Handle ExternalComponent
+    // if (type === 'externalComponent') {
+    //   return resolveHelper<
+    //     TConfig,
+    //     BaseExternalComponentSkeleton<TConfig>,
+    //     TConfig['ExternalComponent']
+    //   >(context, entry, () => baseExternalComponentConverter);
+    // }
+    try {
+        if (context.contentResolver.has(type)) {
+            return resolveContent(context, fromId, entry) ?? null;
+        }
+        if (context.linkResolver.has(type)) {
+            return resolveLink(context, fromId, entry) ?? null;
+        }
+        const errorMessage = `Unknown content type "${type}" for entry with id ${id}`;
+        const cmsError = {
+            entryId: id,
+            entryType: type,
+            message: errorMessage,
+            error: new Error(errorMessage),
+        };
+        context.errors.push(cmsError);
+        console.error(errorMessage);
+        return null;
+    }
+    catch (error) {
+        const errorMessage = `Error resolving content entry with id ${id} of type ${type}: ${error instanceof Error ? error.message : 'Unknown error'}`;
+        const cmsError = {
+            entryId: id,
+            entryType: type,
+            message: errorMessage,
+            error,
+        };
+        context.errors.push(cmsError);
+        console.error(errorMessage);
+        return null;
+    }
+}
+/**
+ * Resolves all embedded entries and assets within a rich text document
+ * Recursively traverses the document tree and resolves link references
+ *
+ * @param context - The converter context with includes and assets maps
+ * @param richText - The unresolved rich text document from Contentful
+ * @returns The rich text document with all embedded content resolved
+ */
+export function resolveRichTextDocument(context, fromId, richText) {
+    if (!richText) {
+        return undefined;
+    }
+    // Track resolved entries to prevent infinite recursion
+    const resolvingEntries = new Set();
+    const resolvedEntries = new Set();
+    /** Process content array, filter null/undefined, and log when malformed (DEBUG) */
+    const processContent = (rawContent, resolveNodeFn, nodeType = 'unknown') => {
+        if (!rawContent)
+            return [];
+        const hasNulls = rawContent.some((c) => c == null);
+        if (hasNulls && process.env.LOG_CMS) {
+            console.warn('[resolveRichTextDocument] Content array has null/undefined:', {
+                fromId,
+                nodeType,
+                indices: rawContent
+                    .map((c, i) => (c == null ? i : null))
+                    .filter((i) => i !== null),
+            });
+        }
+        return rawContent.filter((n) => n != null).map(resolveNodeFn);
+    };
+    const resolveNode = (node) => {
+        // Handle embedded-entry-block nodes
+        const block = node;
+        if (block.data.target &&
+            'sys' in block.data.target &&
+            block.data.target.sys.linkType === 'Entry') {
+            const entryId = block.data.target.sys.id;
+            // Check for circular references
+            if (resolvingEntries.has(entryId)) {
+                if (process.env.LOG_CMS)
+                    console.warn(`Circular reference detected in rich text resolution for entry ${entryId}. Skipping to prevent infinite recursion.`);
+                // Return the node as-is to break the cycle
+                return {
+                    ...block,
+                    content: processContent(block.content, resolveNode, block.nodeType),
+                };
+            }
+            // Check if already resolved
+            if (resolvedEntries.has(entryId)) {
+                // Entry already resolved, skip to avoid duplicate work
+                return {
+                    ...block,
+                    content: processContent(block.content, resolveNode, block.nodeType),
+                };
+            }
+            try {
+                resolvingEntries.add(entryId);
+                const resolvedEntry = resolvePageContent(context, fromId, block.data.target);
+                resolvingEntries.delete(entryId);
+                resolvedEntries.add(entryId);
+                // If resolvePageContent returned null due to error, return node as-is
+                if (resolvedEntry === null) {
+                    return {
+                        ...block,
+                        content: processContent(block.content, resolveNode, block.nodeType),
+                    };
+                }
+                return {
+                    ...block,
+                    data: {
+                        ...block.data,
+                        target: resolvedEntry,
+                    },
+                    content: processContent(block.content, resolveNode, block.nodeType),
+                };
+            }
+            catch (error) {
+                resolvingEntries.delete(entryId); // Clean up on error
+                console.error(`Failed to resolve entry with id ${entryId}:`, error);
+                // Return the node as-is if resolution fails
+                return {
+                    ...block,
+                    content: processContent(block.content, resolveNode, block.nodeType),
+                };
+            }
+        }
+        if (block.data.target &&
+            'sys' in block.data.target &&
+            block.data.target.sys.linkType === 'Asset') {
+            const assetLink = block.data.target;
+            try {
+                // Inline asset hyperlinks render as download links (IDownloadAsset), not visuals.
+                if (node.nodeType === INLINES.ASSET_HYPERLINK) {
+                    const downloadAsset = lookupDownloadAsset(context, assetLink);
+                    if (downloadAsset) {
+                        return {
+                            ...block,
+                            data: {
+                                ...block.data,
+                                target: downloadAsset,
+                            },
+                            content: processContent(block.content, resolveNode, block.nodeType),
+                        };
+                    }
+                }
+                else {
+                    const resolvedAsset = lookupAsset(context, assetLink);
+                    if (resolvedAsset) {
+                        return {
+                            ...block,
+                            data: {
+                                ...block.data,
+                                target: resolvedAsset,
+                            },
+                            content: processContent(block.content, resolveNode, block.nodeType),
+                        };
+                    }
+                    // Fallback to lookupDownloadAsset for non-visual assets (e.g. PDFs)
+                    const downloadAsset = lookupDownloadAsset(context, assetLink);
+                    if (downloadAsset) {
+                        return {
+                            ...block,
+                            data: {
+                                ...block.data,
+                                target: downloadAsset,
+                            },
+                            content: processContent(block.content, resolveNode, block.nodeType),
+                        };
+                    }
+                }
+            }
+            catch (error) {
+                console.error(`Failed to resolve ${block.nodeType} asset with id ${assetLink.sys.id}:`, error);
+                // Return the node as-is if resolution fails
+                return {
+                    ...block,
+                    content: processContent(block.content, resolveNode, block.nodeType),
+                };
+            }
+        }
+        // For all other node types, recursively process content if present
+        return {
+            ...block,
+            content: processContent(block.content, resolveNode, block.nodeType),
+        };
+    };
+    // Cast the EntryFieldTypes.RichText to our working type
+    // Resolve the entire document tree
+    const resolved = resolveNode(richText);
+    // Cast back to the config's RichText type
+    return { json: resolved };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/converters/resolver.js.map

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

package/dist/converters/schema.d.ts

@@ -0,0 +1,14 @@
+import type { ISchema } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { BaseSchemaSkeleton } from '../baseTypes/baseSchema';
+import type { ConverterContext } from './helpers';
+/**
+ * Base converter for Schema entries to ISchema type
+ *
+ * @param context - Converter context
+ * @param entry - Contentful entry to convert
+ * @returns ISchema object
+ */
+export declare function baseSchemaConverter(_context: ConverterContext, entry: Entry<BaseSchemaSkeleton, DefaultChainModifier, string>): ISchema;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/converters/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC7D,OAAO,CAmBT"}

package/dist/converters/schema.js

@@ -0,0 +1,25 @@
+/**
+ * Base converter for Schema entries to ISchema type
+ *
+ * @param context - Converter context
+ * @param entry - Contentful entry to convert
+ * @returns ISchema object
+ */
+export function baseSchemaConverter(_context, entry) {
+    const { sys, fields } = entry;
+    const { cmsLabel, markup } = fields;
+    // markup is typed as Text (string) but may be a JSON field in older CMS configurations,
+    // which Contentful returns as a parsed object/array. Normalise all cases to a string:
+    // - string  → use as-is (new projects: free-text Mustache template)
+    // - object/array → JSON.stringify (older projects: pre-built JSON schema stored as JSON field)
+    // - null/undefined → empty string
+    const markupRaw = markup;
+    const markupString = typeof markupRaw === 'string' ? markupRaw : markupRaw != null ? JSON.stringify(markupRaw) : '';
+    return {
+        id: sys.id,
+        name: cmsLabel,
+        markup: markupString,
+        description: `Schema for ${cmsLabel}`,
+    };
+}
+//# sourceMappingURL=schema.js.map