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

package/dist/contentful/field-value-from-json.d.ts

@@ -0,0 +1,24 @@
+import type { ContentFields } from 'contentful-management';
+import type { SpaceConfig } from '../config/types.js';
+import type { SafeEnvironment } from './client.js';
+export interface MediaSpecFromJson {
+    assetId: string;
+    name: string;
+    position?: string;
+    width?: number;
+}
+export interface ResolveComponentFieldsResult {
+    fields: Record<string, unknown>;
+    warnings: string[];
+    createdMediaEntryIds: string[];
+}
+/**
+ * Resolves explicit visual/mobileVisual shorthands in component `fields`, then returns
+ * remaining keys for scalar/RTF assignment.
+ */
+export declare function resolveComponentFieldsFromJson(rawFields: Record<string, unknown>, ctFields: ContentFields[], env: SafeEnvironment, space: SpaceConfig, locale: string): Promise<ResolveComponentFieldsResult>;
+/**
+ * Coerces a field value using content-type schema (Asset/Entry links, RTF unchanged).
+ */
+export declare function coerceLinkFieldValueFromJson(value: unknown, fieldDef: ContentFields | undefined): unknown;
+//# sourceMappingURL=field-value-from-json.d.ts.map

package/dist/contentful/field-value-from-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-value-from-json.d.ts","sourceRoot":"","sources":["../../src/contentful/field-value-from-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAwLD;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,EAAE,aAAa,EAAE,EACzB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,4BAA4B,CAAC,CA8BvC;AAmDD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,GAAG,SAAS,GAClC,OAAO,CAYT"}

package/dist/contentful/field-value-from-json.js

