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

package/dist-esm/browser/early-console-buffer.js

@@ -0,0 +1,155 @@
+/**
+ * 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 { SeverityNumber } from "@opentelemetry/api-logs";
+import { ConsoleLogAttributes } from "./console-logging.js";
+function mergeAllConsoleLogAttributes(args) {
+    if (args.length === 0)
+        return undefined;
+    return args.reduce((merged, arg) => {
+        if (arg instanceof ConsoleLogAttributes) {
+            return { ...merged, ...arg.attributes };
+        }
+        return merged;
+    }, {});
+}
+class EarlyConsoleBuffer {
+    static instance;
+    buffer = [];
+    maxBufferSize = 1000;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    originalMethods = {};
+    otelLogger = undefined;
+    isPatched = false;
+    static getInstance() {
+        if (!EarlyConsoleBuffer.instance) {
+            EarlyConsoleBuffer.instance = new EarlyConsoleBuffer();
+        }
+        return EarlyConsoleBuffer.instance;
+    }
+    /**
+     * Patch console methods immediately with buffering.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    patchEarly() {
+        if (this.isPatched)
+            return;
+        // Capture current console methods (which may already be patched by Datadog
+        // RUM or PostHog). We keep calling through to whatever was here at the time
+        // patchEarly() was invoked.
+        // eslint-disable-next-line no-console
+        this.originalMethods.log = console.log.bind(console);
+        this.originalMethods.info = console.info.bind(console);
+        this.originalMethods.debug = console.debug.bind(console);
+        this.originalMethods.warn = console.warn.bind(console);
+        this.originalMethods.error = console.error.bind(console);
+        this.patchMethod("log");
+        this.patchMethod("info");
+        this.patchMethod("debug");
+        this.patchMethod("warn");
+        this.patchMethod("error");
+        this.isPatched = true;
+        // Announce via original info to avoid touching the newly patched method
+        // (which would buffer this diagnostic message unnecessarily).
+        this.originalMethods.info("[EarlyConsoleBuffer] Console patching enabled — buffering logs until OpenTelemetry initializes");
+    }
+    patchMethod(level) {
+        const originalMethod = this.originalMethods[level];
+        console[level] = (...args) => {
+            // ALWAYS call through to the original first so downstream patchers work.
+            originalMethod(...args);
+            // Route to OTel or buffer depending on initialization state.
+            if (this.otelLogger) {
+                this.sendToOpenTelemetry(level, args);
+            }
+            else {
+                this.bufferLog(level, args);
+            }
+        };
+    }
+    bufferLog(level, args) {
+        if (this.buffer.length >= this.maxBufferSize) {
+            this.buffer.shift(); // drop oldest entry
+        }
+        this.buffer.push({ level, args, timestamp: Date.now() });
+    }
+    /**
+     * Called once OTel is ready. Flushes buffered entries then routes all future
+     * console calls directly to the OTel logger.
+     */
+    enableOpenTelemetry(otelLogger) {
+        console.info("[EarlyConsoleBuffer] Enabling OpenTelemetry integration");
+        this.otelLogger = otelLogger;
+        this.flushBuffer();
+    }
+    flushBuffer() {
+        if (!this.otelLogger)
+            return;
+        const count = this.buffer.length;
+        if (count === 0) {
+            console.info("[EarlyConsoleBuffer] No buffered logs to flush");
+            return;
+        }
+        console.info(`[EarlyConsoleBuffer] Flushing ${count} buffered logs to OpenTelemetry`);
+        for (const entry of this.buffer) {
+            this.sendToOpenTelemetry(entry.level, entry.args, entry.timestamp, true);
+        }
+        this.buffer = [];
+        console.info(`[EarlyConsoleBuffer] Successfully sent ${count} buffered logs to OpenTelemetry logger`);
+    }
+    sendToOpenTelemetry(level, args, timestamp, fromBuffer) {
+        if (!this.otelLogger)
+            return;
+        const severityMap = {
+            debug: SeverityNumber.DEBUG,
+            log: SeverityNumber.INFO,
+            info: SeverityNumber.INFO,
+            warn: SeverityNumber.WARN,
+            error: SeverityNumber.ERROR,
+        };
+        const attributes = {
+            ...(fromBuffer ? { source: "early-console-buffer" } : {}),
+            ...mergeAllConsoleLogAttributes(args),
+        };
+        this.otelLogger.emit({
+            severityNumber: severityMap[level],
+            severityText: level,
+            body: this.formatConsoleArgs(args),
+            timestamp,
+            attributes: attributes,
+        });
+    }
+    formatConsoleArgs(args) {
+        return args
+            .filter((arg) => !(arg instanceof ConsoleLogAttributes))
+            .map((arg) => {
+            if (typeof arg === "string")
+                return arg;
+            if (arg === null)
+                return "null";
+            if (arg === undefined)
+                return "undefined";
+            if (typeof arg === "object") {
+                try {
+                    return JSON.stringify(arg, null, 2);
+                }
+                catch {
+                    return "[object Object]";
+                }
+            }
+            return String(arg);
+        })
+            .join(" ");
+    }
+}
+export default EarlyConsoleBuffer;
+//# sourceMappingURL=early-console-buffer.js.map

