@interfere/react 11.1.1 → 12.0.0

package/dist/tracking/api.d.mts

@@ -1,55 +1,2 @@
-import { SessionResumeReason } from "../internal/activity.mjs";
-import { IngestTarget } from "../internal/config.mjs";
-import { DeviceManager } from "./device.mjs";
-import { GeoDetector } from "./geo.mjs";
-import { SessionId } from "@interfere/types/data/session";
-import { IdentifyParams } from "@interfere/types/sdk/identify";
-//#region src/tracking/api.d.ts
-interface SessionTrackerOptions {
-  device?: DeviceManager;
-  fetcher?: typeof globalThis.fetch;
-  geo?: GeoDetector;
-  target: IngestTarget;
-}
-declare class SessionTracker {
-  private readonly target;
-  private readonly fetcher;
-  private readonly device;
-  private readonly geo;
-  private mgr;
-  private readonly activity;
-  private currentIdentity;
-  private identifiedSessionId;
-  private syncedSessionId;
-  private syncAttemptMs;
-  private generation;
-  constructor(opts: SessionTrackerOptions);
-  start(): void;
-  onSessionPause(handler: () => void): () => void;
-  onSessionResume(handler: (reason: SessionResumeReason) => void): () => void;
-  sessionId(): SessionId | null;
-  windowId(): string | null;
-  markActivity(): void;
-  getSessionStartedAt(): number;
-  getDeviceId(): string | null;
-  getFpHash(): string | null;
-  /**
-   * Identity headers (session / window / device). Layered onto the
-   * session/identify POSTs alongside the target's static headers
-   * (content-type + auth + force-enable).
-   */
-  headers(): Record<string, string>;
-  getIdentity(): IdentifyParams | null;
-  identify(params: IdentifyParams): Promise<void>;
-  private postIdentify;
-  clearIdentity(): void;
-  reset(): void;
-  rotateSession(): void;
-  dispose(): void;
-  private requestHeaders;
-  private ensureSynced;
-  private syncSession;
-  private onRotate;
-}
-//#endregion
+import { n as SessionTrackerOptions, t as SessionTracker } from "../api-wpS4xoMY.mjs";
 export { SessionTracker, SessionTrackerOptions };

package/dist/tracking/api.mjs

