@c9up/ream 0.1.26 → 0.1.27

package/dist/console/parser.js

@@ -0,0 +1,440 @@
+/**
+ * argv parser for console commands.
+ *
+ * Metadata-driven, unlike the naive splitter it replaces: knowing a flag's
+ * declared type is what makes `--email hugo@example.com` work. Without it the
+ * parser cannot tell a value-taking flag from a boolean one, so it has to treat
+ * every `--flag` as `true` and let the value fall through to the positionals —
+ * which is exactly how the previous implementation silently dropped arguments.
+ *
+ * Supported forms (Console parity):
+ *   --flag=value   --flag value   --flag (boolean)   --no-flag (boolean false)
+ *   -f value       -f             -abc (grouped boolean aliases)
+ *   --             everything after it is positional, never a flag
+ *   repeated flags accumulate for `@flags.array()`
+ */
+import { ReamError } from '../errors/ReamError.js';
+/**
+ * The parser as an object (Console `Parser`).
+ *
+ * Same work as {@link parseArgv}, held in a shape that can be passed around and
+ * reused — which is how Console's kernel and its ported code hold it.
+ */
+export class Parser {
+    #options;
+    constructor(options = {}) {
+        this.#options = options;
+    }
+    parse(argv) {
+        return parseArgv(typeof argv === 'string' ? argv.split(' ').filter(Boolean) : argv, this.#options);
+    }
+}
+export function parseArgv(argv, options = {}) {
+    const declaredFlags = options.flags ?? [];
+    const declaredArgs = options.args ?? [];
+    const where = options.commandName ? ` for "${options.commandName}"` : '';
+    const byName = new Map();
+    const byAlias = new Map();
+    for (const flag of declaredFlags) {
+        byName.set(flag.flagName, flag);
+        for (const alias of flag.alias)
+            byAlias.set(alias, flag);
+    }
+    const positionals = [];
+    /** Collected per property so repeated flags can accumulate into arrays. */
+    const collected = new Map();
+    const unknown = {};
+    const push = (meta, value) => {
+        const existing = collected.get(meta.propertyName);
+        if (existing)
+            existing.push(value);
+        else
+            collected.set(meta.propertyName, [value]);
+    };
+    /** Record the flag as seen without attaching a value to it. */
+    const mention = (meta) => {
+        if (!collected.has(meta.propertyName))
+            collected.set(meta.propertyName, []);
+    };
+    let sawTerminator = false;
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (sawTerminator) {
+            positionals.push(token);
+            continue;
+        }
+        if (token === '--') {
+            sawTerminator = true;
+            continue;
+        }
+        // --long, --long=value, --no-long
+        if (token.startsWith('--')) {
+            const body = token.slice(2);
+            const eq = body.indexOf('=');
+            const name = eq === -1 ? body : body.slice(0, eq);
+            const inline = eq === -1 ? undefined : body.slice(eq + 1);
+            // `--no-x` negates a declared boolean. Checked before the plain lookup so
+            // a genuine flag literally named `no-cache` still wins.
+            const negated = !byName.has(name) && name.startsWith('no-') ? byName.get(name.slice(3)) : undefined;
+            if (negated && negated.type === 'boolean') {
+                if (inline !== undefined) {
+                    throw invalidNegation(token, where);
+                }
+                push(negated, false);
+                continue;
+            }
+            const meta = byName.get(name);
+            if (!meta) {
+                if (!options.allowUnknownFlags)
+                    throw unknownFlag(`--${name}`, where, declaredFlags);
+                // An undeclared flag has no type to go on, so `--foo bar` is read the
+                // way a shell parser does: the next token is its value unless it looks
+                // like another flag. Treating it as a bare boolean would drop `bar`
+                // entirely — a proxy command would silently lose its arguments.
+                if (inline !== undefined) {
+                    unknown[name] = inline;
+                }
+                else {
+                    const next = argv[i + 1];
+                    if (next !== undefined && (!next.startsWith('-') || next === '-')) {
+                        unknown[name] = next;
+                        i++;
+                    }
+                    else {
+                        unknown[name] = true;
+                    }
+                }
+                continue;
+            }
+            i = consume({ meta, value: inline }, argv, i, { push, mention }, where);
+            continue;
+        }
+        // -a, -a value, -abc (grouped booleans)
+        if (token.startsWith('-') && token.length > 1) {
+            const body = token.slice(1);
+            const eq = body.indexOf('=');
+            const chars = eq === -1 ? body : body.slice(0, eq);
+            const inline = eq === -1 ? undefined : body.slice(eq + 1);
+            if (chars.length === 1) {
+                const meta = byAlias.get(chars);
+                if (!meta) {
+                    if (!options.allowUnknownFlags)
+                        throw unknownFlag(`-${chars}`, where, declaredFlags);
+                    if (inline !== undefined) {
+                        unknown[chars] = inline;
+                    }
+                    else {
+                        const next = argv[i + 1];
+                        if (next !== undefined && (!next.startsWith('-') || next === '-')) {
+                            unknown[chars] = next;
+                            i++;
+                        }
+                        else {
+                            unknown[chars] = true;
+                        }
+                    }
+                    continue;
+                }
+                i = consume({ meta, value: inline }, argv, i, { push, mention }, where);
+                continue;
+            }
+            // A group like `-rs` can only be booleans: there is no way to attach a
+            // value to more than one flag at a time.
+            for (const char of chars) {
+                const meta = byAlias.get(char);
+                if (!meta) {
+                    if (!options.allowUnknownFlags)
+                        throw unknownFlag(`-${char}`, where, declaredFlags);
+                    unknown[char] = true;
+                    continue;
+                }
+                if (meta.type !== 'boolean') {
+                    throw new ReamError('E_CONSOLE_INVALID_FLAG_GROUP', `Cannot group "-${char}" with other flags${where} — "--${meta.flagName}" expects a value.`, { hint: `Pass it on its own: -${char} <value>` });
+                }
+                push(meta, true);
+            }
+            continue;
+        }
+        positionals.push(token);
+    }
+    const extraArgs = [];
+    const strict = options.validate !== false;
+    const flags = applyParse(declaredFlags, materialiseFlags(declaredFlags, collected, unknown, where, strict));
+    const args = applyParse(declaredArgs, materialiseArgs(declaredArgs, positionals, where, options.allowUnknownFlags === true, extraArgs, strict));
+    // Rekeyed into Console's shape only here: defaults and `parse` are applied per
+    // DECLARATION, which needs the property name, while what comes out describes
+    // what was typed — positionals as a list, flags under their CLI name.
+    const byFlagName = { ...unknown };
+    for (const meta of declaredFlags) {
+        if (meta.propertyName in flags)
+            byFlagName[meta.flagName] = flags[meta.propertyName];
+    }
+    return {
+        unknownFlags: Object.keys(unknown),
+        flags: byFlagName,
+        args: declaredArgs.map((meta) => args[meta.propertyName]),
+        extraArgs,
+        _: extraArgs,
+        nodeArgs: [],
+    };
+}
+/**
+ * Run each declared input's `parse` callback over the materialised value.
+ *
+ * Applied last, on the already-typed value, so `parse` receives a number for a
+ * number flag rather than the raw token — and only for inputs that were
+ * actually provided or defaulted, never for an absent optional one.
+ */
+function applyParse(declared, values) {
+    for (const meta of declared) {
+        if (meta.parse === undefined)
+            continue;
+        const current = values[meta.propertyName];
+        if (current === undefined)
+            continue;
+        Reflect.set(values, meta.propertyName, Reflect.apply(meta.parse, undefined, [current]));
+    }
+    return values;
+}
+/**
+ * Attach a value to a flag, pulling the next argv token when the value was not
+ * written inline. Returns the new cursor position.
+ */
+function consume(raw, argv, index, collect, where) {
+    const { push, mention } = collect;
+    const { meta, value } = raw;
+    if (meta.type === 'boolean') {
+        if (value === undefined) {
+            push(meta, true);
+            return index;
+        }
+        // `--force=false` is explicit enough to honour; anything else is a typo.
+        if (value === 'true' || value === 'false') {
+            push(meta, value === 'true');
+            return index;
+        }
+        throw new ReamError('E_CONSOLE_INVALID_FLAG_VALUE', `Flag "--${meta.flagName}"${where} is a boolean and cannot take the value "${value}".`, { hint: `Use --${meta.flagName} or --no-${meta.flagName}` });
+    }
+    if (value !== undefined) {
+        push(meta, value);
+        return index;
+    }
+    // Value-taking flag with no inline value: the next token is it. A token that
+    // itself looks like a flag is NOT consumed — `--email --name x` is a mistake
+    // worth reporting, not an email of "--name".
+    const next = argv[index + 1];
+    if (next === undefined || (next.startsWith('-') && next !== '-')) {
+        // Unless the flag says an empty value is meaningful (Console
+        // `allowEmptyValue`), in which case the mention itself is the value.
+        if (meta.allowEmptyValue === true) {
+            // An array flag with nothing behind it is an EMPTY list, not a list
+            // holding one empty string — `mention` records it without a value.
+            if (meta.type === 'array')
+                mention(meta);
+            else
+                push(meta, '');
+            return index;
+        }
+        throw new ReamError('E_CONSOLE_MISSING_FLAG_VALUE', `Flag "--${meta.flagName}"${where} expects a value.`, { hint: `Example: --${meta.flagName}=<value>` });
+    }
+    push(meta, next);
+    return index + 1;
+}
+/** Apply types, defaults and required checks to the collected flag values. */
+function materialiseFlags(declared, collected, unknown, where, strict) {
+    const out = { ...unknown };
+    for (const meta of declared) {
+        const values = collected.get(meta.propertyName);
+        if (values === undefined) {
+            if (meta.default !== undefined)
+                out[meta.propertyName] = meta.default;
+            else if (meta.required && strict) {
+                throw new ReamError('E_CONSOLE_MISSING_FLAG', `Missing required flag "--${meta.flagName}"${where}.`);
+            }
+            continue;
+        }
+        switch (meta.type) {
+            case 'array':
+                out[meta.propertyName] = values.map(String);
+                break;
+            case 'number': {
+                // Last one wins for scalars, matching how shells are normally used.
+                const last = String(values[values.length - 1]);
+                const parsed = Number(last);
+                if (last.trim() === '' || Number.isNaN(parsed)) {
+                    throw new ReamError('E_CONSOLE_INVALID_FLAG_VALUE', `Flag "--${meta.flagName}"${where} expects a number, got "${last}".`);
+                }
+                out[meta.propertyName] = parsed;
+                break;
+            }
+            case 'boolean':
+                out[meta.propertyName] = Boolean(values[values.length - 1]);
+                break;
+            default:
+                out[meta.propertyName] = String(values[values.length - 1]);
+        }
+    }
+    return out;
+}
+/** Map positionals onto declared arguments, honouring `@args.spread()`. */
+function materialiseArgs(declared, positionals, where, allowExtra, extraArgs, strict) {
+    const out = {};
+    let cursor = 0;
+    for (const meta of declared) {
+        if (meta.type === 'spread') {
+            const rest = positionals.slice(cursor);
+            cursor = positionals.length;
+            if (rest.length === 0) {
+                // No default and nothing to collect: the argument is UNDEFINED, not an
+                // empty list (Console). A command that distinguishes "not given" from
+                // "given empty" must be able to tell them apart.
+                if (meta.default !== undefined)
+                    out[meta.propertyName] = meta.default;
+                else if (meta.required && strict)
+                    throw missingArgument(meta, where);
+                continue;
+            }
+            out[meta.propertyName] = rest;
+            continue;
+        }
+        const value = positionals[cursor];
+        cursor++;
+        if (value === undefined) {
+            if (meta.default !== undefined)
+                out[meta.propertyName] = meta.default;
+            else if (meta.required && strict)
+                throw missingArgument(meta, where);
+            continue;
+        }
+        // An empty positional is nearly always a shell variable that did not
+        // expand, so it is reported rather than accepted (Console) — unless the
+        // argument declares that an empty value means something.
+        if (value === '' && meta.allowEmptyValue !== true && strict) {
+            throw new ReamError('E_CONSOLE_MISSING_ARGUMENT_VALUE', `Missing value for argument "${meta.argumentName}"${where}.`);
+        }
+        out[meta.propertyName] = value;
+    }
+    // Anything left over was never asked for. Swallowing it hides a typo:
+    // `greet john extra` would run as `greet john`, silently dropping the rest.
+    // A `spread` argument consumes the tail, so this only fires without one.
+    if (cursor < positionals.length) {
+        const extra = positionals.slice(cursor);
+        // A proxy command (allowUnknownFlags) keeps them — forwarding them is its
+        // whole purpose. Anything else reports them, because swallowing a
+        // positional hides a typo.
+        if (allowExtra) {
+            extraArgs.push(...extra);
+            return out;
+        }
+        throw new ReamError('E_CONSOLE_UNEXPECTED_ARGUMENT', `Unexpected argument${extra.length > 1 ? 's' : ''} ${extra.map((value) => `"${value}"`).join(', ')}${where}.`, {
+            hint: declared.length === 0
+                ? 'This command takes no positional arguments.'
+                : `It takes ${declared.length}: ${declared.map((arg) => arg.argumentName).join(', ')}.`,
+        });
+    }
+    return out;
+}
+/**
+ * Check a parsed input against a command's declarations (Console `validate`).
+ *
+ * Separate from parsing because the ORDER matters: Console runs the global-flag
+ * listeners between the two, which is what lets `--help` work on a command
+ * whose flags are required. One implementation, called by the kernel and by
+ * `BaseCommand.validate()`.
+ *
+ * Positionals are accepted as a list (Console's shape) or keyed by property name
+ * (what a hand-built Ream input holds).
+ */
+export function validateParsed(parsed, declarations) {
+    const where = declarations.commandName ? ` for "${declarations.commandName}"` : '';
+    const byPosition = Array.isArray(parsed.args) ? parsed.args : undefined;
+    const byName = byPosition === undefined ? { ...parsed.args } : {};
+    (declarations.args ?? []).forEach((arg, index) => {
+        const value = byPosition === undefined ? byName[arg.propertyName] : byPosition[index];
+        if (arg.required && value === undefined)
+            throw missingArgument(arg, where);
+        if (value === undefined || arg.allowEmptyValue === true)
+            return;
+        if (value === '' || (Array.isArray(value) && value.length === 0)) {
+            throw new ReamError('E_CONSOLE_MISSING_ARGUMENT_VALUE', `Missing value for argument "${arg.argumentName}"${where}.`);
+        }
+    });
+    const unknown = parsed.unknownFlags ?? [];
+    if (declarations.allowUnknownFlags !== true && unknown.length > 0) {
+        const flag = unknown[0] ?? '';
+        throw new ReamError('E_CONSOLE_UNKNOWN_FLAG', `Unknown flag "${flag.length === 1 ? `-${flag}` : `--${flag}`}"${where}.`);
+    }
+    const flags = parsed.flags ?? {};
+    for (const flag of declarations.flags ?? []) {
+        // Keyed by flag name (Console, and what the parser returns) or by property
+        // name — a hand-built input must validate whichever shape it was written in.
+        const key = Object.hasOwn(flags, flag.flagName) ? flag.flagName : flag.propertyName;
+        const mentioned = Object.hasOwn(flags, key);
+        const value = flags[key];
+        if (flag.required && !mentioned) {
+            throw new ReamError('E_CONSOLE_MISSING_FLAG', `Missing required flag "--${flag.flagName}"${where}.`);
+        }
+        if (!mentioned || flag.allowEmptyValue === true)
+            continue;
+        if (flag.type === 'number') {
+            if (value === undefined || Number.isNaN(value)) {
+                throw new ReamError('E_CONSOLE_INVALID_FLAG_VALUE', `Flag "--${flag.flagName}"${where} expects a number, got "${String(value)}".`);
+            }
+            continue;
+        }
+        // A mentioned string/array flag with nothing behind it: `--name` alone
+        // yields '' from a parser, and an empty array for a repeatable flag.
+        if (flag.type === 'boolean')
+            continue;
+        if (value === '' || (Array.isArray(value) && value.length === 0)) {
+            throw new ReamError('E_CONSOLE_MISSING_FLAG_VALUE', `Missing value for flag "--${flag.flagName}"${where}.`);
+        }
+    }
+}
+/**
+ * Assign the parsed values to the properties they were declared on.
+ *
+ * The single hydration path: `BaseCommand.hydrate()` calls it, and so does the
+ * kernel for a command declared structurally, which has no `hydrate()` of its
+ * own. Both input shapes are accepted — positionals as a list (what the parser
+ * now returns, and Console's shape) or keyed by property name, flags under their
+ * flag name or their property name — because a hand-built input is a documented
+ * use case.
+ */
+export function assignParsedValues(target, declaredArgs, declaredFlags, parsed) {
+    const byPosition = Array.isArray(parsed.args) ? parsed.args : undefined;
+    const byArgName = byPosition === undefined ? { ...parsed.args } : {};
+    declaredArgs.forEach((meta, index) => {
+        define(target, meta.propertyName, byPosition?.[index] ?? byArgName[meta.propertyName]);
+    });
+    for (const meta of declaredFlags) {
+        const key = Object.hasOwn(parsed.flags, meta.flagName) ? meta.flagName : meta.propertyName;
+        define(target, meta.propertyName, parsed.flags[key]);
+    }
+}
+/** Writable and enumerable, as Console's `hydrate` defines them. */
+function define(target, property, value) {
+    Object.defineProperty(target, property, {
+        value,
+        enumerable: true,
+        writable: true,
+        configurable: true,
+    });
+}
+/**
+ * Exported so `BaseCommand.validate()` reports a missing argument with the very
+ * message the parser uses — two wordings for one rule is how they drift apart.
+ */
+export function missingArgument(meta, where = '') {
+    return new ReamError('E_CONSOLE_MISSING_ARGUMENT', `Missing required argument "${meta.argumentName}"${where}.`, meta.description ? { hint: meta.description } : undefined);
+}
+function unknownFlag(token, where, declared) {
+    const known = declared.map((f) => `--${f.flagName}`).join(', ');
+    return new ReamError('E_CONSOLE_UNKNOWN_FLAG', `Unknown flag "${token}"${where}.`, {
+        hint: known.length > 0 ? `Known flags: ${known}` : 'This command declares no flags.',
+    });
+}
+function invalidNegation(token, where) {
+    return new ReamError('E_CONSOLE_INVALID_FLAG_VALUE', `"${token}"${where} negates a boolean flag and cannot carry a value.`);
+}
+//# sourceMappingURL=parser.js.map

