@pristine-ts/cli 2.0.7 → 2.0.16

package/dist/lib/cjs/commands/requests.command.js

@@ -0,0 +1,88 @@
+"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);
+};
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var RequestsCommand_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestsCommand = void 0;
+const common_1 = require("@pristine-ts/common");
+const tsyringe_1 = require("tsyringe");
+const observability_1 = require("@pristine-ts/observability");
+const cli_output_manager_1 = require("../managers/cli-output.manager");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const requests_command_options_1 = require("./requests.command-options");
+/**
+ * Lists recent requests captured in the observability store — the entry point for
+ * "what just happened, and what's the event id I want to inspect?".
+ *
+ * Pulls summaries from every captured process newest-first. A pure report command: all
+ * output goes through `CliOutput` so it pipes cleanly.
+ *
+ * Flags: `--limit <n>` (default 20).
+ */
+let RequestsCommand = RequestsCommand_1 = class RequestsCommand {
+    constructor(cliOutput, traceStore) {
+        this.cliOutput = cliOutput;
+        this.traceStore = traceStore;
+        this.optionsType = requests_command_options_1.RequestsCommandOptions;
+        this.name = "p:requests";
+        this.description = "List recent requests captured in the observability store.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const limit = (_a = args.limit) !== null && _a !== void 0 ? _a : RequestsCommand_1.DEFAULT_LIMIT;
+            const summaries = this.traceStore.recentRequests(limit);
+            if (summaries.length === 0) {
+                this.cliOutput.writeLine("No captured requests yet. Run your app first.");
+                return common_1.ExitCode.Success;
+            }
+            const headers = ["TIME", "METHOD", "PATH", "STATUS", "DURATION", "EVENT"];
+            const rows = summaries.map(summary => {
+                var _a, _b;
+                return [
+                    new Date(summary.startedAt).toTimeString().slice(0, 8),
+                    (_a = summary.httpMethod) !== null && _a !== void 0 ? _a : "-",
+                    (_b = summary.httpPath) !== null && _b !== void 0 ? _b : summary.rootKeyname,
+                    summary.httpStatus !== undefined ? String(summary.httpStatus) : "-",
+                    `${summary.durationMs}ms`,
+                    summary.eventId,
+                ];
+            });
+            for (const line of this.renderTable(headers, rows)) {
+                this.cliOutput.writeLine(line);
+            }
+            return common_1.ExitCode.Success;
+        });
+    }
+    renderTable(headers, rows) {
+        const widths = headers.map((header, column) => Math.max(header.length, ...rows.map(row => row[column].length)));
+        const formatRow = (cells) => cells.map((cell, column) => cell.padEnd(widths[column])).join("  ").trimEnd();
+        return [formatRow(headers), ...rows.map(formatRow)];
+    }
+};
+exports.RequestsCommand = RequestsCommand;
+RequestsCommand.DEFAULT_LIMIT = 20;
+exports.RequestsCommand = RequestsCommand = RequestsCommand_1 = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [cli_output_manager_1.CliOutput,
+        observability_1.TraceStore])
+], RequestsCommand);
+//# sourceMappingURL=requests.command.js.map

package/dist/lib/cjs/commands/requests.command.js.map

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

package/dist/lib/cjs/commands/trace-alias.command.js

@@ -0,0 +1,49 @@
+"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);
+};
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceAliasCommand = void 0;
+const common_1 = require("@pristine-ts/common");
+const tsyringe_1 = require("tsyringe");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const trace_command_1 = require("./trace.command");
+/**
+ * Top-level alias for `p:trace`.
+ */
+let TraceAliasCommand = class TraceAliasCommand {
+    constructor(delegate) {
+        this.delegate = delegate;
+        this.optionsType = null;
+        this.name = "trace";
+        this.description = "Alias for p:trace.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.delegate.run(args);
+        });
+    }
+};
+exports.TraceAliasCommand = TraceAliasCommand;
+exports.TraceAliasCommand = TraceAliasCommand = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [trace_command_1.TraceCommand])
+], TraceAliasCommand);
+//# sourceMappingURL=trace-alias.command.js.map

