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

package/dist/converters/collection.js

@@ -0,0 +1,50 @@
+import { createResponsiveVisual, lookupMediaEntry } from './asset';
+import { DEFAULT_POSITION_FIELDS, lookupAsset, lookupIconAsset, } from './helpers';
+import { resolveCollectionContent, resolveLink, resolveRichTextDocument } from './resolver';
+/**
+ * Base converter for Contentful Collection entries to ICollection type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful entry to convert
+ * @returns ICollection object
+ *
+ * @example
+ * ```ts
+ * const collection = baseCollectionConverter(context, contentfulEntry);
+ * ```
+ */
+export function baseCollectionConverter(context, entry) {
+    const { sys, fields } = entry;
+    const { id } = sys;
+    // Destructure to exclude fields that need special handling
+    const { 
+    // Fields requiring transformation
+    backgroundVisual: bgVisual, mobileBackgroundVisual: mobileBgVisual, visual: visualField, mobileVisual: mobileVisualField, visualCustomSize, icon: iconField, links: linksField, contents: contentsField, body: bodyField, additionalCopy: additionalCopyField, showHeading, heading, 
+    // Already handled elsewhere
+    cmsLabel, ...simpleFields // anchor, backgroundColour, textColour, preHeading, heading, postHeading, backgroundOverlayOpacity
+     } = fields;
+    // Convert background visuals to responsive visual
+    const backgroundVisual = createResponsiveVisual(lookupAsset(context, bgVisual), lookupAsset(context, mobileBgVisual));
+    const visual = createResponsiveVisual(lookupMediaEntry(context, visualField), lookupMediaEntry(context, mobileVisualField), visualCustomSize);
+    const collection = {
+        type: 'Collection',
+        id,
+        name: cmsLabel,
+        cmsLabel,
+        ...DEFAULT_POSITION_FIELDS,
+        ...simpleFields,
+        heading: showHeading ? heading : undefined,
+        body: resolveRichTextDocument(context, id, bodyField),
+        additionalCopy: resolveRichTextDocument(context, id, additionalCopyField),
+        icon: lookupIconAsset(context, iconField),
+        backgroundVisual,
+        visual,
+        links: linksField?.map((link) => resolveLink(context, id, link)),
+        contents: contentsField?.map((content) => resolveCollectionContent(context, id, content)),
+    };
+    return collection;
+}
+//# sourceMappingURL=collection.js.map

package/dist/converters/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/converters/collection.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAEL,uBAAuB,EACvB,WAAW,EACX,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAQ5F;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAyB,EACzB,KAAkE;IAElE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC;IACnB,2DAA2D;IAC3D,MAAM;IACJ,kCAAkC;IAClC,gBAAgB,EAAE,QAAQ,EAC1B,sBAAsB,EAAE,cAAc,EACtC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,iBAAiB,EAC/B,gBAAgB,EAChB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,SAAS,EACf,cAAc,EAAE,mBAAmB,EACnC,WAAW,EACX,OAAO;IACP,4BAA4B;IAC5B,QAAQ,EACR,GAAG,YAAY,CAAC,mGAAmG;MACpH,GAAG,MAAM,CAAC;IAEX,kDAAkD;IAClD,MAAM,gBAAgB,GAAG,sBAAsB,CAC7C,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC9B,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CACrC,CAAC;IAEF,MAAM,MAAM,GAAG,sBAAsB,CACnC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,EACtC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAC5C,gBAAgB,CACjB,CAAC;IAEF,MAAM,UAAU,GAA0B;QACxC,IAAI,EAAE,YAAY;QAClB,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,QAAQ;QACR,GAAG,uBAAuB;QAC1B,GAAG,YAAY;QACf,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC1C,IAAI,EAAE,uBAAuB,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC;QACrD,cAAc,EAAE,uBAAuB,CAAC,OAAO,EAAE,EAAE,EAAE,mBAAmB,CAAC;QACzE,IAAI,EAAE,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC;QACzC,gBAAgB;QAChB,MAAM;QACN,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAChE,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,wBAAwB,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;KAC1F,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/converters/component.d.ts

