humanbehavior-js 0.4.28 → 0.5.0

package/packages/wizard/dist/services/centralized-ai-service.d.ts

@@ -0,0 +1,159 @@
+/**
+ * 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
+ */
+import { AICodeAnalysis } from '../ai/ai-install-wizard';
+export interface FrameworkInfo {
+    name: string;
+    type: 'react' | 'vue' | 'angular' | 'svelte' | 'nextjs' | 'nuxt' | 'remix' | 'vanilla' | 'astro' | 'node';
+    bundler?: 'vite' | 'webpack' | 'esbuild' | 'rollup';
+    packageManager?: 'npm' | 'yarn' | 'pnpm';
+    hasTypeScript?: boolean;
+    hasRouter?: boolean;
+    projectRoot?: string;
+}
+export interface CentralizedAIServiceConfig {
+    openaiApiKey: string;
+    openaiModel?: string;
+    maxTokens?: number;
+    temperature?: number;
+    enableCaching?: boolean;
+    cacheTTL?: number;
+}
+export interface AIAnalysisRequest {
+    codeSamples: string[];
+    projectType?: string;
+    userAgent?: string;
+    timestamp: string;
+}
+export interface AIAnalysisResponse {
+    analysis: AICodeAnalysis;
+    processingTime: number;
+    cacheHit?: boolean;
+    modelUsed: string;
+}
+export interface ConflictResolutionRequest {
+    conflicts: string[];
+    framework: FrameworkInfo;
+    codeContext?: string;
+}
+export interface OptimizationRequest {
+    framework: FrameworkInfo;
+    patterns: string[];
+    projectContext?: string;
+}
+/**
+ * Centralized AI Service Implementation
+ * This runs on your backend infrastructure
+ */
+export 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;
+}
+/**
+ * Express.js server implementation
+ */
+export declare function createAIServiceServer(config: CentralizedAIServiceConfig): any;
+/**
+ * AWS Lambda handler
+ */
+export declare function lambdaHandler(event: any, context: any): Promise<{
+    statusCode: number;
+    body: string;
+}>;
+//# sourceMappingURL=centralized-ai-service.d.ts.map

package/packages/wizard/dist/services/centralized-ai-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"centralized-ai-service.d.ts","sourceRoot":"","sources":["../../src/services/centralized-ai-service.ts"],"names":[],"mappings":"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"}

package/packages/wizard/dist/services/remote-ai-service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Remote AI Service Implementation
+ *
+ * This connects to your deployed Lambda function via API Gateway
+ */
+import { AICodeAnalysis } from '../ai/ai-install-wizard';
+export interface FrameworkInfo {
+    name: string;
+    type: 'react' | 'vue' | 'angular' | 'svelte' | 'nextjs' | 'nuxt' | 'remix' | 'vanilla' | 'astro' | 'gatsby' | 'node';
+    bundler?: 'vite' | 'webpack' | 'esbuild' | 'rollup';
+    packageManager?: 'npm' | 'yarn' | 'pnpm';
+    hasTypeScript?: boolean;
+    hasRouter?: boolean;
+    projectRoot?: string;
+    version?: string;
+    majorVersion?: number;
+    features?: {
+        hasReact18?: boolean;
+        hasVue3?: boolean;
+        hasNuxt3?: boolean;
+        hasAngularStandalone?: boolean;
+        hasNextAppRouter?: boolean;
+        hasSvelteKit?: boolean;
+    };
+}
+export interface RemoteAIServiceConfig {
+    apiEndpoint: string;
+    timeout?: number;
+}
+export 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): Promise<string[]>;
+    /**
+     * Generate optimizations using your deployed AI service
+     */
+    generateOptimizations(framework: FrameworkInfo, patterns: string[]): Promise<string[]>;
+    /**
+     * Heuristic analysis fallback
+     */
+    private performHeuristicAnalysis;
+    /**
+     * Heuristic conflict resolution
+     */
+    private resolveConflictsHeuristic;
+    /**
+     * Heuristic optimization generation
+     */
+    private generateOptimizationsHeuristic;
+}
+//# sourceMappingURL=remote-ai-service.d.ts.map