package/dist/lib/cjs/commands/trace-alias.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-alias.command.js","sourceRoot":"","sources":["../../../../src/commands/trace-alias.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,gDAA0F;AAC1F,uCAAoC;AAEpC,8DAAuD;AACvD,mDAA6C;AAE7C;;GAEG;AAII,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAK5B,YAA6B,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;QAJnD,gBAAW,GAAG,IAAI,CAAC;QACnB,SAAI,GAAG,OAAO,CAAC;QACf,gBAAW,GAAG,oBAAoB,CAAC;IAGnC,CAAC;IAEK,GAAG,CAAC,IAAS;;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;KAAA;CACF,CAAA;AAXY,8CAAiB;4BAAjB,iBAAiB;IAH7B,IAAA,YAAG,EAAC,iCAAwB,CAAC,OAAO,CAAC;IACrC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;qCAM4B,4BAAY;GALxC,iBAAiB,CAW7B"}

package/dist/lib/cjs/commands/trace.command-options.js

@@ -0,0 +1,59 @@
+"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.TraceCommandOptions = void 0;
+require("reflect-metadata");
+const class_validator_1 = require("@pristine-ts/class-validator");
+/**
+ * Flags + positional for `pristine trace [<id>] [--event-id <x>] [--trace-id <x>] [--request-id <x>] [--format tree|flat|json]`.
+ *
+ * Look up a trace by any of three correlation ids — `--event-id` is canonical,
+ * `--trace-id` covers the distributed-tracing case (a propagated `traceparent`),
+ * `--request-id` covers HTTP requests with an `x-pristine-request-id` header. A
+ * positional id is tried against all three.
+ */
+class TraceCommandOptions {
+    /**
+     * Resolves the lookup id: an explicit flag wins over the positional, and explicit
+     * flags are preferred in `eventId > traceId > requestId` order.
+     */
+    get lookupId() {
+        var _a, _b, _c, _d;
+        return (_c = (_b = (_a = this["event-id"]) !== null && _a !== void 0 ? _a : this["trace-id"]) !== null && _b !== void 0 ? _b : this["request-id"]) !== null && _c !== void 0 ? _c : (_d = this._) === null || _d === void 0 ? void 0 : _d[0];
+    }
+}
+exports.TraceCommandOptions = TraceCommandOptions;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TraceCommandOptions.prototype, "event-id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TraceCommandOptions.prototype, "trace-id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TraceCommandOptions.prototype, "request-id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(["tree", "flat", "json"]),
+    __metadata("design:type", String)
+], TraceCommandOptions.prototype, "format", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], TraceCommandOptions.prototype, "_", void 0);
+//# sourceMappingURL=trace.command-options.js.map

package/dist/lib/cjs/commands/trace.command-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.command-options.js","sourceRoot":"","sources":["../../../../src/commands/trace.command-options.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4BAA0B;AAC1B,kEAAiF;AAIjF;;;;;;;GAOG;AACH,MAAa,mBAAmB;IA8B9B;;;OAGG;IACH,IAAI,QAAQ;;QACV,OAAO,MAAA,MAAA,MAAA,IAAI,CAAC,UAAU,CAAC,mCAAI,IAAI,CAAC,UAAU,CAAC,mCAAI,IAAI,CAAC,YAAY,CAAC,mCAAI,MAAA,IAAI,CAAC,CAAC,0CAAG,CAAC,CAAC,CAAC;IACnF,CAAC;CACF;AArCD,kDAqCC;AAjCC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;qDACS;AAKpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;qDACS;AAKpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;uDACW;AAKtB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,sBAAI,EAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;;mDACV;AASrB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,yBAAO,GAAE;;8CACG"}

package/dist/lib/cjs/commands/trace.command.js