@@ -0,0 +1,26 @@
+import type { IBaseComponent } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier, IContentfulRichText } from '../api';
+import type { BaseComponentSkeleton } from '../baseTypes/baseComponent';
+import { type ConverterContext } from './helpers';
+export type IContentfulComponent = IBaseComponent & {
+    body?: IContentfulRichText | null;
+    additionalCopy?: IContentfulRichText | null;
+};
+/**
+ * Base converter for Contentful Component entries to IComponent type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful entry to convert
+ * @returns IComponent object
+ *
+ * @example
+ * ```ts
+ * const component = baseComponentConverter(context, contentfulEntry);
+ * ```
+ */
+export declare function baseComponentConverter(context: ConverterContext, entry: Entry<BaseComponentSkeleton, DefaultChainModifier, string>): IContentfulComponent;
+//# sourceMappingURL=component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/converters/component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,WAAW,CAAC;AAGnB,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC7C,CAAC;AACF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAChE,oBAAoB,CAwDtB"}

package/dist/converters/component.js

@@ -0,0 +1,54 @@
+import { arrayOrUndefined, notEmpty } from '../utils';
+import { createResponsiveVisual, lookupMediaEntry } from './asset';
+import { DEFAULT_POSITION_FIELDS, lookupAsset, lookupIconAsset, } from './helpers';
+import { resolveLinks, resolveRichTextDocument } from './resolver';
+/**
+ * Base converter for Contentful Component entries to IComponent type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful entry to convert
+ * @returns IComponent object
+ *
+ * @example
+ * ```ts
+ * const component = baseComponentConverter(context, contentfulEntry);
+ * ```
+ */
+export function baseComponentConverter(context, entry) {
+    const { sys, fields } = entry;
+    const { id } = sys;
+    // Destructure to exclude fields that need special handling
+    const { 
+    // Fields requiring transformation
+    backgroundVisual: bgVisual, mobileBackgroundVisual: mobileBgVisual, visual: visualField, mobileVisual: mobileVisualField, visualCustomSize, icon: iconField, links: linksField, body: bodyField, additionalCopy: additionalCopyField, 
+    // Field name change
+    showHeading, heading, otherMedia: otherMediaField, 
+    // Already handled elsewhere
+    cmsLabel, ...simpleFields // anchor, backgroundColour, textColour, preHeading, heading, postHeading, backgroundOverlayOpacity
+     } = fields;
+    // Convert background visuals to responsive visual
+    const backgroundVisual = createResponsiveVisual(lookupAsset(context, bgVisual), lookupAsset(context, mobileBgVisual));
+    const visual = createResponsiveVisual(lookupMediaEntry(context, visualField), lookupMediaEntry(context, mobileVisualField), visualCustomSize);
+    const otherMedia = otherMediaField?.map((media) => lookupAsset(context, media));
+    const component = {
+        type: 'Component',
+        id,
+        name: cmsLabel,
+        cmsLabel,
+        ...DEFAULT_POSITION_FIELDS,
+        ...simpleFields,
+        heading: showHeading ? heading : undefined,
+        body: resolveRichTextDocument(context, id, bodyField),
+        additionalCopy: resolveRichTextDocument(context, id, additionalCopyField),
+        icon: lookupIconAsset(context, iconField),
+        backgroundVisual,
+        visual,
+        links: resolveLinks(context, id, linksField),
+        otherMedia: arrayOrUndefined(otherMedia?.filter(notEmpty)),
+    };
+    return component;
+}
+//# sourceMappingURL=component.js.map

package/dist/converters/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/converters/component.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAEL,uBAAuB,EACvB,WAAW,EACX,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAMnE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAyB,EACzB,KAAiE;IAEjE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC;IAEnB,2DAA2D;IAC3D,MAAM;IACJ,kCAAkC;IAClC,gBAAgB,EAAE,QAAQ,EAC1B,sBAAsB,EAAE,cAAc,EACtC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,iBAAiB,EAC/B,gBAAgB,EAChB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,cAAc,EAAE,mBAAmB;IACnC,oBAAoB;IACpB,WAAW,EACX,OAAO,EACP,UAAU,EAAE,eAAe;IAC3B,4BAA4B;IAC5B,QAAQ,EACR,GAAG,YAAY,CAAC,mGAAmG;MACpH,GAAG,MAAM,CAAC;IAEX,kDAAkD;IAClD,MAAM,gBAAgB,GAAG,sBAAsB,CAC7C,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC9B,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CACrC,CAAC;IAEF,MAAM,MAAM,GAAG,sBAAsB,CACnC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,EACtC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAC5C,gBAAgB,CACjB,CAAC;IAEF,MAAM,UAAU,GAAG,eAAe,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAEhF,MAAM,SAAS,GAAyB;QACtC,IAAI,EAAE,WAAW;QACjB,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,QAAQ;QACR,GAAG,uBAAuB;QAC1B,GAAG,YAAY;QACf,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC1C,IAAI,EAAE,uBAAuB,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC;QACrD,cAAc,EAAE,uBAAuB,CAAC,OAAO,EAAE,EAAE,EAAE,mBAAmB,CAAC;QACzE,IAAI,EAAE,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC;QACzC,gBAAgB;QAChB,MAAM;QACN,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC;QAC5C,UAAU,EAAE,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;KAC3D,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/converters/customType.d.ts

