@superblocksteam/telemetry 2.0.173-next.4 → 2.0.174

package/dist-esm/node/dynamic-attribute-processor.d.ts

@@ -0,0 +1,43 @@
+import type { Context } from "@opentelemetry/api";
+import type { LogRecordProcessor, SdkLogRecord } from "@opentelemetry/sdk-logs";
+import type { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+/**
+ * Wraps a span processor and stamps caller-provided attributes onto every span
+ * at start.
+ *
+ * This exists for attributes that are only known AFTER the SDK is initialized —
+ * e.g. the application/user/org identity a dev-server learns at connect time,
+ * when the SDK must already be running to instrument startup. Rather than
+ * re-initializing the SDK (which would churn instrumentation), the caller passes
+ * a getter that returns the current identity, and each span picks it up on start.
+ *
+ * Override semantics: `onStart` runs after creation-time attributes are applied,
+ * so a dynamic attribute overwrites any same-key attribute passed to `startSpan`.
+ * Attributes set on the span after creation still overwrite the dynamic value.
+ */
+export declare class DynamicAttributeSpanProcessor implements SpanProcessor {
+    private readonly inner;
+    private readonly attributes;
+    constructor(inner: SpanProcessor, attributes: () => Record<string, string>);
+    onStart(span: Span, parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Log-record twin of {@link DynamicAttributeSpanProcessor}: stamps the same
+ * late-known identity onto every exported log record. Without it, a service
+ * whose SDK started before identity was known (the dev-server preload) would
+ * export logs missing the application/user/org attributes that spans carry.
+ * Same override semantics as the span twin: dynamic attributes win over
+ * same-key attributes already on the record at emit time.
+ */
+export declare class DynamicAttributeLogRecordProcessor implements LogRecordProcessor {
+    private readonly inner;
+    private readonly attributes;
+    constructor(inner: LogRecordProcessor, attributes: () => Record<string, string>);
+    onEmit(logRecord: SdkLogRecord, context?: Context): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=dynamic-attribute-processor.d.ts.map

package/dist-esm/node/dynamic-attribute-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-attribute-processor.d.ts","sourceRoot":"","sources":["../../src/node/dynamic-attribute-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EACV,YAAY,EACZ,IAAI,EACJ,aAAa,EACd,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,qBAAa,6BAA8B,YAAW,aAAa;IAE/D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAG3D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAUjD,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAG1B;AAED;;;;;;;GAOG;AACH,qBAAa,kCAAmC,YAAW,kBAAkB;IAEzE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAG3D,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAUxD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAG1B"}

package/dist-esm/node/dynamic-attribute-processor.js

@@ -0,0 +1,74 @@
+/**
+ * Wraps a span processor and stamps caller-provided attributes onto every span
+ * at start.
+ *
+ * This exists for attributes that are only known AFTER the SDK is initialized —
+ * e.g. the application/user/org identity a dev-server learns at connect time,
+ * when the SDK must already be running to instrument startup. Rather than
+ * re-initializing the SDK (which would churn instrumentation), the caller passes
+ * a getter that returns the current identity, and each span picks it up on start.
+ *
+ * Override semantics: `onStart` runs after creation-time attributes are applied,
+ * so a dynamic attribute overwrites any same-key attribute passed to `startSpan`.
+ * Attributes set on the span after creation still overwrite the dynamic value.
+ */
+export class DynamicAttributeSpanProcessor {
+    inner;
+    attributes;
+    constructor(inner, attributes) {
+        this.inner = inner;
+        this.attributes = attributes;
+    }
+    onStart(span, parentContext) {
+        // Telemetry must never break span creation; a bad getter is swallowed.
+        try {
+            span.setAttributes(this.attributes());
+        }
+        catch {
+            // ignore
+        }
+        this.inner.onStart(span, parentContext);
+    }
+    onEnd(span) {
+        this.inner.onEnd(span);
+    }
+    forceFlush() {
+        return this.inner.forceFlush();
+    }
+    shutdown() {
+        return this.inner.shutdown();
+    }
+}
+/**
+ * Log-record twin of {@link DynamicAttributeSpanProcessor}: stamps the same
+ * late-known identity onto every exported log record. Without it, a service
+ * whose SDK started before identity was known (the dev-server preload) would
+ * export logs missing the application/user/org attributes that spans carry.
+ * Same override semantics as the span twin: dynamic attributes win over
+ * same-key attributes already on the record at emit time.
+ */
+export class DynamicAttributeLogRecordProcessor {
+    inner;
+    attributes;
+    constructor(inner, attributes) {
+        this.inner = inner;
+        this.attributes = attributes;
+    }
+    onEmit(logRecord, context) {
+        // Telemetry must never break log emission; a bad getter is swallowed.
+        try {
+            logRecord.setAttributes(this.attributes());
+        }
+        catch {
+            // ignore
+        }
+        this.inner.onEmit(logRecord, context);
+    }
+    forceFlush() {
+        return this.inner.forceFlush();
+    }
+    shutdown() {
+        return this.inner.shutdown();
+    }
+}
+//# sourceMappingURL=dynamic-attribute-processor.js.map

package/dist-esm/node/dynamic-attribute-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-attribute-processor.js","sourceRoot":"","sources":["../../src/node/dynamic-attribute-processor.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,6BAA6B;IAErB;IACA;IAFnB,YACmB,KAAoB,EACpB,UAAwC;QADxC,UAAK,GAAL,KAAK,CAAe;QACpB,eAAU,GAAV,UAAU,CAA8B;IACxD,CAAC;IAEJ,OAAO,CAAC,IAAU,EAAE,aAAsB;QACxC,uEAAuE;QACvE,IAAI,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAkB;QACtB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kCAAkC;IAE1B;IACA;IAFnB,YACmB,KAAyB,EACzB,UAAwC;QADxC,UAAK,GAAL,KAAK,CAAoB;QACzB,eAAU,GAAV,UAAU,CAA8B;IACxD,CAAC;IAEJ,MAAM,CAAC,SAAuB,EAAE,OAAiB;QAC/C,sEAAsE;QACtE,IAAI,CAAC;YACH,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist-esm/node/exporters/resilient-exporter.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Resilient Exporter
+ *
+ * Wrapper that ensures Tier 2/3 export failures never block core request paths.
+ * Export failures are observable via metrics, not via blocking or exceptions.
+ */
+import { ExportResult } from "@opentelemetry/core";
+import type { SpanExporter, ReadableSpan } from "@opentelemetry/sdk-trace-base";
+/**
+ * Minimal logger interface for structured export-failure logs (e.g. Pino/SafeLogger).
+ * When provided, export failures are logged so they can be ingested into Datadog.
+ */
+export interface TelemetryExportLogger {
+    warn(obj: object, msg?: string): void;
+    warn(msg: string): void;
+}
+/**
+ * Configuration for the resilient exporter.
+ */
+export interface ResilientExporterConfig {
+    /** Underlying exporter to wrap */
+    delegate: SpanExporter;
+    /** Max items to buffer before dropping (default: 2048) */
+    maxQueueSize?: number;
+    /** Export timeout in ms (default: 30000) */
+    exportTimeoutMs?: number;
+    /** Callback when items are dropped due to backpressure */
+    onDrop?: (count: number, reason: "queue_full" | "export_failed" | "timeout") => void;
+    /**
+     * Optional structured logger for export failures (e.g. safe logger).
+     * When set, export errors are logged here so they are ingested into Datadog.
+     */
+    logger?: TelemetryExportLogger;
+}
+/**
+ * Metrics exposed by the resilient exporter.
+ */
+export interface ResilientExporterMetrics {
+    /** Total spans dropped due to backpressure or failure */
+    dropped: number;
+    /** Current queue size */
+    queued: number;
+    /** Total export failures */
+    failures: number;
+}
+/**
+ * Resilient exporter wrapper that:
+ * - Drops spans when queue is full (never blocks)
+ * - Catches export failures and emits metrics
+ * - Times out stalled exports
+ *
+ * CRITICAL: Telemetry export must be fire-and-forget from the application's perspective.
+ * Export failures should be observable via metrics, not via blocking or exceptions.
+ */
+export declare class ResilientExporter implements SpanExporter {
+    private readonly delegate;
+    private readonly maxQueueSize;
+    private readonly exportTimeoutMs;
+    private readonly onDrop;
+    private readonly logger;
+    private queuedCount;
+    private droppedCount;
+    private exportFailures;
+    private shuttingDown;
+    constructor(config: ResilientExporterConfig);
+    /**
+     * Export spans with resilient error handling.
+     *
+     * IMPORTANT: Always returns SUCCESS to caller - export failures are
+     * observable via metrics, not via the result callback.
+     */
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+    /**
+     * Shutdown the underlying exporter.
+     * Marks exporter as shutting down to reject new exports.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush the underlying exporter.
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Get current metrics for observability.
+     */
+    getMetrics(): ResilientExporterMetrics;
+    /**
+     * Reset metrics (for testing).
+     */
+    resetMetrics(): void;
+}
+//# sourceMappingURL=resilient-exporter.d.ts.map

package/dist-esm/node/exporters/resilient-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient-exporter.d.ts","sourceRoot":"","sources":["../../../src/node/exporters/resilient-exporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CACP,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,SAAS,KAC/C,IAAI,CAAC;IACV;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGb;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,uBAAuB;IAQ3C;;;;;OAKG;IACH,MAAM,CACJ,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAC7C,IAAI;IAiEP;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACH,UAAU,IAAI,wBAAwB;IAQtC;;OAEG;IACH,YAAY,IAAI,IAAI;CAIrB"}

package/dist-esm/node/exporters/resilient-exporter.js

@@ -0,0 +1,132 @@
+/**
+ * Resilient Exporter
+ *
+ * Wrapper that ensures Tier 2/3 export failures never block core request paths.
+ * Export failures are observable via metrics, not via blocking or exceptions.
+ */
+import { ExportResultCode } from "@opentelemetry/core";
+/**
+ * Resilient exporter wrapper that:
+ * - Drops spans when queue is full (never blocks)
+ * - Catches export failures and emits metrics
+ * - Times out stalled exports
+ *
+ * CRITICAL: Telemetry export must be fire-and-forget from the application's perspective.
+ * Export failures should be observable via metrics, not via blocking or exceptions.
+ */
+export class ResilientExporter {
+    delegate;
+    maxQueueSize;
+    exportTimeoutMs;
+    onDrop;
+    logger;
+    queuedCount = 0;
+    droppedCount = 0;
+    exportFailures = 0;
+    shuttingDown = false;
+    constructor(config) {
+        this.delegate = config.delegate;
+        this.maxQueueSize = config.maxQueueSize ?? 2048;
+        this.exportTimeoutMs = config.exportTimeoutMs ?? 30000;
+        this.onDrop = config.onDrop ?? (() => { });
+        this.logger = config.logger;
+    }
+    /**
+     * Export spans with resilient error handling.
+     *
+     * IMPORTANT: Always returns SUCCESS to caller - export failures are
+     * observable via metrics, not via the result callback.
+     */
+    export(spans, resultCallback) {
+        // Don't accept new exports during shutdown
+        if (this.shuttingDown) {
+            resultCallback({ code: ExportResultCode.SUCCESS });
+            return;
+        }
+        // Check backpressure - drop if queue is full
+        if (this.queuedCount + spans.length > this.maxQueueSize) {
+            this.droppedCount += spans.length;
+            this.onDrop(spans.length, "queue_full");
+            // Still return success - don't block the caller
+            resultCallback({ code: ExportResultCode.SUCCESS });
+            return;
+        }
+        this.queuedCount += spans.length;
+        let completed = false;
+        // Wrap with timeout
+        const timeoutId = setTimeout(() => {
+            if (completed)
+                return;
+            completed = true;
+            this.queuedCount -= spans.length;
+            this.droppedCount += spans.length;
+            this.onDrop(spans.length, "timeout");
+            resultCallback({ code: ExportResultCode.SUCCESS }); // Don't propagate failure
+        }, this.exportTimeoutMs);
+        try {
+            this.delegate.export(spans, (result) => {
+                if (completed)
+                    return;
+                completed = true;
+                clearTimeout(timeoutId);
+                this.queuedCount -= spans.length;
+                if (result.code !== ExportResultCode.SUCCESS) {
+                    this.exportFailures++;
+                    this.droppedCount += spans.length;
+                    this.onDrop(spans.length, "export_failed");
+                }
+                // Always return success to caller - export failures are observable via metrics
+                resultCallback({ code: ExportResultCode.SUCCESS });
+            });
+        }
+        catch (error) {
+            if (completed)
+                return;
+            completed = true;
+            clearTimeout(timeoutId);
+            this.queuedCount -= spans.length;
+            this.exportFailures++;
+            this.droppedCount += spans.length;
+            this.onDrop(spans.length, "export_failed");
+            if (this.logger) {
+                this.logger.warn({ err: error, spanCount: spans.length, reason: "export_failed" }, "[Telemetry] Span export threw");
+            }
+            else {
+                console.warn("[Telemetry] Span export threw:", error);
+            }
+            resultCallback({ code: ExportResultCode.SUCCESS }); // Don't propagate failure
+        }
+    }
+    /**
+     * Shutdown the underlying exporter.
+     * Marks exporter as shutting down to reject new exports.
+     */
+    async shutdown() {
+        this.shuttingDown = true;
+        return this.delegate.shutdown();
+    }
+    /**
+     * Force flush the underlying exporter.
+     */
+    async forceFlush() {
+        return this.delegate.forceFlush?.() ?? Promise.resolve();
+    }
+    /**
+     * Get current metrics for observability.
+     */
+    getMetrics() {
+        return {
+            dropped: this.droppedCount,
+            queued: this.queuedCount,
+            failures: this.exportFailures,
+        };
+    }
+    /**
+     * Reset metrics (for testing).
+     */
+    resetMetrics() {
+        this.droppedCount = 0;
+        this.exportFailures = 0;
+    }
+}
+//# sourceMappingURL=resilient-exporter.js.map

package/dist-esm/node/exporters/resilient-exporter.js.map

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

package/dist-esm/node/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Node.js Telemetry Bootstrap
+ *
+ * This is the ONLY approved way to initialize telemetry in Node.js services.
+ */
+export { initNodeTelemetry, getTelemetryInstance, isTelemetryInitialized, resetTelemetry, type GetTracerOptions, type NodeTelemetryInstance, } from "./init.js";
+export { isLocalObsMode } from "./local-obs-mode.js";
+export { MetricsClient, type Labels, type CounterHandle, type CounterOptions, type GaugeHandle, type HistogramHandle, type HistogramOptions, } from "./metrics-client.js";
+export { TracedSocket, type TracedSocketConfig, type TracedSocketOptions, } from "./traced-socket.js";
+export { ResilientExporter, type ResilientExporterConfig, type ResilientExporterMetrics, } from "./exporters/resilient-exporter.js";
+export { LogExportMode, PolicyAwareLogProcessor, getLoggingPolicy, getMinimumPinoLevelForDeployment, getMinimumPinoLevelFromLoggingPolicy, parseLogExportMode, type LoggingPolicyConfig, } from "./log-processor.js";
+export { createSafeLogger, redactForbiddenFields, type SafeLoggerLike, } from "./safe-logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist-esm/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACL,aAAa,EACb,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,oCAAoC,EACpC,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC"}

package/dist-esm/node/index.js

@@ -0,0 +1,13 @@
+/**
+ * Node.js Telemetry Bootstrap
+ *
+ * This is the ONLY approved way to initialize telemetry in Node.js services.
+ */
+export { initNodeTelemetry, getTelemetryInstance, isTelemetryInitialized, resetTelemetry, } from "./init.js";
+export { isLocalObsMode } from "./local-obs-mode.js";
+export { MetricsClient, } from "./metrics-client.js";
+export { TracedSocket, } from "./traced-socket.js";
+export { ResilientExporter, } from "./exporters/resilient-exporter.js";
+export { LogExportMode, PolicyAwareLogProcessor, getLoggingPolicy, getMinimumPinoLevelForDeployment, getMinimumPinoLevelFromLoggingPolicy, parseLogExportMode, } from "./log-processor.js";
+export { createSafeLogger, redactForbiddenFields, } from "./safe-logger.js";
+//# sourceMappingURL=index.js.map

package/dist-esm/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,GAGf,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACL,aAAa,GAOd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,GAGlB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,oCAAoC,EACpC,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAEtB,MAAM,kBAAkB,CAAC"}

package/dist-esm/node/init.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Node.js Telemetry Bootstrap
+ *
+ * This is the ONLY approved way to initialize telemetry in Node.js services.
+ * Direct NodeSDK usage outside this package is prohibited.
+ */
+import { Tracer, Meter } from "@opentelemetry/api";
+import { Logger } from "@opentelemetry/api-logs";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { TelemetryPolicyEvaluator } from "../common/policy-evaluator.js";
+import type { NodeTelemetryConfig } from "../types/index.js";
+import { TelemetryPolicy } from "../types/policy.js";
+import { MetricsClient } from "./metrics-client.js";
+/**
+ * Options for {@link NodeTelemetryInstance.getTracer}.
+ */
+export interface GetTracerOptions {
+    /**
+     * Emit the tracer's spans under this service identity (its resource
+     * `service.name`, which Datadog maps to LLM-Obs `ml_app`). Omit for the
+     * primary service.
+     */
+    serviceName?: string;
+}
+/**
+ * Telemetry instance returned by initNodeTelemetry.
+ */
+export interface NodeTelemetryInstance {
+    /** The underlying NodeSDK instance (undefined in CI/no-op mode) */
+    sdk?: NodeSDK;
+    /** Policy evaluator for runtime decisions */
+    policyEvaluator: TelemetryPolicyEvaluator;
+    /**
+     * Get a tracer for the service.
+     *
+     * Pass `options.serviceName` to emit the tracer's spans under a secondary
+     * service identity (its resource `service.name`, which Datadog maps to LLM-Obs
+     * `ml_app`) while sharing this SDK's sanitization + export pipeline. Omit it
+     * for the primary service. The `options` argument is additive and optional —
+     * existing single-argument callers are unaffected. See APPS-5082.
+     */
+    getTracer: (name?: string, options?: GetTracerOptions) => Tracer;
+    /** Get a meter for the service */
+    getMeter: (name?: string) => Meter;
+    /** Get a logger for the service */
+    getLogger: (name?: string) => Logger;
+    /** Metrics client for recording counters, gauges, and histograms */
+    metricsClient: MetricsClient;
+    /** Graceful shutdown */
+    shutdown: () => Promise<void>;
+}
+declare global {
+    var __superblocksNodeTelemetryInstance: NodeTelemetryInstance | undefined;
+}
+/**
+ * Initialize Node.js telemetry with policy enforcement.
+ *
+ * This is the ONLY approved way to initialize telemetry in Node.js services.
+ * Direct NodeSDK usage outside this package is prohibited.
+ *
+ * @param config - Service configuration
+ * @param policy - Telemetry policy (REQUIRED)
+ * @returns Telemetry instance with SDK and utilities
+ *
+ * @example
+ * ```typescript
+ * import { initNodeTelemetry } from '@superblocksteam/telemetry/node';
+ * import { getDefaultPolicy, DeploymentType } from '@superblocksteam/shared';
+ *
+ * const policy = getDefaultPolicy(DeploymentType.CLOUD_PREM);
+ * const telemetry = initNodeTelemetry({
+ *   serviceName: 'my-service',
+ *   serviceVersion: '1.0.0',
+ *   environment: 'production',
+ *   otlpUrl: 'http://localhost:4318',
+ * }, policy);
+ *
+ * const tracer = telemetry.getTracer();
+ * ```
+ */
+export declare function initNodeTelemetry(config: NodeTelemetryConfig, policy: TelemetryPolicy): NodeTelemetryInstance;
+/**
+ * Get the current telemetry instance.
+ *
+ * @throws Error if not initialized
+ */
+export declare function getTelemetryInstance(): NodeTelemetryInstance;
+/**
+ * Check if telemetry is initialized.
+ */
+export declare function isTelemetryInitialized(): boolean;
+/**
+ * Reset telemetry (for testing only).
+ * @internal
+ */
+export declare function resetTelemetry(): void;
+//# sourceMappingURL=init.d.ts.map

package/dist-esm/node/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/node/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,MAAM,EAAW,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAQ,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAcvD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAOlD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAYpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6CAA6C;IAC7C,eAAe,EAAE,wBAAwB,CAAC;IAC1C;;;;;;;;OAQG;IACH,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC;IACjE,kCAAkC;IAClC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;IACnC,mCAAmC;IACnC,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,oEAAoE;IACpE,aAAa,EAAE,aAAa,CAAC;IAC7B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AASD,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,kCAAkC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC3E;AA0GD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,eAAe,GACtB,qBAAqB,CAqPvB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAQ5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}