@interfere/react 3.0.0 → 5.0.0

package/dist/tracking/api.mjs

@@ -0,0 +1,106 @@
+import { createLogger } from "../util/log.mjs";
+import { getDeviceId, getFpHash, whenDeviceReady } from "./device.mjs";
+import { buildHeaders } from "../transport/http.mjs";
+import { SessionManager } from "./session.mjs";
+//#region src/tracking/api.ts
+const log = createLogger("tracking");
+let mgr = null;
+let target = null;
+let currentIdentity = null;
+let identifiedSessionId = null;
+let syncedSessionId = null;
+let syncAttemptMs = 0;
+const SYNC_COOLDOWN_MS = 5e3;
+function syncSession(sessionId, deviceId, fpHash) {
+	if (!target) return;
+	syncAttemptMs = Date.now();
+	fetch(target.url, {
+		method: "POST",
+		headers: buildHeaders(target.headers),
+		body: JSON.stringify({
+			sessionId,
+			deviceId,
+			fpHash
+		}),
+		keepalive: true,
+		signal: AbortSignal.timeout(1e4)
+	}).then((res) => {
+		if (res.ok) syncedSessionId = sessionId;
+	}).catch(() => {
+		log.warn("session sync failed, will retry");
+	});
+}
+function ensureSynced(sessionId) {
+	if (syncedSessionId === sessionId) return;
+	if (Date.now() - syncAttemptMs < SYNC_COOLDOWN_MS) return;
+	syncSession(sessionId, getDeviceId(), getFpHash());
+}
+async function onRotate(sessionId) {
+	syncedSessionId = null;
+	if (!target) return;
+	const deviceId = await whenDeviceReady();
+	log.debug("POST session %s (device=%s)", sessionId, deviceId ?? "pending");
+	syncSession(sessionId, deviceId, getFpHash());
+}
+function bootstrap(sessionTarget) {
+	target = sessionTarget;
+	mgr = new SessionManager((id) => {
+		onRotate(id).catch(() => {});
+	});
+}
+const session = {
+	getId() {
+		const id = mgr?.getSessionId() ?? null;
+		if (id) ensureSynced(id);
+		return id;
+	},
+	getWindowId() {
+		return mgr?.getWindowId() ?? null;
+	}
+};
+const identity = {
+	get() {
+		return currentIdentity;
+	},
+	set(params) {
+		if (!(mgr && target)) return;
+		const sessionId = mgr.getSessionId();
+		if (identifiedSessionId === sessionId) {
+			log.debug("skipped, already identified for session %s", sessionId);
+			return;
+		}
+		currentIdentity = params;
+		identifiedSessionId = sessionId;
+		const deviceId = getDeviceId();
+		const fpHash = getFpHash();
+		log.info("PUT session %s → user %s", sessionId, params.identifier);
+		fetch(target.url, {
+			method: "PUT",
+			headers: buildHeaders(target.headers),
+			body: JSON.stringify({
+				sessionId,
+				deviceId,
+				fpHash,
+				...params
+			}),
+			keepalive: true,
+			signal: AbortSignal.timeout(1e4)
+		}).catch(() => {
+			identifiedSessionId = null;
+			log.warn("identify failed for session %s", sessionId);
+		});
+	},
+	clear() {
+		currentIdentity = null;
+		identifiedSessionId = null;
+	}
+};
+function teardown() {
+	identity.clear();
+	syncedSessionId = null;
+	syncAttemptMs = 0;
+	mgr = null;
+	target = null;
+}
+//#endregion
+export { bootstrap, identity, session, teardown };

package/dist/tracking/api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.mjs","names":[],"sources":["../../src/tracking/api.ts"],"sourcesContent":["import type { IdentifyParams } from \"@interfere/types/sdk/identify\";\n\nimport { buildHeaders, type IngestTarget } from \"../transport/http.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { getDeviceId, getFpHash, whenDeviceReady } from \"./device.js\";\nimport { SessionManager } from \"./session.js\";\n\nconst log = createLogger(\"tracking\");\n\nlet mgr: SessionManager | null = null;\nlet target: IngestTarget | null = null;\nlet currentIdentity: IdentifyParams | null = null;\nlet identifiedSessionId: string | null = null;\n\nlet syncedSessionId: string | null = null;\nlet syncAttemptMs = 0;\nconst SYNC_COOLDOWN_MS = 5000;\n\nfunction syncSession(\n  sessionId: string,\n  deviceId: string | null,\n  fpHash: string | null\n): void {\n  if (!target) {\n    return;\n  }\n\n  syncAttemptMs = Date.now();\n\n  fetch(target.url, {\n    method: \"POST\",\n    headers: buildHeaders(target.headers),\n    body: JSON.stringify({ sessionId, deviceId, fpHash }),\n    keepalive: true,\n    signal: AbortSignal.timeout(10_000),\n  })\n    .then((res) => {\n      if (res.ok) {\n        syncedSessionId = sessionId;\n      }\n    })\n    .catch(() => {\n      log.warn(\"session sync failed, will retry\");\n    });\n}\n\nfunction ensureSynced(sessionId: string): void {\n  if (syncedSessionId === sessionId) {\n    return;\n  }\n  if (Date.now() - syncAttemptMs < SYNC_COOLDOWN_MS) {\n    return;\n  }\n  syncSession(sessionId, getDeviceId(), getFpHash());\n}\n\nasync function onRotate(sessionId: string): Promise<void> {\n  syncedSessionId = null;\n  if (!target) {\n    return;\n  }\n  const deviceId = await whenDeviceReady();\n  log.debug(\"POST session %s (device=%s)\", sessionId, deviceId ?? \"pending\");\n  syncSession(sessionId, deviceId, getFpHash());\n}\n\nexport function bootstrap(sessionTarget: IngestTarget): void {\n  target = sessionTarget;\n\n  mgr = new SessionManager((id) => {\n    onRotate(id).catch(() => {\n      /* best-effort */\n    });\n  });\n}\n\nexport const session = {\n  getId(): string | null {\n    const id = mgr?.getSessionId() ?? null;\n    if (id) {\n      ensureSynced(id);\n    }\n    return id;\n  },\n\n  getWindowId(): string | null {\n    return mgr?.getWindowId() ?? null;\n  },\n};\n\nexport const identity = {\n  get(): IdentifyParams | null {\n    return currentIdentity;\n  },\n\n  set(params: IdentifyParams): void {\n    if (!(mgr && target)) {\n      return;\n    }\n    const sessionId = mgr.getSessionId();\n    if (identifiedSessionId === sessionId) {\n      log.debug(\"skipped, already identified for session %s\", sessionId);\n      return;\n    }\n\n    currentIdentity = params;\n    identifiedSessionId = sessionId;\n\n    const deviceId = getDeviceId();\n    const fpHash = getFpHash();\n    log.info(\"PUT session %s → user %s\", sessionId, params.identifier);\n    fetch(target.url, {\n      method: \"PUT\",\n      headers: buildHeaders(target.headers),\n      body: JSON.stringify({ sessionId, deviceId, fpHash, ...params }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    }).catch(() => {\n      identifiedSessionId = null;\n      log.warn(\"identify failed for session %s\", sessionId);\n    });\n  },\n\n  clear(): void {\n    currentIdentity = null;\n    identifiedSessionId = null;\n  },\n};\n\nexport function teardown(): void {\n  identity.clear();\n  syncedSessionId = null;\n  syncAttemptMs = 0;\n  mgr = null;\n  target = null;\n}\n"],"mappings":";;;;;AAOA,MAAM,MAAM,aAAa,WAAW;AAEpC,IAAI,MAA6B;AACjC,IAAI,SAA8B;AAClC,IAAI,kBAAyC;AAC7C,IAAI,sBAAqC;AAEzC,IAAI,kBAAiC;AACrC,IAAI,gBAAgB;AACpB,MAAM,mBAAmB;AAEzB,SAAS,YACP,WACA,UACA,QACM;AACN,KAAI,CAAC,OACH;AAGF,iBAAgB,KAAK,KAAK;AAE1B,OAAM,OAAO,KAAK;EAChB,QAAQ;EACR,SAAS,aAAa,OAAO,QAAQ;EACrC,MAAM,KAAK,UAAU;GAAE;GAAW;GAAU;GAAQ,CAAC;EACrD,WAAW;EACX,QAAQ,YAAY,QAAQ,IAAO;EACpC,CAAC,CACC,MAAM,QAAQ;AACb,MAAI,IAAI,GACN,mBAAkB;GAEpB,CACD,YAAY;AACX,MAAI,KAAK,kCAAkC;GAC3C;;AAGN,SAAS,aAAa,WAAyB;AAC7C,KAAI,oBAAoB,UACtB;AAEF,KAAI,KAAK,KAAK,GAAG,gBAAgB,iBAC/B;AAEF,aAAY,WAAW,aAAa,EAAE,WAAW,CAAC;;AAGpD,eAAe,SAAS,WAAkC;AACxD,mBAAkB;AAClB,KAAI,CAAC,OACH;CAEF,MAAM,WAAW,MAAM,iBAAiB;AACxC,KAAI,MAAM,+BAA+B,WAAW,YAAY,UAAU;AAC1E,aAAY,WAAW,UAAU,WAAW,CAAC;;AAG/C,SAAgB,UAAU,eAAmC;AAC3D,UAAS;AAET,OAAM,IAAI,gBAAgB,OAAO;AAC/B,WAAS,GAAG,CAAC,YAAY,GAEvB;GACF;;AAGJ,MAAa,UAAU;CACrB,QAAuB;EACrB,MAAM,KAAK,KAAK,cAAc,IAAI;AAClC,MAAI,GACF,cAAa,GAAG;AAElB,SAAO;;CAGT,cAA6B;AAC3B,SAAO,KAAK,aAAa,IAAI;;CAEhC;AAED,MAAa,WAAW;CACtB,MAA6B;AAC3B,SAAO;;CAGT,IAAI,QAA8B;AAChC,MAAI,EAAE,OAAO,QACX;EAEF,MAAM,YAAY,IAAI,cAAc;AACpC,MAAI,wBAAwB,WAAW;AACrC,OAAI,MAAM,8CAA8C,UAAU;AAClE;;AAGF,oBAAkB;AAClB,wBAAsB;EAEtB,MAAM,WAAW,aAAa;EAC9B,MAAM,SAAS,WAAW;AAC1B,MAAI,KAAK,4BAA4B,WAAW,OAAO,WAAW;AAClE,QAAM,OAAO,KAAK;GAChB,QAAQ;GACR,SAAS,aAAa,OAAO,QAAQ;GACrC,MAAM,KAAK,UAAU;IAAE;IAAW;IAAU;IAAQ,GAAG;IAAQ,CAAC;GAChE,WAAW;GACX,QAAQ,YAAY,QAAQ,IAAO;GACpC,CAAC,CAAC,YAAY;AACb,yBAAsB;AACtB,OAAI,KAAK,kCAAkC,UAAU;IACrD;;CAGJ,QAAc;AACZ,oBAAkB;AAClB,wBAAsB;;CAEzB;AAED,SAAgB,WAAiB;AAC/B,UAAS,OAAO;AAChB,mBAAkB;AAClB,iBAAgB;AAChB,OAAM;AACN,UAAS"}

