@interfere/react 1.0.0-alpha.7 → 1.0.1

package/dist/tracking/api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.mjs","names":[],"sources":["../../src/tracking/api.ts"],"sourcesContent":["import type { IdentifyParams } from \"@interfere/types/sdk/identify\";\n\nimport { buildHeaders, type IngestTarget } from \"../transport/http.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { SessionManager } from \"./session.js\";\nimport { getVisitorId, 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  fetch(url, {\n    method,\n    headers: buildHeaders(headers),\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\nexport function bootstrap(sessionTarget: IngestTarget): void {\n  target = sessionTarget;\n\n  mgr = new SessionManager((id) => {\n    onRotate(id).catch(() => {\n      /* best-effort */\n    });\n  });\n}\n\nexport const session = {\n  getId(): string | null {\n    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":";;;;;AAOA,MAAM,MAAM,aAAa,WAAW;AAEpC,IAAI,MAA6B;AACjC,IAAI,SAA8B;AAClC,IAAI,kBAAyC;AAC7C,IAAI,sBAAqC;AAEzC,SAAS,KACP,KACA,QACA,SACA,MACM;AACN,OAAM,KAAK;EACT;EACA,SAAS,aAAa,QAAQ;EAC9B,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;;AAGpE,SAAgB,UAAU,eAAmC;AAC3D,UAAS;AAET,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;
+  private lastActivityMs;
+  constructor(onRotate?: OnRotate);
+  getSessionId(): string;
+  getWindowId(): string;
+  private restore;
+  private rotate;
+  private touch;
+  private isExpired;
+}
+//#endregion
+export { OnRotate, SessionManager };

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

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

package/dist/tracking/session.mjs

@@ -0,0 +1,76 @@
+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;
+function tryStorage(type) {
+	try {
+		const s = globalThis[type];
+		const key = "__interfere_probe__";
+		s.setItem(key, "1");
+		s.removeItem(key);
+		return s;
+	} catch {
+		return null;
+	}
+}
+var SessionManager = class {
+	sessionId = null;
+	windowId = null;
+	local;
+	session;
+	onRotate = null;
+	lastActivityMs = 0;
+	constructor(onRotate) {
+		this.local = tryStorage("localStorage");
+		this.session = tryStorage("sessionStorage");
+		this.onRotate = onRotate ?? null;
+		this.restore();
+	}
+	getSessionId() {
+		if (this.sessionId && !this.isExpired()) {
+			this.touch();
+			return this.sessionId;
+		}
+		return this.rotate();
+	}
+	getWindowId() {
+		if (this.windowId) return this.windowId;
+		const stored = this.session?.getItem(WINDOW_ID_KEY);
+		if (stored) {
+			this.windowId = stored;
+			return stored;
+		}
+		this.windowId = `win_${nanoid(10)}`;
+		this.session?.setItem(WINDOW_ID_KEY, this.windowId);
+		return this.windowId;
+	}
+	restore() {
+		const stored = this.local?.getItem(SESSION_ID_KEY);
+		if (stored && !this.isExpired()) {
+			this.sessionId = stored;
+			this.touch();
+		} else this.rotate();
+	}
+	rotate() {
+		this.sessionId = v7();
+		this.local?.setItem(SESSION_ID_KEY, this.sessionId);
+		this.touch();
+		this.onRotate?.(this.sessionId);
+		return this.sessionId;
+	}
+	touch() {
+		this.lastActivityMs = Date.now();
+		this.local?.setItem(LAST_ACTIVITY_KEY, String(this.lastActivityMs));
+	}
+	isExpired() {
+		const raw = this.local?.getItem(LAST_ACTIVITY_KEY);
+		const ts = raw ? Number(raw) : this.lastActivityMs;
+		if (ts === 0) return true;
+		return Date.now() - ts > SESSION_TIMEOUT_MS;
+	}
+};
+//#endregion
+export { SessionManager };

package/dist/tracking/session.mjs.map

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

package/dist/tracking/visitor.d.mts

