humanbehavior-js 0.4.28 → 0.5.0

package/src/utils/property-manager.ts

@@ -1,274 +0,0 @@
-/**
- * Property Manager for HumanBehavior SDK
- * Handles automatic properties, session properties, and user properties
- */
-
-import { getAutomaticProperties, getInitialProperties, getCurrentPageProperties, AutomaticProperties } from './property-detector';
-
-export interface Properties {
-    [key: string]: any;
-}
-
-export interface PropertyManagerConfig {
-    enableAutomaticProperties?: boolean;
-    enableSessionProperties?: boolean;
-    enableUserProperties?: boolean;
-    propertyDenylist?: string[];
-}
-
-export class PropertyManager {
-    private config: PropertyManagerConfig;
-    private automaticProperties: AutomaticProperties;
-    private sessionProperties: Properties = {};
-    private userProperties: Properties = {};
-    private initialProperties: Properties = {};
-    private isInitialized: boolean = false;
-
-    constructor(config: PropertyManagerConfig = {}) {
-        this.config = {
-            enableAutomaticProperties: true,
-            enableSessionProperties: true,
-            enableUserProperties: true,
-            propertyDenylist: [],
-            ...config
-        };
-        
-        this.automaticProperties = getAutomaticProperties();
-        this.initialize();
-    }
-
-    /**
-     * Initialize the property manager
-     */
-    private initialize(): void {
-        if (this.isInitialized) return;
-        
-        // Capture initial properties once
-        this.initialProperties = getInitialProperties();
-        
-        // Load session properties from sessionStorage
-        this.loadSessionProperties();
-        
-        this.isInitialized = true;
-    }
-
-    /**
-     * Get all properties for an event
-     */
-    public getEventProperties(eventProperties: Properties = {}): Properties {
-        const properties: Properties = { ...eventProperties };
-
-        // Add automatic properties
-        if (this.config.enableAutomaticProperties) {
-            Object.assign(properties, this.getAutomaticProperties());
-        }
-
-        // Add session properties
-        if (this.config.enableSessionProperties) {
-            Object.assign(properties, this.sessionProperties);
-        }
-
-        // Add user properties
-        if (this.config.enableUserProperties) {
-            Object.assign(properties, this.userProperties);
-        }
-
-        // Add initial properties (only once per session)
-        if (!this.sessionProperties['$initial_properties_captured']) {
-            Object.assign(properties, this.initialProperties);
-            this.setSessionProperty('$initial_properties_captured', true);
-        }
-
-        // Apply denylist
-        this.applyDenylist(properties);
-
-        return properties;
-    }
-
-    /**
-     * Get automatic properties
-     */
-    public getAutomaticProperties(): Properties {
-        return {
-            ...this.automaticProperties,
-            ...getCurrentPageProperties() // Always get fresh page properties
-        };
-    }
-
-    /**
-     * Get automatic properties with GeoIP data merged in
-     */
-    public getAutomaticPropertiesWithGeoIP(geoIPProperties: Record<string, any> = {}): Properties {
-        return {
-            ...this.automaticProperties,
-            ...getCurrentPageProperties(), // Always get fresh page properties
-            ...geoIPProperties
-        };
-    }
-
-    /**
-     * Set a session property
-     */
-    public setSessionProperty(key: string, value: any): void {
-        this.sessionProperties[key] = value;
-        this.saveSessionProperties();
-    }
-
-    /**
-     * Set multiple session properties
-     */
-    public setSessionProperties(properties: Properties): void {
-        Object.assign(this.sessionProperties, properties);
-        this.saveSessionProperties();
-    }
-
-    /**
-     * Get a session property
-     */
-    public getSessionProperty(key: string): any {
-        return this.sessionProperties[key];
-    }
-
-    /**
-     * Remove a session property
-     */
-    public removeSessionProperty(key: string): void {
-        delete this.sessionProperties[key];
-        this.saveSessionProperties();
-    }
-
-    /**
-     * Set a user property
-     */
-    public setUserProperty(key: string, value: any): void {
-        this.userProperties[key] = value;
-    }
-
-    /**
-     * Set multiple user properties
-     */
-    public setUserProperties(properties: Properties): void {
-        Object.assign(this.userProperties, properties);
-    }
-
-    /**
-     * Get a user property
-     */
-    public getUserProperty(key: string): any {
-        return this.userProperties[key];
-    }
-
-    /**
-     * Remove a user property
-     */
-    public removeUserProperty(key: string): void {
-        delete this.userProperties[key];
-    }
-
-    /**
-     * Set a property only if it hasn't been set before
-     */
-    public setOnce(key: string, value: any, scope: 'session' | 'user' = 'user'): void {
-        if (scope === 'session') {
-            if (!(key in this.sessionProperties)) {
-                this.setSessionProperty(key, value);
-            }
-        } else {
-            if (!(key in this.userProperties)) {
-                this.setUserProperty(key, value);
-            }
-        }
-    }
-
-    /**
-     * Clear all session properties
-     */
-    public clearSessionProperties(): void {
-        this.sessionProperties = {};
-        this.saveSessionProperties();
-    }
-
-    /**
-     * Clear all user properties
-     */
-    public clearUserProperties(): void {
-        this.userProperties = {};
-    }
-
-    /**
-     * Reset all properties
-     */
-    public reset(): void {
-        this.clearSessionProperties();
-        this.clearUserProperties();
-        this.initialProperties = {};
-        this.isInitialized = false;
-        this.initialize();
-    }
-
-    /**
-     * Load session properties from sessionStorage
-     */
-    private loadSessionProperties(): void {
-        if (typeof sessionStorage === 'undefined') return;
-        
-        try {
-            const stored = sessionStorage.getItem('hb_session_properties');
-            if (stored) {
-                this.sessionProperties = JSON.parse(stored);
-            }
-        } catch (error) {
-            console.warn('Failed to load session properties:', error);
-        }
-    }
-
-    /**
-     * Save session properties to sessionStorage
-     */
-    private saveSessionProperties(): void {
-        if (typeof sessionStorage === 'undefined') return;
-        
-        try {
-            sessionStorage.setItem('hb_session_properties', JSON.stringify(this.sessionProperties));
-        } catch (error) {
-            console.warn('Failed to save session properties:', error);
-        }
-    }
-
-    /**
-     * Apply property denylist
-     */
-    private applyDenylist(properties: Properties): void {
-        if (!this.config.propertyDenylist || this.config.propertyDenylist.length === 0) {
-            return;
-        }
-
-        this.config.propertyDenylist.forEach(deniedKey => {
-            delete properties[deniedKey];
-        });
-    }
-
-    /**
-     * Update automatic properties (call when page changes)
-     */
-    public updateAutomaticProperties(): void {
-        this.automaticProperties = getAutomaticProperties();
-    }
-
-    /**
-     * Get all properties for debugging
-     */
-    public getAllProperties(): {
-        automatic: Properties;
-        session: Properties;
-        user: Properties;
-        initial: Properties;
-    } {
-        return {
-            automatic: this.getAutomaticProperties(),
-            session: { ...this.sessionProperties },
-            user: { ...this.userProperties },
-            initial: { ...this.initialProperties }
-        };
-    }
-}

