@squasher-ai/browser 0.1.0 → 0.2.0

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"}

package/dist/console-capture.js

@@ -0,0 +1,79 @@
+import { buildErrorEvent, buildMessageEvent } from "./errors.js";
+export function captureConsole(onBreadcrumb, options) {
+    const origError = console.error.bind(console);
+    const origWarn = console.warn.bind(console);
+    console.error = (...args) => {
+        if (!isInternalSquasherConsole(args)) {
+            const message = formatConsoleArgs(args);
+            if (options.captureBreadcrumbs) {
+                onBreadcrumb({
+                    category: "console",
+                    message: message.slice(0, 200),
+                    level: "error",
+                });
+            }
+            options.onConsoleError?.(buildConsoleErrorEvent(args, message));
+        }
+        origError(...args);
+    };
+    console.warn = (...args) => {
+        if (options.captureBreadcrumbs && !isInternalSquasherConsole(args)) {
+            onBreadcrumb({
+                category: "console",
+                message: formatConsoleArgs(args).slice(0, 200),
+                level: "warning",
+            });
+        }
+        origWarn(...args);
+    };
+    return () => {
+        console.error = origError;
+        console.warn = origWarn;
+    };
+}
+function buildConsoleErrorEvent(args, message) {
+    const error = args.find((arg) => arg instanceof Error);
+    if (error instanceof Error) {
+        const event = buildErrorEvent(error, {
+            argument_count: args.length,
+            source: "console",
+        });
+        event.message = message || event.message;
+        event.type = event.type === "Error" ? "ConsoleError" : `ConsoleError(${event.type})`;
+        return event;
+    }
+    const event = buildMessageEvent(message || "console.error", "error");
+    event.type = "ConsoleError";
+    event.extra = {
+        argument_count: args.length,
+        source: "console",
+    };
+    return event;
+}
+function isInternalSquasherConsole(args) {
+    const first = args[0];
+    return (Object.prototype.toString.call(first) === "[object String]" &&
+        String(first).startsWith("[squasher]"));
+}
+function formatConsoleArgs(args) {
+    return args.map(formatConsoleArg).join(" ").slice(0, 1_000);
+}
+function formatConsoleArg(arg) {
+    if (arg instanceof Error) {
+        return `${arg.name}: ${arg.message}`;
+    }
+    if (arg === null) {
+        return "null";
+    }
+    if (arg === undefined) {
+        return "undefined";
+    }
+    const tag = Object.prototype.toString.call(arg);
+    if (tag === "[object String]" ||
+        tag === "[object Number]" ||
+        tag === "[object Boolean]" ||
+        tag === "[object BigInt]") {
+        return String(arg);
+    }
+    return Object.prototype.toString.call(arg);
+}

package/dist/errors.d.ts

@@ -8,7 +8,7 @@
  * Parses Error.stack into StackFrame[] using the same regex pattern as
  * @squasher-ai/node. In-app heuristic: node_modules = not in_app.
  */
-import type { BrowserErrorEvent, StackFrame } from "./types";
+import type { BrowserErrorEvent, JsonObject, StackFrame } from "./types.js";
 /**
  * Parse an Error.stack string into structured StackFrame[].
  */
@@ -16,7 +16,7 @@ export declare function parseStack(stack?: string): StackFrame[] | undefined;
 /**
  * Build a BrowserErrorEvent from an Error object.
  */
-export declare function buildErrorEvent(error: Error, extra?: Record<string, unknown>): BrowserErrorEvent;
+export declare function buildErrorEvent(error: Error, extra?: JsonObject): BrowserErrorEvent;
 /**
  * Build a BrowserErrorEvent from a string message.
  */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW7D;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,SAAS,CAkCnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAWhG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAAiB,CAAC,OAAO,CAAU,GACzC,iBAAiB,CAOnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC1C,MAAM,IAAI,CAuCZ"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW5E;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,SAAS,CA8BnE;AAWD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAWnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAAiB,CAAC,OAAO,CAAU,GACzC,iBAAiB,CAOnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC1C,MAAM,IAAI,CAuCZ"}

package/dist/errors.js

@@ -9,7 +9,7 @@
  * @squasher-ai/node. In-app heuristic: node_modules = not in_app.
  */
 const SDK_NAME = "@squasher-ai/browser";
-const SDK_VERSION = "0.1.0";
+const SDK_VERSION = "0.2.0";
 /** Stack trace line regex — works for V8 (Chrome, Node) and SpiderMonkey (Firefox). */
 const STACK_LINE_RE = /^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?/;
 /** Firefox stack format: "functionName@filename:line:col" */