@@ -0,0 +1,24 @@
+import type { IBaseCustomType, IInternalLink } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { BaseCustomTypeSkeleton } from '../baseTypes/baseCustomType';
+import { type ConverterContext } from './helpers';
+/**
+ * Base converter for Contentful Custom Type entries to IBaseCustomType
+ *
+ * Custom types represent index pages for categories like Topics or Resources.
+ * They provide configuration for both the main index page and potentially
+ * individual entry pages.
+ *
+ * @param context - Converter context containing includes and assets
+ * @param entry - Contentful entry to convert
+ * @returns IBaseCustomType object
+ *
+ * @example
+ * ```ts
+ * const customType = baseCustomTypeConverter(context, contentfulEntry);
+ * ```
+ */
+export declare function baseCustomTypeConverter(context: ConverterContext, entry: Entry<BaseCustomTypeSkeleton, DefaultChainModifier, string>): IBaseCustomType;
+export declare function baseCustomTypeLinkConverter(context: ConverterContext, entry: Entry<BaseCustomTypeSkeleton, DefaultChainModifier, string>): IInternalLink;
+//# sourceMappingURL=customType.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customType.d.ts","sourceRoot":"","sources":["../../src/converters/customType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAmB,MAAM,4BAA4B,CAAC;AAClG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAEL,KAAK,gBAAgB,EAKtB,MAAM,WAAW,CAAC;AAUnB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GACjE,eAAe,CAkEjB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GACjE,aAAa,CAgBf"}

package/dist/converters/customType.js

@@ -0,0 +1,71 @@
+import { addPositionMetadata, createInternalLink, lookupAsset, makeContentfulDescription, makeContentfulTitle, } from './helpers';
+import { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, } from './iconCollector';
+import { resolveNavigation } from './navigationItem';
+import { resolvePageContent, resolveSchema } from './resolver';
+import { resolveTemplate } from './template';
+/**
+ * Base converter for Contentful Custom Type entries to IBaseCustomType
+ *
+ * Custom types represent index pages for categories like Topics or Resources.
+ * They provide configuration for both the main index page and potentially
+ * individual entry pages.
+ *
+ * @param context - Converter context containing includes and assets
+ * @param entry - Contentful entry to convert
+ * @returns IBaseCustomType object
+ *
+ * @example
+ * ```ts
+ * const customType = baseCustomTypeConverter(context, contentfulEntry);
+ * ```
+ */
+export function baseCustomTypeConverter(context, entry) {
+    const { sys, fields } = entry;
+    const { id } = sys;
+    const { name, slug, indexPageTitle, indexPageDescription, featuredImage, menu: menuLink, footer: footerLink, indexPageTemplate: templateLink, indexPageTopContent: topContentLinks, structuredData, indexPageStructuredData, ...other } = fields;
+    // Resolve template (if exists)
+    const template = templateLink ? resolveTemplate(context, templateLink) : null;
+    // Resolve navigation
+    const menu = menuLink ? resolveNavigation(context, menuLink) : template?.menu;
+    const footer = footerLink ? resolveNavigation(context, footerLink) : template?.footer;
+    // Resolve all content sections
+    const topContent = topContentLinks
+        ?.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, ...postContent]);
+    // Collect and deduplicate all SVG icons from custom type content and navigation
+    const icons = deduplicateIcons(collectIconsFromContent(contents), collectIconsFromNavigation(menu), collectIconsFromNavigation(footer));
+    const title = makeContentfulTitle(indexPageTitle, sys.id);
+    const description = makeContentfulDescription(indexPageDescription, sys.id);
+    const customType = {
+        type: 'Custom type',
+        id,
+        slug,
+        name,
+        title,
+        description: description,
+        featuredImage: lookupAsset(context, featuredImage),
+        contentCount: 0,
+        contents,
+        icons,
+        structuredData: [
+            ...(structuredData?.map((link) => resolveSchema(context, id, link)) ?? []),
+            ...(indexPageStructuredData?.map((link) => resolveSchema(context, id, link)) ?? []),
+        ].filter((item) => item !== null),
+        menu,
+        footer,
+        ...other,
+    };
+    return customType;
+}
+export function baseCustomTypeLinkConverter(context, entry) {
+    const { sys: { id, contentType }, fields, } = entry;
+    if (contentType.sys.id !== 'customType') {
+        throw new Error(`Invalid content type: expected "customType", got "${contentType.sys.id}"`);
+    }
+    return createInternalLink(id, fields, context, context.urlCalculators.customType(fields.slug), 'CustomType');
+}
+//# sourceMappingURL=customType.js.map