@@ -0,0 +1,7 @@
+//#region src/tracking/visitor.d.ts
+declare function initVisitor(): void;
+declare function getVisitorId(): string | null;
+declare function whenVisitorReady(): Promise<string | null>;
+declare function resetVisitor(): void;
+//#endregion
+export { getVisitorId, initVisitor, resetVisitor, whenVisitorReady };

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

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.d.mts","names":[],"sources":["../../src/tracking/visitor.ts"],"mappings":";iBAcgB,WAAA,CAAA;AAAA,iBA+BA,YAAA,CAAA;AAAA,iBAIA,gBAAA,CAAA,GAAoB,OAAA;AAAA,iBAOpB,YAAA,CAAA"}

package/dist/tracking/visitor.mjs

@@ -0,0 +1,40 @@
+import { createLogger } from "../util/log.mjs";
+//#region src/tracking/visitor.ts
+const log = createLogger("visitor");
+let visitorId = null;
+let pending = null;
+function resolveApiKey() {
+	if (typeof process === "undefined") return;
+	return process.env.INTERFERE_FINGERPRINT_KEY ?? void 0;
+}
+function initVisitor() {
+	if (visitorId || pending) return;
+	const apiKey = resolveApiKey();
+	if (!apiKey) {
+		log.info("no INTERFERE_FINGERPRINT_KEY, skipping");
+		return;
+	}
+	pending = (async () => {
+		try {
+			visitorId = (await (await (await import("@fingerprintjs/fingerprintjs-pro")).load({ apiKey })).get()).visitorId;
+			log.debug("resolved %s", visitorId);
+			return visitorId;
+		} catch {
+			log.error("fingerprint failed");
+			return null;
+		}
+	})();
+}
+function getVisitorId() {
+	return visitorId;
+}
+function whenVisitorReady() {
+	if (visitorId) return Promise.resolve(visitorId);
+	return pending ?? Promise.resolve(null);
+}
+function resetVisitor() {
+	visitorId = null;
+	pending = null;
+}
+//#endregion
+export { getVisitorId, initVisitor, resetVisitor, whenVisitorReady };

package/dist/tracking/visitor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.mjs","names":[],"sources":["../../src/tracking/visitor.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"visitor\");\n\nlet visitorId: string | null = null;\nlet pending: Promise<string | null> | null = null;\n\nfunction resolveApiKey(): string | undefined {\n  if (typeof process === \"undefined\") {\n    return undefined;\n  }\n  return process.env.INTERFERE_FINGERPRINT_KEY ?? undefined;\n}\n\nexport function initVisitor(): void {\n  if (visitorId || pending) {\n    return;\n  }\n\n  const apiKey = resolveApiKey();\n  if (!apiKey) {\n    log.info(\"no INTERFERE_FINGERPRINT_KEY, skipping\");\n    return;\n  }\n\n  pending = (async () => {\n    try {\n      const FingerprintJS = await import(\"@fingerprintjs/fingerprintjs-pro\");\n\n      const fp = await FingerprintJS.load({ apiKey });\n      const result = await fp.get();\n\n      visitorId = result.visitorId;\n\n      log.debug(\"resolved %s\", visitorId);\n\n      return visitorId;\n    } catch {\n      log.error(\"fingerprint failed\");\n\n      return null;\n    }\n  })();\n}\n\nexport function getVisitorId(): string | null {\n  return visitorId;\n}\n\nexport function whenVisitorReady(): Promise<string | null> {\n  if (visitorId) {\n    return Promise.resolve(visitorId);\n  }\n  return pending ?? Promise.resolve(null);\n}\n\nexport function resetVisitor(): void {\n  visitorId = null;\n  pending = null;\n}\n"],"mappings":";;AAEA,MAAM,MAAM,aAAa,UAAU;AAEnC,IAAI,YAA2B;AAC/B,IAAI,UAAyC;AAE7C,SAAS,gBAAoC;AAC3C,KAAI,OAAO,YAAY,YACrB;AAEF,QAAO,QAAQ,IAAI,6BAA6B,KAAA;;AAGlD,SAAgB,cAAoB;AAClC,KAAI,aAAa,QACf;CAGF,MAAM,SAAS,eAAe;AAC9B,KAAI,CAAC,QAAQ;AACX,MAAI,KAAK,yCAAyC;AAClD;;AAGF,YAAW,YAAY;AACrB,MAAI;AAMF,gBAFe,OADJ,OAFW,MAAM,OAAO,qCAEJ,KAAK,EAAE,QAAQ,CAAC,EACvB,KAAK,EAEV;AAEnB,OAAI,MAAM,eAAe,UAAU;AAEnC,UAAO;UACD;AACN,OAAI,MAAM,qBAAqB;AAE/B,UAAO;;KAEP;;AAGN,SAAgB,eAA8B;AAC5C,QAAO;;AAGT,SAAgB,mBAA2C;AACzD,KAAI,UACF,QAAO,QAAQ,QAAQ,UAAU;AAEnC,QAAO,WAAW,QAAQ,QAAQ,KAAK;;AAGzC,SAAgB,eAAqB;AACnC,aAAY;AACZ,WAAU"}

