@interfere/react 9.0.2 → 10.0.1-canary.0

package/dist/tracking/api.mjs.map

@@ -1 +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 {\n  getDeviceId,\n  getFpHash,\n  initDevice,\n  whenDeviceReady,\n  whenFingerprintReady,\n} from \"./device.js\";\nimport { detectCountryCode, resetGeo } from \"./geo.js\";\nimport { SessionManager } from \"./session.js\";\n\nconst log = createLogger(\"tracking\");\n\nlet mgr: SessionManager | null = null;\nlet target: IngestTarget | null = null;\nlet currentIdentity: IdentifyParams | null = null;\nlet identifiedSessionId: string | null = null;\n\nlet syncedSessionId: string | null = null;\nlet syncAttemptMs = 0;\nlet generation = 0;\nconst SYNC_COOLDOWN_MS = 5000;\n\nfunction syncSession(\n  sessionId: string,\n  deviceId: string | null,\n  fpHash: string | null\n): void {\n  if (!target) {\n    return;\n  }\n\n  syncAttemptMs = Date.now();\n  syncedSessionId = sessionId;\n\n  fetch(target.url, {\n    method: \"POST\",\n    headers: buildHeaders(target.headers),\n    body: JSON.stringify({ sessionId, deviceId, fpHash }),\n    keepalive: true,\n    signal: AbortSignal.timeout(10_000),\n  })\n    .then((res) => {\n      if (!res.ok) {\n        syncedSessionId = null;\n      }\n    })\n    .catch(() => {\n      syncedSessionId = null;\n      log.warn(\"session sync failed, will retry\");\n    });\n}\n\nfunction ensureSynced(sessionId: string): void {\n  if (syncedSessionId === sessionId) {\n    return;\n  }\n  if (Date.now() - syncAttemptMs < SYNC_COOLDOWN_MS) {\n    return;\n  }\n  syncSession(sessionId, getDeviceId(), getFpHash());\n}\n\nasync function onRotate(sessionId: string): Promise<void> {\n  syncedSessionId = null;\n  syncAttemptMs = Date.now();\n  if (!target) {\n    return;\n  }\n  const gen = generation;\n  const [deviceId, fpHash] = await Promise.all([\n    whenDeviceReady(),\n    whenFingerprintReady(),\n  ]);\n  if (gen !== generation) {\n    return;\n  }\n  log.debug(\n    \"POST session %s (device=%s fp=%s)\",\n    sessionId,\n    deviceId ?? \"pending\",\n    fpHash ?? \"none\"\n  );\n  syncSession(sessionId, deviceId, fpHash);\n}\n\nexport function bootstrap(sessionTarget: IngestTarget): void {\n  target = sessionTarget;\n  initDevice();\n  detectCountryCode();\n\n  mgr = new SessionManager((id) => {\n    onRotate(id).catch(() => {\n      /* best-effort */\n    });\n  });\n}\n\nexport const device = {\n  getDeviceId(): string | null {\n    return getDeviceId();\n  },\n\n  getFpHash(): string | null {\n    return getFpHash();\n  },\n};\n\nexport const session = {\n  getId(): string | null {\n    const id = mgr?.getSessionId() ?? null;\n    if (id) {\n      ensureSynced(id);\n    }\n    return id;\n  },\n\n  getWindowId(): string | null {\n    return mgr?.getWindowId() ?? null;\n  },\n};\n\nexport const identity = {\n  get(): IdentifyParams | null {\n    return currentIdentity;\n  },\n\n  async set(params: IdentifyParams): Promise<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 gen = generation;\n    const [deviceId, fpHash, country] = await Promise.all([\n      whenDeviceReady(),\n      whenFingerprintReady(),\n      detectCountryCode(),\n    ]);\n    if (gen !== generation || !target) {\n      identifiedSessionId = null;\n      return;\n    }\n    log.info(\"PUT session %s → user %s\", sessionId, params.identifier);\n    fetch(target.url, {\n      method: \"PUT\",\n      headers: buildHeaders(target.headers),\n      body: JSON.stringify({\n        sessionId,\n        deviceId,\n        fpHash,\n        ...params,\n        ...(country && { country }),\n      }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    }).catch(() => {\n      identifiedSessionId = null;\n      log.warn(\"identify failed for session %s\", sessionId);\n    });\n  },\n\n  clear(): void {\n    currentIdentity = null;\n    identifiedSessionId = null;\n  },\n};\n\nexport function teardown(): void {\n  generation += 1;\n  identity.clear();\n  resetGeo();\n  syncedSessionId = null;\n  syncAttemptMs = 0;\n  mgr = null;\n  target = null;\n}\n"],"mappings":";;;;;;AAcA,MAAM,MAAM,aAAa,WAAW;AAEpC,IAAI,MAA6B;AACjC,IAAI,SAA8B;AAClC,IAAI,kBAAyC;AAC7C,IAAI,sBAAqC;AAEzC,IAAI,kBAAiC;AACrC,IAAI,gBAAgB;AACpB,IAAI,aAAa;AACjB,MAAM,mBAAmB;AAEzB,SAAS,YACP,WACA,UACA,QACM;AACN,KAAI,CAAC,OACH;AAGF,iBAAgB,KAAK,KAAK;AAC1B,mBAAkB;AAElB,OAAM,OAAO,KAAK;EAChB,QAAQ;EACR,SAAS,aAAa,OAAO,QAAQ;EACrC,MAAM,KAAK,UAAU;GAAE;GAAW;GAAU;GAAQ,CAAC;EACrD,WAAW;EACX,QAAQ,YAAY,QAAQ,IAAO;EACpC,CAAC,CACC,MAAM,QAAQ;AACb,MAAI,CAAC,IAAI,GACP,mBAAkB;GAEpB,CACD,YAAY;AACX,oBAAkB;AAClB,MAAI,KAAK,kCAAkC;GAC3C;;AAGN,SAAS,aAAa,WAAyB;AAC7C,KAAI,oBAAoB,UACtB;AAEF,KAAI,KAAK,KAAK,GAAG,gBAAgB,iBAC/B;AAEF,aAAY,WAAW,aAAa,EAAE,WAAW,CAAC;;AAGpD,eAAe,SAAS,WAAkC;AACxD,mBAAkB;AAClB,iBAAgB,KAAK,KAAK;AAC1B,KAAI,CAAC,OACH;CAEF,MAAM,MAAM;CACZ,MAAM,CAAC,UAAU,UAAU,MAAM,QAAQ,IAAI,CAC3C,iBAAiB,EACjB,sBAAsB,CACvB,CAAC;AACF,KAAI,QAAQ,WACV;AAEF,KAAI,MACF,qCACA,WACA,YAAY,WACZ,UAAU,OACX;AACD,aAAY,WAAW,UAAU,OAAO;;AAG1C,SAAgB,UAAU,eAAmC;AAC3D,UAAS;AACT,aAAY;AACZ,oBAAmB;AAEnB,OAAM,IAAI,gBAAgB,OAAO;AAC/B,WAAS,GAAG,CAAC,YAAY,GAEvB;GACF;;AAGJ,MAAa,SAAS;CACpB,cAA6B;AAC3B,SAAO,aAAa;;CAGtB,YAA2B;AACzB,SAAO,WAAW;;CAErB;AAED,MAAa,UAAU;CACrB,QAAuB;EACrB,MAAM,KAAK,KAAK,cAAc,IAAI;AAClC,MAAI,GACF,cAAa,GAAG;AAElB,SAAO;;CAGT,cAA6B;AAC3B,SAAO,KAAK,aAAa,IAAI;;CAEhC;AAED,MAAa,WAAW;CACtB,MAA6B;AAC3B,SAAO;;CAGT,MAAM,IAAI,QAAuC;AAC/C,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,MAAM;EACZ,MAAM,CAAC,UAAU,QAAQ,WAAW,MAAM,QAAQ,IAAI;GACpD,iBAAiB;GACjB,sBAAsB;GACtB,mBAAmB;GACpB,CAAC;AACF,MAAI,QAAQ,cAAc,CAAC,QAAQ;AACjC,yBAAsB;AACtB;;AAEF,MAAI,KAAK,4BAA4B,WAAW,OAAO,WAAW;AAClE,QAAM,OAAO,KAAK;GAChB,QAAQ;GACR,SAAS,aAAa,OAAO,QAAQ;GACrC,MAAM,KAAK,UAAU;IACnB;IACA;IACA;IACA,GAAG;IACH,GAAI,WAAW,EAAE,SAAS;IAC3B,CAAC;GACF,WAAW;GACX,QAAQ,YAAY,QAAQ,IAAO;GACpC,CAAC,CAAC,YAAY;AACb,yBAAsB;AACtB,OAAI,KAAK,kCAAkC,UAAU;IACrD;;CAGJ,QAAc;AACZ,oBAAkB;AAClB,wBAAsB;;CAEzB;AAED,SAAgB,WAAiB;AAC/B,eAAc;AACd,UAAS,OAAO;AAChB,WAAU;AACV,mBAAkB;AAClB,iBAAgB;AAChB,OAAM;AACN,UAAS"}
+{"version":3,"file":"api.mjs","names":[],"sources":["../../src/tracking/api.ts"],"sourcesContent":["import type { SessionId } from \"@interfere/types/data/session\";\nimport type { IdentifyParams } from \"@interfere/types/sdk/identify\";\n\nimport {\n  appendPathBeforeQuery,\n  type IngestTarget,\n} from \"../internal/config.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { DeviceManager } from \"./device.js\";\nimport { GeoDetector } from \"./geo.js\";\nimport { SessionManager } from \"./session.js\";\n\nconst log = createLogger(\"tracking\");\n\nconst SYNC_COOLDOWN_MS = 5000;\n\nexport interface SessionTrackerOptions {\n  device?: DeviceManager;\n  fetcher?: typeof globalThis.fetch;\n  geo?: GeoDetector;\n  target: IngestTarget;\n}\n\nexport class SessionTracker {\n  private readonly target: IngestTarget;\n  private readonly fetcher: typeof globalThis.fetch;\n  private readonly device: DeviceManager;\n  private readonly geo: GeoDetector;\n\n  private mgr: SessionManager | null = null;\n  private currentIdentity: IdentifyParams | null = null;\n  private identifiedSessionId: string | null = null;\n  private syncedSessionId: string | null = null;\n  private syncAttemptMs = 0;\n  private generation = 0;\n\n  constructor(opts: SessionTrackerOptions) {\n    this.target = opts.target;\n    this.fetcher = opts.fetcher ?? globalThis.fetch.bind(globalThis);\n    this.device = opts.device ?? new DeviceManager();\n    this.geo = opts.geo ?? new GeoDetector();\n  }\n\n  start(): void {\n    this.device.init();\n    // Best-effort warm-up; `GeoDetector.detect()` swallows its own errors and\n    // resolves to `null`, so we don't need to attach a `.catch`. If `identify`\n    // runs before the geo result lands, the country field is just omitted.\n    this.geo.detect();\n    this.mgr = new SessionManager((id) => {\n      this.onRotate(id).catch(() => {\n        /* best-effort */\n      });\n    });\n  }\n\n  sessionId(): SessionId | null {\n    const id = this.mgr?.getSessionId() ?? null;\n    if (id) {\n      this.ensureSynced(id);\n    }\n    return id;\n  }\n\n  windowId(): string | null {\n    return this.mgr?.getWindowId() ?? null;\n  }\n\n  getDeviceId(): string | null {\n    return this.device.getDeviceId();\n  }\n\n  getFpHash(): string | null {\n    return this.device.getFpHash();\n  }\n\n  /**\n   * Identity headers (session / window / device). Layered onto the\n   * session/identify POSTs alongside the target's static headers\n   * (content-type + auth + force-enable).\n   */\n  headers(): Record<string, string> {\n    const h: Record<string, string> = {};\n    const sid = this.mgr?.getSessionId() ?? null;\n    if (sid) {\n      h[\"x-interfere-session\"] = sid;\n    }\n    const wid = this.mgr?.getWindowId() ?? null;\n    if (wid) {\n      h[\"x-interfere-window\"] = wid;\n    }\n    const did = this.device.getDeviceId();\n    if (did) {\n      h[\"x-interfere-device\"] = did;\n    }\n    return h;\n  }\n\n  getIdentity(): IdentifyParams | null {\n    return this.currentIdentity;\n  }\n\n  async identify(params: IdentifyParams): Promise<void> {\n    if (!this.mgr) {\n      return;\n    }\n    const sessionId = this.mgr.getSessionId();\n    if (this.identifiedSessionId === sessionId) {\n      log.debug(\"skipped, already identified for session %s\", sessionId);\n      return;\n    }\n\n    this.currentIdentity = params;\n    this.identifiedSessionId = sessionId;\n\n    const gen = this.generation;\n    const [fpHash, country] = await Promise.all([\n      this.device.whenFingerprintReady(),\n      this.geo.detect(),\n    ]);\n    const deviceId = this.device.getDeviceId();\n    if (gen !== this.generation) {\n      this.identifiedSessionId = null;\n      return;\n    }\n    // Append the path to the existing target. `new URL(\"/identify\", base)`\n    // is wrong on both axes: in proxy mode `target.url` is relative\n    // (`/api/interfere/v1/session`) so the URL constructor throws\n    // synchronously — `currentIdentity` is set but no fetch fires; in\n    // direct-ingestion mode the path-absolute \"/identify\" replaces the target's\n    // path, hitting `/identify` at the origin instead of the collector's\n    // `/v1/session/identify` route. The helper preserves relative URLs and\n    // keeps `pk` query auth at the end.\n    log.info(\"POST session %s → user %s\", sessionId, params.identifier);\n    this.fetcher(appendPathBeforeQuery(this.target.url, \"/identify\"), {\n      method: \"POST\",\n      headers: this.requestHeaders(),\n      body: JSON.stringify({\n        sessionId,\n        deviceId,\n        fpHash,\n        ...params,\n        ...(country && { country }),\n      }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    }).catch(() => {\n      this.identifiedSessionId = null;\n      log.warn(\"identify failed for session %s\", sessionId);\n    });\n  }\n\n  clearIdentity(): void {\n    this.currentIdentity = null;\n    this.identifiedSessionId = null;\n  }\n\n  dispose(): void {\n    this.generation += 1;\n    this.clearIdentity();\n    this.syncedSessionId = null;\n    this.syncAttemptMs = 0;\n    this.mgr = null;\n  }\n\n  private requestHeaders(): Record<string, string> {\n    return {\n      ...Object.fromEntries(this.target.headers.entries()),\n      ...this.headers(),\n    };\n  }\n\n  private ensureSynced(sessionId: string): void {\n    if (this.syncedSessionId === sessionId) {\n      return;\n    }\n    if (Date.now() - this.syncAttemptMs < SYNC_COOLDOWN_MS) {\n      return;\n    }\n    this.syncSession(\n      sessionId,\n      this.device.getDeviceId(),\n      this.device.getFpHash()\n    );\n  }\n\n  private syncSession(\n    sessionId: string,\n    deviceId: string | null,\n    fpHash: string | null\n  ): void {\n    this.syncAttemptMs = Date.now();\n    this.syncedSessionId = sessionId;\n\n    this.fetcher(this.target.url, {\n      method: \"POST\",\n      headers: this.requestHeaders(),\n      body: JSON.stringify({ sessionId, deviceId, fpHash }),\n      keepalive: true,\n      signal: AbortSignal.timeout(10_000),\n    })\n      .then((res) => {\n        if (!res.ok) {\n          this.syncedSessionId = null;\n        }\n      })\n      .catch(() => {\n        this.syncedSessionId = null;\n        log.warn(\"session sync failed, will retry\");\n      });\n  }\n\n  private async onRotate(sessionId: string): Promise<void> {\n    this.syncedSessionId = null;\n    this.syncAttemptMs = Date.now();\n    const gen = this.generation;\n    const fpHash = await this.device.whenFingerprintReady();\n    const deviceId = this.device.getDeviceId();\n    if (gen !== this.generation) {\n      return;\n    }\n    log.debug(\n      \"POST session %s (device=%s fp=%s)\",\n      sessionId,\n      deviceId ?? \"pending\",\n      fpHash ?? \"none\"\n    );\n    this.syncSession(sessionId, deviceId, fpHash);\n  }\n}\n"],"mappings":"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"}

