@faststats/web 0.7.0 → 0.8.1

package/dist/index.js

@@ -1,92 +1,108 @@
-import { a as resolveBaseUrl, i as getPageContext, n as FEATURE_FLAGS_BASE, o as sanitizeUrl, r as URLS, t as ANALYTICS_BASE } from "./chunks/api-urls-Dp2XNjRF.js";
-import { c as touchActivity, l as getStorageItem, o as resetSession, r as getSessionContext, s as setCookielessMode, t as sendData } from "./chunks/send-data-DR1JUXka.js";
-import { n as resetAnonymousId, t as getAnonymousId } from "./chunks/identifiers-BvRNbiwA.js";
-//#region src/outbound-links.ts
-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;
+import { a as sanitizeUrl, i as resolveBaseUrl, n as URLS, r as getPageContext, t as ANALYTICS_BASE } from "./chunks/api-urls-DWk43fu6.js";
+import { a as resetSession, o as touchActivity, r as getSessionContext, t as sendData } from "./chunks/send-data-DFZnsaL2.js";
+import { n as resetAnonymousId, t as getAnonymousId } from "./chunks/identifiers-KgQDX74Q.js";
+//#region src/extensions.ts
+var ExtensionHost = class {
+	runtime;
+	handlers = /* @__PURE__ */ new Map();
+	cleanups = [];
+	stopped = false;
+	constructor(extensions, runtime) {
+		this.runtime = runtime;
+		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));
+		} catch (error) {
+			this.runtime.log(`${hook} failed`, error);
+		}
 	}
-	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);
+	stop(discard = false) {
+		if (this.stopped) return;
+		this.stopped = true;
+		for (const cleanup of this.cleanups.reverse()) try {
+			cleanup({ discard });
+		} catch (error) {
+			this.runtime.log("cleanup failed", error);
+		}
+		this.cleanups.length = 0;
+		this.handlers.clear();
+	}
+	async setup(extension) {
+		if (this.stopped) return;
+		const subscriptions = [];
+		try {
+			const cleanup = await extension.setup({
+				...this.runtime,
+				on: (hook, handler) => {
+					if (this.stopped) return () => {};
+					let handlers = this.handlers.get(hook);
+					if (!handlers) {
+						handlers = /* @__PURE__ */ new Set();
+						this.handlers.set(hook, handlers);
+					}
+					handlers.add(handler);
+					const off = () => handlers.delete(handler);
+					subscriptions.push(off);
+					return off;
+				}
+			});
+			if (this.stopped) cleanup?.({ discard: true });
+			else if (cleanup) this.cleanups.push(cleanup);
+		} catch (error) {
+			for (const off of subscriptions) off();
+			this.runtime.log(`${extension.name} setup failed`, error);
+		}
 	}
 };
-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
 //#region src/analytics.ts
