nugi-ts-logs-sdk 1.0.0

package/dist/internal/breadcrumbs.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BreadcrumbBuffer = void 0;
+/**
+ * Fixed-capacity ring buffer of breadcrumbs. Oldest entries are dropped once
+ * capacity is reached. A snapshot is attached to error events so the trail that
+ * led to a failure travels with it.
+ */
+class BreadcrumbBuffer {
+    constructor(capacity) {
+        this.capacity = capacity;
+        this.items = [];
+    }
+    add(crumb) {
+        if (this.capacity <= 0)
+            return;
+        this.items.push(crumb);
+        if (this.items.length > this.capacity) {
+            this.items.splice(0, this.items.length - this.capacity);
+        }
+    }
+    /** Oldest-first snapshot suitable for attaching to an event. */
+    snapshot() {
+        return this.items.slice();
+    }
+    clear() {
+        this.items.length = 0;
+    }
+}
+exports.BreadcrumbBuffer = BreadcrumbBuffer;
+//# sourceMappingURL=breadcrumbs.js.map

package/dist/internal/breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../../src/internal/breadcrumbs.ts"],"names":[],"mappings":";;;AAmBA;;;;GAIG;AACH,MAAa,gBAAgB;IAG3B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAF5B,UAAK,GAAiB,EAAE,CAAC;IAEM,CAAC;IAEjD,GAAG,CAAC,KAAiB;QACnB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;YAAE,OAAO;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;CACF;AArBD,4CAqBC"}

package/dist/internal/console-capture.d.ts

@@ -0,0 +1,31 @@
+import { TelemetryEvent } from '../types';
+import { BreadcrumbBuffer } from './breadcrumbs';
+type ConsoleMethod = 'debug' | 'info' | 'log' | 'warn' | 'error';
+export interface ConsoleCaptureOptions {
+    /** Which console methods to intercept. */
+    levels: ConsoleMethod[];
+    /** Emit each console call as a shippable log event (so services report even
+     *  without HTTP traffic). When false, calls only become breadcrumbs. */
+    asLogs: boolean;
+}
+/**
+ * Monkey-patches the global console so a service's own log output is captured
+ * as first-class telemetry — no HTTP request required. Each call becomes a
+ * breadcrumb and (optionally) a log event. Original console behaviour is always
+ * preserved and restored on stop; capture is re-entrancy guarded so the SDK's
+ * own logging can never recurse.
+ */
+export declare class ConsoleCapture {
+    private readonly sink;
+    private readonly breadcrumbs;
+    private readonly options;
+    private originals;
+    private patched;
+    private inHandler;
+    constructor(sink: (event: TelemetryEvent) => void, breadcrumbs: BreadcrumbBuffer, options: ConsoleCaptureOptions);
+    start(): void;
+    stop(): void;
+    private handle;
+}
+export {};
+//# sourceMappingURL=console-capture.d.ts.map

package/dist/internal/console-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-capture.d.ts","sourceRoot":"","sources":["../../src/internal/console-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAUjE,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;4EACwE;IACxE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,SAAS,CAAoE;IACrF,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;gBAGP,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,EACrC,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,qBAAqB;IAGjD,KAAK,IAAI,IAAI;IAyBb,IAAI,IAAI,IAAI;IAUZ,OAAO,CAAC,MAAM;CA2Bf"}