@@ -1 +1 @@
-import{createLogger}from"../util/log.mjs";import{ActivityMonitor}from"../internal/activity.mjs";import{appendPathBeforeQuery}from"../internal/config.mjs";import{DeviceManager}from"./device.mjs";import{GeoDetector}from"./geo.mjs";import{SessionManager}from"./session.mjs";const log=createLogger(`tracking`);var SessionTracker=class{target;fetcher;device;geo;mgr=null;activity=new ActivityMonitor;currentIdentity=null;identifiedSessionId=null;syncedSessionId=null;syncAttemptMs=0;generation=0;constructor(opts){this.target=opts.target,this.fetcher=opts.fetcher??globalThis.fetch.bind(globalThis),this.device=opts.device??new DeviceManager,this.geo=opts.geo??new GeoDetector}start(){this.device.init(),this.geo.detect(),this.mgr=new SessionManager(id=>{this.onRotate(id)}),this.activity.start({markActivity:()=>this.markActivity(),reset:()=>this.rotateSession(),startedAt:()=>this.getSessionStartedAt()})}onSessionPause(handler){return this.activity.onPause(handler)}onSessionResume(handler){return this.activity.onResume(handler)}sessionId(){let id=this.mgr?.getSessionId()??null;return id&&this.ensureSynced(id),id}windowId(){return this.mgr?.getWindowId()??null}markActivity(){this.mgr?.markActivity()}getSessionStartedAt(){return this.mgr?.getSessionStartedAt()??0}getDeviceId(){return this.device.getDeviceId()}getFpHash(){return this.device.getFpHash()}headers(){let h={},sid=this.mgr?.getSessionId()??null;sid&&(h[`x-interfere-session`]=sid);let wid=this.mgr?.getWindowId()??null;wid&&(h[`x-interfere-window`]=wid);let did=this.device.getDeviceId();return did&&(h[`x-interfere-device`]=did),h}getIdentity(){return this.currentIdentity}async identify(params){if(!this.mgr)return;let sessionId=this.mgr.getSessionId();if(this.identifiedSessionId===sessionId){log.debug(`skipped, already identified for session %s`,sessionId);return}this.currentIdentity=params,this.identifiedSessionId=sessionId;let gen=this.generation,[fpHash,country]=await Promise.all([this.device.whenFingerprintReady(),this.geo.detect()]),deviceId=this.device.getDeviceId();if(gen!==this.generation){this.identifiedSessionId=null;return}log.info(`POST session %s → identify`,sessionId),this.postIdentify(sessionId,{sessionId,deviceId,fpHash,...params,...country&&{country}})}async postIdentify(sessionId,body){try{await this.fetcher(appendPathBeforeQuery(this.target.url,`/identify`),{method:`POST`,headers:this.requestHeaders(),body:JSON.stringify(body),keepalive:!0,credentials:`omit`,signal:AbortSignal.timeout(1e4)})}catch{this.identifiedSessionId=null,log.warn(`identify failed for session %s`,sessionId)}}clearIdentity(){this.currentIdentity=null,this.identifiedSessionId=null}reset(){this.clearIdentity(),this.device.reset(),this.mgr?.reset()}rotateSession(){this.mgr?.reset()}dispose(){this.activity.stop(),this.generation+=1,this.clearIdentity(),this.syncedSessionId=null,this.syncAttemptMs=0,this.mgr=null}requestHeaders(){return{...Object.fromEntries(this.target.headers.entries()),...this.headers()}}ensureSynced(sessionId){this.syncedSessionId!==sessionId&&(Date.now()-this.syncAttemptMs<5e3||this.syncSession(sessionId,this.device.getDeviceId(),this.device.getFpHash()))}async syncSession(sessionId,deviceId,fpHash){this.syncAttemptMs=Date.now(),this.syncedSessionId=sessionId;try{(await this.fetcher(this.target.url,{method:`POST`,headers:this.requestHeaders(),body:JSON.stringify({sessionId,deviceId,fpHash}),keepalive:!0,credentials:`omit`,signal:AbortSignal.timeout(1e4)})).ok||(this.syncedSessionId=null)}catch{this.syncedSessionId=null,log.warn(`session sync failed, will retry`)}}async onRotate(sessionId){this.syncedSessionId=null,this.syncAttemptMs=Date.now();let gen=this.generation;try{let fpHash=await this.device.whenFingerprintReady(),deviceId=this.device.getDeviceId();if(gen!==this.generation)return;log.debug(`POST session %s (device=%s fp=%s)`,sessionId,deviceId??`pending`,fpHash??`none`),this.syncSession(sessionId,deviceId,fpHash)}catch{}}};export{SessionTracker};
+import{createLogger}from"../util/log.mjs";import{ActivityMonitor}from"../internal/activity.mjs";import{DeviceManager}from"./device.mjs";import{GeoDetector}from"./geo.mjs";import{SessionManager}from"./session.mjs";import{omitUndefined}from"@interfere/helpers/omit-undefined";import{InterfereClient}from"@interfere/javascript";const log=createLogger(`tracking`);function syncKey(sessionId,deviceId,fpHash){return`${sessionId}|${deviceId??``}|${fpHash??``}`}var SessionTracker=class{client;device;geo;mgr=null;activity=new ActivityMonitor;currentIdentity=null;identifiedSessionId=null;lastSyncedKey=null;inflightSyncKey=null;syncAttemptMs=0;generation=0;identityStarted=!1;constructor(opts){this.client=new InterfereClient({...opts.target,maxRetries:0,timeoutInSeconds:10,fetch:Object.assign(async(input,init)=>(opts.fetcher??globalThis.fetch)(input,{...init,credentials:`omit`,keepalive:!0}),opts.fetcher??globalThis.fetch)}),this.device=opts.device??new DeviceManager,this.geo=opts.geo??new GeoDetector}start(){this.mgr=new SessionManager(id=>{this.onRotate(id)}),this.activity.start({markActivity:()=>{this.markActivity()},reset:()=>{this.rotateSession()},startedAt:()=>this.getSessionStartedAt()})}startDeviceIdentity(){this.identityStarted||(this.identityStarted=!0,this.device.init(),this.geo.detect(),this.backfillIdentity())}discardDeviceIdentity(){this.identityStarted=!1,this.device.clear(),this.geo.clear()}async backfillIdentity(){let gen=this.generation;if(await Promise.resolve(),gen!==this.generation||!this.identityStarted)return;let initialSessionId=this.mgr?.getSessionId()??null,initialFpHash=this.device.getFpHash();initialSessionId&&await this.syncSession(initialSessionId,this.device.getDeviceId(),initialFpHash);let fpHash=await this.device.whenFingerprintReady(),sessionId=this.mgr?.getSessionId()??null;gen===this.generation&&this.identityStarted&&sessionId&&fpHash!==initialFpHash&&this.syncSession(sessionId,this.device.getDeviceId(),fpHash)}onSessionPause(handler){return this.activity.onPause(handler)}onSessionResume(handler){return this.activity.onResume(handler)}sessionId(){let id=this.mgr?.getSessionId()??null;return id&&this.ensureSynced(id),id}windowId(){return this.mgr?.getWindowId()??null}markActivity(){this.mgr?.markActivity()}getSessionStartedAt(){return this.mgr?.getSessionStartedAt()??0}getDeviceId(){return this.device.getDeviceId()}getFpHash(){return this.device.getFpHash()}getIdentity(){return this.currentIdentity}async identify(params){if(!this.mgr)return;let sessionId=this.mgr.getSessionId();if(this.identifiedSessionId===sessionId){log.debug(`skipped, already identified for session %s`,sessionId);return}this.currentIdentity=params,this.identifiedSessionId=sessionId;let gen=this.generation,[fpHash,country]=await Promise.all([this.device.whenFingerprintReady(),this.geo.detect()]),deviceId=this.device.getDeviceId();if(gen!==this.generation){this.identifiedSessionId=null;return}log.info(`POST session %s → identify`,sessionId),this.postIdentify(sessionId,omitUndefined({deviceId,fpHash,sessionId,...params,country:country||void 0}))}async postIdentify(sessionId,body){try{await this.client.sessions.identifySession(body)}catch{this.identifiedSessionId=null,log.warn(`identify failed for session %s`,sessionId)}}clearIdentity(){this.currentIdentity=null,this.identifiedSessionId=null}reset(){this.clearIdentity(),this.identityStarted&&this.device.reset(),this.mgr?.reset()}rotateSession(){this.mgr?.reset()}dispose(){this.activity.stop(),this.generation+=1,this.clearIdentity(),this.lastSyncedKey=null,this.inflightSyncKey=null,this.syncAttemptMs=0,this.mgr=null}ensureSynced(sessionId){let deviceId=this.device.getDeviceId(),fpHash=this.device.getFpHash(),key=syncKey(sessionId,deviceId,fpHash);this.lastSyncedKey!==key&&this.inflightSyncKey!==key&&(Date.now()-this.syncAttemptMs<5e3||this.syncSession(sessionId,deviceId,fpHash))}async syncSession(sessionId,deviceId,fpHash){let key=syncKey(sessionId,deviceId,fpHash);if(this.lastSyncedKey!==key&&this.inflightSyncKey!==key){this.inflightSyncKey=key,this.syncAttemptMs=Date.now();try{await this.client.sessions.createSession({sessionId,deviceId,fpHash}),this.lastSyncedKey=key}catch{log.warn(`session sync failed, will retry`)}finally{this.inflightSyncKey===key&&(this.inflightSyncKey=null)}}}async onRotate(sessionId){this.syncAttemptMs=Date.now();let gen=this.generation;try{await Promise.resolve();let fpHash=this.device.getFpHash(),deviceId=this.device.getDeviceId();if(gen!==this.generation)return;log.debug(`POST session %s (device=%s fp=%s)`,sessionId,deviceId??`pending`,fpHash??`none`),this.syncSession(sessionId,deviceId,fpHash)}catch{}}};export{SessionTracker};

