@dataxamas/tracker-js 2.1.0 → 2.1.3

package/dist/index.cjs

@@ -318,19 +318,34 @@ var STORAGE_PREFIX = "@dataxamas";
 var REPLAY_FLUSH_SIZE = 100;
 var REPLAY_FLUSH_INTERVAL_MS = 5e3;
 var CAP_CHECK_MS = 1e3;
-var MAX_RECORDING_MS = 10 * 60 * 1e3;
-var MAX_EVENTS_PER_RECORDING = 2e4;
+var MAX_RECORDING_MS = 30 * 60 * 1e3;
+var MAX_EVENTS_PER_RECORDING = 5e4;
+var REPLAY_IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
+var ACTIVITY_SAVE_THROTTLE_MS = 5e3;
+var REPLAY_RECORDING_KEY = `${STORAGE_PREFIX}/replay-recording`;
+function isStoredRecording(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const stored = value;
+  return typeof stored.id === "string" && typeof stored.sessionId === "string" && typeof stored.startedAt === "string" && typeof stored.startedAtMs === "number" && typeof stored.seq === "number" && typeof stored.events === "number" && typeof stored.lastActivityAt === "number" && typeof stored.capped === "boolean";
+}
 var KEEPALIVE_LIMIT_BYTES = 60 * 1024;