package/dist/internal/console-capture.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleCapture = void 0;
+const context_1 = require("./context");
+const METHOD_LEVEL = {
+    debug: 'debug',
+    info: 'info',
+    log: 'info',
+    warn: 'warn',
+    error: 'error',
+};
+/**
+ * Monkey-patches the global console so a service's own log output is captured
+ * as first-class telemetry — no HTTP request required. Each call becomes a
+ * breadcrumb and (optionally) a log event. Original console behaviour is always
+ * preserved and restored on stop; capture is re-entrancy guarded so the SDK's
+ * own logging can never recurse.
+ */
+class ConsoleCapture {
+    constructor(sink, breadcrumbs, options) {
+        this.sink = sink;
+        this.breadcrumbs = breadcrumbs;
+        this.options = options;
+        this.originals = {};
+        this.patched = false;
+        this.inHandler = false;
+    }
+    start() {
+        if (this.patched || typeof console === 'undefined')
+            return;
+        this.patched = true;
+        for (const method of this.options.levels) {
+            const original = console[method];
+            if (typeof original !== 'function')
+                continue;
+            this.originals[method] = original.bind(console);
+            console[method] = (...args) => {
+                // Always call through first so app behaviour is unchanged even if we throw.
+                this.originals[method]?.(...args);
+                if (this.inHandler)
+                    return; // guard against recursion via SDK internals
+                this.inHandler = true;
+                try {
+                    this.handle(method, args);
+                }
+                catch {
+                    /* never let capture break the host */
+                }
+                finally {
+                    this.inHandler = false;
+                }
+            };
+        }
+    }
+    stop() {
+        if (!this.patched)
+            return;
+        for (const method of Object.keys(this.originals)) {
+            const original = this.originals[method];
+            if (original)
+                console[method] = original;
+        }
+        this.originals = {};
+        this.patched = false;
+    }
+    handle(method, args) {
+        const level = METHOD_LEVEL[method];
+        const message = formatArgs(args);
+        if (!message)
+            return;
+        const timestamp = new Date().toISOString();
+        this.breadcrumbs.add({ timestamp, type: 'console', level, message });
+        if (!this.options.asLogs)
+            return;
+        const span = (0, context_1.getActiveSpanContext)();
+        const attributes = { origin: 'auto.console.logging' };
+        // If an Error was logged (e.g. console.error(err)), keep its stack so the
+        // Errors view can render precise frames.
+        const err = args.find((a) => a instanceof Error);
+        if (err?.stack)
+            attributes.stack = err.stack;
+        const event = {
+            kind: 'log',
+            level,
+            message,
+            timestamp,
+            traceId: span?.traceId,
+            spanId: span?.spanId,
+            attributes,
+        };
+        this.sink(event);
+    }
+}
+exports.ConsoleCapture = ConsoleCapture;
+/** Best-effort console.* argument formatting into a single message string. */
+function formatArgs(args) {
+    return args
+        .map((a) => {
+        if (typeof a === 'string')
+            return a;
+        if (a instanceof Error)
+            return `${a.name}: ${a.message}`;
+        try {
+            return JSON.stringify(a);
+        }
+        catch {
+            return String(a);
+        }
+    })
+        .join(' ')
+        .slice(0, 8192);
+}
+//# sourceMappingURL=console-capture.js.map

package/dist/internal/console-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-capture.js","sourceRoot":"","sources":["../../src/internal/console-capture.ts"],"names":[],"mappings":"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"}

package/dist/internal/context.d.ts

@@ -0,0 +1,21 @@
+import { SpanContext } from './propagation';
+export interface ActiveContext {
+    span: SpanContext;
+}
+/** The trace/span active on the current async execution path, if any. */
+export declare function getActiveContext(): ActiveContext | undefined;
+export declare function getActiveSpanContext(): SpanContext | undefined;
+/** Run `fn` with `ctx` installed as the active context for its async subtree. */
+export declare function runWithContext<T>(ctx: ActiveContext, fn: () => T): T;
+/**
+ * Install `ctx` for the *current* async execution and everything downstream,
+ * without a wrapping callback. Needed by frameworks (e.g. Fastify) whose hooks
+ * run in sequence rather than nested, where `run()` can't span the handler.
+ */
+export declare function enterContext(ctx: ActiveContext): void;
+/**
+ * Bind `fn` to the *current* active context so it still sees it when invoked
+ * later (e.g. from an event emitter callback outside the async chain).
+ */
+export declare function bindContext<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R;
+//# sourceMappingURL=context.d.ts.map

package/dist/internal/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/internal/context.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;CACnB;AAID,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED,wBAAgB,oBAAoB,IAAI,WAAW,GAAG,SAAS,CAE9D;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAChD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GACpB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAInB"}

package/dist/internal/context.js

