@nwire/telemetry-otel 0.12.1 → 0.13.0

package/dist/otel-reporter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `otelTelemetryReporter(opts)` — a `TelemetryReporter` that drives the same
+ * OTel span routing as `attachOtelExporter`, but installs via the standard
+ * `installTelemetryReporter` API instead of subscribing directly to a runtime.
+ *
+ *   import { trace } from "@opentelemetry/api";
+ *   import { otelTelemetryReporter } from "@nwire/telemetry-otel";
+ *   import { installTelemetryReporter } from "@nwire/app";
+ *
+ *   const detach = installTelemetryReporter(app.runtime, otelTelemetryReporter({
+ *     tracer: trace.getTracer("my-service"),
+ *   }));
+ *
+ *   // Run both the local file reporter and OTLP in parallel:
+ *   const detachFile = installTelemetryReporter(app.runtime, fileTelemetryReporter(...));
+ *   const detachOtel = installTelemetryReporter(app.runtime, otelTelemetryReporter({ tracer }));
+ *
+ * Internally the reporter creates a minimal mock runtime whose `onTelemetry`
+ * subscriber is driven by `report()`. `close()` calls the `attachOtelExporter`
+ * detach (which closes open spans and clears internal maps). This design keeps
+ * the span-routing logic in one place — `attachOtelExporter` stays the single
+ * source of truth.
+ */
+import type { TelemetryReporter } from "@nwire/app";
+import { type AttachOtelExporterOptions } from "./exporter.js";
+import type { OtelTracer } from "./otel-types.js";
+export interface OtelTelemetryReporterOptions extends AttachOtelExporterOptions {
+    readonly tracer: OtelTracer;
+}
+/**
+ * Returns a {@link TelemetryReporter} that translates each `report()` call
+ * into OTel spans via `attachOtelExporter`'s routing logic.
+ *
+ * Call `installTelemetryReporter(runtime, otelTelemetryReporter({ tracer }))`
+ * to wire it up. A single runtime can hold this reporter alongside others
+ * (e.g. the local JSONL file reporter) — they receive the same records
+ * independently.
+ */
+export declare function otelTelemetryReporter(opts: OtelTelemetryReporterOptions): TelemetryReporter;

package/dist/otel-reporter.js

@@ -0,0 +1,65 @@
+/**
+ * `otelTelemetryReporter(opts)` — a `TelemetryReporter` that drives the same
+ * OTel span routing as `attachOtelExporter`, but installs via the standard
+ * `installTelemetryReporter` API instead of subscribing directly to a runtime.
+ *
+ *   import { trace } from "@opentelemetry/api";
+ *   import { otelTelemetryReporter } from "@nwire/telemetry-otel";
+ *   import { installTelemetryReporter } from "@nwire/app";
+ *
+ *   const detach = installTelemetryReporter(app.runtime, otelTelemetryReporter({
+ *     tracer: trace.getTracer("my-service"),
+ *   }));
+ *
+ *   // Run both the local file reporter and OTLP in parallel:
+ *   const detachFile = installTelemetryReporter(app.runtime, fileTelemetryReporter(...));
+ *   const detachOtel = installTelemetryReporter(app.runtime, otelTelemetryReporter({ tracer }));
+ *
+ * Internally the reporter creates a minimal mock runtime whose `onTelemetry`
+ * subscriber is driven by `report()`. `close()` calls the `attachOtelExporter`
+ * detach (which closes open spans and clears internal maps). This design keeps
+ * the span-routing logic in one place — `attachOtelExporter` stays the single
+ * source of truth.
+ */
+import { attachOtelExporter } from "./exporter.js";
+/**
+ * Returns a {@link TelemetryReporter} that translates each `report()` call
+ * into OTel spans via `attachOtelExporter`'s routing logic.
+ *
+ * Call `installTelemetryReporter(runtime, otelTelemetryReporter({ tracer }))`
+ * to wire it up. A single runtime can hold this reporter alongside others
+ * (e.g. the local JSONL file reporter) — they receive the same records
+ * independently.
+ */
+export function otelTelemetryReporter(opts) {
+    // We construct a lightweight synthetic runtime whose only job is to let
+    // attachOtelExporter subscribe. The single subscriber is stored, then driven
+    // directly from report(). This avoids duplicating the routing switch.
+    let listener = null;
+    const syntheticRuntime = {
+        onTelemetry(cb) {
+            // attachOtelExporter calls this exactly once.
+            listener = cb;
+            return () => {
+                listener = null;
+            };
+        },
+    };
+    // attachOtelExporter subscribes via onTelemetry and returns a detach.
+    // We cast: attachOtelExporter expects Runtime, our synthetic runtime satisfies
+    // the one property it uses (onTelemetry).
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const detach = attachOtelExporter(syntheticRuntime, opts);
+    return {
+        name: "otel",
+        report(record) {
+            if (listener) {
+                listener(record);
+            }
+        },
+        close() {
+            detach();
+            return Promise.resolve();
+        },
+    };
+}

package/dist/telemetry-otel.d.ts

@@ -14,4 +14,5 @@
  * Datadog, Honeycomb, Tempo, Jaeger).
  */
 export { attachOtelExporter, type AttachOtelExporterOptions } from "./exporter.js";
+export { otelTelemetryReporter, type OtelTelemetryReporterOptions } from "./otel-reporter.js";
 export type { OtelTracer, OtelSpan, SpanContext, SpanKind, SpanStatusCode } from "./otel-types.js";

package/dist/telemetry-otel.js

@@ -14,3 +14,4 @@
  * Datadog, Honeycomb, Tempo, Jaeger).
  */
 export { attachOtelExporter } from "./exporter.js";
+export { otelTelemetryReporter } from "./otel-reporter.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/telemetry-otel",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "private": false,
   "description": "OpenTelemetry bridge for the Nwire canonical telemetry stream. Translates every Telemetry record into OTLP spans + events. Plug in any OTEL exporter (Datadog, Honeycomb, Tempo, Vector → GreptimeDB).",
   "license": "MIT",
@@ -21,14 +21,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@nwire/app": "0.12.1",
-    "@nwire/forge": "0.12.1"
+    "@nwire/app": "0.13.0",
+    "@nwire/forge": "0.13.0"
   },
   "devDependencies": {
     "typescript": "^5.6.0",
     "vitest": "^4.0.18",
     "zod": "^4.0.0",
-    "@nwire/messages": "0.12.1"
+    "@nwire/messages": "0.13.0"
   },
   "scripts": {
     "build": "tsc && node ../../scripts/fix-dist-extensions.mjs dist",