package/dist/transport/http.d.mts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.mts","names":[],"sources":["../../src/transport/http.ts"],"mappings":";;;UAUiB,YAAA;EACf,OAAA,EAAS,OAAA;EACT,GAAA;AAAA;AAAA,iBAGc,YAAA,CAAa,IAAA,EAAM,OAAA,GAAU,MAAA;AAAA,cA4BhC,aAAA;EAAA,iBACM,MAAA;EAAA,QACT,gBAAA;cAEI,MAAA,EAAQ,YAAA;EAId,IAAA,CAAK,SAAA,EAAW,QAAA,KAAa,OAAA;AAAA"}

package/dist/transport/http.mjs

@@ -0,0 +1,56 @@
+import { createLogger } from "../util/log.mjs";
+import { getVisitorId } from "../tracking/visitor.mjs";
+import { session } from "../tracking/api.mjs";
+import { make } from "tctx/traceparent";
+//#region src/transport/http.ts
+const log = createLogger("http");
+function buildHeaders(base) {
+	const h = Object.fromEntries(base.entries());
+	h.traceparent = String(make());
+	const sessionId = session.getId();
+	if (sessionId) h["x-interfere-session"] = sessionId;
+	const visitorId = getVisitorId();
+	if (visitorId) h["x-interfere-visitor"] = visitorId;
+	return h;
+}
+function hasServiceWorker() {
+	return typeof navigator !== "undefined" && "serviceWorker" in navigator && navigator.serviceWorker.controller !== null;
+}
+const KEEPALIVE_BUDGET_BYTES = 61440;
+const MAX_CONCURRENT_KEEPALIVE = 15;
+var HttpTransport = class {
+	target;
+	pendingKeepalive = 0;
+	constructor(target) {
+		this.target = target;
+	}
+	async send(envelopes) {
+		const body = JSON.stringify(envelopes);
+		const headers = buildHeaders(this.target.headers);
+		if (hasServiceWorker()) {
+			log.debug("POST %d envelopes via SW", envelopes.length);
+			await fetch(this.target.url, {
+				method: "POST",
+				headers,
+				body
+			});
+			return;
+		}
+		const bytes = new TextEncoder().encode(body).byteLength;
+		const useKeepalive = bytes < KEEPALIVE_BUDGET_BYTES && this.pendingKeepalive < MAX_CONCURRENT_KEEPALIVE;
+		if (useKeepalive) this.pendingKeepalive++;
+		log.debug("POST %d envelopes direct (%d bytes, keepalive=%s)", envelopes.length, bytes, useKeepalive);
+		try {
+			await fetch(this.target.url, {
+				method: "POST",
+				headers,
+				body,
+				keepalive: useKeepalive
+			});
+		} finally {
+			if (useKeepalive) this.pendingKeepalive--;
+		}
+	}
+};
+//#endregion
+export { HttpTransport, buildHeaders };

