@faststats/web 0.10.0 → 0.10.2

package/dist/chunks/{identifiers-xX7o7oZz.js → identifiers-I5UnTXGR.js}

@@ -1,21 +1,18 @@
 import { c as removeStorageItem, l as setStorageItem, n as createId, s as getStorageItem } from "./send-data-Dplz7m4c.js";
 //#region src/utils/identifiers.ts
 const ANONYMOUS_ID_KEY = "faststats_anon_id_";
-function getOrCreateAnonymousId(siteKey) {
+function getAnonymousId(siteKey, cookieless = false) {
+	if (cookieless) return "";
 	const key = `${ANONYMOUS_ID_KEY}${siteKey}`;
 	const existingId = getStorageItem("localStorage", key);
 	if (existingId) return existingId;
 	const newId = createId();
 	return setStorageItem("localStorage", key, newId) ? newId : "";
 }
-function getAnonymousId(siteKey, cookieless = false) {
-	if (cookieless) return "";
-	return getOrCreateAnonymousId(siteKey);
-}
 function resetAnonymousId(siteKey, cookieless) {
 	if (cookieless) return "";
 	if (!removeStorageItem("localStorage", `${ANONYMOUS_ID_KEY}${siteKey}`)) return "";
-	return getOrCreateAnonymousId(siteKey);
+	return getAnonymousId(siteKey);
 }
 //#endregion
 export { resetAnonymousId as n, getAnonymousId as t };

package/dist/error.js

@@ -1,9 +1,9 @@
 import { i as resolveBaseUrl, n as URLS, r as getPageContext, t as ANALYTICS_BASE } from "./chunks/api-urls-DWk43fu6.js";
 import { r as getSessionContext, t as sendData } from "./chunks/send-data-Dplz7m4c.js";
-import { t as getAnonymousId } from "./chunks/identifiers-xX7o7oZz.js";
+import { t as getAnonymousId } from "./chunks/identifiers-I5UnTXGR.js";
 //#region src/error.ts
 const SDK_NAME = "@faststats/web";
-const SDK_VERSION = "0.10.0";
+const SDK_VERSION = "0.10.2";
 function errorTracking(options = {}) {
 	return {
 		name: "error-tracking",

package/dist/index.js

@@ -1,6 +1,6 @@
 import { i as resolveBaseUrl, n as URLS, r as getPageContext, t as ANALYTICS_BASE } from "./chunks/api-urls-DWk43fu6.js";
 import { a as resetSession, n as createId, o as touchActivity, r as getSessionContext, t as sendData } from "./chunks/send-data-Dplz7m4c.js";
-import { n as resetAnonymousId, t as getAnonymousId } from "./chunks/identifiers-xX7o7oZz.js";
+import { n as resetAnonymousId, t as getAnonymousId } from "./chunks/identifiers-I5UnTXGR.js";
 //#region src/extensions.ts
 var ExtensionHost = class {
 	runtime;

package/dist/replay.d.ts

@@ -31,6 +31,7 @@ export interface ReplayTrackerOptions {
   maxLowLatencyBatchSizeBytes?: number;
   maxPendingBatches?: number;
   maxQueueSizeBytes?: number;
+  /** Minimum elapsed time per recording stream before upload. Defaults to 3000. */
   minReplayLengthMs?: number;
   sampling?: RecordOptions["sampling"];
   slimDOMOptions?: RecordOptions["slimDOMOptions"];
@@ -67,7 +68,6 @@ export default class ReplayTracker {
   private readonly minReplayLengthMs;
   private readonly events;
   private readonly pending;
-  private readonly minLengthBlockedBatches;
   private queuedEventsSizeBytes;
   private pendingSizeBytes;
   private viewId;
@@ -76,7 +76,6 @@ export default class ReplayTracker {
   private started;
   private disposed;
   private startTime;
-  private sequence;
   private intervalId;
   private flushTask;
   private retryTask;
@@ -97,10 +96,7 @@ export default class ReplayTracker {
   private log;
   private clearFlushTimers;
   private clearQueues;
-  private dropMinLengthBlockedBatches;
-  private unblockSessionBatches;
   private finalizeSession;
-  private nextBatchSequence;
   setCookielessMode(cookieless: boolean): void;
   start(): void;
   trackPageChange(url?: string): void;
@@ -126,6 +122,7 @@ export default class ReplayTracker {
   private eventSizeBytes;
   private batchSizeBytes;
   private removePending;
+  private stopCapture;
   private enqueueBatch;
   private flush;
   private sendPending;

package/dist/replay.js

@@ -1,6 +1,6 @@
 import { a as sanitizeUrl, i as resolveBaseUrl, n as URLS, t as ANALYTICS_BASE } from "./chunks/api-urls-DWk43fu6.js";
-import { i as onSessionRotated, l as setStorageItem, n as createId, o as touchActivity, r as getSessionContext, s as getStorageItem, t as sendData } from "./chunks/send-data-Dplz7m4c.js";
-import { t as getAnonymousId } from "./chunks/identifiers-xX7o7oZz.js";
+import { c as removeStorageItem, i as onSessionRotated, l as setStorageItem, n as createId, o as touchActivity, r as getSessionContext, s as getStorageItem, t as sendData } from "./chunks/send-data-Dplz7m4c.js";
+import { t as getAnonymousId } from "./chunks/identifiers-I5UnTXGR.js";
 import { record } from "@rrweb/record";
 import { getRecordConsolePlugin } from "@rrweb/rrweb-plugin-console-record";
 import { getRecordNetworkPlugin } from "@rrweb/rrweb-plugin-network-record";
@@ -52,6 +52,51 @@ var ReplayMutationThrottler = class {
 	}
 };
 //#endregion
+//#region src/replay-sequence.ts
+const counters = /* @__PURE__ */ new Map();
+function sameRecording(counter, context) {
+	return counter?.sessionId === context.sessionId && counter.windowId === context.windowId;
+}
+function readCounter(value) {
+	try {
+		const parsed = JSON.parse(value);
+		if (parsed && typeof parsed.sessionId === "string" && typeof parsed.windowId === "string" && typeof parsed.next === "number" && Number.isSafeInteger(parsed.next) && parsed.next >= 0 && (parsed.version === 0 || parsed.version === 1)) return parsed;
+	} catch {}
+}
+function nextReplaySequence(siteKey, context, cookieless) {
+	const key = `faststats_replay_sequence_v1_${siteKey}`;
+	const cached = counters.get(siteKey);
+	const raw = cookieless ? null : getStorageItem("sessionStorage", key);
+	const stored = raw === null ? void 0 : readCounter(raw);
+	if (raw !== null && !stored && !sameRecording(cached, context)) return;
+	let counter = sameRecording(cached, context) ? cached : void 0;
+	if (sameRecording(stored, context) && stored && (!counter || stored.next > counter.next)) counter = stored;
+	const legacyKey = `faststats_replay_batch_sequence_${siteKey}_${context.windowId}`;
+	if (!counter) {
+		const legacy = !cookieless && !stored && !sameRecording(cached, context) ? getStorageItem("sessionStorage", legacyKey) : null;
+		const next = legacy === null ? 0 : Number(legacy);
+		if (!Number.isSafeInteger(next) || next < 0 || legacy !== null && !/^\d+$/.test(legacy)) return;
+		counter = {
+			sessionId: context.sessionId,
+			windowId: context.windowId,
+			next,
+			version: legacy === null ? 1 : 0
+		};
+	}
+	if (!Number.isSafeInteger(counter.next + 1)) return;
+	const sequence = counter.next;
+	const updated = {
+		...counter,
+		next: sequence + 1
+	};
+	counters.set(siteKey, updated);
+	if (!cookieless && setStorageItem("sessionStorage", key, JSON.stringify(updated))) removeStorageItem("sessionStorage", legacyKey);
+	return {
+		sequence,
+		...counter.version === 1 ? { sequenceContractVersion: 1 } : {}
+	};
+}
+//#endregion
 //#region src/replay.ts
 const MAX_TIMEOUT_MS = 2147483647;
 const DEFAULT_MAX_QUEUE_SIZE_BYTES = 2097152;
@@ -66,6 +111,10 @@ const RRWEB_EVENT_META = 4;
 const REPLAY_SEQUENTIAL_ID_KEY = "_faststatsSeqId";
 const textEncoder = new TextEncoder();
 const batchSizeCache = /* @__PURE__ */ new WeakMap();
+function boundedInteger(value, fallback, min, max) {
+	if (value === void 0 || !Number.isFinite(value) || value < min) return fallback;
+	return Math.min(Math.trunc(value), max);
+}
 function sessionReplay(options = {}) {
 	return {
 		name: "session-replay",
@@ -100,7 +149,6 @@ var ReplayTracker = class {
 	minReplayLengthMs;
 	events = [];
 	pending = [];
-	minLengthBlockedBatches = /* @__PURE__ */ new WeakSet();
 	queuedEventsSizeBytes = 0;
 	pendingSizeBytes = 0;
 	viewId = createId();
@@ -109,7 +157,6 @@ var ReplayTracker = class {
 	started = false;
 	disposed = false;
 	startTime = 0;
-	sequence = 0;
 	intervalId = null;
 	flushTask = null;
 	retryTask = null;
@@ -130,13 +177,13 @@ var ReplayTracker = class {
 		this.options = options;
 		this.lastCookielessMode = options.cookieless ?? false;
 		this.endpoint = `${resolveBaseUrl(options.baseUrl, ANALYTICS_BASE)}${URLS.replay}`;
-		this.flushInterval = options.flushInterval ?? 15e3;
-		this.maxEvents = options.maxEvents ?? 1e3;
-		this.maxBatchSizeBytes = options.maxBatchSizeBytes ?? DEFAULT_MAX_BATCH_SIZE_BYTES;
-		this.maxLowLatencyBatchSizeBytes = options.maxLowLatencyBatchSizeBytes ?? DEFAULT_MAX_LOW_LATENCY_BATCH_SIZE_BYTES;
-		this.maxPendingBatches = options.maxPendingBatches ?? 30;
-		this.maxQueueSizeBytes = options.maxQueueSizeBytes ?? DEFAULT_MAX_QUEUE_SIZE_BYTES;
-		this.minReplayLengthMs = options.minReplayLengthMs ?? 3e3;
+		this.flushInterval = boundedInteger(options.flushInterval, 15e3, 1, MAX_TIMEOUT_MS);
+		this.maxEvents = boundedInteger(options.maxEvents, 1e3, 1, 1e5);
+		this.maxBatchSizeBytes = boundedInteger(options.maxBatchSizeBytes, DEFAULT_MAX_BATCH_SIZE_BYTES, 1, 33554432);
+		this.maxLowLatencyBatchSizeBytes = boundedInteger(options.maxLowLatencyBatchSizeBytes, DEFAULT_MAX_LOW_LATENCY_BATCH_SIZE_BYTES, 1, DEFAULT_MAX_LOW_LATENCY_BATCH_SIZE_BYTES);
+		this.maxPendingBatches = boundedInteger(options.maxPendingBatches, 30, 1, 1e3);
+		this.maxQueueSizeBytes = boundedInteger(options.maxQueueSizeBytes, DEFAULT_MAX_QUEUE_SIZE_BYTES, 1, 33554432);
+		this.minReplayLengthMs = boundedInteger(options.minReplayLengthMs, 3e3, 0, MAX_TIMEOUT_MS);
 		this.mutationThrottler = options.mutationThrottle?.enabled === false ? null : new ReplayMutationThrottler(options.mutationThrottle);
 	}
 	log(...args) {
@@ -158,28 +205,10 @@ var ReplayTracker = class {
 		this.pending.length = 0;
 		this.pendingSizeBytes = 0;
 	}
-	dropMinLengthBlockedBatches() {
-		this.needsFinalization = false;
-		for (let index = this.pending.length - 1; index >= 0; index--) {
-			const batch = this.pending[index];
-			if (batch && this.minLengthBlockedBatches.has(batch)) this.removePending(batch);
-		}
-	}
-	unblockSessionBatches(sessionId) {
-		for (const batch of this.pending) if (batch.sessionId === sessionId) this.minLengthBlockedBatches.delete(batch);
-	}
 	finalizeSession(context, flushReason) {
 		if (!this.needsFinalization) return;
-		this.enqueueBatch(this.createBatch([], context, true, flushReason));
-	}
-	nextBatchSequence(context) {
-		const key = `faststats_replay_batch_sequence_${this.options.siteKey}_${context.windowId}`;
-		let sequence = this.sequence;
-		const parsed = Number.parseInt(getStorageItem("sessionStorage", key) ?? "", 10);
-		if (Number.isFinite(parsed) && parsed >= 0) sequence = parsed;
-		setStorageItem("sessionStorage", key, String(sequence + 1));
-		this.sequence = sequence + 1;
-		return sequence;
+		const batch = this.createBatch([], context, true, flushReason);
+		if (batch) this.enqueueBatch(batch);
 	}
 	setCookielessMode(cookieless) {
 		if (this.lastCookielessMode === cookieless) return;
@@ -189,7 +218,7 @@ var ReplayTracker = class {
 		this.clearFlushTimers();
 		const context = getSessionContext(this.options.siteKey, this.lastCookielessMode);
 		this.activeSessionId = context.sessionId;
-		this.startTime = context.sessionStart;
+		this.startTime = Date.now();
 		this.chunkStartedAt = Date.now();
 		this.beginReplayStream();
 	}
@@ -204,7 +233,7 @@ var ReplayTracker = class {
 		this.viewUrl = sanitizeUrl(window.location.href, this.options.trackHash ?? false);
 		const context = getSessionContext(this.options.siteKey, this.lastCookielessMode);
 		this.activeSessionId = context.sessionId;
-		this.startTime = context.sessionStart;
+		this.startTime = Date.now();
 		this.chunkStartedAt = Date.now();
 		this.subscribeToSessionRotation();
 		this.beginRecording();
@@ -227,7 +256,7 @@ var ReplayTracker = class {
 					viewId: this.viewId
 				}
 			}
-		}, false);
+		});
 	}
 	onPageHidden(persisted = false, terminal = false) {
 		if (persisted) return;
@@ -276,7 +305,7 @@ var ReplayTracker = class {
 		return plugins;
 	}
 	beginRecording() {
-		const stop = record({
+		this.stopRecording = record({
 			emit: this.onEvent,
 			sampling: this.options.sampling ?? {
 				mousemove: 50,
@@ -310,7 +339,6 @@ var ReplayTracker = class {
 			checkoutEveryNth: this.options.checkoutEveryNth,
 			plugins: this.recordingPlugins()
 		});
-		this.stopRecording = stop;
 	}
 	stop(discard = false) {
 		if (!this.started) return;
@@ -332,8 +360,8 @@ var ReplayTracker = class {
 		if (!this.hasReachedMinLength()) {
 			this.events.length = 0;
 			this.queuedEventsSizeBytes = 0;
-			this.dropMinLengthBlockedBatches();
-			this.log(`Session too short (${Date.now() - this.startTime}ms), discarding events`);
+			this.needsFinalization = false;
+			this.log(`Recording too short (${Date.now() - this.startTime}ms), discarding events`);
 		}
 		this.flush(true, true, "stop");
 		this.log("Recording stopped");
@@ -349,12 +377,15 @@ var ReplayTracker = class {
 	}
 	applySessionRotation(prev, next) {
 		if (this.activeSessionId === next.sessionId) return;
-		this.enqueueEventsIfReady(prev, {
+		if (this.hasReachedMinLength()) this.enqueueEventsIfReady(prev, {
 			isFinal: true,
 			flushReason: "sessionRotate"
 		});
+		else {
+			this.events.length = 0;
+			this.queuedEventsSizeBytes = 0;
+		}
 		this.finalizeSession(prev, "sessionRotate");
-		this.unblockSessionBatches(prev.sessionId);
 		this.needsFinalization = false;
 		this.activeSessionId = next.sessionId;
 		this.resetSessionTiming(next);
@@ -380,14 +411,14 @@ var ReplayTracker = class {
 			}
 		}
 	}
-	resetSessionTiming(next) {
+	resetSessionTiming(_next) {
 		if (this.minLengthFlushTask) clearTimeout(this.minLengthFlushTask);
 		this.minLengthFlushTask = null;
-		this.startTime = next.sessionStart;
+		this.startTime = Date.now();
 		this.chunkStartedAt = Date.now();
 		this.initialFlushPending = true;
 	}
-	onEvent = (event, _isCheckout) => {
+	onEvent = (event) => {
 		if (this.overflowed) return;
 		let capturedEvent = event;
 		if (event.type === RRWEB_EVENT_META) {
@@ -406,9 +437,17 @@ var ReplayTracker = class {
 			if (this.mutationThrottler && !throttled) return;
 			if (throttled) capturedEvent = throttled;
 		}
-		capturedEvent = Object.assign(capturedEvent, { [REPLAY_SEQUENTIAL_ID_KEY]: ++this.replayEventSequence });
-		this.events.push(capturedEvent);
-		this.queuedEventsSizeBytes += this.eventSizeBytes(capturedEvent);
+		const sequencedEvent = {
+			...capturedEvent,
+			[REPLAY_SEQUENTIAL_ID_KEY]: ++this.replayEventSequence
+		};
+		const eventBytes = this.eventSizeBytes(sequencedEvent);
+		if (this.pendingSizeBytes + this.queuedEventsSizeBytes + eventBytes > this.maxQueueSizeBytes) {
+			this.stopCapture("Replay buffer limit reached");
+			return;
+		}
+		this.events.push(sequencedEvent);
+		this.queuedEventsSizeBytes += eventBytes;
 		let reason;
 		if (this.events.length >= this.maxEvents) reason = "maxEvents";
 		else if (this.queuedEventsSizeBytes >= this.maxBatchSizeBytes) reason = "maxBytes";
@@ -416,13 +455,13 @@ var ReplayTracker = class {
 		else this.scheduleMinLengthFlush();
 	};
 	onUnload = () => {
-		this.requestTerminalFlush("unload");
+		this.flush(true, false, "unload");
 	};
 	requestTerminalFlush(reason) {
 		if (!this.hasReachedMinLength()) {
 			this.events.length = 0;
 			this.queuedEventsSizeBytes = 0;
-			this.dropMinLengthBlockedBatches();
+			this.needsFinalization = false;
 			return;
 		}
 		this.flush(true, true, reason);
@@ -457,18 +496,16 @@ var ReplayTracker = class {
 		}, Math.min(remainingMs, MAX_TIMEOUT_MS));
 	}
 	enqueueEventsIfReady(context, options = {}) {
-		const { isFinal = false, flushReason = "manual", maxBatchSizeBytes = this.maxBatchSizeBytes, sealBeforeMinLength = false } = options;
+		const { isFinal = false, flushReason = "manual", maxBatchSizeBytes = this.maxBatchSizeBytes } = options;
 		if (this.events.length === 0) return;
-		if (!isFinal && !sealBeforeMinLength && !this.hasReachedMinLength()) {
+		if (!isFinal && !this.hasReachedMinLength()) {
 			this.scheduleMinLengthFlush();
 			return;
 		}
 		const batches = this.takeEventBatches(maxBatchSizeBytes);
-		const blockedByMinLength = sealBeforeMinLength && !this.hasReachedMinLength();
 		for (const [index, events] of batches.entries()) {
 			const batch = this.createBatch(events, context, isFinal && index === batches.length - 1, flushReason);
-			if (blockedByMinLength) this.minLengthBlockedBatches.add(batch);
-			this.enqueueBatch(batch);
+			if (!batch || !this.enqueueBatch(batch)) break;
 		}
 		this.queuedEventsSizeBytes = 0;
 	}
@@ -491,7 +528,11 @@ var ReplayTracker = class {
 	}
 	createBatch(events, context, isFinal, flushReason = "manual") {
 		const identifier = getAnonymousId(this.options.siteKey, this.lastCookielessMode);
-		const sequence = this.nextBatchSequence(context);
+		const sequence = nextReplaySequence(this.options.siteKey, context, this.lastCookielessMode);
+		if (!sequence) {
+			this.stopCapture("Replay sequence state is invalid or exhausted");
+			return;
+		}
 		const chunkStartedAt = this.chunkStartedAt;
 		const now = Date.now();
 		this.chunkStartedAt = now;
@@ -504,8 +545,8 @@ var ReplayTracker = class {
 			chunkStartedAt,
 			chunkEndedAt: now,
 			...identifier ? { identifier } : {},
-			batchId: `${context.sessionId}-${sequence}-${chunkStartedAt}`,
-			sequence,
+			batchId: `${context.sessionId}-${sequence.sequence}-${chunkStartedAt}`,
+			...sequence,
 			timestamp: now,
 			url: this.viewUrl || sanitizeUrl(window.location.href, this.options.trackHash ?? false),
 			...isFinal ? { isFinal: true } : {},
@@ -523,28 +564,35 @@ var ReplayTracker = class {
 		batchSizeCache.set(batch, size);
 		return size;
 	}
-	removePending(batch, reason) {
+	removePending(batch) {
 		const index = this.pending.indexOf(batch);
-		if (index < 0) return false;
+		if (index < 0) return;
 		this.pending.splice(index, 1);
 		this.pendingSizeBytes = Math.max(0, this.pendingSizeBytes - this.batchSizeBytes(batch));
-		if (reason) this.log(`${reason}, dropping batch ${batch.sequence}`);
-		return true;
+		this.log(`Sent replay batch ${batch.sequence}`);
+	}
+	stopCapture(reason) {
+		this.log(reason);
+		this.overflowed = true;
+		this.stopRecording?.();
+		this.stopRecording = void 0;
 	}
 	enqueueBatch(batch) {
 		const size = this.batchSizeBytes(batch);
 		if (size > this.maxQueueSizeBytes || this.pending.length >= this.maxPendingBatches || this.pendingSizeBytes + size > this.maxQueueSizeBytes) {
-			this.log(`Replay queue limit reached at batch ${batch.sequence}; stopping recording at the last complete chain`);
-			this.overflowed = true;
-			this.stopRecording?.();
-			this.stopRecording = void 0;
-			return;
+			this.stopCapture(`Replay queue limit reached at batch ${batch.sequence}`);
+			return false;
 		}
 		this.needsFinalization = !batch.isFinal;
 		this.pending.push(batch);
 		this.pendingSizeBytes += size;
+		return true;
 	}
 	async flush(lowLatency, isFinal = false, flushReason = "manual") {
+		if (this.events.length === 0 && !isFinal) {
+			await this.sendPending(lowLatency, false);
+			return;
+		}
 		const rotation = touchActivity(this.options.siteKey, this.lastCookielessMode);
 		if (rotation) this.applySessionRotation(rotation.prev, rotation.next);
 		const context = getSessionContext(this.options.siteKey, this.lastCookielessMode);
@@ -555,8 +603,6 @@ var ReplayTracker = class {
 		});
 		if (isFinal) this.finalizeSession(context, flushReason);
 		if (this.pending.length === 0) return;
-		if (isFinal) for (const batch of this.pending) this.minLengthBlockedBatches.delete(batch);
-		else if (!rotation && flushReason !== "sessionRotate" && this.hasReachedMinLength()) this.unblockSessionBatches(context.sessionId);
 		await this.sendPending(lowLatency, lowLatency && isFinal);
 	}
 	async sendPending(lowLatency, bypassRetryDelay) {
@@ -577,14 +623,13 @@ var ReplayTracker = class {
 		try {
 			while (this.pending.length > 0) {
 				const batch = this.pending[0];
-				if (this.minLengthBlockedBatches.has(batch)) break;
 				if (!await this.sendBatch(batch, lowLatency)) {
 					this.log(`Failed to send replay batch ${batch.sequence}`);
 					if (!this.disposed) this.scheduleRetry();
 					break;
 				}
 				this.retryAttempt = 0;
-				this.removePending(batch, "Sent replay batch");
+				this.removePending(batch);
 				if (this.queuedFlush?.lowLatency) break;
 			}
 		} finally {
@@ -604,7 +649,7 @@ var ReplayTracker = class {
 		this.retryTask = setTimeout(() => {
 			this.retryTask = null;
 			if (this.retryAttempt === RETRY_MAX_ATTEMPTS) this.retryAttempt = 0;
-			this.flush(false);
+			this.sendPending(false, false);
 		}, delay);
 	}
 	retryDelay(attempt) {

package/package.json

@@ -42,7 +42,7 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"version": "0.10.0",
+	"version": "0.10.2",
 	"scripts": {
 		"build": "tsdown && bun run check-size",
 		"dev": "bun run build",
@@ -60,6 +60,6 @@
 		"@rrweb/record": "^2.1.6",
 		"@rrweb/rrweb-plugin-console-record": "^2.1.6",
 		"@rrweb/rrweb-plugin-network-record": "^2.1.6",
-		"web-vitals": "^6.2.1"
+		"web-vitals": "^6.2.2"
 	}
 }