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

package/dist/session/state.js

@@ -0,0 +1,93 @@
+/**
+ * Maps a CMA content type id to the session root kind. Unknown ids default to `page` (e.g. `--id` on a component).
+ */
+export function mapContentTypeIdToRootEntryType(contentTypeId) {
+    switch (contentTypeId) {
+        case 'page':
+            return 'page';
+        case 'article':
+            return 'article';
+        case 'articleType':
+            return 'articleType';
+        case 'tag':
+            return 'tag';
+        case 'navigation':
+            return 'navigation';
+        case 'template':
+            return 'template';
+        default:
+            return 'page';
+    }
+}
+/** Sentinel root entry ID for batch edit sessions (multiple unrelated entries by ID). */
+export const BATCH_ROOT_ENTRY_ID = '__batch__';
+/**
+ * Derives the display status of an entry.
+ *
+ * - changed: has unsaved local patches
+ * - draft: never published
+ * - pending: published but has newer draft on Contentful
+ * - published: published and no pending changes
+ */
+export function getEntryStatus(entry, isLocallyModified) {
+    if (isLocallyModified)
+        return 'changed';
+    const { publishedVersion, version } = entry.sys;
+    if (!publishedVersion)
+        return 'draft';
+    if (publishedVersion >= version - 1)
+        return 'published';
+    return 'pending';
+}
+/**
+ * Returns the content type ID for an entry (e.g. 'component', 'collection', 'page').
+ */
+function getContentTypeId(entry) {
+    return entry.sys.contentType.sys.id;
+}
+/**
+ * Returns the display type label for any content type.
+ * Looks for a ${ctId}Type discriminator field (e.g. componentType, collectionType,
+ * externalComponentType) and renders as TypeName[value] when present.
+ * Falls back to the capitalised content type ID for types without a discriminator.
+ */
+export function getEntryTypeLabel(entry, locale) {
+    const ctId = getContentTypeId(entry);
+    const typeFieldId = `${ctId}Type`;
+    const typeField = entry.fields[typeFieldId];
+    const val = typeField?.[locale] ?? typeField?.['en-US'];
+    if (typeof val === 'string' && val.trim()) {
+        const label = ctId.charAt(0).toUpperCase() + ctId.slice(1);
+        return `${label}[${val}]`;
+    }
+    return ctId.charAt(0).toUpperCase() + ctId.slice(1);
+}
+/**
+ * Returns the best display label (cmsLabel or heading or entry ID).
+ */
+export function getEntryLabel(entry, locale) {
+    const tryField = (fieldId) => {
+        const field = entry.fields[fieldId];
+        if (!field)
+            return null;
+        const val = field[locale] ?? field['en-US'];
+        return typeof val === 'string' && val.trim() ? val : null;
+    };
+    return (tryField('cmsLabel') ??
+        tryField('heading') ??
+        tryField('title') ??
+        tryField('name') ??
+        tryField('adminLabel') ??
+        entry.sys.id);
+}
+/** The content array fields that can contain linked entries. */
+export const CONTENT_ARRAY_FIELDS = [
+    'topContent',
+    'content',
+    'bottomContent',
+    'contents',
+    'structuredData',
+    'indexPageStructuredData',
+    'links',
+];
+//# sourceMappingURL=state.js.map

package/dist/session/state.js.map

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

package/dist/session/store.d.ts

@@ -0,0 +1,16 @@
+import type { SessionState } from './state.js';
+/**
+ * Returns the name of the active session from CLI options or the CONTENTFUL_CMS_SESSION env var.
+ * Used by all commands to support named, isolated sessions (--session <name>).
+ */
+export declare function resolveSessionName(cliName?: string): string | undefined;
+export declare function loadSession(spaceId?: string, rootEntryId?: string, sessionName?: string): Promise<SessionState | null>;
+export declare function saveSession(state: SessionState, sessionName?: string): Promise<void>;
+export declare function clearSession(spaceId: string, rootEntryId: string, sessionName?: string): Promise<void>;
+export declare function clearAllSessions(): Promise<void>;
+/**
+ * Loads the active session or throws a helpful error if none exists.
+ * Pass `sessionName` (or set CONTENTFUL_CMS_SESSION) to target a named session.
+ */
+export declare function requireSession(sessionName?: string, configPath?: string): Promise<SessionState>;
+//# sourceMappingURL=store.d.ts.map