package/dist-esm/browser/early-console-buffer.js.map

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

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

@@ -4,5 +4,12 @@
  * This is the ONLY approved way to initialize telemetry in browser contexts.
  */
 export { initBrowserTelemetry, getBrowserTelemetryInstance, isBrowserTelemetryInitialized, resetBrowserTelemetry, getEnvironmentFromHostname, type BrowserTelemetryInstance, } from "./init.js";
+export { initBrowserLogs, resetBrowserLogs, type BrowserLogsConfig, type BrowserLogsInstance, } from "./logs.js";
+export { initBrowserMetrics, type BrowserMetricsConfig, type BrowserMetricsInstance, } from "./metrics.js";
+export { createSanitizingSpanProcessor, createSanitizingLogProcessor, type SanitizingConfig, } from "./sanitizer.js";
+export { createBrowserInstrumentations, registerBrowserContextManager, type BrowserInstrumentationConfig, } from "./instrumentations.js";
+export { ConsoleLogAttributes, consoleLogAttributes, } from "./console-logging.js";
+export { default as EarlyConsoleBuffer } from "./early-console-buffer.js";
 export { getDefaultPolicy, DeploymentType } from "../types/policy.js";
+export { BrowserTracedSocket, type BrowserTracedSocketConfig, type WebSocketLike, } from "./traced-socket.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC7B,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC7B,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,KAAK,4BAA4B,GAClC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC"}

package/dist-esm/browser/index.js

@@ -4,6 +4,13 @@
  * This is the ONLY approved way to initialize telemetry in browser contexts.
  */
 export { initBrowserTelemetry, getBrowserTelemetryInstance, isBrowserTelemetryInitialized, resetBrowserTelemetry, getEnvironmentFromHostname, } from "./init.js";
+export { initBrowserLogs, resetBrowserLogs, } from "./logs.js";
+export { initBrowserMetrics, } from "./metrics.js";
+export { createSanitizingSpanProcessor, createSanitizingLogProcessor, } from "./sanitizer.js";
+export { createBrowserInstrumentations, registerBrowserContextManager, } from "./instrumentations.js";
+export { ConsoleLogAttributes, consoleLogAttributes, } from "./console-logging.js";
+export { default as EarlyConsoleBuffer } from "./early-console-buffer.js";
 // Re-export policy utilities for convenience
 export { getDefaultPolicy, DeploymentType } from "../types/policy.js";
+export { BrowserTracedSocket, } from "./traced-socket.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC7B,qBAAqB,EACrB,0BAA0B,GAE3B,MAAM,WAAW,CAAC;AAEnB,6CAA6C;AAC7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC7B,qBAAqB,EACrB,0BAA0B,GAE3B,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,eAAe,EACf,gBAAgB,GAGjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,kBAAkB,GAGnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAE7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAE9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,6CAA6C;AAC7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EACL,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC"}

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

@@ -3,8 +3,14 @@
  *
  * This is the ONLY approved way to initialize telemetry in browser contexts.
  * Direct WebTracerProvider usage outside this package is prohibited.
+ *
+ * Composes all browser signals: traces, metrics, logs, sanitizers, and
+ * auto-instrumentations into a single init call.
  */
