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

package/dist/src/runs/fingerprint.js

@@ -1,75 +0,0 @@
-import { createHash } from 'node:crypto';
-import { readFile, stat } from 'node:fs/promises';
-import { resolve } from 'node:path';
-function rowField(row, key) {
-    const v = row[key];
-    return typeof v === 'string' ? v : null;
-}
-export function sha256Hex(buf) {
-    return createHash('sha256').update(buf).digest('hex');
-}
-/**
- * Build a per-file fingerprint of every source file that contributed to a
- * run. Stats each unique source_path once (first-seen component name wins),
- * and (optionally) hashes the raw tokens file too.
- *
- * Missing files do NOT throw — they're simply omitted. The read-side
- * staleness check re-stats from disk and surfaces missing files there so we
- * can report which one disappeared.
- */
-export async function buildSourceFingerprint(opts) {
-    const rows = opts.db
-        .prepare('SELECT name, source_path FROM raw_components WHERE session_id = ?')
-        .all(opts.extractSessionId);
-    const files = {};
-    const seen = new Set();
-    for (const row of rows) {
-        const sourcePath = rowField(row, 'source_path');
-        const name = rowField(row, 'name');
-        if (!sourcePath)
-            continue;
-        const abs = resolve(sourcePath);
-        if (seen.has(abs))
-            continue;
-        seen.add(abs);
-        try {
-            const st = await stat(abs);
-            const entry = { mtime: st.mtime.toISOString() };
-            if (name)
-                entry.componentName = name;
-            files[abs] = entry;
-        }
-        catch {
-            // Source file missing at fingerprint time — skip silently. Staleness
-            // can only fire on files we recorded; a file removed before save
-            // simply isn't tracked. Operators usually re-extract in that case.
-        }
-    }
-    let rawTokensPath = null;
-    let rawTokensMtime = null;
-    let rawTokensContentHash = null;
-    if (opts.rawTokensPath) {
-        const abs = resolve(opts.rawTokensPath);
-        rawTokensPath = abs;
-        try {
-            const [st, buf] = await Promise.all([stat(abs), readFile(abs)]);
-            rawTokensMtime = st.mtime.toISOString();
-            rawTokensContentHash = sha256Hex(buf);
-        }
-        catch {
-            // Missing raw tokens — record the path but leave mtime/hash null so
-            // the staleness check can detect it as missing on read.
-        }
-    }
-    return { files, rawTokensPath, rawTokensMtime, rawTokensContentHash };
-}
-/**
- * Hash the saved JSON contents the wizard just wrote. Caller passes the raw
- * bytes (or strings) so we hash exactly what landed on disk.
- */
-export function buildSavedFingerprint(input) {
-    return {
-        componentsJsonHash: input.componentsJson != null ? sha256Hex(input.componentsJson) : null,
-        tokensJsonHash: input.tokensJson != null ? sha256Hex(input.tokensJson) : null,
-    };
-}

package/dist/src/runs/ls-command.js