package/dist/session/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/session/store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAUD,wBAAsB,WAAW,CAC/B,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAU9B;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1F;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAqCvB"}

package/dist/session/store.js

@@ -0,0 +1,89 @@
+import { ConfigUnavailableError, loadConfig } from '../config/load.js';
+import { isJsonMode } from '../output/mode.js';
+import { getRuntimeContext } from '../runtime/context.js';
+import { defaultFileSessionStore } from './file-session-store.js';
+import { sessionLog, sessionLogVerbose } from './log.js';
+/**
+ * Returns the name of the active session from CLI options or the CONTENTFUL_CMS_SESSION env var.
+ * Used by all commands to support named, isolated sessions (--session <name>).
+ */
+export function resolveSessionName(cliName) {
+    return cliName ?? process.env['CONTENTFUL_CMS_SESSION'] ?? undefined;
+}
+function getActiveSessionStore() {
+    return getRuntimeContext()?.sessionStore ?? defaultFileSessionStore;
+}
+async function resolveStoreResult(value) {
+    return await Promise.resolve(value);
+}
+export async function loadSession(spaceId, rootEntryId, sessionName) {
+    const resolvedName = resolveSessionName(sessionName);
+    sessionLogVerbose('loadSession', {
+        spaceId,
+        rootEntryId,
+        sessionName: resolvedName,
+        store: getActiveSessionStore().constructor.name,
+        userId: getRuntimeContext()?.user?.userId,
+    });
+    return resolveStoreResult(getActiveSessionStore().load(spaceId, rootEntryId, resolvedName));
+}
+export async function saveSession(state, sessionName) {
+    const resolvedName = resolveSessionName(sessionName);
+    sessionLogVerbose('saveSession', {
+        sessionName: resolvedName,
+        rootEntryId: state.rootEntryId,
+        spaceId: state.spaceId,
+        store: getActiveSessionStore().constructor.name,
+        userId: getRuntimeContext()?.user?.userId,
+    });
+    await resolveStoreResult(getActiveSessionStore().save(state, resolvedName));
+}
+export async function clearSession(spaceId, rootEntryId, sessionName) {
+    await resolveStoreResult(getActiveSessionStore().clear(spaceId, rootEntryId, resolveSessionName(sessionName)));
+}
+export async function clearAllSessions() {
+    await resolveStoreResult(getActiveSessionStore().clearAll());
+}
+/**
+ * Loads the active session or throws a helpful error if none exists.
+ * Pass `sessionName` (or set CONTENTFUL_CMS_SESSION) to target a named session.
+ */
+export async function requireSession(sessionName, configPath) {
+    const session = await loadSession(undefined, undefined, resolveSessionName(sessionName));
+    if (!session) {
+        const nameHint = resolveSessionName(sessionName);
+        const userId = getRuntimeContext()?.user?.userId;
+        const store = getActiveSessionStore().constructor.name;
+        sessionLog('requireSession miss', {
+            userId: userId ?? 'none',
+            sessionName: nameHint ?? 'default',
+            envSession: process.env['CONTENTFUL_CMS_SESSION'] ?? null,
+            store,
+        });
+        const hint = nameHint ? ` (session: ${nameHint})` : '';
+        let message = `No active session${hint}. Run 'cms-edit open --page-slug <slug>' or 'cms-edit open --id <id>' first.`;
+        if (isJsonMode()) {
+            message += ` Debug: userId=${userId ?? 'none'}, sessionName=${nameHint ?? 'default'}, store=${store}`;
+        }
+        throw new Error(message);
+    }
+    try {
+        const config = loadConfig(configPath);
+        const validSpaceKeys = Object.keys(config.spaces);
+        if (validSpaceKeys.length > 0 && !validSpaceKeys.includes(session.spaceKey)) {
+            throw new Error(`No active session for this project (spaces: ${validSpaceKeys.join(', ')}). ` +
+                `The most recent session is for space '${session.spaceKey}', which is not configured here. ` +
+                `Run 'cms-edit open --page-slug <slug>' to start a new session.`);
+        }
+    }
+    catch (e) {
+        if (e instanceof ConfigUnavailableError) {
+            // Config unavailable — skip space validation
+        }
+        else {
+            throw e;
+        }
+    }
+    return session;
+}
+//# sourceMappingURL=store.js.map

