@interfere/react 0.1.0-alpha.6 → 0.2.0-alpha.2

package/dist/plugins/lib/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/plugins/lib/types.ts"],"mappings":";;;KAEY,aAAA;AAAA,UAEK,aAAA;EACf,OAAA,WAAkB,SAAA,EAAW,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,eAAA,CAAgB,CAAA;EAC/D,YAAA;AAAA;AAAA,UAGe,MAAA;EAAA,SACN,IAAA;EACT,KAAA,CAAM,GAAA,EAAK,aAAA,GAAgB,aAAA;AAAA"}

package/dist/plugins/lib/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/plugins/pages.d.mts

@@ -0,0 +1,6 @@
+import { Plugin } from "./lib/types.mjs";
+
+//#region src/plugins/pages.d.ts
+declare const pagesPlugin: Plugin;
+//#endregion
+export { pagesPlugin as default, pagesPlugin };

package/dist/plugins/pages.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.mts","names":[],"sources":["../../src/plugins/pages.ts"],"mappings":";;;cAmDa,WAAA,EAAa,MAAA"}

package/dist/plugins/pages.mjs

@@ -0,0 +1,102 @@
+//#region src/plugins/pages.ts
+const INTERACTIVE_TAGS = new Set([
+	"A",
+	"BUTTON",
+	"INPUT",
+	"SELECT",
+	"TEXTAREA"
+]);
+const INTERACTIVE_ROLES = new Set([
+	"button",
+	"link",
+	"tab",
+	"menuitem",
+	"checkbox",
+	"radio",
+	"switch"
+]);
+function isInteractive(el) {
+	if (INTERACTIVE_TAGS.has(el.tagName)) return true;
+	const role = el.getAttribute("role");
+	return role !== null && INTERACTIVE_ROLES.has(role);
+}
+function closestInteractive(target) {
+	if (!(target instanceof Element)) return null;
+	let el = target;
+	while (el) {
+		if (isInteractive(el)) return el;
+		el = el.parentElement;
+	}
+	return null;
+}
+function elementDescriptor(el) {
+	return {
+		tag: el.tagName.toLowerCase(),
+		text: el.textContent?.trim().slice(0, 120) ?? null,
+		...el.id && { id: el.id },
+		...el.getAttribute("role") && { role: el.getAttribute("role") },
+		...el instanceof HTMLAnchorElement && { href: el.href }
+	};
+}
+const pagesPlugin = {
+	name: "pages",
+	setup(ctx) {
+		let pageEnteredAt = Date.now();
+		let currentUrl = location.href;
+		const emitPageview = () => {
+			currentUrl = location.href;
+			pageEnteredAt = Date.now();
+			ctx.capture("pageview", {
+				url: currentUrl,
+				title: document.title || void 0
+			});
+		};
+		const emitPageleave = () => {
+			ctx.capture("pageleave", {
+				url: currentUrl,
+				durationMs: Date.now() - pageEnteredAt
+			});
+		};
+		const originalPushState = history.pushState;
+		const originalReplaceState = history.replaceState;
+		history.pushState = function(...args) {
+			emitPageleave();
+			originalPushState.apply(this, args);
+			emitPageview();
+		};
+		history.replaceState = function(...args) {
+			originalReplaceState.apply(this, args);
+			currentUrl = location.href;
+		};
+		const onPopState = () => {
+			emitPageleave();
+			emitPageview();
+		};
+		globalThis.addEventListener("popstate", onPopState);
+		const onBeforeUnload = () => {
+			emitPageleave();
+		};
+		globalThis.addEventListener("beforeunload", onBeforeUnload);
+		const onVisibilityChange = () => {
+			if (document.visibilityState === "hidden") emitPageleave();
+		};
+		globalThis.addEventListener("visibilitychange", onVisibilityChange);
+		const onClick = (event) => {
+			const el = closestInteractive(event.target);
+			if (!el) return;
+			ctx.capture("ui_event", { event: elementDescriptor(el) });
+		};
+		document.addEventListener("click", onClick, { capture: true });
+		emitPageview();
+		return () => {
+			history.pushState = originalPushState;
+			history.replaceState = originalReplaceState;
+			globalThis.removeEventListener("popstate", onPopState);
+			globalThis.removeEventListener("beforeunload", onBeforeUnload);
+			globalThis.removeEventListener("visibilitychange", onVisibilityChange);
+			document.removeEventListener("click", onClick, { capture: true });
+		};
+	}
+};
+//#endregion
+export { pagesPlugin as default, pagesPlugin };