package/dist/converters/customType.js.map

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

package/dist/converters/externalComponent.d.ts

@@ -0,0 +1,22 @@
+import type { IBaseExternalComponent } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { BaseExternalComponentSkeleton } from '../baseTypes/baseExternalComponent';
+import { type ConverterContext } from './helpers';
+/**
+ * Base converter for Contentful ExternalComponent entries to IExternalComponent type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful entry to convert
+ * @returns IExternalComponent object
+ *
+ * @example
+ * ```ts
+ * const externalComponent = baseExternalComponentConverter(context, contentfulEntry);
+ * ```
+ */
+export declare function baseExternalComponentConverter(context: ConverterContext, entry: Entry<BaseExternalComponentSkeleton, DefaultChainModifier, string>): IBaseExternalComponent;
+//# sourceMappingURL=externalComponent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"externalComponent.d.ts","sourceRoot":"","sources":["../../src/converters/externalComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAExF,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,6BAA6B,EAAE,oBAAoB,EAAE,MAAM,CAAC,GACxE,sBAAsB,CA0BxB"}

package/dist/converters/externalComponent.js

@@ -0,0 +1,34 @@
+import { createResponsiveVisual } from './asset';
+import { DEFAULT_POSITION_FIELDS, lookupAsset, makeContentfulTitle, } from './helpers';
+/**
+ * Base converter for Contentful ExternalComponent entries to IExternalComponent type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful entry to convert
+ * @returns IExternalComponent object
+ *
+ * @example
+ * ```ts
+ * const externalComponent = baseExternalComponentConverter(context, contentfulEntry);
+ * ```
+ */
+export function baseExternalComponentConverter(context, entry) {
+    const { sys, fields } = entry;
+    const { cmsLabel, backgroundVisual: bgVisual, mobileBackgroundVisual: mobileBgVisual, ...simpleFields } = fields;
+    // Convert background visuals to responsive visual
+    const backgroundVisual = createResponsiveVisual(lookupAsset(context, bgVisual), lookupAsset(context, mobileBgVisual));
+    const externalComponent = {
+        type: 'External component',
+        id: sys.id,
+        name: makeContentfulTitle(cmsLabel, sys.id),
+        cmsLabel: cmsLabel,
+        ...DEFAULT_POSITION_FIELDS,
+        ...simpleFields,
+        backgroundVisual,
+    };
+    return externalComponent;
+}
+//# sourceMappingURL=externalComponent.js.map

package/dist/converters/externalComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalComponent.js","sourceRoot":"","sources":["../../src/converters/externalComponent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAEL,uBAAuB,EACvB,WAAW,EACX,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAyB,EACzB,KAAyE;IAEzE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9B,MAAM,EACJ,QAAQ,EACR,gBAAgB,EAAE,QAAQ,EAC1B,sBAAsB,EAAE,cAAc,EACtC,GAAG,YAAY,EAChB,GAAG,MAAM,CAAC;IAEX,kDAAkD;IAClD,MAAM,gBAAgB,GAAG,sBAAsB,CAC7C,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC9B,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CACrC,CAAC;IAEF,MAAM,iBAAiB,GAA2B;QAChD,IAAI,EAAE,oBAAoB;QAC1B,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;QAC3C,QAAQ,EAAE,QAAQ;QAClB,GAAG,uBAAuB;QAC1B,GAAG,YAAY;QACf,gBAAgB;KACjB,CAAC;IACF,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/converters/helpers.d.ts

