@squasher-ai/browser 0.1.1 → 0.2.0

package/dist/autocapture.js

@@ -1,26 +1,28 @@
 /**
- * Auto-capture breadcrumbs for navigation, clicks, and fetch errors.
- *
- * Breadcrumbs are lightweight events that provide context about what the
- * user was doing before an error occurred. They are attached to error
- * events to help with debugging and AI triage.
- *
- * Categories:
- *   - "navigation" — route changes (pushState, replaceState, popstate)
- *   - "ui.click" — user clicks on elements
- *   - "fetch" — failed fetch requests (4xx/5xx)
- *   - "console" — console.error / console.warn calls
+ * Auto-capture breadcrumbs. Categories emitted:
+ *   - "navigation" — pushState/replaceState/popstate
+ *   - "ui.click"   — clicks on elements
+ *   - "fetch"      — 4xx/5xx fetch responses
+ *   - "console"    — console.error / console.warn calls
  */
-/**
- * Install all auto-capture hooks.
- * Returns a cleanup function to remove all hooks and restore originals.
- */
-export function installAutocapture(onBreadcrumb) {
+import { attemptAsync } from "@squasher-ai/result-utils";
+import { readRuntimeProperty, readRuntimeString } from "@squasher-ai/sdk-core";
+import { captureConsole } from "./console-capture.js";
+/** Installs all hooks. Returned function removes them and restores originals. */
+export function installAutocapture(onBreadcrumb, options = {}) {
     const cleanups = [];
-    cleanups.push(captureNavigation(onBreadcrumb));
-    cleanups.push(captureClicks(onBreadcrumb));
-    cleanups.push(captureFetch(onBreadcrumb));
-    cleanups.push(captureConsole(onBreadcrumb));
+    const captureBreadcrumbs = options.captureBreadcrumbs ?? true;
+    if (captureBreadcrumbs) {
+        cleanups.push(captureNavigation(onBreadcrumb));
+        cleanups.push(captureClicks(onBreadcrumb));
+        cleanups.push(captureFetch(onBreadcrumb));
+    }
+    if (captureBreadcrumbs || options.onConsoleError) {
+        cleanups.push(captureConsole(onBreadcrumb, {
+            captureBreadcrumbs,
+            onConsoleError: options.onConsoleError,
+        }));
+    }
     return () => {
         for (const cleanup of cleanups) {
             cleanup();
@@ -43,13 +45,13 @@ function captureNavigation(onBreadcrumb) {
     };
     // Patch history.pushState
     const origPushState = history.pushState.bind(history);
-    history.pushState = function (...args) {
+    history.pushState = (...args) => {
         origPushState(...args);
         emitNavCrumb();
     };
     // Patch history.replaceState
     const origReplaceState = history.replaceState.bind(history);
-    history.replaceState = function (...args) {
+    history.replaceState = (...args) => {
         origReplaceState(...args);
         emitNavCrumb();
     };
@@ -65,20 +67,21 @@ function captureNavigation(onBreadcrumb) {
 // ─── Clicks ─────────────────────────────────────────────────────────────
 function captureClicks(onBreadcrumb) {
     const handler = (event) => {
-        const target = event.target;
+        const target = readClickTarget(event.target);
         if (!target)
             return;
         const descriptor = describeElement(target);
         if (!descriptor)
             return;
+        const data = { tag: target.tagName.toLowerCase() };
+        if (target.id)
+            data.id = target.id;
+        if (target.className)
+            data.className = target.className;
         onBreadcrumb({
             category: "ui.click",
             message: descriptor,
-            data: {
-                tag: target.tagName?.toLowerCase(),
-                id: target.id || undefined,
-                className: target.className || undefined,
-            },
+            data,
         });
     };
     // Use capture phase to catch clicks even if stopPropagation is called
@@ -87,27 +90,35 @@ function captureClicks(onBreadcrumb) {
         document.removeEventListener("click", handler, true);
     };
 }
+function readClickTarget(target) {
+    const tagName = readRuntimeString(readRuntimeProperty(target, "tagName"));
+    if (!tagName)
+        return null;
+    return {
+        className: readRuntimeString(readRuntimeProperty(target, "className")) ?? "",
+        id: readRuntimeString(readRuntimeProperty(target, "id")) ?? "",
+        tagName,
+        textContent: readRuntimeString(readRuntimeProperty(target, "textContent")) ?? "",
+    };
+}
 /**
  * Build a human-readable descriptor for a DOM element.
  * e.g. "button#submit-btn.primary" or "a.nav-link"
  */
 function describeElement(el) {
-    const tag = el.tagName?.toLowerCase();
-    if (!tag)
-        return null;
+    const tag = el.tagName.toLowerCase();
     let desc = tag;
-    const htmlEl = el;
-    if (htmlEl.id) {
-        desc += `#${htmlEl.id}`;
+    if (el.id) {
+        desc += `#${el.id}`;
     }
-    if (htmlEl.className && typeof htmlEl.className === "string") {
-        const classes = htmlEl.className.trim().split(/\s+/).slice(0, 2).join(".");
+    if (el.className) {
+        const classes = el.className.trim().split(/\s+/).slice(0, 2).join(".");
         if (classes) {
             desc += `.${classes}`;
         }
     }
     // Add text content for buttons/links (truncated)
-    const textContent = htmlEl.textContent?.trim();
+    const textContent = el.textContent?.trim();
     if (textContent && (tag === "button" || tag === "a")) {
         const truncated = textContent.length > 30 ? `${textContent.slice(0, 30)}...` : textContent;
         desc += `[${truncated}]`;
@@ -116,76 +127,47 @@ function describeElement(el) {
 }
 // ─── Fetch ──────────────────────────────────────────────────────────────
 function captureFetch(onBreadcrumb) {
-    if (typeof window === "undefined" || !window.fetch)
+    if (!globalThis.window?.fetch)
         return () => { };
     const origFetch = window.fetch.bind(window);
-    window.fetch = async function (input, init) {
+    window.fetch = async (input, init) => {
         const method = init?.method?.toUpperCase() || "GET";
-        const url = typeof input === "string"
-            ? input
-            : input instanceof URL
-                ? input.href
-                : input instanceof Request
-                    ? input.url
-                    : String(input);
-        try {
-            const response = await origFetch(input, init);
-            // Only breadcrumb on error responses (4xx/5xx)
-            if (response.status >= 400) {
+        const url = input instanceof URL ? input.href : input instanceof Request ? input.url : String(input);
+        return attemptAsync({
+            try: async () => {
+                const response = await origFetch(input, init);
+                // Only breadcrumb on error responses (4xx/5xx)
+                if (response.status >= 400) {
+                    onBreadcrumb({
+                        category: "fetch",
+                        message: `${method} ${url} [${response.status}]`,
+                        level: response.status >= 500 ? "error" : "warning",
+                        data: {
+                            method,
+                            url,
+                            status: response.status,
+                        },
+                    });
+                }
+                return response;
+            },
+            catch: ({ cause, error }) => {
+                // Network error
                 onBreadcrumb({
                     category: "fetch",
-                    message: `${method} ${url} [${response.status}]`,
-                    level: response.status >= 500 ? "error" : "warning",
+                    message: `${method} ${url} [network error]`,
+                    level: "error",
                     data: {
                         method,
                         url,
-                        status: response.status,
+                        error: error.message,
                     },
                 });
-            }
-            return response;
-        }
-        catch (error) {
-            // Network error
-            onBreadcrumb({
-                category: "fetch",
-                message: `${method} ${url} [network error]`,
-                level: "error",
-                data: {
-                    method,
-                    url,
-                    error: error instanceof Error ? error.message : String(error),
-                },
-            });
-            throw error;
-        }
-    };
-    return () => {
-        window.fetch = origFetch;
-    };
-}
-// ─── Console ────────────────────────────────────────────────────────────
-function captureConsole(onBreadcrumb) {
-    const origError = console.error.bind(console);
-    const origWarn = console.warn.bind(console);
-    console.error = (...args) => {
-        onBreadcrumb({
-            category: "console",
-            message: args.map(String).join(" ").slice(0, 200),
-            level: "error",
-        });
-        origError(...args);
-    };
-    console.warn = (...args) => {
-        onBreadcrumb({
-            category: "console",
-            message: args.map(String).join(" ").slice(0, 200),
-            level: "warning",
+                throw cause;
+            },
         });
-        origWarn(...args);
     };
     return () => {
-        console.error = origError;
-        console.warn = origWarn;
+        window.fetch = origFetch;
     };
 }

package/dist/client.d.ts

@@ -1,15 +1,6 @@
-/**
- * BrowserClient — the core SDK client for browser environments.
- *
- * Manages:
- *   - Configuration with sensible defaults
- *   - User context, tags, and breadcrumbs
- *   - Web Vitals collection (via vitals.ts)
- *   - Global error capture (via errors.ts)
- *   - Auto-capture breadcrumbs (via autocapture.ts)
- *   - Transport (via transport.ts)
- */
-import type { Breadcrumb, BrowserConfig, BrowserErrorEvent, JsonObject, Level, UserContext } from "./types";
+import { type BrowserClientRuntime } from "./runtime/client.js";
+import type { Breadcrumb, BrowserConfig, BrowserErrorEvent, JsonObject, Level, UserContext } from "./types.js";
+import { type ExternalVitalInput } from "./vitals.js";
 export declare class BrowserClient {
     private config;
     private transport;
@@ -19,12 +10,13 @@ export declare class BrowserClient {
     private disabled;
     private cleanups;
     private replayRecorder;
-    constructor(config: BrowserConfig);
+    private vitalsHandle;
+    constructor(config: BrowserConfig, runtime?: BrowserClientRuntime);
     setUser(user: UserContext | undefined): void;
     setTag(key: string, value: string): void;
     setTags(tags: Record<string, string>): void;
     addBreadcrumb(crumb: Omit<Breadcrumb, "timestamp">): void;
-    captureError(error: Error, extra?: Record<string, unknown>): void;
+    captureError(error: Error, extra?: JsonObject): void;
     captureMessage(message: string, level?: Level): void;
     captureTelemetry(event: BrowserErrorEvent): void;
     track(eventName: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
@@ -34,12 +26,13 @@ export declare class BrowserClient {
     captureSpan(name: string, context?: Partial<BrowserErrorEvent>): void;
     captureToolCall(name: string, context?: Partial<BrowserErrorEvent>): void;
     captureGeneration(message: string, context?: Partial<BrowserErrorEvent>): void;
-    /**
-     * Flush remaining vitals and stop all timers.
-     * Call this before unmounting a SPA or during cleanup.
-     */
+    /** Record a web vital from an external collector (e.g. Next.js `useReportWebVitals`). */
+    recordWebVital(metric: ExternalVitalInput, route?: string): void;
+    /** Stop the SDK's native `web-vitals` collector to avoid double-counting. */
+    suppressNativeVitalsCollection(): void;
+    private vitalsConfig;
+    /** Flush vitals and stop timers. Call before unmounting a SPA. */
     close(): void;
-    private shouldSample;
     /** Enrich an error event with current context and send it. */
     private sendErrorEvent;
 }

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,KAAK,EAEL,WAAW,EACZ,MAAM,SAAS,CAAC;AAiDjB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,cAAc,CAA+B;gBAEzC,MAAM,EAAE,aAAa;IAmFjC,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;IAI5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI3C,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI;IAYzD,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,KAAc,GAAG,IAAI;IAI5D,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAMhD,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,IAAI;IAIP,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,IAAI;IAKP,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAI3F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAI7F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAIzE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAI7E,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAMlF;;;OAGG;IACH,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,YAAY;IAMpB,8DAA8D;IAC9D,OAAO,CAAC,cAAc;CAcvB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,qBAAqB,CAAC;AAa7B,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,KAAK,EACL,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAoB,KAAK,kBAAkB,EAA8B,MAAM,aAAa,CAAC;AAEpG,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,YAAY,CAAsC;gBAE9C,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,oBAAkD;IA4F9F,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;IAI5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI3C,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI;IAUzD,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI;IAIpD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,KAAc,GAAG,IAAI;IAI5D,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAKhD,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,IAAI;IAIP,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,IAAI;IAKP,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAI3F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAI7F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAIzE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAI7E,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,IAAI;IAIlF,yFAAyF;IACzF,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAMhE,6EAA6E;IAC7E,8BAA8B,IAAI,IAAI;IAItC,OAAO,CAAC,YAAY;IAKpB,kEAAkE;IAClE,KAAK,IAAI,IAAI;IAWb,8DAA8D;IAC9D,OAAO,CAAC,cAAc;CAqBvB"}

package/dist/client.js

@@ -1,43 +1,10 @@
-/**
- * BrowserClient — the core SDK client for browser environments.
- *
- * Manages:
- *   - Configuration with sensible defaults
- *   - User context, tags, and breadcrumbs
- *   - Web Vitals collection (via vitals.ts)
- *   - Global error capture (via errors.ts)
- *   - Auto-capture breadcrumbs (via autocapture.ts)
- *   - Transport (via transport.ts)
- */
-import { installAutocapture } from "./autocapture";
-import { buildErrorEvent, buildMessageEvent, installGlobalErrorHandlers } from "./errors";
-import { ReplayRecorder } from "./replay";
-import { buildGenerationEvent, buildIdentifyEvent, buildPageEvent, buildScreenEvent, buildSpanEvent, buildToolCallEvent, buildTrackEvent, mergeIdentifiedUser, prepareBrowserEvent, } from "./telemetry";
-import { Transport } from "./transport";
-import { startVitalsCollection } from "./vitals";
-const DEFAULT_ENDPOINT = "https://ingest.squasher.ai";
-function resolveConfig(config) {
-    return {
-        apiKey: config.apiKey,
-        projectId: config.projectId,
-        endpoint: config.endpoint ?? DEFAULT_ENDPOINT,
-        environment: config.environment,
-        release: config.release,
-        debug: config.debug ?? false,
-        sampleRate: config.sampleRate ?? 1,
-        vitalsSampleRate: config.vitalsSampleRate ?? 1,
-        enableVitals: config.enableVitals ?? true,
-        enableErrorCapture: config.enableErrorCapture ?? true,
-        enableAutoBreadcrumbs: config.enableAutoBreadcrumbs ?? true,
-        beforeSend: config.beforeSend,
-        maxBreadcrumbs: config.maxBreadcrumbs ?? 30,
-        vitalsBufferSize: config.vitalsBufferSize ?? 10,
-        vitalsFlushIntervalMs: config.vitalsFlushIntervalMs ?? 10_000,
-        replayEnabled: config.replay?.enabled ?? false,
-        replaySampleRate: config.replay?.sampleRate ?? 1,
-        replayPrivacy: config.replay?.privacy,
-    };
-}
+import { shouldSampleTelemetry } from "@squasher-ai/sdk-core";
+import { resolveConfig } from "./config.js";
+import { buildErrorEvent, buildMessageEvent } from "./errors.js";
+import { defaultBrowserClientRuntime, } from "./runtime/client.js";
+import { getSessionId } from "./session.js";
+import { buildGenerationEvent, buildIdentifyEvent, buildPageEvent, buildScreenEvent, buildSpanEvent, buildToolCallEvent, buildTrackEvent, mergeIdentifiedUser, prepareBrowserEvent, } from "./telemetry.js";
+import { mapExternalVital } from "./vitals.js";
 export class BrowserClient {
     config;
     transport;
@@ -47,7 +14,8 @@ export class BrowserClient {
     disabled;
     cleanups = [];
     replayRecorder = null;
-    constructor(config) {
+    vitalsHandle = null;
+    constructor(config, runtime = defaultBrowserClientRuntime) {
         if (!config.apiKey)
             throw new Error("Squasher: apiKey is required");
         if (!config.projectId)
@@ -58,8 +26,7 @@ export class BrowserClient {
             if (this.config.debug) {
                 console.warn("[squasher] SDK initialized in disabled mode");
             }
-            // Create a no-op transport
-            this.transport = new Transport({
+            this.transport = runtime.createTransport({
                 endpoint: this.config.endpoint,
                 projectId: this.config.projectId,
                 apiKey: this.config.apiKey,
@@ -69,8 +36,7 @@ export class BrowserClient {
             });
             return;
         }
-        // Initialize transport
-        this.transport = new Transport({
+        this.transport = runtime.createTransport({
             endpoint: this.config.endpoint,
             projectId: this.config.projectId,
             apiKey: this.config.apiKey,
@@ -78,36 +44,45 @@ export class BrowserClient {
             vitalsBufferSize: this.config.vitalsBufferSize,
             vitalsFlushIntervalMs: this.config.vitalsFlushIntervalMs,
         });
-        // Start Web Vitals collection
         if (this.config.enableVitals) {
-            startVitalsCollection(this.transport, {
+            this.vitalsHandle = runtime.startVitalsCollection(this.transport, {
                 sampleRate: this.config.vitalsSampleRate,
                 environment: this.config.environment,
                 release: this.config.release,
                 debug: this.config.debug,
             });
         }
-        // Install global error handlers
         if (this.config.enableErrorCapture) {
-            const cleanup = installGlobalErrorHandlers((event) => {
+            const cleanup = runtime.installGlobalErrorHandlers((event) => {
                 this.sendErrorEvent(event);
             });
             this.cleanups.push(cleanup);
         }
-        // Install auto-capture breadcrumbs
-        if (this.config.enableAutoBreadcrumbs) {
-            const cleanup = installAutocapture((crumb) => {
+        if (this.config.enableAutoBreadcrumbs || this.config.captureConsoleErrors) {
+            const cleanup = runtime.installAutocapture((crumb) => {
                 this.addBreadcrumb(crumb);
+            }, {
+                captureBreadcrumbs: this.config.enableAutoBreadcrumbs,
+                onConsoleError: this.config.captureConsoleErrors
+                    ? (event) => {
+                        this.sendErrorEvent(event);
+                    }
+                    : undefined,
             });
             this.cleanups.push(cleanup);
         }
         if (this.config.replayEnabled) {
-            this.replayRecorder = new ReplayRecorder({
+            this.replayRecorder = runtime.createReplayRecorder({
                 endpoint: this.config.endpoint,
                 projectId: this.config.projectId,
                 apiKey: this.config.apiKey,
                 debug: this.config.debug,
                 sampleRate: this.config.replaySampleRate,
+                environment: this.config.environment,
+                release: this.config.release,
+                getDistinctId: () => this.user?.id,
+                getUserId: () => this.user?.id,
+                getVisitorId: () => getSessionId(),
                 privacy: this.config.replayPrivacy,
             });
         }
@@ -117,11 +92,11 @@ export class BrowserClient {
                 vitals: this.config.enableVitals,
                 errorCapture: this.config.enableErrorCapture,
                 autoBreadcrumbs: this.config.enableAutoBreadcrumbs,
+                consoleErrors: this.config.captureConsoleErrors,
                 replay: this.config.replayEnabled,
             });
         }
     }
-    // ─── Context ──────────────────────────────────────────────────────────
     setUser(user) {
         this.user = user;
     }
@@ -140,7 +115,6 @@ export class BrowserClient {
             this.breadcrumbs = this.breadcrumbs.slice(-this.config.maxBreadcrumbs);
         }
     }
-    // ─── Capture ──────────────────────────────────────────────────────────
     captureError(error, extra) {
         this.captureTelemetry(buildErrorEvent(error, extra));
     }
@@ -150,8 +124,6 @@ export class BrowserClient {
     captureTelemetry(event) {
         if (this.disabled)
             return;
-        if (!this.shouldSample())
-            return;
         this.sendErrorEvent(event);
     }
     track(eventName, properties, context = {}) {
@@ -176,11 +148,22 @@ export class BrowserClient {
     captureGeneration(message, context = {}) {
         this.captureTelemetry(buildGenerationEvent(message, context));
     }
-    // ─── Lifecycle ────────────────────────────────────────────────────────
-    /**
-     * Flush remaining vitals and stop all timers.
-     * Call this before unmounting a SPA or during cleanup.
-     */
+    /** Record a web vital from an external collector (e.g. Next.js `useReportWebVitals`). */
+    recordWebVital(metric, route) {
+        if (this.disabled)
+            return;
+        const event = mapExternalVital(metric, this.vitalsConfig(), route);
+        this.transport.enqueueVital(event);
+    }
+    /** Stop the SDK's native `web-vitals` collector to avoid double-counting. */
+    suppressNativeVitalsCollection() {
+        this.vitalsHandle?.suppress();
+    }
+    vitalsConfig() {
+        const { vitalsSampleRate: sampleRate, environment, release, debug } = this.config;
+        return { sampleRate, environment, release, debug };
+    }
+    /** Flush vitals and stop timers. Call before unmounting a SPA. */
     close() {
         this.replayRecorder?.dispose();
         this.replayRecorder = null;
@@ -190,14 +173,6 @@ export class BrowserClient {
         this.cleanups = [];
         this.transport.dispose();
     }
-    // ─── Private ──────────────────────────────────────────────────────────
-    shouldSample() {
-        if (this.config.sampleRate >= 1)
-            return true;
-        if (this.config.sampleRate <= 0)
-            return false;
-        return Math.random() < this.config.sampleRate;
-    }
     /** Enrich an error event with current context and send it. */
     sendErrorEvent(event) {
         const prepared = prepareBrowserEvent(event, {
@@ -208,8 +183,17 @@ export class BrowserClient {
             tags: this.tags,
             user: this.user,
         });
-        if (prepared) {
-            this.transport.sendEvent(prepared);
+        if (!prepared)
+            return;
+        if (!this.config.debug && !shouldSampleTelemetry(prepared, this.config.sampling)) {
+            if (!prepared.measurements?.length)
+                return;
+            this.transport.sendEvent({
+                ...prepared,
+                attributes: { ...prepared.attributes, "squasher.sampled": false },
+            });
+            return;
         }
+        this.transport.sendEvent(prepared);
     }
 }

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+import { type ResolvedTelemetrySampling } from "@squasher-ai/sdk-core";
+import type { BrowserConfig, BrowserErrorEvent, ReplayPrivacyConfig } from "./types.js";
+export interface ResolvedConfig {
+    apiKey: string;
+    projectId: string;
+    endpoint: string;
+    environment?: string;
+    release?: string;
+    debug: boolean;
+    sampling: ResolvedTelemetrySampling;
+    vitalsSampleRate: number;
+    enableVitals: boolean;
+    enableErrorCapture: boolean;
+    enableAutoBreadcrumbs: boolean;
+    captureConsoleErrors: boolean;
+    beforeSend?: (event: BrowserErrorEvent) => BrowserErrorEvent | null;
+    maxBreadcrumbs: number;
+    vitalsBufferSize: number;
+    vitalsFlushIntervalMs: number;
+    replayEnabled: boolean;
+    replaySampleRate: number;
+    replayPrivacy?: ReplayPrivacyConfig;
+}
+export declare function resolveConfig(config: BrowserConfig): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAExF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,yBAAyB,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,CAAC;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAwBnE"}

package/dist/config.js

@@ -0,0 +1,26 @@
+import { DEFAULT_INGEST_ENDPOINT, detectRelease, resolveDebugFlag, resolveTelemetrySampling, } from "@squasher-ai/sdk-core";
+export function resolveConfig(config) {
+    return {
+        apiKey: config.apiKey,
+        projectId: config.projectId,
+        endpoint: config.endpoint ?? DEFAULT_INGEST_ENDPOINT,
+        environment: config.environment,
+        // In the browser, detectRelease only picks up build-time-injected vars
+        // (Next.js inlines `process.env.NEXT_PUBLIC_*` etc).
+        release: config.release ?? detectRelease() ?? undefined,
+        debug: resolveDebugFlag(config.debug),
+        sampling: resolveTelemetrySampling(config.sampling),
+        vitalsSampleRate: config.vitalsSampleRate ?? 1,
+        enableVitals: config.enableVitals ?? true,
+        enableErrorCapture: config.enableErrorCapture ?? true,
+        enableAutoBreadcrumbs: config.enableAutoBreadcrumbs ?? true,
+        captureConsoleErrors: config.captureConsoleErrors ?? false,
+        beforeSend: config.beforeSend,
+        maxBreadcrumbs: config.maxBreadcrumbs ?? 30,
+        vitalsBufferSize: config.vitalsBufferSize ?? 10,
+        vitalsFlushIntervalMs: config.vitalsFlushIntervalMs ?? 10_000,
+        replayEnabled: config.replay?.enabled ?? true,
+        replaySampleRate: config.replay?.sampleRate ?? 1,
+        replayPrivacy: config.replay?.privacy,
+    };
+}

package/dist/console-capture.d.ts

@@ -0,0 +1,8 @@
+import type { Breadcrumb, BrowserErrorEvent } from "./types.js";
+export type BreadcrumbCallback = (crumb: Omit<Breadcrumb, "timestamp">) => void;
+export interface ConsoleCaptureOptions {
+    captureBreadcrumbs: boolean;
+    onConsoleError?: (event: BrowserErrorEvent) => void;
+}
+export declare function captureConsole(onBreadcrumb: BreadcrumbCallback, options: ConsoleCaptureOptions): () => void;
+//# sourceMappingURL=console-capture.d.ts.map

package/dist/console-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-capture.d.ts","sourceRoot":"","sources":["../src/console-capture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGhE,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACrD;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,qBAAqB,GAC7B,MAAM,IAAI,CAkCZ"}