@faststats/web 0.2.14 → 0.3.1

package/tests/session-manager.test.ts

@@ -1,161 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import {
-	createId,
-	getOrCreateSessionId,
-	getSessionContext,
-	getSessionStart,
-	onSessionRotated,
-	resetSession,
-	setCookielessMode,
-	setDefaultSiteKey,
-	touchActivity,
-} from "../src/utils/session-manager";
-
-class MockStorage {
-	private readonly data = new Map<string, string>();
-
-	getItem(key: string): string | null {
-		return this.data.get(key) ?? null;
-	}
-
-	setItem(key: string, value: string): void {
-		this.data.set(key, value);
-	}
-
-	removeItem(key: string): void {
-		this.data.delete(key);
-	}
-}
-
-function setGlobal(name: keyof typeof globalThis, value: unknown): void {
-	Object.defineProperty(globalThis, name, {
-		configurable: true,
-		writable: true,
-		value,
-	});
-}
-
-const original = {
-	localStorage: globalThis.localStorage,
-	sessionStorage: globalThis.sessionStorage,
-};
-
-beforeEach(() => {
-	setGlobal("localStorage", new MockStorage());
-	setGlobal("sessionStorage", new MockStorage());
-	setCookielessMode(true);
-	setCookielessMode(false);
-	setDefaultSiteKey("site_test");
-});
-
-afterEach(() => {
-	setGlobal("localStorage", original.localStorage);
-	setGlobal("sessionStorage", original.sessionStorage);
-	setCookielessMode(false);
-});
-
-describe("session-manager", () => {
-	test("rotates session after idle timeout", () => {
-		const local = globalThis.localStorage as unknown as MockStorage;
-		const idleMs = 30 * 60 * 1000 + 1;
-		local.setItem("faststats_session_id", "old-session");
-		local.setItem(
-			"faststats_session_activity",
-			(Date.now() - idleMs).toString(),
-		);
-		local.setItem("faststats_session_start", (Date.now() - idleMs).toString());
-
-		const rotations: Array<{ prev: string; next: string }> = [];
-		const unsubscribe = onSessionRotated((prev, next) => {
-			rotations.push({ prev: prev.sessionId, next: next.sessionId });
-		});
-
-		const next = getSessionContext("site_test");
-		unsubscribe();
-		expect(next.sessionId).not.toBe("old-session");
-		expect(rotations).toHaveLength(1);
-		expect(rotations[0]?.prev).toBe("old-session");
-		expect(rotations[0]?.next).toBe(next.sessionId);
-	});
-
-	test("resetSession notifies rotation listeners", () => {
-		const first = getSessionContext("site_test");
-		const rotations: Array<{ prev: string; next: string }> = [];
-		const unsubscribe = onSessionRotated((prev, next) => {
-			rotations.push({ prev: prev.sessionId, next: next.sessionId });
-		});
-
-		const second = resetSession("site_test");
-		unsubscribe();
-		expect(second.sessionId).not.toBe(first.sessionId);
-		expect(rotations).toHaveLength(1);
-	});
-
-	test("touchActivity extends session without rotating", () => {
-		const first = getSessionContext("site_test");
-		touchActivity();
-		const second = getSessionContext("site_test");
-		expect(second.sessionId).toBe(first.sessionId);
-	});
-
-	test("session id is recreated when activity timestamp is invalid", () => {
-		const local = globalThis.localStorage as unknown as MockStorage;
-		local.setItem("faststats_session_id", "old-session");
-		local.setItem("faststats_session_activity", "NaN");
-		const id = getOrCreateSessionId();
-		expect(id).not.toBe("old-session");
-	});
-
-	test("session start falls back when stored value is invalid", () => {
-		const local = globalThis.localStorage as unknown as MockStorage;
-		const now = Date.now();
-		local.setItem("faststats_session_id", "session-1");
-		local.setItem("faststats_session_activity", now.toString());
-		local.setItem("faststats_session_start", "NaN");
-		expect(getSessionStart()).toBe(now);
-	});
-
-	test("session id is shared across tabs via localStorage", () => {
-		const first = getOrCreateSessionId();
-		setGlobal("sessionStorage", new MockStorage());
-		const second = getOrCreateSessionId();
-		expect(second).toBe(first);
-	});
-
-	test("migrates legacy sessionStorage keys into localStorage", () => {
-		const session = globalThis.sessionStorage as unknown as MockStorage;
-		session.setItem("session_id", "legacy-session");
-		session.setItem("session_timestamp", Date.now().toString());
-		const id = getOrCreateSessionId();
-		expect(id).toBe("legacy-session");
-		const local = globalThis.localStorage as unknown as MockStorage;
-		expect(local.getItem("faststats_session_id")).toBe("legacy-session");
-		expect(session.getItem("session_id")).toBeNull();
-	});
-
-	test("createId generates unique values", () => {
-		expect(createId()).not.toBe(createId());
-	});
-
-	test("falls back to ephemeral session when storage access fails", () => {
-		Object.defineProperty(globalThis, "localStorage", {
-			configurable: true,
-			get() {
-				throw new Error("storage blocked");
-			},
-		});
-		Object.defineProperty(globalThis, "sessionStorage", {
-			configurable: true,
-			get() {
-				throw new Error("storage blocked");
-			},
-		});
-
-		const first = getSessionContext("site_test");
-		const second = getSessionContext("site_test");
-
-		expect(first.sessionId).toBeTruthy();
-		expect(second.sessionId).toBe(first.sessionId);
-		expect(second.windowId).toBe(first.sessionId);
-	});
-});

