@tell-rs/browser 0.2.8 → 0.3.2

package/README.md

@@ -32,7 +32,7 @@ tell.track("Button Clicked", { button: "signup" });
 tell.identify("user_123", { name: "Alice" });
 
 // Structured logging
-tell.logInfo("Checkout started", "commerce");
+tell.logInfo("Checkout started", { section: "commerce" });
 ```
 
 Events called before `configure()` are automatically queued and replayed.
@@ -57,6 +57,7 @@ tell.configure("feed1e11feed1e11feed1e11feed1e11", {
   disabled: false,                        // disable all tracking
   maxQueueSize: 1000,                     // max queued items
   sessionTimeout: 1_800_000,              // 30 min session timeout
+  maxSessionLength: 86_400_000,           // 24 hour max session length
   persistence: "localStorage",            // "localStorage" | "memory"
   respectDoNotTrack: false,               // honor browser DNT setting
   botDetection: true,                     // auto-disable for bots
@@ -81,13 +82,13 @@ No `userId` parameter on `track`, `group`, or `revenue` — the browser SDK uses
 ### Logging
 
 ```ts
-tell.log(level, message, service?, data?)
+tell.log(level, message, data?)
 
 // Convenience methods
-tell.logError(message, service?, data?)
-tell.logWarning(message, service?, data?)
-tell.logInfo(message, service?, data?)
-tell.logDebug(message, service?, data?)
+tell.logError(message, data?)
+tell.logWarning(message, data?)
+tell.logInfo(message, data?)
+tell.logDebug(message, data?)
 // ... and logEmergency, logAlert, logCritical, logNotice, logTrace
 ```
 
@@ -129,7 +130,7 @@ tell.configure("feed1e11feed1e11feed1e11feed1e11", production());   // defaults,
 
 ## Features
 
-- **Automatic sessions** — rotated on 30-min inactivity or tab hidden/visible
+- **Automatic sessions** — persisted across page loads, rotated on 30-min inactivity or 24-hour max lifetime
 - **Pre-init queue** — events called before `configure()` are buffered and replayed
 - **sendBeacon flush** — events are flushed via `navigator.sendBeacon` on page unload
 - **Bot detection** — auto-disables for headless browsers and bots

package/dist/index.cjs

@@ -353,6 +353,8 @@ var DEFAULTS = {
   maxQueueSize: 1e3,
   sessionTimeout: 18e5,
   // 30 min
+  maxSessionLength: 864e5,
+  // 24 hours
   persistence: "localStorage",
   respectDoNotTrack: false,
   botDetection: true,
@@ -585,20 +587,41 @@ function captureUtm() {
 }
 
 // src/session.ts
+var SESSION_ID_KEY = "tell_session_id";
+var SESSION_TS_KEY = "tell_session_ts";
+var SESSION_START_KEY = "tell_session_start";
+var PERSIST_INTERVAL = 6e4;
 var SessionManager = class {
   _sessionId;
   lastHiddenAt = 0;
   lastActivityAt;
+  sessionStartedAt;
+  lastPersistedAt = 0;
   timeout;
+  maxLength;
+  storage;
   onNewSession;
   visibilityHandler;
-  lastContextAt = {};
   constructor(config) {
     this.timeout = config.timeout;
+    this.maxLength = config.maxLength;
+    this.storage = config.storage;
     this.onNewSession = config.onNewSession;
-    this._sessionId = generateId();
-    this.lastActivityAt = Date.now();
-    this.emitContext("session_start");
+    const now = Date.now();
+    const storedId = this.storage.get(SESSION_ID_KEY);
+    const storedTs = Number(this.storage.get(SESSION_TS_KEY) || 0);
+    const storedStart = Number(this.storage.get(SESSION_START_KEY) || 0);
+    if (storedId && storedTs > 0 && storedStart > 0 && now - storedTs < this.timeout && now - storedStart < this.maxLength) {
+      this._sessionId = storedId;
+      this.lastActivityAt = storedTs;
+      this.sessionStartedAt = storedStart;
+    } else {
+      this._sessionId = generateId();
+      this.lastActivityAt = now;
+      this.sessionStartedAt = now;
+      this.persist();
+      this.onNewSession("session_start", this._sessionId);
+    }
     this.visibilityHandler = () => this.handleVisibility();
     if (typeof document !== "undefined") {
       document.addEventListener("visibilitychange", this.visibilityHandler);
@@ -609,14 +632,21 @@ var SessionManager = class {
   }
   set sessionId(id) {
     this._sessionId = id;
+    const now = Date.now();
+    this.lastActivityAt = now;
+    this.sessionStartedAt = now;
+    this.persist();
   }
-  /** Update activity timestamp; rotates session if idle longer than timeout. */
+  /** Update activity timestamp; rotates session if idle longer than timeout or exceeds max length. */
   touch() {
     const now = Date.now();
-    if (now - this.lastActivityAt > this.timeout) {
+    if (now - this.lastActivityAt > this.timeout || now - this.sessionStartedAt > this.maxLength) {
       this.rotateSession("session_timeout");
     }
     this.lastActivityAt = now;
+    if (now - this.lastPersistedAt >= PERSIST_INTERVAL) {
+      this.persistActivity();
+    }
   }
   destroy() {
     if (typeof document !== "undefined") {
@@ -627,26 +657,31 @@ var SessionManager = class {
     if (document.visibilityState === "hidden") {
       this.lastHiddenAt = Date.now();
     } else if (document.visibilityState === "visible") {
-      if (this.lastHiddenAt > 0 && Date.now() - this.lastHiddenAt > this.timeout) {
+      const now = Date.now();
+      if (this.lastHiddenAt > 0 && (now - this.lastHiddenAt > this.timeout || now - this.sessionStartedAt > this.maxLength)) {
         this.rotateSession("session_timeout");
-      } else if (this.lastHiddenAt > 0) {
-        this.emitContext("app_foreground");
       }
       this.lastHiddenAt = 0;
     }
   }
   rotateSession(reason) {
     this._sessionId = generateId();
-    this.lastActivityAt = Date.now();
-    this.emitContext(reason);
-  }
-  emitContext(reason) {
     const now = Date.now();
-    const last = this.lastContextAt[reason] ?? 0;
-    if (now - last < 1e3) return;
-    this.lastContextAt[reason] = now;
+    this.lastActivityAt = now;
+    this.sessionStartedAt = now;
+    this.persist();
     this.onNewSession(reason, this._sessionId);
   }
+  persist() {
+    this.storage.set(SESSION_ID_KEY, this._sessionId);
+    this.storage.set(SESSION_TS_KEY, String(this.lastActivityAt));
+    this.storage.set(SESSION_START_KEY, String(this.sessionStartedAt));
+    this.lastPersistedAt = Date.now();
+  }
+  persistActivity() {
+    this.storage.set(SESSION_TS_KEY, String(this.lastActivityAt));
+    this.lastPersistedAt = Date.now();
+  }
 };
 
 // src/transport.ts
@@ -968,6 +1003,8 @@ var tell = {
     });
     sessionManager = new SessionManager({
       timeout: resolvedConfig.sessionTimeout,
+      maxLength: resolvedConfig.maxSessionLength,
+      storage,
       onNewSession
     });
     if (typeof window !== "undefined") {
@@ -987,7 +1024,7 @@ var tell = {
         if (event.lineno) data.lineno = event.lineno;
         if (event.colno) data.colno = event.colno;
         if (event.error?.stack) data.stack = event.error.stack;
-        tell.logError(msg, "browser", data);
+        tell.logError(msg, data);
       };
       rejectionHandler = (event) => {
         if (_disabled || _optedOut || closed) return;
@@ -995,7 +1032,7 @@ var tell = {
         const msg = reason instanceof Error ? reason.message : String(reason ?? "Unhandled promise rejection");
         const data = {};
         if (reason instanceof Error && reason.stack) data.stack = reason.stack;
-        tell.logError(msg, "browser", data);
+        tell.logError(msg, data);
       };
       window.addEventListener("error", errorHandler);
       window.addEventListener("unhandledrejection", rejectionHandler);
@@ -1188,9 +1225,9 @@ var tell = {
   // -----------------------------------------------------------------------
   // Logging
   // -----------------------------------------------------------------------
-  log(level, message, service, data) {
+  log(level, message, data) {
     if (!configured) {
-      queue.push({ method: "log", args: [level, message, service, data] });
+      queue.push({ method: "log", args: [level, message, data] });
       return;
     }
     if (_disabled || _optedOut) return;
@@ -1208,7 +1245,7 @@ var tell = {
       level,
       message,
       source: resolvedConfig.source,
-      service: service ?? resolvedService,
+      service: resolvedService,
       session_id: sessionManager.sessionId,
       timestamp: Date.now(),
       data
@@ -1219,32 +1256,32 @@ var tell = {
     }
     logBatcher.add(logEntry);
   },
-  logEmergency(message, service, data) {
-    tell.log("emergency", message, service, data);
+  logEmergency(message, data) {
+    tell.log("emergency", message, data);
   },
-  logAlert(message, service, data) {
-    tell.log("alert", message, service, data);
+  logAlert(message, data) {
+    tell.log("alert", message, data);
   },
-  logCritical(message, service, data) {
-    tell.log("critical", message, service, data);
+  logCritical(message, data) {
+    tell.log("critical", message, data);
   },
-  logError(message, service, data) {
-    tell.log("error", message, service, data);
+  logError(message, data) {
+    tell.log("error", message, data);
   },
-  logWarning(message, service, data) {
-    tell.log("warning", message, service, data);
+  logWarning(message, data) {
+    tell.log("warning", message, data);
   },
-  logNotice(message, service, data) {
-    tell.log("notice", message, service, data);
+  logNotice(message, data) {
+    tell.log("notice", message, data);
   },
-  logInfo(message, service, data) {
-    tell.log("info", message, service, data);
+  logInfo(message, data) {
+    tell.log("info", message, data);
   },
-  logDebug(message, service, data) {
-    tell.log("debug", message, service, data);
+  logDebug(message, data) {
+    tell.log("debug", message, data);
   },
-  logTrace(message, service, data) {
-    tell.log("trace", message, service, data);
+  logTrace(message, data) {
+    tell.log("trace", message, data);
   },
   // -----------------------------------------------------------------------
   // Super Properties