@se-studio/contentful-cms 1.0.1

package/dist/commands/add.js

@@ -0,0 +1,166 @@
+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';
+export function registerAddCommand(program) {
+    program
+        .command('add <type>')
+        .description('Create a new entry and link it to the page/article.\n' +
+        '--content-type is required: pass the Contentful content type ID (e.g. component, collection, externalComponent, person).\n' +
+        'For typed content types (component, collection, externalComponent, …) the <type> argument is stored in the\n' +
+        '  {contentTypeId}Type field (e.g. componentType, externalComponentType). For content types without that field\n' +
+        '  <type> is used only as the initial cmsLabel.\n' +
+        'Use --after <ref> to insert after a specific entry, or --parent <ref> to add inside a collection.\n' +
+        'Use --target <field> to add to topContent, content, or bottomContent (page/article only).')
+        .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 content array: topContent, content, or bottomContent (page/article only)')
+        .requiredOption('--content-type <ct>', 'Contentful content type ID (e.g. component, collection, externalComponent, person)')
+        .action(async (type, opts, cmd) => {
+        const parentOpts = cmd.parent?.opts() ?? {};
+        try {
+            const session = requireSession();
+            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 whether this content type has a ${ctId}Type discriminator field.
+            // Fetching the CT definition avoids passing unknown fields to createEntry.
+            const typeFieldId = `${ctId}Type`;
+            const ctDefinition = await env.getContentType(ctId);
+            const hasTypeField = ctDefinition.fields.some((f) => f.id === typeFieldId);
+            // Create the new entry in Contentful
+            const newEntry = await env.createEntry(ctId, {
+                cmsLabel: { [locale]: `New ${type}` },
+                ...(hasTypeField ? { [typeFieldId]: { [locale]: type } } : {}),
+            });
+            const newEntryId = newEntry.sys.id;
+            session.entries[newEntryId] = serializeEntry(newEntry);
+            session.originalEntries[newEntryId] = serializeEntry(newEntry);
+            // Determine the parent entry and field to insert into
+            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;
+                targetField = 'contents';
+            }
+            else if (opts.after) {
+                resolveRef(session, opts.after);
+                const afterNode = findTreeNode(session, opts.after);
+                if (!afterNode || !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') {
+                        const pageArticleAllowed = ['topContent', 'content', 'bottomContent'];
+                        if (!pageArticleAllowed.includes(opts.target)) {
+                            errorMsg(`--target must be one of: ${pageArticleAllowed.join(', ')}. Got: ${opts.target}`);
+                            process.exit(1);
+                        }
+                        targetField = opts.target;
+                    }
+                    else {
+                        errorMsg(`--target is only supported when the open entry is a page or article. 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;
+            }
+            // 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] ?? '?';
+            saveSession(session);
+            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('Entry is saved to Contentful but changes to the parent page are unsaved. Run "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":"AAEA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,sCAAsC,EACtC,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AAExC,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CACV,uDAAuD;QACrD,4HAA4H;QAC5H,8GAA8G;QAC9G,iHAAiH;QACjH,kDAAkD;QAClD,qGAAqG;QACrG,2FAA2F,CAC9F;SACA,MAAM,CAAC,eAAe,EAAE,qCAAqC,CAAC;SAC9D,MAAM,CAAC,gBAAgB,EAAE,sDAAsD,CAAC;SAChF,MAAM,CACL,kBAAkB,EAClB,iFAAiF,CAClF;SACA,cAAc,CACb,qBAAqB,EACrB,oFAAoF,CACrF;SACA,MAAM,CACL,KAAK,EACH,IAAY,EACZ,IAA+E,EAC/E,GAAY,EACZ,EAAE;QACF,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAuC,IAAI,EAAE,CAAC;QACjF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YAErC,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC/D,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAE/C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;YAE9B,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,QAAQ,CACN,iBAAiB,IAAI,wDAAwD,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClI,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,2EAA2E;YAC3E,2EAA2E;YAC3E,MAAM,WAAW,GAAG,GAAG,IAAI,MAAM,CAAC;YAClC,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;YAE3E,qCAAqC;YACrC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;gBAC3C,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE;gBACrC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YACvD,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YAE/D,sDAAsD;YACtD,IAAI,aAAqB,CAAC;YAC1B,IAAI,WAAmB,CAAC;YAExB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBACjC,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBACtD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,QAAQ,CAAC,QAAQ,IAAI,CAAC,MAAM,kCAAkC,CAAC,CAAC;oBAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC;gBACnC,WAAW,GAAG,UAAU,CAAC;YAC3B,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAChC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;oBACtC,QAAQ,CAAC,2BAA2B,IAAI,CAAC,KAAK,6BAA6B,CAAC,CAAC;oBAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC;gBACnC,WAAW,GAAG,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;gBACpC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,IAAI,OAAO,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;wBACzC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;wBACtD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;4BAC3C,QAAQ,CAAC,6CAA6C,CAAC,CAAC;4BACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;wBAClB,CAAC;wBACD,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;oBAC5B,CAAC;yBAAM,IAAI,OAAO,CAAC,aAAa,KAAK,MAAM,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;wBACnF,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;wBACtE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;4BAC9C,QAAQ,CACN,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CACjF,CAAC;4BACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;wBAClB,CAAC;wBACD,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;oBAC5B,CAAC;yBAAM,CAAC;wBACN,QAAQ,CACN,wFAAwF,OAAO,CAAC,aAAa,GAAG,CACjH,CAAC;wBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAClB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,IAAI,OAAO,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;wBACzC,QAAQ,CAAC,oEAAoE,CAAC,CAAC;wBAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAClB,CAAC;oBACD,WAAW,GAAG,SAAS,CAAC;gBAC1B,CAAC;YACH,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACnD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,QAAQ,CAAC,oCAAoC,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,sCAAsC;YACtC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YACvC,CAAC;YACD,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,CAA8B,CAAC;YACpF,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAC9B,CAAC;YACD,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAc,CAAC;YAEzD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;YAE1C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpD,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,CACrC,CAAC,IAAI,EAAE,EAAE,CACP,OAAO,IAAI,KAAK,QAAQ;wBACxB,IAAI,KAAK,IAAI;wBACb,KAAK,IAAI,IAAI;wBACZ,IAAgC,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,OAAO,CACjE,CAAC;oBACF,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;wBAClB,YAAY,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;oBAChD,CAAC;yBAAM,CAAC;wBACN,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBACtD,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC/C,CAAC;YAED,sCAAsC;YACtC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,SAAS,CAChD,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,OAAO,EACf,MAAM,CACP,CAAC;YACF,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;YAClC,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;YAE9B,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC;YAC9C,WAAW,CAAC,OAAO,CAAC,CAAC;YACrB,UAAU,CACR,YAAY;gBACV,CAAC,CAAC,WAAW,IAAI,KAAK,IAAI,QAAQ,MAAM,SAAS,UAAU,GAAG;gBAC9D,CAAC,CAAC,WAAW,IAAI,OAAO,MAAM,SAAS,UAAU,qCAAqC,MAAM,mBAAmB,CAClH,CAAC;YACF,OAAO,CACL,+FAA+F,CAChG,CAAC;YACF,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;gBAClB,cAAc,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CACF,CAAC;AACN,CAAC"}

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;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2G3D"}

package/dist/commands/asset.js

@@ -0,0 +1,110 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import pc from 'picocolors';
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { getAssetSummary, searchAssets } from '../contentful/assets.js';
+import { createSafeEnvironment } from '../contentful/client.js';
+import { assetSummaryToJson } from '../output/json.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg, successMsg } from '../output/print.js';
+import { resolveRef } from '../session/refs.js';
+import { requireSession, saveSession } from '../session/store.js';
+export function registerAssetCommand(program) {
+    const asset = program.command('asset').description('Search and inspect Contentful assets');
+    asset
+        .command('search <query>')
+        .description('Search assets by title')
+        .option('-n, --limit <n>', 'Max results', '10')
+        .action(async (query, opts, cmd) => {
+        const parentOpts = cmd.parent?.parent?.opts() ?? {};
+        try {
+            const session = requireSession();
+            const config = loadConfig(parentOpts.config);
+            const { space } = resolveSpaceConfig(config, session.spaceKey);
+            const env = await createSafeEnvironment(space);
+            const limit = Number.parseInt(opts.limit ?? '10', 10);
+            const results = await searchAssets(env, query, limit);
+            if (isJsonMode()) {
+                console.log(JSON.stringify(results.map(assetSummaryToJson), null, 2));
+                return;
+            }
+            if (results.length === 0) {
+                console.log(pc.dim(`No assets found for "${query}"`));
+                return;
+            }
+            console.log(`\n${pc.bold('Assets matching: ')}${pc.cyan(query)}\n`);
+            for (const a of results) {
+                const dims = a.width && a.height ? pc.dim(` (${a.width}×${a.height})`) : '';
+                console.log(`  ${pc.bold(a.id)}  ${a.title}${dims}`);
+                console.log(`    ${pc.dim(a.fileName)}  ${pc.dim(a.url)}`);
+            }
+            console.log('');
+            console.log(pc.dim('Use the asset ID with: cms-edit asset set <ref> <field> <asset-id>'));
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    asset
+        .command('info <asset-id>')
+        .description('Show details for a specific asset')
+        .option('--json', 'Output as a JSON object')
+        .action(async (assetId, opts, cmd) => {
+        const parentOpts = cmd.parent?.parent?.opts() ?? {};
+        try {
+            const session = requireSession();
+            const config = loadConfig(parentOpts.config);
+            const { space } = resolveSpaceConfig(config, session.spaceKey);
+            const env = await createSafeEnvironment(space);
+            const summary = await getAssetSummary(env, assetId);
+            if (!summary) {
+                errorMsg(`Asset "${assetId}" not found.`);
+                process.exit(1);
+                return;
+            }
+            if (opts.json || isJsonMode()) {
+                console.log(JSON.stringify(assetSummaryToJson(summary), null, 2));
+                return;
+            }
+            console.log(`\n${pc.bold('Asset: ')}${summary.title}`);
+            console.log(`  ID:           ${summary.id}`);
+            console.log(`  File:         ${summary.fileName}`);
+            console.log(`  Content type: ${summary.contentType}`);
+            if (summary.width)
+                console.log(`  Dimensions:   ${summary.width}×${summary.height}`);
+            if (summary.size)
+                console.log(`  Size:         ${Math.round(summary.size / 1024)}KB`);
+            console.log(`  URL:          ${summary.url}\n`);
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    asset
+        .command('set <ref> <field> <asset-id>')
+        .description('Set a visual/asset field on an entry to a specific asset ID')
+        .option('--mobile', 'Set the mobile visual field (mobileVisual) instead of visual')
+        .action((ref, field, assetId, _opts) => {
+        try {
+            const session = requireSession();
+            const entry = resolveRef(session, ref);
+            const locale = session.defaultLocale;
+            const assetLink = { sys: { type: 'Link', linkType: 'Asset', id: assetId } };
+            if (!entry.fields[field]) {
+                entry.fields[field] = {};
+            }
+            entry.fields[field][locale] = assetLink;
+            if (!session.modifiedEntryIds.includes(entry.sys.id)) {
+                session.modifiedEntryIds.push(entry.sys.id);
+            }
+            saveSession(session);
+            successMsg(`Set ${field} on ${ref} to asset ${assetId}.`);
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=asset.js.map

package/dist/commands/asset.js.map

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

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

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

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

package/dist/commands/colours.js

@@ -0,0 +1,91 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import pc from 'picocolors';
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { createSafeEnvironment } from '../contentful/client.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg } from '../output/print.js';
+function extractInValues(field) {
+    const values = [];
+    for (const v of field.validations ?? []) {
+        if (Array.isArray(v.in)) {
+            values.push(...v.in);
+        }
+    }
+    return values;
+}
+export function registerColoursCommand(program) {
+    program
+        .command('colours')
+        .description('List the valid backgroundColour and textColour values from the content model.\n' +
+        'Returns one list for background colours and one for text colours.\n' +
+        'No session required — works without opening a page first.\n' +
+        'Example: cms-edit colours | cms-edit colours --json')
+        .action(async (_opts, cmd) => {
+        const parentOpts = cmd.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            const { space } = resolveSpaceConfig(config, parentOpts.space);
+            const env = await createSafeEnvironment(space);
+            const collection = await env.getContentTypes();
+            let backgroundColours = [];
+            let textColours = [];
+            for (const ct of collection.items) {
+                if (backgroundColours.length === 0) {
+                    const field = ct.fields.find((f) => f.id === 'backgroundColour');
+                    if (field) {
+                        const values = extractInValues(field);
+                        if (values.length > 0)
+                            backgroundColours = values.sort();
+                    }
+                }
+                if (textColours.length === 0) {
+                    const field = ct.fields.find((f) => f.id === 'textColour');
+                    if (field) {
+                        const values = extractInValues(field);
+                        if (values.length > 0)
+                            textColours = values.sort();
+                    }
+                }
+                if (backgroundColours.length > 0 && textColours.length > 0)
+                    break;
+            }
+            if (isJsonMode()) {
+                console.log(JSON.stringify({ backgroundColour: backgroundColours, textColour: textColours }, null, 2));
+                return;
+            }
+            if (backgroundColours.length === 0 && textColours.length === 0) {
+                console.log(pc.dim('No backgroundColour or textColour fields with valid values found in this space.'));
+                return;
+            }
+            if (backgroundColours.length > 0) {
+                console.log(`\n${pc.bold('Background colours')} (${backgroundColours.length}):\n`);
+                for (const v of backgroundColours) {
+                    console.log(`  ${pc.cyan(v)}`);
+                }
+                console.log('');
+                console.log(pc.dim('Use with: cms-edit set @ref backgroundColour "<Value>"'));
+                console.log('');
+            }
+            else {
+                console.log(pc.dim('\nNo backgroundColour values found in this space.\n'));
+            }
+            if (textColours.length > 0) {
+                console.log(`${pc.bold('Text colours')} (${textColours.length}):\n`);
+                for (const v of textColours) {
+                    console.log(`  ${pc.cyan(v)}`);
+                }
+                console.log('');
+                console.log(pc.dim('Use with: cms-edit set @ref textColour "<Value>"'));
+                console.log('');
+            }
+            else {
+                console.log(pc.dim('No textColour values found in this space.\n'));
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=colours.js.map

package/dist/commands/colours.js.map

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

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

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

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

package/dist/commands/create.js

@@ -0,0 +1,223 @@
+/** 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 { fetchEntryTree, serializeEntry } from '../contentful/fetch.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg, infoMsg, successMsg } from '../output/print.js';
+import { buildTree } from '../session/refs.js';
+import { saveSession } from '../session/store.js';
+import { renderSnapshot } from '../snapshot/render.js';
+export function registerCreateCommand(program) {
+    const create = program
+        .command('create')
+        .description('Create a new page, article, or other entry. After create, edit with set/rtf/add; then save.');
+    create
+        .command('page')
+        .description('Create a new page entry')
+        .requiredOption('--slug <slug>', 'URL slug (e.g. /about-us)')
+        .requiredOption('--title <title>', 'Page title')
+        .option('--description <desc>', 'Meta description')
+        .action(async (opts, _cmd, cmd2) => {
+        const parentOpts = cmd2.parent?.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            const { key, space } = resolveSpaceConfig(config, parentOpts.space);
+            const env = await createSafeEnvironment(space);
+            const locale = space.defaultLocale;
+            const slug = opts.slug.startsWith('/') ? opts.slug.slice(1) : opts.slug;
+            const newEntry = await env.createEntry('page', {
+                cmsLabel: { [locale]: opts.title },
+                title: { [locale]: opts.title },
+                slug: { [locale]: slug || 'index' },
+                description: { [locale]: opts.description ?? '' },
+            });
+            const rootEntryId = newEntry.sys.id;
+            const entries = await fetchEntryTree(env, rootEntryId);
+            entries[rootEntryId] = serializeEntry(newEntry);
+            const { refs, refsByEntry, treeNodes } = buildTree(rootEntryId, entries, locale);
+            const session = {
+                version: 1,
+                spaceKey: key,
+                spaceId: space.spaceId,
+                environment: space.environment,
+                defaultLocale: locale,
+                rootEntryId,
+                rootEntryType: 'page',
+                fetchedAt: new Date().toISOString(),
+                entries,
+                originalEntries: JSON.parse(JSON.stringify(entries)),
+                refs,
+                refsByEntry,
+                treeNodes,
+                modifiedEntryIds: [],
+                pendingDeletions: [],
+            };
+            saveSession(session);
+            successMsg(`Created page "${opts.title}" (ID: ${rootEntryId})`);
+            infoMsg(`View in Contentful: https://app.contentful.com/spaces/${space.spaceId}/entries/${rootEntryId}`);
+            infoMsg(`Slug: /${slug}`);
+            if (!isJsonMode()) {
+                renderSnapshot(session);
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    create
+        .command('article')
+        .description('Create a new article entry')
+        .requiredOption('--slug <slug>', 'URL slug (e.g. /blog/my-article)')
+        .requiredOption('--title <title>', 'Article title')
+        .requiredOption('--article-type-id <id>', 'Contentful entry ID of the articleType')
+        .option('--description <desc>', 'Meta description')
+        .action(async (opts, _cmd, cmd2) => {
+        const parentOpts = cmd2.parent?.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            const { key, space } = resolveSpaceConfig(config, parentOpts.space);
+            const env = await createSafeEnvironment(space);
+            const locale = space.defaultLocale;
+            const slug = opts.slug.startsWith('/') ? opts.slug.slice(1) : opts.slug;
+            const newEntry = await env.createEntry('article', {
+                cmsLabel: { [locale]: opts.title },
+                title: { [locale]: opts.title },
+                slug: { [locale]: slug },
+                description: { [locale]: opts.description ?? '' },
+                date: { [locale]: new Date().toISOString().split('T')[0] },
+                articleType: {
+                    [locale]: { sys: { type: 'Link', linkType: 'Entry', id: opts.articleTypeId } },
+                },
+            });
+            const rootEntryId = newEntry.sys.id;
+            const entries = await fetchEntryTree(env, rootEntryId);
+            entries[rootEntryId] = serializeEntry(newEntry);
+            const { refs, refsByEntry, treeNodes } = buildTree(rootEntryId, entries, locale);
+            const session = {
+                version: 1,
+                spaceKey: key,
+                spaceId: space.spaceId,
+                environment: space.environment,
+                defaultLocale: locale,
+                rootEntryId,
+                rootEntryType: 'article',
+                fetchedAt: new Date().toISOString(),
+                entries,
+                originalEntries: JSON.parse(JSON.stringify(entries)),
+                refs,
+                refsByEntry,
+                treeNodes,
+                modifiedEntryIds: [],
+                pendingDeletions: [],
+            };
+            saveSession(session);
+            successMsg(`Created article "${opts.title}" (ID: ${rootEntryId})`);
+            infoMsg(`View in Contentful: https://app.contentful.com/spaces/${space.spaceId}/entries/${rootEntryId}`);
+            if (!isJsonMode()) {
+                renderSnapshot(session);
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    create
+        .command('template')
+        .description('Create a new template entry')
+        .requiredOption('--label <label>', 'Template label (cmsLabel)')
+        .action(async (opts, _cmd, cmd2) => {
+        const parentOpts = cmd2.parent?.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            const { key, space } = resolveSpaceConfig(config, parentOpts.space);
+            const env = await createSafeEnvironment(space);
+            const locale = space.defaultLocale;
+            const newEntry = await env.createEntry('template', {
+                cmsLabel: { [locale]: opts.label },
+            });
+            const rootEntryId = newEntry.sys.id;
+            const entries = await fetchEntryTree(env, rootEntryId);
+            entries[rootEntryId] = serializeEntry(newEntry);
+            const { refs, refsByEntry, treeNodes } = buildTree(rootEntryId, entries, locale);
+            const session = {
+                version: 1,
+                spaceKey: key,
+                spaceId: space.spaceId,
+                environment: space.environment,
+                defaultLocale: locale,
+                rootEntryId,
+                rootEntryType: 'template',
+                fetchedAt: new Date().toISOString(),
+                entries,
+                originalEntries: JSON.parse(JSON.stringify(entries)),
+                refs,
+                refsByEntry,
+                treeNodes,
+                modifiedEntryIds: [],
+                pendingDeletions: [],
+            };
+            saveSession(session);
+            successMsg(`Created template "${opts.label}" (ID: ${rootEntryId})`);
+            infoMsg(`View in Contentful: https://app.contentful.com/spaces/${space.spaceId}/entries/${rootEntryId}`);
+            infoMsg(`Open with: cms-edit open ${rootEntryId} --id`);
+            if (!isJsonMode()) {
+                renderSnapshot(session);
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    create
+        .command('navigation')
+        .description('Create a new navigation entry')
+        .requiredOption('--label <label>', 'Navigation label (cmsLabel or adminLabel)')
+        .action(async (opts, _cmd, cmd2) => {
+        const parentOpts = cmd2.parent?.parent?.opts() ?? {};
+        try {
+            const config = loadConfig(parentOpts.config);
+            const { key, space } = resolveSpaceConfig(config, parentOpts.space);
+            const env = await createSafeEnvironment(space);
+            const locale = space.defaultLocale;
+            const newEntry = await env.createEntry('navigation', {
+                cmsLabel: { [locale]: opts.label },
+            });
+            const rootEntryId = newEntry.sys.id;
+            const entries = await fetchEntryTree(env, rootEntryId);
+            entries[rootEntryId] = serializeEntry(newEntry);
+            const { refs, refsByEntry, treeNodes } = buildTree(rootEntryId, entries, locale);
+            const session = {
+                version: 1,
+                spaceKey: key,
+                spaceId: space.spaceId,
+                environment: space.environment,
+                defaultLocale: locale,
+                rootEntryId,
+                rootEntryType: 'navigation',
+                fetchedAt: new Date().toISOString(),
+                entries,
+                originalEntries: JSON.parse(JSON.stringify(entries)),
+                refs,
+                refsByEntry,
+                treeNodes,
+                modifiedEntryIds: [],
+                pendingDeletions: [],
+            };
+            saveSession(session);
+            successMsg(`Created navigation "${opts.label}" (ID: ${rootEntryId})`);
+            infoMsg(`View in Contentful: https://app.contentful.com/spaces/${space.spaceId}/entries/${rootEntryId}`);
+            infoMsg(`Open with: cms-edit open ${rootEntryId} --id or cms-edit nav open ${rootEntryId} --id`);
+            if (!isJsonMode()) {
+                renderSnapshot(session);
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=create.js.map