@@ -0,0 +1,206 @@
+import { mediaByAssetId } from '../index/query.js';
+import { ensureContentIndex } from '../index/require.js';
+import { makeAssetLink, makeEntryLink } from '../session/refs.js';
+import { resolveAssetIdFromFilename } from './asset-link-from-json.js';
+import { createMediaEntry, defaultMediaNameForAsset, } from './media.js';
+const VISUAL_FIELD_BASES = ['visual', 'mobileVisual'];
+function shorthandKeysForBase(base) {
+    return [
+        `${base}Id`,
+        `${base}AssetId`,
+        `${base}AssetFilename`,
+        `${base}Media`,
+        `${base}MediaName`,
+    ];
+}
+function isMediaSpec(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const o = value;
+    return typeof o.assetId === 'string' && typeof o.name === 'string';
+}
+function fieldLinkType(field) {
+    if (field?.type !== 'Link')
+        return undefined;
+    return field.linkType === 'Asset' ? 'Asset' : field.linkType === 'Entry' ? 'Entry' : undefined;
+}
+/**
+ * Picks the Media entry with the latest updatedAt for reuse.
+ */
+function pickNewestMediaId(rows, warnings, base) {
+    if (rows.length === 0) {
+        throw new Error(`Internal error: no Media rows for ${base}.`);
+    }
+    const sorted = [...rows].sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    const picked = sorted[0];
+    if (!picked) {
+        throw new Error(`Internal error: no Media rows for ${base}.`);
+    }
+    if (rows.length > 1) {
+        warnings.push(`Multiple Media entries link to the same asset for "${base}" — reusing the most recently updated (${picked.id}).`);
+    }
+    return picked.id;
+}
+async function resolveMediaForAssetFilename(env, space, locale, fileName, mediaName, base, warnings, createdMediaEntryIds) {
+    await ensureContentIndex(space);
+    const assetId = await resolveAssetIdFromFilename(space, fileName, `${base}AssetFilename`);
+    const mediaRows = mediaByAssetId(space, assetId);
+    if (mediaRows.length > 0) {
+        const mediaId = pickNewestMediaId(mediaRows, warnings, base);
+        return makeEntryLink(mediaId);
+    }
+    const fileStem = fileName.replace(/\.[^.]+$/, '').trim() || fileName.trim();
+    const name = mediaName?.trim() || (await defaultMediaNameForAsset(env, assetId, fileStem));
+    const { id } = await createMediaEntry(env, {
+        assetId,
+        name,
+        locale,
+    });
+    createdMediaEntryIds.push(id);
+    return makeEntryLink(id);
+}
+async function applyVisualShorthandsForBase(base, fields, fieldById, env, space, locale, warnings, createdMediaEntryIds) {
+    const fieldDef = fieldById.get(base);
+    if (!fieldDef) {
+        for (const key of shorthandKeysForBase(base)) {
+            if (fields[key] !== undefined) {
+                warnings.push(`Field "${base}" does not exist on this content type — ignoring "${key}".`);
+                delete fields[key];
+            }
+        }
+        if (fields[base] !== undefined) {
+            warnings.push(`Field "${base}" does not exist on this content type — ignoring "${base}".`);
+            delete fields[base];
+        }
+        return;
+    }
+    const linkType = fieldLinkType(fieldDef);
+    const idKey = `${base}Id`;
+    const assetIdKey = `${base}AssetId`;
+    const filenameKey = `${base}AssetFilename`;
+    const mediaKey = `${base}Media`;
+    const mediaNameKey = `${base}MediaName`;
+    let resolved;
+    const mediaSpec = fields[mediaKey];
+    if (mediaSpec !== undefined) {
+        if (!isMediaSpec(mediaSpec)) {
+            throw new Error(`"${mediaKey}" must be an object with "assetId" and "name". See: cms-edit help create-from-json`);
+        }
+        if (linkType !== 'Entry') {
+            throw new Error(`Field "${base}" is not an Entry link — cannot use "${mediaKey}".`);
+        }
+        const { id } = await createMediaEntry(env, {
+            assetId: mediaSpec.assetId,
+            name: mediaSpec.name,
+            locale,
+            position: mediaSpec.position,
+            width: mediaSpec.width,
+        });
+        createdMediaEntryIds.push(id);
+        resolved = makeEntryLink(id);
+    }
+    else if (fields[filenameKey] !== undefined) {
+        const fileName = String(fields[filenameKey]);
+        if (linkType === 'Asset') {
+            const assetId = await resolveAssetIdFromFilename(space, fileName, filenameKey);
+            resolved = makeAssetLink(assetId);
+        }
+        else {
+            const mediaName = fields[mediaNameKey] !== undefined ? String(fields[mediaNameKey]) : undefined;
+            resolved = await resolveMediaForAssetFilename(env, space, locale, fileName, mediaName, base, warnings, createdMediaEntryIds);
+        }
+    }
+    else if (fields[assetIdKey] !== undefined) {
+        const assetId = String(fields[assetIdKey]).trim();
+        if (linkType !== 'Asset') {
+            throw new Error(`Field "${base}" is an Entry link (Media) — use "${idKey}", "${filenameKey}", or "${mediaKey}", not "${assetIdKey}".`);
+        }
+        resolved = makeAssetLink(assetId);
+    }
+    else if (fields[idKey] !== undefined) {
+        const entryId = String(fields[idKey]).trim();
+        if (linkType !== 'Entry') {
+            throw new Error(`Field "${base}" is an Asset link — use "${assetIdKey}" or "${filenameKey}", not "${idKey}".`);
+        }
+        resolved = makeEntryLink(entryId);
+    }
+    else if (typeof fields[base] === 'string') {
+        const entryId = fields[base].trim();
+        if (linkType === 'Asset') {
+            throw new Error(`Field "${base}" is an Asset link — use "${assetIdKey}" or "${filenameKey}", not a bare string on "${base}".`);
+        }
+        resolved = makeEntryLink(entryId);
+    }
+    if (resolved !== undefined) {
+        fields[base] = resolved;
+    }
+    for (const key of shorthandKeysForBase(base)) {
+        delete fields[key];
+    }
+}
+/**
+ * Resolves explicit visual/mobileVisual shorthands in component `fields`, then returns
+ * remaining keys for scalar/RTF assignment.
+ */
+export async function resolveComponentFieldsFromJson(rawFields, ctFields, env, space, locale) {
+    const warnings = [];
+    const createdMediaEntryIds = [];
+    const fields = { ...rawFields };
+    const fieldById = new Map(ctFields.map((f) => [f.id, f]));
+    for (const base of VISUAL_FIELD_BASES) {
+        await applyVisualShorthandsForBase(base, fields, fieldById, env, space, locale, warnings, createdMediaEntryIds);
+    }
+    await applyGenericLinkShorthands(fields, fieldById, env, space, locale, warnings, createdMediaEntryIds);
+    return { fields, warnings, createdMediaEntryIds };
+}
+async function applyGenericLinkShorthands(fields, fieldById, _env, space, _locale, _warnings, _createdMediaEntryIds) {
+    for (const [fieldId, fieldDef] of fieldById) {
+        if (VISUAL_FIELD_BASES.includes(fieldId))
+            continue;
+        if (fields[fieldId] !== undefined)
+            continue;
+        const assetIdKey = `${fieldId}AssetId`;
+        const filenameKey = `${fieldId}AssetFilename`;
+        const entryIdKey = `${fieldId}Id`;
+        if (fieldDef.type === 'Link' && fieldDef.linkType === 'Asset') {
+            if (fields[filenameKey] !== undefined) {
+                const assetId = await resolveAssetIdFromFilename(space, String(fields[filenameKey]), filenameKey);
+                fields[fieldId] = makeAssetLink(assetId);
+                delete fields[filenameKey];
+                continue;
+            }
+            if (fields[assetIdKey] !== undefined) {
+                fields[fieldId] = makeAssetLink(String(fields[assetIdKey]).trim());
+                delete fields[assetIdKey];
+            }
+            continue;
+        }
+        if (fieldDef.type === 'Link' && fieldDef.linkType === 'Entry') {
+            if (fields[filenameKey] !== undefined || fields[assetIdKey] !== undefined) {
+                throw new Error(`Field "${fieldId}" is an Entry link — use "${entryIdKey}" or visual-style "${fieldId}Media", not "${assetIdKey}" / "${filenameKey}".`);
+            }
+            if (fields[entryIdKey] !== undefined) {
+                fields[fieldId] = makeEntryLink(String(fields[entryIdKey]).trim());
+                delete fields[entryIdKey];
+            }
+        }
+    }
+}
+/**
+ * Coerces a field value using content-type schema (Asset/Entry links, RTF unchanged).
+ */
+export function coerceLinkFieldValueFromJson(value, fieldDef) {
+    if (typeof value !== 'string')
+        return value;
+    const trimmed = value.trim();
+    if (fieldDef?.type !== 'Link')
+        return value;
+    if (fieldDef.linkType === 'Asset') {
+        return makeAssetLink(trimmed);
+    }
+    if (fieldDef.linkType === 'Entry') {
+        return makeEntryLink(trimmed);
+    }
+    return value;
+}
+//# sourceMappingURL=field-value-from-json.js.map