@@ -0,0 +1,116 @@
+import type { IDownloadAsset, IInternalLink, InternalType, ITyped, IVisual } from '@se-studio/core-data-types';
+import type { Asset, Entry, UnresolvedLink } from 'contentful';
+import type { DefaultChainModifier, PossibleResolvedEntry } from '../api';
+import type { BaseContent, BaseLink } from '../baseTypes/baseShared';
+import type { CmsError } from '../types';
+import type { baseArticleConverter, baseArticleTypeConverter } from './article';
+import type { baseCollectionConverter } from './collection';
+import type { baseComponentConverter } from './component';
+import type { baseCustomTypeConverter } from './customType';
+import type { baseNavigationItemConverter } from './navigationItem';
+import type { basePageConverter } from './page';
+import type { baseTagConverter } from './tag';
+export declare function resolveBuildYear(value: string): string;
+export declare function makeContentfulTitle(title: string | undefined | null, id: string, prefix?: string): string;
+export declare function stringOrUndefined(value: string | null | undefined): string | undefined;
+export declare function makeContentfulDescription(description: string | undefined | null, id: string): string;
+export declare function lookupAsset(context: ConverterContext, asset: UnresolvedLink<'Asset'> | undefined): IVisual | undefined;
+/**
+ * Looks up an asset that is used as an icon.
+ * If the asset is an SVG image, it marks it with isIcon: true so it uses the sprite system.
+ */
+export declare function lookupIconAsset(context: ConverterContext, asset: UnresolvedLink<'Asset'> | undefined): IVisual | undefined;
+/**
+ * Looks up a raw asset and converts it to IDownloadAsset for download functionality.
+ * Returns undefined if the asset doesn't exist or doesn't have a valid file.
+ */
+export declare function lookupDownloadAsset(context: ConverterContext, asset: UnresolvedLink<'Asset'> | undefined): IDownloadAsset | undefined;
+/**
+ * Default positioning fields for content items before they are processed
+ */
+export declare const DEFAULT_POSITION_FIELDS: {
+    readonly index: 0;
+    readonly isFirst: false;
+    readonly isLast: false;
+    readonly indexOfType: 0;
+};
+/**
+ * Creates an internal link object with common fields
+ * Used by multiple converters (tag, page, article, person) to reduce duplication
+ */
+export declare function createInternalLink(id: string, fields: {
+    cmsLabel?: string | null;
+    name: string | null;
+    useName?: boolean | null;
+    title?: string | null;
+    featuredImage?: UnresolvedLink<'Asset'>;
+    backgroundColour?: string | null;
+    textColour?: string | null;
+    indexed?: boolean | null;
+    hidden?: boolean | null;
+    slug: string;
+    description?: string | null;
+}, context: ConverterContext, href: string, internalType: InternalType, additionalProps?: any): IInternalLink;
+export type ContentResolverFunction = (context: ConverterContext, entry: Entry<BaseContent, DefaultChainModifier, string>) => unknown;
+export type ContentResolverMap = Map<string, ContentResolverFunction>;
+export type LinkResolverFunction<TResult extends IInternalLink = IInternalLink> = (context: ConverterContext, entry: Entry<BaseLink, DefaultChainModifier, string>) => TResult;
+export type LinkResolverMap = Map<string, LinkResolverFunction>;
+/**
+ * URL calculators for each content type.
+ * Apps can override these to customize URL patterns.
+ */
+export type UrlCalculators = {
+    page: (slug: string) => string;
+    pageVariant: (slug: string) => string;
+    article: (articleTypeSlug: string, slug: string, primaryTagSlug?: string) => string;
+    articleType: (slug: string) => string;
+    tag: (slug: string) => string;
+    person: (slug: string) => string;
+    customType: (slug: string) => string;
+};
+export type BaseConverterContext = {
+    videoPrefix: string;
+    /**
+     * Resolves a mask dropdown value (e.g., 'Rounded diamond') to a URL.
+     * Each project provides its own implementation with project-specific masks.
+     */
+    maskResolver?: (maskName: string) => string | undefined;
+    /**
+     * URL calculators for each content type.
+     * Apps can override these to customize URL patterns for links, sitemaps, and preview.
+     */
+    urlCalculators: UrlCalculators;
+    linkResolver: LinkResolverMap;
+    contentResolver: Map<string, (context: ConverterContext, entry: Entry<BaseContent, DefaultChainModifier, string>) => unknown>;
+    navigationItemResolver: typeof baseNavigationItemConverter;
+    pageResolver: typeof basePageConverter;
+    articleResolver: typeof baseArticleConverter;
+    articleTypeResolver: typeof baseArticleTypeConverter;
+    tagResolver: typeof baseTagConverter;
+    personResolver: typeof import('./person').basePersonConverter;
+    customTypeResolver: typeof baseCustomTypeConverter;
+    componentResolver: typeof baseComponentConverter;
+    collectionResolver: typeof baseCollectionConverter;
+};
+export type ConverterContext = BaseConverterContext & {
+    includes: Map<string, PossibleResolvedEntry>;
+    assets: Map<string, IVisual>;
+    rawAssets: Map<string, Asset>;
+    errors: CmsError[];
+};
+/**
+ * Adds position metadata to an array of content items
+ * Each item gets: index, isFirst, isLast, indexOfType
+ *
+ * @param items - Array of content items to add metadata to
+ * @returns New array with position metadata added to each item
+ */
+export declare function addPositionMetadata<T extends {
+    type: string;
+    index?: number;
+    isFirst?: boolean;
+    isLast?: boolean;
+    indexOfType?: number;
+}>(items: T[]): T[];
+export declare function calculateContentCount(...contents: ITyped[][]): number;
+//# sourceMappingURL=helpers.d.ts.map

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

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