package/dist/transport/http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.mjs","names":[],"sources":["../../src/transport/http.ts"],"sourcesContent":["import type { Envelope } from \"@interfere/types/sdk/envelope\";\n\nimport { make } from \"tctx/traceparent\";\n\nimport { session } from \"../tracking/api.js\";\nimport { getVisitorId } from \"../tracking/visitor.js\";\nimport { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"http\");\n\nexport interface IngestTarget {\n  headers: Headers;\n  url: string;\n}\n\nexport function buildHeaders(base: Headers): Record<string, string> {\n  const h: Record<string, string> = Object.fromEntries(base.entries());\n  h.traceparent = String(make());\n\n  const sessionId = session.getId();\n  if (sessionId) {\n    h[\"x-interfere-session\"] = sessionId;\n  }\n\n  const visitorId = getVisitorId();\n  if (visitorId) {\n    h[\"x-interfere-visitor\"] = visitorId;\n  }\n\n  return h;\n}\n\nfunction hasServiceWorker(): boolean {\n  return (\n    typeof navigator !== \"undefined\" &&\n    \"serviceWorker\" in navigator &&\n    navigator.serviceWorker.controller !== null\n  );\n}\n\nconst KEEPALIVE_BUDGET_BYTES = 61_440;\nconst MAX_CONCURRENT_KEEPALIVE = 15;\n\nexport class HttpTransport {\n  private readonly target: IngestTarget;\n  private pendingKeepalive = 0;\n\n  constructor(target: IngestTarget) {\n    this.target = target;\n  }\n\n  async send(envelopes: Envelope[]): Promise<void> {\n    const body = JSON.stringify(envelopes);\n    const headers = buildHeaders(this.target.headers);\n\n    if (hasServiceWorker()) {\n      log.debug(\"POST %d envelopes via SW\", envelopes.length);\n      await fetch(this.target.url, {\n        method: \"POST\",\n        headers,\n        body,\n      });\n      return;\n    }\n\n    const bytes = new TextEncoder().encode(body).byteLength;\n    const useKeepalive =\n      bytes < KEEPALIVE_BUDGET_BYTES &&\n      this.pendingKeepalive < MAX_CONCURRENT_KEEPALIVE;\n\n    if (useKeepalive) {\n      this.pendingKeepalive++;\n    }\n\n    log.debug(\n      \"POST %d envelopes direct (%d bytes, keepalive=%s)\",\n      envelopes.length,\n      bytes,\n      useKeepalive\n    );\n\n    try {\n      await fetch(this.target.url, {\n        method: \"POST\",\n        headers,\n        body,\n        keepalive: useKeepalive,\n      });\n    } finally {\n      if (useKeepalive) {\n        this.pendingKeepalive--;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAQA,MAAM,MAAM,aAAa,OAAO;AAOhC,SAAgB,aAAa,MAAuC;CAClE,MAAM,IAA4B,OAAO,YAAY,KAAK,SAAS,CAAC;AACpE,GAAE,cAAc,OAAO,MAAM,CAAC;CAE9B,MAAM,YAAY,QAAQ,OAAO;AACjC,KAAI,UACF,GAAE,yBAAyB;CAG7B,MAAM,YAAY,cAAc;AAChC,KAAI,UACF,GAAE,yBAAyB;AAG7B,QAAO;;AAGT,SAAS,mBAA4B;AACnC,QACE,OAAO,cAAc,eACrB,mBAAmB,aACnB,UAAU,cAAc,eAAe;;AAI3C,MAAM,yBAAyB;AAC/B,MAAM,2BAA2B;AAEjC,IAAa,gBAAb,MAA2B;CACzB;CACA,mBAA2B;CAE3B,YAAY,QAAsB;AAChC,OAAK,SAAS;;CAGhB,MAAM,KAAK,WAAsC;EAC/C,MAAM,OAAO,KAAK,UAAU,UAAU;EACtC,MAAM,UAAU,aAAa,KAAK,OAAO,QAAQ;AAEjD,MAAI,kBAAkB,EAAE;AACtB,OAAI,MAAM,4BAA4B,UAAU,OAAO;AACvD,SAAM,MAAM,KAAK,OAAO,KAAK;IAC3B,QAAQ;IACR;IACA;IACD,CAAC;AACF;;EAGF,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,KAAK,CAAC;EAC7C,MAAM,eACJ,QAAQ,0BACR,KAAK,mBAAmB;AAE1B,MAAI,aACF,MAAK;AAGP,MAAI,MACF,qDACA,UAAU,QACV,OACA,aACD;AAED,MAAI;AACF,SAAM,MAAM,KAAK,OAAO,KAAK;IAC3B,QAAQ;IACR;IACA;IACA,WAAW;IACZ,CAAC;YACM;AACR,OAAI,aACF,MAAK"}

