@faststats/web 0.0.2 → 0.0.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @faststats/web
 
+## 0.0.4
+
+### Patch Changes
+
+- 93393c0: Remove redundant isTrackingDisabled checks from sub-trackers (ErrorTracker, WebVitalsTracker, ReplayTracker).
+  Simplify web vitals config - single source of truth (trackWebVitals ?? webVitals?.enabled ?? hasWebVitalsSampling).
+  Fix custom events via trackEvent: set window.\_\_FA_webAnalyticsInstance in init() so it works before async start() completes.
+
+## 0.0.3
+
+### Patch Changes
+
+- bb3dcd1: ESM only for now
+
 ## 0.0.2
 
 ### Patch Changes

package/dist/module.d.ts

@@ -429,7 +429,6 @@ interface IdentifyOptions {
 interface WebAnalyticsOptions {
   siteKey: string;
   endpoint?: string;
-  baseUrl?: string;
   debug?: boolean;
   autoTrack?: boolean;
   trackHash?: boolean;
@@ -463,7 +462,6 @@ declare class WebAnalytics {
   private readonly options;
   private readonly endpoint;
   private readonly debug;
-  private readonly baseUrl;
   private started;
   private pageKey;
   private navTimer;
@@ -481,7 +479,6 @@ declare class WebAnalytics {
   private log;
   private init;
   start(): void;
-  private load;
   pageview(extra?: Dict): void;
   track(name: string, extra?: Dict): void;
   identify(externalId: string, email: string, options?: IdentifyOptions): void;

package/dist/module.js

@@ -1,408 +1,3 @@
-//#region src/utils/identifiers.ts
-const SESSION_TIMEOUT = 1800 * 1e3;
-function getAnonymousId(cookieless) {
-	if (cookieless) return "";
-	return getOrCreateAnonymousId();
-}
-function getOrCreateAnonymousId() {
-	if (typeof localStorage === "undefined") return "";
-	const existingId = localStorage.getItem("faststats_anon_id");
-	if (existingId) return existingId;
-	const newId = crypto.randomUUID();
-	localStorage.setItem("faststats_anon_id", newId);
-	return newId;
-}
-function resetAnonymousId(cookieless) {
-	if (cookieless || typeof localStorage === "undefined") return "";
-	localStorage.removeItem("faststats_anon_id");
-	return getOrCreateAnonymousId();
-}
-function getOrCreateSessionId() {
-	if (typeof sessionStorage === "undefined") return "";
-	const existingId = sessionStorage.getItem("session_id");
-	const sessionTimestamp = sessionStorage.getItem("session_timestamp");
-	if (existingId && sessionTimestamp) {
-		if (Date.now() - Number.parseInt(sessionTimestamp, 10) < SESSION_TIMEOUT) {
-			sessionStorage.setItem("session_timestamp", Date.now().toString());
-			return existingId;
-		}
-		sessionStorage.removeItem("session_id");
-		sessionStorage.removeItem("session_timestamp");
-		sessionStorage.removeItem("session_start");
-	}
-	const now = Date.now().toString();
-	const newId = crypto.randomUUID();
-	sessionStorage.setItem("session_id", newId);
-	sessionStorage.setItem("session_timestamp", now);
-	sessionStorage.setItem("session_start", now);
-	return newId;
-}
-function resetSessionId() {
-	if (typeof sessionStorage === "undefined") return "";
-	sessionStorage.removeItem("session_id");
-	sessionStorage.removeItem("session_timestamp");
-	sessionStorage.removeItem("session_start");
-	return getOrCreateSessionId();
-}
-function refreshSessionTimestamp() {
-	if (typeof sessionStorage === "undefined") return;
-	if (sessionStorage.getItem("session_id")) sessionStorage.setItem("session_timestamp", Date.now().toString());
-}
-function getSessionStart() {
-	if (typeof sessionStorage === "undefined") return Date.now();
-	const start = sessionStorage.getItem("session_start");
-	if (start) return Number.parseInt(start, 10);
-	const ts = sessionStorage.getItem("session_timestamp");
-	return ts ? Number.parseInt(ts, 10) : Date.now();
-}
-
-//#endregion
-//#region src/utils/types.ts
-function normalizeSamplingPercentage(value) {
-	if (typeof value !== "number" || !Number.isFinite(value)) return 100;
-	return Math.max(0, Math.min(100, value));
-}
-
-//#endregion
-//#region src/analytics.ts
-function trackEvent(eventName, properties) {
-	if (typeof window === "undefined" || isTrackingDisabled()) return;
-	window.__FA_webAnalyticsInstance?.track(eventName, properties ?? {});
-}
-function isTrackingDisabled() {
-	if (typeof localStorage === "undefined") return false;
-	const value = localStorage.getItem("disable-faststats");
-	return value === "true" || value === "1";
-}
-async function sendData(options) {
-	const { url, data, contentType = "application/json", headers = {}, debug = false, debugPrefix = "[Analytics]" } = options;
-	const blob = data instanceof Blob ? data : new Blob([data], { type: contentType });
-	if (navigator.sendBeacon?.(url, blob)) {
-		if (debug) console.log(`${debugPrefix} ✓ Sent via beacon`);
-		return true;
-	}
-	try {
-		const response = await fetch(url, {
-			method: "POST",
-			body: data,
-			headers: {
-				"Content-Type": contentType,
-				...headers
-			},
-			keepalive: true
-		});
-		const success = response.ok;
-		if (debug) if (success) console.log(`${debugPrefix} ✓ Sent via fetch`);
-		else console.warn(`${debugPrefix} ✗ Failed: ${response.status}`);
-		return success;
-	} catch {
-		if (debug) console.warn(`${debugPrefix} ✗ Failed to send`);
-		return false;
-	}
-}
-function getLinkEl(el) {
-	while (el && !(el.tagName === "A" && el.href)) el = el.parentNode;
-	return el;
-}
-function getUTM() {
-	const params = {};
-	if (!location.search) return params;
-	const sp = new URLSearchParams(location.search);
-	for (const k of [
-		"utm_source",
-		"utm_medium",
-		"utm_campaign",
-		"utm_term",
-		"utm_content"
-	]) {
-		const v = sp.get(k);
-		if (v) params[k] = v;
-	}
-	return params;
-}
-var WebAnalytics = class {
-	endpoint;
-	debug;
-	baseUrl;
-	started = false;
-	pageKey = "";
-	navTimer = null;
-	heartbeatTimer = null;
-	scrollDepth = 0;
-	pageEntryTime = 0;
-	pagePath = "";
-	pageUrl = "";
-	pageHash = "";
-	hasLeftCurrentPage = false;
-	scrollHandler = null;
-	consentMode;
-	cookielessWhilePending;
-	constructor(options) {
-		this.options = options;
-		this.endpoint = options.endpoint ?? "https://metrics.faststats.dev/v1/web";
-		this.debug = options.debug ?? false;
-		this.consentMode = options.consent?.mode ?? "granted";
-		this.cookielessWhilePending = options.consent?.cookielessWhilePending ?? true;
-		const script = typeof document !== "undefined" ? document.currentScript : null;
-		const scriptBase = script?.src ? script.src.substring(0, script.src.lastIndexOf("/")) : "";
-		this.baseUrl = (options.baseUrl ?? scriptBase) || (typeof window !== "undefined" ? window.location.origin : "");
-		if (options.autoTrack ?? true) this.init();
-	}
-	log(msg) {
-		if (this.debug) console.log(`[Analytics] ${msg}`);
-	}
-	init() {
-		if (typeof window === "undefined") return;
-		if (isTrackingDisabled()) {
-			this.log("disabled");
-			return;
-		}
-		if ("requestIdleCallback" in window) window.requestIdleCallback(() => this.start());
-		else setTimeout(() => this.start(), 1);
-	}
-	start() {
-		if (this.started || typeof window === "undefined") return;
-		if (window.__FA_webAnalyticsInstance && window.__FA_webAnalyticsInstance !== this) {
-			this.log("already started by another instance");
-			return;
-		}
-		if (isTrackingDisabled()) {
-			this.log("disabled");
-			return;
-		}
-		this.started = true;
-		window.__FA_webAnalyticsInstance = this;
-		window.__FA_getAnonymousId = () => getAnonymousId(this.isCookielessMode());
-		window.__FA_getSessionId = getOrCreateSessionId;
-		window.__FA_sendData = sendData;
-		window.__FA_identify = (externalId, email, options) => this.identify(externalId, email, options);
-		window.__FA_logout = (resetAnonymousIdentity) => this.logout(resetAnonymousIdentity);
-		window.__FA_setConsentMode = (mode) => this.setConsentMode(mode);
-		window.__FA_optIn = () => this.optIn();
-		window.__FA_optOut = () => this.optOut();
-		window.__FA_trackEvent = (eventName, props) => this.track(eventName, props ?? {});
-		window.__FA_isTrackingDisabled = isTrackingDisabled;
-		const opts = this.options;
-		const hasWebVitalsSampling = opts.webVitals?.sampling?.percentage !== void 0;
-		const hasReplaySampling = opts.replayOptions?.samplingPercentage !== void 0 || opts.sessionReplays?.sampling?.percentage !== void 0;
-		if (opts.errorTracking?.enabled ?? opts.trackErrors) this.load("error", "__FA_ErrorTracker", {
-			siteKey: opts.siteKey,
-			endpoint: this.endpoint,
-			debug: this.debug,
-			getCommonData: () => ({
-				url: location.href,
-				page: location.pathname,
-				referrer: document.referrer || null
-			})
-		});
-		if (opts.webVitals?.enabled ?? opts.trackWebVitals ?? hasWebVitalsSampling) this.load("web-vitals", "__FA_WebVitalsTracker", {
-			siteKey: opts.siteKey,
-			endpoint: this.endpoint,
-			debug: this.debug,
-			samplingPercentage: normalizeSamplingPercentage(opts.webVitals?.sampling?.percentage)
-		});
-		if (opts.sessionReplays?.enabled ?? opts.trackReplay ?? hasReplaySampling) {
-			const replayOpts = opts.replayOptions ?? {};
-			this.load("replay", "__FA_ReplayTracker", {
-				siteKey: opts.siteKey,
-				endpoint: this.endpoint,
-				debug: this.debug,
-				...replayOpts,
-				samplingPercentage: normalizeSamplingPercentage(replayOpts.samplingPercentage ?? opts.sessionReplays?.sampling?.percentage)
-			});
-		}
-		this.enterPage();
-		this.pageview({ trigger: "load" });
-		this.links();
-		this.trackScroll();
-		this.startHeartbeat();
-		document.addEventListener("visibilitychange", () => {
-			if (document.visibilityState === "hidden") this.leavePage();
-			else this.startHeartbeat();
-		});
-		window.addEventListener("pagehide", () => this.leavePage());
-		window.addEventListener("popstate", () => this.navigate());
-		if (opts.trackHash) window.addEventListener("hashchange", () => this.navigate());
-		this.patch();
-	}
-	load(script, key, trackerOpts) {
-		const el = document.createElement("script");
-		el.src = `${this.baseUrl}/${script}.js`;
-		el.async = true;
-		el.onload = () => {
-			const Ctor = window[key];
-			if (Ctor) {
-				new Ctor(trackerOpts).start();
-				this.log(`${script} loaded`);
-			}
-		};
-		el.onerror = () => {
-			if (this.debug) console.warn(`[Analytics] ${script} failed`);
-		};
-		document.head.appendChild(el);
-	}
-	pageview(extra = {}) {
-		const key = `${location.pathname}|${this.options.trackHash ?? false ? location.hash : ""}`;
-		if (key === this.pageKey) return;
-		this.pageKey = key;
-		this.send("pageview", extra);
-	}
-	track(name, extra = {}) {
-		this.send(name, extra);
-	}
-	identify(externalId, email, options = {}) {
-		if (isTrackingDisabled()) return;
-		if (this.isCookielessMode()) return;
-		const trimmedExternalId = externalId.trim();
-		const trimmedEmail = email.trim();
-		if (!trimmedExternalId || !trimmedEmail) return;
-		sendData({
-			url: this.endpoint.replace(/\/v1\/web$/, "/v1/identify"),
-			data: JSON.stringify({
-				token: this.options.siteKey,
-				identifier: getAnonymousId(false),
-				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 ?? {}
-			}),
-			contentType: "text/plain",
-			debug: this.debug,
-			debugPrefix: "[Analytics] identify"
-		});
-	}
-	logout(resetAnonymousIdentity = true) {
-		if (isTrackingDisabled()) return;
-		if (resetAnonymousIdentity) resetAnonymousId(this.isCookielessMode());
-		resetSessionId();
-	}
-	setConsentMode(mode) {
-		this.consentMode = mode;
-	}
-	optIn() {
-		this.setConsentMode("granted");
-	}
-	optOut() {
-		this.setConsentMode("denied");
-	}
-	getConsentMode() {
-		return this.consentMode;
-	}
-	isCookielessMode() {
-		if (this.options.cookieless) return true;
-		if (this.consentMode === "denied") return true;
-		if (this.consentMode === "pending") return this.cookielessWhilePending;
-		return false;
-	}
-	send(event, extra = {}) {
-		const identifier = getAnonymousId(this.isCookielessMode());
-		const payload = JSON.stringify({
-			token: this.options.siteKey,
-			...identifier ? { userId: identifier } : {},
-			sessionId: getOrCreateSessionId(),
-			data: {
-				event,
-				page: location.pathname,
-				referrer: document.referrer || null,
-				title: document.title || "",
-				url: location.href,
-				...getUTM(),
-				...extra
-			}
-		});
-		this.log(event);
-		sendData({
-			url: this.endpoint,
-			data: payload,
-			contentType: "text/plain",
-			debug: this.debug,
-			debugPrefix: `[Analytics] ${event}`
-		});
-	}
-	enterPage() {
-		this.pageEntryTime = Date.now();
-		this.pagePath = location.pathname;
-		this.pageUrl = location.href;
-		this.pageHash = location.hash;
-		this.scrollDepth = 0;
-		this.hasLeftCurrentPage = false;
-	}
-	leavePage() {
-		if (this.hasLeftCurrentPage) return;
-		this.hasLeftCurrentPage = true;
-		const now = Date.now();
-		this.send("page_leave", {
-			page: this.pagePath,
-			url: this.pageUrl,
-			time_on_page: now - this.pageEntryTime,
-			scroll_depth: this.scrollDepth,
-			session_duration: now - getSessionStart()
-		});
-	}
-	trackScroll() {
-		if (this.scrollHandler) window.removeEventListener("scroll", this.scrollHandler);
-		const update = () => {
-			const doc = document.documentElement;
-			const body = document.body;
-			const viewportH = window.innerHeight;
-			const docH = Math.max(doc.scrollHeight, body.scrollHeight);
-			if (docH <= viewportH) {
-				this.scrollDepth = 100;
-				return;
-			}
-			const depth = Math.min(100, Math.round(((window.scrollY || doc.scrollTop) + viewportH) / docH * 100));
-			if (depth > this.scrollDepth) this.scrollDepth = depth;
-		};
-		this.scrollHandler = update;
-		update();
-		window.addEventListener("scroll", update, { passive: true });
-	}
-	startHeartbeat() {
-		if (this.heartbeatTimer) clearInterval(this.heartbeatTimer);
-		this.heartbeatTimer = setInterval(() => {
-			if (document.visibilityState === "hidden") {
-				clearInterval(this.heartbeatTimer);
-				this.heartbeatTimer = null;
-				return;
-			}
-			refreshSessionTimestamp();
-		}, 300 * 1e3);
-	}
-	navigate() {
-		if (this.navTimer) clearTimeout(this.navTimer);
-		this.navTimer = setTimeout(() => {
-			this.navTimer = null;
-			const pathChanged = location.pathname !== this.pagePath;
-			const hashChanged = (this.options.trackHash ?? false) && location.hash !== this.pageHash;
-			if (!pathChanged && !hashChanged) return;
-			this.leavePage();
-			this.enterPage();
-			this.trackScroll();
-			this.pageview({ trigger: "navigation" });
-		}, 300);
-	}
-	patch() {
-		const fire = () => this.navigate();
-		for (const method of ["pushState", "replaceState"]) {
-			const orig = history[method];
-			history[method] = function(...args) {
-				const result = orig.apply(this, args);
-				fire();
-				return result;
-			};
-		}
-	}
-	links() {
-		const handler = (event) => {
-			const link = getLinkEl(event.target);
-			if (link && link.host !== location.host) this.track("outbound_link", { outbound_link: link.href });
-		};
-		document.addEventListener("click", handler);
-		document.addEventListener("auxclick", handler);
-	}
-};
-
-//#endregion
-export { WebAnalytics, trackEvent };
+import{getRecordConsolePlugin as e}from"@rrweb/rrweb-plugin-console-record";import{record as t}from"rrweb";import{onCLS as n,onFCP as r,onINP as i,onLCP as a,onTTFB as o}from"web-vitals/attribution";var s=class{endpoint;siteKey;debug;flushInterval;maxQueueSize;getCommonData;handledErrors=new WeakSet;errorCounts=new Map;flushTimer=null;started=!1;constructor(e){this.siteKey=e.siteKey,this.endpoint=e.endpoint??`https://metrics.faststats.dev/v1/web`,this.debug=e.debug??!1,this.flushInterval=e.flushInterval??5e3,this.maxQueueSize=e.maxQueueSize??50,this.getCommonData=e.getCommonData??(()=>({}))}start(){this.started||typeof window>`u`||(this.started=!0,window.addEventListener(`error`,this.handleErrorEvent),window.addEventListener(`unhandledrejection`,this.handleRejection),this.flushTimer=setInterval(()=>this.flush(),this.flushInterval),document.addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`&&this.flush()}),window.addEventListener(`pagehide`,()=>this.flush()),this.debug&&console.log(`[ErrorTracker] Started listening for errors`))}stop(){!this.started||typeof window>`u`||(this.started=!1,window.removeEventListener(`error`,this.handleErrorEvent),window.removeEventListener(`unhandledrejection`,this.handleRejection),this.flushTimer&&=(clearInterval(this.flushTimer),null),this.flush(),this.debug&&console.log(`[ErrorTracker] Stopped listening for errors`))}handleErrorEvent=e=>{let t=e.error;if(t instanceof Error){if(this.handledErrors.has(t)){this.debug&&console.log(`[ErrorTracker] Skipping duplicate error:`,t.message);return}this.handledErrors.add(t)}this.queueError({message:e.message||(t?.message??`Unknown error`),filename:e.filename||void 0,lineno:e.lineno||void 0,colno:e.colno||void 0,stack:t?.stack||void 0,type:`error`})};handleRejection=e=>{let t=e.reason;if(t instanceof Error){if(this.handledErrors.has(t)){this.debug&&console.log(`[ErrorTracker] Skipping duplicate rejection:`,t.message);return}this.handledErrors.add(t)}this.queueError({message:t instanceof Error?t.message:typeof t==`string`?t:`Unhandled promise rejection`,stack:t instanceof Error?t.stack:void 0,type:`unhandledrejection`})};isExtensionError(e){return!!(e.filename?.startsWith(`chrome-extension://`)||e.stack&&e.stack.split(`
+`).find(e=>e.trim().startsWith(`at `))?.includes(`chrome-extension://`))}parseStack(e){if(e)return e.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0)}async generateErrorHash(e){let t=[e.type,e.message,e.filename??``,e.lineno??``].join(`:`),n=new TextEncoder().encode(t),r=await crypto.subtle.digest(`SHA-256`,n);return`err_${Array.from(new Uint8Array(r)).map(e=>e.toString(16).padStart(2,`0`)).join(``)}`}async queueError(e){if(this.isExtensionError(e))return;this.debug&&console.log(`[ErrorTracker] Captured error:`,e);let t=await this.generateErrorHash(e),n=this.errorCounts.get(t);if(n)n.count++,this.debug&&console.log(`[ErrorTracker] Incremented count for ${t} to ${n.count}`);else{let n={error:e.type===`unhandledrejection`?`UnhandledRejection`:`Error`,message:e.message,stack:this.parseStack(e.stack)};this.errorCounts.set(t,{entry:n,hash:t,count:1}),this.debug&&console.log(`[ErrorTracker] Queued new error: ${t}`)}this.errorCounts.size>=this.maxQueueSize&&this.flush()}captureError(e){if(this.handledErrors.has(e)){this.debug&&console.log(`[ErrorTracker] Skipping duplicate manual capture:`,e.message);return}this.handledErrors.add(e),this.queueError({message:e.message,stack:e.stack,type:`error`})}flush(){if(this.errorCounts.size===0)return;let e=[];for(let{entry:t,hash:n,count:r}of this.errorCounts.values())e.push({...t,hash:n,count:r});this.errorCounts.clear(),this.debug&&console.log(`[ErrorTracker] Flushing errors:`,e);let t=this.getCommonData(),n=window.__FA_getAnonymousId?.(),r=globalThis.__SOURCEMAPS_BUILD__,i=typeof r?.buildId==`string`&&r.buildId.trim().length>0?r.buildId:void 0,a={token:this.siteKey,...n?{userId:n}:{},sessionId:window.__FA_getSessionId?.(),...i?{buildId:i}:{},data:{url:t.url,page:t.page,referrer:t.referrer,title:typeof document<`u`?document.title:``},errors:e},o=JSON.stringify(a);this.debug&&console.log(`[ErrorTracker] Payload:`,o),window.__FA_sendData?.({url:this.endpoint,data:o,debug:this.debug,debugPrefix:`[ErrorTracker]`})}};typeof window<`u`&&(window.__FA_ErrorTracker=s);function c(e){return typeof e!=`number`||!Number.isFinite(e)?100:Math.max(0,Math.min(100,e))}var l=class{endpoint;siteKey;debug;flushInterval;maxEvents;sampling;slimDOMOptions;maskAllInputs;maskInputOptions;blockClass;blockSelector;maskTextClass;maskTextSelector;checkoutEveryNms;checkoutEveryNth;samplingPercentage;recordConsole;events=[];flushTimer=null;stopRecording=void 0;started=!1;startTime=0;sequenceNumber=0;pendingBatches=[];isFlushing=!1;compressionSupported=!1;sessionSamplingSeed;minReplayLengthMs=3e3;constructor(e){this.siteKey=e.siteKey,this.endpoint=e.endpoint?.replace(/\/v1\/web$/,`/v1/replay`)??`https://metrics.faststats.dev/v1/replay`,this.debug=e.debug??!1,this.samplingPercentage=c(e.samplingPercentage),this.flushInterval=e.flushInterval??1e4,this.maxEvents=e.maxEvents??500,this.sampling=e.sampling??{mousemove:50,mouseInteraction:!0,scroll:150,media:800,input:`last`},this.slimDOMOptions=e.slimDOMOptions??{script:!0,comment:!0,headFavicon:!0,headWhitespace:!0,headMetaDescKeywords:!0,headMetaSocial:!0,headMetaRobots:!0,headMetaHttpEquiv:!0,headMetaAuthorship:!0},this.maskAllInputs=e.maskAllInputs??!0,this.maskInputOptions=e.maskInputOptions??{password:!0,email:!0,tel:!0},this.blockClass=e.blockClass,this.blockSelector=e.blockSelector,this.maskTextClass=e.maskTextClass,this.maskTextSelector=e.maskTextSelector,this.checkoutEveryNms=e.checkoutEveryNms??6e4,this.checkoutEveryNth=e.checkoutEveryNth,this.recordConsole=e.recordConsole??!0,this.sessionSamplingSeed=Math.random()*100,typeof window<`u`&&(this.compressionSupported=`CompressionStream`in window)}start(){if(this.started||typeof window>`u`||this.samplingPercentage<100&&this.sessionSamplingSeed>=this.samplingPercentage)return;this.started=!0,this.startTime=Date.now(),this.debug&&console.log(`[Replay] Recording started`);let n={emit:(e,t)=>this.handleEvent(e,t),sampling:this.sampling,slimDOMOptions:this.slimDOMOptions,maskAllInputs:this.maskAllInputs,checkoutEveryNms:this.checkoutEveryNms};this.maskInputOptions&&(n.maskInputOptions=this.maskInputOptions),this.blockClass&&(n.blockClass=this.blockClass),this.blockSelector&&(n.blockSelector=this.blockSelector),this.maskTextClass&&(n.maskTextClass=this.maskTextClass),this.maskTextSelector&&(n.maskTextSelector=this.maskTextSelector),this.checkoutEveryNth&&(n.checkoutEveryNth=this.checkoutEveryNth),this.recordConsole&&(n.plugins=[e()]),this.stopRecording=t(n),this.flushTimer=setInterval(()=>{this.scheduleFlush()},this.flushInterval),window.addEventListener(`beforeunload`,this.handleUnload),window.addEventListener(`pagehide`,this.handleUnload),document.addEventListener(`visibilitychange`,this.handleVisibilityChange)}stop(){if(!this.started)return;this.started=!1,this.debug&&console.log(`[Replay] Recording stopped`),this.stopRecording?.(),this.stopRecording=void 0,this.flushTimer&&=(clearInterval(this.flushTimer),null),window.removeEventListener(`beforeunload`,this.handleUnload),window.removeEventListener(`pagehide`,this.handleUnload),document.removeEventListener(`visibilitychange`,this.handleVisibilityChange);let e=Date.now()-this.startTime;if(e<this.minReplayLengthMs){this.events=[],this.debug&&console.log(`[Replay] Session too short (${e}ms), discarding events`);return}this.flush()}handleEvent(e,t){this.events.push(e),(t||this.events.length>=this.maxEvents)&&this.scheduleFlush()}scheduleFlush(){this.isFlushing||this.events.length===0||(typeof window<`u`&&`requestIdleCallback`in window?window.requestIdleCallback(()=>this.flush(),{timeout:2e3}):setTimeout(()=>this.flush(),0))}handleUnload=()=>{this.flush()};handleVisibilityChange=()=>{document.visibilityState===`hidden`?(this.flushTimer&&=(clearInterval(this.flushTimer),null),this.flush()):document.visibilityState===`visible`&&this.started&&(this.flushTimer||=setInterval(()=>{this.scheduleFlush()},this.flushInterval))};async flush(){if(this.events.length===0){this.processPendingBatches();return}let e=Date.now()-this.startTime;if(e<this.minReplayLengthMs){this.debug&&console.log(`[Replay] Too short (${e}ms), skipping`),this.processPendingBatches();return}if(this.isFlushing)return;this.isFlushing=!0;let t=this.events;this.events=[];let n=window.__FA_getAnonymousId?.(),r={token:this.siteKey,sessionId:window.__FA_getSessionId?.(),...n?{identifier:n}:{},sequence:this.sequenceNumber++,timestamp:Date.now(),url:window.location.href,events:t};this.debug&&console.log(`[Replay] Sending ${t.length} events (seq: ${r.sequence})`);try{let e,t=!1;if(this.compressionSupported)try{e=await this.compress(JSON.stringify(r)),t=!0}catch{this.debug&&console.warn(`[Replay] Compression failed, using uncompressed`),e=new Blob([JSON.stringify(r)],{type:`application/json`})}else e=new Blob([JSON.stringify(r)],{type:`application/json`});await this.send(e,t)||this.pendingBatches.push({batch:r,isCompressed:t,retries:0})}catch(e){this.debug&&console.warn(`[Replay] Flush error:`,e),this.pendingBatches.push({batch:r,isCompressed:!1,retries:0})}finally{this.isFlushing=!1,this.processPendingBatches()}}async processPendingBatches(){if(this.pendingBatches.length===0)return;let e=this.pendingBatches.shift();if(e){if(e.retries>=3){this.debug&&console.warn(`[Replay] Max retries reached, dropping batch ${e.batch.sequence}`),this.processPendingBatches();return}e.retries++;try{let t;if(e.isCompressed&&this.compressionSupported)try{t=await this.compress(JSON.stringify(e.batch))}catch{t=new Blob([JSON.stringify(e.batch)],{type:`application/json`}),e.isCompressed=!1}else t=new Blob([JSON.stringify(e.batch)],{type:`application/json`});await this.send(t,e.isCompressed)?this.processPendingBatches():(this.pendingBatches.push(e),setTimeout(()=>this.processPendingBatches(),1e3*e.retries))}catch{this.debug&&console.warn(`[Replay] Retry ${e.retries} failed`),this.pendingBatches.push(e),setTimeout(()=>this.processPendingBatches(),1e3*e.retries)}}}async compress(e){if(!this.compressionSupported)throw Error(`Compression not supported`);let t=new TextEncoder().encode(e),n=new CompressionStream(`gzip`),r=n.writable.getWriter();r.write(t),r.close();let i=[],a=n.readable.getReader();for(;;){let{done:e,value:t}=await a.read();if(e)break;t&&i.push(t)}let o=i.reduce((e,t)=>e+t.length,0),s=new Uint8Array(o),c=0;for(let e of i)s.set(e,c),c+=e.length;if(this.debug){let e=(s.length/t.length*100).toFixed(1);console.log(`[Replay] Compressed: ${t.length} → ${s.length} bytes (${e}%)`)}return new Blob([s],{type:`application/octet-stream`})}async send(e,t){let n=t?`${this.endpoint}?encoding=gzip`:this.endpoint,r=(e.size/1024).toFixed(1);return window.__FA_sendData?.({url:n,data:e,contentType:t?`application/octet-stream`:`application/json`,headers:t?{"Content-Encoding":`gzip`}:void 0,debug:this.debug,debugPrefix:`[Replay] ${r}KB`})??Promise.resolve(!1)}getSessionId(){return window.__FA_getSessionId?.()}};typeof window<`u`&&(window.__FA_ReplayTracker=l);function u(e){return e?``:d()}function d(){if(typeof localStorage>`u`)return``;let e=localStorage.getItem(`faststats_anon_id`);if(e)return e;let t=crypto.randomUUID();return localStorage.setItem(`faststats_anon_id`,t),t}function f(e){return e||typeof localStorage>`u`?``:(localStorage.removeItem(`faststats_anon_id`),d())}function p(){if(typeof sessionStorage>`u`)return``;let e=sessionStorage.getItem(`session_id`),t=sessionStorage.getItem(`session_timestamp`);if(e&&t){if(Date.now()-Number.parseInt(t,10)<18e5)return sessionStorage.setItem(`session_timestamp`,Date.now().toString()),e;sessionStorage.removeItem(`session_id`),sessionStorage.removeItem(`session_timestamp`),sessionStorage.removeItem(`session_start`)}let n=Date.now().toString(),r=crypto.randomUUID();return sessionStorage.setItem(`session_id`,r),sessionStorage.setItem(`session_timestamp`,n),sessionStorage.setItem(`session_start`,n),r}function m(){return typeof sessionStorage>`u`?``:(sessionStorage.removeItem(`session_id`),sessionStorage.removeItem(`session_timestamp`),sessionStorage.removeItem(`session_start`),p())}function h(){typeof sessionStorage>`u`||sessionStorage.getItem(`session_id`)&&sessionStorage.setItem(`session_timestamp`,Date.now().toString())}function g(){if(typeof sessionStorage>`u`)return Date.now();let e=sessionStorage.getItem(`session_start`);if(e)return Number.parseInt(e,10);let t=sessionStorage.getItem(`session_timestamp`);return t?Number.parseInt(t,10):Date.now()}var _=class{endpoint;siteKey;debug;samplingPercentage;started=!1;sessionSamplingSeed;metricsMap=new Map;flushed=!1;constructor(e){this.siteKey=e.siteKey,this.endpoint=this.getVitalsEndpoint(e.endpoint??`https://metrics.faststats.dev/v1/web`),this.debug=e.debug??!1,this.samplingPercentage=c(e.samplingPercentage),this.sessionSamplingSeed=Math.random()*100}getVitalsEndpoint(e){let t=new URL(e),n=t.pathname.split(`/`);return n[n.length-1]=`vitals`,t.pathname=n.join(`/`),t.toString()}start(){this.started||typeof window>`u`||(this.started=!0,document.addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`&&this.finalizeAndFlush()}),window.addEventListener(`pagehide`,()=>{this.finalizeAndFlush()}),this.debug&&console.log(`[WebVitals] Tracking started`),n(e=>this.captureMetric(e)),i(e=>this.captureMetric(e)),a(e=>this.captureMetric(e)),r(e=>this.captureMetric(e)),o(e=>this.captureMetric(e)))}captureMetric(e){if(this.flushed||this.samplingPercentage<100&&this.sessionSamplingSeed>=this.samplingPercentage)return;let t=e.name,n={id:e.id,rating:e.rating,delta:e.delta,navigationType:e.navigationType,...e.attribution??{}},r=t===`FCP`||t===`TTFB`;this.metricsMap.set(t,{value:e.value,attributes:n,final:r}),this.debug&&console.log(`[WebVitals] ${t} captured: ${e.value}`+(r?` (final)`:``))}finalizeAndFlush(){if(!(this.flushed||this.metricsMap.size===0)){for(let[e,t]of this.metricsMap.entries())t.final||(t.final=!0,this.debug&&console.log(`[WebVitals] ${e} finalized: ${t.value}`));this.flushWithBeacon()}}buildPayload(){if(this.metricsMap.size===0)return null;let e=Array.from(this.metricsMap.entries()).map(([e,t])=>({metric:e,value:t.value,attributes:t.attributes}));return{body:JSON.stringify({sessionId:window.__FA_getSessionId?.(),vitals:e,metadata:{url:window.location.href}}),count:e.length}}flushWithBeacon(){let e=this.buildPayload();if(e){if(this.flushed=!0,this.debug){let t=Array.from(this.metricsMap.keys()).join(`, `);console.log(`[WebVitals] Sending final metrics (${e.count}): ${t}`)}fetch(this.endpoint,{method:`POST`,body:e.body,headers:{"Content-Type":`application/json`,Authorization:`Bearer ${this.siteKey}`},keepalive:!0}).catch(()=>{this.debug&&console.warn(`[WebVitals] Failed to send metrics`)})}}};typeof window<`u`&&(window.__FA_WebVitalsTracker=_);function v(e,t){typeof window>`u`||y()||window.__FA_webAnalyticsInstance?.track(e,t??{})}function y(){if(typeof localStorage>`u`)return!1;let e=localStorage.getItem(`disable-faststats`);return e===`true`||e===`1`}async function b(e){let{url:t,data:n,contentType:r=`application/json`,headers:i={},debug:a=!1,debugPrefix:o=`[Analytics]`}=e,s=n instanceof Blob?n:new Blob([n],{type:r});if(navigator.sendBeacon?.(t,s))return a&&console.log(`${o} ✓ Sent via beacon`),!0;try{let e=await fetch(t,{method:`POST`,body:n,headers:{"Content-Type":r,...i},keepalive:!0}),s=e.ok;return a&&(s?console.log(`${o} ✓ Sent via fetch`):console.warn(`${o} ✗ Failed: ${e.status}`)),s}catch{return a&&console.warn(`${o} ✗ Failed to send`),!1}}function x(e){for(;e&&!(e.tagName===`A`&&e.href);)e=e.parentNode;return e}function S(){let e={};if(!location.search)return e;let t=new URLSearchParams(location.search);for(let n of[`utm_source`,`utm_medium`,`utm_campaign`,`utm_term`,`utm_content`]){let r=t.get(n);r&&(e[n]=r)}return e}var C=class{endpoint;debug;started=!1;pageKey=``;navTimer=null;heartbeatTimer=null;scrollDepth=0;pageEntryTime=0;pagePath=``;pageUrl=``;pageHash=``;hasLeftCurrentPage=!1;scrollHandler=null;consentMode;cookielessWhilePending;constructor(e){this.options=e,this.endpoint=e.endpoint??`https://metrics.faststats.dev/v1/web`,this.debug=e.debug??!1,this.consentMode=e.consent?.mode??`granted`,this.cookielessWhilePending=e.consent?.cookielessWhilePending??!0,(e.autoTrack??!0)&&this.init()}log(e){this.debug&&console.log(`[Analytics] ${e}`)}init(){if(!(typeof window>`u`)){if(y()){this.log(`disabled`);return}window.__FA_webAnalyticsInstance=this,`requestIdleCallback`in window?window.requestIdleCallback(()=>this.start()):setTimeout(()=>this.start(),1)}}start(){if(this.started||typeof window>`u`)return;if(window.__FA_webAnalyticsInstance&&window.__FA_webAnalyticsInstance!==this){this.log(`already started by another instance`);return}if(y()){this.log(`disabled`);return}this.started=!0,window.__FA_webAnalyticsInstance=this,window.__FA_getAnonymousId=()=>u(this.isCookielessMode()),window.__FA_getSessionId=p,window.__FA_sendData=b,window.__FA_identify=(e,t,n)=>this.identify(e,t,n),window.__FA_logout=e=>this.logout(e),window.__FA_setConsentMode=e=>this.setConsentMode(e),window.__FA_optIn=()=>this.optIn(),window.__FA_optOut=()=>this.optOut(),window.__FA_trackEvent=(e,t)=>this.track(e,t??{}),window.__FA_isTrackingDisabled=y;let e=this.options,t=e.webVitals?.sampling?.percentage!==void 0,n=e.replayOptions?.samplingPercentage!==void 0||e.sessionReplays?.sampling?.percentage!==void 0;if((e.errorTracking?.enabled??e.trackErrors)&&(new s({siteKey:e.siteKey,endpoint:this.endpoint,debug:this.debug,getCommonData:()=>({url:location.href,page:location.pathname,referrer:document.referrer||null})}).start(),this.log(`error loaded`)),(e.trackWebVitals??e.webVitals?.enabled??t)&&(new _({siteKey:e.siteKey,endpoint:this.endpoint,debug:this.debug,samplingPercentage:c(e.webVitals?.sampling?.percentage)}).start(),this.log(`web-vitals loaded`)),e.sessionReplays?.enabled??e.trackReplay??n){let t=e.replayOptions??{};new l({siteKey:e.siteKey,endpoint:this.endpoint,debug:this.debug,...t,samplingPercentage:c(t.samplingPercentage??e.sessionReplays?.sampling?.percentage)}).start(),this.log(`replay loaded`)}this.enterPage(),this.pageview({trigger:`load`}),this.links(),this.trackScroll(),this.startHeartbeat(),document.addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`?this.leavePage():this.startHeartbeat()}),window.addEventListener(`pagehide`,()=>this.leavePage()),window.addEventListener(`popstate`,()=>this.navigate()),e.trackHash&&window.addEventListener(`hashchange`,()=>this.navigate()),this.patch()}pageview(e={}){let t=`${location.pathname}|${this.options.trackHash??!1?location.hash:``}`;t!==this.pageKey&&(this.pageKey=t,this.send(`pageview`,e))}track(e,t={}){this.send(e,t)}identify(e,t,n={}){if(y()||this.isCookielessMode())return;let r=e.trim(),i=t.trim();!r||!i||b({url:this.endpoint.replace(/\/v1\/web$/,`/v1/identify`),data:JSON.stringify({token:this.options.siteKey,identifier:u(!1),externalId:r,email:i,name:n.name?.trim()||void 0,phone:n.phone?.trim()||void 0,avatarUrl:n.avatarUrl?.trim()||void 0,traits:n.traits??{}}),contentType:`text/plain`,debug:this.debug,debugPrefix:`[Analytics] identify`})}logout(e=!0){y()||(e&&f(this.isCookielessMode()),m())}setConsentMode(e){this.consentMode=e}optIn(){this.setConsentMode(`granted`)}optOut(){this.setConsentMode(`denied`)}getConsentMode(){return this.consentMode}isCookielessMode(){return this.options.cookieless||this.consentMode===`denied`?!0:this.consentMode===`pending`?this.cookielessWhilePending:!1}send(e,t={}){let n=u(this.isCookielessMode()),r=JSON.stringify({token:this.options.siteKey,...n?{userId:n}:{},sessionId:p(),data:{event:e,page:location.pathname,referrer:document.referrer||null,title:document.title||``,url:location.href,...S(),...t}});this.log(e),b({url:this.endpoint,data:r,contentType:`text/plain`,debug:this.debug,debugPrefix:`[Analytics] ${e}`})}enterPage(){this.pageEntryTime=Date.now(),this.pagePath=location.pathname,this.pageUrl=location.href,this.pageHash=location.hash,this.scrollDepth=0,this.hasLeftCurrentPage=!1}leavePage(){if(this.hasLeftCurrentPage)return;this.hasLeftCurrentPage=!0;let e=Date.now();this.send(`page_leave`,{page:this.pagePath,url:this.pageUrl,time_on_page:e-this.pageEntryTime,scroll_depth:this.scrollDepth,session_duration:e-g()})}trackScroll(){this.scrollHandler&&window.removeEventListener(`scroll`,this.scrollHandler);let e=()=>{let e=document.documentElement,t=document.body,n=window.innerHeight,r=Math.max(e.scrollHeight,t.scrollHeight);if(r<=n){this.scrollDepth=100;return}let i=Math.min(100,Math.round(((window.scrollY||e.scrollTop)+n)/r*100));i>this.scrollDepth&&(this.scrollDepth=i)};this.scrollHandler=e,e(),window.addEventListener(`scroll`,e,{passive:!0})}startHeartbeat(){this.heartbeatTimer&&clearInterval(this.heartbeatTimer),this.heartbeatTimer=setInterval(()=>{if(document.visibilityState===`hidden`){clearInterval(this.heartbeatTimer),this.heartbeatTimer=null;return}h()},300*1e3)}navigate(){this.navTimer&&clearTimeout(this.navTimer),this.navTimer=setTimeout(()=>{this.navTimer=null;let e=location.pathname!==this.pagePath,t=(this.options.trackHash??!1)&&location.hash!==this.pageHash;!e&&!t||(this.leavePage(),this.enterPage(),this.trackScroll(),this.pageview({trigger:`navigation`}))},300)}patch(){let e=()=>this.navigate();for(let t of[`pushState`,`replaceState`]){let n=history[t];history[t]=function(...t){let r=n.apply(this,t);return e(),r}}}links(){let e=e=>{let t=x(e.target);t&&t.host!==location.host&&this.track(`outbound_link`,{outbound_link:t.href})};document.addEventListener(`click`,e),document.addEventListener(`auxclick`,e)}};export{C as WebAnalytics,v as trackEvent};

package/package.json

@@ -15,11 +15,10 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"version": "0.0.2",
+	"version": "0.0.4",
 	"scripts": {
-		"build": "tsdown && cp -f dist/script.iife.js dist/script.js && cp -f dist/error.iife.js dist/error.js && cp -f dist/web-vitals.iife.js dist/web-vitals.js && cp -f dist/replay.iife.js dist/replay.js",
-		"sync:example-assets": "mkdir -p ../../examples/spa-test/public && cp -f dist/script.iife.js ../../examples/spa-test/public/script.js && cp -f dist/error.iife.js ../../examples/spa-test/public/error.js && cp -f dist/web-vitals.iife.js ../../examples/spa-test/public/web-vitals.js && cp -f dist/replay.iife.js ../../examples/spa-test/public/replay.js",
-		"dev": "bun run build && bun run sync:example-assets",
+		"build": "tsdown",
+		"dev": "bun run build",
 		"deploy:worker": "wrangler deploy"
 	},
 	"devDependencies": {

package/src/analytics.ts

@@ -1,4 +1,6 @@
+import ErrorTracker from "./error";
 import type { ReplayTrackerOptions } from "./replay";
+import ReplayTracker from "./replay";
 import {
 	getAnonymousId,
 	getOrCreateSessionId,
@@ -11,6 +13,7 @@ import {
 	normalizeSamplingPercentage,
 	type SendDataOptions,
 } from "./utils/types";
+import WebVitalsTracker from "./web-vitals";
 
 export type { SendDataOptions };
 
@@ -139,7 +142,6 @@ export interface IdentifyOptions {
 export interface WebAnalyticsOptions {
 	siteKey: string;
 	endpoint?: string;
-	baseUrl?: string;
 	debug?: boolean;
 	autoTrack?: boolean;
 	trackHash?: boolean;
@@ -170,7 +172,10 @@ declare global {
 		__FA_optIn?: () => void;
 		__FA_optOut?: () => void;
 		__FA_isTrackingDisabled?: () => boolean;
-		__FA_trackEvent?: (eventName: string, properties?: Record<string, unknown>) => void;
+		__FA_trackEvent?: (
+			eventName: string,
+			properties?: Record<string, unknown>,
+		) => void;
 		__FA_webAnalyticsInstance?: WebAnalytics;
 	}
 }
@@ -178,7 +183,6 @@ declare global {
 export class WebAnalytics {
 	private readonly endpoint: string;
 	private readonly debug: boolean;
-	private readonly baseUrl: string;
 	private started = false;
 	private pageKey = "";
 	private navTimer: ReturnType<typeof setTimeout> | null = null;
@@ -199,16 +203,6 @@ export class WebAnalytics {
 		this.consentMode = options.consent?.mode ?? "granted";
 		this.cookielessWhilePending =
 			options.consent?.cookielessWhilePending ?? true;
-		const script =
-			typeof document !== "undefined"
-				? (document.currentScript as HTMLScriptElement | null)
-				: null;
-		const scriptBase = script?.src
-			? script.src.substring(0, script.src.lastIndexOf("/"))
-			: "";
-		this.baseUrl =
-			(options.baseUrl ?? scriptBase) ||
-			(typeof window !== "undefined" ? window.location.origin : "");
 		if (options.autoTrack ?? true) this.init();
 	}
 
@@ -222,6 +216,7 @@ export class WebAnalytics {
 			this.log("disabled");
 			return;
 		}
+		window.__FA_webAnalyticsInstance = this;
 		if ("requestIdleCallback" in window)
 			window.requestIdleCallback(() => this.start());
 		else setTimeout(() => this.start(), 1);
@@ -265,7 +260,7 @@ export class WebAnalytics {
 			opts.sessionReplays?.sampling?.percentage !== undefined;
 
 		if (opts.errorTracking?.enabled ?? opts.trackErrors) {
-			this.load("error", "__FA_ErrorTracker", {
+			new ErrorTracker({
 				siteKey: opts.siteKey,
 				endpoint: this.endpoint,
 				debug: this.debug,
@@ -274,25 +269,27 @@ export class WebAnalytics {
 					page: location.pathname,
 					referrer: document.referrer || null,
 				}),
-			});
+			}).start();
+			this.log("error loaded");
 		}
 		if (
-			opts.webVitals?.enabled ??
 			opts.trackWebVitals ??
+			opts.webVitals?.enabled ??
 			hasWebVitalsSampling
 		) {
-			this.load("web-vitals", "__FA_WebVitalsTracker", {
+			new WebVitalsTracker({
 				siteKey: opts.siteKey,
 				endpoint: this.endpoint,
 				debug: this.debug,
 				samplingPercentage: normalizeSamplingPercentage(
 					opts.webVitals?.sampling?.percentage,
 				),
-			});
+			}).start();
+			this.log("web-vitals loaded");
 		}
 		if (opts.sessionReplays?.enabled ?? opts.trackReplay ?? hasReplaySampling) {
 			const replayOpts = opts.replayOptions ?? {};
-			this.load("replay", "__FA_ReplayTracker", {
+			new ReplayTracker({
 				siteKey: opts.siteKey,
 				endpoint: this.endpoint,
 				debug: this.debug,
@@ -301,7 +298,8 @@ export class WebAnalytics {
 					replayOpts.samplingPercentage ??
 						opts.sessionReplays?.sampling?.percentage,
 				),
-			});
+			}).start();
+			this.log("replay loaded");
 		}
 
 		this.enterPage();
@@ -321,31 +319,6 @@ export class WebAnalytics {
 		this.patch();
 	}
 
-	private load(
-		script: string,
-		key: string,
-		trackerOpts: Record<string, unknown>,
-	): void {
-		const el = document.createElement("script");
-		el.src = `${this.baseUrl}/${script}.js`;
-		el.async = true;
-		el.onload = () => {
-			const Ctor = (window as unknown as Record<string, unknown>)[key] as
-				| (new (
-						o: Record<string, unknown>,
-				  ) => { start(): void })
-				| undefined;
-			if (Ctor) {
-				new Ctor(trackerOpts).start();
-				this.log(`${script} loaded`);
-			}
-		};
-		el.onerror = () => {
-			if (this.debug) console.warn(`[Analytics] ${script} failed`);
-		};
-		document.head.appendChild(el);
-	}
-
 	pageview(extra: Dict = {}): void {
 		const key = `${location.pathname}|${(this.options.trackHash ?? false) ? location.hash : ""}`;
 		if (key === this.pageKey) return;

package/src/error.ts

@@ -57,12 +57,6 @@ class ErrorTracker {
 
 	start(): void {
 		if (this.started || typeof window === "undefined") return;
-		if (window.__FA_isTrackingDisabled?.()) {
-			if (this.debug) {
-				console.log("[ErrorTracker] Tracking disabled via localStorage");
-			}
-			return;
-		}
 		this.started = true;
 
 		window.addEventListener("error", this.handleErrorEvent);