@nodii/telemetry 0.0.1 → 0.1.1

package/dist/metrics.js

@@ -0,0 +1,152 @@
+// Metrics per D18 / D19 / D20 / D21 / D22 / D23 / D24.
+//
+// Discipline at v0.1.0:
+//   - `metrics.counter()` and `metrics.histogram()` accept a name +
+//     family + description. The name MUST exist in the vocabulary
+//     registry loaded by `initTelemetry({ vocabularyRegistry })` per
+//     D24. Names not in the registry are rejected with
+//     `telemetry.sdk.cardinality_rejected_total{family, reason='not_in_vocabulary'}`
+//     and a thrown `MetricVocabularyError`.
+//   - `family` is one of the six locked families (D18). Mismatches with
+//     the registry-declared family are rejected the same way.
+//   - `tenant_id` is a bare label (D20) — the registration helper
+//     validates label keys against a deny-list that excludes `tenant.id`
+//     and `tenantId` variants.
+//   - Histograms are exponential (D19); the wrapper exposes
+//     `histogram.record(value, labels)` and stores the configuration
+//     for the OTel adapter to consume in TS-12. Max 160 buckets (D19).
+//   - Delta temporality (D21) is declared on the wrapper; the OTel
+//     adapter sets the OTLP export accordingly.
+import { requireTelemetry } from "./init";
+import { incSdkCounter } from "./sdk-counters";
+import { METRIC_FAMILIES, } from "./types";
+/** Thrown by `metrics.counter/histogram` when registration is rejected. */
+export class MetricVocabularyError extends Error {
+    metric;
+    reason;
+    constructor(metric, reason) {
+        super(`metric "${metric}" rejected: ${reason}`);
+        this.metric = metric;
+        this.reason = reason;
+        this.name = "MetricVocabularyError";
+    }
+}
+/**
+ * D20: bare-label discipline. Reject `tenant.id` and `tenantId`
+ * variants at registration. Also reject any underscored Postgres-y
+ * variants like `tenantid`. The locked correct key is `tenant_id`.
+ */
+const FORBIDDEN_LABEL_KEYS = new Set([
+    "tenant.id",
+    "tenantId",
+    "tenantid",
+    "TENANT_ID",
+]);
+function validateLabelKeys(metric, family, labelKeys) {
+    for (const k of labelKeys) {
+        if (FORBIDDEN_LABEL_KEYS.has(k)) {
+            const reason = "label_key_forbidden";
+            incSdkCounter("telemetry.sdk.cardinality_rejected_total", {
+                family,
+                reason,
+            });
+            throw new MetricVocabularyError(metric, `label key '${k}' forbidden — use bare 'tenant_id' per D20`);
+        }
+    }
+}
+function validateRegistration(metric, family) {
+    if (!METRIC_FAMILIES.includes(family)) {
+        const reason = "family_unknown";
+        incSdkCounter("telemetry.sdk.cardinality_rejected_total", {
+            family,
+            reason,
+        });
+        throw new MetricVocabularyError(metric, reason);
+    }
+    const cfg = requireTelemetry();
+    const entry = cfg.vocabularyRegistry[metric];
+    if (!entry) {
+        const reason = "not_in_vocabulary";
+        incSdkCounter("telemetry.sdk.cardinality_rejected_total", {
+            family,
+            reason,
+        });
+        throw new MetricVocabularyError(metric, reason);
+    }
+    if (entry.family !== family) {
+        const reason = "family_mismatch";
+        incSdkCounter("telemetry.sdk.cardinality_rejected_total", {
+            family,
+            reason,
+        });
+        throw new MetricVocabularyError(metric, `family mismatch — registry says '${entry.family}', caller said '${family}'`);
+    }
+    return entry;
+}
+const inProcessBackend = {
+    recordCounter(_name, _by, _labels) {
+        /* no-op; TS-12 replaces */
+    },
+    recordHistogram(_name, _value, _labels) {
+        /* no-op; TS-12 replaces */
+    },
+};
+let backend = inProcessBackend;
+export function _setMetricsBackend(b) {
+    backend = b;
+}
+export function _resetMetricsBackendForTests() {
+    backend = inProcessBackend;
+}
+function counter(name, reg) {
+    const entry = validateRegistration(name, reg.family);
+    validateLabelKeys(name, reg.family, reg.labelKeys ?? []);
+    const description = reg.description || entry.description;
+    return {
+        name,
+        family: reg.family,
+        description,
+        inc(byOrLabels, maybeLabels) {
+            let by;
+            let labels;
+            if (typeof byOrLabels === "number") {
+                by = byOrLabels;
+                labels = maybeLabels ?? {};
+            }
+            else {
+                by = 1;
+                labels = byOrLabels ?? {};
+            }
+            backend.recordCounter(name, by, labels);
+        },
+    };
+}
+function histogram(name, reg) {
+    const entry = validateRegistration(name, reg.family);
+    validateLabelKeys(name, reg.family, reg.labelKeys ?? []);
+    const description = reg.description || entry.description;
+    const maxBuckets = reg.maxBuckets ?? 160;
+    if (maxBuckets > 160) {
+        throw new MetricVocabularyError(name, `maxBuckets ${maxBuckets} exceeds D19 cap (160)`);
+    }
+    return {
+        name,
+        family: reg.family,
+        description,
+        maxBuckets,
+        record(value, labels = {}) {
+            backend.recordHistogram(name, value, labels);
+        },
+    };
+}
+/**
+ * The `metrics.*` namespace (D149 verbatim name). Use:
+ *
+ *   const c = metrics.counter('billing_payments_total', { family: 'async_worker', description: '...' });
+ *   c.inc({ tenant_id, pgw, status });
+ */
+export const metrics = {
+    counter,
+    histogram,
+};
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,wBAAwB;AACxB,oEAAoE;AACpE,kEAAkE;AAClE,qEAAqE;AACrE,uDAAuD;AACvD,qFAAqF;AACrF,4CAA4C;AAC5C,wEAAwE;AACxE,8DAA8D;AAC9D,kEAAkE;AAClE,yEAAyE;AACzE,+BAA+B;AAC/B,4DAA4D;AAC5D,qEAAqE;AACrE,uEAAuE;AACvE,mEAAmE;AACnE,gDAAgD;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,eAAe,GAGhB,MAAM,SAAS,CAAC;AAEjB,2EAA2E;AAC3E,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IACA;IAFlB,YACkB,MAAc,EACd,MAAc;QAE9B,KAAK,CAAC,WAAW,MAAM,eAAe,MAAM,EAAE,CAAC,CAAC;QAHhC,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,WAAW;IACX,UAAU;IACV,UAAU;IACV,WAAW;CACZ,CAAC,CAAC;AAEH,SAAS,iBAAiB,CACxB,MAAc,EACd,MAAoB,EACpB,SAA4B;IAE5B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACrC,aAAa,CAAC,0CAA0C,EAAE;gBACxD,MAAM;gBACN,MAAM;aACP,CAAC,CAAC;YACH,MAAM,IAAI,qBAAqB,CAC7B,MAAM,EACN,cAAc,CAAC,4CAA4C,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,MAAc,EACd,MAAoB;IAEpB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,gBAAgB,CAAC;QAChC,aAAa,CAAC,0CAA0C,EAAE;YACxD,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QACH,MAAM,IAAI,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,mBAAmB,CAAC;QACnC,aAAa,CAAC,0CAA0C,EAAE;YACxD,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QACH,MAAM,IAAI,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,iBAAiB,CAAC;QACjC,aAAa,CAAC,0CAA0C,EAAE;YACxD,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QACH,MAAM,IAAI,qBAAqB,CAC7B,MAAM,EACN,oCAAoC,KAAK,CAAC,MAAM,mBAAmB,MAAM,GAAG,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAoCD,MAAM,gBAAgB,GAAmB;IACvC,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO;QAC/B,2BAA2B;IAC7B,CAAC;IACD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO;QACpC,2BAA2B;IAC7B,CAAC;CACF,CAAC;AAEF,IAAI,OAAO,GAAmB,gBAAgB,CAAC;AAE/C,MAAM,UAAU,kBAAkB,CAAC,CAAiB;IAClD,OAAO,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,GAAG,gBAAgB,CAAC;AAC7B,CAAC;AAQD,SAAS,OAAO,CAAC,IAAY,EAAE,GAAuB;IACpD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;IACzD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW;QACX,GAAG,CACD,UAAqD,EACrD,WAA6C;YAE7C,IAAI,EAAU,CAAC;YACf,IAAI,MAAuC,CAAC;YAC5C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,EAAE,GAAG,UAAU,CAAC;gBAChB,MAAM,GAAG,WAAW,IAAI,EAAE,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,EAAE,GAAG,CAAC,CAAC;gBACP,MAAM,GAAG,UAAU,IAAI,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,IAAY,EACZ,GAAiD;IAEjD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;IACzD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC;IACzC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,qBAAqB,CAC7B,IAAI,EACJ,cAAc,UAAU,wBAAwB,CACjD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW;QACX,UAAU;QACV,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE;YACvB,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO;IACP,SAAS;CACD,CAAC"}