@@ -1,137 +0,0 @@
-import { listRuns } from './store.js';
-import { resolveRunTarget } from './resolve-run-target.js';
-import { checkRunStaleness, shortStalenessSummary, formatStalenessDetail } from './staleness.js';
-function pad(value, width) {
-    if (value.length >= width)
-        return value;
-    return value + ' '.repeat(width - value.length);
-}
-function formatCreated(iso) {
-    // Drop ms + Z, render as `YYYY-MM-DD HH:MM`.
-    const m = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})/.exec(iso);
-    return m ? `${m[1]} ${m[2]}` : iso;
-}
-function formatPushed(record) {
-    if (!record.pushedTo)
-        return '(not pushed)';
-    return `${record.pushedTo.spaceId}/${record.pushedTo.environmentId}`;
-}
-function makeColumns(staleness) {
-    return [
-        { header: 'ID', get: (r) => r.id },
-        { header: 'CREATED', get: (r) => formatCreated(r.createdAt) },
-        { header: 'PROJECT', get: (r) => r.projectPath },
-        { header: 'SAVED TO', get: (r) => r.savePath },
-        { header: 'COMPONENTS', get: (r) => String(r.componentCount) },
-        { header: 'PUSHED', get: formatPushed },
-        { header: 'STALE', get: (_r, i) => shortStalenessSummary(staleness[i]) },
-    ];
-}
-function renderFooter(runs, write) {
-    if (runs.length === 0)
-        return;
-    const id = runs[0].id;
-    write('\n');
-    write(`Push run ${id}:    experiences import --push-from-run ${id}\n`);
-    write(`Modify run ${id}:  experiences import --modify ${id}\n`);
-}
-async function renderDetail(run, write) {
-    const lines = [
-        `Run ${run.id}`,
-        `Created: ${formatCreated(run.createdAt)}`,
-        `Project: ${run.projectPath}`,
-        `Saved:   ${run.savePath}`,
-        `Components: ${run.componentCount}`,
-        `Tokens:     ${run.tokenCount}`,
-    ];
-    if (run.tokensPath) {
-        lines.push(`Tokens saved: ${run.tokensPath}`);
-    }
-    lines.push(`Agent:      ${run.agent}`, `Pushed:     ${formatPushed(run)}`, '');
-    // Staleness status block. v2/v1 records (no sourceFingerprint) render as
-    // UNKNOWN — the operator can re-extract for a fresh run.
-    if (!run.sourceFingerprint) {
-        lines.push('Status: UNKNOWN (run pre-dates the staleness fingerprint).');
-    }
-    else {
-        const staleness = await checkRunStaleness(run);
-        lines.push(...formatStalenessDetail(staleness));
-    }
-    lines.push('', `Push to Contentful:   experiences import --push-from-run ${run.id}`, `Modify in wizard:     experiences import --modify ${run.id}`, '');
-    write(lines.join('\n'));
-}
-export async function runLsCommand(opts = {}) {
-    const write = opts.write ?? ((s) => process.stdout.write(s));
-    if (opts.pushed && opts.notPushed) {
-        throw new Error('--pushed and --not-pushed are mutually exclusive');
-    }
-    if (opts.target) {
-        const run = await resolveRunTarget(opts.target);
-        if (opts.json) {
-            write(JSON.stringify(run, null, 2) + '\n');
-            return;
-        }
-        await renderDetail(run, write);
-        return;
-    }
-    let runs = await listRuns({
-        ...(opts.projectPath ? { projectPath: opts.projectPath } : {}),
-        ...(typeof opts.limit === 'number' ? { limit: opts.limit } : {}),
-    });
-    if (opts.pushed)
-        runs = runs.filter((r) => r.pushedTo !== null);
-    if (opts.notPushed)
-        runs = runs.filter((r) => r.pushedTo === null);
-    if (opts.json) {
-        write(JSON.stringify(runs, null, 2) + '\n');
-        return;
-    }
-    if (runs.length === 0) {
-        write('No runs recorded yet. Run `experiences import` to create one.\n');
-        return;
-    }
-    // Compute staleness once per row so the table is consistent across the
-    // STALE column and any future detail-equivalent surfaces.
-    const stalenessByIdx = await Promise.all(runs.map(async (r) => (r.sourceFingerprint ? checkRunStaleness(r) : null)));
-    const stalenessForCol = stalenessByIdx.map((s) => s ?? {
-        stale: false,
-        staleComponents: [],
-        staleTokens: false,
-        savedComponentsEdited: false,
-        savedTokensEdited: false,
-        missingSourceFiles: [],
-    });
-    const columns = makeColumns(stalenessForCol);
-    // Auto-expand each column to max(header, max(row value)) so long paths
-    // aren't silently truncated.
-    const widths = columns.map((c) => Math.max(c.header.length, ...runs.map((r, i) => c.get(r, i).length)));
-    const headerRow = columns.map((c, i) => pad(c.header, widths[i])).join('  ');
-    write(headerRow + '\n');
-    for (let i = 0; i < runs.length; i++) {
-        const r = runs[i];
-        const row = columns.map((c, ci) => pad(c.get(r, i), widths[ci])).join('  ');
-        write(row + '\n');
-    }
-    renderFooter(runs, write);
-}
-export function registerRunsCommand(program) {
-    program
-        .command('runs [target]')
-        .alias('ls')
-        .description('List recorded import runs from ~/.config/experiences/runs.json, or show one run when [target] (id or path) is given')
-        .option('--project <path>', 'Filter by source project path (absolute)')
-        .option('--limit <n>', 'Limit the number of rows', (v) => parseInt(v, 10))
-        .option('--json', 'Emit RunRecord JSON to stdout (array, or single object with [target])')
-        .option('--pushed', 'Only show runs that have been pushed to Contentful')
-        .option('--not-pushed', 'Only show runs that have not been pushed')
-        .action(async (target, options) => {
-        await runLsCommand({
-            ...(target ? { target } : {}),
-            ...(options.project ? { projectPath: options.project } : {}),
-            ...(typeof options.limit === 'number' && !Number.isNaN(options.limit) ? { limit: options.limit } : {}),
-            ...(options.json ? { json: true } : {}),
-            ...(options.pushed ? { pushed: true } : {}),
-            ...(options.notPushed ? { notPushed: true } : {}),
-        });
-    });
-}

