@spinajs/telemetry-otel 2.0.507

package/lib/cjs/config/otel.d.ts

@@ -0,0 +1,20 @@
+declare const config: {
+    otel: {
+        /** Master switch — when false nothing is created and tracers are no-ops. */
+        enabled: boolean;
+        /** OTLP/HTTP traces endpoint (highlight.io default). */
+        endpoint: string;
+        /** Reported as the OTel `service.name` resource attribute. */
+        serviceName: string;
+        /** Extra resource attributes, e.g. { 'highlight.project_id': '...' }. */
+        resourceAttributes: Record<string, string>;
+        longSpan: {
+            /** Spans open longer than this are force-closed as orphaned. */
+            maxAgeMs: number;
+            /** Orphan sweep cadence. */
+            sweepIntervalMs: number;
+        };
+    };
+};
+export default config;
+//# sourceMappingURL=otel.d.ts.map

package/lib/cjs/config/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../src/config/otel.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,MAAM;IACV,IAAI;QACF,4EAA4E;QAC5E,OAAO;QAEP,wDAAwD;QACxD,QAAQ;QAER,8DAA8D;QAC9D,WAAW;QAEX,yEAAyE;QACzE,kBAAkB,EAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;QAEhD,QAAQ;YACN,gEAAgE;YAChE,QAAQ;YAER,4BAA4B;YAC5B,eAAe;;;CAGpB,CAAC;eAEa,MAAM"}

package/lib/cjs/config/otel.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config = {
+    otel: {
+        /** Master switch — when false nothing is created and tracers are no-ops. */
+        enabled: false,
+        /** OTLP/HTTP traces endpoint (highlight.io default). */
+        endpoint: 'https://otel.highlight.io:4318/v1/traces',
+        /** Reported as the OTel `service.name` resource attribute. */
+        serviceName: 'spinajs-app',
+        /** Extra resource attributes, e.g. { 'highlight.project_id': '...' }. */
+        resourceAttributes: {},
+        longSpan: {
+            /** Spans open longer than this are force-closed as orphaned. */
+            maxAgeMs: 30 * 60_000,
+            /** Orphan sweep cadence. */
+            sweepIntervalMs: 60_000,
+        },
+    },
+};
+exports.default = config;
+//# sourceMappingURL=otel.js.map

package/lib/cjs/config/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../../src/config/otel.ts"],"names":[],"mappings":";;AAAA,MAAM,MAAM,GAAG;IACb,IAAI,EAAE;QACJ,4EAA4E;QAC5E,OAAO,EAAE,KAAK;QAEd,wDAAwD;QACxD,QAAQ,EAAE,0CAA0C;QAEpD,8DAA8D;QAC9D,WAAW,EAAE,aAAa;QAE1B,yEAAyE;QACzE,kBAAkB,EAAE,EAA4B;QAEhD,QAAQ,EAAE;YACR,gEAAgE;YAChE,QAAQ,EAAE,EAAE,GAAG,MAAM;YAErB,4BAA4B;YAC5B,eAAe,EAAE,MAAM;SACxB;KACF;CACF,CAAC;kBAEa,MAAM"}

package/lib/cjs/index.d.ts

@@ -0,0 +1,3 @@
+export * from './tracing.js';
+export * from './longSpanRegistry.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/lib/cjs/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./tracing.js"), exports);
+__exportStar(require("./longSpanRegistry.js"), exports);
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,wDAAsC"}

package/lib/cjs/longSpanRegistry.d.ts

