humanbehavior-js 0.4.22 → 0.4.24

package/src/tracker.ts

@@ -61,7 +61,12 @@ export class HumanBehaviorTracker {
     public static init(apiKey: string, options?: {
         ingestionUrl?: string;
         logLevel?: 'none' | 'error' | 'warn' | 'info' | 'debug';
-        redactFields?: string[];
+        redactFields?: string[]; // DEPRECATED: Use redactionStrategy instead
+        redactionStrategy?: {
+            mode: 'privacy-first' | 'visibility-first'; // Default: 'privacy-first'
+            unredactFields?: string[]; // Fields to make visible (when mode: 'privacy-first')
+            redactFields?: string[];   // Fields to hide (when mode: 'visibility-first')
+        };
         enableAutomaticTracking?: boolean;
         suppressConsoleErrors?: boolean; // New option to control error suppression
         recordCanvas?: boolean; // Enable canvas recording with protection
@@ -162,11 +167,22 @@ export class HumanBehaviorTracker {
         // Store canvas recording preference
         tracker.recordCanvas = options?.recordCanvas ?? false;
         
-        // Set redacted fields if specified
+        // Set unredacted fields if specified (legacy support)
         if (options?.redactFields) {
-            tracker.setRedactedFields(options.redactFields);
-            // ✅ Apply redaction classes to existing elements
-            tracker.redactionManager.applyRedactionClasses();
+            tracker.setUnredactedFields(options.redactFields);
+        }
+
+        // Handle new redaction strategy
+        if (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
@@ -183,6 +199,12 @@ export class HumanBehaviorTracker {
     constructor(apiKey: string | undefined, ingestionUrl?: string, options?: {
         enableAutomaticProperties?: boolean;
         propertyDenylist?: string[];
+        redactionStrategy?: {
+            mode: 'privacy-first' | 'visibility-first';
+            unredactFields?: string[];
+            redactFields?: string[];
+        };
+        redactFields?: string[]; // Legacy support
     }) {
         if (!apiKey) {
             throw new Error('Human Behavior API Key is required');
@@ -197,7 +219,10 @@ export class HumanBehaviorTracker {
             ingestionUrl: ingestionUrl || defaultIngestionUrl
         });
         this.apiKey = apiKey;
-        this.redactionManager = new RedactionManager();
+        this.redactionManager = new RedactionManager({
+            redactionStrategy: options?.redactionStrategy,
+            legacyRedactFields: options?.redactFields // For backward compatibility
+        });
         
         // Initialize property manager
         this.propertyManager = new PropertyManager({
@@ -880,6 +905,31 @@ export class HumanBehaviorTracker {
             throw new Error(`Failed to identify user: ${userResponse.statusText}`);
         }
         
+        // Get IP info and GeoIP data
+        try {
+            const ipResponse = await 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 || '';
@@ -923,7 +973,7 @@ export 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: {},
@@ -1243,17 +1293,26 @@ export class HumanBehaviorTracker {
     }
 
     /**
-     * Set specific fields to be redacted during session recording
-     * Uses rrweb's built-in masking instead of custom redaction processing
-     * @param fields Array of CSS selectors for fields to redact (e.g., ['input[type="password"]', '#email-field'])
+     * Set specific fields to be redacted (for visibility-first mode)
+     * @param fields Array of CSS selectors for fields to redact
      */
     public setRedactedFields(fields: string[]): void {
         this.redactionManager.setFieldsToRedact(fields);
         
-        // ✅ APPLY RRWEB MASKING CLASSES - More reliable than custom processing
-        this.redactionManager.applyRedactionClasses();
+        // ✅ 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'])
+     */
+    public setUnredactedFields(fields: string[]): void {
+        this.redactionManager.setFieldsToUnredact(fields);
         
-        // ✅ RESTART RECORDING WITH NEW SETTINGS - Ensures masking is applied
+        // ✅ RESTART RECORDING WITH NEW SETTINGS - Ensures unredaction is applied
         if (this.recordInstance) {
             this.restartWithNewRedaction();
         }
@@ -1267,17 +1326,42 @@ export class HumanBehaviorTracker {
     }
 
     /**
-     * Check if redaction is currently active
+     * Check if any fields are currently unredacted
+     */
+    public hasUnredactedFields(): boolean {
+        return this.redactionManager.hasUnredactedFields();
+    }
+
+    /**
+     * Get the currently unredacted fields
      */
-    public isRedactionActive(): boolean {
-        return this.redactionManager.isActive();
+    public getUnredactedFields(): string[] {
+        return this.redactionManager.getUnredactedFields();
     }
 
     /**
-     * Get the currently selected fields for redaction
+     * Remove specific fields from unredaction (they become redacted again)
+     * @param fields Array of CSS selectors for fields to redact
      */
-    public getRedactedFields(): string[] {
-        return this.redactionManager.getSelectedFields();
+    public redactFields(fields: string[]): void {
+        this.redactionManager.redactFields(fields);
+        
+        // ✅ RESTART RECORDING WITH NEW SETTINGS - Ensures redaction is updated
+        if (this.recordInstance) {
+            this.restartWithNewRedaction();
+        }
+    }
+
+    /**
+     * Clear all unredacted fields (everything becomes redacted again)
+     */
+    public clearUnredactedFields(): void {
+        this.redactionManager.clearUnredactedFields();
+        
+        // ✅ RESTART RECORDING WITH NEW SETTINGS - Ensures redaction is updated
+        if (this.recordInstance) {
+            this.restartWithNewRedaction();
+        }
     }
 
     /**

package/src/wizard/core/install-wizard.ts

@@ -299,17 +299,17 @@ export class AutoInstallationWizard {
   }
 
   /**
-   * Install the SDK package
+   * Install the SDK package with latest version range
    */
   protected async installPackage(): Promise<void> {
     const { execSync } = await import('child_process');
     
-    // Build base command
+    // Build base command with latest version range
     let command = this.framework?.packageManager === 'yarn' 
-      ? 'yarn add humanbehavior-js'
+      ? 'yarn add humanbehavior-js@latest'
       : this.framework?.packageManager === 'pnpm'
-      ? 'pnpm add humanbehavior-js'
-      : 'npm install humanbehavior-js';
+      ? 'pnpm add humanbehavior-js@latest'
+      : 'npm install humanbehavior-js@latest';
     
     // Add legacy peer deps flag for npm to handle dependency conflicts
     if (this.framework?.packageManager !== 'yarn' && this.framework?.packageManager !== 'pnpm') {