humanbehavior-js 0.4.28 → 0.5.1

package/src/wizard/ai/manual-framework-wizard.ts

@@ -1,238 +0,0 @@
-/**
- * Manual Framework Installation Wizard
- * 
- * This wizard allows users to manually specify their framework instead of auto-detection.
- * Useful when auto-detection fails or users want more control.
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { AutoInstallationWizard, FrameworkInfo, CodeModification, InstallationResult } from '../core/install-wizard';
-import { RemoteAIService } from '../services/remote-ai-service';
-
-export interface ManualInstallationResult extends InstallationResult {
-  selectedFramework: string;
-  manualMode: boolean;
-}
-
-export class ManualFrameworkInstallationWizard extends AutoInstallationWizard {
-  private selectedFramework: string;
-
-  constructor(apiKey: string, projectRoot: string = process.cwd(), framework: string) {
-    super(apiKey, projectRoot);
-    this.selectedFramework = framework.toLowerCase();
-    this.framework = this.createFrameworkInfo(this.selectedFramework);
-  }
-
-  /**
-   * Manual installation with user-specified framework
-   */
-  async install(): Promise<ManualInstallationResult> {
-    try {
-      // Step 1: Handle framework selection
-      if (this.selectedFramework === 'auto') {
-        // Use full AI detection for "Other" option
-        this.framework = await this.runFullDetection();
-      } else {
-        // Set framework based on user selection
-        this.framework = this.createFrameworkInfo(this.selectedFramework);
-        if (!this.framework) {
-          this.framework = { name: 'unknown', type: 'vanilla' };
-        }
-        
-        // Step 2: Run full detection logic to find entry points, file names, etc.
-        const detectedFramework = await this.runFullDetection();
-        
-        // Step 3: Merge manual framework with detected details
-        this.framework = {
-          ...detectedFramework,
-          name: this.framework.name,
-          type: this.framework.type
-        };
-      }
-      
-      // Step 4: Install package
-      await this.installPackage();
-      
-      // Step 5: Generate and apply code modifications
-      const modifications = await this.generateModifications();
-      await this.applyModifications(modifications);
-      
-      // Step 6: Generate next steps
-      const nextSteps = this.generateManualNextSteps();
-      
-      return {
-        success: true,
-        framework: this.framework,
-        modifications,
-        errors: [],
-        nextSteps,
-        selectedFramework: this.selectedFramework,
-        manualMode: true
-      };
-    } catch (error) {
-      return {
-        success: false,
-        framework: this.framework || { name: 'unknown', type: 'vanilla' },
-        modifications: [],
-        errors: [error instanceof Error ? error.message : 'Unknown error'],
-        nextSteps: [],
-        selectedFramework: this.selectedFramework,
-        manualMode: true
-      };
-    }
-  }
-
-  /**
-   * Run full detection logic to find entry points, file names, bundler, etc.
-   */
-  private async runFullDetection(): Promise<FrameworkInfo> {
-    if (this.selectedFramework === 'auto') {
-      // Use AI service for auto-detection
-      const aiService = new RemoteAIService({
-        apiEndpoint: 'https://ik3zxh4790.execute-api.us-east-1.amazonaws.com/prod'
-      });
-      
-      // Use AI service directly for detection
-      const projectFiles = await this.scanProjectFiles();
-      const codeSamples = await this.extractCodeSamples(projectFiles);
-      const aiAnalysis = await aiService.analyzeCodePatterns(codeSamples);
-      return aiAnalysis.framework;
-    } else {
-      // Use traditional detection for manual frameworks
-      const tempWizard = new AutoInstallationWizard(this.apiKey, this.projectRoot);
-      const detected = await tempWizard.detectFramework();
-      return detected;
-    }
-  }
-
-  /**
-   * Scan project files for analysis
-   */
-  private async scanProjectFiles(): Promise<string[]> {
-    const files: string[] = [];
-    const scanDir = (dir: string, depth: number = 0) => {
-      if (depth > 3) return; // Limit depth
-      
-      try {
-        const items = fs.readdirSync(dir);
-        for (const item of items) {
-          const fullPath = path.join(dir, item);
-          const stat = fs.statSync(fullPath);
-          
-          if (stat.isDirectory() && !item.startsWith('.') && item !== 'node_modules') {
-            scanDir(fullPath, depth + 1);
-          } else if (stat.isFile() && this.isRelevantFile(item)) {
-            files.push(fullPath);
-          }
-        }
-      } catch (error) {
-        // Skip inaccessible directories
-      }
-    };
-    
-    scanDir(this.projectRoot);
-    return files;
-  }
-
-  /**
-   * Check if file is relevant for analysis
-   */
-  private isRelevantFile(filename: string): boolean {
-    const relevantExtensions = [
-      '.js', '.jsx', '.ts', '.tsx', '.vue', '.svelte', '.html',
-      '.json', '.config.js', '.config.ts', '.babelrc', '.eslintrc'
-    ];
-    
-    const relevantNames = [
-      'package.json', 'tsconfig.json', 'vite.config', 'webpack.config',
-      'next.config', 'nuxt.config', 'angular.json', 'svelte.config'
-    ];
-    
-    return relevantExtensions.some(ext => filename.endsWith(ext)) ||
-           relevantNames.some(name => filename.includes(name));
-  }
-
-  /**
-   * Extract code samples for AI analysis
-   */
-  private async extractCodeSamples(files: string[]): Promise<string[]> {
-    const samples: string[] = [];
-    
-    for (const file of files.slice(0, 20)) { // Limit to 20 files
-      try {
-        const content = fs.readFileSync(file, 'utf8');
-        const relativePath = path.relative(this.projectRoot, file);
-        samples.push(`File: ${relativePath}\n${content.substring(0, 1000)}`);
-      } catch (error) {
-        // Skip unreadable files
-      }
-    }
-    
-    return samples;
-  }
-
-  /**
-   * Create framework info based on user selection
-   */
-  private createFrameworkInfo(framework: string): FrameworkInfo {
-    const frameworkMap: Record<string, FrameworkInfo> = {
-      'react': { name: 'react', type: 'react' },
-      'nextjs': { name: 'nextjs', type: 'nextjs' },
-      'next': { name: 'nextjs', type: 'nextjs' },
-      'vue': { name: 'vue', type: 'vue' },
-      'nuxt': { name: 'nuxt', type: 'nuxt' },
-      'nuxtjs': { name: 'nuxt', type: 'nuxt' },
-      'angular': { name: 'angular', type: 'angular' },
-      'svelte': { name: 'svelte', type: 'svelte' },
-      'sveltekit': { name: 'svelte', type: 'svelte' },
-      'remix': { name: 'remix', type: 'remix' },
-      'astro': { name: 'astro', type: 'astro' },
-      'gatsby': { name: 'gatsby', type: 'gatsby' },
-      'vanilla': { name: 'vanilla', type: 'vanilla' },
-      'node': { name: 'node', type: 'node' },
-      'auto': { name: 'auto-detected', type: 'auto' }
-    };
-
-    return frameworkMap[framework] || { name: framework, type: 'vanilla' };
-  }
-
-  /**
-   * Override framework detection to use manual selection
-   */
-  public async detectFramework(): Promise<FrameworkInfo> {
-    return this.framework || { name: 'unknown', type: 'vanilla' };
-  }
-
-  /**
-   * Generate next steps with manual mode info
-   */
-  private generateManualNextSteps(): string[] {
-    return [
-      '✅ Manual framework installation completed!',
-      `🎯 Selected framework: ${this.framework?.name || 'unknown'}`,
-      `🔧 Integration strategy: ${this.getIntegrationStrategy()}`,
-      '🚀 Your app is now ready to track user behavior',
-      '📊 View sessions in your HumanBehavior dashboard'
-    ];
-  }
-
-  /**
-   * Get integration strategy based on framework
-   */
-  private getIntegrationStrategy(): string {
-    if (!this.framework?.type) return 'script';
-    
-    switch (this.framework.type) {
-      case 'react':
-      case 'nextjs':
-        return 'provider';
-      case 'vue':
-        return 'plugin';
-      case 'angular':
-        return 'module';
-      default:
-        return 'script';
-    }
-  }
-} 