package/dist/contentful/field-value-from-json.js.map

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

package/dist/contentful/hosted-asset-upload.d.ts

@@ -0,0 +1,4 @@
+/** True when asset upload runs on hosted MCP (no reliable inline base64 in tool args). */
+export declare function isHostedAssetUploadContext(): boolean;
+export declare const HOSTED_ASSET_UPLOAD_BASE64_ERROR = "asset upload --base64 is not supported on hosted MCP. Use cms_edit_request_staged_upload, run the returned curlCommand, then asset upload --staged <uploadId> with --mime and --file-name.";
+//# sourceMappingURL=hosted-asset-upload.d.ts.map

package/dist/contentful/hosted-asset-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-asset-upload.d.ts","sourceRoot":"","sources":["../../src/contentful/hosted-asset-upload.ts"],"names":[],"mappings":"AAGA,0FAA0F;AAC1F,wBAAgB,0BAA0B,IAAI,OAAO,CAGpD;AAED,eAAO,MAAM,gCAAgC,+LACiJ,CAAC"}

package/dist/contentful/hosted-asset-upload.js

@@ -0,0 +1,9 @@
+import { getRuntimeContext } from '../runtime/context.js';
+import { isHostedMcpMode } from '../telemetry/enrich.js';
+/** True when asset upload runs on hosted MCP (no reliable inline base64 in tool args). */
+export function isHostedAssetUploadContext() {
+    const context = getRuntimeContext();
+    return isHostedMcpMode() || Boolean(context?.stagedUploadStore);
+}
+export const HOSTED_ASSET_UPLOAD_BASE64_ERROR = 'asset upload --base64 is not supported on hosted MCP. Use cms_edit_request_staged_upload, run the returned curlCommand, then asset upload --staged <uploadId> with --mime and --file-name.';
+//# sourceMappingURL=hosted-asset-upload.js.map

package/dist/contentful/hosted-asset-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-asset-upload.js","sourceRoot":"","sources":["../../src/contentful/hosted-asset-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,0FAA0F;AAC1F,MAAM,UAAU,0BAA0B;IACxC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,OAAO,eAAe,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,MAAM,gCAAgC,GAC3C,4LAA4L,CAAC"}

