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

package/dist/src/lib/error-parser.js

@@ -1,269 +0,0 @@
-const LAMBDA_LOG_PREFIX_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z\s+[0-9a-f-]+\s+ERROR\s+(?:\[dd\.[^\]]*\]\s*)?/;
-const DD_TAG_RE = /\[dd\.(?:trace_id|span_id)=[^\]]*\]\s*/g;
-export function stripLambdaLogPrefix(body) {
-    let out = body.replace(LAMBDA_LOG_PREFIX_RE, '');
-    out = out.replace(DD_TAG_RE, '');
-    return out.trim();
-}
-function parseObjectLiteralTail(body) {
-    const braceStart = body.lastIndexOf('{');
-    if (braceStart === -1)
-        return null;
-    const tail = body.slice(braceStart);
-    const codeMatch = tail.match(/code:\s*['"]([^'"]+)['"]/);
-    const cycleMatch = tail.match(/cycle:\s*\[\s*([^\]]*)\s*\]/);
-    if (!codeMatch && !cycleMatch)
-        return null;
-    const code = codeMatch ? codeMatch[1] : null;
-    let cycle = null;
-    if (cycleMatch) {
-        cycle = cycleMatch[1]
-            .split(',')
-            .map((s) => s.trim().replace(/^['"]|['"]$/g, ''))
-            .filter((s) => s.length > 0);
-        if (cycle.length === 0)
-            cycle = null;
-    }
-    return { code, cycle };
-}
-function asRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value)
-        ? value
-        : null;
-}
-function displayValue(value) {
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'number' || typeof value === 'boolean')
-        return String(value);
-    if (value === null || value === undefined)
-        return null;
-    try {
-        return JSON.stringify(value);
-    }
-    catch {
-        return null;
-    }
-}
-function isPathSegment(value) {
-    return typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));
-}
-function formatPath(value) {
-    if (isPathSegment(value))
-        return String(value) ? { path: String(value) } : { path: null };
-    if (Array.isArray(value)) {
-        const parts = value.filter(isPathSegment);
-        return parts.length > 0 ? { path: parts.join(' › ') } : { path: null };
-    }
-    return {};
-}
-function componentFromPath(path) {
-    if (!path)
-        return undefined;
-    const manifestMatch = path.match(/manifest:components\/([^/›]+)/);
-    if (manifestMatch?.[1])
-        return manifestMatch[1];
-    const parts = path
-        .split(/[›/]/)
-        .map((part) => part.trim())
-        .filter(Boolean);
-    const componentsIndex = parts.findIndex((part) => part === 'components');
-    return componentsIndex === -1 ? undefined : parts[componentsIndex + 1];
-}
-function diagnosticMessage(error) {
-    const candidates = [
-        ['message', error.message],
-        ['details', error.details],
-        ['error', error.error],
-        ['name', error.name],
-    ];
-    for (const [messageSource, value] of candidates) {
-        const message = displayValue(value);
-        if (message !== null)
-            return { message, messageSource };
-    }
-    return { message: 'Validation failed' };
-}
-function parseValidationDiagnostics(details) {
-    if (!Array.isArray(details.errors))
-        return [];
-    const diagnostics = [];
-    for (const rawError of details.errors) {
-        const error = asRecord(rawError);
-        if (!error)
-            continue;
-        const location = formatPath(error.path);
-        const component = displayValue(error.component ?? error.componentName ?? error.componentId) ?? componentFromPath(location.path);
-        diagnostics.push({ ...diagnosticMessage(error), ...location, ...(component ? { component } : {}) });
-    }
-    return diagnostics;
-}
-function parseJsonBody(body) {
-    let parsed;
-    try {
-        parsed = JSON.parse(body);
-    }
-    catch {
-        return null;
-    }
-    const p = asRecord(parsed);
-    if (!p)
-        return null;
-    const details = asRecord(p.details) ?? {};
-    const pick = (k) => (p[k] !== undefined ? p[k] : details[k]);
-    const codeRaw = pick('code') ?? asRecord(p.sys)?.id;
-    const messageRaw = pick('message');
-    const cycleRaw = pick('cycle');
-    const out = {};
-    if (typeof codeRaw === 'string')
-        out.code = codeRaw;
-    if (typeof messageRaw === 'string')
-        out.message = messageRaw;
-    if (Array.isArray(cycleRaw)) {
-        const strs = cycleRaw.filter((x) => typeof x === 'string');
-        if (strs.length > 0)
-            out.cycle = strs;
-    }
-    const diagnostics = parseValidationDiagnostics(details);
-    if (diagnostics.length > 0)
-        out.diagnostics = diagnostics;
-    return out;
-}
-function parseBindingDiagnostics(body) {
-    if (!/binding configurations are invalid|Pointer path does not exist/i.test(body))
-        return null;
-    const locationMatches = [...body.matchAll(/(?:^|\.\s)([A-Za-z0-9_$-]+(?:\s*›\s*[A-Za-z0-9_$-]+){2,})/g)];
-    const location = locationMatches.at(-1)?.[1];
-    const pointerMessage = body.match(/Pointer path does not exist for '\[object Object\]':\s*(.+?)(?=\.\s*Default\s*›|$)/i)?.[1];
-    const graphQlMessage = body.match(/return GraphQL validation error:\s*(.+?)(?=\.\s*Default\s*›|$)/i)?.[1];
-    const heading = body.match(/^(.*?)(?=\.?\s*Pointer path does not exist|\.?\s*Default\s*›)/i)?.[1]?.trim();
-    const diagnostics = [];
-    if (pointerMessage)
-        diagnostics.push({ message: pointerMessage.trim(), ...(location ? { path: location } : {}) });
-    if (graphQlMessage)
-        diagnostics.push({ message: graphQlMessage.trim(), ...(location ? { path: location } : {}) });
-    return {
-        code: 'BindingValidationFailed',
-        message: heading || 'One or more binding configurations are invalid.',
-        ...(diagnostics.length > 0 ? { diagnostics } : {}),
-    };
-}
-// ApiError.message shape: `${phasePrefix}\n${body}` where phasePrefix looks
-// like `apply failed: 400`, `preview failed: 422`, `poll failed: 500`. We
-// only strip the prefix line when the first line matches this shape —
-// otherwise a raw body that happens to contain a newline (e.g. a Lambda log
-// spill with a multi-line object literal) gets truncated mid-structure.
-const API_ERROR_PREFIX_RE = /^(?:apply|preview|poll) failed: \d+$/;
-export function parseEdsiError(rawInput) {
-    if (!rawInput)
-        return { code: null, message: '', cycle: null, raw: true };
-    const nlIndex = rawInput.indexOf('\n');
-    let body = rawInput;
-    let prefix = '';
-    if (nlIndex !== -1) {
-        const firstLine = rawInput.slice(0, nlIndex);
-        if (API_ERROR_PREFIX_RE.test(firstLine)) {
-            prefix = firstLine;
-            body = rawInput.slice(nlIndex + 1);
-        }
-    }
-    const cleaned = stripLambdaLogPrefix(body);
-    const json = parseJsonBody(cleaned) ?? parseJsonBody(body);
-    const bindingFromJson = typeof json?.message === 'string' ? parseBindingDiagnostics(json.message) : null;
-    if (bindingFromJson) {
-        return {
-            code: bindingFromJson.code ?? json?.code ?? null,
-            message: bindingFromJson.message ?? cleaned,
-            cycle: null,
-            raw: false,
-            ...(bindingFromJson.diagnostics ? { diagnostics: bindingFromJson.diagnostics } : {}),
-        };
-    }
-    if (json && (json.code || json.message || json.cycle)) {
-        return {
-            code: json.code ?? null,
-            message: json.message ?? (cleaned || prefix),
-            cycle: json.cycle ?? null,
-            raw: false,
-            ...(json.diagnostics ? { diagnostics: json.diagnostics } : {}),
-        };
-    }
-    const binding = parseBindingDiagnostics(cleaned);
-    if (binding) {
-        return {
-            code: binding.code ?? null,
-            message: binding.message ?? cleaned,
-            cycle: null,
-            raw: false,
-            ...(binding.diagnostics ? { diagnostics: binding.diagnostics } : {}),
-        };
-    }
-    const literal = parseObjectLiteralTail(cleaned);
-    if (literal && (literal.code || literal.cycle)) {
-        const braceStart = cleaned.lastIndexOf('{');
-        const head = braceStart === -1 ? cleaned : cleaned.slice(0, braceStart).trim();
-        return {
-            code: literal.code ?? null,
-            message: head || cleaned,
-            cycle: literal.cycle ?? null,
-            raw: false,
-        };
-    }
-    return { code: null, message: cleaned || prefix || rawInput, cycle: null, raw: true };
-}
-export function formatParsedEdsiError(parsed, opts = {}) {
-    const lines = [];
-    if (parsed.code) {
-        lines.push(`[${parsed.code}]`);
-    }
-    if (parsed.message) {
-        lines.push(parsed.message);
-    }
-    for (const diagnostic of parsed.diagnostics ?? []) {
-        const context = [
-            diagnostic.component ? `Component: ${diagnostic.component}` : null,
-            diagnostic.path ? `Path: ${diagnostic.path}` : null,
-        ].filter(Boolean);
-        lines.push(`- ${diagnostic.message}${context.length > 0 ? ` (${context.join('; ')})` : ''}`);
-        if (diagnostic.path === null) {
-            lines.push('  Location: not provided by the server. Review the submitted manifest; no component or field was identified.');
-        }
-        if (opts.verbose && diagnostic.messageSource) {
-            lines.push(`  Message field: ${diagnostic.messageSource}`);
-        }
-    }
-    if (parsed.code === 'BindingValidationFailed') {
-        const location = parsed.diagnostics?.find((diagnostic) => diagnostic.path)?.path;
-        lines.push(location
-            ? `Next action: review the binding at ${location} and correct its pointer or GraphQL selection.`
-            : 'Next action: review the binding pointer and GraphQL selection.');
-    }
-    if (parsed.code === 'AccessDenied') {
-        lines.push('Next action: this operation requires DesignToken and Component permissions in this environment. Ask a Contentful admin to grant both on your role.');
-    }
-    if (parsed.code === 'NotFound') {
-        lines.push('Next action: verify the resource id is correct. If it should exist, your role may lack read permission on DesignToken or Component.');
-    }
-    if (parsed.cycle && parsed.cycle.length > 0) {
-        lines.push(`Cycle: ${parsed.cycle.join(' → ')} → ${parsed.cycle[0]}`);
-        lines.push('Break the cycle by removing at least one $allowedComponents entry.');
-    }
-    if (opts.verbose && opts.raw) {
-        lines.push('');
-        lines.push('--- raw ---');
-        lines.push(opts.raw);
-    }
-    return lines.filter(Boolean).join('\n');
-}
-export function formatEdsiError(raw, opts = {}) {
-    const input = typeof raw === 'string' ? raw : displayValue(raw);
-    if (!input)
-        return '';
-    return formatParsedEdsiError(parseEdsiError(input), { ...opts, raw: opts.raw ?? input });
-}
-export function formatApiError(error, verbose = false) {
-    const formatted = formatEdsiError(error.body || error.message, { verbose, raw: error.body }) || error.message;
-    const phase = error.message.split('\n', 1)[0];
-    const withPhase = /^(?:apply|preview|poll) failed: \d+$/.test(phase) && formatted !== phase ? `${phase}\n${formatted}` : formatted;
-    return error.guidance ? `${withPhase}\n${error.guidance}` : withPhase;
-}