package/dist/transport/queue.d.mts

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

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

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

package/dist/transport/queue.mjs

@@ -0,0 +1,60 @@
+import { createLogger } from "../util/log.mjs";
+//#region src/transport/queue.ts
+const log = createLogger("queue");
+const DEFAULT_BATCH_SIZE = 10;
+const DEFAULT_BATCH_MS = 250;
+var BatchQueue = class {
+	buffer = [];
+	timer = null;
+	batchSize;
+	batchMs;
+	transport;
+	constructor(opts) {
+		this.batchSize = opts.batchSize ?? DEFAULT_BATCH_SIZE;
+		this.batchMs = opts.batchMs ?? DEFAULT_BATCH_MS;
+		this.transport = opts.transport;
+	}
+	start() {
+		if (this.timer) return;
+		this.timer = setInterval(() => {
+			this.flush();
+		}, this.batchMs);
+		if (typeof globalThis.addEventListener === "function") {
+			globalThis.addEventListener("visibilitychange", this.onVisibilityChange);
+			globalThis.addEventListener("beforeunload", this.onBeforeUnload);
+		}
+	}
+	enqueue(envelope) {
+		this.buffer.push(envelope);
+		if (this.buffer.length >= this.batchSize) this.flush();
+	}
+	flush() {
+		while (this.buffer.length > 0) {
+			const batch = this.buffer.splice(0, this.batchSize);
+			log.debug("flushing %d envelopes", batch.length);
+			this.transport.send(batch).catch(() => {
+				log.warn("send failed, re-queuing %d envelopes", batch.length);
+				this.buffer.unshift(...batch);
+			});
+		}
+	}
+	dispose() {
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = null;
+		}
+		if (typeof globalThis.removeEventListener === "function") {
+			globalThis.removeEventListener("visibilitychange", this.onVisibilityChange);
+			globalThis.removeEventListener("beforeunload", this.onBeforeUnload);
+		}
+		this.flush();
+	}
+	onVisibilityChange = () => {
+		if (document.visibilityState === "hidden") this.flush();
+	};
+	onBeforeUnload = () => {
+		this.flush();
+	};
+};
+//#endregion
+export { BatchQueue };

