nugi-ts-logs-sdk 1.0.0

package/dist/signals/logger.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const context_1 = require("../internal/context");
+/**
+ * Structured logger. Every record is automatically correlated with the active
+ * trace/span (via AsyncLocalStorage) so logs join up with request spans. Each
+ * record is also recorded as a breadcrumb (when a buffer is provided) so it can
+ * travel with any subsequent error.
+ */
+class Logger {
+    constructor(sink, boundAttributes = {}, breadcrumbs) {
+        this.sink = sink;
+        this.boundAttributes = boundAttributes;
+        this.breadcrumbs = breadcrumbs;
+    }
+    /** Create a child logger with additional default attributes merged in. */
+    child(attributes) {
+        return new Logger(this.sink, { ...this.boundAttributes, ...attributes }, this.breadcrumbs);
+    }
+    debug(message, attributes) {
+        this.write('debug', message, attributes);
+    }
+    info(message, attributes) {
+        this.write('info', message, attributes);
+    }
+    warn(message, attributes) {
+        this.write('warn', message, attributes);
+    }
+    error(message, attributes) {
+        this.write('error', message, attributes);
+    }
+    fatal(message, attributes) {
+        this.write('fatal', message, attributes);
+    }
+    log(level, message, attributes) {
+        this.write(level, message, attributes);
+    }
+    write(level, message, attributes) {
+        const span = (0, context_1.getActiveSpanContext)();
+        const timestamp = new Date().toISOString();
+        const merged = this.mergeAttributes(attributes);
+        const event = {
+            kind: 'log',
+            level,
+            message: String(message),
+            timestamp,
+            traceId: span?.traceId,
+            spanId: span?.spanId,
+            attributes: merged,
+        };
+        this.breadcrumbs?.add({ timestamp, type: 'log', level, message: String(message), data: merged });
+        this.sink(event);
+    }
+    mergeAttributes(attributes) {
+        if (!attributes && Object.keys(this.boundAttributes).length === 0) {
+            return undefined;
+        }
+        return { ...this.boundAttributes, ...(attributes || {}) };
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/signals/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/signals/logger.ts"],"names":[],"mappings":";;;AACA,iDAA2D;AAK3D;;;;;GAKG;AACH,MAAa,MAAM;IACjB,YACmB,IAAe,EACf,kBAA8B,EAAE,EAChC,WAA8B;QAF9B,SAAI,GAAJ,IAAI,CAAW;QACf,oBAAe,GAAf,eAAe,CAAiB;QAChC,gBAAW,GAAX,WAAW,CAAmB;IAC9C,CAAC;IAEJ,0EAA0E;IAC1E,KAAK,CAAC,UAAsB;QAC1B,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,UAAU,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,UAAuB;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,UAAuB;QAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,UAAuB;QAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,UAAuB;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,UAAuB;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,UAAuB;QAC3D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CACX,KAAe,EACf,OAAe,EACf,UAAuB;QAEvB,MAAM,IAAI,GAAG,IAAA,8BAAoB,GAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,KAAK,GAAa;YACtB,IAAI,EAAE,KAAK;YACX,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;YACxB,SAAS;YACT,OAAO,EAAE,IAAI,EAAE,OAAO;YACtB,MAAM,EAAE,IAAI,EAAE,MAAM;YACpB,UAAU,EAAE,MAAM;SACnB,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAEO,eAAe,CAAC,UAAuB;QAC7C,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;CACF;AA3DD,wBA2DC"}

package/dist/signals/metrics.d.ts

@@ -0,0 +1,58 @@
+import { Attributes, MetricType } from '../types';
+import { BeforeSendMetric, MetricAttributeValue } from '../config';
+import { EventSink } from './logger';
+export interface MetricsOptions {
+    beforeSendMetric?: BeforeSendMetric;
+    maxAttributesBytes?: number;
+    /** Global attributes applied to every metric. */
+    initialAttributes?: Record<string, MetricAttributeValue>;
+}
+/**
+ * Metrics facade producing counter / gauge / histogram measurements. Each
+ * measurement is emitted as a discrete MetricEvent (the backend aggregates),
+ * correlated with the active trace when one exists (exemplars).
+ *
+ * Compatible aliases: `count` → counter, `distribution` → histogram.
+ */
+export declare class Metrics {
+    private readonly sink;
+    private globalAttributes;
+    private readonly beforeSend?;
+    private readonly maxAttributesBytes;
+    constructor(sink: EventSink, options?: MetricsOptions);
+    /** Global attributes applied to every metric. */
+    setAttributes(attrs: Record<string, MetricAttributeValue>): void;
+    clearAttributes(): void;
+    getAttributes(): Record<string, MetricAttributeValue>;
+    /**
+     * Run `fn` with a nested attribute scope. Attributes set via
+     * `setScopeAttributes` inside the callback apply only for that scope.
+     */
+    withScope<T>(attrs: Record<string, MetricAttributeValue>, fn: () => T): T;
+    /** Monotonic counter. `add` defaults to +1. */
+    counter(name: string, unit?: string): {
+        add(value?: number, attributes?: Attributes): void;
+    };
+    /** Nest-SDK-compatible alias for `counter`. */
+    count(name: string, value?: number, options?: {
+        unit?: string;
+        attributes?: Attributes;
+    }): void;
+    /** Last-value gauge. */
+    gauge(name: string, unit?: string): {
+        set(value: number, attributes?: Attributes): void;
+    };
+    /** Distribution of recorded values (durations, sizes). */
+    histogram(name: string, unit?: string): {
+        record(value: number, attributes?: Attributes): void;
+    };
+    /** Nest-SDK-compatible alias for `histogram`. */
+    distribution(name: string, value: number, options?: {
+        unit?: string;
+        attributes?: Attributes;
+    }): void;
+    /** One-shot measurement without holding an instrument reference. */
+    record(name: string, type: MetricType, value: number, attributes?: Attributes, unit?: string): void;
+    private instrument;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/signals/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/signals/metrics.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EAEV,UAAU,EACX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EAErB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAYrC,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,qBAAa,OAAO;IAMhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,gBAAgB,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;gBAGzB,IAAI,EAAE,SAAS,EAChC,OAAO,GAAE,cAAmB;IAS9B,iDAAiD;IACjD,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAOhE,eAAe,IAAI,IAAI;IAIvB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAIrD;;;OAGG;IACH,SAAS,CAAC,CAAC,EACT,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAC3C,EAAE,EAAE,MAAM,CAAC,GACV,CAAC;IAWJ,+CAA+C;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE;IAQ5F,+CAA+C;IAC/C,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,EACT,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,GACnD,IAAI;IAIP,wBAAwB;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE;IAQzF,0DAA0D;IAC1D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE;IAQhG,iDAAiD;IACjD,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,GACnD,IAAI;IAIP,oEAAoE;IACpE,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,UAAU,EACvB,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI;IAIP,OAAO,CAAC,UAAU;CA2CnB"}

package/dist/signals/metrics.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Metrics = void 0;
+const async_hooks_1 = require("async_hooks");
+const context_1 = require("../internal/context");
+const scopeAls = new async_hooks_1.AsyncLocalStorage();
+/**
+ * Metrics facade producing counter / gauge / histogram measurements. Each
+ * measurement is emitted as a discrete MetricEvent (the backend aggregates),
+ * correlated with the active trace when one exists (exemplars).
+ *
+ * Compatible aliases: `count` → counter, `distribution` → histogram.
+ */
+class Metrics {
+    constructor(sink, options = {}) {
+        this.sink = sink;
+        this.globalAttributes = {};
+        this.beforeSend = options.beforeSendMetric;
+        this.maxAttributesBytes = options.maxAttributesBytes ?? 2048;
+        if (options.initialAttributes) {
+            this.globalAttributes = sanitizeAttrs(options.initialAttributes);
+        }
+    }
+    /** Global attributes applied to every metric. */
+    setAttributes(attrs) {
+        this.globalAttributes = {
+            ...this.globalAttributes,
+            ...sanitizeAttrs(attrs),
+        };
+    }
+    clearAttributes() {
+        this.globalAttributes = {};
+    }
+    getAttributes() {
+        return { ...this.globalAttributes, ...currentScopeAttributes() };
+    }
+    /**
+     * Run `fn` with a nested attribute scope. Attributes set via
+     * `setScopeAttributes` inside the callback apply only for that scope.
+     */
+    withScope(attrs, fn) {
+        const parent = scopeAls.getStore();
+        const next = {
+            attributes: {
+                ...(parent?.attributes || {}),
+                ...sanitizeAttrs(attrs),
+            },
+        };
+        return scopeAls.run(next, fn);
+    }
+    /** Monotonic counter. `add` defaults to +1. */
+    counter(name, unit) {
+        const instrument = this.instrument(name, 'counter', unit);
+        return {
+            add: (value = 1, attributes) => instrument.record(value, attributes),
+        };
+    }
+    /** Nest-SDK-compatible alias for `counter`. */
+    count(name, value = 1, options) {
+        this.counter(name, options?.unit).add(value, options?.attributes);
+    }
+    /** Last-value gauge. */
+    gauge(name, unit) {
+        const instrument = this.instrument(name, 'gauge', unit);
+        return {
+            set: (value, attributes) => instrument.record(value, attributes),
+        };
+    }
+    /** Distribution of recorded values (durations, sizes). */
+    histogram(name, unit) {
+        const instrument = this.instrument(name, 'histogram', unit);
+        return {
+            record: (value, attributes) => instrument.record(value, attributes),
+        };
+    }
+    /** Nest-SDK-compatible alias for `histogram`. */
+    distribution(name, value, options) {
+        this.histogram(name, options?.unit).record(value, options?.attributes);
+    }
+    /** One-shot measurement without holding an instrument reference. */
+    record(name, type, value, attributes, unit) {
+        this.instrument(name, type, unit).record(value, attributes);
+    }
+    instrument(name, type, unit) {
+        return {
+            record: (value, attributes) => {
+                if (typeof value !== 'number' || Number.isNaN(value))
+                    return;
+                const span = (0, context_1.getActiveSpanContext)();
+                const merged = truncateAttrs({
+                    ...this.getAttributes(),
+                    ...sanitizeAttrs(attributes),
+                }, this.maxAttributesBytes);
+                let payload = {
+                    name,
+                    type: type === 'histogram' ? 'histogram' : type,
+                    value,
+                    unit,
+                    attributes: merged,
+                    timestamp: new Date().toISOString(),
+                };
+                if (this.beforeSend) {
+                    try {
+                        payload = this.beforeSend(payload);
+                    }
+                    catch {
+                        return;
+                    }
+                    if (!payload)
+                        return;
+                }
+                const event = {
+                    kind: 'metric',
+                    name: payload.name,
+                    type: (payload.type === 'distribution' ? 'histogram' : payload.type),
+                    value: payload.value,
+                    unit: payload.unit,
+                    timestamp: payload.timestamp,
+                    traceId: span?.traceId,
+                    spanId: span?.spanId,
+                    attributes: payload.attributes,
+                };
+                this.sink(event);
+            },
+        };
+    }
+}
+exports.Metrics = Metrics;
+function currentScopeAttributes() {
+    return scopeAls.getStore()?.attributes || {};
+}
+function sanitizeAttrs(attrs) {
+    if (!attrs)
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(attrs)) {
+        if (typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean') {
+            out[k] = v;
+        }
+        else if (v != null) {
+            out[k] = String(v);
+        }
+    }
+    return out;
+}
+function truncateAttrs(attrs, maxBytes) {
+    try {
+        const json = JSON.stringify(attrs);
+        if (json.length <= maxBytes)
+            return attrs;
+        const out = {};
+        let size = 2;
+        for (const [k, v] of Object.entries(attrs)) {
+            const piece = JSON.stringify({ [k]: v });
+            if (size + piece.length > maxBytes)
+                break;
+            out[k] = v;
+            size += piece.length;
+        }
+        return out;
+    }
+    catch {
+        return attrs;
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/signals/metrics.js.map

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

package/dist/signals/tracer.d.ts

@@ -0,0 +1,77 @@
+import { Attributes, RuntimeMetadata, SpanKind, SpanStatus } from '../types';
+import { SpanContext } from '../internal/propagation';
+import { EventSink } from './logger';
+export interface StartSpanOptions {
+    kind?: SpanKind;
+    attributes?: Attributes;
+    /** Explicit parent; defaults to the active span, then a new root. */
+    parent?: SpanContext | null;
+    startTime?: Date;
+}
+export interface EndSpanOptions {
+    status?: SpanStatus;
+    statusMessage?: string;
+    endTime?: Date;
+}
+/** A single unit of work in a trace. Cheap no-op when its trace is not sampled. */
+export declare class Span {
+    private readonly name;
+    private readonly ctx;
+    private readonly kind;
+    private readonly startTime;
+    private readonly sink;
+    private readonly runtimeProvider?;
+    private ended;
+    private status;
+    private statusMessage?;
+    private readonly attributes;
+    private readonly events;
+    private readonly startMs;
+    constructor(name: string, ctx: SpanContext, kind: SpanKind, startTime: Date, sink: EventSink, runtimeProvider?: (() => RuntimeMetadata) | undefined, attributes?: Attributes);
+    context(): SpanContext;
+    get traceId(): string;
+    get spanId(): string;
+    get isSampled(): boolean;
+    setAttribute(key: string, value: unknown): this;
+    setAttributes(attributes: Attributes): this;
+    addEvent(name: string, attributes?: Attributes): this;
+    setStatus(status: SpanStatus, message?: string): this;
+    /** Record an exception on the span and mark it errored. */
+    recordException(error: unknown): this;
+    /** Inject this span's context into an outbound header carrier. */
+    inject(carrier: Record<string, string>): Record<string, string>;
+    end(options?: EndSpanOptions): void;
+}
+export declare class Tracer {
+    private readonly sink;
+    private readonly sampleRate;
+    private readonly runtimeProvider?;
+    constructor(sink: EventSink, sampleRate: number, runtimeProvider?: (() => RuntimeMetadata) | undefined);
+    /**
+     * Start a span. Parent resolution order: explicit `options.parent`, then the
+     * active span (AsyncLocalStorage), then a new sampled-or-not root.
+     */
+    startSpan(name: string, options?: StartSpanOptions): Span;
+    /**
+     * Start a span, install it as the active context, run `fn`, and end the span
+     * automatically — handling both sync throws and rejected promises.
+     */
+    startActiveSpan<T>(name: string, options: StartSpanOptions, fn: (span: Span) => T): T;
+    /** The active span context on this async path, if any. */
+    activeContext(): SpanContext | undefined;
+    /**
+     * Emit a finished span without an active start/end lifecycle.
+     * Used by DB query capture and similar post-hoc timings.
+     */
+    recordFinished(name: string, durationMs: number, options?: {
+        kind?: SpanKind;
+        attributes?: Attributes;
+        status?: SpanStatus;
+        statusMessage?: string;
+        startTime?: Date;
+        endTime?: Date;
+        parent?: SpanContext | null;
+    }): void;
+    private deriveContext;
+}
+//# sourceMappingURL=tracer.d.ts.map

package/dist/signals/tracer.d.ts.map

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

package/dist/signals/tracer.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracer = exports.Span = void 0;
+const propagation_1 = require("../internal/propagation");
+const ids_1 = require("../internal/ids");
+const context_1 = require("../internal/context");
+/** A single unit of work in a trace. Cheap no-op when its trace is not sampled. */
+class Span {
+    constructor(name, ctx, kind, startTime, sink, runtimeProvider, attributes) {
+        this.name = name;
+        this.ctx = ctx;
+        this.kind = kind;
+        this.startTime = startTime;
+        this.sink = sink;
+        this.runtimeProvider = runtimeProvider;
+        this.ended = false;
+        this.status = 'unset';
+        this.events = [];
+        this.attributes = { ...(attributes || {}) };
+        this.startMs = Date.now();
+    }
+    context() {
+        return this.ctx;
+    }
+    get traceId() {
+        return this.ctx.traceId;
+    }
+    get spanId() {
+        return this.ctx.spanId;
+    }
+    get isSampled() {
+        return this.ctx.sampled;
+    }
+    setAttribute(key, value) {
+        this.attributes[key] = value;
+        return this;
+    }
+    setAttributes(attributes) {
+        Object.assign(this.attributes, attributes);
+        return this;
+    }
+    addEvent(name, attributes) {
+        this.events.push({
+            name,
+            timestamp: new Date().toISOString(),
+            attributes,
+        });
+        return this;
+    }
+    setStatus(status, message) {
+        this.status = status;
+        this.statusMessage = message;
+        return this;
+    }
+    /** Record an exception on the span and mark it errored. */
+    recordException(error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        this.addEvent('exception', {
+            'exception.type': err.name,
+            'exception.message': err.message,
+            'exception.stacktrace': err.stack,
+        });
+        return this.setStatus('error', err.message);
+    }
+    /** Inject this span's context into an outbound header carrier. */
+    inject(carrier) {
+        return (0, propagation_1.injectContext)(this.ctx, carrier);
+    }
+    end(options = {}) {
+        if (this.ended)
+            return;
+        this.ended = true;
+        if (options.status)
+            this.status = options.status;
+        if (options.statusMessage)
+            this.statusMessage = options.statusMessage;
+        if (!this.ctx.sampled)
+            return; // dropped by sampling — emit nothing
+        const endTime = options.endTime ?? new Date();
+        const durationMs = Math.max(0, Date.now() - this.startMs);
+        const event = {
+            kind: 'span',
+            traceId: this.ctx.traceId,
+            spanId: this.ctx.spanId,
+            parentSpanId: this.ctx.parentSpanId,
+            name: this.name,
+            spanKind: this.kind,
+            startTime: this.startTime.toISOString(),
+            endTime: endTime.toISOString(),
+            durationMs,
+            status: this.status,
+            statusMessage: this.statusMessage,
+            timestamp: this.startTime.toISOString(),
+            attributes: Object.keys(this.attributes).length > 0 ? this.attributes : undefined,
+            events: this.events.length > 0 ? this.events : undefined,
+            runtime: this.runtimeProvider?.(),
+        };
+        this.sink(event);
+    }
+}
+exports.Span = Span;
+class Tracer {
+    constructor(sink, sampleRate, runtimeProvider) {
+        this.sink = sink;
+        this.sampleRate = sampleRate;
+        this.runtimeProvider = runtimeProvider;
+    }
+    /**
+     * Start a span. Parent resolution order: explicit `options.parent`, then the
+     * active span (AsyncLocalStorage), then a new sampled-or-not root.
+     */
+    startSpan(name, options = {}) {
+        const parent = options.parent !== undefined
+            ? options.parent
+            : (0, context_1.getActiveSpanContext)();
+        const ctx = this.deriveContext(parent);
+        return new Span(name, ctx, options.kind || 'internal', options.startTime ?? new Date(), this.sink, this.runtimeProvider, options.attributes);
+    }
+    /**
+     * Start a span, install it as the active context, run `fn`, and end the span
+     * automatically — handling both sync throws and rejected promises.
+     */
+    startActiveSpan(name, options, fn) {
+        const span = this.startSpan(name, options);
+        return (0, context_1.runWithContext)({ span: span.context() }, () => {
+            try {
+                const result = fn(span);
+                if (isPromise(result)) {
+                    return result.then((value) => {
+                        span.end();
+                        return value;
+                    }, (error) => {
+                        span.recordException(error);
+                        span.end({ status: 'error' });
+                        throw error;
+                    });
+                }
+                span.end();
+                return result;
+            }
+            catch (error) {
+                span.recordException(error);
+                span.end({ status: 'error' });
+                throw error;
+            }
+        });
+    }
+    /** The active span context on this async path, if any. */
+    activeContext() {
+        return (0, context_1.getActiveSpanContext)();
+    }
+    /**
+     * Emit a finished span without an active start/end lifecycle.
+     * Used by DB query capture and similar post-hoc timings.
+     */
+    recordFinished(name, durationMs, options = {}) {
+        try {
+            const endTime = options.endTime ?? new Date();
+            const startTime = options.startTime ??
+                new Date(endTime.getTime() - Math.max(0, durationMs));
+            const parent = options.parent !== undefined
+                ? options.parent
+                : (0, context_1.getActiveSpanContext)();
+            const ctx = this.deriveContext(parent);
+            if (!ctx.sampled)
+                return;
+            const event = {
+                kind: 'span',
+                traceId: ctx.traceId,
+                spanId: ctx.spanId,
+                parentSpanId: ctx.parentSpanId,
+                name,
+                spanKind: options.kind || 'client',
+                startTime: startTime.toISOString(),
+                endTime: endTime.toISOString(),
+                durationMs: Math.max(0, durationMs),
+                status: options.status || 'ok',
+                statusMessage: options.statusMessage,
+                timestamp: startTime.toISOString(),
+                attributes: options.attributes,
+                runtime: this.runtimeProvider?.(),
+            };
+            this.sink(event);
+        }
+        catch {
+            /* never break the host */
+        }
+    }
+    deriveContext(parent) {
+        if (parent) {
+            return {
+                traceId: parent.traceId,
+                spanId: (0, ids_1.generateSpanId)(),
+                parentSpanId: parent.spanId,
+                sampled: parent.sampled,
+                traceState: parent.traceState,
+            };
+        }
+        // New root: head-based sampling decision.
+        const sampled = Math.random() < this.sampleRate;
+        return (0, propagation_1.createRootContext)(sampled);
+    }
+}
+exports.Tracer = Tracer;
+function isPromise(value) {
+    return (!!value &&
+        (typeof value === 'object' || typeof value === 'function') &&
+        typeof value.then === 'function');
+}
+//# sourceMappingURL=tracer.js.map

package/dist/signals/tracer.js.map

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

package/dist/transport/batcher.d.ts

@@ -0,0 +1,31 @@
+import { Resource, TelemetryEvent } from '../types';
+import { ResolvedConfig } from '../config';
+import { Transport } from './transport';
+import { Diagnostics } from '../internal/diagnostics';
+export declare class Batcher {
+    private readonly config;
+    private readonly resource;
+    private readonly transport;
+    private readonly diagnostics;
+    private buffer;
+    private timer?;
+    private flushing;
+    private droppedSinceLastFlush;
+    private closed;
+    constructor(config: ResolvedConfig, resource: Resource, transport: Transport, diagnostics: Diagnostics);
+    /** Add an event to the buffer. Non-blocking; triggers a flush when full. */
+    enqueue(event: TelemetryEvent): void;
+    /** Flush all currently buffered events. Never rejects. */
+    flush(): Promise<void>;
+    /**
+     * Attempt to deliver one batch with retries. Returns true on success.
+     * On a transient failure the batch is re-buffered (front) for a later cycle;
+     * on a fatal failure (e.g. 401/400) the batch is dropped.
+     */
+    private deliver;
+    /** Stop the timer and flush remaining events. Idempotent. */
+    shutdown(): Promise<void>;
+    /** Current number of buffered events (for tests/diagnostics). */
+    get size(): number;
+}
+//# sourceMappingURL=batcher.d.ts.map

package/dist/transport/batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../../src/transport/batcher.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAkB,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,qBAAa,OAAO;IAQhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAV9B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,MAAM,CAAS;gBAGJ,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW;IAS3C,4EAA4E;IAC5E,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAgBpC,0DAA0D;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B;;;;OAIG;YACW,OAAO;IAgDrB,6DAA6D;IACvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,iEAAiE;IACjE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}