package/dist/src/runs/modify-launcher.js

@@ -1,42 +0,0 @@
-/**
- * Thin indirection so `runModifyCommand` can be unit-tested without spinning
- * up the real Ink wizard. The production implementation lives here.
- */
-export async function launchModifyWizard(input) {
-    const { render } = await import('ink');
-    const { createElement } = await import('react');
-    const { WizardApp } = await import('../import/tui/WizardApp.js');
-    // Modify entry: re-open the wizard with the prior run's sessions seeded so
-    // extract + generate are skipped. The wizard short-circuits to `initialStep`
-    // (typically `final-review`) using state derived from the seed IDs. Saved
-    // credentials from the run record's `pushedTo` pre-fill the credentials
-    // step (CMA token is never persisted, so it still falls through to the
-    // env/credentials.json/prompt resolution path).
-    const props = {
-        initialProjectPath: input.projectPath,
-        seedExtractSessionId: input.extractSessionId,
-        initialStep: input.entryStep,
-    };
-    if (input.generateSessionId)
-        props.seedGenerateSessionId = input.generateSessionId;
-    if (input.tokenSessionId)
-        props.seedTokenSessionId = input.tokenSessionId;
-    if (input.compositionMode)
-        props.compositionMode = input.compositionMode;
-    if (input.saveMode === 'overwrite')
-        props.outDirOverride = input.savePath;
-    if (input.outDirOverride)
-        props.outDirOverride = input.outDirOverride;
-    if (input.initialSpaceId)
-        props.initialSpaceId = input.initialSpaceId;
-    if (input.initialEnvironmentId)
-        props.initialEnvironmentId = input.initialEnvironmentId;
-    if (input.initialHost)
-        props.initialHost = input.initialHost;
-    if (input.initialCmaToken)
-        props.initialCmaToken = input.initialCmaToken;
-    if (input.allowDeletions !== undefined)
-        props.allowDeletions = input.allowDeletions;
-    const { waitUntilExit } = render(createElement(WizardApp, props));
-    await waitUntilExit();
-}

package/dist/src/runs/path-prompt.js

@@ -1,72 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState, useEffect } from 'react';
-import { Box, Text } from 'ink';
-import { readdirSync } from 'node:fs';
-import { dirname, basename, join } from 'node:path';
-import { useImmediateInput } from '../analyze/select/tui/hooks/useImmediateInput.js';
-import { normalizePath } from '../import/path-utils.js';
-function autocomplete(partial) {
-    if (!partial)
-        return null;
-    const normalized = normalizePath(partial);
-    const dir = dirname(normalized);
-    const base = basename(normalized);
-    let entries;
-    try {
-        entries = readdirSync(dir);
-    }
-    catch {
-        return null;
-    }
-    const matches = entries.filter((e) => e.startsWith(base));
-    if (matches.length === 0)
-        return null;
-    if (matches.length === 1)
-        return join(dir, matches[0]);
-    // Common prefix
-    let prefix = matches[0];
-    for (const m of matches) {
-        while (!m.startsWith(prefix))
-            prefix = prefix.slice(0, -1);
-        if (!prefix)
-            break;
-    }
-    return prefix.length > base.length ? join(dir, prefix) : null;
-}
-export function PathPrompt({ defaultPath, onSubmit, onCancel, label = 'Save to', }) {
-    const [input, setInput] = useState('');
-    const [cursorVisible, setCursorVisible] = useState(true);
-    useEffect(() => {
-        const interval = setInterval(() => setCursorVisible((v) => !v), 500);
-        return () => clearInterval(interval);
-    }, []);
-    useImmediateInput((rawInput, key) => {
-        if (key.return) {
-            const trimmed = input.trim();
-            onSubmit(trimmed === '' ? defaultPath : normalizePath(trimmed));
-            return;
-        }
-        if (key.escape) {
-            onCancel();
-            return;
-        }
-        if (key.tab) {
-            const target = input.trim() || defaultPath;
-            const completed = autocomplete(target);
-            if (completed)
-                setInput(completed);
-            return;
-        }
-        if (key.backspace || key.delete) {
-            setInput((v) => v.slice(0, -1));
-            return;
-        }
-        if (rawInput && !key.ctrl && !key.meta) {
-            setInput((v) => v + rawInput);
-        }
-    });
-    const shown = input || defaultPath;
-    const isPlaceholder = input === '';
-    const cursor = cursorVisible ? '█' : ' ';
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", children: "?" }), _jsxs(Text, { bold: true, children: [label, ":"] }), _jsx(Text, { dimColor: isPlaceholder, children: shown }), _jsx(Text, { children: cursor })] }), _jsxs(Box, { gap: 3, children: [_jsx(Text, { dimColor: true, children: "[Enter] Confirm" }), _jsx(Text, { dimColor: true, children: "[Tab] Autocomplete" }), _jsx(Text, { dimColor: true, children: "[Esc] Cancel" })] })] }));
-}

