@pristine-ts/cli 2.0.4 → 2.0.6

package/dist/types/errors/errors.d.ts

@@ -1 +1,2 @@
+export * from "./cli-error-code.enum";
 export * from "./command-not-found.error";

package/dist/types/event-handlers/cli.event-handler.d.ts

@@ -5,20 +5,6 @@ import { CommandInterface } from "../interfaces/command.interface";
 import { LogHandlerInterface } from "@pristine-ts/logging";
 import { Validator } from "@pristine-ts/class-validator";
 import { ConsoleManager } from "../managers/console.manager";
-import { ExitCodeEnum } from "../enums/exit-code.enum";
-/**
- * Resolution of a command's argv input. Either we successfully produced an instance of the
- * command's `optionsType` (or the raw args for null-optionsType commands) and `args` is set,
- * OR mapping/validation failed and `exitCode` carries the failure status. Mutually exclusive
- * by construction — `args` is undefined iff `exitCode` is set.
- *
- * Used as the return value of `CliEventHandler.resolveArgs` so the call site can branch on
- * the success/failure case without a thrown exception in the hot path.
- */
-interface ResolvedCommandArgs {
-    args?: any;
-    exitCode?: ExitCodeEnum;
-}
 export declare class CliEventHandler implements EventHandlerInterface<any, any> {
     private readonly logHandler;
     private readonly validator;
@@ -34,12 +20,11 @@ export declare class CliEventHandler implements EventHandlerInterface<any, any>
      * args through unchanged — the legacy escape hatch for commands that want to handle
      * argv parsing themselves.
      *
-     * Mapping or validation failures print the underlying error to the console and return an
-     * `exitCode` so the caller can exit non-zero. Success returns the typed instance under
-     * `args`. The two are mutually exclusive — see `ResolvedCommandArgs`.
+     * Throws `UsageError` for mapping failures and `ValidationError` for class-validator
+     * failures. Both carry structured `details` so `CliErrorReporter` can render them as
+     * readable stderr lines without this method touching the console directly.
      */
-    resolveArgs(command: CommandInterface<any>, rawArgs: any): Promise<ResolvedCommandArgs>;
+    resolveArgs(command: CommandInterface<any>, rawArgs: any): Promise<any>;
     supports(event: Event<any>): boolean;
     private logExitStatus;
 }
-export {};

package/dist/types/interfaces/command.interface.d.ts

@@ -1,5 +1,5 @@
 import { ClassConstructor } from "class-transformer";
-import { ExitCodeEnum } from "../enums/exit-code.enum";
+import { ExitCode } from "@pristine-ts/common";
 /**
  * The contract every CLI command implements. The CliEventHandler reads `optionsType` to
  * map raw `process.argv` flags onto a typed instance of the declared options class, runs
@@ -30,5 +30,5 @@ export interface CommandInterface<T> {
      * Invoked with a validated instance of `optionsType` (when `optionsType` is non-null) or
      * the raw parsed argv shape (when `optionsType` is null). Return an exit code.
      */
-    run(args: T): Promise<ExitCodeEnum | number>;
+    run(args: T): Promise<ExitCode | number>;
 }

package/dist/types/reporters/cli-error.reporter.d.ts