@@ -0,0 +1,84 @@
+"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);
+};
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceCommand = void 0;
+const common_1 = require("@pristine-ts/common");
+const tsyringe_1 = require("tsyringe");
+const observability_1 = require("@pristine-ts/observability");
+const telemetry_1 = require("@pristine-ts/telemetry");
+const cli_output_manager_1 = require("../managers/cli-output.manager");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const trace_command_options_1 = require("./trace.command-options");
+/**
+ * Renders the span tree of one captured trace. Look it up by any of event/trace/request
+ * id — `pristine trace <id>` tries all three, or use the explicit `--event-id`,
+ * `--trace-id`, `--request-id` flags.
+ *
+ * `--format tree|flat|json` controls the rendering (defaults to `tree`).
+ */
+let TraceCommand = class TraceCommand {
+    constructor(cliOutput, traceStore) {
+        this.cliOutput = cliOutput;
+        this.traceStore = traceStore;
+        this.optionsType = trace_command_options_1.TraceCommandOptions;
+        this.name = "p:trace";
+        this.description = "Render the span tree of a captured trace by event/trace/request id.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const lookupId = args.lookupId;
+            if (lookupId === undefined) {
+                this.cliOutput.writeLine("Usage: pristine trace <id> [--format tree|flat|json]");
+                this.cliOutput.writeLine("       pristine trace --event-id <id> | --trace-id <id> | --request-id <id>");
+                return common_1.ExitCode.Error;
+            }
+            const format = (_a = args.format) !== null && _a !== void 0 ? _a : "tree";
+            if (format === "json") {
+                const serialized = this.traceStore.findSerialized(lookupId);
+                if (serialized === undefined) {
+                    this.cliOutput.writeLine(`No trace found matching '${lookupId}'.`);
+                    return common_1.ExitCode.Error;
+                }
+                this.cliOutput.writeLine(JSON.stringify(serialized.trace, null, 2));
+                return common_1.ExitCode.Success;
+            }
+            const found = this.traceStore.find(lookupId);
+            if (found === undefined) {
+                this.cliOutput.writeLine(`No trace found matching '${lookupId}'.`);
+                return common_1.ExitCode.Error;
+            }
+            const rendered = format === "flat"
+                ? telemetry_1.traceRenderer.renderFlat(found.trace)
+                : telemetry_1.traceRenderer.renderTree(found.trace);
+            this.cliOutput.writeLine(rendered);
+            return common_1.ExitCode.Success;
+        });
+    }
+};
+exports.TraceCommand = TraceCommand;
+exports.TraceCommand = TraceCommand = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [cli_output_manager_1.CliOutput,
+        observability_1.TraceStore])
+], TraceCommand);
+//# sourceMappingURL=trace.command.js.map

package/dist/lib/cjs/commands/trace.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.command.js","sourceRoot":"","sources":["../../../../src/commands/trace.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,gDAA0F;AAC1F,uCAAoC;AACpC,8DAAsD;AACtD,sDAAqD;AAErD,uEAAyD;AACzD,8DAAuD;AACvD,mEAA4D;AAE5D;;;;;;GAMG;AAII,IAAM,YAAY,GAAlB,MAAM,YAAY;IAKvB,YACmB,SAAoB,EACpB,UAAsB;QADtB,cAAS,GAAT,SAAS,CAAW;QACpB,eAAU,GAAV,UAAU,CAAY;QANzC,gBAAW,GAAG,2CAAmB,CAAC;QAClC,SAAI,GAAG,SAAS,CAAC;QACjB,gBAAW,GAAG,qEAAqE,CAAC;IAMpF,CAAC;IAEK,GAAG,CAAC,IAAyB;;;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,sDAAsD,CAAC,CAAC;gBACjF,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,6EAA6E,CAAC,CAAC;gBACxG,OAAO,iBAAQ,CAAC,KAAK,CAAC;YACxB,CAAC;YAED,MAAM,MAAM,GAAG,MAAA,IAAI,CAAC,MAAM,mCAAI,MAAM,CAAC;YAErC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAC5D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,4BAA4B,QAAQ,IAAI,CAAC,CAAC;oBACnE,OAAO,iBAAQ,CAAC,KAAK,CAAC;gBACxB,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACpE,OAAO,iBAAQ,CAAC,OAAO,CAAC;YAC1B,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,4BAA4B,QAAQ,IAAI,CAAC,CAAC;gBACnE,OAAO,iBAAQ,CAAC,KAAK,CAAC;YACxB,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,MAAM;gBAChC,CAAC,CAAC,yBAAa,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;gBACvC,CAAC,CAAC,yBAAa,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAEnC,OAAO,iBAAQ,CAAC,OAAO,CAAC;QAC1B,CAAC;KAAA;CACF,CAAA;AA5CY,oCAAY;uBAAZ,YAAY;IAHxB,IAAA,YAAG,EAAC,iCAAwB,CAAC,OAAO,CAAC;IACrC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;qCAOmB,8BAAS;QACR,0BAAU;GAP9B,YAAY,CA4CxB"}

