humanbehavior-js 0.4.6 → 0.4.8

package/dist/types/angular/index.d.ts

@@ -34,6 +34,8 @@ declare class HumanBehaviorTracker {
     private _connectionBlocked;
     private recordInstance;
     private sessionStartTime;
+    private rrwebRecord;
+    private fullSnapshotTimeout;
     /**
      * Initialize the HumanBehavior tracker
      * This is the main entry point - call this once per page
@@ -117,6 +119,11 @@ declare class HumanBehaviorTracker {
      */
     getUserAttributes(): Record<string, any>;
     start(): Promise<void>;
+    /**
+     * Manually trigger a FullSnapshot (for navigation events)
+     * Delays snapshot to avoid capturing mid-animation states
+     */
+    private takeFullSnapshot;
     stop(): Promise<void>;
     /**
      * Add an event to the ingestion queue

package/dist/types/index.d.ts

@@ -124,6 +124,8 @@ declare class HumanBehaviorTracker {
     private _connectionBlocked;
     private recordInstance;
     private sessionStartTime;
+    private rrwebRecord;
+    private fullSnapshotTimeout;
     /**
      * Initialize the HumanBehavior tracker
      * This is the main entry point - call this once per page
@@ -207,6 +209,11 @@ declare class HumanBehaviorTracker {
      */
     getUserAttributes(): Record<string, any>;
     start(): Promise<void>;
+    /**
+     * Manually trigger a FullSnapshot (for navigation events)
+     * Delays snapshot to avoid capturing mid-animation states
+     */
+    private takeFullSnapshot;
     stop(): Promise<void>;
     /**
      * Add an event to the ingestion queue

package/dist/types/install-wizard.d.ts

@@ -6,7 +6,7 @@
  */
 interface FrameworkInfo {
     name: string;
-    type: 'react' | 'vue' | 'angular' | 'svelte' | 'nextjs' | 'nuxt' | 'remix' | 'vanilla' | 'node';
+    type: 'react' | 'vue' | 'angular' | 'svelte' | 'nextjs' | 'nuxt' | 'remix' | 'vanilla' | 'node' | 'auto';
     bundler?: 'vite' | 'webpack' | 'esbuild' | 'rollup';
     packageManager?: 'npm' | 'yarn' | 'pnpm';
     hasTypeScript?: boolean;
@@ -27,9 +27,9 @@ interface InstallationResult {
     nextSteps: string[];
 }
 declare class AutoInstallationWizard {
-    private apiKey;
-    private projectRoot;
-    private framework;
+    protected apiKey: string;
+    protected projectRoot: string;
+    protected framework: FrameworkInfo | null;
     constructor(apiKey: string, projectRoot?: string);
     /**
      * Main installation method - detects framework and auto-installs
@@ -38,15 +38,15 @@ declare class AutoInstallationWizard {
     /**
      * Detect the current framework and project setup
      */
-    private detectFramework;
+    detectFramework(): Promise<FrameworkInfo>;
     /**
      * Install the SDK package
      */
-    private installPackage;
+    protected installPackage(): Promise<void>;
     /**
      * Generate code modifications based on framework
      */
-    private generateModifications;
+    protected generateModifications(): Promise<CodeModification[]>;
     /**
      * Generate React-specific modifications
      */
@@ -82,7 +82,7 @@ declare class AutoInstallationWizard {
     /**
      * Apply modifications to the codebase
      */
-    private applyModifications;
+    protected applyModifications(modifications: CodeModification[]): Promise<void>;
     /**
      * Generate next steps for the user
      */

package/dist/types/react/index.d.ts

@@ -36,6 +36,8 @@ declare class HumanBehaviorTracker {
     private _connectionBlocked;
     private recordInstance;
     private sessionStartTime;
+    private rrwebRecord;
+    private fullSnapshotTimeout;
     /**
      * Initialize the HumanBehavior tracker
      * This is the main entry point - call this once per page
@@ -119,6 +121,11 @@ declare class HumanBehaviorTracker {
      */
     getUserAttributes(): Record<string, any>;
     start(): Promise<void>;
+    /**
+     * Manually trigger a FullSnapshot (for navigation events)
+     * Delays snapshot to avoid capturing mid-animation states
+     */
+    private takeFullSnapshot;
     stop(): Promise<void>;
     /**
      * Add an event to the ingestion queue

package/dist/types/remix/index.d.ts

@@ -37,6 +37,8 @@ declare class HumanBehaviorTracker {
     private _connectionBlocked;
     private recordInstance;
     private sessionStartTime;
+    private rrwebRecord;
+    private fullSnapshotTimeout;
     /**
      * Initialize the HumanBehavior tracker
      * This is the main entry point - call this once per page
@@ -120,6 +122,11 @@ declare class HumanBehaviorTracker {
      */
     getUserAttributes(): Record<string, any>;
     start(): Promise<void>;
+    /**
+     * Manually trigger a FullSnapshot (for navigation events)
+     * Delays snapshot to avoid capturing mid-animation states
+     */
+    private takeFullSnapshot;
     stop(): Promise<void>;
     /**
      * Add an event to the ingestion queue

package/dist/types/svelte/index.d.ts

@@ -34,6 +34,8 @@ declare class HumanBehaviorTracker {
     private _connectionBlocked;
     private recordInstance;
     private sessionStartTime;
+    private rrwebRecord;
+    private fullSnapshotTimeout;
     /**
      * Initialize the HumanBehavior tracker
      * This is the main entry point - call this once per page
@@ -117,6 +119,11 @@ declare class HumanBehaviorTracker {
      */
     getUserAttributes(): Record<string, any>;
     start(): Promise<void>;
+    /**
+     * Manually trigger a FullSnapshot (for navigation events)
+     * Delays snapshot to avoid capturing mid-animation states
+     */
+    private takeFullSnapshot;
     stop(): Promise<void>;
     /**
      * Add an event to the ingestion queue

package/dist/types/wizard/index.d.ts

@@ -0,0 +1,489 @@
+/**
+ * HumanBehavior SDK Auto-Installation Wizard
+ *
+ * This wizard automatically detects the user's framework and modifies their codebase
+ * to integrate the SDK with minimal user intervention.
+ */
+interface FrameworkInfo$2 {
+    name: string;
+    type: 'react' | 'vue' | 'angular' | 'svelte' | 'nextjs' | 'nuxt' | 'remix' | 'vanilla' | 'node' | 'auto';
+    bundler?: 'vite' | 'webpack' | 'esbuild' | 'rollup';
+    packageManager?: 'npm' | 'yarn' | 'pnpm';
+    hasTypeScript?: boolean;
+    hasRouter?: boolean;
+    projectRoot?: string;
+}
+interface CodeModification {
+    filePath: string;
+    action: 'create' | 'modify' | 'append';
+    content: string;
+    description: string;
+}
+interface InstallationResult {
+    success: boolean;
+    framework: FrameworkInfo$2;
+    modifications: CodeModification[];
+    errors: string[];
+    nextSteps: string[];
+}
+declare class AutoInstallationWizard {
+    protected apiKey: string;
+    protected projectRoot: string;
+    protected framework: FrameworkInfo$2 | null;
+    constructor(apiKey: string, projectRoot?: string);
+    /**
+     * Main installation method - detects framework and auto-installs
+     */
+    install(): Promise<InstallationResult>;
+    /**
+     * Detect the current framework and project setup
+     */
+    detectFramework(): Promise<FrameworkInfo$2>;
+    /**
+     * Install the SDK package
+     */
+    protected installPackage(): Promise<void>;
+    /**
+     * Generate code modifications based on framework
+     */
+    protected generateModifications(): Promise<CodeModification[]>;
+    /**
+     * Generate React-specific modifications
+     */
+    private generateReactModifications;
+    /**
+     * Generate Next.js-specific modifications
+     */
+    private generateNextJSModifications;
+    /**
+     * Generate Nuxt-specific modifications
+     */
+    private generateNuxtModifications;
+    /**
+     * Generate Remix-specific modifications
+     */
+    private generateRemixModifications;
+    /**
+     * Generate Vue-specific modifications
+     */
+    private generateVueModifications;
+    /**
+     * Generate Angular-specific modifications
+     */
+    private generateAngularModifications;
+    /**
+     * Generate Svelte-specific modifications
+     */
+    private generateSvelteModifications;
+    /**
+     * Generate vanilla JS/TS modifications
+     */
+    private generateVanillaModifications;
+    /**
+     * Apply modifications to the codebase
+     */
+    protected applyModifications(modifications: CodeModification[]): Promise<void>;
+    /**
+     * Generate next steps for the user
+     */
+    private generateNextSteps;
+    private findReactAppFile;
+    private findVueMainFile;
+    private findSvelteMainFile;
+    private findHTMLFile;
+    private injectReactProvider;
+    private injectNextJSAppRouter;
+    private injectNextJSPagesRouter;
+    private injectRemixProvider;
+    private injectVuePlugin;
+    private injectAngularModule;
+    private injectAngularStandaloneInit;
+    private injectSvelteStore;
+    private injectSvelteKitLayout;
+    private injectVanillaScript;
+    private injectNuxtConfig;
+    /**
+     * Helper method to find the best environment file for a framework
+     */
+    private findBestEnvFile;
+    /**
+     * Helper method to create or append to environment files
+     */
+    private createEnvironmentModification;
+}
+
+/**
+ * AI-Enhanced HumanBehavior SDK Auto-Installation Wizard
+ *
+ * This wizard uses AI to intelligently detect frameworks, analyze code patterns,
+ * and generate optimal integration code that's both future-proof and backward-compatible.
+ *
+ * 🚀 KEY FEATURES:
+ * - AI-powered framework detection beyond package.json
+ * - Intelligent code pattern analysis
+ * - Future-proof integration strategies
+ * - Backward compatibility with legacy frameworks
+ * - Adaptive code generation for new frameworks
+ * - Smart conflict resolution
+ * - Learning from user feedback
+ * - Centralized AI service (no user API keys required)
+ */
+
+interface AICodeAnalysis {
+    framework: FrameworkInfo$2;
+    confidence: number;
+    patterns: string[];
+    conflicts: string[];
+    recommendations: string[];
+    integrationStrategy: 'provider' | 'plugin' | 'module' | 'script' | 'standalone';
+    compatibilityMode: 'modern' | 'legacy' | 'hybrid';
+}
+interface AIInstallationResult extends InstallationResult {
+    aiAnalysis: AICodeAnalysis;
+    learningData: {
+        patterns: string[];
+        framework: string;
+        success: boolean;
+        userFeedback?: string;
+    };
+}
+/**
+ * Centralized AI Service Interface
+ * This runs on your backend infrastructure, not in the user's environment
+ */
+interface CentralizedAIService$1 {
+    analyzeCodePatterns(codeSamples: string[]): Promise<AICodeAnalysis>;
+    resolveConflicts(conflicts: string[], framework: FrameworkInfo$2): Promise<string[]>;
+    generateOptimizations(framework: FrameworkInfo$2, patterns: string[]): Promise<string[]>;
+}
+declare class AIEnhancedInstallationWizard extends AutoInstallationWizard {
+    private aiService;
+    private learningCache;
+    private patternDatabase;
+    constructor(apiKey: string, projectRoot?: string, aiService?: CentralizedAIService$1);
+    /**
+     * AI-enhanced installation with intelligent analysis
+     */
+    install(): Promise<AIInstallationResult>;
+    /**
+     * AI-powered code analysis using centralized service
+     */
+    performAICodeAnalysis(): Promise<AICodeAnalysis>;
+    /**
+     * Scan project files for analysis
+     */
+    private scanProjectFiles;
+    /**
+     * Check if file is relevant for analysis
+     */
+    private isRelevantFile;
+    /**
+     * Extract code samples for AI analysis
+     */
+    private extractCodeSamples;
+    /**
+     * Extract relevant code patterns
+     */
+    private extractCodePatterns;
+    /**
+     * AI-enhanced framework detection
+     */
+    private detectFrameworkWithAI;
+    /**
+     * Generate AI-optimized modifications
+     */
+    private generateAIOptimizedModifications;
+    /**
+     * Enhance modification with AI insights
+     */
+    private enhanceModificationWithAI;
+    /**
+     * Generate AI-specific optimizations
+     */
+    private generateAIOptimizations;
+    /**
+     * Apply modifications with AI conflict resolution
+     */
+    private applyModificationsWithAI;
+    /**
+     * Detect potential conflicts
+     */
+    private detectConflicts;
+    /**
+     * Resolve conflicts with AI
+     */
+    private resolveConflicts;
+    /**
+     * Apply single modification
+     */
+    private applyModification;
+    /**
+     * Generate AI-enhanced next steps
+     */
+    private generateAINextSteps;
+    /**
+     * Learn from installation for future improvements
+     */
+    private learnFromInstallation;
+    /**
+     * Load learning data from disk
+     */
+    private loadLearningData;
+    /**
+     * Save learning data to disk
+     */
+    private saveLearningData;
+    /**
+     * Get AI insights for a specific framework
+     */
+    getAIInsights(frameworkName: string): any[];
+    /**
+     * Get learning statistics
+     */
+    getLearningStats(): any;
+}
+/**
+ * Browser-based AI installation wizard
+ */
+declare class AIBrowserInstallationWizard {
+    private apiKey;
+    private aiService;
+    constructor(apiKey: string, aiService?: CentralizedAIService$1);
+    install(): Promise<AIInstallationResult>;
+    private performBrowserAIAnalysis;
+    private detectBrowserFramework;
+    private analyzeBrowserPatterns;
+    private generateAIBrowserModifications;
+}
+
+/**
+ * AI-Enhanced HumanBehavior SDK Auto-Installation CLI
+ *
+ * Usage: npx humanbehavior-js ai-auto-install [api-key]
+ *
+ * This tool uses AI to intelligently detect frameworks, analyze code patterns,
+ * and generate optimal integration code that's both future-proof and backward-compatible.
+ */
+interface AICLIOptions {
+    apiKey?: string;
+    projectPath?: string;
+    yes?: boolean;
+    dryRun?: boolean;
+    useAI?: boolean;
+    browser?: boolean;
+    framework?: string;
+    manual?: boolean;
+}
+declare class AIAutoInstallCLI {
+    private rl;
+    private options;
+    constructor(options: AICLIOptions);
+    run(): Promise<void>;
+    private getApiKey;
+    private chooseInstallationMode;
+    private confirmInstallation;
+    private getInstallationModeDisplay;
+    private chooseFramework;
+    private displayResults;
+}
+
+/**
+ * HumanBehavior SDK Auto-Installation CLI
+ *
+ * Usage: npx humanbehavior-js auto-install [api-key]
+ *
+ * This tool automatically detects the user's framework and modifies their codebase
+ * to integrate the SDK with minimal user intervention.
+ */
+interface CLIOptions {
+    apiKey?: string;
+    projectPath?: string;
+    yes?: boolean;
+    dryRun?: boolean;
+}
+declare class AutoInstallCLI {
+    private rl;
+    private options;
+    constructor(options: CLIOptions);
+    run(): Promise<void>;
+    private getApiKey;
+    private confirmInstallation;
+    private displayResults;
+}
+
+/**
+ * Remote AI Service Implementation
+ *
+ * This connects to your deployed Lambda function via API Gateway
+ */
+
+interface FrameworkInfo$1 {
+    name: string;
+    type: 'react' | 'vue' | 'angular' | 'svelte' | 'nextjs' | 'nuxt' | 'remix' | 'vanilla' | 'node';
+    bundler?: 'vite' | 'webpack' | 'esbuild' | 'rollup';
+    packageManager?: 'npm' | 'yarn' | 'pnpm';
+    hasTypeScript?: boolean;
+    hasRouter?: boolean;
+    projectRoot?: string;
+}
+interface RemoteAIServiceConfig {
+    apiEndpoint: string;
+    timeout?: number;
+}
+declare class RemoteAIService {
+    private config;
+    constructor(config: RemoteAIServiceConfig);
+    /**
+     * Analyze code patterns using your deployed AI service
+     */
+    analyzeCodePatterns(codeSamples: string[]): Promise<AICodeAnalysis>;
+    /**
+     * Resolve conflicts using your deployed AI service
+     */
+    resolveConflicts(conflicts: string[], framework: FrameworkInfo$1): Promise<string[]>;
+    /**
+     * Generate optimizations using your deployed AI service
+     */
+    generateOptimizations(framework: FrameworkInfo$1, patterns: string[]): Promise<string[]>;
+    /**
+     * Heuristic analysis fallback
+     */
+    private performHeuristicAnalysis;
+    /**
+     * Heuristic conflict resolution
+     */
+    private resolveConflictsHeuristic;
+    /**
+     * Heuristic optimization generation
+     */
+    private generateOptimizationsHeuristic;
+}
+
+/**
+ * Centralized AI Service Implementation
+ *
+ * This service runs on your backend infrastructure and provides AI-powered
+ * code analysis without requiring users to provide their own API keys.
+ *
+ * The service can be deployed as:
+ * - AWS Lambda function
+ * - Docker container
+ * - Express.js server
+ * - Cloud function
+ */
+
+interface FrameworkInfo {
+    name: string;
+    type: 'react' | 'vue' | 'angular' | 'svelte' | 'nextjs' | 'nuxt' | 'remix' | 'vanilla' | 'node';
+    bundler?: 'vite' | 'webpack' | 'esbuild' | 'rollup';
+    packageManager?: 'npm' | 'yarn' | 'pnpm';
+    hasTypeScript?: boolean;
+    hasRouter?: boolean;
+    projectRoot?: string;
+}
+interface CentralizedAIServiceConfig {
+    openaiApiKey: string;
+    openaiModel?: string;
+    maxTokens?: number;
+    temperature?: number;
+    enableCaching?: boolean;
+    cacheTTL?: number;
+}
+/**
+ * Centralized AI Service Implementation
+ * This runs on your backend infrastructure
+ */
+declare class CentralizedAIService {
+    private config;
+    private cache;
+    private openai;
+    constructor(config: CentralizedAIServiceConfig);
+    /**
+     * Initialize OpenAI client
+     */
+    private initializeOpenAI;
+    /**
+     * Analyze code patterns using AI
+     */
+    analyzeCodePatterns(codeSamples: string[]): Promise<AICodeAnalysis>;
+    /**
+     * Resolve conflicts using AI
+     */
+    resolveConflicts(conflicts: string[], framework: FrameworkInfo): Promise<string[]>;
+    /**
+     * Generate optimizations using AI
+     */
+    generateOptimizations(framework: FrameworkInfo, patterns: string[]): Promise<string[]>;
+    /**
+     * Perform AI analysis
+     */
+    private performAIAnalysis;
+    /**
+     * Build analysis prompt
+     */
+    private buildAnalysisPrompt;
+    /**
+     * Build conflict resolution prompt
+     */
+    private buildConflictResolutionPrompt;
+    /**
+     * Build optimization prompt
+     */
+    private buildOptimizationPrompt;
+    /**
+     * Parse analysis result
+     */
+    private parseAnalysisResult;
+    /**
+     * Parse conflict resolutions
+     */
+    private parseConflictResolutions;
+    /**
+     * Parse optimizations
+     */
+    private parseOptimizations;
+    /**
+     * Heuristic analysis fallback
+     */
+    private performHeuristicAnalysis;
+    /**
+     * Heuristic conflict resolution
+     */
+    private resolveConflictsHeuristic;
+    /**
+     * Heuristic optimization generation
+     */
+    private generateOptimizationsHeuristic;
+    /**
+     * Generate cache key
+     */
+    private generateCacheKey;
+    /**
+     * Check if cache is valid
+     */
+    private isCacheValid;
+    /**
+     * Get default analysis
+     */
+    private getDefaultAnalysis;
+    /**
+     * Get service statistics
+     */
+    getStats(): {
+        cacheSize: number;
+        config: {
+            model: string | undefined;
+            maxTokens: number | undefined;
+            temperature: number | undefined;
+            caching: boolean | undefined;
+        };
+        openaiAvailable: boolean;
+    };
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+}
+
+export { AIAutoInstallCLI, AIBrowserInstallationWizard, AIEnhancedInstallationWizard, AutoInstallCLI, AutoInstallationWizard, CentralizedAIService, AutoInstallationWizard as InstallWizard, RemoteAIService };
+export type { AICodeAnalysis, AIInstallationResult, CentralizedAIServiceConfig, CodeModification, FrameworkInfo$2 as FrameworkInfo, InstallationResult, RemoteAIServiceConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanbehavior-js",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "description": "SDK for HumanBehavior session and event recording",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -43,6 +43,11 @@
       "import": "./dist/esm/install-wizard.js",
       "require": "./dist/cjs/install-wizard.cjs",
       "types": "./dist/types/install-wizard.d.ts"
+    },
+    "./wizard": {
+      "import": "./dist/esm/wizard/index.js",
+      "require": "./dist/cjs/wizard/index.cjs",
+      "types": "./dist/types/wizard/index.d.ts"
     }
   },
   "scripts": {
@@ -55,28 +60,29 @@
   "author": "Chirag Kawediya, Skyler Ji, Amogh Chaturvedi",
   "license": "ISC",
   "dependencies": {
-    "@types/react": "^19.0.12",
     "@rrweb/record": "^2.0.0-alpha.17",
+    "@types/react": "^19.0.12",
+    "openai": "^5.12.0",
     "uuid": "^11.1.0"
   },
   "peerDependencies": {
+    "@remix-run/node": ">=2.0.0",
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
-    "vue": ">=3.0.0",
-    "@remix-run/node": ">=2.0.0"
+    "vue": ">=3.0.0"
   },
   "devDependencies": {
+    "@remix-run/node": "^2.0.0",
     "@rollup/plugin-commonjs": "^28.0.3",
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@types/node": "^24.0.3",
+    "@types/node": "^24.2.0",
     "rollup": "^4.36.0",
     "rollup-plugin-dts": "^6.2.1",
     "tslib": "^2.8.1",
     "typescript": "^5.8.2",
-    "vue": "^3.0.0",
-    "@remix-run/node": "^2.0.0"
+    "vue": "^3.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -92,6 +98,6 @@
     "koalaware"
   ],
   "bin": {
-    "humanbehavior-js": "./dist/cli/auto-install.js"
+    "humanbehavior-js": "./dist/cli/ai-auto-install.js"
   }
 }