package/dist/plugins/pages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.mjs","names":[],"sources":["../../src/plugins/pages.ts"],"sourcesContent":["import type { Plugin } from \"./lib/types.js\";\n\nconst INTERACTIVE_TAGS = new Set([\n  \"A\",\n  \"BUTTON\",\n  \"INPUT\",\n  \"SELECT\",\n  \"TEXTAREA\",\n]);\nconst INTERACTIVE_ROLES = new Set([\n  \"button\",\n  \"link\",\n  \"tab\",\n  \"menuitem\",\n  \"checkbox\",\n  \"radio\",\n  \"switch\",\n]);\n\nfunction isInteractive(el: Element): boolean {\n  if (INTERACTIVE_TAGS.has(el.tagName)) {\n    return true;\n  }\n  const role = el.getAttribute(\"role\");\n  return role !== null && INTERACTIVE_ROLES.has(role);\n}\n\nfunction closestInteractive(target: EventTarget | null): Element | null {\n  if (!(target instanceof Element)) {\n    return null;\n  }\n  let el: Element | null = target;\n  while (el) {\n    if (isInteractive(el)) {\n      return el;\n    }\n    el = el.parentElement;\n  }\n  return null;\n}\n\nfunction elementDescriptor(el: Element): Record<string, unknown> {\n  return {\n    tag: el.tagName.toLowerCase(),\n    text: el.textContent?.trim().slice(0, 120) ?? null,\n    ...(el.id && { id: el.id }),\n    ...(el.getAttribute(\"role\") && { role: el.getAttribute(\"role\") }),\n    ...(el instanceof HTMLAnchorElement && { href: el.href }),\n  };\n}\n\nexport const pagesPlugin: Plugin = {\n  name: \"pages\",\n\n  setup(ctx) {\n    let pageEnteredAt = Date.now();\n    let currentUrl = location.href;\n\n    const emitPageview = () => {\n      currentUrl = location.href;\n      pageEnteredAt = Date.now();\n      ctx.capture(\"pageview\", {\n        url: currentUrl,\n        title: document.title || undefined,\n      });\n    };\n\n    const emitPageleave = () => {\n      ctx.capture(\"pageleave\", {\n        url: currentUrl,\n        durationMs: Date.now() - pageEnteredAt,\n      });\n    };\n\n    // Patch history API for SPA navigation\n    const originalPushState = history.pushState;\n    const originalReplaceState = history.replaceState;\n\n    history.pushState = function (...args) {\n      emitPageleave();\n      originalPushState.apply(this, args);\n      emitPageview();\n    };\n\n    history.replaceState = function (...args) {\n      originalReplaceState.apply(this, args);\n      // replaceState doesn't create a new entry — update URL tracking but skip pageview\n      currentUrl = location.href;\n    };\n\n    const onPopState = () => {\n      emitPageleave();\n      emitPageview();\n    };\n    globalThis.addEventListener(\"popstate\", onPopState);\n\n    const onBeforeUnload = () => {\n      emitPageleave();\n    };\n    globalThis.addEventListener(\"beforeunload\", onBeforeUnload);\n\n    const onVisibilityChange = () => {\n      if (document.visibilityState === \"hidden\") {\n        emitPageleave();\n      }\n    };\n    globalThis.addEventListener(\"visibilitychange\", onVisibilityChange);\n\n    const onClick = (event: MouseEvent) => {\n      const el = closestInteractive(event.target);\n      if (!el) {\n        return;\n      }\n      ctx.capture(\"ui_event\", { event: elementDescriptor(el) });\n    };\n    document.addEventListener(\"click\", onClick, { capture: true });\n\n    // Initial pageview\n    emitPageview();\n\n    return () => {\n      history.pushState = originalPushState;\n      history.replaceState = originalReplaceState;\n      globalThis.removeEventListener(\"popstate\", onPopState);\n      globalThis.removeEventListener(\"beforeunload\", onBeforeUnload);\n      globalThis.removeEventListener(\"visibilitychange\", onVisibilityChange);\n      document.removeEventListener(\"click\", onClick, { capture: true });\n    };\n  },\n};\n\nexport default pagesPlugin;\n"],"mappings":";AAEA,MAAM,mBAAmB,IAAI,IAAI;CAC/B;CACA;CACA;CACA;CACA;CACD,CAAC;AACF,MAAM,oBAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAS,cAAc,IAAsB;AAC3C,KAAI,iBAAiB,IAAI,GAAG,QAAQ,CAClC,QAAO;CAET,MAAM,OAAO,GAAG,aAAa,OAAO;AACpC,QAAO,SAAS,QAAQ,kBAAkB,IAAI,KAAK;;AAGrD,SAAS,mBAAmB,QAA4C;AACtE,KAAI,EAAE,kBAAkB,SACtB,QAAO;CAET,IAAI,KAAqB;AACzB,QAAO,IAAI;AACT,MAAI,cAAc,GAAG,CACnB,QAAO;AAET,OAAK,GAAG;;AAEV,QAAO;;AAGT,SAAS,kBAAkB,IAAsC;AAC/D,QAAO;EACL,KAAK,GAAG,QAAQ,aAAa;EAC7B,MAAM,GAAG,aAAa,MAAM,CAAC,MAAM,GAAG,IAAI,IAAI;EAC9C,GAAI,GAAG,MAAM,EAAE,IAAI,GAAG,IAAI;EAC1B,GAAI,GAAG,aAAa,OAAO,IAAI,EAAE,MAAM,GAAG,aAAa,OAAO,EAAE;EAChE,GAAI,cAAc,qBAAqB,EAAE,MAAM,GAAG,MAAM;EACzD;;AAGH,MAAa,cAAsB;CACjC,MAAM;CAEN,MAAM,KAAK;EACT,IAAI,gBAAgB,KAAK,KAAK;EAC9B,IAAI,aAAa,SAAS;EAE1B,MAAM,qBAAqB;AACzB,gBAAa,SAAS;AACtB,mBAAgB,KAAK,KAAK;AAC1B,OAAI,QAAQ,YAAY;IACtB,KAAK;IACL,OAAO,SAAS,SAAS,KAAA;IAC1B,CAAC;;EAGJ,MAAM,sBAAsB;AAC1B,OAAI,QAAQ,aAAa;IACvB,KAAK;IACL,YAAY,KAAK,KAAK,GAAG;IAC1B,CAAC;;EAIJ,MAAM,oBAAoB,QAAQ;EAClC,MAAM,uBAAuB,QAAQ;AAErC,UAAQ,YAAY,SAAU,GAAG,MAAM;AACrC,kBAAe;AACf,qBAAkB,MAAM,MAAM,KAAK;AACnC,iBAAc;;AAGhB,UAAQ,eAAe,SAAU,GAAG,MAAM;AACxC,wBAAqB,MAAM,MAAM,KAAK;AAEtC,gBAAa,SAAS;;EAGxB,MAAM,mBAAmB;AACvB,kBAAe;AACf,iBAAc;;AAEhB,aAAW,iBAAiB,YAAY,WAAW;EAEnD,MAAM,uBAAuB;AAC3B,kBAAe;;AAEjB,aAAW,iBAAiB,gBAAgB,eAAe;EAE3D,MAAM,2BAA2B;AAC/B,OAAI,SAAS,oBAAoB,SAC/B,gBAAe;;AAGnB,aAAW,iBAAiB,oBAAoB,mBAAmB;EAEnE,MAAM,WAAW,UAAsB;GACrC,MAAM,KAAK,mBAAmB,MAAM,OAAO;AAC3C,OAAI,CAAC,GACH;AAEF,OAAI,QAAQ,YAAY,EAAE,OAAO,kBAAkB,GAAG,EAAE,CAAC;;AAE3D,WAAS,iBAAiB,SAAS,SAAS,EAAE,SAAS,MAAM,CAAC;AAG9D,gBAAc;AAEd,eAAa;AACX,WAAQ,YAAY;AACpB,WAAQ,eAAe;AACvB,cAAW,oBAAoB,YAAY,WAAW;AACtD,cAAW,oBAAoB,gBAAgB,eAAe;AAC9D,cAAW,oBAAoB,oBAAoB,mBAAmB;AACtE,YAAS,oBAAoB,SAAS,SAAS,EAAE,SAAS,MAAM,CAAC;;;CAGtE"}