package/dist/tracking/device.d.mts

@@ -0,0 +1,8 @@
+//#region src/tracking/device.d.ts
+declare function initDevice(): void;
+declare function getDeviceId(): string | null;
+declare function getFpHash(): string | null;
+declare function whenDeviceReady(): Promise<string | null>;
+declare function resetDevice(): void;
+//#endregion
+export { getDeviceId, getFpHash, initDevice, resetDevice, whenDeviceReady };

package/dist/tracking/device.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.mts","names":[],"sources":["../../src/tracking/device.ts"],"mappings":";iBA+CgB,UAAA,CAAA;AAAA,iBAiDA,WAAA,CAAA;AAAA,iBAIA,SAAA,CAAA;AAAA,iBAIA,eAAA,CAAA,GAAmB,OAAA;AAAA,iBAOnB,WAAA,CAAA"}

package/dist/tracking/device.mjs

@@ -0,0 +1,76 @@
+import { createLogger } from "../util/log.mjs";
+//#region src/tracking/device.ts
+const log = createLogger("device");
+const LS_KEY = "interfere:device_id";
+const COOKIE_NAME = "interfere_did";
+const COOKIE_MAX_AGE_DAYS = 400;
+let deviceId = null;
+let fpHash = null;
+let fpPending = null;
+function tryLocalStorage() {
+	try {
+		const s = globalThis.localStorage;
+		const key = "__interfere_device_probe__";
+		s.setItem(key, "1");
+		s.removeItem(key);
+		return s;
+	} catch {
+		return null;
+	}
+}
+function getCookie(name) {
+	if (typeof document === "undefined") return null;
+	const match = document.cookie.split("; ").find((c) => c.startsWith(`${name}=`));
+	return match ? decodeURIComponent(match.split("=")[1] ?? "") : null;
+}
+function setCookie(name, value) {
+	if (typeof document === "undefined") return;
+	const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;
+	document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;
+}
+function generateId() {
+	return crypto.randomUUID();
+}
+function initDevice() {
+	if (deviceId) return;
+	const ls = tryLocalStorage();
+	const fromLs = ls?.getItem(LS_KEY) ?? null;
+	const fromCookie = getCookie(COOKIE_NAME);
+	deviceId = fromLs ?? fromCookie ?? generateId();
+	if (!fromLs && ls) ls.setItem(LS_KEY, deviceId);
+	if (!fromCookie) setCookie(COOKIE_NAME, deviceId);
+	if (fromLs && !fromCookie) setCookie(COOKIE_NAME, deviceId);
+	if (fromCookie && !fromLs && ls) ls.setItem(LS_KEY, deviceId);
+	log.debug("device %s (ls=%s cookie=%s)", deviceId, !!fromLs, !!fromCookie);
+	initFpHash();
+}
+function initFpHash() {
+	if (fpHash || fpPending) return;
+	fpPending = (async () => {
+		try {
+			fpHash = (await (await (await import("@fingerprintjs/fingerprintjs")).load()).get()).visitorId;
+			log.debug("fpHash %s", fpHash);
+			return fpHash;
+		} catch {
+			log.warn("fp hash failed");
+			return null;
+		}
+	})();
+}
+function getDeviceId() {
+	return deviceId;
+}
+function getFpHash() {
+	return fpHash;
+}
+function whenDeviceReady() {
+	if (deviceId) return Promise.resolve(deviceId);
+	return Promise.resolve(null);
+}
+function resetDevice() {
+	deviceId = null;
+	fpHash = null;
+	fpPending = null;
+}
+//#endregion
+export { getDeviceId, getFpHash, initDevice, resetDevice, whenDeviceReady };

