@debugkit/sdk 0.1.0 → 0.2.0

package/dist/client-ekzlpWIR.d.ts

@@ -0,0 +1,220 @@
+import { ContextInput, EventInput, Breadcrumb, Severity, parseStack } from '@debugkit/schema/core';
+
+type Shallow<T> = {
+    [K in keyof T]?: T[K] extends object ? Partial<T[K]> : T[K];
+};
+type ContextPatch = Shallow<ContextInput>;
+/** Merge two context patches one level deep (os, device, app ... are merged field by field). */
+declare function mergeContext(a: ContextPatch, b: ContextPatch): ContextPatch;
+/**
+ * Best-effort context for browsers (React, TanStack Start/Router client, Next client ...).
+ * Safe to call in any runtime: it never touches globals that might not exist.
+ */
+declare function browserContext(): ContextPatch;
+
+/**
+ * Automatic instrumentation installed by `init()`: network requests, console, navigation,
+ * clicks and page lifecycle. Every installer is a no-op on platforms that lack the global it
+ * patches, and returns a function that undoes the patch.
+ */
+interface RequestInfo {
+    method: string;
+    url: string;
+    status?: number;
+    error?: unknown;
+    aborted?: boolean;
+    timedOut?: boolean;
+    durationMs: number;
+    /** Stack captured where the request was made, so a failure points at the calling code. */
+    stack?: string;
+}
+/** What the instrumentation needs from the client. */
+interface AutoSink {
+    request(info: RequestInfo): void;
+    crumb(category: "navigation" | "network" | "ui" | "log", message: string, level?: "debug" | "info" | "warning" | "error", data?: Record<string, string | number | boolean | null>): void;
+    navigated(to: string): void;
+    lifecycle(state: "foreground" | "background"): void;
+    ignored(url: string): boolean;
+}
+/**
+ * "https://api.x.com/v1/orders/8812?token=abc" → "api.x.com/v1/orders/:id". Query strings and
+ * fragments never leave the device (they often carry tokens and personal data), and ids are
+ * replaced so requests group by endpoint. Same-origin URLs keep only the path.
+ */
+declare function normaliseUrl(raw: string): string;
+
+declare const SDK_NAME = "@debugkit/sdk";
+declare const SDK_VERSION = "0.2.0";
+/** Optional persistence so events survive app restarts / offline. e.g. AsyncStorage. */
+interface QueueStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+}
+interface InitOptions {
+    /** URL of the ingest function deployed in your cloud. */
+    endpoint: string;
+    /** Public, write-only key. Safe to ship in the app. */
+    ingestKey: string;
+    app: {
+        id: string;
+        version?: string;
+        build?: string;
+        environment?: string;
+    };
+    /**
+     * Platform context. Defaults to browserContext() in browsers. The framework entry points
+     * (`/expo`, `/react-native`, `/node`) fill this in for you.
+     */
+    context?: ContextPatch;
+    /**
+     * What deBug records on its own once initialised. Everything is on by default; pass `false`
+     * to turn it all off, or switch parts off: `autoCapture: { console: false }`.
+     */
+    autoCapture?: boolean | AutoCaptureOptions;
+    /** Network capture settings. */
+    network?: NetworkOptions;
+    /** Fraction of errors and events to keep, 0 to 1. Sessions are never sampled. Default 1. */
+    sampleRate?: number;
+    /** At most this many errors are sent per minute, and at most a sixth of that for one repeating error. Default 60. */
+    maxErrorsPerMinute?: number;
+    /** @deprecated Use `autoCapture: { errors: false }`. */
+    captureGlobalErrors?: boolean;
+    storage?: QueueStorage;
+    /** How often queued events are sent. 0 disables the timer (edge runtimes): call flush() yourself. Default 5000. */
+    flushIntervalMs?: number;
+    maxBatch?: number;
+    maxBreadcrumbs?: number;
+    /** Drop or edit events before they are sent (PII scrubbing). Return null to drop. */
+    beforeSend?: (e: EventInput) => EventInput | null;
+    fetch?: typeof fetch;
+    debug?: boolean;
+}
+interface AutoCaptureOptions {
+    /** Uncaught errors and unhandled promise rejections. */
+    errors?: boolean;
+    /** fetch and XMLHttpRequest: a breadcrumb for every request, an error for each failed one. */
+    network?: boolean;
+    /** console.warn and console.error as breadcrumbs. */
+    console?: boolean;
+    /** Page changes in browsers (History API), so any router is covered. */
+    navigation?: boolean;
+    /** Clicks on buttons, links and other controls in browsers, by their label. */
+    clicks?: boolean;
+    /** Foreground/background and online/offline as breadcrumbs; flushes when the app is hidden. */
+    lifecycle?: boolean;
+    /** Session start, errored and crashed markers, for crash-free rates per release. */
+    sessions?: boolean;
+}
+interface NetworkOptions {
+    /** URLs never recorded (substring or regex). The ingest endpoint is always skipped. */
+    ignoreUrls?: (string | RegExp)[];
+    /**
+     * Tag requests with a flow by URL, first match wins:
+     * `flows: [["/v2/auth/", "auth.login"], [/\/payments\//, "checkout.payment"]]`.
+     */
+    flows?: [string | RegExp, string][];
+    /** Which HTTP statuses count as failures. Default: 500 and above. Network failures and timeouts always count. */
+    isFailure?: (status: number, url: string) => boolean;
+    /** Requests slower than this get a warning breadcrumb. Default 3000ms. */
+    slowMs?: number;
+}
+interface EventMeta {
+    flow?: string;
+    step?: string;
+    tags?: Record<string, string>;
+}
+declare class DebugClient {
+    private opts;
+    private queue;
+    private crumbs;
+    private session;
+    private user;
+    private timer;
+    private flushing;
+    private backoffUntil;
+    private failures;
+    private ready;
+    private handlersInstalled;
+    private auto;
+    private restores;
+    private sessionState;
+    private lastNav;
+    private limits;
+    /** fetch as it was before instrumentation, so our own uploads are never recorded. */
+    private rawFetch;
+    init(options: InitOptions): this;
+    /** Which automatic captures are on, after defaults. */
+    get autoCapture(): Readonly<Required<AutoCaptureOptions>>;
+    /**
+     * Begin a new session: a fresh id and a "started" marker. Called by `init()`, and by the
+     * React Native entry when the app returns after 30 minutes in the background.
+     */
+    startSession(): void;
+    /** Record a navigation breadcrumb ("from → to"). Repeated paths are ignored. */
+    navigated(to: string): void;
+    get initialized(): boolean;
+    /** Merge extra context (e.g. after an async device lookup). Applies to events sent from now on. */
+    setContext(patch: ContextPatch): void;
+    setUser(id: string | undefined): void;
+    breadcrumb(category: Breadcrumb["category"], message: string, data?: Record<string, string | number | boolean | null>, level?: Breadcrumb["level"]): void;
+    /** Log an error. `flow` is the part of the app it belongs to, e.g. "auth.login". */
+    error(err: unknown, meta?: EventMeta & {
+        severity?: Severity;
+        handled?: boolean;
+        fatal?: boolean;
+    }): void;
+    /** Log a custom event. Use outcome to let deBug compute failure rates per flow. */
+    event(name: string, meta?: EventMeta & {
+        outcome?: "success" | "failure" | "abandoned";
+        props?: Record<string, string | number | boolean | null>;
+    }): void;
+    /**
+     * Wraps an async step: logs a success or failure outcome for the flow, plus the error.
+     * Pass `{ captureError: false }` when the error is already reported elsewhere, e.g. a
+     * server function wrapped in withDebug, so it isn't counted twice.
+     */
+    track<T>(flow: string, step: string, fn: () => Promise<T>, opts?: {
+        captureError?: boolean;
+    }): Promise<T>;
+    flush(): Promise<void>;
+    /** Stop the flush timer, undo automatic instrumentation and send what is queued. */
+    close(): Promise<void>;
+    /** @internal Used by the platform entry points for errors that have no thrown value. */
+    captureError(e: {
+        name: string;
+        message: string;
+        stack?: string;
+        frames?: ReturnType<typeof parseStack>;
+    }, meta: EventMeta & {
+        severity?: Severity;
+        handled?: boolean;
+        fatal?: boolean;
+    }, request?: {
+        method: string;
+        url: string;
+        status?: number;
+        durationMs?: number;
+    }): void;
+    /** Per-minute limits: one runaway error can't flood the queue, the network or your database. */
+    private allowError;
+    private sampled;
+    private enqueue;
+    /** Queue without sampling (sessions must be complete for crash-free rates to be right). */
+    private push;
+    private buildContext;
+    /** Set when the ingest rejects 0.2 fields: it predates them, so send what it understands. */
+    private legacyIngest;
+    private send;
+    private persist;
+    private restore;
+    private installGlobalHandlers;
+    private instrument;
+    private uninstrument;
+    /** The bridge the instrumentation (./auto, and the platform entry points) reports through. */
+    sink(): AutoSink;
+    private isIgnored;
+    private recordRequest;
+    private log;
+}
+
+export { type AutoCaptureOptions as A, type ContextPatch as C, DebugClient as D, type EventMeta as E, type InitOptions as I, type NetworkOptions as N, type QueueStorage as Q, SDK_NAME as S, SDK_VERSION as a, browserContext as b, mergeContext as m, normaliseUrl as n };

