@se-studio/contentful-rest-api 1.0.46 → 1.0.48

package/dist/converters/page.js

@@ -0,0 +1,121 @@
+import { addPositionMetadata, calculateContentCount, createInternalLink, lookupAsset, makeContentfulDescription, makeContentfulTitle, } from './helpers';
+import { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, } from './iconCollector';
+import { resolveNavigation } from './navigationItem';
+import { resolveLink, resolvePageContent, resolveSchema } from './resolver';
+import { resolveTemplate } from './template';
+/**
+ * Base converter for Contentful Page entries to IPage type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param entry - Contentful entry to convert
+ * @returns IPage object
+ *
+ * @example
+ * ```ts
+ * const page = basePageConverter(contentfulEntry);
+ * ```
+ */
+export function basePageConverter(context, entry) {
+    const { sys: { id }, fields, } = entry;
+    const { slug, title, description, featuredImage, tags, content, menu: pageMenu, footer: pageFooter, template: templateLink, topContent: topContentLinks, bottomContent: bottomContentLinks, structuredData, ...simpleFields } = fields;
+    const pageMenuNav = pageMenu ? resolveNavigation(context, pageMenu) : undefined;
+    const pageFooterNav = pageFooter ? resolveNavigation(context, pageFooter) : undefined;
+    // Resolve template (if exists)
+    const template = templateLink ? resolveTemplate(context, templateLink) : null;
+    // Resolve all content sections
+    const topContent = topContentLinks
+        ?.map((c) => resolvePageContent(context, id, c))
+        .filter((item) => item !== null) ?? [];
+    const pageContent = content
+        ?.map((c) => resolvePageContent(context, id, c))
+        .filter((item) => item !== null) ?? [];
+    const bottomContent = bottomContentLinks
+        ?.map((c) => resolvePageContent(context, id, c))
+        .filter((item) => item !== null) ?? [];
+    const preContent = template?.preContent ?? [];
+    const postContent = template?.postContent ?? [];
+    // Merge in correct order and add position metadata
+    const contents = addPositionMetadata([
+        ...topContent,
+        ...preContent,
+        ...pageContent,
+        ...postContent,
+        ...bottomContent,
+    ]);
+    // Determine final menu and footer (page-level overrides template)
+    const finalMenu = pageMenuNav ?? template?.menu;
+    const finalFooter = pageFooterNav ?? template?.footer;
+    // Collect and deduplicate all SVG icons from page content and navigation
+    const icons = deduplicateIcons(collectIconsFromContent(contents), collectIconsFromNavigation(finalMenu), collectIconsFromNavigation(finalFooter));
+    const page = {
+        type: 'Page',
+        id,
+        isHomePage: slug === 'index',
+        slug,
+        name: title,
+        title: makeContentfulTitle(title, id),
+        description: makeContentfulDescription(description, id),
+        featuredImage: lookupAsset(context, featuredImage),
+        tags: tags?.map((tag) => resolveLink(context, id, tag)),
+        contentCount: calculateContentCount(topContent, pageContent, bottomContent),
+        contents,
+        icons,
+        structuredData: structuredData
+            ?.map((link) => resolveSchema(context, id, link))
+            .filter((item) => item !== null),
+        ...simpleFields,
+        menu: finalMenu,
+        footer: finalFooter,
+    };
+    return page;
+}
+export function calculatePageHref(slug) {
+    if (slug === 'index') {
+        return '/';
+    }
+    return `/${slug}/`;
+}
+export function basePageLinkConverter(context, entry) {
+    const { sys: { id, contentType }, fields, } = entry;
+    if (contentType.sys.id !== 'page') {
+        throw new Error(`Invalid content type: expected "page", got "${contentType.sys.id}"`);
+    }
+    return createInternalLink(id, {
+        ...fields,
+        name: fields.cmsLabel,
+    }, context, context.urlCalculators.page(fields.slug), 'Page', { tags: fields.tags?.map((tag) => resolveLink(context, id, tag)) });
+}
+/**
+ * Calculates the href for a page variant page
+ * @param slug - Page variant slug
+ * @returns Page variant href path with trailing slash
+ */
+export function calculatePageVariantHref(slug) {
+    return `/${slug}/`;
+}
+/**
+ * Base converter for PageVariant entries to IInternalLink type
+ * Used when a page variant is referenced as a link in content
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful page variant entry to convert
+ * @returns IInternalLink object representing the page variant link
+ *
+ * @example
+ * ```ts
+ * const pageVariantLink = basePageVariantLinkConverter(context, pageVariantEntry);
+ * ```
+ */
+export function basePageVariantLinkConverter(context, entry) {
+    const { sys: { id, contentType }, fields, } = entry;
+    if (contentType.sys.id !== 'pageVariant') {
+        throw new Error(`Invalid content type: expected "pageVariant", got "${contentType.sys.id}"`);
+    }
+    return createInternalLink(id, {
+        ...fields,
+        name: fields.cmsLabel,
+    }, context, context.urlCalculators.pageVariant(fields.slug), 'Page', { tags: fields.tags?.map((tag) => resolveLink(context, id, tag)) });
+}
+//# sourceMappingURL=page.js.map