package/dist/tracking/device.d.mts

@@ -1,33 +1,2 @@
-//#region src/tracking/device.d.ts
-/**
- * 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>;
-  reset(): string;
-}
-//#endregion
+import { n as FingerprintProvider, r as whenIdle, t as DeviceManager } from "../device-vFtWy12y.mjs";
 export { DeviceManager, FingerprintProvider, whenIdle };

package/dist/tracking/device.mjs

@@ -1 +1 @@
-import{createLogger}from"../util/log.mjs";const log=createLogger(`device`),LS_KEY=`interfere:device_id`,COOKIE_NAME=`interfere_did`;function whenIdle(){let{promise,resolve}=Promise.withResolvers();return typeof globalThis.requestIdleCallback==`function`?globalThis.requestIdleCallback(()=>resolve(void 0),{timeout:5e3}):setTimeout(()=>resolve(void 0),0),promise}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(error){return log.error(`fingerprint init failed; visitor identity will be cookie-only`,error),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=34560000;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)}reset(){return this.deviceId=generateId(),tryLocalStorage()?.setItem(LS_KEY,this.deviceId),setCookie(COOKIE_NAME,this.deviceId),log.debug(`device %s (reset)`,this.deviceId),this.deviceId}};export{DeviceManager,whenIdle};
+import{createLogger}from"../util/log.mjs";const log=createLogger(`device`),LS_KEY=`interfere:device_id`,COOKIE_NAME=`interfere_did`;async function whenIdle(){let{promise,resolve}=Promise.withResolvers();return typeof globalThis.requestIdleCallback==`function`?globalThis.requestIdleCallback(()=>{resolve(void 0)},{timeout:5e3}):setTimeout(()=>{resolve(void 0)},0),promise}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(error){return log.error(`fingerprint init failed; visitor identity will be cookie-only`,error),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,maxAgeSeconds){typeof document>`u`||(document.cookie=`${name}=${encodeURIComponent(value)};path=/;max-age=${maxAgeSeconds};SameSite=Lax`)}function persistCookie(name,value){setCookie(name,value,3456e4)}function deleteCookie(name){setCookie(name,``,0)}function generateId(){return crypto.randomUUID()}var DeviceManager=class{deviceId=null;fpHash=null;fpPending=null;epoch=0;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||persistCookie(COOKIE_NAME,this.deviceId),fromLs&&!fromCookie&&persistCookie(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(){if(this.fpHash||this.fpPending)return;let{epoch}=this;this.fpPending=(async()=>{let hash=await this.fingerprintProvider();return epoch===this.epoch?(this.fpHash=hash,hash&&log.debug(`fpHash %s`,hash),hash):null})()}getDeviceId(){return this.deviceId}getFpHash(){return this.fpHash}async whenFingerprintReady(){return this.fpHash?this.fpHash:this.fpPending??Promise.resolve(null)}reset(){return this.deviceId=generateId(),tryLocalStorage()?.setItem(LS_KEY,this.deviceId),persistCookie(COOKIE_NAME,this.deviceId),log.debug(`device %s (reset)`,this.deviceId),this.deviceId}clear(){this.epoch+=1,this.deviceId=null,this.fpHash=null,this.fpPending=null,tryLocalStorage()?.removeItem(LS_KEY),deleteCookie(COOKIE_NAME),log.debug(`device identity cleared`)}};export{DeviceManager,whenIdle};

package/dist/tracking/geo.d.mts

@@ -1,14 +1,2 @@
-//#region src/tracking/geo.d.ts
-declare class GeoDetector {
-  private cached;
-  private pending;
-  private failed;
-  private readonly fetcher;
-  constructor(fetcher?: typeof globalThis.fetch);
-  detect(): Promise<string | null>;
-  private resolveCountryCode;
-  getCountry(): string | null;
-  private fetchCountryCode;
-}
-//#endregion
+import { t as GeoDetector } from "../geo-PDfIZY4L.mjs";
 export { GeoDetector };

package/dist/tracking/geo.mjs

@@ -1,2 +1,2 @@
 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.resolveCountryCode(),this.pending)}async resolveCountryCode(){let code=await this.fetchCountryCode();return this.cached=code,code||(this.failed=!0),this.pending=null,code}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};
+`)){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;epoch=0;fetcher;constructor(fetcher){this.fetcher=fetcher??globalThis.fetch.bind(globalThis)}async detect(){return this.cached?this.cached:this.failed?null:(this.pending??=this.resolveCountryCode(),this.pending)}async resolveCountryCode(){let{epoch}=this,code=await this.fetchCountryCode();return epoch===this.epoch?(this.cached=code,code||(this.failed=!0),this.pending=null,code):null}getCountry(){return this.cached}clear(){this.epoch+=1,this.cached=null,this.failed=!1,this.pending=null}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/session.d.mts

@@ -1,8 +1,8 @@
 import { SessionId } from "@interfere/types/data/session";
 //#region src/tracking/session.d.ts
-type OnRotate = (sessionId: string) => void;
-declare class SessionManager {
-  sessionId: string | null;
+export type OnRotate = (sessionId: string) => void;
+export declare class SessionManager {
+  sessionId: SessionId | null;
   windowId: string | null;
   private readonly local;
   private readonly session;
@@ -10,15 +10,14 @@ declare class SessionManager {
   private lastActivityMs;
   private sessionStartedMs;
   constructor(onRotate?: OnRotate);
-  getSessionId(): SessionId;
+  getSessionId(): string & import("zod").$brand<"SessionId">;
   markActivity(): void;
   getSessionStartedAt(): number;
   getWindowId(): string;
-  reset(): SessionId;
+  reset(): string & import("zod").$brand<"SessionId">;
   private restore;
   private rotate;
   private touch;
   private isExpired;
 }
-//#endregion
-export { OnRotate, SessionManager };
+//#endregion

package/dist/tracking/session.mjs

@@ -1 +1 @@
-import{v7}from"uuid";const SESSION_ID_KEY=`interfere:session_id`,LAST_ACTIVITY_KEY=`interfere:last_activity`,SESSION_STARTED_KEY=`interfere:session_started`,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;sessionStartedMs=0;constructor(onRotate){this.local=tryStorage(`localStorage`),this.session=tryStorage(`sessionStorage`),this.onRotate=onRotate??null,this.restore()}getSessionId(){return this.sessionId?this.sessionId:this.rotate()}markActivity(){this.touch()}getSessionStartedAt(){return this.sessionStartedMs}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)}reset(){return this.rotate()}restore(){let stored=this.local?.getItem(SESSION_ID_KEY),startedRaw=this.local?.getItem(SESSION_STARTED_KEY);this.sessionStartedMs=startedRaw?Number(startedRaw):0,stored&&!this.isExpired()?(this.sessionId=stored,this.touch()):this.rotate()}rotate(){return this.sessionId=v7(),this.sessionStartedMs=Date.now(),this.local?.setItem(SESSION_ID_KEY,this.sessionId),this.local?.setItem(SESSION_STARTED_KEY,String(this.sessionStartedMs)),this.touch(),this.onRotate?.(this.sessionId),this.sessionId}touch(){this.lastActivityMs=Date.now(),this.local?.setItem(LAST_ACTIVITY_KEY,String(this.lastActivityMs))}isExpired(){if(this.sessionStartedMs>0&&Date.now()-this.sessionStartedMs>864e5)return!0;let raw=this.local?.getItem(LAST_ACTIVITY_KEY),ts=raw?Number(raw):this.lastActivityMs;return ts===0||Date.now()-ts>9e5}};export{SessionManager};
+import{sessionIdSchema}from"@interfere/types/data/session";import{v7}from"uuid";const SESSION_ID_KEY=`interfere:session_id`,LAST_ACTIVITY_KEY=`interfere:last_activity`,SESSION_STARTED_KEY=`interfere:session_started`,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;sessionStartedMs=0;constructor(onRotate){this.local=tryStorage(`localStorage`),this.session=tryStorage(`sessionStorage`),this.onRotate=onRotate??null,this.restore()}getSessionId(){return this.sessionId?this.sessionId:this.rotate()}markActivity(){this.touch()}getSessionStartedAt(){return this.sessionStartedMs}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)}reset(){return this.rotate()}restore(){let stored=this.local?.getItem(SESSION_ID_KEY),startedRaw=this.local?.getItem(SESSION_STARTED_KEY),parsed=sessionIdSchema.safeParse(stored);this.sessionStartedMs=startedRaw?Number(startedRaw):0,parsed.success&&!this.isExpired()?(this.sessionId=parsed.data,this.touch()):this.rotate()}rotate(){return this.sessionId=sessionIdSchema.parse(v7()),this.sessionStartedMs=Date.now(),this.local?.setItem(SESSION_ID_KEY,this.sessionId),this.local?.setItem(SESSION_STARTED_KEY,String(this.sessionStartedMs)),this.touch(),this.onRotate?.(this.sessionId),this.sessionId}touch(){this.lastActivityMs=Date.now(),this.local?.setItem(LAST_ACTIVITY_KEY,String(this.lastActivityMs))}isExpired(){if(this.sessionStartedMs>0&&Date.now()-this.sessionStartedMs>864e5)return!0;let raw=this.local?.getItem(LAST_ACTIVITY_KEY),ts=raw?Number(raw):this.lastActivityMs;return ts===0||Date.now()-ts>9e5}};export{SessionManager};

package/dist/util/bot.d.mts

@@ -5,6 +5,5 @@
  * don't need separate checks. Returns `false` outside the browser (no UA
  * to inspect).
  */
