@faststats/web 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @faststats/web
 
+## 0.2.6
+
+### Patch Changes
+
+- 7d57d50: fix: replay flushing issues
+
+## 0.2.5
+
+### Patch Changes
+
+- dd932a0: fix: replay config mismatch
+
 ## 0.2.4
 
 ### Patch Changes

package/dist/analytics-D_dgxSVU.js

@@ -0,0 +1 @@
+import{a as e,c as t,d as n,f as r,i,l as a,m as o,n as s,o as c,r as l,s as u,t as d,u as f}from"./types-Df70G0eM.js";async function p(e,t){if(t.projectToken&&t.projectId)throw Error(`provide either projectToken or projectId, not both`);if(t.identifier&&t.externalId)throw Error(`provide either serverId or externalId, not both`);let n=t.projectToken,r=t.projectId,i=t.identifier,o=t.externalId;if(!n&&!r)throw Error(`feature flag check requires projectToken or projectId`);if(!i&&!o)throw Error(`feature flag check requires serverId or externalId`);let s={key:e,...r?{projectId:r}:{},...i?{identifier:i}:{externalId:o}};t.attributes&&Object.keys(t.attributes).length>0&&(s.attributes=t.attributes);let c={"Content-Type":`application/json`};n&&(c.Authorization=`Bearer ${n}`);let l=a(t.baseUrl),u=await fetch(l,{method:`POST`,headers:c,body:JSON.stringify(s),credentials:`omit`,signal:t.signal});if(!u.ok){let e=``;try{let t=await u.json();typeof t.error==`string`&&t.error.length>0&&(e=` — ${t.error}`)}catch{}throw Error(`feature flag check failed: HTTP ${u.status}${e}`)}return await u.json()}function m(e){return e.replayOptions?.samplingPercentage!==void 0||e.sessionReplays?.sampling?.percentage!==void 0}function h(e,t,n){if(!(e.sessionReplays?.enabled??e.trackReplay??m(e)))return null;let r=e.replayOptions??{};return{siteKey:e.siteKey,baseUrl:t,debug:n,...r,samplingPercentage:d(r.samplingPercentage??e.sessionReplays?.sampling?.percentage)}}let g=null,_;function v(){return g}function y(e,t){typeof window>`u`||E()||g?.track(e,t??{})}function b(e,t,n){typeof window>`u`||E()||g?.identify(e,t,n??{})}function x(e=!0){typeof window>`u`||E()||g?.logout(e)}function S(e){if(g){g.setConsentMode(e);return}_=e}function C(){S(`granted`)}function w(){S(`denied`)}function T(e){typeof window>`u`||E()||g?.reportError(e)}function E(){if(typeof localStorage>`u`)return!1;let e=localStorage.getItem(`disable-faststats`);return e===`true`||e===`1`}async function D(e){let{url:t,data:n,contentType:r=`application/json`,headers:i={},debug:a=!1,debugPrefix:o=`[Analytics]`,useBeacon:s=!0,keepalive:c=!0}=e;if(s&&typeof navigator<`u`&&typeof navigator.sendBeacon==`function`)try{let e=n instanceof Blob?n:typeof Blob<`u`?new Blob([n],{type:r}):n;if(navigator.sendBeacon(t,e))return a&&console.log(`${o} Sent via beacon`),!0}catch{}if(typeof fetch!=`function`)return a&&console.warn(`${o} Failed to send`),!1;try{let e=await fetch(t,{method:`POST`,body:n,headers:{"Content-Type":r,...i},keepalive:c}),s=e.ok;return a&&(s?console.log(`${o} Sent via fetch`):console.warn(`${o} Failed: ${e.status}`)),s}catch{return a&&console.warn(`${o} Failed to send`),!1}}function O(e){for(;e;){if(e instanceof HTMLAnchorElement&&e.href)return e;e=e.parentNode}return null}function k(){let e={};if(!location.search)return e;let t=new URLSearchParams(location.search);for(let n of[`utm_source`,`utm_medium`,`utm_campaign`,`utm_term`,`utm_content`]){let r=t.get(n);r&&(e[n]=r)}return e}var A=class{webEndpoint;baseUrl;featureFlagsBaseUrl;debug;started=!1;destroyed=!1;pageKey=``;navTimer=null;heartbeatTimer=null;scrollDepth=0;pageEntryTime=0;pagePath=``;pageUrl=``;pageHash=``;hasLeftCurrentPage=!1;scrollHandler=null;consentMode;cookielessWhilePending;cleanupCallbacks=[];childTrackers=[];pendingReportedErrors=[];errorTracker=null;handleVisibilityChange=()=>{document.visibilityState===`hidden`?(this.leavePage(),this.stopHeartbeat()):this.startHeartbeat()};handlePageHide=()=>{this.leavePage()};handlePopState=()=>{this.navigate()};handleHashChange=()=>{this.navigate()};constructor(e){this.options=e,this.baseUrl=n(e.baseUrl),this.featureFlagsBaseUrl=r(e.featureFlagsBaseUrl),this.webEndpoint=o(this.baseUrl),this.debug=e.debug??!1,this.consentMode=e.consent?.mode??`granted`,this.cookielessWhilePending=e.consent?.cookielessWhilePending??!0,_!==void 0&&(this.consentMode=_,_=void 0),(e.autoTrack??!0)&&this.init()}log(e){this.debug&&console.log(`[Analytics] ${e}`)}init(){if(!(typeof window>`u`)){if(E()){this.log(`disabled`);return}g=this,t(this.isCookielessMode()),setTimeout(()=>void this.start(),0)}}registerCleanup(e){this.cleanupCallbacks.push(e)}addWindowListener(e,t){window.addEventListener(e,t),this.registerCleanup(()=>window.removeEventListener(e,t))}addDocumentListener(e,t){document.addEventListener(e,t),this.registerCleanup(()=>document.removeEventListener(e,t))}patchHistory(){let e=history.pushState.bind(history),t=history.replaceState.bind(history);history.pushState=(t,n,r)=>{e(t,n,r),this.navigate()},history.replaceState=(e,n,r)=>{t(e,n,r),this.navigate()},this.registerCleanup(()=>{history.pushState=e,history.replaceState=t})}ensureStarted(){return typeof window>`u`||this.destroyed||E()?!1:(this.started||this.start(),!0)}stopHeartbeat(){this.heartbeatTimer&&=(clearInterval(this.heartbeatTimer),null)}stopNavigationTimer(){this.navTimer&&=(clearTimeout(this.navTimer),null)}stopChildTrackers(){for(let e of this.childTrackers.splice(0))e.stop?.();this.errorTracker=null}registerChildTracker(e){return!this.started||this.destroyed||g!==this?(e.stop?.(),!1):(this.childTrackers.push(e),!0)}async startErrorTracker(){try{let{default:e}=await import(`./error-Df3cDcoP.js`);if(!this.started||this.destroyed||g!==this)return;let t=new e({siteKey:this.options.siteKey,baseUrl:this.baseUrl,debug:this.debug});if(t.start(),!this.registerChildTracker(t))return;for(this.errorTracker=t;this.pendingReportedErrors.length>0;){let e=this.pendingReportedErrors.shift();e&&t.captureError(e)}this.log(`error loaded`)}catch(e){this.log(`failed to initialize error tracker: ${String(e)}`)}}async startWebVitalsTracker(){try{let{default:e}=await import(`./web-vitals-gcUR-TX_.js`);if(!this.started||this.destroyed||g!==this)return;let t=new e({siteKey:this.options.siteKey,baseUrl:this.baseUrl,debug:this.debug,samplingPercentage:d(this.options.webVitals?.sampling?.percentage)});if(t.start(),!this.registerChildTracker(t))return;this.log(`web-vitals loaded`)}catch(e){this.log(`failed to initialize web-vitals tracker: ${String(e)}`)}}async startReplayTracker(e){try{let{default:t}=await import(`./replay-alCILAnP.js`);if(!this.started||this.destroyed||g!==this)return;let n=new t(e);if(n.start(),!this.registerChildTracker(n))return;this.log(`replay loaded`)}catch(e){this.log(`failed to initialize replay tracker: ${String(e)}`)}}async start(){if(this.started||this.destroyed||typeof window>`u`)return;if(g&&g!==this){this.log(`already started by another instance`);return}if(E()){this.log(`disabled`);return}this.started=!0,g=this,t(this.isCookielessMode()),l();let e=this.options,n=h(e,this.baseUrl,this.debug);n&&this.startReplayTracker(n),e.trackErrors&&this.startErrorTracker(),e.trackWebVitals&&this.startWebVitalsTracker(),this.enterPage(),this.pageview({trigger:`load`}),this.links(),this.trackScroll(),this.startHeartbeat(),this.addDocumentListener(`visibilitychange`,this.handleVisibilityChange),this.addWindowListener(`pagehide`,this.handlePageHide),this.addWindowListener(`popstate`,this.handlePopState),e.trackHash&&this.addWindowListener(`hashchange`,this.handleHashChange),this.patchHistory()}destroy(){if(!this.destroyed){for(this.started&&typeof window<`u`&&this.leavePage(),this.pendingReportedErrors.length=0,this.stopNavigationTimer(),this.stopHeartbeat(),this.scrollHandler&&typeof window<`u`&&(window.removeEventListener(`scroll`,this.scrollHandler),this.scrollHandler=null);this.cleanupCallbacks.length>0;)this.cleanupCallbacks.pop()?.();this.stopChildTrackers(),g===this&&(g=null),this.started=!1,this.destroyed=!0}}pageview(e={}){if(!this.ensureStarted())return;let t=`${location.pathname}|${this.options.trackHash??!1?location.hash:``}`;t!==this.pageKey&&(this.pageKey=t,this.send(`pageview`,e))}track(e,t={}){this.ensureStarted()&&this.send(e,t)}identify(e,t,n={}){if(!this.ensureStarted()||this.isCookielessMode())return;let r=e.trim(),i=t.trim();!r||!i||D({url:f(this.baseUrl),data:JSON.stringify({token:this.options.siteKey,identifier:s(!1),externalId:r,email:i,name:n.name?.trim()||void 0,phone:n.phone?.trim()||void 0,avatarUrl:n.avatarUrl?.trim()||void 0,traits:n.traits??{}}),contentType:`text/plain`,debug:this.debug,debugPrefix:`[Analytics] identify`})}logout(e=!0){this.ensureStarted()&&(e&&c(this.isCookielessMode()),u())}setConsentMode(e){this.consentMode=e,t(this.isCookielessMode())}optIn(){this.setConsentMode(`granted`)}optOut(){this.setConsentMode(`denied`)}getConsentMode(){return this.consentMode}getAnonymousId(){return s(this.isCookielessMode())}getSessionId(){return l()}async checkFeatureFlag(e,t,n){if(typeof window>`u`||E())return{value:`false`};let r=n?.externalId?.trim();if(r)return p(e,{baseUrl:this.featureFlagsBaseUrl,projectToken:this.options.siteKey,externalId:r,attributes:t,signal:n?.signal});let i=this.getAnonymousId();return i?p(e,{baseUrl:this.featureFlagsBaseUrl,projectToken:this.options.siteKey,identifier:i,attributes:t,signal:n?.signal}):{value:`false`}}reportError(e){if(this.destroyed||typeof window>`u`||E()||!(this.options.trackErrors??!1)||!this.ensureStarted())return;let t=this.errorTracker;if(t){t.captureError(e);return}this.pendingReportedErrors.length>=50&&this.pendingReportedErrors.shift(),this.pendingReportedErrors.push(e)}isCookielessMode(){return this.options.cookieless||this.consentMode===`denied`?!0:this.consentMode===`pending`?this.cookielessWhilePending:!1}send(e,t={}){if(typeof window>`u`||this.destroyed||E())return;let n=s(this.isCookielessMode()),r=JSON.stringify({token:this.options.siteKey,...n?{userId:n}:{},sessionId:l(),data:{event:e,page:location.pathname,referrer:document.referrer||null,title:document.title||``,url:location.href,...k(),...t}});this.log(e),D({url:this.webEndpoint,data:r,contentType:`text/plain`,debug:this.debug,debugPrefix:`[Analytics] ${e}`})}enterPage(){this.pageEntryTime=Date.now(),this.pagePath=location.pathname,this.pageUrl=location.href,this.pageHash=location.hash,this.scrollDepth=0,this.hasLeftCurrentPage=!1}leavePage(){if(this.destroyed||this.hasLeftCurrentPage)return;this.hasLeftCurrentPage=!0;let e=Date.now();this.send(`page_leave`,{page:this.pagePath,url:this.pageUrl,time_on_page:e-this.pageEntryTime,scroll_depth:this.scrollDepth,session_duration:e-i()})}trackScroll(){this.scrollHandler&&window.removeEventListener(`scroll`,this.scrollHandler);let e=()=>{let e=document.documentElement,t=document.body,n=window.innerHeight,r=Math.max(e.scrollHeight,t.scrollHeight);if(r<=n){this.scrollDepth=100;return}let i=Math.min(100,Math.round(((window.scrollY||e.scrollTop)+n)/r*100));i>this.scrollDepth&&(this.scrollDepth=i)};this.scrollHandler=e,e(),window.addEventListener(`scroll`,e,{passive:!0})}startHeartbeat(){this.stopHeartbeat(),this.heartbeatTimer=setInterval(()=>{if(document.visibilityState===`hidden`){this.stopHeartbeat();return}e()},300*1e3)}navigate(){!this.started||this.destroyed||(this.stopNavigationTimer(),this.navTimer=setTimeout(()=>{this.navTimer=null;let e=location.pathname!==this.pagePath,t=(this.options.trackHash??!1)&&location.hash!==this.pageHash;!e&&!t||(this.leavePage(),this.enterPage(),this.trackScroll(),this.pageview({trigger:`navigation`}))},300))}links(){let e=e=>{let t=O(e.target);t&&t.host!==location.host&&this.track(`outbound_link`,{outbound_link:t.href})};this.addDocumentListener(`click`,e),this.addDocumentListener(`auxclick`,e)}};export{x as a,T as c,y as d,p as f,E as i,D as l,v as n,C as o,b as r,w as s,A as t,S as u};

