humanbehavior-js 0.2.6 → 0.2.8

package/dist/cjs/index.js

@@ -4960,6 +4960,9 @@ class HumanBehaviorTracker {
         this.originalReplaceState = null;
         this.navigationListeners = [];
         this._connectionBlocked = false;
+        this.recordInstance = null;
+        this.frequencyUpdateInterval = null;
+        this.sessionStartTime = Date.now();
         if (!apiKey) {
             throw new Error('Human Behavior API Key is required');
         }
@@ -5518,8 +5521,33 @@ class HumanBehaviorTracker {
             }, this.FLUSH_INTERVAL_MS);
             // Enable console tracking
             this.enableConsoleTracking();
-            // Start recording with redaction enabled
-            record({
+            // Adaptive snapshot configuration based on session duration
+            const sessionStartTime = Date.now();
+            let snapshotInterval = 5000; // Start with 5 seconds
+            let eventThreshold = 100; // Start with 100 events
+            // Function to update snapshot frequency based on session duration
+            const updateSnapshotFrequency = () => {
+                const sessionDuration = Date.now() - sessionStartTime;
+                const thirtyMinutes = 30 * 60 * 1000;
+                const twoHours = 2 * 60 * 60 * 1000;
+                if (sessionDuration > twoHours) {
+                    // After 2 hours, very infrequent snapshots
+                    snapshotInterval = 30000; // 30 seconds
+                    eventThreshold = 500; // 500 events
+                    logDebug('Reduced snapshot frequency: 30s/500 events (2+ hours)');
+                }
+                else if (sessionDuration > thirtyMinutes) {
+                    // After 30 minutes, moderate frequency
+                    snapshotInterval = 15000; // 15 seconds
+                    eventThreshold = 300; // 300 events
+                    logDebug('Reduced snapshot frequency: 15s/300 events (30+ minutes)');
+                }
+                // First 30 minutes: 5s/100 events (default)
+            };
+            // Update frequency every 5 minutes
+            const frequencyUpdateInterval = setInterval(updateSnapshotFrequency, 5 * 60 * 1000);
+            // Start recording with adaptive redaction enabled
+            const recordInstance = record({
                 emit: (event) => {
                     // Add additional validation for FullSnapshot events
                     if (event.type === 2) { // FullSnapshot event
@@ -5546,10 +5574,13 @@ class HumanBehaviorTracker {
                 blockClass: 'rr-block',
                 ignoreClass: 'rr-ignore',
                 maskTextClass: 'rr-ignore',
-                // Add more robust configuration
-                checkoutEveryNms: 5000, // Take full snapshot every 5 seconds
-                checkoutEveryNth: 100 // Take full snapshot every 100 events
+                // Adaptive configuration
+                checkoutEveryNms: snapshotInterval,
+                checkoutEveryNth: eventThreshold
             });
+            // Store the record instance and interval for cleanup
+            this.recordInstance = recordInstance;
+            this.frequencyUpdateInterval = frequencyUpdateInterval;
         });
     }
     stop() {
@@ -5561,6 +5592,16 @@ class HumanBehaviorTracker {
                 clearInterval(this.flushInterval);
                 this.flushInterval = null;
             }
+            // Cleanup adaptive snapshot intervals
+            if (this.frequencyUpdateInterval) {
+                clearInterval(this.frequencyUpdateInterval);
+                this.frequencyUpdateInterval = null;
+            }
+            // Stop rrweb recording
+            if (this.recordInstance) {
+                this.recordInstance();
+                this.recordInstance = null;
+            }
             // Disable console tracking
             this.disableConsoleTracking();
             // Cleanup navigation tracking
@@ -5722,8 +5763,9 @@ class HumanBehaviorTracker {
         }
     }
     /**
-     * Log out the current user by clearing all user-related data
-     * This will delete the user ID cookie, clear localStorage, and reset user properties
+     * Clear user data and reset session when user signs out of the site
+     * This should be called when a user logs out of your application to prevent
+     * data contamination between different users
      */
     logout() {
         if (!isBrowser)
@@ -5738,7 +5780,13 @@ class HumanBehaviorTracker {
             // Reset user-related properties
             this.endUserId = null;
             this.userProperties = {};
-            logInfo('User logged out - cleared all user data and cookies');
+            // Generate a new session ID for the next user
+            this.sessionId = v1();
+            if (isBrowser) {
+                localStorage.setItem('human_behavior_session_id', this.sessionId);
+                localStorage.setItem('human_behavior_last_activity', Date.now().toString());
+            }
+            logInfo('User logged out - cleared all user data and started fresh session');
         }
         catch (error) {
             logError('Error during logout:', error);
@@ -5794,6 +5842,33 @@ class HumanBehaviorTracker {
     getCurrentUrl() {
         return this.currentUrl;
     }
+    /**
+     * Get current snapshot frequency info
+     */
+    getSnapshotFrequencyInfo() {
+        const sessionDuration = Date.now() - this.sessionStartTime;
+        const thirtyMinutes = 30 * 60 * 1000;
+        const twoHours = 2 * 60 * 60 * 1000;
+        let phase = 'initial';
+        let interval = 5000;
+        let threshold = 100;
+        if (sessionDuration > twoHours) {
+            phase = 'extended';
+            interval = 30000;
+            threshold = 500;
+        }
+        else if (sessionDuration > thirtyMinutes) {
+            phase = 'moderate';
+            interval = 15000;
+            threshold = 300;
+        }
+        return {
+            sessionDuration,
+            currentInterval: interval,
+            currentThreshold: threshold,
+            phase
+        };
+    }
     /**
      * Test if the tracker can reach the ingestion server
      */
@@ -5866,6 +5941,47 @@ if (isBrowser) {
     window.HumanBehaviorTracker = HumanBehaviorTracker;
 }
 
+/**
+ * Server-side utilities for HumanBehavior SDK
+ */
+/**
+ * Identify user from server-side (NextAuth, Firebase, etc.)
+ * Use this in your auth events to track users immediately on sign-in
+ */
+function identifyUser(userData, apiKey) {
+    return __awaiter$1(this, void 0, void 0, function* () {
+        try {
+            const response = yield fetch('https://ingest.humanbehavior.co/api/ingestion/user', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${apiKey}`
+                },
+                body: JSON.stringify({
+                    userId: userData.email,
+                    userAttributes: userData,
+                    sessionId: null, // Will be set by client-side session recording
+                    posthogName: userData.email || userData.name || null // Update posthogName with email
+                })
+            });
+            if (!response.ok) {
+                const errorText = yield response.text();
+                return {
+                    success: false,
+                    error: `Failed to identify user: ${response.status} ${response.statusText} - ${errorText}`
+                };
+            }
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    });
+}
+
 /**
  * Main entry point for the HumanBehavior SDK
  */
@@ -5879,6 +5995,7 @@ exports.HumanBehaviorTracker = HumanBehaviorTracker;
 exports.MAX_CHUNK_SIZE_BYTES = MAX_CHUNK_SIZE_BYTES;
 exports.RedactionManager = RedactionManager;
 exports.default = HumanBehaviorTracker;
+exports.identifyUser = identifyUser;
 exports.isChunkSizeExceeded = isChunkSizeExceeded;
 exports.logDebug = logDebug;
 exports.logError = logError;