@dataxamas/tracker-js 2.5.0 → 2.7.0

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+## 2.7.0
+
+- Web Vitals also collect FCP (First Contentful Paint) and TTFB (Time to First Byte), sent in the same batch as
+  LCP, INP and CLS. Needs a Dataxamas server that already accepts both metrics.
+- Session replay pauses the recorder after 1 minute without a gesture and resumes on the next one, in the same
+  recording. Limits now match the `dataxamas.js` script: 10 minutes, 15,000 events and 5 MB per recording.
+- Element scroll no longer counts as activity, so an auto-scrolling carousel does not keep the recorder running.
+
+## 2.6.0
+
+- No code changes; same build as 2.5.0.
+
+## 2.5.0
+
+- `tracking.identify(userId | null)` links the visitor to your own user id for retention cohorts; the server stores
+  only a hash of it.
+
+## 2.4.0
+
+- Visitors are identified server-side: the SDK no longer creates a session id and stores nothing in the browser
+  besides the replay key in `sessionStorage`.
+- Replay sampling is decided by the server.
+
+## 2.3.0
+
+- UTM attribution: only `utm_*` query params are sent.
+- Web Vitals (LCP, INP, CLS), flushed on `visibilitychange` / `pagehide`.
+- `tracking.track(name, data)` custom events for goals and funnels.
+
+## 2.1.3
+
+- Tuned the replay idle timeout and recording limit.
+
+## 2.1.2
+
+- Session replay keeps one recording per tab visit across route changes and reloads, closed after idle time or at the
+  size cap.
+- Per-site replay sample rate.
+- Skips automated browsers (`navigator.webdriver`).
+
+## 2.1.0
+
+- Crawler tracking: `DataxamasCrawlers` (`trackRequest`, `track`), `isCrawlerUserAgent`, `withCrawlerTracking` and
+  `createExpressCrawlerMiddleware`.
+- Default base URL is now `https://dataxamas.com`.
+
+## 2.0.1
+
+- Packaging fix, no code changes.
+
+## 2.0.0
+
+- Renamed to `@dataxamas/tracker-js` (was `dataxamas`).
+- `apiKey` replaces `websiteId`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dataxamas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -314,21 +314,25 @@ var DataxamasLogs = class {
   }
 };
 
+// ../tracker-shared/src/constants.ts
+var MAX_RECORDING_MS = 10 * 60 * 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;
 var STORAGE_PREFIX = "@dataxamas";
 var REPLAY_FLUSH_SIZE = 100;
 var REPLAY_FLUSH_INTERVAL_MS = 5e3;
 var CAP_CHECK_MS = 1e3;
-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.startedAt === "string" && typeof stored.startedAtMs === "number" && typeof stored.seq === "number" && typeof stored.events === "number" && typeof stored.lastActivityAt === "number" && typeof stored.capped === "boolean";
+  return typeof stored.id === "string" && typeof stored.startedAt === "string" && typeof stored.startedAtMs === "number" && typeof stored.seq === "number" && typeof stored.events === "number" && typeof stored.bytes === "number" && typeof stored.lastActivityAt === "number" && typeof stored.capped === "boolean";
 }
 var KEEPALIVE_LIMIT_BYTES = 60 * 1024;
 var DataxamasTracking = class {
@@ -381,6 +385,7 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = 0;
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.recordingBytes = 0;
     this.lastActivityAt = 0;
     this.lastActivitySavedAt = 0;
   }
