@c9up/ream 0.1.26 → 0.1.27

package/dist/console/prompts.js

@@ -0,0 +1,356 @@
+/**
+ * Interactive prompts (Console / `@poppinss/prompts` surface).
+ *
+ * Dependency-free, which sets one deliberate boundary: selection prompts are
+ * answered by typing a number or a name, not by arrow-key navigation. Doing
+ * that properly means raw mode, cursor control and redraw handling — a terminal
+ * widget toolkit, which is what enquirer is. Everything else matches Console: the
+ * method names, the option bag (`validate` / `default` / `hint` / `name` /
+ * `result` / `format`), and the trap API that makes prompts testable.
+ */
+import { stdin, stdout } from 'node:process';
+import { createInterface } from 'node:readline';
+import { ReamError } from '../errors/ReamError.js';
+import { colourise } from './ui.js';
+/**
+ * Scripted answer builder — Console's `prompt.trap(name)`.
+ *
+ * Without it a command that asks anything is untestable: the test would either
+ * hang on a prompt or need a fake terminal.
+ */
+export class PromptTrap {
+    #install;
+    constructor(install) {
+        this.#install = install;
+    }
+    /** Answer a text/secure prompt with this value. */
+    replyWith(value) {
+        this.#install(value);
+    }
+    /** Answer a confirm/toggle prompt with yes. */
+    accept() {
+        this.#install(true);
+    }
+    /** Answer a confirm/toggle prompt with no. */
+    reject() {
+        this.#install(false);
+    }
+    /** Pick the option at this index (choice / autocomplete). */
+    chooseOption(index = 0) {
+        this.#install({ index });
+    }
+    /** Pick these indexes (multiple). */
+    chooseOptions(indexes) {
+        this.#install({ indexes: [...indexes] });
+    }
+}
+export class Prompt {
+    #traps = new Map();
+    /**
+     * Script the next answer for the prompt registered under `name`
+     * (`options.name`, defaulting to the message).
+     */
+    trap(name) {
+        return new PromptTrap((value) => {
+            this.#traps.set(name, value);
+        });
+    }
+    /** Traps that were installed but never reached — useful in assertions. */
+    get pendingTraps() {
+        return [...this.#traps.keys()];
+    }
+    async ask(message, options = {}) {
+        return this.#text(message, options, false);
+    }
+    /** Masked input, for passwords and tokens. */
+    async secure(message, options = {}) {
+        return this.#text(message, options, true);
+    }
+    async confirm(message, options = {}) {
+        return this.toggle(message, ['y', 'n'], options);
+    }
+    async toggle(message, labels = ['y', 'n'], options = {}) {
+        const trapped = this.#takeTrap(message, options.name);
+        if (trapped !== undefined) {
+            const value = Boolean(trapped);
+            await this.#assertTrapped(value, options);
+            return options.result === undefined ? value : options.result(value);
+        }
+        const fallback = options.default ?? false;
+        const yes = labels[0];
+        const no = labels[1];
+        const shown = fallback ? `${yes.toUpperCase()}/${no}` : `${yes}/${no.toUpperCase()}`;
+        for (;;) {
+            const answer = (await this.readLine(this.#label(message, options, `(${shown})`))).toLowerCase();
+            if (answer === '') {
+                const problem = await this.#check(fallback, options);
+                if (problem === undefined) {
+                    return options.result === undefined ? fallback : options.result(fallback);
+                }
+                stdout.write(`${colourise(problem, 'yellow')}\n`);
+                continue;
+            }
+            const affirmative = answer === yes.toLowerCase() || answer === 'yes' || answer === 'true';
+            const negative = answer === no.toLowerCase() || answer === 'no' || answer === 'false';
+            if (!affirmative && !negative) {
+                stdout.write(`${colourise(`Answer ${yes} or ${no}.`, 'yellow')}\n`);
+                continue;
+            }
+            const problem = await this.#check(affirmative, options);
+            if (problem !== undefined) {
+                stdout.write(`${colourise(problem, 'yellow')}\n`);
+                continue;
+            }
+            return options.result === undefined ? affirmative : options.result(affirmative);
+        }
+    }
+    /** Pick one option (Console `choice`). */
+    async choice(message, choices, options = {}) {
+        const picked = await this.#select(message, choices, options, false);
+        return picked[0];
+    }
+    /** Pick several options (Console `multiple`). */
+    async multiple(message, choices, options = {}) {
+        const picked = await this.#select(message, choices, options, true);
+        return options.result ? options.result(picked.map(String)) : picked;
+    }
+    /**
+     * Pick one option by typing part of its name (Console `autocomplete`).
+     *
+     * Substring matching rather than fuzzy scoring — predictable, and enough for
+     * the "too many options to list" case it exists for.
+     */
+    async autocomplete(message, choices, options = {}) {
+        const trapped = this.#takeTrap(message, options.name);
+        if (trapped !== undefined) {
+            const picked = this.#fromTrap(trapped, choices, false);
+            // Same rule as every other prompt: a scripted answer is held to the
+            // command's own validation, or the test proves nothing.
+            await this.#validateSelection(picked, options, false);
+            return this.#applyResult(picked[0], options);
+        }
+        const limit = options.limit ?? 10;
+        for (;;) {
+            const typed = await this.readLine(this.#label(message, options, '(type to filter)'));
+            const matches = choices.filter((choice) => nameOf(choice).toLowerCase().includes(typed.toLowerCase()));
+            if (matches.length === 0) {
+                stdout.write(`${colourise('No match.', 'yellow')}\n`);
+                continue;
+            }
+            const first = matches[0];
+            if (matches.length === 1 && first !== undefined) {
+                return this.#finish(nameOf(first), options);
+            }
+            const picked = await this.#select(message, matches.slice(0, limit), { ...options, name: undefined }, false);
+            return picked[0];
+        }
+    }
+    // ─── internals ──────────────────────────────────────────────
+    async #text(message, options, masked) {
+        const trapped = this.#takeTrap(message, options.name);
+        if (trapped !== undefined)
+            return this.#finish(String(trapped), options);
+        for (;;) {
+            const raw = await this.readLine(this.#label(message, options), masked);
+            // `format` is display-only (Console): the returned value is what was typed,
+            // with the default filled in when the line was empty.
+            const value = raw === '' && options.default !== undefined ? options.default : raw;
+            const problem = await this.#check(value, options);
+            if (problem !== undefined) {
+                stdout.write(`${colourise(problem, 'yellow')}\n`);
+                continue;
+            }
+            return options.result ? options.result(value) : value;
+        }
+    }
+    async #select(message, choices, options, many) {
+        if (choices.length === 0) {
+            throw new ReamError('E_CONSOLE_EMPTY_CHOICES', `"${message}" was asked with no options.`);
+        }
+        const trapped = this.#takeTrap(message, options.name);
+        if (trapped !== undefined) {
+            const picked = this.#fromTrap(trapped, choices, many);
+            // Same reasoning as the text prompts: a scripted answer the real prompt
+            // would reject must fail the test, not sail through it.
+            await this.#validateSelection(picked, options, many);
+            return many ? picked : picked.map((value) => this.#applyResult(value, options));
+        }
+        const defaultLabel = options.default === undefined
+            ? undefined
+            : [options.default]
+                .flat()
+                .map((index) => {
+                const choice = choices[index];
+                return choice === undefined ? String(index) : displayOf(choice);
+            })
+                .join(', ');
+        for (;;) {
+            stdout.write(`${this.#label(message, { ...options, default: defaultLabel }).trimEnd()}\n`);
+            choices.forEach((choice, index) => {
+                const hint = typeof choice === 'string' ? undefined : choice.hint;
+                stdout.write(`  ${colourise(String(index + 1), 'cyan')}) ${displayOf(choice)}` +
+                    `${hint === undefined ? '' : colourise(` — ${hint}`, 'dim')}\n`);
+            });
+            const answer = await this.readLine(many ? `Select (e.g. 1,3) from 1-${choices.length}: ` : `Select (1-${choices.length}): `);
+            // An empty answer takes the default — which for a selection prompt is an
+            // index, as Adonis spells it. Without this the default was shown in the
+            // label and then rejected as an invalid selection.
+            const indexes = answer === '' && options.default !== undefined
+                ? [options.default]
+                    .flat()
+                    .filter((index) => Number.isInteger(index) && index >= 0 && index < choices.length)
+                : answer
+                    .split(',')
+                    .map((part) => Number(part.trim()) - 1)
+                    .filter((index) => Number.isInteger(index) && index >= 0 && index < choices.length);
+            if (indexes.length === 0 || (!many && indexes.length !== 1)) {
+                stdout.write(`${colourise('Invalid selection.', 'yellow')}\n`);
+                continue;
+            }
+            const picked = indexes.map((index) => nameOf(choices[index]));
+            const problem = await this.#selectionProblem(picked, options, many);
+            if (problem !== undefined) {
+                stdout.write(`${colourise(problem, 'yellow')}\n`);
+                continue;
+            }
+            return many ? picked : picked.map((value) => this.#applyResult(value, options));
+        }
+    }
+    /** `result` for a single-value selection; `multiple` applies its own. */
+    #applyResult(value, options) {
+        return options.result === undefined
+            ? value
+            : Reflect.apply(options.result, undefined, [String(value)]);
+    }
+    /**
+     * Validation subject for a selection: the whole array for `multiple`, the
+     * single value otherwise — so an Console rule written `validate(values: string[])`
+     * behaves the same here.
+     */
+    async #selectionProblem(picked, options, many) {
+        if (options.validate === undefined)
+            return undefined;
+        const subject = many ? picked.map(String) : String(picked[0] ?? '');
+        const verdict = await Reflect.apply(options.validate, undefined, [subject]);
+        if (verdict === true)
+            return undefined;
+        return typeof verdict === 'string' ? verdict : 'Invalid value.';
+    }
+    async #validateSelection(picked, options, many) {
+        const problem = await this.#selectionProblem(picked, options, many);
+        if (problem === undefined)
+            return;
+        throw new ReamError('E_CONSOLE_INVALID_TRAP_VALUE', `A scripted answer was rejected by its own validation: ${problem}`, { hint: 'The trap supplies a value the real prompt would refuse — fix the test.' });
+    }
+    /**
+     * Apply `format`, `validate` and `result` to a value that came from a trap.
+     *
+     * Skipping `validate` here would let a test inject a value the real prompt
+     * would have rejected, and the command would pass — a test giving confidence
+     * in something that cannot happen. A trapped value that fails validation is a
+     * broken test, so it throws instead of re-asking: there is nobody to re-ask.
+     */
+    async #finish(value, options) {
+        await this.#assertTrapped(value, options);
+        return options.result ? options.result(value) : value;
+    }
+    // Only the validation hook, so `SelectPromptOptions` (whose `default` is an
+    // index, not a value) passes without a variance conflict.
+    async #assertTrapped(value, options) {
+        const problem = await this.#check(value, options);
+        if (problem === undefined)
+            return;
+        throw new ReamError('E_CONSOLE_INVALID_TRAP_VALUE', `A scripted answer was rejected by its own validation: ${problem}`, { hint: 'The trap supplies a value the real prompt would refuse — fix the test.' });
+    }
+    #fromTrap(trapped, choices, many) {
+        const read = (index) => {
+            const choice = choices[index];
+            if (choice === undefined) {
+                throw new ReamError('E_CONSOLE_TRAP_OUT_OF_RANGE', `A trap chose option ${index + 1}, but only ${choices.length} were offered.`);
+            }
+            return nameOf(choice);
+        };
+        if (typeof trapped === 'object' && trapped !== null) {
+            const indexes = Reflect.get(trapped, 'indexes');
+            if (Array.isArray(indexes))
+                return indexes.map((index) => read(Number(index)));
+            const index = Reflect.get(trapped, 'index');
+            if (typeof index === 'number')
+                return [read(index)];
+        }
+        // A trap that replied with a raw value: honour it as-is.
+        if (many)
+            return Array.isArray(trapped) ? trapped : [trapped];
+        return [trapped];
+    }
+    /** Consume a scripted answer, if one was installed for this prompt. */
+    #takeTrap(message, name) {
+        const key = name ?? message;
+        if (!this.#traps.has(key))
+            return undefined;
+        const value = this.#traps.get(key);
+        this.#traps.delete(key);
+        return value;
+    }
+    async #check(value, options) {
+        if (options.validate === undefined)
+            return undefined;
+        const verdict = await options.validate(value);
+        if (verdict === true)
+            return undefined;
+        return typeof verdict === 'string' ? verdict : 'Invalid value.';
+    }
+    // Only the display fields, so a `PromptOptions<boolean>` can be passed
+    // without tripping over the contravariance of `validate`.
+    #label(message, options, suffix) {
+        const hint = options.hint === undefined ? '' : colourise(` (${options.hint})`, 'dim');
+        // The one place `format` legitimately applies: what is shown, not what is
+        // returned.
+        const shownDefault = options.default !== undefined && options.format !== undefined
+            ? Reflect.apply(options.format, undefined, [options.default])
+            : options.default;
+        const shown = shownDefault === undefined ? '' : ` [${String(shownDefault)}]`;
+        const tail = suffix === undefined ? '' : ` ${suffix}`;
+        return `${message}${hint}${shown}${tail}: `;
+    }
+    /**
+     * Read one line from the terminal.
+     *
+     * `protected` on purpose: it is the single seam through which input enters,
+     * so a test (or a future non-readline frontend) can substitute it by
+     * subclassing instead of faking a TTY.
+     */
+    readLine(query, masked = false) {
+        if (!stdin.isTTY) {
+            return Promise.reject(new ReamError('E_CONSOLE_NOT_INTERACTIVE', `Cannot prompt for "${query.trim()}" — stdin is not interactive.`, {
+                hint: 'Pass the value as a flag, or script the answer in tests with prompt.trap(name).',
+            }));
+        }
+        const rl = createInterface({ input: stdin, output: stdout, terminal: true });
+        // readline echoes each keystroke through _writeToOutput; replacing it is
+        // the dependency-free way to hide what is typed.
+        if (masked && isEchoing(rl)) {
+            rl._writeToOutput = (text) => {
+                stdout.write(text.includes(query) ? query : '');
+            };
+        }
+        return new Promise((resolve) => {
+            rl.question(query, (answer) => {
+                if (masked)
+                    stdout.write('\n');
+                rl.close();
+                resolve(answer.trim());
+            });
+        });
+    }
+}
+function isEchoing(value) {
+    return '_writeToOutput' in value && typeof Reflect.get(value, '_writeToOutput') === 'function';
+}
+function nameOf(choice) {
+    return typeof choice === 'string' ? choice : choice.name;
+}
+function displayOf(choice) {
+    return typeof choice === 'string' ? choice : (choice.message ?? choice.name);
+}
+//# sourceMappingURL=prompts.js.map

