@pristine-ts/cli 2.0.7 → 2.0.17

package/dist/lib/cjs/event-payloads/start-repl.event-payload.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartReplEventPayload = void 0;
+/**
+ * Payload that signals "launch the interactive REPL." Produced by `ReplStartEventMapper`
+ * for argv shapes with no command (`pristine`) or with the explicit `repl` command
+ * (`pristine repl`). Consumed by `ReplStartEventHandler` which runs the readline loop
+ * for the rest of the process lifetime.
+ *
+ * The payload carries the `scriptPath` (argv[1]) for parity with `CommandEventPayload`
+ * and for diagnostics; the REPL itself reads its input from stdin, not from the payload.
+ */
+class StartReplEventPayload {
+    constructor(scriptPath) {
+        this.scriptPath = scriptPath;
+    }
+}
+exports.StartReplEventPayload = StartReplEventPayload;
+//# sourceMappingURL=start-repl.event-payload.js.map

package/dist/lib/cjs/event-payloads/start-repl.event-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-repl.event-payload.js","sourceRoot":"","sources":["../../../../src/event-payloads/start-repl.event-payload.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,MAAa,qBAAqB;IAChC,YAAmB,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IACrC,CAAC;CACF;AAHD,sDAGC"}

package/dist/lib/cjs/interfaces/interfaces.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./command.interface"), exports);
+__exportStar(require("./terminal-key.interface"), exports);
 //# sourceMappingURL=interfaces.js.map

package/dist/lib/cjs/interfaces/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,2DAAyC"}

package/dist/lib/cjs/interfaces/terminal-key.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=terminal-key.interface.js.map

package/dist/lib/cjs/interfaces/terminal-key.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-key.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/terminal-key.interface.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/managers/cli-prompt.manager.js

@@ -38,6 +38,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -47,6 +50,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var CliPrompt_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliPrompt = void 0;
 const tsyringe_1 = require("tsyringe");
@@ -56,11 +60,24 @@ const readline = __importStar(require("node:readline/promises"));
 const node_readline_1 = require("node:readline");
 const node_process_1 = require("node:process");
 const console_readline_options_1 = require("../options/console-readline.options");
+const terminal_key_reader_manager_1 = require("./terminal-key-reader.manager");
+const terminal_key_name_enum_1 = require("../enums/terminal-key-name.enum");
+const boolean_answer_parser_1 = require("../utils/boolean-answer-parser");
+const prompt_cancelled_error_1 = require("../errors/prompt-cancelled.error");
 /**
- * Interactive stdin reader for CLI commands. Wraps Node's `readline/promises` and offers
- * a single `readLine` method with optional masking after input is received.
+ * Interactive terminal prompts for CLI commands, implemented entirely on Node's `readline`
+ * and raw-mode stdin — no third-party prompt library. Line-based prompts (`readLine`,
+ * `input`, `confirm`) go through `readline/promises`; the keystroke-level prompts (`select`
+ * arrow menu, masked `readSecret`) go through {@link TerminalKeyReader}.
+ *
+ * `Ctrl+C` rejects with {@link PromptCancelledError} across all of them — the line prompts
+ * via a `readline` SIGINT handler, the raw-mode prompts via the key reader — so callers get
+ * one consistent cancellation signal.
  */