-var REPLAY_SAMPLE_RATE = 1;
 var DataxamasTracking = class {
   constructor(options) {
     /**
-     * Primeiro gesto da pageview liga o gravador; os seguintes só o religam se ele tiver parado
-     * (aba que foi para segundo plano, por exemplo), sempre no mesmo `recordingId`.
+     * Primeiro gesto liga o gravador; os seguintes só o religam se ele tiver parado (aba que foi
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto ou de muito tempo parado,
+     * o gesto abre uma gravação nova.
      */
     this.markReplayActivity = () => {
-      if (this.replayHalted || this.replayCapped || this.isRecording()) return;
+      if (this.replayHalted || this.cutoffPending) return;
       if (document.visibilityState === "hidden") return;
+      const now = Date.now();
+      if (this.replayCapped || now - this.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
+        if (this.isRecording()) this.stopReplayRecorder(false);
+        this.rotateRecording();
+      }
+      this.touchActivity(now);
+      if (this.isRecording()) return;
       this.startReplayRecorder();
     };
     if (!options.apiKey) {
@@ -343,6 +358,7 @@ var DataxamasTracking = class {
     this.currentPage = isBrowser() ? window.location.pathname : "";
     this.heatMapEnabled = _nullishCoalesce(options.heatMapEnabled, () => ( true));
     this.replayEnabled = _nullishCoalesce(options.replayEnabled, () => ( true));
+    this.replaySampleRate = 1;
     this.eventQueue = [];
     this.isProcessing = false;
     this.rrwebRecord = null;
@@ -359,6 +375,8 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = 0;
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.lastActivityAt = 0;
+    this.lastActivitySavedAt = 0;
   }
   isLocalhost() {
     return window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1";
@@ -420,8 +438,7 @@ var DataxamasTracking = class {
     setInterval(() => {
       const newPath = window.location.pathname;
       if (newPath !== lastPath) {
-        this.stopReplayRecorder(false);
-        this.rotateRecording();
+        this.flushReplay(false);
         this.currentPage = newPath;
         this.sendEvent({ name: "PAGE_VIEW", path: newPath });
         lastPath = newPath;
@@ -437,6 +454,9 @@ var DataxamasTracking = class {
       const cfg = await res.json();
       if (typeof cfg.heatMapEnabled === "boolean") this.heatMapEnabled = cfg.heatMapEnabled;
       if (typeof cfg.replayEnabled === "boolean") this.replayEnabled = cfg.replayEnabled;
+      if (typeof cfg.replaySampleRate === "number" && cfg.replaySampleRate >= 0 && cfg.replaySampleRate <= 1) {
+        this.replaySampleRate = cfg.replaySampleRate;
+      }
     } catch (_) {
     }
   }
@@ -530,17 +550,20 @@ var DataxamasTracking = class {
    * de um replay picotado que não dá para assistir.
    */
   isReplaySampled() {
-    if (REPLAY_SAMPLE_RATE >= 1) return true;
-    if (REPLAY_SAMPLE_RATE <= 0) return false;
+    const rate = this.replaySampleRate;
+    if (rate >= 1) return true;
+    if (rate <= 0) return false;
+    const key = `${STORAGE_PREFIX}/replay-sample`;
     try {
-      const stored = window.localStorage.getItem(`${STORAGE_PREFIX}/replay-sample`);
-      if (stored === "1") return true;
-      if (stored === "0") return false;
-      const sampled = Math.random() < REPLAY_SAMPLE_RATE;
-      window.localStorage.setItem(`${STORAGE_PREFIX}/replay-sample`, sampled ? "1" : "0");
+      const [storedRate, storedDecision] = (_nullishCoalesce(window.localStorage.getItem(key), () => ( ""))).split(":");
+      if (Number(storedRate) === rate && (storedDecision === "1" || storedDecision === "0")) {
+        return storedDecision === "1";
+      }
+      const sampled = Math.random() < rate;
+      window.localStorage.setItem(key, `${rate}:${sampled ? "1" : "0"}`);
       return sampled;
     } catch (_) {
-      return Math.random() < REPLAY_SAMPLE_RATE;
+      return Math.random() < rate;
     }
   }
   isRecording() {
@@ -549,6 +572,31 @@ var DataxamasTracking = class {
   exceededReplayCaps() {
     return this.recordingEvents >= MAX_EVENTS_PER_RECORDING || Date.now() - this.recordingStartedAtMs >= MAX_RECORDING_MS;
   }
+  loadRecording() {
+    try {
+      const parsed = JSON.parse(_nullishCoalesce(window.sessionStorage.getItem(REPLAY_RECORDING_KEY), () => ( "null")));
+      return isStoredRecording(parsed) ? parsed : null;
+    } catch (_) {
+      return null;
+    }
+  }
+  saveRecording() {
+    if (!this.sessionId || !this.recordingId || !this.recordingStartedAt) return;
+    const stored = {
+      id: this.recordingId,
+      sessionId: this.sessionId,
+      startedAt: this.recordingStartedAt,
+      startedAtMs: this.recordingStartedAtMs,
+      seq: this.recordingSeq,
+      events: this.recordingEvents,
+      lastActivityAt: this.lastActivityAt,
+      capped: this.replayCapped
+    };
+    try {
+      window.sessionStorage.setItem(REPLAY_RECORDING_KEY, JSON.stringify(stored));
+    } catch (_) {
+    }
+  }
   rotateRecording() {
     this.replayCapped = false;
     this.recordingId = crypto.randomUUID();
@@ -556,6 +604,29 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = Date.now();
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.lastActivityAt = Date.now();
+    this.saveRecording();
+  }
+  /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+  resumeOrRotateRecording() {
+    const stored = this.loadRecording();
+    if (!stored || stored.capped || stored.sessionId !== this.sessionId || Date.now() - stored.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
+      this.rotateRecording();
+      return;
+    }
+    this.replayCapped = false;
+    this.recordingId = stored.id;
+    this.recordingStartedAt = stored.startedAt;
+    this.recordingStartedAtMs = stored.startedAtMs;
+    this.recordingSeq = stored.seq;
+    this.recordingEvents = stored.events;
+    this.lastActivityAt = stored.lastActivityAt;
+  }
+  touchActivity(now) {
+    this.lastActivityAt = now;
+    if (now - this.lastActivitySavedAt < ACTIVITY_SAVE_THROTTLE_MS) return;
+    this.lastActivitySavedAt = now;
+    this.saveRecording();
   }
   flushReplay(urgent) {
     if (this.replayBuffer.length === 0 || !this.recordingId) return;
@@ -571,6 +642,7 @@ var DataxamasTracking = class {
       ...this.measureReplay(),
       events
     });
+    this.saveRecording();
     void this.sendReplayBatch(payload, urgent);
   }
   /**
@@ -612,6 +684,8 @@ var DataxamasTracking = class {
       const body = await res.json().catch(() => null);
       if (_optionalChain([body, 'optionalAccess', _28 => _28.stop])) {
         this.replayHalted = true;
+        this.replayCapped = true;
+        this.saveRecording();
         this.stopReplayRecorder(false);
       }
     } catch (_) {
@@ -625,13 +699,14 @@ var DataxamasTracking = class {
     }
   }
   /**
-   * Bateu o teto: encerra a gravação e fica parado até a próxima pageview, em vez de emendar um
+   * Bateu o teto: encerra a gravação e fica parado até a próxima interação, em vez de emendar um
    * clipe atrás do outro enquanto a página só anima sozinha.
    */
   scheduleReplayCutoff() {
     if (this.cutoffPending) return;
     this.cutoffPending = true;
     this.replayCapped = true;
+    this.saveRecording();
     setTimeout(() => {
       this.cutoffPending = false;
       this.stopReplayRecorder(false);
@@ -708,6 +783,7 @@ var DataxamasTracking = class {
   }
   startTracking() {
     this.sessionId = _nullishCoalesce(this.getSessionId(), () => ( this.createSessionId()));
+    this.resumeOrRotateRecording();
     this.sendEvent({ name: "PAGE_VIEW" });
     this.trackPageChanges();
     this.trackClicks();
@@ -722,6 +798,7 @@ var DataxamasTracking = class {
       throw new Error("DataxamasTracking: This SDK can only be used in a browser environment.");
     }
     if (!this.allowLocalhost && this.isLocalhost()) return;
+    if (navigator.webdriver) return;
     if (document.readyState === "loading") {
       document.addEventListener("DOMContentLoaded", this.startTracking.bind(this));
     } else {

package/dist/index.d.cts

@@ -112,6 +112,7 @@ declare class DataxamasTracking {
     private currentPage;
     private heatMapEnabled;
     private replayEnabled;
+    private replaySampleRate;
     private eventQueue;
     private isProcessing;
     private rrwebRecord;
@@ -128,6 +129,8 @@ declare class DataxamasTracking {
     private recordingStartedAtMs;
     private recordingSeq;
     private recordingEvents;
+    private lastActivityAt;
+    private lastActivitySavedAt;
     constructor(options: DataxamasTrackingOptions);
     private isLocalhost;
     private getSessionId;
@@ -150,7 +153,12 @@ declare class DataxamasTracking {
     private isReplaySampled;
     private isRecording;
     private exceededReplayCaps;
+    private loadRecording;
+    private saveRecording;
     private rotateRecording;
+    /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+    private resumeOrRotateRecording;
+    private touchActivity;
     private flushReplay;
     /**
      * Um full snapshot com CSS inline passa fácil de 100KB cru, e era isso que tomava 413 no
@@ -160,13 +168,14 @@ declare class DataxamasTracking {
     private sendReplayBatch;
     private stopReplayRecorder;
     /**
-     * Bateu o teto: encerra a gravação e fica parado até a próxima pageview, em vez de emendar um
+     * Bateu o teto: encerra a gravação e fica parado até a próxima interação, em vez de emendar um
      * clipe atrás do outro enquanto a página só anima sozinha.
      */
     private scheduleReplayCutoff;
     /**
-     * Primeiro gesto da pageview liga o gravador; os seguintes só o religam se ele tiver parado
-     * (aba que foi para segundo plano, por exemplo), sempre no mesmo `recordingId`.
+     * Primeiro gesto liga o gravador; os seguintes só o religam se ele tiver parado (aba que foi
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto ou de muito tempo parado,
+     * o gesto abre uma gravação nova.
      */
     private markReplayActivity;
     private setupReplayLifecycle;

package/dist/index.d.ts

@@ -112,6 +112,7 @@ declare class DataxamasTracking {
     private currentPage;
     private heatMapEnabled;
     private replayEnabled;
+    private replaySampleRate;
     private eventQueue;
     private isProcessing;
     private rrwebRecord;
@@ -128,6 +129,8 @@ declare class DataxamasTracking {
     private recordingStartedAtMs;
     private recordingSeq;
     private recordingEvents;
+    private lastActivityAt;
+    private lastActivitySavedAt;
     constructor(options: DataxamasTrackingOptions);
     private isLocalhost;
     private getSessionId;
@@ -150,7 +153,12 @@ declare class DataxamasTracking {
     private isReplaySampled;
     private isRecording;
     private exceededReplayCaps;
+    private loadRecording;
+    private saveRecording;
     private rotateRecording;
+    /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+    private resumeOrRotateRecording;
+    private touchActivity;
     private flushReplay;
     /**
      * Um full snapshot com CSS inline passa fácil de 100KB cru, e era isso que tomava 413 no
@@ -160,13 +168,14 @@ declare class DataxamasTracking {
     private sendReplayBatch;
     private stopReplayRecorder;
     /**
-     * Bateu o teto: encerra a gravação e fica parado até a próxima pageview, em vez de emendar um
+     * Bateu o teto: encerra a gravação e fica parado até a próxima interação, em vez de emendar um
      * clipe atrás do outro enquanto a página só anima sozinha.
      */
     private scheduleReplayCutoff;
     /**
-     * Primeiro gesto da pageview liga o gravador; os seguintes só o religam se ele tiver parado
-     * (aba que foi para segundo plano, por exemplo), sempre no mesmo `recordingId`.
+     * Primeiro gesto liga o gravador; os seguintes só o religam se ele tiver parado (aba que foi
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto ou de muito tempo parado,
+     * o gesto abre uma gravação nova.
      */
     private markReplayActivity;
     private setupReplayLifecycle;

package/dist/index.js

@@ -318,19 +318,34 @@ var STORAGE_PREFIX = "@dataxamas";
 var REPLAY_FLUSH_SIZE = 100;
 var REPLAY_FLUSH_INTERVAL_MS = 5e3;
 var CAP_CHECK_MS = 1e3;
-var MAX_RECORDING_MS = 10 * 60 * 1e3;
-var MAX_EVENTS_PER_RECORDING = 2e4;
+var MAX_RECORDING_MS = 30 * 60 * 1e3;
+var MAX_EVENTS_PER_RECORDING = 5e4;
+var REPLAY_IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
+var ACTIVITY_SAVE_THROTTLE_MS = 5e3;
+var REPLAY_RECORDING_KEY = `${STORAGE_PREFIX}/replay-recording`;
+function isStoredRecording(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const stored = value;
+  return typeof stored.id === "string" && typeof stored.sessionId === "string" && typeof stored.startedAt === "string" && typeof stored.startedAtMs === "number" && typeof stored.seq === "number" && typeof stored.events === "number" && typeof stored.lastActivityAt === "number" && typeof stored.capped === "boolean";
+}
 var KEEPALIVE_LIMIT_BYTES = 60 * 1024;
-var REPLAY_SAMPLE_RATE = 1;
 var DataxamasTracking = class {
   constructor(options) {
     /**
-     * Primeiro gesto da pageview liga o gravador; os seguintes só o religam se ele tiver parado
-     * (aba que foi para segundo plano, por exemplo), sempre no mesmo `recordingId`.
+     * Primeiro gesto liga o gravador; os seguintes só o religam se ele tiver parado (aba que foi
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto ou de muito tempo parado,
+     * o gesto abre uma gravação nova.
      */
     this.markReplayActivity = () => {
-      if (this.replayHalted || this.replayCapped || this.isRecording()) return;
+      if (this.replayHalted || this.cutoffPending) return;
       if (document.visibilityState === "hidden") return;
+      const now = Date.now();
+      if (this.replayCapped || now - this.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
+        if (this.isRecording()) this.stopReplayRecorder(false);
+        this.rotateRecording();
+      }
+      this.touchActivity(now);
+      if (this.isRecording()) return;
       this.startReplayRecorder();
     };
     if (!options.apiKey) {
@@ -343,6 +358,7 @@ var DataxamasTracking = class {
     this.currentPage = isBrowser() ? window.location.pathname : "";
     this.heatMapEnabled = options.heatMapEnabled ?? true;
     this.replayEnabled = options.replayEnabled ?? true;
+    this.replaySampleRate = 1;
     this.eventQueue = [];
     this.isProcessing = false;
     this.rrwebRecord = null;
@@ -359,6 +375,8 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = 0;
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.lastActivityAt = 0;
+    this.lastActivitySavedAt = 0;
   }
   isLocalhost() {
     return window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1";
@@ -420,8 +438,7 @@ var DataxamasTracking = class {
     setInterval(() => {
       const newPath = window.location.pathname;
       if (newPath !== lastPath) {
-        this.stopReplayRecorder(false);
-        this.rotateRecording();
+        this.flushReplay(false);
         this.currentPage = newPath;
         this.sendEvent({ name: "PAGE_VIEW", path: newPath });
         lastPath = newPath;
@@ -437,6 +454,9 @@ var DataxamasTracking = class {
       const cfg = await res.json();
       if (typeof cfg.heatMapEnabled === "boolean") this.heatMapEnabled = cfg.heatMapEnabled;
       if (typeof cfg.replayEnabled === "boolean") this.replayEnabled = cfg.replayEnabled;
+      if (typeof cfg.replaySampleRate === "number" && cfg.replaySampleRate >= 0 && cfg.replaySampleRate <= 1) {
+        this.replaySampleRate = cfg.replaySampleRate;
+      }
     } catch (_) {
     }
   }
@@ -530,17 +550,20 @@ var DataxamasTracking = class {
    * de um replay picotado que não dá para assistir.
    */
   isReplaySampled() {
-    if (REPLAY_SAMPLE_RATE >= 1) return true;
-    if (REPLAY_SAMPLE_RATE <= 0) return false;
+    const rate = this.replaySampleRate;
+    if (rate >= 1) return true;
+    if (rate <= 0) return false;
+    const key = `${STORAGE_PREFIX}/replay-sample`;
     try {
-      const stored = window.localStorage.getItem(`${STORAGE_PREFIX}/replay-sample`);
-      if (stored === "1") return true;
-      if (stored === "0") return false;
-      const sampled = Math.random() < REPLAY_SAMPLE_RATE;
-      window.localStorage.setItem(`${STORAGE_PREFIX}/replay-sample`, sampled ? "1" : "0");
+      const [storedRate, storedDecision] = (window.localStorage.getItem(key) ?? "").split(":");
+      if (Number(storedRate) === rate && (storedDecision === "1" || storedDecision === "0")) {
+        return storedDecision === "1";
+      }
+      const sampled = Math.random() < rate;
+      window.localStorage.setItem(key, `${rate}:${sampled ? "1" : "0"}`);
       return sampled;
     } catch (_) {
-      return Math.random() < REPLAY_SAMPLE_RATE;
+      return Math.random() < rate;
     }
   }
   isRecording() {
@@ -549,6 +572,31 @@ var DataxamasTracking = class {
   exceededReplayCaps() {
     return this.recordingEvents >= MAX_EVENTS_PER_RECORDING || Date.now() - this.recordingStartedAtMs >= MAX_RECORDING_MS;
   }
+  loadRecording() {
+    try {
+      const parsed = JSON.parse(window.sessionStorage.getItem(REPLAY_RECORDING_KEY) ?? "null");
+      return isStoredRecording(parsed) ? parsed : null;
+    } catch (_) {
+      return null;
+    }
+  }
+  saveRecording() {
+    if (!this.sessionId || !this.recordingId || !this.recordingStartedAt) return;
+    const stored = {
+      id: this.recordingId,
+      sessionId: this.sessionId,
+      startedAt: this.recordingStartedAt,
+      startedAtMs: this.recordingStartedAtMs,
+      seq: this.recordingSeq,
+      events: this.recordingEvents,
+      lastActivityAt: this.lastActivityAt,
+      capped: this.replayCapped
+    };
+    try {
+      window.sessionStorage.setItem(REPLAY_RECORDING_KEY, JSON.stringify(stored));
+    } catch (_) {
+    }
+  }
   rotateRecording() {
     this.replayCapped = false;
     this.recordingId = crypto.randomUUID();
@@ -556,6 +604,29 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = Date.now();
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.lastActivityAt = Date.now();
+    this.saveRecording();
+  }
+  /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+  resumeOrRotateRecording() {
+    const stored = this.loadRecording();
+    if (!stored || stored.capped || stored.sessionId !== this.sessionId || Date.now() - stored.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
+      this.rotateRecording();
+      return;
+    }
+    this.replayCapped = false;
+    this.recordingId = stored.id;
+    this.recordingStartedAt = stored.startedAt;
+    this.recordingStartedAtMs = stored.startedAtMs;
+    this.recordingSeq = stored.seq;
+    this.recordingEvents = stored.events;
+    this.lastActivityAt = stored.lastActivityAt;
+  }
+  touchActivity(now) {
+    this.lastActivityAt = now;
+    if (now - this.lastActivitySavedAt < ACTIVITY_SAVE_THROTTLE_MS) return;
+    this.lastActivitySavedAt = now;
+    this.saveRecording();
   }
   flushReplay(urgent) {
     if (this.replayBuffer.length === 0 || !this.recordingId) return;
@@ -571,6 +642,7 @@ var DataxamasTracking = class {
       ...this.measureReplay(),
       events
     });
+    this.saveRecording();
     void this.sendReplayBatch(payload, urgent);
   }
   /**
@@ -612,6 +684,8 @@ var DataxamasTracking = class {
       const body = await res.json().catch(() => null);
       if (body?.stop) {
         this.replayHalted = true;
+        this.replayCapped = true;
+        this.saveRecording();
         this.stopReplayRecorder(false);
       }
     } catch (_) {
@@ -625,13 +699,14 @@ var DataxamasTracking = class {
     }
   }
   /**
-   * Bateu o teto: encerra a gravação e fica parado até a próxima pageview, em vez de emendar um
+   * Bateu o teto: encerra a gravação e fica parado até a próxima interação, em vez de emendar um
    * clipe atrás do outro enquanto a página só anima sozinha.
    */
   scheduleReplayCutoff() {
     if (this.cutoffPending) return;
     this.cutoffPending = true;
     this.replayCapped = true;
+    this.saveRecording();
     setTimeout(() => {
       this.cutoffPending = false;
       this.stopReplayRecorder(false);
@@ -708,6 +783,7 @@ var DataxamasTracking = class {
   }
   startTracking() {
     this.sessionId = this.getSessionId() ?? this.createSessionId();
+    this.resumeOrRotateRecording();
     this.sendEvent({ name: "PAGE_VIEW" });
     this.trackPageChanges();
     this.trackClicks();
@@ -722,6 +798,7 @@ var DataxamasTracking = class {
       throw new Error("DataxamasTracking: This SDK can only be used in a browser environment.");
     }
     if (!this.allowLocalhost && this.isLocalhost()) return;
+    if (navigator.webdriver) return;
     if (document.readyState === "loading") {
       document.addEventListener("DOMContentLoaded", this.startTracking.bind(this));
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataxamas/tracker-js",
-  "version": "2.1.0",
+  "version": "2.1.3",
   "type": "module",
   "description": "Node.js SDK for Dataxamas Analytics API",
   "license": "MIT",