package/dist/tracking/device.d.mts

@@ -1,9 +1,32 @@
 //#region src/tracking/device.d.ts
-declare function initDevice(): void;
-declare function getDeviceId(): string | null;
-declare function getFpHash(): string | null;
-declare function whenDeviceReady(): Promise<string | null>;
-declare function whenFingerprintReady(): Promise<string | null>;
-declare function resetDevice(): void;
+/**
+ * Producer of an opaque, stable per-browser fingerprint hash. The default
+ * dynamic-imports the FingerprintJS OSS library and self-defers via
+ * `requestIdleCallback` so the ~1.5s of synchronous font / canvas / WebGL
+ * probing the library performs on a cold load doesn't land on the
+ * hydration tick. Tests inject a fixed-value provider that resolves
+ * immediately — they pay nothing for the production deferral.
+ */
+type FingerprintProvider = () => Promise<string | null>;
+/**
+ * Resolves on the next browser idle frame, capped at 5s. Falls back to
+ * `setTimeout(0)` (next macrotask) on hosts without
+ * `requestIdleCallback`. Exported only for the unit test that pins the
+ * "default provider gates fingerprint work via RIC" contract — not part
+ * of the package's public surface.
+ */
+declare function whenIdle(): Promise<void>;
+declare class DeviceManager {
+  private deviceId;
+  private fpHash;
+  private fpPending;
+  private readonly fingerprintProvider;
+  constructor(fingerprintProvider?: FingerprintProvider);
+  init(): void;
+  private startFingerprint;
+  getDeviceId(): string | null;
+  getFpHash(): string | null;
+  whenFingerprintReady(): Promise<string | null>;
+}
 //#endregion
-export { getDeviceId, getFpHash, initDevice, resetDevice, whenDeviceReady, whenFingerprintReady };
+export { DeviceManager, FingerprintProvider, whenIdle };

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