-let CliPrompt = class CliPrompt {
+let CliPrompt = CliPrompt_1 = class CliPrompt {
+    constructor(terminalKeyReader) {
+        this.terminalKeyReader = terminalKeyReader;
+    }
     /**
      * Reads a string from stdin synchronously. Returns whatever `process.stdin.read()`
      * gives back (which may be `null` when no data is buffered).
@@ -71,29 +88,178 @@ let CliPrompt = class CliPrompt {
     /**
      * Reads a line from stdin after displaying a prompt. When
      * `options.showCharactersOnTyping` is false, the answered line is cleared and replaced
-     * with a masked echo so the typed value isn't left visible on screen.
+     * with a masked echo so the typed value isn't left visible on screen (a post-input clear,
+     * not true keystroke suppression — use {@link readSecret} for real masking).
      *
-     * Note: this is not a true keystroke-suppressing password input — Node's stock
-     * `readline` does not support that without raw-mode handling. The current behavior is
-     * a post-input clear, sufficient for most CLI prompts.
+     * `Ctrl+C` rejects with {@link PromptCancelledError}: registering a `SIGINT` listener on
+     * the readline interface overrides Node's default interrupt handling, turning it into a
+     * clean rejection rather than a hung promise.
      */
     readLine(question_1) {
         return __awaiter(this, arguments, void 0, function* (question, options = new console_readline_options_1.ConsoleReadlineOptions()) {
             const rl = readline.createInterface({ input: node_process_1.stdin, output: node_process_1.stdout });
-            const answer = yield rl.question(question);
-            if (!options.showCharactersOnTyping) {
-                (0, node_readline_1.moveCursor)(node_process_1.stdout, 0, -1);
-                (0, node_readline_1.clearLine)(node_process_1.stdout, 0);
-                process.stdout.write(`${question} [******]\n`);
+            try {
+                const answer = yield new Promise((resolve, reject) => {
+                    rl.on("SIGINT", () => reject(new prompt_cancelled_error_1.PromptCancelledError()));
+                    rl.question(question).then(resolve, reject);
+                });
+                if (!options.showCharactersOnTyping) {
+                    (0, node_readline_1.moveCursor)(node_process_1.stdout, 0, -1);
+                    (0, node_readline_1.clearLine)(node_process_1.stdout, 0);
+                    process.stdout.write(`${question} [******]\n`);
+                }
+                return answer;
+            }
+            finally {
+                rl.close();
+            }
+        });
+    }
+    /**
+     * Asks a free-text question, optionally with a default. The default is shown as a hint and
+     * returned verbatim when the user submits an empty line. The answer is trimmed.
+     */
+    input(message, defaultValue) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const suffix = defaultValue !== undefined && defaultValue !== ""
+                ? ` ${CliPrompt_1.DIM}(${defaultValue})${CliPrompt_1.RESET}`
+                : "";
+            const answer = (yield this.readLine(`${message}${suffix} `)).trim();
+            if (answer.length === 0 && defaultValue !== undefined) {
+                return defaultValue;
             }
-            rl.close();
             return answer;
         });
     }
