@squasher-ai/browser 0.1.1 → 0.2.0

package/dist/replay.js

@@ -1,7 +1,25 @@
-import { getSessionId } from "./session";
-import { applyReplayEventPrivacy, buildReplayRecordOptions } from "./replay-privacy";
-const REPLAY_BUFFER_LIMIT = 50;
+import { attempt } from "@squasher-ai/result-utils";
+import { applyReplayEventPrivacy, buildReplayRecordOptions } from "./replay-privacy.js";
+import { ReplayUploader } from "./replay-retry.js";
+import { defaultReplayRecorderRuntime, } from "./runtime/replay.js";
+import { getSessionId } from "./session.js";
+// Flush on the same 5s cadence Sentry uses for session-mode replays. Anything
+// shorter creates lots of tiny R2 blobs; anything longer hurts time-to-first-
+// segment on the dashboard.
 const REPLAY_FLUSH_INTERVAL_MS = 5_000;
+// Soft cap on buffered JSON bytes before we flush ahead of the timer. ~900KB
+// stays well under our worker's 5MB body limit and PostHog's ~1MB-per-event
+// guidance, while still letting a FullSnapshot ship in one segment.
+const REPLAY_FLUSH_BYTES = 900_000;
+const RRWEB_FULL_SNAPSHOT_EVENT = 2;
+function estimateEventBytes(event) {
+    try {
+        return JSON.stringify(event).length;
+    }
+    catch {
+        return 0;
+    }
+}
 function shouldRecord(sampleRate) {
     if (sampleRate >= 1)
         return true;
@@ -9,8 +27,11 @@ function shouldRecord(sampleRate) {
         return false;
     return Math.random() < sampleRate;
 }
+function isReplayFullSnapshotEvent(event) {
+    return event instanceof Object && "type" in event && event.type === RRWEB_FULL_SNAPSHOT_EVENT;
+}
 function getPageUrl() {
-    return typeof location === "undefined" ? "" : location.href;
+    return globalThis.location?.href ?? "";
 }
 export class ReplayRecorder {
     ready;
@@ -18,12 +39,21 @@ export class ReplayRecorder {
     startedAt = new Date().toISOString();
     cleanups = [];
     config;
+    runtime;
     buffer = [];
+    bufferBytes = 0;
     flushTimer = null;
     stopRecording = null;
     disposed = false;
-    constructor(config) {
+    uploader;
+    constructor(config, runtime = defaultReplayRecorderRuntime) {
         this.config = config;
+        this.runtime = runtime;
+        this.uploader = new ReplayUploader({
+            url: `${config.endpoint}/v1/projects/${config.projectId}/replays`,
+            headerKey: config.apiKey,
+            debug: config.debug,
+        });
         if (!shouldRecord(config.sampleRate)) {
             if (this.config.debug) {
                 console.log("[squasher] Replay recording skipped by sample rate");
@@ -50,70 +80,121 @@ export class ReplayRecorder {
         }
         this.cleanups.length = 0;
         this.flushBufferedEvents({ final: true, allowWhenDisposed: true });
+        this.uploader.dispose();
     }
     async start() {
-        if (typeof window === "undefined" || typeof document === "undefined") {
+        if (this.disposed || !globalThis.window || !globalThis.document) {
             return;
         }
-        const { record } = await import("rrweb");
-        if (this.disposed) {
-            return;
+        let recording;
+        try {
+            recording = await this.runtime.loadRecordingAdapter();
         }
-        const stopRecording = record(buildReplayRecordOptions({
-            emit: (event) => {
-                this.enqueue(applyReplayEventPrivacy(event, this.config.privacy));
-            },
-            privacy: this.config.privacy,
-        }));
-        if (!stopRecording) {
+        catch (error) {
+            if (this.config.debug) {
+                console.warn("[squasher] Replay recording could not start", error);
+            }
             return;
         }
-        this.stopRecording = stopRecording;
-        this.flushTimer = setInterval(() => {
-            this.flushBufferedEvents();
-        }, REPLAY_FLUSH_INTERVAL_MS);
-        const finalFlush = () => {
-            this.flushBufferedEvents({ final: true });
-        };
-        window.addEventListener("pagehide", finalFlush);
-        window.addEventListener("beforeunload", finalFlush);
-        this.cleanups.push(() => window.removeEventListener("pagehide", finalFlush));
-        this.cleanups.push(() => window.removeEventListener("beforeunload", finalFlush));
-        if (this.config.debug) {
-            console.log("[squasher] Replay recording started", {
-                sessionId: this.sessionId,
-            });
+        if (!this.disposed) {
+            const stopRecording = recording.start(buildReplayRecordOptions({
+                emit: (event) => {
+                    this.enqueue(applyReplayEventPrivacy(event, this.config.privacy));
+                },
+                privacy: this.config.privacy,
+            }));
+            if (stopRecording) {
+                this.stopRecording = stopRecording;
+                this.flushTimer = setInterval(() => {
+                    this.flushBufferedEvents();
+                }, REPLAY_FLUSH_INTERVAL_MS);
+                const finalFlush = () => {
+                    this.flushBufferedEvents({ final: true });
+                };
+                window.addEventListener("pagehide", finalFlush);
+                window.addEventListener("beforeunload", finalFlush);
+                this.cleanups.push(() => window.removeEventListener("pagehide", finalFlush));
+                this.cleanups.push(() => window.removeEventListener("beforeunload", finalFlush));
+                this.cleanups.push(this.runtime.installNetworkCapture({
+                    debug: this.config.debug,
+                    emitCustomEvent: recording.emitCustomEvent,
+                    ignoredUrlPrefixes: [
+                        `${this.config.endpoint}/v1/ingest/${this.config.projectId}`,
+                        `${this.config.endpoint}/v1/projects/${this.config.projectId}/replays`,
+                        `${this.config.endpoint}/v1/vitals/${this.config.projectId}`,
+                    ],
+                    replayStartedAtMs: new Date(this.startedAt).getTime(),
+                }));
+                if (this.config.debug) {
+                    console.log("[squasher] Replay recording started", {
+                        sessionId: this.sessionId,
+                    });
+                }
+            }
         }
     }
     enqueue(event) {
         if (this.disposed)
             return;
         this.buffer.push(event);
-        if (this.buffer.length >= REPLAY_BUFFER_LIMIT) {
+        this.bufferBytes += estimateEventBytes(event);
+        if (isReplayFullSnapshotEvent(event) || this.bufferBytes >= REPLAY_FLUSH_BYTES) {
             this.flushBufferedEvents();
         }
     }
     flushBufferedEvents(options) {
-        if (this.buffer.length === 0)
+        if (this.buffer.length === 0 && !options?.final)
             return;
         if (this.disposed && !options?.allowWhenDisposed)
             return;
+        if (options?.final) {
+            this.finalFlush();
+            return;
+        }
+        if (this.buffer.length === 0)
+            return;
         const events = this.buffer.splice(0);
+        this.bufferBytes = 0;
+        const body = this.buildPayloadBody(events);
+        this.uploader.enqueue(body);
+    }
+    /**
+     * Terminal flush during pagehide/beforeunload. Tries sendBeacon first for the
+     * current buffer and any pending retries, then falls back to keepalive fetch.
+     */
+    finalFlush() {
+        const pending = this.uploader.drain();
+        const bodies = [...pending];
+        if (this.buffer.length > 0) {
+            const events = this.buffer.splice(0);
+            this.bufferBytes = 0;
+            bodies.push(this.buildPayloadBody(events));
+        }
+        if (bodies.length === 0)
+            return;
+        const beaconUrl = this.buildReplayUrl({ beacon: true });
+        for (const body of bodies) {
+            if (!this.trySendBeacon(beaconUrl, body)) {
+                this.uploader.enqueue(body);
+            }
+            else if (this.config.debug) {
+                console.log("[squasher] Flushed replay payload via sendBeacon");
+            }
+        }
+    }
+    buildPayloadBody(events) {
         const payload = {
             session_id: this.sessionId,
             events,
             page_url: getPageUrl(),
             started_at: this.startedAt,
+            distinct_id: this.config.getDistinctId?.(),
+            user_id: this.config.getUserId?.(),
+            visitor_id: this.config.getVisitorId?.() ?? this.sessionId,
+            environment: this.config.environment,
+            release: this.config.release,
         };
-        const body = JSON.stringify(payload);
-        const url = this.buildReplayUrl();
-        if (options?.final && this.trySendBeacon(this.buildReplayUrl({ beacon: true }), body)) {
-            if (this.config.debug) {
-                console.log(`[squasher] Flushed ${events.length} replay events via sendBeacon`);
-            }
-            return;
-        }
-        void this.sendFetch(url, body);
+        return JSON.stringify(payload);
     }
     buildReplayUrl(options) {
         const baseUrl = `${this.config.endpoint}/v1/projects/${this.config.projectId}/replays`;
@@ -123,36 +204,15 @@ export class ReplayRecorder {
         return `${baseUrl}?key=${encodeURIComponent(this.config.apiKey)}`;
     }
     trySendBeacon(url, body) {
-        if (typeof navigator === "undefined" || !navigator.sendBeacon) {
-            return false;
-        }
-        try {
-            const blob = new Blob([body], { type: "application/json" });
-            return navigator.sendBeacon(url, blob);
-        }
-        catch {
+        if (!globalThis.navigator?.sendBeacon) {
             return false;
         }
-    }
-    async sendFetch(url, body) {
-        try {
-            await fetch(url, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    "x-squasher-key": this.config.apiKey,
-                },
-                body,
-                keepalive: true,
-            });
-            if (this.config.debug) {
-                console.log("[squasher] Replay events sent via fetch");
-            }
-        }
-        catch (error) {
-            if (this.config.debug) {
-                console.warn("[squasher] Failed to upload replay events:", error);
-            }
-        }
+        return attempt({
+            try: () => {
+                const blob = new Blob([body], { type: "application/json" });
+                return globalThis.navigator.sendBeacon(url, blob);
+            },
+            catch: () => false,
+        });
     }
 }

package/dist/runtime/client-singleton.d.ts

@@ -0,0 +1,25 @@
+import { BrowserClient } from "../client.js";
+import type { Breadcrumb, BrowserConfig, BrowserErrorEvent, JsonObject, Level, UserContext } from "../types.js";
+type CaptureErrorExtra = Parameters<BrowserClient["captureError"]>[1];
+/** 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;
+export declare function captureError(error: Error, extra?: CaptureErrorExtra): void;
+export declare function captureMessage(message: string, level?: Level): void;
+export declare function captureTelemetry(event: BrowserErrorEvent): void;
+export declare function track(eventName: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
+export declare function identify(distinctId: string, traits?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
+export declare function page(name: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
+export declare function screen(name: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
+export declare function captureSpan(name: string, context?: Partial<BrowserErrorEvent>): void;
+export declare function captureToolCall(name: string, context?: Partial<BrowserErrorEvent>): void;
+export declare function captureGeneration(message: string, context?: Partial<BrowserErrorEvent>): void;
+export declare function setUser(user: UserContext | undefined): void;
+export declare function setTag(key: string, value: string): void;
+export declare function setTags(tags: Record<string, string>): void;
+export declare function addBreadcrumb(crumb: Omit<Breadcrumb, "timestamp">): void;
+/** Stops timers, flushes vitals, and removes global handlers. */
+export declare function close(): void;
+export {};
+//# sourceMappingURL=client-singleton.d.ts.map

package/dist/runtime/client-singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-singleton.d.ts","sourceRoot":"","sources":["../../src/runtime/client-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,KAAK,EACL,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,KAAK,iBAAiB,GAAG,UAAU,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAItE,6EAA6E;AAC7E,wBAAgB,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAQzD;AAED,yDAAyD;AACzD,wBAAgB,SAAS,IAAI,aAAa,CAKzC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAE1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAE/D;AAED,wBAAgB,KAAK,CACnB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,IAAI,CAEN;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,IAAI,CAEN;AAED,wBAAgB,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,IAAI,CAEN;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,IAAI,CAEN;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAEpF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAExF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAE7F;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAE3D;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE1D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI,CAExE;AAED,iEAAiE;AACjE,wBAAgB,KAAK,IAAI,IAAI,CAK5B"}

package/dist/runtime/client-singleton.js

@@ -0,0 +1,66 @@
+import { BrowserClient } from "../client.js";
+let client = null;
+/** Initialize the global Squasher browser client. Throws if called twice. */
+export function init(config) {
+    if (client) {
+        throw new Error("squasher.init() called more than once. Call close() first if re-initializing.");
+    }
+    client = new BrowserClient(config);
+    return client;
+}
+/** Get the global client (throws if not initialized). */
+export function getClient() {
+    if (!client) {
+        throw new Error("Squasher not initialized. Call init() first.");
+    }
+    return client;
+}
+export function captureError(error, extra) {
+    getClient().captureError(error, extra);
+}
+export function captureMessage(message, level) {
+    getClient().captureMessage(message, level);
+}
+export function captureTelemetry(event) {
+    getClient().captureTelemetry(event);
+}
+export function track(eventName, properties, context) {
+    getClient().track(eventName, properties, context);
+}
+export function identify(distinctId, traits, context) {
+    getClient().identify(distinctId, traits, context);
+}
+export function page(name, properties, context) {
+    getClient().page(name, properties, context);
+}
+export function screen(name, properties, context) {
+    getClient().screen(name, properties, context);
+}
+export function captureSpan(name, context) {
+    getClient().captureSpan(name, context);
+}
+export function captureToolCall(name, context) {
+    getClient().captureToolCall(name, context);
+}
+export function captureGeneration(message, context) {
+    getClient().captureGeneration(message, context);
+}
+export function setUser(user) {
+    getClient().setUser(user);
+}
+export function setTag(key, value) {
+    getClient().setTag(key, value);
+}
+export function setTags(tags) {
+    getClient().setTags(tags);
+}
+export function addBreadcrumb(crumb) {
+    getClient().addBreadcrumb(crumb);
+}
+/** Stops timers, flushes vitals, and removes global handlers. */
+export function close() {
+    if (client) {
+        client.close();
+        client = null;
+    }
+}

package/dist/runtime/client.d.ts

@@ -0,0 +1,22 @@
+import { type AutocaptureOptions, type BreadcrumbCallback } from "../autocapture.js";
+import { type ReplayRecorderConfig } from "../replay.js";
+import { type TransportConfig } from "../transport.js";
+import type { BrowserErrorEvent, VitalEvent } from "../types.js";
+import { type VitalsCollectorConfig, type VitalsCollectorHandle } from "../vitals.js";
+export interface BrowserTransport {
+    dispose(): void;
+    enqueueVital(event: VitalEvent): void;
+    sendEvent(event: BrowserErrorEvent): void;
+}
+export interface ReplayRecorderHandle {
+    dispose(): void;
+}
+export interface BrowserClientRuntime {
+    createReplayRecorder(config: ReplayRecorderConfig): ReplayRecorderHandle;
+    createTransport(config: TransportConfig): BrowserTransport;
+    installAutocapture(onBreadcrumb: BreadcrumbCallback, options: AutocaptureOptions): () => void;
+    installGlobalErrorHandlers(onError: (event: BrowserErrorEvent) => void): () => void;
+    startVitalsCollection(transport: BrowserTransport, config: VitalsCollectorConfig): VitalsCollectorHandle;
+}
+export declare const defaultBrowserClientRuntime: BrowserClientRuntime;
+//# sourceMappingURL=client.d.ts.map

package/dist/runtime/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/runtime/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,IAAI,CAAC;IAChB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;IACzE,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAC3D,kBAAkB,CAAC,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAC;IAC9F,0BAA0B,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpF,qBAAqB,CACnB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CAAC;CAC1B;AAED,eAAO,MAAM,2BAA2B,EAAE,oBAMzC,CAAC"}

package/dist/runtime/client.js

@@ -0,0 +1,12 @@
+import { installAutocapture, } from "../autocapture.js";
+import { installGlobalErrorHandlers } from "../errors.js";
+import { ReplayRecorder } from "../replay.js";
+import { Transport } from "../transport.js";
+import { startVitalsCollection, } from "../vitals.js";
+export const defaultBrowserClientRuntime = {
+    createReplayRecorder: (config) => new ReplayRecorder(config),
+    createTransport: (config) => new Transport(config),
+    installAutocapture,
+    installGlobalErrorHandlers,
+    startVitalsCollection,
+};

package/dist/runtime/replay.d.ts

@@ -0,0 +1,13 @@
+import type { ReplayNetworkCaptureOptions } from "../replay-network.js";
+import type { ReplayPrivacyRecordOptions } from "../replay-privacy.js";
+export type StopRecording = () => void;
+export interface ReplayRecordingAdapter {
+    emitCustomEvent?: ReplayNetworkCaptureOptions["emitCustomEvent"];
+    start(options: ReplayPrivacyRecordOptions): StopRecording | undefined;
+}
+export interface ReplayRecorderRuntime {
+    installNetworkCapture(options: ReplayNetworkCaptureOptions): () => void;
+    loadRecordingAdapter(): Promise<ReplayRecordingAdapter>;
+}
+export declare const defaultReplayRecorderRuntime: ReplayRecorderRuntime;
+//# sourceMappingURL=replay.d.ts.map

package/dist/runtime/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/runtime/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa,GAAG,SAAS,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,IAAI,CAAC;IACxE,oBAAoB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzD;AAaD,eAAO,MAAM,4BAA4B,EAAE,qBAG1C,CAAC"}

package/dist/runtime/replay.js

@@ -0,0 +1,15 @@
+import { installReplayNetworkCapture } from "../replay-network.js";
+async function loadRecordingAdapter() {
+    const { record } = await import("rrweb");
+    const adapter = {
+        start: (options) => record(options),
+    };
+    if (record.addCustomEvent) {
+        adapter.emitCustomEvent = record.addCustomEvent;
+    }
+    return adapter;
+}
+export const defaultReplayRecorderRuntime = {
+    installNetworkCapture: installReplayNetworkCapture,
+    loadRecordingAdapter,
+};

package/dist/session.d.ts

@@ -1,13 +1,3 @@
-/**
- * Session management for the browser SDK.
- *
- * Generates a unique session ID per tab visit using crypto.randomUUID().
- * Stored in sessionStorage so it persists across SPA navigations but dies
- * when the tab closes — one session per tab visit.
- *
- * The session ID is attached to both error events and Web Vitals for
- * cross-correlation in the dashboard.
- */
 /**
  * Get (or create) the session ID for this tab.
  * Uses sessionStorage for persistence across SPA navigations.

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAOrC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAQrC"}

package/dist/session.js

@@ -1,3 +1,4 @@
+import { attempt } from "@squasher-ai/result-utils";
 /**
  * Session management for the browser SDK.
  *
@@ -18,24 +19,22 @@ let cachedSessionId = null;
 export function getSessionId() {
     if (cachedSessionId)
         return cachedSessionId;
-    try {
-        const stored = sessionStorage.getItem(SESSION_KEY);
-        if (stored) {
-            cachedSessionId = stored;
-            return stored;
-        }
-    }
-    catch {
-        // sessionStorage unavailable (e.g. SSR, sandboxed iframes)
+    const stored = attempt({
+        try: () => sessionStorage.getItem(SESSION_KEY),
+        catch: () => null,
+    });
+    if (stored) {
+        cachedSessionId = stored;
+        return stored;
     }
     const id = crypto.randomUUID();
     cachedSessionId = id;
-    try {
-        sessionStorage.setItem(SESSION_KEY, id);
-    }
-    catch {
-        // Storage full or unavailable — fall back to in-memory
-    }
+    attempt({
+        try: () => {
+            sessionStorage.setItem(SESSION_KEY, id);
+        },
+        catch: () => undefined,
+    });
     return id;
 }
 /**
@@ -43,10 +42,10 @@ export function getSessionId() {
  */
 export function resetSessionId() {
     cachedSessionId = null;
-    try {
-        sessionStorage.removeItem(SESSION_KEY);
-    }
-    catch {
-        // Ignore
-    }
+    attempt({
+        try: () => {
+            sessionStorage.removeItem(SESSION_KEY);
+        },
+        catch: () => undefined,
+    });
 }

package/dist/telemetry.d.ts

@@ -1,4 +1,4 @@
-import type { Breadcrumb, BrowserErrorEvent, JsonObject, UserContext } from "./types";
+import type { Breadcrumb, BrowserErrorEvent, JsonObject, UserContext } from "./types.js";
 interface PrepareBrowserEventInput {
     beforeSend?: (event: BrowserErrorEvent) => BrowserErrorEvent | null;
     breadcrumbs: Breadcrumb[];

package/dist/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtF,UAAU,wBAAwB;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,CAAC;IACpE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAanB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAuBnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAQnB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,wBAAwB,GAC9B,iBAAiB,GAAG,IAAI,CAkC1B"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzF,UAAU,wBAAwB;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,CAAC;IACpE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAanB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAqBnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAQnB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,wBAAwB,GAC9B,iBAAiB,GAAG,IAAI,CAkC1B"}

package/dist/telemetry.js

@@ -1,4 +1,4 @@
-import { getSessionId } from "./session";
+import { getSessionId } from "./session.js";
 export function mergeIdentifiedUser(currentUser, contextUser, distinctId) {
     return {
         ...currentUser,
@@ -54,10 +54,10 @@ export function buildPageEvent(name, properties, context) {
         page: {
             ...context.page,
             name: context.page?.name ?? name,
-            path: context.page?.path ?? (typeof location !== "undefined" ? location.pathname : undefined),
-            title: context.page?.title ?? (typeof document !== "undefined" ? document.title : undefined),
-            referrer: context.page?.referrer ?? (typeof document !== "undefined" ? document.referrer : undefined),
-            search: context.page?.search ?? (typeof location !== "undefined" ? location.search : undefined),
+            path: context.page?.path ?? globalThis.location?.pathname,
+            title: context.page?.title ?? globalThis.document?.title,
+            referrer: context.page?.referrer ?? globalThis.document?.referrer,
+            search: context.page?.search ?? globalThis.location?.search,
         },
     };
 }
@@ -126,19 +126,22 @@ export function prepareBrowserEvent(event, input) {
         environment: filtered.environment ?? input.environment,
         release: filtered.release ?? input.release,
         kind: filtered.kind ?? (filtered.level === "error" || filtered.level === "fatal" ? "error" : "log"),
-        ...(input.user ? { user: { ...input.user } } : {}),
-        ...(Object.keys(input.tags).length > 0 ? { tags: { ...input.tags, ...filtered.tags } } : {}),
-        ...(input.breadcrumbs.length > 0 ? { breadcrumbs: [...input.breadcrumbs] } : {}),
     };
+    if (input.user)
+        prepared.user = { ...input.user };
+    if (Object.keys(input.tags).length > 0)
+        prepared.tags = { ...input.tags, ...filtered.tags };
+    if (input.breadcrumbs.length > 0)
+        prepared.breadcrumbs = [...input.breadcrumbs];
     if (!prepared.visitor &&
         prepared.kind &&
         ["analytics", "identify", "page", "screen", "visitor"].includes(prepared.kind)) {
         prepared.visitor = { anonymous_id: prepared.session_id };
     }
-    if (typeof location !== "undefined") {
+    if (globalThis.location) {
         prepared.request = {
             ...prepared.request,
-            url: prepared.request?.url ?? location.href,
+            url: prepared.request?.url ?? globalThis.location.href,
         };
     }
     return prepared;

package/dist/trace-context.d.ts

@@ -0,0 +1,9 @@
+import type { TraceContext } from "./types.js";
+export declare function createTraceId(): string;
+export declare function createSpanId(): string;
+export declare function createTraceContext(parent?: Pick<TraceContext, "span_id" | "trace_id">): {
+    parent_span_id: string | undefined;
+    span_id: string;
+    trace_id: string;
+};
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,aAAa,WAE5B;AAED,wBAAgB,YAAY,WAE3B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC;;;;EAMrF"}

package/dist/trace-context.js

@@ -0,0 +1,13 @@
+export function createTraceId() {
+    return crypto.randomUUID().replaceAll("-", "");
+}
+export function createSpanId() {
+    return crypto.randomUUID().replaceAll("-", "").slice(0, 16);
+}
+export function createTraceContext(parent) {
+    return {
+        parent_span_id: parent?.span_id,
+        span_id: createSpanId(),
+        trace_id: parent?.trace_id ?? createTraceId(),
+    };
+}