package/dist/plugins/rage-clicks.d.mts

@@ -0,0 +1,6 @@
+import { Plugin } from "./lib/types.mjs";
+
+//#region src/plugins/rage-clicks.d.ts
+declare const rageClicksPlugin: Plugin;
+//#endregion
+export { rageClicksPlugin as default, rageClicksPlugin };

package/dist/plugins/rage-clicks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rage-clicks.d.mts","names":[],"sources":["../../src/plugins/rage-clicks.ts"],"mappings":";;;cA6Ba,gBAAA,EAAkB,MAAA"}

package/dist/plugins/rage-clicks.mjs

@@ -0,0 +1,53 @@
+//#region src/plugins/rage-clicks.ts
+const CLICK_THRESHOLD = 3;
+const TIME_WINDOW_MS = 800;
+const PROXIMITY_PX = 30;
+function distance(a, b) {
+	return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
+}
+function selectorFor(el) {
+	if (!el) return "unknown";
+	if (el.id) return `#${el.id}`;
+	const classes = [...el.classList].slice(0, 3).join(".");
+	const tag = el.tagName.toLowerCase();
+	return classes ? `${tag}.${classes}` : tag;
+}
+const rageClicksPlugin = {
+	name: "rage-clicks",
+	setup(ctx) {
+		const clicks = [];
+		const onClick = (event) => {
+			const now = Date.now();
+			clicks.push({
+				x: event.clientX,
+				y: event.clientY,
+				ts: now,
+				target: event.target instanceof Element ? event.target : null
+			});
+			while (clicks.length > 0 && now - (clicks[0]?.ts ?? 0) > TIME_WINDOW_MS) clicks.shift();
+			if (clicks.length < CLICK_THRESHOLD) return;
+			const anchor = clicks[0];
+			if (!anchor) return;
+			const clustered = clicks.filter((c) => distance(anchor, c) <= PROXIMITY_PX);
+			if (clustered.length < CLICK_THRESHOLD) return;
+			const last = clustered.at(-1);
+			if (!last) return;
+			ctx.capture("rage_click", {
+				count: clustered.length,
+				timeWindow: last.ts - anchor.ts,
+				selector: selectorFor(last.target),
+				text: last.target?.textContent?.trim().slice(0, 120) ?? "",
+				x: last.x,
+				y: last.y,
+				timestamp: now
+			});
+			clicks.length = 0;
+		};
+		document.addEventListener("click", onClick, { capture: true });
+		return () => {
+			document.removeEventListener("click", onClick, { capture: true });
+		};
+	}
+};
+//#endregion
+export { rageClicksPlugin as default, rageClicksPlugin };

package/dist/plugins/rage-clicks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rage-clicks.mjs","names":[],"sources":["../../src/plugins/rage-clicks.ts"],"sourcesContent":["import type { Plugin } from \"./lib/types.js\";\n\nconst CLICK_THRESHOLD = 3;\nconst TIME_WINDOW_MS = 800;\nconst PROXIMITY_PX = 30;\n\ninterface Click {\n  target: Element | null;\n  ts: number;\n  x: number;\n  y: number;\n}\n\nfunction distance(a: Click, b: Click): number {\n  return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);\n}\n\nfunction selectorFor(el: Element | null): string {\n  if (!el) {\n    return \"unknown\";\n  }\n  if (el.id) {\n    return `#${el.id}`;\n  }\n  const classes = [...el.classList].slice(0, 3).join(\".\");\n  const tag = el.tagName.toLowerCase();\n  return classes ? `${tag}.${classes}` : tag;\n}\n\nexport const rageClicksPlugin: Plugin = {\n  name: \"rage-clicks\",\n\n  setup(ctx) {\n    const clicks: Click[] = [];\n\n    const onClick = (event: MouseEvent) => {\n      const now = Date.now();\n      clicks.push({\n        x: event.clientX,\n        y: event.clientY,\n        ts: now,\n        target: event.target instanceof Element ? event.target : null,\n      });\n\n      // Prune stale clicks\n      while (clicks.length > 0 && now - (clicks[0]?.ts ?? 0) > TIME_WINDOW_MS) {\n        clicks.shift();\n      }\n\n      if (clicks.length < CLICK_THRESHOLD) {\n        return;\n      }\n\n      // Check proximity — all clicks within PROXIMITY_PX of the first\n      const anchor = clicks[0];\n      if (!anchor) {\n        return;\n      }\n      const clustered = clicks.filter(\n        (c) => distance(anchor, c) <= PROXIMITY_PX\n      );\n      if (clustered.length < CLICK_THRESHOLD) {\n        return;\n      }\n\n      const last = clustered.at(-1);\n      if (!last) {\n        return;\n      }\n      ctx.capture(\"rage_click\", {\n        count: clustered.length,\n        timeWindow: last.ts - anchor.ts,\n        selector: selectorFor(last.target),\n        text: last.target?.textContent?.trim().slice(0, 120) ?? \"\",\n        x: last.x,\n        y: last.y,\n        timestamp: now,\n      });\n\n      clicks.length = 0;\n    };\n\n    document.addEventListener(\"click\", onClick, { capture: true });\n\n    return () => {\n      document.removeEventListener(\"click\", onClick, { capture: true });\n    };\n  },\n};\n\nexport default rageClicksPlugin;\n"],"mappings":";AAEA,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;AACvB,MAAM,eAAe;AASrB,SAAS,SAAS,GAAU,GAAkB;AAC5C,QAAO,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;;AAGvD,SAAS,YAAY,IAA4B;AAC/C,KAAI,CAAC,GACH,QAAO;AAET,KAAI,GAAG,GACL,QAAO,IAAI,GAAG;CAEhB,MAAM,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI;CACvD,MAAM,MAAM,GAAG,QAAQ,aAAa;AACpC,QAAO,UAAU,GAAG,IAAI,GAAG,YAAY;;AAGzC,MAAa,mBAA2B;CACtC,MAAM;CAEN,MAAM,KAAK;EACT,MAAM,SAAkB,EAAE;EAE1B,MAAM,WAAW,UAAsB;GACrC,MAAM,MAAM,KAAK,KAAK;AACtB,UAAO,KAAK;IACV,GAAG,MAAM;IACT,GAAG,MAAM;IACT,IAAI;IACJ,QAAQ,MAAM,kBAAkB,UAAU,MAAM,SAAS;IAC1D,CAAC;AAGF,UAAO,OAAO,SAAS,KAAK,OAAO,OAAO,IAAI,MAAM,KAAK,eACvD,QAAO,OAAO;AAGhB,OAAI,OAAO,SAAS,gBAClB;GAIF,MAAM,SAAS,OAAO;AACtB,OAAI,CAAC,OACH;GAEF,MAAM,YAAY,OAAO,QACtB,MAAM,SAAS,QAAQ,EAAE,IAAI,aAC/B;AACD,OAAI,UAAU,SAAS,gBACrB;GAGF,MAAM,OAAO,UAAU,GAAG,GAAG;AAC7B,OAAI,CAAC,KACH;AAEF,OAAI,QAAQ,cAAc;IACxB,OAAO,UAAU;IACjB,YAAY,KAAK,KAAK,OAAO;IAC7B,UAAU,YAAY,KAAK,OAAO;IAClC,MAAM,KAAK,QAAQ,aAAa,MAAM,CAAC,MAAM,GAAG,IAAI,IAAI;IACxD,GAAG,KAAK;IACR,GAAG,KAAK;IACR,WAAW;IACZ,CAAC;AAEF,UAAO,SAAS;;AAGlB,WAAS,iBAAiB,SAAS,SAAS,EAAE,SAAS,MAAM,CAAC;AAE9D,eAAa;AACX,YAAS,oBAAoB,SAAS,SAAS,EAAE,SAAS,MAAM,CAAC;;;CAGtE"}

