@superblocksteam/telemetry 2.0.0-SNAPSHOT.329be19cb7ca892b

package/dist-esm/browser/init.js

@@ -0,0 +1,319 @@
+/**
+ * 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 { context, metrics, trace } from "@opentelemetry/api";
+import { W3CTraceContextPropagator, W3CBaggagePropagator, CompositePropagator, } from "@opentelemetry/core";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+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 EarlyConsoleBuffer from "./early-console-buffer.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;
+/**
+ * Validate browser telemetry configuration.
+ *
+ * @param config - Configuration to validate
+ * @throws Error if configuration is invalid
+ */
+function validateBrowserTelemetryConfig(config) {
+    if (!config.serviceName?.trim()) {
+        throw new Error("[Telemetry] serviceName is required and cannot be empty");
+    }
+    if (!config.serviceVersion?.trim()) {
+        throw new Error("[Telemetry] serviceVersion is required and cannot be empty");
+    }
+    if (!config.environment?.trim()) {
+        throw new Error("[Telemetry] environment is required and cannot be empty");
+    }
+    if (!config.otlpUrl?.trim()) {
+        throw new Error("[Telemetry] otlpUrl is required for browser telemetry");
+    }
+    try {
+        new URL(config.otlpUrl);
+    }
+    catch (error) {
+        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.
+ *
+ * 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 function initBrowserTelemetry(config, policy) {
+    // Policy is required
+    if (!policy) {
+        throw new Error("[Telemetry] Policy is required. Cannot initialize telemetry without a policy.");
+    }
+    // Validate config
+    validateBrowserTelemetryConfig(config);
+    // Return existing instance if already initialized
+    if (instance) {
+        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);
+    // 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: [compositeProcessor],
+    });
+    // Register with composite propagator for W3C TraceContext and Baggage
+    provider.register({
+        propagator: new CompositePropagator({
+            propagators: [
+                new W3CBaggagePropagator(),
+                new W3CTraceContextPropagator(),
+            ],
+        }),
+    });
+    // 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,
+            resource,
+        });
+    }
+    // 5. Initialize logs (with EarlyConsoleBuffer flush)
+    let logsInstance;
+    if (policyEvaluator.isExportEnabled(TelemetryTier.TIER_2_OPERATIONAL)) {
+        logsInstance = initBrowserLogs({
+            otlpUrl: `${baseUrl}/v1/logs`,
+            serviceName: config.serviceName,
+            resource,
+        });
+    }
+    else {
+        // Log export disabled (e.g. on-premise) — disable the EarlyConsoleBuffer
+        // so it stops buffering indefinitely and restores original console methods.
+        EarlyConsoleBuffer.getInstance().disable();
+    }
+    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);
+        },
+        forceFlush: async () => {
+            await provider.forceFlush();
+        },
+        shutdown: async () => {
+            await provider.shutdown();
+            if (metricsInstance) {
+                await metricsInstance.shutdown();
+            }
+            if (logsInstance) {
+                await logsInstance.shutdown();
+            }
+            context.disable();
+            instance = undefined;
+        },
+    };
+    return instance;
+}
+/**
+ * Get the current browser telemetry instance.
+ *
+ * @throws Error if not initialized
+ */
+export function getBrowserTelemetryInstance() {
+    if (!instance) {
+        throw new Error("[Telemetry] Not initialized. Call initBrowserTelemetry() first.");
+    }
+    return instance;
+}
+/**
+ * Check if browser telemetry is initialized.
+ */
+export function isBrowserTelemetryInitialized() {
+    return instance !== undefined;
+}
+/**
+ * Reset browser telemetry (for testing only).
+ * @internal
+ */
+export function resetBrowserTelemetry() {
+    instance = undefined;
+    resetBrowserLogs();
+}
+/**
+ * Derive environment from hostname.
+ * Utility for browser context where env vars aren't available.
+ *
+ * @param hostname - The hostname to analyze
+ * @returns Environment string
+ */
+export function getEnvironmentFromHostname(hostname) {
+    if (hostname.includes("localhost") || hostname.includes("127.0.0.1")) {
+        return "local";
+    }
+    if (hostname.includes("staging") || hostname.includes("stg")) {
+        return "staging";
+    }
+    if (hostname.includes("dev") || hostname.includes("development")) {
+        return "development";
+    }
+    return "production";
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/browser/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAe,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,kBAAkB,GAInB,MAAM,+BAA+B,CAAC;AACvC,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,kBAAkB,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAA+B,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AA0B/D,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;;GAEG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,4BAA4B;IACxB,KAAK,GAA2B,EAAE,CAAC;IAE3C,aAAa,CAAC,KAA6B;QACzC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,IAAU,EAAE,cAAuB;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAmB,IAAS,CAAC;IACnC,KAAK,CAAC,QAAQ,KAAmB,CAAC;IAClC,KAAK,CAAC,UAAU,KAAmB,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,6BAA6B;IAChB,UAAU,GAAoB,EAAE,CAAC;IAElD,GAAG,CAAC,SAAwB;QAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAAC,IAAU,EAAE,aAAsB;QACxC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,aAAqD,CAAC,CAAC;YACzE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,GAAG,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAkB;QACtB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;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,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEjD,gEAAgE;IAChE,6BAA6B,EAAE,CAAC;IAEhC,MAAM,eAAe,GAAG,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,wEAAwE;IACxE,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,mBAAmB,GAAG,IAAI,4BAA4B,EAAE,CAAC;IAC/D,MAAM,kBAAkB,GAAG,IAAI,6BAA6B,EAAE,CAAC;IAE/D,kBAAkB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAE5C,kDAAkD;IAClD,kBAAkB,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAExD,6CAA6C;IAC7C,IAAI,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtE,kBAAkB,CAAC,GAAG,CACpB,IAAI,kBAAkB,CACpB,IAAI,wBAAwB,CAAC;YAC3B,QAAQ,EAAE,IAAI,iBAAiB,CAAC;gBAC9B,GAAG,EAAE,GAAG,OAAO,YAAY;aAC5B,CAAC;SACH,CAAC,CACH,CACF,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;QACrC,QAAQ;QACR,cAAc,EAAE,CAAC,kBAAkB,CAAC;KACrC,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,gDAAgD;IAChD,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;QACrD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IAEH,wBAAwB,CAAC;QACvB,gBAAgB;QAChB,cAAc,EAAE,QAAQ;KACzB,CAAC,CAAC;IAEH,wBAAwB;IACxB,IAAI,eAAmD,CAAC;IACxD,IAAI,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtE,eAAe,GAAG,kBAAkB,CAAC;YACnC,OAAO,EAAE,GAAG,OAAO,aAAa;YAChC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,IAAI,YAA4D,CAAC;IACjE,IAAI,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtE,YAAY,GAAG,eAAe,CAAC;YAC7B,OAAO,EAAE,GAAG,OAAO,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,yEAAyE;QACzE,4EAA4E;QAC5E,kBAAkB,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,KAAK,CACX,iDAAiD,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,cAAc,2BAA2B,CACzH,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,CAAC,IAAa,EAAE,EAAE;YAC1B,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YACD,qEAAqE;YACrE,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;QACtD,CAAC;QACD,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE;YAC3B,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YACD,+CAA+C;YAC/C,OAAO;gBACL,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;aACM,CAAC;QACzB,CAAC;QACD,uBAAuB,EAAE,CAAC,KAA6B,EAAE,EAAE;YACzD,mBAAmB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;QACD,gBAAgB,EAAE,CAAC,SAAwB,EAAE,EAAE;YAC7C,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QACD,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC;QACD,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC1B,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,eAAe,CAAC,QAAQ,EAAE,CAAC;YACnC,CAAC;YACD,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;YAChC,CAAC;YACD,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,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;IACrB,gBAAgB,EAAE,CAAC;AACrB,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"}

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

@@ -0,0 +1,67 @@
+/**
+ * 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[];
+    /**
+     * Set to true to skip FetchInstrumentation entirely.
+     * Acts as an escape valve if the Fetch instrumentation regresses in production
+     * without requiring a full revert.
+     * Defaults to false.
+     */
+    disableFetch?: boolean;
+}
+/**
+ * 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;AAatE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,CAAC,EAAE,4BAA4B,GACpC,eAAe,EAAE,CA6BnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD"}

package/dist-esm/browser/instrumentations.js

@@ -0,0 +1,79 @@
+/**
+ * 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 { context, diag } from "@opentelemetry/api";
+import { FetchInstrumentation } from "@opentelemetry/instrumentation-fetch";
+import { XMLHttpRequestInstrumentation } from "@opentelemetry/instrumentation-xml-http-request";
+import { StackContextManager } from "@opentelemetry/sdk-trace-web";
+/**
+ * Default regex for ignoring static asset URLs.
+ * Uses ([?#]|$) to also match cache-busted URLs (e.g. app.js?v=abc123).
+ * These requests are not worth tracing and would create noise.
+ */
+const DEFAULT_IGNORE_URLS = /\.(js|css|map|png|jpg|jpeg|svg|gif|webp|avif|woff|woff2|ttf|eot|ico)([?#]|$)/i;
+/**
+ * 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 function createBrowserInstrumentations(config) {
+    const ignoreUrls = config?.ignoreUrls ?? [DEFAULT_IGNORE_URLS];
+    const propagateTraceHeaderCorsUrls = config?.propagateTraceUrls ?? [];
+    const instrumentations = [
+        new XMLHttpRequestInstrumentation({
+            ignoreUrls,
+            propagateTraceHeaderCorsUrls,
+        }),
+    ];
+    if (!config?.disableFetch) {
+        try {
+            instrumentations.push(new FetchInstrumentation({
+                ignoreUrls,
+                propagateTraceHeaderCorsUrls,
+            }));
+        }
+        catch (err) {
+            // FetchInstrumentation failed; XHR instrumentation continues unaffected.
+            diag.warn("[telemetry] FetchInstrumentation failed to initialize", String(err));
+        }
+    }
+    return instrumentations;
+}
+/**
+ * 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 function registerBrowserContextManager() {
+    const contextManager = new StackContextManager();
+    contextManager.enable();
+    context.setGlobalContextManager(contextManager);
+}
+//# sourceMappingURL=instrumentations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentations.js","sourceRoot":"","sources":["../../src/browser/instrumentations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,mBAAmB,GACvB,+EAA+E,CAAC;AA0BlF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAqC;IAErC,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC/D,MAAM,4BAA4B,GAAG,MAAM,EAAE,kBAAkB,IAAI,EAAE,CAAC;IAEtE,MAAM,gBAAgB,GAAsB;QAC1C,IAAI,6BAA6B,CAAC;YAChC,UAAU;YACV,4BAA4B;SAC7B,CAAC;KACH,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,gBAAgB,CAAC,IAAI,CACnB,IAAI,oBAAoB,CAAC;gBACvB,UAAU;gBACV,4BAA4B;aAC7B,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,yEAAyE;YACzE,IAAI,CAAC,IAAI,CACP,uDAAuD,EACvD,MAAM,CAAC,GAAG,CAAC,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,cAAc,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACjD,cAAc,CAAC,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Browser Log Provider
+ *
+ * Initializes the OTel LoggerProvider for browser contexts. Pairs with the
+ * EarlyConsoleBuffer to ensure pre-init console messages are captured and
+ * forwarded to the OTLP endpoint.
+ *
+ * This is the ONLY approved way to init log telemetry in browser contexts.
+ */
+import { type Logger } from "@opentelemetry/api-logs";
+import type { Resource } from "@opentelemetry/resources";
+export interface BrowserLogsConfig {
+    /** Full URL for the OTLP logs endpoint, e.g. "https://app.example.com/api/v1/logs" */
+    otlpUrl: string;
+    /** Logical service name recorded in every log record */
+    serviceName: string;
+    /** Resource with service.name / deployment.environment.name for Datadog env tags. */
+    resource?: Resource;
+}
+export interface BrowserLogsInstance {
+    /** Get a named Logger (uses serviceName when name is omitted) */
+    getLogger: (name?: string) => Logger;
+    /** Gracefully shut down the underlying LoggerProvider */
+    shutdown: () => Promise<void>;
+}
+/**
+ * Initialize the browser log provider.
+ *
+ * - Creates an OTLPLogExporter pointed at `config.otlpUrl`
+ * - Wraps it in a BatchLogRecordProcessor
+ * - Enables the EarlyConsoleBuffer so buffered pre-init console messages are
+ *   flushed to OpenTelemetry immediately
+ *
+ * Calling this more than once returns the existing instance with a warning.
+ *
+ * @example
+ * ```typescript
+ * import { initBrowserLogs } from '@superblocksteam/telemetry/browser';
+ *
+ * const logs = initBrowserLogs({
+ *   otlpUrl: 'https://app.superblocks.com/api/v1/logs',
+ *   serviceName: 'superblocks-ui',
+ * });
+ *
+ * const logger = logs.getLogger();
+ * logger.emit({ severityNumber: SeverityNumber.INFO, body: 'hello' });
+ * ```
+ */
+export declare function initBrowserLogs(config: BrowserLogsConfig): BrowserLogsInstance;
+/**
+ * Reset the browser log provider singleton (for testing only).
+ * @internal
+ */
+export declare function resetBrowserLogs(): void;
+//# sourceMappingURL=logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/browser/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AASzD,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAcD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,GACxB,mBAAmB,CA+BrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist-esm/browser/logs.js

@@ -0,0 +1,79 @@
+/**
+ * Browser Log Provider
+ *
+ * Initializes the OTel LoggerProvider for browser contexts. Pairs with the
+ * EarlyConsoleBuffer to ensure pre-init console messages are captured and
+ * forwarded to the OTLP endpoint.
+ *
+ * This is the ONLY approved way to init log telemetry in browser contexts.
+ */
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { BatchLogRecordProcessor, LoggerProvider, } from "@opentelemetry/sdk-logs";
+import EarlyConsoleBuffer from "./early-console-buffer.js";
+import { createSanitizingLogProcessor } from "./sanitizer.js";
+// Singleton
+let instance;
+function validateConfig(config) {
+    if (!config.serviceName?.trim()) {
+        throw new Error("[Telemetry] serviceName is required and cannot be empty");
+    }
+    if (!config.otlpUrl?.trim()) {
+        throw new Error("[Telemetry] otlpUrl is required for browser logs");
+    }
+}
+/**
+ * Initialize the browser log provider.
+ *
+ * - Creates an OTLPLogExporter pointed at `config.otlpUrl`
+ * - Wraps it in a BatchLogRecordProcessor
+ * - Enables the EarlyConsoleBuffer so buffered pre-init console messages are
+ *   flushed to OpenTelemetry immediately
+ *
+ * Calling this more than once returns the existing instance with a warning.
+ *
+ * @example
+ * ```typescript
+ * import { initBrowserLogs } from '@superblocksteam/telemetry/browser';
+ *
+ * const logs = initBrowserLogs({
+ *   otlpUrl: 'https://app.superblocks.com/api/v1/logs',
+ *   serviceName: 'superblocks-ui',
+ * });
+ *
+ * const logger = logs.getLogger();
+ * logger.emit({ severityNumber: SeverityNumber.INFO, body: 'hello' });
+ * ```
+ */
+export function initBrowserLogs(config) {
+    validateConfig(config);
+    if (instance) {
+        console.warn("[Telemetry] Browser log provider already initialized");
+        return instance;
+    }
+    const exporter = new OTLPLogExporter({ url: config.otlpUrl });
+    const sanitizer = createSanitizingLogProcessor();
+    const batchProcessor = new BatchLogRecordProcessor({ exporter });
+    const provider = new LoggerProvider({
+        resource: config.resource,
+        processors: [sanitizer, batchProcessor],
+    });
+    // Wire the EarlyConsoleBuffer so buffered pre-init logs are flushed now.
+    const otelLogger = provider.getLogger(config.serviceName, "1.0.0");
+    EarlyConsoleBuffer.getInstance().enableOpenTelemetry(otelLogger);
+    instance = {
+        getLogger: (name) => provider.getLogger(name ?? config.serviceName, "1.0.0"),
+        shutdown: async () => {
+            await provider.shutdown();
+            instance = undefined;
+        },
+    };
+    return instance;
+}
+/**
+ * Reset the browser log provider singleton (for testing only).
+ * @internal
+ */
+export function resetBrowserLogs() {
+    instance = undefined;
+}
+//# sourceMappingURL=logs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/browser/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE,OAAO,EACL,uBAAuB,EACvB,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,kBAAkB,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAkB9D,YAAY;AACZ,IAAI,QAAyC,CAAC;AAE9C,SAAS,cAAc,CAAC,MAAyB;IAC/C,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,kDAAkD,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAyB;IAEzB,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACrE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,4BAA4B,EAAE,CAAC;IACjD,MAAM,cAAc,GAAG,IAAI,uBAAuB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC;KACxC,CAAC,CAAC;IAEH,yEAAyE;IACzE,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnE,kBAAkB,CAAC,WAAW,EAAE,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEjE,QAAQ,GAAG;QACT,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAC3B,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC;QACzD,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;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,GAAG,SAAS,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Browser Metrics Bootstrap
+ *
+ * Initializes a MeterProvider for browser contexts using OTLP HTTP export.
+ */
+import { type Meter } from "@opentelemetry/api";
+import type { Resource } from "@opentelemetry/resources";
+export interface BrowserMetricsInstance {
+    getMeter: (name?: string) => Meter;
+    shutdown: () => Promise<void>;
+}
+export interface BrowserMetricsConfig {
+    /** Full URL for metrics endpoint (e.g. "http://localhost:4318/v1/metrics") */
+    otlpUrl: string;
+    serviceName: string;
+    /** Resource with service.name / deployment.environment.name for Datadog env tags. */
+    resource?: Resource;
+}
+/**
+ * Initialize browser metrics with a MeterProvider that exports via OTLP HTTP.
+ *
+ * Uses DELTA aggregation temporality so each export stands on its own and
+ * Datadog does not see counter-reset artifacts from short-lived sessions.
+ *
+ * @param config - Browser metrics configuration
+ * @returns Browser metrics instance with getMeter and shutdown
+ */
+export declare function initBrowserMetrics(config: BrowserMetricsConfig): BrowserMetricsInstance;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/browser/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOzD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;IACnC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,oBAAoB,GAC3B,sBAAsB,CAsBxB"}