package/dist/lib/cjs/config/config-loader.js

@@ -31,7 +31,8 @@ const dynamic_importer_1 = require("../bootstrap/dynamic-importer");
 /**
  * Loads `pristine.config.ts` (preferred) or `pristine.config.js` (escape hatch for
  * pure-JS projects). Walks up from `process.cwd()` looking for the file, then loads it
- * through `jiti` (for `.ts`) or Node's dynamic `import()` (for `.js`).
+ * through Node's native dynamic `import()`: TypeScript type-stripping (Node >= 22.18)
+ * handles `.ts`, while `.js` loads directly.
  *
  * Returns a `ResolvedPristineConfig` carrying the file path (when found) and per-field
  * provenance, which `pristine p:config:print` uses to render an annotated dump.
@@ -100,26 +101,23 @@ let ConfigLoader = class ConfigLoader {
         }
     }
     /**
-     * Loads a config file from `absolutePath`. `.ts` goes through `jiti`; `.js` uses Node's
-     * native dynamic `import()`. Extracts the default export, falling back to a named
+     * Loads a config file from `absolutePath` via Node's native dynamic `import()`. A `.ts`
+     * config is handled by Node's built-in TypeScript type-stripping (Node >= 22.18); a `.js`
+     * config loads directly. Extracts the default export, falling back to a named
      * `pristineConfig` export for users who prefer not to use `export default`.
      * @private
      */
     importConfigFile(absolutePath) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
-            const ext = path_1.default.extname(absolutePath).toLowerCase();
+            var _a, _b;
             let loaded;
-            if (ext === ".ts") {
-                const jitiModule = yield this.dynamicImporter.import("jiti");
-                const createJiti = (_b = (_a = jitiModule.default) !== null && _a !== void 0 ? _a : jitiModule.createJiti) !== null && _b !== void 0 ? _b : jitiModule;
-                const jiti = createJiti(absolutePath, { interopDefault: true });
-                loaded = jiti(absolutePath);
-            }
-            else {
+            try {
                 loaded = yield this.dynamicImporter.import(`file://${absolutePath}`);
             }
-            const config = (_d = (_c = loaded === null || loaded === void 0 ? void 0 : loaded.default) !== null && _c !== void 0 ? _c : loaded === null || loaded === void 0 ? void 0 : loaded.pristineConfig) !== null && _d !== void 0 ? _d : loaded;
+            catch (error) {
+                throw this.describeImportError(error, absolutePath);
+            }
+            const config = (_b = (_a = loaded === null || loaded === void 0 ? void 0 : loaded.default) !== null && _a !== void 0 ? _a : loaded === null || loaded === void 0 ? void 0 : loaded.pristineConfig) !== null && _b !== void 0 ? _b : loaded;
             if (!config || typeof config !== "object") {
                 throw new Error(`[pristine] Config file at '${absolutePath}' did not export a valid configuration. ` +
                     `Use \`export default defineConfig({ ... })\` or \`export const pristineConfig = { ... }\`.`);
@@ -127,6 +125,29 @@ let ConfigLoader = class ConfigLoader {
             return config;
         });
     }
