@effectstream/log 0.100.18 → 0.100.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effectstream/log",
-  "version": "0.100.18",
+  "version": "0.100.19",
   "license": "MIT",
   "homepage": "https://effectstream.github.io/docs/",
   "repository": {
@@ -13,7 +13,7 @@
   },
   "exports": "./src/mod.ts",
   "dependencies": {
-    "@effectstream/utils": "0.100.18",
+    "@effectstream/utils": "0.100.19",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/api-logs": "0.56.0",
     "@opentelemetry/exporter-logs-otlp-http": "0.56.0",

package/src/mod.ts

@@ -11,6 +11,7 @@ export {
 } from "./const.ts";
 export { attachTransport } from "./tslog.ts";
 export { DefaultLogLevels } from "./tslog.ts";
+export { installUnhandledRejectionLogger } from "./process-handlers.ts";
 
 // re-exporting this
 // so that we don't need to re-import opentelemetry in every component

package/src/process-handlers.ts

@@ -0,0 +1,38 @@
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { log } from "./mod.ts";
+
+/**
+ * Install a process-wide `unhandledRejection` handler.
+ *
+ * By default the handler logs the error at ERROR and re-crashes the process
+ * via `process.exit(1)` — preserving the "let it crash" semantic that Node /
+ * Bun apply when no handler is registered. The point of installing this
+ * handler is *visibility*: without it, Bun crashes silently with no log line
+ * about what the rejection actually was.
+ *
+ * Pass `shouldSurvive` to opt specific errors out of the crash — useful for
+ * known-transient failures from external systems (e.g. a pg pool ECONNRESET
+ * from a serverless Postgres cold-start). Surviving errors are logged at
+ * WARN; non-surviving ones at ERROR before exit.
+ *
+ * Idempotent: only the first call in this module registers a listener.
+ */
+let unhandledRejectionLoggerInstalled = false;
+
+export function installUnhandledRejectionLogger(
+  componentName: string,
+  shouldSurvive?: (reason: unknown) => boolean,
+): void {
+  if (unhandledRejectionLoggerInstalled) return;
+  unhandledRejectionLoggerInstalled = true;
+  process.on("unhandledRejection", (reason: unknown) => {
+    const survive = shouldSurvive?.(reason) ?? false;
+    log.remote(
+      componentName,
+      ["unhandledRejection"],
+      survive ? SeverityNumber.WARN : SeverityNumber.ERROR,
+      (log) => log(reason),
+    );
+    if (!survive) process.exit(1);
+  });
+}