@@ -0,0 +1,42 @@
+"use strict";
+// Ambient trace context propagation using AsyncLocalStorage so that logs,
+// metrics and child spans automatically inherit the active trace/span without
+// the caller threading it manually.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveContext = getActiveContext;
+exports.getActiveSpanContext = getActiveSpanContext;
+exports.runWithContext = runWithContext;
+exports.enterContext = enterContext;
+exports.bindContext = bindContext;
+const async_hooks_1 = require("async_hooks");
+const storage = new async_hooks_1.AsyncLocalStorage();
+/** The trace/span active on the current async execution path, if any. */
+function getActiveContext() {
+    return storage.getStore();
+}
+function getActiveSpanContext() {
+    return storage.getStore()?.span;
+}
+/** Run `fn` with `ctx` installed as the active context for its async subtree. */
+function runWithContext(ctx, fn) {
+    return storage.run(ctx, fn);
+}
+/**
+ * Install `ctx` for the *current* async execution and everything downstream,
+ * without a wrapping callback. Needed by frameworks (e.g. Fastify) whose hooks
+ * run in sequence rather than nested, where `run()` can't span the handler.
+ */
+function enterContext(ctx) {
+    storage.enterWith(ctx);
+}
+/**
+ * Bind `fn` to the *current* active context so it still sees it when invoked
+ * later (e.g. from an event emitter callback outside the async chain).
+ */
+function bindContext(fn) {
+    const captured = storage.getStore();
+    if (!captured)
+        return fn;
+    return (...args) => storage.run(captured, () => fn(...args));
+}
+//# sourceMappingURL=context.js.map

package/dist/internal/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/internal/context.ts"],"names":[],"mappings":";AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,oCAAoC;;AAYpC,4CAEC;AAED,oDAEC;AAGD,wCAEC;AAOD,oCAEC;AAMD,kCAMC;AA1CD,6CAAgD;AAOhD,MAAM,OAAO,GAAG,IAAI,+BAAiB,EAAiB,CAAC;AAEvD,yEAAyE;AACzE,SAAgB,gBAAgB;IAC9B,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,SAAgB,oBAAoB;IAClC,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC;AAClC,CAAC;AAED,iFAAiF;AACjF,SAAgB,cAAc,CAAI,GAAkB,EAAE,EAAW;IAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,GAAkB;IAC7C,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CACzB,EAAqB;IAErB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,OAAO,CAAC,GAAG,IAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/internal/diagnostics.d.ts

@@ -0,0 +1,9 @@
+export interface Diagnostics {
+    debug(message: string, detail?: unknown): void;
+    error(message: string, error?: unknown): void;
+}
+export declare function createDiagnostics(opts: {
+    debug: boolean;
+    onError?: (error: Error) => void;
+}): Diagnostics;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/internal/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/internal/diagnostics.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,GAAG,WAAW,CAuBd"}

package/dist/internal/diagnostics.js