package/dist/plugins/replay.d.mts

@@ -0,0 +1,6 @@
+import { Plugin } from "./lib/types.mjs";
+
+//#region src/plugins/replay.d.ts
+declare const replayPlugin: Plugin;
+//#endregion
+export { replayPlugin as default, replayPlugin };

package/dist/plugins/replay.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.mts","names":[],"sources":["../../src/plugins/replay.ts"],"mappings":";;;cAOa,YAAA,EAAc,MAAA"}

package/dist/plugins/replay.mjs

@@ -0,0 +1,62 @@
+import { createLogger } from "../util/log.mjs";
+//#region src/plugins/replay.ts
+const log = createLogger("replay");
+const FLUSH_INTERVAL_MS = 1e4;
+const replayPlugin = {
+	name: "replay",
+	setup(ctx) {
+		let stopFn = null;
+		let events = [];
+		let flushTimer = null;
+		let firstTs = null;
+		let lastTs = null;
+		const flush = () => {
+			if (events.length === 0) return;
+			const chunk = events;
+			events = [];
+			const fts = firstTs;
+			const lts = lastTs;
+			firstTs = null;
+			lastTs = null;
+			ctx.capture("replay_chunk", {
+				ts: Date.now(),
+				count: chunk.length,
+				events: chunk,
+				...fts !== null && { first_event_ts: fts },
+				...lts !== null && { last_event_ts: lts }
+			});
+		};
+		const onVisibilityChange = () => {
+			if (document.visibilityState === "hidden") flush();
+		};
+		const onBeforeUnload = () => {
+			flush();
+		};
+		const init = async () => {
+			try {
+				stopFn = (await import("rrweb")).record({ emit(event) {
+					const ts = Date.now();
+					if (firstTs === null) firstTs = ts;
+					lastTs = ts;
+					events.push(JSON.stringify(event));
+				} }) ?? null;
+				flushTimer = setInterval(flush, FLUSH_INTERVAL_MS);
+				globalThis.addEventListener("visibilitychange", onVisibilityChange);
+				globalThis.addEventListener("beforeunload", onBeforeUnload);
+				log.debug("recording started");
+			} catch {
+				log.error("rrweb failed to load, replay disabled");
+			}
+		};
+		init().catch(() => {});
+		return () => {
+			flush();
+			stopFn?.();
+			if (flushTimer) clearInterval(flushTimer);
+			globalThis.removeEventListener("visibilitychange", onVisibilityChange);
+			globalThis.removeEventListener("beforeunload", onBeforeUnload);
+		};
+	}
+};
+//#endregion
+export { replayPlugin as default, replayPlugin };