@@ -0,0 +1,45 @@
+import { EnvironmentManager } from "@pristine-ts/core";
+/**
+ * Renders any thrown value to stderr and returns an appropriate process exit code.
+ * Counterpart to networking's `HttpErrorResponder`: same `PristineError`-based contract,
+ * different channel.
+ *
+ * **Production mode** (default): one-line `✗ CODE: message` for `UserError`s; a generic
+ * `Internal Error` for `SystemError`s (raw `Error`s, third-party throws). No stack
+ * trace, no cause chain.
+ *
+ * **Development mode** (`pristine.environment = dev`, env override
+ * `PRISTINE_ENV=dev`): full message even for system errors, structured details
+ * printed below, stack trace and cause chain appended at the end. Useful when debugging
+ * locally.
+ *
+ * Exit code selection: `error.options.exitCode` wins when present. Otherwise:
+ * `ExitCode.Error` (1) for user errors, `ExitCode.Software` (70) for system errors —
+ * both follow `sysexits.h` conventions.
+ *
+ * **Environment source**: `EnvironmentManager` is injected, not read from `process.env`
+ * directly. For the bin script's pre-DI fallback (kernel-boot failures), `bootstrap()`
+ * builds the manager from the configuration that `AppModuleLoader.load()` produced — same
+ * `pristine.environment` value that would have reached DI if the kernel had started. No
+ * code path reads `process.env` directly; env-var input enters exclusively through the
+ * `EnvironmentVariableResolver` registered on `CoreModule`'s configuration definitions.
+ *
+ * **Crash-isolated**: every stderr write is wrapped — if stderr is closed/broken, we
+ * still return an exit code rather than throwing back into the bin's catch handler.
+ */
+export declare class CliErrorReporter {
+    private readonly environmentManager;
+    constructor(environmentManager: EnvironmentManager);
+    /**
+     * Writes the error to stderr and returns the exit code the caller should pass to
+     * `process.exit`. The bin script wraps `bootstrap().catch(err => process.exit(reporter.report(err)))`.
+     */
+    report(error: unknown): number;
+    /**
+     * Wraps `process.stderr.write` so a broken stderr (closed pipe, etc.) doesn't itself
+     * throw and confuse the bin's outer `.catch`. The exit code is the only thing that
+     * matters when stderr is dead.
+     */
+    private write;
+    private safeStringify;
+}

package/dist/types/types/command-event-response.type.d.ts

@@ -1,5 +1,5 @@
 import { EventResponse } from "@pristine-ts/core";
+import { ExitCode } from "@pristine-ts/common";
 import { CommandEventPayload } from "../event-payloads/command.event-payload";
-import { ExitCodeEnum } from "../enums/exit-code.enum";
-export declare class CommandEventResponse extends EventResponse<CommandEventPayload, ExitCodeEnum | number> {
+export declare class CommandEventResponse extends EventResponse<CommandEventPayload, ExitCode | number> {
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pristine-ts/cli",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "",
   "module": "dist/lib/esm/cli.module.js",
   "main": "dist/lib/cjs/cli.module.js",
@@ -25,13 +25,13 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^7.2.0",
-    "@pristine-ts/common": "^2.0.4",
-    "@pristine-ts/core": "^2.0.4",
-    "@pristine-ts/data-mapping": "^2.0.4",
-    "@pristine-ts/data-mapping-common": "^2.0.4",
-    "@pristine-ts/file": "^2.0.4",
-    "@pristine-ts/logging": "^2.0.4",
-    "@pristine-ts/validation": "^2.0.4",
+    "@pristine-ts/common": "^2.0.6",
+    "@pristine-ts/core": "^2.0.6",
+    "@pristine-ts/data-mapping": "^2.0.6",
+    "@pristine-ts/data-mapping-common": "^2.0.6",
+    "@pristine-ts/file": "^2.0.6",
+    "@pristine-ts/logging": "^2.0.6",
+    "@pristine-ts/validation": "^2.0.6",
     "jiti": "^2.4.0",
     "uuid": "^9.0.1"
   },
@@ -72,7 +72,7 @@
       "src/*.{js,ts}"
     ]
   },
-  "gitHead": "f376d34e13c1b17b7764c0b47708148e4e51390b",
+  "gitHead": "539029d624372f9bb1e22e09da7152eabb95c105",
   "repository": {
     "type": "git",
     "url": "https://github.com/magieno/pristine-ts.git",

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

@@ -1,18 +0,0 @@
-"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("./exit-code.enum"), exports);
-//# sourceMappingURL=enums.js.map

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

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

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

@@ -1,9 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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/esm/enums/enums.js

@@ -1,2 +0,0 @@
-export * from "./exit-code.enum";
-//# sourceMappingURL=enums.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../../src/enums/enums.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

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

@@ -1,6 +0,0 @@
-export var ExitCodeEnum;
-(function (ExitCodeEnum) {
-    ExitCodeEnum[ExitCodeEnum["Success"] = 0] = "Success";
-    ExitCodeEnum[ExitCodeEnum["Error"] = 1] = "Error";
-})(ExitCodeEnum || (ExitCodeEnum = {}));
-//# sourceMappingURL=exit-code.enum.js.map

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

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

package/dist/types/enums/enums.d.ts

@@ -1 +0,0 @@
-export * from "./exit-code.enum";

package/dist/types/enums/exit-code.enum.d.ts

@@ -1,4 +0,0 @@
-export declare enum ExitCodeEnum {
-    Success = 0,
-    Error = 1
-}