@tracelog/lib 2.5.0 → 2.5.1-rc.89.5

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