humanbehavior-js 0.4.7 → 0.4.9

package/src/api.ts

@@ -1,4 +1,4 @@
-import { logError, logInfo, logDebug } from './utils/logger';
+import { logError, logInfo, logDebug, logWarn } from './utils/logger';
 
 export const MAX_CHUNK_SIZE_BYTES = 1024 * 1024; // 1MB chunk size - more conservative
 
@@ -19,7 +19,7 @@ export function validateSingleEventSize(event: any, sessionId: string): void {
 
     if (singleEventSize > MAX_CHUNK_SIZE_BYTES) {
         // Instead of throwing, log a warning and suggest reducing event size
-        console.warn(`Single event size (${singleEventSize} bytes) exceeds maximum chunk size (${MAX_CHUNK_SIZE_BYTES} bytes). Consider reducing event data size.`);
+        logWarn(`Single event size (${singleEventSize} bytes) exceeds maximum chunk size (${MAX_CHUNK_SIZE_BYTES} bytes). Consider reducing event data size.`);
     }
 }
 
@@ -102,7 +102,7 @@ export class HumanBehaviorAPI {
             referrer = document.referrer;
         }
 
-        console.log('API init called with:', { sessionId, userId, entryURL, referrer, baseUrl: this.baseUrl });
+        logInfo('API init called with:', { sessionId, userId, entryURL, referrer, baseUrl: this.baseUrl });
 
         try {
         const response = await fetch(`${this.baseUrl}/api/ingestion/init`, {
@@ -120,22 +120,22 @@ export class HumanBehaviorAPI {
             })
         });
 
-            console.log('API init response status:', response.status);
+            logInfo('API init response status:', response.status);
 
         if (!response.ok) {
                 const errorText = await response.text();
-                console.error('API init failed:', response.status, errorText);
+                logError('API init failed:', response.status, errorText);
                 throw new Error(`Failed to initialize ingestion: ${response.statusText} - ${errorText}`);
         } 
 
         const responseJson = await response.json();
-            console.log('API init success:', responseJson);
+            logInfo('API init success:', responseJson);
         return {
             sessionId: responseJson.sessionId,
             endUserId: responseJson.endUserId
             }
         } catch (error) {
-            console.error('API init error:', error);
+            logError('API init error:', error);
             throw error;
         }
     }
@@ -246,7 +246,7 @@ export class HumanBehaviorAPI {
                 posthogName: userData.email || userData.name || null // Update user name with email
             };
             
-            console.log('Sending user data to server:', payload);
+            logInfo('Sending user data to server:', payload);
             
             const response = await fetch(`${this.baseUrl}/api/ingestion/user`, {
                 method: 'POST',
@@ -262,7 +262,7 @@ export class HumanBehaviorAPI {
             }
             
             const result = await response.json();
-            console.log('Server response:', result);
+            logInfo('Server response:', result);
             return result;
         } catch (error) {
             logError('Error sending user data:', error);

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

@@ -229,7 +229,7 @@ export class HumanBehaviorTracker {
             // Track navigation event
             this.trackNavigationEvent('pushState', this.previousUrl, this.currentUrl);
             
-            // Take FullSnapshot on navigation (like PostHog does)
+            // Take FullSnapshot on navigation
             this.takeFullSnapshot();
         };
 
@@ -244,7 +244,7 @@ export class HumanBehaviorTracker {
             // Track navigation event
             this.trackNavigationEvent('replaceState', this.previousUrl, this.currentUrl);
             
-            // Take FullSnapshot on navigation (like PostHog does)
+            // Take FullSnapshot on navigation
             this.takeFullSnapshot();
         };
 
@@ -254,7 +254,7 @@ export class HumanBehaviorTracker {
             this.currentUrl = window.location.href;
             this.trackNavigationEvent('popstate', this.previousUrl, this.currentUrl);
             
-            // Take FullSnapshot on navigation (like PostHog does)
+            // Take FullSnapshot on navigation
             this.takeFullSnapshot();
         };
         
@@ -718,7 +718,7 @@ export class HumanBehaviorTracker {
     public viewLogs() {
         try {
             const logs = logger.getLogs();
-            console.log('HumanBehavior Logs:', logs);
+            logInfo('HumanBehavior Logs:', logs);
             logger.clearLogs(); // Clear logs after viewing
         } catch (e) {
             logError('Failed to read logs:', e);
@@ -797,9 +797,8 @@ export class HumanBehaviorTracker {
             // ✅ CANVAS RECORDING - Disabled to prevent large data URIs
             recordCanvas: false, // Disabled to prevent large data URIs
             
-            // ✅ FULLSNAPSHOT GENERATION - Following PostHog's approach (no periodic snapshots)
-            // PostHog doesn't use checkoutEveryNms or checkoutEveryNth to avoid animation issues
-            // They rely on initial FullSnapshot + navigation-triggered ones only
+            // ✅ FULLSNAPSHOT GENERATION - No periodic snapshots to avoid animation issues
+            // Rely on initial FullSnapshot + navigation-triggered ones only
         });
         
         // Store the record instance for cleanup 

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.