@faststats/web 0.2.14 → 0.3.0

package/src/entries/error.ts

@@ -1,6 +0,0 @@
-export {
-	default,
-	type ErrorEntry,
-	type ErrorTracking,
-	type ErrorTrackingOptions,
-} from "../error";

package/src/entries/feature-flags.ts

@@ -1,5 +0,0 @@
-export type {
-	FeatureFlagCheckContext,
-	FeatureFlagEvaluation,
-} from "../feature-flags";
-export { fetchFeatureFlagEvaluation } from "../feature-flags";

package/src/entries/main.ts

@@ -1,21 +0,0 @@
-export {
-	type ConsentMode,
-	getInstance,
-	type IdentifyOptions,
-	identify,
-	isTrackingDisabled,
-	logout,
-	optIn,
-	optOut,
-	reportError,
-	sendData,
-	setConsentMode,
-	trackEvent,
-	WebAnalytics,
-	type WebAnalyticsOptions,
-} from "../analytics";
-export type {
-	FeatureFlagCheckContext,
-	FeatureFlagEvaluation,
-} from "../feature-flags";
-export { fetchFeatureFlagEvaluation } from "../feature-flags";

package/src/entries/replay.ts

@@ -1 +0,0 @@
-export { default, type ReplayTrackerOptions } from "../replay";

package/src/entries/web-vitals.ts

@@ -1 +0,0 @@
-export { default, type WebVitalsOptions } from "../web-vitals";

package/src/env.d.ts

@@ -1,2 +0,0 @@
-declare const __FASTSTATS_SDK_NAME__: string;
-declare const __FASTSTATS_SDK_VERSION__: string;

package/src/error.ts