package/dist/src/runs/push-creds-prompt.js

@@ -1,39 +0,0 @@
-import React from 'react';
-export async function promptForPushCredentials(opts = {}) {
-    const { render, Box, Text } = await import('ink');
-    const { useState } = await import('react');
-    const { CredentialsStep } = await import('../import/tui/steps/CredentialsStep.js');
-    return new Promise((resolve, reject) => {
-        let app = null;
-        function App() {
-            const [done, setDone] = useState(false);
-            const handle = (spaceId, environmentId, cmaToken, host) => {
-                if (done)
-                    return;
-                setDone(true);
-                // Defer unmount so Ink flushes the final render.
-                queueMicrotask(() => {
-                    app?.unmount();
-                    resolve({ spaceId, environmentId, cmaToken, host });
-                });
-            };
-            if (done) {
-                return React.createElement(Box, null, React.createElement(Text, null, ''));
-            }
-            return React.createElement(CredentialsStep, {
-                summary: opts.summary ?? 'Enter Contentful credentials to push this run. Press Enter on each field to advance.',
-                ...(opts.initialSpaceId !== undefined ? { initialSpaceId: opts.initialSpaceId } : {}),
-                ...(opts.initialEnvironmentId !== undefined ? { initialEnvironmentId: opts.initialEnvironmentId } : {}),
-                ...(opts.initialCmaToken !== undefined ? { initialCmaToken: opts.initialCmaToken } : {}),
-                ...(opts.initialHost !== undefined ? { initialHost: opts.initialHost } : {}),
-                onConfirm: handle,
-                onContinue: handle,
-                onQuit: () => {
-                    app?.unmount();
-                    reject(new Error('Credentials entry cancelled.'));
-                },
-            });
-        }
-        app = render(React.createElement(App));
-    });
-}

package/dist/src/runs/push-helpers.js

@@ -1,72 +0,0 @@
-import { execFile } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-/**
- * Resolve the package's CLI binary. Duplicates the walk from export-helpers
- * so push-helpers can be imported independently.
- */
-function findCliPath() {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 8; i++) {
-        const candidate = join(dir, 'bin', 'cli.js');
-        if (existsSync(candidate))
-            return candidate;
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return join(fileURLToPath(import.meta.url), '..', '..', '..', '..', 'bin', 'cli.js');
-}
-function runCli(args) {
-    const cliPath = findCliPath();
-    if (!existsSync(cliPath)) {
-        return Promise.resolve({
-            exitCode: 1,
-            stdout: '',
-            stderr: `Cannot find CLI binary at ${cliPath}`,
-        });
-    }
-    return new Promise((res) => {
-        execFile('node', [cliPath, ...args], (err, stdout, stderr) => {
-            res({
-                exitCode: err && 'code' in err && typeof err.code === 'number' ? err.code : err ? 1 : 0,
-                stdout,
-                stderr,
-            });
-        });
-    });
-}
-/**
- * Push a recorded pipeline.db session's components + tokens to Contentful by
- * shelling out to `experiences apply push --session <id>`. Does no local
- * file I/O — that is the whole point of --push-from-run.
- */
-export async function pushRunSession(opts) {
-    const args = [
-        'apply',
-        'push',
-        '--session',
-        opts.sessionId,
-        '--space-id',
-        opts.spaceId,
-        '--environment-id',
-        opts.environmentId,
-        '--cma-token',
-        opts.cmaToken,
-        '--yes',
-    ];
-    if (opts.host) {
-        args.push('--host', opts.host);
-    }
-    if (opts.allowDeletions) {
-        args.push('--allow-deletions');
-    }
-    const r = await runCli(args);
-    if (r.exitCode === 0)
-        return { ok: true };
-    return { ok: false, error: r.stderr.trim() || r.stdout.trim() || `exit ${r.exitCode}` };
-}
-/** Internal test surface. Not part of the public API. */
-export const __testing = { findCliPath };