package/src/wizard/cli/ai-auto-install.ts

@@ -1,241 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * 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.
- */
-
-import { AIEnhancedInstallationWizard, AIBrowserInstallationWizard } from '../ai/ai-install-wizard';
-import { ManualFrameworkInstallationWizard } from '../ai/manual-framework-wizard';
-import { AutoInstallationWizard } from '../core/install-wizard';
-import { RemoteAIService } from '../services/remote-ai-service';
-import * as clack from '@clack/prompts';
-import * as fs from 'fs';
-import * as path from 'path';
-
-interface AICLIOptions {
-  apiKey?: string;
-  projectPath?: string;
-  yes?: boolean;
-  dryRun?: boolean;
-  framework?: string;
-}
-
-class AIAutoInstallCLI {
-  private options: AICLIOptions;
-
-  constructor(options: AICLIOptions) {
-    this.options = options;
-  }
-
-  async run() {
-    clack.intro('🤖 AI-Enhanced HumanBehavior SDK Auto-Installation');
-
-    try {
-      // Get API key
-      const apiKey = await this.getApiKey();
-      if (!apiKey) {
-        clack.cancel('API key is required');
-        process.exit(1);
-      }
-
-      // Get project path
-      const projectPath = this.options.projectPath || process.cwd();
-      
-      // Choose framework
-      const framework = await this.chooseFramework();
-      if (!framework) {
-        clack.cancel('Installation cancelled.');
-        process.exit(0);
-      }
-      
-      // Confirm installation
-      if (!this.options.yes) {
-        const confirmed = await this.confirmInstallation(projectPath, framework);
-        if (!confirmed) {
-          clack.cancel('Installation cancelled.');
-          process.exit(0);
-        }
-      }
-
-      // Run installation
-      const spinner = clack.spinner();
-      spinner.start('🔍 Analyzing your project with AI...');
-      
-      const wizard = new ManualFrameworkInstallationWizard(apiKey, projectPath, framework);
-      const result = await wizard.install();
-
-      spinner.stop('Analysis complete!');
-
-      // Display results
-      this.displayResults(result, framework);
-
-    } catch (error) {
-      clack.cancel(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-      process.exit(1);
-    }
-  }
-
-  private async getApiKey(): Promise<string> {
-    if (this.options.apiKey) {
-      return this.options.apiKey;
-    }
-
-    const apiKey = await clack.text({
-      message: 'Enter your HumanBehavior API key:',
-      placeholder: 'hb_...',
-      validate: (value) => {
-        if (!value) return 'API key is required';
-        if (!value.startsWith('hb_')) return 'API key should start with "hb_"';
-        return undefined;
-      }
-    });
-
-    return apiKey;
-  }
-
-
-
-
-
-  private async confirmInstallation(projectPath: string, framework: string): Promise<boolean> {
-    const confirmed = await clack.confirm({
-      message: `Ready to install HumanBehavior SDK in ${projectPath} for ${framework}?`
-    });
-
-    return confirmed;
-  }
-
-  private async chooseFramework(): Promise<string> {
-    const framework = await clack.select({
-      message: 'Select your framework:',
-      options: [
-        { label: 'React', value: 'react' },
-        { label: 'Next.js', value: 'nextjs' },
-        { label: 'Vue', value: 'vue' },
-        { label: 'Angular', value: 'angular' },
-        { label: 'Svelte', value: 'svelte' },
-        { label: 'Nuxt.js', value: 'nuxt' },
-        { label: 'Remix', value: 'remix' },
-        { label: 'Astro', value: 'astro' },
-        { label: 'Gatsby', value: 'gatsby' },
-        { label: 'Vanilla JS/TS', value: 'vanilla' }
-      ]
-    });
-
-    return framework;
-  }
-
-  private displayResults(result: any, framework: string) {
-    if (result.success) {
-      clack.outro('🎉 Installation completed successfully!');
-
-      // Display framework info
-      clack.note(`Framework detected: ${result.framework.name} (${result.framework.type})`, 'Framework Info');
-
-      // Display modifications
-      if (result.modifications && result.modifications.length > 0) {
-        const modifications = result.modifications.map((mod: any) => 
-          `${mod.action}: ${mod.filePath} - ${mod.description}`
-        );
-        clack.note(modifications.join('\n'), 'Files Modified');
-      }
-
-      // Display next steps
-      if (result.nextSteps && result.nextSteps.length > 0) {
-        clack.note(result.nextSteps.join('\n'), 'Next Steps');
-      }
-
-      // Display AI insights if available
-      if (result.aiAnalysis) {
-        clack.note(`Confidence: ${Math.round(result.aiAnalysis.confidence * 100)}%`, 'AI Analysis');
-        if (result.aiAnalysis.recommendations && result.aiAnalysis.recommendations.length > 0) {
-          clack.note(result.aiAnalysis.recommendations.join('\n'), 'AI Recommendations');
-        }
-      }
-
-    } else {
-      clack.cancel('Installation failed');
-      
-      if (result.errors && result.errors.length > 0) {
-        clack.note(result.errors.join('\n'), 'Errors');
-      }
-    }
-  }
-}
-
-function parseArgs(): AICLIOptions {
-  const args = process.argv.slice(2);
-  const options: AICLIOptions = {};
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    
-    switch (arg) {
-      case '--help':
-      case '-h':
-        showHelp();
-        process.exit(0);
-        break;
-      case '--yes':
-      case '-y':
-        options.yes = true;
-        break;
-      case '--dry-run':
-        options.dryRun = true;
-        break;
-
-      case '--project':
-      case '-p':
-        options.projectPath = args[++i];
-        break;
-      case '--framework':
-      case '-f':
-        options.framework = args[++i];
-        break;
-      default:
-        if (!options.apiKey && !arg.startsWith('-')) {
-          options.apiKey = arg;
-        }
-        break;
-    }
-  }
-
-  return options;
-}
-
-function showHelp() {
-  console.log(`
-🤖 HumanBehavior SDK AI Auto-Installation
-
-Usage: npx humanbehavior-js ai-auto-install [api-key] [options]
-
-Options:
-  -h, --help              Show this help message
-  -y, --yes               Skip all prompts and use defaults
-  --dry-run               Show what would be changed without making changes
-
-  -p, --project <path>    Specify project directory
-  -f, --framework <name>  Specify framework manually
-
-Examples:
-  npx humanbehavior-js ai-auto-install
-  npx humanbehavior-js ai-auto-install hb_your_api_key_here
-  npx humanbehavior-js ai-auto-install --project ./my-app --ai
-  npx humanbehavior-js ai-auto-install --framework react --yes
-`);
-}
-
-// Main execution
-const options = parseArgs();
-const cli = new AIAutoInstallCLI(options);
-cli.run().catch((error) => {
-    clack.cancel(`Unexpected error: ${error.message}`);
-    process.exit(1);
-});
-
-export { AIAutoInstallCLI }; 

