@squasher-ai/browser 0.1.1 → 0.2.0

package/dist/replay-network.js

@@ -0,0 +1,193 @@
+import { attempt, attemptAsync } from "@squasher-ai/result-utils";
+import { readRuntimeNumber, readRuntimeProperty, readRuntimeString } from "@squasher-ai/sdk-core";
+const NETWORK_EVENT_TAG = "squasher:network";
+const MAX_NETWORK_EVENTS = 400;
+function clampOffset(offsetMs) {
+    return Math.max(0, Math.round(offsetMs));
+}
+function roundDuration(durationMs) {
+    return Math.max(0, Math.round(durationMs));
+}
+function readFiniteNumber(value) {
+    return value !== null && value !== undefined && Number.isFinite(value) ? value : null;
+}
+function readFiniteString(value) {
+    return value && value.length > 0 ? value : null;
+}
+function getCurrentPageUrl() {
+    return globalThis.location?.href ?? "";
+}
+function shouldIgnoreRequestUrl(requestUrl, ignoredUrlPrefixes) {
+    return ignoredUrlPrefixes.some((prefix) => requestUrl.startsWith(prefix));
+}
+function toResourceKey(payload) {
+    return [
+        payload.source,
+        payload.requestUrl,
+        payload.initiatorType,
+        payload.startOffsetMs,
+        payload.durationMs,
+    ].join("|");
+}
+function buildResourcePayload(entry, replayStartedAtMs) {
+    if (entry.entryType !== "resource" && entry.entryType !== "navigation") {
+        return null;
+    }
+    const initiatorType = readRuntimeString(readRuntimeProperty(entry, "initiatorType"));
+    const nextHopProtocol = readRuntimeString(readRuntimeProperty(entry, "nextHopProtocol"));
+    const renderBlockingStatus = readRuntimeString(readRuntimeProperty(entry, "renderBlockingStatus"));
+    const responseStatus = readRuntimeNumber(readRuntimeProperty(entry, "responseStatus"));
+    const transferSize = readRuntimeNumber(readRuntimeProperty(entry, "transferSize"));
+    const absoluteStartMs = performance.timeOrigin + entry.startTime;
+    return {
+        durationMs: roundDuration(entry.duration),
+        initiatorType: entry.entryType === "navigation"
+            ? "navigation"
+            : readFiniteString(initiatorType) || "resource",
+        pageUrl: getCurrentPageUrl(),
+        protocol: readFiniteString(nextHopProtocol),
+        requestUrl: entry.name,
+        source: "resource",
+        startOffsetMs: clampOffset(absoluteStartMs - replayStartedAtMs),
+        statusCode: readFiniteNumber(responseStatus),
+        statusText: readFiniteString(renderBlockingStatus),
+        transferSize: readFiniteNumber(transferSize),
+    };
+}
+export function installReplayNetworkCapture({ debug, emitCustomEvent, ignoredUrlPrefixes = [], replayStartedAtMs, }) {
+    if (!emitCustomEvent || !globalThis.window) {
+        return () => undefined;
+    }
+    let emittedCount = 0;
+    let customEventAvailable = true;
+    const seenResources = new Set();
+    const cleanups = [];
+    const emit = (payload) => {
+        if (!customEventAvailable || emittedCount >= MAX_NETWORK_EVENTS) {
+            return;
+        }
+        const emitted = attempt({
+            try: () => {
+                emitCustomEvent(NETWORK_EVENT_TAG, payload);
+                return true;
+            },
+            catch: ({ error }) => {
+                customEventAvailable = false;
+                if (debug) {
+                    console.warn("[squasher] Replay network event capture disabled", {
+                        error: error.message,
+                    });
+                }
+                return false;
+            },
+        });
+        if (!emitted)
+            return;
+        emittedCount += 1;
+        if (debug) {
+            console.log("[squasher] Replay network event recorded", {
+                requestUrl: payload.requestUrl,
+                source: payload.source,
+                statusCode: payload.statusCode ?? null,
+            });
+        }
+    };
+    if (globalThis.PerformanceObserver) {
+        const supportedEntryTypes = globalThis.PerformanceObserver.supportedEntryTypes ?? [];
+        const observer = new globalThis.PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                const payload = buildResourcePayload(entry, replayStartedAtMs);
+                if (!payload) {
+                    continue;
+                }
+                if (shouldIgnoreRequestUrl(payload.requestUrl, ignoredUrlPrefixes)) {
+                    continue;
+                }
+                const absoluteStartMs = performance.timeOrigin + entry.startTime;
+                if (payload.initiatorType === "fetch" && absoluteStartMs >= replayStartedAtMs) {
+                    continue;
+                }
+                const key = toResourceKey(payload);
+                if (seenResources.has(key)) {
+                    continue;
+                }
+                seenResources.add(key);
+                emit(payload);
+            }
+        });
+        attempt({
+            try: () => {
+                if (supportedEntryTypes.includes("navigation")) {
+                    observer.observe({ buffered: true, type: "navigation" });
+                }
+                if (supportedEntryTypes.includes("resource")) {
+                    observer.observe({ buffered: true, type: "resource" });
+                }
+                cleanups.push(() => observer.disconnect());
+            },
+            catch: () => {
+                observer.disconnect();
+            },
+        });
+    }
+    if (window.fetch) {
+        const originalFetch = window.fetch.bind(window);
+        window.fetch = async (input, init) => {
+            const requestStartedAtMs = Date.now();
+            const inputIsRequest = globalThis.Request && input instanceof globalThis.Request;
+            const method = init?.method?.toUpperCase() || (inputIsRequest ? input.method.toUpperCase() : "GET");
+            const requestUrl = Object.prototype.toString.call(input) === "[object String]"
+                ? String(input)
+                : input instanceof URL
+                    ? input.href
+                    : inputIsRequest
+                        ? input.url
+                        : String(input);
+            const pageUrl = getCurrentPageUrl();
+            if (shouldIgnoreRequestUrl(requestUrl, ignoredUrlPrefixes)) {
+                return originalFetch(input, init);
+            }
+            return attemptAsync({
+                try: async () => {
+                    const response = await originalFetch(input, init);
+                    emit({
+                        durationMs: roundDuration(Date.now() - requestStartedAtMs),
+                        initiatorType: "fetch",
+                        method,
+                        pageUrl,
+                        requestUrl,
+                        source: "fetch",
+                        startOffsetMs: clampOffset(requestStartedAtMs - replayStartedAtMs),
+                        statusCode: response.status,
+                        statusText: response.statusText || null,
+                        transferSize: null,
+                    });
+                    return response;
+                },
+                catch: ({ cause, error }) => {
+                    emit({
+                        durationMs: roundDuration(Date.now() - requestStartedAtMs),
+                        initiatorType: "fetch",
+                        method,
+                        pageUrl,
+                        requestUrl,
+                        source: "fetch",
+                        startOffsetMs: clampOffset(requestStartedAtMs - replayStartedAtMs),
+                        statusCode: null,
+                        statusText: error.message || "network error",
+                        transferSize: null,
+                    });
+                    throw cause;
+                },
+            });
+        };
+        cleanups.push(() => {
+            window.fetch = originalFetch;
+        });
+    }
+    return () => {
+        for (const cleanup of cleanups) {
+            cleanup();
+        }
+    };
+}