package/dist/contentful/link-fields.d.ts

@@ -0,0 +1,22 @@
+import type { SafeEnvironment } from './client.js';
+export type LinkType = 'internal' | 'external' | 'download' | 'blank';
+export interface BuildLinkEntryFieldsOptions {
+    type?: LinkType;
+    label?: string;
+    href?: string;
+    /** Resolved Contentful entry ID for internal links */
+    internalEntryId?: string;
+    assetId?: string;
+    variant?: string;
+}
+/**
+ * Resolve a page/article slug to a Contentful entry ID.
+ */
+export declare function resolveSlugToEntryId(env: SafeEnvironment, slug: string): Promise<string | null>;
+/**
+ * Build CMA locale-keyed fields for a new `link` content type entry.
+ * Caller must resolve slug → entry ID before calling for internal links.
+ */
+export declare function buildLinkEntryFields(opts: BuildLinkEntryFieldsOptions, locale: string): Record<string, Record<string, unknown>>;
+export declare function getLinkFieldValue(fields: Record<string, Record<string, unknown>>, fieldId: string, locale: string): unknown;
+//# sourceMappingURL=link-fields.d.ts.map

package/dist/contentful/link-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-fields.d.ts","sourceRoot":"","sources":["../../src/contentful/link-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,2BAA2B,EACjC,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6BzC;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAET"}

package/dist/contentful/link-fields.js

@@ -0,0 +1,58 @@
+const SLUG_CONTENT_TYPES = ['page', 'article', 'articleType', 'tag'];
+/**
+ * Resolve a page/article slug to a Contentful entry ID.
+ */
+export async function resolveSlugToEntryId(env, slug) {
+    let slugValue = slug.startsWith('/') ? slug.slice(1) : slug;
+    if (slugValue.endsWith('/'))
+        slugValue = slugValue.slice(0, -1);
+    for (const ct of SLUG_CONTENT_TYPES) {
+        const results = await env.getEntries({
+            content_type: ct,
+            'fields.slug': slugValue,
+            limit: 1,
+        });
+        if (results.items[0])
+            return results.items[0].sys.id;
+    }
+    return null;
+}
+/**
+ * Build CMA locale-keyed fields for a new `link` content type entry.
+ * Caller must resolve slug → entry ID before calling for internal links.
+ */
+export function buildLinkEntryFields(opts, locale) {
+    const linkType = opts.type ?? 'external';
+    const fields = {
+        name: { [locale]: opts.label ?? '' },
+        useName: { [locale]: true },
+    };
+    if (opts.variant !== undefined && opts.variant !== '') {
+        fields['variant'] = { [locale]: opts.variant };
+    }
+    if (linkType === 'internal') {
+        if (!opts.internalEntryId) {
+            throw new Error('Internal links require a resolved internal entry ID.');
+        }
+        fields['internal'] = {
+            [locale]: { sys: { type: 'Link', linkType: 'Entry', id: opts.internalEntryId.trim() } },
+        };
+    }
+    else if (linkType === 'external') {
+        if (!opts.href)
+            throw new Error('External links require href.');
+        fields['external'] = { [locale]: opts.href };
+    }
+    else if (linkType === 'download') {
+        if (!opts.assetId)
+            throw new Error('Download links require assetId.');
+        fields['downloadAsset'] = {
+            [locale]: { sys: { type: 'Link', linkType: 'Asset', id: opts.assetId.trim() } },
+        };
+    }
+    return fields;
+}
+export function getLinkFieldValue(fields, fieldId, locale) {
+    return fields[fieldId]?.[locale] ?? fields[fieldId]?.['en-US'] ?? null;
+}
+//# sourceMappingURL=link-fields.js.map

package/dist/contentful/link-fields.js.map

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

package/dist/contentful/linkedEntryFields.d.ts