package/tests/web-vitals.test.ts

@@ -1,208 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import WebVitalsTracker from "../src/web-vitals";
-
-type FetchCall = {
-	url: string;
-	body?: string;
-};
-
-type Harness = {
-	fetchCalls: FetchCall[];
-	fetchStatuses: number[];
-	restore(): void;
-};
-
-function setGlobal(name: keyof typeof globalThis, value: unknown): void {
-	Object.defineProperty(globalThis, name, {
-		configurable: true,
-		writable: true,
-		value,
-	});
-}
-
-function setupBrowser(): Harness {
-	const originalValues = {
-		window: globalThis.window,
-		document: globalThis.document,
-		location: globalThis.location,
-		fetch: globalThis.fetch,
-		sessionStorage: globalThis.sessionStorage,
-	};
-	const fetchCalls: FetchCall[] = [];
-	const fetchStatuses: number[] = [];
-	const listeners = new Map<string, Set<EventListenerOrEventListenerObject>>();
-	const addEventListener = (
-		type: string,
-		listener: EventListenerOrEventListenerObject,
-	): void => {
-		const existing = listeners.get(type) ?? new Set();
-		existing.add(listener);
-		listeners.set(type, existing);
-	};
-	const removeEventListener = (
-		type: string,
-		listener: EventListenerOrEventListenerObject,
-	): void => {
-		listeners.get(type)?.delete(listener);
-	};
-	const location = {
-		href: "https://example.com/",
-	};
-	const storage = new Map<string, string>();
-	const sessionStorage = {
-		getItem: (key: string) => storage.get(key) ?? null,
-		setItem: (key: string, value: string) => storage.set(key, value),
-		removeItem: (key: string) => storage.delete(key),
-	};
-
-	setGlobal("location", location as Location);
-	setGlobal("document", {
-		addEventListener,
-		removeEventListener,
-		visibilityState: "visible",
-	} as unknown as Document);
-	setGlobal("window", {
-		addEventListener,
-		removeEventListener,
-		location,
-		setTimeout,
-		clearTimeout,
-	} as unknown as Window & typeof globalThis);
-	setGlobal("sessionStorage", sessionStorage);
-	setGlobal("fetch", (async (
-		url: string | URL | Request,
-		init?: RequestInit,
-	): Promise<Response> => {
-		fetchCalls.push({
-			url: String(url),
-			body: typeof init?.body === "string" ? init.body : undefined,
-		});
-		return new Response("", { status: fetchStatuses.shift() ?? 204 });
-	}) as typeof fetch);
-
-	return {
-		fetchCalls,
-		fetchStatuses,
-		restore() {
-			setGlobal("window", originalValues.window);
-			setGlobal("document", originalValues.document);
-			setGlobal("location", originalValues.location);
-			setGlobal("fetch", originalValues.fetch);
-			setGlobal("sessionStorage", originalValues.sessionStorage);
-		},
-	};
-}
-
-function captureMetric(
-	tracker: WebVitalsTracker,
-	metric: Parameters<(metric: unknown) => void>[0],
-): void {
-	(
-		tracker as unknown as {
-			captureMetric(metric: unknown): void;
-		}
-	).captureMetric(metric);
-}
-
-let harness: Harness;
-
-beforeEach(() => {
-	harness = setupBrowser();
-});
-
-afterEach(() => {
-	harness.restore();
-});
-
-describe("WebVitalsTracker", () => {
-	test("flushes the current vitals bucket when the SPA route changes", async () => {
-		const tracker = new WebVitalsTracker({
-			siteKey: "site_test",
-			baseUrl: "https://analytics.example.com",
-			samplingPercentage: 100,
-		});
-
-		tracker.start();
-		captureMetric(tracker, {
-			name: "CLS",
-			value: 0.12,
-			id: "v1",
-			rating: "needs-improvement",
-			delta: 0.12,
-			navigationType: "navigate",
-		});
-
-		tracker.trackPageChange("https://example.com/about");
-		await new Promise((resolve) => setTimeout(resolve, 0));
-
-		expect(harness.fetchCalls.length).toBe(1);
-		const firstPayload = JSON.parse(harness.fetchCalls[0]?.body ?? "{}") as {
-			metadata?: { url?: string };
-			vitals?: Array<{ metric?: string }>;
-		};
-		expect(firstPayload.metadata?.url).toBe("https://example.com/");
-		expect(firstPayload.vitals?.[0]?.metric).toBe("CLS");
-
-		captureMetric(tracker, {
-			name: "INP",
-			value: 32,
-			id: "v2",
-			rating: "good",
-			delta: 32,
-			navigationType: "navigate",
-		});
-
-		tracker.stop();
-		await new Promise((resolve) => setTimeout(resolve, 0));
-
-		expect(harness.fetchCalls.length).toBe(2);
-		const secondPayload = JSON.parse(harness.fetchCalls[1]?.body ?? "{}") as {
-			metadata?: { url?: string };
-			vitals?: Array<{ metric?: string }>;
-		};
-		expect(secondPayload.metadata?.url).toBe("https://example.com/about");
-		expect(secondPayload.vitals?.[0]?.metric).toBe("INP");
-	});
-
-	test("keeps metrics buffered when a route flush fails", async () => {
-		harness.fetchStatuses.push(500, 204, 204);
-		const tracker = new WebVitalsTracker({
-			siteKey: "site_test",
-			baseUrl: "https://analytics.example.com",
-			samplingPercentage: 100,
-		});
-
-		tracker.start();
-		captureMetric(tracker, {
-			name: "CLS",
-			value: 0.12,
-			id: "v1",
-			rating: "needs-improvement",
-			delta: 0.12,
-			navigationType: "navigate",
-		});
-		tracker.trackPageChange("https://example.com/about");
-		await new Promise((resolve) => setTimeout(resolve, 0));
-
-		expect(harness.fetchCalls.length).toBe(1);
-
-		captureMetric(tracker, {
-			name: "INP",
-			value: 32,
-			id: "v2",
-			rating: "good",
-			delta: 32,
-			navigationType: "navigate",
-		});
-		tracker.trackPageChange("https://example.com/contact");
-		await new Promise((resolve) => setTimeout(resolve, 0));
-
-		expect(harness.fetchCalls.length).toBe(3);
-		const retriedPayload = JSON.parse(harness.fetchCalls[1]?.body ?? "{}") as {
-			metadata?: { url?: string };
-			vitals?: Array<{ metric?: string }>;
-		};
-		expect(retriedPayload.metadata?.url).toBe("https://example.com/");
-		expect(retriedPayload.vitals?.[0]?.metric).toBe("CLS");
-	});
-});