@@ -571,6 +576,8 @@ var DataxamasTracking = class {
     webVitals.onLCP(queue);
     webVitals.onINP(queue);
     webVitals.onCLS(queue);
+    webVitals.onFCP(queue);
+    webVitals.onTTFB(queue);
     document.addEventListener("visibilitychange", () => {
       if (document.visibilityState === "hidden") this.flushVitals();
     });
@@ -589,7 +596,7 @@ var DataxamasTracking = class {
     return Boolean(this.stopRrweb);
   }
   exceededReplayCaps() {
-    return this.recordingEvents >= MAX_EVENTS_PER_RECORDING || Date.now() - this.recordingStartedAtMs >= MAX_RECORDING_MS;
+    return this.recordingEvents >= MAX_EVENTS_PER_RECORDING || this.recordingBytes >= MAX_BYTES_PER_RECORDING || Date.now() - this.recordingStartedAtMs >= MAX_RECORDING_MS;
   }
   loadRecording() {
     try {
@@ -607,6 +614,7 @@ var DataxamasTracking = class {
       startedAtMs: this.recordingStartedAtMs,
       seq: this.recordingSeq,
       events: this.recordingEvents,
+      bytes: this.recordingBytes,
       lastActivityAt: this.lastActivityAt,
       capped: this.replayCapped
     };
@@ -622,6 +630,7 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = Date.now();
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.recordingBytes = 0;
     this.lastActivityAt = Date.now();
     this.saveRecording();
   }
@@ -638,6 +647,7 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = stored.startedAtMs;
     this.recordingSeq = stored.seq;
     this.recordingEvents = stored.events;
+    this.recordingBytes = stored.bytes;
     this.lastActivityAt = stored.lastActivityAt;
   }
   touchActivity(now) {
@@ -659,6 +669,7 @@ var DataxamasTracking = class {
       ...this.measureReplay(),
       events
     });
+    this.recordingBytes += payload.length;
     this.saveRecording();
     void this.sendReplayBatch(payload, urgent);
   }