package/dist/transport/queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.mjs","names":[],"sources":["../../src/transport/queue.ts"],"sourcesContent":["import type { Envelope } from \"@interfere/types/sdk/envelope\";\n\nimport { createLogger } from \"../util/log.js\";\nimport type { HttpTransport } from \"./http.js\";\n\nconst log = createLogger(\"queue\");\n\nconst DEFAULT_BATCH_SIZE = 10;\nconst DEFAULT_BATCH_MS = 250;\n\nexport interface QueueOptions {\n  batchMs?: number;\n  batchSize?: number;\n  transport: HttpTransport;\n}\n\nexport class BatchQueue {\n  private readonly buffer: Envelope[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly batchSize: number;\n  private readonly batchMs: number;\n  private readonly transport: HttpTransport;\n\n  constructor(opts: QueueOptions) {\n    this.batchSize = opts.batchSize ?? DEFAULT_BATCH_SIZE;\n    this.batchMs = opts.batchMs ?? DEFAULT_BATCH_MS;\n    this.transport = opts.transport;\n  }\n\n  start(): void {\n    if (this.timer) {\n      return;\n    }\n\n    this.timer = setInterval(() => {\n      this.flush();\n    }, this.batchMs);\n\n    if (typeof globalThis.addEventListener === \"function\") {\n      globalThis.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n      globalThis.addEventListener(\"beforeunload\", this.onBeforeUnload);\n    }\n  }\n\n  enqueue(envelope: Envelope): void {\n    this.buffer.push(envelope);\n    if (this.buffer.length >= this.batchSize) {\n      this.flush();\n    }\n  }\n\n  flush(): void {\n    while (this.buffer.length > 0) {\n      const batch = this.buffer.splice(0, this.batchSize);\n      log.debug(\"flushing %d envelopes\", batch.length);\n      this.transport.send(batch).catch(() => {\n        log.warn(\"send failed, re-queuing %d envelopes\", batch.length);\n        this.buffer.unshift(...batch);\n      });\n    }\n  }\n\n  dispose(): void {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n\n    if (typeof globalThis.removeEventListener === \"function\") {\n      globalThis.removeEventListener(\n        \"visibilitychange\",\n        this.onVisibilityChange\n      );\n      globalThis.removeEventListener(\"beforeunload\", this.onBeforeUnload);\n    }\n\n    this.flush();\n  }\n\n  private readonly onVisibilityChange = (): void => {\n    if (document.visibilityState === \"hidden\") {\n      this.flush();\n    }\n  };\n\n  private readonly onBeforeUnload = (): void => {\n    this.flush();\n  };\n}\n"],"mappings":";;AAKA,MAAM,MAAM,aAAa,QAAQ;AAEjC,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AAQzB,IAAa,aAAb,MAAwB;CACtB,SAAsC,EAAE;CACxC,QAAuD;CACvD;CACA;CACA;CAEA,YAAY,MAAoB;AAC9B,OAAK,YAAY,KAAK,aAAa;AACnC,OAAK,UAAU,KAAK,WAAW;AAC/B,OAAK,YAAY,KAAK;;CAGxB,QAAc;AACZ,MAAI,KAAK,MACP;AAGF,OAAK,QAAQ,kBAAkB;AAC7B,QAAK,OAAO;KACX,KAAK,QAAQ;AAEhB,MAAI,OAAO,WAAW,qBAAqB,YAAY;AACrD,cAAW,iBAAiB,oBAAoB,KAAK,mBAAmB;AACxE,cAAW,iBAAiB,gBAAgB,KAAK,eAAe;;;CAIpE,QAAQ,UAA0B;AAChC,OAAK,OAAO,KAAK,SAAS;AAC1B,MAAI,KAAK,OAAO,UAAU,KAAK,UAC7B,MAAK,OAAO;;CAIhB,QAAc;AACZ,SAAO,KAAK,OAAO,SAAS,GAAG;GAC7B,MAAM,QAAQ,KAAK,OAAO,OAAO,GAAG,KAAK,UAAU;AACnD,OAAI,MAAM,yBAAyB,MAAM,OAAO;AAChD,QAAK,UAAU,KAAK,MAAM,CAAC,YAAY;AACrC,QAAI,KAAK,wCAAwC,MAAM,OAAO;AAC9D,SAAK,OAAO,QAAQ,GAAG,MAAM;KAC7B;;;CAIN,UAAgB;AACd,MAAI,KAAK,OAAO;AACd,iBAAc,KAAK,MAAM;AACzB,QAAK,QAAQ;;AAGf,MAAI,OAAO,WAAW,wBAAwB,YAAY;AACxD,cAAW,oBACT,oBACA,KAAK,mBACN;AACD,cAAW,oBAAoB,gBAAgB,KAAK,eAAe;;AAGrE,OAAK,OAAO;;CAGd,2BAAkD;AAChD,MAAI,SAAS,oBAAoB,SAC/B,MAAK,OAAO;;CAIhB,uBAA8C;AAC5C,OAAK,OAAO"}

package/dist/util/log.d.mts

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

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

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

package/dist/util/log.mjs

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

package/dist/util/log.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/react",
-  "version": "1.0.0-alpha.7",
+  "version": "1.0.1",
   "license": "MIT",
   "description": "Client-side React SDK for Interfere. Error tracking, session replay, and analytics.",
   "keywords": [