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

package/dist/commands/preview.js

@@ -0,0 +1,242 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { createSafeEnvironment } from '../contentful/client.js';
+import { findEntryByContentTypeAndSlug, findEntryBySlug, normalizeSlug, } from '../contentful/fetch.js';
+import { listReferencesBySlug } from '../index/query.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg } from '../output/print.js';
+import { appendRequestParams, buildShowcaseUrl, parseParamOverrides, } from '../preview/capture-urls.js';
+import { buildAllPreviewUrls } from '../preview/entry-urls.js';
+import { loadSession } from '../session/store.js';
+/** Collect repeatable --param key=value into an array. */
+function collectParam(value, prev) {
+    prev.push(value);
+    return prev;
+}
+export function registerPreviewCommand(program) {
+    const preview = program.command('preview').description('Generate preview URLs for content');
+    preview
+        .command('url [slug]')
+        .description('Generate a preview URL for a page slug, including any deployment-protection bypass params.\n' +
+        'If no slug is given, uses the slug from the active session root entry.\n' +
+        'Example: cms-edit preview url about-us\n' +
+        'Example: cms-edit preview url  (uses session slug)')
+        .action(async (slug, _opts, cmd) => {
+        const parentOpts = cmd.parent?.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            let spaceKey = parentOpts.space;
+            let resolvedSlug = slug;
+            if (!spaceKey || !resolvedSlug) {
+                try {
+                    const session = await loadSession(undefined, undefined, parentOpts.session);
+                    if (session) {
+                        spaceKey ??= session.spaceKey;
+                        if (!resolvedSlug) {
+                            const locale = session.defaultLocale;
+                            const rootEntry = session.entries[session.rootEntryId];
+                            const slugVal = rootEntry?.fields['slug']?.[locale] ?? rootEntry?.fields['slug']?.['en-US'];
+                            if (typeof slugVal === 'string' && slugVal) {
+                                resolvedSlug = slugVal;
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // No session — that's fine if slug was provided
+                }
+            }
+            const { space } = resolveSpaceConfig(config, spaceKey);
+            if (!space.devBaseUrl) {
+                errorMsg(`No devBaseUrl configured for this space. ` +
+                    `Add "devBaseUrl": "http://localhost:<port>" to your .contentful-cms.json.`);
+                process.exit(1);
+                return;
+            }
+            if (!resolvedSlug) {
+                errorMsg('No slug provided and no active session. ' + 'Pass a slug: cms-edit preview url <slug>');
+                process.exit(1);
+                return;
+            }
+            const normalizedSlug = resolvedSlug.startsWith('/') ? resolvedSlug : `/${resolvedSlug}`;
+            const rawUrl = `${space.devBaseUrl}${normalizedSlug}`;
+            const url = appendRequestParams(rawUrl, space.requestParams);
+            if (isJsonMode()) {
+                console.log(JSON.stringify({
+                    url,
+                    baseUrl: space.devBaseUrl,
+                    slug: resolvedSlug,
+                    params: space.requestParams ?? {},
+                }, null, 2));
+                return;
+            }
+            console.log(`\n${url}\n`);
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    preview
+        .command('urls [slug]')
+        .description('Generate all preview URLs for an entry: staging, production, site live preview, Contentful entry.\n' +
+        'Uses session entry ID when available. Open returned URLs with a browser MCP.\n' +
+        'Example: cms-edit preview urls /about\n' +
+        'Example: cms-edit preview urls  (uses session slug + entry id)')
+        .option('--entry-id <id>', 'Contentful entry ID (defaults to session root entry)')
+        .option('--focused-field <field>', 'Contentful focusedField query param (e.g. cmsLabel)')
+        .action(async (slug, opts, cmd) => {
+        const parentOpts = cmd.parent?.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            let spaceKey = parentOpts.space;
+            let resolvedSlug = slug;
+            let entryId = opts.entryId;
+            try {
+                const session = await loadSession(undefined, undefined, parentOpts.session);
+                if (session) {
+                    spaceKey ??= session.spaceKey;
+                    entryId ??= session.rootEntryId;
+                    if (!resolvedSlug) {
+                        const locale = session.defaultLocale;
+                        const rootEntry = session.entries[session.rootEntryId];
+                        const slugVal = rootEntry?.fields['slug']?.[locale] ?? rootEntry?.fields['slug']?.['en-US'];
+                        if (typeof slugVal === 'string' && slugVal) {
+                            resolvedSlug = slugVal;
+                        }
+                    }
+                }
+            }
+            catch {
+                // No session — entry id / slug may still be passed explicitly
+            }
+            const { space } = resolveSpaceConfig(config, spaceKey);
+            if (!entryId && resolvedSlug) {
+                const slugNorm = normalizeSlug(resolvedSlug.replace(/^\//, ''));
+                const pageRows = listReferencesBySlug(space, 'page', slugNorm, true);
+                if (pageRows.length === 1) {
+                    entryId = pageRows[0]?.id;
+                }
+                else {
+                    const articleRows = listReferencesBySlug(space, 'article', slugNorm, true);
+                    if (articleRows.length === 1) {
+                        entryId = articleRows[0]?.id;
+                    }
+                    else {
+                        try {
+                            const env = await createSafeEnvironment(space);
+                            const locale = space.defaultLocale ?? 'en-US';
+                            const pageEntry = await findEntryByContentTypeAndSlug(env, 'page', slugNorm);
+                            entryId = pageEntry?.sys.id ?? entryId;
+                            if (!entryId) {
+                                const articleEntry = await findEntryByContentTypeAndSlug(env, 'article', slugNorm);
+                                entryId = articleEntry?.sys.id;
+                            }
+                            if (!entryId) {
+                                const anyEntry = await findEntryBySlug(env, slugNorm, locale);
+                                entryId = anyEntry?.sys.id;
+                            }
+                        }
+                        catch {
+                            // Index/CMA lookup failed — preview URLs may still include staging by slug
+                        }
+                    }
+                }
+            }
+            const results = await buildAllPreviewUrls({
+                spaceId: space.spaceId,
+                environment: space.environment,
+                entryId,
+                slug: resolvedSlug,
+                devBaseUrl: space.devBaseUrl,
+                productionSiteUrl: space.productionSiteUrl,
+                requestParams: space.requestParams,
+                focusedField: opts.focusedField,
+                managementToken: space.managementToken,
+            });
+            if (results.length === 0) {
+                errorMsg('No preview URLs available. Pass a slug and/or --entry-id, and configure devBaseUrl or productionSiteUrl.');
+                process.exit(1);
+                return;
+            }
+            if (isJsonMode()) {
+                console.log(JSON.stringify({
+                    slug: resolvedSlug ?? null,
+                    entryId: entryId ?? null,
+                    urls: results,
+                }, null, 2));
+                return;
+            }
+            console.log('');
+            for (const result of results) {
+                console.log(`${result.label} (${result.target})`);
+                console.log(result.url ?? '(unavailable)');
+                if (result.notes) {
+                    console.log(`  ${result.notes}`);
+                }
+                console.log('');
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    preview
+        .command('showcase')
+        .description('Generate a showcase preview URL for a component or collection type (mock data).\n' +
+        'Example: cms-edit preview showcase --component HeroSimple\n' +
+        'Example: cms-edit preview showcase --collection CardGrid --param backgroundColour=Navy')
+        .option('--component <type>', 'Component type name')
+        .option('--collection <type>', 'Collection type name')
+        .option('--embedded', 'Append embedded=true to suppress iframe height reporter')
+        .option('--clean', 'Use default showcase state only (no curated mock data)')
+        .option('--param <key=value>', 'Showcase override (repeatable). E.g. --param backgroundColour=Navy', collectParam, [])
+        .action(async (opts, cmd) => {
+        const parentOpts = cmd.parent?.parent?.opts() ?? {};
+        try {
+            if (!opts.component && !opts.collection) {
+                errorMsg('Pass --component <type> or --collection <type>.');
+                process.exit(1);
+                return;
+            }
+            if (opts.component && opts.collection) {
+                errorMsg('Pass only one of --component or --collection.');
+                process.exit(1);
+                return;
+            }
+            const config = loadConfig(parentOpts.config);
+            const { space } = resolveSpaceConfig(config, parentOpts.space);
+            if (!space.devBaseUrl) {
+                errorMsg(`No devBaseUrl configured for this space. ` +
+                    `Add "devBaseUrl": "http://localhost:<port>" to your .contentful-cms.json.`);
+                process.exit(1);
+                return;
+            }
+            const mode = opts.collection ? 'collection' : 'component';
+            const typeName = (opts.collection ?? opts.component);
+            const fields = parseParamOverrides(opts.param ?? []);
+            const url = buildShowcaseUrl(space.devBaseUrl, typeName, mode, fields, {
+                embedded: opts.embedded,
+                clean: opts.clean,
+                requestParams: space.requestParams,
+            });
+            if (isJsonMode()) {
+                console.log(JSON.stringify({
+                    url,
+                    baseUrl: space.devBaseUrl,
+                    type: typeName,
+                    mode,
+                    params: fields,
+                }, null, 2));
+                return;
+            }
+            console.log(`\n${url}\n`);
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=preview.js.map

package/dist/commands/preview.js.map

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

package/dist/commands/project.d.ts

@@ -0,0 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { Command } from 'commander';
+export declare function registerProjectCommand(program: Command): Command;
+//# sourceMappingURL=project.d.ts.map

package/dist/commands/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAoEhE"}

package/dist/commands/project.js

@@ -0,0 +1,63 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { isJsonMode } from '../output/mode.js';
+import { runProjectDoctor } from '../project/doctor.js';
+import { loadProjectConfig } from '../project/load.js';
+import { assertHostedDeployReady } from '../project/validate-hosted.js';
+export function registerProjectCommand(program) {
+    const projectCmd = program
+        .command('project')
+        .description('Validate per-site cms-edit project.json configuration');
+    projectCmd
+        .command('validate')
+        .description('Validate project.json is schema-correct, commit-safe (no embedded secrets), and ready for hosted deploy')
+        .requiredOption('--project-config <path>', 'Path to cms-edit/<site>/project.json')
+        .action((opts) => {
+        const project = loadProjectConfig(opts.projectConfig);
+        assertHostedDeployReady(project);
+        if (isJsonMode()) {
+            console.log(JSON.stringify({
+                ok: true,
+                projectKey: project.projectKey,
+                displayName: project.displayName,
+            }));
+            return;
+        }
+        console.log(`Valid project.json for "${project.displayName}" (${project.projectKey})`);
+    });
+    projectCmd
+        .command('doctor')
+        .description('Check editor-pack freshness, playbooks, and onboarding resources for LLM editors')
+        .requiredOption('--project-config <path>', 'Path to cms-edit/<site>/project.json')
+        .action((opts) => {
+        const project = loadProjectConfig(opts.projectConfig);
+        const findings = runProjectDoctor(opts.projectConfig, project);
+        const errors = findings.filter((f) => f.severity === 'error');
+        const warnings = findings.filter((f) => f.severity === 'warning');
+        if (isJsonMode()) {
+            console.log(JSON.stringify({
+                ok: errors.length === 0,
+                projectKey: project.projectKey,
+                findings,
+            }));
+            if (errors.length > 0)
+                process.exit(1);
+            return;
+        }
+        if (findings.length === 0) {
+            console.log(`No issues found for "${project.displayName}" (${project.projectKey})`);
+            return;
+        }
+        for (const finding of findings) {
+            const label = finding.severity.toUpperCase();
+            console.log(`${label} [${finding.code}]: ${finding.message}`);
+        }
+        if (errors.length > 0) {
+            process.exit(1);
+        }
+        if (warnings.length > 0) {
+            console.log(`\n${warnings.length} warning(s) — consider regenerating the editor pack.`);
+        }
+    });
+    return projectCmd;
+}
+//# sourceMappingURL=project.js.map

package/dist/commands/project.js.map

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

package/dist/commands/read.d.ts

@@ -0,0 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { Command } from 'commander';
+export declare function registerReadCommand(program: Command): void;
+//# sourceMappingURL=read.d.ts.map

package/dist/commands/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/commands/read.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8D1D"}

package/dist/commands/read.js

@@ -0,0 +1,59 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { createSafeEnvironment } from '../contentful/client.js';
+import { serializeEntry } from '../contentful/fetch.js';
+import { errorMsg } from '../output/print.js';
+import { resolveRef } from '../session/refs.js';
+import { requireSession } from '../session/store.js';
+import { renderEntryFields } from '../snapshot/fields.js';
+import { renderSnapshot } from '../snapshot/render.js';
+export function registerReadCommand(program) {
+    program
+        .command('read [ref] [field]')
+        .description('Read all fields of a ref entry, or a specific field. Omit ref to re-print snapshot.\n' +
+        'Use --id to read by Contentful entry ID without an open session.')
+        .option('--json', 'Output as JSON (entry object, or field value)')
+        .option('--id', 'Treat ref as a Contentful entry ID instead of a session @ref')
+        .action(async (ref, field, opts, cmd) => {
+        try {
+            const parentOpts = cmd.parent?.opts() ?? {};
+            if (opts.id) {
+                if (!ref) {
+                    errorMsg('Entry ID required when using --id. Example: cms-edit read <entry-id> --id');
+                    process.exit(1);
+                }
+                const config = loadConfig(parentOpts.config);
+                const { space } = resolveSpaceConfig(config, parentOpts.space);
+                const env = await createSafeEnvironment(space);
+                const locale = space.defaultLocale;
+                const rawEntry = await env.getEntry(ref);
+                const entry = serializeEntry(rawEntry);
+                renderEntryFields(entry, locale, {
+                    refLabel: ref,
+                    field,
+                    json: opts.json,
+                });
+                return;
+            }
+            const session = await requireSession(parentOpts.session, parentOpts.config);
+            if (!ref) {
+                renderSnapshot(session);
+                return;
+            }
+            const entry = resolveRef(session, ref);
+            const locale = session.defaultLocale;
+            const ref2 = session.refsByEntry[entry.sys.id] ?? ref;
+            renderEntryFields(entry, locale, {
+                refLabel: ref2,
+                field,
+                json: opts.json,
+                isModified: session.modifiedEntryIds.includes(entry.sys.id),
+            });
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=read.js.map

package/dist/commands/read.js.map

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

package/dist/commands/remove.d.ts

@@ -0,0 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { Command } from 'commander';
+export declare function registerRemoveCommand(program: Command): void;
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgH5D"}

package/dist/commands/remove.js

@@ -0,0 +1,104 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { createSafeEnvironment } from '../contentful/client.js';
+import { countInboundReferences } from '../contentful/references.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg, infoMsg, successMsg, warnMsg } from '../output/print.js';
+import { isReferencedInSessionRichText } from '../rtf/references.js';
+import { buildTree, findTreeNode, resolveRefToId } from '../session/refs.js';
+import { requireSession, saveSession } from '../session/store.js';
+import { renderSnapshot } from '../snapshot/render.js';
+export function registerRemoveCommand(program) {
+    program
+        .command('remove <ref>')
+        .description('Unlink a component or collection from the page.\n' +
+        'If the entry is unreferenced elsewhere and is a draft, it will be deleted on save.')
+        .action(async (ref, _opts, cmd) => {
+        const parentOpts = cmd.parent?.opts() ?? {};
+        try {
+            const session = await requireSession(parentOpts.session, parentOpts.config);
+            const locale = session.defaultLocale;
+            const entryId = resolveRefToId(session, ref);
+            const node = findTreeNode(session, ref);
+            if (!node) {
+                errorMsg(`Ref "${ref}" not found in the content tree.`);
+                process.exit(1);
+                return;
+            }
+            if (!node.parentId || !node.parentField) {
+                errorMsg(`Cannot remove the root entry.`);
+                process.exit(1);
+                return;
+            }
+            const parentEntry = session.entries[node.parentId];
+            if (!parentEntry) {
+                errorMsg(`Parent entry not found.`);
+                process.exit(1);
+                return;
+            }
+            // Remove the link from the parent's content array
+            const fieldData = parentEntry.fields[node.parentField];
+            if (fieldData) {
+                const arr = fieldData[locale];
+                if (Array.isArray(arr)) {
+                    const idx = arr.findIndex((item) => typeof item === 'object' &&
+                        item !== null &&
+                        'sys' in item &&
+                        item.sys.id === entryId);
+                    if (idx >= 0)
+                        arr.splice(idx, 1);
+                }
+            }
+            if (!session.modifiedEntryIds.includes(node.parentId)) {
+                session.modifiedEntryIds.push(node.parentId);
+            }
+            // Check if the entry should be deleted (draft-only + no other references)
+            const targetEntry = session.entries[entryId];
+            const isPublished = !!targetEntry?.sys.publishedVersion;
+            if (!isPublished) {
+                if (isReferencedInSessionRichText(session, entryId)) {
+                    warnMsg(`Entry ${ref} is still embedded in rich text — skipping deletion. Remove the embedded block from the rich text field first.`);
+                }
+                else {
+                    try {
+                        const config = loadConfig(parentOpts.config);
+                        const { space } = resolveSpaceConfig(config, session.spaceKey);
+                        const env = await createSafeEnvironment(space);
+                        const refCount = await countInboundReferences(env, entryId);
+                        if (refCount <= 1) {
+                            if (!session.pendingDeletions.includes(entryId)) {
+                                session.pendingDeletions.push(entryId);
+                            }
+                            infoMsg(`Entry ${ref} is unreferenced and draft-only — will be deleted on save.`);
+                        }
+                        else {
+                            warnMsg(`Entry ${ref} is referenced by ${refCount - 1} other entr${refCount - 1 === 1 ? 'y' : 'ies'} — unlinking only.`);
+                        }
+                    }
+                    catch {
+                        warnMsg(`Could not check references for ${ref} — unlinking only.`);
+                    }
+                }
+            }
+            else {
+                warnMsg(`Entry ${ref} is published — unlinking only. Delete it manually in Contentful if needed.`);
+            }
+            // Rebuild tree without the removed entry
+            delete session.entries[entryId];
+            const { refs, refsByEntry, treeNodes } = buildTree(session.rootEntryId, session.entries, locale);
+            session.refs = refs;
+            session.refsByEntry = refsByEntry;
+            session.treeNodes = treeNodes;
+            await saveSession(session);
+            successMsg(`Removed ${ref} from the page.`);
+            if (!isJsonMode()) {
+                renderSnapshot(session);
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

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

package/dist/commands/resolve.d.ts

@@ -0,0 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import type { Command } from 'commander';
+export declare function registerResolveCommand(program: Command): void;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/commands/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/commands/resolve.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuE7D"}