@@ -0,0 +1,29 @@
+/** Content array fields traversed when resolving entry trees (fetch + audit). */
+export declare const CONTENT_ARRAY_FIELDS: readonly ["topContent", "content", "bottomContent", "contents"];
+/** Extra content arrays on template entries. */
+export declare const TEMPLATE_EXTRA_CONTENT_ARRAY_FIELDS: readonly ["preContent", "postContent"];
+/** Single entry-link fields on articles and related types. */
+export declare const LINKED_ENTRY_SINGLE_FIELDS: readonly ["template", "articleType", "author"];
+/** Array entry-link fields (e.g. article tags, authors). */
+export declare const LINKED_ENTRY_ARRAY_FIELDS: readonly ["tags", "authors"];
+/** Single entry-link fields on template entries. */
+export declare const TEMPLATE_SINGLE_LINK_FIELDS: readonly ["menu", "footer"];
+/** Array entry-link fields on navigation entries. */
+export declare const NAVIGATION_ARRAY_FIELDS: readonly ["items", "navigationItems"];
+export declare function isEntryLink(item: unknown): item is {
+    sys: {
+        id: string;
+        linkType: 'Entry';
+    };
+};
+/**
+ * Collects linked entry IDs from content / link fields for one locale (audit traversal).
+ */
+export declare function collectLinkedEntryIdsForLocale(fields: Record<string, Record<string, unknown>>, locale: string, contentArrayFields: readonly string[]): string[];
+/**
+ * Collects linked entry IDs from content / link fields across all locales (fetch tree).
+ */
+export declare function collectLinkedEntryIdsAllLocales(fields: Record<string, Record<string, unknown>>, contentTypeId: string, options?: {
+    includeTemplateChrome?: boolean;
+}): string[];
+//# sourceMappingURL=linkedEntryFields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkedEntryFields.d.ts","sourceRoot":"","sources":["../../src/contentful/linkedEntryFields.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,iEAAkE,CAAC;AAEpG,gDAAgD;AAChD,eAAO,MAAM,mCAAmC,wCAAyC,CAAC;AAE1F,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,gDAAiD,CAAC;AAEzF,4DAA4D;AAC5D,eAAO,MAAM,yBAAyB,8BAA+B,CAAC;AAEtE,oDAAoD;AACpD,eAAO,MAAM,2BAA2B,6BAA8B,CAAC;AAEvE,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,uCAAwC,CAAC;AAE7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI;IAAE,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAQ7F;AAmBD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,SAAS,MAAM,EAAE,GACpC,MAAM,EAAE,CAiBV;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAChD,MAAM,EAAE,CA6CV"}

package/dist/contentful/linkedEntryFields.js