package/dist/src/runs/push-launcher.js

@@ -1,77 +0,0 @@
-/**
- * Push-from-picker launcher. When the operator selects "Push" from the
- * interactive run-picker, we mount the wizard with seeded session IDs and
- * `initialStep: 'push-from-picker'` so they see the same preview + push UX
- * as a fresh `experiences import` (preview → diff review → pushing progress
- * bars → done with view URL).
- *
- * This is deliberately parallel to `modify-launcher.ts`. The `--push-from-run`
- * CLI flag path (headless shell-out via `replayRun`) is preserved for
- * scripted / non-TTY use.
- */
-export async function launchPushWizard(input) {
-    const { render } = await import('ink');
-    const { createElement } = await import('react');
-    const { WizardApp } = await import('../import/tui/WizardApp.js');
-    const props = {
-        initialProjectPath: input.projectPath,
-        seedExtractSessionId: input.extractSessionId,
-        initialStep: 'push-from-picker',
-    };
-    if (input.generateSessionId)
-        props.seedGenerateSessionId = input.generateSessionId;
-    if (input.tokenSessionId)
-        props.seedTokenSessionId = input.tokenSessionId;
-    if (input.tokensPath)
-        props.seedTokensPath = input.tokensPath;
-    if (input.initialSpaceId)
-        props.initialSpaceId = input.initialSpaceId;
-    if (input.initialEnvironmentId)
-        props.initialEnvironmentId = input.initialEnvironmentId;
-    if (input.initialHost)
-        props.initialHost = input.initialHost;
-    if (input.initialCmaToken)
-        props.initialCmaToken = input.initialCmaToken;
-    const { waitUntilExit } = render(createElement(WizardApp, props));
-    await waitUntilExit();
-}
-/**
- * Interactive picker-Push entry point. Resolves the run record, applies the
- * staleness gate, layers credentials (flag → pushedTo → credentials.json),
- * and mounts the wizard via `launchPushWizard`.
- */
-export async function pickerPushRun(opts) {
-    const { resolveRunTarget } = await import('./resolve-run-target.js');
-    const { readExperiencesCredentials } = await import('../credentials-store.js');
-    const { checkRunStaleness, formatStalenessDetail } = await import('./staleness.js');
-    const run = await resolveRunTarget(opts.runIdOrPath);
-    if (!opts.force) {
-        const staleness = await checkRunStaleness(run);
-        if (staleness.stale) {
-            const detail = formatStalenessDetail(staleness);
-            throw new Error([
-                `Refusing to push run ${run.id} — source or saved files have drifted since the run was recorded.`,
-                ...detail,
-                '',
-                'Re-extract with `experiences import --project <path>` for a fresh run, or pass --force to bypass.',
-            ].join('\n'));
-        }
-    }
-    const stored = await readExperiencesCredentials();
-    const spaceId = opts.spaceId || run.pushedTo?.spaceId || stored.spaceId || '';
-    const environmentId = opts.environmentId || run.pushedTo?.environmentId || stored.environmentId || '';
-    const cmaToken = opts.cmaToken || stored.cmaToken || '';
-    const host = opts.host || run.pushedTo?.host || stored.host || '';
-    await launchPushWizard({
-        extractSessionId: run.extractSessionId,
-        generateSessionId: run.generateSessionId,
-        tokenSessionId: run.tokenSessionId,
-        projectPath: run.projectPath,
-        savePath: run.savePath,
-        tokensPath: run.tokensPath,
-        ...(spaceId ? { initialSpaceId: spaceId } : {}),
-        ...(environmentId ? { initialEnvironmentId: environmentId } : {}),
-        ...(host ? { initialHost: host } : {}),
-        ...(cmaToken ? { initialCmaToken: cmaToken } : {}),
-    });
-}