@superblocksteam/telemetry 2.0.0-SNAPSHOT.329be19cb7ca892b

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

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_logs_1 = require("@opentelemetry/api-logs");
+const console_logging_js_1 = require("./console-logging.js");
+function mergeAllConsoleLogAttributes(args) {
+    if (args.length === 0)
+        return undefined;
+    return args.reduce((merged, arg) => {
+        if (arg instanceof console_logging_js_1.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;
+    disabled = 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 || this.disabled)
+            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() });
+    }
+    /**
+     * Disable the buffer without forwarding to OTel. Discards buffered entries
+     * and removes the buffering wrapper so subsequent console calls go straight
+     * to the original methods (no memory leak from the ever-growing ring buffer).
+     *
+     * Use this when log export is disabled (e.g. on-premise deployments) so the
+     * buffer-and-evict path doesn't run indefinitely.
+     */
+    disable() {
+        this.disabled = true;
+        if (!this.isPatched)
+            return;
+        for (const level of ["log", "info", "debug", "warn", "error"]) {
+            if (this.originalMethods[level]) {
+                console[level] =
+                    this.originalMethods[level];
+            }
+        }
+        const count = this.buffer.length;
+        this.buffer = [];
+        this.isPatched = false;
+        // Use restored console.info directly
+        console.info(`[EarlyConsoleBuffer] Disabled — discarded ${count} buffered entries (log export not enabled)`);
+    }
+    /**
+     * 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: api_logs_1.SeverityNumber.DEBUG,
+            log: api_logs_1.SeverityNumber.INFO,
+            info: api_logs_1.SeverityNumber.INFO,
+            warn: api_logs_1.SeverityNumber.WARN,
+            error: api_logs_1.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 console_logging_js_1.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(" ");
+    }
+}
+exports.default = EarlyConsoleBuffer;
+//# sourceMappingURL=early-console-buffer.js.map

package/dist/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":";AAAA;;;;;;;;;;;GAWG;;AAEH,sDAAsE;AAEtE,6DAA4D;AAQ5D,SAAS,4BAA4B,CACnC,IAAe;IAEf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,OAAO,IAAI,CAAC,MAAM,CAA0B,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QAC1D,IAAI,GAAG,YAAY,yCAAoB,EAAE,CAAC;YACxC,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,MAAM,kBAAkB;IACd,MAAM,CAAC,QAAQ,CAAqB;IAEpC,MAAM,GAAe,EAAE,CAAC;IACxB,aAAa,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IAC9D,eAAe,GAA6B,EAAE,CAAC;IAC/C,UAAU,GAAuB,SAAS,CAAC;IAC3C,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAG,KAAK,CAAC;IAEzB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;YACjC,kBAAkB,CAAC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE5C,2EAA2E;QAC3E,4EAA4E;QAC5E,4BAA4B;QAC5B,sCAAsC;QACtC,IAAI,CAAC,eAAe,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,eAAe,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,eAAe,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAE1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,wEAAwE;QACxE,8DAA8D;QAC9D,IAAI,CAAC,eAAe,CAAC,IAAI,CACvB,gGAAgG,CACjG,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAElD,OAA8C,CAAC,KAAK,CAAC,GAAG,CACvD,GAAG,IAAe,EAClB,EAAE;YACF,yEAAyE;YACxE,cAA4C,CAAC,GAAG,IAAI,CAAC,CAAC;YAEvD,6DAA6D;YAC7D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,mBAAmB,CAAC,KAA0B,EAAE,IAAI,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,CAAC,KAA0B,EAAE,IAAI,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,KAAwB,EAAE,IAAe;QACzD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,oBAAoB;QAC3C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAE5B,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAU,EAAE,CAAC;YACvE,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAA8C,CAAC,KAAK,CAAC;oBACpD,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,qCAAqC;QACrC,OAAO,CAAC,IAAI,CACV,6CAA6C,KAAK,4CAA4C,CAC/F,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,UAAkB;QACpC,OAAO,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACxE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACjC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,OAAO,CAAC,IAAI,CACV,iCAAiC,KAAK,iCAAiC,CACxE,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,OAAO,CAAC,IAAI,CACV,0CAA0C,KAAK,wCAAwC,CACxF,CAAC;IACJ,CAAC;IAEO,mBAAmB,CACzB,KAAwB,EACxB,IAAe,EACf,SAAkB,EAClB,UAAoB;QAEpB,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAE7B,MAAM,WAAW,GAA8C;YAC7D,KAAK,EAAE,yBAAc,CAAC,KAAK;YAC3B,GAAG,EAAE,yBAAc,CAAC,IAAI;YACxB,IAAI,EAAE,yBAAc,CAAC,IAAI;YACzB,IAAI,EAAE,yBAAc,CAAC,IAAI;YACzB,KAAK,EAAE,yBAAc,CAAC,KAAK;SAC5B,CAAC;QAEF,MAAM,UAAU,GAAG;YACjB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,sBAA+B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,GAAG,4BAA4B,CAAC,IAAI,CAAC;SACtC,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,cAAc,EAAE,WAAW,CAAC,KAAK,CAAC;YAClC,YAAY,EAAE,KAAK;YACnB,IAAI,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAClC,SAAS;YACT,UAAU,EAAE,UAAoC;SACjD,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,IAAe;QACvC,OAAO,IAAI;aACR,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,yCAAoB,CAAC,CAAC;aACvD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC;YACxC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;YAChC,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,WAAW,CAAC;YAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACtC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,iBAAiB,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC,CAAC;aACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACF;AAED,kBAAe,kBAAkB,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Browser Telemetry Bootstrap
+ *
+ * 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";
+export { BatchSpanProcessor, SimpleSpanProcessor, type SpanProcessor, type SpanExporter, type ReadableSpan, } from "@opentelemetry/sdk-trace-base";
+export { type ExportResult, ExportResultCode, hrTimeToMicroseconds, } from "@opentelemetry/core";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;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;AAM5B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,YAAY,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Browser Telemetry Bootstrap
+ *
+ * This is the ONLY approved way to initialize telemetry in browser contexts.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hrTimeToMicroseconds = exports.ExportResultCode = exports.SimpleSpanProcessor = exports.BatchSpanProcessor = exports.BrowserTracedSocket = exports.DeploymentType = exports.getDefaultPolicy = exports.EarlyConsoleBuffer = exports.consoleLogAttributes = exports.ConsoleLogAttributes = exports.registerBrowserContextManager = exports.createBrowserInstrumentations = exports.createSanitizingLogProcessor = exports.createSanitizingSpanProcessor = exports.initBrowserMetrics = exports.resetBrowserLogs = exports.initBrowserLogs = exports.getEnvironmentFromHostname = exports.resetBrowserTelemetry = exports.isBrowserTelemetryInitialized = exports.getBrowserTelemetryInstance = exports.initBrowserTelemetry = void 0;
+var init_js_1 = require("./init.js");
+Object.defineProperty(exports, "initBrowserTelemetry", { enumerable: true, get: function () { return init_js_1.initBrowserTelemetry; } });
+Object.defineProperty(exports, "getBrowserTelemetryInstance", { enumerable: true, get: function () { return init_js_1.getBrowserTelemetryInstance; } });
+Object.defineProperty(exports, "isBrowserTelemetryInitialized", { enumerable: true, get: function () { return init_js_1.isBrowserTelemetryInitialized; } });
+Object.defineProperty(exports, "resetBrowserTelemetry", { enumerable: true, get: function () { return init_js_1.resetBrowserTelemetry; } });
+Object.defineProperty(exports, "getEnvironmentFromHostname", { enumerable: true, get: function () { return init_js_1.getEnvironmentFromHostname; } });
+var logs_js_1 = require("./logs.js");
+Object.defineProperty(exports, "initBrowserLogs", { enumerable: true, get: function () { return logs_js_1.initBrowserLogs; } });
+Object.defineProperty(exports, "resetBrowserLogs", { enumerable: true, get: function () { return logs_js_1.resetBrowserLogs; } });
+var metrics_js_1 = require("./metrics.js");
+Object.defineProperty(exports, "initBrowserMetrics", { enumerable: true, get: function () { return metrics_js_1.initBrowserMetrics; } });
+var sanitizer_js_1 = require("./sanitizer.js");
+Object.defineProperty(exports, "createSanitizingSpanProcessor", { enumerable: true, get: function () { return sanitizer_js_1.createSanitizingSpanProcessor; } });
+Object.defineProperty(exports, "createSanitizingLogProcessor", { enumerable: true, get: function () { return sanitizer_js_1.createSanitizingLogProcessor; } });
+var instrumentations_js_1 = require("./instrumentations.js");
+Object.defineProperty(exports, "createBrowserInstrumentations", { enumerable: true, get: function () { return instrumentations_js_1.createBrowserInstrumentations; } });
+Object.defineProperty(exports, "registerBrowserContextManager", { enumerable: true, get: function () { return instrumentations_js_1.registerBrowserContextManager; } });
+var console_logging_js_1 = require("./console-logging.js");
+Object.defineProperty(exports, "ConsoleLogAttributes", { enumerable: true, get: function () { return console_logging_js_1.ConsoleLogAttributes; } });
+Object.defineProperty(exports, "consoleLogAttributes", { enumerable: true, get: function () { return console_logging_js_1.consoleLogAttributes; } });
+var early_console_buffer_js_1 = require("./early-console-buffer.js");
+Object.defineProperty(exports, "EarlyConsoleBuffer", { enumerable: true, get: function () { return __importDefault(early_console_buffer_js_1).default; } });
+// Re-export policy utilities for convenience
+var policy_js_1 = require("../types/policy.js");
+Object.defineProperty(exports, "getDefaultPolicy", { enumerable: true, get: function () { return policy_js_1.getDefaultPolicy; } });
+Object.defineProperty(exports, "DeploymentType", { enumerable: true, get: function () { return policy_js_1.DeploymentType; } });
+var traced_socket_js_1 = require("./traced-socket.js");
+Object.defineProperty(exports, "BrowserTracedSocket", { enumerable: true, get: function () { return traced_socket_js_1.BrowserTracedSocket; } });
+// Re-export OTel SDK primitives that consumers need to register custom processors
+// against the provider owned by this package. Consumers must construct these from
+// the version bundled here, not from their own @opentelemetry/sdk-trace-base, so
+// the Span/Context types match the provider.
+var sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+Object.defineProperty(exports, "BatchSpanProcessor", { enumerable: true, get: function () { return sdk_trace_base_1.BatchSpanProcessor; } });
+Object.defineProperty(exports, "SimpleSpanProcessor", { enumerable: true, get: function () { return sdk_trace_base_1.SimpleSpanProcessor; } });
+var core_1 = require("@opentelemetry/core");
+Object.defineProperty(exports, "ExportResultCode", { enumerable: true, get: function () { return core_1.ExportResultCode; } });
+Object.defineProperty(exports, "hrTimeToMicroseconds", { enumerable: true, get: function () { return core_1.hrTimeToMicroseconds; } });
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,qCAOmB;AANjB,+GAAA,oBAAoB,OAAA;AACpB,sHAAA,2BAA2B,OAAA;AAC3B,wHAAA,6BAA6B,OAAA;AAC7B,gHAAA,qBAAqB,OAAA;AACrB,qHAAA,0BAA0B,OAAA;AAI5B,qCAKmB;AAJjB,0GAAA,eAAe,OAAA;AACf,2GAAA,gBAAgB,OAAA;AAKlB,2CAIsB;AAHpB,gHAAA,kBAAkB,OAAA;AAKpB,+CAIwB;AAHtB,6HAAA,6BAA6B,OAAA;AAC7B,4HAAA,4BAA4B,OAAA;AAI9B,6DAI+B;AAH7B,oIAAA,6BAA6B,OAAA;AAC7B,oIAAA,6BAA6B,OAAA;AAI/B,2DAG8B;AAF5B,0HAAA,oBAAoB,OAAA;AACpB,0HAAA,oBAAoB,OAAA;AAGtB,qEAA0E;AAAjE,8IAAA,OAAO,OAAsB;AAEtC,6CAA6C;AAC7C,gDAAsE;AAA7D,6GAAA,gBAAgB,OAAA;AAAE,2GAAA,cAAc,OAAA;AAEzC,uDAI4B;AAH1B,uHAAA,mBAAmB,OAAA;AAKrB,kFAAkF;AAClF,kFAAkF;AAClF,iFAAiF;AACjF,6CAA6C;AAC7C,gEAMuC;AALrC,oHAAA,kBAAkB,OAAA;AAClB,qHAAA,mBAAmB,OAAA;AAMrB,4CAI6B;AAF3B,wGAAA,gBAAgB,OAAA;AAChB,4GAAA,oBAAoB,OAAA"}

package/dist/browser/init.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Browser Telemetry Bootstrap
+ *
+ * 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 { 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";
+import { TelemetryPolicy } from "../types/policy.js";
+/**
+ * Browser telemetry instance.
+ */
+export interface BrowserTelemetryInstance {
+    /** The underlying WebTracerProvider */
+    provider: WebTracerProvider;
+    /** Policy evaluator for runtime decisions */
+    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;
+    /** Flush pending spans without tearing down (e.g. on pagehide) */
+    forceFlush: () => Promise<void>;
+    /** Graceful shutdown */
+    shutdown: () => Promise<void>;
+}
+/**
+ * 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.
+ *
+ * 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
+ *
+ * @example
+ * ```typescript
+ * import { initBrowserTelemetry } from '@superblocksteam/telemetry/browser';
+ * import { getDefaultPolicy, DeploymentType } from '@superblocksteam/shared';
+ *
+ * const policy = getDefaultPolicy(DeploymentType.CLOUD);
+ * const telemetry = initBrowserTelemetry({
+ *   serviceName: 'superblocks-ui',
+ *   serviceVersion: '1.0.0',
+ *   environment: 'production',
+ *   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;
+/**
+ * Get the current browser telemetry instance.
+ *
+ * @throws Error if not initialized
+ */
+export declare function getBrowserTelemetryInstance(): BrowserTelemetryInstance;
+/**
+ * Check if browser telemetry is initialized.
+ */
+export declare function isBrowserTelemetryInitialized(): boolean;
+/**
+ * Reset browser telemetry (for testing only).
+ * @internal
+ */
+export declare function resetBrowserTelemetry(): void;
+/**
+ * Derive environment from hostname.
+ * Utility for browser context where env vars aren't available.
+ *
+ * @param hostname - The hostname to analyze
+ * @returns Environment string
+ */
+export declare function getEnvironmentFromHostname(hostname: string): string;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"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;AAWpE;;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,kEAAkE;IAClE,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,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,CAoJ1B;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"}