package/src/wizard/cli/auto-install.ts

@@ -1,224 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * 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.
- */
-
-import { AutoInstallationWizard } from '../core/install-wizard';
-import { ManualFrameworkInstallationWizard } from '../ai/manual-framework-wizard';
-import * as clack from '@clack/prompts';
-import * as fs from 'fs';
-import * as path from 'path';
-
-interface CLIOptions {
-  apiKey?: string;
-  projectPath?: string;
-  yes?: boolean;
-  dryRun?: boolean;
-}
-
-class AutoInstallCLI {
-  private options: CLIOptions;
-
-  constructor(options: CLIOptions) {
-    this.options = options;
-  }
-
-  async run() {
-    clack.intro('🚀 HumanBehavior SDK Auto-Installation');
-
-    try {
-      // Get API key
-      const apiKey = await this.getApiKey();
-      if (!apiKey) {
-        clack.cancel('API key is required');
-        process.exit(1);
-      }
-
-      // Get project path
-      const projectPath = this.options.projectPath || process.cwd();
-      
-      // Choose framework
-      const framework = await this.chooseFramework();
-      if (!framework) {
-        clack.cancel('Installation cancelled.');
-        process.exit(0);
-      }
-      
-      // Confirm installation
-      if (!this.options.yes) {
-        const confirmed = await this.confirmInstallation(projectPath, framework);
-        if (!confirmed) {
-          clack.cancel('Installation cancelled.');
-          process.exit(0);
-        }
-      }
-
-      // Run installation
-      const spinner = clack.spinner();
-      spinner.start('🔍 Analyzing your project...');
-      
-      const wizard = new ManualFrameworkInstallationWizard(apiKey, projectPath, framework);
-      const result = await wizard.install();
-
-      spinner.stop('Detection complete!');
-
-      // Display results
-      this.displayResults(result);
-
-    } catch (error) {
-      clack.cancel(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-      process.exit(1);
-    }
-  }
-
-  private async getApiKey(): Promise<string> {
-    if (this.options.apiKey) {
-      return this.options.apiKey;
-    }
-
-    const apiKey = await clack.text({
-      message: 'Enter your HumanBehavior API key:',
-      placeholder: 'hb_...',
-      validate: (value) => {
-        if (!value) return 'API key is required';
-        if (!value.startsWith('hb_')) return 'API key should start with "hb_"';
-        return undefined;
-      }
-    });
-
-    return apiKey;
-  }
-
-
-
-  private async chooseFramework(): Promise<string> {
-    const framework = await clack.select({
-      message: 'Select your framework:',
-      options: [
-        { label: 'React', value: 'react' },
-        { label: 'Next.js', value: 'nextjs' },
-        { label: 'Vue', value: 'vue' },
-        { label: 'Angular', value: 'angular' },
-        { label: 'Svelte', value: 'svelte' },
-        { label: 'Nuxt.js', value: 'nuxt' },
-        { label: 'Remix', value: 'remix' },
-        { label: 'Astro', value: 'astro' },
-        { label: 'Gatsby', value: 'gatsby' },
-        { label: 'Vanilla JS/TS', value: 'vanilla' }
-      ]
-    });
-
-    return framework;
-  }
-
-  private async confirmInstallation(projectPath: string, framework: string): Promise<boolean> {
-    const confirmed = await clack.confirm({
-      message: `Ready to install HumanBehavior SDK in ${projectPath} for ${framework}?`
-    });
-
-    return confirmed;
-  }
-
-  private displayResults(result: any) {
-    if (result.success) {
-      clack.outro('🎉 Installation completed successfully!');
-
-      // Display framework info
-      clack.note(`Framework detected: ${result.framework.name} (${result.framework.type})`, 'Framework Info');
-
-      // Display modifications
-      if (result.modifications && result.modifications.length > 0) {
-        const modifications = result.modifications.map((mod: any) => 
-          `${mod.action}: ${mod.filePath} - ${mod.description}`
-        );
-        clack.note(modifications.join('\n'), 'Files Modified');
-      }
-
-      // Display next steps
-      if (result.nextSteps && result.nextSteps.length > 0) {
-        clack.note(result.nextSteps.join('\n'), 'Next Steps');
-      }
-
-    } else {
-      clack.cancel('Installation failed');
-      
-      if (result.errors && result.errors.length > 0) {
-        clack.note(result.errors.join('\n'), 'Errors');
-      }
-    }
-  }
-}
-
-function parseArgs(): CLIOptions {
-  const args = process.argv.slice(2);
-  const options: CLIOptions = {};
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    
-    switch (arg) {
-      case '--help':
-      case '-h':
-        showHelp();
-        process.exit(0);
-        break;
-      case '--yes':
-      case '-y':
-        options.yes = true;
-        break;
-      case '--dry-run':
-        options.dryRun = true;
-        break;
-      case '--project':
-      case '-p':
-        options.projectPath = args[++i];
-        break;
-      default:
-        if (!options.apiKey && !arg.startsWith('-')) {
-          options.apiKey = arg;
-        }
-        break;
-    }
-  }
-
-  return options;
-}
-
-function showHelp() {
-  console.log(`
-🚀 HumanBehavior SDK Auto-Installation
-
-Usage: npx humanbehavior-js auto-install [api-key] [options]
-
-This tool automatically detects your framework and integrates the HumanBehavior SDK.
-
-Options:
-  -h, --help              Show this help message
-  -y, --yes               Skip all prompts and use defaults
-  --dry-run               Show what would be changed without making changes
-  -p, --project <path>    Specify project directory
-
-Examples:
-  npx humanbehavior-js auto-install
-  npx humanbehavior-js auto-install hb_your_api_key_here
-  npx humanbehavior-js auto-install --project ./my-app --yes
-`);
-}
-
-// Main execution
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const options = parseArgs();
-  const cli = new AutoInstallCLI(options);
-  cli.run().catch((error) => {
-    clack.cancel(`Unexpected error: ${error.message}`);
-    process.exit(1);
-  });
-}
-
-export { AutoInstallCLI };