-declare function isBotUserAgent(): boolean;
-//#endregion
-export { isBotUserAgent };
+export declare function isBotUserAgent(): boolean;
+//#endregion

package/dist/util/bot.mjs

@@ -1 +1 @@
-import{isBot}from"@ua-parser-js/pro-enterprise/bot-detection";function isBotUserAgent(){return typeof navigator>`u`?!1:isBot(navigator.userAgent)}export{isBotUserAgent};
+import{isBot}from"@ua-parser-js/pro-enterprise/bot-detection";const AUTOMATION_UA_RE=/headless|electron|puppeteer|playwright/iu;function isBotUserAgent(){return typeof navigator>`u`?!1:navigator.webdriver||AUTOMATION_UA_RE.test(navigator.userAgent)?!0:isBot(navigator.userAgent)}export{isBotUserAgent};

package/dist/util/global.d.mts

@@ -1,11 +1,5 @@
 //#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;
-declare function setGlobal(key: string, value: unknown): void;
-//#endregion
-export { getGlobal, setGlobal };
+export declare function getGlobal(key: string): unknown;
+export declare function getStringGlobal(key: string): string | undefined;
+export declare function setGlobal(key: string, value: unknown): void;
+//#endregion

package/dist/util/global.mjs

@@ -1 +1 @@
-function getGlobal(key){return globalThis[key]}function setGlobal(key,value){globalThis[key]=value}export{getGlobal,setGlobal};
+function getGlobal(key){return Reflect.get(globalThis,key)}function getStringGlobal(key){let value=getGlobal(key);return typeof value==`string`?value:void 0}function setGlobal(key,value){Reflect.set(globalThis,key,value)}export{getGlobal,getStringGlobal,setGlobal};

