@squasher-ai/browser 0.1.0 → 0.2.0

package/dist/replay-retry.js

@@ -0,0 +1,193 @@
+import { attemptAsync } from "@squasher-ai/result-utils";
+import { getDefaultHeaders, nextBackoffMs } from "@squasher-ai/sdk-core";
+const MAX_ATTEMPTS = 3;
+const MAX_BACKOFF_MS = 4_000;
+const MAX_PENDING_PAYLOADS = 10;
+const SDK_NAME = "@squasher-ai/browser";
+const SDK_VERSION = "0.2.0";
+const DEFAULT_TELEMETRY_HEADERS = getDefaultHeaders({
+    packageName: SDK_NAME,
+    packageVersion: SDK_VERSION,
+});
+/**
+ * Compute next-attempt backoff. Delegates the math + Retry-After parsing to
+ * sdk-core's `nextBackoffMs` so every Squasher SDK shares one
+ * implementation. We keep the replay-specific 4-second cap because replay
+ * payloads are bursty and a longer wait throws off the page-unload window.
+ */
+function backoffForAttempt(attempts, headers) {
+    // sdk-core uses 0-indexed attempts; this module uses 1-indexed (1st retry).
+    return Math.round(nextBackoffMs({
+        attempt: attempts - 1,
+        headers: headers ?? undefined,
+        maxSleepMs: MAX_BACKOFF_MS,
+    }));
+}
+/**
+ * In-memory retry queue for replay payloads.
+ *
+ * Semantics:
+ * - Enqueue a payload; `flush()` tries to send the oldest pending job.
+ * - Successful 2xx -> drop the job.
+ * - 4xx (except 429) -> drop the job (non-retryable client error).
+ * - 5xx, 429, or network error -> increment attempts; reschedule with
+ *   exponential backoff (1s, 2s, 4s). After MAX_ATTEMPTS, the job is dropped.
+ * - Concurrency: a `sending` flag prevents two concurrent `flush` runs from
+ *   double-sending the same head-of-queue job.
+ * - Queue length is capped at MAX_PENDING_PAYLOADS to bound memory.
+ */
+export class ReplayUploader {
+    client;
+    queue = [];
+    sending = false;
+    activeController = null;
+    retryTimer = null;
+    disposed = false;
+    constructor(client) {
+        this.client = client;
+    }
+    enqueue(body) {
+        if (this.disposed)
+            return;
+        if (this.queue.length >= MAX_PENDING_PAYLOADS) {
+            if (this.client.debug) {
+                console.warn("[squasher] Replay retry queue full; dropping oldest payload");
+            }
+            this.queue.splice(this.oldestDroppableIndex(), 1);
+        }
+        this.queue.push({ body, attempts: 0 });
+        void this.flush();
+    }
+    /**
+     * Returns every payload body and clears the queue. The active fetch is
+     * aborted first so pagehide can transfer ownership of the head payload to
+     * sendBeacon instead of losing the initial replay snapshot on navigation.
+     */
+    drain() {
+        this.activeController?.abort();
+        this.activeController = null;
+        const bodies = this.queue.map((job) => job.body);
+        this.queue.length = 0;
+        if (this.retryTimer) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = null;
+        }
+        return bodies;
+    }
+    oldestDroppableIndex() {
+        return this.sending && this.queue.length > 1 ? 1 : 0;
+    }
+    dispose() {
+        this.disposed = true;
+        this.activeController?.abort();
+        this.activeController = null;
+        this.queue.length = 0;
+        if (this.retryTimer) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = null;
+        }
+    }
+    async flush() {
+        if (this.sending || this.disposed)
+            return;
+        if (this.queue.length === 0)
+            return;
+        if (this.retryTimer)
+            return; // waiting for scheduled retry
+        this.sending = true;
+        try {
+            const job = this.queue[0];
+            if (!job)
+                return;
+            const controller = new AbortController();
+            this.activeController = controller;
+            const outcome = await this.send(job.body, controller.signal);
+            if (this.activeController === controller) {
+                this.activeController = null;
+            }
+            if (this.queue[0] === job) {
+                if (outcome.kind === "success") {
+                    this.queue.shift();
+                }
+                else if (outcome.kind === "drop") {
+                    this.queue.shift();
+                    if (this.client.debug) {
+                        console.warn(`[squasher] Replay upload failed with non-retryable status; dropping payload (${outcome.reason})`);
+                    }
+                }
+                else {
+                    job.attempts += 1;
+                    if (job.attempts >= MAX_ATTEMPTS) {
+                        this.queue.shift();
+                        if (this.client.debug) {
+                            console.warn(`[squasher] Replay upload exhausted ${MAX_ATTEMPTS} attempts; dropping payload`);
+                        }
+                    }
+                    else {
+                        const delay = backoffForAttempt(job.attempts, outcome.retryHeaders);
+                        this.scheduleRetry(delay);
+                        return;
+                    }
+                }
+            }
+        }
+        finally {
+            this.sending = false;
+        }
+        if (this.queue.length > 0 && !this.retryTimer) {
+            void this.flush();
+        }
+    }
+    scheduleRetry(delayMs) {
+        if (this.retryTimer)
+            return;
+        this.retryTimer = setTimeout(() => {
+            this.retryTimer = null;
+            void this.flush();
+        }, delayMs);
+    }
+    async send(body, signal) {
+        const result = await attemptAsync({
+            try: async () => {
+                const response = await fetch(this.client.url, {
+                    method: "POST",
+                    headers: {
+                        ...DEFAULT_TELEMETRY_HEADERS,
+                        "Content-Type": "application/json",
+                        "x-squasher-key": this.client.headerKey,
+                    },
+                    body,
+                    signal,
+                });
+                return response;
+            },
+            catch: ({ cause }) => {
+                if (this.client.debug) {
+                    console.warn("[squasher] Replay upload network error:", cause);
+                }
+                return null;
+            },
+        });
+        if (!result) {
+            return { kind: "retry", retryHeaders: null };
+        }
+        if (result.status >= 200 && result.status < 300) {
+            if (this.client.debug) {
+                console.log("[squasher] Replay events sent via fetch");
+            }
+            return { kind: "success" };
+        }
+        if (result.status === 429) {
+            // Hand the response Headers straight to sdk-core's nextBackoffMs so it
+            // can read Retry-After-Ms or Retry-After (seconds or HTTP-date).
+            return {
+                kind: "retry",
+                retryHeaders: result.headers,
+            };
+        }
+        if (result.status >= 500) {
+            return { kind: "retry", retryHeaders: null };
+        }
+        return { kind: "drop", reason: `HTTP ${result.status}` };
+    }
+}