package/dist/tracking/device.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.mjs","names":[],"sources":["../../src/tracking/device.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"device\");\n\nconst LS_KEY = \"interfere:device_id\";\nconst COOKIE_NAME = \"interfere_did\";\nconst COOKIE_MAX_AGE_DAYS = 400;\n\nlet deviceId: string | null = null;\nlet fpHash: string | null = null;\nlet fpPending: Promise<string | null> | null = null;\n\nfunction tryLocalStorage(): Storage | null {\n  try {\n    const s = globalThis.localStorage;\n    const key = \"__interfere_device_probe__\";\n    s.setItem(key, \"1\");\n    s.removeItem(key);\n    return s;\n  } catch {\n    return null;\n  }\n}\n\nfunction getCookie(name: string): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n  const match = document.cookie\n    .split(\"; \")\n    .find((c) => c.startsWith(`${name}=`));\n  return match ? decodeURIComponent(match.split(\"=\")[1] ?? \"\") : null;\n}\n\nfunction setCookie(name: string, value: string): void {\n  if (typeof document === \"undefined\") {\n    return;\n  }\n  const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;\n  // biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API is async and not universally supported; synchronous access is required here\n  document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;\n}\n\nfunction generateId(): string {\n  return crypto.randomUUID();\n}\n\nexport function initDevice(): void {\n  if (deviceId) {\n    return;\n  }\n\n  const ls = tryLocalStorage();\n  const fromLs = ls?.getItem(LS_KEY) ?? null;\n  const fromCookie = getCookie(COOKIE_NAME);\n\n  deviceId = fromLs ?? fromCookie ?? generateId();\n\n  if (!fromLs && ls) {\n    ls.setItem(LS_KEY, deviceId);\n  }\n  if (!fromCookie) {\n    setCookie(COOKIE_NAME, deviceId);\n  }\n  if (fromLs && !fromCookie) {\n    setCookie(COOKIE_NAME, deviceId);\n  }\n  if (fromCookie && !fromLs && ls) {\n    ls.setItem(LS_KEY, deviceId);\n  }\n\n  log.debug(\"device %s (ls=%s cookie=%s)\", deviceId, !!fromLs, !!fromCookie);\n\n  initFpHash();\n}\n\nfunction initFpHash(): void {\n  if (fpHash || fpPending) {\n    return;\n  }\n\n  fpPending = (async () => {\n    try {\n      const FingerprintJS = await import(\"@fingerprintjs/fingerprintjs\");\n      const fp = await FingerprintJS.load();\n      const result = await fp.get();\n      fpHash = result.visitorId;\n      log.debug(\"fpHash %s\", fpHash);\n      return fpHash;\n    } catch {\n      log.warn(\"fp hash failed\");\n      return null;\n    }\n  })();\n}\n\nexport function getDeviceId(): string | null {\n  return deviceId;\n}\n\nexport function getFpHash(): string | null {\n  return fpHash;\n}\n\nexport function whenDeviceReady(): Promise<string | null> {\n  if (deviceId) {\n    return Promise.resolve(deviceId);\n  }\n  return Promise.resolve(null);\n}\n\nexport function resetDevice(): void {\n  deviceId = null;\n  fpHash = null;\n  fpPending = null;\n}\n"],"mappings":";;AAEA,MAAM,MAAM,aAAa,SAAS;AAElC,MAAM,SAAS;AACf,MAAM,cAAc;AACpB,MAAM,sBAAsB;AAE5B,IAAI,WAA0B;AAC9B,IAAI,SAAwB;AAC5B,IAAI,YAA2C;AAE/C,SAAS,kBAAkC;AACzC,KAAI;EACF,MAAM,IAAI,WAAW;EACrB,MAAM,MAAM;AACZ,IAAE,QAAQ,KAAK,IAAI;AACnB,IAAE,WAAW,IAAI;AACjB,SAAO;SACD;AACN,SAAO;;;AAIX,SAAS,UAAU,MAA6B;AAC9C,KAAI,OAAO,aAAa,YACtB,QAAO;CAET,MAAM,QAAQ,SAAS,OACpB,MAAM,KAAK,CACX,MAAM,MAAM,EAAE,WAAW,GAAG,KAAK,GAAG,CAAC;AACxC,QAAO,QAAQ,mBAAmB,MAAM,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG;;AAGjE,SAAS,UAAU,MAAc,OAAqB;AACpD,KAAI,OAAO,aAAa,YACtB;CAEF,MAAM,SAAS,sBAAsB,KAAK,KAAK;AAE/C,UAAS,SAAS,GAAG,KAAK,GAAG,mBAAmB,MAAM,CAAC,kBAAkB,OAAO;;AAGlF,SAAS,aAAqB;AAC5B,QAAO,OAAO,YAAY;;AAG5B,SAAgB,aAAmB;AACjC,KAAI,SACF;CAGF,MAAM,KAAK,iBAAiB;CAC5B,MAAM,SAAS,IAAI,QAAQ,OAAO,IAAI;CACtC,MAAM,aAAa,UAAU,YAAY;AAEzC,YAAW,UAAU,cAAc,YAAY;AAE/C,KAAI,CAAC,UAAU,GACb,IAAG,QAAQ,QAAQ,SAAS;AAE9B,KAAI,CAAC,WACH,WAAU,aAAa,SAAS;AAElC,KAAI,UAAU,CAAC,WACb,WAAU,aAAa,SAAS;AAElC,KAAI,cAAc,CAAC,UAAU,GAC3B,IAAG,QAAQ,QAAQ,SAAS;AAG9B,KAAI,MAAM,+BAA+B,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW;AAE1E,aAAY;;AAGd,SAAS,aAAmB;AAC1B,KAAI,UAAU,UACZ;AAGF,cAAa,YAAY;AACvB,MAAI;AAIF,aADe,OADJ,OADW,MAAM,OAAO,iCACJ,MAAM,EACb,KAAK,EACb;AAChB,OAAI,MAAM,aAAa,OAAO;AAC9B,UAAO;UACD;AACN,OAAI,KAAK,iBAAiB;AAC1B,UAAO;;KAEP;;AAGN,SAAgB,cAA6B;AAC3C,QAAO;;AAGT,SAAgB,YAA2B;AACzC,QAAO;;AAGT,SAAgB,kBAA0C;AACxD,KAAI,SACF,QAAO,QAAQ,QAAQ,SAAS;AAElC,QAAO,QAAQ,QAAQ,KAAK;;AAG9B,SAAgB,cAAoB;AAClC,YAAW;AACX,UAAS;AACT,aAAY"}

package/dist/tracking/session.d.mts

@@ -0,0 +1,19 @@
+//#region src/tracking/session.d.ts
+type OnRotate = (sessionId: string) => void;
+declare class SessionManager {
+  sessionId: string | null;
+  windowId: string | null;
+  private readonly local;
+  private readonly session;
+  private readonly onRotate;
+  private lastActivityMs;
+  constructor(onRotate?: OnRotate);
+  getSessionId(): string;
+  getWindowId(): string;
+  private restore;
+  private rotate;
+  private touch;
+  private isExpired;
+}
+//#endregion
+export { OnRotate, SessionManager };

package/dist/tracking/session.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.mts","names":[],"sources":["../../src/tracking/session.ts"],"mappings":";KAmBY,QAAA,IAAY,SAAA;AAAA,cAEX,cAAA;EACX,SAAA;EACA,QAAA;EAAA,iBACiB,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,QAAA;EAAA,QACT,cAAA;cAEI,QAAA,GAAW,QAAA;EAOvB,YAAA,CAAA;EAQA,WAAA,CAAA;EAAA,QAgBQ,OAAA;EAAA,QAWA,MAAA;EAAA,QAQA,KAAA;EAAA,QAKA,SAAA;AAAA"}

package/dist/tracking/session.mjs