package/dist/{error-BLRIDscG.js → error-Df3cDcoP.js}

@@ -1,2 +1,2 @@
-import{m as e,n as t,r as n}from"./types-Df70G0eM.js";import{l as r}from"./analytics-B988lkxn.js";const i=/(?:^|\()(chrome|moz|ms-browser|safari-web)-extension:\/\//,a=e=>e?.split(`
+import{m as e,n as t,r as n}from"./types-Df70G0eM.js";import{l as r}from"./analytics-D_dgxSVU.js";const i=/(?:^|\()(chrome|moz|ms-browser|safari-web)-extension:\/\//,a=e=>e?.split(`
 `).map(e=>e.trim()).filter(Boolean);function o(e){if(e instanceof Error)return{error:e.name?.trim()||`Error`,message:e.message,stack:a(e.stack),cause:o(e.cause)};if(typeof e==`string`)return{error:`Error`,message:e}}function s(e){return e?`${e.error}\0${e.message??``}\0${s(e.cause)}`:``}function c(e){let t=[e.kind,e.handled?`handled`:`unhandled`,e.message,e.filename??``,e.lineno??``,s(e.cause)].join(`\0`),n=2166136261,r=3598710387;for(let e=0;e<t.length;e++){let i=t.charCodeAt(e);n=Math.imul(n^i,16777619),r=Math.imul(r^i,2246822519)}return`err_${(n>>>0).toString(16).padStart(8,`0`)}${(r>>>0).toString(16).padStart(8,`0`)}`}var l=class{endpoint;handled=new WeakSet;queue=new Map;timer=null;started=!1;constructor(t){this.options=t,this.endpoint=e(t.baseUrl)}get debug(){return this.options.debug??!1}get flushInterval(){return this.options.flushInterval??5e3}get maxQueueSize(){return this.options.maxQueueSize??50}log(...e){this.debug&&console.log(`[ErrorTracker]`,...e)}start(){this.started||typeof window>`u`||(this.started=!0,window.addEventListener(`error`,this.onError),window.addEventListener(`unhandledrejection`,this.onRejection),document.addEventListener(`visibilitychange`,this.onVisibilityChange),window.addEventListener(`pagehide`,this.flush),this.timer=setInterval(this.flush,this.flushInterval),this.log(`Started listening for errors`))}stop(){!this.started||typeof window>`u`||(this.started=!1,window.removeEventListener(`error`,this.onError),window.removeEventListener(`unhandledrejection`,this.onRejection),document.removeEventListener(`visibilitychange`,this.onVisibilityChange),window.removeEventListener(`pagehide`,this.flush),this.timer&&clearInterval(this.timer),this.timer=null,this.flush(),this.log(`Stopped listening for errors`))}captureError(e){this.record({kind:`error`,message:e.message,stack:e.stack,handled:!0,cause:o(e.cause)},e)}onError=e=>{let t=e.error;this.record({kind:`error`,message:e.message||`Unknown error`,filename:e.filename||void 0,lineno:e.lineno||void 0,stack:t instanceof Error?t.stack:void 0,handled:!1,cause:t instanceof Error?o(t.cause):void 0},t)};onRejection=e=>{let t=e.reason;this.record({kind:`unhandledrejection`,message:t.message||`Unhandled promise rejection`,stack:t.stack||void 0,handled:!1,cause:o(t.cause)},t)};onVisibilityChange=()=>{document.visibilityState===`hidden`&&this.flush()};record(e,t){if(t instanceof Error){if(this.handled.has(t)){this.log(`Skipping duplicate:`,t.message);return}this.handled.add(t)}if(i.test(`${e.filename??``}\n${e.stack??``}`))return;let n=c(e),r=this.queue.get(n);r?r.count+=1:this.queue.set(n,{hash:n,count:1,error:e.kind===`unhandledrejection`?`UnhandledRejection`:`Error`,message:e.message,stack:a(e.stack),handled:e.handled,...e.cause?{cause:e.cause}:{}}),this.log(`Captured error:`,e),this.queue.size>=this.maxQueueSize&&this.flush()}flush=()=>{if(this.queue.size===0)return;let e=[...this.queue.values()];this.queue.clear();let i=t(),a=globalThis.__SOURCEMAPS_BUILD__,o=typeof a?.buildId==`string`&&a.buildId.trim()?a.buildId:void 0,s=JSON.stringify({token:this.options.siteKey,...i?{userId:i}:{},sessionId:n(),...o?{buildId:o}:{},data:{url:location.href,page:location.pathname,referrer:document.referrer||null,title:document.title},errors:e});this.log(`Flushing errors:`,e),this.log(`Payload:`,s),r({url:this.endpoint,data:s,debug:this.debug,debugPrefix:`[ErrorTracker]`})}};export{l as default};

package/dist/module.d.ts

@@ -374,6 +374,7 @@ interface ReplayTrackerOptions {
   siteKey: string;
   baseUrl?: string;
   debug?: boolean;
+  compress?: boolean;
   samplingPercentage?: number;
   flushInterval?: number;
   maxEvents?: number;
@@ -413,6 +414,7 @@ interface WebVitalsConfig {
   sampling?: SamplingOptions;
 }
 interface SessionReplayConfig {
+  enabled?: boolean;
   sampling?: SamplingOptions;
 }
 type ConsentMode = "pending" | "granted" | "denied";
@@ -491,6 +493,10 @@ declare class WebAnalytics {
   private stopHeartbeat;
   private stopNavigationTimer;
   private stopChildTrackers;
+  private registerChildTracker;
+  private startErrorTracker;
+  private startWebVitalsTracker;
+  private startReplayTracker;
   start(): Promise<void>;
   destroy(): void;
   pageview(extra?: Dict): void;

package/dist/module.js

@@ -1 +1 @@
-import{f as e,l as t}from"./types-Df70G0eM.js";import{a as n,c as r,d as i,f as a,i as o,l as s,n as c,o as l,r as u,s as d,t as f,u as p}from"./analytics-B988lkxn.js";export{f as WebAnalytics,t as featureFlagsCheckUrl,a as fetchFeatureFlagEvaluation,c as getInstance,u as identify,o as isTrackingDisabled,n as logout,e as normalizeFeatureFlagsBaseUrl,l as optIn,d as optOut,r as reportError,s as sendData,p as setConsentMode,i as trackEvent};
+import{f as e,l as t}from"./types-Df70G0eM.js";import{a as n,c as r,d as i,f as a,i as o,l as s,n as c,o as l,r as u,s as d,t as f,u as p}from"./analytics-D_dgxSVU.js";export{f as WebAnalytics,t as featureFlagsCheckUrl,a as fetchFeatureFlagEvaluation,c as getInstance,u as identify,o as isTrackingDisabled,n as logout,e as normalizeFeatureFlagsBaseUrl,l as optIn,d as optOut,r as reportError,s as sendData,p as setConsentMode,i as trackEvent};

package/dist/replay-alCILAnP.js

@@ -0,0 +1 @@
+import{i as e,n as t,p as n,r,t as i}from"./types-Df70G0eM.js";import{l as a}from"./analytics-D_dgxSVU.js";import{getRecordConsolePlugin as o}from"@rrweb/rrweb-plugin-console-record";import{getRecordSequentialIdPlugin as s}from"@rrweb/rrweb-plugin-sequential-id-record";import{EventType as c,record as l}from"rrweb";const u={mousemove:50,mouseInteraction:!0,scroll:150,media:800,input:`last`},d={script:!0,comment:!0,headFavicon:!0,headWhitespace:!0,headMetaDescKeywords:!0,headMetaSocial:!0,headMetaRobots:!0,headMetaHttpEquiv:!0,headMetaAuthorship:!0};var f=class{endpoint;compressionSupported=typeof window<`u`&&`CompressionStream`in window;sampled;events=[];pending=[];started=!1;startTime=0;sequence=0;intervalId=null;flushTask=null;retryTask=null;minLengthFlushTask=null;stopRecording;sending=!1;constructor(e){this.options=e,this.endpoint=n(e.baseUrl),this.sampled=Math.random()*100<i(e.samplingPercentage)}get debug(){return this.options.debug??!1}get flushInterval(){return this.options.flushInterval??1e4}get maxEvents(){return this.options.maxEvents??500}get maxPendingBatches(){return this.options.maxPendingBatches??30}get minReplayLengthMs(){return this.options.minReplayLengthMs??3e3}get shouldCompress(){return this.options.compress??!1}log(...e){this.debug&&console.log(`[Replay]`,...e)}start(){this.started||typeof window>`u`||!this.sampled||(this.started=!0,r(),this.startTime=e(),this.stopRecording=l({emit:this.onEvent,sampling:this.options.sampling??u,slimDOMOptions:this.options.slimDOMOptions??d,maskAllInputs:this.options.maskAllInputs??!0,maskInputOptions:this.options.maskInputOptions??{password:!0,email:!0,tel:!0},blockClass:this.options.blockClass,blockSelector:this.options.blockSelector,maskTextClass:this.options.maskTextClass,maskTextSelector:this.options.maskTextSelector,checkoutEveryNms:this.options.checkoutEveryNms??6e4,checkoutEveryNth:this.options.checkoutEveryNth,plugins:[s({key:`_faststatsSeqId`}),...this.options.recordConsole??!0?[o()]:[]]}),this.intervalId=setInterval(this.requestFlush,this.flushInterval),window.addEventListener(`beforeunload`,this.onUnload),window.addEventListener(`pagehide`,this.onUnload),document.addEventListener(`visibilitychange`,this.onVisibilityChange),this.log(`Recording started`))}stop(){if(this.started){if(this.started=!1,this.stopRecording?.(),this.stopRecording=void 0,this.intervalId&&clearInterval(this.intervalId),this.flushTask&&clearTimeout(this.flushTask),this.retryTask&&clearTimeout(this.retryTask),this.minLengthFlushTask&&clearTimeout(this.minLengthFlushTask),this.intervalId=null,this.flushTask=null,this.retryTask=null,this.minLengthFlushTask=null,window.removeEventListener(`beforeunload`,this.onUnload),window.removeEventListener(`pagehide`,this.onUnload),document.removeEventListener(`visibilitychange`,this.onVisibilityChange),!this.hasReachedMinLength()){this.events.length=0,this.log(`Session too short (${Date.now()-this.startTime}ms), discarding events`);return}this.flush(!0),this.log(`Recording stopped`)}}getSessionId(){return r()}onEvent=(e,t)=>{if(this.events.push(e),t||this.events.length>=this.maxEvents||e.type===c.FullSnapshot&&this.hasReachedMinLength()){this.requestFlush();return}this.scheduleMinLengthFlush()};onUnload=()=>{this.flush(!0)};onVisibilityChange=()=>{document.visibilityState===`hidden`&&this.flush(!0)};hasReachedMinLength(){return this.minReplayLengthMs<=0||Date.now()-this.startTime>=this.minReplayLengthMs}requestFlush=()=>{this.flushTask||this.sending||this.events.length===0||(this.minLengthFlushTask&&=(clearTimeout(this.minLengthFlushTask),null),this.flushTask=setTimeout(()=>{this.flushTask=null,this.flush(!1)},0))};scheduleMinLengthFlush(){if(this.minLengthFlushTask||this.events.length===0||this.hasReachedMinLength())return;let e=Math.max(0,this.minReplayLengthMs-(Date.now()-this.startTime)),t=Math.min(e,2147483647);this.minLengthFlushTask=setTimeout(()=>{this.minLengthFlushTask=null,this.requestFlush()},t)}createBatch(e){let n=t();return{token:this.options.siteKey,sessionId:r(),...n?{identifier:n}:{},sequence:this.sequence++,timestamp:Date.now(),url:window.location.href,events:e}}async encodeBatch(e,t){let n=JSON.stringify(e);if(!this.shouldCompress||!this.compressionSupported||t)return{data:n,isCompressed:!1};try{return{data:await this.compress(n),isCompressed:!0}}catch{return this.log(`Compression failed, using uncompressed`),{data:new Blob([n],{type:`application/json`}),isCompressed:!1}}}async flush(e){if(!this.sending){if(this.events.length>0)if(!this.hasReachedMinLength())this.scheduleMinLengthFlush();else{let e=this.createBatch(this.events.splice(0));this.pending.push(e)}if(this.pending.length!==0){this.sending=!0;try{for(;this.pending.length>0;){let t=this.pending[0];if(!t)break;let n=await this.encodeBatch(t,e);if(!await this.send(n.data,n.isCompressed,e)){this.pending.length>=this.maxPendingBatches&&(this.log(`Pending buffer full, dropping batch ${t.sequence}`),this.pending.shift()),this.log(`Failed to send replay batch ${t.sequence}, retrying`),this.scheduleRetry();break}this.pending.shift(),e=!1}}finally{this.sending=!1}}}}scheduleRetry(){this.retryTask||=setTimeout(()=>{this.retryTask=null,this.flush(!1)},1e3)}async compress(e){let t=new TextEncoder().encode(e),n=new CompressionStream(`gzip`),r=n.writable.getWriter();await r.write(t),await r.close();let i=[],a=n.readable.getReader();for(;;){let{done:e,value:t}=await a.read();if(e)break;t&&i.push(t)}let o=i.reduce((e,t)=>e+t.length,0),s=new Uint8Array(o),c=0;for(let e of i)s.set(e,c),c+=e.length;return new Blob([s],{type:`application/octet-stream`})}send(e,t,n){return a({url:t?`${this.endpoint}?encoding=gzip`:this.endpoint,data:e,contentType:t?`application/octet-stream`:`application/json`,debug:!1,useBeacon:!1,keepalive:n})??Promise.resolve(!1)}};export{f as default};

package/package.json

@@ -19,7 +19,7 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"version": "0.2.4",
+	"version": "0.2.6",
 	"scripts": {
 		"build": "tsdown",
 		"dev": "bun run build",

package/src/analytics.ts

@@ -44,6 +44,7 @@ interface WebVitalsConfig {
 }
 
 interface SessionReplayConfig {
+	enabled?: boolean;
 	sampling?: SamplingOptions;
 }
 
@@ -78,6 +79,39 @@ export interface WebAnalyticsOptions {
 	replayOptions?: Partial<ReplayTrackerOptions>;
 }
 
+function hasReplaySamplingConfig(options: WebAnalyticsOptions): boolean {
+	return (
+		options.replayOptions?.samplingPercentage !== undefined ||
+		options.sessionReplays?.sampling?.percentage !== undefined
+	);
+}
+
+export function resolveReplayTrackerOptions(
+	options: WebAnalyticsOptions,
+	baseUrl: string,
+	debug: boolean,
+): ReplayTrackerOptions | null {
+	const replayEnabled =
+		options.sessionReplays?.enabled ??
+		options.trackReplay ??
+		hasReplaySamplingConfig(options);
+
+	if (!replayEnabled) return null;
+
+	const replayOptions = options.replayOptions ?? {};
+
+	return {
+		siteKey: options.siteKey,
+		baseUrl,
+		debug,
+		...replayOptions,
+		samplingPercentage: normalizeSamplingPercentage(
+			replayOptions.samplingPercentage ??
+				options.sessionReplays?.sampling?.percentage,
+		),
+	};
+}
+
 let _instance: WebAnalytics | null = null;
 let pendingConsentMode: ConsentMode | undefined;
 
@@ -373,6 +407,81 @@ export class WebAnalytics {
 		this.errorTracker = null;
 	}
 
+	private registerChildTracker(tracker: ChildTracker): boolean {
+		if (!this.started || this.destroyed || _instance !== this) {
+			tracker.stop?.();
+			return false;
+		}
+
+		this.childTrackers.push(tracker);
+		return true;
+	}
+
+	private async startErrorTracker(): Promise<void> {
+		try {
+			const { default: ErrorTrackerClass } = await import("./error");
+			if (!this.started || this.destroyed || _instance !== this) return;
+
+			const errorTracker: ErrorTracker = new ErrorTrackerClass({
+				siteKey: this.options.siteKey,
+				baseUrl: this.baseUrl,
+				debug: this.debug,
+			});
+			errorTracker.start();
+			if (!this.registerChildTracker(errorTracker)) return;
+
+			this.errorTracker = errorTracker;
+			while (this.pendingReportedErrors.length > 0) {
+				const pending = this.pendingReportedErrors.shift();
+				if (pending) errorTracker.captureError(pending);
+			}
+			this.log("error loaded");
+		} catch (error) {
+			this.log(`failed to initialize error tracker: ${String(error)}`);
+		}
+	}
+
+	private async startWebVitalsTracker(): Promise<void> {
+		try {
+			const { default: WebVitalsTrackerClass } = await import("./web-vitals");
+			if (!this.started || this.destroyed || _instance !== this) return;
+
+			const webVitalsTracker: WebVitalsTracker = new WebVitalsTrackerClass({
+				siteKey: this.options.siteKey,
+				baseUrl: this.baseUrl,
+				debug: this.debug,
+				samplingPercentage: normalizeSamplingPercentage(
+					this.options.webVitals?.sampling?.percentage,
+				),
+			});
+			webVitalsTracker.start();
+			if (!this.registerChildTracker(webVitalsTracker)) return;
+
+			this.log("web-vitals loaded");
+		} catch (error) {
+			this.log(`failed to initialize web-vitals tracker: ${String(error)}`);
+		}
+	}
+
+	private async startReplayTracker(
+		replayOptions: ReplayTrackerOptions,
+	): Promise<void> {
+		try {
+			const { default: ReplayTrackerClass } = await import("./replay");
+			if (!this.started || this.destroyed || _instance !== this) return;
+
+			const replayTracker: ReplayTracker = new ReplayTrackerClass(
+				replayOptions,
+			);
+			replayTracker.start();
+			if (!this.registerChildTracker(replayTracker)) return;
+
+			this.log("replay loaded");
+		} catch (error) {
+			this.log(`failed to initialize replay tracker: ${String(error)}`);
+		}
+	}
+
 	async start(): Promise<void> {
 		if (this.started || this.destroyed || typeof window === "undefined") return;
 		if (_instance && _instance !== this) {
@@ -387,61 +496,22 @@ export class WebAnalytics {
 		this.started = true;
 		_instance = this;
 		setCookielessMode(this.isCookielessMode());
+		getOrCreateSessionId();
 
 		const opts = this.options;
+		const replayOptions = resolveReplayTrackerOptions(
+			opts,
+			this.baseUrl,
+			this.debug,
+		);
+		if (replayOptions) {
+			void this.startReplayTracker(replayOptions);
+		}
 		if (opts.trackErrors) {
-			try {
-				const { default: ErrorTrackerClass } = await import("./error");
-				const errorTracker: ErrorTracker = new ErrorTrackerClass({
-					siteKey: opts.siteKey,
-					baseUrl: this.baseUrl,
-					debug: this.debug,
-				});
-				errorTracker.start();
-				this.errorTracker = errorTracker;
-				this.childTrackers.push(errorTracker);
-				while (this.pendingReportedErrors.length > 0) {
-					const pending = this.pendingReportedErrors.shift();
-					if (pending) errorTracker.captureError(pending);
-				}
-				this.log("error loaded");
-			} catch (error) {
-				this.log(`failed to initialize error tracker: ${String(error)}`);
-			}
+			void this.startErrorTracker();
 		}
 		if (opts.trackWebVitals) {
-			try {
-				const { default: WebVitalsTrackerClass } = await import("./web-vitals");
-				const webVitalsTracker: WebVitalsTracker = new WebVitalsTrackerClass({
-					siteKey: opts.siteKey,
-					baseUrl: this.baseUrl,
-					debug: this.debug,
-					samplingPercentage: normalizeSamplingPercentage(
-						opts.webVitals?.sampling?.percentage,
-					),
-				});
-				webVitalsTracker.start();
-				this.childTrackers.push(webVitalsTracker);
-				this.log("web-vitals loaded");
-			} catch (error) {
-				this.log(`failed to initialize web-vitals tracker: ${String(error)}`);
-			}
-		}
-		if (opts.trackReplay) {
-			try {
-				const { default: ReplayTrackerClass } = await import("./replay");
-				const replayTracker: ReplayTracker = new ReplayTrackerClass({
-					siteKey: opts.siteKey,
-					baseUrl: this.baseUrl,
-					debug: this.debug,
-					...opts.replayOptions,
-				});
-				replayTracker.start();
-				this.childTrackers.push(replayTracker);
-				this.log("replay loaded");
-			} catch (error) {
-				this.log(`failed to initialize replay tracker: ${String(error)}`);
-			}
+			void this.startWebVitalsTracker();
 		}
 
 		this.enterPage();

package/src/replay.ts

@@ -6,15 +6,21 @@ import type { recordOptions } from "rrweb/typings/types";
 import type { SlimDOMOptions } from "rrweb-snapshot";
 import { sendData } from "./analytics";
 import { replayEventsUrl } from "./utils/api-urls";
-import { getAnonymousId, getOrCreateSessionId } from "./utils/identifiers";
+import {
+	getAnonymousId,
+	getOrCreateSessionId,
+	getSessionStart,
+} from "./utils/identifiers";
 import { normalizeSamplingPercentage } from "./utils/types";
 
 const RRWEB_SEQUENTIAL_ID_KEY = "_faststatsSeqId";
+const MAX_TIMEOUT_MS = 2_147_483_647;
 
 export interface ReplayTrackerOptions {
 	siteKey: string;
 	baseUrl?: string;
 	debug?: boolean;
+	compress?: boolean;
 	samplingPercentage?: number;
 	flushInterval?: number;
 	maxEvents?: number;
@@ -78,6 +84,7 @@ export default class ReplayTracker {
 	private intervalId: ReturnType<typeof setInterval> | null = null;
 	private flushTask: ReturnType<typeof setTimeout> | null = null;
 	private retryTask: ReturnType<typeof setTimeout> | null = null;
+	private minLengthFlushTask: ReturnType<typeof setTimeout> | null = null;
 	private stopRecording?: listenerHandler;
 	private sending = false;
 
@@ -108,6 +115,10 @@ export default class ReplayTracker {
 		return this.options.minReplayLengthMs ?? 3000;
 	}
 
+	private get shouldCompress(): boolean {
+		return this.options.compress ?? false;
+	}
+
 	private log(...args: unknown[]): void {
 		if (this.debug) console.log("[Replay]", ...args);
 	}
@@ -116,7 +127,8 @@ export default class ReplayTracker {
 		if (this.started || typeof window === "undefined" || !this.sampled) return;
 
 		this.started = true;
-		this.startTime = Date.now();
+		getOrCreateSessionId();
+		this.startTime = getSessionStart();
 
 		this.stopRecording = record({
 			emit: this.onEvent,
@@ -161,10 +173,12 @@ export default class ReplayTracker {
 		if (this.intervalId) clearInterval(this.intervalId);
 		if (this.flushTask) clearTimeout(this.flushTask);
 		if (this.retryTask) clearTimeout(this.retryTask);
+		if (this.minLengthFlushTask) clearTimeout(this.minLengthFlushTask);
 
 		this.intervalId = null;
 		this.flushTask = null;
 		this.retryTask = null;
+		this.minLengthFlushTask = null;
 
 		window.removeEventListener("beforeunload", this.onUnload);
 		window.removeEventListener("pagehide", this.onUnload);
@@ -195,7 +209,10 @@ export default class ReplayTracker {
 			(event.type === EventType.FullSnapshot && this.hasReachedMinLength())
 		) {
 			this.requestFlush();
+			return;
 		}
+
+		this.scheduleMinLengthFlush();
 	};
 
 	private onUnload = (): void => {
@@ -218,12 +235,38 @@ export default class ReplayTracker {
 	private requestFlush = (): void => {
 		if (this.flushTask || this.sending || this.events.length === 0) return;
 
+		if (this.minLengthFlushTask) {
+			clearTimeout(this.minLengthFlushTask);
+			this.minLengthFlushTask = null;
+		}
+
 		this.flushTask = setTimeout(() => {
 			this.flushTask = null;
 			void this.flush(false);
 		}, 0);
 	};
 
+	private scheduleMinLengthFlush(): void {
+		if (
+			this.minLengthFlushTask ||
+			this.events.length === 0 ||
+			this.hasReachedMinLength()
+		) {
+			return;
+		}
+
+		const remainingMs = Math.max(
+			0,
+			this.minReplayLengthMs - (Date.now() - this.startTime),
+		);
+		const timeoutMs = Math.min(remainingMs, MAX_TIMEOUT_MS);
+
+		this.minLengthFlushTask = setTimeout(() => {
+			this.minLengthFlushTask = null;
+			this.requestFlush();
+		}, timeoutMs);
+	}
+
 	private createBatch(events: eventWithTime[]): ReplayBatch {
 		const identifier = getAnonymousId();
 
@@ -241,12 +284,12 @@ export default class ReplayTracker {
 	private async encodeBatch(
 		batch: ReplayBatch,
 		lowLatency: boolean,
-	): Promise<{ data: Blob; isCompressed: boolean }> {
+	): Promise<{ data: string | Blob; isCompressed: boolean }> {
 		const json = JSON.stringify(batch);
 
-		if (!this.compressionSupported || lowLatency) {
+		if (!this.shouldCompress || !this.compressionSupported || lowLatency) {
 			return {
-				data: new Blob([json], { type: "application/json" }),
+				data: json,
 				isCompressed: false,
 			};
 		}
@@ -270,11 +313,10 @@ export default class ReplayTracker {
 
 		if (this.events.length > 0) {
 			if (!this.hasReachedMinLength()) {
-				this.log(
-					`Too short (${Date.now() - this.startTime}ms), skipping flush`,
-				);
+				this.scheduleMinLengthFlush();
 			} else {
-				this.pending.push(this.createBatch(this.events.splice(0)));
+				const batch = this.createBatch(this.events.splice(0));
+				this.pending.push(batch);
 			}
 		}
 
@@ -298,11 +340,10 @@ export default class ReplayTracker {
 						this.log(`Pending buffer full, dropping batch ${batch.sequence}`);
 						this.pending.shift();
 					}
+					this.log(`Failed to send replay batch ${batch.sequence}, retrying`);
 					this.scheduleRetry();
 					break;
 				}
-
-				this.log(`Sent ${batch.events.length} events (seq: ${batch.sequence})`);
 				this.pending.shift();
 				lowLatency = false;
 			}
@@ -313,7 +354,6 @@ export default class ReplayTracker {
 
 	private scheduleRetry(): void {
 		if (this.retryTask) return;
-
 		this.retryTask = setTimeout(() => {
 			this.retryTask = null;
 			void this.flush(false);
@@ -346,17 +386,11 @@ export default class ReplayTracker {
 			offset += chunk.length;
 		}
 
-		this.log(
-			`Compressed: ${input.length} → ${output.length} bytes (${(
-				(output.length / input.length) * 100
-			).toFixed(1)}%)`,
-		);
-
 		return new Blob([output], { type: "application/octet-stream" });
 	}
 
 	private send(
-		data: Blob,
+		data: string | Blob,
 		isCompressed: boolean,
 		lowLatency: boolean,
 	): Promise<boolean> {
@@ -367,9 +401,8 @@ export default class ReplayTracker {
 				contentType: isCompressed
 					? "application/octet-stream"
 					: "application/json",
-				debug: this.debug,
-				debugPrefix: `[Replay] ${(data.size / 1024).toFixed(1)}KB`,
-				useBeacon: lowLatency,
+				debug: false,
+				useBeacon: false,
 				keepalive: lowLatency,
 			}) ?? Promise.resolve(false)
 		);

package/tests/analytics.test.ts

@@ -1,6 +1,7 @@
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import {
 	getInstance,
+	resolveReplayTrackerOptions,
 	sendData,
 	setConsentMode,
 	WebAnalytics,
@@ -358,4 +359,25 @@ describe("WebAnalytics lifecycle", () => {
 			),
 		).toBe(true);
 	});
+
+	test("resolveReplayTrackerOptions honors sessionReplays config", () => {
+		const options = resolveReplayTrackerOptions(
+			{
+				siteKey: "site_test",
+				sessionReplays: {
+					enabled: true,
+					sampling: { percentage: 37 },
+				},
+			},
+			"https://metrics.example.com",
+			true,
+		);
+
+		expect(options).toMatchObject({
+			siteKey: "site_test",
+			baseUrl: "https://metrics.example.com",
+			debug: true,
+			samplingPercentage: 37,
+		});
+	});
 });

package/tests/replay.test.ts

@@ -17,6 +17,37 @@ class MockStorage {
 	}
 }
 
+type ReplayEvent = {
+	type: number;
+	timestamp: number;
+	data?: Record<string, unknown>;
+};
+
+type ReplayBatch = {
+	token: string;
+	sessionId?: string;
+	identifier?: string;
+	sequence: number;
+	timestamp: number;
+	url: string;
+	events: ReplayEvent[];
+};
+
+type ReplayTrackerInternals = {
+	events: ReplayEvent[];
+	pending: ReplayBatch[];
+	minLengthFlushTask: ReturnType<typeof setTimeout> | null;
+	retryTask: ReturnType<typeof setTimeout> | null;
+	startTime: number;
+	onEvent: (event: ReplayEvent, isCheckout?: boolean) => void;
+	flush: (lowLatency: boolean) => Promise<void>;
+	send: (
+		data: string | Blob,
+		isCompressed: boolean,
+		lowLatency: boolean,
+	) => Promise<boolean>;
+};
+
 function setGlobal(name: keyof typeof globalThis, value: unknown): void {
 	Object.defineProperty(globalThis, name, {
 		configurable: true,
@@ -66,86 +97,54 @@ afterEach(() => {
 	setGlobal("sessionStorage", original.sessionStorage);
 });
 
+function createTracker(
+	options: Partial<ConstructorParameters<typeof ReplayTracker>[0]> = {},
+): ReplayTrackerInternals {
+	return new ReplayTracker({
+		siteKey: "site_test",
+		...options,
+	}) as unknown as ReplayTrackerInternals;
+}
+
 describe("ReplayTracker", () => {
-	test("collects replay events", () => {
-		const tracker = new ReplayTracker({
-			siteKey: "site_test",
+	test("buffers replay events", () => {
+		const tracker = createTracker({
 			maxEvents: 1000,
 			minReplayLengthMs: Number.MAX_SAFE_INTEGER,
-		}) as unknown as {
-			handleEvent: (event: unknown, isCheckout?: boolean) => void;
-			events: unknown[];
-		};
+		});
 
-		for (let i = 0; i < 12; i++) {
-			tracker.handleEvent({ id: i, timestamp: i }, false);
-		}
+		tracker.onEvent({ type: 2, timestamp: 1, data: {} }, false);
+		tracker.onEvent({ type: 3, timestamp: 2, data: {} }, false);
 
-		expect(tracker.events.length).toBe(12);
+		expect(tracker.events.length).toBe(2);
 	});
 
-	test("keeps pending batches for retry", () => {
-		const tracker = new ReplayTracker({
-			siteKey: "site_test",
-		}) as unknown as {
-			pendingBatches: unknown[];
-		};
-
-		tracker.pendingBatches.push({
-			batch: {
-				token: "site_test",
-				sessionId: "s1",
-				sequence: 1,
-				timestamp: 1,
-				url: "https://example.com/",
-				events: [],
-			},
-			isCompressed: false,
-			retries: 0,
+	test("does not flush before minimum replay length", async () => {
+		const tracker = createTracker({
+			minReplayLengthMs: Number.MAX_SAFE_INTEGER,
 		});
-		expect(tracker.pendingBatches.length).toBe(1);
-	});
 
-	test("deduplicates scheduled flush work", () => {
-		let idleCallbackRuns = 0;
-		setGlobal("window", {
-			location: { href: "https://example.com/" },
-			addEventListener: () => {},
-			removeEventListener: () => {},
-			requestIdleCallback: () => {
-				idleCallbackRuns++;
-				return 1;
-			},
-			cancelIdleCallback: () => {},
-		} as unknown as Window);
-
-		const tracker = new ReplayTracker({
-			siteKey: "site_test",
-		}) as unknown as {
-			events: unknown[];
-			scheduleFlush: () => void;
+		let sent = 0;
+		tracker.send = async () => {
+			sent++;
+			return true;
 		};
+		tracker.startTime = Date.now();
+		tracker.onEvent({ type: 2, timestamp: Date.now(), data: {} }, false);
 
-		tracker.events = [{ type: 2 }, { type: 3 }];
-		tracker.scheduleFlush();
-		tracker.scheduleFlush();
-		expect(idleCallbackRuns).toBe(1);
+		await tracker.flush(false);
+
+		expect(sent).toBe(0);
+		expect(tracker.events.length).toBe(1);
+		expect(tracker.pending.length).toBe(0);
+
+		if (tracker.minLengthFlushTask) clearTimeout(tracker.minLengthFlushTask);
 	});
 
-	test("flushes buffered snapshot when minimum replay length is reached", async () => {
-		const tracker = new ReplayTracker({
-			siteKey: "site_test",
-			minReplayLengthMs: 1,
-		}) as unknown as {
-			events: unknown[];
-			send: (
-				data: Blob,
-				isCompressed: boolean,
-				options?: { useBeacon?: boolean },
-			) => Promise<boolean>;
-			scheduleMinLengthFlush: () => void;
-			startTime: number;
-		};
+	test("flushes buffered events once minimum replay length is reached", async () => {
+		const tracker = createTracker({
+			minReplayLengthMs: 20,
+		});
 
 		let sent = 0;
 		tracker.send = async () => {
@@ -153,95 +152,74 @@ describe("ReplayTracker", () => {
 			return true;
 		};
 		tracker.startTime = Date.now();
-		tracker.events = [{ type: 2, timestamp: Date.now(), data: {} }];
+		tracker.onEvent({ type: 2, timestamp: Date.now(), data: {} }, false);
 
-		tracker.scheduleMinLengthFlush();
-		await new Promise((resolve) => setTimeout(resolve, 20));
+		await new Promise((resolve) => setTimeout(resolve, 40));
 
 		expect(sent).toBe(1);
 		expect(tracker.events.length).toBe(0);
+		expect(tracker.pending.length).toBe(0);
 	});
 
-	test("caps pending batch buffer size", () => {
-		const tracker = new ReplayTracker({
-			siteKey: "site_test",
-			maxPendingBatches: 3,
-		}) as unknown as {
-			pendingBatches: unknown[];
-			queuePendingBatch: (batch: unknown) => void;
+	test("emits replay payload when flushed", async () => {
+		const tracker = createTracker({
+			minReplayLengthMs: 0,
+		});
+
+		let payload: ReplayBatch | null = null;
+		let lowLatency = false;
+		tracker.send = async (data, _isCompressed, nextLowLatency) => {
+			payload = JSON.parse(
+				typeof data === "string" ? data : await data.text(),
+			) as ReplayBatch;
+			lowLatency = nextLowLatency;
+			return true;
 		};
+		tracker.startTime = Date.now() - 1000;
+		tracker.onEvent({ type: 2, timestamp: Date.now(), data: {} }, false);
 
-		for (let i = 0; i < 5; i++) {
-			tracker.queuePendingBatch({
-				batch: {
-					token: "site_test",
-					sessionId: "s1",
-					sequence: i,
-					timestamp: i,
-					url: "https://example.com/",
-					events: [],
-				},
-				isCompressed: false,
-				retries: 0,
-			});
-		}
-
-		expect(tracker.pendingBatches.length).toBe(3);
+		await tracker.flush(true);
+
+		expect(payload).not.toBeNull();
+		expect(payload?.token).toBe("site_test");
+		expect(payload?.sessionId).toBeTruthy();
+		expect(payload?.events).toHaveLength(1);
+		expect(lowLatency).toBe(true);
+		expect(tracker.pending.length).toBe(0);
 	});
 
-	test("queues new flush behind pending batches to preserve order", async () => {
-		const tracker = new ReplayTracker({
-			siteKey: "site_test",
+	test("sends replay as plain JSON by default", async () => {
+		const tracker = createTracker({
 			minReplayLengthMs: 0,
-		}) as unknown as {
-			events: unknown[];
-			pendingBatches: Array<{
-				batch: {
-					token: string;
-					sessionId: string;
-					sequence: number;
-					timestamp: number;
-					url: string;
-					events: unknown[];
-				};
-				isCompressed: boolean;
-				retries: number;
-			}>;
-			sequenceNumber: number;
-			flush: (options?: { lowLatency?: boolean }) => Promise<void>;
-			send: (
-				data: Blob,
-				isCompressed: boolean,
-				options?: { useBeacon?: boolean },
-			) => Promise<boolean>;
-		};
-
-		tracker.sequenceNumber = 2;
-		tracker.pendingBatches.push({
-			batch: {
-				token: "site_test",
-				sessionId: "s1",
-				sequence: 1,
-				timestamp: 1,
-				url: "https://example.com/",
-				events: [{ id: "older" }],
-			},
-			isCompressed: false,
-			retries: 0,
 		});
-		tracker.events = [{ id: "newer" }];
 
-		const sentSequences: number[] = [];
+		let bodyType: "string" | "blob" | null = null;
 		tracker.send = async (data) => {
-			const payload = JSON.parse(await data.text()) as { sequence: number };
-			sentSequences.push(payload.sequence);
+			bodyType = typeof data === "string" ? "string" : "blob";
 			return true;
 		};
+		tracker.startTime = Date.now() - 1000;
+		tracker.onEvent({ type: 2, timestamp: Date.now(), data: {} }, false);
+
+		await tracker.flush(false);
+
+		expect(bodyType).toBe("string");
+	});
+
+	test("keeps failed batches queued for retry", async () => {
+		const tracker = createTracker({
+			minReplayLengthMs: 0,
+		});
+
+		tracker.send = async () => false;
+		tracker.startTime = Date.now() - 1000;
+		tracker.onEvent({ type: 2, timestamp: Date.now(), data: {} }, false);
+
+		await tracker.flush(false);
 
-		await tracker.flush();
-		await new Promise((resolve) => setTimeout(resolve, 0));
+		expect(tracker.pending.length).toBe(1);
+		expect(tracker.retryTask).not.toBeNull();
 
-		expect(sentSequences).toEqual([1, 2]);
-		expect(tracker.pendingBatches.length).toBe(0);
+		if (tracker.retryTask) clearTimeout(tracker.retryTask);
 	});
 });

package/dist/analytics-B988lkxn.js

@@ -1 +0,0 @@
-import{a as e,c as t,d as n,f as r,i,l as a,m as o,n as s,o as c,r as l,s as u,t as d,u as f}from"./types-Df70G0eM.js";async function p(e,t){if(t.projectToken&&t.projectId)throw Error(`provide either projectToken or projectId, not both`);if(t.identifier&&t.externalId)throw Error(`provide either serverId or externalId, not both`);let n=t.projectToken,r=t.projectId,i=t.identifier,o=t.externalId;if(!n&&!r)throw Error(`feature flag check requires projectToken or projectId`);if(!i&&!o)throw Error(`feature flag check requires serverId or externalId`);let s={key:e,...r?{projectId:r}:{},...i?{identifier:i}:{externalId:o}};t.attributes&&Object.keys(t.attributes).length>0&&(s.attributes=t.attributes);let c={"Content-Type":`application/json`};n&&(c.Authorization=`Bearer ${n}`);let l=a(t.baseUrl),u=await fetch(l,{method:`POST`,headers:c,body:JSON.stringify(s),credentials:`omit`,signal:t.signal});if(!u.ok){let e=``;try{let t=await u.json();typeof t.error==`string`&&t.error.length>0&&(e=` — ${t.error}`)}catch{}throw Error(`feature flag check failed: HTTP ${u.status}${e}`)}return await u.json()}let m=null,h;function g(){return m}function _(e,t){typeof window>`u`||w()||m?.track(e,t??{})}function v(e,t,n){typeof window>`u`||w()||m?.identify(e,t,n??{})}function y(e=!0){typeof window>`u`||w()||m?.logout(e)}function b(e){if(m){m.setConsentMode(e);return}h=e}function x(){b(`granted`)}function S(){b(`denied`)}function C(e){typeof window>`u`||w()||m?.reportError(e)}function w(){if(typeof localStorage>`u`)return!1;let e=localStorage.getItem(`disable-faststats`);return e===`true`||e===`1`}async function T(e){let{url:t,data:n,contentType:r=`application/json`,headers:i={},debug:a=!1,debugPrefix:o=`[Analytics]`,useBeacon:s=!0,keepalive:c=!0}=e;if(s&&typeof navigator<`u`&&typeof navigator.sendBeacon==`function`)try{let e=n instanceof Blob?n:typeof Blob<`u`?new Blob([n],{type:r}):n;if(navigator.sendBeacon(t,e))return a&&console.log(`${o} Sent via beacon`),!0}catch{}if(typeof fetch!=`function`)return a&&console.warn(`${o} Failed to send`),!1;try{let e=await fetch(t,{method:`POST`,body:n,headers:{"Content-Type":r,...i},keepalive:c}),s=e.ok;return a&&(s?console.log(`${o} Sent via fetch`):console.warn(`${o} Failed: ${e.status}`)),s}catch{return a&&console.warn(`${o} Failed to send`),!1}}function E(e){for(;e;){if(e instanceof HTMLAnchorElement&&e.href)return e;e=e.parentNode}return null}function D(){let e={};if(!location.search)return e;let t=new URLSearchParams(location.search);for(let n of[`utm_source`,`utm_medium`,`utm_campaign`,`utm_term`,`utm_content`]){let r=t.get(n);r&&(e[n]=r)}return e}var O=class{webEndpoint;baseUrl;featureFlagsBaseUrl;debug;started=!1;destroyed=!1;pageKey=``;navTimer=null;heartbeatTimer=null;scrollDepth=0;pageEntryTime=0;pagePath=``;pageUrl=``;pageHash=``;hasLeftCurrentPage=!1;scrollHandler=null;consentMode;cookielessWhilePending;cleanupCallbacks=[];childTrackers=[];pendingReportedErrors=[];errorTracker=null;handleVisibilityChange=()=>{document.visibilityState===`hidden`?(this.leavePage(),this.stopHeartbeat()):this.startHeartbeat()};handlePageHide=()=>{this.leavePage()};handlePopState=()=>{this.navigate()};handleHashChange=()=>{this.navigate()};constructor(e){this.options=e,this.baseUrl=n(e.baseUrl),this.featureFlagsBaseUrl=r(e.featureFlagsBaseUrl),this.webEndpoint=o(this.baseUrl),this.debug=e.debug??!1,this.consentMode=e.consent?.mode??`granted`,this.cookielessWhilePending=e.consent?.cookielessWhilePending??!0,h!==void 0&&(this.consentMode=h,h=void 0),(e.autoTrack??!0)&&this.init()}log(e){this.debug&&console.log(`[Analytics] ${e}`)}init(){if(!(typeof window>`u`)){if(w()){this.log(`disabled`);return}m=this,t(this.isCookielessMode()),setTimeout(()=>void this.start(),0)}}registerCleanup(e){this.cleanupCallbacks.push(e)}addWindowListener(e,t){window.addEventListener(e,t),this.registerCleanup(()=>window.removeEventListener(e,t))}addDocumentListener(e,t){document.addEventListener(e,t),this.registerCleanup(()=>document.removeEventListener(e,t))}patchHistory(){let e=history.pushState.bind(history),t=history.replaceState.bind(history);history.pushState=(t,n,r)=>{e(t,n,r),this.navigate()},history.replaceState=(e,n,r)=>{t(e,n,r),this.navigate()},this.registerCleanup(()=>{history.pushState=e,history.replaceState=t})}ensureStarted(){return typeof window>`u`||this.destroyed||w()?!1:(this.started||this.start(),!0)}stopHeartbeat(){this.heartbeatTimer&&=(clearInterval(this.heartbeatTimer),null)}stopNavigationTimer(){this.navTimer&&=(clearTimeout(this.navTimer),null)}stopChildTrackers(){for(let e of this.childTrackers.splice(0))e.stop?.();this.errorTracker=null}async start(){if(this.started||this.destroyed||typeof window>`u`)return;if(m&&m!==this){this.log(`already started by another instance`);return}if(w()){this.log(`disabled`);return}this.started=!0,m=this,t(this.isCookielessMode());let e=this.options;if(e.trackErrors)try{let{default:t}=await import(`./error-BLRIDscG.js`),n=new t({siteKey:e.siteKey,baseUrl:this.baseUrl,debug:this.debug});for(n.start(),this.errorTracker=n,this.childTrackers.push(n);this.pendingReportedErrors.length>0;){let e=this.pendingReportedErrors.shift();e&&n.captureError(e)}this.log(`error loaded`)}catch(e){this.log(`failed to initialize error tracker: ${String(e)}`)}if(e.trackWebVitals)try{let{default:t}=await import(`./web-vitals-gcUR-TX_.js`),n=new t({siteKey:e.siteKey,baseUrl:this.baseUrl,debug:this.debug,samplingPercentage:d(e.webVitals?.sampling?.percentage)});n.start(),this.childTrackers.push(n),this.log(`web-vitals loaded`)}catch(e){this.log(`failed to initialize web-vitals tracker: ${String(e)}`)}if(e.trackReplay)try{let{default:t}=await import(`./replay-44QeDpKH.js`),n=new t({siteKey:e.siteKey,baseUrl:this.baseUrl,debug:this.debug,...e.replayOptions});n.start(),this.childTrackers.push(n),this.log(`replay loaded`)}catch(e){this.log(`failed to initialize replay tracker: ${String(e)}`)}this.enterPage(),this.pageview({trigger:`load`}),this.links(),this.trackScroll(),this.startHeartbeat(),this.addDocumentListener(`visibilitychange`,this.handleVisibilityChange),this.addWindowListener(`pagehide`,this.handlePageHide),this.addWindowListener(`popstate`,this.handlePopState),e.trackHash&&this.addWindowListener(`hashchange`,this.handleHashChange),this.patchHistory()}destroy(){if(!this.destroyed){for(this.started&&typeof window<`u`&&this.leavePage(),this.pendingReportedErrors.length=0,this.stopNavigationTimer(),this.stopHeartbeat(),this.scrollHandler&&typeof window<`u`&&(window.removeEventListener(`scroll`,this.scrollHandler),this.scrollHandler=null);this.cleanupCallbacks.length>0;)this.cleanupCallbacks.pop()?.();this.stopChildTrackers(),m===this&&(m=null),this.started=!1,this.destroyed=!0}}pageview(e={}){if(!this.ensureStarted())return;let t=`${location.pathname}|${this.options.trackHash??!1?location.hash:``}`;t!==this.pageKey&&(this.pageKey=t,this.send(`pageview`,e))}track(e,t={}){this.ensureStarted()&&this.send(e,t)}identify(e,t,n={}){if(!this.ensureStarted()||this.isCookielessMode())return;let r=e.trim(),i=t.trim();!r||!i||T({url:f(this.baseUrl),data:JSON.stringify({token:this.options.siteKey,identifier:s(!1),externalId:r,email:i,name:n.name?.trim()||void 0,phone:n.phone?.trim()||void 0,avatarUrl:n.avatarUrl?.trim()||void 0,traits:n.traits??{}}),contentType:`text/plain`,debug:this.debug,debugPrefix:`[Analytics] identify`})}logout(e=!0){this.ensureStarted()&&(e&&c(this.isCookielessMode()),u())}setConsentMode(e){this.consentMode=e,t(this.isCookielessMode())}optIn(){this.setConsentMode(`granted`)}optOut(){this.setConsentMode(`denied`)}getConsentMode(){return this.consentMode}getAnonymousId(){return s(this.isCookielessMode())}getSessionId(){return l()}async checkFeatureFlag(e,t,n){if(typeof window>`u`||w())return{value:`false`};let r=n?.externalId?.trim();if(r)return p(e,{baseUrl:this.featureFlagsBaseUrl,projectToken:this.options.siteKey,externalId:r,attributes:t,signal:n?.signal});let i=this.getAnonymousId();return i?p(e,{baseUrl:this.featureFlagsBaseUrl,projectToken:this.options.siteKey,identifier:i,attributes:t,signal:n?.signal}):{value:`false`}}reportError(e){if(this.destroyed||typeof window>`u`||w()||!(this.options.trackErrors??!1)||!this.ensureStarted())return;let t=this.errorTracker;if(t){t.captureError(e);return}this.pendingReportedErrors.length>=50&&this.pendingReportedErrors.shift(),this.pendingReportedErrors.push(e)}isCookielessMode(){return this.options.cookieless||this.consentMode===`denied`?!0:this.consentMode===`pending`?this.cookielessWhilePending:!1}send(e,t={}){if(typeof window>`u`||this.destroyed||w())return;let n=s(this.isCookielessMode()),r=JSON.stringify({token:this.options.siteKey,...n?{userId:n}:{},sessionId:l(),data:{event:e,page:location.pathname,referrer:document.referrer||null,title:document.title||``,url:location.href,...D(),...t}});this.log(e),T({url:this.webEndpoint,data:r,contentType:`text/plain`,debug:this.debug,debugPrefix:`[Analytics] ${e}`})}enterPage(){this.pageEntryTime=Date.now(),this.pagePath=location.pathname,this.pageUrl=location.href,this.pageHash=location.hash,this.scrollDepth=0,this.hasLeftCurrentPage=!1}leavePage(){if(this.destroyed||this.hasLeftCurrentPage)return;this.hasLeftCurrentPage=!0;let e=Date.now();this.send(`page_leave`,{page:this.pagePath,url:this.pageUrl,time_on_page:e-this.pageEntryTime,scroll_depth:this.scrollDepth,session_duration:e-i()})}trackScroll(){this.scrollHandler&&window.removeEventListener(`scroll`,this.scrollHandler);let e=()=>{let e=document.documentElement,t=document.body,n=window.innerHeight,r=Math.max(e.scrollHeight,t.scrollHeight);if(r<=n){this.scrollDepth=100;return}let i=Math.min(100,Math.round(((window.scrollY||e.scrollTop)+n)/r*100));i>this.scrollDepth&&(this.scrollDepth=i)};this.scrollHandler=e,e(),window.addEventListener(`scroll`,e,{passive:!0})}startHeartbeat(){this.stopHeartbeat(),this.heartbeatTimer=setInterval(()=>{if(document.visibilityState===`hidden`){this.stopHeartbeat();return}e()},300*1e3)}navigate(){!this.started||this.destroyed||(this.stopNavigationTimer(),this.navTimer=setTimeout(()=>{this.navTimer=null;let e=location.pathname!==this.pagePath,t=(this.options.trackHash??!1)&&location.hash!==this.pageHash;!e&&!t||(this.leavePage(),this.enterPage(),this.trackScroll(),this.pageview({trigger:`navigation`}))},300))}links(){let e=e=>{let t=E(e.target);t&&t.host!==location.host&&this.track(`outbound_link`,{outbound_link:t.href})};this.addDocumentListener(`click`,e),this.addDocumentListener(`auxclick`,e)}};export{y as a,C as c,_ as d,p as f,w as i,T as l,g as n,x as o,v as r,S as s,O as t,b as u};

package/dist/replay-44QeDpKH.js

@@ -1 +0,0 @@
-import{n as e,p as t,r as n,t as r}from"./types-Df70G0eM.js";import{l as i}from"./analytics-B988lkxn.js";import{getRecordConsolePlugin as a}from"@rrweb/rrweb-plugin-console-record";import{getRecordSequentialIdPlugin as o}from"@rrweb/rrweb-plugin-sequential-id-record";import{EventType as s,record as c}from"rrweb";const l={mousemove:50,mouseInteraction:!0,scroll:150,media:800,input:`last`},u={script:!0,comment:!0,headFavicon:!0,headWhitespace:!0,headMetaDescKeywords:!0,headMetaSocial:!0,headMetaRobots:!0,headMetaHttpEquiv:!0,headMetaAuthorship:!0};var d=class{endpoint;compressionSupported=typeof window<`u`&&`CompressionStream`in window;sampled;events=[];pending=[];started=!1;startTime=0;sequence=0;intervalId=null;flushTask=null;retryTask=null;stopRecording;sending=!1;constructor(e){this.options=e,this.endpoint=t(e.baseUrl),this.sampled=Math.random()*100<r(e.samplingPercentage)}get debug(){return this.options.debug??!1}get flushInterval(){return this.options.flushInterval??1e4}get maxEvents(){return this.options.maxEvents??500}get maxPendingBatches(){return this.options.maxPendingBatches??30}get minReplayLengthMs(){return this.options.minReplayLengthMs??3e3}log(...e){this.debug&&console.log(`[Replay]`,...e)}start(){this.started||typeof window>`u`||!this.sampled||(this.started=!0,this.startTime=Date.now(),this.stopRecording=c({emit:this.onEvent,sampling:this.options.sampling??l,slimDOMOptions:this.options.slimDOMOptions??u,maskAllInputs:this.options.maskAllInputs??!0,maskInputOptions:this.options.maskInputOptions??{password:!0,email:!0,tel:!0},blockClass:this.options.blockClass,blockSelector:this.options.blockSelector,maskTextClass:this.options.maskTextClass,maskTextSelector:this.options.maskTextSelector,checkoutEveryNms:this.options.checkoutEveryNms??6e4,checkoutEveryNth:this.options.checkoutEveryNth,plugins:[o({key:`_faststatsSeqId`}),...this.options.recordConsole??!0?[a()]:[]]}),this.intervalId=setInterval(this.requestFlush,this.flushInterval),window.addEventListener(`beforeunload`,this.onUnload),window.addEventListener(`pagehide`,this.onUnload),document.addEventListener(`visibilitychange`,this.onVisibilityChange),this.log(`Recording started`))}stop(){if(this.started){if(this.started=!1,this.stopRecording?.(),this.stopRecording=void 0,this.intervalId&&clearInterval(this.intervalId),this.flushTask&&clearTimeout(this.flushTask),this.retryTask&&clearTimeout(this.retryTask),this.intervalId=null,this.flushTask=null,this.retryTask=null,window.removeEventListener(`beforeunload`,this.onUnload),window.removeEventListener(`pagehide`,this.onUnload),document.removeEventListener(`visibilitychange`,this.onVisibilityChange),!this.hasReachedMinLength()){this.events.length=0,this.log(`Session too short (${Date.now()-this.startTime}ms), discarding events`);return}this.flush(!0),this.log(`Recording stopped`)}}getSessionId(){return n()}onEvent=(e,t)=>{this.events.push(e),(t||this.events.length>=this.maxEvents||e.type===s.FullSnapshot&&this.hasReachedMinLength())&&this.requestFlush()};onUnload=()=>{this.flush(!0)};onVisibilityChange=()=>{document.visibilityState===`hidden`&&this.flush(!0)};hasReachedMinLength(){return this.minReplayLengthMs<=0||Date.now()-this.startTime>=this.minReplayLengthMs}requestFlush=()=>{this.flushTask||this.sending||this.events.length===0||(this.flushTask=setTimeout(()=>{this.flushTask=null,this.flush(!1)},0))};createBatch(t){let r=e();return{token:this.options.siteKey,sessionId:n(),...r?{identifier:r}:{},sequence:this.sequence++,timestamp:Date.now(),url:window.location.href,events:t}}async encodeBatch(e,t){let n=JSON.stringify(e);if(!this.compressionSupported||t)return{data:new Blob([n],{type:`application/json`}),isCompressed:!1};try{return{data:await this.compress(n),isCompressed:!0}}catch{return this.log(`Compression failed, using uncompressed`),{data:new Blob([n],{type:`application/json`}),isCompressed:!1}}}async flush(e){if(!this.sending&&(this.events.length>0&&(this.hasReachedMinLength()?this.pending.push(this.createBatch(this.events.splice(0))):this.log(`Too short (${Date.now()-this.startTime}ms), skipping flush`)),this.pending.length!==0)){this.sending=!0;try{for(;this.pending.length>0;){let t=this.pending[0];if(!t)break;let n=await this.encodeBatch(t,e);if(!await this.send(n.data,n.isCompressed,e)){this.pending.length>=this.maxPendingBatches&&(this.log(`Pending buffer full, dropping batch ${t.sequence}`),this.pending.shift()),this.scheduleRetry();break}this.log(`Sent ${t.events.length} events (seq: ${t.sequence})`),this.pending.shift(),e=!1}}finally{this.sending=!1}}}scheduleRetry(){this.retryTask||=setTimeout(()=>{this.retryTask=null,this.flush(!1)},1e3)}async compress(e){let t=new TextEncoder().encode(e),n=new CompressionStream(`gzip`),r=n.writable.getWriter();await r.write(t),await r.close();let i=[],a=n.readable.getReader();for(;;){let{done:e,value:t}=await a.read();if(e)break;t&&i.push(t)}let o=i.reduce((e,t)=>e+t.length,0),s=new Uint8Array(o),c=0;for(let e of i)s.set(e,c),c+=e.length;return this.log(`Compressed: ${t.length} → ${s.length} bytes (${(s.length/t.length*100).toFixed(1)}%)`),new Blob([s],{type:`application/octet-stream`})}send(e,t,n){return i({url:t?`${this.endpoint}?encoding=gzip`:this.endpoint,data:e,contentType:t?`application/octet-stream`:`application/json`,debug:this.debug,debugPrefix:`[Replay] ${(e.size/1024).toFixed(1)}KB`,useBeacon:n,keepalive:n})??Promise.resolve(!1)}};export{d as default};