package/dist/otlp-adapter.d.ts

@@ -0,0 +1,44 @@
+import { LoggerProvider } from "@opentelemetry/sdk-logs";
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { type CounterHandle, type HistogramHandle } from "./metrics";
+import type { ErrorHandlingConfig, ResourceAttributes } from "./types";
+/** Config for the OTLP adapter — the subset of init config it needs. */
+export interface OtlpAdapterConfig {
+    serviceName: string;
+    env: string;
+    serviceVersion?: string;
+    deploymentRegion?: string;
+    otlpEndpoint: string;
+    errorHandling: ErrorHandlingConfig;
+    resourceAttributes: Record<string, string | number | boolean>;
+}
+/** Handle returned by `installOtlpAdapter` so callers can shut down. */
+export interface OtlpAdapterHandle {
+    /** Force-flushes all signal pipelines (spans + logs + metrics). */
+    forceFlush(): Promise<void>;
+    /** Shuts everything down. Calls flush first. */
+    shutdown(): Promise<void>;
+    /** Direct accessor — used by Lambda lifecycle wrappers. */
+    tracerProvider: NodeTracerProvider;
+    loggerProvider: LoggerProvider;
+    meterProvider: MeterProvider;
+}
+/**
+ * Installs the real OTLP exporters by replacing the no-op emitter,
+ * sink, and backend with adapters that flush to OTel SDK providers
+ * wired to OTLP gRPC.
+ *
+ * Idempotent — second call returns the same handle.
+ */
+export declare function installOtlpAdapter(cfg: OtlpAdapterConfig): OtlpAdapterHandle;
+/** Force-flushes the active OTLP pipelines. No-op when not installed. */
+export declare function forceFlush(): Promise<void>;
+/** Shuts down the OTLP pipelines. No-op when not installed. */
+export declare function shutdownOtlpAdapter(): Promise<void>;
+/** For tests + introspection. */
+export declare function getOtlpAdapterHandle(): OtlpAdapterHandle | null;
+/** Test-only reset; does NOT shutdown providers. */
+export declare function _resetOtlpAdapterForTests(): void;
+export type { CounterHandle, HistogramHandle, ResourceAttributes };
+//# sourceMappingURL=otlp-adapter.d.ts.map