@@ -0,0 +1,75 @@
+import { v7 } from "uuid";
+//#region src/tracking/session.ts
+const SESSION_ID_KEY = "interfere:session_id";
+const LAST_ACTIVITY_KEY = "interfere:last_activity";
+const WINDOW_ID_KEY = "interfere:window_id";
+const SESSION_TIMEOUT_MS = 1800 * 1e3;
+function tryStorage(type) {
+	try {
+		const s = globalThis[type];
+		const key = "__interfere_probe__";
+		s.setItem(key, "1");
+		s.removeItem(key);
+		return s;
+	} catch {
+		return null;
+	}
+}
+var SessionManager = class {
+	sessionId = null;
+	windowId = null;
+	local;
+	session;
+	onRotate = null;
+	lastActivityMs = 0;
+	constructor(onRotate) {
+		this.local = tryStorage("localStorage");
+		this.session = tryStorage("sessionStorage");
+		this.onRotate = onRotate ?? null;
+		this.restore();
+	}
+	getSessionId() {
+		if (this.sessionId && !this.isExpired()) {
+			this.touch();
+			return this.sessionId;
+		}
+		return this.rotate();
+	}
+	getWindowId() {
+		if (this.windowId) return this.windowId;
+		const stored = this.session?.getItem(WINDOW_ID_KEY);
+		if (stored) {
+			this.windowId = stored;
+			return stored;
+		}
+		this.windowId = `win_${crypto.randomUUID()}`;
+		this.session?.setItem(WINDOW_ID_KEY, this.windowId);
+		return this.windowId;
+	}
+	restore() {
+		const stored = this.local?.getItem(SESSION_ID_KEY);
+		if (stored && !this.isExpired()) {
+			this.sessionId = stored;
+			this.touch();
+		} else this.rotate();
+	}
+	rotate() {
+		this.sessionId = v7();
+		this.local?.setItem(SESSION_ID_KEY, this.sessionId);
+		this.touch();
+		this.onRotate?.(this.sessionId);
+		return this.sessionId;
+	}
+	touch() {
+		this.lastActivityMs = Date.now();
+		this.local?.setItem(LAST_ACTIVITY_KEY, String(this.lastActivityMs));
+	}
+	isExpired() {
+		const raw = this.local?.getItem(LAST_ACTIVITY_KEY);
+		const ts = raw ? Number(raw) : this.lastActivityMs;
+		if (ts === 0) return true;
+		return Date.now() - ts > SESSION_TIMEOUT_MS;
+	}
+};
+//#endregion
+export { SessionManager };

package/dist/tracking/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","names":["uuidv7"],"sources":["../../src/tracking/session.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"uuid\";\n\nconst SESSION_ID_KEY = \"interfere:session_id\";\nconst LAST_ACTIVITY_KEY = \"interfere:last_activity\";\nconst WINDOW_ID_KEY = \"interfere:window_id\";\nconst SESSION_TIMEOUT_MS = 30 * 60 * 1000;\n\nfunction tryStorage(type: \"localStorage\" | \"sessionStorage\"): Storage | null {\n  try {\n    const s = globalThis[type];\n    const key = \"__interfere_probe__\";\n    s.setItem(key, \"1\");\n    s.removeItem(key);\n    return s;\n  } catch {\n    return null;\n  }\n}\n\nexport type OnRotate = (sessionId: string) => void;\n\nexport class SessionManager {\n  sessionId: string | null = null;\n  windowId: string | null = null;\n  private readonly local: Storage | null;\n  private readonly session: Storage | null;\n  private readonly onRotate: OnRotate | null = null;\n  private lastActivityMs = 0;\n\n  constructor(onRotate?: OnRotate) {\n    this.local = tryStorage(\"localStorage\");\n    this.session = tryStorage(\"sessionStorage\");\n    this.onRotate = onRotate ?? null;\n    this.restore();\n  }\n\n  getSessionId(): string {\n    if (this.sessionId && !this.isExpired()) {\n      this.touch();\n      return this.sessionId;\n    }\n    return this.rotate();\n  }\n\n  getWindowId(): string {\n    if (this.windowId) {\n      return this.windowId;\n    }\n\n    const stored = this.session?.getItem(WINDOW_ID_KEY);\n    if (stored) {\n      this.windowId = stored;\n      return stored;\n    }\n\n    this.windowId = `win_${crypto.randomUUID()}`;\n    this.session?.setItem(WINDOW_ID_KEY, this.windowId);\n    return this.windowId;\n  }\n\n  private restore(): void {\n    const stored = this.local?.getItem(SESSION_ID_KEY);\n\n    if (stored && !this.isExpired()) {\n      this.sessionId = stored;\n      this.touch();\n    } else {\n      this.rotate();\n    }\n  }\n\n  private rotate(): string {\n    this.sessionId = uuidv7();\n    this.local?.setItem(SESSION_ID_KEY, this.sessionId);\n    this.touch();\n    this.onRotate?.(this.sessionId);\n    return this.sessionId;\n  }\n\n  private touch(): void {\n    this.lastActivityMs = Date.now();\n    this.local?.setItem(LAST_ACTIVITY_KEY, String(this.lastActivityMs));\n  }\n\n  private isExpired(): boolean {\n    const raw = this.local?.getItem(LAST_ACTIVITY_KEY);\n    const ts = raw ? Number(raw) : this.lastActivityMs;\n\n    if (ts === 0) {\n      return true;\n    }\n    return Date.now() - ts > SESSION_TIMEOUT_MS;\n  }\n}\n"],"mappings":";;AAEA,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,OAAU;AAErC,SAAS,WAAW,MAAyD;AAC3E,KAAI;EACF,MAAM,IAAI,WAAW;EACrB,MAAM,MAAM;AACZ,IAAE,QAAQ,KAAK,IAAI;AACnB,IAAE,WAAW,IAAI;AACjB,SAAO;SACD;AACN,SAAO;;;AAMX,IAAa,iBAAb,MAA4B;CAC1B,YAA2B;CAC3B,WAA0B;CAC1B;CACA;CACA,WAA6C;CAC7C,iBAAyB;CAEzB,YAAY,UAAqB;AAC/B,OAAK,QAAQ,WAAW,eAAe;AACvC,OAAK,UAAU,WAAW,iBAAiB;AAC3C,OAAK,WAAW,YAAY;AAC5B,OAAK,SAAS;;CAGhB,eAAuB;AACrB,MAAI,KAAK,aAAa,CAAC,KAAK,WAAW,EAAE;AACvC,QAAK,OAAO;AACZ,UAAO,KAAK;;AAEd,SAAO,KAAK,QAAQ;;CAGtB,cAAsB;AACpB,MAAI,KAAK,SACP,QAAO,KAAK;EAGd,MAAM,SAAS,KAAK,SAAS,QAAQ,cAAc;AACnD,MAAI,QAAQ;AACV,QAAK,WAAW;AAChB,UAAO;;AAGT,OAAK,WAAW,OAAO,OAAO,YAAY;AAC1C,OAAK,SAAS,QAAQ,eAAe,KAAK,SAAS;AACnD,SAAO,KAAK;;CAGd,UAAwB;EACtB,MAAM,SAAS,KAAK,OAAO,QAAQ,eAAe;AAElD,MAAI,UAAU,CAAC,KAAK,WAAW,EAAE;AAC/B,QAAK,YAAY;AACjB,QAAK,OAAO;QAEZ,MAAK,QAAQ;;CAIjB,SAAyB;AACvB,OAAK,YAAYA,IAAQ;AACzB,OAAK,OAAO,QAAQ,gBAAgB,KAAK,UAAU;AACnD,OAAK,OAAO;AACZ,OAAK,WAAW,KAAK,UAAU;AAC/B,SAAO,KAAK;;CAGd,QAAsB;AACpB,OAAK,iBAAiB,KAAK,KAAK;AAChC,OAAK,OAAO,QAAQ,mBAAmB,OAAO,KAAK,eAAe,CAAC;;CAGrE,YAA6B;EAC3B,MAAM,MAAM,KAAK,OAAO,QAAQ,kBAAkB;EAClD,MAAM,KAAK,MAAM,OAAO,IAAI,GAAG,KAAK;AAEpC,MAAI,OAAO,EACT,QAAO;AAET,SAAO,KAAK,KAAK,GAAG,KAAK"}