package/dist/plugins/replay.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.mjs","names":[],"sources":["../../src/plugins/replay.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\nimport type { Plugin } from \"./lib/types.js\";\n\nconst log = createLogger(\"replay\");\n\nconst FLUSH_INTERVAL_MS = 10_000;\n\nexport const replayPlugin: Plugin = {\n  name: \"replay\",\n\n  setup(ctx) {\n    let stopFn: (() => void) | null = null;\n    let events: string[] = [];\n    let flushTimer: ReturnType<typeof setInterval> | null = null;\n    let firstTs: number | null = null;\n    let lastTs: number | null = null;\n\n    const flush = () => {\n      if (events.length === 0) {\n        return;\n      }\n      const chunk = events;\n      events = [];\n      const fts = firstTs;\n      const lts = lastTs;\n      firstTs = null;\n      lastTs = null;\n\n      ctx.capture(\"replay_chunk\", {\n        ts: Date.now(),\n        count: chunk.length,\n        events: chunk,\n        ...(fts !== null && { first_event_ts: fts }),\n        ...(lts !== null && { last_event_ts: lts }),\n      });\n    };\n\n    const onVisibilityChange = () => {\n      if (document.visibilityState === \"hidden\") {\n        flush();\n      }\n    };\n    const onBeforeUnload = () => {\n      flush();\n    };\n\n    const init = async () => {\n      try {\n        const rrweb = await import(\"rrweb\");\n        stopFn =\n          rrweb.record({\n            emit(event) {\n              const ts = Date.now();\n              if (firstTs === null) {\n                firstTs = ts;\n              }\n              lastTs = ts;\n              events.push(JSON.stringify(event));\n            },\n          }) ?? null;\n\n        flushTimer = setInterval(flush, FLUSH_INTERVAL_MS);\n        globalThis.addEventListener(\"visibilitychange\", onVisibilityChange);\n        globalThis.addEventListener(\"beforeunload\", onBeforeUnload);\n        log.debug(\"recording started\");\n      } catch {\n        log.error(\"rrweb failed to load, replay disabled\");\n      }\n    };\n\n    init().catch(() => {\n      // rrweb load failure is non-fatal\n    });\n\n    return () => {\n      flush();\n      stopFn?.();\n      if (flushTimer) {\n        clearInterval(flushTimer);\n      }\n      globalThis.removeEventListener(\"visibilitychange\", onVisibilityChange);\n      globalThis.removeEventListener(\"beforeunload\", onBeforeUnload);\n    };\n  },\n};\n\nexport default replayPlugin;\n"],"mappings":";;AAGA,MAAM,MAAM,aAAa,SAAS;AAElC,MAAM,oBAAoB;AAE1B,MAAa,eAAuB;CAClC,MAAM;CAEN,MAAM,KAAK;EACT,IAAI,SAA8B;EAClC,IAAI,SAAmB,EAAE;EACzB,IAAI,aAAoD;EACxD,IAAI,UAAyB;EAC7B,IAAI,SAAwB;EAE5B,MAAM,cAAc;AAClB,OAAI,OAAO,WAAW,EACpB;GAEF,MAAM,QAAQ;AACd,YAAS,EAAE;GACX,MAAM,MAAM;GACZ,MAAM,MAAM;AACZ,aAAU;AACV,YAAS;AAET,OAAI,QAAQ,gBAAgB;IAC1B,IAAI,KAAK,KAAK;IACd,OAAO,MAAM;IACb,QAAQ;IACR,GAAI,QAAQ,QAAQ,EAAE,gBAAgB,KAAK;IAC3C,GAAI,QAAQ,QAAQ,EAAE,eAAe,KAAK;IAC3C,CAAC;;EAGJ,MAAM,2BAA2B;AAC/B,OAAI,SAAS,oBAAoB,SAC/B,QAAO;;EAGX,MAAM,uBAAuB;AAC3B,UAAO;;EAGT,MAAM,OAAO,YAAY;AACvB,OAAI;AAEF,cADc,MAAM,OAAO,UAEnB,OAAO,EACX,KAAK,OAAO;KACV,MAAM,KAAK,KAAK,KAAK;AACrB,SAAI,YAAY,KACd,WAAU;AAEZ,cAAS;AACT,YAAO,KAAK,KAAK,UAAU,MAAM,CAAC;OAErC,CAAC,IAAI;AAER,iBAAa,YAAY,OAAO,kBAAkB;AAClD,eAAW,iBAAiB,oBAAoB,mBAAmB;AACnE,eAAW,iBAAiB,gBAAgB,eAAe;AAC3D,QAAI,MAAM,oBAAoB;WACxB;AACN,QAAI,MAAM,wCAAwC;;;AAItD,QAAM,CAAC,YAAY,GAEjB;AAEF,eAAa;AACX,UAAO;AACP,aAAU;AACV,OAAI,WACF,eAAc,WAAW;AAE3B,cAAW,oBAAoB,oBAAoB,mBAAmB;AACtE,cAAW,oBAAoB,gBAAgB,eAAe;;;CAGnE"}

package/dist/provider.d.mts

@@ -1,17 +1,23 @@
-import { InterfereProviderValue, Plugin } from "./core/schemas.mjs";
-import { Config } from "@interfere/types/sdk/config";
 import { PropsWithChildren, ReactNode } from "react";
+import { EnvelopePayload, EventType } from "@interfere/types/sdk/envelope";
+import { IdentifyParams } from "@interfere/types/sdk/identify";
 
 //#region src/provider.d.ts
-interface InterfereProviderProps extends PropsWithChildren {
-  config: Config;
-  plugins?: readonly Plugin[];
+interface InterfereContextValue {
+  capture<T extends EventType>(type: T, payload: EnvelopePayload<T>): void;
+  identity: {
+    get(): IdentifyParams | null;
+    set(params: IdentifyParams): void;
+  };
+  session: {
+    getId(): string | null;
+    getWindowId(): string | null;
+  };
 }
 declare function InterfereProvider({
-  children,
-  config,
-  plugins
-}: InterfereProviderProps): ReactNode;
-declare function useInterfere(): InterfereProviderValue;
+  children
+}: PropsWithChildren): ReactNode;
+declare function useInterfere(): InterfereContextValue;
+declare function useSession(): string | null;
 //#endregion
-export { InterfereProvider, InterfereProviderProps, useInterfere };
+export { InterfereProvider, useInterfere, useSession };

package/dist/provider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"mappings":";;;;;UAwBiB,sBAAA,SAA+B,iBAAA;EAC9C,MAAA,EAAQ,MAAA;EACR,OAAA,YAAmB,MAAA;AAAA;AAAA,iBAGL,iBAAA,CAAA;EACd,QAAA;EACA,MAAA;EACA;AAAA,GACC,sBAAA,GAAyB,SAAA;AAAA,iBAkBZ,YAAA,CAAA,GAAgB,sBAAA"}
+{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"mappings":";;;;;UAeU,qBAAA;EACR,OAAA,WAAkB,SAAA,EAAW,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,eAAA,CAAgB,CAAA;EAC/D,QAAA;IACE,GAAA,IAAO,cAAA;IACP,GAAA,CAAI,MAAA,EAAQ,cAAA;EAAA;EAEd,OAAA;IACE,KAAA;IACA,WAAA;EAAA;AAAA;AAAA,iBAMY,iBAAA,CAAA;EAAoB;AAAA,GAAY,iBAAA,GAAoB,SAAA;AAAA,iBAUpD,YAAA,CAAA,GAAgB,qBAAA;AAAA,iBAQhB,UAAA,CAAA"}

package/dist/provider.mjs

@@ -1,26 +1,27 @@
 "use client";
