humanbehavior-js 0.4.23 → 0.4.25

package/dist/cjs/index.cjs

@@ -12908,6 +12908,8 @@ class RedactionManager {
     constructor(options) {
         this.redactedText = '[REDACTED]';
         this.unredactedFields = new Set(); // Fields that user wants to unredact
+        this.redactedFields = new Set(); // Fields that user wants to redact
+        this.redactionMode = 'privacy-first';
         this.excludeSelectors = [
             '[data-no-redact="true"]',
             '.human-behavior-no-redact'
@@ -12918,10 +12920,56 @@ class RedactionManager {
         if (options === null || options === void 0 ? void 0 : options.excludeSelectors) {
             this.excludeSelectors = [...this.excludeSelectors, ...options.excludeSelectors];
         }
+        // Handle new redaction strategy
+        if (options === null || options === void 0 ? void 0 : options.redactionStrategy) {
+            this.redactionMode = options.redactionStrategy.mode;
+            if (this.redactionMode === 'privacy-first') {
+                // Privacy-first: everything redacted by default, unredact specific fields
+                if (options.redactionStrategy.unredactFields) {
+                    this.setFieldsToUnredact(options.redactionStrategy.unredactFields);
+                }
+            }
+            else {
+                // Visibility-first: everything visible by default, redact specific fields
+                if (options.redactionStrategy.redactFields) {
+                    this.setFieldsToRedact(options.redactionStrategy.redactFields);
+                }
+            }
+        }
+        // Handle legacy redactFields (backward compatibility)
+        if (options === null || options === void 0 ? void 0 : options.legacyRedactFields) {
+            this.setFieldsToUnredact(options.legacyRedactFields);
+        }
+        // Handle legacy userFields
         if (options === null || options === void 0 ? void 0 : options.userFields) {
             this.setFieldsToUnredact(options.userFields);
         }
     }
+    /**
+     * Set specific fields to be redacted (for visibility-first mode)
+     * @param fields Array of CSS selectors for fields to redact
+     */
+    setFieldsToRedact(fields) {
+        this.redactedFields.clear();
+        // Always include password fields in redacted list
+        const passwordFields = [
+            'input[type="password"]',
+            'input[type="password" i]',
+            '[type="password"]',
+            '[type="password" i]'
+        ];
+        // Add password fields and user-specified fields
+        [...passwordFields, ...fields].forEach(field => {
+            this.redactedFields.add(field);
+        });
+        if (this.redactedFields.size > 0) {
+            logDebug(`Redaction: Active for ${this.redactedFields.size} field(s):`, Array.from(this.redactedFields));
+        }
+        else {
+            logDebug('Redaction: No fields to redact');
+        }
+        this.applyRedactionClasses();
+    }
     /**
      * Set specific fields to be unredacted (everything else stays redacted by rrweb)
      * @param fields Array of CSS selectors for fields to unredact
@@ -12976,6 +13024,12 @@ class RedactionManager {
     hasUnredactedFields() {
         return this.unredactedFields.size > 0;
     }
+    /**
+     * Get the current redaction mode
+     */
+    getRedactionMode() {
+        return this.redactionMode;
+    }
     /**
      * Get the currently unredacted fields
      */
@@ -12987,30 +13041,42 @@ class RedactionManager {
      * Returns null if no fields are unredacted (everything stays redacted)
      */
     getMaskTextSelector() {
-        if (this.unredactedFields.size === 0) {
-            return null; // Everything stays redacted
+        if (this.redactionMode === 'privacy-first') {
+            // Privacy-first: mask everything except unredacted fields
+            if (this.unredactedFields.size === 0) {
+                return null; // Everything stays redacted
+            }
+            return Array.from(this.unredactedFields).join(',');
+        }
+        else {
+            // Visibility-first: mask only redacted fields
+            if (this.redactedFields.size === 0) {
+                return null; // Nothing to redact
+            }
+            return Array.from(this.redactedFields).join(',');
         }
-        return Array.from(this.unredactedFields).join(',');
     }
     /**
-     * Check if an element should be unredacted
+     * Apply redaction classes to DOM elements (for visibility-first mode)
+     * Adds 'rr-mask' class to elements that should be redacted
      */
-    shouldUnredactElement(element) {
-        if (this.unredactedFields.size === 0) {
-            return false; // Nothing unredacted
+    applyRedactionClasses() {
+        if (this.redactedFields.size === 0) {
+            return;
         }
-        // Check if any selector matches this element
-        for (const selector of this.unredactedFields) {
+        // Add 'rr-mask' class to redacted elements
+        this.redactedFields.forEach(selector => {
             try {
-                if (element.matches(selector)) {
-                    return true;
-                }
+                const elements = document.querySelectorAll(selector);
+                elements.forEach(element => {
+                    element.classList.add('rr-mask');
+                });
+                logDebug(`Added rr-mask class to ${elements.length} element(s) for selector: ${selector}`);
             }
             catch (e) {
                 logWarn(`Invalid selector: ${selector}`);
             }
-        }
-        return false;
+        });
     }
     /**
      * Apply unredaction classes to DOM elements
@@ -13068,6 +13134,47 @@ class RedactionManager {
     isElementUnredacted(element) {
         return this.shouldUnredactElement(element);
     }
+    /**
+     * Check if an element should be unredacted
+     */
+    shouldUnredactElement(element) {
+        if (this.redactionMode === 'privacy-first') {
+            // Privacy-first: check if element is in unredacted fields
+            if (this.unredactedFields.size === 0) {
+                return false; // Nothing unredacted
+            }
+            // Check if any selector matches this element
+            for (const selector of this.unredactedFields) {
+                try {
+                    if (element.matches(selector)) {
+                        return true;
+                    }
+                }
+                catch (e) {
+                    logWarn(`Invalid selector: ${selector}`);
+                }
+            }
+            return false;
+        }
+        else {
+            // Visibility-first: check if element is NOT in redacted fields
+            if (this.redactedFields.size === 0) {
+                return true; // Nothing redacted, everything visible
+            }
+            // Check if any selector matches this element
+            for (const selector of this.redactedFields) {
+                try {
+                    if (element.matches(selector)) {
+                        return false; // Element is redacted
+                    }
+                }
+                catch (e) {
+                    logWarn(`Invalid selector: ${selector}`);
+                }
+            }
+            return true; // Element is not redacted
+        }
+    }
 }
 // Export a default instance
 const redactionManager = new RedactionManager();
@@ -13635,10 +13742,23 @@ class HumanBehaviorTracker {
         });
         // Store canvas recording preference
         tracker.recordCanvas = (_a = options === null || options === void 0 ? void 0 : options.recordCanvas) !== null && _a !== void 0 ? _a : false;
-        // Set unredacted fields if specified
+        // Set unredacted fields if specified (legacy support)
         if (options === null || options === void 0 ? void 0 : options.redactFields) {
             tracker.setUnredactedFields(options.redactFields);
         }
+        // Handle new redaction strategy
+        if (options === null || options === void 0 ? void 0 : options.redactionStrategy) {
+            if (options.redactionStrategy.mode === 'privacy-first') {
+                if (options.redactionStrategy.unredactFields) {
+                    tracker.setUnredactedFields(options.redactionStrategy.unredactFields);
+                }
+            }
+            else {
+                if (options.redactionStrategy.redactFields) {
+                    tracker.setRedactedFields(options.redactionStrategy.redactFields);
+                }
+            }
+        }
         // Setup automatic tracking if enabled
         if ((options === null || options === void 0 ? void 0 : options.enableAutomaticTracking) !== false) {
             tracker.setupAutomaticTracking(options === null || options === void 0 ? void 0 : options.automaticTrackingOptions);
@@ -13684,7 +13804,10 @@ class HumanBehaviorTracker {
             ingestionUrl: ingestionUrl || defaultIngestionUrl
         });
         this.apiKey = apiKey;
-        this.redactionManager = new RedactionManager();
+        this.redactionManager = new RedactionManager({
+            redactionStrategy: options === null || options === void 0 ? void 0 : options.redactionStrategy,
+            legacyRedactFields: options === null || options === void 0 ? void 0 : options.redactFields // For backward compatibility
+        });
         // Initialize property manager
         this.propertyManager = new PropertyManager({
             enableAutomaticProperties: (options === null || options === void 0 ? void 0 : options.enableAutomaticProperties) !== false,
@@ -14262,6 +14385,31 @@ class HumanBehaviorTracker {
             if (!userResponse.ok) {
                 throw new Error(`Failed to identify user: ${userResponse.statusText}`);
             }
+            // Get IP info and GeoIP data
+            try {
+                const ipResponse = yield fetch(`${this.api['baseUrl']}/api/ingestion/ip-info`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${this.apiKey}`
+                    },
+                    body: JSON.stringify({
+                        sessionId: this.sessionId,
+                        clientIP: null, // Let server detect from headers
+                        ipDetectionMethod: 'headers',
+                        timestamp: new Date().toISOString()
+                    })
+                });
+                if (ipResponse.ok) {
+                    logDebug('✅ IP info and GeoIP data retrieved successfully');
+                }
+                else {
+                    logDebug(`⚠️ IP info request failed: ${ipResponse.statusText}`);
+                }
+            }
+            catch (error) {
+                logDebug(`⚠️ IP info request error: ${error}`);
+            }
             // Don't update endUserId - keep it as the original UUID
             return originalEndUserId || '';
         });
@@ -14301,7 +14449,7 @@ class HumanBehaviorTracker {
                     // ✅ HUMANBEHAVIOR'S CUSTOM SETTINGS
                     maskTextSelector: this.redactionManager.getMaskTextSelector() || undefined,
                     maskTextFn: undefined,
-                    maskAllInputs: true, // HumanBehavior default
+                    maskAllInputs: this.redactionManager.getRedactionMode() === 'privacy-first', // Configurable based on strategy
                     maskInputOptions: { password: true }, // HumanBehavior default
                     maskInputFn: undefined,
                     slimDOMOptions: {},
@@ -14610,6 +14758,17 @@ class HumanBehaviorTracker {
             this.redactionManager = new RedactionManager(options);
         });
     }
+    /**
+     * Set specific fields to be redacted (for visibility-first mode)
+     * @param fields Array of CSS selectors for fields to redact
+     */
+    setRedactedFields(fields) {
+        this.redactionManager.setFieldsToRedact(fields);
+        // ✅ RESTART RECORDING WITH NEW SETTINGS - Ensures redaction is applied
+        if (this.recordInstance) {
+            this.restartWithNewRedaction();
+        }
+    }
     /**
      * Set specific fields to be unredacted (everything else stays redacted by rrweb)
      * @param fields Array of CSS selectors for fields to unredact (e.g., ['#username', '#comment'])