package/dist/converters/helpers.js

@@ -0,0 +1,128 @@
+export function resolveBuildYear(value) {
+    const buildYear = new Date().getFullYear();
+    return value.replaceAll('#buildYear#', buildYear.toString());
+}
+export function makeContentfulTitle(title, id, prefix = 'Title for ') {
+    return title ?? `${prefix}${id}`;
+}
+export function stringOrUndefined(value) {
+    if (value && value.length > 0) {
+        return value;
+    }
+    return undefined;
+}
+export function makeContentfulDescription(description, id) {
+    return description ?? `Description for ${id}`;
+}
+export function lookupAsset(context, asset) {
+    if (!asset)
+        return undefined;
+    return context.assets.get(asset.sys.id);
+}
+/**
+ * Looks up an asset that is used as an icon.
+ * If the asset is an SVG image, it marks it with isIcon: true so it uses the sprite system.
+ */
+export function lookupIconAsset(context, asset) {
+    const visual = lookupAsset(context, asset);
+    if (!visual)
+        return undefined;
+    // Mark SVG images as icons
+    if (visual.image?.type === 'Svg image') {
+        return {
+            ...visual,
+            image: {
+                ...visual.image,
+                isIcon: true,
+            },
+        };
+    }
+    return visual;
+}
+/**
+ * Looks up a raw asset and converts it to IDownloadAsset for download functionality.
+ * Returns undefined if the asset doesn't exist or doesn't have a valid file.
+ */
+export function lookupDownloadAsset(context, asset) {
+    if (!asset)
+        return undefined;
+    const rawAsset = context.rawAssets.get(asset.sys.id);
+    if (!rawAsset?.fields?.file)
+        return undefined;
+    // Cast to AssetFile since we're working with resolved assets without link resolution
+    const file = rawAsset.fields.file;
+    if (!file.url || !file.fileName || !file.contentType)
+        return undefined;
+    return {
+        assetId: rawAsset.sys.id,
+        filename: file.fileName,
+        contentType: file.contentType,
+        size: file.details?.size,
+        url: `https:${file.url}`,
+    };
+}
+/**
+ * Default positioning fields for content items before they are processed
+ */
+export const DEFAULT_POSITION_FIELDS = {
+    index: 0,
+    isFirst: false,
+    isLast: false,
+    indexOfType: 0,
+};
+/**
+ * Creates an internal link object with common fields
+ * Used by multiple converters (tag, page, article, person) to reduce duplication
+ */
+export function createInternalLink(id, fields, context, href, internalType, 
+// biome-ignore lint/suspicious/noExplicitAny: Used for expanding
+additionalProps) {
+    const { cmsLabel, title, name, useName, featuredImage, backgroundColour, textColour, indexed, hidden, slug, description, } = fields;
+    const text = makeContentfulTitle(title, id);
+    return {
+        type: 'Internal link',
+        internalType,
+        id,
+        name: name ?? cmsLabel ?? '',
+        useName,
+        text,
+        visual: lookupAsset(context, featuredImage),
+        backgroundColour,
+        textColour,
+        indexed,
+        hidden,
+        slug,
+        href,
+        title,
+        description,
+        ...additionalProps,
+    };
+}
+/**
+ * Adds position metadata to an array of content items
+ * Each item gets: index, isFirst, isLast, indexOfType
+ *
+ * @param items - Array of content items to add metadata to
+ * @returns New array with position metadata added to each item
+ */
+export function addPositionMetadata(items) {
+    if (items.length === 0)
+        return items;
+    // Count items by type for indexOfType calculation
+    const typeCount = new Map();
+    return items.map((item, index) => {
+        const currentTypeIndex = typeCount.get(item.type) ?? 0;
+        typeCount.set(item.type, currentTypeIndex + 1);
+        return {
+            ...item,
+            index,
+            isFirst: index === 0,
+            isLast: index === items.length - 1,
+            indexOfType: currentTypeIndex,
+        };
+    });
+}
+export function calculateContentCount(...contents) {
+    return contents.reduce((acc, content) => acc + content.length, 0);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/converters/helpers.js.map

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

package/dist/converters/iconCollector.d.ts

@@ -0,0 +1,65 @@
+import type { IBaseCollection, IBaseComponent, INavigation, IResponsiveVisual, ISvgImage, ITyped, IVisual } from '@se-studio/core-data-types';
+/**
+ * Extract SVG image from a visual if it's marked as an icon.
+ * Only returns SVG images that have isIcon: true (set during conversion from icon fields).
+ *
+ * @param visual - Visual to check
+ * @returns SVG image if visual contains an icon SVG, undefined otherwise
+ */
+export declare function extractIconFromVisual(visual: IVisual | undefined): ISvgImage | undefined;
+/**
+ * Extract icon SVG images from a responsive visual (both desktop and mobile).
+ * Only returns SVG images that have isIcon: true.
+ *
+ * @param visual - Responsive visual to check
+ * @returns Array of icon SVG images found (may contain 0, 1, or 2 items)
+ */
+export declare function extractIconsFromResponsiveVisual(visual: IResponsiveVisual | undefined): ISvgImage[];
+/**
+ * Collect icon SVG from a component's icon field.
+ *
+ * @param component - Component to check
+ * @returns Array of icon SVGs found
+ */
+export declare function collectIconsFromComponent(component: IBaseComponent | undefined): ISvgImage[];
+/**
+ * Collect icon SVG from a collection's icon field.
+ *
+ * @param collection - Collection to check
+ * @returns Array of icon SVGs found
+ */
+export declare function collectIconsFromCollection(collection: IBaseCollection | undefined): ISvgImage[];
+/**
+ * Recursively collect all SVG icons from navigation structures.
+ * This includes icons from navigation item links and nested navigation entries.
+ *
+ * @param navigation - Navigation structure to scan
+ * @returns Array of all SVG icons found
+ */
+export declare function collectIconsFromNavigation(navigation: INavigation | undefined): ISvgImage[];
+/**
+ * Recursively collect all SVG icons from page content.
+ * This includes icons from components, collections, nested content,
+ * and embedded entries within rich text fields (body, additionalCopy).
+ *
+ * @param contents - Array of content items to scan
+ * @returns Array of all SVG icons found
+ */
+export declare function collectIconsFromContent(contents: ReadonlyArray<ITyped> | undefined): ISvgImage[];
+/**
+ * Deduplicate icons by ID, preserving order of first occurrence.
+ * Takes any number of icon arrays and returns a single deduplicated array.
+ *
+ * @param iconArrays - Arrays of icons to merge and deduplicate
+ * @returns Deduplicated array of icons, or undefined if empty
+ */
+export declare function deduplicateIcons(...iconArrays: ReadonlyArray<ISvgImage>[]): ISvgImage[] | undefined;
+/**
+ * Process icons by fetching SVG content and generating sprite symbols.
+ * This runs during data conversion to pre-process icons for the sprite sheet.
+ *
+ * @param icons - Array of icon SVG images to process
+ * @returns Array of icons with symbolContent populated
+ */
+export declare function processIconsForSprite(icons: ReadonlyArray<ISvgImage>): Promise<ISvgImage[]>;
+//# sourceMappingURL=iconCollector.d.ts.map