@dataxamas/tracker-js 2.7.0 → 2.8.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 2.8.0
+
+- Session replay records at most 30 seconds per visit, counted from the visitor's first gesture instead of page
+  load. After the cap the visit is not recorded again; a new recording only starts after 10 minutes without
+  interaction.
+- The 1-minute idle pause is gone: the 30-second cap already ends the recording first.
+
 ## 2.7.0
 
 - Web Vitals also collect FCP (First Contentful Paint) and TTFB (Time to First Byte), sent in the same batch as

package/dist/index.cjs

@@ -315,11 +315,10 @@ var DataxamasLogs = class {
 };
 
 // ../tracker-shared/src/constants.ts
-var MAX_RECORDING_MS = 10 * 60 * 1e3;
+var MAX_RECORDING_MS = 30 * 1e3;
 var MAX_EVENTS_PER_RECORDING = 15e3;
 var MAX_BYTES_PER_RECORDING = 5 * 1024 * 1024;
 var REPLAY_IDLE_TIMEOUT_MS = 10 * 60 * 1e3;
-var REPLAY_IDLE_SUSPEND_MS = 60 * 1e3;
 
 // src/tracking.ts
 var QUEUE_DELAY_MS = 4e3;
@@ -339,19 +338,19 @@ var DataxamasTracking = class {
   constructor(options) {
     /**
      * 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.
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto a visita não grava mais;
+     * só um gesto depois de muito tempo parado abre uma gravação nova.
      */
     this.markReplayActivity = () => {
       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 (now - this.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
         if (this.isRecording()) this.stopReplayRecorder(false);
         this.rotateRecording();
       }
       this.touchActivity(now);
-      if (this.isRecording()) return;
+      if (this.replayCapped || this.isRecording()) return;
       this.startReplayRecorder();
     };
     if (!options.apiKey) {
@@ -634,14 +633,17 @@ var DataxamasTracking = class {
     this.lastActivityAt = Date.now();
     this.saveRecording();
   }
-  /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+  /**
+   * Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa.
+   * Se ela já bateu o teto, segue sem gravar.
+   */
   resumeOrRotateRecording() {
     const stored = this.loadRecording();
-    if (!stored || stored.capped || Date.now() - stored.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
+    if (!stored || Date.now() - stored.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
       this.rotateRecording();
       return;
     }
-    this.replayCapped = false;
+    this.replayCapped = stored.capped;
     this.recordingId = stored.id;
     this.recordingStartedAt = stored.startedAt;
     this.recordingStartedAtMs = stored.startedAtMs;
@@ -727,8 +729,8 @@ var DataxamasTracking = class {
     }
   }
   /**
-   * 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.
+   * Bateu o teto: encerra a gravação e a visita não grava mais, em vez de emendar um clipe atrás do
+   * outro.
    */
   scheduleReplayCutoff() {
     if (this.cutoffPending) return;
@@ -751,11 +753,7 @@ var DataxamasTracking = class {
     }, REPLAY_FLUSH_INTERVAL_MS);
     setInterval(() => {
       if (!this.isRecording()) return;
-      if (this.exceededReplayCaps()) {
-        this.scheduleReplayCutoff();
-        return;
-      }
-      if (Date.now() - this.lastActivityAt >= REPLAY_IDLE_SUSPEND_MS) this.stopReplayRecorder(false);
+      if (this.exceededReplayCaps()) this.scheduleReplayCutoff();
     }, CAP_CHECK_MS);
     window.addEventListener("pagehide", () => this.stopReplayRecorder(true));
     document.addEventListener("visibilitychange", () => {
@@ -777,9 +775,17 @@ var DataxamasTracking = class {
     }
     if (this.isRecording() || this.replayHalted) return;
     if (!this.recordingId) this.rotateRecording();
+    if (this.recordingSeq === 0) {
+      this.recordingStartedAt = (/* @__PURE__ */ new Date()).toISOString();
+      this.recordingStartedAtMs = Date.now();
+    }
     this.snapshotFlushed = false;
     this.stopRrweb = this.rrwebRecord({
       emit: (event) => {
+        if (this.exceededReplayCaps()) {
+          this.scheduleReplayCutoff();
+          return;
+        }
         this.replayBuffer.push(event);
         this.recordingEvents++;
         if (!this.snapshotFlushed && event.type === 2) {
@@ -787,10 +793,6 @@ var DataxamasTracking = class {
           this.flushReplay(false);
           return;
         }
-        if (this.exceededReplayCaps()) {
-          this.scheduleReplayCutoff();
-          return;
-        }
         if (this.replayBuffer.length >= REPLAY_FLUSH_SIZE) this.flushReplay(false);
       },
       maskAllInputs: true,

package/dist/index.d.cts

@@ -158,7 +158,10 @@ declare class DataxamasTracking {
     private loadRecording;
     private saveRecording;
     private rotateRecording;
-    /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+    /**
+     * Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa.
+     * Se ela já bateu o teto, segue sem gravar.
+     */
     private resumeOrRotateRecording;
     private touchActivity;
     private flushReplay;
@@ -170,14 +173,14 @@ declare class DataxamasTracking {
     private sendReplayBatch;
     private stopReplayRecorder;
     /**
-     * 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.
+     * Bateu o teto: encerra a gravação e a visita não grava mais, em vez de emendar um clipe atrás do
+     * outro.
      */
     private scheduleReplayCutoff;
     /**
      * 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.
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto a visita não grava mais;
+     * só um gesto depois de muito tempo parado abre uma gravação nova.
      */
     private markReplayActivity;
     private setupReplayLifecycle;

package/dist/index.d.ts

@@ -158,7 +158,10 @@ declare class DataxamasTracking {
     private loadRecording;
     private saveRecording;
     private rotateRecording;
-    /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+    /**
+     * Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa.
+     * Se ela já bateu o teto, segue sem gravar.
+     */
     private resumeOrRotateRecording;
     private touchActivity;
     private flushReplay;
@@ -170,14 +173,14 @@ declare class DataxamasTracking {
     private sendReplayBatch;
     private stopReplayRecorder;
     /**
-     * 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.
+     * Bateu o teto: encerra a gravação e a visita não grava mais, em vez de emendar um clipe atrás do
+     * outro.
      */
     private scheduleReplayCutoff;
     /**
      * 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.
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto a visita não grava mais;
+     * só um gesto depois de muito tempo parado abre uma gravação nova.
      */
     private markReplayActivity;
     private setupReplayLifecycle;

package/dist/index.js

@@ -315,11 +315,10 @@ var DataxamasLogs = class {
 };
 
 // ../tracker-shared/src/constants.ts
-var MAX_RECORDING_MS = 10 * 60 * 1e3;
+var MAX_RECORDING_MS = 30 * 1e3;
 var MAX_EVENTS_PER_RECORDING = 15e3;
 var MAX_BYTES_PER_RECORDING = 5 * 1024 * 1024;
 var REPLAY_IDLE_TIMEOUT_MS = 10 * 60 * 1e3;
-var REPLAY_IDLE_SUSPEND_MS = 60 * 1e3;
 
 // src/tracking.ts
 var QUEUE_DELAY_MS = 4e3;
@@ -339,19 +338,19 @@ var DataxamasTracking = class {
   constructor(options) {
     /**
      * 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.
+     * para segundo plano, reload), no mesmo `recordingId`. Depois do teto a visita não grava mais;
+     * só um gesto depois de muito tempo parado abre uma gravação nova.
      */
     this.markReplayActivity = () => {
       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 (now - this.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
         if (this.isRecording()) this.stopReplayRecorder(false);
         this.rotateRecording();
       }
       this.touchActivity(now);
-      if (this.isRecording()) return;
+      if (this.replayCapped || this.isRecording()) return;
       this.startReplayRecorder();
     };
     if (!options.apiKey) {
@@ -634,14 +633,17 @@ var DataxamasTracking = class {
     this.lastActivityAt = Date.now();
     this.saveRecording();
   }
-  /** Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa. */
+  /**
+   * Reload ou navegação completa na mesma aba continua a gravação, se a visita ainda estiver ativa.
+   * Se ela já bateu o teto, segue sem gravar.
+   */
   resumeOrRotateRecording() {
     const stored = this.loadRecording();
-    if (!stored || stored.capped || Date.now() - stored.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
+    if (!stored || Date.now() - stored.lastActivityAt >= REPLAY_IDLE_TIMEOUT_MS) {
       this.rotateRecording();
       return;
     }
-    this.replayCapped = false;
+    this.replayCapped = stored.capped;
     this.recordingId = stored.id;
     this.recordingStartedAt = stored.startedAt;
     this.recordingStartedAtMs = stored.startedAtMs;
@@ -727,8 +729,8 @@ var DataxamasTracking = class {
     }
   }
   /**
-   * 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.
+   * Bateu o teto: encerra a gravação e a visita não grava mais, em vez de emendar um clipe atrás do
+   * outro.
    */
   scheduleReplayCutoff() {
     if (this.cutoffPending) return;
@@ -751,11 +753,7 @@ var DataxamasTracking = class {
     }, REPLAY_FLUSH_INTERVAL_MS);
     setInterval(() => {
       if (!this.isRecording()) return;
-      if (this.exceededReplayCaps()) {
-        this.scheduleReplayCutoff();
-        return;
-      }
-      if (Date.now() - this.lastActivityAt >= REPLAY_IDLE_SUSPEND_MS) this.stopReplayRecorder(false);
+      if (this.exceededReplayCaps()) this.scheduleReplayCutoff();
     }, CAP_CHECK_MS);
     window.addEventListener("pagehide", () => this.stopReplayRecorder(true));
     document.addEventListener("visibilitychange", () => {
@@ -777,9 +775,17 @@ var DataxamasTracking = class {
     }
     if (this.isRecording() || this.replayHalted) return;
     if (!this.recordingId) this.rotateRecording();
+    if (this.recordingSeq === 0) {
+      this.recordingStartedAt = (/* @__PURE__ */ new Date()).toISOString();
+      this.recordingStartedAtMs = Date.now();
+    }
     this.snapshotFlushed = false;
     this.stopRrweb = this.rrwebRecord({
       emit: (event) => {
+        if (this.exceededReplayCaps()) {
+          this.scheduleReplayCutoff();
+          return;
+        }
         this.replayBuffer.push(event);
         this.recordingEvents++;
         if (!this.snapshotFlushed && event.type === 2) {
@@ -787,10 +793,6 @@ var DataxamasTracking = class {
           this.flushReplay(false);
           return;
         }
-        if (this.exceededReplayCaps()) {
-          this.scheduleReplayCutoff();
-          return;
-        }
         if (this.replayBuffer.length >= REPLAY_FLUSH_SIZE) this.flushReplay(false);
       },
       maskAllInputs: true,

package/package.json

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