@greenhat-services/magpie-node 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Magpie contributors
+
+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

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @greenhat-services/magpie-node
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Magpie error tracking and performance monitoring for Node.js servers, including Nuxt's Nitro.
+
+```sh
+npm install @greenhat-services/magpie-node
+```
+
+Per-request context isolated with AsyncLocalStorage, request tracing that continues the browser's trace, and the server's own `fetch` calls as spans.
+
+```ts
+import * as Magpie from '@greenhat-services/magpie-node';
+
+const client = Magpie.init({ dsn: 'https://<key>@<host>/<project>', tracesSampleRate: 0.2 });
+```
+
+Using Nuxt? Install `@greenhat-services/magpie-nuxt` instead, which sets this up for you.
+
+Full documentation, options and what is (and is not) sent: https://github.com/Greenhat-Services/magpie-js#readme
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,262 @@
+'use strict';
+
+var magpieCore = require('@greenhat-services/magpie-core');
+var async_hooks = require('async_hooks');
+var os = require('os');
+var zlib = require('zlib');
+
+// src/index.ts
+var storage = new async_hooks.AsyncLocalStorage();
+var currentStore = () => storage.getStore();
+function isolatePerRequest(client) {
+  let processScope = client.scope;
+  let processTransaction = client.activeTransaction;
+  Object.defineProperty(client, "scope", {
+    configurable: true,
+    get: () => storage.getStore()?.scope ?? processScope,
+    // withScope() swaps in a copy while its callback runs and puts the original back afterwards. Inside a request
+    // that swap belongs to the request, so one request's temporary tags can never reach another.
+    set: (scope) => {
+      const store = storage.getStore();
+      if (store) store.scope = scope;
+      else processScope = scope;
+    }
+  });
+  Object.defineProperty(client, "activeTransaction", {
+    configurable: true,
+    get: () => {
+      const store = storage.getStore();
+      return store ? store.transaction : processTransaction;
+    },
+    set: (tx) => {
+      const store = storage.getStore();
+      if (store) store.transaction = tx;
+      else processTransaction = tx;
+    }
+  });
+}
+function runWithRequest(client, request, fn) {
+  return storage.run({ scope: client.scope.clone(), transaction: void 0, request }, fn);
+}
+
+// src/handlers.ts
+function processHandlers() {
+  return {
+    name: "ProcessHandlers",
+    setup(client) {
+      const onUncaught = (error) => {
+        client.captureException(error, { mechanism: { type: "onuncaughtexception", handled: false } });
+        void client.flush(2e3).finally(() => {
+          if (process.listenerCount("uncaughtException") <= 1) {
+            console.error(error);
+            process.exit(1);
+          }
+        });
+      };
+      const onRejection = (reason) => {
+        client.captureException(reason, { mechanism: { type: "onunhandledrejection", handled: false } });
+        if (process.listenerCount("unhandledRejection") <= 1) {
+          setImmediate(() => {
+            throw reason instanceof Error ? reason : new Error(`Unhandled promise rejection: ${String(reason)}`);
+          });
+        }
+      };
+      process.on("uncaughtException", onUncaught);
+      process.on("unhandledRejection", onRejection);
+      return () => {
+        process.off("uncaughtException", onUncaught);
+        process.off("unhandledRejection", onRejection);
+      };
+    }
+  };
+}
+function nodeHttp() {
+  return {
+    name: "NodeHttp",
+    setup(client) {
+      if (typeof globalThis.fetch !== "function") return;
+      const original = globalThis.fetch;
+      const skip = (url) => !!client.dsn && url.startsWith(client.dsn.origin);
+      globalThis.fetch = function patchedFetch(input, init2) {
+        const isRequest = typeof Request !== "undefined" && input instanceof Request;
+        const url = typeof input === "string" ? input : input instanceof URL ? input.href : isRequest ? input.url : String(input);
+        const method = (init2?.method ?? (isRequest ? input.method : "GET")).toUpperCase();
+        if (skip(url)) return original.call(this, input, init2);
+        const tx = client.activeTransaction;
+        const started = performance.now();
+        let span;
+        if (tx?.sampled) span = tx.startChild({ op: "http.client", description: `${method} ${magpieCore.scrubUrl(url).split(/[?#]/)[0]}`, data: { method } });
+        const propagate = (client.options.tracesSampleRate ?? 0) > 0 && !!tx && (client.options.tracePropagationTargets === void 0 || client.shouldPropagate(url));
+        let args = [input, init2];
+        if (propagate && tx) {
+          const headers = new Headers(init2?.headers ?? (isRequest ? input.headers : void 0));
+          if (!headers.has(magpieCore.TRACE_HEADER)) headers.set(magpieCore.TRACE_HEADER, magpieCore.formatTraceHeader(tx.traceId, span?.spanId ?? tx.spanId, tx.sampled));
+          args = [input, { ...init2, headers }];
+        }
+        const finish = (status) => {
+          if (span) {
+            if (status) span.setData("status_code", status);
+            span.setStatus(status === 0 ? "unknown_error" : status >= 500 ? "internal_error" : "ok");
+            span.end();
+          }
+          client.addBreadcrumb({
+            category: "http",
+            type: "http",
+            level: status >= 500 || status === 0 ? "error" : status >= 400 ? "warning" : "info",
+            message: `${method} ${magpieCore.scrubUrl(url)}`,
+            data: { method, status_code: status || "failed", duration_ms: Math.round(performance.now() - started) }
+          });
+        };
+        return original.apply(this, args).then(
+          (response) => {
+            finish(response.status);
+            return response;
+          },
+          (error) => {
+            finish(0);
+            throw error;
+          }
+        );
+      };
+      return () => {
+        globalThis.fetch = original;
+      };
+    }
+  };
+}
+var COMPRESS_FROM = 4096;
+function nodeTransport(dsn, fetchImpl = (...args) => globalThis.fetch(...args), timeoutMs = 3e3) {
+  return {
+    async send(payload) {
+      try {
+        const path = payload.type === "transaction" ? "transactions" : "events";
+        const json = JSON.stringify(payload);
+        const compressed = json.length >= COMPRESS_FROM;
+        const response = await fetchImpl(magpieCore.endpoint(dsn, path), {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-Magpie-Auth": `Magpie magpie_version=1, magpie_key=${dsn.publicKey}, magpie_client=magpie-node`,
+            ...compressed ? { "Content-Encoding": "gzip" } : {}
+          },
+          body: compressed ? new Uint8Array(zlib.gzipSync(json)) : json,
+          signal: AbortSignal.timeout(timeoutMs)
+        });
+        const retry = Number(response.headers.get("retry-after"));
+        return { ok: response.ok, status: response.status, retryAfter: Number.isFinite(retry) && retry > 0 ? Math.min(retry, 3600) : void 0 };
+      } catch {
+        return { ok: false };
+      }
+    }
+  };
+}
+
+// src/runtime.ts
+var SDK_NAME = "magpie.javascript.node";
+var OS_NAMES = { win32: "Windows", darwin: "macOS", linux: "Linux", freebsd: "FreeBSD" };
+function nodeRuntime(options = {}) {
+  return {
+    sdk: { name: options.sdkName ?? SDK_NAME, version: magpieCore.SDK_VERSION },
+    platform: "node",
+    createTransport: (dsn) => nodeTransport(dsn, options.fetch),
+    contexts: () => ({
+      runtime: { name: "node", version: process.version.replace(/^v/, "") },
+      os: { name: OS_NAMES[os.platform()] ?? os.platform(), version: os.release() }
+    }),
+    // The request being served, when there is one: set by `trackRequest`, read here for every event.
+    request: () => currentStore()?.request
+  };
+}
+var defaultServerName = () => {
+  try {
+    return os.hostname() || void 0;
+  } catch {
+    return void 0;
+  }
+};
+var SAFE_HEADERS = ["user-agent", "accept", "accept-language", "content-type", "host", "referer", "x-forwarded-proto"];
+function trackRequest(client, info, fn) {
+  const { path, query } = splitUrl(info.url);
+  const request = {
+    url: info.headers?.host ? `${firstHeader(info.headers["x-forwarded-proto"]) ?? "http"}://${firstHeader(info.headers.host)}${path}` : path,
+    method: info.method.toUpperCase(),
+    ...query ? { query_string: magpieCore.scrubQuery(query) } : {},
+    headers: safeHeaders(info.headers)
+  };
+  return runWithRequest(client, request, () => {
+    const parent = magpieCore.parseTraceHeader(firstHeader(info.headers?.[magpieCore.TRACE_HEADER]));
+    const method = info.method.toUpperCase();
+    const name = (route) => `${method} ${route ?? info.route ?? path}`;
+    const transaction = client.startTransaction({
+      name: name(),
+      op: "http.server",
+      ...parent ? { traceId: parent.traceId, parentSpanId: parent.spanId, sampled: parent.sampled } : {}
+    });
+    client.activeTransaction = transaction;
+    client.scope.setTransactionName(transaction.name);
+    const finish = (statusCode, route) => {
+      transaction.setName(name(route));
+      transaction.setData("http.status_code", statusCode);
+      if (statusCode >= 500) transaction.setStatus("internal_error");
+      transaction.end();
+    };
+    return fn({ transaction, finish });
+  });
+}
+function splitUrl(url) {
+  let target = url;
+  try {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(url)) {
+      const u = new URL(url);
+      target = `${u.pathname}${u.search}`;
+    }
+  } catch {
+  }
+  const q = target.indexOf("?");
+  return q < 0 ? { path: target, query: "" } : { path: target.slice(0, q), query: target.slice(q + 1) };
+}
+function firstHeader(value) {
+  return Array.isArray(value) ? value[0] : value;
+}
+function safeHeaders(headers) {
+  const out = {};
+  for (const name of SAFE_HEADERS) {
+    const value = firstHeader(headers?.[name]);
+    if (value) out[name] = value;
+  }
+  return out;
+}
+
+// src/index.ts
+function init(options = {}) {
+  const previous = magpieCore.getClient();
+  if (previous) void previous.close(0);
+  const { captureUnhandled = true, http = true, sdkName, integrations = [], ...rest } = options;
+  const client = new magpieCore.Client(
+    { serverName: defaultServerName(), ...rest, release: rest.release ?? process.env.MAGPIE_RELEASE },
+    nodeRuntime({ sdkName })
+  );
+  isolatePerRequest(client);
+  magpieCore.setClient(client);
+  const defaults = [...captureUnhandled ? [processHandlers()] : [], ...http ? [nodeHttp()] : []];
+  client.setupIntegrations([...defaults, ...integrations]);
+  return client;
+}
+
+exports.currentStore = currentStore;
+exports.init = init;
+exports.isolatePerRequest = isolatePerRequest;
+exports.nodeHttp = nodeHttp;
+exports.nodeTransport = nodeTransport;
+exports.processHandlers = processHandlers;
+exports.runWithRequest = runWithRequest;
+exports.storage = storage;
+exports.trackRequest = trackRequest;
+Object.keys(magpieCore).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return magpieCore[k]; }
+  });
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/handlers.ts","../src/http.ts","../src/transport.ts","../src/runtime.ts","../src/request.ts","../src/index.ts"],"names":["AsyncLocalStorage","init","scrubUrl","TRACE_HEADER","formatTraceHeader","endpoint","gzipSync","SDK_VERSION","platform","release","hostname","scrubQuery","parseTraceHeader","getClient","Client","setClient"],"mappings":"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","file":"index.cjs","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Client, MagpieEvent, Scope, Transaction } from '@greenhat-services/magpie-core';\n\n/**\n * What belongs to one request on a server that handles many at once: its own scope (tags, user, breadcrumbs), the\n * transaction being timed, and the request being served. Carried through every `await` by AsyncLocalStorage, so two\n * overlapping requests never see each other's data.\n */\nexport interface RequestStore {\n    scope: Scope;\n    transaction: Transaction | undefined;\n    request: MagpieEvent['request'] | undefined;\n}\n\nexport const storage = new AsyncLocalStorage<RequestStore>();\n\nexport const currentStore = (): RequestStore | undefined => storage.getStore();\n\n/**\n * Makes `client.scope` and `client.activeTransaction` follow the request that is running, and fall back to the\n * process-wide ones outside any request. Applied to the instance, so core stays free of Node.\n */\nexport function isolatePerRequest(client: Client): void {\n    let processScope = client.scope;\n    let processTransaction = client.activeTransaction;\n\n    Object.defineProperty(client, 'scope', {\n        configurable: true,\n        get: () => storage.getStore()?.scope ?? processScope,\n        // withScope() swaps in a copy while its callback runs and puts the original back afterwards. Inside a request\n        // that swap belongs to the request, so one request's temporary tags can never reach another.\n        set: (scope: Scope) => {\n            const store = storage.getStore();\n            if (store) store.scope = scope;\n            else processScope = scope;\n        },\n    });\n\n    Object.defineProperty(client, 'activeTransaction', {\n        configurable: true,\n        get: () => {\n            const store = storage.getStore();\n\n            return store ? store.transaction : processTransaction;\n        },\n        set: (tx: Transaction | undefined) => {\n            const store = storage.getStore();\n            if (store) store.transaction = tx;\n            else processTransaction = tx;\n        },\n    });\n}\n\n/** Runs `fn` as one request: a copy of the process scope, its own transaction slot, and the request being served. */\nexport function runWithRequest<T>(client: Client, request: MagpieEvent['request'] | undefined, fn: () => T): T {\n    return storage.run({ scope: client.scope.clone(), transaction: undefined, request }, fn);\n}\n","import type { Client, Integration } from '@greenhat-services/magpie-core';\n\n/**\n * Reports what the process did not catch. Adding a listener for either event removes Node's own reaction to it (print\n * and exit), so after reporting, that reaction is restored unless something else in the process is handling it.\n */\nexport function processHandlers(): Integration {\n    return {\n        name: 'ProcessHandlers',\n        setup(client: Client) {\n            const onUncaught = (error: Error) => {\n                client.captureException(error, { mechanism: { type: 'onuncaughtexception', handled: false } });\n\n                void client.flush(2000).finally(() => {\n                    if (process.listenerCount('uncaughtException') <= 1) {\n                        console.error(error);\n                        process.exit(1);\n                    }\n                });\n            };\n\n            const onRejection = (reason: unknown) => {\n                client.captureException(reason, { mechanism: { type: 'onunhandledrejection', handled: false } });\n\n                // Node's default since v15 is to raise an unhandled rejection as an uncaught exception. Keep it, so a\n                // server that crashed before Magpie still crashes (and the crash is already reported).\n                if (process.listenerCount('unhandledRejection') <= 1) {\n                    setImmediate(() => {\n                        throw reason instanceof Error ? reason : new Error(`Unhandled promise rejection: ${String(reason)}`);\n                    });\n                }\n            };\n\n            process.on('uncaughtException', onUncaught);\n            process.on('unhandledRejection', onRejection);\n\n            return () => {\n                process.off('uncaughtException', onUncaught);\n                process.off('unhandledRejection', onRejection);\n            };\n        },\n    };\n}\n","import { type Client, formatTraceHeader, type Integration, scrubUrl, type Span, TRACE_HEADER } from '@greenhat-services/magpie-core';\n\n/**\n * Times the server's own outgoing `fetch` calls (an API your pages render from). Each becomes a breadcrumb on the\n * current request and, when that request is being traced, a span of it, and carries the `magpie-trace` header so\n * the service on the other end continues the trace: browser, Nuxt server and Laravel API as one.\n *\n * The header goes to every host unless `tracePropagationTargets` lists the ones that should get it.\n */\nexport function nodeHttp(): Integration {\n    return {\n        name: 'NodeHttp',\n        setup(client: Client) {\n            if (typeof globalThis.fetch !== 'function') return;\n\n            const original = globalThis.fetch;\n            const skip = (url: string) => !!client.dsn && url.startsWith(client.dsn.origin);\n\n            globalThis.fetch = function patchedFetch(this: unknown, input: Parameters<typeof fetch>[0], init?: RequestInit) {\n                const isRequest = typeof Request !== 'undefined' && input instanceof Request;\n                const url = typeof input === 'string' ? input : input instanceof URL ? input.href : isRequest ? (input as Request).url : String(input);\n                const method = (init?.method ?? (isRequest ? (input as Request).method : 'GET')).toUpperCase();\n\n                if (skip(url)) return original.call(this, input, init);\n\n                const tx = client.activeTransaction;\n                const started = performance.now();\n                let span: Span | undefined;\n                if (tx?.sampled) span = tx.startChild({ op: 'http.client', description: `${method} ${scrubUrl(url).split(/[?#]/)[0]}`, data: { method } });\n\n                const propagate = (client.options.tracesSampleRate ?? 0) > 0 && !!tx && (client.options.tracePropagationTargets === undefined || client.shouldPropagate(url));\n                let args: [Parameters<typeof fetch>[0], RequestInit | undefined] = [input, init];\n                if (propagate && tx) {\n                    const headers = new Headers(init?.headers ?? (isRequest ? (input as Request).headers : undefined));\n                    if (!headers.has(TRACE_HEADER)) headers.set(TRACE_HEADER, formatTraceHeader(tx.traceId, span?.spanId ?? tx.spanId, tx.sampled));\n                    args = [input, { ...init, headers }];\n                }\n\n                const finish = (status: number) => {\n                    if (span) {\n                        if (status) span.setData('status_code', status);\n                        span.setStatus(status === 0 ? 'unknown_error' : status >= 500 ? 'internal_error' : 'ok');\n                        span.end();\n                    }\n                    client.addBreadcrumb({\n                        category: 'http',\n                        type: 'http',\n                        level: status >= 500 || status === 0 ? 'error' : status >= 400 ? 'warning' : 'info',\n                        message: `${method} ${scrubUrl(url)}`,\n                        data: { method, status_code: status || 'failed', duration_ms: Math.round(performance.now() - started) },\n                    });\n                };\n\n                return original.apply(this, args).then(\n                    (response) => {\n                        finish(response.status);\n\n                        return response;\n                    },\n                    (error) => {\n                        finish(0);\n                        throw error;\n                    },\n                );\n            } as typeof fetch;\n\n            return () => {\n                globalThis.fetch = original;\n            };\n        },\n    };\n}\n","import { gzipSync } from 'node:zlib';\nimport { type Dsn, endpoint, type Payload, type Transport, type TransportResult } from '@greenhat-services/magpie-core';\n\n/** Bodies above this are gzip-compressed, which Magpie accepts. */\nconst COMPRESS_FROM = 4096;\n\n/**\n * Delivers payloads from a server. There is no CORS to avoid here, so the key goes in the `X-Magpie-Auth` header,\n * the same as the Laravel SDK, and the body is JSON, compressed when it is large.\n */\nexport function nodeTransport(dsn: Dsn, fetchImpl: typeof fetch = (...args) => globalThis.fetch(...args), timeoutMs = 3000): Transport {\n    return {\n        async send(payload: Payload): Promise<TransportResult> {\n            try {\n                const path = (payload as { type?: string }).type === 'transaction' ? 'transactions' : 'events';\n                const json = JSON.stringify(payload);\n                const compressed = json.length >= COMPRESS_FROM;\n\n                const response = await fetchImpl(endpoint(dsn, path), {\n                    method: 'POST',\n                    headers: {\n                        'Content-Type': 'application/json',\n                        'X-Magpie-Auth': `Magpie magpie_version=1, magpie_key=${dsn.publicKey}, magpie_client=magpie-node`,\n                        ...(compressed ? { 'Content-Encoding': 'gzip' } : {}),\n                    },\n                    body: compressed ? new Uint8Array(gzipSync(json)) : json,\n                    signal: AbortSignal.timeout(timeoutMs),\n                });\n\n                const retry = Number(response.headers.get('retry-after'));\n\n                return { ok: response.ok, status: response.status, retryAfter: Number.isFinite(retry) && retry > 0 ? Math.min(retry, 3600) : undefined };\n            } catch {\n                // Unreachable, or too slow: monitoring must never hold a request up, so the payload is dropped.\n                return { ok: false };\n            }\n        },\n    };\n}\n","import { hostname, platform, release } from 'node:os';\nimport { type Runtime, SDK_VERSION } from '@greenhat-services/magpie-core';\nimport { currentStore } from './context';\nimport { nodeTransport } from './transport';\n\nexport const SDK_NAME = 'magpie.javascript.node';\n\nconst OS_NAMES: Record<string, string> = { win32: 'Windows', darwin: 'macOS', linux: 'Linux', freebsd: 'FreeBSD' };\n\nexport function nodeRuntime(options: { sdkName?: string; fetch?: typeof fetch } = {}): Runtime {\n    return {\n        sdk: { name: options.sdkName ?? SDK_NAME, version: SDK_VERSION },\n        platform: 'node',\n        createTransport: (dsn) => nodeTransport(dsn, options.fetch),\n        contexts: () => ({\n            runtime: { name: 'node', version: process.version.replace(/^v/, '') },\n            os: { name: OS_NAMES[platform()] ?? platform(), version: release() },\n        }),\n        // The request being served, when there is one: set by `trackRequest`, read here for every event.\n        request: () => currentStore()?.request,\n    };\n}\n\nexport const defaultServerName = (): string | undefined => {\n    try {\n        return hostname() || undefined;\n    } catch {\n        return undefined;\n    }\n};\n","import { type Client, parseTraceHeader, scrubQuery, TRACE_HEADER, type Transaction } from '@greenhat-services/magpie-core';\nimport { runWithRequest } from './context';\n\nexport interface RequestInfo {\n    method: string;\n    /** The path (and query string), or a full URL. */\n    url: string;\n    /** The request's headers, lower-case names. Only a short allow-list of them is ever attached to an event. */\n    headers?: Record<string, string | string[] | undefined>;\n    /** The matched route pattern (`/users/:id`) when the framework already knows it. */\n    route?: string;\n}\n\n/** Headers worth having on an event. Everything else, cookies and authorization above all, is dropped, not filtered. */\nconst SAFE_HEADERS = ['user-agent', 'accept', 'accept-language', 'content-type', 'host', 'referer', 'x-forwarded-proto'];\n\nexport interface RequestHandle {\n    transaction: Transaction;\n    /** Ends the request's transaction. Pass the route pattern when it is only known now, so `/users/7` becomes `/users/:id`. */\n    finish(statusCode: number, route?: string): void;\n}\n\n/**\n * Runs `fn` as one request: its own scope and transaction, the request attached to every event raised inside it, and a\n * trace that continues the caller's `magpie-trace` header (so a page load in the browser and this server render are one\n * trace). Call `finish` when the response is done.\n */\nexport function trackRequest<T>(client: Client, info: RequestInfo, fn: (handle: RequestHandle) => T): T {\n    const { path, query } = splitUrl(info.url);\n    const request = {\n        url: info.headers?.host ? `${firstHeader(info.headers['x-forwarded-proto']) ?? 'http'}://${firstHeader(info.headers.host)}${path}` : path,\n        method: info.method.toUpperCase(),\n        ...(query ? { query_string: scrubQuery(query) } : {}),\n        headers: safeHeaders(info.headers),\n    };\n\n    return runWithRequest(client, request, () => {\n        const parent = parseTraceHeader(firstHeader(info.headers?.[TRACE_HEADER]));\n        const method = info.method.toUpperCase();\n        const name = (route?: string) => `${method} ${route ?? info.route ?? path}`;\n\n        const transaction = client.startTransaction({\n            name: name(),\n            op: 'http.server',\n            ...(parent ? { traceId: parent.traceId, parentSpanId: parent.spanId, sampled: parent.sampled } : {}),\n        });\n        client.activeTransaction = transaction;\n        client.scope.setTransactionName(transaction.name);\n\n        const finish = (statusCode: number, route?: string) => {\n            transaction.setName(name(route));\n            transaction.setData('http.status_code', statusCode);\n            // Magpie counts any status but \"ok\" as a failure, so only a server error is one. A 404 is a success.\n            if (statusCode >= 500) transaction.setStatus('internal_error');\n            transaction.end();\n        };\n\n        return fn({ transaction, finish });\n    });\n}\n\nfunction splitUrl(url: string): { path: string; query: string } {\n    let target = url;\n    try {\n        if (/^[a-z][a-z0-9+.-]*:/i.test(url)) {\n            const u = new URL(url);\n            target = `${u.pathname}${u.search}`;\n        }\n    } catch {\n        // Keep it as given.\n    }\n    const q = target.indexOf('?');\n\n    return q < 0 ? { path: target, query: '' } : { path: target.slice(0, q), query: target.slice(q + 1) };\n}\n\nfunction firstHeader(value: string | string[] | undefined): string | undefined {\n    return Array.isArray(value) ? value[0] : value;\n}\n\nfunction safeHeaders(headers: RequestInfo['headers']): Record<string, string> {\n    const out: Record<string, string> = {};\n    for (const name of SAFE_HEADERS) {\n        const value = firstHeader(headers?.[name]);\n        if (value) out[name] = value;\n    }\n\n    return out;\n}\n","import { Client, type Integration, type Options, setClient, getClient } from '@greenhat-services/magpie-core';\nimport { isolatePerRequest } from './context';\nimport { processHandlers } from './handlers';\nimport { nodeHttp } from './http';\nimport { defaultServerName, nodeRuntime } from './runtime';\n\nexport * from '@greenhat-services/magpie-core';\nexport { currentStore, isolatePerRequest, runWithRequest, storage } from './context';\nexport { processHandlers } from './handlers';\nexport { nodeHttp } from './http';\nexport { trackRequest, type RequestHandle, type RequestInfo } from './request';\nexport { nodeTransport } from './transport';\n\nexport interface NodeOptions extends Options {\n    /** Report uncaught exceptions and unhandled rejections. Default true. */\n    captureUnhandled?: boolean;\n    /** Time and propagate the server's own `fetch` calls. Default true. */\n    http?: boolean;\n    sdkName?: string;\n}\n\n/**\n * Starts Magpie on a server. Per-request data (scope, transaction, the request) is isolated with AsyncLocalStorage, so\n * use `trackRequest` around each request the framework handles.\n */\nexport function init(options: NodeOptions = {}): Client {\n    const previous = getClient();\n    if (previous) void previous.close(0);\n\n    const { captureUnhandled = true, http = true, sdkName, integrations = [], ...rest } = options;\n\n    const client = new Client(\n        { serverName: defaultServerName(), ...rest, release: rest.release ?? process.env.MAGPIE_RELEASE },\n        nodeRuntime({ sdkName }),\n    );\n\n    isolatePerRequest(client);\n    setClient(client);\n\n    const defaults: Integration[] = [...(captureUnhandled ? [processHandlers()] : []), ...(http ? [nodeHttp()] : [])];\n    client.setupIntegrations([...defaults, ...integrations]);\n\n    return client;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,80 @@
+import { Scope, Transaction, MagpieEvent, Client, Integration, Dsn, Transport, Options } from '@greenhat-services/magpie-core';
+export * from '@greenhat-services/magpie-core';
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+/**
+ * What belongs to one request on a server that handles many at once: its own scope (tags, user, breadcrumbs), the
+ * transaction being timed, and the request being served. Carried through every `await` by AsyncLocalStorage, so two
+ * overlapping requests never see each other's data.
+ */
+interface RequestStore {
+    scope: Scope;
+    transaction: Transaction | undefined;
+    request: MagpieEvent['request'] | undefined;
+}
+declare const storage: AsyncLocalStorage<RequestStore>;
+declare const currentStore: () => RequestStore | undefined;
+/**
+ * Makes `client.scope` and `client.activeTransaction` follow the request that is running, and fall back to the
+ * process-wide ones outside any request. Applied to the instance, so core stays free of Node.
+ */
+declare function isolatePerRequest(client: Client): void;
+/** Runs `fn` as one request: a copy of the process scope, its own transaction slot, and the request being served. */
+declare function runWithRequest<T>(client: Client, request: MagpieEvent['request'] | undefined, fn: () => T): T;
+
+/**
+ * Reports what the process did not catch. Adding a listener for either event removes Node's own reaction to it (print
+ * and exit), so after reporting, that reaction is restored unless something else in the process is handling it.
+ */
+declare function processHandlers(): Integration;
+
+/**
+ * Times the server's own outgoing `fetch` calls (an API your pages render from). Each becomes a breadcrumb on the
+ * current request and, when that request is being traced, a span of it, and carries the `magpie-trace` header so
+ * the service on the other end continues the trace: browser, Nuxt server and Laravel API as one.
+ *
+ * The header goes to every host unless `tracePropagationTargets` lists the ones that should get it.
+ */
+declare function nodeHttp(): Integration;
+
+interface RequestInfo {
+    method: string;
+    /** The path (and query string), or a full URL. */
+    url: string;
+    /** The request's headers, lower-case names. Only a short allow-list of them is ever attached to an event. */
+    headers?: Record<string, string | string[] | undefined>;
+    /** The matched route pattern (`/users/:id`) when the framework already knows it. */
+    route?: string;
+}
+interface RequestHandle {
+    transaction: Transaction;
+    /** Ends the request's transaction. Pass the route pattern when it is only known now, so `/users/7` becomes `/users/:id`. */
+    finish(statusCode: number, route?: string): void;
+}
+/**
+ * Runs `fn` as one request: its own scope and transaction, the request attached to every event raised inside it, and a
+ * trace that continues the caller's `magpie-trace` header (so a page load in the browser and this server render are one
+ * trace). Call `finish` when the response is done.
+ */
+declare function trackRequest<T>(client: Client, info: RequestInfo, fn: (handle: RequestHandle) => T): T;
+
+/**
+ * Delivers payloads from a server. There is no CORS to avoid here, so the key goes in the `X-Magpie-Auth` header,
+ * the same as the Laravel SDK, and the body is JSON, compressed when it is large.
+ */
+declare function nodeTransport(dsn: Dsn, fetchImpl?: typeof fetch, timeoutMs?: number): Transport;
+
+interface NodeOptions extends Options {
+    /** Report uncaught exceptions and unhandled rejections. Default true. */
+    captureUnhandled?: boolean;
+    /** Time and propagate the server's own `fetch` calls. Default true. */
+    http?: boolean;
+    sdkName?: string;
+}
+/**
+ * Starts Magpie on a server. Per-request data (scope, transaction, the request) is isolated with AsyncLocalStorage, so
+ * use `trackRequest` around each request the framework handles.
+ */
+declare function init(options?: NodeOptions): Client;
+
+export { type NodeOptions, type RequestHandle, type RequestInfo, currentStore, init, isolatePerRequest, nodeHttp, nodeTransport, processHandlers, runWithRequest, storage, trackRequest };

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import { Scope, Transaction, MagpieEvent, Client, Integration, Dsn, Transport, Options } from '@greenhat-services/magpie-core';
+export * from '@greenhat-services/magpie-core';
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+/**
+ * What belongs to one request on a server that handles many at once: its own scope (tags, user, breadcrumbs), the
+ * transaction being timed, and the request being served. Carried through every `await` by AsyncLocalStorage, so two
+ * overlapping requests never see each other's data.
+ */
+interface RequestStore {
+    scope: Scope;
+    transaction: Transaction | undefined;
+    request: MagpieEvent['request'] | undefined;
+}
+declare const storage: AsyncLocalStorage<RequestStore>;
+declare const currentStore: () => RequestStore | undefined;
+/**
+ * Makes `client.scope` and `client.activeTransaction` follow the request that is running, and fall back to the
+ * process-wide ones outside any request. Applied to the instance, so core stays free of Node.
+ */
+declare function isolatePerRequest(client: Client): void;
+/** Runs `fn` as one request: a copy of the process scope, its own transaction slot, and the request being served. */
+declare function runWithRequest<T>(client: Client, request: MagpieEvent['request'] | undefined, fn: () => T): T;
+
+/**
+ * Reports what the process did not catch. Adding a listener for either event removes Node's own reaction to it (print
+ * and exit), so after reporting, that reaction is restored unless something else in the process is handling it.
+ */
+declare function processHandlers(): Integration;
+
+/**
+ * Times the server's own outgoing `fetch` calls (an API your pages render from). Each becomes a breadcrumb on the
+ * current request and, when that request is being traced, a span of it, and carries the `magpie-trace` header so
+ * the service on the other end continues the trace: browser, Nuxt server and Laravel API as one.
+ *
+ * The header goes to every host unless `tracePropagationTargets` lists the ones that should get it.
+ */
+declare function nodeHttp(): Integration;
+
+interface RequestInfo {
+    method: string;
+    /** The path (and query string), or a full URL. */
+    url: string;
+    /** The request's headers, lower-case names. Only a short allow-list of them is ever attached to an event. */
+    headers?: Record<string, string | string[] | undefined>;
+    /** The matched route pattern (`/users/:id`) when the framework already knows it. */
+    route?: string;
+}
+interface RequestHandle {
+    transaction: Transaction;
+    /** Ends the request's transaction. Pass the route pattern when it is only known now, so `/users/7` becomes `/users/:id`. */
+    finish(statusCode: number, route?: string): void;
+}
+/**
+ * Runs `fn` as one request: its own scope and transaction, the request attached to every event raised inside it, and a
+ * trace that continues the caller's `magpie-trace` header (so a page load in the browser and this server render are one
+ * trace). Call `finish` when the response is done.
+ */
+declare function trackRequest<T>(client: Client, info: RequestInfo, fn: (handle: RequestHandle) => T): T;
+
+/**
+ * Delivers payloads from a server. There is no CORS to avoid here, so the key goes in the `X-Magpie-Auth` header,
+ * the same as the Laravel SDK, and the body is JSON, compressed when it is large.
+ */
+declare function nodeTransport(dsn: Dsn, fetchImpl?: typeof fetch, timeoutMs?: number): Transport;
+
+interface NodeOptions extends Options {
+    /** Report uncaught exceptions and unhandled rejections. Default true. */
+    captureUnhandled?: boolean;
+    /** Time and propagate the server's own `fetch` calls. Default true. */
+    http?: boolean;
+    sdkName?: string;
+}
+/**
+ * Starts Magpie on a server. Per-request data (scope, transaction, the request) is isolated with AsyncLocalStorage, so
+ * use `trackRequest` around each request the framework handles.
+ */
+declare function init(options?: NodeOptions): Client;
+
+export { type NodeOptions, type RequestHandle, type RequestInfo, currentStore, init, isolatePerRequest, nodeHttp, nodeTransport, processHandlers, runWithRequest, storage, trackRequest };

package/dist/index.js

@@ -0,0 +1,247 @@
+import { scrubUrl, TRACE_HEADER, formatTraceHeader, endpoint, scrubQuery, parseTraceHeader, getClient, Client, setClient, SDK_VERSION } from '@greenhat-services/magpie-core';
+export * from '@greenhat-services/magpie-core';
+import { AsyncLocalStorage } from 'async_hooks';
+import { hostname, release, platform } from 'os';
+import { gzipSync } from 'zlib';
+
+// src/index.ts
+var storage = new AsyncLocalStorage();
+var currentStore = () => storage.getStore();
+function isolatePerRequest(client) {
+  let processScope = client.scope;
+  let processTransaction = client.activeTransaction;
+  Object.defineProperty(client, "scope", {
+    configurable: true,
+    get: () => storage.getStore()?.scope ?? processScope,
+    // withScope() swaps in a copy while its callback runs and puts the original back afterwards. Inside a request
+    // that swap belongs to the request, so one request's temporary tags can never reach another.
+    set: (scope) => {
+      const store = storage.getStore();
+      if (store) store.scope = scope;
+      else processScope = scope;
+    }
+  });
+  Object.defineProperty(client, "activeTransaction", {
+    configurable: true,
+    get: () => {
+      const store = storage.getStore();
+      return store ? store.transaction : processTransaction;
+    },
+    set: (tx) => {
+      const store = storage.getStore();
+      if (store) store.transaction = tx;
+      else processTransaction = tx;
+    }
+  });
+}
+function runWithRequest(client, request, fn) {
+  return storage.run({ scope: client.scope.clone(), transaction: void 0, request }, fn);
+}
+
+// src/handlers.ts
+function processHandlers() {
+  return {
+    name: "ProcessHandlers",
+    setup(client) {
+      const onUncaught = (error) => {
+        client.captureException(error, { mechanism: { type: "onuncaughtexception", handled: false } });
+        void client.flush(2e3).finally(() => {
+          if (process.listenerCount("uncaughtException") <= 1) {
+            console.error(error);
+            process.exit(1);
+          }
+        });
+      };
+      const onRejection = (reason) => {
+        client.captureException(reason, { mechanism: { type: "onunhandledrejection", handled: false } });
+        if (process.listenerCount("unhandledRejection") <= 1) {
+          setImmediate(() => {
+            throw reason instanceof Error ? reason : new Error(`Unhandled promise rejection: ${String(reason)}`);
+          });
+        }
+      };
+      process.on("uncaughtException", onUncaught);
+      process.on("unhandledRejection", onRejection);
+      return () => {
+        process.off("uncaughtException", onUncaught);
+        process.off("unhandledRejection", onRejection);
+      };
+    }
+  };
+}
+function nodeHttp() {
+  return {
+    name: "NodeHttp",
+    setup(client) {
+      if (typeof globalThis.fetch !== "function") return;
+      const original = globalThis.fetch;
+      const skip = (url) => !!client.dsn && url.startsWith(client.dsn.origin);
+      globalThis.fetch = function patchedFetch(input, init2) {
+        const isRequest = typeof Request !== "undefined" && input instanceof Request;
+        const url = typeof input === "string" ? input : input instanceof URL ? input.href : isRequest ? input.url : String(input);
+        const method = (init2?.method ?? (isRequest ? input.method : "GET")).toUpperCase();
+        if (skip(url)) return original.call(this, input, init2);
+        const tx = client.activeTransaction;
+        const started = performance.now();
+        let span;
+        if (tx?.sampled) span = tx.startChild({ op: "http.client", description: `${method} ${scrubUrl(url).split(/[?#]/)[0]}`, data: { method } });
+        const propagate = (client.options.tracesSampleRate ?? 0) > 0 && !!tx && (client.options.tracePropagationTargets === void 0 || client.shouldPropagate(url));
+        let args = [input, init2];
+        if (propagate && tx) {
+          const headers = new Headers(init2?.headers ?? (isRequest ? input.headers : void 0));
+          if (!headers.has(TRACE_HEADER)) headers.set(TRACE_HEADER, formatTraceHeader(tx.traceId, span?.spanId ?? tx.spanId, tx.sampled));
+          args = [input, { ...init2, headers }];
+        }
+        const finish = (status) => {
+          if (span) {
+            if (status) span.setData("status_code", status);
+            span.setStatus(status === 0 ? "unknown_error" : status >= 500 ? "internal_error" : "ok");
+            span.end();
+          }
+          client.addBreadcrumb({
+            category: "http",
+            type: "http",
+            level: status >= 500 || status === 0 ? "error" : status >= 400 ? "warning" : "info",
+            message: `${method} ${scrubUrl(url)}`,
+            data: { method, status_code: status || "failed", duration_ms: Math.round(performance.now() - started) }
+          });
+        };
+        return original.apply(this, args).then(
+          (response) => {
+            finish(response.status);
+            return response;
+          },
+          (error) => {
+            finish(0);
+            throw error;
+          }
+        );
+      };
+      return () => {
+        globalThis.fetch = original;
+      };
+    }
+  };
+}
+var COMPRESS_FROM = 4096;
+function nodeTransport(dsn, fetchImpl = (...args) => globalThis.fetch(...args), timeoutMs = 3e3) {
+  return {
+    async send(payload) {
+      try {
+        const path = payload.type === "transaction" ? "transactions" : "events";
+        const json = JSON.stringify(payload);
+        const compressed = json.length >= COMPRESS_FROM;
+        const response = await fetchImpl(endpoint(dsn, path), {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-Magpie-Auth": `Magpie magpie_version=1, magpie_key=${dsn.publicKey}, magpie_client=magpie-node`,
+            ...compressed ? { "Content-Encoding": "gzip" } : {}
+          },
+          body: compressed ? new Uint8Array(gzipSync(json)) : json,
+          signal: AbortSignal.timeout(timeoutMs)
+        });
+        const retry = Number(response.headers.get("retry-after"));
+        return { ok: response.ok, status: response.status, retryAfter: Number.isFinite(retry) && retry > 0 ? Math.min(retry, 3600) : void 0 };
+      } catch {
+        return { ok: false };
+      }
+    }
+  };
+}
+
+// src/runtime.ts
+var SDK_NAME = "magpie.javascript.node";
+var OS_NAMES = { win32: "Windows", darwin: "macOS", linux: "Linux", freebsd: "FreeBSD" };
+function nodeRuntime(options = {}) {
+  return {
+    sdk: { name: options.sdkName ?? SDK_NAME, version: SDK_VERSION },
+    platform: "node",
+    createTransport: (dsn) => nodeTransport(dsn, options.fetch),
+    contexts: () => ({
+      runtime: { name: "node", version: process.version.replace(/^v/, "") },
+      os: { name: OS_NAMES[platform()] ?? platform(), version: release() }
+    }),
+    // The request being served, when there is one: set by `trackRequest`, read here for every event.
+    request: () => currentStore()?.request
+  };
+}
+var defaultServerName = () => {
+  try {
+    return hostname() || void 0;
+  } catch {
+    return void 0;
+  }
+};
+var SAFE_HEADERS = ["user-agent", "accept", "accept-language", "content-type", "host", "referer", "x-forwarded-proto"];
+function trackRequest(client, info, fn) {
+  const { path, query } = splitUrl(info.url);
+  const request = {
+    url: info.headers?.host ? `${firstHeader(info.headers["x-forwarded-proto"]) ?? "http"}://${firstHeader(info.headers.host)}${path}` : path,
+    method: info.method.toUpperCase(),
+    ...query ? { query_string: scrubQuery(query) } : {},
+    headers: safeHeaders(info.headers)
+  };
+  return runWithRequest(client, request, () => {
+    const parent = parseTraceHeader(firstHeader(info.headers?.[TRACE_HEADER]));
+    const method = info.method.toUpperCase();
+    const name = (route) => `${method} ${route ?? info.route ?? path}`;
+    const transaction = client.startTransaction({
+      name: name(),
+      op: "http.server",
+      ...parent ? { traceId: parent.traceId, parentSpanId: parent.spanId, sampled: parent.sampled } : {}
+    });
+    client.activeTransaction = transaction;
+    client.scope.setTransactionName(transaction.name);
+    const finish = (statusCode, route) => {
+      transaction.setName(name(route));
+      transaction.setData("http.status_code", statusCode);
+      if (statusCode >= 500) transaction.setStatus("internal_error");
+      transaction.end();
+    };
+    return fn({ transaction, finish });
+  });
+}
+function splitUrl(url) {
+  let target = url;
+  try {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(url)) {
+      const u = new URL(url);
+      target = `${u.pathname}${u.search}`;
+    }
+  } catch {
+  }
+  const q = target.indexOf("?");
+  return q < 0 ? { path: target, query: "" } : { path: target.slice(0, q), query: target.slice(q + 1) };
+}
+function firstHeader(value) {
+  return Array.isArray(value) ? value[0] : value;
+}
+function safeHeaders(headers) {
+  const out = {};
+  for (const name of SAFE_HEADERS) {
+    const value = firstHeader(headers?.[name]);
+    if (value) out[name] = value;
+  }
+  return out;
+}
+
+// src/index.ts
+function init(options = {}) {
+  const previous = getClient();
+  if (previous) void previous.close(0);
+  const { captureUnhandled = true, http = true, sdkName, integrations = [], ...rest } = options;
+  const client = new Client(
+    { serverName: defaultServerName(), ...rest, release: rest.release ?? process.env.MAGPIE_RELEASE },
+    nodeRuntime({ sdkName })
+  );
+  isolatePerRequest(client);
+  setClient(client);
+  const defaults = [...captureUnhandled ? [processHandlers()] : [], ...http ? [nodeHttp()] : []];
+  client.setupIntegrations([...defaults, ...integrations]);
+  return client;
+}
+
+export { currentStore, init, isolatePerRequest, nodeHttp, nodeTransport, processHandlers, runWithRequest, storage, trackRequest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/handlers.ts","../src/http.ts","../src/transport.ts","../src/runtime.ts","../src/request.ts","../src/index.ts"],"names":["init","TRACE_HEADER"],"mappings":";;;;;;;AAcO,IAAM,OAAA,GAAU,IAAI,iBAAA;AAEpB,IAAM,YAAA,GAAe,MAAgC,OAAA,CAAQ,QAAA;AAM7D,SAAS,kBAAkB,MAAA,EAAsB;AACpD,EAAA,IAAI,eAAe,MAAA,CAAO,KAAA;AAC1B,EAAA,IAAI,qBAAqB,MAAA,CAAO,iBAAA;AAEhC,EAAA,MAAA,CAAO,cAAA,CAAe,QAAQ,OAAA,EAAS;AAAA,IACnC,YAAA,EAAc,IAAA;AAAA,IACd,GAAA,EAAK,MAAM,OAAA,CAAQ,QAAA,IAAY,KAAA,IAAS,YAAA;AAAA;AAAA;AAAA,IAGxC,GAAA,EAAK,CAAC,KAAA,KAAiB;AACnB,MAAA,MAAM,KAAA,GAAQ,QAAQ,QAAA,EAAS;AAC/B,MAAA,IAAI,KAAA,QAAa,KAAA,GAAQ,KAAA;AAAA,WACpB,YAAA,GAAe,KAAA;AAAA,IACxB;AAAA,GACH,CAAA;AAED,EAAA,MAAA,CAAO,cAAA,CAAe,QAAQ,mBAAA,EAAqB;AAAA,IAC/C,YAAA,EAAc,IAAA;AAAA,IACd,KAAK,MAAM;AACP,MAAA,MAAM,KAAA,GAAQ,QAAQ,QAAA,EAAS;AAE/B,MAAA,OAAO,KAAA,GAAQ,MAAM,WAAA,GAAc,kBAAA;AAAA,IACvC,CAAA;AAAA,IACA,GAAA,EAAK,CAAC,EAAA,KAAgC;AAClC,MAAA,MAAM,KAAA,GAAQ,QAAQ,QAAA,EAAS;AAC/B,MAAA,IAAI,KAAA,QAAa,WAAA,GAAc,EAAA;AAAA,WAC1B,kBAAA,GAAqB,EAAA;AAAA,IAC9B;AAAA,GACH,CAAA;AACL;AAGO,SAAS,cAAA,CAAkB,MAAA,EAAgB,OAAA,EAA6C,EAAA,EAAgB;AAC3G,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,EAAE,KAAA,EAAO,MAAA,CAAO,KAAA,CAAM,KAAA,EAAM,EAAG,WAAA,EAAa,MAAA,EAAW,OAAA,EAAQ,EAAG,EAAE,CAAA;AAC3F;;;AClDO,SAAS,eAAA,GAA+B;AAC3C,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,iBAAA;AAAA,IACN,MAAM,MAAA,EAAgB;AAClB,MAAA,MAAM,UAAA,GAAa,CAAC,KAAA,KAAiB;AACjC,QAAA,MAAA,CAAO,gBAAA,CAAiB,KAAA,EAAO,EAAE,SAAA,EAAW,EAAE,MAAM,qBAAA,EAAuB,OAAA,EAAS,KAAA,EAAM,EAAG,CAAA;AAE7F,QAAA,KAAK,MAAA,CAAO,KAAA,CAAM,GAAI,CAAA,CAAE,QAAQ,MAAM;AAClC,UAAA,IAAI,OAAA,CAAQ,aAAA,CAAc,mBAAmB,CAAA,IAAK,CAAA,EAAG;AACjD,YAAA,OAAA,CAAQ,MAAM,KAAK,CAAA;AACnB,YAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,UAClB;AAAA,QACJ,CAAC,CAAA;AAAA,MACL,CAAA;AAEA,MAAA,MAAM,WAAA,GAAc,CAAC,MAAA,KAAoB;AACrC,QAAA,MAAA,CAAO,gBAAA,CAAiB,MAAA,EAAQ,EAAE,SAAA,EAAW,EAAE,MAAM,sBAAA,EAAwB,OAAA,EAAS,KAAA,EAAM,EAAG,CAAA;AAI/F,QAAA,IAAI,OAAA,CAAQ,aAAA,CAAc,oBAAoB,CAAA,IAAK,CAAA,EAAG;AAClD,UAAA,YAAA,CAAa,MAAM;AACf,YAAA,MAAM,MAAA,YAAkB,QAAQ,MAAA,GAAS,IAAI,MAAM,CAAA,6BAAA,EAAgC,MAAA,CAAO,MAAM,CAAC,CAAA,CAAE,CAAA;AAAA,UACvG,CAAC,CAAA;AAAA,QACL;AAAA,MACJ,CAAA;AAEA,MAAA,OAAA,CAAQ,EAAA,CAAG,qBAAqB,UAAU,CAAA;AAC1C,MAAA,OAAA,CAAQ,EAAA,CAAG,sBAAsB,WAAW,CAAA;AAE5C,MAAA,OAAO,MAAM;AACT,QAAA,OAAA,CAAQ,GAAA,CAAI,qBAAqB,UAAU,CAAA;AAC3C,QAAA,OAAA,CAAQ,GAAA,CAAI,sBAAsB,WAAW,CAAA;AAAA,MACjD,CAAA;AAAA,IACJ;AAAA,GACJ;AACJ;ACjCO,SAAS,QAAA,GAAwB;AACpC,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,UAAA;AAAA,IACN,MAAM,MAAA,EAAgB;AAClB,MAAA,IAAI,OAAO,UAAA,CAAW,KAAA,KAAU,UAAA,EAAY;AAE5C,MAAA,MAAM,WAAW,UAAA,CAAW,KAAA;AAC5B,MAAA,MAAM,IAAA,GAAO,CAAC,GAAA,KAAgB,CAAC,CAAC,MAAA,CAAO,GAAA,IAAO,GAAA,CAAI,UAAA,CAAW,MAAA,CAAO,GAAA,CAAI,MAAM,CAAA;AAE9E,MAAA,UAAA,CAAW,KAAA,GAAQ,SAAS,YAAA,CAA4B,KAAA,EAAoCA,KAAAA,EAAoB;AAC5G,QAAA,MAAM,SAAA,GAAY,OAAO,OAAA,KAAY,WAAA,IAAe,KAAA,YAAiB,OAAA;AACrE,QAAA,MAAM,GAAA,GAAM,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,KAAA,YAAiB,GAAA,GAAM,KAAA,CAAM,IAAA,GAAO,SAAA,GAAa,KAAA,CAAkB,GAAA,GAAM,OAAO,KAAK,CAAA;AACrI,QAAA,MAAM,UAAUA,KAAAA,EAAM,MAAA,KAAW,YAAa,KAAA,CAAkB,MAAA,GAAS,QAAQ,WAAA,EAAY;AAE7F,QAAA,IAAI,IAAA,CAAK,GAAG,CAAA,EAAG,OAAO,SAAS,IAAA,CAAK,IAAA,EAAM,OAAOA,KAAI,CAAA;AAErD,QAAA,MAAM,KAAK,MAAA,CAAO,iBAAA;AAClB,QAAA,MAAM,OAAA,GAAU,YAAY,GAAA,EAAI;AAChC,QAAA,IAAI,IAAA;AACJ,QAAA,IAAI,EAAA,EAAI,OAAA,EAAS,IAAA,GAAO,EAAA,CAAG,UAAA,CAAW,EAAE,EAAA,EAAI,aAAA,EAAe,WAAA,EAAa,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,GAAG,CAAA,CAAE,KAAA,CAAM,MAAM,CAAA,CAAE,CAAC,CAAC,CAAA,CAAA,EAAI,IAAA,EAAM,EAAE,MAAA,EAAO,EAAG,CAAA;AAEzI,QAAA,MAAM,SAAA,GAAA,CAAa,MAAA,CAAO,OAAA,CAAQ,gBAAA,IAAoB,KAAK,CAAA,IAAK,CAAC,CAAC,EAAA,KAAO,OAAO,OAAA,CAAQ,uBAAA,KAA4B,MAAA,IAAa,MAAA,CAAO,gBAAgB,GAAG,CAAA,CAAA;AAC3J,QAAA,IAAI,IAAA,GAA+D,CAAC,KAAA,EAAOA,KAAI,CAAA;AAC/E,QAAA,IAAI,aAAa,EAAA,EAAI;AACjB,UAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAQA,KAAAA,EAAM,YAAY,SAAA,GAAa,KAAA,CAAkB,UAAU,MAAA,CAAU,CAAA;AACjG,UAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,YAAY,CAAA,UAAW,GAAA,CAAI,YAAA,EAAc,iBAAA,CAAkB,EAAA,CAAG,SAAS,IAAA,EAAM,MAAA,IAAU,GAAG,MAAA,EAAQ,EAAA,CAAG,OAAO,CAAC,CAAA;AAC9H,UAAA,IAAA,GAAO,CAAC,KAAA,EAAO,EAAE,GAAGA,KAAAA,EAAM,SAAS,CAAA;AAAA,QACvC;AAEA,QAAA,MAAM,MAAA,GAAS,CAAC,MAAA,KAAmB;AAC/B,UAAA,IAAI,IAAA,EAAM;AACN,YAAA,IAAI,MAAA,EAAQ,IAAA,CAAK,OAAA,CAAQ,aAAA,EAAe,MAAM,CAAA;AAC9C,YAAA,IAAA,CAAK,UAAU,MAAA,KAAW,CAAA,GAAI,kBAAkB,MAAA,IAAU,GAAA,GAAM,mBAAmB,IAAI,CAAA;AACvF,YAAA,IAAA,CAAK,GAAA,EAAI;AAAA,UACb;AACA,UAAA,MAAA,CAAO,aAAA,CAAc;AAAA,YACjB,QAAA,EAAU,MAAA;AAAA,YACV,IAAA,EAAM,MAAA;AAAA,YACN,KAAA,EAAO,UAAU,GAAA,IAAO,MAAA,KAAW,IAAI,OAAA,GAAU,MAAA,IAAU,MAAM,SAAA,GAAY,MAAA;AAAA,YAC7E,SAAS,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,QAAA,CAAS,GAAG,CAAC,CAAA,CAAA;AAAA,YACnC,IAAA,EAAM,EAAE,MAAA,EAAQ,WAAA,EAAa,MAAA,IAAU,QAAA,EAAU,WAAA,EAAa,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,GAAA,EAAI,GAAI,OAAO,CAAA;AAAE,WACzG,CAAA;AAAA,QACL,CAAA;AAEA,QAAA,OAAO,QAAA,CAAS,KAAA,CAAM,IAAA,EAAM,IAAI,CAAA,CAAE,IAAA;AAAA,UAC9B,CAAC,QAAA,KAAa;AACV,YAAA,MAAA,CAAO,SAAS,MAAM,CAAA;AAEtB,YAAA,OAAO,QAAA;AAAA,UACX,CAAA;AAAA,UACA,CAAC,KAAA,KAAU;AACP,YAAA,MAAA,CAAO,CAAC,CAAA;AACR,YAAA,MAAM,KAAA;AAAA,UACV;AAAA,SACJ;AAAA,MACJ,CAAA;AAEA,MAAA,OAAO,MAAM;AACT,QAAA,UAAA,CAAW,KAAA,GAAQ,QAAA;AAAA,MACvB,CAAA;AAAA,IACJ;AAAA,GACJ;AACJ;ACnEA,IAAM,aAAA,GAAgB,IAAA;AAMf,SAAS,aAAA,CAAc,GAAA,EAAU,SAAA,GAA0B,CAAA,GAAI,IAAA,KAAS,UAAA,CAAW,KAAA,CAAM,GAAG,IAAI,CAAA,EAAG,SAAA,GAAY,GAAA,EAAiB;AACnI,EAAA,OAAO;AAAA,IACH,MAAM,KAAK,OAAA,EAA4C;AACnD,MAAA,IAAI;AACA,QAAA,MAAM,IAAA,GAAQ,OAAA,CAA8B,IAAA,KAAS,aAAA,GAAgB,cAAA,GAAiB,QAAA;AACtF,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AACnC,QAAA,MAAM,UAAA,GAAa,KAAK,MAAA,IAAU,aAAA;AAElC,QAAA,MAAM,WAAW,MAAM,SAAA,CAAU,QAAA,CAAS,GAAA,EAAK,IAAI,CAAA,EAAG;AAAA,UAClD,MAAA,EAAQ,MAAA;AAAA,UACR,OAAA,EAAS;AAAA,YACL,cAAA,EAAgB,kBAAA;AAAA,YAChB,eAAA,EAAiB,CAAA,oCAAA,EAAuC,GAAA,CAAI,SAAS,CAAA,2BAAA,CAAA;AAAA,YACrE,GAAI,UAAA,GAAa,EAAE,kBAAA,EAAoB,MAAA,KAAW;AAAC,WACvD;AAAA,UACA,MAAM,UAAA,GAAa,IAAI,WAAW,QAAA,CAAS,IAAI,CAAC,CAAA,GAAI,IAAA;AAAA,UACpD,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,SAAS;AAAA,SACxC,CAAA;AAED,QAAA,MAAM,QAAQ,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAExD,QAAA,OAAO,EAAE,EAAA,EAAI,QAAA,CAAS,IAAI,MAAA,EAAQ,QAAA,CAAS,QAAQ,UAAA,EAAY,MAAA,CAAO,SAAS,KAAK,CAAA,IAAK,QAAQ,CAAA,GAAI,IAAA,CAAK,IAAI,KAAA,EAAO,IAAI,IAAI,KAAA,CAAA,EAAU;AAAA,MAC3I,CAAA,CAAA,MAAQ;AAEJ,QAAA,OAAO,EAAE,IAAI,KAAA,EAAM;AAAA,MACvB;AAAA,IACJ;AAAA,GACJ;AACJ;;;ACjCO,IAAM,QAAA,GAAW,wBAAA;AAExB,IAAM,QAAA,GAAmC,EAAE,KAAA,EAAO,SAAA,EAAW,QAAQ,OAAA,EAAS,KAAA,EAAO,OAAA,EAAS,OAAA,EAAS,SAAA,EAAU;AAE1G,SAAS,WAAA,CAAY,OAAA,GAAsD,EAAC,EAAY;AAC3F,EAAA,OAAO;AAAA,IACH,KAAK,EAAE,IAAA,EAAM,QAAQ,OAAA,IAAW,QAAA,EAAU,SAAS,WAAA,EAAY;AAAA,IAC/D,QAAA,EAAU,MAAA;AAAA,IACV,iBAAiB,CAAC,GAAA,KAAQ,aAAA,CAAc,GAAA,EAAK,QAAQ,KAAK,CAAA;AAAA,IAC1D,UAAU,OAAO;AAAA,MACb,OAAA,EAAS,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,QAAQ,OAAA,CAAQ,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAA,EAAE;AAAA,MACpE,EAAA,EAAI,EAAE,IAAA,EAAM,QAAA,CAAS,QAAA,EAAU,CAAA,IAAK,QAAA,EAAS,EAAG,OAAA,EAAS,OAAA,EAAQ;AAAE,KACvE,CAAA;AAAA;AAAA,IAEA,OAAA,EAAS,MAAM,YAAA,EAAa,EAAG;AAAA,GACnC;AACJ;AAEO,IAAM,oBAAoB,MAA0B;AACvD,EAAA,IAAI;AACA,IAAA,OAAO,UAAS,IAAK,KAAA,CAAA;AAAA,EACzB,CAAA,CAAA,MAAQ;AACJ,IAAA,OAAO,MAAA;AAAA,EACX;AACJ,CAAA;ACfA,IAAM,YAAA,GAAe,CAAC,YAAA,EAAc,QAAA,EAAU,mBAAmB,cAAA,EAAgB,MAAA,EAAQ,WAAW,mBAAmB,CAAA;AAahH,SAAS,YAAA,CAAgB,MAAA,EAAgB,IAAA,EAAmB,EAAA,EAAqC;AACpG,EAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,QAAA,CAAS,KAAK,GAAG,CAAA;AACzC,EAAA,MAAM,OAAA,GAAU;AAAA,IACZ,GAAA,EAAK,KAAK,OAAA,EAAS,IAAA,GAAO,GAAG,WAAA,CAAY,IAAA,CAAK,QAAQ,mBAAmB,CAAC,KAAK,MAAM,CAAA,GAAA,EAAM,YAAY,IAAA,CAAK,OAAA,CAAQ,IAAI,CAAC,CAAA,EAAG,IAAI,CAAA,CAAA,GAAK,IAAA;AAAA,IACrI,MAAA,EAAQ,IAAA,CAAK,MAAA,CAAO,WAAA,EAAY;AAAA,IAChC,GAAI,QAAQ,EAAE,YAAA,EAAc,WAAW,KAAK,CAAA,KAAM,EAAC;AAAA,IACnD,OAAA,EAAS,WAAA,CAAY,IAAA,CAAK,OAAO;AAAA,GACrC;AAEA,EAAA,OAAO,cAAA,CAAe,MAAA,EAAQ,OAAA,EAAS,MAAM;AACzC,IAAA,MAAM,SAAS,gBAAA,CAAiB,WAAA,CAAY,KAAK,OAAA,GAAUC,YAAY,CAAC,CAAC,CAAA;AACzE,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,CAAO,WAAA,EAAY;AACvC,IAAA,MAAM,IAAA,GAAO,CAAC,KAAA,KAAmB,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,KAAA,IAAS,IAAA,CAAK,KAAA,IAAS,IAAI,CAAA,CAAA;AAEzE,IAAA,MAAM,WAAA,GAAc,OAAO,gBAAA,CAAiB;AAAA,MACxC,MAAM,IAAA,EAAK;AAAA,MACX,EAAA,EAAI,aAAA;AAAA,MACJ,GAAI,MAAA,GAAS,EAAE,OAAA,EAAS,MAAA,CAAO,OAAA,EAAS,YAAA,EAAc,MAAA,CAAO,MAAA,EAAQ,OAAA,EAAS,MAAA,CAAO,OAAA,KAAY;AAAC,KACrG,CAAA;AACD,IAAA,MAAA,CAAO,iBAAA,GAAoB,WAAA;AAC3B,IAAA,MAAA,CAAO,KAAA,CAAM,kBAAA,CAAmB,WAAA,CAAY,IAAI,CAAA;AAEhD,IAAA,MAAM,MAAA,GAAS,CAAC,UAAA,EAAoB,KAAA,KAAmB;AACnD,MAAA,WAAA,CAAY,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAC,CAAA;AAC/B,MAAA,WAAA,CAAY,OAAA,CAAQ,oBAAoB,UAAU,CAAA;AAElD,MAAA,IAAI,UAAA,IAAc,GAAA,EAAK,WAAA,CAAY,SAAA,CAAU,gBAAgB,CAAA;AAC7D,MAAA,WAAA,CAAY,GAAA,EAAI;AAAA,IACpB,CAAA;AAEA,IAAA,OAAO,EAAA,CAAG,EAAE,WAAA,EAAa,MAAA,EAAQ,CAAA;AAAA,EACrC,CAAC,CAAA;AACL;AAEA,SAAS,SAAS,GAAA,EAA8C;AAC5D,EAAA,IAAI,MAAA,GAAS,GAAA;AACb,EAAA,IAAI;AACA,IAAA,IAAI,sBAAA,CAAuB,IAAA,CAAK,GAAG,CAAA,EAAG;AAClC,MAAA,MAAM,CAAA,GAAI,IAAI,GAAA,CAAI,GAAG,CAAA;AACrB,MAAA,MAAA,GAAS,CAAA,EAAG,CAAA,CAAE,QAAQ,CAAA,EAAG,EAAE,MAAM,CAAA,CAAA;AAAA,IACrC;AAAA,EACJ,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,MAAM,CAAA,GAAI,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAE5B,EAAA,OAAO,CAAA,GAAI,IAAI,EAAE,IAAA,EAAM,QAAQ,KAAA,EAAO,EAAA,KAAO,EAAE,IAAA,EAAM,OAAO,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA,EAAG,KAAA,EAAO,OAAO,KAAA,CAAM,CAAA,GAAI,CAAC,CAAA,EAAE;AACxG;AAEA,SAAS,YAAY,KAAA,EAA0D;AAC3E,EAAA,OAAO,MAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,CAAM,CAAC,CAAA,GAAI,KAAA;AAC7C;AAEA,SAAS,YAAY,OAAA,EAAyD;AAC1E,EAAA,MAAM,MAA8B,EAAC;AACrC,EAAA,KAAA,MAAW,QAAQ,YAAA,EAAc;AAC7B,IAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,OAAA,GAAU,IAAI,CAAC,CAAA;AACzC,IAAA,IAAI,KAAA,EAAO,GAAA,CAAI,IAAI,CAAA,GAAI,KAAA;AAAA,EAC3B;AAEA,EAAA,OAAO,GAAA;AACX;;;AC/DO,SAAS,IAAA,CAAK,OAAA,GAAuB,EAAC,EAAW;AACpD,EAAA,MAAM,WAAW,SAAA,EAAU;AAC3B,EAAA,IAAI,QAAA,EAAU,KAAK,QAAA,CAAS,KAAA,CAAM,CAAC,CAAA;AAEnC,EAAA,MAAM,EAAE,gBAAA,GAAmB,IAAA,EAAM,IAAA,GAAO,IAAA,EAAM,OAAA,EAAS,YAAA,GAAe,EAAC,EAAG,GAAG,IAAA,EAAK,GAAI,OAAA;AAEtF,EAAA,MAAM,SAAS,IAAI,MAAA;AAAA,IACf,EAAE,UAAA,EAAY,iBAAA,EAAkB,EAAG,GAAG,IAAA,EAAM,OAAA,EAAS,IAAA,CAAK,OAAA,IAAW,OAAA,CAAQ,GAAA,CAAI,cAAA,EAAe;AAAA,IAChG,WAAA,CAAY,EAAE,OAAA,EAAS;AAAA,GAC3B;AAEA,EAAA,iBAAA,CAAkB,MAAM,CAAA;AACxB,EAAA,SAAA,CAAU,MAAM,CAAA;AAEhB,EAAA,MAAM,WAA0B,CAAC,GAAI,gBAAA,GAAmB,CAAC,iBAAiB,CAAA,GAAI,EAAC,EAAI,GAAI,IAAA,GAAO,CAAC,UAAU,CAAA,GAAI,EAAG,CAAA;AAChH,EAAA,MAAA,CAAO,kBAAkB,CAAC,GAAG,QAAA,EAAU,GAAG,YAAY,CAAC,CAAA;AAEvD,EAAA,OAAO,MAAA;AACX","file":"index.js","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Client, MagpieEvent, Scope, Transaction } from '@greenhat-services/magpie-core';\n\n/**\n * What belongs to one request on a server that handles many at once: its own scope (tags, user, breadcrumbs), the\n * transaction being timed, and the request being served. Carried through every `await` by AsyncLocalStorage, so two\n * overlapping requests never see each other's data.\n */\nexport interface RequestStore {\n    scope: Scope;\n    transaction: Transaction | undefined;\n    request: MagpieEvent['request'] | undefined;\n}\n\nexport const storage = new AsyncLocalStorage<RequestStore>();\n\nexport const currentStore = (): RequestStore | undefined => storage.getStore();\n\n/**\n * Makes `client.scope` and `client.activeTransaction` follow the request that is running, and fall back to the\n * process-wide ones outside any request. Applied to the instance, so core stays free of Node.\n */\nexport function isolatePerRequest(client: Client): void {\n    let processScope = client.scope;\n    let processTransaction = client.activeTransaction;\n\n    Object.defineProperty(client, 'scope', {\n        configurable: true,\n        get: () => storage.getStore()?.scope ?? processScope,\n        // withScope() swaps in a copy while its callback runs and puts the original back afterwards. Inside a request\n        // that swap belongs to the request, so one request's temporary tags can never reach another.\n        set: (scope: Scope) => {\n            const store = storage.getStore();\n            if (store) store.scope = scope;\n            else processScope = scope;\n        },\n    });\n\n    Object.defineProperty(client, 'activeTransaction', {\n        configurable: true,\n        get: () => {\n            const store = storage.getStore();\n\n            return store ? store.transaction : processTransaction;\n        },\n        set: (tx: Transaction | undefined) => {\n            const store = storage.getStore();\n            if (store) store.transaction = tx;\n            else processTransaction = tx;\n        },\n    });\n}\n\n/** Runs `fn` as one request: a copy of the process scope, its own transaction slot, and the request being served. */\nexport function runWithRequest<T>(client: Client, request: MagpieEvent['request'] | undefined, fn: () => T): T {\n    return storage.run({ scope: client.scope.clone(), transaction: undefined, request }, fn);\n}\n","import type { Client, Integration } from '@greenhat-services/magpie-core';\n\n/**\n * Reports what the process did not catch. Adding a listener for either event removes Node's own reaction to it (print\n * and exit), so after reporting, that reaction is restored unless something else in the process is handling it.\n */\nexport function processHandlers(): Integration {\n    return {\n        name: 'ProcessHandlers',\n        setup(client: Client) {\n            const onUncaught = (error: Error) => {\n                client.captureException(error, { mechanism: { type: 'onuncaughtexception', handled: false } });\n\n                void client.flush(2000).finally(() => {\n                    if (process.listenerCount('uncaughtException') <= 1) {\n                        console.error(error);\n                        process.exit(1);\n                    }\n                });\n            };\n\n            const onRejection = (reason: unknown) => {\n                client.captureException(reason, { mechanism: { type: 'onunhandledrejection', handled: false } });\n\n                // Node's default since v15 is to raise an unhandled rejection as an uncaught exception. Keep it, so a\n                // server that crashed before Magpie still crashes (and the crash is already reported).\n                if (process.listenerCount('unhandledRejection') <= 1) {\n                    setImmediate(() => {\n                        throw reason instanceof Error ? reason : new Error(`Unhandled promise rejection: ${String(reason)}`);\n                    });\n                }\n            };\n\n            process.on('uncaughtException', onUncaught);\n            process.on('unhandledRejection', onRejection);\n\n            return () => {\n                process.off('uncaughtException', onUncaught);\n                process.off('unhandledRejection', onRejection);\n            };\n        },\n    };\n}\n","import { type Client, formatTraceHeader, type Integration, scrubUrl, type Span, TRACE_HEADER } from '@greenhat-services/magpie-core';\n\n/**\n * Times the server's own outgoing `fetch` calls (an API your pages render from). Each becomes a breadcrumb on the\n * current request and, when that request is being traced, a span of it, and carries the `magpie-trace` header so\n * the service on the other end continues the trace: browser, Nuxt server and Laravel API as one.\n *\n * The header goes to every host unless `tracePropagationTargets` lists the ones that should get it.\n */\nexport function nodeHttp(): Integration {\n    return {\n        name: 'NodeHttp',\n        setup(client: Client) {\n            if (typeof globalThis.fetch !== 'function') return;\n\n            const original = globalThis.fetch;\n            const skip = (url: string) => !!client.dsn && url.startsWith(client.dsn.origin);\n\n            globalThis.fetch = function patchedFetch(this: unknown, input: Parameters<typeof fetch>[0], init?: RequestInit) {\n                const isRequest = typeof Request !== 'undefined' && input instanceof Request;\n                const url = typeof input === 'string' ? input : input instanceof URL ? input.href : isRequest ? (input as Request).url : String(input);\n                const method = (init?.method ?? (isRequest ? (input as Request).method : 'GET')).toUpperCase();\n\n                if (skip(url)) return original.call(this, input, init);\n\n                const tx = client.activeTransaction;\n                const started = performance.now();\n                let span: Span | undefined;\n                if (tx?.sampled) span = tx.startChild({ op: 'http.client', description: `${method} ${scrubUrl(url).split(/[?#]/)[0]}`, data: { method } });\n\n                const propagate = (client.options.tracesSampleRate ?? 0) > 0 && !!tx && (client.options.tracePropagationTargets === undefined || client.shouldPropagate(url));\n                let args: [Parameters<typeof fetch>[0], RequestInit | undefined] = [input, init];\n                if (propagate && tx) {\n                    const headers = new Headers(init?.headers ?? (isRequest ? (input as Request).headers : undefined));\n                    if (!headers.has(TRACE_HEADER)) headers.set(TRACE_HEADER, formatTraceHeader(tx.traceId, span?.spanId ?? tx.spanId, tx.sampled));\n                    args = [input, { ...init, headers }];\n                }\n\n                const finish = (status: number) => {\n                    if (span) {\n                        if (status) span.setData('status_code', status);\n                        span.setStatus(status === 0 ? 'unknown_error' : status >= 500 ? 'internal_error' : 'ok');\n                        span.end();\n                    }\n                    client.addBreadcrumb({\n                        category: 'http',\n                        type: 'http',\n                        level: status >= 500 || status === 0 ? 'error' : status >= 400 ? 'warning' : 'info',\n                        message: `${method} ${scrubUrl(url)}`,\n                        data: { method, status_code: status || 'failed', duration_ms: Math.round(performance.now() - started) },\n                    });\n                };\n\n                return original.apply(this, args).then(\n                    (response) => {\n                        finish(response.status);\n\n                        return response;\n                    },\n                    (error) => {\n                        finish(0);\n                        throw error;\n                    },\n                );\n            } as typeof fetch;\n\n            return () => {\n                globalThis.fetch = original;\n            };\n        },\n    };\n}\n","import { gzipSync } from 'node:zlib';\nimport { type Dsn, endpoint, type Payload, type Transport, type TransportResult } from '@greenhat-services/magpie-core';\n\n/** Bodies above this are gzip-compressed, which Magpie accepts. */\nconst COMPRESS_FROM = 4096;\n\n/**\n * Delivers payloads from a server. There is no CORS to avoid here, so the key goes in the `X-Magpie-Auth` header,\n * the same as the Laravel SDK, and the body is JSON, compressed when it is large.\n */\nexport function nodeTransport(dsn: Dsn, fetchImpl: typeof fetch = (...args) => globalThis.fetch(...args), timeoutMs = 3000): Transport {\n    return {\n        async send(payload: Payload): Promise<TransportResult> {\n            try {\n                const path = (payload as { type?: string }).type === 'transaction' ? 'transactions' : 'events';\n                const json = JSON.stringify(payload);\n                const compressed = json.length >= COMPRESS_FROM;\n\n                const response = await fetchImpl(endpoint(dsn, path), {\n                    method: 'POST',\n                    headers: {\n                        'Content-Type': 'application/json',\n                        'X-Magpie-Auth': `Magpie magpie_version=1, magpie_key=${dsn.publicKey}, magpie_client=magpie-node`,\n                        ...(compressed ? { 'Content-Encoding': 'gzip' } : {}),\n                    },\n                    body: compressed ? new Uint8Array(gzipSync(json)) : json,\n                    signal: AbortSignal.timeout(timeoutMs),\n                });\n\n                const retry = Number(response.headers.get('retry-after'));\n\n                return { ok: response.ok, status: response.status, retryAfter: Number.isFinite(retry) && retry > 0 ? Math.min(retry, 3600) : undefined };\n            } catch {\n                // Unreachable, or too slow: monitoring must never hold a request up, so the payload is dropped.\n                return { ok: false };\n            }\n        },\n    };\n}\n","import { hostname, platform, release } from 'node:os';\nimport { type Runtime, SDK_VERSION } from '@greenhat-services/magpie-core';\nimport { currentStore } from './context';\nimport { nodeTransport } from './transport';\n\nexport const SDK_NAME = 'magpie.javascript.node';\n\nconst OS_NAMES: Record<string, string> = { win32: 'Windows', darwin: 'macOS', linux: 'Linux', freebsd: 'FreeBSD' };\n\nexport function nodeRuntime(options: { sdkName?: string; fetch?: typeof fetch } = {}): Runtime {\n    return {\n        sdk: { name: options.sdkName ?? SDK_NAME, version: SDK_VERSION },\n        platform: 'node',\n        createTransport: (dsn) => nodeTransport(dsn, options.fetch),\n        contexts: () => ({\n            runtime: { name: 'node', version: process.version.replace(/^v/, '') },\n            os: { name: OS_NAMES[platform()] ?? platform(), version: release() },\n        }),\n        // The request being served, when there is one: set by `trackRequest`, read here for every event.\n        request: () => currentStore()?.request,\n    };\n}\n\nexport const defaultServerName = (): string | undefined => {\n    try {\n        return hostname() || undefined;\n    } catch {\n        return undefined;\n    }\n};\n","import { type Client, parseTraceHeader, scrubQuery, TRACE_HEADER, type Transaction } from '@greenhat-services/magpie-core';\nimport { runWithRequest } from './context';\n\nexport interface RequestInfo {\n    method: string;\n    /** The path (and query string), or a full URL. */\n    url: string;\n    /** The request's headers, lower-case names. Only a short allow-list of them is ever attached to an event. */\n    headers?: Record<string, string | string[] | undefined>;\n    /** The matched route pattern (`/users/:id`) when the framework already knows it. */\n    route?: string;\n}\n\n/** Headers worth having on an event. Everything else, cookies and authorization above all, is dropped, not filtered. */\nconst SAFE_HEADERS = ['user-agent', 'accept', 'accept-language', 'content-type', 'host', 'referer', 'x-forwarded-proto'];\n\nexport interface RequestHandle {\n    transaction: Transaction;\n    /** Ends the request's transaction. Pass the route pattern when it is only known now, so `/users/7` becomes `/users/:id`. */\n    finish(statusCode: number, route?: string): void;\n}\n\n/**\n * Runs `fn` as one request: its own scope and transaction, the request attached to every event raised inside it, and a\n * trace that continues the caller's `magpie-trace` header (so a page load in the browser and this server render are one\n * trace). Call `finish` when the response is done.\n */\nexport function trackRequest<T>(client: Client, info: RequestInfo, fn: (handle: RequestHandle) => T): T {\n    const { path, query } = splitUrl(info.url);\n    const request = {\n        url: info.headers?.host ? `${firstHeader(info.headers['x-forwarded-proto']) ?? 'http'}://${firstHeader(info.headers.host)}${path}` : path,\n        method: info.method.toUpperCase(),\n        ...(query ? { query_string: scrubQuery(query) } : {}),\n        headers: safeHeaders(info.headers),\n    };\n\n    return runWithRequest(client, request, () => {\n        const parent = parseTraceHeader(firstHeader(info.headers?.[TRACE_HEADER]));\n        const method = info.method.toUpperCase();\n        const name = (route?: string) => `${method} ${route ?? info.route ?? path}`;\n\n        const transaction = client.startTransaction({\n            name: name(),\n            op: 'http.server',\n            ...(parent ? { traceId: parent.traceId, parentSpanId: parent.spanId, sampled: parent.sampled } : {}),\n        });\n        client.activeTransaction = transaction;\n        client.scope.setTransactionName(transaction.name);\n\n        const finish = (statusCode: number, route?: string) => {\n            transaction.setName(name(route));\n            transaction.setData('http.status_code', statusCode);\n            // Magpie counts any status but \"ok\" as a failure, so only a server error is one. A 404 is a success.\n            if (statusCode >= 500) transaction.setStatus('internal_error');\n            transaction.end();\n        };\n\n        return fn({ transaction, finish });\n    });\n}\n\nfunction splitUrl(url: string): { path: string; query: string } {\n    let target = url;\n    try {\n        if (/^[a-z][a-z0-9+.-]*:/i.test(url)) {\n            const u = new URL(url);\n            target = `${u.pathname}${u.search}`;\n        }\n    } catch {\n        // Keep it as given.\n    }\n    const q = target.indexOf('?');\n\n    return q < 0 ? { path: target, query: '' } : { path: target.slice(0, q), query: target.slice(q + 1) };\n}\n\nfunction firstHeader(value: string | string[] | undefined): string | undefined {\n    return Array.isArray(value) ? value[0] : value;\n}\n\nfunction safeHeaders(headers: RequestInfo['headers']): Record<string, string> {\n    const out: Record<string, string> = {};\n    for (const name of SAFE_HEADERS) {\n        const value = firstHeader(headers?.[name]);\n        if (value) out[name] = value;\n    }\n\n    return out;\n}\n","import { Client, type Integration, type Options, setClient, getClient } from '@greenhat-services/magpie-core';\nimport { isolatePerRequest } from './context';\nimport { processHandlers } from './handlers';\nimport { nodeHttp } from './http';\nimport { defaultServerName, nodeRuntime } from './runtime';\n\nexport * from '@greenhat-services/magpie-core';\nexport { currentStore, isolatePerRequest, runWithRequest, storage } from './context';\nexport { processHandlers } from './handlers';\nexport { nodeHttp } from './http';\nexport { trackRequest, type RequestHandle, type RequestInfo } from './request';\nexport { nodeTransport } from './transport';\n\nexport interface NodeOptions extends Options {\n    /** Report uncaught exceptions and unhandled rejections. Default true. */\n    captureUnhandled?: boolean;\n    /** Time and propagate the server's own `fetch` calls. Default true. */\n    http?: boolean;\n    sdkName?: string;\n}\n\n/**\n * Starts Magpie on a server. Per-request data (scope, transaction, the request) is isolated with AsyncLocalStorage, so\n * use `trackRequest` around each request the framework handles.\n */\nexport function init(options: NodeOptions = {}): Client {\n    const previous = getClient();\n    if (previous) void previous.close(0);\n\n    const { captureUnhandled = true, http = true, sdkName, integrations = [], ...rest } = options;\n\n    const client = new Client(\n        { serverName: defaultServerName(), ...rest, release: rest.release ?? process.env.MAGPIE_RELEASE },\n        nodeRuntime({ sdkName }),\n    );\n\n    isolatePerRequest(client);\n    setClient(client);\n\n    const defaults: Integration[] = [...(captureUnhandled ? [processHandlers()] : []), ...(http ? [nodeHttp()] : [])];\n    client.setupIntegrations([...defaults, ...integrations]);\n\n    return client;\n}\n"]}

package/package.json

@@ -1,6 +1,46 @@
 {
-  "name": "@greenhat-services/magpie-node",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@greenhat-services/magpie-node",
+    "version": "0.1.0",
+    "description": "Magpie error tracking and performance monitoring for Node.js servers, including Nuxt's Nitro.",
+    "license": "MIT",
+    "type": "module",
+    "sideEffects": false,
+    "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"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "prepack": "npm run build"
+    },
+    "dependencies": {
+        "@greenhat-services/magpie-core": "^0.1.0"
+    },
+    "engines": {
+        "node": ">=20"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Greenhat-Services/magpie-js.git",
+        "directory": "packages/node"
+    },
+    "keywords": [
+        "magpie",
+        "error-tracking",
+        "monitoring",
+        "node",
+        "nitro"
+    ]
+}