package/dist/session/store.js.map

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

package/dist/snapshot/field-value.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Renders a single field value for display (used by `read` and `peek`).
+ */
+export declare function renderFieldValue(value: unknown, indent?: string): string;
+//# sourceMappingURL=field-value.d.ts.map

package/dist/snapshot/field-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-value.d.ts","sourceRoot":"","sources":["../../src/snapshot/field-value.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAK,GAAG,MAAM,CAgBpE"}

package/dist/snapshot/field-value.js

@@ -0,0 +1,42 @@
+import pc from 'picocolors';
+import { isRtfDocument } from '../rtf/utils.js';
+/**
+ * Renders a single field value for display (used by `read` and `peek`).
+ */
+export function renderFieldValue(value, indent = '') {
+    if (value === null || value === undefined)
+        return pc.dim('(empty)');
+    if (typeof value === 'boolean')
+        return value ? pc.green('true') : pc.red('false');
+    if (typeof value === 'number')
+        return pc.yellow(String(value));
+    if (typeof value === 'string')
+        return value.length > 0 ? value : pc.dim('(empty string)');
+    if (isRtfDocument(value))
+        return pc.dim('[Rich text — use "cms-edit read <ref> <field>" to view]');
+    if (isEntryLink(value))
+        return pc.dim(`[Entry link → ${value.sys.id}]`);
+    if (isAssetLink(value))
+        return pc.dim(`[Asset link → ${value.sys.id}]`);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return pc.dim('(empty array)');
+        return value
+            .map((item, i) => `${indent}  [${i}] ${renderFieldValue(item, `${indent}  `)}`)
+            .join('\n');
+    }
+    return JSON.stringify(value, null, 2);
+}
+function isEntryLink(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'sys' in value &&
+        value.sys?.linkType === 'Entry');
+}
+function isAssetLink(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'sys' in value &&
+        value.sys?.linkType === 'Asset');
+}
+//# sourceMappingURL=field-value.js.map

package/dist/snapshot/field-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-value.js","sourceRoot":"","sources":["../../src/snapshot/field-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,MAAM,GAAG,EAAE;IAC1D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1F,IAAI,aAAa,CAAC,KAAK,CAAC;QACtB,OAAO,EAAE,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IAC3E,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACxE,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACxE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACvD,OAAO,KAAK;aACT,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,gBAAgB,CAAC,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC;aAC9E,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACb,KAAyC,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CACrE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACb,KAAyC,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CACrE,CAAC;AACJ,CAAC"}

package/dist/snapshot/fields.d.ts

@@ -0,0 +1,10 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { SerializedEntry } from '../session/state.js';
+export declare function buildEntryFieldsJson(entry: SerializedEntry, locale: string, field?: string): Record<string, unknown> | unknown;
+export declare function renderEntryFields(entry: SerializedEntry, locale: string, options: {
+    refLabel: string;
+    field?: string;
+    json?: boolean;
+    isModified?: boolean;
+}): void;
+//# sourceMappingURL=fields.d.ts.map

package/dist/snapshot/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/snapshot/fields.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAQvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAoBnC;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GACA,IAAI,CAuDN"}