@@ -1 +1 @@
-{"version":3,"file":"device.d.mts","names":[],"sources":["../../src/tracking/device.ts"],"mappings":";iBA+CgB,UAAA,CAAA;AAAA,iBAiDA,WAAA,CAAA;AAAA,iBAIA,SAAA,CAAA;AAAA,iBAIA,eAAA,CAAA,GAAmB,OAAA;AAAA,iBAOnB,oBAAA,CAAA,GAAwB,OAAA;AAAA,iBAOxB,WAAA,CAAA"}
+{"version":3,"file":"device.d.mts","names":[],"sources":["../../src/tracking/device.ts"],"mappings":";;AAgBA;;;;AAA+C;AAW/C;;KAXY,mBAAA,SAA4B,OAAO;;AAWZ;AAuEnC;;;;;iBAvEgB,QAAA,CAAA,GAAY,OAAO;AAAA,cAuEtB,aAAA;EAAA,QACH,QAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,iBACS,mBAAA;cAEL,mBAAA,GAAsB,mBAAA;EAKlC,IAAA,CAAA;EAAA,QAkCQ,gBAAA;EAkBR,WAAA,CAAA;EAIA,SAAA,CAAA;EAIA,oBAAA,CAAA,GAAwB,OAAO;AAAA"}

package/dist/tracking/device.mjs

@@ -1,80 +1 @@
-import { createLogger } from "../util/log.mjs";
-//#region src/tracking/device.ts
-const log = createLogger("device");
-const LS_KEY = "interfere:device_id";
-const COOKIE_NAME = "interfere_did";
-const COOKIE_MAX_AGE_DAYS = 400;
-let deviceId = null;
-let fpHash = null;
-let fpPending = null;
-function tryLocalStorage() {
-	try {
-		const s = globalThis.localStorage;
-		const key = "__interfere_device_probe__";
-		s.setItem(key, "1");
-		s.removeItem(key);
-		return s;
-	} catch {
-		return null;
-	}
-}
-function getCookie(name) {
-	if (typeof document === "undefined") return null;
-	const match = document.cookie.split("; ").find((c) => c.startsWith(`${name}=`));
-	return match ? decodeURIComponent(match.split("=")[1] ?? "") : null;
-}
-function setCookie(name, value) {
-	if (typeof document === "undefined") return;
-	const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;
-	document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;
-}
-function generateId() {
-	return crypto.randomUUID();
-}
-function initDevice() {
-	if (deviceId) return;
-	const ls = tryLocalStorage();
-	const fromLs = ls?.getItem(LS_KEY) ?? null;
-	const fromCookie = getCookie(COOKIE_NAME);
-	deviceId = fromLs ?? fromCookie ?? generateId();
-	if (!fromLs && ls) ls.setItem(LS_KEY, deviceId);
-	if (!fromCookie) setCookie(COOKIE_NAME, deviceId);
-	if (fromLs && !fromCookie) setCookie(COOKIE_NAME, deviceId);
-	if (fromCookie && !fromLs && ls) ls.setItem(LS_KEY, deviceId);
-	log.debug("device %s (ls=%s cookie=%s)", deviceId, !!fromLs, !!fromCookie);
-	initFpHash();
-}
-function initFpHash() {
-	if (fpHash || fpPending) return;
-	fpPending = (async () => {
-		try {
-			fpHash = (await (await (await import("@fingerprintjs/fingerprintjs")).load()).get()).visitorId;
-			log.debug("fpHash %s", fpHash);
-			return fpHash;
-		} catch {
-			log.warn("fp hash failed");
-			return null;
-		}
-	})();
-}
-function getDeviceId() {
-	return deviceId;
-}
-function getFpHash() {
-	return fpHash;
-}
-function whenDeviceReady() {
-	if (deviceId) return Promise.resolve(deviceId);
-	return Promise.resolve(null);
-}
-function whenFingerprintReady() {
-	if (fpHash) return Promise.resolve(fpHash);
-	return fpPending ?? Promise.resolve(null);
-}
-function resetDevice() {
-	deviceId = null;
-	fpHash = null;
-	fpPending = null;
-}
-//#endregion
-export { getDeviceId, getFpHash, initDevice, resetDevice, whenDeviceReady, whenFingerprintReady };
+import{createLogger}from"../util/log.mjs";const log=createLogger(`device`),LS_KEY=`interfere:device_id`,COOKIE_NAME=`interfere_did`;function whenIdle(){return new Promise(resolve=>{if(typeof globalThis.requestIdleCallback==`function`){globalThis.requestIdleCallback(()=>resolve(),{timeout:5e3});return}setTimeout(resolve,0)})}const defaultFingerprintProvider=async()=>{await whenIdle();try{let result=await(await(await import(`@fingerprintjs/fingerprintjs`)).load()).get();return result.visitorId?result.visitorId:(log.error(`Fingerprinting returned an empty visitor id; visitor identity will be cookie-only`),null)}catch(err){return log.error(`fingerprint init failed; visitor identity will be cookie-only`,err),null}};function tryLocalStorage(){try{let s=globalThis.localStorage,key=`__interfere_device_probe__`;return s.setItem(key,`1`),s.removeItem(key),s}catch{return null}}function getCookie(name){if(typeof document>`u`)return null;let match=document.cookie.split(`; `).find(c=>c.startsWith(`${name}=`));return match?decodeURIComponent(match.split(`=`)[1]??``):null}function setCookie(name,value){typeof document>`u`||(document.cookie=`${name}=${encodeURIComponent(value)};path=/;max-age=${400*24*60*60};SameSite=Lax`)}function generateId(){return crypto.randomUUID()}var DeviceManager=class{deviceId=null;fpHash=null;fpPending=null;fingerprintProvider;constructor(fingerprintProvider){this.fingerprintProvider=fingerprintProvider??defaultFingerprintProvider}init(){if(this.deviceId)return;let ls=tryLocalStorage(),fromLs=ls?.getItem(LS_KEY)??null,fromCookie=getCookie(COOKIE_NAME);this.deviceId=fromLs??fromCookie??generateId(),!fromLs&&ls&&ls.setItem(LS_KEY,this.deviceId),fromCookie||setCookie(COOKIE_NAME,this.deviceId),fromLs&&!fromCookie&&setCookie(COOKIE_NAME,this.deviceId),fromCookie&&!fromLs&&ls&&ls.setItem(LS_KEY,this.deviceId),log.debug(`device %s (ls=%s cookie=%s)`,this.deviceId,!!fromLs,!!fromCookie),this.startFingerprint()}startFingerprint(){this.fpHash||this.fpPending||(this.fpPending=(async()=>{let hash=await this.fingerprintProvider();return this.fpHash=hash,hash&&log.debug(`fpHash %s`,hash),hash})())}getDeviceId(){return this.deviceId}getFpHash(){return this.fpHash}whenFingerprintReady(){return this.fpHash?Promise.resolve(this.fpHash):this.fpPending??Promise.resolve(null)}};export{DeviceManager,whenIdle};