package/dist/otlp-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-adapter.d.ts","sourceRoot":"","sources":["../src/otlp-adapter.ts"],"names":[],"mappings":"AAkCA,OAAO,EAEL,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,aAAa,EAEd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EAGrB,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,mBAAmB,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC/D;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,2DAA2D;IAC3D,cAAc,EAAE,kBAAkB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,CA2M5E;AAED,yEAAyE;AACzE,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAGhD;AAED,+DAA+D;AAC/D,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGzD;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D;AAED,oDAAoD;AACpD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAkHD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/otlp-adapter.js

@@ -0,0 +1,351 @@
+// Real OTLP wiring per D153 + D154. This module replaces the no-op
+// emitters/sinks/backends installed by tracer.ts, logger.ts, and
+// metrics.ts at module-init time with real OTel SDK exporters writing
+// to an OTLP gRPC collector (signoz/signoz-otel-collector) at
+// `OTLPEndpoint` (default `http://localhost:4317`).
+//
+// Wired here:
+//   - NodeTracerProvider + BatchSpanProcessor + OTLPTraceExporter
+//   - LoggerProvider + BatchLogRecordProcessor + OTLPLogExporter
+//   - MeterProvider + PeriodicExportingMetricReader + OTLPMetricExporter
+//
+// We do NOT call NodeSDK.start() — instead we wire providers directly
+// so we can keep the existing SpanEmitter / LogSink / MetricsBackend
+// injection points the rest of the library depends on. This way we
+// don't break the existing v0.1.0 API surface or its tests.
+import { credentials } from "@grpc/grpc-js";
+import { SpanKind as OtelSpanKind, SpanStatusCode, TraceFlags, context as otelContext, trace as otelTrace, } from "@opentelemetry/api";
+import { SeverityNumber, logs as otelLogs, } from "@opentelemetry/api-logs";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-grpc";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-grpc";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-grpc";
+import { Resource } from "@opentelemetry/resources";
+import { BatchLogRecordProcessor, LoggerProvider, } from "@opentelemetry/sdk-logs";
+import { AggregationTemporality, MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
+import { BatchSpanProcessor, NodeTracerProvider, } from "@opentelemetry/sdk-trace-node";
+import { ATTR_DEPLOYMENT_ENVIRONMENT_NAME, ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from "@opentelemetry/semantic-conventions";
+import { _setLogSink } from "./logger";
+import { _setMetricsBackend, } from "./metrics";
+import { incSdkCounter } from "./sdk-counters";
+import { _setSpanEmitter } from "./tracer";
+let activeHandle = null;
+/**
+ * Installs the real OTLP exporters by replacing the no-op emitter,
+ * sink, and backend with adapters that flush to OTel SDK providers
+ * wired to OTLP gRPC.
+ *
+ * Idempotent — second call returns the same handle.
+ */
+export function installOtlpAdapter(cfg) {
+    if (activeHandle)
+        return activeHandle;
+    // Normalize the endpoint so all 3 languages accept the same shape.
+    // TS's OTLP exporter requires the `http://` or `https://` scheme on
+    // `url`. Python/Go accept bare host:port. We accept either and
+    // canonicalize for TS by adding `http://` if missing.
+    const otlpUrl = normalizeOtlpUrlForTs(cfg.otlpEndpoint);
+    const resource = new Resource({
+        [ATTR_SERVICE_NAME]: cfg.serviceName,
+        [ATTR_DEPLOYMENT_ENVIRONMENT_NAME]: cfg.env,
+        ...(cfg.serviceVersion
+            ? { [ATTR_SERVICE_VERSION]: cfg.serviceVersion }
+            : {}),
+        ...(cfg.deploymentRegion ? { "cloud.region": cfg.deploymentRegion } : {}),
+        ...cfg.resourceAttributes,
+    });
+    // ── Trace pipeline. D153 sending_queue=5000; drop on full.
+    const traceExporter = new OTLPTraceExporter({
+        url: otlpUrl,
+        credentials: credentials.createInsecure(),
+    });
+    const batchSpanProcessor = new BatchSpanProcessor(traceExporter, {
+        maxQueueSize: cfg.errorHandling.otlpSendingQueueSize,
+        maxExportBatchSize: 512,
+        scheduledDelayMillis: 1000,
+        exportTimeoutMillis: 10000,
+    });
+    const tracerProvider = new NodeTracerProvider({
+        resource,
+        spanProcessors: [batchSpanProcessor],
+    });
+    tracerProvider.register();
+    // ── Log pipeline. D153 backpressure shares the same lock.
+    const logExporter = new OTLPLogExporter({
+        url: otlpUrl,
+        credentials: credentials.createInsecure(),
+    });
+    const logRecordProcessor = new BatchLogRecordProcessor(logExporter, {
+        maxQueueSize: cfg.errorHandling.otlpSendingQueueSize,
+        maxExportBatchSize: 512,
+        scheduledDelayMillis: 1000,
+        exportTimeoutMillis: 10000,
+    });
+    const loggerProvider = new LoggerProvider({ resource });
+    loggerProvider.addLogRecordProcessor(logRecordProcessor);
+    otelLogs.setGlobalLoggerProvider(loggerProvider);
+    // ── Metrics pipeline. D21: delta temporality for counters + histograms.
+    const metricExporter = new OTLPMetricExporter({
+        url: otlpUrl,
+        credentials: credentials.createInsecure(),
+        temporalityPreference: AggregationTemporality.DELTA,
+    });
+    const metricReader = new PeriodicExportingMetricReader({
+        exporter: metricExporter,
+        exportIntervalMillis: 10000,
+        exportTimeoutMillis: 5000,
+    });
+    const meterProvider = new MeterProvider({
+        resource,
+        readers: [metricReader],
+    });
+    // ── Wire SpanEmitter to OTel tracer.
+    const otelTracer = tracerProvider.getTracer(cfg.serviceName);
+    const spanEmitter = {
+        emit(record) {
+            // We already produced our own span record with hex IDs. The
+            // cleanest path is to start an OTel span with the same name,
+            // attributes, and status using the existing trace context, then
+            // end it. Timestamps are taken from the record so the trace
+            // shape matches.
+            try {
+                const span = otelTracer.startSpan(record.name, {
+                    startTime: hrtimeFromNs(record.start_ns),
+                    attributes: toAttributes(record.attributes),
+                    kind: kindToOTel(record.kind),
+                });
+                for (const ev of record.events) {
+                    span.addEvent(ev.name, ev.attributes ? toAttributes(ev.attributes) : undefined, hrtimeFromNs(ev.ts_ns));
+                }
+                if (record.status === "ERROR") {
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: record.status_message,
+                    });
+                }
+                else if (record.status === "OK") {
+                    span.setStatus({ code: SpanStatusCode.OK });
+                }
+                span.end(hrtimeFromNs(record.end_ns));
+            }
+            catch (err) {
+                incSdkCounter("telemetry.sdk.export_failures_total", {
+                    signal: "traces",
+                    reason: classifyExportError(err),
+                });
+            }
+        },
+    };
+    _setSpanEmitter(spanEmitter);
+    // ── Wire LogSink to OTel logger.
+    const otelLogger = loggerProvider.getLogger(cfg.serviceName);
+    const logSink = (envelope, fields) => {
+        try {
+            const traceCtx = currentTraceCtx();
+            const merged = {
+                severityNumber: severityFromLevel(envelope.level),
+                severityText: envelope.level,
+                body: envelope.msg,
+                attributes: toAttributes(buildLogAttributes(envelope, fields)),
+                timestamp: Date.now(),
+                ...(traceCtx
+                    ? {
+                        traceId: traceCtx.traceId,
+                        spanId: traceCtx.spanId,
+                        traceFlags: traceCtx.traceFlags,
+                    }
+                    : {}),
+            };
+            otelLogger.emit(merged);
+        }
+        catch (err) {
+            incSdkCounter("telemetry.sdk.export_failures_total", {
+                signal: "logs",
+                reason: classifyExportError(err),
+            });
+        }
+    };
+    _setLogSink(logSink);
+    // ── Wire MetricsBackend to OTel meter.
+    const meter = meterProvider.getMeter(cfg.serviceName);
+    const counterCache = new Map();
+    const histogramCache = new Map();
+    const otelBackend = {
+        recordCounter(name, by, labels) {
+            try {
+                let c = counterCache.get(name);
+                if (!c) {
+                    c = meter.createCounter(name);
+                    counterCache.set(name, c);
+                }
+                c.add(by, toAttributes(labels));
+            }
+            catch (err) {
+                incSdkCounter("telemetry.sdk.export_failures_total", {
+                    signal: "metrics",
+                    reason: classifyExportError(err),
+                });
+            }
+        },
+        recordHistogram(name, value, labels) {
+            try {
+                let h = histogramCache.get(name);
+                if (!h) {
+                    h = meter.createHistogram(name);
+                    histogramCache.set(name, h);
+                }
+                h.record(value, toAttributes(labels));
+            }
+            catch (err) {
+                incSdkCounter("telemetry.sdk.export_failures_total", {
+                    signal: "metrics",
+                    reason: classifyExportError(err),
+                });
+            }
+        },
+    };
+    _setMetricsBackend(otelBackend);
+    activeHandle = {
+        tracerProvider,
+        loggerProvider,
+        meterProvider,
+        async forceFlush() {
+            await Promise.allSettled([
+                tracerProvider.forceFlush(),
+                loggerProvider.forceFlush(),
+                meterProvider.forceFlush(),
+            ]);
+        },
+        async shutdown() {
+            await this.forceFlush();
+            await Promise.allSettled([
+                tracerProvider.shutdown(),
+                loggerProvider.shutdown(),
+                meterProvider.shutdown(),
+            ]);
+            activeHandle = null;
+        },
+    };
+    return activeHandle;
+}
+/** Force-flushes the active OTLP pipelines. No-op when not installed. */
+export async function forceFlush() {
+    if (!activeHandle)
+        return;
+    await activeHandle.forceFlush();
+}
+/** Shuts down the OTLP pipelines. No-op when not installed. */
+export async function shutdownOtlpAdapter() {
+    if (!activeHandle)
+        return;
+    await activeHandle.shutdown();
+}
+/** For tests + introspection. */
+export function getOtlpAdapterHandle() {
+    return activeHandle;
+}
+/** Test-only reset; does NOT shutdown providers. */
+export function _resetOtlpAdapterForTests() {
+    activeHandle = null;
+}
+// ── helpers ────────────────────────────────────────────────────────
+function hrtimeFromNs(ns) {
+    const n = typeof ns === "bigint" ? ns : BigInt(Math.floor(ns));
+    const seconds = Number(n / 1000000000n);
+    const nanos = Number(n % 1000000000n);
+    return [seconds, nanos];
+}
+function toAttributes(attrs) {
+    const out = {};
+    for (const [k, v] of Object.entries(attrs)) {
+        if (v === null || v === undefined)
+            continue;
+        if (typeof v === "string" ||
+            typeof v === "number" ||
+            typeof v === "boolean") {
+            out[k] = v;
+        }
+        else {
+            out[k] = JSON.stringify(v);
+        }
+    }
+    return out;
+}
+function kindToOTel(kind) {
+    switch (kind) {
+        case "SERVER":
+            return OtelSpanKind.SERVER;
+        case "CLIENT":
+            return OtelSpanKind.CLIENT;
+        case "PRODUCER":
+            return OtelSpanKind.PRODUCER;
+        case "CONSUMER":
+            return OtelSpanKind.CONSUMER;
+        default:
+            return OtelSpanKind.INTERNAL;
+    }
+}
+function severityFromLevel(level) {
+    switch (level) {
+        case "debug":
+            return SeverityNumber.DEBUG;
+        case "info":
+            return SeverityNumber.INFO;
+        case "warn":
+            return SeverityNumber.WARN;
+        case "error":
+            return SeverityNumber.ERROR;
+        default:
+            return SeverityNumber.UNSPECIFIED;
+    }
+}
+function buildLogAttributes(envelope, fields) {
+    const attrs = {
+        "service.name": envelope.service,
+        "deployment.environment.name": envelope.env,
+        tenant_id: envelope.tenant_id,
+        request_id: envelope.request_id,
+        ...(envelope.user_id ? { user_id: envelope.user_id } : {}),
+        ...(envelope.actor_type ? { actor_type: envelope.actor_type } : {}),
+        ...(envelope.on_behalf_of ? { on_behalf_of: envelope.on_behalf_of } : {}),
+        ...(envelope.intent_id ? { intent_id: envelope.intent_id } : {}),
+        ...(envelope.trace_id ? { "telemetry.trace_id": envelope.trace_id } : {}),
+        ...(envelope.span_id ? { "telemetry.span_id": envelope.span_id } : {}),
+        ...fields,
+    };
+    return attrs;
+}
+function currentTraceCtx() {
+    const span = otelTrace.getSpan(otelContext.active());
+    if (!span)
+        return null;
+    const sc = span.spanContext();
+    if (!sc.traceId)
+        return null;
+    return {
+        traceId: sc.traceId,
+        spanId: sc.spanId,
+        traceFlags: sc.traceFlags ?? TraceFlags.NONE,
+    };
+}
+function classifyExportError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/queue/i.test(msg))
+        return "queue_full";
+    if (/timeout/i.test(msg))
+        return "timeout";
+    if (/5\d\d/.test(msg))
+        return "server_5xx";
+    return "network_error";
+}
+/**
+ * Cross-language endpoint normalization. Python and Go accept
+ * `localhost:4317`; TS's OTLP gRPC exporter requires a URL with
+ * scheme. We accept both and prepend `http://` for TS if absent.
+ */
+function normalizeOtlpUrlForTs(endpoint) {
+    const trimmed = endpoint.trim();
+    if (/^[a-zA-Z]+:\/\//.test(trimmed))
+        return trimmed;
+    return `http://${trimmed}`;
+}
+//# sourceMappingURL=otlp-adapter.js.map

package/dist/otlp-adapter.js.map

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

package/dist/outbox-emit.d.ts

@@ -0,0 +1,34 @@
+export interface OutboxEvent {
+    /** Locked topic format `<service>.<entity>.<verb>.v<N>`. */
+    topic: string;
+    /** Stable event id. UUIDv7 preferred. */
+    event_id: string;
+    payload: Record<string, unknown>;
+    /** Schema version embedded in the topic; surfaced here for outbox writers that want it as a column. */
+    schema_version: number;
+}
+export interface OutboxColumns {
+    tenant_id: string | null;
+    request_id: string | null;
+    intent_id: string | null;
+    trace_parent: string | null;
+    trace_state: string | null;
+    context_envelope: Record<string, unknown>;
+}
+export type OutboxWriter = (event: OutboxEvent, columns: OutboxColumns) => Promise<void> | void;
+/**
+ * SDK-internal: the `@nodii/telemetry/outbox` adapter or service init
+ * code sets the writer. Public callers MUST NOT call this directly.
+ */
+export declare function _setOutboxWriter(w: OutboxWriter): void;
+export declare function _resetOutboxWriterForTests(): void;
+/**
+ * Stage an outbox row. Per D43: hybrid columns + context_envelope
+ * jsonb. The columns are derived from the active NodiiContext + OTel
+ * span; the envelope is a JSON blob of the remaining context fields.
+ *
+ * Returns the resolved columns so callers (typically the intent
+ * lifecycle) can verify what was staged.
+ */
+export declare function emitOutbox(event: OutboxEvent): Promise<OutboxColumns>;
+//# sourceMappingURL=outbox-emit.d.ts.map

package/dist/outbox-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-emit.d.ts","sourceRoot":"","sources":["../src/outbox-emit.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uGAAuG;IACvG,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,aAAa,KACnB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAQ1B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAEtD;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAoB3E"}