humanbehavior-js 0.4.23 → 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,24 @@ export class HumanBehaviorTracker {
         // Store canvas recording preference
         tracker.recordCanvas = options?.recordCanvas ?? false;
         
-        // Set unredacted fields if specified
+        // Set unredacted fields if specified (legacy support)
         if (options?.redactFields) {
             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
         if (options?.enableAutomaticTracking !== false) {
             tracker.setupAutomaticTracking(options?.automaticTrackingOptions);
@@ -181,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');
@@ -195,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({
@@ -878,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 || '';
@@ -921,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: {},
@@ -1240,6 +1292,19 @@ export 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
+     */
+    public setRedactedFields(fields: string[]): void {
+        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'])

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') {