humanbehavior-js 0.3.6 → 0.3.8

package/rollup.config.js

@@ -4,13 +4,16 @@ import commonjs from '@rollup/plugin-commonjs';
 import terser from '@rollup/plugin-terser';
 import dts from 'rollup-plugin-dts';
 
-// React should be external since it's typically provided by the host application
+// External dependencies that shouldn't be bundled
 const external = ['react', 'react-dom', 'react/jsx-runtime'];
+const nodeExternal = ['fs', 'path', 'child_process', 'readline'];
 
 // Global variables for UMD build
 const globals = {
   react: 'React',
-  'react-dom': 'ReactDOM'
+  'react-dom': 'ReactDOM',
+  fs: 'fs',
+  path: 'path'
 };
 
 export default [
@@ -19,7 +22,7 @@ export default [
     input: 'src/index.ts',
     output: [
       {
-        file: 'dist/cjs/index.js',
+        file: 'dist/cjs/index.cjs',
         format: 'cjs',
         name: 'HumanBehaviorTracker',
         globals,
@@ -42,14 +45,17 @@ export default [
       }
     ],
     plugins: [
-      resolve(),
+      resolve({
+        preferBuiltins: false
+      }),
       commonjs(),
       typescript({
         tsconfig: './tsconfig.json',
-        declaration: false
+        declaration: false,
+        declarationMap: false
       })
     ],
-    external
+    external: [...external, ...nodeExternal]
   },
   
   // React component bundle
@@ -57,12 +63,12 @@ export default [
     input: './src/react/index.tsx',
     output: [
       {
-        file: 'dist/cjs/react/index.js',
+        file: 'dist/cjs/react/index.cjs',
         format: 'cjs',
         name: 'HumanBehaviorReact',
         globals: {
           ...globals,
-          '..': 'HumanBehaviorTracker'
+          '../index': 'HumanBehaviorTracker'
         },
         exports: 'named',
         sourcemap: true
@@ -74,14 +80,160 @@ export default [
       }
     ],
     plugins: [
-      resolve(),
+      resolve({
+        preferBuiltins: false
+      }),
       commonjs(),
       typescript({
         tsconfig: './tsconfig.json',
-        declaration: false
+        declaration: false,
+        declarationMap: false
       })
     ],
-    external: [...external, '..'] // Externalize React and the main SDK
+    external: [...external] // Only externalize React, bundle the main SDK
+  },
+  
+  // Svelte bundle
+  {
+    input: './src/svelte/index.ts',
+    output: [
+      {
+        file: 'dist/cjs/svelte/index.cjs',
+        format: 'cjs',
+        name: 'HumanBehaviorSvelte',
+        globals: {
+          ...globals,
+          '../index': 'HumanBehaviorTracker'
+        },
+        exports: 'named',
+        sourcemap: true
+      },
+      {
+        file: 'dist/esm/svelte/index.js',
+        format: 'es',
+        sourcemap: true
+      }
+    ],
+    plugins: [
+      resolve({
+        preferBuiltins: false
+      }),
+      commonjs(),
+      typescript({
+        tsconfig: './tsconfig.json',
+        declaration: false,
+        declarationMap: false
+      })
+    ],
+    external: [...external, '../index', ...nodeExternal] // Externalize the main SDK
+  },
+  
+  // Vue bundle
+  {
+    input: './src/vue/index.ts',
+    output: [
+      {
+        file: 'dist/cjs/vue/index.cjs',
+        format: 'cjs',
+        name: 'HumanBehaviorVue',
+        globals: {
+          ...globals,
+          '../index': 'HumanBehaviorTracker',
+          'vue': 'Vue'
+        },
+        exports: 'named',
+        sourcemap: true
+      },
+      {
+        file: 'dist/esm/vue/index.js',
+        format: 'es',
+        sourcemap: true
+      }
+    ],
+    plugins: [
+      resolve({
+        preferBuiltins: false
+      }),
+      commonjs(),
+      typescript({
+        tsconfig: './tsconfig.json',
+        declaration: false,
+        declarationMap: false
+      })
+    ],
+    external: [...external, '../index', 'vue', ...nodeExternal] // Externalize Vue and the main SDK
+  },
+  
+  // Remix bundle
+  {
+    input: './src/remix/index.ts',
+    output: [
+      {
+        file: 'dist/cjs/remix/index.cjs',
+        format: 'cjs',
+        name: 'HumanBehaviorRemix',
+        globals: {
+          ...globals,
+          '../index': 'HumanBehaviorTracker',
+          '../react': 'HumanBehaviorReact',
+          '@remix-run/node': 'RemixNode'
+        },
+        exports: 'named',
+        sourcemap: true
+      },
+      {
+        file: 'dist/esm/remix/index.js',
+        format: 'es',
+        sourcemap: true
+      }
+    ],
+    plugins: [
+      resolve({
+        preferBuiltins: false
+      }),
+      commonjs(),
+      typescript({
+        tsconfig: './tsconfig.json',
+        declaration: false,
+        declarationMap: false
+      })
+    ],
+    external: [...external, '../index', '../react', '@remix-run/node', ...nodeExternal] // Externalize dependencies
+  },
+  
+  // Angular bundle
+  {
+    input: './src/angular/index.ts',
+    output: [
+      {
+        file: 'dist/cjs/angular/index.cjs',
+        format: 'cjs',
+        name: 'HumanBehaviorAngular',
+        globals: {
+          ...globals,
+          '../index': 'HumanBehaviorTracker'
+        },
+        exports: 'named',
+        sourcemap: true
+      },
+      {
+        file: 'dist/esm/angular/index.js',
+        format: 'es',
+        sourcemap: true
+      }
+    ],
+    plugins: [
+      resolve({
+        preferBuiltins: false
+      }),
+      commonjs(),
+      typescript({
+        tsconfig: './tsconfig.json',
+        declaration: false,
+        declarationMap: false
+      })
+    ],
+    external: [...external, '../index', ...nodeExternal] // Externalize the main SDK
   },
   
   // Type definition bundles - generate these separately
@@ -92,7 +244,7 @@ export default [
       format: 'es'
     },
     plugins: [dts()],
-    external
+    external: [...external, ...nodeExternal]
   },
   {
     input: 'src/react/index.tsx',
@@ -101,6 +253,104 @@ export default [
       format: 'es'
     },
     plugins: [dts()],
-    external: [...external, '..']
+    external: [...external, '..', ...nodeExternal]
+  },
+  {
+    input: 'src/svelte/index.ts',
+    output: {
+      file: 'dist/types/svelte/index.d.ts',
+      format: 'es'
+    },
+    plugins: [dts()],
+    external: [...external, '..', ...nodeExternal]
+  },
+  {
+    input: 'src/vue/index.ts',
+    output: {
+      file: 'dist/types/vue/index.d.ts',
+      format: 'es'
+    },
+    plugins: [dts()],
+    external: [...external, '..', 'vue', ...nodeExternal]
+  },
+  {
+    input: 'src/remix/index.ts',
+    output: {
+      file: 'dist/types/remix/index.d.ts',
+      format: 'es'
+    },
+    plugins: [dts()],
+    external: [...external, '..', '../react', '@remix-run/node', ...nodeExternal]
+  },
+  {
+    input: 'src/angular/index.ts',
+    output: {
+      file: 'dist/types/angular/index.d.ts',
+      format: 'es'
+    },
+    plugins: [dts()],
+    external: [...external, '..', ...nodeExternal]
+  },
+  
+  // CLI bundle
+  {
+    input: 'src/cli/auto-install.ts',
+    output: {
+      file: 'dist/cli/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',
+    output: [
+      {
+        file: 'dist/cjs/install-wizard.cjs',
+        format: 'cjs',
+        sourcemap: true
+      },
+      {
+        file: 'dist/esm/install-wizard.js',
+        format: 'es',
+        sourcemap: true
+      }
+    ],
+    plugins: [
+      resolve({
+        preferBuiltins: true
+      }),
+      commonjs(),
+      typescript({
+        tsconfig: './tsconfig.json',
+        declaration: false,
+        declarationMap: false
+      })
+    ],
+    external: nodeExternal
+  },
+  
+  // Install wizard types
+  {
+    input: 'src/install-wizard.ts',
+    output: {
+      file: 'dist/types/install-wizard.d.ts',
+      format: 'es'
+    },
+    plugins: [dts()],
+    external: nodeExternal
   }
 ]; 

package/src/angular/index.ts

@@ -0,0 +1,54 @@
+import { HumanBehaviorTracker } from '../index';
+
+// Angular NgModule for legacy Angular applications
+export class HumanBehaviorModule {
+  static forRoot(config: { apiKey: string }) {
+    return {
+      ngModule: HumanBehaviorModule,
+      providers: [
+        {
+          provide: 'HUMANBEHAVIOR_API_KEY',
+          useValue: config.apiKey
+        },
+        {
+          provide: HumanBehaviorTracker,
+          useFactory: (apiKey: string) => {
+            return HumanBehaviorTracker.init(apiKey);
+          },
+          deps: ['HUMANBEHAVIOR_API_KEY']
+        }
+      ]
+    };
+  }
+}
+
+// Angular service for dependency injection
+export class HumanBehaviorService {
+  private tracker: HumanBehaviorTracker;
+
+  constructor(apiKey: string) {
+    this.tracker = HumanBehaviorTracker.init(apiKey);
+  }
+
+  // Expose core tracker methods
+  identifyUser(userProperties: Record<string, any>) {
+    return this.tracker.identifyUser({ userProperties });
+  }
+
+  getSessionId() {
+    return this.tracker.getSessionId();
+  }
+
+  setRedactedFields(fields: string[]) {
+    return this.tracker.setRedactedFields(fields);
+  }
+
+  getRedactedFields() {
+    return this.tracker.getRedactedFields();
+  }
+}
+
+// Helper function for standalone Angular initialization
+export function initializeHumanBehavior(apiKey: string): HumanBehaviorTracker {
+  return HumanBehaviorTracker.init(apiKey);
+} 

package/src/api.ts

@@ -23,7 +23,16 @@ export function validateSingleEventSize(event: any, sessionId: string): void {
     }
 }
 
+
+
+
+
 export function splitLargeEvent(event: any, sessionId: string): any[] {
+    // ✅ SIMPLE VALIDATION
+    if (!event || typeof event !== 'object') {
+        return [];
+    }
+    
     const eventSize = new TextEncoder().encode(JSON.stringify({
         sessionId,
         events: [event]
@@ -132,6 +141,9 @@ export class HumanBehaviorAPI {
     }
 
     async sendEvents(events: any[], sessionId: string, userId: string) {
+        // ✅ SIMPLE VALIDATION FOR ALL EVENTS
+        const validEvents = events.filter(event => event && typeof event === 'object');
+        
         const response = await fetch(`${this.baseUrl}/api/ingestion/events`, {
             method: 'POST',
             headers: {
@@ -140,7 +152,7 @@ export class HumanBehaviorAPI {
             },
             body: JSON.stringify({
                 sessionId,
-                events: events,
+                events: validEvents,
                 endUserId: userId
             })
         });
@@ -156,6 +168,11 @@ export class HumanBehaviorAPI {
             let currentChunk: any[] = [];
             
             for (const event of events) {
+                // ✅ SIMPLE VALIDATION FOR ALL EVENTS
+                if (!event || typeof event !== 'object') {
+                    continue;
+                }
+                
                 if (isChunkSizeExceeded(currentChunk, event, sessionId)) {
                     // If current chunk is not empty, send it first
                     if (currentChunk.length > 0) {
@@ -226,7 +243,7 @@ export class HumanBehaviorAPI {
                 userId: userId,
                 userAttributes: userData,
                 sessionId: sessionId,
-                posthogName: userData.email || userData.name || null // Update posthogName with email
+                posthogName: userData.email || userData.name || null // Update user name with email
             };
             
             console.log('Sending user data to server:', payload);

package/src/cli/auto-install.ts

@@ -0,0 +1,225 @@
+#!/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 '../install-wizard';
+import * as readline from 'readline';
+import * as fs from 'fs';
+import * as path from 'path';
+
+interface CLIOptions {
+  apiKey?: string;
+  projectPath?: string;
+  yes?: boolean;
+  dryRun?: boolean;
+}
+
+class AutoInstallCLI {
+  private rl: readline.Interface;
+  private options: CLIOptions;
+
+  constructor(options: CLIOptions) {
+    this.options = options;
+    this.rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+  }
+
+  async run() {
+    console.log('🚀 HumanBehavior SDK Auto-Installation');
+    console.log('=====================================\n');
+
+    try {
+      // Get API key
+      const apiKey = await this.getApiKey();
+      if (!apiKey) {
+        console.error('❌ API key is required');
+        process.exit(1);
+      }
+
+      // Get project path
+      const projectPath = this.options.projectPath || process.cwd();
+      
+      // Confirm installation
+      if (!this.options.yes) {
+        const confirmed = await this.confirmInstallation(projectPath);
+        if (!confirmed) {
+          console.log('Installation cancelled.');
+          process.exit(0);
+        }
+      }
+
+      // Run auto-installation
+      console.log('🔍 Detecting your project setup...');
+      const wizard = new AutoInstallationWizard(apiKey, projectPath);
+      const result = await wizard.install();
+
+      // Display results
+      this.displayResults(result);
+
+    } catch (error) {
+      console.error('❌ Error:', error instanceof Error ? error.message : error);
+      process.exit(1);
+    } finally {
+      this.rl.close();
+    }
+  }
+
+  private async getApiKey(): Promise<string> {
+    if (this.options.apiKey) {
+      return this.options.apiKey;
+    }
+
+    return new Promise((resolve) => {
+      this.rl.question('Enter your HumanBehavior API key: ', (answer) => {
+        resolve(answer.trim());
+      });
+    });
+  }
+
+  private async confirmInstallation(projectPath: string): Promise<boolean> {
+    console.log(`📁 Project path: ${projectPath}`);
+    console.log('⚠️  This will modify your codebase to integrate HumanBehavior SDK.');
+    console.log('   The following changes will be made:');
+    console.log('   - Install humanbehavior-js package');
+    console.log('   - Modify your main app file');
+    console.log('   - Create environment files');
+    console.log('   - Add SDK initialization code\n');
+
+    return new Promise((resolve) => {
+      this.rl.question('Continue with auto-installation? (y/n): ', (answer) => {
+        resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+      });
+    });
+  }
+
+  private displayResults(result: any) {
+    if (result.success) {
+      console.log('\n✅ Installation completed successfully!');
+      console.log(`📦 Framework detected: ${result.framework.name}`);
+      
+      if (result.framework.bundler) {
+        console.log(`🔧 Bundler: ${result.framework.bundler}`);
+      }
+      
+      if (result.framework.packageManager) {
+        console.log(`📋 Package Manager: ${result.framework.packageManager}`);
+      }
+
+      console.log('\n📝 Changes made:');
+      result.modifications.forEach((mod: any) => {
+        console.log(`   ${mod.action === 'create' ? '➕' : '✏️'}  ${mod.description}`);
+        console.log(`      ${mod.filePath}`);
+      });
+
+      console.log('\n🎯 Next steps:');
+      result.nextSteps.forEach((step: string) => {
+        console.log(`   ${step}`);
+      });
+
+      console.log('\n🚀 Your app is now ready to track user behavior!');
+      console.log('📊 View sessions in your HumanBehavior dashboard');
+      
+    } else {
+      console.log('\n❌ Installation failed:');
+      result.errors.forEach((error: string) => {
+        console.log(`   ${error}`);
+      });
+      
+      console.log('\n💡 Try running with --help for more options');
+    }
+  }
+}
+
+// CLI argument parsing
+function parseArgs(): CLIOptions {
+  const args = process.argv.slice(2);
+  const options: CLIOptions = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (arg === '--yes' || arg === '-y') {
+      options.yes = true;
+    } else if (arg === '--dry-run' || arg === '-d') {
+      options.dryRun = true;
+    } else if (arg === '--project' || arg === '-p') {
+      options.projectPath = args[i + 1];
+      i++;
+    } else if (arg === '--help' || arg === '-h') {
+      showHelp();
+      process.exit(0);
+    } else if (!options.apiKey) {
+      options.apiKey = arg;
+    }
+  }
+
+  return options;
+}
+
+function showHelp() {
+  console.log(`
+HumanBehavior SDK Auto-Installation CLI
+
+Usage: npx humanbehavior-js auto-install [api-key] [options]
+
+This tool automatically detects your project's framework and modifies your codebase
+to integrate the HumanBehavior SDK with minimal user intervention.
+
+Arguments:
+  api-key              Your HumanBehavior API key
+
+Options:
+  -y, --yes           Skip all prompts and use defaults
+  -d, --dry-run       Show what would be changed without making changes
+  -p, --project <path> Project directory (default: current directory)
+  -h, --help          Show this help message
+
+Examples:
+  npx humanbehavior-js auto-install your-api-key
+  npx humanbehavior-js auto-install your-api-key --yes
+  npx humanbehavior-js auto-install your-api-key -p /path/to/project
+
+Supported Frameworks:
+  ✅ React (CRA, Vite, Webpack)
+  ✅ Next.js (App Router, Pages Router)
+  ✅ Vue (Vue CLI, Vite)
+  ✅ Angular
+  ✅ Svelte (SvelteKit, Vite)
+  ✅ Vanilla JS/TS
+  ✅ Node.js (CommonJS & ESM)
+
+The tool will:
+1. 🔍 Auto-detect your project's framework and setup
+2. 📦 Install the humanbehavior-js package
+3. ✏️  Modify your codebase to integrate the SDK
+4. 🔧 Create environment files with your API key
+5. 🚀 Make your app ready to track user behavior
+`);
+}
+
+// Main execution
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const options = parseArgs();
+  
+  if (process.argv.length < 3 || process.argv.includes('--help') || process.argv.includes('-h')) {
+    showHelp();
+    process.exit(0);
+  }
+
+  const cli = new AutoInstallCLI(options);
+  cli.run().catch((error) => {
+    console.error('❌ Fatal error:', error);
+    process.exit(1);
+  });
+}
+
+export { AutoInstallCLI }; 

package/src/index.ts

@@ -16,8 +16,11 @@ export * from './redact';
 // Export logger functionality
 export * from './utils/logger';
 
-// Also export the tracker as the default export
-export { HumanBehaviorTracker as default } from './tracker';
+// Installation wizard is exported separately to avoid Node.js dependencies in browser bundles
+// Import from 'humanbehavior-js/install-wizard' for Node.js usage
+
+// Note: Default export removed to avoid mixed export warnings
+// Use: import { HumanBehaviorTracker } from 'humanbehavior-js'
 
 // For UMD builds, expose the main class globally
 if (typeof window !== 'undefined') {