@@ -0,0 +1,97 @@
+/** Content array fields traversed when resolving entry trees (fetch + audit). */
+export const CONTENT_ARRAY_FIELDS = ['topContent', 'content', 'bottomContent', 'contents'];
+/** Extra content arrays on template entries. */
+export const TEMPLATE_EXTRA_CONTENT_ARRAY_FIELDS = ['preContent', 'postContent'];
+/** Single entry-link fields on articles and related types. */
+export const LINKED_ENTRY_SINGLE_FIELDS = ['template', 'articleType', 'author'];
+/** Array entry-link fields (e.g. article tags, authors). */
+export const LINKED_ENTRY_ARRAY_FIELDS = ['tags', 'authors'];
+/** Single entry-link fields on template entries. */
+export const TEMPLATE_SINGLE_LINK_FIELDS = ['menu', 'footer'];
+/** Array entry-link fields on navigation entries. */
+export const NAVIGATION_ARRAY_FIELDS = ['items', 'navigationItems'];
+export function isEntryLink(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'sys' in item &&
+        typeof item.sys === 'object' &&
+        item.sys.linkType === 'Entry');
+}
+function localizedFieldValue(fields, fieldId, locale) {
+    const fieldData = fields[fieldId];
+    if (!fieldData)
+        return undefined;
+    return fieldData[locale] ?? fieldData['en-US'];
+}
+function collectFromArrayValue(val, ids) {
+    if (!Array.isArray(val))
+        return;
+    for (const item of val) {
+        if (isEntryLink(item))
+            ids.push(item.sys.id);
+    }
+}
+/**
+ * Collects linked entry IDs from content / link fields for one locale (audit traversal).
+ */
+export function collectLinkedEntryIdsForLocale(fields, locale, contentArrayFields) {
+    const ids = [];
+    for (const fieldId of contentArrayFields) {
+        collectFromArrayValue(localizedFieldValue(fields, fieldId, locale), ids);
+    }
+    for (const fieldId of LINKED_ENTRY_SINGLE_FIELDS) {
+        const val = localizedFieldValue(fields, fieldId, locale);
+        if (isEntryLink(val))
+            ids.push(val.sys.id);
+    }
+    for (const fieldId of LINKED_ENTRY_ARRAY_FIELDS) {
+        collectFromArrayValue(localizedFieldValue(fields, fieldId, locale), ids);
+    }
+    return ids;
+}
+/**
+ * Collects linked entry IDs from content / link fields across all locales (fetch tree).
+ */
+export function collectLinkedEntryIdsAllLocales(fields, contentTypeId, options = {}) {
+    const ids = [];
+    const forEachLocaleValue = (fieldId, cb) => {
+        const fieldData = fields[fieldId];
+        if (!fieldData)
+            return;
+        for (const localeValue of Object.values(fieldData)) {
+            cb(localeValue);
+        }
+    };
+    for (const fieldId of CONTENT_ARRAY_FIELDS) {
+        forEachLocaleValue(fieldId, (localeValue) => collectFromArrayValue(localeValue, ids));
+    }
+    for (const fieldId of LINKED_ENTRY_SINGLE_FIELDS) {
+        forEachLocaleValue(fieldId, (localeValue) => {
+            if (isEntryLink(localeValue))
+                ids.push(localeValue.sys.id);
+        });
+    }
+    for (const fieldId of LINKED_ENTRY_ARRAY_FIELDS) {
+        forEachLocaleValue(fieldId, (localeValue) => collectFromArrayValue(localeValue, ids));
+    }
+    if (contentTypeId === 'template') {
+        for (const fieldId of TEMPLATE_EXTRA_CONTENT_ARRAY_FIELDS) {
+            forEachLocaleValue(fieldId, (localeValue) => collectFromArrayValue(localeValue, ids));
+        }
+        if (options.includeTemplateChrome) {
+            for (const fieldId of TEMPLATE_SINGLE_LINK_FIELDS) {
+                forEachLocaleValue(fieldId, (localeValue) => {
+                    if (isEntryLink(localeValue))
+                        ids.push(localeValue.sys.id);
+                });
+            }
+        }
+    }
+    if (contentTypeId === 'navigation') {
+        for (const fieldId of NAVIGATION_ARRAY_FIELDS) {
+            forEachLocaleValue(fieldId, (localeValue) => collectFromArrayValue(localeValue, ids));
+        }
+    }
+    return ids;
+}
+//# sourceMappingURL=linkedEntryFields.js.map

package/dist/contentful/linkedEntryFields.js.map

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

package/dist/contentful/list-entry-format.d.ts

@@ -0,0 +1,18 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { EntryProps } from 'contentful-management';
+export interface EntryLineAssetInfo {
+    id: string;
+    fileName: string;
+}
+export declare function getEntryTitle(fields: Record<string, Record<string, unknown>>, locale: string, fallbackId: string): string;
+export declare function getEntrySlug(fields: Record<string, Record<string, unknown>>, locale: string): string | undefined;
+export declare function extractLinkedAssetId(fields: Record<string, Record<string, unknown>>, locale: string): string | null;
+export declare function printIndexedMediaLine(row: {
+    id: string;
+    name: string;
+    assetId: string;
+    assetFileName: string;
+    updatedAt: string;
+}): void;
+export declare function printEntryLine(entry: EntryProps, locale: string, assetInfo?: EntryLineAssetInfo): void;
+//# sourceMappingURL=list-entry-format.d.ts.map

package/dist/contentful/list-entry-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-entry-format.d.ts","sourceRoot":"","sources":["../../src/contentful/list-entry-format.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAWf;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAIP;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,kBAAkB,GAC7B,IAAI,CAaN"}

package/dist/contentful/list-entry-format.js