package/dist/replay-privacy.d.ts

@@ -1,5 +1,5 @@
-import type { ReplayPrivacyConfig } from "./types";
-type ReplayRecordFn = typeof import("rrweb")["record"];
+import type { ReplayPrivacyConfig } from "./types.js";
+type ReplayRecordFn = (typeof import("rrweb"))["record"];
 type ReplayRecordOptions = NonNullable<Parameters<ReplayRecordFn>[0]>;
 type ReplayEmit = NonNullable<ReplayRecordOptions["emit"]>;
 type ReplayEvent = Parameters<ReplayEmit>[0];

package/dist/replay-privacy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay-privacy.d.ts","sourceRoot":"","sources":["../src/replay-privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,KAAK,cAAc,GAAG,cAAc,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;AACvD,KAAK,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,KAAK,UAAU,GAAG,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3D,KAAK,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAc7C,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAWrD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,GAAG,0BAA0B,CAgB7B;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,WAAW,EAC3D,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,mBAAmB,GAC5B,CAAC,CASH"}
+{"version":3,"file":"replay-privacy.d.ts","sourceRoot":"","sources":["../src/replay-privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,KAAK,cAAc,GAAG,CAAC,cAAc,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACzD,KAAK,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,KAAK,UAAU,GAAG,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3D,KAAK,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAkBrD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,GAAG,0BAA0B,CAiB7B;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,WAAW,EAC3D,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,mBAAmB,GAC5B,CAAC,CAUH"}

package/dist/replay-privacy.js

@@ -7,9 +7,16 @@ const MASKED_TEXT_KEYS = new Set([
     "title",
     "value",
 ]);
+// Force rrweb to emit a fresh Meta+FullSnapshot every minute. Without this,
+// only the first segment of a session contains a snapshot, so any later
+// segment loss (or seeking to a non-zero anchor) leaves the player with
+// nothing to render. 60s matches Sentry's buffer-mode checkout cadence and
+// keeps each segment independently seekable.
+const CHECKOUT_EVERY_NMS = 60_000;
 export function buildReplayRecordOptions(input) {
     const options = {
         emit: input.emit,
+        checkoutEveryNms: CHECKOUT_EVERY_NMS,
     };
     if (input.privacy?.blockSelector) {
         options.blockSelector = input.privacy.blockSelector;
@@ -25,36 +32,59 @@ export function applyReplayEventPrivacy(event, privacy) {
     if (!privacy?.maskAllText) {
         return event;
     }
-    return redactReplayValue(event, {
+    redactReplayValue(event, {
         currentTagName: null,
         key: "",
     });
+    return event;
 }
 function redactReplayValue(value, context) {
-    if (typeof value === "string") {
-        return shouldMaskString(context) ? maskReplayText(value) : value;
-    }
     if (Array.isArray(value)) {
-        return value.map((entry) => redactReplayValue(entry, context));
-    }
-    if (!isReplayPrivacyObject(value)) {
-        return value;
+        value.forEach((entry, index) => {
+            if (isString(entry) && shouldMaskString(context)) {
+                value.splice(index, 1, maskReplayText(String(entry)));
+            }
+            else {
+                redactReplayValue(entry, context);
+            }
+        });
+        return;
     }
+    if (!isReplayRecord(value))
+        return;
     const nextTagName = readTagName(value) ?? context.currentTagName;
-    const nextValue = {};
     for (const [entryKey, entryValue] of Object.entries(value)) {
-        nextValue[entryKey] = redactReplayValue(entryValue, {
-            currentTagName: nextTagName,
-            key: entryKey,
-        });
+        const nextContext = { currentTagName: nextTagName, key: entryKey };
+        if (isString(entryValue) && shouldMaskString(nextContext)) {
+            Object.defineProperty(value, entryKey, {
+                configurable: true,
+                enumerable: true,
+                value: maskReplayText(String(entryValue)),
+                writable: true,
+            });
+        }
+        else {
+            redactReplayValue(entryValue, nextContext);
+        }
+    }
+}
+function isReplayRecord(value) {
+    if (value === null)
+        return false;
+    try {
+        const prototype = Object.getPrototypeOf(Object(value));
+        return prototype === null || Object.getPrototypeOf(prototype) === null;
+    }
+    catch {
+        return false;
     }
-    return nextValue;
 }
-function isReplayPrivacyObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+function isString(value) {
+    return Object.prototype.toString.call(value) === "[object String]";
 }
 function readTagName(value) {
-    return typeof value.tagName === "string" ? value.tagName.toLowerCase() : null;
+    const tagName = Object.getOwnPropertyDescriptor(Object(value), "tagName")?.value;
+    return isString(tagName) ? String(tagName).toLowerCase() : null;
 }
 function maskReplayText(value) {
     return value.replace(/[^\s]/g, "*");

package/dist/replay-retry.d.ts

@@ -0,0 +1,41 @@
+interface ReplayUploadClient {
+    url: string;
+    headerKey: string;
+    debug: boolean;
+}
+/**
+ * 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 declare class ReplayUploader {
+    private readonly client;
+    private readonly queue;
+    private sending;
+    private activeController;
+    private retryTimer;
+    private disposed;
+    constructor(client: ReplayUploadClient);
+    enqueue(body: string): void;
+    /**
+     * 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(): string[];
+    private oldestDroppableIndex;
+    dispose(): void;
+    flush(): Promise<void>;
+    private scheduleRetry;
+    private send;
+}
+export {};
+//# sourceMappingURL=replay-retry.d.ts.map

package/dist/replay-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-retry.d.ts","sourceRoot":"","sources":["../src/replay-retry.ts"],"names":[],"mappings":"AAmBA,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAmBD;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,kBAAkB;IAItC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAY3B;;;;OAIG;IACH,KAAK,IAAI,MAAM,EAAE;IAYjB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,IAAI,IAAI;IAWT,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD5B,OAAO,CAAC,aAAa;YAQP,IAAI;CAwDnB"}

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