@@ -0,0 +1,42 @@
+import { AsyncService } from '@spinajs/di';
+import { Log } from '@spinajs/log';
+import { Attributes } from '@opentelemetry/api';
+import { OtelTracing } from './tracing.js';
+/**
+ * Keyed registry for long-lived spans (minutes) that cannot be scoped to one
+ * async call — e.g. one root span per payment transaction, opened when the
+ * transaction starts and closed by whichever handler sees the terminal state.
+ *
+ * Every method is a guarded no-op when tracing is disabled, the key is unknown
+ * or the underlying OTel call throws: observability must never break the
+ * business flow. An orphan sweep force-closes spans that outlive
+ * `otel.longSpan.maxAgeMs` (crashed flows, lost terminal messages).
+ */
+export declare class LongSpanRegistry extends AsyncService {
+    protected log: Log;
+    protected tracing: OtelTracing;
+    protected maxAgeMs: number;
+    protected sweepIntervalMs: number;
+    private readonly spans;
+    private timer?;
+    /** Open a span under `key`; a stale span on the same key is closed as replaced. */
+    open(key: string, name: string, attrs?: Attributes): void;
+    /** Add a span event; no-op when key is undefined/unknown. */
+    event(key: string | undefined, name: string, attrs?: Attributes): void;
+    setAttributes(key: string, attrs: Attributes): void;
+    has(key: string): boolean;
+    /** Close and export the span; no-op for unknown keys. */
+    close(key: string, status: 'ok' | 'error', attrs?: Attributes): void;
+    /**
+     * Run `fn` inside a short span, parented into the open long span for `key`
+     * when there is one (giving kiosk round-trips a place in the transaction
+     * waterfall), standalone otherwise. Errors are recorded and re-thrown.
+     */
+    childSpan<T>(key: string | undefined, name: string, attrs: Attributes, fn: () => Promise<T>): Promise<T>;
+    /** Force-close spans that outlived `maxAgeMs` (public for tests). */
+    sweep(): void;
+    private ensureSweepTimer;
+    private stopSweepTimer;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=longSpanRegistry.d.ts.map

package/lib/cjs/longSpanRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"longSpanRegistry.d.ts","sourceRoot":"","sources":["../../src/longSpanRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,YAAY,EAAc,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAwB,UAAU,EAAgC,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C;;;;;;;;;GASG;AACH,qBAEa,gBAAiB,SAAQ,YAAY;IAEhD,SAAS,CAAC,GAAG,EAAG,GAAG,CAAC;IAGpB,SAAS,CAAC,OAAO,EAAG,WAAW,CAAC;IAGhC,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAG5B,SAAS,CAAC,eAAe,EAAG,MAAM,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,KAAK,CAAC,CAAiB;IAE/B,mFAAmF;IAC5E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAe/D;IAED,6DAA6D;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAO5E;IAEM,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAMzD;IAEM,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/B;IAED,yDAAyD;IAClD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAY1E;IAED;;;;OAIG;IACU,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoBpH;IAED,qEAAqE;IAC9D,KAAK,IAAI,IAAI,CAYnB;IAED,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAMT,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpC;CACF"}

package/lib/cjs/longSpanRegistry.js

@@ -0,0 +1,176 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LongSpanRegistry = void 0;
+const di_1 = require("@spinajs/di");
+const configuration_1 = require("@spinajs/configuration");
+const log_1 = require("@spinajs/log");
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("./tracing.js");
+/**
+ * Keyed registry for long-lived spans (minutes) that cannot be scoped to one
+ * async call — e.g. one root span per payment transaction, opened when the
+ * transaction starts and closed by whichever handler sees the terminal state.
+ *
+ * Every method is a guarded no-op when tracing is disabled, the key is unknown
+ * or the underlying OTel call throws: observability must never break the
+ * business flow. An orphan sweep force-closes spans that outlive
+ * `otel.longSpan.maxAgeMs` (crashed flows, lost terminal messages).
+ */
+let LongSpanRegistry = class LongSpanRegistry extends di_1.AsyncService {
+    constructor() {
+        super(...arguments);
+        this.spans = new Map();
+    }
+    /** Open a span under `key`; a stale span on the same key is closed as replaced. */
+    open(key, name, attrs) {
+        try {
+            const stale = this.spans.get(key);
+            if (stale) {
+                stale.span.setAttribute('replaced', true);
+                stale.span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: 'replaced by a new span on the same key' });
+                stale.span.end();
+                this.spans.delete(key);
+            }
+            const span = this.tracing.tracer('paystation').startSpan(name, { attributes: attrs });
+            this.spans.set(key, { span, openedAt: Date.now() });
+            this.ensureSweepTimer();
+        }
+        catch (err) {
+            this.log.warn(`long-span open('${key}') failed: ${err.message}`);
+        }
+    }
+    /** Add a span event; no-op when key is undefined/unknown. */
+    event(key, name, attrs) {
+        try {
+            if (!key)
+                return;
+            this.spans.get(key)?.span.addEvent(name, attrs);
+        }
+        catch (err) {
+            this.log.warn(`long-span event('${key ?? ''}') failed: ${err.message}`);
+        }
+    }
+    setAttributes(key, attrs) {
+        try {
+            this.spans.get(key)?.span.setAttributes(attrs);
+        }
+        catch (err) {
+            this.log.warn(`long-span setAttributes('${key}') failed: ${err.message}`);
+        }
+    }
+    has(key) {
+        return this.spans.has(key);
+    }
+    /** Close and export the span; no-op for unknown keys. */
+    close(key, status, attrs) {
+        try {
+            const entry = this.spans.get(key);
+            if (!entry)
+                return;
+            if (attrs)
+                entry.span.setAttributes(attrs);
+            entry.span.setStatus({ code: status === 'ok' ? api_1.SpanStatusCode.OK : api_1.SpanStatusCode.ERROR });
+            entry.span.end();
+            this.spans.delete(key);
+            if (this.spans.size === 0)
+                this.stopSweepTimer();
+        }
+        catch (err) {
+            this.log.warn(`long-span close('${key}') failed: ${err.message}`);
+        }
+    }
+    /**
+     * Run `fn` inside a short span, parented into the open long span for `key`
+     * when there is one (giving kiosk round-trips a place in the transaction
+     * waterfall), standalone otherwise. Errors are recorded and re-thrown.
+     */
+    async childSpan(key, name, attrs, fn) {
+        let span;
+        try {
+            const parent = key ? this.spans.get(key)?.span : undefined;
+            const ctx = parent ? api_1.trace.setSpan(api_1.ROOT_CONTEXT, parent) : api_1.context.active();
+            span = this.tracing.tracer('paystation').startSpan(name, { attributes: attrs }, ctx);
+        }
+        catch (err) {
+            this.log.warn(`long-span childSpan('${name}') failed to start: ${err.message}`);
+        }
+        try {
+            const result = await fn();
+            span?.setStatus({ code: api_1.SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span?.recordException(err);
+            span?.setStatus({ code: api_1.SpanStatusCode.ERROR, message: err.message });
+            throw err;
+        }
+        finally {
+            span?.end();
+        }
+    }
+    /** Force-close spans that outlived `maxAgeMs` (public for tests). */
+    sweep() {
+        const cutoff = Date.now() - this.maxAgeMs;
+        for (const [key, entry] of this.spans) {
+            if (entry.openedAt <= cutoff) {
+                this.log.warn(`long-span '${key}' exceeded maxAgeMs; closing as orphaned`);
+                entry.span.setAttribute('orphaned', true);
+                entry.span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: 'span outlived otel.longSpan.maxAgeMs' });
+                entry.span.end();
+                this.spans.delete(key);
+            }
+        }
+        if (this.spans.size === 0)
+            this.stopSweepTimer();
+    }
+    ensureSweepTimer() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.sweep(), this.sweepIntervalMs);
+        this.timer.unref?.();
+    }
+    stopSweepTimer() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    async dispose() {
+        for (const key of [...this.spans.keys()]) {
+            this.close(key, 'error', { shutdown: true });
+        }
+        this.stopSweepTimer();
+        await super.dispose();
+    }
+};
+exports.LongSpanRegistry = LongSpanRegistry;
+__decorate([
+    (0, log_1.Logger)('otel'),
+    __metadata("design:type", log_1.Log)
+], LongSpanRegistry.prototype, "log", void 0);
+__decorate([
+    (0, di_1.Autoinject)(tracing_js_1.OtelTracing),
+    __metadata("design:type", tracing_js_1.OtelTracing)
+], LongSpanRegistry.prototype, "tracing", void 0);
+__decorate([
+    (0, configuration_1.Config)('otel.longSpan.maxAgeMs', { defaultValue: 30 * 60_000 }),
+    __metadata("design:type", Number)
+], LongSpanRegistry.prototype, "maxAgeMs", void 0);
+__decorate([
+    (0, configuration_1.Config)('otel.longSpan.sweepIntervalMs', { defaultValue: 60_000 }),
+    __metadata("design:type", Number)
+], LongSpanRegistry.prototype, "sweepIntervalMs", void 0);
+exports.LongSpanRegistry = LongSpanRegistry = __decorate([
+    (0, di_1.Singleton)(),
+    (0, di_1.Injectable)()
+], LongSpanRegistry);
+//# sourceMappingURL=longSpanRegistry.js.map