package/dist/tracking/device.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"device.mjs","names":[],"sources":["../../src/tracking/device.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"device\");\n\nconst LS_KEY = \"interfere:device_id\";\nconst COOKIE_NAME = \"interfere_did\";\nconst COOKIE_MAX_AGE_DAYS = 400;\n\nlet deviceId: string | null = null;\nlet fpHash: string | null = null;\nlet fpPending: Promise<string | null> | null = null;\n\nfunction tryLocalStorage(): Storage | null {\n  try {\n    const s = globalThis.localStorage;\n    const key = \"__interfere_device_probe__\";\n    s.setItem(key, \"1\");\n    s.removeItem(key);\n    return s;\n  } catch {\n    return null;\n  }\n}\n\nfunction getCookie(name: string): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n  const match = document.cookie\n    .split(\"; \")\n    .find((c) => c.startsWith(`${name}=`));\n  return match ? decodeURIComponent(match.split(\"=\")[1] ?? \"\") : null;\n}\n\nfunction setCookie(name: string, value: string): void {\n  if (typeof document === \"undefined\") {\n    return;\n  }\n  const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;\n  // biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API is async and not universally supported; synchronous access is required here\n  document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;\n}\n\nfunction generateId(): string {\n  return crypto.randomUUID();\n}\n\nexport function initDevice(): void {\n  if (deviceId) {\n    return;\n  }\n\n  const ls = tryLocalStorage();\n  const fromLs = ls?.getItem(LS_KEY) ?? null;\n  const fromCookie = getCookie(COOKIE_NAME);\n\n  deviceId = fromLs ?? fromCookie ?? generateId();\n\n  if (!fromLs && ls) {\n    ls.setItem(LS_KEY, deviceId);\n  }\n  if (!fromCookie) {\n    setCookie(COOKIE_NAME, deviceId);\n  }\n  if (fromLs && !fromCookie) {\n    setCookie(COOKIE_NAME, deviceId);\n  }\n  if (fromCookie && !fromLs && ls) {\n    ls.setItem(LS_KEY, deviceId);\n  }\n\n  log.debug(\"device %s (ls=%s cookie=%s)\", deviceId, !!fromLs, !!fromCookie);\n\n  initFpHash();\n}\n\nfunction initFpHash(): void {\n  if (fpHash || fpPending) {\n    return;\n  }\n\n  fpPending = (async () => {\n    try {\n      const FingerprintJS = await import(\"@fingerprintjs/fingerprintjs\");\n      const fp = await FingerprintJS.load();\n      const result = await fp.get();\n      fpHash = result.visitorId;\n      log.debug(\"fpHash %s\", fpHash);\n      return fpHash;\n    } catch {\n      log.warn(\"fp hash failed\");\n      return null;\n    }\n  })();\n}\n\nexport function getDeviceId(): string | null {\n  return deviceId;\n}\n\nexport function getFpHash(): string | null {\n  return fpHash;\n}\n\nexport function whenDeviceReady(): Promise<string | null> {\n  if (deviceId) {\n    return Promise.resolve(deviceId);\n  }\n  return Promise.resolve(null);\n}\n\nexport function whenFingerprintReady(): Promise<string | null> {\n  if (fpHash) {\n    return Promise.resolve(fpHash);\n  }\n  return fpPending ?? Promise.resolve(null);\n}\n\nexport function resetDevice(): void {\n  deviceId = null;\n  fpHash = null;\n  fpPending = null;\n}\n"],"mappings":";;AAEA,MAAM,MAAM,aAAa,SAAS;AAElC,MAAM,SAAS;AACf,MAAM,cAAc;AACpB,MAAM,sBAAsB;AAE5B,IAAI,WAA0B;AAC9B,IAAI,SAAwB;AAC5B,IAAI,YAA2C;AAE/C,SAAS,kBAAkC;AACzC,KAAI;EACF,MAAM,IAAI,WAAW;EACrB,MAAM,MAAM;AACZ,IAAE,QAAQ,KAAK,IAAI;AACnB,IAAE,WAAW,IAAI;AACjB,SAAO;SACD;AACN,SAAO;;;AAIX,SAAS,UAAU,MAA6B;AAC9C,KAAI,OAAO,aAAa,YACtB,QAAO;CAET,MAAM,QAAQ,SAAS,OACpB,MAAM,KAAK,CACX,MAAM,MAAM,EAAE,WAAW,GAAG,KAAK,GAAG,CAAC;AACxC,QAAO,QAAQ,mBAAmB,MAAM,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG;;AAGjE,SAAS,UAAU,MAAc,OAAqB;AACpD,KAAI,OAAO,aAAa,YACtB;CAEF,MAAM,SAAS,sBAAsB,KAAK,KAAK;AAE/C,UAAS,SAAS,GAAG,KAAK,GAAG,mBAAmB,MAAM,CAAC,kBAAkB,OAAO;;AAGlF,SAAS,aAAqB;AAC5B,QAAO,OAAO,YAAY;;AAG5B,SAAgB,aAAmB;AACjC,KAAI,SACF;CAGF,MAAM,KAAK,iBAAiB;CAC5B,MAAM,SAAS,IAAI,QAAQ,OAAO,IAAI;CACtC,MAAM,aAAa,UAAU,YAAY;AAEzC,YAAW,UAAU,cAAc,YAAY;AAE/C,KAAI,CAAC,UAAU,GACb,IAAG,QAAQ,QAAQ,SAAS;AAE9B,KAAI,CAAC,WACH,WAAU,aAAa,SAAS;AAElC,KAAI,UAAU,CAAC,WACb,WAAU,aAAa,SAAS;AAElC,KAAI,cAAc,CAAC,UAAU,GAC3B,IAAG,QAAQ,QAAQ,SAAS;AAG9B,KAAI,MAAM,+BAA+B,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW;AAE1E,aAAY;;AAGd,SAAS,aAAmB;AAC1B,KAAI,UAAU,UACZ;AAGF,cAAa,YAAY;AACvB,MAAI;AAIF,aAAS,OADY,OADJ,MADW,OAAO,iCACJ,MAAM,EACb,KAAK,EACb;AAChB,OAAI,MAAM,aAAa,OAAO;AAC9B,UAAO;UACD;AACN,OAAI,KAAK,iBAAiB;AAC1B,UAAO;;KAEP;;AAGN,SAAgB,cAA6B;AAC3C,QAAO;;AAGT,SAAgB,YAA2B;AACzC,QAAO;;AAGT,SAAgB,kBAA0C;AACxD,KAAI,SACF,QAAO,QAAQ,QAAQ,SAAS;AAElC,QAAO,QAAQ,QAAQ,KAAK;;AAG9B,SAAgB,uBAA+C;AAC7D,KAAI,OACF,QAAO,QAAQ,QAAQ,OAAO;AAEhC,QAAO,aAAa,QAAQ,QAAQ,KAAK;;AAG3C,SAAgB,cAAoB;AAClC,YAAW;AACX,UAAS;AACT,aAAY"}
+{"version":3,"file":"device.mjs","names":[],"sources":["../../src/tracking/device.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"device\");\n\nconst LS_KEY = \"interfere:device_id\";\nconst COOKIE_NAME = \"interfere_did\";\nconst COOKIE_MAX_AGE_DAYS = 400;\n\n/**\n * Producer of an opaque, stable per-browser fingerprint hash. The default\n * dynamic-imports the FingerprintJS OSS library and self-defers via\n * `requestIdleCallback` so the ~1.5s of synchronous font / canvas / WebGL\n * probing the library performs on a cold load doesn't land on the\n * hydration tick. Tests inject a fixed-value provider that resolves\n * immediately — they pay nothing for the production deferral.\n */\nexport type FingerprintProvider = () => Promise<string | null>;\n\nconst FP_IDLE_TIMEOUT_MS = 5000;\n\n/**\n * Resolves on the next browser idle frame, capped at 5s. Falls back to\n * `setTimeout(0)` (next macrotask) on hosts without\n * `requestIdleCallback`. Exported only for the unit test that pins the\n * \"default provider gates fingerprint work via RIC\" contract — not part\n * of the package's public surface.\n */\nexport function whenIdle(): Promise<void> {\n  return new Promise((resolve) => {\n    if (typeof globalThis.requestIdleCallback === \"function\") {\n      globalThis.requestIdleCallback(() => resolve(), {\n        timeout: FP_IDLE_TIMEOUT_MS,\n      });\n      return;\n    }\n    setTimeout(resolve, 0);\n  });\n}\n\nconst defaultFingerprintProvider: FingerprintProvider = async () => {\n  await whenIdle();\n  try {\n    const FingerprintJS = await import(\"@fingerprintjs/fingerprintjs\");\n    const fp = await FingerprintJS.load();\n    const result = await fp.get();\n    if (!result.visitorId) {\n      log.error(\n        \"Fingerprinting returned an empty visitor id; visitor identity will be cookie-only\"\n      );\n\n      return null;\n    }\n    return result.visitorId;\n  } catch (err) {\n    log.error(\n      \"fingerprint init failed; visitor identity will be cookie-only\",\n      err\n    );\n\n    return null;\n  }\n};\n\nfunction tryLocalStorage(): Storage | null {\n  try {\n    const s = globalThis.localStorage;\n    const key = \"__interfere_device_probe__\";\n    s.setItem(key, \"1\");\n    s.removeItem(key);\n    return s;\n  } catch {\n    return null;\n  }\n}\n\nfunction getCookie(name: string): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n  const match = document.cookie\n    .split(\"; \")\n    .find((c) => c.startsWith(`${name}=`));\n  return match ? decodeURIComponent(match.split(\"=\")[1] ?? \"\") : null;\n}\n\nfunction setCookie(name: string, value: string): void {\n  if (typeof document === \"undefined\") {\n    return;\n  }\n  const maxAge = COOKIE_MAX_AGE_DAYS * 24 * 60 * 60;\n  // biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API is async and not universally supported; synchronous access is required here\n  document.cookie = `${name}=${encodeURIComponent(value)};path=/;max-age=${maxAge};SameSite=Lax`;\n}\n\nfunction generateId(): string {\n  return crypto.randomUUID();\n}\n\nexport class DeviceManager {\n  private deviceId: string | null = null;\n  private fpHash: string | null = null;\n  private fpPending: Promise<string | null> | null = null;\n  private readonly fingerprintProvider: FingerprintProvider;\n\n  constructor(fingerprintProvider?: FingerprintProvider) {\n    this.fingerprintProvider =\n      fingerprintProvider ?? defaultFingerprintProvider;\n  }\n\n  init(): void {\n    if (this.deviceId) {\n      return;\n    }\n\n    const ls = tryLocalStorage();\n    const fromLs = ls?.getItem(LS_KEY) ?? null;\n    const fromCookie = getCookie(COOKIE_NAME);\n\n    this.deviceId = fromLs ?? fromCookie ?? generateId();\n\n    if (!fromLs && ls) {\n      ls.setItem(LS_KEY, this.deviceId);\n    }\n    if (!fromCookie) {\n      setCookie(COOKIE_NAME, this.deviceId);\n    }\n    if (fromLs && !fromCookie) {\n      setCookie(COOKIE_NAME, this.deviceId);\n    }\n    if (fromCookie && !fromLs && ls) {\n      ls.setItem(LS_KEY, this.deviceId);\n    }\n\n    log.debug(\n      \"device %s (ls=%s cookie=%s)\",\n      this.deviceId,\n      !!fromLs,\n      !!fromCookie\n    );\n\n    this.startFingerprint();\n  }\n\n  private startFingerprint(): void {\n    if (this.fpHash || this.fpPending) {\n      return;\n    }\n\n    this.fpPending = (async () => {\n      const hash = await this.fingerprintProvider();\n      this.fpHash = hash;\n      if (hash) {\n        log.debug(\"fpHash %s\", hash);\n      }\n      // No log on null — the provider is responsible for surfacing its own\n      // failure mode (the default provider logs at error level; custom\n      // providers can choose). Logging here too would double-count.\n      return hash;\n    })();\n  }\n\n  getDeviceId(): string | null {\n    return this.deviceId;\n  }\n\n  getFpHash(): string | null {\n    return this.fpHash;\n  }\n\n  whenFingerprintReady(): Promise<string | null> {\n    if (this.fpHash) {\n      return Promise.resolve(this.fpHash);\n    }\n    return this.fpPending ?? Promise.resolve(null);\n  }\n}\n"],"mappings":"0CAEA,MAAM,IAAM,aAAa,QAAQ,EAE3B,OAAS,sBACT,YAAc,gBAsBpB,SAAgB,UAA0B,CACxC,OAAO,IAAI,QAAS,SAAY,CAC9B,GAAI,OAAO,WAAW,qBAAwB,WAAY,CACxD,WAAW,wBAA0B,QAAQ,EAAG,CAC9C,QAAS,GACX,CAAC,EACD,MACF,CACA,WAAW,QAAS,CAAC,CACvB,CAAC,CACH,CAEA,MAAM,2BAAkD,SAAY,CAClE,MAAM,SAAS,EACf,GAAI,CAGF,IAAM,OAAS,MAAM,MADJ,MADW,OAAO,iCACJ,KAAK,GACZ,IAAI,EAQ5B,OAPK,OAAO,UAOL,OAAO,WANZ,IAAI,MACF,mFACF,EAEO,KAGX,OAAS,IAAK,CAMZ,OALA,IAAI,MACF,gEACA,GACF,EAEO,IACT,CACF,EAEA,SAAS,iBAAkC,CACzC,GAAI,CACF,IAAM,EAAI,WAAW,aACf,IAAM,6BAGZ,OAFA,EAAE,QAAQ,IAAK,GAAG,EAClB,EAAE,WAAW,GAAG,EACT,CACT,MAAQ,CACN,OAAO,IACT,CACF,CAEA,SAAS,UAAU,KAA6B,CAC9C,GAAI,OAAO,SAAa,IACtB,OAAO,KAET,IAAM,MAAQ,SAAS,OACpB,MAAM,IAAI,EACV,KAAM,GAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAAC,EACvC,OAAO,MAAQ,mBAAmB,MAAM,MAAM,GAAG,EAAE,IAAM,EAAE,EAAI,IACjE,CAEA,SAAS,UAAU,KAAc,MAAqB,CAChD,OAAO,SAAa,MAKxB,SAAS,OAAS,GAAG,KAAK,GAAG,mBAAmB,KAAK,EAAE,kBAFxC,IAAsB,GAAK,GAAK,GAEiC,eAClF,CAEA,SAAS,YAAqB,CAC5B,OAAO,OAAO,WAAW,CAC3B,CAEA,IAAa,cAAb,KAA2B,CACzB,SAAkC,KAClC,OAAgC,KAChC,UAAmD,KACnD,oBAEA,YAAY,oBAA2C,CACrD,KAAK,oBACH,qBAAuB,0BAC3B,CAEA,MAAa,CACX,GAAI,KAAK,SACP,OAGF,IAAM,GAAK,gBAAgB,EACrB,OAAS,IAAI,QAAQ,MAAM,GAAK,KAChC,WAAa,UAAU,WAAW,EAExC,KAAK,SAAW,QAAU,YAAc,WAAW,EAE/C,CAAC,QAAU,IACb,GAAG,QAAQ,OAAQ,KAAK,QAAQ,EAE7B,YACH,UAAU,YAAa,KAAK,QAAQ,EAElC,QAAU,CAAC,YACb,UAAU,YAAa,KAAK,QAAQ,EAElC,YAAc,CAAC,QAAU,IAC3B,GAAG,QAAQ,OAAQ,KAAK,QAAQ,EAGlC,IAAI,MACF,8BACA,KAAK,SACL,CAAC,CAAC,OACF,CAAC,CAAC,UACJ,EAEA,KAAK,iBAAiB,CACxB,CAEA,kBAAiC,CAC3B,KAAK,QAAU,KAAK,YAIxB,KAAK,WAAa,SAAY,CAC5B,IAAM,KAAO,MAAM,KAAK,oBAAoB,EAQ5C,MAPA,MAAK,OAAS,KACV,MACF,IAAI,MAAM,YAAa,IAAI,EAKtB,IACT,GAAG,EACL,CAEA,aAA6B,CAC3B,OAAO,KAAK,QACd,CAEA,WAA2B,CACzB,OAAO,KAAK,MACd,CAEA,sBAA+C,CAI7C,OAHI,KAAK,OACA,QAAQ,QAAQ,KAAK,MAAM,EAE7B,KAAK,WAAa,QAAQ,QAAQ,IAAI,CAC/C,CACF"}

