@contentful/experience-design-system-cli 2.26.1-dev-build-a852362.0 → 2.26.1-dev-build-f03f014.0

package/dist/src/import/tui/wizard-422-helpers.js

@@ -1,60 +0,0 @@
-import { parsePreviewValidationErrors } from '../../apply/api-client.js';
-import { patchReviewStateWithValidationErrors, rejectComponentsByName } from '../../analyze/select/command.js';
-/**
- * Decide what to do with an `ApiError` raised by `previewImport()`.
- * Returns `not-422` if the caller should fall through to its other branches
- * (404 / 401 / 403 / generic), `unparseable` if the body cannot be parsed
- * into structured component-level errors (caller should route to the generic
- * error step), or `validation-error` with the patched-state side effects
- * already applied.
- *
- * Pure decision logic + a single delegated side effect to
- * `patchReviewStateWithValidationErrors`. Extracted from `WizardApp.runPreview`
- * so the routing is unit-testable without driving the full TUI.
- */
-export async function handlePreview422(err, extractSessionId, patchFn = patchReviewStateWithValidationErrors) {
-    if (err.status !== 422)
-        return { kind: 'not-422' };
-    const errors = parsePreviewValidationErrors(err.body);
-    if (errors.length === 0)
-        return { kind: 'unparseable', message: err.message };
-    let missingNames = [];
-    if (extractSessionId) {
-        const result = await patchFn(extractSessionId, errors);
-        missingNames = result.missingNames;
-    }
-    return { kind: 'validation-error', errors, missingNames };
-}
-/**
- * The WizardState patch the wizard should spread into any update that
- * transitions OUT of the preview-validation-error step (e.g. into
- * preview-gate after a successful retry). Without this, the validation-error
- * arrays linger in state and any future code path that reads them sees stale
- * data from a prior failed attempt.
- */
-export function clearedValidationErrorState() {
-    return {
-        previewValidationErrors: [],
-        previewValidationMissingNames: [],
-    };
-}
-/**
- * Run the "skip and retry" side effect: dedup the offending component
- * names from a list of errors and call `rejectComponentsByName`. Returns
- * the deduped names so the caller can log them or include them in test
- * assertions. No-op when sessionId is null or errors are empty.
- *
- * The DB update inside `rejectComponentsByName` is what makes the next
- * preview see a manifest with the offenders excluded — see SP-3 retro
- * Bug 1: writing to the JSON state file alone is not enough because
- * `loadCDFComponents` reads from the pipeline DB.
- */
-export async function applySkipValidationErrors(sessionId, errors, rejectFn = rejectComponentsByName) {
-    if (!sessionId)
-        return [];
-    const names = [...new Set(errors.map((e) => e.componentName))];
-    if (names.length === 0)
-        return [];
-    await rejectFn(sessionId, names);
-    return names;
-}

package/dist/src/import/tui/wizard-generate-progress.js

@@ -1,25 +0,0 @@
-const PROGRESS_LINE = /^progress=generate:(\d+)\/(\d+):(.+)$/;
-const LEGACY_LINE = /\[(\d+)\/(\d+)\]\s+(.+)/;
-export function parseGenerateStderrChunk(chunk, prev) {
-    let state = prev;
-    for (const line of chunk.split('\n')) {
-        const progressMatch = PROGRESS_LINE.exec(line);
-        if (progressMatch) {
-            state = {
-                done: Number(progressMatch[1]),
-                total: Number(progressMatch[2]),
-                current: progressMatch[3].trim(),
-            };
-            continue;
-        }
-        const legacyMatch = LEGACY_LINE.exec(line);
-        if (legacyMatch) {
-            state = {
-                done: state?.done ?? 0,
-                total: Number(legacyMatch[2]),
-                current: legacyMatch[3].trim(),
-            };
-        }
-    }
-    return state;
-}

package/dist/src/import/tui/wizard-save-flow.js

@@ -1,20 +0,0 @@
-import { appendRun } from '../../runs/store.js';
-import { resolveSavePath } from '../../runs/save-path-resolver.js';
-export async function planSaveFlow(input) {
-    if (input.outDirOverride) {
-        if (input.onConflict) {
-            const resolved = await resolveSavePath(input.outDirOverride, { onConflict: input.onConflict });
-            if (resolved.kind === 'write')
-                return { kind: 'write', path: resolved.path };
-            if (resolved.kind === 'fail')
-                return { kind: 'fail', conflict: resolved.conflict };
-            // `no-conflict` / `conflict` never come back when onConflict is set.
-            return { kind: 'write', path: input.outDirOverride };
-        }
-        return { kind: 'write', path: input.outDirOverride };
-    }
-    return { kind: 'prompt', defaultPath: input.defaultPath };
-}
-export async function recordRunAfterSave(input) {
-    return appendRun(input);
-}