+    /**
+     * Asks a yes/no question. An empty answer takes the default; anything `BooleanAnswerParser`
+     * understands (`y`/`yes`/`true`/`1`, `n`/`no`/`false`/`0`) is accepted; anything else is
+     * re-asked. The default is shown capitalized in the `(Y/n)` / `(y/N)` hint.
+     */
+    confirm(message_1) {
+        return __awaiter(this, arguments, void 0, function* (message, defaultValue = true) {
+            const hint = defaultValue ? "(Y/n)" : "(y/N)";
+            for (;;) {
+                const raw = (yield this.readLine(`${message} ${hint} `)).trim();
+                if (raw.length === 0) {
+                    return defaultValue;
+                }
+                const parsed = boolean_answer_parser_1.BooleanAnswerParser.parse(raw);
+                if (parsed !== undefined) {
+                    return parsed;
+                }
+                process.stdout.write("Please answer yes (y) or no (n).\n");
+            }
+        });
+    }
+    /**
+     * Presents an arrow-key menu and returns the chosen choice's `value`. `↑`/`↓` move the
+     * highlight (wrapping at the ends), `Enter` selects, `Ctrl+C` cancels. When `defaultValue`
+     * matches a choice, the menu starts on it. The cursor is hidden while the menu is active
+     * and restored afterward.
+     */
+    select(message, choices, defaultValue) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (choices.length === 0) {
+                throw new Error("CliPrompt.select requires at least one choice.");
+            }
+            const defaultIndex = choices.findIndex((choice) => choice.value === defaultValue);
+            let active = defaultIndex >= 0 ? defaultIndex : 0;
+            process.stdout.write(CliPrompt_1.HIDE_CURSOR);
+            process.stdout.write(`${CliPrompt_1.CYAN}?${CliPrompt_1.RESET} ${message}\n`);
+            this.renderChoices(choices, active);
+            try {
+                return yield this.terminalKeyReader.read((key, resolve) => {
+                    if (key.name === terminal_key_name_enum_1.TerminalKeyName.Up) {
+                        active = (active - 1 + choices.length) % choices.length;
+                        this.repaintChoices(choices, active);
+                    }
+                    else if (key.name === terminal_key_name_enum_1.TerminalKeyName.Down) {
+                        active = (active + 1) % choices.length;
+                        this.repaintChoices(choices, active);
+                    }
+                    else if (key.name === terminal_key_name_enum_1.TerminalKeyName.Enter) {
+                        resolve(choices[active].value);
+                    }
+                });
+            }
+            finally {
+                process.stdout.write(CliPrompt_1.SHOW_CURSOR);
+            }
+        });
+    }
+    /**
+     * Reads a secret (password, token, …) from stdin with the typed characters masked as `*`.
+     * Real keystroke suppression via raw mode (unlike {@link readLine}'s post-input clear):
+     * each character echoes a `*`, `Backspace` erases one, `Enter` submits, `Ctrl+C` cancels.
+     * The value is returned untrimmed — a secret may legitimately contain surrounding
+     * whitespace.
+     */
+    readSecret(question) {
+        return __awaiter(this, void 0, void 0, function* () {
+            process.stdout.write(question);
+            let value = "";
+            try {
+                yield this.terminalKeyReader.read((key, resolve) => {
+                    if (key.name === terminal_key_name_enum_1.TerminalKeyName.Enter) {
+                        resolve(undefined);
+                    }
+                    else if (key.name === terminal_key_name_enum_1.TerminalKeyName.Backspace) {
+                        if (value.length > 0) {
+                            value = value.slice(0, -1);
+                            process.stdout.write("\b \b");
+                        }
+                    }
+                    else if (key.name === terminal_key_name_enum_1.TerminalKeyName.Character) {
+                        value += key.sequence;
+                        process.stdout.write("*");
+                    }
+                });
+            }
+            finally {
+                process.stdout.write("\n");
+            }
+            return value;
+        });
+    }
+    /**
+     * Writes the choice rows, highlighting the active one with a colored pointer. Each row is
+     * cleared before it's written so a repaint never leaves a longer previous label behind.
+     * @private
+     */
+    renderChoices(choices, active) {
+        choices.forEach((choice, index) => {
+            (0, node_readline_1.clearLine)(process.stdout, 0);
+            (0, node_readline_1.cursorTo)(process.stdout, 0);
+            if (index === active) {
+                process.stdout.write(`${CliPrompt_1.CYAN}${CliPrompt_1.POINTER} ${choice.name}${CliPrompt_1.RESET}\n`);
+            }
+            else {
+                process.stdout.write(`  ${choice.name}\n`);
+            }
+        });
+    }
+    /**
+     * Moves the cursor back up over the previously-rendered choice rows and rewrites them, so
+     * the menu updates in place as the selection moves.
+     * @private
+     */
+    repaintChoices(choices, active) {
+        (0, node_readline_1.moveCursor)(process.stdout, 0, -choices.length);
+        this.renderChoices(choices, active);
+    }
 };
 exports.CliPrompt = CliPrompt;