package/dist/util/log.d.mts

@@ -1,13 +1,17 @@
 //#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 {
+export type LogLevel = "debug" | "info" | "warn" | "error" | "none";
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export 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 };
+export declare function createLogger(scope: string): {
+  debug: (...args: unknown[]) => void;
+  error: (...args: unknown[]) => void;
+  info: (...args: unknown[]) => void;
+  warn: (...args: unknown[]) => void;
+};
+//#endregion

package/dist/util/log.mjs

@@ -1 +1 @@
-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};
+const PRIORITY={debug:0,error:3,info:1,none:4,warn:2},CONSOLE_FN={debug:`debug`,error:`error`,info:`info`,warn:`warn`};let currentLevel=`warn`;function setLogLevel(level){currentLevel=level}function getLogLevel(){return currentLevel}function emit(level,prefix,args){if(PRIORITY[level]<PRIORITY[currentLevel])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)},error:(...args)=>{emit(`error`,prefix,args)},info:(...args)=>{emit(`info`,prefix,args)},warn:(...args)=>{emit(`warn`,prefix,args)}}}export{createLogger,getLogLevel,setLogLevel};

package/dist/util/stringify.d.mts

@@ -4,6 +4,5 @@
  * 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 };
+export declare function safeStringify(value: unknown): string;
+//#endregion