package/dist/converters/page.js.map

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

package/dist/converters/person.d.ts

@@ -0,0 +1,40 @@
+import type { BaseModelLinkOmissions, IBasePerson, IInternalLink } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier, IContentfulRichText } from '../api';
+import type { BaseCustomTypeSkeleton } from '../baseTypes/baseCustomType';
+import type { BasePersonSkeleton } from '../baseTypes/basePerson';
+import { type ConverterContext } from './helpers';
+export type IContentfulPerson = IBasePerson & {
+    bio?: IContentfulRichText | null;
+};
+export type ContentfulPersonLink = Omit<IContentfulPerson, BaseModelLinkOmissions | 'structuredData' | 'contents' | 'customType'>;
+/**
+ * Base converter for Person entries to IInternalLink type
+ * Used when a person is referenced as a link in content
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful person entry to convert
+ * @returns IInternalLink object representing the person link
+ *
+ * @example
+ * ```ts
+ * const personLink = basePersonLinkConverter(context, personEntry);
+ * ```
+ */
+export declare function basePersonLinkConverter(context: ConverterContext, entry: Entry<BasePersonSkeleton, DefaultChainModifier, string>): IInternalLink;
+/**
+ * Base converter for Person entries to IPerson type
+ * Used when a complete person object with bio and content is needed
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful person entry to convert
+ * @param customTypeEntry - Optional custom type entry that defines templates and navigation
+ * @returns IPerson object representing the complete person
+ *
+ * @example
+ * ```ts
+ * const person = basePersonConverter(context, personEntry, customTypeEntry);
+ * ```
+ */
+export declare function basePersonConverter(context: ConverterContext, entry: Entry<BasePersonSkeleton, DefaultChainModifier, string>, customTypeEntry?: Entry<BaseCustomTypeSkeleton, DefaultChainModifier, string>): IContentfulPerson;
+//# sourceMappingURL=person.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"person.d.ts","sourceRoot":"","sources":["../../src/converters/person.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,aAAa,EAGd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAEL,KAAK,gBAAgB,EAKtB,MAAM,WAAW,CAAC;AAUnB,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,GAAG,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,EACjB,sBAAsB,GAAG,gBAAgB,GAAG,UAAU,GAAG,YAAY,CACtE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC7D,aAAa,CAwCf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAC9D,eAAe,CAAC,EAAE,KAAK,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC5E,iBAAiB,CA6EnB"}

package/dist/converters/person.js