-exports.CliPrompt = CliPrompt = __decorate([
+// ANSI constants, matching the conventions used by CliSpinner / CliProgressBar.
+CliPrompt.CYAN = "\x1b[36m";
+CliPrompt.DIM = "\x1b[2m";
+CliPrompt.RESET = "\x1b[0m";
+CliPrompt.HIDE_CURSOR = "\x1B[?25l";
+CliPrompt.SHOW_CURSOR = "\x1B[?25h";
+CliPrompt.POINTER = "❯";
+exports.CliPrompt = CliPrompt = CliPrompt_1 = __decorate([
     (0, tsyringe_1.injectable)(),
-    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname)
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    __metadata("design:paramtypes", [terminal_key_reader_manager_1.TerminalKeyReader])
 ], CliPrompt);
 //# sourceMappingURL=cli-prompt.manager.js.map

package/dist/lib/cjs/managers/cli-prompt.manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-prompt.manager.js","sourceRoot":"","sources":["../../../../src/managers/cli-prompt.manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAoC;AACpC,gDAAiD;AACjD,8DAAuD;AACvD,iEAAmD;AACnD,iDAAoD;AACpD,+CAA8D;AAC9D,kFAA2E;AAE3E;;;GAGG;AAGI,IAAM,SAAS,GAAf,MAAM,SAAS;IAEpB;;;OAGG;IACH,IAAI;QACF,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAY,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACG,QAAQ;6DAAC,QAAgB,EAAE,UAAkC,IAAI,iDAAsB,EAAE;YAC7F,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAC,KAAK,EAAL,oBAAK,EAAE,MAAM,EAAN,qBAAM,EAAC,CAAC,CAAC;YAErD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAE3C,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC;gBACpC,IAAA,0BAAU,EAAC,qBAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAA,yBAAS,EAAC,qBAAM,EAAE,CAAC,CAAC,CAAC;gBACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,aAAa,CAAC,CAAC;YACjD,CAAC;YAED,EAAE,CAAC,KAAK,EAAE,CAAC;YAEX,OAAO,MAAM,CAAC;QAChB,CAAC;KAAA;CACF,CAAA;AAlCY,8BAAS;oBAAT,SAAS;IAFrB,IAAA,qBAAU,GAAE;IACZ,IAAA,qBAAY,EAAC,qCAAgB,CAAC;GAClB,SAAS,CAkCrB"}
+{"version":3,"file":"cli-prompt.manager.js","sourceRoot":"","sources":["../../../../src/managers/cli-prompt.manager.ts"],"names":[],"mappings":"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"}

package/dist/lib/cjs/managers/managers.js

@@ -18,5 +18,6 @@ __exportStar(require("./cli-output.manager"), exports);
 __exportStar(require("./cli-progress-bar.manager"), exports);
 __exportStar(require("./cli-prompt.manager"), exports);
 __exportStar(require("./cli-spinner.manager"), exports);
+__exportStar(require("./terminal-key-reader.manager"), exports);
 __exportStar(require("./shell.manager"), exports);
 //# sourceMappingURL=managers.js.map

package/dist/lib/cjs/managers/managers.js.map

@@ -1 +1 @@
-{"version":3,"file":"managers.js","sourceRoot":"","sources":["../../../../src/managers/managers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,kDAAgC"}
+{"version":3,"file":"managers.js","sourceRoot":"","sources":["../../../../src/managers/managers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,gEAA8C;AAC9C,kDAAgC"}

package/dist/lib/cjs/managers/terminal-key-reader.manager.js

@@ -0,0 +1,99 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalKeyReader = void 0;
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const terminal_key_name_enum_1 = require("../enums/terminal-key-name.enum");
+const terminal_key_decoder_1 = require("../utils/terminal-key-decoder");
+const prompt_cancelled_error_1 = require("../errors/prompt-cancelled.error");
+/**
+ * Owns the raw-mode keystroke reading the interactive prompts need (arrow-key `select`,
+ * masked `readSecret`) — the one place in the CLI that flips stdin into raw mode. Node's
+ * stock `readline` is line-buffered and echoes input, so it can't drive an arrow-key menu
+ * or suppress a password's characters; this reads keys one at a time instead.
+ *
+ * Two responsibilities are handled centrally so callers don't each reimplement them:
+ *   - **Cancellation:** `Ctrl+C` rejects the read with {@link PromptCancelledError}.
+ *   - **Terminal restore:** raw mode is entered on start and restored in every exit path,
+ *     so a thrown handler or a cancellation never leaves the terminal in raw mode.
+ *
+ * The `input`/`output` fields default to the process streams and exist as a seam so tests
+ * can drive synthetic keystrokes without a real TTY.
+ */
+let TerminalKeyReader = class TerminalKeyReader {
+    constructor() {
+        this.input = process.stdin;
+        this.output = process.stdout;
+    }
+    /**
+     * Whether both stdin and stdout are interactive terminals. Raw-mode reading is only
+     * meaningful on a real TTY; callers fall back (or skip prompting) when this is false.
+     */
+    isInteractive() {
+        return Boolean(this.input.isTTY) && Boolean(this.output.isTTY);
+    }
+    /**
+     * Reads keystrokes in raw mode, handing each decoded {@link TerminalKey} to `onKey` until
+     * `onKey` ends the read by invoking its `resolve` callback with the result. Resolves to
+     * that value; rejects with {@link PromptCancelledError} on `Ctrl+C`. Raw mode is entered
+     * on start and restored to its prior state in every exit path.
+     */
+    read(onKey) {
+        const input = this.input;
+        const wasRaw = input.isRaw === true;
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const cleanup = () => {
+                input.removeListener("data", onData);
+                if (input.isTTY && typeof input.setRawMode === "function") {
+                    input.setRawMode(wasRaw);
+                }
+                input.pause();
+            };
+            const settle = (run) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanup();
+                run();
+            };
+            const onData = (data) => {
+                for (const key of terminal_key_decoder_1.TerminalKeyDecoder.decode(data.toString())) {
+                    if (key.name === terminal_key_name_enum_1.TerminalKeyName.CtrlC) {
+                        settle(() => reject(new prompt_cancelled_error_1.PromptCancelledError()));
+                        return;
+                    }
+                    try {
+                        onKey(key, (value) => settle(() => resolve(value)));
+                    }
+                    catch (error) {
+                        settle(() => reject(error));
+                        return;
+                    }
+                    if (settled) {
+                        return;
+                    }
+                }
+            };
+            if (input.isTTY && typeof input.setRawMode === "function") {
+                input.setRawMode(true);
+            }
+            input.resume();
+            input.on("data", onData);
+        });
+    }
+};
+exports.TerminalKeyReader = TerminalKeyReader;
+exports.TerminalKeyReader = TerminalKeyReader = __decorate([
+    (0, tsyringe_1.injectable)(),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname)
+], TerminalKeyReader);
+//# sourceMappingURL=terminal-key-reader.manager.js.map