package/dist/version-BniHrwLD.mjs

@@ -0,0 +1 @@
+var name=`@interfere/react`,version=`12.0.0`;const SDK_NAME=name,SDK_VERSION=version,PRODUCER_VERSION=`${SDK_NAME}@${SDK_VERSION}`;export{SDK_NAME as n,SDK_VERSION as r,PRODUCER_VERSION as t};

package/dist/web-vitals-x8y70B5x.d.mts

@@ -0,0 +1,34 @@
+import { Meter } from "@opentelemetry/api";
+//#region src/internal/otel/web-vitals.d.ts
+interface WebVitalsInput {
+  /**
+   * Called after the page-load vitals have all fired. The kernel passes
+   * its own `flush()` so short-visit exports don't depend on the
+   * `visibilitychange` listener firing.
+   */
+  flush: () => Promise<void>;
+  /** OTel meter from the kernel's private provider. */
+  meter: Meter;
+  /**
+   * Pathname → low-cardinality route template (e.g. `/blog/[slug]`).
+   * Without this, dynamic routes produce one unique `url.path` label
+   * per visited slug — a metric cardinality hazard.
+   */
+  resolveRoute?: (pathname: string) => string | undefined;
+}
+/**
+ * Subscribes to Core Web Vitals (LCP/FCP/TTFB/INP/CLS) and records OTel
+ * histograms. Time-based vitals are converted to seconds per
+ * observability convention; CLS is dimensionless and recorded as-is.
+ *
+ * Each record carries `web_vital.rating`, `web_vital.navigation_type`,
+ * and `url.path` (templated when `resolveRoute` is provided). Browser
+ * and device dimensions come from the resource attached to the
+ * MeterProvider, so every histogram datapoint already carries them.
+ *
+ * Bucket boundaries match the rum.ts SDK — same dashboards, same
+ * histograms, same percentile shape.
+ */
+declare function captureWebVitals(input: WebVitalsInput): void;
+//#endregion
+export { captureWebVitals as n, WebVitalsInput as t };

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@interfere/react",
-  "version": "11.1.1",
-  "license": "MIT",
+  "version": "12.0.0",
   "description": "Client-side React SDK for Interfere. Error tracking, session replay, and analytics.",
   "keywords": [
+    "error-tracking",
     "observability",
-    "typescript",
     "react",
-    "error-tracking",
-    "session-replay"
+    "session-replay",
+    "typescript"
   ],
   "homepage": "https://interfere.com",
   "bugs": {
     "url": "mailto:support@interfere.com"
   },