package/dist/expo-router.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkKUJ4EW3D_cjs = require('./chunk-KUJ4EW3D.cjs');
-var chunkXEFWRCN4_cjs = require('./chunk-XEFWRCN4.cjs');
+var chunkYELZOB7J_cjs = require('./chunk-YELZOB7J.cjs');
+var chunkEGCXLOFH_cjs = require('./chunk-EGCXLOFH.cjs');
 var expoRouter = require('expo-router');
 
-function useDebugExpoRouter(client = chunkXEFWRCN4_cjs.deBug) {
-  chunkKUJ4EW3D_cjs.useDebugNavigation(expoRouter.usePathname(), client);
+function useDebugExpoRouter(client = chunkEGCXLOFH_cjs.deBug) {
+  chunkYELZOB7J_cjs.useDebugNavigation(expoRouter.usePathname(), client);
 }
 
 exports.useDebugExpoRouter = useDebugExpoRouter;

package/dist/expo-router.d.cts

@@ -1,4 +1,4 @@
-import { D as DebugClient } from './client-drmb0n15.cjs';
+import { D as DebugClient } from './client-ekzlpWIR.cjs';
 import '@debugkit/schema/core';
 
 /**

package/dist/expo-router.d.ts

@@ -1,4 +1,4 @@
-import { D as DebugClient } from './client-drmb0n15.js';
+import { D as DebugClient } from './client-ekzlpWIR.js';
 import '@debugkit/schema/core';
 
 /**

package/dist/expo-router.js

@@ -1,5 +1,5 @@
-import { useDebugNavigation } from './chunk-3UN5VMQU.js';
-import { deBug } from './chunk-VIJ5USKQ.js';
+import { useDebugNavigation } from './chunk-3WRI3DI2.js';
+import { deBug } from './chunk-5C7KJJNO.js';
 import { usePathname } from 'expo-router';
 
 function useDebugExpoRouter(client = deBug) {

package/dist/expo.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkNSWUGBA2_cjs = require('./chunk-NSWUGBA2.cjs');
-var chunkKUJ4EW3D_cjs = require('./chunk-KUJ4EW3D.cjs');
-var chunkXEFWRCN4_cjs = require('./chunk-XEFWRCN4.cjs');
+var chunkNJ6DTUVX_cjs = require('./chunk-NJ6DTUVX.cjs');
+var chunkYELZOB7J_cjs = require('./chunk-YELZOB7J.cjs');
+var chunkEGCXLOFH_cjs = require('./chunk-EGCXLOFH.cjs');
 var Application = require('expo-application');
 var Device = require('expo-device');
 
@@ -52,12 +52,12 @@ function expoContext() {
     }
   };
 }
-function initExpo(options, client = chunkXEFWRCN4_cjs.deBug) {
+function initExpo(options, client = chunkEGCXLOFH_cjs.deBug) {
   var _a;
   const ctx = expoContext();
-  const merged = chunkXEFWRCN4_cjs.mergeContext(ctx, (_a = options.context) != null ? _a : {});
+  const merged = chunkEGCXLOFH_cjs.mergeContext(ctx, (_a = options.context) != null ? _a : {});
   if (!ctx.os) delete merged.os;
-  return chunkNSWUGBA2_cjs.initReactNative(
+  return chunkNJ6DTUVX_cjs.initReactNative(
     { ...options, app: { ...ctx.app, ...options.app }, context: merged },
     client
   );
@@ -65,31 +65,31 @@ function initExpo(options, client = chunkXEFWRCN4_cjs.deBug) {
 
 Object.defineProperty(exports, "initReactNative", {
   enumerable: true,
-  get: function () { return chunkNSWUGBA2_cjs.initReactNative; }
+  get: function () { return chunkNJ6DTUVX_cjs.initReactNative; }
 });
 Object.defineProperty(exports, "nativeContext", {
   enumerable: true,
-  get: function () { return chunkNSWUGBA2_cjs.nativeContext; }
+  get: function () { return chunkNJ6DTUVX_cjs.nativeContext; }
 });
 Object.defineProperty(exports, "trackReactNavigation", {
   enumerable: true,
-  get: function () { return chunkNSWUGBA2_cjs.trackReactNavigation; }
+  get: function () { return chunkNJ6DTUVX_cjs.trackReactNavigation; }
 });
 Object.defineProperty(exports, "DebugErrorBoundary", {
   enumerable: true,
-  get: function () { return chunkKUJ4EW3D_cjs.DebugErrorBoundary; }
+  get: function () { return chunkYELZOB7J_cjs.DebugErrorBoundary; }
 });
 Object.defineProperty(exports, "trackTanStackRouter", {
   enumerable: true,
-  get: function () { return chunkKUJ4EW3D_cjs.trackTanStackRouter; }
+  get: function () { return chunkYELZOB7J_cjs.trackTanStackRouter; }
 });
 Object.defineProperty(exports, "useDebugNavigation", {
   enumerable: true,
-  get: function () { return chunkKUJ4EW3D_cjs.useDebugNavigation; }
+  get: function () { return chunkYELZOB7J_cjs.useDebugNavigation; }
 });
 Object.defineProperty(exports, "deBug", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.deBug; }
+  get: function () { return chunkEGCXLOFH_cjs.deBug; }
 });
 exports.expoContext = expoContext;
 exports.initExpo = initExpo;

package/dist/expo.d.cts

@@ -1,5 +1,5 @@
 export { deBug } from './index.cjs';
-import { C as ContextPatch, D as DebugClient } from './client-drmb0n15.cjs';
+import { C as ContextPatch, D as DebugClient } from './client-ekzlpWIR.cjs';
 import { ReactNativeInitOptions } from './react-native.cjs';
 export { DeviceInfoModule, initReactNative, nativeContext, trackReactNavigation } from './react-native.cjs';
 export { DebugErrorBoundary, DebugErrorBoundaryProps, trackTanStackRouter, useDebugNavigation } from './react.cjs';

package/dist/expo.d.ts

@@ -1,5 +1,5 @@
 export { deBug } from './index.js';
-import { C as ContextPatch, D as DebugClient } from './client-drmb0n15.js';
+import { C as ContextPatch, D as DebugClient } from './client-ekzlpWIR.js';
 import { ReactNativeInitOptions } from './react-native.js';
 export { DeviceInfoModule, initReactNative, nativeContext, trackReactNavigation } from './react-native.js';
 export { DebugErrorBoundary, DebugErrorBoundaryProps, trackTanStackRouter, useDebugNavigation } from './react.js';

package/dist/expo.js

@@ -1,8 +1,8 @@
-import { initReactNative } from './chunk-BD2FNVCP.js';
-export { initReactNative, nativeContext, trackReactNavigation } from './chunk-BD2FNVCP.js';
-export { DebugErrorBoundary, trackTanStackRouter, useDebugNavigation } from './chunk-3UN5VMQU.js';
-import { deBug, mergeContext } from './chunk-VIJ5USKQ.js';
-export { deBug } from './chunk-VIJ5USKQ.js';
+import { initReactNative } from './chunk-HO3JW55K.js';
+export { initReactNative, nativeContext, trackReactNavigation } from './chunk-HO3JW55K.js';
+export { DebugErrorBoundary, trackTanStackRouter, useDebugNavigation } from './chunk-3WRI3DI2.js';
+import { deBug, mergeContext } from './chunk-5C7KJJNO.js';
+export { deBug } from './chunk-5C7KJJNO.js';
 import * as Application from 'expo-application';
 import * as Device from 'expo-device';
 

package/dist/index.cjs

@@ -1,36 +1,40 @@
 'use strict';
 
-var chunkXEFWRCN4_cjs = require('./chunk-XEFWRCN4.cjs');
+var chunkEGCXLOFH_cjs = require('./chunk-EGCXLOFH.cjs');
 
 
 
 Object.defineProperty(exports, "DebugClient", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.DebugClient; }
+  get: function () { return chunkEGCXLOFH_cjs.DebugClient; }
 });
 Object.defineProperty(exports, "SDK_NAME", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.SDK_NAME; }
+  get: function () { return chunkEGCXLOFH_cjs.SDK_NAME; }
 });
 Object.defineProperty(exports, "SDK_VERSION", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.SDK_VERSION; }
+  get: function () { return chunkEGCXLOFH_cjs.SDK_VERSION; }
 });
 Object.defineProperty(exports, "browserContext", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.browserContext; }
+  get: function () { return chunkEGCXLOFH_cjs.browserContext; }
 });
 Object.defineProperty(exports, "deBug", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.deBug; }
+  get: function () { return chunkEGCXLOFH_cjs.deBug; }
 });
 Object.defineProperty(exports, "mergeContext", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.mergeContext; }
+  get: function () { return chunkEGCXLOFH_cjs.mergeContext; }
+});
+Object.defineProperty(exports, "normaliseUrl", {
+  enumerable: true,
+  get: function () { return chunkEGCXLOFH_cjs.normaliseUrl; }
 });
 Object.defineProperty(exports, "parseStack", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.parseStack; }
+  get: function () { return chunkEGCXLOFH_cjs.parseStack; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { D as DebugClient } from './client-drmb0n15.cjs';
-export { C as ContextPatch, E as EventMeta, I as InitOptions, Q as QueueStorage, S as SDK_NAME, a as SDK_VERSION, b as browserContext, m as mergeContext } from './client-drmb0n15.cjs';
+import { D as DebugClient } from './client-ekzlpWIR.cjs';
+export { A as AutoCaptureOptions, C as ContextPatch, E as EventMeta, I as InitOptions, N as NetworkOptions, Q as QueueStorage, S as SDK_NAME, a as SDK_VERSION, b as browserContext, m as mergeContext, n as normaliseUrl } from './client-ekzlpWIR.cjs';
 export { Breadcrumb, EventInput, Severity, StackFrame, parseStack } from '@debugkit/schema/core';
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DebugClient } from './client-drmb0n15.js';
-export { C as ContextPatch, E as EventMeta, I as InitOptions, Q as QueueStorage, S as SDK_NAME, a as SDK_VERSION, b as browserContext, m as mergeContext } from './client-drmb0n15.js';
+import { D as DebugClient } from './client-ekzlpWIR.js';
+export { A as AutoCaptureOptions, C as ContextPatch, E as EventMeta, I as InitOptions, N as NetworkOptions, Q as QueueStorage, S as SDK_NAME, a as SDK_VERSION, b as browserContext, m as mergeContext, n as normaliseUrl } from './client-ekzlpWIR.js';
 export { Breadcrumb, EventInput, Severity, StackFrame, parseStack } from '@debugkit/schema/core';
 
 /**

package/dist/index.js

@@ -1,3 +1,3 @@
-export { DebugClient, SDK_NAME, SDK_VERSION, browserContext, deBug, mergeContext, parseStack } from './chunk-VIJ5USKQ.js';
+export { DebugClient, SDK_NAME, SDK_VERSION, browserContext, deBug, mergeContext, normaliseUrl, parseStack } from './chunk-5C7KJJNO.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/node.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunkXEFWRCN4_cjs = require('./chunk-XEFWRCN4.cjs');
+var chunkEGCXLOFH_cjs = require('./chunk-EGCXLOFH.cjs');
+var dc = require('diagnostics_channel');
 var os = require('os');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
+var dc__default = /*#__PURE__*/_interopDefault(dc);
 var os__default = /*#__PURE__*/_interopDefault(os);
 
 function nodeContext() {
@@ -12,14 +14,16 @@ function nodeContext() {
     os: { name: os__default.default.platform(), version: os__default.default.release() },
     runtime: { name: "node", version: process.versions.node },
     device: { type: "unknown", memoryMb: Math.round(os__default.default.totalmem() / 1024 / 1024) },
-    timezone: chunkXEFWRCN4_cjs.timezone()
+    timezone: chunkEGCXLOFH_cjs.timezone()
   };
 }
 var installed = false;
-function initNode(options, client = chunkXEFWRCN4_cjs.deBug) {
-  var _a;
+function initNode(options, client = chunkEGCXLOFH_cjs.deBug) {
+  var _a, _b;
   const { captureProcessErrors = true, shutdownTimeoutMs = 2e3, ...rest } = options;
-  client.init({ ...rest, captureGlobalErrors: false, context: chunkXEFWRCN4_cjs.mergeContext(nodeContext(), (_a = rest.context) != null ? _a : {}) });
+  const auto = rest.autoCapture === false ? false : { console: false, ...typeof rest.autoCapture === "object" ? rest.autoCapture : {} };
+  client.init({ ...rest, autoCapture: auto === false ? false : { ...auto, errors: false }, context: chunkEGCXLOFH_cjs.mergeContext(nodeContext(), (_a = rest.context) != null ? _a : {}) });
+  if (client.autoCapture.network) instrumentNodeHttp(client, (_b = rest.captureServerErrors) != null ? _b : true);
   if (!captureProcessErrors || installed) return client;
   installed = true;
   const flushThenExit = async (err) => {
@@ -28,7 +32,7 @@ function initNode(options, client = chunkXEFWRCN4_cjs.deBug) {
     process.exit(1);
   };
   process.on("uncaughtException", (err) => {
-    client.error(err, { handled: false, severity: "critical", tags: { source: "uncaughtException" } });
+    client.error(err, { handled: false, fatal: true, tags: { source: "uncaughtException" } });
     void flushThenExit(err);
   });
   process.on("unhandledRejection", (reason) => {
@@ -38,7 +42,54 @@ function initNode(options, client = chunkXEFWRCN4_cjs.deBug) {
   process.on("beforeExit", () => void client.flush());
   return client;
 }
-function withDebug(flow, fn, client = chunkXEFWRCN4_cjs.deBug) {
+var httpInstrumented = false;
+function instrumentNodeHttp(client, captureServer) {
+  var _a;
+  if (httpInstrumented || typeof ((_a = dc__default.default) == null ? void 0 : _a.subscribe) !== "function") return;
+  httpInstrumented = true;
+  const sink = client.sink();
+  const urlOf = (r) => {
+    var _a2, _b, _c, _d, _e;
+    return `${(_a2 = r.protocol) != null ? _a2 : "http:"}//${String((_d = (_c = (_b = r.getHeader) == null ? void 0 : _b.call(r, "host")) != null ? _c : r.host) != null ? _d : "")}${(_e = r.path) != null ? _e : ""}`;
+  };
+  dc__default.default.subscribe("http.client.request.start", (m) => {
+    const r = m.request;
+    r.__debugStart = Date.now();
+    r.__debugStack = new Error().stack;
+  });
+  dc__default.default.subscribe("http.client.response.finish", (m) => {
+    var _a2, _b;
+    const { request: r, response } = m;
+    const url = urlOf(r);
+    if (sink.ignored(url)) return;
+    sink.request({ method: (_a2 = r.method) != null ? _a2 : "GET", url, status: response.statusCode, durationMs: Date.now() - ((_b = r.__debugStart) != null ? _b : Date.now()), stack: r.__debugStack });
+  });
+  dc__default.default.subscribe("http.client.request.error", (m) => {
+    var _a2, _b;
+    const { request: r, error } = m;
+    const url = urlOf(r);
+    if (sink.ignored(url)) return;
+    sink.request({ method: (_a2 = r.method) != null ? _a2 : "GET", url, error, durationMs: Date.now() - ((_b = r.__debugStart) != null ? _b : Date.now()), stack: r.__debugStack });
+  });
+  if (!captureServer) return;
+  dc__default.default.subscribe("http.server.request.start", (m) => {
+    m.request.__debugStart = Date.now();
+  });
+  dc__default.default.subscribe("http.server.response.finish", (m) => {
+    var _a2, _b, _c, _d;
+    const { request: r, response } = m;
+    const status = (_a2 = response.statusCode) != null ? _a2 : 0;
+    if (status < 500) return;
+    const url = chunkEGCXLOFH_cjs.normaliseUrl((_b = r.url) != null ? _b : "/");
+    const method = ((_c = r.method) != null ? _c : "GET").toUpperCase();
+    client.captureError(
+      { name: "HttpServerError", message: `${method} ${url} responded ${status}`, frames: [] },
+      { handled: true, tags: { source: "http-server" } },
+      { method, url, status, durationMs: Date.now() - ((_d = r.__debugStart) != null ? _d : Date.now()) }
+    );
+  });
+}
+function withDebug(flow, fn, client = chunkEGCXLOFH_cjs.deBug) {
   return async (...args) => {
     try {
       return await fn(...args);
@@ -52,31 +103,35 @@ function withDebug(flow, fn, client = chunkXEFWRCN4_cjs.deBug) {
 
 Object.defineProperty(exports, "DebugClient", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.DebugClient; }
+  get: function () { return chunkEGCXLOFH_cjs.DebugClient; }
 });
 Object.defineProperty(exports, "SDK_NAME", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.SDK_NAME; }
+  get: function () { return chunkEGCXLOFH_cjs.SDK_NAME; }
 });
 Object.defineProperty(exports, "SDK_VERSION", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.SDK_VERSION; }
+  get: function () { return chunkEGCXLOFH_cjs.SDK_VERSION; }
 });
 Object.defineProperty(exports, "browserContext", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.browserContext; }
+  get: function () { return chunkEGCXLOFH_cjs.browserContext; }
 });
 Object.defineProperty(exports, "deBug", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.deBug; }
+  get: function () { return chunkEGCXLOFH_cjs.deBug; }
 });
 Object.defineProperty(exports, "mergeContext", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.mergeContext; }
+  get: function () { return chunkEGCXLOFH_cjs.mergeContext; }
+});
+Object.defineProperty(exports, "normaliseUrl", {
+  enumerable: true,
+  get: function () { return chunkEGCXLOFH_cjs.normaliseUrl; }
 });
 Object.defineProperty(exports, "parseStack", {
   enumerable: true,
-  get: function () { return chunkXEFWRCN4_cjs.parseStack; }
+  get: function () { return chunkEGCXLOFH_cjs.parseStack; }
 });
 exports.initNode = initNode;
 exports.nodeContext = nodeContext;