package/dist/console/prompts.js.map

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

package/dist/console/tracing.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Diagnostics channels for the console (Console `tracingChannels`).
+ *
+ * `diagnostics_channel` is Node's built-in tracing hook: an APM agent, or a
+ * test, subscribes without the framework knowing about it and without paying
+ * anything when nobody listens.
+ */
+import diagnosticsChannel from 'node:diagnostics_channel';
+import type { CommandClass, CommandInstance } from './types.js';
+export interface CommandExecTracingData {
+    command: CommandClass;
+    commandInstance: CommandInstance;
+    argv: readonly string[];
+}
+/** Traces every command run by the kernel — start, end, error and result. */
+export declare const commandExec: diagnosticsChannel.TracingChannel<"ream.command.exec", CommandExecTracingData>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/console/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/console/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,kBAAkB,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,CAAA;IACrB,eAAe,EAAE,eAAe,CAAA;IAChC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACxB;AAED,6EAA6E;AAC7E,eAAO,MAAM,WAAW,gFAGF,CAAA"}

package/dist/console/tracing.js

@@ -0,0 +1,11 @@
+/**
+ * Diagnostics channels for the console (Console `tracingChannels`).
+ *
+ * `diagnostics_channel` is Node's built-in tracing hook: an APM agent, or a
+ * test, subscribes without the framework knowing about it and without paying
+ * anything when nobody listens.
+ */
+import diagnosticsChannel from 'node:diagnostics_channel';
+/** Traces every command run by the kernel — start, end, error and result. */
+export const commandExec = diagnosticsChannel.tracingChannel('ream.command.exec');
+//# sourceMappingURL=tracing.js.map

package/dist/console/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/console/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,kBAAkB,MAAM,0BAA0B,CAAA;AASzD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC,cAAc,CAG1D,mBAAmB,CAAC,CAAA"}