-
-import { capture } from "./client.mjs";
-import { useRuntimeAndPlugins } from "./hooks/use-runtime-and-plugins.mjs";
-import { createContext, useContext, useMemo } from "react";
+import { identity, session } from "./tracking/api.mjs";
+import { capture } from "./internal/client.mjs";
+import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-
 //#region src/provider.tsx
-const InterfereContext = createContext({ capture });
-function InterfereProvider({ children, config, plugins }) {
-	const pluginApis = useRuntimeAndPlugins(config, plugins);
-	const contextValue = useMemo(() => ({
-		capture,
-		...pluginApis
-	}), [pluginApis]);
-	return /* @__PURE__ */ jsx(InterfereContext.Provider, {
-		value: contextValue,
+const InterfereContext = createContext(null);
+function InterfereProvider({ children }) {
+	return /* @__PURE__ */ jsx(InterfereContext, {
+		value: {
+			capture,
+			identity,
+			session
+		},
 		children
 	});
 }
 function useInterfere() {
-	return useContext(InterfereContext);
+	const ctx = useContext(InterfereContext);
+	if (!ctx) throw new Error("useInterfere must be used within <InterfereProvider>");
+	return ctx;
+}
+function useSession() {
+	return useInterfere().session.getId();
 }
-
 //#endregion
-export { InterfereProvider, useInterfere };
+export { InterfereProvider, useInterfere, useSession };

package/dist/provider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"provider.mjs","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { Config } from \"@interfere/types/sdk/config\";\n\nimport {\n  createContext,\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n  useMemo,\n} from \"react\";\n\nimport { capture } from \"./client.js\";\nimport type { InterfereProviderValue, Plugin } from \"./core/schemas.js\";\nimport { useRuntimeAndPlugins } from \"./hooks/use-runtime-and-plugins.js\";\n\nconst interfereContextDefaultValue: InterfereProviderValue = {\n  capture,\n};\n\nconst InterfereContext = createContext<InterfereProviderValue>(\n  interfereContextDefaultValue\n);\n\nexport interface InterfereProviderProps extends PropsWithChildren {\n  config: Config;\n  plugins?: readonly Plugin[];\n}\n\nexport function InterfereProvider({\n  children,\n  config,\n  plugins,\n}: InterfereProviderProps): ReactNode {\n  const pluginApis = useRuntimeAndPlugins(config, plugins);\n\n  const contextValue = useMemo(\n    () => ({\n      capture,\n      ...pluginApis,\n    }),\n    [pluginApis]\n  );\n\n  return (\n    <InterfereContext.Provider value={contextValue}>\n      {children}\n    </InterfereContext.Provider>\n  );\n}\n\nexport function useInterfere(): InterfereProviderValue {\n  const context = useContext(InterfereContext);\n\n  return context;\n}\n"],"mappings":";;;;;;;;AAoBA,MAAM,mBAAmB,cAJoC,EAC3D,SACD,CAIA;AAOD,SAAgB,kBAAkB,EAChC,UACA,QACA,WACoC;CACpC,MAAM,aAAa,qBAAqB,QAAQ,QAAQ;CAExD,MAAM,eAAe,eACZ;EACL;EACA,GAAG;EACJ,GACD,CAAC,WAAW,CACb;AAED,QACE,oBAAC,iBAAiB;EAAS,OAAO;EAC/B;GACyB;;AAIhC,SAAgB,eAAuC;AAGrD,QAFgB,WAAW,iBAAiB"}
+{"version":3,"file":"provider.mjs","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { EnvelopePayload, EventType } from \"@interfere/types/sdk/envelope\";\nimport type { IdentifyParams } from \"@interfere/types/sdk/identify\";\n\nimport {\n  createContext,\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n} from \"react\";\n\nimport { capture } from \"./internal/client.js\";\nimport { identity, session } from \"./tracking/api.js\";\n\ninterface InterfereContextValue {\n  capture<T extends EventType>(type: T, payload: EnvelopePayload<T>): void;\n  identity: {\n    get(): IdentifyParams | null;\n    set(params: IdentifyParams): void;\n  };\n  session: {\n    getId(): string | null;\n    getWindowId(): string | null;\n  };\n}\n\nconst InterfereContext = createContext<InterfereContextValue | null>(null);\n\nexport function InterfereProvider({ children }: PropsWithChildren): ReactNode {\n  const value: InterfereContextValue = {\n    capture,\n    identity,\n    session,\n  };\n\n  return <InterfereContext value={value}>{children}</InterfereContext>;\n}\n\nexport function useInterfere(): InterfereContextValue {\n  const ctx = useContext(InterfereContext);\n  if (!ctx) {\n    throw new Error(\"useInterfere must be used within <InterfereProvider>\");\n  }\n  return ctx;\n}\n\nexport function useSession(): string | null {\n  return useInterfere().session.getId();\n}\n"],"mappings":";;;;;;AA2BA,MAAM,mBAAmB,cAA4C,KAAK;AAE1E,SAAgB,kBAAkB,EAAE,YAA0C;AAO5E,QAAO,oBAAC,kBAAD;EAAkB,OANY;GACnC;GACA;GACA;GACD;EAEuC;EAA4B,CAAA;;AAGtE,SAAgB,eAAsC;CACpD,MAAM,MAAM,WAAW,iBAAiB;AACxC,KAAI,CAAC,IACH,OAAM,IAAI,MAAM,uDAAuD;AAEzE,QAAO;;AAGT,SAAgB,aAA4B;AAC1C,QAAO,cAAc,CAAC,QAAQ,OAAO"}

package/dist/tracking/api.d.mts

