@interfere/react 9.0.2 → 10.0.0

package/dist/plugins/logs.d.mts

@@ -0,0 +1,13 @@
+import { Plugin } from "./lib/types.mjs";
+
+//#region src/plugins/logs.d.ts
+/**
+ * Subscribes to the central console patch so string-only console calls
+ * land as OTel `LogRecord`s. Error-bearing calls are skipped: the
+ * `errors` plugin's subscriber on the same patch handles those as
+ * exceptions. Class boundary stays firm: errors flow as exceptions,
+ * strings flow as logs.
+ */
+declare const logsPlugin: Plugin;
+//#endregion
+export { logsPlugin as default, logsPlugin };

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.mts","names":[],"sources":["../../src/plugins/logs.ts"],"mappings":";;;;;AAyBA;;;;;cAAa,UAAA,EAAY,MAAA"}

package/dist/plugins/logs.mjs

@@ -0,0 +1,53 @@
+import { activeKernel } from "../internal/kernel-registry.mjs";
+import { onConsoleCall } from "../internal/console-patch.mjs";
+import { safeStringify } from "../util/stringify.mjs";
+import { SeverityNumber } from "@opentelemetry/api-logs";
+//#region src/plugins/logs.ts
+const LEVEL_TO_SEVERITY = {
+	debug: {
+		number: SeverityNumber.DEBUG,
+		text: "DEBUG"
+	},
+	info: {
+		number: SeverityNumber.INFO,
+		text: "INFO"
+	},
+	log: {
+		number: SeverityNumber.INFO,
+		text: "INFO"
+	},
+	warn: {
+		number: SeverityNumber.WARN,
+		text: "WARN"
+	},
+	error: {
+		number: SeverityNumber.ERROR,
+		text: "ERROR"
+	}
+};
+/**
+* Subscribes to the central console patch so string-only console calls
+* land as OTel `LogRecord`s. Error-bearing calls are skipped: the
+* `errors` plugin's subscriber on the same patch handles those as
+* exceptions. Class boundary stays firm: errors flow as exceptions,
+* strings flow as logs.
+*/
+const logsPlugin = {
+	name: "logs",
+	setup() {
+		return onConsoleCall((level, args) => {
+			if (args.some((a) => a instanceof Error)) return;
+			const kernel = activeKernel();
+			if (!kernel) return;
+			const sev = LEVEL_TO_SEVERITY[level];
+			kernel.recordLog({
+				severityText: sev.text,
+				severityNumber: sev.number,
+				body: args.length === 1 ? safeStringify(args[0]) : args.map(safeStringify).join(" "),
+				attributes: { "console.level": level }
+			});
+		});
+	}
+};
+//#endregion
+export { logsPlugin as default, logsPlugin };

package/dist/plugins/logs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.mjs","names":[],"sources":["../../src/plugins/logs.ts"],"sourcesContent":["import { SeverityNumber } from \"@opentelemetry/api-logs\";\n\nimport { type ConsoleLevel, onConsoleCall } from \"../internal/console-patch.js\";\nimport { activeKernel } from \"../internal/kernel-registry.js\";\nimport { safeStringify } from \"../util/stringify.js\";\nimport type { Plugin } from \"./lib/types.js\";\n\nconst LEVEL_TO_SEVERITY: Record<\n  ConsoleLevel,\n  { number: SeverityNumber; text: string }\n> = {\n  debug: { number: SeverityNumber.DEBUG, text: \"DEBUG\" },\n  info: { number: SeverityNumber.INFO, text: \"INFO\" },\n  log: { number: SeverityNumber.INFO, text: \"INFO\" },\n  warn: { number: SeverityNumber.WARN, text: \"WARN\" },\n  error: { number: SeverityNumber.ERROR, text: \"ERROR\" },\n};\n\n/**\n * Subscribes to the central console patch so string-only console calls\n * land as OTel `LogRecord`s. Error-bearing calls are skipped: the\n * `errors` plugin's subscriber on the same patch handles those as\n * exceptions. Class boundary stays firm: errors flow as exceptions,\n * strings flow as logs.\n */\nexport const logsPlugin: Plugin = {\n  name: \"logs\",\n\n  setup() {\n    const unsubscribe = onConsoleCall((level, args) => {\n      if (args.some((a) => a instanceof Error)) {\n        return;\n      }\n      const kernel = activeKernel();\n      if (!kernel) {\n        return;\n      }\n      const sev = LEVEL_TO_SEVERITY[level];\n      kernel.recordLog({\n        severityText: sev.text,\n        severityNumber: sev.number,\n        body:\n          args.length === 1\n            ? safeStringify(args[0])\n            : args.map(safeStringify).join(\" \"),\n        attributes: { \"console.level\": level },\n      });\n    });\n\n    return unsubscribe;\n  },\n};\n\nexport default logsPlugin;\n"],"mappings":";;;;;AAOA,MAAM,oBAGF;CACF,OAAO;EAAE,QAAQ,eAAe;EAAO,MAAM;EAAS;CACtD,MAAM;EAAE,QAAQ,eAAe;EAAM,MAAM;EAAQ;CACnD,KAAK;EAAE,QAAQ,eAAe;EAAM,MAAM;EAAQ;CAClD,MAAM;EAAE,QAAQ,eAAe;EAAM,MAAM;EAAQ;CACnD,OAAO;EAAE,QAAQ,eAAe;EAAO,MAAM;EAAS;CACvD;;;;;;;;AASD,MAAa,aAAqB;CAChC,MAAM;CAEN,QAAQ;EAqBN,OApBoB,eAAe,OAAO,SAAS;GACjD,IAAI,KAAK,MAAM,MAAM,aAAa,MAAM,EACtC;GAEF,MAAM,SAAS,cAAc;GAC7B,IAAI,CAAC,QACH;GAEF,MAAM,MAAM,kBAAkB;GAC9B,OAAO,UAAU;IACf,cAAc,IAAI;IAClB,gBAAgB,IAAI;IACpB,MACE,KAAK,WAAW,IACZ,cAAc,KAAK,GAAG,GACtB,KAAK,IAAI,cAAc,CAAC,KAAK,IAAI;IACvC,YAAY,EAAE,iBAAiB,OAAO;IACvC,CAAC;IAGc;;CAErB"}

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

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

package/dist/plugins/rage-clicks.mjs

@@ -1,7 +1,9 @@
+import { trace } from "@opentelemetry/api";
 //#region src/plugins/rage-clicks.ts
 const CLICK_THRESHOLD = 3;
 const TIME_WINDOW_MS = 800;
 const PROXIMITY_PX = 30;
+const TRACER_NAME = "@interfere/react/rage-clicks";
 function distance(a, b) {
 	return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
 }
