@rasputin-ai/node 0.5.0-alpha.9 → 0.5.0

package/dist/install-global-handlers.d.ts

@@ -1,18 +1,39 @@
 import type { RasputinClient } from '@rasputin-ai/core';
 export type InstallGlobalHandlersOptions = {
     /**
-     * When we are the only `uncaughtException` listener, flush then `process.exit(1)`
-     * (Node's default is suppressed by any listener). When other listeners exist,
-     * capture + flush only — they own graceful shutdown / exit.
+     * If Rasputin is the only `uncaughtException` listener, flush then exit the
+     * process (Node does this by default when nobody is listening). If you have
+     * other listeners, Rasputin only reports the error and leaves shutdown to you.
      */
     exitOnUncaughtException?: boolean;
-    /** Flush budget before exit. Default 2000ms. */
+    /** How long to wait for queued events before exiting. Default: 2000 ms. */
     flushTimeoutMs?: number;
 };
+type HandlerClient = Pick<RasputinClient, 'captureException' | 'flush'>;
 /**
- * Capture process-level failures outside any request handler.
- * `uncaughtException`: capture → flush → exit only if we are the sole listener.
- * `unhandledRejection`: capture only (do not exit).
+ * Observe process-level failures without becoming the host crash/recovery owner.
+ *
+ * On Node in the default `throw` / `strict` unhandled-rejection modes, Rasputin
+ * does not install `unhandledRejection`. Node then converts the rejection to
+ * `uncaughtException` the same way it would without Rasputin, so an existing
+ * recoverer still runs and a late `rejectionHandled` is unchanged. Capture
+ * happens on `uncaughtException`. Rasputin exits only when no host
+ * `uncaughtException` listener is present. Other Rasputin installations in the
+ * same process share this listener and are not treated as host recovery.
+ *
+ * In `warn`, `none`, and `warn-with-error-code`, installing a listener does
+ * not change exit policy. Rasputin observes only: it never calls
+ * `process.exit` for a rejection, prints when it is the sole host listener and
+ * Node would have printed, and sets `exitCode` only for `warn-with-error-code`.
+ *
+ * Bun is not forced onto Node's conversion model. Bun continues after
+ * unhandled rejections even in `throw` / `strict`; Rasputin observes a
+ * converted `uncaughtException` but does not exit.
+ *
+ * Disable this from `RasputinInit({ installGlobalHandlers: false })` when the
+ * host owns process diagnostics. SIGINT / SIGTERM / beforeExit flush hooks are
+ * separate: `RasputinInit({ installTransportSignalHandlers: false })`.
  */
-export declare const installGlobalHandlers: (client: Pick<RasputinClient, "captureException" | "flush">, options?: InstallGlobalHandlersOptions) => (() => void);
+export declare const installGlobalHandlers: (client: HandlerClient, options?: InstallGlobalHandlersOptions) => (() => void);
+export {};
 //# sourceMappingURL=install-global-handlers.d.ts.map

package/dist/install-global-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-global-handlers.d.ts","sourceRoot":"","sources":["../src/install-global-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,4BAA4B,GAAG;IAC1C;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAQF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GACjC,QAAQ,IAAI,CAAC,cAAc,EAAE,kBAAkB,GAAG,OAAO,CAAC,EAC1D,UAAS,4BAAiC,KACxC,CAAC,MAAM,IAAI,CAuDb,CAAC"}
+{"version":3,"file":"install-global-handlers.d.ts","sourceRoot":"","sources":["../src/install-global-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,4BAA4B,GAAG;IAC1C;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAsDF,KAAK,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC;AA+GxE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,qBAAqB,GACjC,QAAQ,aAAa,EACrB,UAAS,4BAAiC,KACxC,CAAC,MAAM,IAAI,CAcb,CAAC"}