package/dist/src/lib/prompt-overrides.js

@@ -1,69 +0,0 @@
-/**
- * Generic `--prompt <stage>=<value>` override parser.
- *
- * One repeatable flag overrides the prompt for any named pipeline stage
- * (e.g. `composition`, `select`, `generate`). The value is classified by
- * string SHAPE only — no filesystem access here: a value that looks like a
- * path is resolved+read by the consumer; otherwise it is treated as the
- * literal prompt text. This keeps the parser pure and testable.
- */
-import { readFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
-const PROMPT_FILE_EXTENSIONS = ['.md', '.txt', '.prompt'];
-/**
- * Heuristic: does this value look like a file path (vs. literal prompt text)?
- * Path if it contains a path separator, starts with `~`, or ends with a known
- * prompt-file extension. Deliberately does NOT touch the filesystem.
- */
-export function looksLikePath(value) {
-    if (value.includes('/') || value.includes('\\'))
-        return true;
-    if (value.startsWith('~'))
-        return true;
-    const lower = value.toLowerCase();
-    return PROMPT_FILE_EXTENSIONS.some((ext) => lower.endsWith(ext));
-}
-/**
- * Parse repeated `stage=value` flag inputs into a stage→override map. Splits on
- * the FIRST `=` so values may contain `=`. Last write wins for a repeated
- * stage. Malformed entries are collected in `errors` (caller decides fatality).
- */
-export function parsePromptOverrides(inputs) {
-    const overrides = new Map();
-    const errors = [];
-    for (const raw of inputs) {
-        const eq = raw.indexOf('=');
-        if (eq === -1) {
-            errors.push(`--prompt "${raw}" must be in the form stage=value`);
-            continue;
-        }
-        const stage = raw.slice(0, eq).trim();
-        const value = raw.slice(eq + 1);
-        if (stage === '') {
-            errors.push(`--prompt "${raw}" has an empty stage (expected stage=value)`);
-            continue;
-        }
-        if (value === '') {
-            errors.push(`--prompt "${raw}" has an empty value`);
-            continue;
-        }
-        overrides.set(stage, looksLikePath(value) ? { kind: 'path', value } : { kind: 'text', value });
-    }
-    return { overrides, errors };
-}
-/**
- * Resolve an override to its prompt text: read the file for a `path` override
- * (resolved against cwd), or return the literal `text` value. Throws with a
- * clear message if a path override can't be read.
- */
-export async function resolvePromptOverride(override) {
-    if (override.kind === 'text')
-        return override.value;
-    const abs = resolve(override.value);
-    try {
-        return await readFile(abs, 'utf8');
-    }
-    catch {
-        throw new Error(`--prompt: could not read prompt file: ${abs}`);
-    }
-}

package/dist/src/lib/terminal-capabilities.js

@@ -1,51 +0,0 @@
-/**
- * Check the capabilities Ink's interactive input hooks require before the UI
- * mounts. A stream can report itself as a TTY while its terminal host still
- * rejects raw mode, so the check briefly enables and restores raw mode.
- */
-export function getInteractiveTerminalSupport(options = {}) {
-    const stdin = options.stdin ?? process.stdin;
-    const stdout = options.stdout ?? process.stdout;
-    if (stdout.isTTY !== true)
-        return { supported: false, reason: 'output-not-tty' };
-    if (stdin.isTTY !== true)
-        return { supported: false, reason: 'input-not-tty' };
-    if (typeof stdin.setRawMode !== 'function') {
-        return { supported: false, reason: 'raw-mode-unavailable' };
-    }
-    const wasRaw = stdin.isRaw === true;
-    try {
-        stdin.setRawMode(true);
-        if (!wasRaw)
-            stdin.setRawMode(false);
-    }
-    catch {
-        if (!wasRaw) {
-            try {
-                stdin.setRawMode(false);
-            }
-            catch {
-                // The original capability failure is the actionable result.
-            }
-        }
-        return { supported: false, reason: 'raw-mode-unavailable' };
-    }
-    return { supported: true };
-}
-export function requireInteractiveTerminal(options = {}) {
-    const support = getInteractiveTerminalSupport(options);
-    if (support.supported)
-        return;
-    const reason = support.reason === 'output-not-tty'
-        ? 'standard output is not a TTY'
-        : support.reason === 'input-not-tty'
-            ? 'standard input is not a TTY'
-            : 'standard input cannot enter raw mode';
-    const lines = [
-        `Interactive terminal UI is unavailable because ${reason}.`,
-        'On Windows, run this command in Windows Terminal with PowerShell.',
-    ];
-    if (options.alternative)
-        lines.push(`To continue without the UI, ${options.alternative}.`);
-    throw new Error(lines.join('\n'));
-}

package/dist/src/lib/user-agent.js

@@ -1,29 +0,0 @@
-import { createRequire } from 'node:module';
-const require = createRequire(import.meta.url);
-const pkg = require('../../package.json');
-const APP = 'contentful.experience-design-system-cli';
-// process.platform → CEP-0056 os name, mirroring contentful-sdk-core's
-// getNodeOS so the header parses identically to SDK-originated traffic.
-const OS_NAMES = {
-    android: 'Android',
-    aix: 'Linux',
-    darwin: 'macOS',
-    freebsd: 'Linux',
-    linux: 'Linux',
-    openbsd: 'Linux',
-    sunos: 'Linux',
-    win32: 'Windows',
-};
-/**
- * X-Contentful-User-Agent for the CLI's CMA requests, so writes are
- * attributable to the DSI CLI as their origin. Format follows CEP-0056:
- * `app <name>/<ver>; platform node.js/<ver>; os <name>/<ver>;`. Carries only
- * the app/platform/os segments — no user- or content-identifying data.
- */
-export function buildUserAgent(version = pkg.version) {
-    const parts = [`app ${APP}/${version}`, `platform node.js/${process.version}`];
-    const os = OS_NAMES[process.platform];
-    if (os)
-        parts.push(`os ${os}/${process.version}`);
-    return `${parts.join('; ')};`;
-}

package/dist/src/output/format.js

@@ -1,110 +0,0 @@
-// Color support — checked once at module load.
-// Honors NO_COLOR (https://no-color.org) and FORCE_COLOR (set by orchestrator for non-TTY subprocesses).
-function detectColors() {
-    if (process.env['NO_COLOR'] !== undefined)
-        return false;
-    if (process.env['FORCE_COLOR'] !== undefined)
-        return true;
-    return process.stderr.isTTY === true;
-}
-const col = detectColors();
-export const c = {
-    green: (s) => (col ? `\x1b[32m${s}\x1b[0m` : s),
-    red: (s) => (col ? `\x1b[31m${s}\x1b[0m` : s),
-    cyan: (s) => (col ? `\x1b[36m${s}\x1b[0m` : s),
-    yellow: (s) => (col ? `\x1b[33m${s}\x1b[0m` : s),
-    dim: (s) => (col ? `\x1b[2m${s}\x1b[0m` : s),
-    bold: (s) => (col ? `\x1b[1m${s}\x1b[0m` : s),
-};
-// Formats a single parsed tool-call object into a human-readable line, or returns null to suppress it.
-function formatToolCall(obj) {
-    switch (obj['tool']) {
-        case 'classify_component': {
-            const desc = typeof obj['description'] === 'string' ? obj['description'] : null;
-            return desc ? `    ${c.dim('→')}  ${c.dim(desc)}` : null;
-        }
-        case 'classify_prop': {
-            const prop = String(obj['prop'] ?? '');
-            const type = String(obj['cdf_type'] ?? '');
-            const cat = String(obj['cdf_category'] ?? '');
-            return `    ${c.green('+')}  ${prop}  ${c.dim(`${type}  ${cat}`)}`;
-        }
-        case 'exclude_prop': {
-            const prop = String(obj['prop'] ?? '');
-            const reason = typeof obj['reason'] === 'string' ? obj['reason'] : '';
-            return `    ${c.dim('–')}  ${prop}  ${c.dim(reason)}`;
-        }
-        case 'classify_slot': {
-            const slot = String(obj['slot'] ?? '');
-            const desc = typeof obj['description'] === 'string' ? obj['description'] : '';
-            const req = obj['required'] === true ? c.dim(' required') : '';
-            return `    ${c.cyan('◈')}  ${slot}${req}  ${c.dim(desc)}`;
-        }
-        case 'select_component': {
-            const name = String(obj['name'] ?? '');
-            const reason = typeof obj['reason'] === 'string' ? obj['reason'] : '';
-            return `    ${c.green('+')}  ${name}  ${c.dim(reason)}`;
-        }
-        case 'reject_component': {
-            const name = String(obj['name'] ?? '');
-            const reason = typeof obj['reason'] === 'string' ? obj['reason'] : '';
-            return `    ${c.dim('–')}  ${name}  ${c.dim(reason)}`;
-        }
-        default:
-            return null;
-    }
-}
-/**
- * Processes streaming agent output line by line.
- *
- * Tool-call JSON lines are translated into human-readable summaries.
- * Prose (reasoning text) is shown only when verbose=true.
- */
-export class OutputFormatter {
-    _buf = '';
-    _verbose;
-    _write;
-    constructor(verbose, write = (s) => process.stderr.write(s)) {
-        this._verbose = verbose;
-        this._write = write;
-    }
-    push(chunk) {
-        this._buf += chunk;
-        // Process all complete lines; keep any trailing partial line in the buffer.
-        const nl = this._buf.lastIndexOf('\n');
-        if (nl === -1)
-            return;
-        const complete = this._buf.slice(0, nl + 1);
-        this._buf = this._buf.slice(nl + 1);
-        for (const line of complete.split('\n')) {
-            this._processLine(line);
-        }
-    }
-    flush() {
-        if (this._buf.trim())
-            this._processLine(this._buf);
-        this._buf = '';
-    }
-    _processLine(line) {
-        const trimmed = line.trim();
-        if (!trimmed)
-            return;
-        if (trimmed.startsWith('{')) {
-            try {
-                const obj = JSON.parse(trimmed);
-                if (typeof obj['tool'] === 'string') {
-                    const formatted = formatToolCall(obj);
-                    if (formatted !== null)
-                        this._write(formatted + '\n');
-                    return;
-                }
-            }
-            catch {
-                // not JSON — fall through to prose handling
-            }
-        }
-        if (this._verbose) {
-            this._write(c.dim('    ' + trimmed) + '\n');
-        }
-    }
-}