@se-studio/contentful-cms 0.0.0-next16-20260822103555

package/dist/contentful/entry-lookup.js

@@ -0,0 +1,273 @@
+import { ReferenceCatalogAmbiguityError } from '../index/errors.js';
+import { resolveIndexPreview } from '../index/mode.js';
+import { indexExists } from '../index/paths.js';
+import { findReferenceByCmsLabel, findReferenceByLabel, findReferenceBySlug, listReferenceEntries, } from '../index/query.js';
+import { isCatalogContentType } from '../index/schema.js';
+import { findEntryByContentTypeAndSlug, normalizeSlug } from './fetch.js';
+import { referenceRowFromCmaEntry } from './reference-record.js';
+async function findCmaByField(env, contentType, fieldId, value, limit = 2) {
+    const result = await env.getEntries({
+        content_type: contentType,
+        [`fields.${fieldId}`]: value.trim(),
+        limit,
+    });
+    if (result.items.length > 1) {
+        throw new ReferenceCatalogAmbiguityError(`Multiple ${contentType} entries share ${fieldId} "${value}" in Contentful.`, result.items.map((entry) => ({
+            id: entry.sys.id,
+            label: value,
+            slug: null,
+        })));
+    }
+    return result.items[0] ?? null;
+}
+async function resolveTagTypeSlugFromName(space, env, name, preview) {
+    const fromIndex = findReferenceByLabel(space, 'tagType', name, preview);
+    if (fromIndex?.slug)
+        return fromIndex.slug;
+    const entry = await findCmaByField(env, 'tagType', 'name', name);
+    if (!entry)
+        return null;
+    const fields = entry.fields;
+    const locale = space.defaultLocale;
+    const slugVal = fields['slug']?.[locale] ?? fields['slug']?.['en-US'];
+    return slugVal != null ? normalizeSlug(String(slugVal)) : null;
+}
+function lookupFromIndexRow(row) {
+    return { id: row.id, contentType: row.contentType, row };
+}
+async function lookupCatalogSlug(space, env, contentType, slug, preview) {
+    const normalized = normalizeSlug(slug);
+    if (indexExists(space, resolveIndexPreview(preview))) {
+        const row = findReferenceBySlug(space, contentType, normalized, preview);
+        if (row)
+            return lookupFromIndexRow(row);
+    }
+    const entry = await findEntryByContentTypeAndSlug(env, contentType, normalized);
+    if (!entry)
+        return null;
+    return { id: entry.sys.id, contentType };
+}
+async function lookupCatalogLabel(space, env, contentType, label, preview) {
+    if (indexExists(space, resolveIndexPreview(preview))) {
+        const row = findReferenceByLabel(space, contentType, label, preview);
+        if (row)
+            return lookupFromIndexRow(row);
+    }
+    const fieldId = contentType === 'page' ||
+        contentType === 'article' ||
+        contentType === 'pageVariant' ||
+        contentType === 'navigationItem'
+        ? 'title'
+        : 'name';
+    const entry = await findCmaByField(env, contentType, fieldId, label);
+    if (!entry)
+        return null;
+    return { id: entry.sys.id, contentType };
+}
+async function lookupCatalogCmsLabel(space, env, contentType, cmsLabel, preview) {
+    if (indexExists(space, resolveIndexPreview(preview))) {
+        const row = findReferenceByCmsLabel(space, contentType, cmsLabel, preview);
+        if (row)
+            return lookupFromIndexRow(row);
+    }
+    const entry = await findCmaByField(env, contentType, 'cmsLabel', cmsLabel);
+    if (!entry)
+        return null;
+    if (isCatalogContentType(contentType)) {
+        const mapped = referenceRowFromCmaEntry(contentType, entry, space.defaultLocale);
+        return { id: mapped.id, contentType: mapped.contentType, row: mapped };
+    }
+    return { id: entry.sys.id, contentType };
+}
+async function lookupTagScoped(space, env, match, cma, tagTypeSlug, tagTypeName, preview) {
+    let parentSlug = tagTypeSlug ? normalizeSlug(tagTypeSlug) : undefined;
+    if (!parentSlug && tagTypeName) {
+        parentSlug = (await resolveTagTypeSlugFromName(space, env, tagTypeName, preview)) ?? undefined;
+    }
+    if (indexExists(space, resolveIndexPreview(preview))) {
+        const rows = listReferenceEntries(space, 'tag', {
+            preview,
+            ...(parentSlug ? { tagTypeSlug: parentSlug } : {}),
+        });
+        const row = match(rows);
+        if (row)
+            return lookupFromIndexRow(row);
+    }
+    const entry = await cma();
+    if (!entry)
+        return null;
+    if (parentSlug) {
+        const fields = entry.fields;
+        const locale = space.defaultLocale;
+        const tagTypeLink = fields['tagType']?.[locale] ?? fields['tagType']?.['en-US'];
+        const tagTypeId = tagTypeLink && typeof tagTypeLink === 'object' && 'sys' in tagTypeLink
+            ? tagTypeLink.sys?.id
+            : undefined;
+        if (tagTypeId) {
+            const parent = await env.getEntry(tagTypeId);
+            const parentSlugVal = parent.fields['slug']?.[locale] ?? parent.fields['slug']?.['en-US'];
+            if (parentSlugVal != null && normalizeSlug(String(parentSlugVal)) !== parentSlug) {
+                return null;
+            }
+        }
+    }
+    const mapped = referenceRowFromCmaEntry('tag', entry, space.defaultLocale);
+    return { id: mapped.id, contentType: 'tag', row: mapped };
+}
+/**
+ * Resolves a catalog or navigation entry from flat lookup flags (index-first, CMA fallback).
+ */
+export async function findEntryByLookupTarget(space, env, target, opts = {}) {
+    const preview = opts.preview;
+    switch (target.kind) {
+        case 'entryId': {
+            try {
+                const entry = await env.getEntry(target.id);
+                return { id: entry.sys.id, contentType: entry.sys.contentType.sys.id };
+            }
+            catch {
+                return null;
+            }
+        }
+        case 'pageSlug':
+            return lookupCatalogSlug(space, env, 'page', target.slug, preview);
+        case 'pageTitle':
+            return lookupCatalogLabel(space, env, 'page', target.title, preview);
+        case 'pageCmsLabel':
+            return lookupCatalogCmsLabel(space, env, 'page', target.cmsLabel, preview);
+        case 'articleSlug':
+            return lookupCatalogSlug(space, env, 'article', target.slug, preview);
+        case 'articleTitle':
+            return lookupCatalogLabel(space, env, 'article', target.title, preview);
+        case 'articleCmsLabel':
+            return lookupCatalogCmsLabel(space, env, 'article', target.cmsLabel, preview);
+        case 'pageVariantSlug':
+            return lookupCatalogSlug(space, env, 'pageVariant', target.slug, preview);
+        case 'pageVariantTitle':
+            return lookupCatalogLabel(space, env, 'pageVariant', target.title, preview);
+        case 'pageVariantCmsLabel':
+            return lookupCatalogCmsLabel(space, env, 'pageVariant', target.cmsLabel, preview);
+        case 'tagTypeSlug':
+            return lookupCatalogSlug(space, env, 'tagType', target.slug, preview);
+        case 'tagTypeName':
+            return lookupCatalogLabel(space, env, 'tagType', target.name, preview);
+        case 'articleTypeSlug':
+            return lookupCatalogSlug(space, env, 'articleType', target.slug, preview);
+        case 'articleTypeName':
+            return lookupCatalogLabel(space, env, 'articleType', target.name, preview);
+        case 'templateLabel':
+            return lookupCatalogCmsLabel(space, env, 'template', target.label, preview);
+        case 'tagSlug':
+            return lookupTagScoped(space, env, (rows) => {
+                const normalized = normalizeSlug(target.slug);
+                const matches = rows.filter((r) => r.slug === normalized);
+                if (matches.length === 0)
+                    return null;
+                if (matches.length > 1) {
+                    throw new ReferenceCatalogAmbiguityError(`Multiple tag entries share slug "${target.slug}" in the local index.`, matches.map((r) => ({ id: r.id, label: r.label, slug: r.slug })));
+                }
+                return matches[0] ?? null;
+            }, () => findEntryByContentTypeAndSlug(env, 'tag', target.slug), target.tagTypeSlug, target.tagTypeName, preview);
+        case 'tagName':
+            return lookupTagScoped(space, env, (rows) => {
+                const matches = rows.filter((r) => r.label === target.name.trim());
+                if (matches.length === 0)
+                    return null;
+                if (matches.length > 1) {
+                    throw new ReferenceCatalogAmbiguityError(`Multiple tag entries share name "${target.name}" in the local index.`, matches.map((r) => ({ id: r.id, label: r.label, slug: r.slug })));
+                }
+                return matches[0] ?? null;
+            }, () => findCmaByField(env, 'tag', 'name', target.name), target.tagTypeSlug, target.tagTypeName, preview);
+        case 'tagCmsLabel':
+            return lookupTagScoped(space, env, (rows) => {
+                const matches = rows.filter((r) => r.cmsLabel === target.cmsLabel.trim());
+                if (matches.length === 0)
+                    return null;
+                if (matches.length > 1) {
+                    throw new ReferenceCatalogAmbiguityError(`Multiple tag entries share cmsLabel "${target.cmsLabel}" in the local index.`, matches.map((r) => ({ id: r.id, label: r.label, slug: r.slug })));
+                }
+                return matches[0] ?? null;
+            }, () => findCmaByField(env, 'tag', 'cmsLabel', target.cmsLabel), target.tagTypeSlug, target.tagTypeName, preview);
+        case 'navId': {
+            try {
+                const entry = await env.getEntry(target.id);
+                if (entry.sys.contentType.sys.id !== 'navigation')
+                    return null;
+                return { id: entry.sys.id, contentType: 'navigation' };
+            }
+            catch {
+                return null;
+            }
+        }
+        case 'navName': {
+            if (indexExists(space, resolveIndexPreview(preview))) {
+                const row = findReferenceByLabel(space, 'navigation', target.name, preview);
+                if (row)
+                    return lookupFromIndexRow(row);
+            }
+            const entry = await findCmaByField(env, 'navigation', 'name', target.name);
+            if (!entry)
+                return null;
+            return { id: entry.sys.id, contentType: 'navigation' };
+        }
+        case 'navItemId': {
+            try {
+                const entry = await env.getEntry(target.id);
+                if (entry.sys.contentType.sys.id !== 'navigationItem')
+                    return null;
+                return { id: entry.sys.id, contentType: 'navigationItem' };
+            }
+            catch {
+                return null;
+            }
+        }
+        case 'navItemTitle': {
+            const rows = indexExists(space, resolveIndexPreview(preview))
+                ? listReferenceEntries(space, 'navigationItem', { preview }).filter((r) => r.label === target.title.trim())
+                : [];
+            if (rows.length > 1 && !target.navId) {
+                throw new ReferenceCatalogAmbiguityError(`Multiple navigationItem entries share title "${target.title}". Provide --nav-id to scope.`, rows.map((r) => ({ id: r.id, label: r.label, slug: r.slug })));
+            }
+            if (rows.length === 1) {
+                return lookupFromIndexRow(rows[0]);
+            }
+            const cmaMatches = await env.getEntries({
+                content_type: 'navigationItem',
+                'fields.title': target.title.trim(),
+                limit: 10,
+            });
+            if (cmaMatches.items.length > 1 && !target.navId) {
+                throw new ReferenceCatalogAmbiguityError(`Multiple navigationItem entries share title "${target.title}". Provide --nav-id to scope.`, cmaMatches.items.map((e) => ({ id: e.sys.id, label: target.title, slug: null })));
+            }
+            if (target.navId && cmaMatches.items.length > 0) {
+                const nav = await env.getEntry(target.navId);
+                const locale = space.defaultLocale;
+                const itemsField = Object.keys(nav.fields).find((k) => {
+                    const val = nav.fields[k]?.[locale] ?? nav.fields[k]?.['en-US'];
+                    return Array.isArray(val);
+                });
+                const itemIds = new Set();
+                if (itemsField) {
+                    const arr = (nav.fields[itemsField]?.[locale] ??
+                        nav.fields[itemsField]?.['en-US']);
+                    for (const link of arr) {
+                        if (link?.sys?.id)
+                            itemIds.add(link.sys.id);
+                    }
+                }
+                const scoped = cmaMatches.items.filter((e) => itemIds.has(e.sys.id));
+                if (scoped.length === 1) {
+                    return { id: scoped[0].sys.id, contentType: 'navigationItem' };
+                }
+                if (scoped.length === 0)
+                    return null;
+                throw new ReferenceCatalogAmbiguityError(`Multiple navigationItem entries share title "${target.title}" under navigation ${target.navId}.`, scoped.map((e) => ({ id: e.sys.id, label: target.title, slug: null })));
+            }
+            if (cmaMatches.items.length === 1) {
+                return { id: cmaMatches.items[0].sys.id, contentType: 'navigationItem' };
+            }
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=entry-lookup.js.map

package/dist/contentful/entry-lookup.js.map

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

package/dist/contentful/featured-image-defaults.d.ts

@@ -0,0 +1,16 @@
+import type { SpaceConfig } from '../config/types.js';
+import type { EditorDefaultsConfig } from '../project/types.js';
+import type { SafeEnvironment } from './client.js';
+export type FeaturedImageSource = 'explicit' | 'articleType' | 'siteDefault' | 'none';
+export interface FeaturedImageResolution {
+    assetId?: string;
+    source: FeaturedImageSource;
+    message?: string;
+}
+export declare function loadEditorDefaultsFromPack(): EditorDefaultsConfig | null;
+export declare function loadEditorDefaultsFromProject(): EditorDefaultsConfig | null;
+export declare function getEditorDefaults(): EditorDefaultsConfig | null;
+export declare function getArticleTypeFeaturedImageAssetId(env: SafeEnvironment, articleTypeId: string, locale: string): Promise<string | undefined>;
+export declare function resolveSiteDefaultFeaturedImageAssetId(space: SpaceConfig, defaults: EditorDefaultsConfig): Promise<string | undefined>;
+export declare function resolveArticleFeaturedImageFallback(env: SafeEnvironment, space: SpaceConfig, locale: string, articleTypeId: string | undefined, hasExplicitFeatured: boolean): Promise<FeaturedImageResolution>;
+//# sourceMappingURL=featured-image-defaults.d.ts.map

package/dist/contentful/featured-image-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featured-image-defaults.d.ts","sourceRoot":"","sources":["../../src/contentful/featured-image-defaults.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsBD,wBAAgB,0BAA0B,IAAI,oBAAoB,GAAG,IAAI,CAmBxE;AAED,wBAAgB,6BAA6B,IAAI,oBAAoB,GAAG,IAAI,CAiB3E;AAED,wBAAgB,iBAAiB,IAAI,oBAAoB,GAAG,IAAI,CAE/D;AAED,wBAAsB,kCAAkC,CACtD,GAAG,EAAE,eAAe,EACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqB7B;AAED,wBAAsB,sCAAsC,CAC1D,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED,wBAAsB,mCAAmC,CACvD,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,mBAAmB,EAAE,OAAO,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAiClC"}

package/dist/contentful/featured-image-defaults.js

@@ -0,0 +1,117 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { resolveEditorPackPath } from '../editor-pack/load.js';
+import { loadProjectConfig } from '../project/load.js';
+import { resolveAssetIdFromFilename } from './asset-link-from-json.js';
+function normalizeDefaultsConfig(raw) {
+    if ('featuredImageAssetFilename' in raw || 'featuredImageAssetId' in raw) {
+        return {
+            featuredImageAssetFilename: raw.featuredImageAssetFilename,
+            featuredImageAssetId: raw.featuredImageAssetId,
+        };
+    }
+    const nested = raw.featuredImage ?? raw.defaults;
+    return nested ?? {};
+}
+export function loadEditorDefaultsFromPack() {
+    const packPath = resolveEditorPackPath();
+    if (!packPath) {
+        return null;
+    }
+    const jsonPath = path.join(packPath, 'defaults.json');
+    if (!fs.existsSync(jsonPath)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+        const config = normalizeDefaultsConfig(parsed);
+        if (!config.featuredImageAssetFilename && !config.featuredImageAssetId) {
+            return null;
+        }
+        return config;
+    }
+    catch {
+        return null;
+    }
+}
+export function loadEditorDefaultsFromProject() {
+    const configPath = process.env['CMS_EDIT_PROJECT_CONFIG'];
+    if (configPath && fs.existsSync(configPath)) {
+        const project = loadProjectConfig(configPath);
+        return project.editor?.defaults ?? null;
+    }
+    const packPath = resolveEditorPackPath();
+    if (packPath) {
+        const sibling = path.join(path.dirname(packPath), 'project.json');
+        if (fs.existsSync(sibling)) {
+            const project = loadProjectConfig(sibling);
+            return project.editor?.defaults ?? null;
+        }
+    }
+    return null;
+}
+export function getEditorDefaults() {
+    return loadEditorDefaultsFromPack() ?? loadEditorDefaultsFromProject();
+}
+export async function getArticleTypeFeaturedImageAssetId(env, articleTypeId, locale) {
+    try {
+        const entry = await env.getEntry(articleTypeId);
+        const featuredImageField = entry.fields['featuredImage'];
+        if (!featuredImageField || typeof featuredImageField !== 'object') {
+            return undefined;
+        }
+        const localized = featuredImageField[locale] ??
+            featuredImageField['en-US'] ??
+            Object.values(featuredImageField)[0];
+        if (localized && typeof localized === 'object' && 'sys' in localized) {
+            const id = localized.sys?.id;
+            if (id) {
+                return id;
+            }
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+export async function resolveSiteDefaultFeaturedImageAssetId(space, defaults) {
+    if (defaults.featuredImageAssetId) {
+        return defaults.featuredImageAssetId;
+    }
+    if (defaults.featuredImageAssetFilename) {
+        return resolveAssetIdFromFilename(space, defaults.featuredImageAssetFilename, 'site default featuredImage');
+    }
+    return undefined;
+}
+export async function resolveArticleFeaturedImageFallback(env, space, locale, articleTypeId, hasExplicitFeatured) {
+    if (hasExplicitFeatured) {
+        return { source: 'explicit' };
+    }
+    if (articleTypeId) {
+        const assetId = await getArticleTypeFeaturedImageAssetId(env, articleTypeId, locale);
+        if (assetId) {
+            return {
+                assetId,
+                source: 'articleType',
+                message: `Featured image inherited from articleType (${articleTypeId})`,
+            };
+        }
+    }
+    const defaults = getEditorDefaults();
+    if (defaults) {
+        const assetId = await resolveSiteDefaultFeaturedImageAssetId(space, defaults);
+        if (assetId) {
+            return {
+                assetId,
+                source: 'siteDefault',
+                message: 'Featured image set from site default (editor.defaults)',
+            };
+        }
+    }
+    return {
+        source: 'none',
+        message: 'No featured image set (optional — articleType or site default may apply on the live site)',
+    };
+}
+//# sourceMappingURL=featured-image-defaults.js.map

package/dist/contentful/featured-image-defaults.js.map

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

package/dist/contentful/fetch.d.ts

@@ -0,0 +1,31 @@
+import type { EntryProps } from 'contentful-management';
+import type { SerializedEntry } from '../session/state.js';
+import type { SafeEnvironment } from './client.js';
+/**
+ * Serializes a CMA Entry into the session's plain-object format.
+ */
+export declare function serializeEntry(entry: EntryProps): SerializedEntry;
+/**
+ * Normalises a slug for Contentful storage: strips leading and trailing slashes; empty becomes `index`.
+ */
+export declare function normalizeSlug(slug: string): string;
+/** Slug values to try when querying Contentful (with and without leading slash). */
+export declare function slugQueryVariants(slug: string): string[];
+/**
+ * Finds an entry of a specific content type by slug field.
+ */
+export declare function findEntryByContentTypeAndSlug(env: SafeEnvironment, contentType: string, slug: string): Promise<EntryProps | null>;
+/**
+ * Finds an entry by slug field. Searches page, article, articleType, tagType, and tag (one content type per query;
+ * the Management API does not allow field filters across multiple content types).
+ */
+export declare function findEntryBySlug(env: SafeEnvironment, slug: string, _locale: string): Promise<EntryProps | null>;
+/**
+ * Fetches a full entry tree starting from a root entry ID.
+ * Returns all entries keyed by ID.
+ * Only resolves content array fields (not visual/asset fields).
+ */
+export declare function fetchEntryTree(env: SafeEnvironment, rootEntryId: string, options?: {
+    includeTemplateChrome?: boolean;
+}): Promise<Record<string, SerializedEntry>>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/contentful/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/contentful/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAajE;AASD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGxD;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAU5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa5B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAChD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CA2B1C"}

package/dist/contentful/fetch.js

@@ -0,0 +1,115 @@
+import { collectLinkedEntryIdsAllLocales } from './linkedEntryFields.js';
+const BATCH_SIZE = 100;
+/**
+ * Serializes a CMA Entry into the session's plain-object format.
+ */
+export function serializeEntry(entry) {
+    return {
+        sys: {
+            id: entry.sys.id,
+            version: entry.sys.version,
+            publishedVersion: entry.sys.publishedVersion ?? undefined,
+            publishedAt: entry.sys.publishedAt ?? undefined,
+            contentType: { sys: { id: entry.sys.contentType.sys.id } },
+            createdAt: entry.sys.createdAt,
+            updatedAt: entry.sys.updatedAt,
+        },
+        fields: entry.fields,
+    };
+}
+/**
+ * Content types queried by slug for `open` / `peek` / backup.
+ * Order matters: first match wins if multiple types share a slug (page before article before taxonomy).
+ * Navigation uses its own slug query in nav.ts (navigation entries are opened via `cms-edit nav open`).
+ */
+const SLUG_CONTENT_TYPES = ['page', 'article', 'articleType', 'tagType', 'tag'];
+/**
+ * Normalises a slug for Contentful storage: strips leading and trailing slashes; empty becomes `index`.
+ */
+export function normalizeSlug(slug) {
+    let trimmed = slug.trim();
+    while (trimmed.startsWith('/')) {
+        trimmed = trimmed.slice(1);
+    }
+    while (trimmed.endsWith('/')) {
+        trimmed = trimmed.slice(0, -1);
+    }
+    return trimmed === '' ? 'index' : trimmed;
+}
+/** Slug values to try when querying Contentful (with and without leading slash). */
+export function slugQueryVariants(slug) {
+    const normalized = normalizeSlug(slug);
+    return [normalized, `/${normalized}`];
+}
+/**
+ * Finds an entry of a specific content type by slug field.
+ */
+export async function findEntryByContentTypeAndSlug(env, contentType, slug) {
+    for (const slugValue of slugQueryVariants(slug)) {
+        const result = await env.getEntries({
+            content_type: contentType,
+            'fields.slug': slugValue,
+            limit: 1,
+        });
+        if (result.items.length > 0)
+            return result.items[0] ?? null;
+    }
+    return null;
+}
+/**
+ * Finds an entry by slug field. Searches page, article, articleType, tagType, and tag (one content type per query;
+ * the Management API does not allow field filters across multiple content types).
+ */
+export async function findEntryBySlug(env, slug, _locale) {
+    for (const contentType of SLUG_CONTENT_TYPES) {
+        for (const slugValue of slugQueryVariants(slug)) {
+            const result = await env.getEntries({
+                content_type: contentType,
+                'fields.slug': slugValue,
+                limit: 1,
+            });
+            if (result.items.length > 0)
+                return result.items[0] ?? null;
+        }
+    }
+    return null;
+}
+/**
+ * Fetches a full entry tree starting from a root entry ID.
+ * Returns all entries keyed by ID.
+ * Only resolves content array fields (not visual/asset fields).
+ */
+export async function fetchEntryTree(env, rootEntryId, options = {}) {
+    const entries = {};
+    const toFetch = new Set([rootEntryId]);
+    const fetched = new Set();
+    while (toFetch.size > 0) {
+        const batch = Array.from(toFetch).slice(0, BATCH_SIZE);
+        for (const id of batch) {
+            toFetch.delete(id);
+        }
+        const result = await env.getEntries({ 'sys.id[in]': batch.join(','), limit: BATCH_SIZE });
+        for (const entry of result.items) {
+            const serialized = serializeEntry(entry);
+            entries[entry.sys.id] = serialized;
+            fetched.add(entry.sys.id);
+            const linkedIds = extractLinkedEntryIds(serialized, options.includeTemplateChrome === true);
+            for (const id of linkedIds) {
+                if (!fetched.has(id) && !toFetch.has(id)) {
+                    toFetch.add(id);
+                }
+            }
+        }
+    }
+    return entries;
+}
+/**
+ * Linked IDs for tree walk: content arrays, template/articleType/author/tags/authors,
+ * template preContent/postContent. Template menu/footer only when includeTemplateChrome.
+ */
+function extractLinkedEntryIds(entry, includeTemplateChrome) {
+    return collectLinkedEntryIdsAllLocales(entry.fields, entry.sys.contentType.sys.id, {
+        includeTemplateChrome,
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/contentful/fetch.js.map

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

package/dist/contentful/field-metadata.d.ts

@@ -0,0 +1,8 @@
+import type { ContentFields } from 'contentful-management';
+/**
+ * Optional per-field description from the Contentful model.
+ * The CMA may include `description` on field definitions, but `ContentFields` in
+ * `contentful-management` does not list it — so we read it with a small runtime check.
+ */
+export declare function readContentfulFieldDescription(field: ContentFields): string | undefined;
+//# sourceMappingURL=field-metadata.d.ts.map

package/dist/contentful/field-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-metadata.d.ts","sourceRoot":"","sources":["../../src/contentful/field-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAIvF"}

package/dist/contentful/field-metadata.js

@@ -0,0 +1,12 @@
+/**
+ * Optional per-field description from the Contentful model.
+ * The CMA may include `description` on field definitions, but `ContentFields` in
+ * `contentful-management` does not list it — so we read it with a small runtime check.
+ */
+export function readContentfulFieldDescription(field) {
+    if (!('description' in field))
+        return undefined;
+    const v = field.description;
+    return typeof v === 'string' && v.trim() ? v.trim() : undefined;
+}
+//# sourceMappingURL=field-metadata.js.map

package/dist/contentful/field-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-metadata.js","sourceRoot":"","sources":["../../src/contentful/field-metadata.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAAoB;IACjE,IAAI,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,CAAC,GAAI,KAAmD,CAAC,WAAW,CAAC;IAC3E,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC"}