package/dist/transport/http.d.mts

@@ -0,0 +1,21 @@
+import { Envelope } from "@interfere/types/sdk/envelope";
+
+//#region src/transport/http.d.ts
+interface IngestTarget {
+  headers: Headers;
+  url: string;
+}
+interface DeliveryMeta {
+  queueDepth: number;
+  retryCount: number;
+}
+declare function buildHeaders(base: Headers, meta?: DeliveryMeta): Record<string, string>;
+declare function hasServiceWorker(): boolean;
+declare class HttpTransport {
+  private readonly target;
+  private pendingKeepalive;
+  constructor(target: IngestTarget);
+  send(envelopes: Envelope[], meta?: DeliveryMeta): Promise<void>;
+}
+//#endregion
+export { DeliveryMeta, HttpTransport, IngestTarget, buildHeaders, hasServiceWorker };

package/dist/transport/http.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.mts","names":[],"sources":["../../src/transport/http.ts"],"mappings":";;;UAWiB,YAAA;EACf,OAAA,EAAS,OAAA;EACT,GAAA;AAAA;AAAA,UAGe,YAAA;EACf,UAAA;EACA,UAAA;AAAA;AAAA,iBAGc,YAAA,CACd,IAAA,EAAM,OAAA,EACN,IAAA,GAAO,YAAA,GACN,MAAA;AAAA,iBA4Ba,gBAAA,CAAA;AAAA,cAiBH,aAAA;EAAA,iBACM,MAAA;EAAA,QACT,gBAAA;cAEI,MAAA,EAAQ,YAAA;EAId,IAAA,CAAK,SAAA,EAAW,QAAA,IAAY,IAAA,GAAO,YAAA,GAAe,OAAA;AAAA"}

package/dist/transport/http.mjs

@@ -0,0 +1,68 @@
+import { PRODUCER_VERSION } from "../internal/version.mjs";
+import { createLogger } from "../util/log.mjs";
+import { getDeviceId } from "../tracking/device.mjs";
+import { session } from "../tracking/api.mjs";
+//#region src/transport/http.ts
+const log = createLogger("http");
+const SEND_TIMEOUT_MS = 1e4;
+function buildHeaders(base, meta) {
+	const h = Object.fromEntries(base.entries());
+	h["x-interfere-sdk-version"] = PRODUCER_VERSION;
+	const sessionId = session.getId();
+	if (sessionId) h["x-interfere-session"] = sessionId;
+	const windowId = session.getWindowId();
+	if (windowId) h["x-interfere-window"] = windowId;
+	const deviceId = getDeviceId();
+	if (deviceId) h["x-interfere-device"] = deviceId;
+	if (meta) {
+		h["x-interfere-retry-count"] = String(meta.retryCount);
+		h["x-interfere-queue-depth"] = String(meta.queueDepth);
+	}
+	return h;
+}
+function hasServiceWorker() {
+	return typeof navigator !== "undefined" && "serviceWorker" in navigator && navigator.serviceWorker.controller !== null;
+}
+function assertOk(response) {
+	if (!response.ok) throw new Error(`ingest responded ${response.status}`);
+}
+const KEEPALIVE_BUDGET_BYTES = 61440;
+const MAX_CONCURRENT_KEEPALIVE = 15;
+var HttpTransport = class {
+	target;
+	pendingKeepalive = 0;
+	constructor(target) {
+		this.target = target;
+	}
+	async send(envelopes, meta) {
+		const body = JSON.stringify(envelopes);
+		const headers = buildHeaders(this.target.headers, meta);
+		if (hasServiceWorker()) {
+			log.debug("POST %d envelopes via SW", envelopes.length);
+			assertOk(await fetch(this.target.url, {
+				method: "POST",
+				headers,
+				body,
+				signal: AbortSignal.timeout(SEND_TIMEOUT_MS)
+			}));
+			return;
+		}
+		const bytes = new TextEncoder().encode(body).byteLength;
+		const useKeepalive = bytes < KEEPALIVE_BUDGET_BYTES && this.pendingKeepalive < MAX_CONCURRENT_KEEPALIVE;
+		if (useKeepalive) this.pendingKeepalive++;
+		log.debug("POST %d envelopes direct (%d bytes, keepalive=%s)", envelopes.length, bytes, useKeepalive);
+		try {
+			assertOk(await fetch(this.target.url, {
+				method: "POST",
+				headers,
+				body,
+				keepalive: useKeepalive,
+				signal: AbortSignal.timeout(SEND_TIMEOUT_MS)
+			}));
+		} finally {
+			if (useKeepalive) this.pendingKeepalive--;
+		}
+	}
+};
+//#endregion
+export { HttpTransport, buildHeaders, hasServiceWorker };

