@nwire/telemetry-otel 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @nwire/telemetry-otel
+
+> OpenTelemetry bridge — subscribes to `runtime.onTelemetry` and emits OTLP spans + events.
+
+## What it does
+
+Translates every canonical telemetry record into OTel spans (with causation-id-keyed parent lookup) and events. `@opentelemetry/api` is duck-typed, so the only runtime dep on Nwire side is `@nwire/forge`'s telemetry types. Pairs cleanly with Vector → GreptimeDB and any OTLP backend (Datadog, Honeycomb, Tempo, Jaeger).
+
+## Install
+
+```bash
+pnpm add @nwire/telemetry-otel @opentelemetry/api
+# plus the SDK + exporter you choose, e.g.:
+pnpm add @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-http
+```
+
+## Quick start
+
+```ts
+import { trace } from "@opentelemetry/api";
+import { attachOtelExporter } from "@nwire/telemetry-otel";
+import { app } from "./app";
+
+const detach = attachOtelExporter(app.runtime, {
+  tracer: trace.getTracer("learnflow"),
+});
+
+// later, during shutdown:
+detach();
+```
+
+## API surface
+
+- `attachOtelExporter(runtime, { tracer })` — returns an unsubscribe function.
+- `OtelTracer` / `OtelSpan` / `SpanContext` / `SpanKind` / `SpanStatusCode` — duck-typed OTel shapes.
+
+## When to use
+
+When you want production traces in your APM. Fits L4 and up.
+
+## Standalone use
+
+For developers using `@nwire/telemetry-otel` **without the rest of Nwire** — pair it with any TypeScript project, any container, any HTTP framework.
+
+```ts
+// See the package's main entry (src/) for the standalone surface.
+// The exports below work without @nwire/app or @nwire/forge.
+import {} from /* ...standalone exports... */ "@nwire/telemetry-otel";
+```
+
+## Within nwire-app
+
+For developers using this package as part of the Nwire stack — register it via `app.use(...)` or it auto-wires when you compose `createApp({ modules })`.
+
+```ts
+import { createApp } from "@nwire/forge";
+
+const app = createApp({
+  /* ...config... */
+});
+// Adapter/plugin wiring happens here when applicable.
+```
+
+## See also
+
+- [Architecture sketch §05 — Adapters tier](../../architecture-sketch.html#packages)
+- Sibling packages: [@nwire/observability](../nwire-observability), [@nwire/logger-pino](../nwire-logger-pino)

package/dist/exporter.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `attachOtelExporter(runtime, options)` — translates the canonical
+ * Nwire telemetry stream into OpenTelemetry spans + events.
+ *
+ *   import { trace } from "@opentelemetry/api";
+ *   import { attachOtelExporter } from "@nwire/telemetry-otel";
+ *
+ *   const tracer = trace.getTracer("amit");
+ *   const detach = attachOtelExporter(app.runtime, { tracer });
+ *
+ * Every Telemetry kind gets a sensible OTel mapping:
+ *
+ *   action.dispatched           → open span  "action {name}"      (parent for the dispatch)
+ *   action.completed            → close that span with ok status
+ *   action.failed               → addEvent  "action.failed" (attempt + error)
+ *   dlq.recorded                → close span with error status + dlq event
+ *   event.published             → addEvent  "event.published" on the open action span
+ *                                  OR ad-hoc span if no open parent
+ *   actor.transitioned          → addEvent  "actor.transitioned"
+ *   projection.folded           → addEvent  "projection.folded"
+ *   reaction.fired              → child span "reaction {sourceEvent}"
+ *   reaction.failed             → addEvent on the parent + recordException
+ *   query.executed              → ad-hoc span "query {name}"
+ *   timer.scheduled / .fired    → addEvent
+ *   external.call.started       → open child span "external {call}"
+ *   external.call.completed     → close it with ok
+ *   external.call.failed        → close it with error + addEvent per attempt
+ *   inbound.webhook.received    → ad-hoc span "webhook {name}"
+ *   outbox.flushed              → addEvent (could become a metric later)
+ *   inbox.dedup.hit             → addEvent
+ *   queue.job.{enqueued,started,completed}  → ad-hoc span "queue {queue}/{jobId}"
+ *   cron.fired                  → ad-hoc span "cron {name}"
+ *
+ * Spans are correlated by `envelope.messageId` (when present) — open spans
+ * are tracked in a Map so completion records can look them up. If a
+ * close-record arrives with no matching open span (e.g. listener attached
+ * mid-flight), we emit an orphan span with `{ status: ERROR, orphan: true }`.
+ *
+ * Returns a detach function — calling it unsubscribes and closes any
+ * still-open spans with an `unsubscribed` event.
+ */
+import type { Runtime, Telemetry } from "@nwire/forge";
+import type { OtelTracer } from "./otel-types";
+export interface AttachOtelExporterOptions {
+    /** OTel Tracer instance from `trace.getTracer(name, version?)`. */
+    readonly tracer: OtelTracer;
+    /**
+     * Prefix to apply to span names. Default `'nwire.'` so traces in OTLP
+     * backends stand out. Pass empty string to disable.
+     */
+    readonly spanNamePrefix?: string;
+    /**
+     * Custom event-published handling. By default, we attach published
+     * events as span events on the open action span. If you prefer each
+     * event as its own span, set `eventsAsSpans: true`.
+     */
+    readonly eventsAsSpans?: boolean;
+    /**
+     * Filter which telemetry kinds to forward. Default: all. Pass an array
+     * to opt in to specific kinds (e.g. for high-volume production traffic
+     * you might keep only action.* + external.call.*).
+     */
+    readonly kinds?: readonly Telemetry["kind"][];
+}
+export declare function attachOtelExporter(runtime: Runtime, options: AttachOtelExporterOptions): () => void;
+//# sourceMappingURL=exporter.d.ts.map

package/dist/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../src/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAmB,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,cAAc,CAAC;AAEzE,MAAM,WAAW,yBAAyB;IACxC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;CAC/C;AAUD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,yBAAyB,GACjC,MAAM,IAAI,CAwTZ"}

package/dist/exporter.js

@@ -0,0 +1,352 @@
+/**
+ * `attachOtelExporter(runtime, options)` — translates the canonical
+ * Nwire telemetry stream into OpenTelemetry spans + events.
+ *
+ *   import { trace } from "@opentelemetry/api";
+ *   import { attachOtelExporter } from "@nwire/telemetry-otel";
+ *
+ *   const tracer = trace.getTracer("amit");
+ *   const detach = attachOtelExporter(app.runtime, { tracer });
+ *
+ * Every Telemetry kind gets a sensible OTel mapping:
+ *
+ *   action.dispatched           → open span  "action {name}"      (parent for the dispatch)
+ *   action.completed            → close that span with ok status
+ *   action.failed               → addEvent  "action.failed" (attempt + error)
+ *   dlq.recorded                → close span with error status + dlq event
+ *   event.published             → addEvent  "event.published" on the open action span
+ *                                  OR ad-hoc span if no open parent
+ *   actor.transitioned          → addEvent  "actor.transitioned"
+ *   projection.folded           → addEvent  "projection.folded"
+ *   reaction.fired              → child span "reaction {sourceEvent}"
+ *   reaction.failed             → addEvent on the parent + recordException
+ *   query.executed              → ad-hoc span "query {name}"
+ *   timer.scheduled / .fired    → addEvent
+ *   external.call.started       → open child span "external {call}"
+ *   external.call.completed     → close it with ok
+ *   external.call.failed        → close it with error + addEvent per attempt
+ *   inbound.webhook.received    → ad-hoc span "webhook {name}"
+ *   outbox.flushed              → addEvent (could become a metric later)
+ *   inbox.dedup.hit             → addEvent
+ *   queue.job.{enqueued,started,completed}  → ad-hoc span "queue {queue}/{jobId}"
+ *   cron.fired                  → ad-hoc span "cron {name}"
+ *
+ * Spans are correlated by `envelope.messageId` (when present) — open spans
+ * are tracked in a Map so completion records can look them up. If a
+ * close-record arrives with no matching open span (e.g. listener attached
+ * mid-flight), we emit an orphan span with `{ status: ERROR, orphan: true }`.
+ *
+ * Returns a detach function — calling it unsubscribes and closes any
+ * still-open spans with an `unsubscribed` event.
+ */
+const OK = 1;
+const ERROR = 2;
+export function attachOtelExporter(runtime, options) {
+    const tracer = options.tracer;
+    const prefix = options.spanNamePrefix ?? "nwire.";
+    const eventsAsSpans = options.eventsAsSpans ?? false;
+    const allowed = options.kinds
+        ? new Set(options.kinds)
+        : null;
+    // Open spans, keyed by envelope.messageId (action) or call+messageId
+    // pair (external call). When the matching completion arrives we close.
+    const actionSpans = new Map();
+    const externalCallSpans = new Map();
+    const unsubscribe = runtime.onTelemetry((rec) => {
+        if (allowed && !allowed.has(rec.kind))
+            return;
+        try {
+            route(rec);
+        }
+        catch (err) {
+            // Don't let exporter errors break the runtime — the framework's
+            // emit() already guards listener throws, but we add explicit
+            // logging here too.
+            // eslint-disable-next-line no-console
+            console.error("[telemetry-otel] export failed:", err);
+        }
+    });
+    function route(rec) {
+        switch (rec.kind) {
+            case "action.dispatched":
+                openActionSpan(rec);
+                return;
+            case "action.completed":
+                closeActionSpan(rec, OK, undefined, {
+                    "nwire.action.duration_ms": rec.durationMs,
+                    "nwire.action.emitted_events": rec.emittedEvents.join(","),
+                });
+                return;
+            case "action.failed":
+                addEventToActionSpan(rec.envelope.messageId, "action.failed", {
+                    "nwire.action.attempt": rec.attempt,
+                    "nwire.action.max_attempts": rec.maxAttempts,
+                    "nwire.action.will_retry": rec.willRetry,
+                    ...errorAttrs(rec.error),
+                });
+                return;
+            case "dlq.recorded":
+                closeActionSpan(rec, ERROR, rec.error.message, {
+                    "nwire.dlq.attempts": rec.attempts,
+                    ...errorAttrs(rec.error),
+                });
+                return;
+            case "event.published":
+                if (eventsAsSpans) {
+                    adhocSpan(`event ${rec.event.eventName}`, rec.ts, {
+                        "nwire.event.name": rec.event.eventName,
+                        "nwire.event.source": rec.source,
+                        ...envelopeAttrs(rec.envelope),
+                    });
+                }
+                else {
+                    // Event records carry a DERIVED envelope: messageId is the
+                    // event's own, causationId is the action that emitted it. So
+                    // we look up the action span by causationId.
+                    addEventToActionSpan(rec.envelope.causationId, "event.published", {
+                        "nwire.event.name": rec.event.eventName,
+                        "nwire.event.source": rec.source,
+                    });
+                }
+                return;
+            case "actor.transitioned":
+                addEventToActionSpan(rec.envelope.causationId, "actor.transitioned", {
+                    "nwire.actor": rec.actor,
+                    "nwire.actor.key": rec.key,
+                    "nwire.actor.from": rec.from,
+                    "nwire.actor.to": rec.to,
+                    "nwire.actor.event": rec.triggeringEvent,
+                });
+                return;
+            case "projection.folded":
+                addEventToActionSpan(rec.envelope.causationId, "projection.folded", {
+                    "nwire.projection": rec.projection,
+                    "nwire.event.name": rec.event,
+                    "nwire.projection.duration_ms": rec.durationMs,
+                });
+                return;
+            case "reaction.fired":
+                adhocSpan(`reaction ${rec.sourceEvent}`, rec.ts, {
+                    "nwire.reaction.source_event": rec.sourceEvent,
+                    "nwire.reaction.duration_ms": rec.durationMs,
+                    ...envelopeAttrs(rec.envelope),
+                });
+                return;
+            case "reaction.failed":
+                addEventToActionSpan(rec.envelope.causationId, "reaction.failed", {
+                    "nwire.reaction.source_event": rec.sourceEvent,
+                    ...errorAttrs(rec.error),
+                });
+                return;
+            case "query.executed":
+                adhocSpan(`query ${rec.query}`, rec.ts, {
+                    "nwire.query.name": rec.query,
+                    "nwire.query.duration_ms": rec.durationMs,
+                    "nwire.tenant": rec.tenant,
+                });
+                return;
+            case "timer.scheduled":
+            case "timer.fired":
+                adhocSpan(rec.kind, rec.ts, {
+                    "nwire.actor": rec.actor,
+                    "nwire.actor.key": rec.key,
+                    "nwire.timer.name": rec.timer,
+                    "nwire.timer.action": rec.action,
+                    "nwire.tenant": rec.tenant,
+                    ...(rec.kind === "timer.fired"
+                        ? { "nwire.timer.late_by_ms": rec.lateByMs }
+                        : { "nwire.timer.fire_at": rec.fireAt }),
+                });
+                return;
+            case "external.call.started":
+                openExternalCallSpan(rec);
+                return;
+            case "external.call.completed":
+                closeExternalCallSpan(rec, OK, undefined, {
+                    "nwire.external.duration_ms": rec.durationMs,
+                    ...(rec.status !== undefined ? { "nwire.external.status": rec.status } : {}),
+                });
+                return;
+            case "external.call.failed":
+                closeExternalCallSpan(rec, ERROR, rec.error.message, {
+                    "nwire.external.attempt": rec.attempt,
+                    "nwire.external.will_retry": rec.willRetry,
+                    ...errorAttrs(rec.error),
+                });
+                return;
+            case "inbound.webhook.received":
+                adhocSpan(`webhook ${rec.webhook}`, rec.ts, {
+                    "nwire.webhook.name": rec.webhook,
+                    "nwire.webhook.source": rec.source,
+                    "nwire.webhook.signature_valid": rec.signatureValid,
+                    "nwire.webhook.dedup_hit": rec.dedupHit,
+                    ...(rec.routedTo ? { "nwire.webhook.routed_to": rec.routedTo } : {}),
+                });
+                return;
+            case "outbox.flushed":
+                adhocSpan(`outbox ${rec.outbox} flush`, rec.ts, {
+                    "nwire.outbox.name": rec.outbox,
+                    "nwire.outbox.events": rec.events,
+                    "nwire.outbox.failed": rec.failed,
+                    "nwire.outbox.duration_ms": rec.durationMs,
+                });
+                return;
+            case "inbox.dedup.hit":
+                adhocSpan(`inbox ${rec.inbox} dedup`, rec.ts, {
+                    "nwire.inbox.name": rec.inbox,
+                    "nwire.inbox.message_id": rec.messageId,
+                    "nwire.inbox.first_seen_at": rec.firstSeenAt,
+                });
+                return;
+            case "queue.job.enqueued":
+            case "queue.job.started":
+            case "queue.job.completed":
+                adhocSpan(`queue ${rec.queue}/${rec.kind.replace("queue.job.", "")}`, rec.ts, {
+                    "nwire.queue.name": rec.queue,
+                    "nwire.queue.job_id": rec.jobId,
+                    ...(rec.kind === "queue.job.enqueued" && rec.delay !== undefined
+                        ? { "nwire.queue.delay": rec.delay }
+                        : {}),
+                    ...(rec.kind === "queue.job.started" ? { "nwire.queue.waited_ms": rec.waitedMs } : {}),
+                    ...(rec.kind === "queue.job.completed"
+                        ? { "nwire.queue.duration_ms": rec.durationMs, "nwire.queue.ok": rec.ok }
+                        : {}),
+                });
+                return;
+            case "cron.fired":
+                adhocSpan(`cron ${rec.cronName}`, rec.ts, {
+                    "nwire.cron.name": rec.cronName,
+                    "nwire.cron.schedule": rec.schedule,
+                    "nwire.cron.expected": rec.expected,
+                    "nwire.cron.actual": rec.actual,
+                    "nwire.cron.late_by_ms": rec.lateByMs,
+                });
+                return;
+        }
+    }
+    function openActionSpan(rec) {
+        const span = tracer.startSpan(`${prefix}action ${rec.action}`, {
+            startTime: new Date(rec.ts),
+            attributes: {
+                "nwire.action": rec.action,
+                ...envelopeAttrs(rec.envelope),
+                "nwire.app": rec.appName,
+            },
+        });
+        actionSpans.set(rec.envelope.messageId, { span, startedAt: Date.now() });
+    }
+    function closeActionSpan(rec, status, msg, attrs) {
+        const open = actionSpans.get(rec.envelope.messageId);
+        if (!open) {
+            // Orphan — close-record without an open span. Emit an ad-hoc record
+            // so we don't silently drop data.
+            adhocSpan(`${prefix}action.orphan`, rec.ts, {
+                "nwire.orphan": true,
+                "nwire.app": rec.appName,
+                ...attrs,
+            });
+            return;
+        }
+        actionSpans.delete(rec.envelope.messageId);
+        setAttrs(open.span, attrs);
+        open.span.setStatus({ code: status, message: msg });
+        open.span.end(new Date(rec.ts));
+    }
+    function addEventToActionSpan(messageId, name, attrs) {
+        const open = actionSpans.get(messageId);
+        if (open) {
+            open.span.addEvent(name, attrs);
+            return;
+        }
+        // No parent — emit standalone ad-hoc.
+        adhocSpan(name, new Date().toISOString(), attrs);
+    }
+    function openExternalCallSpan(rec) {
+        const span = tracer.startSpan(`${prefix}external ${rec.call}`, {
+            startTime: new Date(rec.ts),
+            attributes: {
+                "nwire.external.call": rec.call,
+                "nwire.external.target": rec.target,
+                ...(rec.idempotencyKey
+                    ? { "nwire.external.idempotency_key": rec.idempotencyKey }
+                    : {}),
+                ...(rec.envelope ? envelopeAttrs(rec.envelope) : {}),
+                "nwire.app": rec.appName,
+            },
+        });
+        // Key by call + correlation; multiple concurrent calls with same name
+        // would collide, so include messageId if available.
+        const key = externalCallKey(rec.call, rec.envelope?.messageId);
+        externalCallSpans.set(key, { span, startedAt: Date.now() });
+    }
+    function closeExternalCallSpan(rec, status, msg, attrs) {
+        const key = externalCallKey(rec.call, rec.envelope?.messageId);
+        const open = externalCallSpans.get(key);
+        if (!open) {
+            adhocSpan(`${prefix}external.orphan ${rec.call}`, rec.ts, {
+                "nwire.orphan": true,
+                "nwire.external.call": rec.call,
+                "nwire.external.target": rec.target,
+                ...attrs,
+            });
+            return;
+        }
+        externalCallSpans.delete(key);
+        setAttrs(open.span, attrs);
+        open.span.setStatus({ code: status, message: msg });
+        open.span.end(new Date(rec.ts));
+    }
+    function externalCallKey(call, messageId) {
+        return `${call}::${messageId ?? "no-envelope"}`;
+    }
+    function adhocSpan(name, ts, attrs) {
+        const startTime = new Date(ts);
+        const span = tracer.startSpan(name.startsWith(prefix) ? name : `${prefix}${name}`, {
+            startTime,
+            attributes: attrs,
+        });
+        span.end(startTime);
+    }
+    return () => {
+        unsubscribe();
+        // Close any still-open spans so the exporter flushes them.
+        for (const { span } of actionSpans.values()) {
+            span.addEvent("nwire.unsubscribed");
+            span.end();
+        }
+        for (const { span } of externalCallSpans.values()) {
+            span.addEvent("nwire.unsubscribed");
+            span.end();
+        }
+        actionSpans.clear();
+        externalCallSpans.clear();
+    };
+}
+function envelopeAttrs(envelope) {
+    return {
+        "nwire.message_id": envelope.messageId,
+        "nwire.correlation_id": envelope.correlationId,
+        "nwire.causation_id": envelope.causationId,
+        ...(envelope.tenant ? { "nwire.tenant": envelope.tenant } : {}),
+        ...(envelope.userId ? { "nwire.user_id": envelope.userId } : {}),
+    };
+}
+function errorAttrs(err) {
+    return {
+        "nwire.error.name": err.name,
+        "nwire.error.message": err.message,
+        ...(err.stack ? { "nwire.error.stack": err.stack } : {}),
+    };
+}
+function setAttrs(span, attrs) {
+    if (span.setAttributes) {
+        span.setAttributes(attrs);
+        return;
+    }
+    for (const [k, v] of Object.entries(attrs)) {
+        if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+            span.setAttribute(k, v);
+        }
+    }
+}
+//# sourceMappingURL=exporter.js.map