package/dist/lib/cjs/managers/terminal-key-reader.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-key-reader.manager.js","sourceRoot":"","sources":["../../../../src/managers/terminal-key-reader.manager.ts"],"names":[],"mappings":";;;;;;;;;AAAA,uCAAoC;AACpC,gDAAiD;AACjD,8DAAuD;AAEvD,4EAAgE;AAChE,wEAAiE;AACjE,6EAAsE;AAEtE;;;;;;;;;;;;;GAaG;AAGI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAAvB;QACL,UAAK,GAAsB,OAAO,CAAC,KAAK,CAAC;QACzC,WAAM,GAAuB,OAAO,CAAC,MAAM,CAAC;IAmE9C,CAAC;IAjEC;;;OAGG;IACH,aAAa;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAI,KAA8D;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;QAEpC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC1D,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC3B,CAAC;gBACD,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,CAAC,GAAe,EAAE,EAAE;gBACjC,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,GAAG,EAAE,CAAC;YACR,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,CAAC,IAAqB,EAAE,EAAE;gBACvC,KAAK,MAAM,GAAG,IAAI,yCAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;oBAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,wCAAe,CAAC,KAAK,EAAE,CAAC;wBACvC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,6CAAoB,EAAE,CAAC,CAAC,CAAC;wBACjD,OAAO;oBACT,CAAC;oBAED,IAAI,CAAC;wBACH,KAAK,CAAC,GAAG,EAAE,CAAC,KAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACzD,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAc,CAAC,CAAC,CAAC;wBACrC,OAAO;oBACT,CAAC;oBAED,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC1D,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AArEY,8CAAiB;4BAAjB,iBAAiB;IAF7B,IAAA,qBAAU,GAAE;IACZ,IAAA,qBAAY,EAAC,qCAAgB,CAAC;GAClB,iBAAiB,CAqE7B"}

package/dist/lib/cjs/mappers/command-event.mapper.js

