@superblocksteam/telemetry 2.0.105-next.0 → 2.0.105-next.1

package/dist/browser/traced-socket.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Browser-side TracedSocket for WebSocket tracing.
+ *
+ * Wraps a WebSocket client (or any WebSocket-like object) and adds
+ * OpenTelemetry tracing. Designed to speak the same envelope protocol as the
+ * server-side TracedSocket so that distributed traces link correctly across
+ * the browser–server boundary.
+ *
+ * Envelope format (matches @superblocksteam/shared SocketRequest):
+ *   outbound: { request: { method, id, traceparent?, tracestate?, ... } }
+ *   inbound:  { request: { method, id, traceparent?, tracestate?, ... } }
+ *             { response: { id, ... } }
+ *
+ * Propagation uses the W3C Trace Context propagator registered globally by
+ * initBrowserTelemetry() (see browser/init.ts). The carrier is the
+ * `request` object itself — the same convention as the server side.
+ */
+import { type Tracer } from "@opentelemetry/api";
+import type { SocketMessageEnvelope } from "../common/traced-socket-types.js";
+/** Minimal browser WebSocket surface needed by BrowserTracedSocket. */
+export interface WebSocketLike {
+    readonly readyState: number;
+    close(code?: number, reason?: string): void;
+    send(data: string | ArrayBuffer): void;
+    addEventListener(type: string, listener: (event: unknown) => void): void;
+    removeEventListener(type: string, listener: (event: unknown) => void): void;
+}
+/** Configuration for BrowserTracedSocket. */
+export interface BrowserTracedSocketConfig {
+    /**
+     * Tracer instance. When omitted the global tracer named
+     * "superblocks-ws" is used (requires initBrowserTelemetry() first).
+     */
+    tracer?: Tracer;
+}
+/**
+ * BrowserTracedSocket wraps a WebSocket and provides:
+ *
+ * 1. `decorateOutbound(msg)` — call this before sending any message.
+ *    Injects traceparent/tracestate into msg.request so the server can
+ *    extract the browser's active context.
+ *
+ * 2. `traceOutboundCall(method)` — wraps a client-initiated RPC call in a
+ *    CLIENT span.  Returns the span's end function.
+ *
+ * 3. `handleInbound(msg)` — call this when a message arrives from the server.
+ *    Extracts the server's trace context and creates a SERVER span so that
+ *    server-initiated pushes appear in the browser's trace.
+ *
+ * 4. `recordReconnect({ attempt })` — call this from the reconnect loop to
+ *    create a ws.reconnect span.
+ *
+ * Lifecycle spans (ws.connect, ws.disconnect) are attached automatically via
+ * WebSocket open/close event listeners.
+ */
+export declare class BrowserTracedSocket {
+    private readonly ws;
+    private readonly tracer;
+    private connectStartTime;
+    constructor(ws: WebSocketLike, config: BrowserTracedSocketConfig);
+    private readonly onOpen;
+    private readonly onClose;
+    /**
+     * Records a ws.reconnect span.  Call this from the reconnect loop just
+     * before opening a new WebSocket, passing the attempt counter so it shows
+     * up as a span attribute.
+     */
+    recordReconnect({ attempt }: {
+        attempt: number;
+    }): void;
+    /**
+     * Injects W3C trace context into the message's request envelope.
+     * Call this on every outbound message before handing it to the transport.
+     *
+     * Mirrors the server-side TracedSocket.decorateToSend() behaviour so that
+     * the server can extract the browser's active context via propagation.extract.
+     */
+    decorateOutbound(message: SocketMessageEnvelope): SocketMessageEnvelope;
+    /**
+     * Creates a CLIENT span for a browser-initiated RPC call.
+     * Returns the span so the caller can end it after the response resolves.
+     *
+     * Usage:
+     * ```typescript
+     * const span = socket.traceOutboundCall("editor.runApi");
+     * const result = await socket.request("editor.runApi", params);
+     * span.end();
+     * ```
+     */
+    traceOutboundCall(method: string): import("@opentelemetry/api").Span;
+    /**
+     * Handles an inbound message from the server.
+     * - Extracts the server's trace context from the request envelope.
+     * - Creates a SERVER span as a child of the server's trace so that
+     *   server-initiated pushes appear in the browser's distributed trace.
+     * - Response-only messages (no request field) are ignored.
+     */
+    handleInbound(message: SocketMessageEnvelope): void;
+    /** Remove lifecycle listeners. Call when tearing down the socket. */
+    dispose(): void;
+}
+//# sourceMappingURL=traced-socket.d.ts.map