package/dist/snapshot/fields.js

@@ -0,0 +1,72 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import pc from 'picocolors';
+import { entryFieldsToJson, entryToJson } from '../output/json.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg, statusBadge } from '../output/print.js';
+import { rtfToMarkdown } from '../rtf/toMarkdown.js';
+import { isRtfDocument } from '../rtf/utils.js';
+import { getEntryLabel, getEntryStatus, getEntryTypeLabel } from '../session/state.js';
+import { renderFieldValue } from './field-value.js';
+export function buildEntryFieldsJson(entry, locale, field) {
+    if (field) {
+        const fieldData = entry.fields[field];
+        if (!fieldData)
+            return {};
+        const serialized = entryFieldsToJson({ [field]: fieldData }, locale);
+        return serialized[field] ?? null;
+    }
+    return entryToJson({
+        sys: {
+            id: entry.sys.id,
+            contentType: { sys: { id: entry.sys.contentType.sys.id } },
+            publishedVersion: entry.sys.publishedVersion,
+            updatedAt: entry.sys.updatedAt,
+        },
+        fields: entry.fields,
+    }, locale);
+}
+export function renderEntryFields(entry, locale, options) {
+    const status = getEntryStatus(entry, options.isModified ?? false);
+    if (options.json || isJsonMode()) {
+        const json = buildEntryFieldsJson(entry, locale, options.field);
+        console.log(JSON.stringify(json, null, 2));
+        return;
+    }
+    if (options.field) {
+        const fieldData = entry.fields[options.field];
+        if (!fieldData) {
+            errorMsg(`Field "${options.field}" not found on this entry.`);
+            const available = Object.keys(entry.fields).join(', ');
+            console.log(pc.dim(`Available fields: ${available}`));
+            process.exit(1);
+        }
+        const value = fieldData[locale] ?? fieldData['en-US'];
+        if (isRtfDocument(value)) {
+            console.log(pc.bold(`\n${options.field} (rich text):\n`));
+            console.log(rtfToMarkdown(value));
+        }
+        else {
+            console.log(pc.bold(`\n${options.field}:\n`));
+            console.log(renderFieldValue(value));
+        }
+        return;
+    }
+    const typeLabel = getEntryTypeLabel(entry, locale);
+    const displayLabel = getEntryLabel(entry, locale);
+    console.log(`\n${pc.bold(options.refLabel)} ${pc.blue(typeLabel)} ${pc.white(`"${displayLabel}"`)}  ${statusBadge(status)}`);
+    console.log(pc.dim(`Entry ID: ${entry.sys.id}  v${entry.sys.version}  Content type: ${entry.sys.contentType.sys.id}\n`));
+    for (const [fieldId, fieldData] of Object.entries(entry.fields)) {
+        const value = fieldData[locale] ?? fieldData['en-US'];
+        const label = pc.bold(`${fieldId}:`).padEnd(30);
+        if (isRtfDocument(value)) {
+            console.log(`${label} ${pc.dim('[Rich text]')} — use: cms-edit read ${options.refLabel} ${fieldId}${options.refLabel.startsWith('@') ? '' : ' --id'}`);
+        }
+        else {
+            const rendered = renderFieldValue(value);
+            const firstLine = rendered.split('\n')[0] ?? rendered;
+            console.log(`${label} ${firstLine}`);
+        }
+    }
+    console.log('');
+}
+//# sourceMappingURL=fields.js.map

package/dist/snapshot/fields.js.map

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

package/dist/snapshot/render.d.ts

