@pristine-ts/cli 2.0.4 → 2.0.6

package/dist/lib/esm/reporters/cli-error.reporter.js

@@ -0,0 +1,118 @@
+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);
+};
+import { injectable } from "tsyringe";
+import { ExitCode, PristineError, PristineErrorKind, } from "@pristine-ts/common";
+import { EnvironmentManager, PristineEnvironment } 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.
+ */
+let CliErrorReporter = class CliErrorReporter {
+    constructor(environmentManager) {
+        this.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) {
+        var _a, _b;
+        const e = PristineError.from(error);
+        const isDev = this.environmentManager.getEnvironment() === PristineEnvironment.Development;
+        const isUserError = e.options.kind !== PristineErrorKind.SystemError;
+        // Headline: in production, system errors get a generic message so we don't dump
+        // internal-bug messages to the user. User errors always show their own message.
+        const headline = isUserError || isDev ? e.message : "Internal Error";
+        const code = (_a = e.options.code) !== null && _a !== void 0 ? _a : "ERROR";
+        this.write(`✗ ${code}: ${headline}\n`);
+        // Details: per-error-class structured fields. Surfaced for user errors always, for
+        // system errors only in dev (helps debugging without leaking in prod CI logs).
+        if (e.options.details && (isUserError || isDev)) {
+            for (const [k, v] of Object.entries(e.options.details)) {
+                const rendered = typeof v === "string" ? v : this.safeStringify(v);
+                this.write(`  ${k}: ${rendered}\n`);
+            }
+        }
+        // Stack + cause chain are dev-only. Production stderr stays clean.
+        if (isDev) {
+            if (e.stack) {
+                this.write(`\n${e.stack}\n`);
+            }
+            let current = e.cause;
+            let depth = 0;
+            while (current instanceof Error && depth < 10) {
+                this.write(`\ncaused by: ${current.name}: ${current.message}\n`);
+                if (current.stack)
+                    this.write(`${current.stack}\n`);
+                current = current.cause;
+                depth++;
+            }
+        }
+        // Exit code fallback: ExitCode.Error (1) for user errors, ExitCode.Software (70)
+        // for system errors. Both follow sysexits.h conventions.
+        return (_b = e.options.exitCode) !== null && _b !== void 0 ? _b : (isUserError ? ExitCode.Error : ExitCode.Software);
+    }
+    /**
+     * 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.
+     */
+    write(text) {
+        try {
+            process.stderr.write(text);
+        }
+        catch (_a) {
+            // Nothing useful to do if stderr is unwritable.
+        }
+    }
+    safeStringify(value) {
+        try {
+            return JSON.stringify(value);
+        }
+        catch (_a) {
+            try {
+                return String(value);
+            }
+            catch (_b) {
+                return "[unrepresentable]";
+            }
+        }
+    }
+};
+CliErrorReporter = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [EnvironmentManager])
+], CliErrorReporter);
+export { CliErrorReporter };
+//# sourceMappingURL=cli-error.reporter.js.map

package/dist/lib/esm/reporters/cli-error.reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error.reporter.js","sourceRoot":"","sources":["../../../../src/reporters/cli-error.reporter.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EACL,QAAQ,EACR,aAAa,EACb,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAC,kBAAkB,EAAE,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YACmB,kBAAsC;QAAtC,uBAAkB,GAAlB,kBAAkB,CAAoB;IAEzD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAc;;QACnB,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,cAAc,EAAE,KAAK,mBAAmB,CAAC,WAAW,CAAC;QAC3F,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,iBAAiB,CAAC,WAAW,CAAC;QAErE,gFAAgF;QAChF,gFAAgF;QAChF,MAAM,QAAQ,GAAG,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACrE,MAAM,IAAI,GAAG,MAAA,CAAC,CAAC,OAAO,CAAC,IAAI,mCAAI,OAAO,CAAC;QAEvC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC;QAEvC,mFAAmF;QACnF,+EAA+E;QAC/E,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,EAAE,CAAC;YAChD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;gBACnE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO,GAAa,CAAW,CAAC,KAAK,CAAC;YAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,OAAO,OAAO,YAAY,KAAK,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;gBAC9C,IAAI,CAAC,KAAK,CAAC,gBAAgB,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;gBACjE,IAAI,OAAO,CAAC,KAAK;oBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;gBACpD,OAAO,GAAI,OAAiB,CAAC,KAAK,CAAC;gBACnC,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QAED,iFAAiF;QACjF,yDAAyD;QACzD,OAAO,MAAA,CAAC,CAAC,OAAO,CAAC,QAAQ,mCAAI,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClF,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,IAAY;QACxB,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,WAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,KAAc;QAClC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,WAAM,CAAC;YACP,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAAC,WAAM,CAAC;gBACP,OAAO,mBAAmB,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AA3EY,gBAAgB;IAD5B,UAAU,EAAE;qCAG4B,kBAAkB;GAF9C,gBAAgB,CA2E5B"}