package/dist/transport/http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.mjs","names":[],"sources":["../../src/transport/http.ts"],"sourcesContent":["import type { Envelope } from \"@interfere/types/sdk/envelope\";\n\nimport { PRODUCER_VERSION } from \"../internal/version.js\";\nimport { session } from \"../tracking/api.js\";\nimport { getDeviceId } from \"../tracking/device.js\";\nimport { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"http\");\n\nconst SEND_TIMEOUT_MS = 10_000;\n\nexport interface IngestTarget {\n  headers: Headers;\n  url: string;\n}\n\nexport interface DeliveryMeta {\n  queueDepth: number;\n  retryCount: number;\n}\n\nexport function buildHeaders(\n  base: Headers,\n  meta?: DeliveryMeta\n): Record<string, string> {\n  const h: Record<string, string> = Object.fromEntries(base.entries());\n\n  h[\"x-interfere-sdk-version\"] = PRODUCER_VERSION;\n\n  const sessionId = session.getId();\n  if (sessionId) {\n    h[\"x-interfere-session\"] = sessionId;\n  }\n\n  const windowId = session.getWindowId();\n  if (windowId) {\n    h[\"x-interfere-window\"] = windowId;\n  }\n\n  const deviceId = getDeviceId();\n  if (deviceId) {\n    h[\"x-interfere-device\"] = deviceId;\n  }\n\n  if (meta) {\n    h[\"x-interfere-retry-count\"] = String(meta.retryCount);\n    h[\"x-interfere-queue-depth\"] = String(meta.queueDepth);\n  }\n\n  return h;\n}\n\nexport function hasServiceWorker(): boolean {\n  return (\n    typeof navigator !== \"undefined\" &&\n    \"serviceWorker\" in navigator &&\n    navigator.serviceWorker.controller !== null\n  );\n}\n\nfunction assertOk(response: Response): void {\n  if (!response.ok) {\n    throw new Error(`ingest responded ${response.status}`);\n  }\n}\n\nconst KEEPALIVE_BUDGET_BYTES = 61_440;\nconst MAX_CONCURRENT_KEEPALIVE = 15;\n\nexport class HttpTransport {\n  private readonly target: IngestTarget;\n  private pendingKeepalive = 0;\n\n  constructor(target: IngestTarget) {\n    this.target = target;\n  }\n\n  async send(envelopes: Envelope[], meta?: DeliveryMeta): Promise<void> {\n    const body = JSON.stringify(envelopes);\n    const headers = buildHeaders(this.target.headers, meta);\n\n    if (hasServiceWorker()) {\n      log.debug(\"POST %d envelopes via SW\", envelopes.length);\n      const res = await fetch(this.target.url, {\n        method: \"POST\",\n        headers,\n        body,\n        signal: AbortSignal.timeout(SEND_TIMEOUT_MS),\n      });\n      assertOk(res);\n      return;\n    }\n\n    const bytes = new TextEncoder().encode(body).byteLength;\n    const useKeepalive =\n      bytes < KEEPALIVE_BUDGET_BYTES &&\n      this.pendingKeepalive < MAX_CONCURRENT_KEEPALIVE;\n\n    if (useKeepalive) {\n      this.pendingKeepalive++;\n    }\n\n    log.debug(\n      \"POST %d envelopes direct (%d bytes, keepalive=%s)\",\n      envelopes.length,\n      bytes,\n      useKeepalive\n    );\n\n    try {\n      const res = await fetch(this.target.url, {\n        method: \"POST\",\n        headers,\n        body,\n        keepalive: useKeepalive,\n        signal: AbortSignal.timeout(SEND_TIMEOUT_MS),\n      });\n      assertOk(res);\n    } finally {\n      if (useKeepalive) {\n        this.pendingKeepalive--;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAOA,MAAM,MAAM,aAAa,OAAO;AAEhC,MAAM,kBAAkB;AAYxB,SAAgB,aACd,MACA,MACwB;CACxB,MAAM,IAA4B,OAAO,YAAY,KAAK,SAAS,CAAC;AAEpE,GAAE,6BAA6B;CAE/B,MAAM,YAAY,QAAQ,OAAO;AACjC,KAAI,UACF,GAAE,yBAAyB;CAG7B,MAAM,WAAW,QAAQ,aAAa;AACtC,KAAI,SACF,GAAE,wBAAwB;CAG5B,MAAM,WAAW,aAAa;AAC9B,KAAI,SACF,GAAE,wBAAwB;AAG5B,KAAI,MAAM;AACR,IAAE,6BAA6B,OAAO,KAAK,WAAW;AACtD,IAAE,6BAA6B,OAAO,KAAK,WAAW;;AAGxD,QAAO;;AAGT,SAAgB,mBAA4B;AAC1C,QACE,OAAO,cAAc,eACrB,mBAAmB,aACnB,UAAU,cAAc,eAAe;;AAI3C,SAAS,SAAS,UAA0B;AAC1C,KAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,oBAAoB,SAAS,SAAS;;AAI1D,MAAM,yBAAyB;AAC/B,MAAM,2BAA2B;AAEjC,IAAa,gBAAb,MAA2B;CACzB;CACA,mBAA2B;CAE3B,YAAY,QAAsB;AAChC,OAAK,SAAS;;CAGhB,MAAM,KAAK,WAAuB,MAAoC;EACpE,MAAM,OAAO,KAAK,UAAU,UAAU;EACtC,MAAM,UAAU,aAAa,KAAK,OAAO,SAAS,KAAK;AAEvD,MAAI,kBAAkB,EAAE;AACtB,OAAI,MAAM,4BAA4B,UAAU,OAAO;AAOvD,YANY,MAAM,MAAM,KAAK,OAAO,KAAK;IACvC,QAAQ;IACR;IACA;IACA,QAAQ,YAAY,QAAQ,gBAAgB;IAC7C,CAAC,CACW;AACb;;EAGF,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,KAAK,CAAC;EAC7C,MAAM,eACJ,QAAQ,0BACR,KAAK,mBAAmB;AAE1B,MAAI,aACF,MAAK;AAGP,MAAI,MACF,qDACA,UAAU,QACV,OACA,aACD;AAED,MAAI;AAQF,YAPY,MAAM,MAAM,KAAK,OAAO,KAAK;IACvC,QAAQ;IACR;IACA;IACA,WAAW;IACX,QAAQ,YAAY,QAAQ,gBAAgB;IAC7C,CAAC,CACW;YACL;AACR,OAAI,aACF,MAAK"}

package/dist/transport/queue.d.mts

@@ -0,0 +1,31 @@
+import { HttpTransport } from "./http.mjs";
+import { Envelope } from "@interfere/types/sdk/envelope";
+
+//#region src/transport/queue.d.ts
+interface QueueOptions {
+  batchMs?: number;
+  batchSize?: number;
+  maxBufferSize?: number;
+  transport: HttpTransport;
+}
+declare class BatchQueue {
+  private readonly buffer;
+  private timer;
+  private flushing;
+  private failures;
+  private pausedUntil;
+  private readonly batchSize;
+  private readonly batchMs;
+  private readonly maxBufferSize;
+  private readonly transport;
+  constructor(opts: QueueOptions);
+  start(): void;
+  enqueue(envelope: Envelope): void;
+  flush(): void;
+  dispose(): void;
+  private drain;
+  private readonly onVisibilityChange;
+  private readonly onBeforeUnload;
+}
+//#endregion
+export { BatchQueue, QueueOptions };

package/dist/transport/queue.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.mts","names":[],"sources":["../../src/transport/queue.ts"],"mappings":";;;;UAciB,YAAA;EACf,OAAA;EACA,SAAA;EACA,aAAA;EACA,SAAA,EAAW,aAAA;AAAA;AAAA,cAGA,UAAA;EAAA,iBACM,MAAA;EAAA,QACT,KAAA;EAAA,QACA,QAAA;EAAA,QACA,QAAA;EAAA,QACA,WAAA;EAAA,iBACS,SAAA;EAAA,iBACA,OAAA;EAAA,iBACA,aAAA;EAAA,iBACA,SAAA;cAEL,IAAA,EAAM,YAAA;EAOlB,KAAA,CAAA;EAeA,OAAA,CAAQ,QAAA,EAAU,QAAA;EAclB,KAAA,CAAA;EA2CA,OAAA,CAAA;EAAA,QAiBQ,KAAA;EAAA,iBASS,kBAAA;EAAA,iBAMA,cAAA;AAAA"}

package/dist/transport/queue.mjs

