npm - humanbehavior-js - Versions diffs - 0.4.28 → 0.5.0 - Mend

humanbehavior-js 0.4.28 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (140) hide show

package/README.md +151 -0
package/package.json +114 -79
package/packages/angular/dist/index.d.ts +46 -0
package/packages/angular/dist/index.d.ts.map +1 -0
package/packages/angular/dist/index.js +2 -0
package/packages/angular/dist/index.js.map +1 -0
package/packages/angular/dist/index.mjs +2 -0
package/packages/angular/dist/index.mjs.map +1 -0
package/packages/browser/dist/index.d.ts +5 -0
package/packages/browser/dist/index.d.ts.map +1 -0
package/packages/browser/dist/index.iife.js +12095 -0
package/packages/browser/dist/index.iife.js.map +1 -0
package/packages/browser/dist/index.js +2 -0
package/packages/browser/dist/index.js.map +1 -0
package/packages/browser/dist/index.min.js +2 -0
package/packages/browser/dist/index.min.js.map +1 -0
package/packages/browser/dist/index.mjs +2 -0
package/packages/browser/dist/index.mjs.map +1 -0
package/packages/react/dist/browser.d.ts +2 -0
package/packages/react/dist/browser.d.ts.map +1 -0
package/packages/react/dist/index.d.ts +48 -0
package/packages/react/dist/index.d.ts.map +1 -0
package/packages/react/dist/index.js +2 -0
package/packages/react/dist/index.js.map +1 -0
package/packages/react/dist/index.mjs +2 -0
package/packages/react/dist/index.mjs.map +1 -0
package/packages/remix/dist/index.d.ts +8 -0
package/packages/remix/dist/index.d.ts.map +1 -0
package/packages/remix/dist/index.js +2 -0
package/packages/remix/dist/index.js.map +1 -0
package/packages/remix/dist/index.mjs +2 -0
package/packages/remix/dist/index.mjs.map +1 -0
package/packages/svelte/dist/index.d.ts +11 -0
package/packages/svelte/dist/index.d.ts.map +1 -0
package/packages/svelte/dist/index.js +2 -0
package/packages/svelte/dist/index.js.map +1 -0
package/packages/svelte/dist/index.mjs +2 -0
package/packages/svelte/dist/index.mjs.map +1 -0
package/{dist/types/vue → packages/vue/dist}/index.d.ts +4 -5
package/packages/vue/dist/index.d.ts.map +1 -0
package/packages/vue/dist/index.js +2 -0
package/packages/vue/dist/index.js.map +1 -0
package/packages/vue/dist/index.mjs +2 -0
package/packages/vue/dist/index.mjs.map +1 -0
package/packages/wizard/dist/ai/ai-install-wizard.d.ts +145 -0
package/packages/wizard/dist/ai/ai-install-wizard.d.ts.map +1 -0
package/packages/wizard/dist/ai/manual-framework-wizard.d.ts +52 -0
package/packages/wizard/dist/ai/manual-framework-wizard.d.ts.map +1 -0
package/packages/wizard/dist/cli/ai-auto-install.d.ts +27 -0
package/packages/wizard/dist/cli/ai-auto-install.d.ts.map +1 -0
package/{dist → packages/wizard/dist}/cli/ai-auto-install.js +821 -905
package/packages/wizard/dist/cli/ai-auto-install.js.map +1 -0
package/packages/wizard/dist/cli/auto-install.d.ts +26 -0
package/packages/wizard/dist/cli/auto-install.d.ts.map +1 -0
package/{dist → packages/wizard/dist}/cli/auto-install.js +821 -905
package/packages/wizard/dist/cli/auto-install.js.map +1 -0
package/{dist/types → packages/wizard/dist/core}/install-wizard.d.ts +6 -8
package/packages/wizard/dist/core/install-wizard.d.ts.map +1 -0
package/packages/wizard/dist/index.d.ts +18 -0
package/packages/wizard/dist/index.d.ts.map +1 -0
package/packages/wizard/dist/index.js +2 -0
package/packages/wizard/dist/index.js.map +1 -0
package/packages/wizard/dist/index.mjs +2 -0
package/packages/wizard/dist/index.mjs.map +1 -0
package/packages/wizard/dist/services/centralized-ai-service.d.ts +159 -0
package/packages/wizard/dist/services/centralized-ai-service.d.ts.map +1 -0
package/packages/wizard/dist/services/remote-ai-service.d.ts +58 -0
package/packages/wizard/dist/services/remote-ai-service.d.ts.map +1 -0
package/WIZARD_USAGE_GUIDE.md +0 -381
package/dist/cjs/angular/index.cjs +0 -14979
package/dist/cjs/angular/index.cjs.map +0 -1
package/dist/cjs/index.cjs +0 -14964
package/dist/cjs/index.cjs.map +0 -1
package/dist/cjs/install-wizard.cjs +0 -1576
package/dist/cjs/install-wizard.cjs.map +0 -1
package/dist/cjs/react/index.cjs +0 -15103
package/dist/cjs/react/index.cjs.map +0 -1
package/dist/cjs/remix/index.cjs +0 -15077
package/dist/cjs/remix/index.cjs.map +0 -1
package/dist/cjs/svelte/index.cjs +0 -14933
package/dist/cjs/svelte/index.cjs.map +0 -1
package/dist/cjs/vue/index.cjs +0 -14942
package/dist/cjs/vue/index.cjs.map +0 -1
package/dist/cjs/wizard/index.cjs +0 -3490
package/dist/cjs/wizard/index.cjs.map +0 -1
package/dist/cli/ai-auto-install.js.map +0 -1
package/dist/cli/auto-install.js.map +0 -1
package/dist/esm/angular/index.js +0 -14975
package/dist/esm/angular/index.js.map +0 -1
package/dist/esm/index.js +0 -14941
package/dist/esm/index.js.map +0 -1
package/dist/esm/install-wizard.js +0 -1553
package/dist/esm/install-wizard.js.map +0 -1
package/dist/esm/react/index.js +0 -15097
package/dist/esm/react/index.js.map +0 -1
package/dist/esm/remix/index.js +0 -15073
package/dist/esm/remix/index.js.map +0 -1
package/dist/esm/svelte/index.js +0 -14931
package/dist/esm/svelte/index.js.map +0 -1
package/dist/esm/vue/index.js +0 -14940
package/dist/esm/vue/index.js.map +0 -1
package/dist/esm/wizard/index.js +0 -3459
package/dist/esm/wizard/index.js.map +0 -1
package/dist/index.min.js +0 -2
package/dist/index.min.js.map +0 -1
package/dist/types/angular/index.d.ts +0 -357
package/dist/types/index.d.ts +0 -644
package/dist/types/react/index.d.ts +0 -345
package/dist/types/remix/index.d.ts +0 -336
package/dist/types/svelte/index.d.ts +0 -322
package/dist/types/wizard/index.d.ts +0 -523
package/readme.md +0 -335
package/rollup.config.js +0 -422
package/simple-spa.html +0 -1000
package/src/angular/index.ts +0 -79
package/src/api.ts +0 -416
package/src/index.ts +0 -35
package/src/react/AutoInstallWizard.tsx +0 -557
package/src/react/browser.ts +0 -8
package/src/react/index.tsx +0 -308
package/src/redact.ts +0 -327
package/src/remix/index.ts +0 -16
package/src/svelte/index.ts +0 -14
package/src/tracker.ts +0 -1587
package/src/types/clack.d.ts +0 -31
package/src/utils/ip-detector.ts +0 -158
package/src/utils/logger.ts +0 -144
package/src/utils/property-detector.ts +0 -345
package/src/utils/property-manager.ts +0 -274
package/src/vue/index.ts +0 -29
package/src/wizard/README.md +0 -114
package/src/wizard/ai/ai-install-wizard.ts +0 -897
package/src/wizard/ai/manual-framework-wizard.ts +0 -238
package/src/wizard/cli/ai-auto-install.ts +0 -241
package/src/wizard/cli/auto-install.ts +0 -224
package/src/wizard/core/install-wizard.ts +0 -1794
package/src/wizard/index.ts +0 -23
package/src/wizard/services/centralized-ai-service.ts +0 -668
package/src/wizard/services/remote-ai-service.ts +0 -240
package/tsconfig.json +0 -24

