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

package/dist/client.js

@@ -0,0 +1,322 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Any ok for now! */
+import { logCmsQuery, readResponseBodyWithSize } from './telemetry/queryLog.js';
+import { AuthenticationError, ContentfulError, EntryNotFoundError, RateLimitError, ValidationError, } from './utils/errors.js';
+import { calculateBackoffDelay, getRateLimiter, getRateLimitPauseSeconds, getRetryConfig, } from './utils/retry.js';
+/**
+ * Builds query string from query parameters
+ */
+function buildQueryString(query) {
+    const params = new URLSearchParams();
+    Object.entries(query).forEach(([key, value]) => {
+        if (value !== undefined && value !== null) {
+            params.append(key, String(value));
+        }
+    });
+    return params.toString();
+}
+/**
+ * Sleep utility for async delays
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Parses retry-after header from response
+ *
+ * @param response - Fetch response object
+ * @returns Retry-after value in seconds, or undefined if not present
+ */
+function parseRetryAfter(response) {
+    const retryAfterHeader = response.headers.get('X-Contentful-RateLimit-Reset') || response.headers.get('Retry-After');
+    if (retryAfterHeader) {
+        const parsed = Number.parseInt(retryAfterHeader, 10);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    return undefined;
+}
+/**
+ * Parses error response from Contentful API
+ */
+async function parseErrorResponse(response) {
+    const statusCode = response.status;
+    let errorData;
+    try {
+        errorData = await response.json();
+    }
+    catch {
+        errorData = { message: response.statusText };
+    }
+    const message = errorData?.message || `Contentful API error: ${statusCode}`;
+    switch (statusCode) {
+        case 401:
+            return new AuthenticationError(message);
+        case 404:
+            return new EntryNotFoundError(errorData?.sys?.id || 'unknown', errorData?.sys?.contentType?.sys?.id);
+        case 429: {
+            // Parse retry-after header (in seconds)
+            const retryAfterHeader = response.headers.get('X-Contentful-RateLimit-Reset') || response.headers.get('Retry-After');
+            const retryAfter = retryAfterHeader ? Number.parseInt(retryAfterHeader, 10) : undefined;
+            return new RateLimitError(message, retryAfter, errorData);
+        }
+        case 400:
+            return new ValidationError(message, errorData);
+        default:
+            return new ContentfulError(message, statusCode, errorData);
+    }
+}
+/**
+ * Fetch-based Contentful client that participates in Next.js caching.
+ * Includes proactive rate limiting and automatic retry on 429 errors.
+ */
+export class ContentfulFetchClient {
+    baseUrl;
+    accessToken;
+    rateLimiter;
+    isPreview;
+    retryConfig;
+    constructor(config, preview = false) {
+        const host = config.host || (preview ? 'preview.contentful.com' : 'cdn.contentful.com');
+        const environment = config.environment || 'master';
+        this.baseUrl = `https://${host}/spaces/${config.spaceId}/environments/${environment}`;
+        this.accessToken = config.accessToken;
+        this.isPreview = preview;
+        this.rateLimiter = getRateLimiter(preview);
+        this.retryConfig = getRetryConfig(preview);
+    }
+    /**
+     * Fetches entries from Contentful with proactive rate limiting
+     * and automatic retry on rate limit errors.
+     *
+     * Rate limits are applied proactively:
+     * - Preview API: ~10 requests/second (proactive headroom under 14 cap)
+     * - Delivery API: 55 requests/second
+     *
+     * If a 429 is still received (e.g., due to other processes), retries with backoff.
+     */
+    async getEntries(query, options) {
+        const queryString = buildQueryString(query);
+        const url = `${this.baseUrl}/entries?${queryString}`;
+        const fetchOptions = {
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            ...(options?.cache && { cache: options.cache }),
+            ...(options?.next && { next: options.next }),
+        };
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            try {
+                // Wait for rate limiter before making request
+                await this.rateLimiter.acquire();
+                if (process.env.LOG_CMS_FETCH) {
+                    console.log(`[CMS fetch] ${url}`);
+                }
+                const fetchStart = performance.now();
+                const response = await fetch(url, fetchOptions);
+                const fetchMs = Math.round(performance.now() - fetchStart);
+                if (response.ok) {
+                    const { bytes, text } = await readResponseBodyWithSize(response);
+                    logCmsQuery({ url, bytes, ms: fetchMs });
+                    return JSON.parse(text);
+                }
+                // Handle rate limiting (429) with automatic retry
+                if (response.status === 429 && attempt < this.retryConfig.maxRetries) {
+                    const retryAfter = parseRetryAfter(response);
+                    const delay = calculateBackoffDelay(attempt, this.retryConfig, retryAfter);
+                    if (process.env.LOG_CMS)
+                        console.warn(`[Contentful] Rate limited (429), retrying in ${delay}ms (attempt ${attempt + 1}/${this.retryConfig.maxRetries}). ` +
+                            `Queue: ${this.rateLimiter.getQueueLength()} waiting. ` +
+                            `API: ${this.isPreview ? 'preview' : 'delivery'}`);
+                    // Pause the rate limiter - this affects all queued requests
+                    const pauseSeconds = getRateLimitPauseSeconds(retryAfter, this.isPreview);
+                    this.rateLimiter.pause(pauseSeconds);
+                    // Wait before retrying this request
+                    await sleep(delay);
+                    continue;
+                }
+                // For non-429 errors or final retry attempt, throw the error
+                throw await parseErrorResponse(response);
+            }
+            catch (error) {
+                if (error instanceof ContentfulError) {
+                    throw error;
+                }
+                console.error('[Contentful] Unexpected error in request', error);
+                throw new ContentfulError('Unexpected error in request', 500);
+            }
+        }
+        // This should never be reached due to the throw in the loop,
+        // but TypeScript needs it for type safety
+        throw new ContentfulError('Max retries exceeded', 500);
+    }
+    /**
+     * Fetches a page of assets from Contentful (`GET /assets`) with rate limiting
+     * and retry on 429.
+     */
+    async getAssets(query = {}, options) {
+        const queryString = buildQueryString(query);
+        const url = `${this.baseUrl}/assets?${queryString}`;
+        const fetchOptions = {
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            ...(options?.cache && { cache: options.cache }),
+            ...(options?.next && { next: options.next }),
+        };
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            try {
+                await this.rateLimiter.acquire();
+                if (process.env.LOG_CMS_FETCH) {
+                    console.log(`[CMS fetch] ${url}`);
+                }
+                const fetchStart = performance.now();
+                const response = await fetch(url, fetchOptions);
+                const fetchMs = Math.round(performance.now() - fetchStart);
+                if (response.ok) {
+                    const { bytes, text } = await readResponseBodyWithSize(response);
+                    logCmsQuery({ url, bytes, ms: fetchMs });
+                    return JSON.parse(text);
+                }
+                if (response.status === 429 && attempt < this.retryConfig.maxRetries) {
+                    const retryAfter = parseRetryAfter(response);
+                    const delay = calculateBackoffDelay(attempt, this.retryConfig, retryAfter);
+                    if (process.env.LOG_CMS)
+                        console.warn(`[Contentful] Rate limited (429), retrying in ${delay}ms (attempt ${attempt + 1}/${this.retryConfig.maxRetries}). ` +
+                            `Queue: ${this.rateLimiter.getQueueLength()} waiting. ` +
+                            `API: ${this.isPreview ? 'preview' : 'delivery'}`);
+                    const pauseSeconds = getRateLimitPauseSeconds(retryAfter, this.isPreview);
+                    this.rateLimiter.pause(pauseSeconds);
+                    await sleep(delay);
+                    continue;
+                }
+                throw await parseErrorResponse(response);
+            }
+            catch (error) {
+                if (error instanceof ContentfulError) {
+                    throw error;
+                }
+                console.error('[Contentful] Unexpected error in assets request', error);
+                throw new ContentfulError('Unexpected error in assets request', 500);
+            }
+        }
+        throw new ContentfulError('Max retries exceeded', 500);
+    }
+    /**
+     * Fetches a single asset by ID. Returns null for 404.
+     */
+    async getAsset(assetId, options) {
+        const url = `${this.baseUrl}/assets/${assetId}`;
+        const fetchOptions = {
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            ...(options?.cache && { cache: options.cache }),
+            ...(options?.next && { next: options.next }),
+        };
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            try {
+                // Wait for rate limiter before making request
+                await this.rateLimiter.acquire();
+                if (process.env.LOG_CMS_FETCH) {
+                    console.log(`[CMS fetch] ${url}`);
+                }
+                const fetchStart = performance.now();
+                const response = await fetch(url, fetchOptions);
+                const fetchMs = Math.round(performance.now() - fetchStart);
+                if (response.ok) {
+                    const { bytes, text } = await readResponseBodyWithSize(response);
+                    logCmsQuery({ url, bytes, ms: fetchMs });
+                    return JSON.parse(text);
+                }
+                // Return null for 404 (asset not found)
+                if (response.status === 404) {
+                    return null;
+                }
+                // Handle rate limiting (429) with automatic retry
+                if (response.status === 429 && attempt < this.retryConfig.maxRetries) {
+                    const retryAfter = parseRetryAfter(response);
+                    const delay = calculateBackoffDelay(attempt, this.retryConfig, retryAfter);
+                    if (process.env.LOG_CMS)
+                        console.warn(`[Contentful] Rate limited (429), retrying in ${delay}ms (attempt ${attempt + 1}/${this.retryConfig.maxRetries}). ` +
+                            `Queue: ${this.rateLimiter.getQueueLength()} waiting. ` +
+                            `API: ${this.isPreview ? 'preview' : 'delivery'}`);
+                    // Pause the rate limiter - this affects all queued requests
+                    const pauseSeconds = getRateLimitPauseSeconds(retryAfter, this.isPreview);
+                    this.rateLimiter.pause(pauseSeconds);
+                    // Wait before retrying this request
+                    await sleep(delay);
+                    continue;
+                }
+                // For non-429 errors or final retry attempt, throw the error
+                throw await parseErrorResponse(response);
+            }
+            catch (error) {
+                if (error instanceof ContentfulError) {
+                    throw error;
+                }
+                console.error('[Contentful] Unexpected error in asset request', error);
+                throw new ContentfulError('Unexpected error in asset request', 500);
+            }
+        }
+        throw new ContentfulError('Max retries exceeded', 500);
+    }
+}
+/**
+ * Creates a Contentful Content Delivery API (CDA) client
+ *
+ * @param config - Configuration object for the Contentful client
+ * @returns Contentful CDA client instance
+ *
+ * @example
+ * ```ts
+ * const client = createContentfulClient({
+ *   spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *   accessToken: process.env.CONTENTFUL_ACCESS_TOKEN!,
+ *   environment: 'master'
+ * });
+ * ```
+ */
+export function createContentfulClient(config) {
+    return new ContentfulFetchClient(config, false);
+}
+/**
+ * Creates a Contentful Content Preview API (CPA) client
+ *
+ * @param config - Configuration object for the Contentful preview client
+ * @returns Contentful CPA client instance
+ *
+ * @example
+ * ```ts
+ * const previewClient = createContentfulPreviewClient({
+ *   spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *   accessToken: process.env.CONTENTFUL_PREVIEW_ACCESS_TOKEN!,
+ *   environment: 'master'
+ * });
+ * ```
+ */
+export function createContentfulPreviewClient(config) {
+    return new ContentfulFetchClient(config, true);
+}
+/**
+ * Gets the appropriate Contentful client based on preview mode
+ *
+ * @param config - Configuration for the Contentful client
+ * @param preview - Whether to use the preview API
+ * @returns Contentful client instance (CDA or CPA)
+ *
+ * @example
+ * ```ts
+ * const client = getContentfulClient({
+ *   spaceId: process.env.CONTENTFUL_SPACE_ID!,
+ *   accessToken: preview
+ *     ? process.env.CONTENTFUL_PREVIEW_ACCESS_TOKEN!
+ *     : process.env.CONTENTFUL_ACCESS_TOKEN!,
+ * }, preview);
+ * ```
+ */
+export function getContentfulClient(config, preview) {
+    return preview ? createContentfulPreviewClient(config) : createContentfulClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/cms-integrity.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Node-safe entry for smoke CMS integrity checks (no Next.js `next/cache` dependency at load time).
+ */
+export { createBaseConverterContext } from './api/context.js';
+export { contentfulAllArticleLinksForIntegrity } from './api/links.js';
+export type { IContentfulArticleLink } from './converters/article.js';
+export type { BaseConverterContext } from './converters/helpers.js';
+export { createMarketingSiteUrlCalculators, type MarketingSiteRoutingOptions, } from './routing/index.js';
+export type { CmsResponse, ContentfulConfig, FetchOptions } from './types.js';
+//# sourceMappingURL=cms-integrity.d.ts.map

package/dist/cms-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-integrity.d.ts","sourceRoot":"","sources":["../src/cms-integrity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,qCAAqC,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,iCAAiC,EACjC,KAAK,2BAA2B,GACjC,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/cms-integrity.js

@@ -0,0 +1,7 @@
+/**
+ * Node-safe entry for smoke CMS integrity checks (no Next.js `next/cache` dependency at load time).
+ */
+export { createBaseConverterContext } from './api/context.js';
+export { contentfulAllArticleLinksForIntegrity } from './api/links.js';
+export { createMarketingSiteUrlCalculators, } from './routing/index.js';
+//# sourceMappingURL=cms-integrity.js.map

package/dist/cms-integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-integrity.js","sourceRoot":"","sources":["../src/cms-integrity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,qCAAqC,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EACL,iCAAiC,GAElC,MAAM,oBAAoB,CAAC"}

package/dist/converters/animationEnricher.d.ts

@@ -0,0 +1,17 @@
+import type { IVisual } from '@se-studio/core-data-types';
+/**
+ * Decode a .lottie (zip) buffer and return dimensions from the primary animation JSON.
+ * Optionally returns an embedded raster poster if the package includes a common image asset.
+ */
+export declare function dimensionsFromDotLottieBuffer(buffer: Uint8Array): {
+    width: number;
+    height: number;
+    posterSrc?: string;
+} | null;
+/**
+ * Enriches all animation visuals in the assets Map with dimensions (optimised SVG)
+ * and a posterSrc for the lazy shell / reduced-motion fallback.
+ * Mutates animation in place so values are available at render without async server components.
+ */
+export declare function enrichAnimationAssets(assets: Map<string, IVisual>): Promise<void>;
+//# sourceMappingURL=animationEnricher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animationEnricher.d.ts","sourceRoot":"","sources":["../../src/converters/animationEnricher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EACR,MAAM,4BAA4B,CAAC;AAoCpC;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,UAAU,GAAG;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAoFP;AAqED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvF"}

package/dist/converters/animationEnricher.js

@@ -0,0 +1,177 @@
+import { unzipSync } from 'fflate';
+import { assetTag } from '../revalidation/tags.js';
+function getLottieDimensions(lottieJson) {
+    const width = lottieJson.w || lottieJson.width || 0;
+    const height = lottieJson.h || lottieJson.height || 0;
+    return { width, height };
+}
+function blankSvg(width, height) {
+    return `<svg width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg" preserveAspectRatio="xMidYMid meet" style="width: 100%; height: 100%"></svg>`;
+}
+function optimisedFromDimensions(width, height) {
+    if (!width || !height)
+        return undefined;
+    return { width, height, data: blankSvg(width, height) };
+}
+/** Transparent SVG data URL — reserves space and works as a reduced-motion / lazy shell. */
+function posterDataUrlFromSvg(svg) {
+    return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+}
+/**
+ * Decode a .lottie (zip) buffer and return dimensions from the primary animation JSON.
+ * Optionally returns an embedded raster poster if the package includes a common image asset.
+ */
+export function dimensionsFromDotLottieBuffer(buffer) {
+    let files;
+    try {
+        files = unzipSync(buffer);
+    }
+    catch {
+        return null;
+    }
+    const entries = Object.keys(files);
+    const manifestKey = entries.find((k) => k === 'manifest.json' || k.endsWith('/manifest.json'));
+    let animationPath;
+    if (manifestKey) {
+        const manifestBytes = files[manifestKey];
+        if (manifestBytes) {
+            try {
+                const manifest = JSON.parse(new TextDecoder().decode(manifestBytes));
+                const firstId = manifest.animations?.[0]?.id;
+                if (firstId) {
+                    // Spec locations: a/<id>.json or animations/<id>.json
+                    animationPath = entries.find((k) => k === `a/${firstId}.json` ||
+                        k === `animations/${firstId}.json` ||
+                        k.endsWith(`/${firstId}.json`));
+                }
+            }
+            catch {
+                // fall through to first JSON under a/ or animations/
+            }
+        }
+    }
+    if (!animationPath) {
+        animationPath = entries.find((k) => (k.startsWith('a/') || k.includes('/a/') || k.startsWith('animations/')) &&
+            k.endsWith('.json') &&
+            !k.endsWith('manifest.json'));
+    }
+    if (!animationPath) {
+        // Last resort: any non-manifest JSON
+        animationPath = entries.find((k) => k.endsWith('.json') && !k.endsWith('manifest.json'));
+    }
+    if (!animationPath)
+        return null;
+    const animBytes = files[animationPath];
+    if (!animBytes)
+        return null;
+    let json;
+    try {
+        json = JSON.parse(new TextDecoder().decode(animBytes));
+    }
+    catch {
+        return null;
+    }
+    const { width, height } = getLottieDimensions(json);
+    if (!width || !height)
+        return null;
+    // Opportunistic embedded still (not guaranteed to be frame 0).
+    const imageKey = entries.find((k) => /\.(png|jpe?g|webp)$/i.test(k));
+    let posterSrc;
+    if (imageKey) {
+        const imgBytes = files[imageKey];
+        if (imgBytes && imgBytes.byteLength > 0 && imgBytes.byteLength <= 100 * 1024) {
+            const ext = imageKey.split('.').pop()?.toLowerCase() ?? 'png';
+            const mime = ext === 'jpg' || ext === 'jpeg'
+                ? 'image/jpeg'
+                : ext === 'webp'
+                    ? 'image/webp'
+                    : 'image/png';
+            let binary = '';
+            const chunk = 0x8000;
+            for (let i = 0; i < imgBytes.length; i += chunk) {
+                binary += String.fromCharCode(...imgBytes.subarray(i, i + chunk));
+            }
+            posterSrc = `data:${mime};base64,${btoa(binary)}`;
+        }
+    }
+    return { width, height, posterSrc };
+}
+async function fetchCached(url, assetId) {
+    const response = await fetch(url, {
+        cache: 'force-cache',
+        next: {
+            tags: [assetTag(assetId)],
+        },
+    });
+    if (!response.ok)
+        return undefined;
+    return response;
+}
+/**
+ * Fetches a Lottie animation JSON and returns an optimised SVG placeholder
+ * capturing the animation's dimensions. Optionally sets a SVG data-URL poster.
+ */
+async function enrichLottieJson(animationSrc, assetId) {
+    const response = await fetchCached(animationSrc, assetId);
+    if (!response)
+        return undefined;
+    const json = (await response.json());
+    const { width, height } = getLottieDimensions(json);
+    const optimised = optimisedFromDimensions(width, height);
+    if (!optimised)
+        return undefined;
+    return {
+        optimised,
+        posterSrc: posterDataUrlFromSvg(optimised.data),
+    };
+}
+/**
+ * Fetches a .lottie package, unzips it, reads dimensions from the primary animation JSON.
+ */
+async function enrichDotLottie(animationSrc, assetId) {
+    const response = await fetchCached(animationSrc, assetId);
+    if (!response)
+        return undefined;
+    const buffer = new Uint8Array(await response.arrayBuffer());
+    const dims = dimensionsFromDotLottieBuffer(buffer);
+    if (!dims)
+        return undefined;
+    const optimised = optimisedFromDimensions(dims.width, dims.height);
+    if (!optimised)
+        return undefined;
+    return {
+        optimised,
+        // Prefer embedded raster; otherwise transparent SVG with correct aspect.
+        posterSrc: dims.posterSrc ?? posterDataUrlFromSvg(optimised.data),
+    };
+}
+async function enrichOne(format, animationSrc, assetId) {
+    if (format === 'dotlottie') {
+        return enrichDotLottie(animationSrc, assetId);
+    }
+    return enrichLottieJson(animationSrc, assetId);
+}
+/**
+ * Enriches all animation visuals in the assets Map with dimensions (optimised SVG)
+ * and a posterSrc for the lazy shell / reduced-motion fallback.
+ * Mutates animation in place so values are available at render without async server components.
+ */
+export async function enrichAnimationAssets(assets) {
+    const animationEntries = Array.from(assets.entries()).filter(([, visual]) => visual.animation !== undefined);
+    if (animationEntries.length === 0)
+        return;
+    await Promise.all(animationEntries.map(async ([assetId, visual]) => {
+        try {
+            const format = visual.animation.format ?? 'lottie-json';
+            const result = await enrichOne(format, visual.animation.animationSrc, assetId);
+            if (result) {
+                visual.animation.optimised = result.optimised;
+                visual.animation.posterSrc = result.posterSrc;
+            }
+        }
+        catch {
+            // Leave optimised/poster undefined — LazyAnimation handles missing case gracefully
+        }
+    }));
+}
+//# sourceMappingURL=animationEnricher.js.map

package/dist/converters/animationEnricher.js.map

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

package/dist/converters/article.d.ts

@@ -0,0 +1,48 @@
+import { type IArticleLink, type IArticleTypeLink, type IBaseArticle, type IBaseArticleType } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier, IContentfulRichText } from '../api';
+import type { BaseArticleSkeleton } from '../baseTypes/baseArticle';
+import type { BaseArticleTypeSkeleton } from '../baseTypes/baseArticleType';
+import type { BaseCustomTypeSkeleton } from '../baseTypes/baseCustomType';
+import { type ConverterContext } from './helpers';
+export type IContentfulArticle = IBaseArticle & {
+    summary?: IContentfulRichText | null;
+};
+export type IContentfulArticleLink = IArticleLink & {
+    summary?: IContentfulRichText | null;
+};
+/**
+ * Base converter for Contentful Article entries to IArticle type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param entry - Contentful entry to convert
+ * @returns IArticle object
+ *
+ * @example
+ * ```ts
+ * const article = baseArticleConverter(contentfulEntry);
+ * ```
+ */
+export declare function baseArticleConverter(context: ConverterContext, entry: Entry<BaseArticleSkeleton, DefaultChainModifier, string>): IContentfulArticle;
+export declare function baseArticleLinkConverter(context: ConverterContext, entry: Entry<BaseArticleSkeleton, DefaultChainModifier, string>): IContentfulArticleLink;
+export declare function baseArticleTypeLinkConverter(context: ConverterContext, entry: Entry<BaseArticleTypeSkeleton, DefaultChainModifier, string>): IArticleTypeLink;
+/**
+ * Base converter for Contentful Article Type entries to IArticleType type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing includes
+ * @param entry - Contentful entry to convert
+ * @param customTypeEntry - Optional custom type entry that defines templates and navigation
+ * @returns IBaseArticleType object
+ *
+ * @example
+ * ```ts
+ * const articleType = baseArticleTypeConverter(context, contentfulEntry, customTypeEntry);
+ * ```
+ */
+export declare function baseArticleTypeConverter(context: ConverterContext, entry: Entry<BaseArticleTypeSkeleton, DefaultChainModifier, string>, customTypeEntry?: Entry<BaseCustomTypeSkeleton, DefaultChainModifier, string>): IBaseArticleType;
+//# sourceMappingURL=article.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"article.d.ts","sourceRoot":"","sources":["../../src/converters/article.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAQtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAG1E,OAAO,EAEL,KAAK,gBAAgB,EAStB,MAAM,WAAW,CAAC;AAgBnB,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG;IAClD,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACtC,CAAC;AAyCF;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC9D,kBAAkB,CA2MpB;AAkBD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC9D,sBAAsB,CA8ExB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAClE,gBAAgB,CAwBlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,CAAC,EACnE,eAAe,CAAC,EAAE,KAAK,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC5E,gBAAgB,CAwHlB"}