@@ -1,257 +0,0 @@
-import { SDK_NAME, SDK_VERSION } from "./sdk";
-import { normalizeAnalyticsBaseUrl, URLS } from "./utils/api-urls";
-import { getAnonymousId } from "./utils/identifiers";
-import { sendData } from "./utils/send-data";
-import {
-	getOrCreateSessionId,
-	getOrCreateWindowId,
-} from "./utils/session-manager";
-
-export type ErrorEntry = {
-	error: string;
-	message?: string;
-	stack?: string[];
-	handled?: boolean;
-	cause?: ErrorEntry;
-};
-
-export type ErrorTracking = ErrorEntry & {
-	hash: string;
-	count: number;
-};
-
-export interface ErrorTrackingOptions {
-	siteKey: string;
-	baseUrl?: string;
-	debug?: boolean;
-	flushInterval?: number;
-	maxQueueSize?: number;
-	sdkName?: string;
-	sdkVersion?: string;
-}
-
-type Kind = "error" | "unhandledrejection";
-
-const EXTENSION_RE =
-	/(?:^|\()(chrome|moz|ms-browser|safari-web)-extension:\/\//;
-
-const parseStack = (stack?: string): string[] | undefined =>
-	stack
-		?.split("\n")
-		.map((l) => l.trim())
-		.filter(Boolean);
-
-function serializeCause(value: unknown): ErrorEntry | undefined {
-	if (value instanceof Error) {
-		return {
-			error: value.name?.trim() || "Error",
-			message: value.message,
-			stack: parseStack(value.stack),
-			cause: serializeCause(value.cause),
-		};
-	}
-	if (typeof value === "string") return { error: "Error", message: value };
-}
-
-function fingerprintCause(cause?: ErrorEntry): string {
-	let s = "";
-	for (let c = cause; c; c = c.cause) {
-		s += `${c.error}\0${c.message ?? ""}\0`;
-	}
-	return s;
-}
-
-function hashKey(key: string): string {
-	let a = 2166136261;
-	let b = 3598710387;
-	for (let i = 0; i < key.length; i++) {
-		const c = key.charCodeAt(i);
-		a = Math.imul(a ^ c, 16777619);
-		b = Math.imul(b ^ c, 2246822519);
-	}
-	return `err_${(a >>> 0).toString(16).padStart(8, "0")}${(b >>> 0).toString(16).padStart(8, "0")}`;
-}
-
-function readBuildId(): string | undefined {
-	const v = (globalThis as { __SOURCEMAPS_BUILD__?: { buildId?: unknown } })
-		.__SOURCEMAPS_BUILD__?.buildId;
-	return typeof v === "string" && v.trim() ? v : undefined;
-}
-
-export default class ErrorTracker {
-	private readonly endpoint: string;
-	private readonly seen = new WeakSet<object>();
-	private readonly queue = new Map<string, ErrorTracking>();
-	private timer: ReturnType<typeof setInterval> | null = null;
-	private started = false;
-	private flushing = false;
-
-	constructor(private readonly options: ErrorTrackingOptions) {
-		this.endpoint = `${normalizeAnalyticsBaseUrl(options.baseUrl)}${URLS.events}`;
-	}
-
-	private log(...args: unknown[]): void {
-		if (this.options.debug) console.log("[ErrorTracker]", ...args);
-	}
-
-	start(): void {
-		if (this.started || typeof window === "undefined") return;
-		this.started = true;
-		window.addEventListener("error", this.onError);
-		window.addEventListener("unhandledrejection", this.onRejection);
-		window.addEventListener("pagehide", this.scheduleFlush);
-		document.addEventListener("visibilitychange", this.onVisibility);
-		this.timer = setInterval(
-			this.scheduleFlush,
-			this.options.flushInterval ?? 5000,
-		);
-		this.log("Started");
-	}
-
-	stop(): void {
-		if (!this.started || typeof window === "undefined") return;
-		this.started = false;
-		window.removeEventListener("error", this.onError);
-		window.removeEventListener("unhandledrejection", this.onRejection);
-		window.removeEventListener("pagehide", this.scheduleFlush);
-		document.removeEventListener("visibilitychange", this.onVisibility);
-		if (this.timer) clearInterval(this.timer);
-		this.timer = null;
-		this.scheduleFlush();
-		this.log("Stopped");
-	}
-
-	captureError(error: Error): void {
-		this.capture("error", error.message, true, error);
-	}
-
-	private onError = (event: ErrorEvent): void => {
-		this.capture(
-			"error",
-			event.message || "Unknown error",
-			false,
-			event.error,
-			event.filename || "",
-			event.lineno,
-		);
-	};
-
-	private onRejection = (event: PromiseRejectionEvent): void => {
-		const reason = event.reason;
-		const message =
-			reason instanceof Error
-				? reason.message
-				: typeof reason === "string"
-					? reason
-					: "Unhandled promise rejection";
-		this.capture("unhandledrejection", message, false, reason);
-	};
-
-	private onVisibility = (): void => {
-		if (document.visibilityState === "hidden") this.scheduleFlush();
-	};
-
-	private scheduleFlush = (): void => {
-		void this.flush();
-	};
-
-	private capture(
-		kind: Kind,
-		message: string,
-		handled: boolean,
-		source: unknown,
-		filename = "",
-		lineno: number | "" = "",
-	): void {
-		const stackText = source instanceof Error ? (source.stack ?? "") : "";
-		if (EXTENSION_RE.test(`${filename}\n${stackText}`)) return;
-
-		if (typeof source === "object" && source !== null) {
-			if (this.seen.has(source)) {
-				this.log("Skipping duplicate:", message);
-				return;
-			}
-			this.seen.add(source);
-		}
-
-		const entry: ErrorEntry = {
-			error: kind === "unhandledrejection" ? "UnhandledRejection" : "Error",
-			message,
-			handled,
-		};
-		if (source instanceof Error) {
-			entry.stack = parseStack(source.stack);
-			const cause = serializeCause(source.cause);
-			if (cause) entry.cause = cause;
-		}
-
-		const key = hashKey(
-			`${kind}\0${handled ? "handled" : "unhandled"}\0${message}\0${filename}\0${lineno}\0${fingerprintCause(entry.cause)}`,
-		);
-
-		const existing = this.queue.get(key);
-		if (existing) {
-			existing.count++;
-		} else {
-			this.queue.set(key, { hash: key, count: 1, ...entry });
-		}
-
-		this.log("Captured:", entry);
-
-		if (this.queue.size >= (this.options.maxQueueSize ?? 50)) {
-			this.scheduleFlush();
-		}
-	}
-
-	private async flush(): Promise<void> {
-		if (this.flushing || this.queue.size === 0) return;
-
-		const errors = [...this.queue.values()];
-		this.queue.clear();
-		this.flushing = true;
-
-		const userId = getAnonymousId();
-		const buildId = readBuildId();
-
-		const payload = JSON.stringify({
-			token: this.options.siteKey,
-			...(userId ? { userId } : {}),
-			sessionId: getOrCreateSessionId(),
-			windowId: getOrCreateWindowId(this.options.siteKey),
-			...(buildId ? { buildId } : {}),
-			sdkName: this.options.sdkName ?? SDK_NAME,
-			sdkVersion: this.options.sdkVersion ?? SDK_VERSION,
-			data: {
-				url: location.href,
-				page: location.pathname,
-				referrer: document.referrer || null,
-				title: document.title,
-			},
-			errors,
-		});
-
-		this.log("Flushing:", errors);
-
-		try {
-			const sent = await sendData({
-				url: this.endpoint,
-				data: payload,
-				debug: this.options.debug,
-				debugPrefix: "[ErrorTracker]",
-			});
-			if (!sent) this.requeue(errors);
-		} catch {
-			this.requeue(errors);
-		} finally {
-			this.flushing = false;
-		}
-	}
-
-	private requeue(errors: ErrorTracking[]): void {
-		for (const e of errors) {
-			const existing = this.queue.get(e.hash);
-			if (existing) existing.count += e.count;
-			else this.queue.set(e.hash, e);
-		}
-	}
-}

package/src/feature-flags.ts

@@ -1,84 +0,0 @@
-import { normalizeFeatureFlagsBaseUrl, URLS } from "./utils/api-urls";
-
-export type FeatureFlagEvaluation = {
-	value: string;
-	variantKey?: string;
-	variantValue?: string;
-};
-
-export type FeatureFlagCheckContext = {
-	baseUrl?: string;
-	projectToken?: string;
-	projectId?: string;
-	identifier?: string;
-	externalId?: string;
-	sessionId?: string;
-	attributes?: Record<string, unknown>;
-	signal?: AbortSignal;
-};
-
-export async function fetchFeatureFlagEvaluation(
-	flagKey: string,
-	context: FeatureFlagCheckContext,
-): Promise<FeatureFlagEvaluation> {
-	if (context.projectToken && context.projectId) {
-		throw new Error("provide either projectToken or projectId, not both");
-	}
-
-	const projectToken = context.projectToken;
-	const projectId = context.projectId;
-	const identifier = context.identifier;
-	const externalId = context.externalId;
-	const sessionId = context.sessionId;
-
-	if (!projectToken && !projectId) {
-		throw new Error("feature flag check requires projectToken or projectId");
-	}
-	if (!identifier && !externalId) {
-		throw new Error("feature flag check requires serverId or externalId");
-	}
-
-	const body: Record<string, unknown> = {
-		key: flagKey,
-		...(projectId ? { projectId } : {}),
-		...(identifier ? { identifier } : {}),
-		...(externalId ? { externalId } : {}),
-		...(sessionId ? { sessionId } : {}),
-	};
-
-	if (context.attributes && Object.keys(context.attributes).length > 0) {
-		body.attributes = context.attributes;
-	}
-
-	const headers: Record<string, string> = {
-		"Content-Type": "application/json",
-	};
-	if (projectToken) {
-		headers.Authorization = `Bearer ${projectToken}`;
-	}
-
-	const url = `${normalizeFeatureFlagsBaseUrl(context.baseUrl)}${URLS.flags}`;
-	const res = await fetch(url, {
-		method: "POST",
-		headers,
-		body: JSON.stringify(body),
-		credentials: "omit",
-		signal: context.signal,
-	});
-
-	if (!res.ok) {
-		let detail = "";
-		try {
-			const err = (await res.json()) as { error?: string };
-			if (typeof err.error === "string" && err.error.length > 0) {
-				detail = ` — ${err.error}`;
-			}
-		} catch {
-			/* ignore */
-		}
-		throw new Error(`feature flag check failed: HTTP ${res.status}${detail}`);
-	}
-
-	const data = (await res.json()) as FeatureFlagEvaluation;
-	return data;
-}