@@ -0,0 +1,93 @@
+import { createLogger } from "../util/log.mjs";
+import { hasServiceWorker } from "./http.mjs";
+//#region src/transport/queue.ts
+const log = createLogger("queue");
+const DEFAULT_BATCH_SIZE = 10;
+const DEFAULT_BATCH_MS = 250;
+const DEFAULT_MAX_BUFFER_SIZE = 1e3;
+const BREAKER_THRESHOLD = 5;
+const BREAKER_COOLDOWN_MS = 3e4;
+var BatchQueue = class {
+	buffer = [];
+	timer = null;
+	flushing = false;
+	failures = 0;
+	pausedUntil = 0;
+	batchSize;
+	batchMs;
+	maxBufferSize;
+	transport;
+	constructor(opts) {
+		this.batchSize = opts.batchSize ?? DEFAULT_BATCH_SIZE;
+		this.batchMs = opts.batchMs ?? DEFAULT_BATCH_MS;
+		this.maxBufferSize = opts.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;
+		this.transport = opts.transport;
+	}
+	start() {
+		if (this.timer) return;
+		this.timer = setInterval(() => {
+			this.flush();
+		}, this.batchMs);
+		if (typeof globalThis.addEventListener === "function") {
+			globalThis.addEventListener("visibilitychange", this.onVisibilityChange);
+			globalThis.addEventListener("beforeunload", this.onBeforeUnload);
+		}
+	}
+	enqueue(envelope) {
+		this.buffer.push(envelope);
+		if (this.buffer.length > this.maxBufferSize) {
+			const overflow = this.buffer.length - this.maxBufferSize;
+			this.buffer.splice(0, overflow);
+			log.warn("buffer full, dropped %d oldest envelopes", overflow);
+		}
+		if (this.buffer.length >= this.batchSize) this.flush();
+	}
+	flush() {
+		if (this.flushing || this.buffer.length === 0) return;
+		if (this.failures >= BREAKER_THRESHOLD && Date.now() < this.pausedUntil) return;
+		this.flushing = true;
+		const batch = this.buffer.splice(0, this.batchSize);
+		const meta = {
+			retryCount: this.failures,
+			queueDepth: this.buffer.length
+		};
+		this.transport.send(batch, meta).then(() => {
+			if (this.failures > 0) log.info("send recovered after %d failures", this.failures);
+			this.failures = 0;
+		}).catch(() => {
+			if (!hasServiceWorker()) this.buffer.unshift(...batch);
+			this.failures++;
+			if (this.failures >= BREAKER_THRESHOLD) {
+				this.pausedUntil = Date.now() + BREAKER_COOLDOWN_MS;
+				log.warn("pausing sends for %dms after %d consecutive failures", BREAKER_COOLDOWN_MS, this.failures);
+			}
+		}).finally(() => {
+			this.flushing = false;
+		});
+	}
+	dispose() {
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = null;
+		}
+		if (typeof globalThis.removeEventListener === "function") {
+			globalThis.removeEventListener("visibilitychange", this.onVisibilityChange);
+			globalThis.removeEventListener("beforeunload", this.onBeforeUnload);
+		}
+		this.drain();
+	}
+	drain() {
+		while (this.buffer.length > 0) {
+			const batch = this.buffer.splice(0, this.batchSize);
+			this.transport.send(batch).catch(() => {});
+		}
+	}
+	onVisibilityChange = () => {
+		if (document.visibilityState === "hidden") this.drain();
+	};
+	onBeforeUnload = () => {
+		this.drain();
+	};
+};
+//#endregion
+export { BatchQueue };

package/dist/transport/queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.mjs","names":[],"sources":["../../src/transport/queue.ts"],"sourcesContent":["import type { Envelope } from \"@interfere/types/sdk/envelope\";\n\nimport { createLogger } from \"../util/log.js\";\nimport { type HttpTransport, hasServiceWorker } from \"./http.js\";\n\nconst log = createLogger(\"queue\");\n\nconst DEFAULT_BATCH_SIZE = 10;\nconst DEFAULT_BATCH_MS = 250;\nconst DEFAULT_MAX_BUFFER_SIZE = 1000;\n\nconst BREAKER_THRESHOLD = 5;\nconst BREAKER_COOLDOWN_MS = 30_000;\n\nexport interface QueueOptions {\n  batchMs?: number;\n  batchSize?: number;\n  maxBufferSize?: number;\n  transport: HttpTransport;\n}\n\nexport class BatchQueue {\n  private readonly buffer: Envelope[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private flushing = false;\n  private failures = 0;\n  private pausedUntil = 0;\n  private readonly batchSize: number;\n  private readonly batchMs: number;\n  private readonly maxBufferSize: number;\n  private readonly transport: HttpTransport;\n\n  constructor(opts: QueueOptions) {\n    this.batchSize = opts.batchSize ?? DEFAULT_BATCH_SIZE;\n    this.batchMs = opts.batchMs ?? DEFAULT_BATCH_MS;\n    this.maxBufferSize = opts.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;\n    this.transport = opts.transport;\n  }\n\n  start(): void {\n    if (this.timer) {\n      return;\n    }\n\n    this.timer = setInterval(() => {\n      this.flush();\n    }, this.batchMs);\n\n    if (typeof globalThis.addEventListener === \"function\") {\n      globalThis.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n      globalThis.addEventListener(\"beforeunload\", this.onBeforeUnload);\n    }\n  }\n\n  enqueue(envelope: Envelope): void {\n    this.buffer.push(envelope);\n\n    if (this.buffer.length > this.maxBufferSize) {\n      const overflow = this.buffer.length - this.maxBufferSize;\n      this.buffer.splice(0, overflow);\n      log.warn(\"buffer full, dropped %d oldest envelopes\", overflow);\n    }\n\n    if (this.buffer.length >= this.batchSize) {\n      this.flush();\n    }\n  }\n\n  flush(): void {\n    if (this.flushing || this.buffer.length === 0) {\n      return;\n    }\n\n    if (this.failures >= BREAKER_THRESHOLD && Date.now() < this.pausedUntil) {\n      return;\n    }\n\n    this.flushing = true;\n    const batch = this.buffer.splice(0, this.batchSize);\n    const meta = {\n      retryCount: this.failures,\n      queueDepth: this.buffer.length,\n    };\n\n    this.transport\n      .send(batch, meta)\n      .then(() => {\n        if (this.failures > 0) {\n          log.info(\"send recovered after %d failures\", this.failures);\n        }\n        this.failures = 0;\n      })\n      .catch(() => {\n        if (!hasServiceWorker()) {\n          this.buffer.unshift(...batch);\n        }\n        this.failures++;\n        if (this.failures >= BREAKER_THRESHOLD) {\n          this.pausedUntil = Date.now() + BREAKER_COOLDOWN_MS;\n          log.warn(\n            \"pausing sends for %dms after %d consecutive failures\",\n            BREAKER_COOLDOWN_MS,\n            this.failures\n          );\n        }\n      })\n      .finally(() => {\n        this.flushing = false;\n      });\n  }\n\n  dispose(): void {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n\n    if (typeof globalThis.removeEventListener === \"function\") {\n      globalThis.removeEventListener(\n        \"visibilitychange\",\n        this.onVisibilityChange\n      );\n      globalThis.removeEventListener(\"beforeunload\", this.onBeforeUnload);\n    }\n\n    this.drain();\n  }\n\n  private drain(): void {\n    while (this.buffer.length > 0) {\n      const batch = this.buffer.splice(0, this.batchSize);\n      this.transport.send(batch).catch(() => {\n        /* best-effort — SW BackgroundSync handles persistence */\n      });\n    }\n  }\n\n  private readonly onVisibilityChange = (): void => {\n    if (document.visibilityState === \"hidden\") {\n      this.drain();\n    }\n  };\n\n  private readonly onBeforeUnload = (): void => {\n    this.drain();\n  };\n}\n"],"mappings":";;;AAKA,MAAM,MAAM,aAAa,QAAQ;AAEjC,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,0BAA0B;AAEhC,MAAM,oBAAoB;AAC1B,MAAM,sBAAsB;AAS5B,IAAa,aAAb,MAAwB;CACtB,SAAsC,EAAE;CACxC,QAAuD;CACvD,WAAmB;CACnB,WAAmB;CACnB,cAAsB;CACtB;CACA;CACA;CACA;CAEA,YAAY,MAAoB;AAC9B,OAAK,YAAY,KAAK,aAAa;AACnC,OAAK,UAAU,KAAK,WAAW;AAC/B,OAAK,gBAAgB,KAAK,iBAAiB;AAC3C,OAAK,YAAY,KAAK;;CAGxB,QAAc;AACZ,MAAI,KAAK,MACP;AAGF,OAAK,QAAQ,kBAAkB;AAC7B,QAAK,OAAO;KACX,KAAK,QAAQ;AAEhB,MAAI,OAAO,WAAW,qBAAqB,YAAY;AACrD,cAAW,iBAAiB,oBAAoB,KAAK,mBAAmB;AACxE,cAAW,iBAAiB,gBAAgB,KAAK,eAAe;;;CAIpE,QAAQ,UAA0B;AAChC,OAAK,OAAO,KAAK,SAAS;AAE1B,MAAI,KAAK,OAAO,SAAS,KAAK,eAAe;GAC3C,MAAM,WAAW,KAAK,OAAO,SAAS,KAAK;AAC3C,QAAK,OAAO,OAAO,GAAG,SAAS;AAC/B,OAAI,KAAK,4CAA4C,SAAS;;AAGhE,MAAI,KAAK,OAAO,UAAU,KAAK,UAC7B,MAAK,OAAO;;CAIhB,QAAc;AACZ,MAAI,KAAK,YAAY,KAAK,OAAO,WAAW,EAC1C;AAGF,MAAI,KAAK,YAAY,qBAAqB,KAAK,KAAK,GAAG,KAAK,YAC1D;AAGF,OAAK,WAAW;EAChB,MAAM,QAAQ,KAAK,OAAO,OAAO,GAAG,KAAK,UAAU;EACnD,MAAM,OAAO;GACX,YAAY,KAAK;GACjB,YAAY,KAAK,OAAO;GACzB;AAED,OAAK,UACF,KAAK,OAAO,KAAK,CACjB,WAAW;AACV,OAAI,KAAK,WAAW,EAClB,KAAI,KAAK,oCAAoC,KAAK,SAAS;AAE7D,QAAK,WAAW;IAChB,CACD,YAAY;AACX,OAAI,CAAC,kBAAkB,CACrB,MAAK,OAAO,QAAQ,GAAG,MAAM;AAE/B,QAAK;AACL,OAAI,KAAK,YAAY,mBAAmB;AACtC,SAAK,cAAc,KAAK,KAAK,GAAG;AAChC,QAAI,KACF,wDACA,qBACA,KAAK,SACN;;IAEH,CACD,cAAc;AACb,QAAK,WAAW;IAChB;;CAGN,UAAgB;AACd,MAAI,KAAK,OAAO;AACd,iBAAc,KAAK,MAAM;AACzB,QAAK,QAAQ;;AAGf,MAAI,OAAO,WAAW,wBAAwB,YAAY;AACxD,cAAW,oBACT,oBACA,KAAK,mBACN;AACD,cAAW,oBAAoB,gBAAgB,KAAK,eAAe;;AAGrE,OAAK,OAAO;;CAGd,QAAsB;AACpB,SAAO,KAAK,OAAO,SAAS,GAAG;GAC7B,MAAM,QAAQ,KAAK,OAAO,OAAO,GAAG,KAAK,UAAU;AACnD,QAAK,UAAU,KAAK,MAAM,CAAC,YAAY,GAErC;;;CAIN,2BAAkD;AAChD,MAAI,SAAS,oBAAoB,SAC/B,MAAK,OAAO;;CAIhB,uBAA8C;AAC5C,OAAK,OAAO"}