@@ -5,6 +5,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommandEventMapper = void 0;
 const core_1 = require("@pristine-ts/core");
@@ -12,10 +15,30 @@ const tsyringe_1 = require("tsyringe");
 const command_event_payload_1 = require("../event-payloads/command.event-payload");
 const common_1 = require("@pristine-ts/common");
 const cli_module_keyname_1 = require("../cli.module.keyname");
-const uuid_1 = require("uuid");
+const pristine_argv_1 = require("../utils/pristine-argv");
 let CommandEventMapper = class CommandEventMapper {
+    constructor(eventIdManager) {
+        this.eventIdManager = eventIdManager;
+    }
+    /**
+     * Matches argv that names an explicit command. The no-command shape and the bare
+     * `pristine repl` form are deliberately rejected here; `ReplStartEventMapper` claims
+     * those. Commands typed inside the interactive session are also re-dispatched under
+     * `Cli`, so this mapper handles them too. Argv parsing is delegated to `PristineArgv`,
+     * which scans for the bin token rather than relying on positional indexing.
+     */
     supportsMapping(rawEvent, executionContext) {
-        return executionContext.keyname === core_1.ExecutionContextKeynameEnum.Cli;
+        if (executionContext.keyname !== core_1.ExecutionContextKeynameEnum.Cli) {
+            return false;
+        }
+        if (Array.isArray(rawEvent) === false) {
+            return false;
+        }
+        const argv = new pristine_argv_1.PristineArgv(rawEvent);
+        if (argv.isValid === false) {
+            return false;
+        }
+        return argv.userArgs.length >= 1 && argv.userArgs[0] !== "repl";
     }
     /**
      * Inspired from: https://github.com/eveningkid/args-parser
@@ -23,21 +46,31 @@ let CommandEventMapper = class CommandEventMapper {
      * @param executionContext
      */
     map(rawEvent, executionContext) {
+        // `supportsMapping` already filters out the unsupported shapes — these guards stay only
+        // as a defence in case the pipeline ever invokes `map` without consulting `supportsMapping`.
         if (Array.isArray(rawEvent) === false) {
             throw new Error("If using the 'CLI', process.argv should be passed as the event.");
         }
-        if (rawEvent.length < 3) {
+        const argv = new pristine_argv_1.PristineArgv(rawEvent);
+        if (argv.isValid === false || argv.userArgs.length === 0) {
             throw new Error("If using the 'CLI', there must be at least one command passed");
         }
-        const command = new command_event_payload_1.CommandEventPayload(rawEvent[2], rawEvent[1]);
+        const command = new command_event_payload_1.CommandEventPayload(argv.userArgs[0], argv.scriptPath);
         // if argument starts with - or --, then there is two options. Either there's an equal sign in the string and after the equal sign is the value or the next argument is actually the value
         // for the value, we need to check if it can be a boolean and if not, if it can be a number. If yes, they should be transformed. Else, the value should be a string.
         // If the argument doesn't start with --, then it's value is simply the true boolean
-        const passedArguments = rawEvent.slice(3);
+        const passedArguments = argv.userArgs.slice(1);
         for (let i = 0; i < passedArguments.length; i++) {
             const arg = passedArguments[i];
             if (arg.startsWith("-") === false) {
+                // Bare (non-dashed) tokens are positionals. Kept as `arguments[arg] = true` for
+                // backward compatibility, and additionally collected in order under the reserved
+                // `_` key so commands like `trace <id>` / `logs <id>` can read a real positional.
                 command.arguments[arg] = true;
+                if (Array.isArray(command.arguments._) === false) {
+                    command.arguments._ = [];
+                }
+                command.arguments._.push(arg);
                 continue;
             }
             const numberOfStartingDashes = arg.startsWith("--") ? 2 : 1;
@@ -90,12 +123,18 @@ let CommandEventMapper = class CommandEventMapper {
             command.arguments[argumentName] = argumentValue;
         }
         return {
-            events: [new core_1.Event("command", command, (0, uuid_1.v4)())],
+            events: [new core_1.Event("command", command, this.eventIdManager.generateEventId())],
             executionOrder: "sequential",
         };
     }
     supportsReverseMapping(eventResponse, response, executionContext) {
-        return executionContext.keyname === core_1.ExecutionContextKeynameEnum.Cli;
+        var _a;
+        if (executionContext.keyname !== core_1.ExecutionContextKeynameEnum.Cli) {
+            return false;
+        }
+        // Reverse-map only the command responses this mapper owns — the REPL-start payload
+        // flows through `ReplStartEventMapper` and would otherwise be silently clobbered here.
+        return ((_a = eventResponse.event) === null || _a === void 0 ? void 0 : _a.payload) instanceof command_event_payload_1.CommandEventPayload;
     }
     /**
      * We want to support returning an exit code directly. This means that in the cli.ts file of the customers, they can directly do:
@@ -112,6 +151,7 @@ exports.CommandEventMapper = CommandEventMapper;
 exports.CommandEventMapper = CommandEventMapper = __decorate([
     (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.EventMapper),
     (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
-    (0, tsyringe_1.injectable)()
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [core_1.EventIdManager])
 ], CommandEventMapper);
 //# sourceMappingURL=command-event.mapper.js.map

package/dist/lib/cjs/mappers/command-event.mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-event.mapper.js","sourceRoot":"","sources":["../../../../src/mappers/command-event.mapper.ts"],"names":[],"mappings":";;;;;;;;;AAAA,4CAO2B;AAC3B,uCAAoC;AACpC,mFAA4E;AAC5E,gDAAgF;AAChF,8DAAuD;AACvD,+BAAkC;AAK3B,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,eAAe,CAAC,QAAa,EAAE,gBAAgD;QAC7E,OAAO,gBAAgB,CAAC,OAAO,KAAK,kCAA2B,CAAC,GAAG,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,QAAa,EAAE,gBAAgD;QACjE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,2CAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAElE,0LAA0L;QAC1L,oKAAoK;QACpK,oFAAoF;QACpF,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,GAAG,GAAW,eAAe,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;gBAClC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBAC9B,SAAS;YACX,CAAC;YAED,MAAM,sBAAsB,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAE5D,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAEvD,gFAAgF;YAChF,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACnD,IAAI,sBAAsB,KAAK,CAAC,IAAI,gBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC3D,MAAM,kBAAkB,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;gBACnE,MAAM,mBAAmB,GAAG,YAAY,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAA;gBAEpE,IAAI,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;oBAC1H,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAa,CAAC,CAAC;gBAC9F,CAAC;gBAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;oBACxD,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAmC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;oBACnG,SAAS;gBACX,CAAC;gBAED,2BAA2B;gBAC3B,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,mBAAmB,CAAC;gBAC5D,SAAS;YACX,CAAC;YAED,+GAA+G;YAC/G,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChF,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;gBACvC,SAAS;YACX,CAAC;YAED,MAAM,aAAa,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAE7C,mGAAmG;YACnG,CAAC,EAAE,CAAC;YAEJ,IAAI,WAAW,GAAQ,UAAU,CAAC,aAAa,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC;gBAC9C,SAAS;YACX,CAAC;YAED,WAAW,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;gBAC3B,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;gBACvC,SAAS;YACX,CAAC;iBAAM,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;gBACnC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;gBACxC,SAAS;YACX,CAAC;YAED,IAAI,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC9G,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAa,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBAClD,OAAO,CAAC,SAAS,CAAC,YAAY,CAAmC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACvF,SAAS;YACX,CAAC;YAED,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,aAAa,CAAC;QAClD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,CAAC,IAAI,YAAK,CAAsB,SAAS,EAAE,OAAO,EAAE,IAAA,SAAM,GAAE,CAAC,CAAC;YACtE,cAAc,EAAE,YAAY;SAC7B,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,aAAyD,EAAE,QAAa,EAAE,gBAAgD;QAC/I,OAAO,gBAAgB,CAAC,OAAO,KAAK,kCAA2B,CAAC,GAAG,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,aAAyD,EAAE,QAAa,EAAE,gBAAgD;QACnI,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;CACF,CAAA;AAjHY,gDAAkB;6BAAlB,kBAAkB;IAH9B,IAAA,YAAG,EAAC,iCAAwB,CAAC,WAAW,CAAC;IACzC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;GACA,kBAAkB,CAiH9B"}
+{"version":3,"file":"command-event.mapper.js","sourceRoot":"","sources":["../../../../src/mappers/command-event.mapper.ts"],"names":[],"mappings":"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"}

package/dist/lib/cjs/mappers/mappers.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./command-event.mapper"), exports);
+__exportStar(require("./repl-start-event.mapper"), exports);
 //# sourceMappingURL=mappers.js.map

package/dist/lib/cjs/mappers/mappers.js.map

@@ -1 +1 @@
-{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../../src/mappers/mappers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}
+{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../../src/mappers/mappers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,4DAA0C"}

package/dist/lib/cjs/mappers/repl-start-event.mapper.js

@@ -0,0 +1,80 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplStartEventMapper = void 0;
+const core_1 = require("@pristine-ts/core");
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const start_repl_event_payload_1 = require("../event-payloads/start-repl.event-payload");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const pristine_argv_1 = require("../utils/pristine-argv");
+/**
+ * Maps the "no command" / `repl` argv shapes onto a `StartReplEventPayload` so the kernel
+ * can dispatch the REPL launch through the normal event pipeline — `cli.ts` just calls
+ * `kernel.handle(process.argv, {keyname: Cli})` regardless of whether the user invoked
+ * `pristine`, `pristine repl`, or `pristine <some-command>`.
+ *
+ * Argv parsing is delegated to `PristineArgv`, which scans for the bin token rather than
+ * assuming positional layout — so the rule is runtime-agnostic and survives launchers
+ * that shape argv differently.
+ *
+ * `CommandEventMapper` explicitly excludes these same shapes from its own
+ * `supportsMapping` so the two mappers partition argv space cleanly — no shape is claimed
+ * by both.
+ */
+let ReplStartEventMapper = class ReplStartEventMapper {
+    constructor(eventIdManager) {
+        this.eventIdManager = eventIdManager;
+    }
+    supportsMapping(rawEvent, executionContext) {
+        if (executionContext.keyname !== core_1.ExecutionContextKeynameEnum.Cli) {
+            return false;
+        }
+        if (Array.isArray(rawEvent) === false) {
+            return false;
+        }
+        const argv = new pristine_argv_1.PristineArgv(rawEvent);
+        if (argv.isValid === false) {
+            return false;
+        }
+        // No user args → REPL. First user arg is `repl` → REPL (any tokens after `repl` are
+        // ignored at routing time, by design).
+        return argv.userArgs.length === 0 || argv.userArgs[0] === "repl";
+    }
+    map(rawEvent, executionContext) {
+        const argv = new pristine_argv_1.PristineArgv(Array.isArray(rawEvent) ? rawEvent : []);
+        const payload = new start_repl_event_payload_1.StartReplEventPayload(argv.scriptPath);
+        return {
+            events: [new core_1.Event("start-repl", payload, this.eventIdManager.generateEventId())],
+            executionOrder: "sequential",
+        };
+    }
+    supportsReverseMapping(eventResponse, response, executionContext) {
+        var _a;
+        return executionContext.keyname === core_1.ExecutionContextKeynameEnum.Cli
+            && ((_a = eventResponse.event) === null || _a === void 0 ? void 0 : _a.payload) instanceof start_repl_event_payload_1.StartReplEventPayload;
+    }
+    /**
+     * The REPL handler resolves with the session's exit code; surface it as-is so
+     * `Cli.bootstrap()` can return it to the bin (which calls `process.exit`).
+     */
+    reverseMap(eventResponse, response, executionContext) {
+        return eventResponse.response;
+    }
+};
+exports.ReplStartEventMapper = ReplStartEventMapper;
+exports.ReplStartEventMapper = ReplStartEventMapper = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.EventMapper),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [core_1.EventIdManager])
+], ReplStartEventMapper);
+//# sourceMappingURL=repl-start-event.mapper.js.map