package/dist/tracking/geo.d.mts

@@ -1,5 +1,13 @@
 //#region src/tracking/geo.d.ts
-declare function detectCountryCode(): Promise<string | null>;
-declare function resetGeo(): void;
+declare class GeoDetector {
+  private cached;
+  private pending;
+  private failed;
+  private readonly fetcher;
+  constructor(fetcher?: typeof globalThis.fetch);
+  detect(): Promise<string | null>;
+  getCountry(): string | null;
+  private fetchCountryCode;
+}
 //#endregion
-export { detectCountryCode, resetGeo };
+export { GeoDetector };

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

@@ -1 +1 @@
-{"version":3,"file":"geo.d.mts","names":[],"sources":["../../src/tracking/geo.ts"],"mappings":";iBAwCgB,iBAAA,CAAA,GAAqB,OAAA;AAAA,iBAuBrB,QAAA,CAAA"}
+{"version":3,"file":"geo.d.mts","names":[],"sources":["../../src/tracking/geo.ts"],"mappings":";cAea,WAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,iBACS,OAAA;cAEL,OAAA,UAAiB,UAAA,CAAW,KAAA;EAIxC,MAAA,CAAA,GAAU,OAAO;EAuBjB,UAAA,CAAA;EAAA,QAIc,gBAAA;AAAA"}

package/dist/tracking/geo.mjs

@@ -1,44 +1,2 @@
-import { cloudflareTraceSchema } from "@interfere/types/sdk/geo";
-//#region src/tracking/geo.ts
-const CF_TRACE_URL = "https://cloudflare.com/cdn-cgi/trace";
-let cached = null;
-let pending = null;
-let failed = false;
-function parseTrace(text) {
-	const result = {};
-	for (const line of text.split("\n")) {
-		const idx = line.indexOf("=");
-		if (idx > 0) result[line.slice(0, idx)] = line.slice(idx + 1);
-	}
-	return result;
-}
-async function fetchCountryCode() {
-	try {
-		const res = await fetch(CF_TRACE_URL, { signal: AbortSignal.timeout(3e3) });
-		if (!res.ok) return null;
-		const raw = parseTrace(await res.text());
-		const trace = cloudflareTraceSchema.safeParse(raw);
-		if (!trace.success) return null;
-		return trace.data.loc.toUpperCase();
-	} catch {
-		return null;
-	}
-}
-function detectCountryCode() {
-	if (cached) return Promise.resolve(cached);
-	if (failed) return Promise.resolve(null);
-	if (!pending) pending = fetchCountryCode().then((code) => {
-		cached = code;
-		if (!code) failed = true;
-		pending = null;
-		return code;
-	});
-	return pending;
-}
-function resetGeo() {
-	cached = null;
-	pending = null;
-	failed = false;
-}
-//#endregion
-export { detectCountryCode, resetGeo };
+import{cloudflareTraceSchema}from"@interfere/types/sdk/geo";function parseTrace(text){let result={};for(let line of text.split(`
+`)){let idx=line.indexOf(`=`);idx>0&&(result[line.slice(0,idx)]=line.slice(idx+1))}return result}var GeoDetector=class{cached=null;pending=null;failed=!1;fetcher;constructor(fetcher){this.fetcher=fetcher??globalThis.fetch.bind(globalThis)}detect(){return this.cached?Promise.resolve(this.cached):this.failed?Promise.resolve(null):(this.pending||=this.fetchCountryCode().then(code=>(this.cached=code,code||(this.failed=!0),this.pending=null,code)),this.pending)}getCountry(){return this.cached}async fetchCountryCode(){try{let res=await this.fetcher(`https://cloudflare.com/cdn-cgi/trace`,{signal:AbortSignal.timeout(3e3)});if(!res.ok)return null;let raw=parseTrace(await res.text()),trace=cloudflareTraceSchema.safeParse(raw);return trace.success?trace.data.loc.toUpperCase():null}catch{return null}}};export{GeoDetector};