package/dist/node.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/node.ts"],"names":["os","timezone","deBug","mergeContext"],"mappings":";;;;;;;;;AAKO,SAAS,WAAA,GAA4B;AAC1C,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,EAAE,IAAA,EAAMA,mBAAA,CAAG,UAAS,EAAG,OAAA,EAASA,mBAAA,CAAG,OAAA,EAAQ,EAAE;AAAA,IACjD,SAAS,EAAE,IAAA,EAAM,QAAQ,OAAA,EAAS,OAAA,CAAQ,SAAS,IAAA,EAAK;AAAA,IACxD,MAAA,EAAQ,EAAE,IAAA,EAAM,SAAA,EAAW,QAAA,EAAU,IAAA,CAAK,KAAA,CAAMA,mBAAA,CAAG,QAAA,EAAS,GAAI,IAAA,GAAO,IAAI,CAAA,EAAE;AAAA,IAC7E,UAAUC,0BAAA;AAAS,GACrB;AACF;AASA,IAAI,SAAA,GAAY,KAAA;AAGT,SAAS,QAAA,CAAS,OAAA,EAA0B,MAAA,GAAsBC,uBAAA,EAAoB;AAxB7F,EAAA,IAAA,EAAA;AAyBE,EAAA,MAAM,EAAE,oBAAA,GAAuB,IAAA,EAAM,oBAAoB,GAAA,EAAM,GAAG,MAAK,GAAI,OAAA;AAC3E,EAAA,MAAA,CAAO,KAAK,EAAE,GAAG,IAAA,EAAM,mBAAA,EAAqB,OAAO,OAAA,EAASC,8BAAA,CAAa,WAAA,EAAY,EAAA,CAAG,UAAK,OAAA,KAAL,IAAA,GAAA,EAAA,GAAgB,EAAE,GAAG,CAAA;AAC7G,EAAA,IAAI,CAAC,oBAAA,IAAwB,SAAA,EAAW,OAAO,MAAA;AAC/C,EAAA,SAAA,GAAY,IAAA;AAEZ,EAAA,MAAM,aAAA,GAAgB,OAAO,GAAA,KAAiB;AAC5C,IAAA,MAAM,OAAA,CAAQ,IAAA,CAAK,CAAC,MAAA,CAAO,OAAM,EAAG,IAAI,OAAA,CAAQ,CAAC,MAAM,UAAA,CAAW,CAAA,EAAG,iBAAiB,CAAC,CAAC,CAAC,CAAA;AACzF,IAAA,OAAA,CAAQ,MAAM,GAAG,CAAA;AACjB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB,CAAA;AAEA,EAAA,OAAA,CAAQ,EAAA,CAAG,mBAAA,EAAqB,CAAC,GAAA,KAAQ;AACvC,IAAA,MAAA,CAAO,KAAA,CAAM,GAAA,EAAK,EAAE,OAAA,EAAS,KAAA,EAAO,QAAA,EAAU,UAAA,EAAY,IAAA,EAAM,EAAE,MAAA,EAAQ,mBAAA,EAAoB,EAAG,CAAA;AACjG,IAAA,KAAK,cAAc,GAAG,CAAA;AAAA,EACxB,CAAC,CAAA;AACD,EAAA,OAAA,CAAQ,EAAA,CAAG,oBAAA,EAAsB,CAAC,MAAA,KAAW;AAC3C,IAAA,MAAA,CAAO,KAAA,CAAM,MAAA,EAAQ,EAAE,OAAA,EAAS,KAAA,EAAO,MAAM,EAAE,MAAA,EAAQ,oBAAA,EAAqB,EAAG,CAAA;AAC/E,IAAA,IAAI,QAAQ,aAAA,CAAc,oBAAoB,MAAM,CAAA,EAAG,KAAK,cAAc,MAAM,CAAA;AAAA,EAClF,CAAC,CAAA;AACD,EAAA,OAAA,CAAQ,GAAG,YAAA,EAAc,MAAM,KAAK,MAAA,CAAO,OAAO,CAAA;AAClD,EAAA,OAAO,MAAA;AACT;AAOO,SAAS,SAAA,CAAkC,IAAA,EAAc,EAAA,EAAgC,MAAA,GAAsBD,uBAAA,EAAO;AAC3H,EAAA,OAAO,UAAU,IAAA,KAAwB;AACvC,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,IACzB,SAAS,GAAA,EAAK;AACZ,MAAA,MAAA,CAAO,MAAM,GAAA,EAAK,EAAE,IAAA,EAAM,OAAA,EAAS,OAAO,CAAA;AAC1C,MAAA,MAAM,OAAO,KAAA,EAAM;AACnB,MAAA,MAAM,GAAA;AAAA,IACR;AAAA,EACF,CAAA;AACF","file":"node.cjs","sourcesContent":["import os from \"node:os\";\nimport { deBug, type DebugClient, type InitOptions } from \"./index\";\nimport { mergeContext, timezone, type ContextPatch } from \"./context\";\n\n/** Context for Node servers (TanStack Start server functions, Next API routes, Express ...). */\nexport function nodeContext(): ContextPatch {\n  return {\n    os: { name: os.platform(), version: os.release() },\n    runtime: { name: \"node\", version: process.versions.node },\n    device: { type: \"unknown\", memoryMb: Math.round(os.totalmem() / 1024 / 1024) },\n    timezone: timezone(),\n  };\n}\n\nexport interface NodeInitOptions extends InitOptions {\n  /** Capture uncaught exceptions and unhandled rejections, then exit like Node would. Default true. */\n  captureProcessErrors?: boolean;\n  /** Max time to wait for a final flush before exiting on a fatal error. Default 2000ms. */\n  shutdownTimeoutMs?: number;\n}\n\nlet installed = false;\n\n/** Initialise deBug on a Node server. */\nexport function initNode(options: NodeInitOptions, client: DebugClient = deBug): DebugClient {\n  const { captureProcessErrors = true, shutdownTimeoutMs = 2000, ...rest } = options;\n  client.init({ ...rest, captureGlobalErrors: false, context: mergeContext(nodeContext(), rest.context ?? {}) });\n  if (!captureProcessErrors || installed) return client;\n  installed = true;\n\n  const flushThenExit = async (err: unknown) => {\n    await Promise.race([client.flush(), new Promise((r) => setTimeout(r, shutdownTimeoutMs))]);\n    console.error(err);\n    process.exit(1);\n  };\n  // Adding these listeners disables Node's default crash, so we re-create it after flushing.\n  process.on(\"uncaughtException\", (err) => {\n    client.error(err, { handled: false, severity: \"critical\", tags: { source: \"uncaughtException\" } });\n    void flushThenExit(err);\n  });\n  process.on(\"unhandledRejection\", (reason) => {\n    client.error(reason, { handled: false, tags: { source: \"unhandledRejection\" } });\n    if (process.listenerCount(\"unhandledRejection\") === 1) void flushThenExit(reason);\n  });\n  process.on(\"beforeExit\", () => void client.flush());\n  return client;\n}\n\n/**\n * Wrap a server handler so any error it throws is reported (and re-thrown).\n * Good for TanStack Start server functions and route handlers:\n *   .handler(withDebug(\"checkout.payment\", async ({ data }) => { ... }))\n */\nexport function withDebug<A extends unknown[], R>(flow: string, fn: (...args: A) => Promise<R>, client: DebugClient = deBug) {\n  return async (...args: A): Promise<R> => {\n    try {\n      return await fn(...args);\n    } catch (err) {\n      client.error(err, { flow, handled: false });\n      await client.flush();\n      throw err;\n    }\n  };\n}\n\nexport * from \"./index\";\n"]}
+{"version":3,"sources":["../src/node.ts"],"names":["os","timezone","deBug","mergeContext","dc","_a","normaliseUrl"],"mappings":"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","file":"node.cjs","sourcesContent":["import dc from \"node:diagnostics_channel\";\nimport os from \"node:os\";\nimport { deBug, type DebugClient, type InitOptions } from \"./index\";\nimport { mergeContext, timezone, type ContextPatch } from \"./context\";\nimport { normaliseUrl } from \"./auto\";\n\n/** Context for Node servers (TanStack Start server functions, Next API routes, Express ...). */\nexport function nodeContext(): ContextPatch {\n  return {\n    os: { name: os.platform(), version: os.release() },\n    runtime: { name: \"node\", version: process.versions.node },\n    device: { type: \"unknown\", memoryMb: Math.round(os.totalmem() / 1024 / 1024) },\n    timezone: timezone(),\n  };\n}\n\nexport interface NodeInitOptions extends InitOptions {\n  /** Capture uncaught exceptions and unhandled rejections, then exit like Node would. Default true. */\n  captureProcessErrors?: boolean;\n  /** Max time to wait for a final flush before exiting on a fatal error. Default 2000ms. */\n  shutdownTimeoutMs?: number;\n  /** Report responses your server sends with a 5xx status. Default true (needs `autoCapture.network`). */\n  captureServerErrors?: boolean;\n}\n\nlet installed = false;\n\n/** Initialise deBug on a Node server. */\nexport function initNode(options: NodeInitOptions, client: DebugClient = deBug): DebugClient {\n  const { captureProcessErrors = true, shutdownTimeoutMs = 2000, ...rest } = options;\n  const auto = rest.autoCapture === false ? false : { console: false, ...(typeof rest.autoCapture === \"object\" ? rest.autoCapture : {}) };\n  // Process-level hooks below replace the browser-style global handlers.\n  client.init({ ...rest, autoCapture: auto === false ? false : { ...auto, errors: false }, context: mergeContext(nodeContext(), rest.context ?? {}) });\n  if (client.autoCapture.network) instrumentNodeHttp(client, rest.captureServerErrors ?? true);\n  if (!captureProcessErrors || installed) return client;\n  installed = true;\n\n  const flushThenExit = async (err: unknown) => {\n    await Promise.race([client.flush(), new Promise((r) => setTimeout(r, shutdownTimeoutMs))]);\n    console.error(err);\n    process.exit(1);\n  };\n  // Adding these listeners disables Node's default crash, so we re-create it after flushing.\n  process.on(\"uncaughtException\", (err) => {\n    client.error(err, { handled: false, fatal: true, tags: { source: \"uncaughtException\" } });\n    void flushThenExit(err);\n  });\n  process.on(\"unhandledRejection\", (reason) => {\n    client.error(reason, { handled: false, tags: { source: \"unhandledRejection\" } });\n    if (process.listenerCount(\"unhandledRejection\") === 1) void flushThenExit(reason);\n  });\n  process.on(\"beforeExit\", () => void client.flush());\n  return client;\n}\n\n/**\n * Wrap a server handler so any error it throws is reported (and re-thrown).\n * Good for TanStack Start server functions and route handlers:\n *   .handler(withDebug(\"checkout.payment\", async ({ data }) => { ... }))\n */\ntype ClientReq = { method?: string; protocol?: string; host?: string; path?: string; getHeader?(n: string): unknown; __debugStart?: number; __debugStack?: string };\ntype ServerReq = { method?: string; url?: string; __debugStart?: number };\nlet httpInstrumented = false;\n\n/**\n * Outgoing requests made with node:http/https (axios, got, SDKs) and responses this server\n * sends, through Node's diagnostics channels. `fetch` is covered by the shared instrumentation.\n */\nfunction instrumentNodeHttp(client: DebugClient, captureServer: boolean) {\n  if (httpInstrumented || typeof dc?.subscribe !== \"function\") return;\n  httpInstrumented = true;\n  const sink = client.sink();\n  // The Host header keeps a non-default port; request.host doesn't.\n  const urlOf = (r: ClientReq) => `${r.protocol ?? \"http:\"}//${String(r.getHeader?.(\"host\") ?? r.host ?? \"\")}${r.path ?? \"\"}`;\n  dc.subscribe(\"http.client.request.start\", (m) => {\n    const r = (m as { request: ClientReq }).request;\n    r.__debugStart = Date.now();\n    r.__debugStack = new Error().stack;\n  });\n  dc.subscribe(\"http.client.response.finish\", (m) => {\n    const { request: r, response } = m as { request: ClientReq; response: { statusCode?: number } };\n    const url = urlOf(r);\n    if (sink.ignored(url)) return;\n    sink.request({ method: r.method ?? \"GET\", url, status: response.statusCode, durationMs: Date.now() - (r.__debugStart ?? Date.now()), stack: r.__debugStack });\n  });\n  dc.subscribe(\"http.client.request.error\", (m) => {\n    const { request: r, error } = m as { request: ClientReq; error: unknown };\n    const url = urlOf(r);\n    if (sink.ignored(url)) return;\n    sink.request({ method: r.method ?? \"GET\", url, error, durationMs: Date.now() - (r.__debugStart ?? Date.now()), stack: r.__debugStack });\n  });\n  if (!captureServer) return;\n  dc.subscribe(\"http.server.request.start\", (m) => {\n    (m as { request: ServerReq }).request.__debugStart = Date.now();\n  });\n  dc.subscribe(\"http.server.response.finish\", (m) => {\n    const { request: r, response } = m as { request: ServerReq; response: { statusCode?: number } };\n    const status = response.statusCode ?? 0;\n    if (status < 500) return;\n    const url = normaliseUrl(r.url ?? \"/\");\n    const method = (r.method ?? \"GET\").toUpperCase();\n    client.captureError(\n      { name: \"HttpServerError\", message: `${method} ${url} responded ${status}`, frames: [] },\n      { handled: true, tags: { source: \"http-server\" } },\n      { method, url, status, durationMs: Date.now() - (r.__debugStart ?? Date.now()) },\n    );\n  });\n}\n\nexport function withDebug<A extends unknown[], R>(flow: string, fn: (...args: A) => Promise<R>, client: DebugClient = deBug) {\n  return async (...args: A): Promise<R> => {\n    try {\n      return await fn(...args);\n    } catch (err) {\n      client.error(err, { flow, handled: false });\n      await client.flush();\n      throw err;\n    }\n  };\n}\n\nexport * from \"./index\";\n"]}