@@ -0,0 +1,22 @@
+import { PluginOverrides } from "../plugins/lib/loader.mjs";
+import { IngestTarget } from "../transport/http.mjs";
+import { IdentifyParams } from "@interfere/types/sdk/identify";
+
+//#region src/tracking/api.d.ts
+/**
+ * Bootstraps the tracking subsystem: creates the session manager,
+ * resolves the session target, and optionally starts Fingerprint Pro.
+ */
+declare function bootstrap(sessionTarget: IngestTarget, plugins?: PluginOverrides): void;
+declare const session: {
+  getId(): string | null;
+  getWindowId(): string | null;
+};
+declare const identity: {
+  get(): IdentifyParams | null;
+  set(params: IdentifyParams): void;
+  clear(): void;
+};
+declare function teardown(): void;
+//#endregion
+export { bootstrap, identity, session, teardown };

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.mts","names":[],"sources":["../../src/tracking/api.ts"],"mappings":";;;;;;;AA4DA;;iBAAgB,SAAA,CACd,aAAA,EAAe,YAAA,EACf,OAAA,GAAU,eAAA;AAAA,cAgBC,OAAA;EAQZ,KAAA;EAAA,WAAA;AAAA;AAAA,cAEY,QAAA;SACJ,cAAA;cAIK,cAAA;;;iBA4BE,QAAA,CAAA"}

package/dist/tracking/api.mjs

@@ -0,0 +1,88 @@
+import { createLogger } from "../util/log.mjs";
+import { resolveFeatures } from "../plugins/lib/loader.mjs";
+import { SessionManager } from "./session.mjs";
+import { getVisitorId, initVisitor, whenVisitorReady } from "./visitor.mjs";
+import { make } from "tctx/traceparent";
+//#region src/tracking/api.ts
+const log = createLogger("tracking");
+let mgr = null;
+let target = null;
+let currentIdentity = null;
+let identifiedSessionId = null;
+function fire(url, method, headers, body) {
+	const h = Object.fromEntries(headers.entries());
+	h.traceparent = String(make());
+	const sid = mgr?.getSessionId();
+	if (sid) h["x-interfere-session"] = sid;
+	const vid = getVisitorId();
+	if (vid) h["x-interfere-visitor"] = vid;
+	fetch(url, {
+		method,
+		headers: h,
+		body: JSON.stringify(body),
+		keepalive: true
+	}).catch(() => {
+		log.warn("fire-and-forget %s failed", method);
+	});
+}
+async function onRotate(sessionId) {
+	if (!target) return;
+	const visitorId = await whenVisitorReady();
+	log.debug("POST session %s (visitor=%s)", sessionId, visitorId ?? "pending");
+	fire(target.url, "POST", target.headers, {
+		sessionId,
+		visitorId
+	});
+}
+/**
+* Bootstraps the tracking subsystem: creates the session manager,
+* resolves the session target, and optionally starts Fingerprint Pro.
+*/
+function bootstrap(sessionTarget, plugins) {
+	target = sessionTarget;
+	if (resolveFeatures(plugins).fingerprint) initVisitor();
+	mgr = new SessionManager((id) => {
+		onRotate(id).catch(() => {});
+	});
+}
+const session = {
+	getId() {
+		return mgr?.getSessionId() ?? null;
+	},
+	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 visitorId = getVisitorId();
+		log.info("PUT session %s → user %s", sessionId, params.identifier);
+		fire(target.url, "PUT", target.headers, {
+			sessionId,
+			visitorId,
+			...params
+		});
+	},
+	clear() {
+		currentIdentity = null;
+		identifiedSessionId = null;
+	}
+};
+function teardown() {
+	identity.clear();
+	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 { make } from \"tctx/traceparent\";\n\nimport type { PluginOverrides } from \"../plugins/lib/loader.js\";\nimport { resolveFeatures } from \"../plugins/lib/loader.js\";\nimport type { IngestTarget } from \"../transport/http.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { SessionManager } from \"./session.js\";\nimport { getVisitorId, initVisitor, whenVisitorReady } from \"./visitor.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\nfunction fire(\n  url: string,\n  method: \"POST\" | \"PUT\",\n  headers: Headers,\n  body: unknown\n): void {\n  const h: Record<string, string> = Object.fromEntries(headers.entries());\n  h.traceparent = String(make());\n\n  const sid = mgr?.getSessionId();\n  if (sid) {\n    h[\"x-interfere-session\"] = sid;\n  }\n\n  const vid = getVisitorId();\n  if (vid) {\n    h[\"x-interfere-visitor\"] = vid;\n  }\n\n  fetch(url, {\n    method,\n    headers: h,\n    body: JSON.stringify(body),\n    keepalive: true,\n  }).catch(() => {\n    log.warn(\"fire-and-forget %s failed\", method);\n  });\n}\n\nasync function onRotate(sessionId: string): Promise<void> {\n  if (!target) {\n    return;\n  }\n  const visitorId = await whenVisitorReady();\n  log.debug(\"POST session %s (visitor=%s)\", sessionId, visitorId ?? \"pending\");\n  fire(target.url, \"POST\", target.headers, { sessionId, visitorId });\n}\n\n/**\n * Bootstraps the tracking subsystem: creates the session manager,\n * resolves the session target, and optionally starts Fingerprint Pro.\n */\nexport function bootstrap(\n  sessionTarget: IngestTarget,\n  plugins?: PluginOverrides\n): void {\n  target = sessionTarget;\n\n  const features = resolveFeatures(plugins);\n  if (features.fingerprint) {\n    initVisitor();\n  }\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    return mgr?.getSessionId() ?? null;\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 visitorId = getVisitorId();\n    log.info(\"PUT session %s → user %s\", sessionId, params.identifier);\n    fire(target.url, \"PUT\", target.headers, {\n      sessionId,\n      visitorId,\n      ...params,\n    });\n  },\n\n  clear(): void {\n    currentIdentity = null;\n    identifiedSessionId = null;\n  },\n};\n\nexport function teardown(): void {\n  identity.clear();\n  mgr = null;\n  target = null;\n}\n"],"mappings":";;;;;;AAWA,MAAM,MAAM,aAAa,WAAW;AAEpC,IAAI,MAA6B;AACjC,IAAI,SAA8B;AAClC,IAAI,kBAAyC;AAC7C,IAAI,sBAAqC;AAEzC,SAAS,KACP,KACA,QACA,SACA,MACM;CACN,MAAM,IAA4B,OAAO,YAAY,QAAQ,SAAS,CAAC;AACvE,GAAE,cAAc,OAAO,MAAM,CAAC;CAE9B,MAAM,MAAM,KAAK,cAAc;AAC/B,KAAI,IACF,GAAE,yBAAyB;CAG7B,MAAM,MAAM,cAAc;AAC1B,KAAI,IACF,GAAE,yBAAyB;AAG7B,OAAM,KAAK;EACT;EACA,SAAS;EACT,MAAM,KAAK,UAAU,KAAK;EAC1B,WAAW;EACZ,CAAC,CAAC,YAAY;AACb,MAAI,KAAK,6BAA6B,OAAO;GAC7C;;AAGJ,eAAe,SAAS,WAAkC;AACxD,KAAI,CAAC,OACH;CAEF,MAAM,YAAY,MAAM,kBAAkB;AAC1C,KAAI,MAAM,gCAAgC,WAAW,aAAa,UAAU;AAC5E,MAAK,OAAO,KAAK,QAAQ,OAAO,SAAS;EAAE;EAAW;EAAW,CAAC;;;;;;AAOpE,SAAgB,UACd,eACA,SACM;AACN,UAAS;AAGT,KADiB,gBAAgB,QAAQ,CAC5B,YACX,cAAa;AAGf,OAAM,IAAI,gBAAgB,OAAO;AAC/B,WAAS,GAAG,CAAC,YAAY,GAEvB;GACF;;AAGJ,MAAa,UAAU;CACrB,QAAuB;AACrB,SAAO,KAAK,cAAc,IAAI;;CAGhC,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,YAAY,cAAc;AAChC,MAAI,KAAK,4BAA4B,WAAW,OAAO,WAAW;AAClE,OAAK,OAAO,KAAK,OAAO,OAAO,SAAS;GACtC;GACA;GACA,GAAG;GACJ,CAAC;;CAGJ,QAAc;AACZ,oBAAkB;AAClB,wBAAsB;;CAEzB;AAED,SAAgB,WAAiB;AAC/B,UAAS,OAAO;AAChB,OAAM;AACN,UAAS"}

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;
+  constructor(onRotate?: OnRotate);
+  getSessionId(): string;
+  getWindowId(): string;
+  whenReady(signal?: AbortSignal): Promise<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":";KAqBY,QAAA,IAAY,SAAA;AAAA,cAEX,cAAA;EACX,SAAA;EACA,QAAA;EAAA,iBACiB,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,QAAA;cAEL,QAAA,GAAW,QAAA;EAOvB,YAAA,CAAA;EAQA,WAAA,CAAA;EAgBA,SAAA,CAAU,MAAA,GAAS,WAAA,GAAc,OAAA;EAAA,QAsBzB,OAAA;EAAA,QAWA,MAAA;EAAA,QAQA,KAAA;EAAA,QAIA,SAAA;AAAA"}