package/src/vue/index.ts

@@ -1,29 +0,0 @@
-import { HumanBehaviorTracker } from '../index.js';
-import type { App } from 'vue';
-
-interface HumanBehaviorPluginOptions {
-  apiKey: string;
-  ingestionUrl?: string;
-  logLevel?: 'none' | 'error' | 'warn' | 'info' | 'debug';
-  redactFields?: string[];
-  suppressConsoleErrors?: boolean;
-  recordCanvas?: boolean; // Enable canvas recording with protection
-}
-
-export const HumanBehaviorPlugin = {
-  install: (app: App, options: HumanBehaviorPluginOptions) => {
-    const tracker = HumanBehaviorTracker.init(options.apiKey, {
-      ingestionUrl: options.ingestionUrl,
-      logLevel: options.logLevel,
-      redactFields: options.redactFields,
-      suppressConsoleErrors: options.suppressConsoleErrors,
-      recordCanvas: options.recordCanvas, // Pass canvas recording option
-    });
-    
-    // Make tracker available globally
-    app.config.globalProperties.$humanBehavior = tracker;
-    
-    // Also provide it via inject/provide
-    app.provide('humanBehavior', tracker);
-  }
-}; 

package/src/wizard/README.md

@@ -1,114 +0,0 @@
-# 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.