package/dist/src/import/tui/wizard-state-transitions.js

@@ -1,32 +0,0 @@
-export function nextStepAfterScopeGate(opts) {
-    if (opts.acceptedCount > 0) {
-        return opts.noPush ? 'generating' : 'credentials';
-    }
-    return opts.noPush ? 'print-gate' : 'credentials';
-}
-export function nextStepAfterCredentialsValidated(opts) {
-    return opts.acceptedCount > 0 ? 'generating' : 'push-decision-gate';
-}
-export function shouldSkipFinalReviewAfterCredentials(state) {
-    return state.finalReviewPassed && state.generateSessionId != null;
-}
-export function resolveNoCacheForGenerate(opts) {
-    return opts.cliNoCache;
-}
-export function shouldBypassPreview(state) {
-    return state.credentialsSkipped === true;
-}
-export function buildSkippedPreviewTransition() {
-    return { step: 'push-decision-gate', serverPreview: null };
-}
-export function resolveCycleGateAction(opts) {
-    if (!opts.hasCycles)
-        return 'proceed';
-    return opts.autoRejectCycles ? 'auto-reject' : 'block';
-}
-export function shouldRefusePush(state) {
-    return state.credentialsSkipped === true;
-}
-export function buildSkippedPushTransition() {
-    return { step: 'print-gate' };
-}

package/dist/src/lib/agent-model-options.js

@@ -1,15 +0,0 @@
-import { AGENT_NAMES } from '@contentful/experience-design-system-generation';
-export const AGENT_DESCRIPTION = `Agent to use: ${AGENT_NAMES.join(', ')} (defaults to value saved by experiences setup)`;
-export const MODEL_DESCRIPTION = 'Model to use (defaults to a lightweight per-agent model; override with EDS_AGENT_MODEL_<AGENT>)';
-/**
- * Register --agent and optionally --model flags to a Commander command, with customizable descriptions.
- * Pass `includeModel: false` for commands where the model dimension is not applicable (e.g., mapping-resolution agents that select an agent for logic, not model choice).
- */
-export function addAgentModelOptions(cmd, config = {}) {
-    const { agentDescription = AGENT_DESCRIPTION, includeModel = true, modelDescription = MODEL_DESCRIPTION } = config;
-    cmd.option('--agent <name>', agentDescription);
-    if (includeModel) {
-        cmd.option('--model <name>', modelDescription);
-    }
-    return cmd;
-}

package/dist/src/lib/command-options.js

@@ -1,30 +0,0 @@
-export function addArtifactInputOptions(cmd) {
-    return cmd
-        .option('--components <path>', 'Path to components.json (CDF)')
-        .option('--tokens <path>', 'Path to tokens.json (DTCG)')
-        .option('--session <id>', 'Pipeline session ID to load generated components from');
-}
-export function addContentfulTargetOptions(cmd) {
-    return cmd
-        .requiredOption('--space-id <id>', 'Contentful space ID')
-        .requiredOption('--environment-id <id>', 'Contentful environment ID')
-        .option('--cma-token <token>', 'CMA personal access token (or set CONTENTFUL_MANAGEMENT_TOKEN)')
-        .option('--host <url>', 'Override API base URL');
-}
-export function addCompositionOptions(cmd) {
-    return cmd
-        .option('--composite', 'Import embedded-component hierarchy (opt in; default is atomic)')
-        .option('--atomic', 'Import flat components with no embedded-component hierarchy (default)');
-}
-function collectOptionValue(value, previous) {
-    return [...previous, value];
-}
-export function addSelectionOptions(cmd) {
-    return cmd
-        .option('--select-all', 'Select all entities without launching TUI')
-        .option('--select <pattern>', 'Select entities by ID pattern (repeatable)', collectOptionValue, [])
-        .option('--deselect <pattern>', 'Deselect entities by ID pattern (repeatable)', collectOptionValue, []);
-}
-export function addAllowDeletionsOption(cmd) {
-    return cmd.option('--allow-deletions', 'Allow the push to delete remote ComponentTypes/DesignTokens missing from the manifest (default: skip them)');
-}

