@faststats/web 0.10.3 → 0.11.0

package/README.md

@@ -3,21 +3,20 @@
 > [!IMPORTANT]
 > This repository is in early development and not intended for production use.
 
-The base SDK only handles analytics, identity, sessions, navigation, and consent.
+The base SDK handles analytics, identity, sessions, navigation, outbound link
+clicks, and consent.
 Error tracking, Web Vitals, and session replay are independent extensions, so
 applications only download the products they use.
 
 ```ts
 import { init, track } from "@faststats/web";
 import { errorTracking } from "@faststats/web/error";
-import { outboundLinks } from "@faststats/web/outbound-links";
 import { sessionReplay } from "@faststats/web/replay";
 import { webVitals } from "@faststats/web/web-vitals";
 
 init({
 	siteKey: "site_123",
 	extensions: [
-		outboundLinks(),
 		errorTracking(),
 		webVitals(),
 		sessionReplay({ recordConsole: true }),
@@ -123,7 +122,7 @@ export function diagnostics(): AnalyticsExtension {
 		name: "diagnostics",
 		setup(context) {
 			const off = context.on("pageChange", ({ url }) => {
-				console.debug("page changed", url, context.getSession());
+				console.debug("page changed", url);
 			});
 
 			return () => off();

package/dist/chunks/{extensions-DW7tJY0T.d.ts → extensions-DZDQn8O8.d.ts}

@@ -1,10 +1,3 @@
-//#region src/utils/session-manager.d.ts
-type SessionContext = {
-  sessionId: string;
-  windowId: string;
-  sessionStart: number;
-};
-//#endregion
 //#region src/extensions.d.ts
 type ExtensionHooks = {
   pageChange: {
@@ -34,11 +27,7 @@ interface AnalyticsExtensionContext {
   readonly sdkName?: string;
   readonly sdkVersion?: string;
   isCookieless(): boolean;
-  getAnonymousId(): string;
-  getSession(): SessionContext;
-  capture(event: string, properties?: Record<string, unknown>): void;
   on<K extends ExtensionHook>(hook: K, handler: ExtensionHandler<K>): () => void;
-  log(message: string, ...details: unknown[]): void;
 }
 interface AnalyticsExtension {
   readonly name: string;

package/dist/chunks/{identifiers-BgGtAQdp.js → identifiers-BwGNL11R.js}

@@ -1,4 +1,4 @@
-import { c as removeStorageItem, l as setStorageItem, n as createId, s as getStorageItem } from "./send-data-DAVUdfNm.js";
+import { c as removeStorageItem, l as setStorageItem, n as createId, s as getStorageItem } from "./send-data-D520oab1.js";
 //#region src/utils/identifiers.ts
 const ANONYMOUS_ID_KEY = "faststats_anon_id_";
 function getAnonymousId(siteKey, cookieless = false) {

package/dist/chunks/{send-data-DAVUdfNm.js → send-data-D520oab1.js}

@@ -1,3 +1,54 @@
+//#region src/utils/api-urls.ts
+function resolveBaseUrl(baseUrl) {
+	return baseUrl?.replace(/\/+$/, "") || "https://metrics.faststats.dev";
+}
+const URLS = {
+	events: "/v1/web",
+	identify: "/v1/identify",
+	replay: "/v1/replay",
+	vitals: "/v1/vitals"
+};
+function sanitizeUrl(url, includeHash = false) {
+	try {
+		const parsed = new URL(url, location.href);
+		return `${parsed.origin}${parsed.pathname}${includeHash ? parsed.hash : ""}`;
+	} catch {
+		return url.split(includeHash ? "?" : /[?#]/, 1)[0] ?? "";
+	}
+}
+const UTM_KEYS = [
+	"utm_source",
+	"utm_medium",
+	"utm_campaign",
+	"utm_term",
+	"utm_content"
+];
+function getReferrer() {
+	const raw = document.referrer;
+	if (!raw) return null;
+	try {
+		const pageOrigin = new URL(location.href).origin;
+		if (new URL(raw, location.href).origin === pageOrigin) return null;
+	} catch {}
+	return sanitizeUrl(raw);
+}
+function getPageContext(includeHash = false) {
+	const hash = includeHash ? location.hash : "";
+	const ctx = {
+		page: `${location.pathname}${hash}`,
+		url: sanitizeUrl(location.href, includeHash),
+		referrer: getReferrer(),
+		title: document.title || ""
+	};
+	if (!location.search) return ctx;
+	const sp = new URLSearchParams(location.search);
+	for (const key of UTM_KEYS) {
+		const value = sp.get(key);
+		if (value) ctx[key] = value;
+	}
+	return ctx;
+}
+//#endregion
 //#region src/utils/storage.ts
 function getStorageItem(name, key) {
 	try {
@@ -31,6 +82,7 @@ function removeStorageItem(name, key) {
 const IDLE_MS = 18e5;
 const MAX_AGE_MS = 864e5;
 const SESSION_KEY = "faststats_session_";
+const WINDOW_KEY = "faststats_window_id_";
 const NO_STORAGE = {};
 const memorySessions = /* @__PURE__ */ new Map();
 const rotationListeners = /* @__PURE__ */ new Map();
@@ -64,7 +116,7 @@ function readSession(siteKey) {
 	if (!raw) return memory;
 	try {
 		const session = JSON.parse(raw);
-		return typeof session?.id === "string" && session.id && Number.isFinite(session.start) && Number.isFinite(session.activity) ? session : memory;
+		if (typeof session?.id === "string" && session.id && Number.isFinite(session.start) && Number.isFinite(session.activity)) return session;
 	} catch {}
 	return memory;
 }
@@ -104,7 +156,7 @@ function resolveSession(siteKey, cookieless, touch) {
 }
 function windowId(siteKey, cookieless, sessionId) {
 	if (cookieless) return sessionId;
-	const key = `faststats_window_id_${siteKey}`;
+	const key = `${WINDOW_KEY}${siteKey}`;
 	const existing = getStorageItem("sessionStorage", key);
 	if (existing) return existing;
 	const id = createId();
@@ -128,7 +180,7 @@ function resetSession(siteKey, cookieless = false) {
 	memorySessions.delete(memoryKey(siteKey, cookieless));
 	if (!cookieless) {
 		removeStorageItem("localStorage", `${SESSION_KEY}${siteKey}`);
-		removeStorageItem("sessionStorage", `faststats_window_id_${siteKey}`);
+		removeStorageItem("sessionStorage", `${WINDOW_KEY}${siteKey}`);
 	}
 	const next = getSessionContext(siteKey, cookieless);
 	if (previous.sessionId !== next.sessionId) emitRotation(siteKey, cookieless, previous, next);
@@ -150,8 +202,7 @@ function onSessionRotated(siteKey, cookieless, listener) {
 //#endregion
 //#region src/utils/send-data.ts
 async function sendData(options) {
-	const { url, data, contentType = "application/json", headers = {}, debug = false, debugPrefix = "[Analytics]", useBeacon = true, keepalive = true, signal, settleRejected } = options;
-	if (signal?.aborted) return false;
+	const { url, data, contentType = "application/json", debug = false, debugPrefix = "[Analytics]", useBeacon = true, keepalive = true, settleRejected } = options;
 	if (useBeacon && typeof globalThis.navigator?.sendBeacon === "function") try {
 		const beaconBody = data instanceof Blob || typeof Blob === "undefined" ? data : new Blob([data], { type: contentType });
 		if (globalThis.navigator.sendBeacon(url, beaconBody)) {
@@ -159,17 +210,14 @@ async function sendData(options) {
 			return true;
 		}
 	} catch {}
+	const size = typeof data === "string" ? data.length : data instanceof Blob ? data.size : data.byteLength;
 	try {
 		const { ok, status } = await fetch(url, {
 			method: "POST",
 			body: data,
-			headers: {
-				"Content-Type": contentType,
-				...headers
-			},
-			keepalive,
-			credentials: "omit",
-			signal
+			headers: { "Content-Type": contentType },
+			keepalive: keepalive && size <= 61440,
+			credentials: "omit"
 		});
 		if (debug) console.log(debugPrefix, ok ? "Sent via fetch" : status);
 		return ok || !!settleRejected && status < 500 && status !== 429;
@@ -179,4 +227,4 @@ async function sendData(options) {
 	}
 }
 //#endregion
-export { resetSession as a, removeStorageItem as c, onSessionRotated as i, setStorageItem as l, createId as n, touchActivity as o, getSessionContext as r, getStorageItem as s, sendData as t };
+export { resetSession as a, removeStorageItem as c, getPageContext as d, resolveBaseUrl as f, onSessionRotated as i, setStorageItem as l, createId as n, touchActivity as o, sanitizeUrl as p, getSessionContext as r, getStorageItem as s, sendData as t, URLS as u };

package/dist/error.d.ts

@@ -1,4 +1,4 @@
-import { t as AnalyticsExtension } from "./chunks/extensions-DW7tJY0T.js";
+import { t as AnalyticsExtension } from "./chunks/extensions-DZDQn8O8.js";
 //#region src/error.d.ts
 export type ErrorEntry = {
   error: string;
@@ -17,7 +17,7 @@ export interface ErrorTrackingOptions {
   sdkName?: string;
   sdkVersion?: string;
 }
-export type ErrorTrackingExtensionOptions = Omit<ErrorTrackingOptions, "siteKey" | "baseUrl" | "debug" | "trackHash" | "cookieless" | "sdkName" | "sdkVersion">;
+export type ErrorTrackingExtensionOptions = Pick<ErrorTrackingOptions, "flushInterval" | "maxQueueSize">;
 export declare function errorTracking(options?: ErrorTrackingExtensionOptions): AnalyticsExtension;
 export default class ErrorTracker {
   private readonly options;
@@ -26,11 +26,14 @@ export default class ErrorTracker {
   private timer;
   private started;
   private flushing;
+  private generation;
   private cookieless;
+  private readonly maxQueueSize;
   constructor(options: ErrorTrackingOptions);
   setCookielessMode(cookieless: boolean): void;
   start(): void;
   stop(discard?: boolean): void;
+  private discard;
   onPageHidden(persisted?: boolean): void;
   captureError(error: Error): void;
   private onError;

package/dist/error.js

@@ -1,9 +1,8 @@
-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-DAVUdfNm.js";
-import { t as getAnonymousId } from "./chunks/identifiers-BgGtAQdp.js";
+import { d as getPageContext, f as resolveBaseUrl, r as getSessionContext, t as sendData, u as URLS } from "./chunks/send-data-D520oab1.js";
+import { t as getAnonymousId } from "./chunks/identifiers-BwGNL11R.js";
 //#region src/error.ts
 const SDK_NAME = "@faststats/web";
-const SDK_VERSION = "0.10.3";
+const SDK_VERSION = "0.11.0";
 function errorTracking(options = {}) {
 	return {
 		name: "error-tracking",
@@ -51,14 +50,17 @@ var ErrorTracker = class {
 	timer = null;
 	started = false;
 	flushing = false;
+	generation = 0;
 	cookieless;
+	maxQueueSize;
 	constructor(options) {
 		this.options = options;
-		this.endpoint = `${resolveBaseUrl(options.baseUrl, ANALYTICS_BASE)}${URLS.events}`;
+		this.maxQueueSize = options.maxQueueSize ?? 50;
+		this.endpoint = `${resolveBaseUrl(options.baseUrl)}${URLS.events}`;
 		this.cookieless = options.cookieless ?? false;
 	}
 	setCookielessMode(cookieless) {
-		if (this.cookieless !== cookieless) this.queue = [];
+		if (this.cookieless !== cookieless) this.discard();
 		this.cookieless = cookieless;
 	}
 	start() {
@@ -69,15 +71,19 @@ var ErrorTracker = class {
 		this.timer = setInterval(() => void this.flush(), this.options.flushInterval ?? 5e3);
 	}
 	stop(discard = false) {
-		if (!this.started || typeof window === "undefined") return;
+		if (!this.started) return;
 		this.started = false;
 		window.removeEventListener("error", this.onError);
 		window.removeEventListener("unhandledrejection", this.onRejection);
 		if (this.timer) clearInterval(this.timer);
 		this.timer = null;
-		if (discard) this.queue = [];
+		if (discard) this.discard();
 		else this.flush();
 	}
+	discard() {
+		this.generation++;
+		this.queue = [];
+	}
 	onPageHidden(persisted = false) {
 		if (!persisted) this.flush();
 	}
@@ -111,11 +117,12 @@ var ErrorTracker = class {
 				properties: {}
 			}
 		});
-		if (this.queue.length >= (this.options.maxQueueSize ?? 50)) this.flush();
+		if (this.queue.length >= this.maxQueueSize) this.flush();
 	}
 	async flush() {
 		if (this.flushing || !this.queue.length) return;
 		this.flushing = true;
+		const generation = this.generation;
 		const batch = this.queue;
 		this.queue = [];
 		const groups = /* @__PURE__ */ new Map();
@@ -128,29 +135,36 @@ var ErrorTracker = class {
 			group.items.push(item);
 			groups.set(key, group);
 		}
-		const failed = await Promise.all([...groups.values()].map(async (group) => {
-			const errors = /* @__PURE__ */ new Map();
-			for (const { error } of group.items) {
-				const key = JSON.stringify(error);
-				const existing = errors.get(key);
-				if (existing) existing.count++;
-				else errors.set(key, {
-					...error,
-					count: 1
-				});
-			}
-			return await sendData({
-				url: this.endpoint,
-				data: JSON.stringify({
-					...group.context,
-					errors: [...errors.values()]
-				}),
-				debug: this.options.debug,
-				debugPrefix: "[ErrorTracker]"
-			}) ? [] : group.items;
-		}));
-		this.queue.unshift(...failed.flat());
-		this.flushing = false;
+		let failed = [];
+		try {
+			failed = (await Promise.all([...groups.values()].map(async (group) => {
+				const errors = /* @__PURE__ */ new Map();
+				for (const { error } of group.items) {
+					const key = JSON.stringify(error);
+					const existing = errors.get(key);
+					if (existing) existing.count++;
+					else errors.set(key, {
+						...error,
+						count: 1
+					});
+				}
+				return await sendData({
+					url: this.endpoint,
+					data: JSON.stringify({
+						...group.context,
+						errors: [...errors.values()]
+					}),
+					debug: this.options.debug,
+					debugPrefix: "[ErrorTracker]",
+					settleRejected: true
+				}) ? [] : group.items;
+			}))).flat();
+		} finally {
+			this.flushing = false;
+		}
+		if (generation !== this.generation) return;
+		this.queue = [...failed, ...this.queue].slice(-this.maxQueueSize);
+		if (!this.started && !failed.length) this.flush();
 	}
 };
 //#endregion

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as ExtensionHook, i as ExtensionHandler, n as AnalyticsExtensionContext, o as ExtensionHooks, r as ExtensionCleanup, t as AnalyticsExtension } from "./chunks/extensions-DW7tJY0T.js";
+import { a as ExtensionHook, i as ExtensionHandler, n as AnalyticsExtensionContext, o as ExtensionHooks, r as ExtensionCleanup, t as AnalyticsExtension } from "./chunks/extensions-DZDQn8O8.js";
 //#region src/analytics.d.ts
 type ConsentMode = "anonymous" | "granted" | "denied";
 interface IdentifyOptions {
@@ -32,7 +32,7 @@ export declare class WebAnalytics {
   private readonly baseUrl;
   private readonly debug;
   private readonly cleanup;
-  private started;
+  private state;
   private heartbeatTimer;
   private extensions;
   private pageKey;
@@ -53,6 +53,8 @@ export declare class WebAnalytics {
   private canTrack;
   private isCookieless;
   private isActive;
+  private session;
+  private context;
   private activate;
   private startExtensions;
   private stopExtensions;

package/dist/index.js

@@ -1,22 +1,23 @@
-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-DAVUdfNm.js";
-import { n as resetAnonymousId, t as getAnonymousId } from "./chunks/identifiers-BgGtAQdp.js";
+import { a as resetSession, d as getPageContext, f as resolveBaseUrl, n as createId, o as touchActivity, p as sanitizeUrl, r as getSessionContext, t as sendData, u as URLS } from "./chunks/send-data-D520oab1.js";
+import { n as resetAnonymousId, t as getAnonymousId } from "./chunks/identifiers-BwGNL11R.js";
 //#region src/extensions.ts
 var ExtensionHost = class {
-	runtime;
+	context;
+	log;
 	handlers = /* @__PURE__ */ new Map();
 	cleanups = [];
 	stopped = false;
-	constructor(extensions, runtime) {
-		this.runtime = runtime;
+	constructor(extensions, context, log) {
+		this.context = context;
+		this.log = log;
 		for (const extension of extensions) this.setup(extension);
 	}
 	emit(hook, event) {
 		if (this.stopped) return;
 		for (const handler of this.handlers.get(hook) ?? []) try {
-			handler(event)?.catch((error) => this.runtime.log(`${hook} failed`, error));
+			handler(event)?.catch((error) => this.log(`${hook} failed`, error));
 		} catch (error) {
-			this.runtime.log(`${hook} failed`, error);
+			this.log(`${hook} failed`, error);
 		}
 	}
 	stop(discard = false) {
@@ -25,7 +26,7 @@ var ExtensionHost = class {
 		for (const cleanup of this.cleanups.reverse()) try {
 			cleanup({ discard });
 		} catch (error) {
-			this.runtime.log("cleanup failed", error);
+			this.log("cleanup failed", error);
 		}
 		this.cleanups.length = 0;
 		this.handlers.clear();
@@ -35,7 +36,7 @@ var ExtensionHost = class {
 		const subscriptions = [];
 		try {
 			const cleanup = await extension.setup({
-				...this.runtime,
+				...this.context,
 				on: (hook, handler) => {
 					if (this.stopped) return () => {};
 					let handlers = this.handlers.get(hook);
@@ -53,11 +54,40 @@ var ExtensionHost = class {
 			else if (cleanup) this.cleanups.push(cleanup);
 		} catch (error) {
 			for (const off of subscriptions) off();
-			this.runtime.log(`${extension.name} setup failed`, error);
+			this.log(`${extension.name} setup failed`, error);
 		}
 	}
 };
 //#endregion
+//#region src/outbound-links.ts
+const DEDUPE_MS = 500;
+function outboundHref(event) {
+	for (const node of event.composedPath()) if (node instanceof HTMLAnchorElement && (node.protocol === "http:" || node.protocol === "https:") && node.host !== location.host) return node.href;
+}
+function trackOutboundLinks(report) {
+	let last;
+	const onClick = (event) => {
+		if (!(event instanceof MouseEvent) || event.defaultPrevented) return;
+		if (event.button !== (event.type === "click" ? 0 : 1)) return;
+		const href = outboundHref(event);
+		if (!href) return;
+		const key = `${event.button}:${event.clientX}:${event.clientY}:${href}`;
+		const now = Date.now();
+		const duplicate = last?.key === key && now - last.at <= DEDUPE_MS;
+		last = {
+			key,
+			at: now
+		};
+		if (!duplicate) report(sanitizeUrl(href));
+	};
+	document.addEventListener("click", onClick, true);
+	document.addEventListener("auxclick", onClick, true);
+	return () => {
+		document.removeEventListener("click", onClick, true);
+		document.removeEventListener("auxclick", onClick, true);
+	};
+}
+//#endregion
 //#region src/analytics.ts
 const navigationListeners = /* @__PURE__ */ new Set();
 const historyPatches = {};
@@ -95,12 +125,18 @@ function observeHistory(listener) {
 		}
 	};
 }
+const RESERVED_EVENTS = /* @__PURE__ */ new Set([
+	"pageview",
+	"page_leave",
+	"error",
+	"outbound_link"
+]);
 var WebAnalytics = class {
 	options;
 	baseUrl;
 	debug;
 	cleanup = [];
-	started = false;
+	state = "idle";
 	heartbeatTimer = null;
 	extensions = null;
 	pageKey = "";
@@ -110,20 +146,20 @@ var WebAnalytics = class {
 	constructor(options) {
 		this.options = options;
 		if (!options.siteKey.trim()) throw new Error("siteKey is required");
-		this.baseUrl = resolveBaseUrl(options.baseUrl, ANALYTICS_BASE);
+		this.baseUrl = resolveBaseUrl(options.baseUrl);
 		this.debug = options.debug ?? false;
 		this.consentMode = options.consent ?? "granted";
 	}
 	start() {
-		if (this.started !== false || typeof window === "undefined") return;
-		this.started = true;
+		if (this.state !== "idle" || typeof window === "undefined") return;
+		this.state = "started";
 		this.installBrowserLifecycle();
 		if (this.canTrack()) this.activate("load");
 	}
 	destroy() {
-		if (this.started === null) return;
+		if (this.state === "destroyed") return;
 		this.leavePage();
-		this.started = null;
+		this.state = "destroyed";
 		this.pendingPageview = null;
 		for (const cleanup of this.cleanup.splice(0).reverse()) cleanup();
 		this.stopExtensions(false);
@@ -135,26 +171,22 @@ var WebAnalytics = class {
 			this.leavePage();
 			if (this.pageKey) this.extensions?.emit("pageChange", { url: getPageContext(this.options.trackHash).url ?? "" });
 			this.pageKey = key;
+			this.pendingPageview = null;
 		}
 		if (document.visibilityState !== "visible") {
-			this.pendingPageview = properties;
+			this.pendingPageview ??= properties;
 			return;
 		}
 		this.pendingPageview = null;
 		if (document.hasFocus()) touchActivity(this.options.siteKey, this.isCookieless());
-		const session = getSessionContext(this.options.siteKey, this.isCookieless());
-		const userId = this.getAnonymousId();
-		if (this.visit?.session.sessionId === session.sessionId && this.visit.context.userId === (userId || void 0)) return;
+		const session = this.session();
+		const context = this.context(session);
+		if (this.visit?.session.sessionId === session.sessionId && this.visit.context.userId === context.userId) return;
 		this.leavePage();
 		this.visit = {
 			id: createId(),
 			session,
-			context: {
-				...getPageContext(this.options.trackHash),
-				userId: userId || void 0,
-				sessionId: session.sessionId,
-				windowId: session.windowId
-			},
+			context,
 			duration: 0,
 			startedAt: null,
 			reportedDuration: -1
@@ -168,7 +200,7 @@ var WebAnalytics = class {
 	track(name, properties = {}) {
 		if (!this.isActive()) return;
 		const eventName = name.trim();
-		if (!eventName || eventName === "pageview" || eventName === "page_leave" || eventName === "error" || eventName === "outbound_link") return;
+		if (!eventName || RESERVED_EVENTS.has(eventName)) return;
 		this.pageview({ trigger: "session" });
 		this.send(eventName, properties);
 	}
@@ -233,7 +265,7 @@ var WebAnalytics = class {
 		if (wasTracking) {
 			this.extensions?.emit("consentChange", { cookieless: willBeCookieless });
 			if (wasCookieless !== willBeCookieless) this.pageview({ trigger: "consent" });
-		} else if (this.started) this.activate("consent");
+		} else if (this.state === "started") this.activate("consent");
 	}
 	getAnonymousId() {
 		return this.canTrack() ? getAnonymousId(this.options.siteKey, this.isCookieless()) : "";
@@ -249,7 +281,18 @@ var WebAnalytics = class {
 		return this.options.cookieless === true || this.consentMode === "anonymous";
 	}
 	isActive() {
-		return this.started === true && this.canTrack();
+		return this.state === "started" && this.canTrack();
+	}
+	session() {
+		return getSessionContext(this.options.siteKey, this.isCookieless());
+	}
+	context(session = this.session()) {
+		return {
+			...getPageContext(this.options.trackHash),
+			userId: this.getAnonymousId() || void 0,
+			sessionId: session.sessionId,
+			windowId: session.windowId
+		};
 	}
 	activate(trigger) {
 		this.startExtensions();
@@ -257,22 +300,17 @@ var WebAnalytics = class {
 	}
 	startExtensions() {
 		if (this.extensions || !this.options.extensions?.length) return;
-		const host = new ExtensionHost(this.options.extensions, {
+		this.extensions = new ExtensionHost(this.options.extensions, {
 			siteKey: this.options.siteKey,
 			baseUrl: this.baseUrl,
 			debug: this.debug,
 			trackHash: this.options.trackHash ?? false,
 			sdkName: this.options.sdkName,
 			sdkVersion: this.options.sdkVersion,
-			isCookieless: () => this.isCookieless(),
-			getAnonymousId: () => this.getAnonymousId(),
-			getSession: () => getSessionContext(this.options.siteKey, this.isCookieless()),
-			capture: (event, properties) => this.send(event, properties),
-			log: (...details) => {
-				if (this.debug) console.log(...details);
-			}
+			isCookieless: () => this.isCookieless()
+		}, (...details) => {
+			if (this.debug) console.log(...details);
 		});
-		this.extensions = host;
 	}
 	stopExtensions(discard) {
 		this.extensions?.stop(discard);
@@ -286,7 +324,7 @@ var WebAnalytics = class {
 		this.bind(window, "blur", () => this.pauseVisit());
 		this.bind(window, "popstate", this.onNavigate);
 		if (this.options.trackHash) this.bind(window, "hashchange", this.onNavigate);
-		this.cleanup.push(observeHistory(this.onNavigate));
+		this.cleanup.push(observeHistory(this.onNavigate), trackOutboundLinks((url) => this.send("outbound_link", { outbound_link: url })));
 	}
 	bind(target, type, listener) {
 		target.addEventListener(type, listener);
@@ -359,21 +397,14 @@ var WebAnalytics = class {
 				this.pauseVisit();
 				return;
 			}
+			const visit = this.visit;
 			this.pageview({ trigger: "session" });
-			this.checkpoint();
+			if (this.visit === visit) this.checkpoint();
 		}, 15e3);
 	}
 	send(event, properties = {}, context) {
 		if (!this.isActive()) return;
-		if (!context) {
-			const session = getSessionContext(this.options.siteKey, this.isCookieless());
-			context = {
-				...getPageContext(this.options.trackHash),
-				userId: this.getAnonymousId() || void 0,
-				sessionId: session.sessionId,
-				windowId: session.windowId
-			};
-		}
+		context ??= this.context();
 		let data;
 		try {
 			data = JSON.stringify({

package/dist/replay.d.ts

@@ -1,4 +1,4 @@
-import { t as AnalyticsExtension } from "./chunks/extensions-DW7tJY0T.js";
+import { t as AnalyticsExtension } from "./chunks/extensions-DZDQn8O8.js";
 import { record } from "@rrweb/record";
 import { LogLevel } from "@rrweb/rrweb-plugin-console-record";
 import { NetworkRecordOptions } from "@rrweb/rrweb-plugin-network-record";
@@ -96,6 +96,7 @@ export default class ReplayTracker {
   constructor(options: ReplayTrackerOptions);
   private log;
   private clearFlushTimers;
+  private dropEvents;
   private clearQueues;
   private finalizeSession;
   setCookielessMode(cookieless: boolean): void;
@@ -112,7 +113,6 @@ export default class ReplayTracker {
   private beginReplayStream;
   private resetSessionTiming;
   private onEvent;
-  private onUnload;
   private requestTerminalFlush;
   private hasReachedMinLength;
   private requestFlush;

package/dist/replay.js

@@ -1,6 +1,5 @@
-import { a as sanitizeUrl, i as resolveBaseUrl, n as URLS, t as ANALYTICS_BASE } from "./chunks/api-urls-DWk43fu6.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-DAVUdfNm.js";
-import { t as getAnonymousId } from "./chunks/identifiers-BgGtAQdp.js";
+import { f as resolveBaseUrl, i as onSessionRotated, l as setStorageItem, n as createId, o as touchActivity, p as sanitizeUrl, r as getSessionContext, s as getStorageItem, t as sendData, u as URLS } from "./chunks/send-data-D520oab1.js";
+import { t as getAnonymousId } from "./chunks/identifiers-BwGNL11R.js";
 import { record } from "@rrweb/record";
 import { getRecordConsolePlugin } from "@rrweb/rrweb-plugin-console-record";
 import { getRecordNetworkPlugin } from "@rrweb/rrweb-plugin-network-record";
@@ -57,50 +56,39 @@ const counters = /* @__PURE__ */ new Map();
 function sameRecording(counter, context) {
 	return counter?.sessionId === context.sessionId && counter.windowId === context.windowId;
 }
-function readCounter(value) {
+function readCounter(siteKey, cookieless) {
+	const raw = cookieless ? null : getStorageItem("sessionStorage", sequenceKey(siteKey));
+	if (raw === null) return { corrupt: false };
 	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;
+		const parsed = JSON.parse(raw);
+		if (parsed && typeof parsed.sessionId === "string" && typeof parsed.windowId === "string" && typeof parsed.next === "number" && Number.isSafeInteger(parsed.next) && parsed.next >= 0) return {
+			corrupt: false,
+			counter: parsed
+		};
 	} catch {}
+	return { corrupt: true };
 }
 const sequenceKey = (siteKey) => `faststats_replay_sequence_v1_${siteKey}`;
 /** Whether this recording already sent batches, e.g. from an earlier page load. */
 function hasReplaySequence(siteKey, context, cookieless) {
-	const raw = cookieless ? null : getStorageItem("sessionStorage", sequenceKey(siteKey));
-	return [counters.get(siteKey), raw === null ? void 0 : readCounter(raw)].some((counter) => sameRecording(counter, context) && counter.next > 0);
+	return [counters.get(siteKey), readCounter(siteKey, cookieless).counter].some((counter) => sameRecording(counter, context) && counter.next > 0);
 }
+/** Next batch sequence for this recording, or undefined when it cannot be trusted. */
 function nextReplaySequence(siteKey, context, cookieless) {
-	const key = sequenceKey(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,
+	const stored = readCounter(siteKey, cookieless);
+	if (stored.corrupt && !sameRecording(cached, context)) return;
+	let sequence = sameRecording(cached, context) ? cached.next : 0;
+	if (sameRecording(stored.counter, context)) sequence = Math.max(sequence, stored.counter.next);
+	if (!Number.isSafeInteger(sequence + 1)) return;
+	const counter = {
+		sessionId: context.sessionId,
+		windowId: context.windowId,
 		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 } : {}
-	};
+	counters.set(siteKey, counter);
+	if (!cookieless) setStorageItem("sessionStorage", sequenceKey(siteKey), JSON.stringify(counter));
+	return sequence;
 }
 //#endregion
 //#region src/replay.ts
@@ -183,7 +171,7 @@ var ReplayTracker = class {
 	constructor(options) {
 		this.options = options;
 		this.lastCookielessMode = options.cookieless ?? false;
-		this.endpoint = `${resolveBaseUrl(options.baseUrl, ANALYTICS_BASE)}${URLS.replay}`;
+		this.endpoint = `${resolveBaseUrl(options.baseUrl)}${URLS.replay}`;
 		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);
@@ -205,10 +193,13 @@ var ReplayTracker = class {
 		this.retryAttempt = 0;
 		this.minLengthFlushTask = null;
 	}
-	clearQueues() {
-		this.needsFinalization = false;
+	dropEvents() {
 		this.events.length = 0;
 		this.queuedEventsSizeBytes = 0;
+	}
+	clearQueues() {
+		this.needsFinalization = false;
+		this.dropEvents();
 		this.pending.length = 0;
 		this.pendingSizeBytes = 0;
 	}
@@ -243,7 +234,6 @@ var ReplayTracker = class {
 		this.subscribeToSessionRotation();
 		this.beginRecording();
 		this.intervalId = setInterval(() => this.requestFlush("interval"), this.flushInterval);
-		window.addEventListener("beforeunload", this.onUnload);
 		this.log("Recording started");
 	}
 	trackPageChange(url) {
@@ -293,7 +283,7 @@ var ReplayTracker = class {
 		}));
 		if (this.options.recordNetwork === true) {
 			const options = this.options.networkOptions;
-			const base = resolveBaseUrl(this.options.baseUrl, ANALYTICS_BASE);
+			const base = resolveBaseUrl(this.options.baseUrl);
 			const endpoints = new Set(Object.values(URLS).map((path) => {
 				const url = new URL(`${base}${path}`, window.location.href);
 				return `${url.origin}${url.pathname}`;
@@ -356,15 +346,13 @@ var ReplayTracker = class {
 		if (this.intervalId) clearInterval(this.intervalId);
 		this.clearFlushTimers();
 		this.intervalId = null;
-		window.removeEventListener("beforeunload", this.onUnload);
 		if (discard) {
 			this.clearQueues();
 			this.log("Recording discarded");
 			return;
 		}
 		if (!this.hasReachedMinLength()) {
-			this.events.length = 0;
-			this.queuedEventsSizeBytes = 0;
+			this.dropEvents();
 			this.needsFinalization = false;
 			this.log(`Recording too short (${Date.now() - this.startTime}ms), discarding events`);
 		}
@@ -383,10 +371,7 @@ var ReplayTracker = class {
 	applySessionRotation(prev, next) {
 		if (this.activeSessionId === next.sessionId) return;
 		if (this.hasReachedMinLength()) this.enqueueEventsIfReady(prev, "sessionRotate");
-		else {
-			this.events.length = 0;
-			this.queuedEventsSizeBytes = 0;
-		}
+		else this.dropEvents();
 		this.finalizeSession(prev, "sessionRotate");
 		this.needsFinalization = false;
 		this.activeSessionId = next.sessionId;
@@ -457,13 +442,9 @@ var ReplayTracker = class {
 		if (reason) this.requestFlush(reason);
 		else this.scheduleMinLengthFlush();
 	};
-	onUnload = () => {
-		this.flush(true, false, "unload");
-	};
 	requestTerminalFlush(reason) {
 		if (!this.hasReachedMinLength()) {
-			this.events.length = 0;
-			this.queuedEventsSizeBytes = 0;
+			this.dropEvents();
 			this.needsFinalization = false;
 			return;
 		}
@@ -472,7 +453,7 @@ var ReplayTracker = class {
 	hasReachedMinLength() {
 		return this.resumed || this.minReplayLengthMs <= 0 || Date.now() - this.startTime >= this.minReplayLengthMs;
 	}
-	requestFlush = (reason = "manual") => {
+	requestFlush(reason) {
 		if (this.flushTask || this.events.length === 0) return;
 		if (this.minLengthFlushTask) {
 			clearTimeout(this.minLengthFlushTask);
@@ -482,7 +463,7 @@ var ReplayTracker = class {
 			this.flushTask = null;
 			this.flush(false, false, reason);
 		}, 0);
-	};
+	}
 	scheduleMinLengthFlush() {
 		if (!this.initialFlushPending || this.events.length === 0 || this.minReplayLengthMs <= 0) return;
 		if (this.hasReachedMinLength()) {
@@ -498,7 +479,7 @@ var ReplayTracker = class {
 			this.requestFlush("minLength");
 		}, Math.min(remainingMs, MAX_TIMEOUT_MS));
 	}
-	enqueueEventsIfReady(context, flushReason = "manual", maxBatchSizeBytes = this.maxBatchSizeBytes) {
+	enqueueEventsIfReady(context, flushReason, maxBatchSizeBytes = this.maxBatchSizeBytes) {
 		if (this.events.length === 0) return;
 		if (!this.hasReachedMinLength()) {
 			this.scheduleMinLengthFlush();
@@ -532,10 +513,10 @@ var ReplayTracker = class {
 		if (current.length > 0) batches.push(current);
 		return batches;
 	}
-	createBatch(events, context, isFinal, flushReason = "manual") {
+	createBatch(events, context, isFinal, flushReason) {
 		const identifier = getAnonymousId(this.options.siteKey, this.lastCookielessMode);
 		const sequence = nextReplaySequence(this.options.siteKey, context, this.lastCookielessMode);
-		if (!sequence) {
+		if (sequence === void 0) {
 			this.stopCapture("Replay sequence state is invalid or exhausted");
 			return;
 		}
@@ -551,8 +532,9 @@ var ReplayTracker = class {
 			chunkStartedAt,
 			chunkEndedAt: now,
 			...identifier ? { identifier } : {},
-			batchId: `${context.sessionId}-${sequence.sequence}-${chunkStartedAt}`,
-			...sequence,
+			batchId: `${context.sessionId}-${sequence}-${chunkStartedAt}`,
+			sequence,
+			sequenceContractVersion: 1,
 			timestamp: now,
 			url: this.viewUrl || sanitizeUrl(window.location.href, this.options.trackHash ?? false),
 			...isFinal ? { isFinal: true } : {},
@@ -647,7 +629,7 @@ var ReplayTracker = class {
 	}
 	async sendBatch(batch, lowLatency) {
 		const json = JSON.stringify(batch);
-		const lowLatencySafe = lowLatency && textEncoder.encode(json).byteLength <= 61440;
+		const lowLatencySafe = lowLatency && this.batchSizeBytes(batch) <= DEFAULT_MAX_LOW_LATENCY_BATCH_SIZE_BYTES;
 		const sendOptions = {
 			debug: this.options.debug,
 			debugPrefix: "[Replay]",

package/dist/web-vitals.d.ts

@@ -1,4 +1,4 @@
-import { t as AnalyticsExtension } from "./chunks/extensions-DW7tJY0T.js";
+import { t as AnalyticsExtension } from "./chunks/extensions-DZDQn8O8.js";
 //#region src/web-vitals.d.ts
 export interface WebVitalsOptions {
   siteKey: string;

package/dist/web-vitals.js

@@ -1,5 +1,4 @@
-import { a as sanitizeUrl, i as resolveBaseUrl, n as URLS, t as ANALYTICS_BASE } from "./chunks/api-urls-DWk43fu6.js";
-import { r as getSessionContext, t as sendData } from "./chunks/send-data-DAVUdfNm.js";
+import { f as resolveBaseUrl, p as sanitizeUrl, r as getSessionContext, t as sendData, u as URLS } from "./chunks/send-data-D520oab1.js";
 import { onCLS, onFCP, onINP, onLCP, onTTFB } from "web-vitals/attribution";
 //#region src/utils/web-vitals-collector.ts
 const collectors = /* @__PURE__ */ new WeakMap();
@@ -72,7 +71,7 @@ var WebVitalsTracker = class {
 	cookieless;
 	constructor(options) {
 		this.options = options;
-		this.endpoint = `${resolveBaseUrl(options.baseUrl, ANALYTICS_BASE)}${URLS.vitals}`;
+		this.endpoint = `${resolveBaseUrl(options.baseUrl)}${URLS.vitals}`;
 		this.cookieless = options.cookieless ?? false;
 	}
 	setCookielessMode(cookieless) {
@@ -104,10 +103,8 @@ var WebVitalsTracker = class {
 		});
 	}
 	onMetric = (metric) => {
-		if (!this.started) return;
-		const name = metric.name;
-		if (!METRIC_NAMES.has(name) || !Number.isFinite(metric.value) || metric.value < 0) return;
-		this.metrics.set(name, metric);
+		if (!this.started || !METRIC_NAMES.has(metric.name) || !Number.isFinite(metric.value) || metric.value < 0) return;
+		this.metrics.set(metric.name, metric);
 	};
 	discard() {
 		this.generation++;

package/package.json

@@ -13,11 +13,6 @@
 			"import": "./dist/index.js",
 			"default": "./dist/index.js"
 		},
-		"./outbound-links": {
-			"types": "./dist/outbound-links.d.ts",
-			"import": "./dist/outbound-links.js",
-			"default": "./dist/outbound-links.js"
-		},
 		"./replay": {
 			"types": "./dist/replay.d.ts",
 			"import": "./dist/replay.js",
@@ -42,7 +37,7 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"version": "0.10.3",
+	"version": "0.11.0",
 	"scripts": {
 		"build": "tsdown && bun run check-size",
 		"dev": "bun run build",

package/dist/chunks/api-urls-DWk43fu6.js

@@ -1,53 +0,0 @@
-//#region src/utils/api-urls.ts
-const ANALYTICS_BASE = "https://metrics.faststats.dev";
-function resolveBaseUrl(input, fallback) {
-	return input?.replace(/\/+$/, "") || fallback;
-}
-const URLS = {
-	events: "/v1/web",
-	identify: "/v1/identify",
-	replay: "/v1/replay",
-	vitals: "/v1/vitals"
-};
-function sanitizeUrl(url, includeHash = false) {
-	try {
-		const parsed = new URL(url, location.href);
-		return `${parsed.origin}${parsed.pathname}${includeHash ? parsed.hash : ""}`;
-	} catch {
-		return url.split(includeHash ? "?" : /[?#]/, 1)[0] ?? "";
-	}
-}
-const UTM_KEYS = [
-	"utm_source",
-	"utm_medium",
-	"utm_campaign",
-	"utm_term",
-	"utm_content"
-];
-function getReferrer() {
-	const raw = document.referrer;
-	if (!raw) return null;
-	try {
-		const pageOrigin = new URL(location.href).origin;
-		if (new URL(raw, location.href).origin === pageOrigin) return null;
-	} catch {}
-	return sanitizeUrl(raw);
-}
-function getPageContext(includeHash = false) {
-	const hash = includeHash ? location.hash : "";
-	const ctx = {
-		page: `${location.pathname}${hash}`,
-		url: sanitizeUrl(location.href, includeHash),
-		referrer: getReferrer(),
-		title: document.title || ""
-	};
-	if (!location.search) return ctx;
-	const sp = new URLSearchParams(location.search);
-	for (const key of UTM_KEYS) {
-		const value = sp.get(key);
-		if (value) ctx[key] = value;
-	}
-	return ctx;
-}
-//#endregion
-export { sanitizeUrl as a, resolveBaseUrl as i, URLS as n, getPageContext as r, ANALYTICS_BASE as t };

package/dist/outbound-links.d.ts

@@ -1,9 +0,0 @@
-import { t as AnalyticsExtension } from "./chunks/extensions-DW7tJY0T.js";
-//#region src/outbound-links.d.ts
-export declare function outboundLinks(): AnalyticsExtension;
-export declare class OutboundLinkTracker {
-  private lastActivation;
-  getHref(event: Event): string | null;
-  private isDuplicate;
-}
-//#endregion

package/dist/outbound-links.js

@@ -1,62 +0,0 @@
-import { a as sanitizeUrl } from "./chunks/api-urls-DWk43fu6.js";
-//#region src/outbound-links.ts
-function outboundLinks() {
-	return {
-		name: "outbound-links",
-		setup(context) {
-			const tracker = new OutboundLinkTracker();
-			const onClick = (event) => {
-				const href = tracker.getHref(event);
-				if (href) context.capture("outbound_link", { outbound_link: sanitizeUrl(href) });
-			};
-			document.addEventListener("click", onClick, true);
-			document.addEventListener("auxclick", onClick, true);
-			return () => {
-				document.removeEventListener("click", onClick, true);
-				document.removeEventListener("auxclick", onClick, true);
-			};
-		}
-	};
-}
-const DEDUPE_MS = 500;
-var OutboundLinkTracker = class {
-	lastActivation = null;
-	getHref(event) {
-		if (!(event instanceof MouseEvent) || !isEligibleActivation(event)) return null;
-		const anchor = findOutboundAnchor(event);
-		if (!anchor || this.isDuplicate(event, anchor.href)) return null;
-		return anchor.href;
-	}
-	isDuplicate(event, href) {
-		const activation = {
-			button: event.button,
-			href,
-			clientX: event.clientX,
-			clientY: event.clientY,
-			at: Date.now()
-		};
-		const previous = this.lastActivation;
-		this.lastActivation = activation;
-		return !!(previous && previous.href === activation.href && previous.button === activation.button && previous.clientX === activation.clientX && previous.clientY === activation.clientY && activation.at - previous.at <= DEDUPE_MS);
-	}
-};
-function isEligibleActivation(event) {
-	if (event.defaultPrevented) return false;
-	if (event.type === "click") return event.button === 0;
-	if (event.type === "auxclick") return event.button === 1;
-	return false;
-}
-function findOutboundAnchor(event) {
-	for (const node of event.composedPath()) if (isOutboundAnchor(node)) return node;
-	let node = event.target;
-	while (node) {
-		if (isOutboundAnchor(node)) return node;
-		node = node.parentNode;
-	}
-	return null;
-}
-function isOutboundAnchor(node) {
-	return node instanceof HTMLAnchorElement && (node.protocol === "http:" || node.protocol === "https:") && node.host !== location.host;
-}
-//#endregion
-export { OutboundLinkTracker, outboundLinks };