+  "license": "MIT",
   "author": "Interfere <support@interfere.com> (https://interfere.com)",
   "repository": {
     "type": "git",
@@ -24,6 +24,7 @@
     "dist"
   ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     "./provider": {
       "monorepo": "./src/provider.tsx",
@@ -70,54 +71,85 @@
       "types": "./dist/internal/sw-queue.d.mts",
       "default": "./dist/internal/sw-queue.mjs"
     },
+    "./util/global": {
+      "monorepo": "./src/util/global.ts",
+      "types": "./dist/util/global.d.mts",
+      "default": "./dist/util/global.mjs"
+    },
     "./util/log": {
       "monorepo": "./src/util/log.ts",
       "types": "./dist/util/log.d.mts",
       "default": "./dist/util/log.mjs"
     }
   },
-  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "build": "tsdown",
     "test": "vitest run",
+    "test:artifact": "bun run build && node --test test/recorder-artifact.test.mts",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@fingerprintjs/fingerprintjs": "^5.2.0",
-    "@interfere/constants": "^9.0.5",
-    "@interfere/helpers": "^9.1.1",
-    "@interfere/types": "^10.1.1",
+    "@interfere/constants": "^9.1.0",
+    "@interfere/helpers": "^9.2.0",
+    "@interfere/javascript": "^0.2.0",
+    "@interfere/types": "^10.2.0",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/api-logs": "^0.221.0",
-    "@opentelemetry/context-zone": "^2.7.1",
-    "@opentelemetry/core": "^2.7.0",
-    "@opentelemetry/instrumentation": "^0.221.0",
-    "@opentelemetry/instrumentation-browser-navigation": "^0.14.0",
-    "@opentelemetry/instrumentation-document-load": "^0.66.0",
-    "@opentelemetry/instrumentation-fetch": "^0.221.0",
-    "@opentelemetry/instrumentation-long-task": "^0.65.0",
-    "@opentelemetry/instrumentation-user-interaction": "^0.65.0",
-    "@opentelemetry/instrumentation-xml-http-request": "^0.221.0",
-    "@opentelemetry/opentelemetry-browser-detector": "^0.221.0",
-    "@opentelemetry/otlp-transformer": "^0.221.0",
-    "@opentelemetry/resources": "^2.7.0",
-    "@opentelemetry/sdk-logs": "^0.221.0",
-    "@opentelemetry/sdk-metrics": "^2.7.0",
-    "@opentelemetry/sdk-trace-base": "^2.7.0",
-    "@opentelemetry/sdk-trace-web": "^2.7.1",
-    "@opentelemetry/web-common": "^0.221.0",
+    "@opentelemetry/api-logs": "^0.222.0",
+    "@opentelemetry/context-zone": "^2.11.0",
+    "@opentelemetry/core": "^2.11.0",
+    "@opentelemetry/instrumentation": "^0.222.0",
+    "@opentelemetry/instrumentation-browser-navigation": "^0.15.0",
+    "@opentelemetry/instrumentation-document-load": "^0.67.0",
+    "@opentelemetry/instrumentation-fetch": "^0.222.0",
+    "@opentelemetry/instrumentation-long-task": "^0.66.0",
+    "@opentelemetry/instrumentation-user-interaction": "^0.66.0",
+    "@opentelemetry/instrumentation-xml-http-request": "^0.222.0",
+    "@opentelemetry/opentelemetry-browser-detector": "^0.222.0",
+    "@opentelemetry/otlp-transformer": "^0.222.0",
+    "@opentelemetry/resources": "^2.11.0",
+    "@opentelemetry/sdk-logs": "^0.222.0",
+    "@opentelemetry/sdk-metrics": "^2.11.0",
+    "@opentelemetry/sdk-trace-base": "^2.11.0",
+    "@opentelemetry/sdk-trace-web": "^2.11.0",
+    "@opentelemetry/web-common": "^0.222.0",
     "@rrweb/types": "2.1.1",
     "@ua-parser-js/pro-enterprise": "^2.0.6",
     "rrweb": "2.1.1",