@@ -14,7 +16,7 @@ function selectorFor(el) {
 }
 const rageClicksPlugin = {
 	name: "rage-clicks",
-	setup(ctx) {
+	setup() {
 		const clicks = [];
 		const onClick = (event) => {
 			const now = Date.now();
@@ -32,15 +34,15 @@ const rageClicksPlugin = {
 			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
-			});
+			trace.getTracer(TRACER_NAME).startSpan("rage_click", { attributes: {
+				"ui.event_type": "rage_click",
+				"ui.rage_click.count": clustered.length,
+				"ui.rage_click.time_window_ms": last.ts - anchor.ts,
+				"ui.rage_click.selector": selectorFor(last.target),
+				"ui.rage_click.text": last.target?.textContent?.trim().slice(0, 120) ?? "",
+				"ui.rage_click.x": last.x,
+				"ui.rage_click.y": last.y
+			} }).end();
 			clicks.length = 0;
 		};
 		document.addEventListener("click", onClick, { capture: true });

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

@@ -1 +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"}
+{"version":3,"file":"rage-clicks.mjs","names":[],"sources":["../../src/plugins/rage-clicks.ts"],"sourcesContent":["import { trace } from \"@opentelemetry/api\";\n\nimport type { Plugin } from \"./lib/types.js\";\n\nconst CLICK_THRESHOLD = 3;\nconst TIME_WINDOW_MS = 800;\nconst PROXIMITY_PX = 30;\nconst TRACER_NAME = \"@interfere/react/rage-clicks\";\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() {\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\n      // Emit as a discrete OTel span. The cluster of clicks is a single\n      // user-experience event; a span (rather than a span event on\n      // whatever's currently active) keeps the rage-click correlatable\n      // by `ui.event_type=rage_click` regardless of whether a navigation\n      // / interaction span happens to be open at click time.\n      const span = trace.getTracer(TRACER_NAME).startSpan(\"rage_click\", {\n        attributes: {\n          \"ui.event_type\": \"rage_click\",\n          \"ui.rage_click.count\": clustered.length,\n          \"ui.rage_click.time_window_ms\": last.ts - anchor.ts,\n          \"ui.rage_click.selector\": selectorFor(last.target),\n          \"ui.rage_click.text\":\n            last.target?.textContent?.trim().slice(0, 120) ?? \"\",\n          \"ui.rage_click.x\": last.x,\n          \"ui.rage_click.y\": last.y,\n        },\n      });\n      span.end();\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":";;AAIA,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;AACvB,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAS,SAAS,GAAU,GAAkB;CAC5C,OAAO,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;;AAGvD,SAAS,YAAY,IAA4B;CAC/C,IAAI,CAAC,IACH,OAAO;CAET,IAAI,GAAG,IACL,OAAO,IAAI,GAAG;CAEhB,MAAM,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI;CACvD,MAAM,MAAM,GAAG,QAAQ,aAAa;CACpC,OAAO,UAAU,GAAG,IAAI,GAAG,YAAY;;AAGzC,MAAa,mBAA2B;CACtC,MAAM;CAEN,QAAQ;EACN,MAAM,SAAkB,EAAE;EAE1B,MAAM,WAAW,UAAsB;GACrC,MAAM,MAAM,KAAK,KAAK;GACtB,OAAO,KAAK;IACV,GAAG,MAAM;IACT,GAAG,MAAM;IACT,IAAI;IACJ,QAAQ,MAAM,kBAAkB,UAAU,MAAM,SAAS;IAC1D,CAAC;GAGF,OAAO,OAAO,SAAS,KAAK,OAAO,OAAO,IAAI,MAAM,KAAK,gBACvD,OAAO,OAAO;GAGhB,IAAI,OAAO,SAAS,iBAClB;GAIF,MAAM,SAAS,OAAO;GACtB,IAAI,CAAC,QACH;GAEF,MAAM,YAAY,OAAO,QACtB,MAAM,SAAS,QAAQ,EAAE,IAAI,aAC/B;GACD,IAAI,UAAU,SAAS,iBACrB;GAGF,MAAM,OAAO,UAAU,GAAG,GAAG;GAC7B,IAAI,CAAC,MACH;GAoBF,MAZmB,UAAU,YAAY,CAAC,UAAU,cAAc,EAChE,YAAY;IACV,iBAAiB;IACjB,uBAAuB,UAAU;IACjC,gCAAgC,KAAK,KAAK,OAAO;IACjD,0BAA0B,YAAY,KAAK,OAAO;IAClD,sBACE,KAAK,QAAQ,aAAa,MAAM,CAAC,MAAM,GAAG,IAAI,IAAI;IACpD,mBAAmB,KAAK;IACxB,mBAAmB,KAAK;IACzB,EACF,CACG,CAAC,KAAK;GAEV,OAAO,SAAS;;EAGlB,SAAS,iBAAiB,SAAS,SAAS,EAAE,SAAS,MAAM,CAAC;EAE9D,aAAa;GACX,SAAS,oBAAoB,SAAS,SAAS,EAAE,SAAS,MAAM,CAAC;;;CAGtE"}

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

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

package/dist/plugins/replay.mjs

@@ -1,10 +1,52 @@
 import { createLogger } from "../util/log.mjs";
+import { resolveTargets } from "../internal/config.mjs";
+import { onPageHidden } from "../internal/page-lifecycle.mjs";
+import { trace } from "@opentelemetry/api";
 //#region src/plugins/replay.ts
 const log = createLogger("replay");
 const FLUSH_INTERVAL_MS = 1e4;
+const UPLOAD_PATH_PREFIX = "/v2/replay/upload/";
+const TRACER_NAME = "@interfere/react/replay";
+const TRAILING_SLASH_RE = /\/$/;
+/**
+* POSTs the chunk's events array to the collector. The collector writes
+* to R2 server-side and returns the object key we stamp onto the
+* `replay.chunk` span event. Single round trip; if the request fails,
+* the chunk is dropped — replay is best-effort and the customer's next
+* session will still record cleanly.
+*/
+async function deliverChunk({ ctx, uploadBaseUrl, authHeaders, payload }) {
+	const sessionId = ctx.getSessionId();
+	if (!sessionId) return;
+	const body = JSON.stringify(payload.events);
+	const sizeBytes = body.length;
+	const res = await fetch(`${uploadBaseUrl}${encodeURIComponent(sessionId)}`, {
+		method: "POST",
+		headers: {
+			...authHeaders,
+			"content-type": "application/json"
+		},
+		body
+	});
+	if (!res.ok) {
+		log.warn("replay chunk upload rejected (%d)", res.status);
+		return;
+	}
+	const { objectKey } = await res.json();
+	trace.getTracer(TRACER_NAME).startSpan("replay.chunk", { attributes: {
+		"replay.chunk.uri": objectKey,
+		"replay.chunk.size_bytes": sizeBytes,
+		"replay.chunk.event_count": payload.events.length,
+		...payload.firstTs === null ? {} : { "replay.chunk.first_event_ts": payload.firstTs },
+		...payload.lastTs === null ? {} : { "replay.chunk.last_event_ts": payload.lastTs }
+	} }).end();
+}
 const replayPlugin = {
 	name: "replay",
 	setup(ctx) {
+		const targets = resolveTargets();
+		const uploadBaseUrl = `${targets.collectorBaseUrl.replace(TRAILING_SLASH_RE, "")}${UPLOAD_PATH_PREFIX}`;
+		const authHeaders = Object.fromEntries(targets.ingest.headers.entries());
 		let stopFn = null;
 		let events = [];
 		let flushTimer = null;
@@ -14,24 +56,23 @@ const replayPlugin = {
 			if (events.length === 0) return;
 			const chunk = events;
 			events = [];
-			const fts = firstTs;
-			const lts = lastTs;
+			const payload = {
+				events: chunk,
+				firstTs,
+				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 }
+			deliverChunk({
+				ctx,
+				uploadBaseUrl,
+				authHeaders,
+				payload
+			}).catch((error) => {
+				log.warn("replay chunk dropped: %o", error);
 			});
 		};
-		const onVisibilityChange = () => {
-			if (document.visibilityState === "hidden") flush();
-		};
-		const onBeforeUnload = () => {
-			flush();
-		};
+		let unsubscribeHidden = null;
 		const init = async () => {
 			try {
 				stopFn = (await import("rrweb")).record({ emit(event) {
@@ -41,20 +82,18 @@ const replayPlugin = {
 					events.push(JSON.stringify(event));
 				} }) ?? null;
 				flushTimer = setInterval(flush, FLUSH_INTERVAL_MS);
-				globalThis.addEventListener("visibilitychange", onVisibilityChange);
-				globalThis.addEventListener("beforeunload", onBeforeUnload);
+				unsubscribeHidden = onPageHidden(flush);
 				log.debug("recording started");
 			} catch {
 				log.error("rrweb failed to load, replay disabled");
 			}
 		};
-		init().catch(() => {});
+		init();
 		return () => {
 			flush();
 			stopFn?.();
 			if (flushTimer) clearInterval(flushTimer);
-			globalThis.removeEventListener("visibilitychange", onVisibilityChange);
-			globalThis.removeEventListener("beforeunload", onBeforeUnload);
+			unsubscribeHidden?.();
 		};
 	}
 };

package/dist/plugins/replay.mjs.map

@@ -1 +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,cACE,MAFkB,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"}
+{"version":3,"file":"replay.mjs","names":[],"sources":["../../src/plugins/replay.ts"],"sourcesContent":["import { trace } from \"@opentelemetry/api\";\n\nimport { resolveTargets } from \"../internal/config.js\";\nimport { onPageHidden } from \"../internal/page-lifecycle.js\";\nimport { createLogger } from \"../util/log.js\";\nimport type { Plugin, PluginContext } from \"./lib/types.js\";\n\nconst log = createLogger(\"replay\");\n\nconst FLUSH_INTERVAL_MS = 10_000;\nconst UPLOAD_PATH_PREFIX = \"/v2/replay/upload/\";\nconst TRACER_NAME = \"@interfere/react/replay\";\nconst TRAILING_SLASH_RE = /\\/$/;\n\ninterface UploadResponse {\n  objectKey: string;\n}\n\ninterface ChunkPayload {\n  events: string[];\n  firstTs: number | null;\n  lastTs: number | null;\n}\n\ninterface DeliverInput {\n  authHeaders: Record<string, string>;\n  ctx: PluginContext;\n  payload: ChunkPayload;\n  uploadBaseUrl: string;\n}\n\n/**\n * POSTs the chunk's events array to the collector. The collector writes\n * to R2 server-side and returns the object key we stamp onto the\n * `replay.chunk` span event. Single round trip; if the request fails,\n * the chunk is dropped — replay is best-effort and the customer's next\n * session will still record cleanly.\n */\nasync function deliverChunk({\n  ctx,\n  uploadBaseUrl,\n  authHeaders,\n  payload,\n}: DeliverInput): Promise<void> {\n  const sessionId = ctx.getSessionId();\n  if (!sessionId) {\n    return;\n  }\n\n  const body = JSON.stringify(payload.events);\n  const sizeBytes = body.length;\n\n  const res = await fetch(`${uploadBaseUrl}${encodeURIComponent(sessionId)}`, {\n    method: \"POST\",\n    headers: { ...authHeaders, \"content-type\": \"application/json\" },\n    body,\n  });\n  if (!res.ok) {\n    log.warn(\"replay chunk upload rejected (%d)\", res.status);\n    return;\n  }\n\n  const { objectKey } = (await res.json()) as UploadResponse;\n\n  // Span-per-chunk is the cleanest OTel mapping: replay chunks are\n  // events-in-time, not \"things that happened during a span\", so the\n  // span itself carries the attrs. Mapper picks up by name later\n  // (PRD 3 replay UI work).\n  const span = trace.getTracer(TRACER_NAME).startSpan(\"replay.chunk\", {\n    attributes: {\n      \"replay.chunk.uri\": objectKey,\n      \"replay.chunk.size_bytes\": sizeBytes,\n      \"replay.chunk.event_count\": payload.events.length,\n      ...(payload.firstTs === null\n        ? {}\n        : { \"replay.chunk.first_event_ts\": payload.firstTs }),\n      ...(payload.lastTs === null\n        ? {}\n        : { \"replay.chunk.last_event_ts\": payload.lastTs }),\n    },\n  });\n  span.end();\n}\n\nexport const replayPlugin: Plugin = {\n  name: \"replay\",\n\n  setup(ctx) {\n    const targets = resolveTargets();\n    const uploadBaseUrl = `${targets.collectorBaseUrl.replace(TRAILING_SLASH_RE, \"\")}${UPLOAD_PATH_PREFIX}`;\n    const authHeaders = Object.fromEntries(targets.ingest.headers.entries());\n\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 payload: ChunkPayload = {\n        events: chunk,\n        firstTs,\n        lastTs,\n      };\n      firstTs = null;\n      lastTs = null;\n\n      // Fire-and-forget; replay capture must never block the rrweb event\n      // loop. Failed chunks are dropped — replay is best-effort and the\n      // next session will still record cleanly.\n      deliverChunk({ ctx, uploadBaseUrl, authHeaders, payload }).catch(\n        (error: unknown) => {\n          log.warn(\"replay chunk dropped: %o\", error);\n        }\n      );\n    };\n\n    let unsubscribeHidden: (() => void) | null = null;\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        unsubscribeHidden = onPageHidden(flush);\n        log.debug(\"recording started\");\n      } catch {\n        log.error(\"rrweb failed to load, replay disabled\");\n      }\n    };\n\n    // `init()` swallows rrweb load failures internally — no outer `.catch`\n    // needed (it can never reject).\n    init();\n\n    return () => {\n      flush();\n      stopFn?.();\n      if (flushTimer) {\n        clearInterval(flushTimer);\n      }\n      unsubscribeHidden?.();\n    };\n  },\n};\n\nexport default replayPlugin;\n"],"mappings":";;;;;AAOA,MAAM,MAAM,aAAa,SAAS;AAElC,MAAM,oBAAoB;AAC1B,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AACpB,MAAM,oBAAoB;;;;;;;;AA0B1B,eAAe,aAAa,EAC1B,KACA,eACA,aACA,WAC8B;CAC9B,MAAM,YAAY,IAAI,cAAc;CACpC,IAAI,CAAC,WACH;CAGF,MAAM,OAAO,KAAK,UAAU,QAAQ,OAAO;CAC3C,MAAM,YAAY,KAAK;CAEvB,MAAM,MAAM,MAAM,MAAM,GAAG,gBAAgB,mBAAmB,UAAU,IAAI;EAC1E,QAAQ;EACR,SAAS;GAAE,GAAG;GAAa,gBAAgB;GAAoB;EAC/D;EACD,CAAC;CACF,IAAI,CAAC,IAAI,IAAI;EACX,IAAI,KAAK,qCAAqC,IAAI,OAAO;EACzD;;CAGF,MAAM,EAAE,cAAe,MAAM,IAAI,MAAM;CAmBvC,MAbmB,UAAU,YAAY,CAAC,UAAU,gBAAgB,EAClE,YAAY;EACV,oBAAoB;EACpB,2BAA2B;EAC3B,4BAA4B,QAAQ,OAAO;EAC3C,GAAI,QAAQ,YAAY,OACpB,EAAE,GACF,EAAE,+BAA+B,QAAQ,SAAS;EACtD,GAAI,QAAQ,WAAW,OACnB,EAAE,GACF,EAAE,8BAA8B,QAAQ,QAAQ;EACrD,EACF,CACG,CAAC,KAAK;;AAGZ,MAAa,eAAuB;CAClC,MAAM;CAEN,MAAM,KAAK;EACT,MAAM,UAAU,gBAAgB;EAChC,MAAM,gBAAgB,GAAG,QAAQ,iBAAiB,QAAQ,mBAAmB,GAAG,GAAG;EACnF,MAAM,cAAc,OAAO,YAAY,QAAQ,OAAO,QAAQ,SAAS,CAAC;EAExE,IAAI,SAA8B;EAClC,IAAI,SAAmB,EAAE;EACzB,IAAI,aAAoD;EACxD,IAAI,UAAyB;EAC7B,IAAI,SAAwB;EAE5B,MAAM,cAAc;GAClB,IAAI,OAAO,WAAW,GACpB;GAEF,MAAM,QAAQ;GACd,SAAS,EAAE;GACX,MAAM,UAAwB;IAC5B,QAAQ;IACR;IACA;IACD;GACD,UAAU;GACV,SAAS;GAKT,aAAa;IAAE;IAAK;IAAe;IAAa;IAAS,CAAC,CAAC,OACxD,UAAmB;IAClB,IAAI,KAAK,4BAA4B,MAAM;KAE9C;;EAGH,IAAI,oBAAyC;EAE7C,MAAM,OAAO,YAAY;GACvB,IAAI;IAEF,UACE,MAFkB,OAAO,UAEnB,OAAO,EACX,KAAK,OAAO;KACV,MAAM,KAAK,KAAK,KAAK;KACrB,IAAI,YAAY,MACd,UAAU;KAEZ,SAAS;KACT,OAAO,KAAK,KAAK,UAAU,MAAM,CAAC;OAErC,CAAC,IAAI;IAER,aAAa,YAAY,OAAO,kBAAkB;IAClD,oBAAoB,aAAa,MAAM;IACvC,IAAI,MAAM,oBAAoB;WACxB;IACN,IAAI,MAAM,wCAAwC;;;EAMtD,MAAM;EAEN,aAAa;GACX,OAAO;GACP,UAAU;GACV,IAAI,YACF,cAAc,WAAW;GAE3B,qBAAqB;;;CAG1B"}

package/dist/provider.d.mts

@@ -1,26 +1,9 @@
+import { Kernel } from "./internal/kernel.mjs";
+import { InterfereContext, InterfereContextValue } from "./internal/react-context.mjs";
 import { PropsWithChildren, ReactNode } from "react";
 import { ConsentState } from "@interfere/types/sdk/plugins/manifest";
-import { IdentifyParams } from "@interfere/types/sdk/identify";
 
 //#region src/provider.d.ts
-interface InterfereContextValue {
-  consent: {
-    get(): ConsentState | null;
-    set(state?: ConsentState): void;
-  };
-  device: {
-    getDeviceId(): string | null;
-    getFpHash(): string | null;
-  };
-  identity: {
-    get(): IdentifyParams | null;
-    set(params: IdentifyParams): Promise<void>;
-  };
-  session: {
-    getId(): string | null;
-    getWindowId(): string | null;
-  };
-}
 interface InterfereProviderProps extends PropsWithChildren {
   consent?: ConsentState | undefined;
   /**
@@ -40,8 +23,16 @@ interface InterfereProviderProps extends PropsWithChildren {
    * @default true
    */
   errorBoundary?: boolean;
+  /**
+   * The active kernel from `init()`. Pass `null` (or omit on the server)
+   * when the SDK isn't initialized — useful during SSR/SSG where `init()`
+   * runs client-side only. The provider mounts with null-safe accessors
+   * and switches to the real kernel once it's available.
+   */
+  kernel: Kernel | null;
 }
 declare function InterfereProvider({
+  kernel,
   children,
   consent,
   errorBoundary
@@ -49,4 +40,4 @@ declare function InterfereProvider({
 declare function useInterfere(): InterfereContextValue;
 declare function useSession(): string | null;
 //#endregion
-export { InterfereProvider, useInterfere, useSession };
+export { InterfereContext, type InterfereContextValue, InterfereProvider, useInterfere, useSession };

package/dist/provider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"mappings":";;;;;UAiBU,qBAAA;EACR,OAAA;IACE,GAAA,IAAO,YAAA;IACP,GAAA,CAAI,KAAA,GAAQ,YAAA;EAAA;EAEd,MAAA;IACE,WAAA;IACA,SAAA;EAAA;EAEF,QAAA;IACE,GAAA,IAAO,cAAA;IACP,GAAA,CAAI,MAAA,EAAQ,cAAA,GAAiB,OAAA;EAAA;EAE/B,OAAA;IACE,KAAA;IACA,WAAA;EAAA;AAAA;AAAA,UAMM,sBAAA,SAA+B,iBAAA;EACvC,OAAA,GAAU,YAAA;EAfR;;;;;;;;;;;;;AAQW;;;EAwBb,aAAA;AAAA;AAAA,iBAGc,iBAAA,CAAA;EACd,QAAA;EACA,OAAA;EACA;AAAA,GACC,sBAAA,GAAyB,SAAA;AAAA,iBAqBZ,YAAA,CAAA,GAAgB,qBAAA;AAAA,iBAQhB,UAAA,CAAA"}
+{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"mappings":";;;;;;UAmBU,sBAAA,SAA+B,iBAAA;EACvC,OAAA,GAAU,YAAA;EADF;;;;;;;;;;;;;;;;EAkBR,aAAA;EAU+B;;;;;;EAH/B,MAAA,EAAQ,MAAA;AAAA;AAAA,iBAGM,iBAAA,CAAA;EACd,MAAA;EACA,QAAA;EACA,OAAA;EACA;AAAA,GACC,sBAAA,GAAyB,SAAA;AAAA,iBAwBZ,YAAA,CAAA,GAAgB,qBAAA;AAAA,iBAQhB,UAAA,CAAA"}

package/dist/provider.mjs

@@ -1,22 +1,21 @@
 "use client";
-import { device, identity, session } from "./tracking/api.mjs";
-import { consent, syncConsent } from "./internal/client.mjs";
+import { InterfereContext, NULL_CONTEXT_VALUE } from "./internal/react-context.mjs";
 import { CaptureBoundary } from "./internal/capture-boundary.mjs";
-import { createContext, useContext, useEffect } from "react";
+import { useContext, useEffect } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/provider.tsx
-const InterfereContext = createContext(null);
-function InterfereProvider({ children, consent: consent$1, errorBoundary = true }) {
+function InterfereProvider({ kernel, children, consent, errorBoundary = true }) {
 	useEffect(() => {
-		syncConsent(consent$1);
-	}, [consent$1]);
+		kernel?.syncConsent(consent);
+	}, [kernel, consent]);
 	return /* @__PURE__ */ jsx(InterfereContext, {
-		value: {
-			consent,
-			device,
-			identity,
-			session
-		},
+		value: kernel ? {
+			consent: kernel.consent,
+			device: kernel.device,
+			identity: kernel.identity,
+			kernel,
+			session: kernel.session
+		} : NULL_CONTEXT_VALUE,
 		children: errorBoundary ? /* @__PURE__ */ jsx(CaptureBoundary, { children }) : children
 	});
 }
@@ -29,4 +28,4 @@ function useSession() {
 	return useInterfere().session.getId();
 }
 //#endregion
-export { InterfereProvider, useInterfere, useSession };
+export { InterfereContext, InterfereProvider, useInterfere, useSession };

package/dist/provider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"provider.mjs","names":["consent","sdkConsent"],"sources":["../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { IdentifyParams } from \"@interfere/types/sdk/identify\";\nimport type { ConsentState } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport {\n  createContext,\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n  useEffect,\n} from \"react\";\n\nimport { CaptureBoundary } from \"./internal/capture-boundary.js\";\nimport { consent as sdkConsent, syncConsent } from \"./internal/client.js\";\nimport { device, identity, session } from \"./tracking/api.js\";\n\ninterface InterfereContextValue {\n  consent: {\n    get(): ConsentState | null;\n    set(state?: ConsentState): void;\n  };\n  device: {\n    getDeviceId(): string | null;\n    getFpHash(): string | null;\n  };\n  identity: {\n    get(): IdentifyParams | null;\n    set(params: IdentifyParams): Promise<void>;\n  };\n  session: {\n    getId(): string | null;\n    getWindowId(): string | null;\n  };\n}\n\nconst InterfereContext = createContext<InterfereContextValue | null>(null);\n\ninterface InterfereProviderProps extends PropsWithChildren {\n  consent?: ConsentState | undefined;\n  /**\n   * Auto-install an internal capture boundary around `children` so\n   * render-phase React errors are reported even when the host app has no\n   * `ErrorBoundary` / `error.tsx` of its own.\n   *\n   * The internal boundary is transparent: it captures the error and then\n   * re-throws so upstream boundaries (the customer's own, Next.js's\n   * `error.tsx` / `global-error.tsx`, or React's default unmount) keep full\n   * control of what the user sees. Safe to leave enabled.\n   *\n   * Pass `false` only if you explicitly don't want automatic capture of\n   * render-phase errors — for example, if you've already wired\n   * {@link reactErrorHandler} into `createRoot()`.\n   *\n   * @default true\n   */\n  errorBoundary?: boolean;\n}\n\nexport function InterfereProvider({\n  children,\n  consent,\n  errorBoundary = true,\n}: InterfereProviderProps): ReactNode {\n  useEffect(() => {\n    syncConsent(consent);\n  }, [consent]);\n\n  const value: InterfereContextValue = {\n    consent: sdkConsent,\n    device,\n    identity,\n    session,\n  };\n\n  const body = errorBoundary ? (\n    <CaptureBoundary>{children}</CaptureBoundary>\n  ) : (\n    children\n  );\n\n  return <InterfereContext value={value}>{body}</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":";;;;;;;AAoCA,MAAM,mBAAmB,cAA4C,KAAK;AAuB1E,SAAgB,kBAAkB,EAChC,UACA,SAAA,WACA,gBAAgB,QACoB;AACpC,iBAAgB;AACd,cAAYA,UAAQ;IACnB,CAACA,UAAQ,CAAC;AAeb,QAAO,oBAAC,kBAAD;EAAkB,OAAO;GAZrBC;GACT;GACA;GACA;GASmC;YANxB,gBACX,oBAAC,iBAAD,EAAkB,UAA2B,CAAA,GAE7C;EAG8D,CAAA;;AAGlE,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"}
+{"version":3,"file":"provider.mjs","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { ConsentState } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport {\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n  useEffect,\n} from \"react\";\n\nimport { CaptureBoundary } from \"./internal/capture-boundary.js\";\nimport type { Kernel } from \"./internal/kernel.js\";\nimport type { InterfereContextValue } from \"./internal/react-context.js\";\nimport {\n  InterfereContext,\n  NULL_CONTEXT_VALUE,\n} from \"./internal/react-context.js\";\n\ninterface InterfereProviderProps extends PropsWithChildren {\n  consent?: ConsentState | undefined;\n  /**\n   * Auto-install an internal capture boundary around `children` so\n   * render-phase React errors are reported even when the host app has no\n   * `ErrorBoundary` / `error.tsx` of its own.\n   *\n   * The internal boundary is transparent: it captures the error and then\n   * re-throws so upstream boundaries (the customer's own, Next.js's\n   * `error.tsx` / `global-error.tsx`, or React's default unmount) keep full\n   * control of what the user sees. Safe to leave enabled.\n   *\n   * Pass `false` only if you explicitly don't want automatic capture of\n   * render-phase errors — for example, if you've already wired\n   * {@link reactErrorHandler} into `createRoot()`.\n   *\n   * @default true\n   */\n  errorBoundary?: boolean;\n  /**\n   * The active kernel from `init()`. Pass `null` (or omit on the server)\n   * when the SDK isn't initialized — useful during SSR/SSG where `init()`\n   * runs client-side only. The provider mounts with null-safe accessors\n   * and switches to the real kernel once it's available.\n   */\n  kernel: Kernel | null;\n}\n\nexport function InterfereProvider({\n  kernel,\n  children,\n  consent,\n  errorBoundary = true,\n}: InterfereProviderProps): ReactNode {\n  useEffect(() => {\n    kernel?.syncConsent(consent);\n  }, [kernel, consent]);\n\n  const value: InterfereContextValue = kernel\n    ? {\n        consent: kernel.consent,\n        device: kernel.device,\n        identity: kernel.identity,\n        kernel,\n        session: kernel.session,\n      }\n    : NULL_CONTEXT_VALUE;\n\n  const body = errorBoundary ? (\n    <CaptureBoundary>{children}</CaptureBoundary>\n  ) : (\n    children\n  );\n\n  return <InterfereContext value={value}>{body}</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\nexport type { InterfereContextValue } from \"./internal/react-context.js\";\n// biome-ignore lint/performance/noBarrelFile: Re-export the context handle alongside the provider so consumers (custom error boundaries, the `@interfere/next` wrapper) can import everything from one entry.\nexport { InterfereContext } from \"./internal/react-context.js\";\n"],"mappings":";;;;;;AA+CA,SAAgB,kBAAkB,EAChC,QACA,UACA,SACA,gBAAgB,QACoB;CACpC,gBAAgB;EACd,QAAQ,YAAY,QAAQ;IAC3B,CAAC,QAAQ,QAAQ,CAAC;CAkBrB,OAAO,oBAAC,kBAAD;EAAkB,OAhBY,SACjC;GACE,SAAS,OAAO;GAChB,QAAQ,OAAO;GACf,UAAU,OAAO;GACjB;GACA,SAAS,OAAO;GACjB,GACD;YAES,gBACX,oBAAC,iBAAD,EAAkB,UAA2B,CAAA,GAE7C;EAG8D,CAAA;;AAGlE,SAAgB,eAAsC;CACpD,MAAM,MAAM,WAAW,iBAAiB;CACxC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uDAAuD;CAEzE,OAAO;;AAGT,SAAgB,aAA4B;CAC1C,OAAO,cAAc,CAAC,QAAQ,OAAO"}

package/dist/react-error-handler.d.mts

@@ -1,3 +1,5 @@
+import { Kernel } from "./internal/kernel.mjs";
+
 //#region src/react-error-handler.d.ts
 /**
  * Matches the shape React 19 passes to `onCaughtError`, `onUncaughtError`,
@@ -30,7 +32,18 @@ interface ReactErrorHandlerCallbacks {
    */
   onUncaughtError?: RootErrorCallback;
 }
-interface ReactErrorHandlerOptions extends ReactErrorHandlerCallbacks {}
+interface ReactErrorHandlerOptions extends ReactErrorHandlerCallbacks {
+  /**
+   * The kernel to capture errors against. Pass either the kernel directly
+   * or a getter — framework wrappers expose `getKernelOrNull()` for the
+   * latter pattern, which lets you wire the handler before `init()`
+   * resolves. Pass `getKernelOrNull` (not `getKernel`) — the throwing
+   * variant breaks this contract since the handler runs in error-recovery
+   * paths where rethrowing isn't useful. Capture is silently skipped when
+   * no kernel is available.
+   */
+  kernel?: Kernel | (() => Kernel | null) | null;
+}
 interface ReactRootErrorHandlers {
   onCaughtError: RootErrorCallback;
   onRecoverableError: RootErrorCallback;
@@ -42,11 +55,13 @@ interface ReactRootErrorHandlers {
  *
  * ```ts
  * import { createRoot } from "react-dom/client";
+ * import { getKernelOrNull } from "@interfere/next";
  * import { reactErrorHandler } from "@interfere/react/react-error-handler";
  *
- * createRoot(document.getElementById("root")!, reactErrorHandler()).render(
- *   <App />
- * );
+ * createRoot(
+ *   document.getElementById("root")!,
+ *   reactErrorHandler({ kernel: getKernelOrNull })
+ * ).render(<App />);
  * ```
  *
  * Pass your own callbacks to observe errors without replacing the capture
@@ -54,10 +69,11 @@ interface ReactRootErrorHandlers {
  *
  * ```ts
  * reactErrorHandler({
+ *   kernel: getKernelOrNull,
  *   onUncaughtError: (err) => myLogger.fatal(err),
  * });
  * ```
  */
-declare function reactErrorHandler(callbacks?: ReactErrorHandlerOptions): ReactRootErrorHandlers;
+declare function reactErrorHandler(options?: ReactErrorHandlerOptions): ReactRootErrorHandlers;
 //#endregion
 export { ReactErrorHandlerCallbacks, ReactErrorHandlerOptions, reactErrorHandler };

package/dist/react-error-handler.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"react-error-handler.d.mts","names":[],"sources":["../src/react-error-handler.ts"],"mappings":";;;;;;;AAcgB;UADN,kBAAA;EACR,cAAA;AAAA;AAAA,KAGG,iBAAA,IAAqB,KAAA,WAAgB,IAAA,EAAM,kBAAA;AAAA,UAE/B,0BAAA;EAFyB;;;AAE1C;;EAME,aAAA,GAAgB,iBAAA;EAAA;;;;;EAMhB,kBAAA,GAAqB,iBAAA;EANL;;;;;EAYhB,eAAA,GAAkB,iBAAA;AAAA;AAAA,UAGH,wBAAA,SAAiC,0BAAA;AAAA,UAExC,sBAAA;EACR,aAAA,EAAe,iBAAA;EACf,kBAAA,EAAoB,iBAAA;EACpB,eAAA,EAAiB,iBAAA;AAAA;;;;;;;;;;;;;;;AAyBnB;;;;;;;;iBAAgB,iBAAA,CACd,SAAA,GAAW,wBAAA,GACV,sBAAA"}
+{"version":3,"file":"react-error-handler.d.mts","names":[],"sources":["../src/react-error-handler.ts"],"mappings":";;;;;AAKmD;;;;;UASzC,kBAAA;EACR,cAAA;AAAA;AAAA,KAGG,iBAAA,IAAqB,KAAA,WAAgB,IAAA,EAAM,kBAAA;AAAA,UAE/B,0BAAA;EAF+B;;;;AAEhD;EAME,aAAA,GAAgB,iBAAA;;;;;;EAMhB,kBAAA,GAAqB,iBAAA;EANrB;;;;;EAYA,eAAA,GAAkB,iBAAA;AAAA;AAAA,UAGH,wBAAA,SAAiC,0BAAA;EAAjC;;;;;;;;;EAUf,MAAA,GAAS,MAAA,UAAgB,MAAA;AAAA;AAAA,UAGjB,sBAAA;EACR,aAAA,EAAe,iBAAA;EACf,kBAAA,EAAoB,iBAAA;EACpB,eAAA,EAAiB,iBAAA;AAAA;;;;;;;;;;;;;;;AAqCnB;;;;;;;;;;;iBAAgB,iBAAA,CACd,OAAA,GAAS,wBAAA,GACR,sBAAA"}

package/dist/react-error-handler.mjs

@@ -2,17 +2,23 @@
 import { captureReactError } from "./internal/capture.mjs";
 import { MECHANISM_TYPE } from "@interfere/types/sdk/errors";
 //#region src/react-error-handler.ts
+function resolveKernel(source) {
+	if (!source) return null;
+	return typeof source === "function" ? source() : source;
+}
 /**
 * Creates the three error callbacks React 19's `createRoot()` / `hydrateRoot()`
 * accept, wired into Interfere's capture pipeline.
 *
 * ```ts
 * import { createRoot } from "react-dom/client";
+* import { getKernelOrNull } from "@interfere/next";
 * import { reactErrorHandler } from "@interfere/react/react-error-handler";
 *
-* createRoot(document.getElementById("root")!, reactErrorHandler()).render(
-*   <App />
-* );
+* createRoot(
+*   document.getElementById("root")!,
+*   reactErrorHandler({ kernel: getKernelOrNull })
+* ).render(<App />);
 * ```
 *
 * Pass your own callbacks to observe errors without replacing the capture
@@ -20,28 +26,30 @@ import { MECHANISM_TYPE } from "@interfere/types/sdk/errors";
 *
 * ```ts
 * reactErrorHandler({
+*   kernel: getKernelOrNull,
 *   onUncaughtError: (err) => myLogger.fatal(err),
 * });
 * ```
 */
-function reactErrorHandler(callbacks = {}) {
+function reactErrorHandler(options = {}) {
+	const { kernel: kernelSource, ...callbacks } = options;
 	return {
 		onCaughtError(error, info) {
-			if (error instanceof Error) captureReactError(error, info.componentStack, {
+			if (error instanceof Error) captureReactError(resolveKernel(kernelSource), error, info.componentStack, {
 				type: MECHANISM_TYPE.react.caughtError,
 				handled: true
 			});
 			callbacks.onCaughtError?.(error, info);
 		},
 		onUncaughtError(error, info) {
-			if (error instanceof Error) captureReactError(error, info.componentStack, {
+			if (error instanceof Error) captureReactError(resolveKernel(kernelSource), error, info.componentStack, {
 				type: MECHANISM_TYPE.react.uncaughtError,
 				handled: false
 			});
 			callbacks.onUncaughtError?.(error, info);
 		},
 		onRecoverableError(error, info) {
-			if (error instanceof Error) captureReactError(error, info.componentStack, {
+			if (error instanceof Error) captureReactError(resolveKernel(kernelSource), error, info.componentStack, {
 				type: MECHANISM_TYPE.react.recoverableError,
 				handled: true,
 				synthetic: true

package/dist/react-error-handler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"react-error-handler.mjs","names":[],"sources":["../src/react-error-handler.ts"],"sourcesContent":["\"use client\";\n\nimport { MECHANISM_TYPE } from \"@interfere/types/sdk/errors\";\n\nimport { captureReactError } from \"./internal/capture.js\";\n\n/**\n * Matches the shape React 19 passes to `onCaughtError`, `onUncaughtError`,\n * and `onRecoverableError` on `createRoot()` / `hydrateRoot()`.\n *\n * We intentionally keep this permissive — React has iterated on the exact\n * fields of `ErrorInfo` across 19.x minors and we only need `componentStack`.\n */\ninterface ReactRootErrorInfo {\n  componentStack?: string | null | undefined;\n}\n\ntype RootErrorCallback = (error: unknown, info: ReactRootErrorInfo) => void;\n\nexport interface ReactErrorHandlerCallbacks {\n  /**\n   * Called when a React error boundary caught and handled an error. Interfere\n   * reports it with `mechanism.handled: true`. Your callback runs after the\n   * capture.\n   */\n  onCaughtError?: RootErrorCallback;\n  /**\n   * Called when concurrent React auto-recovered from an error by retrying\n   * the render. Reported with `mechanism.synthetic: true` so the agent can\n   * deprioritize — these often aren't user-facing bugs.\n   */\n  onRecoverableError?: RootErrorCallback;\n  /**\n   * Called when a render-phase error propagated past every boundary and\n   * React unmounted (or fell back to its default UI). Reported with\n   * `mechanism.handled: false` — this is the \"real\" uncaught case.\n   */\n  onUncaughtError?: RootErrorCallback;\n}\n\nexport interface ReactErrorHandlerOptions extends ReactErrorHandlerCallbacks {}\n\ninterface ReactRootErrorHandlers {\n  onCaughtError: RootErrorCallback;\n  onRecoverableError: RootErrorCallback;\n  onUncaughtError: RootErrorCallback;\n}\n\n/**\n * Creates the three error callbacks React 19's `createRoot()` / `hydrateRoot()`\n * accept, wired into Interfere's capture pipeline.\n *\n * ```ts\n * import { createRoot } from \"react-dom/client\";\n * import { reactErrorHandler } from \"@interfere/react/react-error-handler\";\n *\n * createRoot(document.getElementById(\"root\")!, reactErrorHandler()).render(\n *   <App />\n * );\n * ```\n *\n * Pass your own callbacks to observe errors without replacing the capture\n * behaviour — user callbacks run after Interfere has captured:\n *\n * ```ts\n * reactErrorHandler({\n *   onUncaughtError: (err) => myLogger.fatal(err),\n * });\n * ```\n */\nexport function reactErrorHandler(\n  callbacks: ReactErrorHandlerOptions = {}\n): ReactRootErrorHandlers {\n  return {\n    onCaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(error, info.componentStack, {\n          type: MECHANISM_TYPE.react.caughtError,\n          handled: true,\n        });\n      }\n      callbacks.onCaughtError?.(error, info);\n    },\n    onUncaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(error, info.componentStack, {\n          type: MECHANISM_TYPE.react.uncaughtError,\n          handled: false,\n        });\n      }\n      callbacks.onUncaughtError?.(error, info);\n    },\n    onRecoverableError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(error, info.componentStack, {\n          type: MECHANISM_TYPE.react.recoverableError,\n          handled: true,\n          synthetic: true,\n        });\n      }\n      callbacks.onRecoverableError?.(error, info);\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAsEA,SAAgB,kBACd,YAAsC,EAAE,EAChB;AACxB,QAAO;EACL,cAAc,OAAO,MAAM;AACzB,OAAI,iBAAiB,MACnB,mBAAkB,OAAO,KAAK,gBAAgB;IAC5C,MAAM,eAAe,MAAM;IAC3B,SAAS;IACV,CAAC;AAEJ,aAAU,gBAAgB,OAAO,KAAK;;EAExC,gBAAgB,OAAO,MAAM;AAC3B,OAAI,iBAAiB,MACnB,mBAAkB,OAAO,KAAK,gBAAgB;IAC5C,MAAM,eAAe,MAAM;IAC3B,SAAS;IACV,CAAC;AAEJ,aAAU,kBAAkB,OAAO,KAAK;;EAE1C,mBAAmB,OAAO,MAAM;AAC9B,OAAI,iBAAiB,MACnB,mBAAkB,OAAO,KAAK,gBAAgB;IAC5C,MAAM,eAAe,MAAM;IAC3B,SAAS;IACT,WAAW;IACZ,CAAC;AAEJ,aAAU,qBAAqB,OAAO,KAAK;;EAE9C"}
+{"version":3,"file":"react-error-handler.mjs","names":[],"sources":["../src/react-error-handler.ts"],"sourcesContent":["\"use client\";\n\nimport { MECHANISM_TYPE } from \"@interfere/types/sdk/errors\";\n\nimport { captureReactError } from \"./internal/capture.js\";\nimport type { Kernel } from \"./internal/kernel.js\";\n\n/**\n * Matches the shape React 19 passes to `onCaughtError`, `onUncaughtError`,\n * and `onRecoverableError` on `createRoot()` / `hydrateRoot()`.\n *\n * We intentionally keep this permissive — React has iterated on the exact\n * fields of `ErrorInfo` across 19.x minors and we only need `componentStack`.\n */\ninterface ReactRootErrorInfo {\n  componentStack?: string | null | undefined;\n}\n\ntype RootErrorCallback = (error: unknown, info: ReactRootErrorInfo) => void;\n\nexport interface ReactErrorHandlerCallbacks {\n  /**\n   * Called when a React error boundary caught and handled an error. Interfere\n   * reports it with `mechanism.handled: true`. Your callback runs after the\n   * capture.\n   */\n  onCaughtError?: RootErrorCallback;\n  /**\n   * Called when concurrent React auto-recovered from an error by retrying\n   * the render. Reported with `mechanism.synthetic: true` so the agent can\n   * deprioritize — these often aren't user-facing bugs.\n   */\n  onRecoverableError?: RootErrorCallback;\n  /**\n   * Called when a render-phase error propagated past every boundary and\n   * React unmounted (or fell back to its default UI). Reported with\n   * `mechanism.handled: false` — this is the \"real\" uncaught case.\n   */\n  onUncaughtError?: RootErrorCallback;\n}\n\nexport interface ReactErrorHandlerOptions extends ReactErrorHandlerCallbacks {\n  /**\n   * The kernel to capture errors against. Pass either the kernel directly\n   * or a getter — framework wrappers expose `getKernelOrNull()` for the\n   * latter pattern, which lets you wire the handler before `init()`\n   * resolves. Pass `getKernelOrNull` (not `getKernel`) — the throwing\n   * variant breaks this contract since the handler runs in error-recovery\n   * paths where rethrowing isn't useful. Capture is silently skipped when\n   * no kernel is available.\n   */\n  kernel?: Kernel | (() => Kernel | null) | null;\n}\n\ninterface ReactRootErrorHandlers {\n  onCaughtError: RootErrorCallback;\n  onRecoverableError: RootErrorCallback;\n  onUncaughtError: RootErrorCallback;\n}\n\nfunction resolveKernel(\n  source: ReactErrorHandlerOptions[\"kernel\"]\n): Kernel | null {\n  if (!source) {\n    return null;\n  }\n  return typeof source === \"function\" ? source() : source;\n}\n\n/**\n * Creates the three error callbacks React 19's `createRoot()` / `hydrateRoot()`\n * accept, wired into Interfere's capture pipeline.\n *\n * ```ts\n * import { createRoot } from \"react-dom/client\";\n * import { getKernelOrNull } from \"@interfere/next\";\n * import { reactErrorHandler } from \"@interfere/react/react-error-handler\";\n *\n * createRoot(\n *   document.getElementById(\"root\")!,\n *   reactErrorHandler({ kernel: getKernelOrNull })\n * ).render(<App />);\n * ```\n *\n * Pass your own callbacks to observe errors without replacing the capture\n * behaviour — user callbacks run after Interfere has captured:\n *\n * ```ts\n * reactErrorHandler({\n *   kernel: getKernelOrNull,\n *   onUncaughtError: (err) => myLogger.fatal(err),\n * });\n * ```\n */\nexport function reactErrorHandler(\n  options: ReactErrorHandlerOptions = {}\n): ReactRootErrorHandlers {\n  const { kernel: kernelSource, ...callbacks } = options;\n  return {\n    onCaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.caughtError,\n            handled: true,\n          }\n        );\n      }\n      callbacks.onCaughtError?.(error, info);\n    },\n    onUncaughtError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.uncaughtError,\n            handled: false,\n          }\n        );\n      }\n      callbacks.onUncaughtError?.(error, info);\n    },\n    onRecoverableError(error, info) {\n      if (error instanceof Error) {\n        captureReactError(\n          resolveKernel(kernelSource),\n          error,\n          info.componentStack,\n          {\n            type: MECHANISM_TYPE.react.recoverableError,\n            handled: true,\n            synthetic: true,\n          }\n        );\n      }\n      callbacks.onRecoverableError?.(error, info);\n    },\n  };\n}\n"],"mappings":";;;;AA4DA,SAAS,cACP,QACe;CACf,IAAI,CAAC,QACH,OAAO;CAET,OAAO,OAAO,WAAW,aAAa,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BnD,SAAgB,kBACd,UAAoC,EAAE,EACd;CACxB,MAAM,EAAE,QAAQ,cAAc,GAAG,cAAc;CAC/C,OAAO;EACL,cAAc,OAAO,MAAM;GACzB,IAAI,iBAAiB,OACnB,kBACE,cAAc,aAAa,EAC3B,OACA,KAAK,gBACL;IACE,MAAM,eAAe,MAAM;IAC3B,SAAS;IACV,CACF;GAEH,UAAU,gBAAgB,OAAO,KAAK;;EAExC,gBAAgB,OAAO,MAAM;GAC3B,IAAI,iBAAiB,OACnB,kBACE,cAAc,aAAa,EAC3B,OACA,KAAK,gBACL;IACE,MAAM,eAAe,MAAM;IAC3B,SAAS;IACV,CACF;GAEH,UAAU,kBAAkB,OAAO,KAAK;;EAE1C,mBAAmB,OAAO,MAAM;GAC9B,IAAI,iBAAiB,OACnB,kBACE,cAAc,aAAa,EAC3B,OACA,KAAK,gBACL;IACE,MAAM,eAAe,MAAM;IAC3B,SAAS;IACT,WAAW;IACZ,CACF;GAEH,UAAU,qBAAqB,OAAO,KAAK;;EAE9C"}

package/dist/sw.d.mts

@@ -0,0 +1,2 @@
+// AUTOGENERATED by scripts/build-sw.ts — do not edit.
+export declare const SW_SCRIPT: string;

package/dist/sw.mjs

@@ -0,0 +1,2 @@
+// AUTOGENERATED by scripts/build-sw.ts — do not edit.
+export const SW_SCRIPT = "(function(){try{self[`workbox:core:7.4.0`]&&_()}catch{}let e=(e,...t)=>{let n=e;return t.length>0&&(n+=` :: ${JSON.stringify(t)}`),n};var t=class extends Error{constructor(t,n){let r=e(t,n);super(r),this.name=t,this.details=n}};let n=(e,t)=>t.some(t=>e instanceof t),r,i;function a(){return r||=[IDBDatabase,IDBObjectStore,IDBIndex,IDBCursor,IDBTransaction]}function o(){return i||=[IDBCursor.prototype.advance,IDBCursor.prototype.continue,IDBCursor.prototype.continuePrimaryKey]}let s=new WeakMap,c=new WeakMap,l=new WeakMap,u=new WeakMap,d=new WeakMap;function f(e){let t=new Promise((t,n)=>{let r=()=>{e.removeEventListener(`success`,i),e.removeEventListener(`error`,a)},i=()=>{t(y(e.result)),r()},a=()=>{n(e.error),r()};e.addEventListener(`success`,i),e.addEventListener(`error`,a)});return t.then(t=>{t instanceof IDBCursor&&s.set(t,e)}).catch(()=>{}),d.set(t,e),t}function p(e){if(c.has(e))return;let t=new Promise((t,n)=>{let r=()=>{e.removeEventListener(`complete`,i),e.removeEventListener(`error`,a),e.removeEventListener(`abort`,a)},i=()=>{t(),r()},a=()=>{n(e.error||new DOMException(`AbortError`,`AbortError`)),r()};e.addEventListener(`complete`,i),e.addEventListener(`error`,a),e.addEventListener(`abort`,a)});c.set(e,t)}let m={get(e,t,n){if(e instanceof IDBTransaction){if(t===`done`)return c.get(e);if(t===`objectStoreNames`)return e.objectStoreNames||l.get(e);if(t===`store`)return n.objectStoreNames[1]?void 0:n.objectStore(n.objectStoreNames[0])}return y(e[t])},set(e,t,n){return e[t]=n,!0},has(e,t){return e instanceof IDBTransaction&&(t===`done`||t===`store`)?!0:t in e}};function h(e){m=e(m)}function g(e){return e===IDBDatabase.prototype.transaction&&!(`objectStoreNames`in IDBTransaction.prototype)?function(t,...n){let r=e.call(b(this),t,...n);return l.set(r,t.sort?t.sort():[t]),y(r)}:o().includes(e)?function(...t){return e.apply(b(this),t),y(s.get(this))}:function(...t){return y(e.apply(b(this),t))}}function v(e){return typeof e==`function`?g(e):(e instanceof IDBTransaction&&p(e),n(e,a())?new Proxy(e,m):e)}function y(e){if(e instanceof IDBRequest)return f(e);if(u.has(e))return u.get(e);let t=v(e);return t!==e&&(u.set(e,t),d.set(t,e)),t}let b=e=>d.get(e);function x(e,t,{blocked:n,upgrade:r,blocking:i,terminated:a}={}){let o=indexedDB.open(e,t),s=y(o);return r&&o.addEventListener(`upgradeneeded`,e=>{r(y(o.result),e.oldVersion,e.newVersion,y(o.transaction),e)}),n&&o.addEventListener(`blocked`,e=>n(e.oldVersion,e.newVersion,e)),s.then(e=>{a&&e.addEventListener(`close`,()=>a()),i&&e.addEventListener(`versionchange`,e=>i(e.oldVersion,e.newVersion,e))}).catch(()=>{}),s}let S=[`get`,`getKey`,`getAll`,`getAllKeys`,`count`],C=[`put`,`add`,`delete`,`clear`],w=new Map;function T(e,t){if(!(e instanceof IDBDatabase&&!(t in e)&&typeof t==`string`))return;if(w.get(t))return w.get(t);let n=t.replace(/FromIndex$/,``),r=t!==n,i=C.includes(n);if(!(n in(r?IDBIndex:IDBObjectStore).prototype)||!(i||S.includes(n)))return;let a=async function(e,...t){let a=this.transaction(e,i?`readwrite`:`readonly`),o=a.store;return r&&(o=o.index(t.shift())),(await Promise.all([o[n](...t),i&&a.done]))[0]};return w.set(t,a),a}h(e=>({...e,get:(t,n,r)=>T(t,n)||e.get(t,n,r),has:(t,n)=>!!T(t,n)||e.has(t,n)}));try{self[`workbox:background-sync:7.4.0`]&&_()}catch{}let E=`requests`,D=`queueName`;var O=class{constructor(){this._db=null}async addEntry(e){let t=(await this.getDb()).transaction(E,`readwrite`,{durability:`relaxed`});await t.store.add(e),await t.done}async getFirstEntryId(){return(await(await this.getDb()).transaction(E).store.openCursor())?.value.id}async getAllEntriesByQueueName(e){return await(await this.getDb()).getAllFromIndex(E,D,IDBKeyRange.only(e))||[]}async getEntryCountByQueueName(e){return(await this.getDb()).countFromIndex(E,D,IDBKeyRange.only(e))}async deleteEntry(e){await(await this.getDb()).delete(E,e)}async getFirstEntryByQueueName(e){return await this.getEndEntryFromIndex(IDBKeyRange.only(e),`next`)}async getLastEntryByQueueName(e){return await this.getEndEntryFromIndex(IDBKeyRange.only(e),`prev`)}async getEndEntryFromIndex(e,t){return(await(await this.getDb()).transaction(E).store.index(D).openCursor(e,t))?.value}async getDb(){return this._db||=await x(`workbox-background-sync`,3,{upgrade:this._upgradeDb}),this._db}_upgradeDb(e,t){t>0&&t<3&&e.objectStoreNames.contains(E)&&e.deleteObjectStore(E),e.createObjectStore(E,{autoIncrement:!0,keyPath:`id`}).createIndex(D,D,{unique:!1})}},k=class{constructor(e){this._queueName=e,this._queueDb=new O}async pushEntry(e){delete e.id,e.queueName=this._queueName,await this._queueDb.addEntry(e)}async unshiftEntry(e){let t=await this._queueDb.getFirstEntryId();t?e.id=t-1:delete e.id,e.queueName=this._queueName,await this._queueDb.addEntry(e)}async popEntry(){return this._removeEntry(await this._queueDb.getLastEntryByQueueName(this._queueName))}async shiftEntry(){return this._removeEntry(await this._queueDb.getFirstEntryByQueueName(this._queueName))}async getAll(){return await this._queueDb.getAllEntriesByQueueName(this._queueName)}async size(){return await this._queueDb.getEntryCountByQueueName(this._queueName)}async deleteEntry(e){await this._queueDb.deleteEntry(e)}async _removeEntry(e){return e&&await this.deleteEntry(e.id),e}};let A=[`method`,`referrer`,`referrerPolicy`,`mode`,`credentials`,`cache`,`redirect`,`integrity`,`keepalive`];var j=class e{static async fromRequest(t){let n={url:t.url,headers:{}};t.method!==`GET`&&(n.body=await t.clone().arrayBuffer());for(let[e,r]of t.headers.entries())n.headers[e]=r;for(let e of A)t[e]!==void 0&&(n[e]=t[e]);return new e(n)}constructor(e){e.mode===`navigate`&&(e.mode=`same-origin`),this._requestData=e}toObject(){let e=Object.assign({},this._requestData);return e.headers=Object.assign({},this._requestData.headers),e.body&&=e.body.slice(0),e}toRequest(){return new Request(this._requestData.url,this._requestData)}clone(){return new e(this.toObject())}};let M=`workbox-background-sync`,N=new Set,P=e=>{let t={request:new j(e.requestData).toRequest(),timestamp:e.timestamp};return e.metadata&&(t.metadata=e.metadata),t};var F=class{constructor(e,{forceSyncFallback:n,onSync:r,maxRetentionTime:i}={}){if(this._syncInProgress=!1,this._requestsAddedDuringSync=!1,N.has(e))throw new t(`duplicate-queue-name`,{name:e});N.add(e),this._name=e,this._onSync=r||this.replayRequests,this._maxRetentionTime=i||10080,this._forceSyncFallback=!!n,this._queueStore=new k(this._name),this._addSyncListener()}get name(){return this._name}async pushRequest(e){await this._addRequest(e,`push`)}async unshiftRequest(e){await this._addRequest(e,`unshift`)}async popRequest(){return this._removeRequest(`pop`)}async shiftRequest(){return this._removeRequest(`shift`)}async getAll(){let e=await this._queueStore.getAll(),t=Date.now(),n=[];for(let r of e){let e=this._maxRetentionTime*60*1e3;t-r.timestamp>e?await this._queueStore.deleteEntry(r.id):n.push(P(r))}return n}async size(){return await this._queueStore.size()}async _addRequest({request:e,metadata:t,timestamp:n=Date.now()},r){let i={requestData:(await j.fromRequest(e.clone())).toObject(),timestamp:n};switch(t&&(i.metadata=t),r){case`push`:await this._queueStore.pushEntry(i);break;case`unshift`:await this._queueStore.unshiftEntry(i);break}this._syncInProgress?this._requestsAddedDuringSync=!0:await this.registerSync()}async _removeRequest(e){let t=Date.now(),n;switch(e){case`pop`:n=await this._queueStore.popEntry();break;case`shift`:n=await this._queueStore.shiftEntry();break}if(n){let r=this._maxRetentionTime*60*1e3;return t-n.timestamp>r?this._removeRequest(e):P(n)}else return}async replayRequests(){let e;for(;e=await this.shiftRequest();)try{await fetch(e.request.clone())}catch{throw await this.unshiftRequest(e),new t(`queue-replay-failed`,{name:this._name})}}async registerSync(){if(`sync`in self.registration&&!this._forceSyncFallback)try{await self.registration.sync.register(`${M}:${this._name}`)}catch{}}_addSyncListener(){`sync`in self.registration&&!this._forceSyncFallback?self.addEventListener(`sync`,e=>{e.tag===`${M}:${this._name}`&&e.waitUntil((async()=>{this._syncInProgress=!0;let t;try{await this._onSync({queue:this})}catch(e){if(e instanceof Error)throw t=e,t}finally{this._requestsAddedDuringSync&&!(t&&!e.lastChance)&&await this.registerSync(),this._syncInProgress=!1,this._requestsAddedDuringSync=!1}})())}):this._onSync({queue:this})}static get _queueNames(){return N}};let I={status:202,statusText:`Queued`};async function L(e){let t=await self.clients.matchAll({includeUncontrolled:!1});for(let n of t)n.postMessage(e)}async function R(e){let t=await e.getAll(),n=0;for(let e of t){let t=e.metadata;typeof t?.bytes==`number`&&(n+=t.bytes)}return n}async function z(e,t){let n=await R(e);for(;n+t>10485760;){let t=await e.shiftRequest();if(!t)break;let r=t.metadata;n-=r?.bytes??0,await L({type:`interfere.sw.dropped`,url:t.request.url,reason:`queue_size_cap`})}}async function B(e,t){let n=t.clone(),r=(await n.clone().arrayBuffer()).byteLength;await z(e,r),await e.pushRequest({request:n,metadata:{bytes:r}}),await L({type:`interfere.sw.queued`,url:t.url})}let V=new F(`interfere-ingest`,{maxRetentionTime:1440,onSync:async({queue:e})=>{let t=await e.shiftRequest();for(;t;){try{let e=await fetch(t.request.clone());if(!e.ok&&(e.status>=500||e.status===429))throw Error(`retry status ${e.status}`);await L({type:`interfere.sw.replayed`,url:t.request.url})}catch(n){throw await e.unshiftRequest(t),n}t=await e.shiftRequest()}}});self.addEventListener(`install`,()=>{self.skipWaiting()}),self.addEventListener(`activate`,e=>{e.waitUntil((async()=>{await self.clients.claim(),V.replayRequests().catch(()=>{})})())}),self.addEventListener(`fetch`,e=>{let{request:t}=e;if(t.method!==`POST`)return;let n;try{n=new URL(t.url)}catch{return}n.pathname.startsWith(`/api/interfere/`)&&e.respondWith((async()=>{try{let e=await fetch(t.clone());return e.ok?e:e.status>=500||e.status===429?(await B(V,t),new Response(null,I)):e}catch{return await B(V,t),new Response(null,I)}})())})})();";