package/dist/replay.d.ts

@@ -1,10 +1,16 @@
-import type { ReplayPrivacyConfig } from "./types";
-interface ReplayRecorderConfig {
+import { type ReplayRecorderRuntime } from "./runtime/replay.js";
+import type { ReplayPrivacyConfig } from "./types.js";
+export interface ReplayRecorderConfig {
     endpoint: string;
     projectId: string;
     apiKey: string;
     debug: boolean;
     sampleRate: number;
+    environment?: string;
+    release?: string;
+    getDistinctId?: () => string | undefined;
+    getUserId?: () => string | undefined;
+    getVisitorId?: () => string | undefined;
     privacy?: ReplayPrivacyConfig;
 }
 export declare class ReplayRecorder {
@@ -13,18 +19,25 @@ export declare class ReplayRecorder {
     private readonly startedAt;
     private readonly cleanups;
     private readonly config;
+    private readonly runtime;
     private buffer;
+    private bufferBytes;
     private flushTimer;
     private stopRecording;
     private disposed;
-    constructor(config: ReplayRecorderConfig);
+    private readonly uploader;
+    constructor(config: ReplayRecorderConfig, runtime?: ReplayRecorderRuntime);
     dispose(): void;
     private start;
     private enqueue;
     private flushBufferedEvents;
+    /**
+     * Terminal flush during pagehide/beforeunload. Tries sendBeacon first for the
+     * current buffer and any pending retries, then falls back to keepalive fetch.
+     */
+    private finalFlush;
+    private buildPayloadBody;
     private buildReplayUrl;
     private trySendBeacon;
-    private sendFetch;
 }
-export {};
 //# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAWnD,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAwBD,qBAAa,cAAc;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,oBAAoB;IAcxC,OAAO,IAAI,IAAI;YAuBD,KAAK;IA8CnB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;YAaP,SAAS;CAqBxB"}
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAgBtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAyCD,qBAAa,cAAc;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,MAAM,EAAE,oBAAoB,EAAE,OAAO,wBAA+B;IAoBhF,OAAO,IAAI,IAAI;YAwBD,KAAK;IA6DnB,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,mBAAmB;IAgB3B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;CAatB"}

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