package/dist/tracking/geo.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"geo.mjs","names":[],"sources":["../../src/tracking/geo.ts"],"sourcesContent":["import { cloudflareTraceSchema } from \"@interfere/types/sdk/geo\";\n\nconst CF_TRACE_URL = \"https://cloudflare.com/cdn-cgi/trace\";\n\nlet cached: string | null = null;\nlet pending: Promise<string | null> | null = null;\nlet failed = false;\n\nfunction parseTrace(text: string): Record<string, string> {\n  const result: Record<string, string> = {};\n  for (const line of text.split(\"\\n\")) {\n    const idx = line.indexOf(\"=\");\n    if (idx > 0) {\n      result[line.slice(0, idx)] = line.slice(idx + 1);\n    }\n  }\n  return result;\n}\n\nasync function fetchCountryCode(): Promise<string | null> {\n  try {\n    const res = await fetch(CF_TRACE_URL, {\n      signal: AbortSignal.timeout(3000),\n    });\n    if (!res.ok) {\n      return null;\n    }\n\n    const raw = parseTrace(await res.text());\n    const trace = cloudflareTraceSchema.safeParse(raw);\n    if (!trace.success) {\n      return null;\n    }\n\n    return trace.data.loc.toUpperCase();\n  } catch {\n    return null;\n  }\n}\n\nexport function detectCountryCode(): Promise<string | null> {\n  if (cached) {\n    return Promise.resolve(cached);\n  }\n\n  if (failed) {\n    return Promise.resolve(null);\n  }\n\n  if (!pending) {\n    pending = fetchCountryCode().then((code) => {\n      cached = code;\n      if (!code) {\n        failed = true;\n      }\n      pending = null;\n      return code;\n    });\n  }\n\n  return pending;\n}\n\nexport function resetGeo(): void {\n  cached = null;\n  pending = null;\n  failed = false;\n}\n"],"mappings":";;AAEA,MAAM,eAAe;AAErB,IAAI,SAAwB;AAC5B,IAAI,UAAyC;AAC7C,IAAI,SAAS;AAEb,SAAS,WAAW,MAAsC;CACxD,MAAM,SAAiC,EAAE;AACzC,MAAK,MAAM,QAAQ,KAAK,MAAM,KAAK,EAAE;EACnC,MAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,MAAI,MAAM,EACR,QAAO,KAAK,MAAM,GAAG,IAAI,IAAI,KAAK,MAAM,MAAM,EAAE;;AAGpD,QAAO;;AAGT,eAAe,mBAA2C;AACxD,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,cAAc,EACpC,QAAQ,YAAY,QAAQ,IAAK,EAClC,CAAC;AACF,MAAI,CAAC,IAAI,GACP,QAAO;EAGT,MAAM,MAAM,WAAW,MAAM,IAAI,MAAM,CAAC;EACxC,MAAM,QAAQ,sBAAsB,UAAU,IAAI;AAClD,MAAI,CAAC,MAAM,QACT,QAAO;AAGT,SAAO,MAAM,KAAK,IAAI,aAAa;SAC7B;AACN,SAAO;;;AAIX,SAAgB,oBAA4C;AAC1D,KAAI,OACF,QAAO,QAAQ,QAAQ,OAAO;AAGhC,KAAI,OACF,QAAO,QAAQ,QAAQ,KAAK;AAG9B,KAAI,CAAC,QACH,WAAU,kBAAkB,CAAC,MAAM,SAAS;AAC1C,WAAS;AACT,MAAI,CAAC,KACH,UAAS;AAEX,YAAU;AACV,SAAO;GACP;AAGJ,QAAO;;AAGT,SAAgB,WAAiB;AAC/B,UAAS;AACT,WAAU;AACV,UAAS"}
+{"version":3,"file":"geo.mjs","names":[],"sources":["../../src/tracking/geo.ts"],"sourcesContent":["import { cloudflareTraceSchema } from \"@interfere/types/sdk/geo\";\n\nconst CF_TRACE_URL = \"https://cloudflare.com/cdn-cgi/trace\";\n\nfunction parseTrace(text: string): Record<string, string> {\n  const result: Record<string, string> = {};\n  for (const line of text.split(\"\\n\")) {\n    const idx = line.indexOf(\"=\");\n    if (idx > 0) {\n      result[line.slice(0, idx)] = line.slice(idx + 1);\n    }\n  }\n  return result;\n}\n\nexport class GeoDetector {\n  private cached: string | null = null;\n  private pending: Promise<string | null> | null = null;\n  private failed = false;\n  private readonly fetcher: typeof globalThis.fetch;\n\n  constructor(fetcher?: typeof globalThis.fetch) {\n    this.fetcher = fetcher ?? globalThis.fetch.bind(globalThis);\n  }\n\n  detect(): Promise<string | null> {\n    if (this.cached) {\n      return Promise.resolve(this.cached);\n    }\n\n    if (this.failed) {\n      return Promise.resolve(null);\n    }\n\n    if (!this.pending) {\n      this.pending = this.fetchCountryCode().then((code) => {\n        this.cached = code;\n        if (!code) {\n          this.failed = true;\n        }\n        this.pending = null;\n        return code;\n      });\n    }\n\n    return this.pending;\n  }\n\n  getCountry(): string | null {\n    return this.cached;\n  }\n\n  private async fetchCountryCode(): Promise<string | null> {\n    try {\n      const res = await this.fetcher(CF_TRACE_URL, {\n        signal: AbortSignal.timeout(3000),\n      });\n      if (!res.ok) {\n        return null;\n      }\n\n      const raw = parseTrace(await res.text());\n      const trace = cloudflareTraceSchema.safeParse(raw);\n      if (!trace.success) {\n        return null;\n      }\n\n      return trace.data.loc.toUpperCase();\n    } catch {\n      return null;\n    }\n  }\n}\n"],"mappings":"4DAIA,SAAS,WAAW,KAAsC,CACxD,IAAM,OAAiC,CAAC,EACxC,IAAK,IAAM,QAAQ,KAAK,MAAM;CAAI,EAAG,CACnC,IAAM,IAAM,KAAK,QAAQ,GAAG,EACxB,IAAM,IACR,OAAO,KAAK,MAAM,EAAG,GAAG,GAAK,KAAK,MAAM,IAAM,CAAC,EAEnD,CACA,OAAO,MACT,CAEA,IAAa,YAAb,KAAyB,CACvB,OAAgC,KAChC,QAAiD,KACjD,OAAiB,GACjB,QAEA,YAAY,QAAmC,CAC7C,KAAK,QAAU,SAAW,WAAW,MAAM,KAAK,UAAU,CAC5D,CAEA,QAAiC,CAoB/B,OAnBI,KAAK,OACA,QAAQ,QAAQ,KAAK,MAAM,EAGhC,KAAK,OACA,QAAQ,QAAQ,IAAI,GAG7B,AACE,KAAK,UAAU,KAAK,iBAAiB,EAAE,KAAM,OAC3C,KAAK,OAAS,KACT,OACH,KAAK,OAAS,IAEhB,KAAK,QAAU,KACR,KACR,EAGI,KAAK,QACd,CAEA,YAA4B,CAC1B,OAAO,KAAK,MACd,CAEA,MAAc,kBAA2C,CACvD,GAAI,CACF,IAAM,IAAM,MAAM,KAAK,QAAQ,uCAAc,CAC3C,OAAQ,YAAY,QAAQ,GAAI,CAClC,CAAC,EACD,GAAI,CAAC,IAAI,GACP,OAAO,KAGT,IAAM,IAAM,WAAW,MAAM,IAAI,KAAK,CAAC,EACjC,MAAQ,sBAAsB,UAAU,GAAG,EAKjD,OAJK,MAAM,QAIJ,MAAM,KAAK,IAAI,YAAY,EAHzB,IAIX,MAAQ,CACN,OAAO,IACT,CACF,CACF"}

package/dist/tracking/session.d.mts