package/packages/wizard/dist/services/remote-ai-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-ai-service.d.ts","sourceRoot":"","sources":["../../src/services/remote-ai-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpD,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAOzC;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAuBzE;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBxF;;OAEG;IACG,qBAAqB,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuB5F;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4DhC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAsBjC;;OAEG;IACH,OAAO,CAAC,8BAA8B;CA2BvC"}

package/WIZARD_USAGE_GUIDE.md

@@ -1,381 +0,0 @@
-# HumanBehavior SDK Auto-Installation Wizard
-
-The HumanBehavior SDK includes an intelligent auto-installation wizard that can detect your project's framework and automatically integrate the SDK with minimal user intervention.
-
-## 🚀 Quick Start
-
-### Single Command Installation
-
-**When the package is published to npm:**
-```bash
-npx humanbehavior-js auto-install YOUR_API_KEY
-```
-
-**For local development/testing:**
-```bash
-node path/to/humanbehavior-js/dist/cli/auto-install.js YOUR_API_KEY
-```
-
-That's it! The wizard will:
-- 🔍 Auto-detect your project's framework
-- 📦 Install the humanbehavior-js package
-- ✏️ Modify your codebase to integrate the SDK
-- 🔧 Create environment files with your API key
-- 🚀 Make your app ready to track user behavior
-
-## 📋 Supported Frameworks
-
-The wizard automatically detects and configures:
-
-- ✅ **React** (CRA, Vite, Webpack)
-- ✅ **Next.js** (App Router, Pages Router)
-- ✅ **Vue** (Vue CLI, Vite)
-- ✅ **Angular**
-- ✅ **Svelte** (SvelteKit, Vite)
-- ✅ **Nuxt.js**
-- ✅ **Vanilla JS/TS**
-- ✅ **Node.js** (CommonJS & ESM)
-
-## 🛠️ Installation Options
-
-### Basic Usage
-
-**When the package is published to npm:**
-```bash
-# Interactive mode (prompts for API key)
-npx humanbehavior-js auto-install
-
-# With API key as argument
-npx humanbehavior-js auto-install your-api-key-here
-
-# Skip all prompts
-npx humanbehavior-js auto-install your-api-key-here --yes
-```
-
-**For local development/testing:**
-```bash
-# Interactive mode (prompts for API key)
-node path/to/humanbehavior-js/dist/cli/auto-install.js
-
-# With API key as argument
-node path/to/humanbehavior-js/dist/cli/auto-install.js your-api-key-here
-
-# Skip all prompts
-node path/to/humanbehavior-js/dist/cli/auto-install.js your-api-key-here --yes
-```
-
-### Advanced Options
-
-**When the package is published to npm:**
-```bash
-# Specify project directory
-npx humanbehavior-js auto-install your-api-key -p /path/to/project
-
-# Dry run (show what would be changed without making changes)
-npx humanbehavior-js auto-install your-api-key --dry-run
-
-# Get help
-npx humanbehavior-js auto-install --help
-```
-
-**For local development/testing:**
-```bash
-# Specify project directory
-node path/to/humanbehavior-js/dist/cli/auto-install.js your-api-key -p /path/to/project
-
-# Dry run (show what would be changed without making changes)
-node path/to/humanbehavior-js auto-install.js your-api-key --dry-run
-
-# Get help
-node path/to/humanbehavior-js/dist/cli/auto-install.js --help
-```
-
-## 🔧 Framework-Specific Integration
-
-### React
-```jsx
-// The wizard automatically wraps your app with HumanBehaviorProvider
-import { HumanBehaviorProvider } from 'humanbehavior-js/react';
-
-function App() {
-  return (
-    <HumanBehaviorProvider apiKey={process.env.HUMANBEHAVIOR_API_KEY}>
-      {/* Your app content */}
-    </HumanBehaviorProvider>
-  );
-}
-```
-
-### Next.js (App Router)
-```tsx
-// Creates app/providers.tsx
-'use client';
-import { HumanBehaviorProvider } from 'humanbehavior-js/react';
-
-export function Providers({ children }: { children: React.ReactNode }) {
-  return (
-    <HumanBehaviorProvider apiKey={process.env.HUMANBEHAVIOR_API_KEY}>
-      {children}
-    </HumanBehaviorProvider>
-  );
-}
-
-// Modifies app/layout.tsx to use Providers
-```
-
-### Next.js (Pages Router)
-```tsx
-// Creates components/providers.tsx
-'use client';
-import { HumanBehaviorProvider } from 'humanbehavior-js/react';
-
-export function Providers({ children }: { children: React.ReactNode }) {
-  return (
-    <HumanBehaviorProvider apiKey={process.env.HUMANBEHAVIOR_API_KEY}>
-      {children}
-    </HumanBehaviorProvider>
-  );
-}
-
-// Modifies pages/_app.tsx to use Providers
-```
-
-### Vue
-```js
-// The wizard adds the plugin to your main.js/ts
-import { HumanBehaviorPlugin } from 'humanbehavior-js/vue';
-
-app.use(HumanBehaviorPlugin, {
-  apiKey: import.meta.env.VITE_HUMANBEHAVIOR_API_KEY
-});
-```
-
-### Angular
-```typescript
-// The wizard adds the module to app.module.ts
-import { HumanBehaviorModule } from 'humanbehavior-js/angular';
-
-@NgModule({
-  imports: [
-    // ... other imports
-    HumanBehaviorModule.forRoot({
-      apiKey: environment.humanBehaviorApiKey
-    })
-  ]
-})
-```
-
-### Svelte
-```javascript
-// The wizard adds the store to your main file
-import { humanBehaviorStore } from 'humanbehavior-js/svelte';
-
-humanBehaviorStore.init('your-api-key');
-```
-
-### Nuxt.js
-```typescript
-// Creates plugins/humanbehavior.client.ts
-import { HumanBehaviorPlugin } from 'humanbehavior-js/vue';
-
-export default defineNuxtPlugin((nuxtApp) => {
-  nuxtApp.vueApp.use(HumanBehaviorPlugin, {
-    apiKey: useRuntimeConfig().public.humanBehaviorApiKey
-  });
-});
-```
-
-## 🔐 Environment Variables
-
-The wizard intelligently handles environment files:
-
-### Smart File Detection
-The wizard checks for existing environment files in this order:
-1. `.env.local`
-2. `.env.development.local`
-3. `.env.development`
-4. `.env.local.development`
-5. `.env`
-6. `.env.production`
-7. `.env.staging`
-
-### Framework-Specific Variables
-- **React/Next.js**: `HUMANBEHAVIOR_API_KEY`
-- **Vue**: `VITE_HUMANBEHAVIOR_API_KEY`
-- **Svelte**: `PUBLIC_HUMANBEHAVIOR_API_KEY`
-- **Angular**: `humanBehaviorApiKey` (in environment.ts)
-- **Nuxt**: `HUMANBEHAVIOR_API_KEY`
-
-### Safe Environment Handling
-- ✅ **Preserves existing files** (never overwrites)
-- ✅ **Appends to existing files** (adds API key safely)
-- ✅ **Skips duplicates** (won't add same variable twice)
-- ✅ **Works with gitignored files** (finds .env files even if ignored)
-
-## 📁 Project Structure After Installation
-
-### React/Next.js Project
-```
-your-project/
-├── .env.local                    # Created with API key
-├── src/
-│   ├── App.tsx                   # Modified with provider
-│   └── index.tsx                 # Unchanged
-├── package.json                  # humanbehavior-js added
-└── node_modules/
-```
-
-### Next.js App Router
-```
-your-project/
-├── .env.local                    # Created with API key
-├── app/
-│   ├── layout.tsx                # Modified to use providers
-│   └── providers.tsx             # Created with provider
-├── package.json                  # humanbehavior-js added
-└── node_modules/
-```
-
-### Vue Project
-```
-your-project/
-├── .env.local                    # Created with API key
-├── src/
-│   └── main.js                   # Modified with plugin
-├── package.json                  # humanbehavior-js added
-└── node_modules/
-```
-
-## 🎯 What Gets Modified
-
-### Code Changes
-- **Main entry point**: Wrapped with provider/plugin
-- **Environment files**: API key added safely
-- **Package.json**: humanbehavior-js dependency added
-
-### Files Created
-- **Environment files**: `.env.local`, `.env`, etc.
-- **Provider files**: `providers.tsx` (Next.js)
-- **Plugin files**: `humanbehavior.client.ts` (Nuxt)
-
-### Files Modified
-- **Main app file**: `App.tsx`, `main.js`, `layout.tsx`, etc.
-- **Package.json**: Dependencies updated
-- **Environment files**: API key appended
-
-## 🚨 Troubleshooting
-
-### Common Issues
-
-**"Framework not detected"**
-- Ensure you're running the command from your project root
-- Check that `package.json` exists and has dependencies
-
-**"Permission denied"**
-- Make sure you have write permissions to your project directory
-- Try running with `sudo` if needed (not recommended)
-
-**"Package installation failed"**
-- Check your internet connection
-- Ensure npm/yarn is properly configured
-- Try running `npm install` manually first
-
-### Manual Fallback
-
-If the wizard fails, you can install manually:
-
-```bash
-# Install the package
-npm install humanbehavior-js
-
-# Add environment variable
-echo "HUMANBEHAVIOR_API_KEY=your-api-key" >> .env.local
-
-# Then follow framework-specific setup in the main README
-```
-
-## 🚀 Current Status
-
-**Note**: The auto-installation wizard is currently in development and not yet published to npm. To test it locally:
-
-1. **Clone the repository**:
-   ```bash
-   git clone https://github.com/humanbehavior-gh/humanbehavior-js.git
-   cd humanbehavior-js
-   ```
-
-2. **Build the wizard**:
-   ```bash
-   npm install
-   npm run build
-   ```
-
-3. **Test in your project**:
-   ```bash
-   node dist/cli/auto-install.js your-api-key --yes
-   ```
-
-Once the package is published to npm, you'll be able to use the `npx` commands shown above.
-
-## 🔍 Debugging
-
-### Dry Run Mode
-**When the package is published to npm:**
-```bash
-npx humanbehavior-js auto-install your-api-key --dry-run
-```
-
-**For local development/testing:**
-```bash
-node path/to/humanbehavior-js/dist/cli/auto-install.js your-api-key --dry-run
-```
-
-Shows what changes would be made without actually making them.
-
-### Verbose Output
-The wizard provides detailed output showing:
-- Framework detection results
-- Package installation status
-- Files created/modified
-- Next steps for the user
-
-## 📚 Next Steps After Installation
-
-Once the wizard completes:
-
-1. **Start your development server**
-   ```bash
-   npm start
-   # or
-   yarn dev
-   ```
-
-2. **Verify integration**
-   - Check browser console for SDK initialization
-   - Visit your app and trigger some interactions
-   - Check your HumanBehavior dashboard for sessions
-
-3. **Customize tracking** (optional)
-   ```javascript
-   // React
-   import { useHumanBehavior } from 'humanbehavior-js/react';
-   
-   function MyComponent() {
-     const { trackEvent } = useHumanBehavior();
-     
-     const handleClick = () => {
-       trackEvent('button_clicked', { button: 'submit' });
-     };
-   }
-   ```
-
-## 🎉 Success Indicators
-
-The wizard is successful when you see:
-- ✅ "Installation completed successfully!"
-- ✅ Framework detected correctly
-- ✅ Package installed without errors
-- ✅ Environment file created
-- ✅ Code modifications applied
-
-Your app is now ready to track user behavior! 🚀