package/tsconfig.json

@@ -1,30 +0,0 @@
-{
-	"compilerOptions": {
-		// Environment setup & latest features
-		"lib": ["ESNext", "DOM"],
-		"target": "ESNext",
-		"module": "Preserve",
-		"moduleDetection": "force",
-		"jsx": "react-jsx",
-		"allowJs": true,
-
-		// Bundler mode
-		"moduleResolution": "bundler",
-		"allowImportingTsExtensions": true,
-		"verbatimModuleSyntax": true,
-		"noEmit": true,
-
-		// Best practices
-		"strict": true,
-		"skipLibCheck": true,
-		"noFallthroughCasesInSwitch": true,
-		"noUncheckedIndexedAccess": true,
-		"noImplicitOverride": true,
-
-		// Some stricter flags (disabled by default)
-		"noUnusedLocals": false,
-		"noUnusedParameters": false,
-		"noPropertyAccessFromIndexSignature": false
-	},
-	"include": ["src"]
-}

package/tsdown.config.ts

@@ -1,27 +0,0 @@
-import { defineConfig } from "tsdown";
-import pkg from "./package.json" with { type: "json" };
-
-export default defineConfig({
-	entry: {
-		index: "src/entries/main.ts",
-		"feature-flags": "src/entries/feature-flags.ts",
-		replay: "src/entries/replay.ts",
-		error: "src/entries/error.ts",
-		"web-vitals": "src/entries/web-vitals.ts",
-	},
-	format: ["esm"],
-	platform: "browser",
-	outDir: "dist",
-	dts: true,
-	minify: true,
-	deps: { onlyBundle: false },
-	checks: { pluginTimings: false },
-	define: {
-		__FASTSTATS_SDK_NAME__: JSON.stringify(pkg.name),
-		__FASTSTATS_SDK_VERSION__: JSON.stringify(pkg.version),
-	},
-	outputOptions: {
-		chunkFileNames: "chunks/[name]-[hash].js",
-		entryFileNames: "[name].js",
-	},
-});

package/worker/index.ts

@@ -1,22 +0,0 @@
-export default {
-	async fetch(
-		request: Request,
-		env: { ASSETS: { fetch: typeof fetch } },
-	): Promise<Response> {
-		const response = await env.ASSETS.fetch(request);
-
-		if (response.ok) {
-			const newHeaders = new Headers(response.headers);
-			newHeaders.set("Cache-Control", "public, max-age=31536000, immutable");
-			newHeaders.set("Access-Control-Allow-Origin", "*");
-
-			return new Response(response.body, {
-				status: response.status,
-				statusText: response.statusText,
-				headers: newHeaders,
-			});
-		}
-
-		return response;
-	},
-};