@@ -1,3 +1,5 @@
+import { SessionId } from "@interfere/types/data/session";
+
 //#region src/tracking/session.d.ts
 type OnRotate = (sessionId: string) => void;
 declare class SessionManager {
@@ -8,7 +10,7 @@ declare class SessionManager {
   private readonly onRotate;
   private lastActivityMs;
   constructor(onRotate?: OnRotate);
-  getSessionId(): string;
+  getSessionId(): SessionId;
   getWindowId(): string;
   private restore;
   private rotate;

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

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

package/dist/tracking/session.mjs

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

package/dist/tracking/session.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"session.mjs","names":["uuidv7"],"sources":["../../src/tracking/session.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"uuid\";\n\nconst SESSION_ID_KEY = \"interfere:session_id\";\nconst LAST_ACTIVITY_KEY = \"interfere:last_activity\";\nconst WINDOW_ID_KEY = \"interfere:window_id\";\nconst SESSION_TIMEOUT_MS = 30 * 60 * 1000;\n\nfunction tryStorage(type: \"localStorage\" | \"sessionStorage\"): Storage | null {\n  try {\n    const s = globalThis[type];\n    const key = \"__interfere_probe__\";\n    s.setItem(key, \"1\");\n    s.removeItem(key);\n    return s;\n  } catch {\n    return null;\n  }\n}\n\nexport type OnRotate = (sessionId: string) => void;\n\nexport class SessionManager {\n  sessionId: string | null = null;\n  windowId: string | null = null;\n  private readonly local: Storage | null;\n  private readonly session: Storage | null;\n  private readonly onRotate: OnRotate | null = null;\n  private lastActivityMs = 0;\n\n  constructor(onRotate?: OnRotate) {\n    this.local = tryStorage(\"localStorage\");\n    this.session = tryStorage(\"sessionStorage\");\n    this.onRotate = onRotate ?? null;\n    this.restore();\n  }\n\n  getSessionId(): string {\n    if (this.sessionId && !this.isExpired()) {\n      this.touch();\n      return this.sessionId;\n    }\n    return this.rotate();\n  }\n\n  getWindowId(): string {\n    if (this.windowId) {\n      return this.windowId;\n    }\n\n    const stored = this.session?.getItem(WINDOW_ID_KEY);\n    if (stored) {\n      this.windowId = stored;\n      return stored;\n    }\n\n    this.windowId = `win_${crypto.randomUUID()}`;\n    this.session?.setItem(WINDOW_ID_KEY, this.windowId);\n    return this.windowId;\n  }\n\n  private restore(): void {\n    const stored = this.local?.getItem(SESSION_ID_KEY);\n\n    if (stored && !this.isExpired()) {\n      this.sessionId = stored;\n      this.touch();\n    } else {\n      this.rotate();\n    }\n  }\n\n  private rotate(): string {\n    this.sessionId = uuidv7();\n    this.local?.setItem(SESSION_ID_KEY, this.sessionId);\n    this.touch();\n    this.onRotate?.(this.sessionId);\n    return this.sessionId;\n  }\n\n  private touch(): void {\n    this.lastActivityMs = Date.now();\n    this.local?.setItem(LAST_ACTIVITY_KEY, String(this.lastActivityMs));\n  }\n\n  private isExpired(): boolean {\n    const raw = this.local?.getItem(LAST_ACTIVITY_KEY);\n    const ts = raw ? Number(raw) : this.lastActivityMs;\n\n    if (ts === 0) {\n      return true;\n    }\n    return Date.now() - ts > SESSION_TIMEOUT_MS;\n  }\n}\n"],"mappings":";;AAEA,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,OAAU;AAErC,SAAS,WAAW,MAAyD;AAC3E,KAAI;EACF,MAAM,IAAI,WAAW;EACrB,MAAM,MAAM;AACZ,IAAE,QAAQ,KAAK,IAAI;AACnB,IAAE,WAAW,IAAI;AACjB,SAAO;SACD;AACN,SAAO;;;AAMX,IAAa,iBAAb,MAA4B;CAC1B,YAA2B;CAC3B,WAA0B;CAC1B;CACA;CACA,WAA6C;CAC7C,iBAAyB;CAEzB,YAAY,UAAqB;AAC/B,OAAK,QAAQ,WAAW,eAAe;AACvC,OAAK,UAAU,WAAW,iBAAiB;AAC3C,OAAK,WAAW,YAAY;AAC5B,OAAK,SAAS;;CAGhB,eAAuB;AACrB,MAAI,KAAK,aAAa,CAAC,KAAK,WAAW,EAAE;AACvC,QAAK,OAAO;AACZ,UAAO,KAAK;;AAEd,SAAO,KAAK,QAAQ;;CAGtB,cAAsB;AACpB,MAAI,KAAK,SACP,QAAO,KAAK;EAGd,MAAM,SAAS,KAAK,SAAS,QAAQ,cAAc;AACnD,MAAI,QAAQ;AACV,QAAK,WAAW;AAChB,UAAO;;AAGT,OAAK,WAAW,OAAO,OAAO,YAAY;AAC1C,OAAK,SAAS,QAAQ,eAAe,KAAK,SAAS;AACnD,SAAO,KAAK;;CAGd,UAAwB;EACtB,MAAM,SAAS,KAAK,OAAO,QAAQ,eAAe;AAElD,MAAI,UAAU,CAAC,KAAK,WAAW,EAAE;AAC/B,QAAK,YAAY;AACjB,QAAK,OAAO;QAEZ,MAAK,QAAQ;;CAIjB,SAAyB;AACvB,OAAK,YAAYA,IAAQ;AACzB,OAAK,OAAO,QAAQ,gBAAgB,KAAK,UAAU;AACnD,OAAK,OAAO;AACZ,OAAK,WAAW,KAAK,UAAU;AAC/B,SAAO,KAAK;;CAGd,QAAsB;AACpB,OAAK,iBAAiB,KAAK,KAAK;AAChC,OAAK,OAAO,QAAQ,mBAAmB,OAAO,KAAK,eAAe,CAAC;;CAGrE,YAA6B;EAC3B,MAAM,MAAM,KAAK,OAAO,QAAQ,kBAAkB;EAClD,MAAM,KAAK,MAAM,OAAO,IAAI,GAAG,KAAK;AAEpC,MAAI,OAAO,EACT,QAAO;AAET,SAAO,KAAK,KAAK,GAAG,KAAK"}
+{"version":3,"file":"session.mjs","names":["uuidv7"],"sources":["../../src/tracking/session.ts"],"sourcesContent":["import type { SessionId } from \"@interfere/types/data/session\";\n\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(): SessionId {\n    if (this.sessionId && !this.isExpired()) {\n      this.touch();\n      return this.sessionId as SessionId;\n    }\n    return this.rotate() as SessionId;\n  }\n\n  getWindowId(): string {\n    if (this.windowId) {\n      return this.windowId;\n    }\n\n    const stored = this.session?.getItem(WINDOW_ID_KEY);\n    if (stored) {\n      this.windowId = stored;\n      return stored;\n    }\n\n    this.windowId = `win_${crypto.randomUUID()}`;\n    this.session?.setItem(WINDOW_ID_KEY, this.windowId);\n    return this.windowId;\n  }\n\n  private restore(): void {\n    const stored = this.local?.getItem(SESSION_ID_KEY);\n\n    if (stored && !this.isExpired()) {\n      this.sessionId = stored;\n      this.touch();\n    } else {\n      this.rotate();\n    }\n  }\n\n  private rotate(): SessionId {\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 as 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":"qBAIA,MAAM,eAAiB,uBACjB,kBAAoB,0BACpB,cAAgB,sBAGtB,SAAS,WAAW,KAAyD,CAC3E,GAAI,CACF,IAAM,EAAI,WAAW,MACf,IAAM,sBAGZ,OAFA,EAAE,QAAQ,IAAK,GAAG,EAClB,EAAE,WAAW,GAAG,EACT,CACT,MAAQ,CACN,OAAO,IACT,CACF,CAIA,IAAa,eAAb,KAA4B,CAC1B,UAA2B,KAC3B,SAA0B,KAC1B,MACA,QACA,SAA6C,KAC7C,eAAyB,EAEzB,YAAY,SAAqB,CAC/B,KAAK,MAAQ,WAAW,cAAc,EACtC,KAAK,QAAU,WAAW,gBAAgB,EAC1C,KAAK,SAAW,UAAY,KAC5B,KAAK,QAAQ,CACf,CAEA,cAA0B,CAKxB,OAJI,KAAK,WAAa,CAAC,KAAK,UAAU,GACpC,KAAK,MAAM,EACJ,KAAK,WAEP,KAAK,OAAO,CACrB,CAEA,aAAsB,CACpB,GAAI,KAAK,SACP,OAAO,KAAK,SAGd,IAAM,OAAS,KAAK,SAAS,QAAQ,aAAa,EAQlD,OAPI,QACF,KAAK,SAAW,OACT,SAGT,KAAK,SAAW,OAAO,OAAO,WAAW,IACzC,KAAK,SAAS,QAAQ,cAAe,KAAK,QAAQ,EAC3C,KAAK,SACd,CAEA,SAAwB,CACtB,IAAM,OAAS,KAAK,OAAO,QAAQ,cAAc,EAE7C,QAAU,CAAC,KAAK,UAAU,GAC5B,KAAK,UAAY,OACjB,KAAK,MAAM,GAEX,KAAK,OAAO,CAEhB,CAEA,QAA4B,CAK1B,MAJA,MAAK,UAAYA,GAAO,EACxB,KAAK,OAAO,QAAQ,eAAgB,KAAK,SAAS,EAClD,KAAK,MAAM,EACX,KAAK,WAAW,KAAK,SAAS,EACvB,KAAK,SACd,CAEA,OAAsB,CACpB,KAAK,eAAiB,KAAK,IAAI,EAC/B,KAAK,OAAO,QAAQ,kBAAmB,OAAO,KAAK,cAAc,CAAC,CACpE,CAEA,WAA6B,CAC3B,IAAM,IAAM,KAAK,OAAO,QAAQ,iBAAiB,EAC3C,GAAK,IAAM,OAAO,GAAG,EAAI,KAAK,eAKpC,OAHI,KAAO,EACF,GAEF,KAAK,IAAI,EAAI,GAAK,IAC3B,CACF"}

package/dist/util/bot.d.mts

@@ -0,0 +1,10 @@
+//#region src/util/bot.d.ts
+/**
+ * `isBot` covers the union of the Crawlers, Fetchers, CLIs, and Libraries
+ * extensions, so `isAICrawler` / `isAIAssistant` are strict subsets that
+ * don't need separate checks. Returns `false` outside the browser (no UA
+ * to inspect).
+ */
+declare function isBotUserAgent(): boolean;
+//#endregion
+export { isBotUserAgent };

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.mts","names":[],"sources":["../../src/util/bot.ts"],"mappings":";;AAQA;;;;AAA8B;iBAAd,cAAA,CAAA"}

package/dist/util/bot.mjs

@@ -0,0 +1 @@
+import{isBot}from"@ua-parser-js/pro-enterprise/bot-detection";function isBotUserAgent(){return typeof navigator>`u`?!1:isBot(navigator.userAgent)}export{isBotUserAgent};

package/dist/util/bot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.mjs","names":[],"sources":["../../src/util/bot.ts"],"sourcesContent":["import { isBot } from \"@ua-parser-js/pro-enterprise/bot-detection\";\n\n/**\n * `isBot` covers the union of the Crawlers, Fetchers, CLIs, and Libraries\n * extensions, so `isAICrawler` / `isAIAssistant` are strict subsets that\n * don't need separate checks. Returns `false` outside the browser (no UA\n * to inspect).\n */\nexport function isBotUserAgent(): boolean {\n  if (typeof navigator === \"undefined\") {\n    return false;\n  }\n  return isBot(navigator.userAgent);\n}\n"],"mappings":"8DAQA,SAAgB,gBAA0B,CAIxC,OAHI,OAAO,UAAc,IAChB,GAEF,MAAM,UAAU,SAAS,CAClC"}

