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

package/dist/commands/entry-lookup-target.js

@@ -0,0 +1,235 @@
+/** Shared flat lookup flags for `open`, `peek`, and `resolve`. */
+export const ENTRY_LOOKUP_OPEN_CLI_OPTIONS = [
+    ['--id <entryId>', 'Contentful entry ID'],
+    ['--page-slug <slug>', 'Page slug'],
+    ['--page-title <title>', 'Page title'],
+    ['--page-cms-label <label>', 'Page cmsLabel'],
+    ['--article-slug <slug>', 'Article slug'],
+    ['--article-title <title>', 'Article title'],
+    ['--article-cms-label <label>', 'Article cmsLabel'],
+    ['--page-variant-slug <slug>', 'Page variant slug'],
+    ['--page-variant-title <title>', 'Page variant title'],
+    ['--page-variant-cms-label <label>', 'Page variant cmsLabel'],
+    ['--tag-slug <slug>', 'Tag slug (optional: --tag-type-slug / --tag-type-name to scope)'],
+    ['--tag-name <name>', 'Tag name (optional: --tag-type-slug / --tag-type-name to scope)'],
+    [
+        '--tag-cms-label <label>',
+        'Tag cmsLabel (optional: --tag-type-slug / --tag-type-name to scope)',
+    ],
+    ['--tag-type-slug <slug>', 'Tag type slug'],
+    ['--tag-type-name <name>', 'Tag type name'],
+    ['--article-type-slug <slug>', 'Article type slug'],
+    ['--article-type-name <name>', 'Article type name'],
+    ['--template-label <label>', 'Template cmsLabel'],
+    ['--label <label>', 'Alias for --template-label'],
+];
+/** Navigation lookup flags used by `resolve` only. */
+export const ENTRY_LOOKUP_RESOLVE_NAV_CLI_OPTIONS = [
+    ['--nav-id <id>', 'Navigation entry ID'],
+    ['--nav-name <name>', 'Navigation name'],
+    ['--nav-item-id <id>', 'Navigation item entry ID'],
+    ['--nav-item-title <title>', 'Navigation item title (use --nav-id when titles collide)'],
+];
+export function registerEntryLookupOpenOptions(cmd) {
+    for (const [flags, desc] of ENTRY_LOOKUP_OPEN_CLI_OPTIONS) {
+        cmd.option(flags, desc);
+    }
+}
+export function registerEntryLookupResolveOptions(cmd) {
+    registerEntryLookupOpenOptions(cmd);
+    for (const [flags, desc] of ENTRY_LOOKUP_RESOLVE_NAV_CLI_OPTIONS) {
+        cmd.option(flags, desc);
+    }
+}
+const PRIMARY_KEYS = [
+    'id',
+    'pageSlug',
+    'pageTitle',
+    'pageCmsLabel',
+    'articleSlug',
+    'articleTitle',
+    'articleCmsLabel',
+    'pageVariantSlug',
+    'pageVariantTitle',
+    'pageVariantCmsLabel',
+    'tagSlug',
+    'tagName',
+    'tagCmsLabel',
+    'articleTypeSlug',
+    'articleTypeName',
+    'templateLabel',
+    'navName',
+    'navItemId',
+    'navItemTitle',
+];
+function trimOpt(value) {
+    const t = value?.trim();
+    return t === '' ? undefined : t;
+}
+function normalizeOpts(opts) {
+    const templateLabel = trimOpt(opts.templateLabel) ?? trimOpt(opts.label);
+    return {
+        id: trimOpt(opts.id),
+        pageSlug: trimOpt(opts.pageSlug),
+        pageTitle: trimOpt(opts.pageTitle),
+        pageCmsLabel: trimOpt(opts.pageCmsLabel),
+        articleSlug: trimOpt(opts.articleSlug),
+        articleTitle: trimOpt(opts.articleTitle),
+        articleCmsLabel: trimOpt(opts.articleCmsLabel),
+        pageVariantSlug: trimOpt(opts.pageVariantSlug),
+        pageVariantTitle: trimOpt(opts.pageVariantTitle),
+        pageVariantCmsLabel: trimOpt(opts.pageVariantCmsLabel),
+        tagSlug: trimOpt(opts.tagSlug),
+        tagName: trimOpt(opts.tagName),
+        tagCmsLabel: trimOpt(opts.tagCmsLabel),
+        tagTypeSlug: trimOpt(opts.tagTypeSlug),
+        tagTypeName: trimOpt(opts.tagTypeName),
+        articleTypeSlug: trimOpt(opts.articleTypeSlug),
+        articleTypeName: trimOpt(opts.articleTypeName),
+        templateLabel,
+        navId: trimOpt(opts.navId),
+        navName: trimOpt(opts.navName),
+        navItemId: trimOpt(opts.navItemId),
+        navItemTitle: trimOpt(opts.navItemTitle),
+    };
+}
+function tagScope(o) {
+    return {
+        ...(o.tagTypeSlug ? { tagTypeSlug: o.tagTypeSlug } : {}),
+        ...(o.tagTypeName ? { tagTypeName: o.tagTypeName } : {}),
+    };
+}
+function buildPrimaryTarget(key, o) {
+    const scope = tagScope(o);
+    switch (key) {
+        case 'id':
+            return { kind: 'entryId', id: o.id };
+        case 'pageSlug':
+            return { kind: 'pageSlug', slug: o.pageSlug };
+        case 'pageTitle':
+            return { kind: 'pageTitle', title: o.pageTitle };
+        case 'pageCmsLabel':
+            return { kind: 'pageCmsLabel', cmsLabel: o.pageCmsLabel };
+        case 'articleSlug':
+            return { kind: 'articleSlug', slug: o.articleSlug };
+        case 'articleTitle':
+            return { kind: 'articleTitle', title: o.articleTitle };
+        case 'articleCmsLabel':
+            return { kind: 'articleCmsLabel', cmsLabel: o.articleCmsLabel };
+        case 'pageVariantSlug':
+            return { kind: 'pageVariantSlug', slug: o.pageVariantSlug };
+        case 'pageVariantTitle':
+            return { kind: 'pageVariantTitle', title: o.pageVariantTitle };
+        case 'pageVariantCmsLabel':
+            return { kind: 'pageVariantCmsLabel', cmsLabel: o.pageVariantCmsLabel };
+        case 'tagSlug':
+            return { kind: 'tagSlug', slug: o.tagSlug, ...scope };
+        case 'tagName':
+            return { kind: 'tagName', name: o.tagName, ...scope };
+        case 'tagCmsLabel':
+            return { kind: 'tagCmsLabel', cmsLabel: o.tagCmsLabel, ...scope };
+        case 'articleTypeSlug':
+            return { kind: 'articleTypeSlug', slug: o.articleTypeSlug };
+        case 'articleTypeName':
+            return { kind: 'articleTypeName', name: o.articleTypeName };
+        case 'templateLabel':
+            return { kind: 'templateLabel', label: o.templateLabel };
+        case 'navName':
+            return { kind: 'navName', name: o.navName };
+        case 'navItemId':
+            return { kind: 'navItemId', id: o.navItemId };
+        case 'navItemTitle':
+            return {
+                kind: 'navItemTitle',
+                title: o.navItemTitle,
+                ...(o.navId ? { navId: o.navId } : {}),
+            };
+    }
+}
+/**
+ * Parses flat CLI lookup flags into a single target. Returns null when none or multiple primaries are set.
+ */
+export function parseEntryLookupTarget(opts) {
+    const o = normalizeOpts(opts);
+    const tagScoped = Boolean(o.tagSlug ?? o.tagName ?? o.tagCmsLabel);
+    const primaryKeys = [];
+    for (const key of PRIMARY_KEYS) {
+        if (o[key] !== undefined)
+            primaryKeys.push(key);
+    }
+    if (!tagScoped) {
+        if (o.tagTypeSlug && !o.tagTypeName) {
+            return { kind: 'tagTypeSlug', slug: o.tagTypeSlug };
+        }
+        if (o.tagTypeName && !o.tagTypeSlug) {
+            return { kind: 'tagTypeName', name: o.tagTypeName };
+        }
+        if (o.tagTypeSlug && o.tagTypeName)
+            return null;
+    }
+    else if (primaryKeys.length === 0) {
+        return null;
+    }
+    if (primaryKeys.length !== 1)
+        return null;
+    const key = primaryKeys[0];
+    if (key === undefined)
+        return null;
+    return buildPrimaryTarget(key, o);
+}
+export function entryLookupTargetErrorMessage() {
+    return ('Provide exactly one lookup flag, for example:\n' +
+        '  --id <entryId>\n' +
+        '  --page-slug <slug>  --page-title <title>  --page-cms-label <label>\n' +
+        '  --article-slug <slug>  --tag-name <name>  --template-label <cmsLabel>\n' +
+        '  --nav-name <name>  --nav-item-title <title> [--nav-id <navId>]');
+}
+export function entryLookupTargetDescription(target) {
+    switch (target.kind) {
+        case 'entryId':
+            return `entry ID ${target.id}`;
+        case 'pageSlug':
+            return `page slug "${target.slug}"`;
+        case 'pageTitle':
+            return `page title "${target.title}"`;
+        case 'pageCmsLabel':
+            return `page cmsLabel "${target.cmsLabel}"`;
+        case 'articleSlug':
+            return `article slug "${target.slug}"`;
+        case 'articleTitle':
+            return `article title "${target.title}"`;
+        case 'articleCmsLabel':
+            return `article cmsLabel "${target.cmsLabel}"`;
+        case 'pageVariantSlug':
+            return `pageVariant slug "${target.slug}"`;
+        case 'pageVariantTitle':
+            return `pageVariant title "${target.title}"`;
+        case 'pageVariantCmsLabel':
+            return `pageVariant cmsLabel "${target.cmsLabel}"`;
+        case 'tagSlug':
+            return `tag slug "${target.slug}"`;
+        case 'tagName':
+            return `tag name "${target.name}"`;
+        case 'tagCmsLabel':
+            return `tag cmsLabel "${target.cmsLabel}"`;
+        case 'tagTypeSlug':
+            return `tagType slug "${target.slug}"`;
+        case 'tagTypeName':
+            return `tagType name "${target.name}"`;
+        case 'articleTypeSlug':
+            return `articleType slug "${target.slug}"`;
+        case 'articleTypeName':
+            return `articleType name "${target.name}"`;
+        case 'templateLabel':
+            return `template cmsLabel "${target.label}"`;
+        case 'navId':
+            return `navigation ID ${target.id}`;
+        case 'navName':
+            return `navigation name "${target.name}"`;
+        case 'navItemId':
+            return `navigationItem ID ${target.id}`;
+        case 'navItemTitle':
+            return `navigationItem title "${target.title}"`;
+    }
+}
+//# sourceMappingURL=entry-lookup-target.js.map