-import { Tracer } from "@opentelemetry/api";
+import { type Tracer } from "@opentelemetry/api";
+import type { Meter } from "@opentelemetry/api";
+import type { Logger } from "@opentelemetry/api-logs";
+import { type SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { WebTracerProvider } from "@opentelemetry/sdk-trace-web";
 import { TelemetryPolicyEvaluator } from "../common/policy-evaluator.js";
 import type { BrowserTelemetryConfig } from "../types/index.js";
@@ -19,6 +25,14 @@ export interface BrowserTelemetryInstance {
     policyEvaluator: TelemetryPolicyEvaluator;
     /** Get a tracer */
     getTracer: (name?: string) => Tracer;
+    /** Get a meter for recording metrics */
+    getMeter: (name?: string) => Meter;
+    /** Get a logger for emitting log records */
+    getLogger: (name?: string) => Logger;
+    /** Set attributes that are injected into every new span (dynamic context like org, user) */
+    setGlobalSpanAttributes: (attrs: Record<string, string>) => void;
+    /** Register an additional SpanProcessor on the provider (e.g. LocalStorageExporter) */
+    addSpanProcessor: (processor: SpanProcessor) => void;
     /** Graceful shutdown */
     shutdown: () => Promise<void>;
 }
@@ -28,7 +42,15 @@ export interface BrowserTelemetryInstance {
  * Browser telemetry is always sanitized (Tier 2) since it runs in untrusted context.
  * Full fidelity Tier 1 data should never be emitted from the browser.
  *
- * @param config - Browser configuration
+ * Composes:
+ * - Traces: WebTracerProvider with sanitizing + batch processors
+ * - Metrics: MeterProvider via initBrowserMetrics
+ * - Logs: LoggerProvider via initBrowserLogs (with EarlyConsoleBuffer)
+ * - Sanitizers: PII redaction for spans and logs
+ * - Instrumentations: XHR + Fetch auto-instrumentation
+ * - Context: StackContextManager for async context propagation
+ *
+ * @param config - Browser configuration (otlpUrl is treated as base URL)
  * @param policy - Telemetry policy (REQUIRED)
  * @returns Browser telemetry instance
  *
@@ -42,10 +64,12 @@ export interface BrowserTelemetryInstance {
  *   serviceName: 'superblocks-ui',
  *   serviceVersion: '1.0.0',
  *   environment: 'production',
- *   otlpUrl: 'https://app.superblocks.com/api/v1/traces',
+ *   otlpUrl: 'https://app.superblocks.com/api',
  * }, policy);
  *
  * const tracer = telemetry.getTracer();
+ * const meter = telemetry.getMeter();
+ * const logger = telemetry.getLogger();
  * ```
  */
 export declare function initBrowserTelemetry(config: BrowserTelemetryConfig, policy: TelemetryPolicy): BrowserTelemetryInstance;

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/browser/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,6CAA6C;IAC7C,eAAe,EAAE,wBAAwB,CAAC;IAC1C,mBAAmB;IACnB,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,eAAe,GACtB,wBAAwB,CAkE1B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,wBAAwB,CAOtE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWnE"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/browser/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAQtD,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAUpE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,6CAA6C;IAC7C,eAAe,EAAE,wBAAwB,CAAC;IAC1C,mBAAmB;IACnB,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,wCAAwC;IACxC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;IACnC,4CAA4C;IAC5C,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,4FAA4F;IAC5F,uBAAuB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACjE,uFAAuF;IACvF,gBAAgB,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IACrD,wBAAwB;IACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AA2GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,eAAe,GACtB,wBAAwB,CA4I1B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,wBAAwB,CAOtE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWnE"}

package/dist-esm/browser/init.js

@@ -3,16 +3,24 @@
  *
  * This is the ONLY approved way to initialize telemetry in browser contexts.
  * Direct WebTracerProvider usage outside this package is prohibited.
+ *
+ * Composes all browser signals: traces, metrics, logs, sanitizers, and
+ * auto-instrumentations into a single init call.
  */
-import { trace } from "@opentelemetry/api";
+import { context, metrics, trace } from "@opentelemetry/api";
 import { W3CTraceContextPropagator, W3CBaggagePropagator, CompositePropagator, } from "@opentelemetry/core";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { registerInstrumentations } from "@opentelemetry/instrumentation";
+import { BatchSpanProcessor, } from "@opentelemetry/sdk-trace-base";
 import { WebTracerProvider } from "@opentelemetry/sdk-trace-web";
 import { TelemetryPolicyEvaluator } from "../common/policy-evaluator.js";
 import { buildResource } from "../common/resource.js";
 import { TelemetryTier } from "../types/policy.js";
+import { createBrowserInstrumentations, registerBrowserContextManager, } from "./instrumentations.js";
+import { initBrowserLogs, resetBrowserLogs } from "./logs.js";
+import { initBrowserMetrics } from "./metrics.js";
 import { BrowserResilientExporter } from "./resilient-exporter.js";
+import { createSanitizingSpanProcessor } from "./sanitizer.js";
 // Singleton instance
 let instance;
 /**
@@ -41,13 +49,84 @@ function validateBrowserTelemetryConfig(config) {
         throw new Error(`[Telemetry] Invalid otlpUrl: ${config.otlpUrl} (${error.message})`);
     }
 }
+/**
+ * Strips trailing slash from a URL string.
+ */
+function normalizeBaseUrl(url) {
+    return url.replace(/\/+$/, "");
+}
+/**
+ * SpanProcessor that injects mutable global attributes into every span on start.
+ * Since OTel Resource is immutable, dynamic context (org ID, user ID, app ID)
+ * must be applied at the span level.
+ */
+class GlobalAttributeSpanProcessor {
+    attrs = {};
+    setAttributes(attrs) {
+        this.attrs = { ...attrs };
+    }
+    onStart(span, _parentContext) {
+        for (const [key, value] of Object.entries(this.attrs)) {
+            span.setAttribute(key, value);
+        }
+    }
+    onEnd(_span) { }
+    async shutdown() { }
+    async forceFlush() { }
+}
+/**
+ * Composite SpanProcessor that delegates to a mutable list of inner processors.
+ * In OTel SDK v2.x, `addSpanProcessor` was removed from BasicTracerProvider,
+ * so we wrap the processor list ourselves to support runtime additions
+ * (e.g. UI's LocalStorageExporter).
+ */
+class DynamicCompositeSpanProcessor {
+    processors = [];
+    add(processor) {
+        this.processors.push(processor);
+    }
+    onStart(span, parentContext) {
+        for (const p of this.processors) {
+            try {
+                p.onStart(span, parentContext);
+            }
+            catch (err) {
+                console.error("[Telemetry] SpanProcessor.onStart failed", err);
+            }
+        }
+    }
+    onEnd(span) {
+        for (const p of this.processors) {
+            try {
+                p.onEnd(span);
+            }
+            catch (err) {
+                console.error("[Telemetry] SpanProcessor.onEnd failed", err);
+            }
+        }
+    }
+    async shutdown() {
+        await Promise.all(this.processors.map((p) => p.shutdown()));
+    }
+    async forceFlush() {
+        await Promise.all(this.processors.map((p) => p.forceFlush()));
+    }
+}
 /**
  * Initialize browser telemetry with policy enforcement.
  *
  * Browser telemetry is always sanitized (Tier 2) since it runs in untrusted context.
  * Full fidelity Tier 1 data should never be emitted from the browser.
  *
- * @param config - Browser configuration
+ * Composes:
+ * - Traces: WebTracerProvider with sanitizing + batch processors
+ * - Metrics: MeterProvider via initBrowserMetrics
+ * - Logs: LoggerProvider via initBrowserLogs (with EarlyConsoleBuffer)
+ * - Sanitizers: PII redaction for spans and logs
+ * - Instrumentations: XHR + Fetch auto-instrumentation
+ * - Context: StackContextManager for async context propagation
+ *
+ * @param config - Browser configuration (otlpUrl is treated as base URL)
  * @param policy - Telemetry policy (REQUIRED)
  * @returns Browser telemetry instance
  *
@@ -61,10 +140,12 @@ function validateBrowserTelemetryConfig(config) {
  *   serviceName: 'superblocks-ui',
  *   serviceVersion: '1.0.0',
  *   environment: 'production',
- *   otlpUrl: 'https://app.superblocks.com/api/v1/traces',
+ *   otlpUrl: 'https://app.superblocks.com/api',
  * }, policy);
  *
  * const tracer = telemetry.getTracer();
+ * const meter = telemetry.getMeter();
+ * const logger = telemetry.getLogger();
  * ```
  */
 export function initBrowserTelemetry(config, policy) {
@@ -79,21 +160,31 @@ export function initBrowserTelemetry(config, policy) {
         console.warn("[Telemetry] Browser provider already initialized");
         return instance;
     }
+    const baseUrl = normalizeBaseUrl(config.otlpUrl);
+    // 1. Register StackContextManager for async context propagation
+    registerBrowserContextManager();
     const policyEvaluator = new TelemetryPolicyEvaluator(policy);
     const resource = buildResource(config);
-    // Build span processors based on policy
-    // Use isExportEnabled (not canExport) - sampling applies at runtime, not initialization
-    const spanProcessors = policyEvaluator.isExportEnabled(TelemetryTier.TIER_2_OPERATIONAL)
-        ? [
-            new BatchSpanProcessor(new BrowserResilientExporter({
-                delegate: new OTLPTraceExporter({ url: config.otlpUrl }),
-            })),
-        ]
-        : [];
-    // Create provider with span processors in constructor (OTEL v2.x API)
+    // 2. Build span processors: global attrs -> sanitizer -> batch exporter
+    //    Wrapped in a DynamicCompositeSpanProcessor so addSpanProcessor() works
+    //    at runtime (OTel SDK v2.x removed addSpanProcessor from the provider).
+    const globalAttrProcessor = new GlobalAttributeSpanProcessor();
+    const compositeProcessor = new DynamicCompositeSpanProcessor();
+    compositeProcessor.add(globalAttrProcessor);
+    // Add sanitizing processor (always on in browser)
+    compositeProcessor.add(createSanitizingSpanProcessor());
+    // Add batch exporter if policy allows export
+    if (policyEvaluator.isExportEnabled(TelemetryTier.TIER_2_OPERATIONAL)) {
+        compositeProcessor.add(new BatchSpanProcessor(new BrowserResilientExporter({
+            delegate: new OTLPTraceExporter({
+                url: `${baseUrl}/v1/traces`,
+            }),
+        })));
+    }
+    // Create provider with the composite processor (OTEL v2.x API)
     const provider = new WebTracerProvider({
         resource,
-        spanProcessors,
+        spanProcessors: [compositeProcessor],
     });
     // Register with composite propagator for W3C TraceContext and Baggage
     provider.register({
@@ -104,13 +195,66 @@ export function initBrowserTelemetry(config, policy) {
             ],
         }),
     });
