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

package/dist/commands/add.js

@@ -0,0 +1,291 @@
+/** 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 { isJsonMode } from '../output/mode.js';
+import { errorMsg, successMsg, warnMsg } from '../output/print.js';
+import { buildTree, findTreeNode, makeEntryLink, resolveRef } from '../session/refs.js';
+import { requireSession, saveSession } from '../session/store.js';
+import { renderSnapshot } from '../snapshot/render.js';
+import { ALLOWED_CONTENT_TYPES_FOR_PAGE_ARTICLE, isAllowedContentTypeForAdd, } from '../validation/allowed-types.js';
+import { buildAddCreateFields } from './add-initial-fields.js';
+import { assertAddTargetIsEntryLinkArray } from './add-target-field.js';
+function getValidTypeValues(ctDef, typeFieldId) {
+    const field = ctDef.fields.find((f) => f.id === typeFieldId);
+    if (!field)
+        return [];
+    const values = [];
+    for (const v of field.validations ?? []) {
+        const inValues = v.in;
+        if (Array.isArray(inValues))
+            values.push(...inValues);
+    }
+    return values;
+}
+export function registerAddCommand(program) {
+    program
+        .command('add <type>')
+        .description('Create a new entry and link it into an Entry-link **array** on the page/article/collection.\n' +
+        '--content-type is required: pass the Contentful content type ID (e.g. component, collection, media, person).\n' +
+        'For typed content types (component, collection, externalComponent, …) the <type> argument is stored in the\n' +
+        '  {contentTypeId}Type field (e.g. componentType). For types without that field (media, person),\n' +
+        '  <type> seeds the initial label field that exists on the CT (cmsLabel, else name, else adminLabel/title).\n' +
+        'Media: prefer `create media --asset-id` then set … --link, or `add … --content-type media --asset-id` into content arrays.\n' +
+        'Use --after <ref> to insert after a specific entry, or --parent <ref> to add inside a collection.\n' +
+        'Use --target <field> only for array fields (topContent, content, bottomContent, contents, …).\n' +
+        'Never use --target for singular fields (e.g. visual, featuredImage) — use: set <ref> <field> <entryId> --link')
+        .option('--after <ref>', 'Insert the new entry after this ref')
+        .option('--parent <ref>', 'Add inside this collection (uses its contents field)')
+        .option('--target <field>', 'Target Entry-link array field only (e.g. topContent, content, bottomContent). Not for singular visual/featuredImage')
+        .option('--existing-id <entryId>', 'Link an existing entry by ID instead of creating a new one (skips entry creation)')
+        .option('--label <text>', 'Initial cmsLabel/name/adminLabel/title value (default: "New <type>")')
+        .option('--asset-id <assetId>', 'When --content-type media: link this asset on create (recommended for media)')
+        .requiredOption('--content-type <ct>', 'Contentful content type ID (e.g. component, collection, externalComponent, media, person)')
+        .action(async (type, opts, cmd) => {
+        const parentOpts = cmd.parent?.opts() ?? {};
+        try {
+            const session = await requireSession(parentOpts.session, parentOpts.config);
+            const locale = session.defaultLocale;
+            const config = loadConfig(parentOpts.config);
+            const { space } = resolveSpaceConfig(config, session.spaceKey);
+            const env = await createSafeEnvironment(space);
+            const ctId = opts.contentType;
+            if (!isAllowedContentTypeForAdd(ctId)) {
+                errorMsg(`Content type '${ctId}' is not supported for add in this project. Allowed: ${ALLOWED_CONTENT_TYPES_FOR_PAGE_ARTICLE.join(', ')}.`);
+                process.exit(1);
+            }
+            // Resolve parent + target field FIRST (before createEntry) so bad --target never orphans entries.
+            let parentEntryId;
+            let targetField;
+            if (opts.parent) {
+                resolveRef(session, opts.parent);
+                const parentNode = findTreeNode(session, opts.parent);
+                if (!parentNode) {
+                    errorMsg(`Ref "${opts.parent}" not found in the content tree.`);
+                    process.exit(1);
+                }
+                parentEntryId = parentNode.entryId;
+                const parentEntryEarly = session.entries[parentEntryId];
+                if (!parentEntryEarly) {
+                    errorMsg(`Parent entry not found in session.`);
+                    process.exit(1);
+                }
+                const parentCtId = parentEntryEarly.sys.contentType.sys.id;
+                if (parentCtId === 'collection') {
+                    targetField = opts.target ?? 'contents';
+                }
+                else if (parentCtId === 'page' ||
+                    parentCtId === 'article' ||
+                    parentCtId === 'articleType' ||
+                    parentCtId === 'tag') {
+                    const contentRootAllowed = ['topContent', 'content', 'bottomContent'];
+                    if (opts.target && !contentRootAllowed.includes(opts.target)) {
+                        errorMsg(`--target must be one of: ${contentRootAllowed.join(', ')}. Got: ${opts.target}`);
+                        process.exit(1);
+                    }
+                    targetField = opts.target ?? 'content';
+                }
+                else if (parentCtId === 'template') {
+                    const templateAllowed = ['preContent', 'postContent'];
+                    if (!opts.target || !templateAllowed.includes(opts.target)) {
+                        errorMsg('For template parent, --target preContent or postContent is required.');
+                        process.exit(1);
+                    }
+                    targetField = opts.target;
+                }
+                else {
+                    // Non-container parents (component, media, …): require explicit --target and schema check.
+                    if (!opts.target) {
+                        errorMsg(`Parent content type "${parentCtId}" is not a page/article/collection/template. ` +
+                            `add cannot invent a target field. For singular links (e.g. visual) use:\n` +
+                            `  set ${opts.parent} visual <entryId> --link\n` +
+                            `Or pass --parent pointing at a collection/page and --target content|contents.`);
+                        process.exit(1);
+                    }
+                    targetField = opts.target;
+                }
+            }
+            else if (opts.after) {
+                resolveRef(session, opts.after);
+                const afterNode = findTreeNode(session, opts.after);
+                if (!afterNode?.parentId) {
+                    errorMsg(`Cannot find parent for "${opts.after}". Use --parent to specify.`);
+                    process.exit(1);
+                }
+                parentEntryId = afterNode.parentId;
+                targetField = afterNode.parentField ?? 'content';
+            }
+            else {
+                parentEntryId = session.rootEntryId;
+                if (opts.target) {
+                    if (session.rootEntryType === 'template') {
+                        const templateAllowed = ['preContent', 'postContent'];
+                        if (!templateAllowed.includes(opts.target)) {
+                            errorMsg('For template use preContent or postContent.');
+                            process.exit(1);
+                        }
+                        targetField = opts.target;
+                    }
+                    else if (session.rootEntryType === 'page' ||
+                        session.rootEntryType === 'article' ||
+                        session.rootEntryType === 'articleType' ||
+                        session.rootEntryType === 'tag') {
+                        const contentRootAllowed = ['topContent', 'content', 'bottomContent'];
+                        if (!contentRootAllowed.includes(opts.target)) {
+                            errorMsg(`--target must be one of: ${contentRootAllowed.join(', ')}. Got: ${opts.target}`);
+                            process.exit(1);
+                        }
+                        targetField = opts.target;
+                    }
+                    else {
+                        errorMsg(`--target is only supported when the session root is a page, article, articleType, or tag. Current root is ${session.rootEntryType}.`);
+                        process.exit(1);
+                    }
+                }
+                else {
+                    if (session.rootEntryType === 'template') {
+                        errorMsg('For template, --target is required. Use preContent or postContent.');
+                        process.exit(1);
+                    }
+                    targetField = 'content';
+                }
+            }
+            const parentEntry = session.entries[parentEntryId];
+            if (!parentEntry) {
+                errorMsg(`Parent entry not found in session.`);
+                process.exit(1);
+                return;
+            }
+            const parentCtId = parentEntry.sys.contentType.sys.id;
+            const parentCtDef = await env.getContentType(parentCtId);
+            const targetCheck = assertAddTargetIsEntryLinkArray(parentCtDef, targetField);
+            if (!targetCheck.ok) {
+                errorMsg(targetCheck.message);
+                process.exit(1);
+            }
+            let newEntryId;
+            let hasTypeField = false;
+            if (opts.existingId) {
+                // Link an existing entry — no creation, fetch if not already in session
+                newEntryId = opts.existingId.trim();
+                if (!session.entries[newEntryId]) {
+                    const existing = await env.getEntry(newEntryId);
+                    session.entries[newEntryId] = serializeEntry(existing);
+                    session.originalEntries[newEntryId] = serializeEntry(existing);
+                }
+            }
+            else {
+                // Fetch CT definition so we only send fields that exist (media/person have name, not cmsLabel).
+                const typeFieldId = `${ctId}Type`;
+                const ctDefinition = await env.getContentType(ctId);
+                hasTypeField = ctDefinition.fields.some((f) => f.id === typeFieldId);
+                // Validate that <type> is a recognised value for the discriminator field.
+                if (hasTypeField) {
+                    const allowedValues = getValidTypeValues(ctDefinition, typeFieldId);
+                    if (allowedValues.length > 0 && !allowedValues.includes(type)) {
+                        // Check sibling typed content types to suggest the correct --content-type.
+                        const siblings = ['component', 'collection', 'externalComponent'].filter((s) => s !== ctId);
+                        const siblingDefs = await Promise.all(siblings.map(async (s) => {
+                            try {
+                                return { id: s, def: await env.getContentType(s) };
+                            }
+                            catch {
+                                return null;
+                            }
+                        }));
+                        const match = siblingDefs.find((s) => {
+                            if (!s)
+                                return false;
+                            const vals = getValidTypeValues(s.def, `${s.id}Type`);
+                            return vals.includes(type);
+                        });
+                        if (match) {
+                            errorMsg(`"${type}" is not a valid ${typeFieldId}. Did you mean --content-type ${match.id}?`);
+                        }
+                        else {
+                            errorMsg(`"${type}" is not a valid ${typeFieldId}. Run "cms-edit schema types ${ctId}" to see valid values.`);
+                        }
+                        process.exit(1);
+                    }
+                }
+                if (ctId === 'media' && !opts.assetId?.trim()) {
+                    warnMsg('Creating media without --asset-id (name only). Prefer: cms-edit create media --asset-id <id> --name "…", then set <ref> visual <mediaId> --link; or pass --asset-id on add into a content array.');
+                }
+                const { fields, hasTypeField: typed } = buildAddCreateFields(ctDefinition, {
+                    contentTypeId: ctId,
+                    typeArg: type,
+                    locale,
+                    label: opts.label,
+                    assetId: opts.assetId,
+                });
+                hasTypeField = typed;
+                // Create the new entry in Contentful (schema-safe fields only) — only after target validated
+                const newEntry = await env.createEntry(ctId, fields);
+                newEntryId = newEntry.sys.id;
+                session.entries[newEntryId] = serializeEntry(newEntry);
+                session.originalEntries[newEntryId] = serializeEntry(newEntry);
+            }
+            // Get or initialise the content array
+            if (!parentEntry.fields[targetField]) {
+                parentEntry.fields[targetField] = {};
+            }
+            const fieldLocaleMap = parentEntry.fields[targetField];
+            if (!fieldLocaleMap[locale]) {
+                fieldLocaleMap[locale] = [];
+            }
+            const contentArray = fieldLocaleMap[locale];
+            const newLink = makeEntryLink(newEntryId);
+            if (opts.after) {
+                const afterNode = findTreeNode(session, opts.after);
+                if (afterNode) {
+                    const afterIdx = contentArray.findIndex((item) => typeof item === 'object' &&
+                        item !== null &&
+                        'sys' in item &&
+                        item.sys.id === afterNode.entryId);
+                    if (afterIdx >= 0) {
+                        contentArray.splice(afterIdx + 1, 0, newLink);
+                    }
+                    else {
+                        contentArray.push(newLink);
+                    }
+                }
+                else {
+                    contentArray.push(newLink);
+                }
+            }
+            else {
+                contentArray.push(newLink);
+            }
+            if (!session.modifiedEntryIds.includes(parentEntryId)) {
+                session.modifiedEntryIds.push(parentEntryId);
+            }
+            // Rebuild the tree with the new entry
+            const { refs, refsByEntry, treeNodes } = buildTree(session.rootEntryId, session.entries, locale);
+            session.refs = refs;
+            session.refsByEntry = refsByEntry;
+            session.treeNodes = treeNodes;
+            const newRef = refsByEntry[newEntryId] ?? '?';
+            await saveSession(session);
+            if (opts.existingId) {
+                successMsg(`Linked existing entry ${newEntryId} as ${newRef}`);
+            }
+            else {
+                successMsg(hasTypeField
+                    ? `Created ${ctId} "${type}" as ${newRef} (ID: ${newEntryId})`
+                    : `Created ${ctId} as ${newRef} (ID: ${newEntryId}) — set fields with "cms-edit set ${newRef} <field> <value>"`);
+            }
+            warnMsg('Created entry is in Contentful with default fields only. ' +
+                'Field edits (set/rtf) on this entry AND the parent content-link stay in this session until "cms-edit save". ' +
+                'Do not open again without save/discard — that discards staged field edits. ' +
+                'Use "cms-edit open --resume" to re-print this session, or "cms-edit diff" / "cms-edit save".');
+            if (!isJsonMode()) {
+                renderSnapshot(session);
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/article-tags-from-json.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 registerArticleTagsFromJsonCommand(program: Command): void;
+//# sourceMappingURL=article-tags-from-json.d.ts.map

package/dist/commands/article-tags-from-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-tags-from-json.d.ts","sourceRoot":"","sources":["../../src/commands/article-tags-from-json.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuDzE"}

package/dist/commands/article-tags-from-json.js

@@ -0,0 +1,55 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { readJsonInput } from '../cli/read-json-input.js';
+import { runArticleTagsFromJson, } from '../contentful/article-tags-from-json.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg, infoMsg, warnMsg } from '../output/print.js';
+export function registerArticleTagsFromJsonCommand(program) {
+    program
+        .command('article-tags-from-json')
+        .description('Set tags on one or more articles from JSON.\n' +
+        'Provide --json or --json-base64. Resolves tag slugs via the local index (run index sync first).\n' +
+        'Continues on per-item errors and reports successes and failures.')
+        .option('--json <json>', 'Inline article-tags batch JSON')
+        .option('--json-base64 <encoded>', 'Base64-encoded article-tags batch JSON')
+        .option('--dry-run', 'Validate and preview without saving')
+        .action(async (opts) => {
+        const parentOpts = program.opts();
+        let spec;
+        try {
+            spec = readJsonInput({
+                json: opts.json,
+                jsonBase64: opts.jsonBase64,
+                label: 'article-tags-from-json',
+            });
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+        const batch = await runArticleTagsFromJson({
+            items: spec.articles ?? [],
+            dryRun: opts.dryRun,
+            configPath: parentOpts.config,
+            spaceKey: parentOpts.space,
+        });
+        const { results } = batch;
+        const updated = results.filter((r) => r.status === 'updated').length;
+        const failed = results.filter((r) => r.status === 'failed');
+        if (isJsonMode()) {
+            console.log(JSON.stringify({ ok: batch.ok, articles: results }));
+        }
+        else if (!opts.dryRun) {
+            infoMsg(`Updated tags on ${String(updated)} article(s); ${String(results.length - updated - failed.length)} unchanged/skipped.`);
+            if (failed.length > 0) {
+                warnMsg(`${String(failed.length)} article(s) failed:`);
+                for (const row of failed) {
+                    warnMsg(`  ${row.articleSlug}: ${row.message ?? 'unknown error'}`);
+                }
+            }
+        }
+        if (!batch.ok) {
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=article-tags-from-json.js.map

package/dist/commands/article-tags-from-json.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../src/commands/asset.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAGvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8CzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAo0B3D"}