@faststats/web 0.10.3 → 0.12.0

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-BfubKIzk.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,24 @@
-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 sanitizeUrl, i as resolveBaseUrl, n as URLS, r as getPageContext, t as sendData } from "./chunks/send-data-DYZZjeM-.js";
+import { a as touchActivity, i as resetSession, n as getSessionContext, t as createId } from "./chunks/session-manager-CFQEWbgo.js";
+import { n as resetAnonymousId, t as getAnonymousId } from "./chunks/identifiers-CpmDmpDv.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 +27,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 +37,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 +55,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 +126,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 +147,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 +172,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 +201,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);
 	}
@@ -181,6 +214,7 @@ var WebAnalytics = class {
 		} : userOrExternalId;
 		const externalId = user.id.trim();
 		if (!externalId) return false;
+		this.extensions?.emit("identityChange", { userId: externalId });
 		const clearFields = [
 			"email",
 			"name",
@@ -214,6 +248,7 @@ var WebAnalytics = class {
 		this.leavePage();
 		if (resetAnonymousIdentity) resetAnonymousId(this.options.siteKey, this.isCookieless());
 		resetSession(this.options.siteKey, this.isCookieless());
+		this.extensions?.emit("identityChange", { userId: void 0 });
 		this.pageview({ trigger: "logout" });
 	}
 	setConsentMode(mode) {
@@ -233,7 +268,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 +284,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 +303,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 +327,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 +400,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,8 +1,8 @@
-import { t as AnalyticsExtension } from "./chunks/extensions-DW7tJY0T.js";
+import { t as AnalyticsExtension } from "./chunks/extensions-BfubKIzk.js";
 import { record } from "@rrweb/record";
 import { LogLevel } from "@rrweb/rrweb-plugin-console-record";
 import { NetworkRecordOptions } from "@rrweb/rrweb-plugin-network-record";
-//#region ../../node_modules/.bun/@rrweb+types@2.1.6/node_modules/@rrweb/types/dist/index.d.ts
+//#region ../../node_modules/.bun/@rrweb+types@2.1.7/node_modules/@rrweb/types/dist/index.d.ts
 declare global {
   interface Window {
     FontFace: typeof FontFace;
@@ -58,7 +58,7 @@ export declare function sessionReplay(options?: SessionReplayExtensionOptions):
 export default class ReplayTracker {
   private readonly options;
   private readonly endpoint;
-  private readonly compressionSupported;
+  private readonly compress;
   private readonly flushInterval;
   private readonly maxEvents;
   private readonly maxBatchSizeBytes;
@@ -95,7 +95,10 @@ export default class ReplayTracker {
   private readonly mutationThrottler;
   constructor(options: ReplayTrackerOptions);
   private log;
+  private sessionContext;
+  private sanitize;
   private clearFlushTimers;
+  private dropEvents;
   private clearQueues;
   private finalizeSession;
   setCookielessMode(cookieless: boolean): void;
@@ -112,7 +115,6 @@ export default class ReplayTracker {
   private beginReplayStream;
   private resetSessionTiming;
   private onEvent;
-  private onUnload;
   private requestTerminalFlush;
   private hasReachedMinLength;
   private requestFlush;