-    console.debug(`[Telemetry] Browser tracing initialized for ${config.serviceName} (${policy.deploymentType})`);
+    // 3. Create auto-instrumentations (XHR + fetch)
+    const instrumentations = createBrowserInstrumentations({
+        propagateTraceUrls: config.propagateTraceUrls,
+        ignoreUrls: config.ignoreUrls,
+    });
+    registerInstrumentations({
+        instrumentations,
+        tracerProvider: provider,
+    });
+    // 4. Initialize metrics
+    let metricsInstance;
+    if (policyEvaluator.isExportEnabled(TelemetryTier.TIER_2_OPERATIONAL)) {
+        metricsInstance = initBrowserMetrics({
+            otlpUrl: `${baseUrl}/v1/metrics`,
+            serviceName: config.serviceName,
+        });
+    }
+    // 5. Initialize logs (with EarlyConsoleBuffer flush)
+    const logsInstance = policyEvaluator.isExportEnabled(TelemetryTier.TIER_2_OPERATIONAL)
+        ? initBrowserLogs({
+            otlpUrl: `${baseUrl}/v1/logs`,
+            serviceName: config.serviceName,
+        })
+        : undefined;
+    console.debug(`[Telemetry] Browser telemetry initialized for ${config.serviceName} (${policy.deploymentType}) — traces, metrics, logs`);
     instance = {
         provider,
         policyEvaluator,
         getTracer: (name) => trace.getTracer(name ?? config.serviceName, config.serviceVersion),
+        getMeter: (name) => {
+            if (metricsInstance) {
+                return metricsInstance.getMeter(name);
+            }
+            // Return a no-op meter from the global API when metrics are disabled
+            return metrics.getMeter(name ?? config.serviceName);
+        },
+        getLogger: (name) => {
+            if (logsInstance) {
+                return logsInstance.getLogger(name);
+            }
+            // Return a no-op logger when logs are disabled
+            return {
+                emit: () => { },
+            };
+        },
+        setGlobalSpanAttributes: (attrs) => {
+            globalAttrProcessor.setAttributes(attrs);
+        },
+        addSpanProcessor: (processor) => {
+            compositeProcessor.add(processor);
+        },
         shutdown: async () => {
             await provider.shutdown();
+            if (metricsInstance) {
+                await metricsInstance.shutdown();
+            }
+            if (logsInstance) {
+                await logsInstance.shutdown();
+            }
+            context.disable();
             instance = undefined;
         },
     };