+    /**
+     * Translates Node's low-level module-loading failures for a `.ts` config into an
+     * actionable error. Native type-stripping has two distinct failure modes worth telling
+     * apart: the running Node is too old (or has stripping disabled) to import `.ts` at all
+     * (`ERR_UNKNOWN_FILE_EXTENSION`), versus a config written with non-erasable TypeScript that
+     * stripping refuses (`ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`). Any other error is passed through
+     * unchanged so genuine config bugs surface as-is.
+     * @private
+     */
+    describeImportError(error, absolutePath) {
+        var _a;
+        if ((error === null || error === void 0 ? void 0 : error.code) === "ERR_UNKNOWN_FILE_EXTENSION") {
+            return new Error(`[pristine] Loading '${absolutePath}' requires Node >= 22.18 (native TypeScript ` +
+                `type-stripping); you are running ${process.version}. Upgrade Node, or rename the ` +
+                `file to 'pristine.config.js'.`);
+        }
+        if ((error === null || error === void 0 ? void 0 : error.code) === "ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX") {
+            return new Error(`[pristine] '${absolutePath}' uses TypeScript that Node cannot type-strip (enum, ` +
+                `namespace, parameter properties, ...). Use only erasable TypeScript in your config, ` +
+                `or rename the file to 'pristine.config.js'.\nOriginal error: ${(_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error}`);
+        }
+        return error instanceof Error ? error : new Error(String(error));
+    }
 };
 exports.ConfigLoader = ConfigLoader;
 exports.ConfigLoader = ConfigLoader = __decorate([

package/dist/lib/cjs/config/config-loader.js.map

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

package/dist/lib/cjs/decorators/command-parameter.decorator.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandParameter = void 0;
+const metadata_1 = require("@pristine-ts/metadata");
+const cli_decorator_metadata_keyname_enum_1 = require("../enums/cli-decorator-metadata-keyname.enum");
+/**
+ * Describes a command-line parameter on a command's options class. Stored as property
+ * metadata and read by the CLI while resolving a command's arguments — before the arguments
+ * are mapped onto the options instance and validated.
+ *
+ * Two behaviors flow from the options:
+ *
+ *   - `flag` rebinds the property to a differently-named flag (the property name is the
+ *     default), so the property and the flag no longer have to be spelled identically.
+ *   - `question` makes the CLI ask for the value interactively when the flag is absent
+ *     (subject to configuration and an interactive terminal). Omit it to never prompt.
+ *
+ * ```ts
+ * import {IsString, IsOptional} from "@pristine-ts/class-validator";
+ * import {commandParameter} from "@pristine-ts/cli";
+ *
+ * export class MigrateCommandOptions {
+ *   @commandParameter({flag: "db-url", question: "What is the database URL?"})
+ *   @IsString()
+ *   databaseUrl?: string;            // bound to --db-url; asked for when missing
+ *
+ *   @commandParameter({flag: "dir"}) // bound to --dir; never asked for
+ *   @IsOptional()
+ *   @IsString()
+ *   migrationsDirectory?: string;
+ * }
+ * ```
+ */
+const commandParameter = (options = {}) => {
+    return (target, propertyKey) => {
+        metadata_1.PropertyMetadata.defineMetadata(target, propertyKey, cli_decorator_metadata_keyname_enum_1.CliDecoratorMetadataKeynameEnum.CommandParameter, options);
+    };
+};
+exports.commandParameter = commandParameter;
+//# sourceMappingURL=command-parameter.decorator.js.map

package/dist/lib/cjs/decorators/command-parameter.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter.decorator.js","sourceRoot":"","sources":["../../../../src/decorators/command-parameter.decorator.ts"],"names":[],"mappings":";;;AAAA,oDAAuD;AACvD,sGAA6F;AAG7F;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACI,MAAM,gBAAgB,GAAG,CAAC,UAAmC,EAAE,EAAE,EAAE;IACxE,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,EAAE;QAC1C,2BAAgB,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,qEAA+B,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAClH,CAAC,CAAC;AACJ,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B"}

package/dist/lib/cjs/decorators/decorators.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./command-parameter.decorator"), exports);
+//# sourceMappingURL=decorators.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../../src/decorators/decorators.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C"}

package/dist/lib/cjs/enums/cli-decorator-metadata-keyname.enum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliDecoratorMetadataKeynameEnum = void 0;
+/**
+ * Metadata keynames written by `@pristine-ts/cli`'s own property/class decorators and read
+ * back when resolving a command's options. Namespaced under `cli:` so they never collide
+ * with the keys other Pristine decorators (validation, data-mapping, mysql, …) store on the
+ * same class.
+ */
+var CliDecoratorMetadataKeynameEnum;
+(function (CliDecoratorMetadataKeynameEnum) {
+    CliDecoratorMetadataKeynameEnum["CommandParameter"] = "cli:command-parameter";
+})(CliDecoratorMetadataKeynameEnum || (exports.CliDecoratorMetadataKeynameEnum = CliDecoratorMetadataKeynameEnum = {}));
+//# sourceMappingURL=cli-decorator-metadata-keyname.enum.js.map

package/dist/lib/cjs/enums/cli-decorator-metadata-keyname.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-decorator-metadata-keyname.enum.js","sourceRoot":"","sources":["../../../../src/enums/cli-decorator-metadata-keyname.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,+BAEX;AAFD,WAAY,+BAA+B;IACzC,6EAA0C,CAAA;AAC5C,CAAC,EAFW,+BAA+B,+CAA/B,+BAA+B,QAE1C"}

package/dist/lib/cjs/enums/enums.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cli-decorator-metadata-keyname.enum"), exports);
+__exportStar(require("./terminal-key-name.enum"), exports);
+//# sourceMappingURL=enums.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../../src/enums/enums.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wEAAsD;AACtD,2DAAyC"}

package/dist/lib/cjs/enums/exit-code.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExitCodeEnum = void 0;
+var ExitCodeEnum;
+(function (ExitCodeEnum) {
+    ExitCodeEnum[ExitCodeEnum["Success"] = 0] = "Success";
+    ExitCodeEnum[ExitCodeEnum["Error"] = 1] = "Error";
+})(ExitCodeEnum || (exports.ExitCodeEnum = ExitCodeEnum = {}));
+//# sourceMappingURL=exit-code.enum.js.map

package/dist/lib/cjs/enums/exit-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-code.enum.js","sourceRoot":"","sources":["../../../../src/enums/exit-code.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,qDAAW,CAAA;IACX,iDAAS,CAAA;AACX,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB"}

package/dist/lib/cjs/enums/terminal-key-name.enum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalKeyName = void 0;
+/**
+ * The kinds of keypress the CLI's interactive prompts understand. `TerminalKeyDecoder`
+ * maps the raw bytes Node delivers from a raw-mode stdin onto one of these; every printable
+ * keystroke collapses to `Character` (with the literal character carried separately on
+ * {@link TerminalKey}). `Other` covers control/escape sequences the prompts don't act on
+ * (function keys, unhandled arrows) so callers can ignore them instead of echoing garbage.
+ */
+var TerminalKeyName;
+(function (TerminalKeyName) {
+    TerminalKeyName["Up"] = "up";
+    TerminalKeyName["Down"] = "down";
+    TerminalKeyName["Enter"] = "enter";
+    TerminalKeyName["Backspace"] = "backspace";
+    TerminalKeyName["CtrlC"] = "ctrl-c";
+    TerminalKeyName["Character"] = "character";
+    TerminalKeyName["Other"] = "other";
+})(TerminalKeyName || (exports.TerminalKeyName = TerminalKeyName = {}));
+//# sourceMappingURL=terminal-key-name.enum.js.map

package/dist/lib/cjs/enums/terminal-key-name.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-key-name.enum.js","sourceRoot":"","sources":["../../../../src/enums/terminal-key-name.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,4BAAS,CAAA;IACT,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,0CAAuB,CAAA;IACvB,mCAAgB,CAAA;IAChB,0CAAuB,CAAA;IACvB,kCAAe,CAAA;AACjB,CAAC,EARW,eAAe,+BAAf,eAAe,QAQ1B"}

package/dist/lib/cjs/errors/cli-error-code.enum.js

@@ -6,12 +6,22 @@ exports.CliErrorCode = void 0;
  * (typed `PristineErrorCode | string`, so any enum value is accepted).
  *
  * Codes here describe CLI-specific failures — command resolution, argument mapping,
- * and argument validation.
+ * argument validation, and command-parameter binding.
  */
 var CliErrorCode;
 (function (CliErrorCode) {
     CliErrorCode["CommandNotFound"] = "COMMAND_NOT_FOUND";
     CliErrorCode["ArgumentMappingFailed"] = "ARGUMENT_MAPPING_FAILED";
     CliErrorCode["ArgumentValidationFailed"] = "ARGUMENT_VALIDATION_FAILED";
+    /**
+     * Two `@commandParameter` properties on the same options class resolve to the same flag.
+     * A programming error in the command's options definition, not bad user input.
+     */
+    CliErrorCode["CommandParameterFlagConflict"] = "COMMAND_PARAMETER_FLAG_CONFLICT";
+    /**
+     * The user cancelled an interactive prompt with `Ctrl+C`. Carried by
+     * `PromptCancelledError` — a clean, user-initiated cancellation, not a failure.
+     */
+    CliErrorCode["PromptCancelled"] = "PROMPT_CANCELLED";
 })(CliErrorCode || (exports.CliErrorCode = CliErrorCode = {}));
 //# sourceMappingURL=cli-error-code.enum.js.map

package/dist/lib/cjs/errors/cli-error-code.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;AACzD,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}
+{"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,YAgBX;AAhBD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;IAEvD;;;OAGG;IACH,gFAAgE,CAAA;IAEhE;;;OAGG;IACH,oDAAoC,CAAA;AACtC,CAAC,EAhBW,YAAY,4BAAZ,YAAY,QAgBvB"}

package/dist/lib/cjs/errors/errors.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./cli-error-code.enum"), exports);
 __exportStar(require("./command-not-found.error"), exports);
+__exportStar(require("./prompt-cancelled.error"), exports);
 //# sourceMappingURL=errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,4DAA0C"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,4DAA0C;AAC1C,2DAAyC"}

package/dist/lib/cjs/errors/prompt-cancelled.error.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptCancelledError = void 0;
+const common_1 = require("@pristine-ts/common");
+const cli_error_code_enum_1 = require("./cli-error-code.enum");
+/**
+ * Thrown when the user cancels an interactive prompt with `Ctrl+C`. A clean, user-initiated
+ * cancellation — not a crash — so it carries `kind: UserError` (the `CliErrorReporter`
+ * renders the message verbatim instead of a stack dump) and exit code `130`, following the
+ * POSIX `128 + SIGINT(2)` convention so shell pipelines can detect the interrupt.
+ *
+ * Callers that treat cancellation as a normal branch (e.g. `BuildStalenessPrompt`) catch it
+ * via `instanceof`; everywhere else it propagates to the reporter for a tidy exit.
+ */
+class PromptCancelledError extends common_1.PristineError {
+    constructor() {
+        super("Prompt cancelled.", {
+            code: cli_error_code_enum_1.CliErrorCode.PromptCancelled,
+            exitCode: 130,
+            kind: common_1.PristineErrorKind.UserError,
+        });
+    }
+}
+exports.PromptCancelledError = PromptCancelledError;
+//# sourceMappingURL=prompt-cancelled.error.js.map

package/dist/lib/cjs/errors/prompt-cancelled.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cancelled.error.js","sourceRoot":"","sources":["../../../../src/errors/prompt-cancelled.error.ts"],"names":[],"mappings":";;;AAAA,gDAAqE;AACrE,+DAAmD;AAEnD;;;;;;;;GAQG;AACH,MAAa,oBAAqB,SAAQ,sBAAa;IACrD;QACE,KAAK,CAAC,mBAAmB,EAAE;YACzB,IAAI,EAAE,kCAAY,CAAC,eAAe;YAClC,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,0BAAiB,CAAC,SAAS;SAClC,CAAC,CAAC;IACL,CAAC;CACF;AARD,oDAQC"}