package/lib/cjs/longSpanRegistry.js.map

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

package/lib/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/cjs/tracing.d.ts

@@ -0,0 +1,36 @@
+import { AsyncService } from '@spinajs/di';
+import { Log } from '@spinajs/log';
+import { Tracer, Span, Attributes } from '@opentelemetry/api';
+import { SpanProcessor } from '@opentelemetry/sdk-trace-base';
+/**
+ * Boots a private OTel NodeTracerProvider with an OTLP/HTTP trace exporter.
+ *
+ * Config-driven and disabled by default: with `otel.enabled=false` no provider
+ * is created and `tracer()` hands out the OTel API no-op tracer, so call sites
+ * cost nothing. The provider is intentionally NOT registered as the OTel
+ * global — consumers get tracers through this service.
+ *
+ * `start( processor )` accepts a processor override so tests can plug an
+ * InMemorySpanExporter without any network.
+ */
+export declare class OtelTracing extends AsyncService {
+    protected log: Log;
+    protected enabled: boolean;
+    protected endpoint: string;
+    protected serviceName: string;
+    protected resourceAttributes: Record<string, string>;
+    private provider?;
+    /**
+     * Create the provider (idempotent, no-op when disabled). Call after the
+     * Configuration service is resolved so the @Config fields are populated.
+     */
+    start(processorOverride?: SpanProcessor): void;
+    get active(): boolean;
+    /** A tracer from the private provider, or the API no-op tracer when off. */
+    tracer(name: string): Tracer;
+    /** Run `fn` inside a span; records exceptions and sets ERROR status on throw. */
+    withSpan<T>(name: string, attrs: Attributes, fn: (span: Span) => Promise<T>): Promise<T>;
+    flush(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=tracing.d.ts.map

package/lib/cjs/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,YAAY,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAS,MAAM,EAAE,IAAI,EAAkB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAsB,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKlF;;;;;;;;;;GAUG;AACH,qBAEa,WAAY,SAAQ,YAAY;IAE3C,SAAS,CAAC,GAAG,EAAG,GAAG,CAAC;IAGpB,SAAS,CAAC,OAAO,EAAG,OAAO,CAAC;IAG5B,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAG5B,SAAS,CAAC,WAAW,EAAG,MAAM,CAAC;IAG/B,SAAS,CAAC,kBAAkB,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtD,OAAO,CAAC,QAAQ,CAAC,CAAqB;IAEtC;;;OAGG;IACI,KAAK,CAAC,iBAAiB,CAAC,EAAE,aAAa,GAAG,IAAI,CAWpD;IAED,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,4EAA4E;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElC;IAED,iFAAiF;IACpE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAapG;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpC;CACF"}

package/lib/cjs/tracing.js

@@ -0,0 +1,108 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtelTracing = void 0;
+const di_1 = require("@spinajs/di");
+const configuration_1 = require("@spinajs/configuration");
+const log_1 = require("@spinajs/log");
+const api_1 = require("@opentelemetry/api");
+const sdk_trace_node_1 = require("@opentelemetry/sdk-trace-node");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+/**
+ * Boots a private OTel NodeTracerProvider with an OTLP/HTTP trace exporter.
+ *
+ * Config-driven and disabled by default: with `otel.enabled=false` no provider
+ * is created and `tracer()` hands out the OTel API no-op tracer, so call sites
+ * cost nothing. The provider is intentionally NOT registered as the OTel
+ * global — consumers get tracers through this service.
+ *
+ * `start( processor )` accepts a processor override so tests can plug an
+ * InMemorySpanExporter without any network.
+ */
+let OtelTracing = class OtelTracing extends di_1.AsyncService {
+    /**
+     * Create the provider (idempotent, no-op when disabled). Call after the
+     * Configuration service is resolved so the @Config fields are populated.
+     */
+    start(processorOverride) {
+        if (!this.enabled || this.provider) {
+            return;
+        }
+        const resource = (0, resources_1.resourceFromAttributes)({
+            [semantic_conventions_1.ATTR_SERVICE_NAME]: this.serviceName,
+            ...this.resourceAttributes,
+        });
+        const processor = processorOverride ?? new sdk_trace_base_1.BatchSpanProcessor(new exporter_trace_otlp_http_1.OTLPTraceExporter({ url: this.endpoint }));
+        this.provider = new sdk_trace_node_1.NodeTracerProvider({ resource, spanProcessors: [processor] });
+        this.log.info(`otel tracing started (service=${this.serviceName}, endpoint=${this.endpoint})`);
+    }
+    get active() {
+        return this.provider !== undefined;
+    }
+    /** A tracer from the private provider, or the API no-op tracer when off. */
+    tracer(name) {
+        return this.provider ? this.provider.getTracer(name) : api_1.trace.getTracer(name);
+    }
+    /** Run `fn` inside a span; records exceptions and sets ERROR status on throw. */
+    async withSpan(name, attrs, fn) {
+        const span = this.tracer('spinajs').startSpan(name, { attributes: attrs });
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span.recordException(err);
+            span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: err.message });
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    }
+    async flush() {
+        await this.provider?.forceFlush();
+    }
+    async dispose() {
+        await this.provider?.shutdown();
+        this.provider = undefined;
+        await super.dispose();
+    }
+};
+exports.OtelTracing = OtelTracing;
+__decorate([
+    (0, log_1.Logger)('otel'),
+    __metadata("design:type", log_1.Log)
+], OtelTracing.prototype, "log", void 0);
+__decorate([
+    (0, configuration_1.Config)('otel.enabled', { defaultValue: false }),
+    __metadata("design:type", Boolean)
+], OtelTracing.prototype, "enabled", void 0);
+__decorate([
+    (0, configuration_1.Config)('otel.endpoint', { defaultValue: 'https://otel.highlight.io:4318/v1/traces' }),
+    __metadata("design:type", String)
+], OtelTracing.prototype, "endpoint", void 0);
+__decorate([
+    (0, configuration_1.Config)('otel.serviceName', { defaultValue: 'spinajs-app' }),
+    __metadata("design:type", String)
+], OtelTracing.prototype, "serviceName", void 0);
+__decorate([
+    (0, configuration_1.Config)('otel.resourceAttributes', { defaultValue: {} }),
+    __metadata("design:type", Object)
+], OtelTracing.prototype, "resourceAttributes", void 0);
+exports.OtelTracing = OtelTracing = __decorate([
+    (0, di_1.Singleton)(),
+    (0, di_1.Injectable)()
+], OtelTracing);
+//# sourceMappingURL=tracing.js.map