package/dist/browser/traced-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-socket.d.ts","sourceRoot":"","sources":["../../src/browser/traced-socket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAML,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACvC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7E;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAK5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAJrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAqB;gBAG1B,EAAE,EAAE,aAAa,EAClC,MAAM,EAAE,yBAAyB;IAYnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAoBrB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAmBtB;IAEF;;;;OAIG;IACI,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoB9D;;;;;;OAMG;IACI,gBAAgB,CACrB,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB;IAexB;;;;;;;;;;OAUG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM;IAkBvC;;;;;;OAMG;IACI,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAgC1D,qEAAqE;IAC9D,OAAO,IAAI,IAAI;CAIvB"}

package/dist/browser/traced-socket.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Browser-side TracedSocket for WebSocket tracing.
+ *
+ * Wraps a WebSocket client (or any WebSocket-like object) and adds
+ * OpenTelemetry tracing. Designed to speak the same envelope protocol as the
+ * server-side TracedSocket so that distributed traces link correctly across
+ * the browser–server boundary.
+ *
+ * Envelope format (matches @superblocksteam/shared SocketRequest):
+ *   outbound: { request: { method, id, traceparent?, tracestate?, ... } }
+ *   inbound:  { request: { method, id, traceparent?, tracestate?, ... } }
+ *             { response: { id, ... } }
+ *
+ * Propagation uses the W3C Trace Context propagator registered globally by
+ * initBrowserTelemetry() (see browser/init.ts). The carrier is the
+ * `request` object itself — the same convention as the server side.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserTracedSocket = void 0;
+const api_1 = require("@opentelemetry/api");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const MESSAGING_ATTRS = {
+    [semantic_conventions_1.SEMATTRS_MESSAGING_SYSTEM]: "ws",
+    [semantic_conventions_1.SEMATTRS_MESSAGING_DESTINATION_KIND]: "websocket",
+};
+/**
+ * BrowserTracedSocket wraps a WebSocket and provides:
+ *
+ * 1. `decorateOutbound(msg)` — call this before sending any message.
+ *    Injects traceparent/tracestate into msg.request so the server can
+ *    extract the browser's active context.
+ *
+ * 2. `traceOutboundCall(method)` — wraps a client-initiated RPC call in a
+ *    CLIENT span.  Returns the span's end function.
+ *
+ * 3. `handleInbound(msg)` — call this when a message arrives from the server.
+ *    Extracts the server's trace context and creates a SERVER span so that
+ *    server-initiated pushes appear in the browser's trace.
+ *
+ * 4. `recordReconnect({ attempt })` — call this from the reconnect loop to
+ *    create a ws.reconnect span.
+ *
+ * Lifecycle spans (ws.connect, ws.disconnect) are attached automatically via
+ * WebSocket open/close event listeners.
+ */
+class BrowserTracedSocket {
+    ws;
+    tracer;
+    connectStartTime;
+    constructor(ws, config) {
+        this.ws = ws;
+        this.tracer = config.tracer ?? api_1.trace.getTracer("superblocks-ws", "0.0.0");
+        this.ws.addEventListener("open", this.onOpen);
+        this.ws.addEventListener("close", this.onClose);
+    }
+    // ------------------------------------------------------------------
+    // Lifecycle handlers
+    // ------------------------------------------------------------------
+    onOpen = (_event) => {
+        const durationMs = this.connectStartTime
+            ? Date.now() - this.connectStartTime
+            : undefined;
+        this.tracer.startActiveSpan("ws.connect", {
+            kind: api_1.SpanKind.CLIENT,
+            attributes: {
+                ...MESSAGING_ATTRS,
+                ...(durationMs !== undefined
+                    ? { "ws.connect_duration_ms": durationMs }
+                    : {}),
+            },
+        }, (span) => {
+            span.end();
+        });
+    };
+    onClose = (event) => {
+        const ev = event;
+        const code = ev.code ?? 1000;
+        const reason = ev.reason ?? "";
+        this.tracer.startActiveSpan("ws.disconnect", {
+            kind: api_1.SpanKind.CLIENT,
+            attributes: {
+                ...MESSAGING_ATTRS,
+                "ws.close_code": code,
+                "ws.close_reason": reason,
+            },
+        }, (span) => {
+            span.end();
+        });
+    };
+    /**
+     * Records a ws.reconnect span.  Call this from the reconnect loop just
+     * before opening a new WebSocket, passing the attempt counter so it shows
+     * up as a span attribute.
+     */
+    recordReconnect({ attempt }) {
+        this.tracer.startActiveSpan("ws.reconnect", {
+            kind: api_1.SpanKind.CLIENT,
+            attributes: {
+                ...MESSAGING_ATTRS,
+                "ws.reconnect_attempt": attempt,
+            },
+        }, (span) => {
+            span.end();
+        });
+    }
+    // ------------------------------------------------------------------
+    // Outbound
+    // ------------------------------------------------------------------
+    /**
+     * Injects W3C trace context into the message's request envelope.
+     * Call this on every outbound message before handing it to the transport.
+     *
+     * Mirrors the server-side TracedSocket.decorateToSend() behaviour so that
+     * the server can extract the browser's active context via propagation.extract.
+     */
+    decorateOutbound(message) {
+        if (!message.request) {
+            return message;
+        }
+        // Skip if already injected (e.g. manual traceparent for testing)
+        if (message.request.traceparent || message.request.tracestate) {
+            return message;
+        }
+        api_1.propagation.inject(api_1.context.active(), message.request);
+        return message;
+    }
+    /**
+     * Creates a CLIENT span for a browser-initiated RPC call.
+     * Returns the span so the caller can end it after the response resolves.
+     *
+     * Usage:
+     * ```typescript
+     * const span = socket.traceOutboundCall("editor.runApi");
+     * const result = await socket.request("editor.runApi", params);
+     * span.end();
+     * ```
+     */
+    traceOutboundCall(method) {
+        return this.tracer.startActiveSpan(`WS CLIENT ${method}`, {
+            kind: api_1.SpanKind.CLIENT,
+            attributes: {
+                ...MESSAGING_ATTRS,
+                "ws.method": method,
+            },
+        }, (span) => span);
+    }
+    // ------------------------------------------------------------------
+    // Inbound
+    // ------------------------------------------------------------------
+    /**
+     * Handles an inbound message from the server.
+     * - Extracts the server's trace context from the request envelope.
+     * - Creates a SERVER span as a child of the server's trace so that
+     *   server-initiated pushes appear in the browser's distributed trace.
+     * - Response-only messages (no request field) are ignored.
+     */
+    handleInbound(message) {
+        if (!message.request) {
+            return;
+        }
+        const method = message.request.method ?? "unknown";
+        const parentCtx = api_1.propagation.extract(api_1.ROOT_CONTEXT, message.request);
+        api_1.context.with(parentCtx, () => {
+            this.tracer.startActiveSpan(`WS SERVER ${method}`, {
+                kind: api_1.SpanKind.CLIENT,
+                attributes: {
+                    ...MESSAGING_ATTRS,
+                    "ws.method": method,
+                },
+            }, (span) => {
+                span.end();
+            });
+        });
+    }
+    // ------------------------------------------------------------------
+    // Cleanup
+    // ------------------------------------------------------------------
+    /** Remove lifecycle listeners. Call when tearing down the socket. */
+    dispose() {
+        this.ws.removeEventListener("open", this.onOpen);
+        this.ws.removeEventListener("close", this.onClose);
+    }
+}
+exports.BrowserTracedSocket = BrowserTracedSocket;
+//# sourceMappingURL=traced-socket.js.map

