humanbehavior-js 0.4.6 → 0.4.8

package/rollup.config.js

@@ -294,7 +294,7 @@ export default [
   
   // CLI bundle
   {
-    input: 'src/cli/auto-install.ts',
+    input: 'src/wizard/cli/auto-install.ts',
     output: {
       file: 'dist/cli/auto-install.js',
       format: 'es',
@@ -314,9 +314,31 @@ export default [
     external: nodeExternal
   },
   
+  // AI CLI bundle
+  {
+    input: 'src/wizard/cli/ai-auto-install.ts',
+    output: {
+      file: 'dist/cli/ai-auto-install.js',
+      format: 'es',
+      sourcemap: true
+    },
+    plugins: [
+      resolve({
+        preferBuiltins: true
+      }),
+      commonjs(),
+      typescript({
+        tsconfig: './tsconfig.json',
+        declaration: false,
+        declarationMap: false
+      })
+    ],
+    external: nodeExternal
+  },
+  
   // Install wizard bundle
   {
-    input: 'src/install-wizard.ts',
+    input: 'src/wizard/core/install-wizard.ts',
     output: [
       {
         file: 'dist/cjs/install-wizard.cjs',
@@ -345,12 +367,52 @@ export default [
   
   // Install wizard types
   {
-    input: 'src/install-wizard.ts',
+    input: 'src/wizard/core/install-wizard.ts',
     output: {
       file: 'dist/types/install-wizard.d.ts',
       format: 'es'
     },
     plugins: [dts()],
     external: nodeExternal
+  },
+  
+  // Wizard module bundle
+  {
+    input: 'src/wizard/index.ts',
+    output: [
+      {
+        file: 'dist/cjs/wizard/index.cjs',
+        format: 'cjs',
+        sourcemap: true
+      },
+      {
+        file: 'dist/esm/wizard/index.js',
+        format: 'es',
+        sourcemap: true
+      }
+    ],
+    plugins: [
+      resolve({
+        preferBuiltins: true
+      }),
+      commonjs(),
+      typescript({
+        tsconfig: './tsconfig.json',
+        declaration: false,
+        declarationMap: false
+      })
+    ],
+    external: nodeExternal
+  },
+  
+  // Wizard module types
+  {
+    input: 'src/wizard/index.ts',
+    output: {
+      file: 'dist/types/wizard/index.d.ts',
+      format: 'es'
+    },
+    plugins: [dts()],
+    external: nodeExternal
   }
 ]; 

package/src/react/AutoInstallWizard.tsx

@@ -1,5 +1,5 @@
 import React, { useState, useEffect } from 'react';
-import { BrowserAutoInstallationWizard } from '../install-wizard';
+import { BrowserAutoInstallationWizard } from '../wizard/core/install-wizard';
 
 interface AutoInstallWizardProps {
   apiKey: string;

package/src/tracker.ts

@@ -1,4 +1,5 @@
 import { record } from '@rrweb/record';
+import type { listenerHandler } from '@rrweb/types';
 import { v1 as uuidv1 } from 'uuid';
 import { HumanBehaviorAPI } from './api';
 import { RedactionManager, RedactionOptions } from './redact';
@@ -45,8 +46,10 @@ export class HumanBehaviorTracker {
     private originalReplaceState: typeof history.replaceState | null = null;
     private navigationListeners: Array<() => void> = [];
     private _connectionBlocked: boolean = false;
-    private recordInstance: any = null;
+    private recordInstance: listenerHandler | null = null;
     private sessionStartTime: number = Date.now();
+    private rrwebRecord: any = null;
+    private fullSnapshotTimeout: number | null = null;
 
     /**
      * Initialize the HumanBehavior tracker
@@ -225,6 +228,9 @@ export class HumanBehaviorTracker {
             
             // Track navigation event
             this.trackNavigationEvent('pushState', this.previousUrl, this.currentUrl);
+            
+            // Take FullSnapshot on navigation
+            this.takeFullSnapshot();
         };
 
         // Override replaceState to capture programmatic navigation
@@ -237,6 +243,9 @@ export class HumanBehaviorTracker {
             
             // Track navigation event
             this.trackNavigationEvent('replaceState', this.previousUrl, this.currentUrl);
+            
+            // Take FullSnapshot on navigation
+            this.takeFullSnapshot();
         };
 
         // Listen for popstate events (back/forward navigation)
@@ -244,6 +253,9 @@ export class HumanBehaviorTracker {
             this.previousUrl = this.currentUrl;
             this.currentUrl = window.location.href;
             this.trackNavigationEvent('popstate', this.previousUrl, this.currentUrl);
+            
+            // Take FullSnapshot on navigation
+            this.takeFullSnapshot();
         };
         
         window.addEventListener('popstate', popstateListener);
@@ -751,8 +763,8 @@ export class HumanBehaviorTracker {
             this.flush();
         }, this.FLUSH_INTERVAL_MS);
 
-        // Enable console tracking
-        this.enableConsoleTracking();
+        // Disable console tracking to reduce event pollution
+        // this.enableConsoleTracking();
 
         // ✅ DOM READY DETECTION
         // Wait for DOM to be ready before starting recording
@@ -760,6 +772,7 @@ export class HumanBehaviorTracker {
             logDebug('🎯 DOM ready, starting session recording');
             
             // ✅ HUMANBEHAVIOR RRWEB CONFIGURATION
+            this.rrwebRecord = record;
             const recordInstance = record({
             emit: (event) => {
                 // ✅ DIRECT EVENT HANDLING - Let rrweb handle events natively
@@ -784,13 +797,12 @@ export class HumanBehaviorTracker {
             // ✅ CANVAS RECORDING - Disabled to prevent large data URIs
             recordCanvas: false, // Disabled to prevent large data URIs
             
-            // ✅ FULLSNAPSHOT GENERATION - Use reasonable intervals
-            // checkoutEveryNms: 300000, // Take FullSnapshot every 5 minutes
-            // checkoutEveryNth: 1000,   // Take FullSnapshot every 1000 events
+            // ✅ FULLSNAPSHOT GENERATION - No periodic snapshots to avoid animation issues
+            // Rely on initial FullSnapshot + navigation-triggered ones only
         });
         
-        // Store the record instance for cleanup
-        this.recordInstance = recordInstance;
+        // Store the record instance for cleanup 
+        this.recordInstance = recordInstance || null;
         };
 
         // ✅ DOM READY DETECTION
@@ -809,6 +821,37 @@ export class HumanBehaviorTracker {
         }
     }
 
+    /**
+     * Manually trigger a FullSnapshot (for navigation events)
+     * Delays snapshot to avoid capturing mid-animation states
+     */
+    private takeFullSnapshot(): void {
+        // Clear any existing timeout to avoid multiple snapshots
+        if (this.fullSnapshotTimeout) {
+            clearTimeout(this.fullSnapshotTimeout);
+        }
+
+        // Delay FullSnapshot to let animations settle
+        this.fullSnapshotTimeout = window.setTimeout(() => {
+            try {
+                // Wait for any pending animations/transitions to complete
+                requestAnimationFrame(() => {
+                    requestAnimationFrame(() => {
+                        // Access takeFullSnapshot from the rrweb record function
+                        if (this.rrwebRecord && typeof this.rrwebRecord.takeFullSnapshot === 'function') {
+                            this.rrwebRecord.takeFullSnapshot();
+                            logDebug('✅ FullSnapshot taken for navigation (delayed for animations)');
+                        } else {
+                            logWarn('⚠️ takeFullSnapshot not available on record function');
+                        }
+                    });
+                });
+            } catch (error) {
+                logError('❌ Failed to take FullSnapshot for navigation:', error);
+            }
+        }, 1000); // Wait 1 second for animations to settle
+    }
+
     public async stop() {
         await this.ensureInitialized();
         if (!isBrowser) return;
@@ -823,6 +866,14 @@ export class HumanBehaviorTracker {
             this.recordInstance();
             this.recordInstance = null;
         }
+        
+        // Clear any pending FullSnapshot timeouts
+        if (this.fullSnapshotTimeout) {
+            clearTimeout(this.fullSnapshotTimeout);
+            this.fullSnapshotTimeout = null;
+        }
+        
+        this.rrwebRecord = null;
 
         // Disable console tracking
         this.disableConsoleTracking();

package/src/wizard/README.md

@@ -0,0 +1,114 @@
+# HumanBehavior SDK Wizard Module
+
+This module provides AI-enhanced auto-installation capabilities for the HumanBehavior SDK.
+
+## 📁 Directory Structure
+
+```
+src/wizard/
+├── core/           # Core installation wizard
+│   └── install-wizard.ts
+├── ai/             # AI-enhanced wizard components
+│   └── ai-install-wizard.ts
+├── cli/            # Command-line interfaces
+│   ├── auto-install.ts
+│   └── ai-auto-install.ts
+├── services/       # AI service implementations
+│   ├── remote-ai-service.ts
+│   └── centralized-ai-service.ts
+├── index.ts        # Main exports
+└── README.md       # This file
+```
+
+## 🚀 Key Components
+
+### Core (`core/`)
+- **`install-wizard.ts`**: Traditional installation wizard
+- Framework detection and code modification
+- Environment variable management
+- Package installation
+
+### AI (`ai/`)
+- **`ai-install-wizard.ts`**: AI-enhanced installation wizard
+- AI-powered framework detection
+- Intelligent code analysis
+- Conflict resolution
+- Learning system
+
+### CLI (`cli/`)
+- **`auto-install.ts`**: Traditional CLI interface
+- **`ai-auto-install.ts`**: AI-enhanced CLI interface
+- User interaction and command parsing
+- Installation mode selection
+
+### Services (`services/`)
+- **`remote-ai-service.ts`**: Connects to deployed Lambda AI service
+- **`centralized-ai-service.ts`**: Local AI service implementation
+- Heuristic fallback when AI is unavailable
+
+## 🔧 Usage
+
+### Traditional Installation
+```typescript
+import { AutoInstallationWizard } from 'humanbehavior-js/wizard';
+
+const wizard = new AutoInstallationWizard(apiKey, projectPath);
+const result = await wizard.install();
+```
+
+### AI-Enhanced Installation
+```typescript
+import { AIEnhancedInstallationWizard, RemoteAIService } from 'humanbehavior-js/wizard';
+
+const aiService = new RemoteAIService({
+  apiEndpoint: 'https://your-lambda-api.execute-api.region.amazonaws.com/prod'
+});
+
+const wizard = new AIEnhancedInstallationWizard(apiKey, projectPath, aiService);
+const result = await wizard.install();
+```
+
+### CLI Usage
+```bash
+# Traditional installation
+npx humanbehavior-js auto-install YOUR_API_KEY
+
+# AI-enhanced installation
+npx humanbehavior-js ai-auto-install YOUR_API_KEY --ai
+```
+
+## 🧠 AI Features
+
+- **Intelligent Framework Detection**: Beyond package.json analysis
+- **Code Pattern Analysis**: Understands project structure and patterns
+- **Conflict Resolution**: Smart handling of existing integrations
+- **Future-Proofing**: Adaptive strategies for new frameworks
+- **Learning System**: Improves over time with usage patterns
+
+## 🔄 Backward Compatibility
+
+All existing imports continue to work:
+- `humanbehavior-js/install-wizard` → `humanbehavior-js/wizard`
+- Traditional wizard functionality unchanged
+- AI features are additive, not breaking
+
+## 🚀 Lambda Deployment
+
+The `lambda-deployment/` directory contains the AI service for AWS Lambda deployment. This is separate from the client-side wizard code and should not be modified unless deploying AI service updates.
+
+### 📁 Lambda Deployment Structure
+```
+lambda-deployment/
+├── index.js                    # Lambda entry point
+├── ai-install-wizard.ts        # AI service implementation  
+├── install-wizard.ts           # Core wizard logic
+├── centralized-ai-service.ts   # AI service interface
+└── README.md                   # Deployment documentation
+```
+
+### 🔗 Client-Server Relationship
+- **Client**: `src/wizard/` - User-facing installation wizard
+- **Server**: `lambda-deployment/` - AI service backend
+- **Connection**: `RemoteAIService` connects client to Lambda
+
+See `lambda-deployment/README.md` for detailed deployment instructions.