@@ -33,10 +33,7 @@ export function parseStack(stack) {
         if (!match)
             continue;
         const [, fn, filename, lineno, colno] = match;
-        const isExternal = filename?.includes("node_modules") ||
-            filename?.includes("extensions/") ||
-            filename?.startsWith("chrome-extension://") ||
-            false;
+        const isExternal = isExternalFilename(filename);
         frames.push({
             function: fn || "<anonymous>",
             filename,
@@ -47,6 +44,12 @@ export function parseStack(stack) {
     }
     return frames.length > 0 ? frames : undefined;
 }
+function isExternalFilename(filename) {
+    return (filename?.includes("node_modules") ||
+        filename?.includes("extensions/") ||
+        filename?.startsWith("chrome-extension://") ||
+        false);
+}
 /**
  * Build a BrowserErrorEvent from an Error object.
  */

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  *   - Core Web Vitals (LCP, CLS, INP, FCP, TTFB)
  *   - JavaScript errors (window.onerror, unhandledrejection)
  *   - Navigation breadcrumbs, click breadcrumbs, fetch error breadcrumbs
+ *   - Optional console.error events
  *   - Session context for error ↔ vitals correlation
  *
  * Usage:
@@ -21,42 +22,8 @@
  *   // Manual capture:
  *   captureError(new Error('Something went wrong'));
  */
-export { BrowserClient } from "./client";
-export type { AnalyticsContext, Breadcrumb, BrowserConfig, BrowserErrorEvent, DeviceType, IngestBatchPayload, IngestResponse, JsonObject, LlmContext, Level, PageContext, ReplayConfig, ReplayPrivacyConfig, SessionContext, StackFrame, TelemetryKind, TelemetryMeasurement, ToolCallContext, UserContext, VitalEvent, VitalMetricName, VitalRating, TraceContext, VisitorContext, VitalsPayload, } from "./types";
-import { BrowserClient } from "./client";
-import type { Breadcrumb, BrowserConfig, BrowserErrorEvent, JsonObject, Level, UserContext } from "./types";
-/** Initialize the global Squasher browser client. Throws if called twice. */
-export declare function init(config: BrowserConfig): BrowserClient;
-/** Get the global client (throws if not initialized). */
-export declare function getClient(): BrowserClient;
-/** Capture an error using the global client. */
-export declare function captureError(error: Error, extra?: Record<string, unknown>): void;
-/** Capture a message using the global client. */
-export declare function captureMessage(message: string, level?: Level): void;
-/** Capture a generalized telemetry event using the global client. */
-export declare function captureTelemetry(event: BrowserErrorEvent): void;
-/** Track a product analytics event using the global client. */
-export declare function track(eventName: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Identify a distinct user or visitor using the global client. */
-export declare function identify(distinctId: string, traits?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Capture a page navigation event using the global client. */
-export declare function page(name: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Capture a screen event using the global client. */
-export declare function screen(name: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Capture an agent span using the global client. */
-export declare function captureSpan(name: string, context?: Partial<BrowserErrorEvent>): void;
-/** Capture a tool call using the global client. */
-export declare function captureToolCall(name: string, context?: Partial<BrowserErrorEvent>): void;
-/** Capture an LLM generation event using the global client. */
-export declare function captureGeneration(message: string, context?: Partial<BrowserErrorEvent>): void;
-/** Set user context on the global client. */
-export declare function setUser(user: UserContext | undefined): void;
-/** Set a single tag on the global client. */
-export declare function setTag(key: string, value: string): void;
-/** Set multiple tags on the global client. */
-export declare function setTags(tags: Record<string, string>): void;
-/** Add a breadcrumb on the global client. */
-export declare function addBreadcrumb(crumb: Omit<Breadcrumb, "timestamp">): void;
-/** Close the global client (stop timers, flush vitals, remove handlers). */
-export declare function close(): void;
+export { BrowserClient } from "./client.js";
+export { addBreadcrumb, captureError, captureGeneration, captureMessage, captureSpan, captureTelemetry, captureToolCall, close, getClient, identify, init, page, screen, setTag, setTags, setUser, track, } from "./runtime/client-singleton.js";
+export { createSpanId, createTraceContext, createTraceId } from "./trace-context.js";
+export type { AnalyticsContext, Breadcrumb, BrowserConfig, BrowserErrorEvent, DeviceType, IngestBatchPayload, IngestResponse, JsonObject, Level, LlmContext, PageContext, ReplayConfig, ReplayPrivacyConfig, SessionContext, StackFrame, TelemetryKind, TelemetryMeasurement, ToolCallContext, TraceContext, UserContext, VisitorContext, VitalEvent, VitalMetricName, VitalRating, VitalsPayload, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,KAAK,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC"}