-let instance = null;
-let pendingConsentMode;
-function getInstance() {
-	return instance;
-}
-function activeInstance() {
-	if (typeof window === "undefined" || isTrackingDisabled()) return null;
-	return instance;
-}
-function trackEvent(eventName, properties) {
-	activeInstance()?.track(eventName, properties);
-}
-async function identify(externalId, email, options) {
-	return activeInstance()?.identify(externalId, email, options) ?? false;
-}
-function logout(resetAnonymousIdentity = true) {
-	activeInstance()?.logout(resetAnonymousIdentity);
-}
-function setConsentMode(mode) {
-	if (instance) instance.setConsentMode(mode);
-	else pendingConsentMode = mode;
-}
-function optIn() {
-	setConsentMode("granted");
-}
-function optOut() {
-	setConsentMode("denied");
-}
-function reportError(error) {
-	activeInstance()?.reportError(error);
+const navigationListeners = /* @__PURE__ */ new Set();
+const historyPatches = {};
+function patchHistory(method) {
+	if (historyPatches[method]?.owner === history) return;
+	const original = history[method];
+	const wrapped = function(data, unused, url) {
+		Reflect.apply(original, this, [
+			data,
+			unused,
+			url
+		]);
+		for (const listener of navigationListeners) listener();
+	};
+	history[method] = wrapped;
+	historyPatches[method] = {
+		owner: history,
+		original,
+		wrapped
+	};
 }
-function isTrackingDisabled() {
-	const value = getStorageItem("localStorage", "disable-faststats");
-	return value === "true" || value === "1";
+function observeHistory(listener) {
+	navigationListeners.add(listener);
+	patchHistory("pushState");
+	patchHistory("replaceState");
+	return () => {
+		navigationListeners.delete(listener);
+		if (navigationListeners.size) return;
+		for (const method of ["pushState", "replaceState"]) {
+			const patch = historyPatches[method];
+			if (patch && history[method] === patch.wrapped) {
+				history[method] = patch.original;
+				delete historyPatches[method];
+			}
+		}
+	};
 }
 var WebAnalytics = class {
 	options;
 	baseUrl;
 	debug;
+	cleanup = [];
 	started = false;
-	destroyed = false;
-	epoch = 0;
 	heartbeatTimer = null;
+	extensions = null;
 	pageKey = "";
 	entry = {
 		path: "",
@@ -98,365 +114,327 @@ var WebAnalytics = class {
 	visitStartedAt = null;
 	pendingPageviewTrigger = null;
 	consentMode;
-	pendingBehavior;
-	cleanup = [];
-	childTrackers = [];
-	outboundLinks = new OutboundLinkTracker();
 	constructor(options) {
 		this.options = options;
+		if (!options.siteKey.trim()) throw new Error("siteKey is required");
 		this.baseUrl = resolveBaseUrl(options.baseUrl, ANALYTICS_BASE);
 		this.debug = options.debug ?? false;
-		this.consentMode = pendingConsentMode ?? options.consent?.mode ?? "granted";
-		pendingConsentMode = void 0;
-		this.pendingBehavior = options.consent?.pendingBehavior ?? "anonymous";
-		if (options.autoTrack ?? true) {
-			if (typeof window === "undefined") return;
-			if (isTrackingDisabled()) {
-				this.log("disabled");
-				return;
-			}
-			setTimeout(() => void this.start(), 0);
-		}
-	}
-	log(msg) {
-		if (this.debug) console.log(`[Analytics] ${msg}`);
-	}
-	isTrackingBlocked() {
-		return typeof window === "undefined" || this.destroyed || isTrackingDisabled();
-	}
-	ensureActive() {
-		if (this.isTrackingBlocked()) return false;
-		if (!this.started) this.start();
-		return this.started && !this.destroyed && instance === this;
-	}
-	canTrack() {
-		return this.consentMode === "granted" || this.consentMode === "pending" && this.pendingBehavior === "anonymous";
-	}
-	canSendEvents() {
-		return !this.isTrackingBlocked() && this.canTrack();
-	}
-	cookieless() {
-		return !!this.options.cookieless || this.consentMode === "pending" && this.pendingBehavior === "anonymous";
-	}
-	touch() {
-		if (this.canTrack()) touchActivity(this.options.siteKey, this.cookieless());
-	}
-	bind(target, type, listener, options) {
-		target.addEventListener(type, listener, options);
-		this.cleanup.push(() => target.removeEventListener(type, listener, options));
-	}
-	stopHeartbeat() {
-		if (!this.heartbeatTimer) return;
-		clearInterval(this.heartbeatTimer);
-		this.heartbeatTimer = null;
-	}
-	loadChild(name, create) {
-		const epoch = this.epoch;
-		create().then(async (tracker) => {
-			if (this.epoch !== epoch || !this.started) return tracker.stop?.(true);
-			await tracker.start();
-			if (this.epoch !== epoch || !this.started) return tracker.stop?.(true);
-			this.childTrackers.push(tracker);
-			this.log(`${name} loaded`);
-		}).catch((error) => this.log(`failed to initialize ${name} tracker: ${String(error)}`));
-	}
-	loadOptionalTrackers() {
-		const o = this.options;
-		const base = {
-			siteKey: o.siteKey,
-			baseUrl: this.baseUrl,
-			debug: this.debug,
-			trackHash: o.trackHash ?? false
-		};
-		if (o.sessionReplays?.enabled) this.loadChild("replay", async () => {
-			const { default: ReplayTracker } = await import("./replay.js");
-			return new ReplayTracker({
-				...base,
-				...o.replayOptions
-			});
-		});
-		if (o.errorTracking?.enabled) this.loadChild("error", async () => {
-			const { default: ErrorTracker } = await import("./error.js");
-			return new ErrorTracker({
-				...base,
-				sdkName: o.sdkName,
-				sdkVersion: o.sdkVersion
-			});
-		});
-		if (o.webVitals?.enabled) this.loadChild("web-vitals", async () => {
-			const { default: WebVitalsTracker } = await import("./web-vitals.js");
-			return new WebVitalsTracker({
-				...base,
-				attribution: o.webVitals?.attribution ?? false
-			});
-		});
-	}
-	enterPage() {
-		const includeHash = this.options.trackHash ?? false;
-		const hash = includeHash ? location.hash : "";
-		this.entry = {
-			path: `${location.pathname}${hash}`,
-			url: sanitizeUrl(location.href, includeHash),
-			search: location.search
-		};
-		this.left = false;
-		this.startVisit();
-	}
-	beginTracking(trigger) {
-		this.touch();
-		this.loadOptionalTrackers();
-		this.enterPage();
-		this.pageKey = "";
-		if (document.visibilityState === "visible") {
-			this.pageview({ trigger });
-			return;
-		}
-		this.pendingPageviewTrigger = trigger;
+		this.consentMode = options.consent ?? "granted";
 	}
-	onLinkClick = (event) => {
-		const href = this.outboundLinks.getHref(event);
-		if (href) this.send("outbound_link", { outbound_link: sanitizeUrl(href) });
-	};
-	onVisibilityChange = () => {
-		this.touch();
-		if (document.visibilityState === "hidden") {
-			this.pauseVisit();
-			for (const tracker of this.childTrackers) tracker.onPageHidden?.(false, false);
-			this.stopHeartbeat();
-			return;
-		}
-		this.startHeartbeat();
-		this.resumeVisit();
-		const trigger = this.pendingPageviewTrigger;
-		this.pendingPageviewTrigger = null;
-		if (trigger) this.pageview({ trigger });
-	};
-	onPageHide = (event) => {
-		const persisted = event.persisted;
-		this.pauseVisit();
-		for (const tracker of this.childTrackers) tracker.onPageHidden?.(persisted, !persisted);
-		if (!persisted) this.leavePage();
-	};
-	onPageShow = (event) => {
-		if (document.visibilityState === "visible") this.resumeVisit();
-		for (const tracker of this.childTrackers) tracker.onPageShow?.(event.persisted);
-	};
-	async start() {
-		if (this.started) return;
-		if (this.isTrackingBlocked()) {
-			if (isTrackingDisabled()) this.log("disabled");
-			return;
-		}
-		if (instance && instance !== this) {
-			this.log("already started by another instance");
-			return;
-		}
+	start() {
+		if (this.started !== false || typeof window === "undefined") return;
 		this.started = true;
-		instance = this;
-		setCookielessMode(this.cookieless());
-		this.bind(document, "click", this.onLinkClick, true);
-		this.bind(document, "auxclick", this.onLinkClick, true);
-		this.bind(document, "visibilitychange", this.onVisibilityChange);
-		this.bind(window, "pagehide", this.onPageHide);
-		this.bind(window, "pageshow", this.onPageShow);
-		this.bind(window, "popstate", () => this.navigate());
-		if (this.options.trackHash ?? false) this.bind(window, "hashchange", () => this.navigate());
-		for (const method of ["pushState", "replaceState"]) {
-			const original = history[method];
-			const wrapped = (data, unused, url) => {
-				Reflect.apply(original, history, [
-					data,
-					unused,
-					url
-				]);
-				this.navigate();
-			};
-			history[method] = wrapped;
-			this.cleanup.push(() => {
-				if (history[method] === wrapped) history[method] = original;
-			});
-		}
-		this.startHeartbeat();
-		if (this.canTrack()) this.beginTracking("load");
+		this.installBrowserLifecycle();
+		if (this.canTrack()) this.activate("load");
 	}
 	destroy() {
-		if (this.destroyed) return;
-		this.epoch++;
-		if (this.started && typeof window !== "undefined") this.leavePage();
+		if (this.started === null) return;
+		if (this.started && typeof window !== "undefined" && this.canTrack()) this.leavePage();
+		this.started = null;
 		this.pendingPageviewTrigger = null;
 		this.stopHeartbeat();
-		for (const fn of this.cleanup.splice(0)) fn();
-		for (const tracker of this.childTrackers.splice(0)) tracker.stop?.();
-		if (instance === this) instance = null;
-		this.started = false;
-		this.destroyed = true;
+		for (const cleanup of this.cleanup.splice(0).reverse()) cleanup();
+		this.stopExtensions(false);
 	}
-	pageview(extra = {}) {
+	pageview(properties = {}) {
 		if (!this.ensureActive()) return;
-		const trackHash = this.options.trackHash ?? false;
-		const key = `${location.pathname}|${location.search}|${trackHash ? location.hash : ""}`;
+		const includeHash = this.options.trackHash ?? false;
+		const key = `${location.pathname}|${location.search}|${includeHash ? location.hash : ""}`;
 		if (key === this.pageKey) return;
 		this.pageKey = key;
-		this.send("pageview", extra);
+		this.send("pageview", properties);
 	}
-	track(name, extra = {}) {
+	track(name, properties = {}) {
 		if (!this.ensureActive()) return;
 		const eventName = name.trim();
 		if (!eventName || eventName === "pageview" || eventName === "page_leave" || eventName === "error" || eventName === "outbound_link") return;
-		this.send(eventName, extra);
-	}
-	async identify(externalId, email, options = {}) {
-		if (!this.ensureActive() || !this.canTrack() || this.cookieless()) return false;
-		const trimmedExternalId = externalId.trim();
-		const trimmedEmail = email.trim();
-		if (!trimmedExternalId || !trimmedEmail) return false;
-		return sendData({
+		this.send(eventName, properties);
+	}
+	async identify(userOrExternalId, email, options = {}) {
+		if (!this.ensureActive() || !this.canTrack() || this.isCookieless()) return false;
+		const user = typeof userOrExternalId === "string" ? {
+			id: userOrExternalId,
+			email,
+			...options
+		} : userOrExternalId;
+		const externalId = user.id.trim();
+		if (!externalId) return false;
+		const clearFields = [
+			"email",
+			"name",
+			"phone",
+			"avatarUrl"
+		].filter((field) => user[field] === null);
+		return await sendData({
 			url: `${this.baseUrl}${URLS.identify}`,
 			data: JSON.stringify({
 				token: this.options.siteKey,
 				identifier: this.getAnonymousId(),
-				externalId: trimmedExternalId,
-				email: trimmedEmail,
-				name: options.name?.trim() || void 0,
-				phone: options.phone?.trim() || void 0,
-				avatarUrl: options.avatarUrl?.trim() || void 0,
-				traits: options.traits ?? {}
+				externalId,
+				email: user.email?.trim() || void 0,
+				name: user.name?.trim() || void 0,
+				phone: user.phone?.trim() || void 0,
+				avatarUrl: user.avatarUrl?.trim() || void 0,
+				traits: user.traits,
+				replaceTraits: user.traitMode === "replace",
+				unsetTraits: user.unsetTraits,
+				aliases: user.aliases,
+				clearFields
 			}),
 			contentType: "text/plain",
 			debug: this.debug,
-			debugPrefix: "[Analytics] identify",
+			debugPrefix: "[FastStats] identify",
 			useBeacon: false
 		});
 	}
 	logout(resetAnonymousIdentity = true) {
 		if (!this.ensureActive()) return;
-		if (resetAnonymousIdentity) resetAnonymousId(this.options.siteKey, this.cookieless());
-		resetSession(this.options.siteKey);
+		if (resetAnonymousIdentity) resetAnonymousId(this.options.siteKey, this.isCookieless());
+		resetSession(this.options.siteKey, this.isCookieless());
 	}
 	setConsentMode(mode) {
 		if (mode === this.consentMode) return;
 		const wasTracking = this.canTrack();
+		const wasCookieless = this.isCookieless();
+		const willTrack = mode !== "denied";
+		const willBeCookieless = this.options.cookieless === true || mode === "anonymous";
+		if (wasTracking && willTrack && wasCookieless !== willBeCookieless) this.leavePage();
 		this.consentMode = mode;
-		const tracking = this.canTrack();
-		const cookieless = this.cookieless();
-		setCookielessMode(cookieless);
-		if (!tracking) {
-			this.epoch++;
+		if (!willTrack) {
 			this.pauseVisit();
 			this.stopHeartbeat();
 			this.pendingPageviewTrigger = null;
-			for (const tracker of this.childTrackers.splice(0)) tracker.stop?.(true);
+			this.stopExtensions(true);
 			return;
 		}
-		for (const tracker of this.childTrackers) tracker.setCookielessMode?.(cookieless);
-		if (!wasTracking && this.started) {
-			this.startHeartbeat();
-			this.beginTracking("consent");
-		}
-	}
-	getConsentMode() {
-		return this.consentMode;
+		if (wasTracking) {
+			this.extensions?.emit("consentChange", { cookieless: willBeCookieless });
+			if (wasCookieless !== willBeCookieless) {
+				this.enterPage();
+				this.pageKey = "";
+				this.pageview({ trigger: "consent" });
+			}
+		} else if (this.started) this.activate("consent");
 	}
 	getAnonymousId() {
-		if (!this.canTrack()) return "";
-		return getAnonymousId(this.options.siteKey, this.cookieless());
+		return this.canTrack() ? getAnonymousId(this.options.siteKey, this.isCookieless()) : "";
 	}
-	getSessionId() {
-		if (!this.canTrack()) return "";
-		return getSessionContext(this.options.siteKey, this.cookieless()).sessionId;
+	reportError(error) {
+		if (!this.ensureActive() || !this.canTrack()) return;
+		this.extensions?.emit("error", { error });
 	}
-	getWindowId() {
-		if (!this.canTrack()) return "";
-		return getSessionContext(this.options.siteKey, this.cookieless()).windowId;
+	canTrack() {
+		return this.consentMode !== "denied";
 	}
-	async checkFeatureFlag(key, attributes, opts) {
-		if (typeof window === "undefined" || isTrackingDisabled() || !this.canTrack()) return { value: "false" };
-		const externalId = opts?.externalId?.trim();
-		const identifier = this.getAnonymousId();
-		if (!externalId && !identifier) return { value: "false" };
-		const { fetchFeatureFlagEvaluation } = await import("./feature-flags.js");
-		return fetchFeatureFlagEvaluation(key, {
-			baseUrl: resolveBaseUrl(this.options.featureFlagsBaseUrl, FEATURE_FLAGS_BASE),
-			projectToken: this.options.siteKey,
-			...identifier ? { identifier } : {},
-			...externalId ? { externalId } : {},
-			sessionId: this.getSessionId(),
-			attributes,
-			signal: opts?.signal
-		});
+	isCookieless() {
+		return this.options.cookieless === true || this.consentMode === "anonymous";
 	}
-	reportError(error) {
-		if (!this.ensureActive() || !this.options.errorTracking?.enabled || !this.canTrack()) return;
-		this.childTrackers.find((tracker) => tracker.captureError)?.captureError?.(error);
+	ensureActive() {
+		return this.started === true && typeof window !== "undefined";
 	}
-	send(event, properties = {}, dims = {}) {
-		if (!this.canSendEvents()) return;
-		const cookieless = this.cookieless();
-		const id = getAnonymousId(this.options.siteKey, cookieless);
-		const ctx = getSessionContext(this.options.siteKey, cookieless);
-		this.log(event);
-		sendData({
-			url: `${this.baseUrl}${URLS.events}`,
-			data: JSON.stringify({
-				token: this.options.siteKey,
-				...id ? { userId: id } : {},
-				sessionId: ctx.sessionId,
-				windowId: ctx.windowId,
-				event,
-				...getPageContext(this.options.trackHash ?? false),
-				...dims,
-				properties
-			}),
-			contentType: "text/plain",
+	activate(trigger) {
+		this.touch();
+		this.startExtensions();
+		this.enterPage();
+		this.pageKey = "";
+		this.startHeartbeat();
+		if (document.visibilityState === "visible") this.pageview({ trigger });
+		else this.pendingPageviewTrigger = trigger;
+	}
+	startExtensions() {
+		if (this.extensions || !this.options.extensions?.length) return;
+		const host = new ExtensionHost(this.options.extensions, {
+			siteKey: this.options.siteKey,
+			baseUrl: this.baseUrl,
 			debug: this.debug,
-			debugPrefix: `[Analytics] ${event}`
+			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);
+			}
 		});
+		this.extensions = host;
+	}
+	stopExtensions(discard) {
+		this.extensions?.stop(discard);
+		this.extensions = null;
+	}
+	installBrowserLifecycle() {
+		this.bind(document, "visibilitychange", this.onVisibilityChange);
+		this.bind(window, "pagehide", this.onPageHide);
+		this.bind(window, "pageshow", this.onPageShow);
+		this.bind(window, "popstate", this.onNavigate);
+		if (this.options.trackHash) this.bind(window, "hashchange", this.onNavigate);
+		this.cleanup.push(observeHistory(() => this.navigate()));
+	}
+	bind(target, type, listener, options) {
+		target.addEventListener(type, listener, options);
+		this.cleanup.push(() => target.removeEventListener(type, listener, options));
+	}
+	onNavigate = () => this.navigate();
+	onVisibilityChange = () => {
+		if (!this.canTrack()) return;
+		this.touch();
+		if (document.visibilityState === "hidden") {
+			this.pauseVisit();
+			this.extensions?.emit("pageHide", {
+				persisted: false,
+				terminal: false
+			});
+			this.stopHeartbeat();
+			return;
+		}
+		this.startHeartbeat();
+		this.resumeVisit();
+		const trigger = this.pendingPageviewTrigger;
+		this.pendingPageviewTrigger = null;
+		if (trigger) this.pageview({ trigger });
+	};
+	onPageHide = (event) => {
+		if (!this.canTrack()) return;
+		const persisted = event.persisted;
+		this.pauseVisit();
+		this.extensions?.emit("pageHide", {
+			persisted,
+			terminal: !persisted
+		});
+		if (!persisted) this.leavePage();
+	};
+	onPageShow = (event) => {
+		if (!this.canTrack()) return;
+		if (document.visibilityState === "visible") this.resumeVisit();
+		this.extensions?.emit("pageShow", { persisted: event.persisted });
+	};
+	navigate() {
+		if (this.started !== true || !this.canTrack()) return;
+		const includeHash = this.options.trackHash ?? false;
+		if (`${location.pathname}${includeHash ? location.hash : ""}` === this.entry.path && location.search === this.entry.search) return;
+		const url = sanitizeUrl(location.href, includeHash);
+		this.extensions?.emit("pageChange", { url });
+		this.leavePage();
+		this.enterPage();
+		this.pageview({ trigger: "navigation" });
+	}
+	enterPage() {
+		const includeHash = this.options.trackHash ?? false;
+		const hash = includeHash ? location.hash : "";
+		this.entry = {
+			path: `${location.pathname}${hash}`,
+			url: sanitizeUrl(location.href, includeHash),
+			search: location.search
+		};
+		this.left = false;
+		this.visitDuration = 0;
+		this.visitStartedAt = document.visibilityState === "visible" ? Date.now() : null;
 	}
 	leavePage() {
-		if (this.destroyed || this.left) return;
+		if (this.started !== true || this.left || !this.canTrack()) return;
 		this.pauseVisit();
 		this.left = true;
-		const ctx = getSessionContext(this.options.siteKey, this.cookieless());
+		const session = getSessionContext(this.options.siteKey, this.isCookieless());
 		this.send("page_leave", {
 			time_on_page: this.visitDuration,
-			session_duration: Date.now() - ctx.sessionStart
+			session_duration: Date.now() - session.sessionStart
 		}, {
 			page: this.entry.path,
 			url: this.entry.url
 		});
 	}
-	startVisit() {
-		this.visitDuration = 0;
-		this.visitStartedAt = document.visibilityState === "visible" ? Date.now() : null;
-	}
 	pauseVisit() {
 		if (this.visitStartedAt === null) return;
 		this.visitDuration += Math.max(0, Date.now() - this.visitStartedAt);
 		this.visitStartedAt = null;
 	}
 	resumeVisit() {
-		if (this.left || this.visitStartedAt !== null) return;
-		this.visitStartedAt = Date.now();
+		if (!this.left && this.visitStartedAt === null) this.visitStartedAt = Date.now();
+	}
+	touch() {
+		if (this.canTrack()) touchActivity(this.options.siteKey, this.isCookieless());
 	}
 	startHeartbeat() {
 		this.stopHeartbeat();
 		this.heartbeatTimer = setInterval(() => {
-			if (document.visibilityState === "hidden") {
-				this.stopHeartbeat();
-				return;
-			}
+			if (document.visibilityState === "hidden") return this.stopHeartbeat();
 			this.touch();
-		}, 300 * 1e3);
+		}, 3e5);
 	}
-	navigate() {
-		if (!this.started || this.destroyed) return;
-		const trackHash = this.options.trackHash ?? false;
-		if (`${location.pathname}${trackHash ? location.hash : ""}` === this.entry.path && location.search === this.entry.search) return;
-		for (const tracker of this.childTrackers) tracker.trackPageChange?.(sanitizeUrl(location.href, trackHash));
-		this.leavePage();
-		this.enterPage();
-		this.pageview({ trigger: "navigation" });
+	stopHeartbeat() {
+		if (!this.heartbeatTimer) return;
+		clearInterval(this.heartbeatTimer);
+		this.heartbeatTimer = null;
+	}
+	send(event, properties = {}, dimensions = {}) {
+		if (this.started !== true || !this.canTrack()) return;
+		const cookieless = this.isCookieless();
+		const userId = getAnonymousId(this.options.siteKey, cookieless);
+		const session = getSessionContext(this.options.siteKey, cookieless);
+		let data;
+		try {
+			data = JSON.stringify({
+				token: this.options.siteKey,
+				...userId ? { userId } : {},
+				sessionId: session.sessionId,
+				windowId: session.windowId,
+				event,
+				...getPageContext(this.options.trackHash ?? false),
+				...dimensions,
+				properties
+			});
+		} catch (error) {
+			if (this.debug) console.log("serialization failed", event, error);
+			return;
+		}
+		sendData({
+			url: `${this.baseUrl}${URLS.events}`,
+			data,
+			contentType: "text/plain",
+			debug: this.debug,
+			debugPrefix: "[FastStats]"
+		});
 	}
 };
 //#endregion
-export { WebAnalytics, getInstance, identify, isTrackingDisabled, logout, optIn, optOut, reportError, setConsentMode, trackEvent };
+//#region src/client.ts
+let client;
+/** Creates an independent client. Call `start()` when it should begin tracking. */
+function createClient(options) {
+	return new WebAnalytics(options);
+}
+/** Initializes and starts the shared client used by the convenience functions. */
+function init(options) {
+	if (client) return client;
+	client = createClient(options);
+	client.start();
+	return client;
+}
+/** Stops and forgets the shared client. Independent clients are unaffected. */
+function shutdown() {
+	client?.destroy();
+	client = void 0;
+}
+function pageview(properties) {
+	client?.pageview(properties);
+}
+function track(name, properties) {
+	client?.track(name, properties);
+}
+function identify(userOrExternalId, email, options) {
+	if (!client) return Promise.resolve(false);
+	return typeof userOrExternalId === "string" ? client.identify(userOrExternalId, email, options) : client.identify(userOrExternalId);
+}
+function logout(resetAnonymousIdentity) {
+	client?.logout(resetAnonymousIdentity);
+}
+function setConsentMode(mode) {
+	client?.setConsentMode(mode);
+}
+function reportError(error) {
+	client?.reportError(error);
+}
+//#endregion
+export { WebAnalytics, createClient, identify, init, logout, pageview, reportError, setConsentMode, shutdown, track };