package/dist/commands/entry-lookup-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-lookup-target.js","sourceRoot":"","sources":["../../src/commands/entry-lookup-target.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IACzC,CAAC,oBAAoB,EAAE,WAAW,CAAC;IACnC,CAAC,sBAAsB,EAAE,YAAY,CAAC;IACtC,CAAC,0BAA0B,EAAE,eAAe,CAAC;IAC7C,CAAC,uBAAuB,EAAE,cAAc,CAAC;IACzC,CAAC,yBAAyB,EAAE,eAAe,CAAC;IAC5C,CAAC,6BAA6B,EAAE,kBAAkB,CAAC;IACnD,CAAC,4BAA4B,EAAE,mBAAmB,CAAC;IACnD,CAAC,8BAA8B,EAAE,oBAAoB,CAAC;IACtD,CAAC,kCAAkC,EAAE,uBAAuB,CAAC;IAC7D,CAAC,mBAAmB,EAAE,iEAAiE,CAAC;IACxF,CAAC,mBAAmB,EAAE,iEAAiE,CAAC;IACxF;QACE,yBAAyB;QACzB,qEAAqE;KACtE;IACD,CAAC,wBAAwB,EAAE,eAAe,CAAC;IAC3C,CAAC,wBAAwB,EAAE,eAAe,CAAC;IAC3C,CAAC,4BAA4B,EAAE,mBAAmB,CAAC;IACnD,CAAC,4BAA4B,EAAE,mBAAmB,CAAC;IACnD,CAAC,0BAA0B,EAAE,mBAAmB,CAAC;IACjD,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;CACzC,CAAC;AAEX,sDAAsD;AACtD,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,CAAC,eAAe,EAAE,qBAAqB,CAAC;IACxC,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;IACxC,CAAC,oBAAoB,EAAE,0BAA0B,CAAC;IAClD,CAAC,0BAA0B,EAAE,0DAA0D,CAAC;CAChF,CAAC;AAEX,MAAM,UAAU,8BAA8B,CAAC,GAAY;IACzD,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,6BAA6B,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,GAAY;IAC5D,8BAA8B,CAAC,GAAG,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,oCAAoC,EAAE,CAAC;QACjE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAyDD,MAAM,YAAY,GAAiB;IACjC,IAAI;IACJ,UAAU;IACV,WAAW;IACX,cAAc;IACd,aAAa;IACb,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,SAAS;IACT,SAAS;IACT,aAAa;IACb,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,SAAS;IACT,WAAW;IACX,cAAc;CACf,CAAC;AAEF,SAAS,OAAO,CAAC,KAAyB;IACxC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,IAA2B;IAChD,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAClC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QACxC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;QACtC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QACxC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9C,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9C,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAChD,mBAAmB,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACtD,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;QACtC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;QACtC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;QACtC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9C,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9C,aAAa;QACb,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAClC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAwB;IAIxC,OAAO;QACL,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAe,EAAE,CAAwB;IACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,IAAI;YACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,EAAG,EAAE,CAAC;QACxC,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,QAAS,EAAE,CAAC;QACjD,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,SAAU,EAAE,CAAC;QACpD,KAAK,cAAc;YACjB,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAa,EAAE,CAAC;QAC7D,KAAK,aAAa;YAChB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,WAAY,EAAE,CAAC;QACvD,KAAK,cAAc;YACjB,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,YAAa,EAAE,CAAC;QAC1D,KAAK,iBAAiB;YACpB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,eAAgB,EAAE,CAAC;QACnE,KAAK,iBAAiB;YACpB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,eAAgB,EAAE,CAAC;QAC/D,KAAK,kBAAkB;YACrB,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,gBAAiB,EAAE,CAAC;QAClE,KAAK,qBAAqB;YACxB,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,CAAC,mBAAoB,EAAE,CAAC;QAC3E,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,OAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;QACzD,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,OAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;QACzD,KAAK,aAAa;YAChB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,WAAY,EAAE,GAAG,KAAK,EAAE,CAAC;QACrE,KAAK,iBAAiB;YACpB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,eAAgB,EAAE,CAAC;QAC/D,KAAK,iBAAiB;YACpB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,eAAgB,EAAE,CAAC;QAC/D,KAAK,eAAe;YAClB,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,aAAc,EAAE,CAAC;QAC5D,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,OAAQ,EAAE,CAAC;QAC/C,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,SAAU,EAAE,CAAC;QACjD,KAAK,cAAc;YACjB,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,CAAC,CAAC,YAAa;gBACtB,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvC,CAAC;IACN,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA2B;IAChE,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC;IACnE,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;IAClD,CAAC;SAAM,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,CACL,iDAAiD;QACjD,oBAAoB;QACpB,wEAAwE;QACxE,2EAA2E;QAC3E,kEAAkE,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAyB;IACpE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,YAAY,MAAM,CAAC,EAAE,EAAE,CAAC;QACjC,KAAK,UAAU;YACb,OAAO,cAAc,MAAM,CAAC,IAAI,GAAG,CAAC;QACtC,KAAK,WAAW;YACd,OAAO,eAAe,MAAM,CAAC,KAAK,GAAG,CAAC;QACxC,KAAK,cAAc;YACjB,OAAO,kBAAkB,MAAM,CAAC,QAAQ,GAAG,CAAC;QAC9C,KAAK,aAAa;YAChB,OAAO,iBAAiB,MAAM,CAAC,IAAI,GAAG,CAAC;QACzC,KAAK,cAAc;YACjB,OAAO,kBAAkB,MAAM,CAAC,KAAK,GAAG,CAAC;QAC3C,KAAK,iBAAiB;YACpB,OAAO,qBAAqB,MAAM,CAAC,QAAQ,GAAG,CAAC;QACjD,KAAK,iBAAiB;YACpB,OAAO,qBAAqB,MAAM,CAAC,IAAI,GAAG,CAAC;QAC7C,KAAK,kBAAkB;YACrB,OAAO,sBAAsB,MAAM,CAAC,KAAK,GAAG,CAAC;QAC/C,KAAK,qBAAqB;YACxB,OAAO,yBAAyB,MAAM,CAAC,QAAQ,GAAG,CAAC;QACrD,KAAK,SAAS;YACZ,OAAO,aAAa,MAAM,CAAC,IAAI,GAAG,CAAC;QACrC,KAAK,SAAS;YACZ,OAAO,aAAa,MAAM,CAAC,IAAI,GAAG,CAAC;QACrC,KAAK,aAAa;YAChB,OAAO,iBAAiB,MAAM,CAAC,QAAQ,GAAG,CAAC;QAC7C,KAAK,aAAa;YAChB,OAAO,iBAAiB,MAAM,CAAC,IAAI,GAAG,CAAC;QACzC,KAAK,aAAa;YAChB,OAAO,iBAAiB,MAAM,CAAC,IAAI,GAAG,CAAC;QACzC,KAAK,iBAAiB;YACpB,OAAO,qBAAqB,MAAM,CAAC,IAAI,GAAG,CAAC;QAC7C,KAAK,iBAAiB;YACpB,OAAO,qBAAqB,MAAM,CAAC,IAAI,GAAG,CAAC;QAC7C,KAAK,eAAe;YAClB,OAAO,sBAAsB,MAAM,CAAC,KAAK,GAAG,CAAC;QAC/C,KAAK,OAAO;YACV,OAAO,iBAAiB,MAAM,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,SAAS;YACZ,OAAO,oBAAoB,MAAM,CAAC,IAAI,GAAG,CAAC;QAC5C,KAAK,WAAW;YACd,OAAO,qBAAqB,MAAM,CAAC,EAAE,EAAE,CAAC;QAC1C,KAAK,cAAc;YACjB,OAAO,yBAAyB,MAAM,CAAC,KAAK,GAAG,CAAC;IACpD,CAAC;AACH,CAAC"}

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