package/dist/src/lib/composition-mode.js

@@ -1,39 +0,0 @@
-export const COMPOSITION_MODES = ['composite', 'atomic'];
-export function isCompositionMode(value) {
-    return COMPOSITION_MODES.includes(value);
-}
-function hasCompositionSource(opts) {
-    return !!opts.compositionMap || !!opts.compositionAgent || !!opts.compositionRefresh || !!opts.generateMap;
-}
-/**
- * Resolve the effective composition mode with precedence
- * `explicit flag > implied source > env > persisted config > default`.
- * Default is `atomic` (composition OFF); `--composite` opts into the hierarchy
- * machinery.
- *
- * `--atomic` is accepted for symmetry and wins when passed — even alongside a
- * composition source, since it's an explicit "no" that overrides the implicit
- * opt-in. If both `--composite` and `--atomic` are present, `--composite`
- * wins. Passing a composition source (`--composition-map/-agent`,
- * `--composition-refresh`, or `--generate-map`) implies composite without a
- * separate `--composite`.
- */
-export function resolveCompositionMode(opts, configMode) {
-    if (opts.composite)
-        return 'composite';
-    if (opts.atomic)
-        return 'atomic';
-    // A composition source is an explicit opt-in for this invocation — it beats
-    // env/config, but not an explicit --atomic (handled above).
-    if (hasCompositionSource(opts))
-        return 'composite';
-    const env = process.env['EXPERIENCES_COMPOSITION_MODE'];
-    if (env !== undefined && env !== '') {
-        const v = env.toLowerCase();
-        if (isCompositionMode(v))
-            return v;
-    }
-    if (configMode && isCompositionMode(configMode))
-        return configMode;
-    return 'atomic';
-}

package/dist/src/lib/contentful-urls.js