package/dist/browser/traced-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-socket.js","sourceRoot":"","sources":["../../src/browser/traced-socket.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,4CAO4B;AAC5B,8EAG6C;AAsB7C,MAAM,eAAe,GAAG;IACtB,CAAC,gDAAyB,CAAC,EAAE,IAAI;IACjC,CAAC,0DAAmC,CAAC,EAAE,WAAW;CAC1C,CAAC;AAEX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,mBAAmB;IAKX;IAJF,MAAM,CAAS;IACxB,gBAAgB,CAAqB;IAE7C,YACmB,EAAiB,EAClC,MAAiC;QADhB,OAAE,GAAF,EAAE,CAAe;QAGlC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,WAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAE1E,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,qEAAqE;IACrE,qBAAqB;IACrB,qEAAqE;IAEpD,MAAM,GAAG,CAAC,MAAe,EAAQ,EAAE;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB;YACtC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,gBAAgB;YACpC,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,CAAC,MAAM,CAAC,eAAe,CACzB,YAAY,EACZ;YACE,IAAI,EAAE,cAAQ,CAAC,MAAM;YACrB,UAAU,EAAE;gBACV,GAAG,eAAe;gBAClB,GAAG,CAAC,UAAU,KAAK,SAAS;oBAC1B,CAAC,CAAC,EAAE,wBAAwB,EAAE,UAAU,EAAE;oBAC1C,CAAC,CAAC,EAAE,CAAC;aACR;SACF,EACD,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;IAEe,OAAO,GAAG,CAAC,KAAc,EAAQ,EAAE;QAClD,MAAM,EAAE,GAAG,KAA2C,CAAC;QACvD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC;QAC7B,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;QAE/B,IAAI,CAAC,MAAM,CAAC,eAAe,CACzB,eAAe,EACf;YACE,IAAI,EAAE,cAAQ,CAAC,MAAM;YACrB,UAAU,EAAE;gBACV,GAAG,eAAe;gBAClB,eAAe,EAAE,IAAI;gBACrB,iBAAiB,EAAE,MAAM;aAC1B;SACF,EACD,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;IAEF;;;;OAIG;IACI,eAAe,CAAC,EAAE,OAAO,EAAuB;QACrD,IAAI,CAAC,MAAM,CAAC,eAAe,CACzB,cAAc,EACd;YACE,IAAI,EAAE,cAAQ,CAAC,MAAM;YACrB,UAAU,EAAE;gBACV,GAAG,eAAe;gBAClB,sBAAsB,EAAE,OAAO;aAChC;SACF,EACD,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC,CACF,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,WAAW;IACX,qEAAqE;IAErE;;;;;;OAMG;IACI,gBAAgB,CACrB,OAA8B;QAE9B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,iEAAiE;QACjE,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC9D,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,iBAAW,CAAC,MAAM,CAChB,aAAO,CAAC,MAAM,EAAE,EAChB,OAAO,CAAC,OAA6C,CACtD,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;;;OAUG;IACI,iBAAiB,CAAC,MAAc;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAChC,aAAa,MAAM,EAAE,EACrB;YACE,IAAI,EAAE,cAAQ,CAAC,MAAM;YACrB,UAAU,EAAE;gBACV,GAAG,eAAe;gBAClB,WAAW,EAAE,MAAM;aACpB;SACF,EACD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CACf,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,UAAU;IACV,qEAAqE;IAErE;;;;;;OAMG;IACI,aAAa,CAAC,OAA8B;QACjD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;QACnD,MAAM,SAAS,GAAG,iBAAW,CAAC,OAAO,CACnC,kBAAY,EACZ,OAAO,CAAC,OAA4C,CACrD,CAAC;QAEF,aAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,MAAM,CAAC,eAAe,CACzB,aAAa,MAAM,EAAE,EACrB;gBACE,IAAI,EAAE,cAAQ,CAAC,MAAM;gBACrB,UAAU,EAAE;oBACV,GAAG,eAAe;oBAClB,WAAW,EAAE,MAAM;iBACpB;aACF,EACD,CAAC,IAAI,EAAE,EAAE;gBACP,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IACrE,UAAU;IACV,qEAAqE;IAErE,qEAAqE;IAC9D,OAAO;QACZ,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF;AAvLD,kDAuLC"}