package/lib/cjs/tracing.js.map

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

package/lib/mjs/config/otel.d.ts

@@ -0,0 +1,20 @@
+declare const config: {
+    otel: {
+        /** Master switch — when false nothing is created and tracers are no-ops. */
+        enabled: boolean;
+        /** OTLP/HTTP traces endpoint (highlight.io default). */
+        endpoint: string;
+        /** Reported as the OTel `service.name` resource attribute. */
+        serviceName: string;
+        /** Extra resource attributes, e.g. { 'highlight.project_id': '...' }. */
+        resourceAttributes: Record<string, string>;
+        longSpan: {
+            /** Spans open longer than this are force-closed as orphaned. */
+            maxAgeMs: number;
+            /** Orphan sweep cadence. */
+            sweepIntervalMs: number;
+        };
+    };
+};
+export default config;
+//# sourceMappingURL=otel.d.ts.map

package/lib/mjs/config/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../src/config/otel.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,MAAM;IACV,IAAI;QACF,4EAA4E;QAC5E,OAAO;QAEP,wDAAwD;QACxD,QAAQ;QAER,8DAA8D;QAC9D,WAAW;QAEX,yEAAyE;QACzE,kBAAkB,EAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;QAEhD,QAAQ;YACN,gEAAgE;YAChE,QAAQ;YAER,4BAA4B;YAC5B,eAAe;;;CAGpB,CAAC;eAEa,MAAM"}

