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

package/dist/commands/snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerSnapshotCommand(program: Command): void;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B9D"}

package/dist/commands/snapshot.js

@@ -0,0 +1,31 @@
+import { loadConfig, resolveSpaceConfig } from '../config/load.js';
+import { createSafeEnvironment } from '../contentful/client.js';
+import { errorMsg } from '../output/print.js';
+import { requireSession } from '../session/store.js';
+import { renderDeepLinkedAssets, renderSnapshot } from '../snapshot/render.js';
+export function registerSnapshotCommand(program) {
+    program
+        .command('snapshot')
+        .alias('tree')
+        .description('Re-print the content tree with @refs and status badges')
+        .option('-c, --compact', 'Compact output — show type labels only, no entry labels or status')
+        .option('--deep', 'Also fetch and show all linked assets (with alt text) across all session entries')
+        .action(async (opts, cmd) => {
+        try {
+            const parentOpts = cmd.parent?.opts() ?? {};
+            const session = await requireSession(parentOpts.session, parentOpts.config);
+            renderSnapshot(session, { compact: opts.compact });
+            if (opts.deep) {
+                const config = loadConfig(parentOpts.config);
+                const { space } = resolveSpaceConfig(config, session.spaceKey);
+                const env = await createSafeEnvironment(space);
+                await renderDeepLinkedAssets(session, env, space.defaultLocale);
+            }
+        }
+        catch (err) {
+            errorMsg(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/commands/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,KAAK,CAAC,MAAM,CAAC;SACb,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,eAAe,EAAE,mEAAmE,CAAC;SAC5F,MAAM,CACL,QAAQ,EACR,kFAAkF,CACnF;SACA,MAAM,CAAC,KAAK,EAAE,IAA2C,EAAE,GAAY,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAyC,IAAI,EAAE,CAAC;YACnF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5E,cAAc,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAEnD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC7C,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC/D,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAC;gBAC/C,MAAM,sBAAsB,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;YAClE,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,CAAC,CAAC;AACP,CAAC"}

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

package/dist/commands/staged-upload.d.ts.map

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

package/dist/commands/staged-upload.js

@@ -0,0 +1,54 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { isJsonMode } from '../output/mode.js';
+import { errorMsg } from '../output/print.js';
+import { getRuntimeContext } from '../runtime/context.js';
+import { createStagedUploadRequest } from '../staged-upload/request.js';
+export function registerStagedUploadCommand(program) {
+    const stagedUpload = program
+        .command('staged-upload')
+        .description('Hosted staged file upload helpers');
+    stagedUpload
+        .command('request')
+        .description('Reserve a staged upload slot and return a presigned uploadUrl + consumeArgs (hosted MCP only).')
+        .requiredOption('--file-name <name>', 'Target file name in Contentful')
+        .requiredOption('--mime <type>', 'MIME type (e.g. image/png)')
+        .option('--byte-length <n>', 'Declared file size in bytes', (v) => Number.parseInt(v, 10))
+        .option('--title <title>', 'Optional asset title for consumeArgs')
+        .action(async (opts) => {
+        const ctx = getRuntimeContext();
+        const userId = ctx?.user?.userId;
+        const store = ctx?.stagedUploadStore;
+        if (!userId || !store) {
+            errorMsg('staged-upload request requires hosted MCP context (authenticated user and Redis staged upload store).');
+            process.exit(1);
+        }
+        try {
+            const result = await createStagedUploadRequest(store, {
+                userId,
+                fileName: opts.fileName,
+                mimeType: opts.mime,
+                byteLength: opts.byteLength,
+                title: opts.title,
+            });
+            if (isJsonMode()) {
+                console.log(JSON.stringify({ ok: true, ...result }));
+                return;
+            }
+            console.log(`uploadId: ${result.uploadId}`);
+            console.log(`uploadUrl: ${result.uploadUrl}`);
+            console.log(`curlCommand: ${result.curlCommand}`);
+            console.log(`consumeArgs: ${JSON.stringify(result.consumeArgs)}`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (isJsonMode()) {
+                console.log(JSON.stringify({ ok: false, error: message }));
+            }
+            else {
+                errorMsg(message);
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=staged-upload.js.map

package/dist/commands/staged-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-upload.js","sourceRoot":"","sources":["../../src/commands/staged-upload.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAGvF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAEpD,YAAY;SACT,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CACV,gGAAgG,CACjG;SACA,cAAc,CAAC,oBAAoB,EAAE,gCAAgC,CAAC;SACtE,cAAc,CAAC,eAAe,EAAE,4BAA4B,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,CAAC,CAAS,EAAE,EAAE,CACxE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CACvB;SACA,MAAM,CAAC,iBAAiB,EAAE,sCAAsC,CAAC;SACjE,MAAM,CACL,KAAK,EAAE,IAA6E,EAAE,EAAE;QACtF,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC;QACjC,MAAM,KAAK,GAAG,GAAG,EAAE,iBAAiB,CAAC;QAErC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACtB,QAAQ,CACN,uGAAuG,CACxG,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE;gBACpD,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;YAEH,IAAI,UAAU,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;gBACrD,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,UAAU,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CACF,CAAC;AACN,CAAC"}

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

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

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

package/dist/commands/version.js

@@ -0,0 +1,17 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { isJsonMode } from '../output/mode.js';
+import { getVersionInfo } from '../version.js';
+export function registerVersionCommand(program) {
+    program
+        .command('version')
+        .description('Print the installed cms-edit version. No session or credentials required.')
+        .action(() => {
+        const info = getVersionInfo();
+        if (isJsonMode()) {
+            console.log(JSON.stringify({ ok: true, ...info }));
+            return;
+        }
+        console.log(`${info.name} ${info.version}`);
+    });
+}
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAGvF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2EAA2E,CAAC;SACxF,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;QAC9B,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/config/data-root.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Root directory for cms-edit local data (content index, content-type cache, etc.).
+ * Override with CMS_EDIT_INDEX_HOME (historical name — applies to all local data paths).
+ */
+export declare function getCmsEditDataRoot(): string;
+//# sourceMappingURL=data-root.d.ts.map

package/dist/config/data-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-root.d.ts","sourceRoot":"","sources":["../../src/config/data-root.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C"}

package/dist/config/data-root.js

@@ -0,0 +1,21 @@
+import * as os from 'node:os';
+function isServerlessRuntime() {
+    return (process.env['VERCEL'] === '1' ||
+        process.env['AWS_LAMBDA_FUNCTION_NAME'] !== undefined ||
+        process.env['LAMBDA_TASK_ROOT'] !== undefined);
+}
+/**
+ * Root directory for cms-edit local data (content index, content-type cache, etc.).
+ * Override with CMS_EDIT_INDEX_HOME (historical name — applies to all local data paths).
+ */
+export function getCmsEditDataRoot() {
+    const configured = process.env['CMS_EDIT_INDEX_HOME']?.trim();
+    if (configured) {
+        return configured;
+    }
+    if (isServerlessRuntime()) {
+        return '/tmp';
+    }
+    return os.homedir();
+}
+//# sourceMappingURL=data-root.js.map

package/dist/config/data-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-root.js","sourceRoot":"","sources":["../../src/config/data-root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,SAAS,mBAAmB;IAC1B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,GAAG;QAC7B,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,KAAK,SAAS;QACrD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,SAAS,CAC9C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,mBAAmB,EAAE,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;AACtB,CAAC"}

package/dist/config/hosted.d.ts

@@ -0,0 +1,36 @@
+import type { ContentfulUserIdentity } from '../runtime/context.js';
+import type { CmsEditConfig, SpaceConfig } from './types.js';
+export interface HostedDeploymentConfig {
+    spaceId: string;
+    environment: string;
+    defaultLocale?: string;
+    devBaseUrl?: string;
+    productionSiteUrl?: string;
+    vercelBypassToken?: string;
+    /**
+     * Preview API token for default index sync (draft content).
+     * Server-side only — avoids per-editor CMA api_keys access for AI Editor roles.
+     */
+    previewAccessToken?: string;
+    /** Content Delivery API token for `index sync --published` and published catalog lookups. */
+    deliveryAccessToken?: string;
+    /** Short key used as defaultSpace in CmsEditConfig */
+    projectKey: string;
+}
+export interface ValidatePatResult extends ContentfulUserIdentity {
+    token: string;
+}
+/**
+ * Validates a Contentful personal access token and returns the owning user.
+ */
+export declare function validateContentfulPat(token: string): Promise<ContentfulUserIdentity>;
+/**
+ * Verifies the PAT can access the expected space (deployment lock).
+ */
+export declare function assertPatSpaceAccess(token: string, expectedSpaceId: string): Promise<void>;
+export declare function validatePatForDeployment(token: string, deployment: HostedDeploymentConfig): Promise<ValidatePatResult>;
+export declare function buildHostedSpaceConfig(deployment: HostedDeploymentConfig, managementToken: string): SpaceConfig;
+export declare function buildHostedConfig(deployment: HostedDeploymentConfig, managementToken: string): CmsEditConfig;
+export declare function loadHostedDeploymentFromEnv(): HostedDeploymentConfig;
+export declare function extractBearerToken(authorizationHeader: string | null): string | null;
+//# sourceMappingURL=hosted.d.ts.map

package/dist/config/hosted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted.d.ts","sourceRoot":"","sources":["../../src/config/hosted.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAe1F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchG;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,sBAAsB,EAClC,eAAe,EAAE,MAAM,GACtB,WAAW,CA0Bb;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,sBAAsB,EAClC,eAAe,EAAE,MAAM,GACtB,aAAa,CAQf;AAED,wBAAgB,2BAA2B,IAAI,sBAAsB,CAuBpE;AAED,wBAAgB,kBAAkB,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIpF"}

package/dist/config/hosted.js

@@ -0,0 +1,113 @@
+import { cmaFetchHeaders } from '../contentful/cma-user-agent.js';
+import { incrementCmaRequests } from '../telemetry/request-stats.js';
+/**
+ * Validates a Contentful personal access token and returns the owning user.
+ */
+export async function validateContentfulPat(token) {
+    incrementCmaRequests();
+    const res = await fetch('https://api.contentful.com/users/me', {
+        headers: cmaFetchHeaders(token),
+    });
+    if (res.status === 401) {
+        throw new Error('Invalid Contentful management token.');
+    }
+    if (!res.ok) {
+        throw new Error(`Contentful API error: ${res.status} ${res.statusText}`);
+    }
+    const user = (await res.json());
+    const email = user.email ?? ([user.firstName, user.lastName].filter(Boolean).join(' ').trim() || user.sys.id);
+    return { userId: user.sys.id, email };
+}
+/**
+ * Verifies the PAT can access the expected space (deployment lock).
+ */
+export async function assertPatSpaceAccess(token, expectedSpaceId) {
+    incrementCmaRequests();
+    const res = await fetch(`https://api.contentful.com/spaces/${expectedSpaceId}`, {
+        headers: cmaFetchHeaders(token),
+    });
+    if (res.status === 401) {
+        throw new Error('Invalid Contentful management token.');
+    }
+    if (res.status === 404) {
+        throw new Error('This token does not have access to the configured Contentful space.');
+    }
+    if (!res.ok) {
+        throw new Error(`Contentful space check failed: ${res.status} ${res.statusText}`);
+    }
+}
+export async function validatePatForDeployment(token, deployment) {
+    const trimmed = token.trim();
+    if (!trimmed) {
+        throw new Error('Contentful management token is required.');
+    }
+    const [user] = await Promise.all([
+        validateContentfulPat(trimmed),
+        assertPatSpaceAccess(trimmed, deployment.spaceId),
+    ]);
+    return { ...user, token: trimmed };
+}
+export function buildHostedSpaceConfig(deployment, managementToken) {
+    const space = {
+        spaceId: deployment.spaceId,
+        environment: deployment.environment,
+        managementToken,
+        defaultLocale: deployment.defaultLocale ?? 'en-US',
+    };
+    if (deployment.devBaseUrl) {
+        space.devBaseUrl = deployment.devBaseUrl;
+    }
+    if (deployment.productionSiteUrl) {
+        space.productionSiteUrl = deployment.productionSiteUrl;
+    }
+    if (deployment.vercelBypassToken) {
+        space.requestParams = {
+            'x-vercel-protection-bypass': deployment.vercelBypassToken,
+            'x-vercel-set-bypass-cookie': 'true',
+        };
+    }
+    if (deployment.previewAccessToken) {
+        space.previewAccessToken = deployment.previewAccessToken;
+    }
+    if (deployment.deliveryAccessToken) {
+        space.deliveryAccessToken = deployment.deliveryAccessToken;
+    }
+    return space;
+}
+export function buildHostedConfig(deployment, managementToken) {
+    const key = deployment.projectKey;
+    return {
+        defaultSpace: key,
+        spaces: {
+            [key]: buildHostedSpaceConfig(deployment, managementToken),
+        },
+    };
+}
+export function loadHostedDeploymentFromEnv() {
+    const spaceId = process.env['CONTENTFUL_SPACE_ID'];
+    const environment = process.env['CONTENTFUL_ENVIRONMENT'] ?? 'master';
+    const projectKey = process.env['CMS_EDIT_PROJECT_KEY'] ?? 'default';
+    if (!spaceId) {
+        throw new Error('CONTENTFUL_SPACE_ID environment variable is required.');
+    }
+    const previewAccessToken = process.env['CONTENTFUL_PREVIEW_ACCESS_TOKEN']?.trim();
+    const deliveryAccessToken = process.env['CONTENTFUL_ACCESS_TOKEN']?.trim();
+    return {
+        spaceId,
+        environment,
+        defaultLocale: process.env['CONTENTFUL_DEFAULT_LOCALE'] ?? 'en-US',
+        devBaseUrl: process.env['DEV_BASE_URL'],
+        productionSiteUrl: process.env['PRODUCTION_SITE_URL'],
+        vercelBypassToken: process.env['VERCEL_BYPASS_TOKEN'],
+        ...(previewAccessToken ? { previewAccessToken } : {}),
+        ...(deliveryAccessToken ? { deliveryAccessToken } : {}),
+        projectKey,
+    };
+}
+export function extractBearerToken(authorizationHeader) {
+    if (!authorizationHeader)
+        return null;
+    const match = /^Bearer\s+(.+)$/i.exec(authorizationHeader.trim());
+    return match?.[1]?.trim() ?? null;
+}
+//# sourceMappingURL=hosted.js.map

package/dist/config/hosted.js.map

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

package/dist/config/load.d.ts

@@ -0,0 +1,27 @@
+import type { CmsEditConfig, SpaceConfig } from './types.js';
+/**
+ * Thrown when no config file can be found or a required environment variable is missing.
+ * Caught in requireSession to skip space validation when the CLI is used outside a project.
+ */
+export declare class ConfigUnavailableError extends Error {
+    constructor(message: string);
+}
+/**
+ * Loads .contentful-cms.json from the given path or searches up from cwd.
+ * Also loads .env.local from cwd (and home dir) for token resolution.
+ *
+ * Config resolution order:
+ *   1. --config <path> flag (explicit)
+ *   2. CMS_EDIT_CONFIG env var (useful for MCP / Claude Desktop env block)
+ *   3. Walk up from cwd
+ *   4. Home directory fallback (~/.contentful-cms.json)
+ */
+export declare function loadConfig(configPath?: string): CmsEditConfig;
+/**
+ * Resolves a specific space config given the config and an optional override key.
+ */
+export declare function resolveSpaceConfig(config: CmsEditConfig, spaceKey?: string): {
+    key: string;
+    space: SpaceConfig;
+};
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAiF7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAWrC"}

package/dist/config/load.js

@@ -0,0 +1,139 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { config as loadDotenv } from 'dotenv';
+import { getRuntimeContext } from '../runtime/context.js';
+/**
+ * Thrown when no config file can be found or a required environment variable is missing.
+ * Caught in requireSession to skip space validation when the CLI is used outside a project.
+ */
+export class ConfigUnavailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigUnavailableError';
+    }
+}
+/**
+ * Resolves ${ENV_VAR} tokens in a string value using process.env.
+ */
+function resolveEnvToken(value) {
+    return value.replace(/\$\{([^}]+)\}/g, (_, key) => {
+        const resolved = process.env[key];
+        if (!resolved) {
+            throw new ConfigUnavailableError(`Environment variable "${key}" is not set. Check your .env.local or shell environment.`);
+        }
+        return resolved;
+    });
+}
+/**
+ * Loads .contentful-cms.json from the given path or searches up from cwd.
+ * Also loads .env.local from cwd (and home dir) for token resolution.
+ *
+ * Config resolution order:
+ *   1. --config <path> flag (explicit)
+ *   2. CMS_EDIT_CONFIG env var (useful for MCP / Claude Desktop env block)
+ *   3. Walk up from cwd
+ *   4. Home directory fallback (~/.contentful-cms.json)
+ */
+export function loadConfig(configPath) {
+    const runtimeConfig = getRuntimeContext()?.config;
+    if (runtimeConfig) {
+        return runtimeConfig;
+    }
+    const cwd = process.cwd();
+    const home = os.homedir();
+    // Load .env.local from cwd and home dir so tokens like ${CMS_EDIT_TOKEN} can be resolved.
+    // Home dir is loaded first (lower priority) so cwd can override.
+    const homeEnvLocal = path.join(home, '.env.local');
+    if (fs.existsSync(homeEnvLocal)) {
+        loadDotenv({ path: homeEnvLocal, override: false, quiet: true });
+    }
+    const envLocalPath = path.join(cwd, '.env.local');
+    if (fs.existsSync(envLocalPath)) {
+        loadDotenv({ path: envLocalPath, override: false, quiet: true });
+    }
+    const envVarConfig = process.env['CMS_EDIT_CONFIG'];
+    const resolvedPath = configPath
+        ? path.resolve(configPath)
+        : envVarConfig
+            ? path.resolve(envVarConfig)
+            : findConfigFile(cwd);
+    if (!resolvedPath) {
+        throw new ConfigUnavailableError('No .contentful-cms.json found. Create one in your project root or home directory, ' +
+            'or set CMS_EDIT_CONFIG=/path/to/.contentful-cms.json (see .contentful-cms.example.json).');
+    }
+    const raw = fs.readFileSync(resolvedPath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    // Resolve env var tokens in all management tokens
+    const resolved = {
+        defaultSpace: parsed.defaultSpace,
+        spaces: {},
+    };
+    for (const [key, space] of Object.entries(parsed.spaces)) {
+        const resolvedRequestHeaders = space.requestHeaders
+            ? Object.fromEntries(Object.entries(space.requestHeaders).map(([k, v]) => [k, resolveEnvToken(v)]))
+            : undefined;
+        const resolvedRequestParams = space.requestParams
+            ? Object.fromEntries(Object.entries(space.requestParams).map(([k, v]) => [k, resolveEnvToken(v)]))
+            : undefined;
+        resolved.spaces[key] = {
+            spaceId: resolveEnvToken(space.spaceId),
+            environment: resolveEnvToken(space.environment),
+            managementToken: resolveEnvToken(space.managementToken),
+            defaultLocale: space.defaultLocale || 'en-US',
+            ...(space.devBaseUrl ? { devBaseUrl: resolveEnvToken(space.devBaseUrl) } : {}),
+            ...(space.productionSiteUrl
+                ? { productionSiteUrl: resolveEnvToken(space.productionSiteUrl) }
+                : {}),
+            ...(resolvedRequestHeaders ? { requestHeaders: resolvedRequestHeaders } : {}),
+            ...(resolvedRequestParams ? { requestParams: resolvedRequestParams } : {}),
+            ...(space.deliveryAccessToken
+                ? { deliveryAccessToken: resolveEnvToken(space.deliveryAccessToken) }
+                : {}),
+            ...(space.deliveryApiKeyName ? { deliveryApiKeyName: space.deliveryApiKeyName } : {}),
+            ...(space.autoCreateDeliveryApiKey !== undefined
+                ? { autoCreateDeliveryApiKey: space.autoCreateDeliveryApiKey }
+                : {}),
+            ...(space.previewAccessToken
+                ? { previewAccessToken: resolveEnvToken(space.previewAccessToken) }
+                : {}),
+        };
+    }
+    return resolved;
+}
+/**
+ * Resolves a specific space config given the config and an optional override key.
+ */
+export function resolveSpaceConfig(config, spaceKey) {
+    const key = spaceKey ?? config.defaultSpace ?? Object.keys(config.spaces)[0];
+    if (!key) {
+        throw new Error('No space configured in .contentful-cms.json');
+    }
+    const space = config.spaces[key];
+    if (!space) {
+        const available = Object.keys(config.spaces).join(', ');
+        throw new Error(`Space "${key}" not found in config. Available: ${available}`);
+    }
+    return { key, space };
+}
+/**
+ * Walk up the directory tree from start to find .contentful-cms.json.
+ * Falls back to the home directory if not found along the path.
+ */
+function findConfigFile(start) {
+    let current = start;
+    while (true) {
+        const candidate = path.join(current, '.contentful-cms.json');
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    // Home directory fallback — useful when launched by MCP servers (e.g. Claude Desktop)
+    // where the working directory is unrelated to the user's project.
+    const homeCandidate = path.join(os.homedir(), '.contentful-cms.json');
+    return fs.existsSync(homeCandidate) ? homeCandidate : null;
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,42 @@
+export interface SpaceConfig {
+    spaceId: string;
+    environment: string;
+    managementToken: string;
+    defaultLocale: string;
+    /** Base URL of the local dev server for this space (preview url, preview showcase). e.g. "http://localhost:3013" */
+    devBaseUrl?: string;
+    /** Canonical production URL (no trailing slash). Used by `preview urls` for the production target. */
+    productionSiteUrl?: string;
+    /**
+     * HTTP headers injected into devBaseUrl requests (e.g. cms-capture-screenshots via agent-browser).
+     * Useful for deployment protection bypass that requires a header rather than a query param.
+     * Values support ${ENV_VAR} token syntax.
+     * Example: { "x-custom-header": "${CUSTOM_TOKEN}" }
+     */
+    requestHeaders?: Record<string, string>;
+    /**
+     * Query parameters appended to devBaseUrl requests (preview url, preview showcase, cms-capture-screenshots).
+     * Useful for Vercel deployment protection bypass: { "x-vercel-protection-bypass": "${VERCEL_BYPASS_TOKEN}" }
+     * Values support ${ENV_VAR} token syntax.
+     */
+    requestParams?: Record<string, string>;
+    /**
+     * Content Delivery API token for `index sync --published` (optional).
+     * Supports ${ENV_VAR} syntax. When unset, resolved via CMA API keys at sync time.
+     */
+    deliveryAccessToken?: string;
+    /** Prefer a delivery API key with this name from space.getApiKeys(). */
+    deliveryApiKeyName?: string;
+    /** When true and no matching key exists, create a cms-edit-index delivery key (requires PAT permissions). Used with `--published` sync only. */
+    autoCreateDeliveryApiKey?: boolean;
+    /**
+     * Preview API token for default `index sync` (draft content).
+     * Supports ${ENV_VAR} syntax. When unset, resolved from the linked preview key at sync time.
+     */
+    previewAccessToken?: string;
+}
+export interface CmsEditConfig {
+    defaultSpace?: string;
+    spaces: Record<string, SpaceConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,oHAAoH;IACpH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gJAAgJ;IAChJ,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC"}

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/contentful/article-tags-from-json.d.ts

@@ -0,0 +1,25 @@
+export interface ArticleTagsItem {
+    articleSlug: string;
+    tagSlugs: string[];
+    append?: boolean;
+}
+export interface ArticleTagsResult {
+    articleSlug: string;
+    articleId?: string;
+    tagSlugs: string[];
+    status: 'updated' | 'unchanged' | 'dry-run' | 'failed';
+    message?: string;
+}
+export interface ArticleTagsBatchResult {
+    results: ArticleTagsResult[];
+    /** False when one or more items failed (others may still have succeeded). */
+    ok: boolean;
+}
+export interface ArticleTagsFromJsonOptions {
+    items: ArticleTagsItem[];
+    dryRun?: boolean;
+    configPath?: string;
+    spaceKey?: string;
+}
+export declare function runArticleTagsFromJson(opts: ArticleTagsFromJsonOptions): Promise<ArticleTagsBatchResult>;
+//# sourceMappingURL=article-tags-from-json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"article-tags-from-json.d.ts","sourceRoot":"","sources":["../../src/contentful/article-tags-from-json.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkHD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAyBjC"}