package/dist/common/index.d.ts

@@ -7,6 +7,7 @@
  * in the tiered telemetry architecture. See obs/otel-collector/config-tiered.yaml.
  */
 export * from "./deployment-type.js";
+export * from "./traced-socket-types.js";
 export * from "./resource.js";
 export * from "./policy-evaluator.js";
 export * from "./guardrails.js";

package/dist/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/common/index.js

@@ -23,6 +23,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./deployment-type.js"), exports);
+__exportStar(require("./traced-socket-types.js"), exports);
 __exportStar(require("./resource.js"), exports);
 __exportStar(require("./policy-evaluator.js"), exports);
 __exportStar(require("./guardrails.js"), exports);

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,gDAA8B;AAC9B,wDAAsC;AACtC,kDAAgC;AAChC,8DAA4C;AAC5C,qDAAmC;AACnC,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,2DAAyC;AACzC,gDAA8B;AAC9B,wDAAsC;AACtC,kDAAgC;AAChC,8DAA4C;AAC5C,qDAAmC;AACnC,kDAAgC"}

package/dist/common/traced-socket-types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared TracedSocket types for WebSocket message envelopes.
+ *
+ * Both the browser (TracedSocket in telemetry/browser) and the server
+ * (TracedSocket in telemetry/node) inject and extract trace context using
+ * these field names. Keeping them in one place ensures the two sides speak
+ * the same envelope protocol so traces link correctly end-to-end.
+ *
+ * Envelope structure mirrors @superblocksteam/shared SocketRequest:
+ *   { request?: { method, payload, id, traceparent?, tracestate?, ... } }
+ *
+ * The W3C Trace Context propagator writes/reads exactly these two fields.
+ * See: https://www.w3.org/TR/trace-context/
+ */
+/**
+ * W3C Trace Context fields that live inside a socket message's request object.
+ * The propagator uses these as the carrier for context injection/extraction.
+ */
+export interface SocketTraceContext {
+    traceparent?: string;
+    tracestate?: string;
+}
+/**
+ * Minimal shape of the request portion of a socket message envelope.
+ * Both browser and server code passes this object as the propagation carrier.
+ */
+export interface SocketRequestEnvelope extends SocketTraceContext {
+    method?: string;
+    id?: number;
+    [key: string]: unknown;
+}
+/**
+ * Minimal shape of the full socket message envelope.
+ * Request messages carry trace context; response messages do not.
+ */
+export interface SocketMessageEnvelope {
+    request?: SocketRequestEnvelope;
+    response?: {
+        id?: number;
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=traced-socket-types.d.ts.map

package/dist/common/traced-socket-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-socket-types.d.ts","sourceRoot":"","sources":["../../src/common/traced-socket-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE;QACT,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}

package/dist/common/traced-socket-types.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Shared TracedSocket types for WebSocket message envelopes.
+ *
+ * Both the browser (TracedSocket in telemetry/browser) and the server
+ * (TracedSocket in telemetry/node) inject and extract trace context using
+ * these field names. Keeping them in one place ensures the two sides speak
+ * the same envelope protocol so traces link correctly end-to-end.
+ *
+ * Envelope structure mirrors @superblocksteam/shared SocketRequest:
+ *   { request?: { method, payload, id, traceparent?, tracestate?, ... } }
+ *
+ * The W3C Trace Context propagator writes/reads exactly these two fields.
+ * See: https://www.w3.org/TR/trace-context/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=traced-socket-types.js.map

package/dist/common/traced-socket-types.js.map

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

package/dist/types/index.d.ts

@@ -61,7 +61,11 @@ export interface NodeTelemetryConfig extends BaseTelemetryConfig {
  * Browser specific telemetry configuration.
  */
 export interface BrowserTelemetryConfig extends BaseTelemetryConfig {
-    /** OTLP traces endpoint URL */
+    /** OTLP base URL (e.g. "http://localhost:4318"). Signal-specific paths (/v1/traces, /v1/metrics, /v1/logs) are appended automatically. */
     otlpUrl: string;
+    /** URL patterns to inject traceparent header into (for cross-origin propagation) */
+    propagateTraceUrls?: RegExp[];
+    /** URL patterns to skip instrumenting entirely */
+    ignoreUrls?: RegExp[];
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IAEvB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAE7B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAE3D;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IAEvB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAE7B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAE3D;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,0IAA0I;IAC1I,OAAO,EAAE,MAAM,CAAC;IAEhB,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE9B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}

package/dist-esm/browser/console-logging.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Console Log Attributes
+ *
+ * Used to attach structured key-value metadata to console.* calls so the
+ * EarlyConsoleBuffer (and the live OTel patch) can forward them as OTEL log
+ * record attributes.
+ *
+ * Usage:
+ *   import { consoleLogAttributes } from '@superblocksteam/telemetry/browser';
+ *   console.info("user loaded", consoleLogAttributes({ userId: "abc123" }));
+ */
+export declare class ConsoleLogAttributes {
+    readonly attributes: Record<string, unknown>;
+    constructor(attributes: Record<string, unknown>);
+    static create(attrs: Record<string, unknown>): ConsoleLogAttributes;
+}
+export declare const consoleLogAttributes: (attrs: Record<string, unknown>) => ConsoleLogAttributes;
+//# sourceMappingURL=console-logging.d.ts.map

package/dist-esm/browser/console-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logging.d.ts","sourceRoot":"","sources":["../../src/browser/console-logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,qBAAa,oBAAoB;aACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAAnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE/D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB;CAGpE;AAGD,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,oBAEF,CAAC"}

package/dist-esm/browser/console-logging.js

@@ -0,0 +1,27 @@
+/**
+ * Console Log Attributes
+ *
+ * Used to attach structured key-value metadata to console.* calls so the
+ * EarlyConsoleBuffer (and the live OTel patch) can forward them as OTEL log
+ * record attributes.
+ *
+ * Usage:
+ *   import { consoleLogAttributes } from '@superblocksteam/telemetry/browser';
+ *   console.info("user loaded", consoleLogAttributes({ userId: "abc123" }));
+ */
+// The attributes that should be passed to OTEL logs as part of the message context.
+// To use, create an instance of this class and pass it as an argument to console.* methods.
+export class ConsoleLogAttributes {
+    attributes;
+    constructor(attributes) {
+        this.attributes = attributes;
+    }
+    static create(attrs) {
+        return new ConsoleLogAttributes(attrs);
+    }
+}
+// Convenience factory
+export const consoleLogAttributes = (attrs) => {
+    return new ConsoleLogAttributes(attrs);
+};
+//# sourceMappingURL=console-logging.js.map

package/dist-esm/browser/console-logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logging.js","sourceRoot":"","sources":["../../src/browser/console-logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oFAAoF;AACpF,4FAA4F;AAC5F,MAAM,OAAO,oBAAoB;IACH;IAA5B,YAA4B,UAAmC;QAAnC,eAAU,GAAV,UAAU,CAAyB;IAAG,CAAC;IAEnE,MAAM,CAAC,MAAM,CAAC,KAA8B;QAC1C,OAAO,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED,sBAAsB;AACtB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAA8B,EACR,EAAE;IACxB,OAAO,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/dist-esm/browser/early-console-buffer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Early Console Buffer
+ *
+ * Patches console.log/info/debug/warn/error as early as possible (before OTel
+ * initialises) to capture logs in a ring buffer. On OTel init, the buffer is
+ * flushed to the OTel Logger and all subsequent console calls are forwarded
+ * directly.
+ *
+ * IMPORTANT: Each patched method ALWAYS calls through to the original console
+ * method first, so downstream patchers (Datadog RUM, PostHog, etc.) that wrap
+ * console after us continue to receive every call.
+ */
+import { type Logger } from "@opentelemetry/api-logs";
+declare class EarlyConsoleBuffer {
+    private static instance;
+    private buffer;
+    private maxBufferSize;
+    private originalMethods;
+    private otelLogger;
+    private isPatched;
+    static getInstance(): EarlyConsoleBuffer;
+    /**
+     * Patch console methods immediately with buffering.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    patchEarly(): void;
+    private patchMethod;
+    private bufferLog;
+    /**
+     * Called once OTel is ready. Flushes buffered entries then routes all future
+     * console calls directly to the OTel logger.
+     */
+    enableOpenTelemetry(otelLogger: Logger): void;
+    private flushBuffer;
+    private sendToOpenTelemetry;
+    private formatConsoleArgs;
+}
+export default EarlyConsoleBuffer;
+//# sourceMappingURL=early-console-buffer.d.ts.map

package/dist-esm/browser/early-console-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"early-console-buffer.d.ts","sourceRoot":"","sources":["../../src/browser/early-console-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,yBAAyB,CAAC;AAuBtE,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAE5C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,aAAa,CAAQ;IAE7B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,SAAS,CAAS;IAE1B,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;;OAGG;IACH,UAAU,IAAI,IAAI;IA4BlB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,SAAS;IAOjB;;;OAGG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM7C,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,iBAAiB;CAkB1B;AAED,eAAe,kBAAkB,CAAC"}