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

package/dist/cli/program.js

@@ -0,0 +1,152 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { Command } from 'commander';
+import { registerAddCommand } from '../commands/add.js';
+import { registerArticleTagsFromJsonCommand } from '../commands/article-tags-from-json.js';
+import { registerAssetCommand } from '../commands/asset.js';
+import { registerBatchCommand } from '../commands/batch.js';
+import { registerBulkRtfReplaceCommand } from '../commands/bulk-rtf-replace.js';
+import { registerCreateCommand } from '../commands/create.js';
+import { registerCreateFromJsonCommand } from '../commands/create-from-json.js';
+import { registerPersonCreateCommands } from '../commands/create-person.js';
+import { registerPersonFromJsonCommand } from '../commands/create-person-from-json.js';
+import { registerTaxonomyCreateCommands } from '../commands/create-taxonomy.js';
+import { registerTaxonomyFromJsonCommand } from '../commands/create-taxonomy-from-json.js';
+import { registerCustomerCommand } from '../commands/customer.js';
+import { registerDiagnoseCommand } from '../commands/diagnose.js';
+import { registerDiffCommand } from '../commands/diff.js';
+import { registerDiscardCommand } from '../commands/discard.js';
+import { registerEditorPackCommand } from '../commands/editor-pack.js';
+import { registerEntrySearchCommand } from '../commands/entry-search.js';
+import { registerGuideCommand } from '../commands/guide.js';
+import { registerHealthCommand } from '../commands/health.js';
+import { registerHelpCommand } from '../commands/help.js';
+import { registerHostCommand } from '../commands/host.js';
+import { registerIndexCommand } from '../commands/index.js';
+import { registerLinksCommand } from '../commands/links.js';
+import { registerListCommand } from '../commands/list.js';
+import { registerMediaCommand } from '../commands/media.js';
+import { registerMoveCommand } from '../commands/move.js';
+import { registerNavCommand } from '../commands/nav.js';
+import { registerOpenCommand } from '../commands/open.js';
+import { registerPeekCommand } from '../commands/peek.js';
+import { registerPreviewCommand } from '../commands/preview.js';
+import { registerProjectCommand } from '../commands/project.js';
+import { registerReadCommand } from '../commands/read.js';
+import { registerRemoveCommand } from '../commands/remove.js';
+import { registerResolveCommand } from '../commands/resolve.js';
+import { registerRtfCommand } from '../commands/rtf.js';
+import { registerSaveCommand } from '../commands/save.js';
+import { registerSchemaCommand } from '../commands/schema.js';
+import { registerSetCommand } from '../commands/set.js';
+import { registerSnapshotCommand } from '../commands/snapshot.js';
+import { registerStagedUploadCommand } from '../commands/staged-upload.js';
+import { registerVersionCommand } from '../commands/version.js';
+import { setJsonMode } from '../output/mode.js';
+import { beginTelemetryCommand, recordTelemetryOutcome } from '../telemetry/index.js';
+import { CMS_EDIT_VERSION } from '../version.js';
+const LLM_INTRO = 'Opinionated CLI for editing Contentful draft content (pages, articles, templates, navigation). No publish — all saves create drafts.\n' +
+    'Workflow: open → snapshot → read/set/rtf/add/remove/move → diff → save. Use @refs from snapshot (e.g. @c0); re-snapshot after add/remove/move.\n' +
+    'Detailed help: cms-edit help <topic>  Topics: workflow, create-from-json, taxonomy-from-json, person-from-json, article-tags-from-json, bulk-rtf-replace, batch, batch-run, fields, fields-page, fields-article, fields-component, fields-collection, fields-taxonomy, index-sync, asset-review, lookup\n' +
+    'Getting started (hosted/MCP): cms-edit guide [overview|workflow|commands|troubleshooting|hosted]\n' +
+    'Single-shot page/article creation: cms-edit help create-from-json\n' +
+    'Taxonomy bootstrap: cms-edit help taxonomy-from-json\n' +
+    'Author import: cms-edit help person-from-json\n' +
+    'Full README: cms-edit --docs. Agent skills: npx skills add @se-studio/skills\n' +
+    'Schema introspection: cms-edit schema <content-type> | cms-edit schema colours | cms-edit schema types <content-type>\n' +
+    'Visual checks: cms-edit preview url <slug> or cms-edit preview showcase --component <type> (use browser MCP to open the URL).';
+export function createCmsEditProgram(hooks = {}) {
+    const program = new Command('cms-edit');
+    program
+        .name('cms-edit')
+        .version(CMS_EDIT_VERSION)
+        .description(LLM_INTRO)
+        .option('--space <name>', 'Contentful space to use (overrides defaultSpace in config)')
+        .option('--config <path>', 'Path to .contentful-cms.json config file')
+        .option('--session <name>', 'Named session for concurrent isolation (also CONTENTFUL_CMS_SESSION env var). ' +
+        'Use the same name in all commands for a given workflow.')
+        .option('--json-output', 'Output all results as machine-readable JSON (also enabled by CMS_EDIT_JSON=1 env var)')
+        .option('--docs', 'Print absolute path to package README and exit (for LLM tooling)');
+    program.hook('preAction', (_thisCmd, actionCmd) => {
+        const opts = program.opts();
+        if (opts.jsonOutput ||
+            process.env['CMS_EDIT_JSON'] === '1' ||
+            process.env['CMS_EDIT_JSON'] === 'true') {
+            setJsonMode(true);
+        }
+        if (opts.session) {
+            process.env['CONTENTFUL_CMS_SESSION'] = opts.session;
+        }
+        else {
+            delete process.env['CONTENTFUL_CMS_SESSION'];
+        }
+        const telemetryCommand = actionCmd.parent?.name() !== 'cms-edit' ? actionCmd.parent?.name() : actionCmd.name();
+        const telemetrySubcommand = actionCmd.parent?.name() !== 'cms-edit' ? actionCmd.name() : undefined;
+        beginTelemetryCommand(telemetryCommand ?? 'unknown', telemetrySubcommand);
+        hooks.onPreAction?.(telemetryCommand ?? 'unknown', telemetrySubcommand);
+    });
+    program.hook('postAction', () => {
+        recordTelemetryOutcome('success');
+        hooks.onPostAction?.();
+    });
+    registerOpenCommand(program);
+    registerPeekCommand(program);
+    registerSnapshotCommand(program);
+    registerReadCommand(program);
+    registerSetCommand(program);
+    registerRtfCommand(program);
+    registerDiffCommand(program);
+    registerSaveCommand(program);
+    registerDiscardCommand(program);
+    registerLinksCommand(program);
+    registerBatchCommand(program);
+    registerAddCommand(program);
+    registerRemoveCommand(program);
+    registerMoveCommand(program);
+    const createCmd = registerCreateCommand(program);
+    registerTaxonomyCreateCommands(createCmd, program);
+    registerPersonCreateCommands(createCmd, program);
+    registerCreateFromJsonCommand(createCmd);
+    registerTaxonomyFromJsonCommand(createCmd, program);
+    registerPersonFromJsonCommand(createCmd, program);
+    registerArticleTagsFromJsonCommand(program);
+    registerBulkRtfReplaceCommand(program);
+    registerNavCommand(program);
+    registerAssetCommand(program);
+    registerEntrySearchCommand(program);
+    registerHealthCommand(program);
+    registerDiagnoseCommand(program);
+    registerStagedUploadCommand(program);
+    registerMediaCommand(program);
+    registerVersionCommand(program);
+    registerGuideCommand(program);
+    registerCustomerCommand(program);
+    registerSchemaCommand(program);
+    registerListCommand(program);
+    registerIndexCommand(program);
+    registerResolveCommand(program);
+    registerPreviewCommand(program);
+    registerProjectCommand(program);
+    registerEditorPackCommand(program);
+    registerHostCommand(program);
+    registerHelpCommand(program);
+    program.parseAsync = wrapParseAsync(program.parseAsync.bind(program), (err) => {
+        recordTelemetryOutcome('error', {
+            exitCode: 1,
+            errorName: err instanceof Error ? err.constructor.name : 'UnknownError',
+        });
+        hooks.onError?.(err);
+    });
+    return program;
+}
+function wrapParseAsync(original, onError) {
+    return async (...args) => {
+        try {
+            return await original(...args);
+        }
+        catch (err) {
+            onError(err);
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=program.js.map

package/dist/cli/program.js.map

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

package/dist/cli/read-json-input.d.ts

@@ -0,0 +1,27 @@
+export interface JsonInputOptions {
+    json?: string;
+    jsonBase64?: string;
+    /** Command name for error messages (e.g. "create from-json"). */
+    label?: string;
+}
+export interface TextInputOptions {
+    content?: string;
+    base64?: string;
+    /** Flag names for error messages. */
+    contentFlag?: string;
+    base64Flag?: string;
+    label?: string;
+}
+/**
+ * Returns raw JSON text from --json or --json-base64 (exactly one required).
+ */
+export declare function readJsonString(opts: JsonInputOptions): string;
+/**
+ * Parses JSON from --json or --json-base64 (exactly one required).
+ */
+export declare function readJsonInput(opts: JsonInputOptions): unknown;
+/**
+ * Returns plain text from --content or --base64 (exactly one required).
+ */
+export declare function readTextInput(opts: TextInputOptions): string;
+//# sourceMappingURL=read-json-input.d.ts.map

package/dist/cli/read-json-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-json-input.d.ts","sourceRoot":"","sources":["../../src/cli/read-json-input.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAqB7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAS7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAuB5D"}

package/dist/cli/read-json-input.js

@@ -0,0 +1,65 @@
+function inputLabel(opts) {
+    return opts.label ?? 'command';
+}
+/**
+ * Returns raw JSON text from --json or --json-base64 (exactly one required).
+ */
+export function readJsonString(opts) {
+    const label = inputLabel(opts);
+    const hasJson = opts.json !== undefined && opts.json !== '';
+    const hasBase64 = opts.jsonBase64 !== undefined && opts.jsonBase64 !== '';
+    if (hasJson && hasBase64) {
+        throw new Error(`Cannot use both --json and --json-base64 for ${label}.`);
+    }
+    if (!hasJson && !hasBase64) {
+        throw new Error(`Provide --json or --json-base64 for ${label}.`);
+    }
+    if (hasBase64) {
+        try {
+            return Buffer.from(opts.jsonBase64, 'base64').toString('utf8');
+        }
+        catch {
+            throw new Error(`Invalid --json-base64 for ${label}: could not decode base64.`);
+        }
+    }
+    return opts.json;
+}
+/**
+ * Parses JSON from --json or --json-base64 (exactly one required).
+ */
+export function readJsonInput(opts) {
+    const source = opts.jsonBase64 !== undefined && opts.jsonBase64 !== '' ? '--json-base64' : '--json';
+    const str = readJsonString(opts);
+    try {
+        return JSON.parse(str);
+    }
+    catch {
+        throw new Error(`Invalid JSON in ${source} for ${inputLabel(opts)}.`);
+    }
+}
+/**
+ * Returns plain text from --content or --base64 (exactly one required).
+ */
+export function readTextInput(opts) {
+    const label = inputLabel(opts);
+    const contentFlag = opts.contentFlag ?? '--content';
+    const base64Flag = opts.base64Flag ?? '--base64';
+    const hasContent = opts.content !== undefined && opts.content !== '';
+    const hasBase64 = opts.base64 !== undefined && opts.base64 !== '';
+    if (hasContent && hasBase64) {
+        throw new Error(`Cannot use both ${contentFlag} and ${base64Flag} for ${label}.`);
+    }
+    if (!hasContent && !hasBase64) {
+        throw new Error(`Provide ${contentFlag} or ${base64Flag} for ${label}.`);
+    }
+    if (hasBase64) {
+        try {
+            return Buffer.from(opts.base64, 'base64').toString('utf8');
+        }
+        catch {
+            throw new Error(`Invalid ${base64Flag} for ${label}: could not decode base64.`);
+        }
+    }
+    return opts.content;
+}
+//# sourceMappingURL=read-json-input.js.map

package/dist/cli/read-json-input.js.map

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

package/dist/cli/runner.d.ts

@@ -0,0 +1,15 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+export declare class CmsEditProcessExit extends Error {
+    readonly exitCode: number;
+    constructor(exitCode: number);
+}
+export interface RunCmsEditArgsResult {
+    exitCode: number;
+    output: string;
+}
+/**
+ * Runs cms-edit commands in-process, capturing stdout/stderr instead of spawning a child.
+ * Used by the hosted MCP server on Vercel.
+ */
+export declare function runCmsEditArgs(args: string[]): Promise<RunCmsEditArgsResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/cli/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAUvF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;CAK7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AA2BD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAclF"}

package/dist/cli/runner.js

@@ -0,0 +1,113 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { sessionLogVerbose } from '../session/log.js';
+import { flushTelemetry, recordTelemetryOutcome, runWithContentfulRequestStats, } from '../telemetry/index.js';
+import { createCmsEditProgram } from './program.js';
+export class CmsEditProcessExit extends Error {
+    exitCode;
+    constructor(exitCode) {
+        super(`cms-edit exited with code ${String(exitCode)}`);
+        this.name = 'CmsEditProcessExit';
+        this.exitCode = exitCode;
+    }
+}
+function formatConsoleArgs(args) {
+    return args
+        .map((arg) => {
+        if (typeof arg === 'string')
+            return arg;
+        try {
+            return JSON.stringify(arg);
+        }
+        catch {
+            return String(arg);
+        }
+    })
+        .join(' ');
+}
+let programInstance;
+function getProgram() {
+    if (!programInstance) {
+        programInstance = createCmsEditProgram();
+    }
+    return programInstance;
+}
+/** Serializes in-process CLI runs — global console/process.exit patching is not concurrency-safe. */
+let runLock = Promise.resolve();
+/**
+ * Runs cms-edit commands in-process, capturing stdout/stderr instead of spawning a child.
+ * Used by the hosted MCP server on Vercel.
+ */
+export async function runCmsEditArgs(args) {
+    let release;
+    const wait = new Promise((resolve) => {
+        release = resolve;
+    });
+    const previous = runLock;
+    runLock = previous.then(() => wait);
+    await previous;
+    try {
+        return await runWithContentfulRequestStats(() => runCmsEditArgsInner(args));
+    }
+    finally {
+        release();
+    }
+}
+async function runCmsEditArgsInner(args) {
+    delete process.env['CONTENTFUL_CMS_SESSION'];
+    sessionLogVerbose('runCmsEditArgs start', { args });
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    const originalLog = console.log;
+    const originalError = console.error;
+    const originalStderrWrite = process.stderr.write.bind(process.stderr);
+    const originalExit = process.exit;
+    console.log = (...logArgs) => {
+        stdoutChunks.push(formatConsoleArgs(logArgs));
+    };
+    console.error = (...logArgs) => {
+        stderrChunks.push(formatConsoleArgs(logArgs));
+    };
+    process.stderr.write = ((chunk) => {
+        if (typeof chunk === 'string') {
+            stderrChunks.push(chunk.replace(/\n$/, ''));
+        }
+        else if (chunk instanceof Uint8Array) {
+            stderrChunks.push(Buffer.from(chunk).toString('utf8').replace(/\n$/, ''));
+        }
+        return true;
+    });
+    process.exit = ((code) => {
+        const numCode = typeof code === 'string' ? Number.parseInt(code, 10) : (code ?? 0);
+        throw new CmsEditProcessExit(Number.isNaN(numCode) ? 1 : numCode);
+    });
+    try {
+        const program = getProgram();
+        await program.parseAsync(args, { from: 'user' });
+        sessionLogVerbose('runCmsEditArgs done', {
+            envSession: process.env['CONTENTFUL_CMS_SESSION'] ?? null,
+        });
+        const output = [...stdoutChunks, ...stderrChunks].filter(Boolean).join('\n').trim();
+        return { exitCode: 0, output };
+    }
+    catch (err) {
+        if (err instanceof CmsEditProcessExit) {
+            recordTelemetryOutcome('exit', { exitCode: err.exitCode });
+            const output = [...stdoutChunks, ...stderrChunks].filter(Boolean).join('\n').trim();
+            return { exitCode: err.exitCode, output };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        stderrChunks.push(message);
+        return {
+            exitCode: 1,
+            output: [...stdoutChunks, ...stderrChunks].filter(Boolean).join('\n').trim(),
+        };
+    }
+    finally {
+        await flushTelemetry();
+        console.log = originalLog;
+        console.error = originalError;
+        process.stderr.write = originalStderrWrite;
+        process.exit = originalExit;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/cli/runner.js.map

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

package/dist/commands/add-initial-fields.d.ts

@@ -0,0 +1,27 @@
+import type { ContentTypeProps } from 'contentful-management';
+/**
+ * Pick a label field that exists on the content type.
+ * Components use cmsLabel; media/person/externalVideo use name.
+ */
+export declare function pickInitialLabelFieldId(fieldIds: Iterable<string>): string | null;
+export interface BuildAddCreateFieldsOptions {
+    contentTypeId: string;
+    /** Positional `<type>` from `add <type>` — enum for typed CTs, else used as initial label. */
+    typeArg: string;
+    locale: string;
+    /** Optional override for the initial label value (default `New ${typeArg}`). */
+    label?: string;
+    /** When creating media, link this asset if the CT has an `asset` field. */
+    assetId?: string;
+}
+/**
+ * Build CMA create fields for `cms-edit add`, only including fields present on the CT.
+ * Never sends cmsLabel when the type has no such field (media/person 422).
+ */
+export declare function buildAddCreateFields(ctDef: ContentTypeProps, opts: BuildAddCreateFieldsOptions): {
+    fields: Record<string, Record<string, unknown>>;
+    labelFieldId: string | null;
+    hasTypeField: boolean;
+    typeFieldId: string;
+};
+//# sourceMappingURL=add-initial-fields.d.ts.map

package/dist/commands/add-initial-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-initial-fields.d.ts","sourceRoot":"","sources":["../../src/commands/add-initial-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAQjF;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,2BAA2B,GAChC;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAyBA"}

package/dist/commands/add-initial-fields.js

@@ -0,0 +1,42 @@
+/** Display/label fields agents commonly set on first create — first match wins. */
+const LABEL_FIELD_CANDIDATES = ['cmsLabel', 'name', 'adminLabel', 'title'];
+/**
+ * Pick a label field that exists on the content type.
+ * Components use cmsLabel; media/person/externalVideo use name.
+ */
+export function pickInitialLabelFieldId(fieldIds) {
+    const set = fieldIds instanceof Set ? fieldIds : new Set(fieldIds);
+    for (const id of LABEL_FIELD_CANDIDATES) {
+        if (set.has(id)) {
+            return id;
+        }
+    }
+    return null;
+}
+/**
+ * Build CMA create fields for `cms-edit add`, only including fields present on the CT.
+ * Never sends cmsLabel when the type has no such field (media/person 422).
+ */
+export function buildAddCreateFields(ctDef, opts) {
+    const fieldIds = new Set(ctDef.fields.map((f) => f.id));
+    const typeFieldId = `${opts.contentTypeId}Type`;
+    const hasTypeField = fieldIds.has(typeFieldId);
+    const fields = {};
+    const labelFieldId = pickInitialLabelFieldId(fieldIds);
+    const labelValue = (opts.label?.trim() || `New ${opts.typeArg}`).trim();
+    if (labelFieldId) {
+        fields[labelFieldId] = { [opts.locale]: labelValue };
+    }
+    if (hasTypeField) {
+        fields[typeFieldId] = { [opts.locale]: opts.typeArg };
+    }
+    if (opts.assetId?.trim() && fieldIds.has('asset')) {
+        fields.asset = {
+            [opts.locale]: {
+                sys: { type: 'Link', linkType: 'Asset', id: opts.assetId.trim() },
+            },
+        };
+    }
+    return { fields, labelFieldId, hasTypeField, typeFieldId };
+}
+//# sourceMappingURL=add-initial-fields.js.map

package/dist/commands/add-initial-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-initial-fields.js","sourceRoot":"","sources":["../../src/commands/add-initial-fields.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAU,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA0B;IAChE,MAAM,GAAG,GAAG,QAAQ,YAAY,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnE,KAAK,MAAM,EAAE,IAAI,sBAAsB,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAuB,EACvB,IAAiC;IAOjC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,aAAa,MAAM,CAAC;IAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,MAAM,GAA4C,EAAE,CAAC;IAE3D,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,KAAK,GAAG;YACb,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;gBACb,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE;aAClE;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAC7D,CAAC"}

package/dist/commands/add-target-field.d.ts

@@ -0,0 +1,15 @@
+import type { ContentTypeProps } from 'contentful-management';
+export type AddTargetFieldOk = {
+    ok: true;
+};
+export type AddTargetFieldErr = {
+    ok: false;
+    message: string;
+};
+export type AddTargetFieldResult = AddTargetFieldOk | AddTargetFieldErr;
+/**
+ * `add` may only append into Entry-link **array** fields (content, contents, topContent, …).
+ * Singular links (e.g. component.visual) must use `set <ref> <field> <id> --link`.
+ */
+export declare function assertAddTargetIsEntryLinkArray(parentCt: ContentTypeProps, targetField: string): AddTargetFieldResult;
+//# sourceMappingURL=add-target-field.d.ts.map

package/dist/commands/add-target-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-target-field.d.ts","sourceRoot":"","sources":["../../src/commands/add-target-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAExE;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,EAAE,MAAM,GAClB,oBAAoB,CA8BtB"}

package/dist/commands/add-target-field.js

@@ -0,0 +1,48 @@
+/**
+ * `add` may only append into Entry-link **array** fields (content, contents, topContent, …).
+ * Singular links (e.g. component.visual) must use `set <ref> <field> <id> --link`.
+ */
+export function assertAddTargetIsEntryLinkArray(parentCt, targetField) {
+    const field = parentCt.fields.find((f) => f.id === targetField);
+    if (!field) {
+        return {
+            ok: false,
+            message: `Field "${targetField}" does not exist on content type "${parentCt.sys.id}".\n` +
+                `add only supports Entry-link array fields (e.g. content, topContent, bottomContent, contents).\n` +
+                `For a singular Entry field (e.g. visual), create/import the entry then:\n` +
+                `  set <parentRef> ${targetField} <entryId> --link`,
+        };
+    }
+    if (!isEntryLinkArrayField(field)) {
+        const singularHint = field.type === 'Link'
+            ? `For a singular Entry field, use:\n  set <parentRef> ${targetField} <entryId> --link`
+            : `add only supports Entry-link array fields (e.g. content, topContent, bottomContent, contents).\n` +
+                `For a singular Entry field (e.g. visual), create/import the entry then:\n` +
+                `  set <parentRef> ${targetField} <entryId> --link`;
+        return {
+            ok: false,
+            message: `--target "${targetField}" is not an Entry-link array on content type "${parentCt.sys.id}" ` +
+                `(type=${field.type}${field.type === 'Array' ? `, items=${describeItems(field)}` : ''}).\n` +
+                singularHint,
+        };
+    }
+    return { ok: true };
+}
+function isEntryLinkArrayField(field) {
+    if (field.type !== 'Array')
+        return false;
+    const items = field.items;
+    if (!items || items.type !== 'Link')
+        return false;
+    // linkType Entry (default for our content arrays); reject Asset arrays
+    if (items.linkType && items.linkType !== 'Entry')
+        return false;
+    return true;
+}
+function describeItems(field) {
+    const items = field.items;
+    if (!items)
+        return 'none';
+    return items.linkType ? `${items.type}:${items.linkType}` : String(items.type ?? 'unknown');
+}
+//# sourceMappingURL=add-target-field.js.map

package/dist/commands/add-target-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-target-field.js","sourceRoot":"","sources":["../../src/commands/add-target-field.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA0B,EAC1B,WAAmB;IAEnB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,UAAU,WAAW,qCAAqC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM;gBAC/E,kGAAkG;gBAClG,2EAA2E;gBAC3E,qBAAqB,WAAW,mBAAmB;SACtD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,YAAY,GAChB,KAAK,CAAC,IAAI,KAAK,MAAM;YACnB,CAAC,CAAC,uDAAuD,WAAW,mBAAmB;YACvF,CAAC,CAAC,kGAAkG;gBAClG,2EAA2E;gBAC3E,qBAAqB,WAAW,mBAAmB,CAAC;QAC1D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,aAAa,WAAW,iDAAiD,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI;gBAC5F,SAAS,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM;gBAC3F,YAAY;SACf,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAoB;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAyD,CAAC;IAC9E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAClD,uEAAuE;IACvE,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,KAAoB;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAyD,CAAC;IAC9E,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;AAC9F,CAAC"}

package/dist/commands/add.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 registerAddCommand(program: Command): void;
+//# sourceMappingURL=add.d.ts.map

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

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