@@ -0,0 +1,109 @@
+import { addPositionMetadata, calculateContentCount, createInternalLink, lookupAsset, makeContentfulTitle, } from './helpers';
+import { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, } from './iconCollector';
+import { resolveNavigation } from './navigationItem';
+import { resolvePageContent, resolveRichTextDocument, resolveSchema } from './resolver';
+import { resolveTemplate } from './template';
+/**
+ * Base converter for Person entries to IInternalLink type
+ * Used when a person is referenced as a link in content
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful person entry to convert
+ * @returns IInternalLink object representing the person link
+ *
+ * @example
+ * ```ts
+ * const personLink = basePersonLinkConverter(context, personEntry);
+ * ```
+ */
+export function basePersonLinkConverter(context, entry) {
+    const { sys, fields } = entry;
+    const { name, bio: fieldsBio, jobTitle, phoneNumber, emailAddress, linkedIn, location, media, ...simpleFields } = fields;
+    if (sys.contentType.sys.id !== 'person') {
+        throw new Error(`Invalid content type: expected "person", got "${sys.contentType.sys.id}"`);
+    }
+    const title = makeContentfulTitle(name, sys.id);
+    return createInternalLink(sys.id, {
+        ...simpleFields,
+        name,
+        title,
+        featuredImage: media,
+        cmsLabel: title,
+    }, context, context.urlCalculators.person(fields.slug), 'Person', {
+        bio: resolveRichTextDocument(context, sys.id, fieldsBio),
+        jobTitle,
+        phoneNumber,
+        emailAddress,
+        linkedIn,
+        location,
+    });
+}
+/**
+ * Base converter for Person entries to IPerson type
+ * Used when a complete person object with bio and content is needed
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful person entry to convert
+ * @param customTypeEntry - Optional custom type entry that defines templates and navigation
+ * @returns IPerson object representing the complete person
+ *
+ * @example
+ * ```ts
+ * const person = basePersonConverter(context, personEntry, customTypeEntry);
+ * ```
+ */
+export function basePersonConverter(context, entry, customTypeEntry) {
+    const { sys: { id, contentType }, fields, } = entry;
+    if (contentType.sys.id !== 'person') {
+        throw new Error(`Invalid content type: expected "person", got "${contentType.sys.id}"`);
+    }
+    const { slug, name, description, media, bio: bioField, content: contentLinks, structuredData, ...rest } = fields;
+    // Resolve custom type (if provided)
+    const customType = customTypeEntry
+        ? context.customTypeResolver(context, customTypeEntry)
+        : undefined;
+    // Resolve template from custom type (if provided)
+    const template = customTypeEntry?.fields.template
+        ? resolveTemplate(context, customTypeEntry.fields.template)
+        : null;
+    // Resolve content sections
+    const personContent = contentLinks
+        ?.map((c) => resolvePageContent(context, id, c))
+        .filter((item) => item !== null) ?? [];
+    const preContent = template?.preContent ?? [];
+    const postContent = template?.postContent ?? [];
+    // Merge in correct order and add position metadata
+    const contents = addPositionMetadata([...preContent, ...personContent, ...postContent]);
+    // Resolve navigation (template level or from custom type)
+    // Note: Person doesn't have direct menu/footer overrides, so we rely on the custom type/template
+    const menu = customTypeEntry?.fields.menu
+        ? resolveNavigation(context, customTypeEntry.fields.menu)
+        : template?.menu;
+    const footer = customTypeEntry?.fields.footer
+        ? resolveNavigation(context, customTypeEntry.fields.footer)
+        : template?.footer;
+    // Collect and deduplicate all SVG icons
+    const icons = deduplicateIcons(collectIconsFromContent(contents), collectIconsFromNavigation(menu), collectIconsFromNavigation(footer));
+    return {
+        type: 'Person',
+        id,
+        slug,
+        name,
+        title: makeContentfulTitle(name, id),
+        description: description ?? `Description for ${id}`,
+        featuredImage: lookupAsset(context, media), // Person uses 'media' not 'featuredImage'
+        href: context.urlCalculators.person(slug),
+        bio: resolveRichTextDocument(context, id, bioField) ?? null,
+        contentCount: calculateContentCount(personContent),
+        contents,
+        menu,
+        footer,
+        icons,
+        customType,
+        structuredData: structuredData
+            ?.map((link) => resolveSchema(context, id, link))
+            .filter((item) => item !== null),
+        ...rest,
+    };
+}
+//# sourceMappingURL=person.js.map

package/dist/converters/person.js.map

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

package/dist/converters/resolver.d.ts

