@tracelog/lib 2.5.1 → 2.6.0

package/README.md

@@ -131,6 +131,7 @@ tracelog.destroy();
 | `setCustomHeaders(provider)` | Add custom HTTP headers to requests (see [Custom Headers](#custom-headers)) |
 | `removeCustomHeaders()` | Remove custom headers provider |
 | `isInitialized()` | Check initialization status |
+| `getSessionId()` | Get current session ID (or null) |
 | `setQaMode(enabled)` | Enable/disable QA mode (console logging) |
 | `destroy()` | Stop tracking and cleanup |
 
@@ -879,6 +880,24 @@ await tracelog.init({ /* same config */ });
 
 **→ [Full Error Handling Reference](./API_REFERENCE.md#error-handling)**
 
+### Session Continuity (External Redirects)
+
+TraceLog automatically preserves sessions across external redirects (payment processors, OAuth flows, etc.) with zero developer action. Session data is mirrored to `sessionStorage` alongside `localStorage`, so when a user returns from an external site and `localStorage` is empty, the session is recovered from `sessionStorage` transparently.
+
+```typescript
+// No special handling needed before redirect
+window.location.href = paymentUrl;
+
+// On the confirmation page, init() automatically recovers the session
+const { sessionId } = await tracelog.init({ /* same config */ });
+tracelog.event('purchase', { orderId: '12345', amount: 99.99 });
+// Same session as before the redirect
+```
+
+- Automatic: no API calls or developer action required
+- `sessionStorage` mirror survives same-tab navigation (cleared on tab close)
+- Session timeout still applies (expired sessions are not recovered)
+
 ---
 
 ## Privacy & Security

package/dist/browser/tracelog.esm.js

@@ -290,7 +290,7 @@ const Ot = () => {
     default:
       return We;
   }
-}, Bt = 1e3, Wt = 50, Gt = "2.5.0", Xt = Gt, nt = () => typeof window < "u" && typeof sessionStorage < "u", Qt = () => {
+}, Bt = 1e3, Wt = 50, Gt = "2.5.1", Xt = Gt, nt = () => typeof window < "u" && typeof sessionStorage < "u", Qt = () => {
   try {
     const s = new URLSearchParams(window.location.search);
     s.delete(Je);
@@ -2857,18 +2857,28 @@ class Er extends w {
   }
   loadStoredSession() {
     const e = this.getSessionStorageKey(), t = this.storageManager.getItem(e);
-    if (!t)
-      return null;
-    try {
-      const r = JSON.parse(t);
-      return !r.id || typeof r.lastActivity != "number" ? null : r;
-    } catch {
-      return this.storageManager.removeItem(e), null;
-    }
+    if (t !== null)
+      try {
+        const n = JSON.parse(t);
+        if (n.id && typeof n.lastActivity == "number")
+          return n;
+      } catch {
+        this.storageManager.removeItem(e);
+      }
+    const r = this.storageManager.getSessionItem(e);
+    if (r !== null)
+      try {
+        const n = JSON.parse(r);
+        if (n.id && typeof n.lastActivity == "number")
+          return n;
+      } catch {
+        this.storageManager.removeSessionItem(e);
+      }
+    return null;
   }
   saveStoredSession(e) {
-    const t = this.getSessionStorageKey();
-    this.storageManager.setItem(t, JSON.stringify(e));
+    const t = this.getSessionStorageKey(), r = JSON.stringify(e);
+    this.storageManager.setItem(t, r), this.storageManager.setSessionItem(t, r);
   }
   getSessionStorageKey() {
     return wt(this.getProjectId());
@@ -2896,7 +2906,8 @@ class Er extends w {
    * 11. Sets up lifecycle listeners (visibilitychange, beforeunload)
    *
    * **Session Recovery**:
-   * - Checks localStorage for existing session
+   * - Checks localStorage for existing session (primary)
+   * - Falls back to sessionStorage mirror (survives external redirects)
    * - Recovers if session exists and is recent (within timeout window)
    * - NO SESSION_START event if session recovered
    *