package/dist/tracking/session.mjs

@@ -0,0 +1,92 @@
+import { nanoid } from "nanoid";
+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;
+const POLL_INTERVAL_MS = 250;
+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;
+	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_${nanoid(10)}`;
+		this.session?.setItem(WINDOW_ID_KEY, this.windowId);
+		return this.windowId;
+	}
+	whenReady(signal) {
+		const id = this.sessionId;
+		if (id && !this.isExpired()) return Promise.resolve(id);
+		return new Promise((resolve, reject) => {
+			const check = setInterval(() => {
+				if (signal?.aborted) {
+					clearInterval(check);
+					reject(signal.reason);
+					return;
+				}
+				const current = this.getSessionId();
+				if (current) {
+					clearInterval(check);
+					resolve(current);
+				}
+			}, POLL_INTERVAL_MS);
+		});
+	}
+	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.local?.setItem(LAST_ACTIVITY_KEY, String(Date.now()));
+	}
+	isExpired() {
+		const raw = this.local?.getItem(LAST_ACTIVITY_KEY);
+		if (!raw) return true;
+		return Date.now() - Number(raw) > 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 { nanoid } from \"nanoid\";\nimport { 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; // 30 minutes\nconst POLL_INTERVAL_MS = 250;\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\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_${nanoid(10)}`;\n    this.session?.setItem(WINDOW_ID_KEY, this.windowId);\n    return this.windowId;\n  }\n\n  whenReady(signal?: AbortSignal): Promise<string> {\n    const id = this.sessionId;\n    if (id && !this.isExpired()) {\n      return Promise.resolve(id);\n    }\n\n    return new Promise((resolve, reject) => {\n      const check = setInterval(() => {\n        if (signal?.aborted) {\n          clearInterval(check);\n          reject(signal.reason as Error);\n          return;\n        }\n        const current = this.getSessionId();\n        if (current) {\n          clearInterval(check);\n          resolve(current);\n        }\n      }, POLL_INTERVAL_MS);\n    });\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.local?.setItem(LAST_ACTIVITY_KEY, String(Date.now()));\n  }\n\n  private isExpired(): boolean {\n    const raw = this.local?.getItem(LAST_ACTIVITY_KEY);\n\n    if (!raw) {\n      return true;\n    }\n    return Date.now() - Number(raw) > SESSION_TIMEOUT_MS;\n  }\n}\n"],"mappings":";;;AAGA,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,OAAU;AACrC,MAAM,mBAAmB;AAEzB,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;CAE7C,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,GAAG;AACjC,OAAK,SAAS,QAAQ,eAAe,KAAK,SAAS;AACnD,SAAO,KAAK;;CAGd,UAAU,QAAuC;EAC/C,MAAM,KAAK,KAAK;AAChB,MAAI,MAAM,CAAC,KAAK,WAAW,CACzB,QAAO,QAAQ,QAAQ,GAAG;AAG5B,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,QAAQ,kBAAkB;AAC9B,QAAI,QAAQ,SAAS;AACnB,mBAAc,MAAM;AACpB,YAAO,OAAO,OAAgB;AAC9B;;IAEF,MAAM,UAAU,KAAK,cAAc;AACnC,QAAI,SAAS;AACX,mBAAc,MAAM;AACpB,aAAQ,QAAQ;;MAEjB,iBAAiB;IACpB;;CAGJ,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,OAAO,QAAQ,mBAAmB,OAAO,KAAK,KAAK,CAAC,CAAC;;CAG5D,YAA6B;EAC3B,MAAM,MAAM,KAAK,OAAO,QAAQ,kBAAkB;AAElD,MAAI,CAAC,IACH,QAAO;AAET,SAAO,KAAK,KAAK,GAAG,OAAO,IAAI,GAAG"}