package/readme.md DELETED Viewed

@@ -1,335 +0,0 @@
-# HumanBehavior SDK
-A simplified session recording and analytics SDK that maintains session continuity across page navigations.
-📖 **[Full Documentation](https://documentation.humanbehavior.co)** - Complete API reference, examples, and integration guides
-## Quick Start
-### Auto-Installation (Recommended)
-The easiest way to get started is using our auto-installation wizard:
-```bash
-# One command installation
-npx humanbehavior-js auto-install YOUR_API_KEY
-```
-This will automatically:
-- 🔍 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
-### Single Page Application (Manual Setup)
-For the best session continuity experience, use the SPA approach:
-```html
-<!DOCTYPE html>
-<html>
-<head>
-    <script src="dist/index.min.js"></script>
-</head>
-<body>
-    <script>
-        // Initialize once - session persists across all navigation
-        const tracker = HumanBehaviorTracker.init('your-api-key', {
-            logLevel: 'warn', // Reduce console noise
-            redactFields: ['password', 'credit_card'],
-            suppressConsoleErrors: true, // Suppress common rrweb errors (default)
-            recordCanvas: false // Enable canvas recording with protection (default: false)
-        });
-        // Your SPA navigation logic here
-        function navigateToPage(page) {
-            // Update content without page reload
-            loadPageContent(page);
-            // Track navigation
-            tracker.trackNavigationEvent('spa_navigation', currentPage, page);
-        }
-    </script>
-</body>
-</html>
-```
-### Traditional Multi-Page Setup
-For traditional HTML pages, the tracker will automatically restore sessions:
-```html
-<!-- index.html -->
-<script src="dist/index.min.js"></script>
-<script>
-    const tracker = HumanBehaviorTracker.init('your-api-key');
-</script>
-<!-- about.html -->
-<script src="dist/index.min.js"></script>
-<script>
-    const tracker = HumanBehaviorTracker.init('your-api-key'); // Reuses existing session
-</script>
-```
-## API Reference
-### Initialization
-```javascript
-// Main initialization method
-const tracker = HumanBehaviorTracker.init(apiKey, options);
-```
-**Options:**
-- `ingestionUrl`: Custom ingestion server URL
-- `logLevel`: 'none' | 'error' | 'warn' | 'info' | 'debug'
-- `redactFields`: Array of CSS selectors to unredact (DEPRECATED: Use redactionStrategy instead)
-- `redactionStrategy`: Flexible redaction configuration
-  - `mode`: 'privacy-first' | 'visibility-first' (default: 'privacy-first')
-  - `unredactFields`: Array of CSS selectors to make visible (when mode: 'privacy-first')
-  - `redactFields`: Array of CSS selectors to hide (when mode: 'visibility-first')
-- `suppressConsoleErrors`: Boolean to suppress common rrweb errors (default: true)
-- `recordCanvas`: Boolean to enable canvas recording with PostHog-style protection (default: false)
-### Session Management
-```javascript
-// Get current session ID
-const sessionId = tracker.getSessionId();
-// Get current URL
-const currentUrl = tracker.getCurrentUrl();
-// Test connection to ingestion server
-const result = await tracker.testConnection();
-```
-### Event Tracking
-```javascript
-// Track custom events
-await tracker.customEvent('button_click', { button: 'submit' });
-// Track page views
-await tracker.trackPageView();
-// Track navigation (for SPAs)
-await tracker.trackNavigationEvent('pushState', '/home', '/about');
-```
-### Data Redaction
-The SDK supports flexible redaction strategies to protect sensitive data:
-#### Privacy-First Mode (Default)
-Everything is redacted by default. Specify fields to unredact:
-```javascript
-// Privacy-first: everything redacted, unredact specific fields
-const tracker = HumanBehaviorTracker.init('your-api-key', {
-    redactionStrategy: {
-        mode: 'privacy-first',
-        unredactFields: ['#username', '#comment', '.public-field']
-    }
-});
-```
-#### Visibility-First Mode
-Everything is visible by default. Specify fields to redact:
-```javascript
-// Visibility-first: everything visible, redact specific fields
-const tracker = HumanBehaviorTracker.init('your-api-key', {
-    redactionStrategy: {
-        mode: 'visibility-first',
-        redactFields: ['#password', '#credit-card', '.sensitive-data']
-    }
-});
-```
-#### Legacy Support
-The old `redactFields` option still works (privacy-first mode):
-```javascript
-// Legacy: same as privacy-first mode
-const tracker = HumanBehaviorTracker.init('your-api-key', {
-    redactFields: ['#username', '#email'] // These fields will be unredacted
-});
-```
-#### Dynamic Redaction
-Change redaction settings at runtime:
-```javascript
-// Privacy-first: add fields to unredact
-tracker.setUnredactedFields(['#new-field', '.another-field']);
-// Visibility-first: add fields to redact
-tracker.setRedactedFields(['#sensitive-field', '.private-data']);
-// Clear all settings
-tracker.clearUnredactedFields(); // Privacy-first
-tracker.clearRedactedFields();   // Visibility-first
-```
-#### Security Features
-- **Password fields always protected** (cannot be unredacted in any mode)
-- **CSS selector validation** (prevents invalid selectors)
-- **Runtime safety checks** (handles DOM errors gracefully)
-### Debugging
-```javascript
-// View logs
-tracker.viewLogs();
-// Get connection status
-const status = tracker.getConnectionStatus();
-```
-### Error Suppression
-The SDK automatically suppresses common rrweb errors for a clean console:
-```javascript
-// Enable error suppression (default)
-const tracker = HumanBehaviorTracker.init('your-api-key', {
-    suppressConsoleErrors: true // Suppresses canvas security errors, CORS issues, etc.
-});
-// Disable error suppression for debugging
-const tracker = HumanBehaviorTracker.init('your-api-key', {
-    suppressConsoleErrors: false // Show all errors for debugging
-});
-```
-**Suppressed Errors:**
-- Canvas security errors (`SecurityError: Failed to execute 'toDataURL'`)
-- Cross-origin resource errors
-- CORS policy violations
-- Ad blocker interference warnings
-### Canvas Recording
-The SDK supports canvas recording with PostHog-style protection against overwhelming events:
-```javascript
-// Enable canvas recording with protection
-const tracker = HumanBehaviorTracker.init('your-api-key', {
-    recordCanvas: true // Enables canvas recording with 4 FPS throttle and 40% quality
-});
-```
-**Protection Features:**
-- **4 FPS Throttling**: Prevents canvas overwhelm (vs 60 FPS default)
-- **40% Quality**: WebP format with compression
-- **Opt-in Only**: Disabled by default for safety
-- **Smart Sampling**: Only captures when canvas changes
-## Session Continuity
-The SDK automatically handles session continuity:
-1. **Session Restoration**: Automatically restores sessions within 15 minutes
-2. **Activity Tracking**: Updates activity timestamp on user interactions
-3. **Cross-Page Persistence**: Session persists across page navigations
-## Demo
-Check out `simple-spa.html` for a complete single-page application demo that shows:
-- True session continuity across navigation
-- Interactive event tracking
-- Real-time status updates
-- Modern UI with smooth transitions
-## Troubleshooting
-### Ad Blocker Issues
-If you see `net::ERR_BLOCKED_BY_CLIENT` errors:
-1. Check if ad blockers are active
-2. Use `tracker.getConnectionStatus()` to diagnose
-3. Consider whitelisting your domain
-### Session Issues
-- Sessions automatically expire after 15 minutes of inactivity
-- Each page load calls `/init` but reuses existing sessions when possible
-- Check browser console for session restoration logs
-## Development
-```bash
-# Build the SDK
-npm run build
-# Watch for changes
-npm run dev
-# Run tests
-npm test
-# Run auto-installation
-npm run auto-install
-```
-## Auto-Installation Wizard
-The SDK includes an auto-installation wizard that can detect your project's framework and automatically modify your codebase to integrate the SDK.
-### CLI Usage
-```bash
-# Basic usage
-npx humanbehavior-js auto-install YOUR_API_KEY
-# With options
-npx humanbehavior-js auto-install YOUR_API_KEY --yes --project /path/to/project
-# Help
-npx humanbehavior-js auto-install --help
-```
-### React Component Usage
-```jsx
-import { AutoInstallWizard } from 'humanbehavior-js/react';
-function Dashboard() {
-  return (
-    <AutoInstallWizard
-      apiKey="your-api-key"
-      onComplete={(result) => console.log('Installation completed!', result)}
-      onError={(error) => console.error('Installation failed:', error)}
-    />
-  );
-}
-```
-### 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 wizard will automatically:
-1. Detect your project's framework and setup
-2. Install the humanbehavior-js package
-3. Modify your main app files to integrate the SDK
-4. Create environment files with your API key
-5. Make your app ready to track user behavior
-## Architecture
-- **Frontend**: TypeScript SDK with session restoration
-- **Backend**: Node.js ingestion server with Redis storage
-- **Archiver**: Processes completed sessions to S3 and Prisma
-- **Session Continuity**: localStorage + cookie-based session management