@@ -0,0 +1,29 @@
+import type { Document } from '@contentful/rich-text-types';
+import type { BaseCollectionContent, IInternalLink, INavigationItem, ISchema, ITyped } from '@se-studio/core-data-types';
+import type { Entry, EntrySkeletonType, UnresolvedLink } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { ConverterContext } from './helpers';
+export declare function resolveHelper<TEntrySkeletonType extends EntrySkeletonType, TResult>(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>, getResolver: (type: string) => ((context: ConverterContext, entry: Entry<TEntrySkeletonType, DefaultChainModifier, string>) => TResult) | undefined): TResult;
+export declare function resolveSchema(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): ISchema;
+export declare function resolveLink(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): IInternalLink;
+export declare function resolveLinks(context: ConverterContext, fromId: string, entries: UnresolvedLink<'Entry'>[] | undefined): readonly IInternalLink[] | undefined;
+export declare function resolveContent(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): ITyped;
+export declare function resolveNavigationItem(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): INavigationItem;
+export declare function resolveCollectionContent(context: ConverterContext, fromId: string, entry: UnresolvedLink<'Entry'>): BaseCollectionContent;
+/**
+ * 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,KAAK,EAAS,QAAQ,EAAgB,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,OAAO,EACP,MAAM,EACP,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAWnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIlD,wBAAgB,aAAa,CAAC,kBAAkB,SAAS,iBAAiB,EAAE,OAAO,EACjF,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,WAAW,EAAE,CACX,IAAI,EAAE,MAAM,KAEV,CAAC,CACC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,CAAC,KAC3D,OAAO,CAAC,GACb,SAAS,GACZ,OAAO,CAyBT;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,OAAO,CAOT;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,aAAa,CAIf;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,CAEtC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,eAAe,CAQjB;AAGD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,qBAAqB,CAkEvB;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;UA2HH,QAAQ;cACpC"}

package/dist/converters/resolver.js

@@ -0,0 +1,317 @@
+import { arrayOrUndefined } from '../utils';
+import { convertExternalVideoEntryToVisual, convertMediaEntryToVisual } from './asset';
+import { lookupAsset } from './helpers';
+import { baseSchemaConverter } from './schema';
+export function resolveHelper(context, fromId, entry, getResolver) {
+    const id = entry.sys.id;
+    const possibleEntry = context.includes.get(id);
+    if (!possibleEntry) {
+        throw new Error(`Cannot find included entry for link from ${fromId} with id ${id}`);
+    }
+    if (!possibleEntry.resolved) {
+        const resolver = getResolver(possibleEntry.type);
+        if (!resolver) {
+            throw new Error(`No resolver found for link type ${possibleEntry.type} (${JSON.stringify(possibleEntry)}) [${JSON.stringify(entry)}]`);
+        }
+        if (typeof resolver !== 'function') {
+            console.log('Resolver type', possibleEntry.type, typeof resolver, resolver);
+        }
+        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)));
+}
+export 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) {
+    const result = resolveHelper(context, fromId, entry, () => context.navigationItemResolver);
+    return result;
+}
+export function resolveCollectionContent(context, fromId, entry) {
+    const id = entry.sys.id;
+    const possibleEntry = context.includes.get(id);
+    if (!possibleEntry) {
+        throw new Error(`Cannot find included entry for collection content from ${fromId} with id ${id}`);
+    }
+    // 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) {
+            throw new Error(`Failed to convert media entry with id ${id}`);
+        }
+        possibleEntry.resolved = visual;
+        return visual;
+    }
+    // Handle ExternalVideo - convert to IVisual
+    if (type === 'externalVideo') {
+        const visual = convertExternalVideoEntryToVisual(context, possibleEntry.entry);
+        if (!visual) {
+            throw new Error(`Failed to convert externalVideo entry with id ${id}`);
+        }
+        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;
+    });
+}
+/**
+ * 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);
+        }
+        if (context.linkResolver.has(type)) {
+            return resolveLink(context, fromId, entry);
+        }
+        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();
+    const resolveNode = (node) => {
+        // Handle embedded-entry-block nodes
+        if (!('content' in node)) {
+            return node;
+        }
+        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)) {
+                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: block.content?.map(resolveNode),
+                };
+            }
+            // Check if already resolved
+            if (resolvedEntries.has(entryId)) {
+                // Entry already resolved, skip to avoid duplicate work
+                return {
+                    ...block,
+                    content: block.content?.map(resolveNode),
+                };
+            }
+            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: block.content?.map(resolveNode),
+                    };
+                }
+                return {
+                    ...block,
+                    data: {
+                        ...block.data,
+                        target: resolvedEntry,
+                    },
+                    content: block.content?.map(resolveNode),
+                };
+            }
+            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: block.content?.map(resolveNode),
+                };
+            }
+        }
+        if (block.data.target &&
+            'sys' in block.data.target &&
+            block.data.target.sys.linkType === 'Asset') {
+            try {
+                const resolvedAsset = lookupAsset(context, block.data.target);
+                if (resolvedAsset) {
+                    return {
+                        ...block,
+                        data: {
+                            ...block.data,
+                            target: resolvedAsset,
+                        },
+                        content: block.content?.map(resolveNode),
+                    };
+                }
+            }
+            catch (error) {
+                console.error(`Failed to resolve embedded-asset-block with id ${block.data.target.sys.id}:`, error);
+                // Return the node as-is if resolution fails
+                return {
+                    ...block,
+                    content: block.content?.map(resolveNode),
+                };
+            }
+        }
+        // For all other node types, recursively process content if present
+        return {
+            ...block,
+            content: block.content?.map(resolveNode),
+        };
+    };
+    // 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