package/dist/util/global.d.mts

@@ -0,0 +1,10 @@
+//#region src/util/global.d.ts
+/**
+ * Typed read of a build-time-injected global. The Vite plugin and
+ * `withInterfere()` stamp values like `__INTERFERE_RELEASE_SLUG__` onto
+ * `globalThis`; this is the single read site so the unsafe cast lives in
+ * one place.
+ */
+declare function getGlobal<T>(key: string): T | undefined;
+//#endregion
+export { getGlobal };

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

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.mts","names":[],"sources":["../../src/util/global.ts"],"mappings":";;AAMA;;;;;iBAAgB,SAAA,GAAA,CAAa,GAAA,WAAc,CAAC"}

package/dist/util/global.mjs

@@ -0,0 +1 @@
+function getGlobal(key){return globalThis[key]}export{getGlobal};

package/dist/util/global.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.mjs","names":[],"sources":["../../src/util/global.ts"],"sourcesContent":["/**\n * Typed read of a build-time-injected global. The Vite plugin and\n * `withInterfere()` stamp values like `__INTERFERE_RELEASE_SLUG__` onto\n * `globalThis`; this is the single read site so the unsafe cast lives in\n * one place.\n */\nexport function getGlobal<T>(key: string): T | undefined {\n  return (globalThis as Record<string, unknown>)[key] as T | undefined;\n}\n"],"mappings":"AAMA,SAAgB,UAAa,IAA4B,CACvD,OAAQ,WAAuC,IACjD"}

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

@@ -1 +1 @@
-{"version":3,"file":"log.d.mts","names":[],"sources":["../../src/util/log.ts"],"mappings":";KAAY,QAAA;AAAA,iBA0BI,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"}
+{"version":3,"file":"log.d.mts","names":[],"sources":["../../src/util/log.ts"],"mappings":";KAAY,QAAA;AAAA,iBA6BI,WAAA,CAAY,KAAe,EAAR,QAAQ;AAAA,iBAI3B,WAAA,CAAA,GAAe,QAAQ;AAAA,UAKtB,MAAA;EACf,KAAA,IAAS,IAAA;EACT,KAAA,IAAS,IAAA;EACT,IAAA,IAAQ,IAAA;EACR,IAAA,IAAQ,IAAA;AAAA;AAAA,iBAeM,YAAA,CAAa,KAAA,WAAgB,MAAM"}

package/dist/util/log.mjs

@@ -1,37 +1 @@
-//#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 = typeof import.meta !== "undefined" && Boolean(import.meta.env?.VITEST) ? PRIORITY.none : 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 };
+const PRIORITY={debug:0,info:1,warn:2,error:3,none:4},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;let fn=CONSOLE_FN[level];globalThis.console[fn](prefix,...args)}function createLogger(scope){let 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)}}export{createLogger,getLogLevel,setLogLevel};

package/dist/util/log.mjs.map

@@ -1 +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\nconst isTestEnv =\n  typeof import.meta !== \"undefined\" &&\n  Boolean((import.meta as { env?: { VITEST?: unknown } }).env?.VITEST);\n\nlet threshold = isTestEnv ? PRIORITY.none : 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;AAMD,IAAI,YAHF,OAAO,OAAO,SAAS,eACvB,QAAS,OAAO,KAAwC,KAAK,OAAO,GAE1C,SAAS,OAAO,SAAS;AAErD,SAAgB,YAAY,OAAuB;AACjD,aAAY,SAAS;;AAGvB,SAAgB,cAAwB;AAEtC,QADc,OAAO,QAAQ,SAAS,CAAC,MAAM,GAAG,OAAO,MAAM,UAChD,GAAG,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"}
+{"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\n/**\n * Customer apps see `warn` and above by default. Tests opt into silence by\n * calling `setLogLevel(\"none\")` in their setup file (we don't auto-detect\n * the test runtime — verified empirically that vitest browser mode exposes\n * neither `import.meta.env`, `process.env`, nor `__VITEST_*` globals to\n * library code, so any \"is this a test?\" probe is unreliable).\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,SAAqC,CACzC,MAAO,EACP,KAAM,EACN,KAAM,EACN,MAAO,EACP,KAAM,CACR,EAEM,WAGF,CACF,MAAO,QACP,KAAM,OACN,KAAM,OACN,MAAO,OACT,EASA,IAAI,UAAY,SAAS,KAEzB,SAAgB,YAAY,MAAuB,CACjD,UAAY,SAAS,MACvB,CAEA,SAAgB,aAAwB,CAEtC,OADc,OAAO,QAAQ,QAAQ,EAAE,MAAM,EAAG,KAAO,IAAM,SACjD,IAAI,IAAM,MACxB,CASA,SAAS,KACP,MACA,OACA,KACM,CACN,GAAI,SAAS,OAAS,UACpB,OAEF,IAAM,GAAK,WAAW,OACtB,WAAW,QAAQ,IAAI,OAAQ,GAAG,IAAI,CACxC,CAEA,SAAgB,aAAa,MAAuB,CAClD,IAAM,OAAS,cAAc,MAAM,GACnC,MAAO,CACL,OAAQ,GAAG,OAAS,KAAK,QAAS,OAAQ,IAAI,EAC9C,MAAO,GAAG,OAAS,KAAK,OAAQ,OAAQ,IAAI,EAC5C,MAAO,GAAG,OAAS,KAAK,OAAQ,OAAQ,IAAI,EAC5C,OAAQ,GAAG,OAAS,KAAK,QAAS,OAAQ,IAAI,CAChD,CACF"}

package/dist/util/stringify.d.mts

@@ -0,0 +1,9 @@
+//#region src/util/stringify.d.ts
+/**
+ * `JSON.stringify` with a `String(value)` fallback for circular refs and
+ * non-serialisable values (BigInt, …). Strings pass through unchanged so
+ * single-arg log calls don't get re-quoted.
+ */
+declare function safeStringify(value: unknown): string;
+//#endregion
+export { safeStringify };

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

@@ -0,0 +1 @@
+{"version":3,"file":"stringify.d.mts","names":[],"sources":["../../src/util/stringify.ts"],"mappings":";;AAKA;;;;iBAAgB,aAAA,CAAc,KAAc"}

package/dist/util/stringify.mjs

@@ -0,0 +1 @@
+function safeStringify(value){if(typeof value==`string`)return value;try{return JSON.stringify(value)??String(value)}catch{return String(value)}}export{safeStringify};

package/dist/util/stringify.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify.mjs","names":[],"sources":["../../src/util/stringify.ts"],"sourcesContent":["/**\n * `JSON.stringify` with a `String(value)` fallback for circular refs and\n * non-serialisable values (BigInt, …). Strings pass through unchanged so\n * single-arg log calls don't get re-quoted.\n */\nexport function safeStringify(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n"],"mappings":"AAKA,SAAgB,cAAc,MAAwB,CACpD,GAAI,OAAO,OAAU,SACnB,OAAO,MAET,GAAI,CACF,OAAO,KAAK,UAAU,KAAK,GAAK,OAAO,KAAK,CAC9C,MAAQ,CACN,OAAO,OAAO,KAAK,CACrB,CACF"}