@@ -0,0 +1,45 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import pc from 'picocolors';
+export function getEntryTitle(fields, locale, fallbackId) {
+    return String(fields['title']?.[locale] ??
+        fields['title']?.['en-US'] ??
+        fields['name']?.[locale] ??
+        fields['name']?.['en-US'] ??
+        fields['cmsLabel']?.[locale] ??
+        fields['cmsLabel']?.['en-US'] ??
+        fallbackId);
+}
+export function getEntrySlug(fields, locale) {
+    const slugVal = fields['slug']?.[locale] ?? fields['slug']?.['en-US'];
+    return slugVal !== undefined && slugVal !== null ? String(slugVal) : undefined;
+}
+export function extractLinkedAssetId(fields, locale) {
+    const assetLink = fields['asset']?.[locale] ?? fields['asset']?.['en-US'];
+    if (assetLink &&
+        typeof assetLink === 'object' &&
+        'sys' in assetLink &&
+        typeof assetLink.sys?.id === 'string') {
+        return assetLink.sys.id;
+    }
+    return null;
+}
+export function printIndexedMediaLine(row) {
+    console.log(`  ${pc.bold(row.id)}  ${pc.blue('[media]')}  ${row.name}`);
+    console.log(`    ${pc.dim(`asset: ${row.assetId}  ${row.assetFileName}`)}`);
+    console.log(`    ${pc.dim(`Updated: ${row.updatedAt}`)}`);
+}
+export function printEntryLine(entry, locale, assetInfo) {
+    const ctId = entry.sys.contentType.sys.id;
+    const fields = entry.fields;
+    const title = getEntryTitle(fields, locale, entry.sys.id);
+    const slugVal = getEntrySlug(fields, locale);
+    const status = entry.sys.publishedVersion ? pc.green('published') : pc.cyan('draft');
+    console.log(`  ${pc.bold(entry.sys.id)}  ${pc.blue(`[${ctId}]`)}  ${title}  ${status}`);
+    if (slugVal)
+        console.log(`    ${pc.dim(`slug: /${slugVal}`)}`);
+    if (assetInfo) {
+        console.log(`    ${pc.dim(`asset: ${assetInfo.id}  ${assetInfo.fileName}`)}`);
+    }
+    console.log(`    ${pc.dim(`Updated: ${entry.sys.updatedAt}`)}`);
+}
+//# sourceMappingURL=list-entry-format.js.map

package/dist/contentful/list-entry-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-entry-format.js","sourceRoot":"","sources":["../../src/contentful/list-entry-format.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAGvF,OAAO,EAAE,MAAM,YAAY,CAAC;AAO5B,MAAM,UAAU,aAAa,CAC3B,MAA+C,EAC/C,MAAc,EACd,UAAkB;IAElB,OAAO,MAAM,CACX,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC;QACvB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;QAC1B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC;QACxB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC;QACzB,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC;QAC5B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC;QAC7B,UAAU,CACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAA+C,EAC/C,MAAc;IAEd,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACtE,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAA+C,EAC/C,MAAc;IAEd,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IAC1E,IACE,SAAS;QACT,OAAO,SAAS,KAAK,QAAQ;QAC7B,KAAK,IAAI,SAAS;QAClB,OAAQ,SAAuC,CAAC,GAAG,EAAE,EAAE,KAAK,QAAQ,EACpE,CAAC;QACD,OAAQ,SAAqC,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAMrC;IACC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAiB,EACjB,MAAc,EACd,SAA8B;IAE9B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAiD,CAAC;IACvE,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErF,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;IACxF,IAAI,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,UAAU,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/contentful/media.d.ts

@@ -0,0 +1,26 @@
+import type { EntryProps } from 'contentful-management';
+import type { SafeEnvironment } from './client.js';
+export type MediaHorizontalPosition = 'Left' | 'Middle' | 'Right';
+export declare function parseMediaHorizontalPosition(input: string | undefined): MediaHorizontalPosition | undefined;
+export interface CreateMediaEntryOptions {
+    assetId: string;
+    name: string;
+    locale: string;
+    position?: string;
+    width?: number;
+}
+/** Media entry list label — prefer the linked asset's title. */
+export declare function defaultMediaNameForAsset(env: SafeEnvironment, assetId: string, fallback?: string): Promise<string>;
+/**
+ * Creates a draft Media entry linking to an asset.
+ */
+export declare function createMediaEntry(env: SafeEnvironment, opts: CreateMediaEntryOptions): Promise<{
+    id: string;
+}>;
+export declare function listMediaForAsset(env: SafeEnvironment, assetId: string, locale: string): Promise<Array<{
+    id: string;
+    name: string;
+}>>;
+/** Fetches all Media entries linking to an asset (paginated). */
+export declare function listAllMediaForAsset(env: SafeEnvironment, assetId: string, _locale: string): Promise<EntryProps[]>;
+//# sourceMappingURL=media.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/contentful/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,uBAAuB,GAAG,SAAS,CASrC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BzB;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAG9C;AAQD,iEAAiE;AACjE,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBvB"}