package/dist/commands/entry-search.d.ts.map

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

package/dist/commands/entry-search.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 { entryToJson } from '../output/json.js';
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg } from '../output/print.js';
+export function registerEntrySearchCommand(program) {
+    program
+        .command('search <query>')
+        .description('Full-text search across Contentful entries (pages, articles, components).\n' +
+        'For type-specific listing use: list --type <contentType>  (e.g. list --type article)')
+        .option('-n, --limit <n>', 'Max results', '10')
+        .option('--type <type>', 'Filter by content type (e.g. page, article, component)')
+        .option('--json', 'Output as a JSON array including all fields')
+        .action(async (query, 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 locale = space.defaultLocale;
+            const limit = Number.parseInt(opts.limit ?? '10', 10);
+            const queryParams = {
+                query,
+                limit,
+                order: opts.type === 'article' ? '-fields.date' : '-sys.updatedAt',
+            };
+            if (opts.type) {
+                queryParams['content_type'] = opts.type;
+            }
+            const result = await env.getEntries(queryParams);
+            if (opts.json || isJsonMode()) {
+                const jsonEntries = result.items.map((e) => {
+                    const fields = e.fields;
+                    return entryToJson({
+                        sys: {
+                            id: e.sys.id,
+                            contentType: { sys: { id: e.sys.contentType.sys.id } },
+                            publishedVersion: e.sys.publishedVersion,
+                            updatedAt: e.sys.updatedAt,
+                        },
+                        fields,
+                    }, locale);
+                });
+                console.log(JSON.stringify(jsonEntries, null, 2));
+                return;
+            }
+            if (result.items.length === 0) {
+                console.log(pc.dim(`No entries found for "${query}"`));
+                return;
+            }
+            console.log(`\n${pc.bold('Entries matching: ')}${pc.cyan(query)} ${pc.dim(`(${result.total} total)`)}\n`);
+            for (const entry of result.items) {
+                const ctId = entry.sys.contentType.sys.id;
+                const fields = entry.fields;
+                const title = String(fields['title']?.[locale] ??
+                    fields['title']?.['en-US'] ??
+                    fields['cmsLabel']?.[locale] ??
+                    fields['cmsLabel']?.['en-US'] ??
+                    entry.sys.id);
+                const slug = fields['slug']?.[locale] ?? fields['slug']?.['en-US'];
+                const status = entry.sys.publishedVersion ? pc.green('published') : pc.cyan('draft');
+                const date = fields['date']?.[locale] ?? fields['date']?.['en-US'];
+                console.log(`  ${pc.bold(entry.sys.id)}  ${pc.blue(`[${ctId}]`)}  ${title}  ${status}`);
+                if (slug)
+                    console.log(`    ${pc.dim(`slug: /${slug}`)}`);
+                if (date)
+                    console.log(`    ${pc.dim(`Date: ${String(date)}`)}`);
+                console.log(`    ${pc.dim(`Updated: ${entry.sys.updatedAt}`)}`);
+            }
+            console.log('');
+            console.log(pc.dim('Open with: cms-edit open --page-slug <slug>  or  cms-edit open --id <id>'));
+            console.log('');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // Contentful returns HTTP 400 when the query string is malformed or uses unsupported syntax
+            if (msg.includes('400') || msg.toLowerCase().includes('bad request')) {
+                errorMsg(`Search query rejected by Contentful (HTTP 400). The query string may contain unsupported characters or syntax.\n` +
+                    `Tip: Use simple keywords (e.g. cms-edit search "case study") or add --type to narrow results.\n` +
+                    `Original error: ${msg}`);
+            }
+            else {
+                errorMsg(msg);
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=entry-search.js.map

package/dist/commands/entry-search.js.map

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

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

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

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

package/dist/commands/guide.js

@@ -0,0 +1,18 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { getGuideTopicMarkdown, parseGuideTopic } from '../mcp/guide.js';
+import { isJsonMode } from '../output/mode.js';
+export function registerGuideCommand(program) {
+    program
+        .command('guide [topic]')
+        .description('Print the cms-edit getting-started guide. Topics: overview, workflow, commands, troubleshooting, hosted.')
+        .action((topic) => {
+        const resolvedTopic = parseGuideTopic(topic);
+        const markdown = getGuideTopicMarkdown(resolvedTopic);
+        if (isJsonMode()) {
+            console.log(JSON.stringify({ ok: true, topic: resolvedTopic, markdown }));
+            return;
+        }
+        console.log(markdown);
+    });
+}
+//# sourceMappingURL=guide.js.map

package/dist/commands/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/commands/guide.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAGvF,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CACV,0GAA0G,CAC3G;SACA,MAAM,CAAC,CAAC,KAAc,EAAE,EAAE;QACzB,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACP,CAAC"}

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

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

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

package/dist/commands/health.js

@@ -0,0 +1,179 @@
+/** 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';
+export function registerHealthCommand(program) {
+    program
+        .command('health')
+        .description('Validate config, token, and Contentful connectivity. No session required.\n' +
+        'Exit 0 if all required checks pass (optional warnings allowed). Exit 1 if any required check fails.')
+        .action(async (_opts, cmd) => {
+        const parentOpts = cmd.parent?.opts() ?? {};
+        try {
+            const results = [];
+            // 1. Config file found
+            let config;
+            try {
+                config = loadConfig(parentOpts.config);
+                results.push({ name: 'Config file found', ok: true, optional: false, detail: 'OK' });
+            }
+            catch (err) {
+                results.push({
+                    name: 'Config file found',
+                    ok: false,
+                    optional: false,
+                    detail: err instanceof Error ? err.message : String(err),
+                });
+            }
+            // 2. Space config resolves
+            let spaceKey;
+            let spaceCfg;
+            if (config) {
+                try {
+                    const resolved = resolveSpaceConfig(config);
+                    spaceKey = resolved.key;
+                    spaceCfg = resolved.space;
+                    results.push({
+                        name: `Space config (${resolved.key})`,
+                        ok: true,
+                        optional: false,
+                        detail: `spaceId=${resolved.space.spaceId}  env=${resolved.space.environment}`,
+                    });
+                }
+                catch (err) {
+                    results.push({
+                        name: 'Space config',
+                        ok: false,
+                        optional: false,
+                        detail: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            // 3. Default locale configured
+            if (spaceCfg) {
+                results.push({
+                    name: 'Default locale',
+                    ok: true,
+                    optional: false,
+                    detail: spaceCfg.defaultLocale ?? 'en-US',
+                });
+            }
+            // 4. Contentful connectivity
+            let connected = false;
+            if (spaceCfg) {
+                try {
+                    const env = await createSafeEnvironment(spaceCfg);
+                    const cts = await env.getContentTypes();
+                    connected = true;
+                    results.push({
+                        name: 'Contentful connectivity',
+                        ok: true,
+                        optional: false,
+                        detail: `Connected — ${String(cts.total)} content type(s)`,
+                    });
+                }
+                catch (err) {
+                    results.push({
+                        name: 'Contentful connectivity',
+                        ok: false,
+                        optional: false,
+                        detail: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            // 5. All configured spaces connectivity (optional — informational)
+            if (config) {
+                const allSpaceKeys = Object.keys(config.spaces);
+                if (allSpaceKeys.length > 1) {
+                    for (const key of allSpaceKeys) {
+                        if (key === spaceKey)
+                            continue; // already checked as default
+                        const cfg = config.spaces[key];
+                        if (!cfg)
+                            continue;
+                        try {
+                            const spaceEnv = await createSafeEnvironment(cfg);
+                            const cts = await spaceEnv.getContentTypes();
+                            results.push({
+                                name: `Space: ${key}`,
+                                ok: true,
+                                optional: true,
+                                detail: `Connected — ${String(cts.total)} content type(s)`,
+                            });
+                        }
+                        catch (err) {
+                            results.push({
+                                name: `Space: ${key}`,
+                                ok: false,
+                                optional: true,
+                                detail: err instanceof Error ? err.message : String(err),
+                            });
+                        }
+                    }
+                }
+            }
+            // 6. devBaseUrl configured (optional — needed for preview url / showcase)
+            if (spaceCfg) {
+                if (spaceCfg.devBaseUrl) {
+                    results.push({
+                        name: 'devBaseUrl configured',
+                        ok: true,
+                        optional: true,
+                        detail: spaceCfg.devBaseUrl,
+                    });
+                }
+                else {
+                    results.push({
+                        name: 'devBaseUrl configured',
+                        ok: false,
+                        optional: true,
+                        detail: 'Not set — preview url and preview showcase require devBaseUrl in config',
+                    });
+                }
+            }
+            // Output
+            const requiredFailed = results.filter((r) => !r.ok && !r.optional);
+            const overallOk = requiredFailed.length === 0;
+            if (isJsonMode()) {
+                console.log(JSON.stringify({
+                    ok: overallOk,
+                    spaceKey: spaceKey ?? null,
+                    connected,
+                    checks: results.map((r) => ({
+                        name: r.name,
+                        ok: r.ok,
+                        optional: r.optional,
+                        detail: r.detail,
+                    })),
+                }));
+            }
+            else {
+                console.log(pc.bold('\ncms-edit health\n'));
+                for (const r of results) {
+                    const icon = r.ok ? pc.green('✓') : r.optional ? pc.yellow('~') : pc.red('✗');
+                    const label = r.ok ? pc.green(r.name) : r.optional ? pc.yellow(r.name) : pc.red(r.name);
+                    console.log(`  ${icon} ${label}`);
+                    if (!r.ok || r.optional) {
+                        console.log(`      ${pc.dim(r.detail)}`);
+                    }
+                }
+                console.log('');
+                if (overallOk) {
+                    console.log(pc.green('All required checks passed.\n'));
+                }
+                else {
+                    console.log(pc.red(`${String(requiredFailed.length)} required check(s) failed. Fix the errors above and re-run.\n`));
+                }
+            }
+            if (!overallOk)
+                process.exit(1);
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/commands/health.js.map

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

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

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

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