@@ -732,7 +743,7 @@ var DataxamasTracking = class {
   setupReplayLifecycle() {
     if (this.lifecycleReady) return;
     this.lifecycleReady = true;
-    for (const type of ["pointerdown", "keydown", "wheel", "touchstart", "scroll"]) {
+    for (const type of ["pointerdown", "keydown", "wheel", "touchstart"]) {
       window.addEventListener(type, this.markReplayActivity, { passive: true, capture: true });
     }
     setInterval(() => {
@@ -740,7 +751,11 @@ var DataxamasTracking = class {
     }, REPLAY_FLUSH_INTERVAL_MS);
     setInterval(() => {
       if (!this.isRecording()) return;
-      if (this.exceededReplayCaps()) this.scheduleReplayCutoff();
+      if (this.exceededReplayCaps()) {
+        this.scheduleReplayCutoff();
+        return;
+      }
+      if (Date.now() - this.lastActivityAt >= REPLAY_IDLE_SUSPEND_MS) this.stopReplayRecorder(false);
     }, CAP_CHECK_MS);
     window.addEventListener("pagehide", () => this.stopReplayRecorder(true));
     document.addEventListener("visibilitychange", () => {

package/dist/index.d.cts

@@ -134,6 +134,7 @@ declare class DataxamasTracking {
     private recordingStartedAtMs;
     private recordingSeq;
     private recordingEvents;
+    private recordingBytes;
     private lastActivityAt;
     private lastActivitySavedAt;
     constructor(options: DataxamasTrackingOptions);

package/dist/index.d.ts

@@ -134,6 +134,7 @@ declare class DataxamasTracking {
     private recordingStartedAtMs;
     private recordingSeq;
     private recordingEvents;
+    private recordingBytes;
     private lastActivityAt;
     private lastActivitySavedAt;
     constructor(options: DataxamasTrackingOptions);

package/dist/index.js

@@ -314,21 +314,25 @@ var DataxamasLogs = class {
   }
 };
 
+// ../tracker-shared/src/constants.ts
+var MAX_RECORDING_MS = 10 * 60 * 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;
 var STORAGE_PREFIX = "@dataxamas";
 var REPLAY_FLUSH_SIZE = 100;
 var REPLAY_FLUSH_INTERVAL_MS = 5e3;
 var CAP_CHECK_MS = 1e3;
-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.startedAt === "string" && typeof stored.startedAtMs === "number" && typeof stored.seq === "number" && typeof stored.events === "number" && typeof stored.lastActivityAt === "number" && typeof stored.capped === "boolean";
+  return typeof stored.id === "string" && typeof stored.startedAt === "string" && typeof stored.startedAtMs === "number" && typeof stored.seq === "number" && typeof stored.events === "number" && typeof stored.bytes === "number" && typeof stored.lastActivityAt === "number" && typeof stored.capped === "boolean";
 }
 var KEEPALIVE_LIMIT_BYTES = 60 * 1024;
 var DataxamasTracking = class {
@@ -381,6 +385,7 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = 0;
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.recordingBytes = 0;
     this.lastActivityAt = 0;
     this.lastActivitySavedAt = 0;
   }
@@ -571,6 +576,8 @@ var DataxamasTracking = class {
     webVitals.onLCP(queue);
     webVitals.onINP(queue);
     webVitals.onCLS(queue);
+    webVitals.onFCP(queue);
+    webVitals.onTTFB(queue);
     document.addEventListener("visibilitychange", () => {
       if (document.visibilityState === "hidden") this.flushVitals();
     });
@@ -589,7 +596,7 @@ var DataxamasTracking = class {
     return Boolean(this.stopRrweb);
   }
   exceededReplayCaps() {
-    return this.recordingEvents >= MAX_EVENTS_PER_RECORDING || Date.now() - this.recordingStartedAtMs >= MAX_RECORDING_MS;
+    return this.recordingEvents >= MAX_EVENTS_PER_RECORDING || this.recordingBytes >= MAX_BYTES_PER_RECORDING || Date.now() - this.recordingStartedAtMs >= MAX_RECORDING_MS;
   }
   loadRecording() {
     try {
@@ -607,6 +614,7 @@ var DataxamasTracking = class {
       startedAtMs: this.recordingStartedAtMs,
       seq: this.recordingSeq,
       events: this.recordingEvents,
+      bytes: this.recordingBytes,
       lastActivityAt: this.lastActivityAt,
       capped: this.replayCapped
     };
@@ -622,6 +630,7 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = Date.now();
     this.recordingSeq = 0;
     this.recordingEvents = 0;
+    this.recordingBytes = 0;
     this.lastActivityAt = Date.now();
     this.saveRecording();
   }
@@ -638,6 +647,7 @@ var DataxamasTracking = class {
     this.recordingStartedAtMs = stored.startedAtMs;
     this.recordingSeq = stored.seq;
     this.recordingEvents = stored.events;
+    this.recordingBytes = stored.bytes;
     this.lastActivityAt = stored.lastActivityAt;
   }
   touchActivity(now) {
@@ -659,6 +669,7 @@ var DataxamasTracking = class {
       ...this.measureReplay(),
       events
     });
+    this.recordingBytes += payload.length;
     this.saveRecording();
     void this.sendReplayBatch(payload, urgent);
   }
@@ -732,7 +743,7 @@ var DataxamasTracking = class {
   setupReplayLifecycle() {
     if (this.lifecycleReady) return;
     this.lifecycleReady = true;
-    for (const type of ["pointerdown", "keydown", "wheel", "touchstart", "scroll"]) {
+    for (const type of ["pointerdown", "keydown", "wheel", "touchstart"]) {
       window.addEventListener(type, this.markReplayActivity, { passive: true, capture: true });
     }
     setInterval(() => {
@@ -740,7 +751,11 @@ var DataxamasTracking = class {
     }, REPLAY_FLUSH_INTERVAL_MS);
     setInterval(() => {
       if (!this.isRecording()) return;
-      if (this.exceededReplayCaps()) this.scheduleReplayCutoff();
+      if (this.exceededReplayCaps()) {
+        this.scheduleReplayCutoff();
+        return;
+      }
+      if (Date.now() - this.lastActivityAt >= REPLAY_IDLE_SUSPEND_MS) this.stopReplayRecorder(false);
     }, CAP_CHECK_MS);
     window.addEventListener("pagehide", () => this.stopReplayRecorder(true));
     document.addEventListener("visibilitychange", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataxamas/tracker-js",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "type": "module",
   "description": "Node.js SDK for Dataxamas Analytics API",
   "license": "MIT",
@@ -14,7 +14,8 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "exports": {
     ".": {
@@ -26,14 +27,11 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
-    },
-    "./script": "./src/script/bundle.ts",
-    "./script/vite": "./src/script/vite.ts",
-    "./script/virtual": "./src/script/virtual.d.ts"
+    }
   },
   "scripts": {
     "build": "tsup",
-    "types": "tsc --noEmit && tsc --noEmit -p tsconfig.script.json",
+    "types": "tsc --noEmit",
     "lint": "biome lint",
     "lint:fix": "biome lint --write",
     "check": "biome check",
@@ -48,13 +46,12 @@
   ],
   "devDependencies": {
     "@dataxamas/biome-config": "workspace:*",
+    "@dataxamas/tracker-shared": "workspace:*",
     "@dataxamas/tsconfig": "workspace:*",
     "@types/node": "^26.1.0",
-    "esbuild": "^0.28.1",
     "rrweb": "^2.1.0",
     "tsup": "^8.5.1",
     "typescript": "^5",
-    "vite": "^8.0.16",
     "web-vitals": "^6.2.3"
   },
   "dependencies": {