@dispatchitapp/node 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Recursivity LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @dispatchitapp/node
+
+The Node.js server SDK for [Dispatch](https://dispatchit.app). Builds on
+[`@dispatchitapp/core`](../core), adding the two things a server needs that the core can't do
+portably:
+
+- **V8 stack frames with source context** — in-app frames carry the lines around the failing
+  line (`pre_context`/`context_line`/`post_context`), read from disk, exactly like the gem.
+- **Global error handlers** — `process` `uncaughtException` / `unhandledRejection`, the
+  runtime-level analogue of the gem's Rack middleware + `Rails.error` subscriber.
+
+```ts
+import { init, captureException, report } from "@dispatchitapp/node";
+
+init({
+  apiKey: process.env.DISPATCH_API_KEY!,
+  environment: process.env.NODE_ENV,
+  release: process.env.GIT_SHA,
+  // installGlobalHandlers: true (default) — capture uncaught errors + rejections
+});
+
+try {
+  doRiskyThing();
+} catch (err) {
+  captureException(err, { tags: { area: "import" } });
+}
+```
+
+Framework middleware (Express, Fastify) lands in `@dispatchitapp/express` / `@dispatchitapp/fastify` and
+builds on this package. Everything from `@dispatchitapp/core` is re-exported here, so a Node app
+imports solely from `@dispatchitapp/node`.
+
+## Notes
+
+- `init` sets `platform: "node"`, the `dispatch-node` SDK identity, and a source-context stack
+  parser rooted at `cwd` (default `process.cwd()`). `in_app` = under the project root and not in
+  `node_modules` / `node:` internals.
+- The handlers preserve Node's native crash behavior — capture, then print the error and
+  `exit(1)` (registering a listener would otherwise suppress both). `uncaughtException`:
+  override with `onFatalError` or `exitOnUncaught: false`. `unhandledRejection`: fatal by
+  default exactly like Node's own `--unhandled-rejections=throw`; opt out with
+  `exitOnUnhandledRejection: false` (this keeps the process alive, which Node alone would not).
+- Shutdown flush: the event queue drains on `beforeExit` and before any fatal exit, budgeted by
+  `shutdownTimeout` (ms, default 3000; the gem's `shutdown_timeout` analogue). Disable the
+  `beforeExit` hook with `flushOnBeforeExit: false`. Fatal events are tagged
+  `source: uncaughtException` / `unhandledRejection` (the gem's `at_exit` / `rake` analogues).
+
+## Scripts
+
+```bash
+pnpm test · pnpm typecheck · pnpm build
+```

package/dist/index.cjs

@@ -0,0 +1,263 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CONTEXT_LINES: () => CONTEXT_LINES,
+  Client: () => import_core3.Client,
+  MAX_CONTEXT_FRAMES: () => MAX_CONTEXT_FRAMES,
+  SDK_NAME: () => SDK_NAME,
+  SDK_VERSION: () => SDK_VERSION,
+  addSourceContext: () => addSourceContext,
+  buildEvent: () => import_core3.buildEvent,
+  buildTicketPayload: () => import_core3.buildTicketPayload,
+  captureException: () => import_core3.captureException,
+  clearSourceCache: () => clearSourceCache,
+  close: () => import_core3.close,
+  extractRequest: () => extractRequest,
+  flush: () => import_core3.flush,
+  getClient: () => import_core3.getClient,
+  init: () => init,
+  installGlobalHandlers: () => installGlobalHandlers,
+  nodeStackParser: () => nodeStackParser,
+  normalizeUser: () => normalizeUser,
+  parseStack: () => import_core3.parseStack,
+  report: () => import_core3.report,
+  resolveConfig: () => import_core3.resolveConfig
+});
+module.exports = __toCommonJS(index_exports);
+var import_core2 = require("@dispatchitapp/core");
+
+// src/handlers.ts
+function installGlobalHandlers(client, options = {}) {
+  const target = options.target ?? process;
+  const exit = options.exit ?? ((code) => process.exit(code));
+  const flushTimeout = options.flushTimeout ?? client.config.shutdownTimeout;
+  const installed = [];
+  const flushThenExit = (err) => {
+    if (!options.onFatalError) console.error(err);
+    void client.flush(flushTimeout).finally(() => {
+      if (options.onFatalError) options.onFatalError(err);
+      else exit(1);
+    });
+  };
+  if (options.captureUncaughtException !== false) {
+    const onUncaught = (err) => {
+      client.captureException(err, { handled: false, tags: { source: "uncaughtException" } });
+      if (options.exitOnUncaught !== false || options.onFatalError) flushThenExit(err);
+    };
+    target.on("uncaughtException", onUncaught);
+    installed.push(["uncaughtException", onUncaught]);
+  }
+  if (options.captureUnhandledRejections !== false) {
+    const onRejection = (reason) => {
+      client.captureException(reason, { handled: false, tags: { source: "unhandledRejection" } });
+      if (options.exitOnUnhandledRejection !== false || options.onFatalError) flushThenExit(reason);
+    };
+    target.on("unhandledRejection", onRejection);
+    installed.push(["unhandledRejection", onRejection]);
+  }
+  if (options.flushOnBeforeExit !== false) {
+    const onBeforeExit = () => {
+      void client.flush(flushTimeout);
+    };
+    target.on("beforeExit", onBeforeExit);
+    installed.push(["beforeExit", onBeforeExit]);
+  }
+  return () => {
+    for (const [event, listener] of installed) target.removeListener(event, listener);
+  };
+}
+
+// src/stack.ts
+var import_node_path = require("path");
+var import_node_url = require("url");
+var import_core = require("@dispatchitapp/core");
+
+// src/sourceContext.ts
+var import_node_fs = require("fs");
+var CONTEXT_LINES = 5;
+var MAX_CONTEXT_FRAMES = 12;
+var sourceCache = /* @__PURE__ */ new Map();
+function rstrip(line) {
+  return line.replace(/\s+$/, "");
+}
+function sourceLines(path) {
+  const cached = sourceCache.get(path);
+  if (cached !== void 0) return cached;
+  let lines = null;
+  try {
+    lines = (0, import_node_fs.readFileSync)(path, "utf8").split("\n");
+  } catch {
+    lines = null;
+  }
+  sourceCache.set(path, lines);
+  return lines;
+}
+function applyContext(frame) {
+  const path = frame.abs_path;
+  const lineno = frame.lineno;
+  if (!path || !lineno) return;
+  const lines = sourceLines(path);
+  if (!lines) return;
+  const idx = lineno - 1;
+  if (idx < 0 || idx >= lines.length) return;
+  frame.pre_context = lines.slice(Math.max(0, idx - CONTEXT_LINES), idx).map(rstrip);
+  frame.context_line = rstrip(lines[idx]);
+  frame.post_context = lines.slice(idx + 1, idx + 1 + CONTEXT_LINES).map(rstrip);
+}
+function addSourceContext(frames) {
+  let budget = MAX_CONTEXT_FRAMES;
+  for (let i = frames.length - 1; i >= 0 && budget > 0; i--) {
+    const frame = frames[i];
+    if (!frame.in_app) continue;
+    budget--;
+    applyContext(frame);
+  }
+}
+function clearSourceCache() {
+  sourceCache.clear();
+}
+
+// src/stack.ts
+function underRoot(absPath, root) {
+  return absPath === root || absPath.startsWith(root + import_node_path.sep);
+}
+function nodeStackParser(cwd) {
+  return (stack) => {
+    const frames = (0, import_core.parseStack)(stack);
+    for (const frame of frames) {
+      let abs = frame.abs_path ?? null;
+      if (abs && abs.startsWith("file://")) {
+        try {
+          abs = (0, import_node_url.fileURLToPath)(abs);
+        } catch {
+        }
+        frame.abs_path = abs;
+      }
+      if (abs && (0, import_node_path.isAbsolute)(abs) && !abs.includes("node_modules") && underRoot(abs, cwd)) {
+        frame.in_app = true;
+        frame.filename = (0, import_node_path.relative)(cwd, abs);
+      } else {
+        frame.in_app = false;
+      }
+    }
+    addSourceContext(frames);
+    return frames;
+  };
+}
+
+// src/version.ts
+var SDK_NAME = "dispatch-node";
+var SDK_VERSION = "1.0.0";
+
+// src/request.ts
+var SAFE_HEADERS = [
+  ["user-agent", "User-Agent"],
+  ["referer", "Referer"],
+  ["accept", "Accept"],
+  ["content-type", "Content-Type"],
+  ["host", "Host"],
+  ["x-request-id", "X-Request-Id"]
+];
+function headerValue(headers, name) {
+  const value = headers[name];
+  if (Array.isArray(value)) return value[0];
+  return value ?? void 0;
+}
+function safeHeaders(headers) {
+  const out = {};
+  for (const [lower, canonical] of SAFE_HEADERS) {
+    const value = headers[lower];
+    if (value === void 0) continue;
+    out[canonical] = Array.isArray(value) ? value.join(", ") : value;
+  }
+  return out;
+}
+function extractRequest(req) {
+  const headers = req.headers ?? {};
+  const rawUrl = req.originalUrl ?? req.url ?? "";
+  const q = rawUrl.indexOf("?");
+  const path = q >= 0 ? rawUrl.slice(0, q) : rawUrl;
+  const query = q >= 0 ? rawUrl.slice(q + 1) : void 0;
+  const host = headerValue(headers, "host");
+  const scheme = req.protocol || headerValue(headers, "x-forwarded-proto") || (req.socket?.encrypted ? "https" : "http");
+  const forwarded = headerValue(headers, "x-forwarded-for");
+  const ip = req.ip || req.socket?.remoteAddress || (forwarded ? forwarded.split(",")[0].trim() : void 0);
+  const out = {};
+  const url = host ? `${scheme}://${host}${path}` : path || void 0;
+  if (url) out.url = url;
+  if (req.method) out.method = req.method;
+  if (query) out.query_string = query;
+  const hdrs = safeHeaders(headers);
+  if (Object.keys(hdrs).length > 0) out.headers = hdrs;
+  if (ip) out.env = { REMOTE_ADDR: ip };
+  return out;
+}
+function normalizeUser(user) {
+  if (user === null || typeof user !== "object") return void 0;
+  const u = user;
+  const id = u["id"] ?? u["external_id"];
+  const out = {};
+  if (id !== void 0 && id !== null) out.id = String(id);
+  if (typeof u["email"] === "string") out.email = u["email"];
+  return out.id !== void 0 || out.email !== void 0 ? out : void 0;
+}
+
+// src/index.ts
+var import_core3 = require("@dispatchitapp/core");
+function init(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const client = (0, import_core2.init)({
+    ...options,
+    platform: options.platform ?? "node",
+    sdk: options.sdk ?? { name: SDK_NAME, version: SDK_VERSION },
+    parseStack: options.parseStack ?? nodeStackParser(cwd)
+  });
+  if (options.installGlobalHandlers !== false) {
+    installGlobalHandlers(client, options);
+  }
+  return client;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CONTEXT_LINES,
+  Client,
+  MAX_CONTEXT_FRAMES,
+  SDK_NAME,
+  SDK_VERSION,
+  addSourceContext,
+  buildEvent,
+  buildTicketPayload,
+  captureException,
+  clearSourceCache,
+  close,
+  extractRequest,
+  flush,
+  getClient,
+  init,
+  installGlobalHandlers,
+  nodeStackParser,
+  normalizeUser,
+  parseStack,
+  report,
+  resolveConfig
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/handlers.ts","../src/stack.ts","../src/sourceContext.ts","../src/version.ts","../src/request.ts"],"sourcesContent":["// @dispatchitapp/node — the Node.js server SDK.\n//\n// Adds, on top of @dispatchitapp/core: V8 stack frames with source context (the gem's in-app\n// `pre/context/post_context`), and process-level global error handlers — the runtime-level\n// analogue of the gem's Rack middleware + Rails.error subscriber. Framework middleware\n// (Express/Fastify) builds on this in @dispatchitapp/express / @dispatchitapp/fastify.\n\nimport { type Client, type ClientOptions, init as coreInit } from \"@dispatchitapp/core\";\nimport { type GlobalHandlerOptions, installGlobalHandlers } from \"./handlers\";\nimport { nodeStackParser } from \"./stack\";\nimport { SDK_NAME, SDK_VERSION } from \"./version\";\n\nexport interface NodeOptions extends ClientOptions, GlobalHandlerOptions {\n  /** Project root for in_app detection + relative filenames. Default process.cwd(). */\n  cwd?: string;\n  /** Install process-level uncaught/unhandledRejection handlers. Default true. */\n  installGlobalHandlers?: boolean;\n}\n\n// Initialise the default Node client: a \"node\" platform, the dispatch-node SDK identity, the\n// source-context stack parser, and (by default) global handlers. Returns the client.\nexport function init(options: NodeOptions): Client {\n  const cwd = options.cwd ?? process.cwd();\n  const client = coreInit({\n    ...options,\n    platform: options.platform ?? \"node\",\n    sdk: options.sdk ?? { name: SDK_NAME, version: SDK_VERSION },\n    parseStack: options.parseStack ?? nodeStackParser(cwd),\n  });\n\n  if (options.installGlobalHandlers !== false) {\n    installGlobalHandlers(client, options);\n  }\n  return client;\n}\n\n// Node-specific exports.\nexport { nodeStackParser } from \"./stack\";\nexport { addSourceContext, clearSourceCache, CONTEXT_LINES, MAX_CONTEXT_FRAMES } from \"./sourceContext\";\nexport { installGlobalHandlers } from \"./handlers\";\nexport type { GlobalHandlerOptions, ProcessLike } from \"./handlers\";\nexport { extractRequest, normalizeUser } from \"./request\";\nexport type { HttpRequestLike } from \"./request\";\nexport { SDK_NAME, SDK_VERSION } from \"./version\";\n\n// Re-export the core runtime API so consumers import everything from @dispatchitapp/node.\nexport {\n  Client,\n  captureException,\n  report,\n  flush,\n  close,\n  getClient,\n  buildEvent,\n  buildTicketPayload,\n  parseStack,\n  resolveConfig,\n} from \"@dispatchitapp/core\";\nexport type {\n  CaptureContext,\n  ClientOptions,\n  DispatchOptions,\n  DispatchConfig,\n  DispatchEvent,\n  DispatchExceptionValue,\n  DispatchFrame,\n  DispatchUser,\n  DispatchRequest,\n  Level,\n  ReportInput,\n  Tags,\n  TicketPayload,\n  TicketResponse,\n  Transport,\n} from \"@dispatchitapp/core\";\n","import type { Client } from \"@dispatchitapp/core\";\n\ntype Listener = (...args: unknown[]) => void;\n\n// The slice of `process` (or a test double) we need: register and remove listeners.\nexport interface ProcessLike {\n  on(event: string, listener: Listener): unknown;\n  removeListener(event: string, listener: Listener): unknown;\n}\n\nexport interface GlobalHandlerOptions {\n  /** Capture uncaught exceptions. Default true. */\n  captureUncaughtException?: boolean;\n  /** Capture unhandled promise rejections. Default true. */\n  captureUnhandledRejections?: boolean;\n  /** After capturing+flushing an uncaught exception, exit(1). Default true (Node would have\n   *  crashed anyway — continuing leaves the process in an undefined state). */\n  exitOnUncaught?: boolean;\n  /** After capturing+flushing an unhandled rejection, exit(1). Default true: Node's own\n   *  default (--unhandled-rejections=throw) crashes the process, and merely installing a\n   *  listener would silently disable that. We report, then preserve the native outcome. */\n  exitOnUnhandledRejection?: boolean;\n  /** Drain the event queue when the event loop empties (the at_exit-flush analogue of the\n   *  gem's shutdown_timeout drain). Default true. */\n  flushOnBeforeExit?: boolean;\n  /** Flush budget before exit, ms. Default: config.shutdownTimeout (3000). */\n  flushTimeout?: number;\n  /** Called after flush instead of exiting — for custom shutdown (and tests). When set, the\n   *  fatal error is not printed to stderr; the callback owns the response. */\n  onFatalError?: (err: unknown) => void;\n  /** Event target. Defaults to the global process; injectable for tests. */\n  target?: ProcessLike;\n  /** Exit function. Defaults to process.exit; injectable for tests. */\n  exit?: (code: number) => void;\n}\n\n// Wire the client into Node's global error events — the runtime-level analogue of the gem's\n// Rack middleware + at_exit hook. The contract mirrors the gem's: capture, then preserve the\n// runtime's native crash behavior (print the error, exit non-zero) — never swallow.\n// Returns an uninstall function.\nexport function installGlobalHandlers(\n  client: Client,\n  options: GlobalHandlerOptions = {},\n): () => void {\n  const target = options.target ?? (process as unknown as ProcessLike);\n  const exit = options.exit ?? ((code: number) => process.exit(code));\n  const flushTimeout = options.flushTimeout ?? client.config.shutdownTimeout;\n  const installed: Array<[string, Listener]> = [];\n\n  // Flush, then hand off to onFatalError or exit(1). Registering a listener suppresses\n  // Node's native crash report, so we print the error first to keep the trace visible.\n  const flushThenExit = (err: unknown) => {\n    if (!options.onFatalError) console.error(err);\n    void client.flush(flushTimeout).finally(() => {\n      if (options.onFatalError) options.onFatalError(err);\n      else exit(1);\n    });\n  };\n\n  if (options.captureUncaughtException !== false) {\n    const onUncaught: Listener = (err) => {\n      client.captureException(err, { handled: false, tags: { source: \"uncaughtException\" } });\n      if (options.exitOnUncaught !== false || options.onFatalError) flushThenExit(err);\n    };\n    target.on(\"uncaughtException\", onUncaught);\n    installed.push([\"uncaughtException\", onUncaught]);\n  }\n\n  if (options.captureUnhandledRejections !== false) {\n    const onRejection: Listener = (reason) => {\n      client.captureException(reason, { handled: false, tags: { source: \"unhandledRejection\" } });\n      if (options.exitOnUnhandledRejection !== false || options.onFatalError) flushThenExit(reason);\n    };\n    target.on(\"unhandledRejection\", onRejection);\n    installed.push([\"unhandledRejection\", onRejection]);\n  }\n\n  if (options.flushOnBeforeExit !== false) {\n    // A pending fetch keeps the loop alive, so this is mostly insurance for custom\n    // transports — and the closest Node analogue of the gem's at_exit queue drain.\n    const onBeforeExit: Listener = () => {\n      void client.flush(flushTimeout);\n    };\n    target.on(\"beforeExit\", onBeforeExit);\n    installed.push([\"beforeExit\", onBeforeExit]);\n  }\n\n  return () => {\n    for (const [event, listener] of installed) target.removeListener(event, listener);\n  };\n}\n","import { isAbsolute, relative, sep } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { parseStack as coreParseStack, type DispatchFrame } from \"@dispatchitapp/core\";\nimport { addSourceContext } from \"./sourceContext\";\n\nfunction underRoot(absPath: string, root: string): boolean {\n  return absPath === root || absPath.startsWith(root + sep);\n}\n\n// A parseStack tailored to a Node server: starts from core's portable V8 parse, then resolves\n// file:// URLs, recomputes in_app/filename against the project root, and reads source context\n// for in-app frames. Mirrors the gem's EventBuilder frame handling (relative filename, in_app,\n// pre/context/post). Pass the result as the Client's `parseStack`.\nexport function nodeStackParser(cwd: string): (stack?: string | null) => DispatchFrame[] {\n  return (stack?: string | null): DispatchFrame[] => {\n    const frames = coreParseStack(stack);\n\n    for (const frame of frames) {\n      let abs = frame.abs_path ?? null;\n      if (abs && abs.startsWith(\"file://\")) {\n        try {\n          abs = fileURLToPath(abs);\n        } catch {\n          /* keep the original */\n        }\n        frame.abs_path = abs;\n      }\n\n      if (abs && isAbsolute(abs) && !abs.includes(\"node_modules\") && underRoot(abs, cwd)) {\n        frame.in_app = true;\n        frame.filename = relative(cwd, abs);\n      } else {\n        // node: internals, dependencies, or paths outside the project are not app code.\n        frame.in_app = false;\n      }\n    }\n\n    addSourceContext(frames);\n    return frames;\n  };\n}\n","import { readFileSync } from \"node:fs\";\nimport type { DispatchFrame } from \"@dispatchitapp/core\";\n\nexport const CONTEXT_LINES = 5;\nexport const MAX_CONTEXT_FRAMES = 12;\n\n// Cache file contents per path for the process lifetime — a single request's stack often\n// revisits the same file, and source doesn't change under a running process.\nconst sourceCache = new Map<string, string[] | null>();\n\nfunction rstrip(line: string): string {\n  return line.replace(/\\s+$/, \"\");\n}\n\nfunction sourceLines(path: string): string[] | null {\n  const cached = sourceCache.get(path);\n  if (cached !== undefined) return cached;\n  let lines: string[] | null = null;\n  try {\n    lines = readFileSync(path, \"utf8\").split(\"\\n\");\n  } catch {\n    lines = null;\n  }\n  sourceCache.set(path, lines);\n  return lines;\n}\n\nfunction applyContext(frame: DispatchFrame): void {\n  const path = frame.abs_path;\n  const lineno = frame.lineno;\n  if (!path || !lineno) return;\n  const lines = sourceLines(path);\n  if (!lines) return;\n  const idx = lineno - 1;\n  if (idx < 0 || idx >= lines.length) return;\n  frame.pre_context = lines.slice(Math.max(0, idx - CONTEXT_LINES), idx).map(rstrip);\n  frame.context_line = rstrip(lines[idx]!);\n  frame.post_context = lines.slice(idx + 1, idx + 1 + CONTEXT_LINES).map(rstrip);\n}\n\n// Add source context to the most-recent in-app frames (the tail of the oldest-first array),\n// within a per-event budget. Mirrors EventBuilder#annotate_context.\nexport function addSourceContext(frames: DispatchFrame[]): void {\n  let budget = MAX_CONTEXT_FRAMES;\n  for (let i = frames.length - 1; i >= 0 && budget > 0; i--) {\n    const frame = frames[i]!;\n    if (!frame.in_app) continue;\n    budget--;\n    applyContext(frame);\n  }\n}\n\n// Exposed for tests so a fixture file's freshly-written contents aren't masked by the cache.\nexport function clearSourceCache(): void {\n  sourceCache.clear();\n}\n","export const SDK_NAME = \"dispatch-node\";\nexport const SDK_VERSION = \"1.0.0\";\n","import type { DispatchRequest, DispatchUser } from \"@dispatchitapp/core\";\n\n// The header allow-list, lowercased (Node lowercases header keys) → canonical wire name.\n// Same set as the gem's EventBuilder::SAFE_HEADERS.\nconst SAFE_HEADERS: Array<[string, string]> = [\n  [\"user-agent\", \"User-Agent\"],\n  [\"referer\", \"Referer\"],\n  [\"accept\", \"Accept\"],\n  [\"content-type\", \"Content-Type\"],\n  [\"host\", \"Host\"],\n  [\"x-request-id\", \"X-Request-Id\"],\n];\n\ntype HeaderBag = Record<string, string | string[] | undefined>;\n\n// The slice of a Node/Express/Fastify request we read. Kept structural so we depend on no\n// framework types.\nexport interface HttpRequestLike {\n  method?: string;\n  url?: string;\n  originalUrl?: string;\n  headers?: HeaderBag;\n  protocol?: string;\n  ip?: string;\n  socket?: { remoteAddress?: string; encrypted?: boolean };\n}\n\nfunction headerValue(headers: HeaderBag, name: string): string | undefined {\n  const value = headers[name];\n  if (Array.isArray(value)) return value[0];\n  return value ?? undefined;\n}\n\nfunction safeHeaders(headers: HeaderBag): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [lower, canonical] of SAFE_HEADERS) {\n    const value = headers[lower];\n    if (value === undefined) continue;\n    out[canonical] = Array.isArray(value) ? value.join(\", \") : value;\n  }\n  return out;\n}\n\n// Build the contract `request` object from a Node-style request. Best-effort and never throws;\n// only allow-listed headers are included. Mirrors EventBuilder#request_hash.\nexport function extractRequest(req: HttpRequestLike): DispatchRequest {\n  const headers = req.headers ?? {};\n  const rawUrl = req.originalUrl ?? req.url ?? \"\";\n  const q = rawUrl.indexOf(\"?\");\n  const path = q >= 0 ? rawUrl.slice(0, q) : rawUrl;\n  const query = q >= 0 ? rawUrl.slice(q + 1) : undefined;\n\n  const host = headerValue(headers, \"host\");\n  const scheme =\n    req.protocol ||\n    headerValue(headers, \"x-forwarded-proto\") ||\n    (req.socket?.encrypted ? \"https\" : \"http\");\n  const forwarded = headerValue(headers, \"x-forwarded-for\");\n  const ip =\n    req.ip ||\n    req.socket?.remoteAddress ||\n    (forwarded ? forwarded.split(\",\")[0]!.trim() : undefined);\n\n  const out: DispatchRequest = {};\n  const url = host ? `${scheme}://${host}${path}` : path || undefined;\n  if (url) out.url = url;\n  if (req.method) out.method = req.method;\n  if (query) out.query_string = query;\n  const hdrs = safeHeaders(headers);\n  if (Object.keys(hdrs).length > 0) out.headers = hdrs;\n  if (ip) out.env = { REMOTE_ADDR: ip };\n  return out;\n}\n\n// Normalise a resolved user object (from a `user` callback or req.user) into the contract's\n// { id, email } shape — accepting both `id` and the gem's `external_id`. Returns undefined when\n// there's nothing usable, so the event falls back to the configured user.\nexport function normalizeUser(user: unknown): DispatchUser | undefined {\n  if (user === null || typeof user !== \"object\") return undefined;\n  const u = user as Record<string, unknown>;\n  const id = u[\"id\"] ?? u[\"external_id\"];\n  const out: DispatchUser = {};\n  if (id !== undefined && id !== null) out.id = String(id);\n  if (typeof u[\"email\"] === \"string\") out.email = u[\"email\"];\n  return out.id !== undefined || out.email !== undefined ? out : undefined;\n}\n"],"mappings":"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","names":["import_core","coreParseStack","import_core","coreInit"]}

package/dist/index.d.cts

@@ -0,0 +1,70 @@
+import { Client, DispatchFrame, DispatchRequest, DispatchUser, ClientOptions } from '@dispatchitapp/core';
+export { CaptureContext, Client, ClientOptions, DispatchConfig, DispatchEvent, DispatchExceptionValue, DispatchFrame, DispatchOptions, DispatchRequest, DispatchUser, Level, ReportInput, Tags, TicketPayload, TicketResponse, Transport, buildEvent, buildTicketPayload, captureException, close, flush, getClient, parseStack, report, resolveConfig } from '@dispatchitapp/core';
+
+type Listener = (...args: unknown[]) => void;
+interface ProcessLike {
+    on(event: string, listener: Listener): unknown;
+    removeListener(event: string, listener: Listener): unknown;
+}
+interface GlobalHandlerOptions {
+    /** Capture uncaught exceptions. Default true. */
+    captureUncaughtException?: boolean;
+    /** Capture unhandled promise rejections. Default true. */
+    captureUnhandledRejections?: boolean;
+    /** After capturing+flushing an uncaught exception, exit(1). Default true (Node would have
+     *  crashed anyway — continuing leaves the process in an undefined state). */
+    exitOnUncaught?: boolean;
+    /** After capturing+flushing an unhandled rejection, exit(1). Default true: Node's own
+     *  default (--unhandled-rejections=throw) crashes the process, and merely installing a
+     *  listener would silently disable that. We report, then preserve the native outcome. */
+    exitOnUnhandledRejection?: boolean;
+    /** Drain the event queue when the event loop empties (the at_exit-flush analogue of the
+     *  gem's shutdown_timeout drain). Default true. */
+    flushOnBeforeExit?: boolean;
+    /** Flush budget before exit, ms. Default: config.shutdownTimeout (3000). */
+    flushTimeout?: number;
+    /** Called after flush instead of exiting — for custom shutdown (and tests). When set, the
+     *  fatal error is not printed to stderr; the callback owns the response. */
+    onFatalError?: (err: unknown) => void;
+    /** Event target. Defaults to the global process; injectable for tests. */
+    target?: ProcessLike;
+    /** Exit function. Defaults to process.exit; injectable for tests. */
+    exit?: (code: number) => void;
+}
+declare function installGlobalHandlers(client: Client, options?: GlobalHandlerOptions): () => void;
+
+declare function nodeStackParser(cwd: string): (stack?: string | null) => DispatchFrame[];
+
+declare const CONTEXT_LINES = 5;
+declare const MAX_CONTEXT_FRAMES = 12;
+declare function addSourceContext(frames: DispatchFrame[]): void;
+declare function clearSourceCache(): void;
+
+type HeaderBag = Record<string, string | string[] | undefined>;
+interface HttpRequestLike {
+    method?: string;
+    url?: string;
+    originalUrl?: string;
+    headers?: HeaderBag;
+    protocol?: string;
+    ip?: string;
+    socket?: {
+        remoteAddress?: string;
+        encrypted?: boolean;
+    };
+}
+declare function extractRequest(req: HttpRequestLike): DispatchRequest;
+declare function normalizeUser(user: unknown): DispatchUser | undefined;
+
+declare const SDK_NAME = "dispatch-node";
+declare const SDK_VERSION = "1.0.0";
+
+interface NodeOptions extends ClientOptions, GlobalHandlerOptions {
+    /** Project root for in_app detection + relative filenames. Default process.cwd(). */
+    cwd?: string;
+    /** Install process-level uncaught/unhandledRejection handlers. Default true. */
+    installGlobalHandlers?: boolean;
+}
+declare function init(options: NodeOptions): Client;
+
+export { CONTEXT_LINES, type GlobalHandlerOptions, type HttpRequestLike, MAX_CONTEXT_FRAMES, type NodeOptions, type ProcessLike, SDK_NAME, SDK_VERSION, addSourceContext, clearSourceCache, extractRequest, init, installGlobalHandlers, nodeStackParser, normalizeUser };

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import { Client, DispatchFrame, DispatchRequest, DispatchUser, ClientOptions } from '@dispatchitapp/core';
+export { CaptureContext, Client, ClientOptions, DispatchConfig, DispatchEvent, DispatchExceptionValue, DispatchFrame, DispatchOptions, DispatchRequest, DispatchUser, Level, ReportInput, Tags, TicketPayload, TicketResponse, Transport, buildEvent, buildTicketPayload, captureException, close, flush, getClient, parseStack, report, resolveConfig } from '@dispatchitapp/core';
+
+type Listener = (...args: unknown[]) => void;
+interface ProcessLike {
+    on(event: string, listener: Listener): unknown;
+    removeListener(event: string, listener: Listener): unknown;
+}
+interface GlobalHandlerOptions {
+    /** Capture uncaught exceptions. Default true. */
+    captureUncaughtException?: boolean;
+    /** Capture unhandled promise rejections. Default true. */
+    captureUnhandledRejections?: boolean;
+    /** After capturing+flushing an uncaught exception, exit(1). Default true (Node would have
+     *  crashed anyway — continuing leaves the process in an undefined state). */
+    exitOnUncaught?: boolean;
+    /** After capturing+flushing an unhandled rejection, exit(1). Default true: Node's own
+     *  default (--unhandled-rejections=throw) crashes the process, and merely installing a
+     *  listener would silently disable that. We report, then preserve the native outcome. */
+    exitOnUnhandledRejection?: boolean;
+    /** Drain the event queue when the event loop empties (the at_exit-flush analogue of the
+     *  gem's shutdown_timeout drain). Default true. */
+    flushOnBeforeExit?: boolean;
+    /** Flush budget before exit, ms. Default: config.shutdownTimeout (3000). */
+    flushTimeout?: number;
+    /** Called after flush instead of exiting — for custom shutdown (and tests). When set, the
+     *  fatal error is not printed to stderr; the callback owns the response. */
+    onFatalError?: (err: unknown) => void;
+    /** Event target. Defaults to the global process; injectable for tests. */
+    target?: ProcessLike;
+    /** Exit function. Defaults to process.exit; injectable for tests. */
+    exit?: (code: number) => void;
+}
+declare function installGlobalHandlers(client: Client, options?: GlobalHandlerOptions): () => void;
+
+declare function nodeStackParser(cwd: string): (stack?: string | null) => DispatchFrame[];
+
+declare const CONTEXT_LINES = 5;
+declare const MAX_CONTEXT_FRAMES = 12;
+declare function addSourceContext(frames: DispatchFrame[]): void;
+declare function clearSourceCache(): void;
+
+type HeaderBag = Record<string, string | string[] | undefined>;
+interface HttpRequestLike {
+    method?: string;
+    url?: string;
+    originalUrl?: string;
+    headers?: HeaderBag;
+    protocol?: string;
+    ip?: string;
+    socket?: {
+        remoteAddress?: string;
+        encrypted?: boolean;
+    };
+}
+declare function extractRequest(req: HttpRequestLike): DispatchRequest;
+declare function normalizeUser(user: unknown): DispatchUser | undefined;
+
+declare const SDK_NAME = "dispatch-node";
+declare const SDK_VERSION = "1.0.0";
+
+interface NodeOptions extends ClientOptions, GlobalHandlerOptions {
+    /** Project root for in_app detection + relative filenames. Default process.cwd(). */
+    cwd?: string;
+    /** Install process-level uncaught/unhandledRejection handlers. Default true. */
+    installGlobalHandlers?: boolean;
+}
+declare function init(options: NodeOptions): Client;
+
+export { CONTEXT_LINES, type GlobalHandlerOptions, type HttpRequestLike, MAX_CONTEXT_FRAMES, type NodeOptions, type ProcessLike, SDK_NAME, SDK_VERSION, addSourceContext, clearSourceCache, extractRequest, init, installGlobalHandlers, nodeStackParser, normalizeUser };

package/dist/index.js

@@ -0,0 +1,229 @@
+// src/index.ts
+import { init as coreInit } from "@dispatchitapp/core";
+
+// src/handlers.ts
+function installGlobalHandlers(client, options = {}) {
+  const target = options.target ?? process;
+  const exit = options.exit ?? ((code) => process.exit(code));
+  const flushTimeout = options.flushTimeout ?? client.config.shutdownTimeout;
+  const installed = [];
+  const flushThenExit = (err) => {
+    if (!options.onFatalError) console.error(err);
+    void client.flush(flushTimeout).finally(() => {
+      if (options.onFatalError) options.onFatalError(err);
+      else exit(1);
+    });
+  };
+  if (options.captureUncaughtException !== false) {
+    const onUncaught = (err) => {
+      client.captureException(err, { handled: false, tags: { source: "uncaughtException" } });
+      if (options.exitOnUncaught !== false || options.onFatalError) flushThenExit(err);
+    };
+    target.on("uncaughtException", onUncaught);
+    installed.push(["uncaughtException", onUncaught]);
+  }
+  if (options.captureUnhandledRejections !== false) {
+    const onRejection = (reason) => {
+      client.captureException(reason, { handled: false, tags: { source: "unhandledRejection" } });
+      if (options.exitOnUnhandledRejection !== false || options.onFatalError) flushThenExit(reason);
+    };
+    target.on("unhandledRejection", onRejection);
+    installed.push(["unhandledRejection", onRejection]);
+  }
+  if (options.flushOnBeforeExit !== false) {
+    const onBeforeExit = () => {
+      void client.flush(flushTimeout);
+    };
+    target.on("beforeExit", onBeforeExit);
+    installed.push(["beforeExit", onBeforeExit]);
+  }
+  return () => {
+    for (const [event, listener] of installed) target.removeListener(event, listener);
+  };
+}
+
+// src/stack.ts
+import { isAbsolute, relative, sep } from "path";
+import { fileURLToPath } from "url";
+import { parseStack as coreParseStack } from "@dispatchitapp/core";
+
+// src/sourceContext.ts
+import { readFileSync } from "fs";
+var CONTEXT_LINES = 5;
+var MAX_CONTEXT_FRAMES = 12;
+var sourceCache = /* @__PURE__ */ new Map();
+function rstrip(line) {
+  return line.replace(/\s+$/, "");
+}
+function sourceLines(path) {
+  const cached = sourceCache.get(path);
+  if (cached !== void 0) return cached;
+  let lines = null;
+  try {
+    lines = readFileSync(path, "utf8").split("\n");
+  } catch {
+    lines = null;
+  }
+  sourceCache.set(path, lines);
+  return lines;
+}
+function applyContext(frame) {
+  const path = frame.abs_path;
+  const lineno = frame.lineno;
+  if (!path || !lineno) return;
+  const lines = sourceLines(path);
+  if (!lines) return;
+  const idx = lineno - 1;
+  if (idx < 0 || idx >= lines.length) return;
+  frame.pre_context = lines.slice(Math.max(0, idx - CONTEXT_LINES), idx).map(rstrip);
+  frame.context_line = rstrip(lines[idx]);
+  frame.post_context = lines.slice(idx + 1, idx + 1 + CONTEXT_LINES).map(rstrip);
+}
+function addSourceContext(frames) {
+  let budget = MAX_CONTEXT_FRAMES;
+  for (let i = frames.length - 1; i >= 0 && budget > 0; i--) {
+    const frame = frames[i];
+    if (!frame.in_app) continue;
+    budget--;
+    applyContext(frame);
+  }
+}
+function clearSourceCache() {
+  sourceCache.clear();
+}
+
+// src/stack.ts
+function underRoot(absPath, root) {
+  return absPath === root || absPath.startsWith(root + sep);
+}
+function nodeStackParser(cwd) {
+  return (stack) => {
+    const frames = coreParseStack(stack);
+    for (const frame of frames) {
+      let abs = frame.abs_path ?? null;
+      if (abs && abs.startsWith("file://")) {
+        try {
+          abs = fileURLToPath(abs);
+        } catch {
+        }
+        frame.abs_path = abs;
+      }
+      if (abs && isAbsolute(abs) && !abs.includes("node_modules") && underRoot(abs, cwd)) {
+        frame.in_app = true;
+        frame.filename = relative(cwd, abs);
+      } else {
+        frame.in_app = false;
+      }
+    }
+    addSourceContext(frames);
+    return frames;
+  };
+}
+
+// src/version.ts
+var SDK_NAME = "dispatch-node";
+var SDK_VERSION = "1.0.0";
+
+// src/request.ts
+var SAFE_HEADERS = [
+  ["user-agent", "User-Agent"],
+  ["referer", "Referer"],
+  ["accept", "Accept"],
+  ["content-type", "Content-Type"],
+  ["host", "Host"],
+  ["x-request-id", "X-Request-Id"]
+];
+function headerValue(headers, name) {
+  const value = headers[name];
+  if (Array.isArray(value)) return value[0];
+  return value ?? void 0;
+}
+function safeHeaders(headers) {
+  const out = {};
+  for (const [lower, canonical] of SAFE_HEADERS) {
+    const value = headers[lower];
+    if (value === void 0) continue;
+    out[canonical] = Array.isArray(value) ? value.join(", ") : value;
+  }
+  return out;
+}
+function extractRequest(req) {
+  const headers = req.headers ?? {};
+  const rawUrl = req.originalUrl ?? req.url ?? "";
+  const q = rawUrl.indexOf("?");
+  const path = q >= 0 ? rawUrl.slice(0, q) : rawUrl;
+  const query = q >= 0 ? rawUrl.slice(q + 1) : void 0;
+  const host = headerValue(headers, "host");
+  const scheme = req.protocol || headerValue(headers, "x-forwarded-proto") || (req.socket?.encrypted ? "https" : "http");
+  const forwarded = headerValue(headers, "x-forwarded-for");
+  const ip = req.ip || req.socket?.remoteAddress || (forwarded ? forwarded.split(",")[0].trim() : void 0);
+  const out = {};
+  const url = host ? `${scheme}://${host}${path}` : path || void 0;
+  if (url) out.url = url;
+  if (req.method) out.method = req.method;
+  if (query) out.query_string = query;
+  const hdrs = safeHeaders(headers);
+  if (Object.keys(hdrs).length > 0) out.headers = hdrs;
+  if (ip) out.env = { REMOTE_ADDR: ip };
+  return out;
+}
+function normalizeUser(user) {
+  if (user === null || typeof user !== "object") return void 0;
+  const u = user;
+  const id = u["id"] ?? u["external_id"];
+  const out = {};
+  if (id !== void 0 && id !== null) out.id = String(id);
+  if (typeof u["email"] === "string") out.email = u["email"];
+  return out.id !== void 0 || out.email !== void 0 ? out : void 0;
+}
+
+// src/index.ts
+import {
+  Client,
+  captureException,
+  report,
+  flush,
+  close,
+  getClient,
+  buildEvent,
+  buildTicketPayload,
+  parseStack,
+  resolveConfig
+} from "@dispatchitapp/core";
+function init(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const client = coreInit({
+    ...options,
+    platform: options.platform ?? "node",
+    sdk: options.sdk ?? { name: SDK_NAME, version: SDK_VERSION },
+    parseStack: options.parseStack ?? nodeStackParser(cwd)
+  });
+  if (options.installGlobalHandlers !== false) {
+    installGlobalHandlers(client, options);
+  }
+  return client;
+}
+export {
+  CONTEXT_LINES,
+  Client,
+  MAX_CONTEXT_FRAMES,
+  SDK_NAME,
+  SDK_VERSION,
+  addSourceContext,
+  buildEvent,
+  buildTicketPayload,
+  captureException,
+  clearSourceCache,
+  close,
+  extractRequest,
+  flush,
+  getClient,
+  init,
+  installGlobalHandlers,
+  nodeStackParser,
+  normalizeUser,
+  parseStack,
+  report,
+  resolveConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/handlers.ts","../src/stack.ts","../src/sourceContext.ts","../src/version.ts","../src/request.ts"],"sourcesContent":["// @dispatchitapp/node — the Node.js server SDK.\n//\n// Adds, on top of @dispatchitapp/core: V8 stack frames with source context (the gem's in-app\n// `pre/context/post_context`), and process-level global error handlers — the runtime-level\n// analogue of the gem's Rack middleware + Rails.error subscriber. Framework middleware\n// (Express/Fastify) builds on this in @dispatchitapp/express / @dispatchitapp/fastify.\n\nimport { type Client, type ClientOptions, init as coreInit } from \"@dispatchitapp/core\";\nimport { type GlobalHandlerOptions, installGlobalHandlers } from \"./handlers\";\nimport { nodeStackParser } from \"./stack\";\nimport { SDK_NAME, SDK_VERSION } from \"./version\";\n\nexport interface NodeOptions extends ClientOptions, GlobalHandlerOptions {\n  /** Project root for in_app detection + relative filenames. Default process.cwd(). */\n  cwd?: string;\n  /** Install process-level uncaught/unhandledRejection handlers. Default true. */\n  installGlobalHandlers?: boolean;\n}\n\n// Initialise the default Node client: a \"node\" platform, the dispatch-node SDK identity, the\n// source-context stack parser, and (by default) global handlers. Returns the client.\nexport function init(options: NodeOptions): Client {\n  const cwd = options.cwd ?? process.cwd();\n  const client = coreInit({\n    ...options,\n    platform: options.platform ?? \"node\",\n    sdk: options.sdk ?? { name: SDK_NAME, version: SDK_VERSION },\n    parseStack: options.parseStack ?? nodeStackParser(cwd),\n  });\n\n  if (options.installGlobalHandlers !== false) {\n    installGlobalHandlers(client, options);\n  }\n  return client;\n}\n\n// Node-specific exports.\nexport { nodeStackParser } from \"./stack\";\nexport { addSourceContext, clearSourceCache, CONTEXT_LINES, MAX_CONTEXT_FRAMES } from \"./sourceContext\";\nexport { installGlobalHandlers } from \"./handlers\";\nexport type { GlobalHandlerOptions, ProcessLike } from \"./handlers\";\nexport { extractRequest, normalizeUser } from \"./request\";\nexport type { HttpRequestLike } from \"./request\";\nexport { SDK_NAME, SDK_VERSION } from \"./version\";\n\n// Re-export the core runtime API so consumers import everything from @dispatchitapp/node.\nexport {\n  Client,\n  captureException,\n  report,\n  flush,\n  close,\n  getClient,\n  buildEvent,\n  buildTicketPayload,\n  parseStack,\n  resolveConfig,\n} from \"@dispatchitapp/core\";\nexport type {\n  CaptureContext,\n  ClientOptions,\n  DispatchOptions,\n  DispatchConfig,\n  DispatchEvent,\n  DispatchExceptionValue,\n  DispatchFrame,\n  DispatchUser,\n  DispatchRequest,\n  Level,\n  ReportInput,\n  Tags,\n  TicketPayload,\n  TicketResponse,\n  Transport,\n} from \"@dispatchitapp/core\";\n","import type { Client } from \"@dispatchitapp/core\";\n\ntype Listener = (...args: unknown[]) => void;\n\n// The slice of `process` (or a test double) we need: register and remove listeners.\nexport interface ProcessLike {\n  on(event: string, listener: Listener): unknown;\n  removeListener(event: string, listener: Listener): unknown;\n}\n\nexport interface GlobalHandlerOptions {\n  /** Capture uncaught exceptions. Default true. */\n  captureUncaughtException?: boolean;\n  /** Capture unhandled promise rejections. Default true. */\n  captureUnhandledRejections?: boolean;\n  /** After capturing+flushing an uncaught exception, exit(1). Default true (Node would have\n   *  crashed anyway — continuing leaves the process in an undefined state). */\n  exitOnUncaught?: boolean;\n  /** After capturing+flushing an unhandled rejection, exit(1). Default true: Node's own\n   *  default (--unhandled-rejections=throw) crashes the process, and merely installing a\n   *  listener would silently disable that. We report, then preserve the native outcome. */\n  exitOnUnhandledRejection?: boolean;\n  /** Drain the event queue when the event loop empties (the at_exit-flush analogue of the\n   *  gem's shutdown_timeout drain). Default true. */\n  flushOnBeforeExit?: boolean;\n  /** Flush budget before exit, ms. Default: config.shutdownTimeout (3000). */\n  flushTimeout?: number;\n  /** Called after flush instead of exiting — for custom shutdown (and tests). When set, the\n   *  fatal error is not printed to stderr; the callback owns the response. */\n  onFatalError?: (err: unknown) => void;\n  /** Event target. Defaults to the global process; injectable for tests. */\n  target?: ProcessLike;\n  /** Exit function. Defaults to process.exit; injectable for tests. */\n  exit?: (code: number) => void;\n}\n\n// Wire the client into Node's global error events — the runtime-level analogue of the gem's\n// Rack middleware + at_exit hook. The contract mirrors the gem's: capture, then preserve the\n// runtime's native crash behavior (print the error, exit non-zero) — never swallow.\n// Returns an uninstall function.\nexport function installGlobalHandlers(\n  client: Client,\n  options: GlobalHandlerOptions = {},\n): () => void {\n  const target = options.target ?? (process as unknown as ProcessLike);\n  const exit = options.exit ?? ((code: number) => process.exit(code));\n  const flushTimeout = options.flushTimeout ?? client.config.shutdownTimeout;\n  const installed: Array<[string, Listener]> = [];\n\n  // Flush, then hand off to onFatalError or exit(1). Registering a listener suppresses\n  // Node's native crash report, so we print the error first to keep the trace visible.\n  const flushThenExit = (err: unknown) => {\n    if (!options.onFatalError) console.error(err);\n    void client.flush(flushTimeout).finally(() => {\n      if (options.onFatalError) options.onFatalError(err);\n      else exit(1);\n    });\n  };\n\n  if (options.captureUncaughtException !== false) {\n    const onUncaught: Listener = (err) => {\n      client.captureException(err, { handled: false, tags: { source: \"uncaughtException\" } });\n      if (options.exitOnUncaught !== false || options.onFatalError) flushThenExit(err);\n    };\n    target.on(\"uncaughtException\", onUncaught);\n    installed.push([\"uncaughtException\", onUncaught]);\n  }\n\n  if (options.captureUnhandledRejections !== false) {\n    const onRejection: Listener = (reason) => {\n      client.captureException(reason, { handled: false, tags: { source: \"unhandledRejection\" } });\n      if (options.exitOnUnhandledRejection !== false || options.onFatalError) flushThenExit(reason);\n    };\n    target.on(\"unhandledRejection\", onRejection);\n    installed.push([\"unhandledRejection\", onRejection]);\n  }\n\n  if (options.flushOnBeforeExit !== false) {\n    // A pending fetch keeps the loop alive, so this is mostly insurance for custom\n    // transports — and the closest Node analogue of the gem's at_exit queue drain.\n    const onBeforeExit: Listener = () => {\n      void client.flush(flushTimeout);\n    };\n    target.on(\"beforeExit\", onBeforeExit);\n    installed.push([\"beforeExit\", onBeforeExit]);\n  }\n\n  return () => {\n    for (const [event, listener] of installed) target.removeListener(event, listener);\n  };\n}\n","import { isAbsolute, relative, sep } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { parseStack as coreParseStack, type DispatchFrame } from \"@dispatchitapp/core\";\nimport { addSourceContext } from \"./sourceContext\";\n\nfunction underRoot(absPath: string, root: string): boolean {\n  return absPath === root || absPath.startsWith(root + sep);\n}\n\n// A parseStack tailored to a Node server: starts from core's portable V8 parse, then resolves\n// file:// URLs, recomputes in_app/filename against the project root, and reads source context\n// for in-app frames. Mirrors the gem's EventBuilder frame handling (relative filename, in_app,\n// pre/context/post). Pass the result as the Client's `parseStack`.\nexport function nodeStackParser(cwd: string): (stack?: string | null) => DispatchFrame[] {\n  return (stack?: string | null): DispatchFrame[] => {\n    const frames = coreParseStack(stack);\n\n    for (const frame of frames) {\n      let abs = frame.abs_path ?? null;\n      if (abs && abs.startsWith(\"file://\")) {\n        try {\n          abs = fileURLToPath(abs);\n        } catch {\n          /* keep the original */\n        }\n        frame.abs_path = abs;\n      }\n\n      if (abs && isAbsolute(abs) && !abs.includes(\"node_modules\") && underRoot(abs, cwd)) {\n        frame.in_app = true;\n        frame.filename = relative(cwd, abs);\n      } else {\n        // node: internals, dependencies, or paths outside the project are not app code.\n        frame.in_app = false;\n      }\n    }\n\n    addSourceContext(frames);\n    return frames;\n  };\n}\n","import { readFileSync } from \"node:fs\";\nimport type { DispatchFrame } from \"@dispatchitapp/core\";\n\nexport const CONTEXT_LINES = 5;\nexport const MAX_CONTEXT_FRAMES = 12;\n\n// Cache file contents per path for the process lifetime — a single request's stack often\n// revisits the same file, and source doesn't change under a running process.\nconst sourceCache = new Map<string, string[] | null>();\n\nfunction rstrip(line: string): string {\n  return line.replace(/\\s+$/, \"\");\n}\n\nfunction sourceLines(path: string): string[] | null {\n  const cached = sourceCache.get(path);\n  if (cached !== undefined) return cached;\n  let lines: string[] | null = null;\n  try {\n    lines = readFileSync(path, \"utf8\").split(\"\\n\");\n  } catch {\n    lines = null;\n  }\n  sourceCache.set(path, lines);\n  return lines;\n}\n\nfunction applyContext(frame: DispatchFrame): void {\n  const path = frame.abs_path;\n  const lineno = frame.lineno;\n  if (!path || !lineno) return;\n  const lines = sourceLines(path);\n  if (!lines) return;\n  const idx = lineno - 1;\n  if (idx < 0 || idx >= lines.length) return;\n  frame.pre_context = lines.slice(Math.max(0, idx - CONTEXT_LINES), idx).map(rstrip);\n  frame.context_line = rstrip(lines[idx]!);\n  frame.post_context = lines.slice(idx + 1, idx + 1 + CONTEXT_LINES).map(rstrip);\n}\n\n// Add source context to the most-recent in-app frames (the tail of the oldest-first array),\n// within a per-event budget. Mirrors EventBuilder#annotate_context.\nexport function addSourceContext(frames: DispatchFrame[]): void {\n  let budget = MAX_CONTEXT_FRAMES;\n  for (let i = frames.length - 1; i >= 0 && budget > 0; i--) {\n    const frame = frames[i]!;\n    if (!frame.in_app) continue;\n    budget--;\n    applyContext(frame);\n  }\n}\n\n// Exposed for tests so a fixture file's freshly-written contents aren't masked by the cache.\nexport function clearSourceCache(): void {\n  sourceCache.clear();\n}\n","export const SDK_NAME = \"dispatch-node\";\nexport const SDK_VERSION = \"1.0.0\";\n","import type { DispatchRequest, DispatchUser } from \"@dispatchitapp/core\";\n\n// The header allow-list, lowercased (Node lowercases header keys) → canonical wire name.\n// Same set as the gem's EventBuilder::SAFE_HEADERS.\nconst SAFE_HEADERS: Array<[string, string]> = [\n  [\"user-agent\", \"User-Agent\"],\n  [\"referer\", \"Referer\"],\n  [\"accept\", \"Accept\"],\n  [\"content-type\", \"Content-Type\"],\n  [\"host\", \"Host\"],\n  [\"x-request-id\", \"X-Request-Id\"],\n];\n\ntype HeaderBag = Record<string, string | string[] | undefined>;\n\n// The slice of a Node/Express/Fastify request we read. Kept structural so we depend on no\n// framework types.\nexport interface HttpRequestLike {\n  method?: string;\n  url?: string;\n  originalUrl?: string;\n  headers?: HeaderBag;\n  protocol?: string;\n  ip?: string;\n  socket?: { remoteAddress?: string; encrypted?: boolean };\n}\n\nfunction headerValue(headers: HeaderBag, name: string): string | undefined {\n  const value = headers[name];\n  if (Array.isArray(value)) return value[0];\n  return value ?? undefined;\n}\n\nfunction safeHeaders(headers: HeaderBag): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [lower, canonical] of SAFE_HEADERS) {\n    const value = headers[lower];\n    if (value === undefined) continue;\n    out[canonical] = Array.isArray(value) ? value.join(\", \") : value;\n  }\n  return out;\n}\n\n// Build the contract `request` object from a Node-style request. Best-effort and never throws;\n// only allow-listed headers are included. Mirrors EventBuilder#request_hash.\nexport function extractRequest(req: HttpRequestLike): DispatchRequest {\n  const headers = req.headers ?? {};\n  const rawUrl = req.originalUrl ?? req.url ?? \"\";\n  const q = rawUrl.indexOf(\"?\");\n  const path = q >= 0 ? rawUrl.slice(0, q) : rawUrl;\n  const query = q >= 0 ? rawUrl.slice(q + 1) : undefined;\n\n  const host = headerValue(headers, \"host\");\n  const scheme =\n    req.protocol ||\n    headerValue(headers, \"x-forwarded-proto\") ||\n    (req.socket?.encrypted ? \"https\" : \"http\");\n  const forwarded = headerValue(headers, \"x-forwarded-for\");\n  const ip =\n    req.ip ||\n    req.socket?.remoteAddress ||\n    (forwarded ? forwarded.split(\",\")[0]!.trim() : undefined);\n\n  const out: DispatchRequest = {};\n  const url = host ? `${scheme}://${host}${path}` : path || undefined;\n  if (url) out.url = url;\n  if (req.method) out.method = req.method;\n  if (query) out.query_string = query;\n  const hdrs = safeHeaders(headers);\n  if (Object.keys(hdrs).length > 0) out.headers = hdrs;\n  if (ip) out.env = { REMOTE_ADDR: ip };\n  return out;\n}\n\n// Normalise a resolved user object (from a `user` callback or req.user) into the contract's\n// { id, email } shape — accepting both `id` and the gem's `external_id`. Returns undefined when\n// there's nothing usable, so the event falls back to the configured user.\nexport function normalizeUser(user: unknown): DispatchUser | undefined {\n  if (user === null || typeof user !== \"object\") return undefined;\n  const u = user as Record<string, unknown>;\n  const id = u[\"id\"] ?? u[\"external_id\"];\n  const out: DispatchUser = {};\n  if (id !== undefined && id !== null) out.id = String(id);\n  if (typeof u[\"email\"] === \"string\") out.email = u[\"email\"];\n  return out.id !== undefined || out.email !== undefined ? out : undefined;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@dispatchitapp/node",
+  "version": "1.0.0",
+  "description": "Node.js server SDK for Dispatch: global error handlers, V8 stack frames with source context, on top of @dispatchitapp/core.",
+  "license": "MIT",
+  "author": "Dispatch Team <hello@dispatchit.app>",
+  "homepage": "https://dispatchit.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Recursivity-LLC/dispatch-sdks.git",
+    "directory": "packages/node"
+  },
+  "bugs": "https://github.com/Recursivity-LLC/dispatch-sdks/issues",
+  "keywords": [
+    "error-tracking",
+    "monitoring",
+    "dispatch",
+    "nodejs",
+    "sentry"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@dispatchitapp/core": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit"
+  }
+}