@gobing-ai/ts-utils 0.3.19 → 0.3.21

package/dist/output.d.ts

@@ -15,6 +15,21 @@ export declare function setDefaultOutputTargets(opts: {
     stdout?: WriteTarget;
     stderr?: WriteTarget;
 }): () => void;
+/** Terminates the current process with `code`. Anything matching `(code?: number) => never`. */
+export type ExitTarget = (code?: number) => never;
+/**
+ * Terminate the process with the given exit code — the single sanctioned seam
+ * for `process.exit` in the workspace (enforced by the `no-direct-process-exit`
+ * spur rule). Defaults to `0`. Pass or set an {@link ExitTarget} to intercept
+ * in tests or non-`process` runtimes.
+ */
+export declare function exitProcess(code?: number, target?: ExitTarget): never;
+/**
+ * Override the default exit target.
+ *
+ * Returns a rollback function that restores the previous target.
+ */
+export declare function setDefaultExitTarget(target: ExitTarget | undefined): () => void;
 /** In-memory `WriteTarget` that records all chunks for later retrieval. */
 export interface BufferTarget extends WriteTarget {
     readonly chunks: string[];

package/dist/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAoBD,sDAAsD;AACtD,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,WAA4D,GAAG,IAAI,CAEhH;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,WAA4D,GAAG,IAAI,CAErH;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,MAAM,IAAI,CASxG;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,IAAI,YAAY,CAejD"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAoBD,sDAAsD;AACtD,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,WAA4D,GAAG,IAAI,CAEhH;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,WAA4D,GAAG,IAAI,CAErH;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,MAAM,IAAI,CASxG;AAED,gGAAgG;AAChG,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;AAelD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAAI,EAAE,MAAM,GAAE,UAA+C,GAAG,KAAK,CAEpG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,IAAI,CAM/E;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,IAAI,YAAY,CAejD"}

package/dist/output.js

@@ -38,6 +38,38 @@ export function setDefaultOutputTargets(opts) {
         defaultStderrTarget = prevStderr;
     };
 }
+// Resolved lazily, not at module load: reading `process.exit` eagerly would throw on import in
+// runtimes without `process` (e.g. Cloudflare Workers). `undefined` means "fall back to process".
+let defaultExitTarget;
+function processExit() {
+    const proc = globalThis.process;
+    const exit = proc?.exit;
+    if (exit === undefined) {
+        throw new Error('No exit target available: set one via setDefaultExitTarget or pass an explicit target');
+    }
+    return exit;
+}
+/**
+ * Terminate the process with the given exit code — the single sanctioned seam
+ * for `process.exit` in the workspace (enforced by the `no-direct-process-exit`
+ * spur rule). Defaults to `0`. Pass or set an {@link ExitTarget} to intercept
+ * in tests or non-`process` runtimes.
+ */
+export function exitProcess(code = 0, target = defaultExitTarget ?? processExit()) {
+    return target(code);
+}
+/**
+ * Override the default exit target.
+ *
+ * Returns a rollback function that restores the previous target.
+ */
+export function setDefaultExitTarget(target) {
+    const prev = defaultExitTarget;
+    defaultExitTarget = target;
+    return () => {
+        defaultExitTarget = prev;
+    };
+}
 /** Create an in-memory {@link BufferTarget} for capturing output during tests or tooling. */
 export function createBufferTarget() {
     const chunks = [];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-utils",
-    "version": "0.3.19",
+    "version": "0.3.21",
     "description": "Zero-dependency TypeScript utilities for dates, cursors, errors, output, origins, roles, and API responses.",
     "keywords": [
         "typescript",

package/src/output.ts

@@ -47,6 +47,45 @@ export function setDefaultOutputTargets(opts: { stdout?: WriteTarget; stderr?: W
     };
 }
 
+/** Terminates the current process with `code`. Anything matching `(code?: number) => never`. */
+export type ExitTarget = (code?: number) => never;
+
+// Resolved lazily, not at module load: reading `process.exit` eagerly would throw on import in
+// runtimes without `process` (e.g. Cloudflare Workers). `undefined` means "fall back to process".
+let defaultExitTarget: ExitTarget | undefined;
+
+function processExit(): ExitTarget {
+    const proc = (globalThis as { process?: { exit?: ExitTarget } }).process;
+    const exit = proc?.exit;
+    if (exit === undefined) {
+        throw new Error('No exit target available: set one via setDefaultExitTarget or pass an explicit target');
+    }
+    return exit;
+}
+
+/**
+ * Terminate the process with the given exit code — the single sanctioned seam
+ * for `process.exit` in the workspace (enforced by the `no-direct-process-exit`
+ * spur rule). Defaults to `0`. Pass or set an {@link ExitTarget} to intercept
+ * in tests or non-`process` runtimes.
+ */
+export function exitProcess(code = 0, target: ExitTarget = defaultExitTarget ?? processExit()): never {
+    return target(code);
+}
+
+/**
+ * Override the default exit target.
+ *
+ * Returns a rollback function that restores the previous target.
+ */
+export function setDefaultExitTarget(target: ExitTarget | undefined): () => void {
+    const prev = defaultExitTarget;
+    defaultExitTarget = target;
+    return () => {
+        defaultExitTarget = prev;
+    };
+}
+
 /** In-memory `WriteTarget` that records all chunks for later retrieval. */
 export interface BufferTarget extends WriteTarget {
     readonly chunks: string[];