package/dist/node.d.cts

@@ -1,6 +1,6 @@
 export { deBug } from './index.cjs';
-import { I as InitOptions, D as DebugClient, C as ContextPatch } from './client-drmb0n15.cjs';
-export { E as EventMeta, Q as QueueStorage, S as SDK_NAME, a as SDK_VERSION, b as browserContext, m as mergeContext } from './client-drmb0n15.cjs';
+import { I as InitOptions, D as DebugClient, C as ContextPatch } from './client-ekzlpWIR.cjs';
+export { A as AutoCaptureOptions, E as EventMeta, N as NetworkOptions, Q as QueueStorage, S as SDK_NAME, a as SDK_VERSION, b as browserContext, m as mergeContext, n as normaliseUrl } from './client-ekzlpWIR.cjs';
 export { Breadcrumb, EventInput, Severity, StackFrame, parseStack } from '@debugkit/schema/core';
 
 /** Context for Node servers (TanStack Start server functions, Next API routes, Express ...). */
@@ -10,14 +10,11 @@ interface NodeInitOptions extends InitOptions {
     captureProcessErrors?: boolean;
     /** Max time to wait for a final flush before exiting on a fatal error. Default 2000ms. */
     shutdownTimeoutMs?: number;
+    /** Report responses your server sends with a 5xx status. Default true (needs `autoCapture.network`). */
+    captureServerErrors?: boolean;
 }
 /** Initialise deBug on a Node server. */
 declare function initNode(options: NodeInitOptions, client?: DebugClient): DebugClient;
-/**
- * Wrap a server handler so any error it throws is reported (and re-thrown).
- * Good for TanStack Start server functions and route handlers:
- *   .handler(withDebug("checkout.payment", async ({ data }) => { ... }))
- */
 declare function withDebug<A extends unknown[], R>(flow: string, fn: (...args: A) => Promise<R>, client?: DebugClient): (...args: A) => Promise<R>;
 
 export { ContextPatch, DebugClient, InitOptions, type NodeInitOptions, initNode, nodeContext, withDebug };