package/lib/mjs/config/otel.js

@@ -0,0 +1,20 @@
+const config = {
+    otel: {
+        /** Master switch — when false nothing is created and tracers are no-ops. */
+        enabled: false,
+        /** OTLP/HTTP traces endpoint (highlight.io default). */
+        endpoint: 'https://otel.highlight.io:4318/v1/traces',
+        /** Reported as the OTel `service.name` resource attribute. */
+        serviceName: 'spinajs-app',
+        /** Extra resource attributes, e.g. { 'highlight.project_id': '...' }. */
+        resourceAttributes: {},
+        longSpan: {
+            /** Spans open longer than this are force-closed as orphaned. */
+            maxAgeMs: 30 * 60_000,
+            /** Orphan sweep cadence. */
+            sweepIntervalMs: 60_000,
+        },
+    },
+};
+export default config;
+//# sourceMappingURL=otel.js.map

package/lib/mjs/config/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../../src/config/otel.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG;IACb,IAAI,EAAE;QACJ,4EAA4E;QAC5E,OAAO,EAAE,KAAK;QAEd,wDAAwD;QACxD,QAAQ,EAAE,0CAA0C;QAEpD,8DAA8D;QAC9D,WAAW,EAAE,aAAa;QAE1B,yEAAyE;QACzE,kBAAkB,EAAE,EAA4B;QAEhD,QAAQ,EAAE;YACR,gEAAgE;YAChE,QAAQ,EAAE,EAAE,GAAG,MAAM;YAErB,4BAA4B;YAC5B,eAAe,EAAE,MAAM;SACxB;KACF;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/lib/mjs/index.d.ts