package/dist/util/log.d.mts

@@ -0,0 +1,13 @@
+//#region src/util/log.d.ts
+type LogLevel = "debug" | "info" | "warn" | "error" | "none";
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+interface Logger {
+  debug(...args: unknown[]): void;
+  error(...args: unknown[]): void;
+  info(...args: unknown[]): void;
+  warn(...args: unknown[]): void;
+}
+declare function createLogger(scope: string): Logger;
+//#endregion
+export { LogLevel, Logger, createLogger, getLogLevel, setLogLevel };

package/dist/util/log.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.mts","names":[],"sources":["../../src/util/log.ts"],"mappings":";KAAY,QAAA;AAAA,iBAsBI,WAAA,CAAY,KAAA,EAAO,QAAA;AAAA,iBAInB,WAAA,CAAA,GAAe,QAAA;AAAA,UAKd,MAAA;EACf,KAAA,IAAS,IAAA;EACT,KAAA,IAAS,IAAA;EACT,IAAA,IAAQ,IAAA;EACR,IAAA,IAAQ,IAAA;AAAA;AAAA,iBAeM,YAAA,CAAa,KAAA,WAAgB,MAAA"}

package/dist/util/log.mjs

@@ -0,0 +1,37 @@
+//#region src/util/log.ts
+const PRIORITY = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3,
+	none: 4
+};
+const CONSOLE_FN = {
+	debug: "debug",
+	info: "info",
+	warn: "warn",
+	error: "error"
+};
+let threshold = PRIORITY.warn;
+function setLogLevel(level) {
+	threshold = PRIORITY[level];
+}
+function getLogLevel() {
+	return Object.entries(PRIORITY).find(([, v]) => v === threshold)?.[0] ?? "warn";
+}
+function emit(level, prefix, args) {
+	if (PRIORITY[level] < threshold) return;
+	const fn = CONSOLE_FN[level];
+	globalThis.console[fn](prefix, ...args);
+}
+function createLogger(scope) {
+	const prefix = `[Interfere:${scope}]`;
+	return {
+		debug: (...args) => emit("debug", prefix, args),
+		info: (...args) => emit("info", prefix, args),
+		warn: (...args) => emit("warn", prefix, args),
+		error: (...args) => emit("error", prefix, args)
+	};
+}
+//#endregion
+export { createLogger, getLogLevel, setLogLevel };

package/dist/util/log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.mjs","names":[],"sources":["../../src/util/log.ts"],"sourcesContent":["export type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\nconst PRIORITY: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n  none: 4,\n};\n\nconst CONSOLE_FN: Record<\n  Exclude<LogLevel, \"none\">,\n  \"debug\" | \"info\" | \"warn\" | \"error\"\n> = {\n  debug: \"debug\",\n  info: \"info\",\n  warn: \"warn\",\n  error: \"error\",\n};\n\nlet threshold = PRIORITY.warn;\n\nexport function setLogLevel(level: LogLevel): void {\n  threshold = PRIORITY[level];\n}\n\nexport function getLogLevel(): LogLevel {\n  const entry = Object.entries(PRIORITY).find(([, v]) => v === threshold);\n  return (entry?.[0] ?? \"warn\") as LogLevel;\n}\n\nexport interface Logger {\n  debug(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n}\n\nfunction emit(\n  level: Exclude<LogLevel, \"none\">,\n  prefix: string,\n  args: unknown[]\n): void {\n  if (PRIORITY[level] < threshold) {\n    return;\n  }\n  const fn = CONSOLE_FN[level];\n  globalThis.console[fn](prefix, ...args);\n}\n\nexport function createLogger(scope: string): Logger {\n  const prefix = `[Interfere:${scope}]`;\n  return {\n    debug: (...args) => emit(\"debug\", prefix, args),\n    info: (...args) => emit(\"info\", prefix, args),\n    warn: (...args) => emit(\"warn\", prefix, args),\n    error: (...args) => emit(\"error\", prefix, args),\n  };\n}\n"],"mappings":";AAEA,MAAM,WAAqC;CACzC,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACP;AAED,MAAM,aAGF;CACF,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACR;AAED,IAAI,YAAY,SAAS;AAEzB,SAAgB,YAAY,OAAuB;AACjD,aAAY,SAAS;;AAGvB,SAAgB,cAAwB;AAEtC,QADc,OAAO,QAAQ,SAAS,CAAC,MAAM,GAAG,OAAO,MAAM,UAAU,GACvD,MAAM;;AAUxB,SAAS,KACP,OACA,QACA,MACM;AACN,KAAI,SAAS,SAAS,UACpB;CAEF,MAAM,KAAK,WAAW;AACtB,YAAW,QAAQ,IAAI,QAAQ,GAAG,KAAK;;AAGzC,SAAgB,aAAa,OAAuB;CAClD,MAAM,SAAS,cAAc,MAAM;AACnC,QAAO;EACL,QAAQ,GAAG,SAAS,KAAK,SAAS,QAAQ,KAAK;EAC/C,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,KAAK;EAC7C,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,KAAK;EAC7C,QAAQ,GAAG,SAAS,KAAK,SAAS,QAAQ,KAAK;EAChD"}