-    "uuid": "^14.0.1",
-    "web-vitals": "^6.1.0",
-    "workbox-background-sync": "^7.4.0"
+    "uuid": "^14.0.2",
+    "web-vitals": "^6.2.1",
+    "workbox-background-sync": "^7.4.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.29.7",
+    "@interfere/typescript-config": "^9.0.2",
+    "@interfere/vitest-config": "0.0.0",
+    "@rolldown/plugin-babel": "^0.2.3",
+    "@types/babel__core": "^7.20.5",
+    "@types/node": "^26.4.1",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.7",
+    "@vitejs/plugin-react": "^6.1.1",
+    "@vitest/browser": "5.0.1",
+    "@vitest/browser-playwright": "5.0.1",
+    "@vitest/coverage-v8": "5.0.1",
+    "babel-plugin-react-compiler": "1.0.0",
+    "fflate": "^0.8.3",
+    "msw": "^2.14.6",
+    "playwright": "^1.63.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "5.0.1",
+    "vitest-browser-react": "2.3.0"
   },
   "peerDependencies": {
-    "react": "^19.2.6",
+    "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "peerDependenciesMeta": {
@@ -128,22 +160,9 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "@interfere/test-utils": "^9.1.1",
-    "@interfere/typescript-config": "^9.0.2",
-    "@types/node": "^26.2.0",
-    "@types/react": "19.2.18",
-    "@types/react-dom": "19.2.4",
-    "@vitest/browser": "4.1.10",
-    "@vitest/browser-playwright": "4.1.10",
-    "@vitest/coverage-v8": "4.1.10",
-    "fflate": "^0.8.3",
-    "playwright": "^1.62.1",
-    "react": "^19.2.6",
-    "react-dom": "19.2.8",
-    "tsdown": "^0.22.2",
-    "typescript": "^7.0.2",
-    "vitest": "4.1.10",
-    "vitest-browser-react": "2.2.0"
+  "msw": {
+    "workerDirectory": [
+      "test/public"
+    ]
   }
 }

package/dist/package.mjs

@@ -1 +0,0 @@
-var name=`@interfere/react`,version=`11.1.1`;export{name,version};