@@ -0,0 +1,43 @@
+"use strict";
+// Internal diagnostics channel. The SDK must never crash the host, so internal
+// failures are routed here (optional user callback + optional debug console)
+// instead of being thrown.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDiagnostics = createDiagnostics;
+function createDiagnostics(opts) {
+    const prefix = '[nugi-ts-logs-sdk]';
+    return {
+        debug(message, detail) {
+            if (opts.debug) {
+                // eslint-disable-next-line no-console
+                console.debug(`${prefix} ${message}`, detail ?? '');
+            }
+        },
+        error(message, error) {
+            const err = error instanceof Error ? error : new Error(describe(message, error));
+            if (opts.debug) {
+                // eslint-disable-next-line no-console
+                console.error(`${prefix} ${message}`, error ?? '');
+            }
+            try {
+                opts.onError?.(err);
+            }
+            catch {
+                /* never let the error handler itself throw */
+            }
+        },
+    };
+}
+function describe(message, error) {
+    if (error === undefined)
+        return message;
+    if (typeof error === 'string')
+        return `${message}: ${error}`;
+    try {
+        return `${message}: ${JSON.stringify(error)}`;
+    }
+    catch {
+        return message;
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/internal/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/internal/diagnostics.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,2BAA2B;;AAO3B,8CA0BC;AA1BD,SAAgB,iBAAiB,CAAC,IAGjC;IACC,MAAM,MAAM,GAAG,oBAAoB,CAAC;IACpC,OAAO;QACL,KAAK,CAAC,OAAO,EAAE,MAAM;YACnB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,KAAK;YAClB,MAAM,GAAG,GACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACvE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,KAAc;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,OAAO,KAAK,KAAK,EAAE,CAAC;IAC7D,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/internal/http-utils.d.ts

@@ -0,0 +1,16 @@
+/** Best-effort payload size in bytes from a content-length header or the body. */
+export declare function byteLength(contentLength: unknown, body: unknown): number;
+/** Extract an authenticated principal id from a request, if the app set one. */
+export declare function extractUserId(req: unknown): string | undefined;
+/** Lower-cases header keys into a plain record; tolerant of odd inputs. */
+export declare function normalizeHeaders(headers: unknown): Record<string, unknown>;
+/**
+ * Resolve the real client IP from the request. Handles:
+ * - x-forwarded-for (first entry = real client behind proxy/LB)
+ * - IPv4-mapped IPv6 (::ffff:192.168.1.1 → 192.168.1.1)
+ * - Falls back to req.ip / socket.remoteAddress
+ */
+export declare function resolveClientIp(req: unknown): string;
+/** Strip IPv4-mapped IPv6 prefix and trim. */
+export declare function normalizeIp(ip: string): string;
+//# sourceMappingURL=http-utils.d.ts.map

package/dist/internal/http-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-utils.d.ts","sourceRoot":"","sources":["../../src/internal/http-utils.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAaxE;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAU9D;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAcpD;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ9C"}

package/dist/internal/http-utils.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.byteLength = byteLength;
+exports.extractUserId = extractUserId;
+exports.normalizeHeaders = normalizeHeaders;
+exports.resolveClientIp = resolveClientIp;
+exports.normalizeIp = normalizeIp;
+/** Best-effort payload size in bytes from a content-length header or the body. */
+function byteLength(contentLength, body) {
+    const declared = Number(Array.isArray(contentLength) ? contentLength[0] : contentLength);
+    if (Number.isFinite(declared) && declared >= 0)
+        return declared;
+    try {
+        if (body === undefined || body === null)
+            return 0;
+        if (typeof body === 'string')
+            return Buffer.byteLength(body);
+        if (Buffer.isBuffer(body))
+            return body.length;
+        return Buffer.byteLength(JSON.stringify(body) ?? '');
+    }
+    catch {
+        return 0;
+    }
+}
+/** Extract an authenticated principal id from a request, if the app set one. */
+function extractUserId(req) {
+    try {
+        const user = req?.user;
+        if (!user)
+            return undefined;
+        const id = user.id ?? user._id ?? user.sub ?? user.userId ?? user.uid;
+        return id !== undefined && id !== null ? String(id) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Lower-cases header keys into a plain record; tolerant of odd inputs. */
+function normalizeHeaders(headers) {
+    if (!headers || typeof headers !== 'object')
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        out[k.toLowerCase()] = v;
+    }
+    return out;
+}
+/**
+ * Resolve the real client IP from the request. Handles:
+ * - x-forwarded-for (first entry = real client behind proxy/LB)
+ * - IPv4-mapped IPv6 (::ffff:192.168.1.1 → 192.168.1.1)
+ * - Falls back to req.ip / socket.remoteAddress
+ */
+function resolveClientIp(req) {
+    try {
+        const r = (req || {});
+        const headers = r.headers || {};
+        const forwarded = headers['x-forwarded-for'] ?? headers['X-Forwarded-For'];
+        const raw = (typeof forwarded === 'string' ? forwarded.split(',')[0]?.trim() : undefined) ||
+            r.ip ||
+            r.socket?.remoteAddress ||
+            '';
+        return normalizeIp(raw);
+    }
+    catch {
+        return (req?.ip) || '';
+    }
+}
+/** Strip IPv4-mapped IPv6 prefix and trim. */
+function normalizeIp(ip) {
+    if (!ip)
+        return ip;
+    const trimmed = ip.trim();
+    const prefix = '::ffff:';
+    if (trimmed.toLowerCase().startsWith(prefix)) {
+        return trimmed.slice(prefix.length);
+    }
+    return trimmed;
+}
+//# sourceMappingURL=http-utils.js.map

package/dist/internal/http-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-utils.js","sourceRoot":"","sources":["../../src/internal/http-utils.ts"],"names":[],"mappings":";;AACA,gCAaC;AAGD,sCAUC;AAGD,4CASC;AAQD,0CAcC;AAGD,kCAQC;AAxED,kFAAkF;AAClF,SAAgB,UAAU,CAAC,aAAsB,EAAE,IAAa;IAC9D,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAChE,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QAClD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QAC9C,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,SAAgB,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAI,GAA0C,EAAE,IAAI,CAAC;QAC/D,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,MAAM,EAAE,GACN,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC;QAC7D,OAAO,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,SAAgB,gBAAgB,CAC9B,OAAgB;IAEhB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,GAAY;IAC1C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAwB,CAAC;QAC7C,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC3E,MAAM,GAAG,GACP,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM,EAAE,aAAa;YACvB,EAAE,CAAC;QACL,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAE,GAAuB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,8CAA8C;AAC9C,SAAgB,WAAW,CAAC,EAAU;IACpC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/internal/ids.d.ts

@@ -0,0 +1,9 @@
+/** 16-byte (32 hex char) W3C trace id. */
+export declare function generateTraceId(): string;
+/** 8-byte (16 hex char) W3C span id. */
+export declare function generateSpanId(): string;
+/** General-purpose unique id (request ids, batch ids). */
+export declare function generateId(): string;
+export declare function isValidTraceId(id: string | undefined): id is string;
+export declare function isValidSpanId(id: string | undefined): id is string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/internal/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/internal/ids.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wCAAwC;AACxC,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAKD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,EAAE,IAAI,MAAM,CAEnE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,EAAE,IAAI,MAAM,CAElE"}

package/dist/internal/ids.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTraceId = generateTraceId;
+exports.generateSpanId = generateSpanId;
+exports.generateId = generateId;
+exports.isValidTraceId = isValidTraceId;
+exports.isValidSpanId = isValidSpanId;
+const crypto_1 = require("crypto");
+/** 16-byte (32 hex char) W3C trace id. */
+function generateTraceId() {
+    return (0, crypto_1.randomBytes)(16).toString('hex');
+}
+/** 8-byte (16 hex char) W3C span id. */
+function generateSpanId() {
+    return (0, crypto_1.randomBytes)(8).toString('hex');
+}
+/** General-purpose unique id (request ids, batch ids). */
+function generateId() {
+    try {
+        return (0, crypto_1.randomUUID)();
+    }
+    catch {
+        return (0, crypto_1.randomBytes)(16).toString('hex');
+    }
+}
+const INVALID_TRACE_ID = '0'.repeat(32);
+const INVALID_SPAN_ID = '0'.repeat(16);
+function isValidTraceId(id) {
+    return !!id && /^[0-9a-f]{32}$/i.test(id) && id !== INVALID_TRACE_ID;
+}
+function isValidSpanId(id) {
+    return !!id && /^[0-9a-f]{16}$/i.test(id) && id !== INVALID_SPAN_ID;
+}
+//# sourceMappingURL=ids.js.map

package/dist/internal/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/internal/ids.ts"],"names":[],"mappings":";;AAGA,0CAEC;AAGD,wCAEC;AAGD,gCAMC;AAKD,wCAEC;AAED,sCAEC;AA9BD,mCAAiD;AAEjD,0CAA0C;AAC1C,SAAgB,eAAe;IAC7B,OAAO,IAAA,oBAAW,EAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,wCAAwC;AACxC,SAAgB,cAAc;IAC5B,OAAO,IAAA,oBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,0DAA0D;AAC1D,SAAgB,UAAU;IACxB,IAAI,CAAC;QACH,OAAO,IAAA,mBAAU,GAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAA,oBAAW,EAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACxC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEvC,SAAgB,cAAc,CAAC,EAAsB;IACnD,OAAO,CAAC,CAAC,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,gBAAgB,CAAC;AACvE,CAAC;AAED,SAAgB,aAAa,CAAC,EAAsB;IAClD,OAAO,CAAC,CAAC,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,eAAe,CAAC;AACtE,CAAC"}

package/dist/internal/metadata.d.ts

@@ -0,0 +1,4 @@
+import { HostMetadata, RuntimeMetadata } from '../types';
+export declare function getHostMetadata(): HostMetadata;
+export declare function getRuntimeMetadata(): RuntimeMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/internal/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/internal/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAiDzD,wBAAgB,eAAe,IAAI,YAAY,CAyB9C;AAKD,wBAAgB,kBAAkB,IAAI,eAAe,CA6BpD"}

package/dist/internal/metadata.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHostMetadata = getHostMetadata;
+exports.getRuntimeMetadata = getRuntimeMetadata;
+const os = __importStar(require("os"));
+// Host metadata is static for the process lifetime — computed once and cached.
+// Runtime metadata (memory/CPU) is sampled per call. All collection is
+// defensive: it must never throw into the host application.
+function resolveSdkVersion() {
+    try {
+        // package.json sits at the package root, one level above dist/ (and src/).
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require('../../package.json').version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function resolveServerIps() {
+    const ipv4 = [];
+    const ipv6 = [];
+    try {
+        const interfaces = os.networkInterfaces();
+        for (const name of Object.keys(interfaces)) {
+            for (const iface of interfaces[name] || []) {
+                if (iface.internal)
+                    continue;
+                const family = String(iface.family);
+                if (family === 'IPv4' || family === '4') {
+                    ipv4.push(iface.address);
+                }
+                else if (family === 'IPv6' || family === '6') {
+                    if (!iface.address.startsWith('fe80')) {
+                        ipv6.push(iface.address);
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    const primary = ipv4[0] || ipv6[0] || '127.0.0.1';
+    return { primary, ipv4, ipv6 };
+}
+let cachedHost;
+function getHostMetadata() {
+    if (cachedHost)
+        return cachedHost;
+    try {
+        const ips = resolveServerIps();
+        cachedHost = {
+            hostname: os.hostname(),
+            serverIp: ips.primary,
+            serverIps: { ipv4: ips.ipv4, ipv6: ips.ipv6 },
+            sdkVersion: resolveSdkVersion(),
+            nodeVersion: process.version,
+            os: `${os.type()} ${os.release()} (${os.platform()}/${os.arch()})`,
+            pid: process.pid,
+        };
+    }
+    catch {
+        cachedHost = {
+            hostname: 'unknown',
+            serverIp: '127.0.0.1',
+            serverIps: { ipv4: [], ipv6: [] },
+            sdkVersion: resolveSdkVersion(),
+            nodeVersion: process.version,
+            os: 'unknown',
+            pid: process.pid,
+        };
+    }
+    return cachedHost;
+}
+let lastCpuUsage;
+let lastCpuSampleAt;
+function getRuntimeMetadata() {
+    const memoryUsage = safeMemoryUsage();
+    let percent = -1;
+    let user = 0;
+    let system = 0;
+    try {
+        const now = Date.now();
+        const current = process.cpuUsage();
+        user = current.user;
+        system = current.system;
+        if (lastCpuUsage && lastCpuSampleAt !== undefined) {
+            const elapsedMs = now - lastCpuSampleAt;
+            if (elapsedMs > 0) {
+                const usedMicros = current.user - lastCpuUsage.user +
+                    (current.system - lastCpuUsage.system);
+                percent =
+                    Math.round((usedMicros / (elapsedMs * 1000)) * 100 * 100) / 100;
+            }
+        }
+        lastCpuUsage = current;
+        lastCpuSampleAt = now;
+    }
+    catch {
+        /* leave defaults */
+    }
+    return { memoryUsage, cpuUsage: { percent, user, system } };
+}
+function safeMemoryUsage() {
+    try {
+        const m = process.memoryUsage();
+        return {
+            rss: m.rss,
+            heapUsed: m.heapUsed,
+            heapTotal: m.heapTotal,
+            external: m.external,
+        };
+    }
+    catch {
+        return { rss: 0, heapUsed: 0, heapTotal: 0, external: 0 };
+    }
+}
+//# sourceMappingURL=metadata.js.map