package/dist/console/parser.js.map

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

package/dist/console/prompts.d.ts

@@ -0,0 +1,124 @@
+/**
+ * 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.
+ */
+/** A selectable option — a bare string, or a value with its display text. */
+export type PromptChoice = string | {
+    name: string;
+    message?: string;
+    hint?: string;
+};
+/**
+ * Options for the selection prompts.
+ *
+ * `default` is an INDEX here, not a value — that is how Adonis spells it for
+ * `choice` / `multiple` / `autocomplete`.
+ */
+export interface SelectPromptOptions extends Omit<PromptOptions, 'default'> {
+    default?: number | readonly number[];
+}
+/**
+ * Options for `multiple()`.
+ *
+ * `validate` and `result` receive the whole selection, not each item: the
+ * prompt's value IS the array, and per-item calls would make a rule like "pick
+ * at least two" impossible to express.
+ */
+export interface MultiplePromptOptions extends Omit<SelectPromptOptions, 'validate' | 'result' | 'format'> {
+    validate?: (values: string[]) => boolean | string | Promise<boolean | string>;
+    result?: (values: string[]) => unknown;
+}
+export interface PromptOptions<T = string> {
+    /** Used when the answer is empty. */
+    default?: T;
+    /** Identifies the prompt for {@link Prompt.trap}. Defaults to the message. */
+    name?: string;
+    /** Shown next to the question. */
+    hint?: string;
+    /** Return `true` to accept, or a string describing what is wrong. */
+    validate?: (value: T) => boolean | string | Promise<boolean | string>;
+    /** Transforms the value that is returned. */
+    result?: (value: T) => unknown;
+    /**
+     * Formats what is echoed as the user types — display only.
+     *
+     * It does NOT change the value the prompt returns: Console documents it as
+     * "affecting only the CLI output", and treating it as a transform would make
+     * a ported command receive a different value. Use `result` to transform.
+     */
+    format?: (value: T) => T;
+}
+/**
+ * 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 declare class PromptTrap {
+    #private;
+    constructor(install: (value: unknown) => void);
+    /** Answer a text/secure prompt with this value. */
+    replyWith(value: string): void;
+    /** Answer a confirm/toggle prompt with yes. */
+    accept(): void;
+    /** Answer a confirm/toggle prompt with no. */
+    reject(): void;
+    /** Pick the option at this index (choice / autocomplete). */
+    chooseOption(index?: number): void;
+    /** Pick these indexes (multiple). */
+    chooseOptions(indexes: readonly number[]): void;
+}
+/**
+ * Options for `confirm` / `toggle`. `result` may map the boolean to something
+ * else, which is why the return type follows it (Console documents `result` for
+ * every prompt).
+ */
+export interface BooleanPromptOptions<R = boolean> extends Omit<PromptOptions<boolean>, 'result' | 'format'> {
+    result?: (value: boolean) => R;
+}
+export declare class Prompt {
+    #private;
+    /**
+     * Script the next answer for the prompt registered under `name`
+     * (`options.name`, defaulting to the message).
+     */
+    trap(name: string): PromptTrap;
+    /** Traps that were installed but never reached — useful in assertions. */
+    get pendingTraps(): string[];
+    ask(message: string, options?: PromptOptions): Promise<unknown>;
+    /** Masked input, for passwords and tokens. */
+    secure(message: string, options?: PromptOptions): Promise<unknown>;
+    confirm(message: string, options?: BooleanPromptOptions): Promise<boolean>;
+    confirm<R>(message: string, options: BooleanPromptOptions<R>): Promise<R>;
+    /** Two custom labels instead of yes/no (Console `toggle`). */
+    toggle(message: string, labels?: readonly [string, string], options?: BooleanPromptOptions): Promise<boolean>;
+    toggle<R>(message: string, labels: readonly [string, string] | undefined, options: BooleanPromptOptions<R>): Promise<R>;
+    /** Pick one option (Console `choice`). */
+    choice(message: string, choices: readonly PromptChoice[], options?: SelectPromptOptions): Promise<unknown>;
+    /** Pick several options (Console `multiple`). */
+    multiple(message: string, choices: readonly PromptChoice[], options?: MultiplePromptOptions): Promise<unknown>;
+    /**
+     * 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.
+     */
+    autocomplete(message: string, choices: readonly PromptChoice[], options?: SelectPromptOptions & {
+        limit?: number;
+    }): Promise<unknown>;
+    /**
+     * 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.
+     */
+    protected readLine(query: string, masked?: boolean): Promise<string>;
+}
+//# sourceMappingURL=prompts.d.ts.map

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

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