package/dist/exporter.js.map

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

package/dist/otel-types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Minimal duck-typed surface of `@opentelemetry/api`'s Tracer + Span. We
+ * never import the package — consumers bring their own version and pass a
+ * `Tracer` in. This keeps `@nwire/telemetry-otel` zero-dep at runtime
+ * (only `@nwire/forge` for the Telemetry type).
+ *
+ * The fields are the subset we actually use. If a consumer passes a real
+ * `@opentelemetry/api` Tracer, structural typing makes it compatible.
+ */
+export type SpanKind = 0 | 1 | 2 | 3 | 4 | 5;
+export type SpanStatusCode = 0 | 1 | 2;
+export interface SpanContext {
+    traceId: string;
+    spanId: string;
+}
+export interface OtelSpan {
+    spanContext?(): SpanContext;
+    setAttribute(key: string, value: string | number | boolean): OtelSpan | void;
+    setAttributes?(attrs: Record<string, unknown>): OtelSpan | void;
+    addEvent(name: string, attrs?: Record<string, unknown>, timestamp?: number | Date): OtelSpan | void;
+    recordException(err: unknown): OtelSpan | void;
+    setStatus(status: {
+        code: SpanStatusCode;
+        message?: string;
+    }): OtelSpan | void;
+    end(endTime?: number | Date): void;
+}
+export interface OtelTracer {
+    startSpan(name: string, options?: {
+        attributes?: Record<string, unknown>;
+        kind?: SpanKind;
+        startTime?: number | Date;
+    }): OtelSpan;
+}
+//# sourceMappingURL=otel-types.d.ts.map