@@ -1,27 +0,0 @@
-/**
- * Shared Contentful webapp URL builders.
- *
- * The wizard's `done` step and the `experiences import` orchestrator both used
- * to inline the same post-push URL formatter. This module centralizes that
- * formatter so the wizard, `apply push`, and `apply select` all emit the same
- * URL shape.
- */
-function normalizeHost(host) {
-    return host
-        .trim()
-        .replace(/^https?:\/\//i, '')
-        .replace(/\/+$/, '');
-}
-/**
- * Map a Contentful API host to the corresponding webapp host. For api.*.com
- * inputs this swaps the `api.` prefix to `app.`; any other host is returned
- * as-is (callers get the raw host, no guessing).
- */
-export function apiHostToAppHost(host) {
-    const normalized = normalizeHost(host);
-    return normalized.replace(/^api\./, 'app.');
-}
-export function buildPostPushUrl({ host, spaceId, environmentId, view = 'components' }) {
-    const appHost = apiHostToAppHost(host);
-    return `https://${appHost}/spaces/${spaceId}/environments/${environmentId}/views/${view}`;
-}

package/dist/src/lib/debug-logger.js

@@ -1,229 +0,0 @@
-import { mkdirSync, appendFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { homedir } from 'node:os';
-// ── Redaction ────────────────────────────────────────────────────────────────
-// Blocklist of secret-shaped keys; matched case-insensitively.
-const SECRET_KEY_PATTERNS = [
-    /token/i,
-    /secret/i,
-    /password/i,
-    /authorization/i,
-    /^auth$/i,
-    /apikey/i,
-    /api_key/i,
-    /credential/i,
-    /bearer/i,
-    /^cma$/i,
-    /cmaToken/i,
-];
-// Value-side patterns for strings that look like tokens even under innocuous keys.
-const SECRET_VALUE_PATTERNS = [
-    /^Bearer\s+\S+/i,
-    /CFPAT-[A-Za-z0-9_-]{20,}/,
-    /sk-[A-Za-z0-9_-]{20,}/,
-    /xox[baprs]-[A-Za-z0-9-]{10,}/,
-];
-const REDACTED = '«redacted»';
-const MAX_STRING_LEN = 4000;
-function redactValue(value, seen) {
-    if (value === null || value === undefined)
-        return value;
-    if (typeof value === 'string') {
-        if (SECRET_VALUE_PATTERNS.some((r) => r.test(value)))
-            return REDACTED;
-        return value.length > MAX_STRING_LEN
-            ? value.slice(0, MAX_STRING_LEN) + `…«+${value.length - MAX_STRING_LEN}»`
-            : value;
-    }
-    if (typeof value !== 'object')
-        return value;
-    if (seen.has(value))
-        return '«cycle»';
-    seen.add(value);
-    if (Array.isArray(value))
-        return value.map((v) => redactValue(v, seen));
-    const out = {};
-    for (const [k, v] of Object.entries(value)) {
-        if (SECRET_KEY_PATTERNS.some((r) => r.test(k))) {
-            out[k] = REDACTED;
-        }
-        else {
-            out[k] = redactValue(v, seen);
-        }
-    }
-    return out;
-}
-export function redactForDebug(payload) {
-    return redactValue(payload, new WeakSet());
-}
-// ── Path resolution ──────────────────────────────────────────────────────────
-const DEBUG_ROOT_ENV = 'EDSI_DEBUG_ROOT';
-const DEBUG_LOG_ENV = 'EDSI_DEBUG_LOG';
-function defaultDebugRoot() {
-    return process.env[DEBUG_ROOT_ENV] ?? join(homedir(), '.contentful', 'experience-design-system-cli', 'debug');
-}
-// Session timestamp source. Deterministic-friendly: honors EDSI_DEBUG_TS for tests.
-function makeSessionTimestamp() {
-    const override = process.env['EDSI_DEBUG_TS'];
-    if (override)
-        return override;
-    const now = new Date();
-    const pad = (n, w = 2) => n.toString().padStart(w, '0');
-    return (`${now.getUTCFullYear()}${pad(now.getUTCMonth() + 1)}${pad(now.getUTCDate())}` +
-        `T${pad(now.getUTCHours())}${pad(now.getUTCMinutes())}${pad(now.getUTCSeconds())}Z`);
-}
-// ── Singleton ───────────────────────────────────────────────────────────────
-let singleton = null;
-class NoopDebugLogger {
-    enabled = false;
-    path = null;
-    event() {
-        /* no-op */
-    }
-}
-class FileDebugLogger {
-    enabled = true;
-    path;
-    sessionStart;
-    constructor(path) {
-        this.path = path;
-        this.sessionStart = Date.now();
-        mkdirSync(dirname(path), { recursive: true });
-        // Header event — records the process context.
-        this.write({
-            ts: new Date().toISOString(),
-            category: 'config',
-            name: 'session.open',
-            pid: process.pid,
-            ppid: process.ppid,
-            cwd: process.cwd(),
-            argv: process.argv.slice(1),
-            node: process.version,
-            platform: process.platform,
-        });
-    }
-    event(category, name, payload = {}) {
-        const redacted = redactForDebug(payload);
-        this.write({
-            ts: new Date().toISOString(),
-            elapsedMs: Date.now() - this.sessionStart,
-            category,
-            name,
-            pid: process.pid,
-            ...redacted,
-        });
-    }
-    write(record) {
-        try {
-            appendFileSync(this.path, JSON.stringify(record) + '\n', { encoding: 'utf8' });
-        }
-        catch {
-            // Debug logging must never crash the CLI. Swallow.
-        }
-    }
-}
-/**
- * Initialize the process-wide debug logger. Safe to call multiple times —
- * subsequent calls return the existing instance.
- *
- * If EDSI_DEBUG_LOG is already set in the environment, this process joins
- * that log file (used by spawned subprocesses so a whole `experiences import`
- * flow lands in a single file).
- */
-export function initDebugLogger(opts) {
-    if (singleton)
-        return singleton;
-    // Inherited from parent process — always join the existing file, regardless
-    // of the local flag/env decision. Parent already made the choice.
-    const inherited = process.env[DEBUG_LOG_ENV];
-    if (inherited) {
-        singleton = new FileDebugLogger(inherited);
-        if (opts.command)
-            singleton.event('config', 'subprocess.start', { command: opts.command });
-        return singleton;
-    }
-    if (!opts.enabled) {
-        singleton = new NoopDebugLogger();
-        return singleton;
-    }
-    const root = opts.root ?? defaultDebugRoot();
-    const ts = makeSessionTimestamp();
-    const suffix = opts.command ? `-${opts.command}` : '';
-    const path = join(root, `${ts}${suffix}.jsonl`);
-    singleton = new FileDebugLogger(path);
-    process.env[DEBUG_LOG_ENV] = path; // propagate to spawned children
-    if (opts.command)
-        singleton.event('config', 'command.start', { command: opts.command });
-    // Emit a close event on process exit. Best-effort — writeFileSync-based, so
-    // it works from within an 'exit' handler.
-    process.on('exit', (code) => {
-        if (singleton && singleton.enabled) {
-            singleton.event('config', 'session.close', { exitCode: code });
-        }
-    });
-    return singleton;
-}
-export function getDebugLogger() {
-    return singleton ?? new NoopDebugLogger();
-}
-/** Test-only: reset the singleton. */
-export function __resetDebugLoggerForTest() {
-    singleton = null;
-    delete process.env[DEBUG_LOG_ENV];
-}
-// ── Resolver ────────────────────────────────────────────────────────────────
-/**
- * Resolve effective debug-mode setting from three sources.
- *
- * Precedence (highest first):
- *   1. `--debug` / `--no-debug` CLI flag
- *   2. `EDSI_DEBUG` env var (truthy: 1, true, yes, on)
- *   3. Persisted `debug` field in credentials.json
- *   4. Default: OFF
- */
-export function resolveDebugMode(opts, configDebug) {
-    if (opts.debug !== undefined)
-        return opts.debug;
-    const env = process.env['EDSI_DEBUG'];
-    if (env !== undefined && env !== '') {
-        const v = env.toLowerCase();
-        if (v === '1' || v === 'true' || v === 'yes' || v === 'on')
-            return true;
-        if (v === '0' || v === 'false' || v === 'no' || v === 'off')
-            return false;
-    }
-    if (configDebug !== undefined)
-        return configDebug;
-    return false;
-}
-// ── Bright-green banner ─────────────────────────────────────────────────────
-/**
- * Emit the bright-green "debug logs at <path>" banner to stderr.
- * No-op when debug is disabled or stderr is not a TTY-friendly stream.
- * Callers should invoke this once at start and once at end of the command.
- */
-export function printDebugBanner(logger, phase) {
-    if (!logger.enabled || !logger.path)
-        return;
-    const prefix = phase === 'start' ? '\x1b[92m[debug]\x1b[0m ' : '\x1b[92m[debug]\x1b[0m ';
-    const label = phase === 'start' ? 'debug logs at' : 'debug logs written to';
-    // Bright green (92) + bold (1); reset with 0.
-    const line = `${prefix}\x1b[1m\x1b[92m${label} ${logger.path}\x1b[0m\n`;
-    try {
-        process.stderr.write(line);
-    }
-    catch {
-        /* ignore */
-    }
-}
-/** Directory that contains the current process's debug log, if any. */
-export function debugLogPath() {
-    return singleton?.path ?? process.env[DEBUG_LOG_ENV] ?? null;
-}
-/** Ensure spawned children join the same debug log by including EDSI_DEBUG_LOG in their env. */
-export function debugEnvForSubprocess(env = process.env) {
-    const path = debugLogPath();
-    if (!path)
-        return env;
-    return { ...env, [DEBUG_LOG_ENV]: path };
-}

package/dist/src/lib/debug-preamble.js

@@ -1,33 +0,0 @@
-import { initDebugLogger, printDebugBanner, resolveDebugMode } from './debug-logger.js';
-import { readExperiencesCredentials } from '../credentials-store.js';
-let endBannerRegistered = false;
-/**
- * Preamble every top-level command action should call before doing work.
- *
- * Resolves the effective debug decision (flag > env > persisted config),
- * initializes the singleton, and prints the bright-green start banner.
- * Registers a process-exit handler that prints the end banner once.
- *
- * Returns the logger so the caller can emit events without a second import.
- * When debug is disabled, the returned logger is a no-op.
- */
-export async function beginCommand(command, opts) {
-    let configDebug;
-    try {
-        const creds = await readExperiencesCredentials();
-        configDebug = creds.debug;
-    }
-    catch {
-        // Missing credentials.json is fine — the resolver falls through to default OFF.
-    }
-    const enabled = resolveDebugMode(opts, configDebug);
-    const logger = initDebugLogger({ enabled, command });
-    if (logger.enabled) {
-        printDebugBanner(logger, 'start');
-        if (!endBannerRegistered) {
-            endBannerRegistered = true;
-            process.on('exit', () => printDebugBanner(logger, 'end'));
-        }
-    }
-    return logger;
-}