@@ -0,0 +1,21 @@
+import type { SafeEnvironment } from '../contentful/client.js';
+import type { SessionState } from '../session/state.js';
+export { renderFieldValue } from './field-value.js';
+export { renderEntryFields } from './fields.js';
+interface RenderOptions {
+    compact?: boolean;
+    /** Include root entry fields in output (used by peek for stateless field preview). */
+    includeRootFields?: boolean;
+}
+/**
+ * Renders the full content tree snapshot to stdout.
+ * In JSON mode emits a single JSON object; otherwise emits formatted human text.
+ */
+export declare function renderSnapshot(session: SessionState, options?: RenderOptions): void;
+/**
+ * Collects all unique asset IDs referenced in Link fields across all session entries,
+ * then fetches and prints them with title, fileName, and description (alt text).
+ * Flags assets missing a description. Only runs in human (non-JSON) mode.
+ */
+export declare function renderDeepLinkedAssets(session: SessionState, env: SafeEnvironment, locale: string): Promise<void>;
+//# sourceMappingURL=render.d.ts.map

package/dist/snapshot/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/snapshot/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AA8GD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CA6GvF;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/snapshot/render.js

@@ -0,0 +1,231 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import pc from 'picocolors';
+import { getAssetSummary } from '../contentful/assets.js';
+import { isJsonMode } from '../output/mode.js';
+import { entryLabel, refLabel, statusBadge, typeLabel } from '../output/print.js';
+import { getRuntimeContext } from '../runtime/context.js';
+import { buildSessionKey } from '../session/session-store.js';
+import { getEntryLabel, getEntryStatus, getEntryTypeLabel } from '../session/state.js';
+import { resolveSessionName } from '../session/store.js';
+import { buildEntryFieldsJson, renderEntryFields } from './fields.js';
+export { renderFieldValue } from './field-value.js';
+export { renderEntryFields } from './fields.js';
+/**
+ * Returns the snapshot as a plain JSON-serialisable object.
+ * Used by renderSnapshot when JSON mode is active.
+ */
+function buildSnapshotJson(session, options = {}) {
+    const locale = session.defaultLocale;
+    const rootEntry = session.entries[session.rootEntryId];
+    const rootStatus = rootEntry
+        ? getEntryStatus(rootEntry, session.modifiedEntryIds.includes(session.rootEntryId))
+        : 'draft';
+    const rootSlug = session.rootEntryType === 'template' || session.rootEntryType === 'navigation'
+        ? ''
+        : rootEntry
+            ? String(rootEntry.fields['slug']?.[locale] ?? rootEntry.fields['slug']?.['en-US'] ?? '?')
+            : '?';
+    const entries = [];
+    for (const node of session.treeNodes) {
+        if (node.entryId === session.rootEntryId)
+            continue;
+        const entry = session.entries[node.entryId];
+        if (!entry)
+            continue;
+        const isModified = session.modifiedEntryIds.includes(node.entryId);
+        const ctId = entry.sys.contentType.sys.id;
+        const typeFieldId = `${ctId}Type`;
+        const typeField = entry.fields[typeFieldId];
+        const typeVal = typeField?.[locale] ?? typeField?.['en-US'];
+        const parentNode = node.parentId
+            ? session.treeNodes.find((n) => n.entryId === node.parentId)
+            : null;
+        entries.push({
+            ref: node.ref,
+            entryId: node.entryId,
+            contentType: ctId,
+            type: typeof typeVal === 'string' ? typeVal : null,
+            label: getEntryLabel(entry, locale),
+            status: getEntryStatus(entry, isModified),
+            depth: node.depth,
+            parentRef: parentNode?.ref ?? null,
+            parentField: node.parentField,
+        });
+    }
+    const sessionName = resolveSessionName() ?? null;
+    const userId = getRuntimeContext()?.user?.userId;
+    const snapshot = {
+        rootType: session.rootEntryType,
+        rootSlug,
+        rootId: session.rootEntryId,
+        rootStatus,
+        spaceKey: session.spaceKey,
+        sessionName,
+        sessionKey: buildSessionKey(userId, session.spaceId, session.rootEntryId, sessionName ?? undefined),
+        fetchedAt: session.fetchedAt,
+        unsavedChanges: session.modifiedEntryIds.length,
+        pendingDeletions: session.pendingDeletions.length,
+        emptyContent: entries.length === 0,
+        entries,
+    };
+    if (options.includeRootFields && rootEntry) {
+        const fieldsJson = buildEntryFieldsJson(rootEntry, locale);
+        if (fieldsJson && typeof fieldsJson === 'object' && 'fields' in fieldsJson) {
+            snapshot.rootFields = fieldsJson.fields;
+        }
+    }
+    return snapshot;
+}
+/**
+ * Renders the full content tree snapshot to stdout.
+ * In JSON mode emits a single JSON object; otherwise emits formatted human text.
+ */
+export function renderSnapshot(session, options = {}) {
+    if (isJsonMode()) {
+        console.log(JSON.stringify(buildSnapshotJson(session, options), null, 2));
+        return;
+    }
+    const { compact = false } = options;
+    const locale = session.defaultLocale;
+    const rootEntry = session.entries[session.rootEntryId];
+    const rootStatus = rootEntry
+        ? getEntryStatus(rootEntry, session.modifiedEntryIds.includes(session.rootEntryId))
+        : 'draft';
+    const rootSlug = session.rootEntryType === 'template' || session.rootEntryType === 'navigation'
+        ? ''
+        : rootEntry
+            ? String(rootEntry.fields['slug']?.[locale] ?? rootEntry.fields['slug']?.['en-US'] ?? '?')
+            : '?';
+    const rootTitle = session.rootEntryType === 'template' && rootEntry
+        ? `Template: ${getEntryLabel(rootEntry, locale)}`
+        : session.rootEntryType === 'navigation' && rootEntry
+            ? `Navigation: ${getEntryLabel(rootEntry, locale)}`
+            : session.rootEntryType.charAt(0).toUpperCase() + session.rootEntryType.slice(1);
+    const slugPart = session.rootEntryType === 'template' || session.rootEntryType === 'navigation'
+        ? ''
+        : ` ${pc.cyan(`/${rootSlug}`)}  `;
+    console.log(`\n${pc.bold(rootTitle)}:${slugPart}` +
+        `${pc.dim(`[${session.rootEntryId} | `)}${statusBadge(rootStatus)}${pc.dim(']')}  ` +
+        `${pc.dim('·')}  ${pc.bold(session.spaceKey)}\n`);
+    // Show content-array separators (topContent / content / bottomContent) only when a page
+    // uses more than one distinct array at depth 1 — avoids noise in the common single-array case.
+    const depth1Fields = [
+        ...new Set(session.treeNodes
+            .filter((n) => n.depth === 1 && n.entryId !== session.rootEntryId && n.parentField)
+            .map((n) => n.parentField)),
+    ];
+    const showSeparators = depth1Fields.length > 1;
+    // Skip the root entry itself (index 0) — it's shown in the header
+    let componentsPrinted = 0;
+    let lastParentField = null;
+    for (const node of session.treeNodes) {
+        if (node.entryId === session.rootEntryId)
+            continue;
+        const entry = session.entries[node.entryId];
+        if (!entry)
+            continue;
+        if (showSeparators && node.depth === 1 && node.parentField !== lastParentField) {
+            if (lastParentField !== null)
+                console.log('');
+            console.log(pc.dim(`  ── ${node.parentField ?? 'content'} ──`));
+            lastParentField = node.parentField ?? null;
+        }
+        const isModified = session.modifiedEntryIds.includes(node.entryId);
+        const status = getEntryStatus(entry, isModified);
+        const typeLabelStr = getEntryTypeLabel(entry, locale);
+        const displayLabel = getEntryLabel(entry, locale);
+        const indent = '  '.repeat(node.depth);
+        if (compact) {
+            console.log(`${indent}${refLabel(node.ref)} ${typeLabel(typeLabelStr)}`);
+        }
+        else {
+            console.log(`${indent}${refLabel(node.ref)} ${typeLabel(typeLabelStr)} ${entryLabel(displayLabel)}  ${statusBadge(status)}`);
+        }
+        componentsPrinted++;
+    }
+    if (componentsPrinted === 0) {
+        if (options.includeRootFields && rootEntry) {
+            renderEntryFields(rootEntry, locale, { refLabel: '@root' });
+        }
+        else {
+            console.log(pc.dim(`  (no linked content — use ${pc.bold('read @root')} to inspect root fields)`));
+        }
+    }
+    else if (options.includeRootFields && rootEntry) {
+        console.log(pc.dim('\n  ── root fields ──'));
+        renderEntryFields(rootEntry, locale, { refLabel: '@root' });
+    }
+    const pendingCount = session.modifiedEntryIds.length;
+    const deletionCount = session.pendingDeletions.length;
+    if (pendingCount > 0 || deletionCount > 0) {
+        const parts = [];
+        if (pendingCount > 0)
+            parts.push(`${pendingCount} unsaved change${pendingCount > 1 ? 's' : ''}`);
+        if (deletionCount > 0)
+            parts.push(`${deletionCount} pending deletion${deletionCount > 1 ? 's' : ''}`);
+        console.log(`\n${pc.yellow(`⚠ ${parts.join(', ')} — run "cms-edit save" to write to Contentful`)}`);
+    }
+    console.log('');
+}
+/**
+ * Collects all unique asset IDs referenced in Link fields across all session entries,
+ * then fetches and prints them with title, fileName, and description (alt text).
+ * Flags assets missing a description. Only runs in human (non-JSON) mode.
+ */
+export async function renderDeepLinkedAssets(session, env, locale) {
+    const assetIds = new Set();
+    for (const entry of Object.values(session.entries)) {
+        for (const localeMap of Object.values(entry.fields)) {
+            const val = localeMap[locale] ?? localeMap['en-US'];
+            collectAssetIds(val, assetIds);
+        }
+    }
+    if (assetIds.size === 0) {
+        console.log(pc.dim('  (no asset links found in session entries)\n'));
+        return;
+    }
+    console.log(`\n${pc.bold('Linked assets')} ${pc.dim(`(${String(assetIds.size)} unique)`)}\n`);
+    const summaries = await Promise.all([...assetIds].map((id) => getAssetSummary(env, id)));
+    let missingCount = 0;
+    for (const summary of summaries) {
+        if (!summary)
+            continue;
+        const isImage = summary.contentType.startsWith('image/');
+        const hasDesc = Boolean(summary.description);
+        if (isImage && !hasDesc)
+            missingCount++;
+        const descStr = summary.description
+            ? pc.dim(summary.description)
+            : isImage
+                ? pc.red('(no alt text)')
+                : pc.dim('(no description)');
+        const dims = summary.width && summary.height ? `  ${summary.width}×${summary.height}` : '';
+        const icon = isImage && !hasDesc ? pc.red('✗') : pc.green('✓');
+        console.log(`  ${icon} ${pc.bold(summary.id)}  ${summary.title}  ${pc.dim(summary.fileName)}${pc.dim(dims)}`);
+        console.log(`      ${descStr}`);
+    }
+    if (missingCount > 0) {
+        console.log(`\n${pc.yellow(`⚠ ${String(missingCount)} image asset${missingCount === 1 ? '' : 's'} missing alt text`)}`);
+        console.log(pc.dim('  Fix with: cms-edit asset set-description <asset-id> "alt text"\n'));
+    }
+    else {
+        console.log(pc.green('\n  All image assets have alt text.\n'));
+    }
+}
+function collectAssetIds(val, out) {
+    if (!val || typeof val !== 'object')
+        return;
+    const obj = val;
+    if (obj['sys'] && typeof obj['sys'] === 'object') {
+        const sys = obj['sys'];
+        if (sys['linkType'] === 'Asset' && typeof sys['id'] === 'string') {
+            out.add(sys['id']);
+            return;
+        }
+    }
+    if (Array.isArray(val)) {
+        for (const item of val)
+            collectAssetIds(item, out);
+    }
+}
+//# sourceMappingURL=render.js.map