package/dist/otel-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-types.d.ts","sourceRoot":"","sources":["../src/otel-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,IAAI,WAAW,CAAC;IAC5B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC7E,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IAChE,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,QAAQ,GAAG,IAAI,CAAC;IACnB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/E,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GACA,QAAQ,CAAC;CACb"}

package/dist/otel-types.js

@@ -0,0 +1,11 @@
+/**
+ * Minimal duck-typed surface of `@opentelemetry/api`'s Tracer + Span. We
+ * never import the package — consumers bring their own version and pass a
+ * `Tracer` in. This keeps `@nwire/telemetry-otel` zero-dep at runtime
+ * (only `@nwire/forge` for the Telemetry type).
+ *
+ * The fields are the subset we actually use. If a consumer passes a real
+ * `@opentelemetry/api` Tracer, structural typing makes it compatible.
+ */
+export {};
+//# sourceMappingURL=otel-types.js.map

package/dist/otel-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-types.js","sourceRoot":"","sources":["../src/otel-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/telemetry-otel.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@nwire/telemetry-otel` — OpenTelemetry bridge for the canonical Nwire
+ * telemetry stream. Subscribes to `runtime.onTelemetry` and translates
+ * every record into OTel spans + events.
+ *
+ *   import { trace } from "@opentelemetry/api";
+ *   import { attachOtelExporter } from "@nwire/telemetry-otel";
+ *
+ *   const detach = attachOtelExporter(app.runtime, {
+ *     tracer: trace.getTracer("amit"),
+ *   });
+ *
+ * Pairs cleanly with Vector → GreptimeDB (and any other OTLP backend —
+ * Datadog, Honeycomb, Tempo, Jaeger).
+ */
+export { attachOtelExporter, type AttachOtelExporterOptions } from "./exporter";
+export type { OtelTracer, OtelSpan, SpanContext, SpanKind, SpanStatusCode } from "./otel-types";
+//# sourceMappingURL=telemetry-otel.d.ts.map

package/dist/telemetry-otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-otel.d.ts","sourceRoot":"","sources":["../src/telemetry-otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/telemetry-otel.js

@@ -0,0 +1,17 @@
+/**
+ * `@nwire/telemetry-otel` — OpenTelemetry bridge for the canonical Nwire
+ * telemetry stream. Subscribes to `runtime.onTelemetry` and translates
+ * every record into OTel spans + events.
+ *
+ *   import { trace } from "@opentelemetry/api";
+ *   import { attachOtelExporter } from "@nwire/telemetry-otel";
+ *
+ *   const detach = attachOtelExporter(app.runtime, {
+ *     tracer: trace.getTracer("amit"),
+ *   });
+ *
+ * Pairs cleanly with Vector → GreptimeDB (and any other OTLP backend —
+ * Datadog, Honeycomb, Tempo, Jaeger).
+ */
+export { attachOtelExporter } from "./exporter";
+//# sourceMappingURL=telemetry-otel.js.map

package/dist/telemetry-otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-otel.js","sourceRoot":"","sources":["../src/telemetry-otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,kBAAkB,EAAkC,MAAM,YAAY,CAAC"}