@@ -139,6 +283,7 @@ export function isBrowserTelemetryInitialized() {
  */
 export function resetBrowserTelemetry() {
     instance = undefined;
+    resetBrowserLogs();
 }
 /**
  * Derive environment from hostname.

package/dist-esm/browser/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/browser/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAU,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAmB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAgBnE,qBAAqB;AACrB,IAAI,QAA8C,CAAC;AAEnD;;;;;GAKG;AACH,SAAS,8BAA8B,CAAC,MAA8B;IACpE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,OAAO,KAAM,KAAe,CAAC,OAAO,GAAG,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA8B,EAC9B,MAAuB;IAEvB,qBAAqB;IACrB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAEvC,kDAAkD;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,wCAAwC;IACxC,wFAAwF;IACxF,MAAM,cAAc,GAAG,eAAe,CAAC,eAAe,CACpD,aAAa,CAAC,kBAAkB,CACjC;QACC,CAAC,CAAC;YACE,IAAI,kBAAkB,CACpB,IAAI,wBAAwB,CAAC;gBAC3B,QAAQ,EAAE,IAAI,iBAAiB,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;aACzD,CAAC,CACH;SACF;QACH,CAAC,CAAC,EAAE,CAAC;IAEP,sEAAsE;IACtE,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;QACrC,QAAQ;QACR,cAAc;KACf,CAAC,CAAC;IAEH,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC;QAChB,UAAU,EAAE,IAAI,mBAAmB,CAAC;YAClC,WAAW,EAAE;gBACX,IAAI,oBAAoB,EAAE;gBAC1B,IAAI,yBAAyB,EAAE;aAChC;SACF,CAAC;KACH,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CACX,+CAA+C,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,cAAc,GAAG,CAC/F,CAAC;IAEF,QAAQ,GAAG;QACT,QAAQ;QACR,eAAe;QACf,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAC3B,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC;QACpE,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC1B,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,QAAQ,KAAK,SAAS,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,QAAQ,GAAG,SAAS,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACrE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACjE,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/browser/init.ts"],"names":[],"mappings":"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"}

package/dist-esm/browser/instrumentations.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Browser Auto-Instrumentations Factory
+ *
+ * Creates and configures auto-instrumentations for browser telemetry.
+ * Handles XHR and Fetch requests with configurable URL filtering and
+ * trace context propagation.
+ */
+import type { Instrumentation } from "@opentelemetry/instrumentation";
+/**
+ * Configuration for browser auto-instrumentations.
+ */
+export interface BrowserInstrumentationConfig {
+    /**
+     * URL patterns to inject traceparent header into.
+     * Only requests matching these patterns will have W3C trace context propagated.
+     * Defaults to empty (no cross-origin propagation).
+     */
+    propagateTraceUrls?: RegExp[];
+    /**
+     * URL patterns to skip instrumenting entirely.
+     * Defaults to common static asset extensions.
+     */
+    ignoreUrls?: RegExp[];
+}
+/**
+ * Create auto-instrumentations for browser telemetry.
+ *
+ * Returns an array containing XMLHttpRequestInstrumentation and
+ * FetchInstrumentation.
+ *
+ * Both instrumentations use the provided ignoreUrls to filter out asset
+ * downloads, and propagate trace context only to URLs matching propagateTraceUrls.
+ *
+ * @param config - Optional instrumentation configuration
+ * @returns Array of configured Instrumentation instances
+ *
+ * @example
+ * ```typescript
+ * const instrumentations = createBrowserInstrumentations({
+ *   propagateTraceUrls: [/https:\/\/api\.superblocks\.com/],
+ *   ignoreUrls: [/\/static\//],
+ * });
+ * registerInstrumentations({ instrumentations });
+ * ```
+ */
+export declare function createBrowserInstrumentations(config?: BrowserInstrumentationConfig): Instrumentation[];
+/**
+ * Register the StackContextManager for async context propagation in the browser.
+ *
+ * This must be called before using `context.with()` in browser environments.
+ * Without this, Redux middleware and other async code cannot thread trace
+ * context through async operations.
+ *
+ * @example
+ * ```typescript
+ * registerBrowserContextManager();
+ * // context.with() now works correctly in browser async flows
+ * ```
+ */
+export declare function registerBrowserContextManager(): void;
+//# sourceMappingURL=instrumentations.d.ts.map

package/dist-esm/browser/instrumentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentations.d.ts","sourceRoot":"","sources":["../../src/browser/instrumentations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAYtE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,CAAC,EAAE,4BAA4B,GACpC,eAAe,EAAE,CAcnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD"}