@@ -0,0 +1,3 @@
+export * from './tracing.js';
+export * from './longSpanRegistry.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/mjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/lib/mjs/index.js

@@ -0,0 +1,3 @@
+export * from './tracing.js';
+export * from './longSpanRegistry.js';
+//# sourceMappingURL=index.js.map

package/lib/mjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/lib/mjs/longSpanRegistry.d.ts

@@ -0,0 +1,42 @@
+import { AsyncService } from '@spinajs/di';
+import { Log } from '@spinajs/log';
+import { Attributes } from '@opentelemetry/api';
+import { OtelTracing } from './tracing.js';
+/**
+ * Keyed registry for long-lived spans (minutes) that cannot be scoped to one
+ * async call — e.g. one root span per payment transaction, opened when the
+ * transaction starts and closed by whichever handler sees the terminal state.
+ *
+ * Every method is a guarded no-op when tracing is disabled, the key is unknown
+ * or the underlying OTel call throws: observability must never break the
+ * business flow. An orphan sweep force-closes spans that outlive
+ * `otel.longSpan.maxAgeMs` (crashed flows, lost terminal messages).
+ */
+export declare class LongSpanRegistry extends AsyncService {
+    protected log: Log;
+    protected tracing: OtelTracing;
+    protected maxAgeMs: number;
+    protected sweepIntervalMs: number;
+    private readonly spans;
+    private timer?;
+    /** Open a span under `key`; a stale span on the same key is closed as replaced. */
+    open(key: string, name: string, attrs?: Attributes): void;
+    /** Add a span event; no-op when key is undefined/unknown. */
+    event(key: string | undefined, name: string, attrs?: Attributes): void;
+    setAttributes(key: string, attrs: Attributes): void;
+    has(key: string): boolean;
+    /** Close and export the span; no-op for unknown keys. */
+    close(key: string, status: 'ok' | 'error', attrs?: Attributes): void;
+    /**
+     * Run `fn` inside a short span, parented into the open long span for `key`
+     * when there is one (giving kiosk round-trips a place in the transaction
+     * waterfall), standalone otherwise. Errors are recorded and re-thrown.
+     */
+    childSpan<T>(key: string | undefined, name: string, attrs: Attributes, fn: () => Promise<T>): Promise<T>;
+    /** Force-close spans that outlived `maxAgeMs` (public for tests). */
+    sweep(): void;
+    private ensureSweepTimer;
+    private stopSweepTimer;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=longSpanRegistry.d.ts.map

package/lib/mjs/longSpanRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"longSpanRegistry.d.ts","sourceRoot":"","sources":["../../src/longSpanRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,YAAY,EAAc,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAwB,UAAU,EAAgC,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C;;;;;;;;;GASG;AACH,qBAEa,gBAAiB,SAAQ,YAAY;IAEhD,SAAS,CAAC,GAAG,EAAG,GAAG,CAAC;IAGpB,SAAS,CAAC,OAAO,EAAG,WAAW,CAAC;IAGhC,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAG5B,SAAS,CAAC,eAAe,EAAG,MAAM,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,KAAK,CAAC,CAAiB;IAE/B,mFAAmF;IAC5E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAe/D;IAED,6DAA6D;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAO5E;IAEM,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAMzD;IAEM,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/B;IAED,yDAAyD;IAClD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAY1E;IAED;;;;OAIG;IACU,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoBpH;IAED,qEAAqE;IAC9D,KAAK,IAAI,IAAI,CAYnB;IAED,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAMT,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpC;CACF"}