humanbehavior-js 0.1.9 → 0.2.1

package/dist/types/index.d.ts

@@ -186,18 +186,31 @@ declare class HumanBehaviorTracker {
     private trackConsoleEvent;
     private setupPageUnloadHandler;
     viewLogs(): void;
-    addUserInfo(userProperties: Record<string, any>): Promise<void>;
+    addUserInfo({ userId, userProperties }: {
+        userId: string;
+        userProperties: Record<string, any>;
+    }): Promise<void>;
     /**
-     * Authenticate user using existing userInfo data
+     * Add user identification information to the tracker
      * @param authFields Array of field names to check for existing users (e.g., ['email', 'phoneNumber'])
      */
-    auth(authFields: string[]): Promise<void>;
+    private auth;
     start(): Promise<void>;
     stop(): Promise<void>;
     addEvent(event: any): Promise<void>;
     private flush;
     private setCookie;
     getCookie(name: string): string | null;
+    /**
+     * Delete a cookie by setting its expiration date to the past
+     * @param name The name of the cookie to delete
+     */
+    private deleteCookie;
+    /**
+     * Log out the current user by clearing all user-related data
+     * This will delete the user ID cookie, clear localStorage, and reset user properties
+     */
+    logout(): void;
     /**
      * Start redaction functionality for sensitive input fields
      * @param options Optional configuration for redaction behavior
@@ -314,5 +327,9 @@ declare const logWarn: (message: string, ...args: any[]) => void;
 declare const logInfo: (message: string, ...args: any[]) => void;
 declare const logDebug: (message: string, ...args: any[]) => void;
 
+/**
+ * Main entry point for the HumanBehavior SDK
+ */
+
 export { HumanBehaviorAPI, HumanBehaviorTracker, LogLevel, MAX_CHUNK_SIZE_BYTES, RedactionManager, HumanBehaviorTracker as default, isChunkSizeExceeded, logDebug, logError, logInfo, logWarn, logger, redactionManager, splitLargeEvent, validateSingleEventSize };
 export type { LoggerConfig, RedactionOptions };

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

@@ -1,4 +1,5 @@
-import React, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
 import { HumanBehaviorTracker } from '..';
 export { HumanBehaviorTracker } from '..';
 
@@ -12,7 +13,21 @@ interface HumanBehaviorProviderProps {
         redactFields?: string[];
     };
 }
-declare const HumanBehaviorProvider: ({ apiKey, client, children, options }: HumanBehaviorProviderProps) => React.JSX.Element;
+declare const HumanBehaviorProvider: ({ apiKey, client, children, options }: HumanBehaviorProviderProps) => react_jsx_runtime.JSX.Element;
 declare const useHumanBehavior: () => HumanBehaviorTracker;
+declare const useRedaction: () => {
+    setRedactedFields: (fields: string[]) => void;
+    isRedactionActive: () => boolean;
+    getRedactedFields: () => string[];
+};
+declare const useUserTracking: () => {
+    addUserInfo: (userId: string, userProperties: Record<string, any>) => Promise<{
+        success: boolean;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: unknown;
+    }>;
+};
 
-export { HumanBehaviorProvider, useHumanBehavior };
+export { HumanBehaviorProvider, useHumanBehavior, useRedaction, useUserTracking };

package/package.json

@@ -1,37 +1,50 @@
 {
   "name": "humanbehavior-js",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "SDK for HumanBehavior session and event recording",
   "type": "module",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/types/index.d.ts",
   "unpkg": "dist/index.min.js",
+  "jsdelivr": "dist/index.min.js",
   "homepage": "https://documentation.humanbehavior.co",
   "exports": {
     ".": {
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js",
-      "types": "./dist/types/index.d.ts"
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/esm/index.js"
     },
     "./react": {
       "import": "./dist/esm/react/index.js",
       "require": "./dist/cjs/react/index.js",
-      "types": "./dist/types/react/index.d.ts"
-    }
+      "types": "./dist/types/react/index.d.ts",
+      "default": "./dist/esm/react/index.js"
+    },
+    "./package.json": "./package.json"
   },
+  "files": [
+    "dist/**/*",
+    "src/**/*",
+    "*.d.ts"
+  ],
   "scripts": {
     "build": "rollup -c",
     "build:dev": "rollup -c --environment NODE_ENV:development",
     "prepare": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node scripts/test-bundlers.js",
+    "test:bundlers": "node scripts/test-bundlers.js",
+    "test:framework": "node scripts/test-framework-compatibility.js",
+    "test:all": "npm run test:bundlers && npm run test:framework"
   },
   "author": "Chirag Kawediya, Skyler Ji, Amogh Chaturvedi",
   "license": "ISC",
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
   "dependencies": {
-    "@types/react": "^19.0.12",
-    "humanbehavior-js": "^0.0.9",
-    "react": "^19.0.0",
     "rrweb": "^2.0.0-alpha.4",
     "uuid": "^11.1.0"
   },
@@ -41,6 +54,8 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.2",
     "@types/node": "^24.0.3",
+    "@types/react": "^19.0.12",
+    "@types/react-dom": "^19.0.0",
     "rollup": "^4.36.0",
     "rollup-plugin-dts": "^6.2.1",
     "tslib": "^2.8.1",
@@ -57,6 +72,13 @@
     "session-recording",
     "analytics",
     "rrweb",
-    "koalaware"
-  ]
+    "koalaware",
+    "webpack",
+    "esbuild",
+    "vite",
+    "rollup"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  }
 }

package/src/api.ts

@@ -1,4 +1,4 @@
-import { logError, logInfo } from './utils/logger';
+import { logError, logInfo, logDebug } from './utils/logger';
 
 export const MAX_CHUNK_SIZE_BYTES = 1024 * 1024; // 1MB chunk size - more conservative
 
@@ -278,7 +278,8 @@ export class HumanBehaviorAPI {
         const payload = {
             sessionId: sessionId,
             events: events,
-            endUserId: null // Beacon doesn't have user context
+            endUserId: null, // Beacon doesn't have user context
+            apiKey: this.apiKey // Include API key in body since beacon can't use headers
         };
 
         // Convert to Blob for sendBeacon
@@ -295,6 +296,7 @@ export class HumanBehaviorAPI {
     }
 
     async sendCustomEvent(sessionId: string, eventName: string, eventProperties?: Record<string, any>) {
+        logInfo('[SDK] Sending custom event', { sessionId, eventName, eventProperties });
         try {
             const response = await fetch(`${this.baseUrl}/api/ingestion/customEvent`, {
                 method: 'POST',
@@ -308,14 +310,17 @@ export class HumanBehaviorAPI {
                     eventProperties: eventProperties || {}
                 })
             });
-            
+            logInfo('[SDK] Custom event response', { status: response.status, statusText: response.statusText });
             if (!response.ok) {
-                throw new Error(`Failed to send custom event: ${response.status} ${response.statusText}`);
+                const errorText = await response.text();
+                logError('[SDK] Failed to send custom event', { status: response.status, statusText: response.statusText, errorText });
+                throw new Error(`Failed to send custom event: ${response.status} ${response.statusText} - ${errorText}`);
             }
-            
-            return await response.json();
+            const json = await response.json();
+            logDebug('[SDK] Custom event success', json);
+            return json;
         } catch (error) {
-            logError('Error sending custom event:', error);
+            logError('[SDK] Error sending custom event', error, { sessionId, eventName, eventProperties });
             throw error;
         }
     }

package/src/index.ts

@@ -16,8 +16,8 @@ export * from './redact';
 // Export logger functionality
 export * from './utils/logger';
 
-// Also export the tracker as the default export
-export { HumanBehaviorTracker as default } from './tracker';
+// Export the tracker as the default export
+export default HumanBehaviorTracker;
 
 // For UMD builds, expose the main class globally
 if (typeof window !== 'undefined') {

package/src/react/index.tsx

@@ -120,14 +120,18 @@ export const HumanBehaviorProvider = ({ apiKey, client, children, options }: Hum
       // Process any queued events
       const currentQueue = eventQueueRef.current;
       if (currentQueue.length > 0) {
-        currentQueue.forEach(event => {
+        for (const event of currentQueue) {
           if (event.type === 'identify') {
             logDebug('Processing queued identify event', event.userProperties);
-            tracker.addUserInfo(event.userProperties);
+            try {
+              await tracker.addUserInfo(event.userProperties);
+            } catch (error) {
+              logError('Failed to process queued user info:', error);
+            }
           } else {
             tracker.addEvent(event);
           }
-        });
+        }
         setEventQueue([]); // Clear the queue
       }
     }).catch(error => {
@@ -200,6 +204,48 @@ export const useHumanBehavior = () => {
   return tracker;
 };
 
+// Custom hook for managing redaction fields dynamically
+export const useRedaction = () => {
+  const tracker = useHumanBehavior();
+  
+  const setRedactedFields = useCallback((fields: string[]) => {
+    tracker.setRedactedFields(fields);
+  }, [tracker]);
+  
+  const isRedactionActive = useCallback(() => {
+    return tracker.isRedactionActive();
+  }, [tracker]);
+  
+  const getRedactedFields = useCallback(() => {
+    return tracker.getRedactedFields();
+  }, [tracker]);
+  
+  return {
+    setRedactedFields,
+    isRedactionActive,
+    getRedactedFields
+  };
+};
+
+// Custom hook for managing user info
+export const useUserTracking = () => {
+  const tracker = useHumanBehavior();
+  
+  const addUserInfo = useCallback(async (userId: string, userProperties: Record<string, any>) => {
+    try {
+      await tracker.addUserInfo({ userId, userProperties });
+      return { success: true };
+    } catch (error) {
+      logError('Failed to add user info:', error);
+      return { success: false, error };
+    }
+  }, [tracker]);
+  
+  return {
+    addUserInfo
+  };
+};
+
 // Automatic page tracking component (similar to PostHog's PostHogPageView)
 function HumanBehaviorPageView() {
   const tracker = useContext(HumanBehaviorContext);

package/src/tracker.ts

@@ -717,30 +717,31 @@ export class HumanBehaviorTracker {
         }
     }
 
-    public async addUserInfo(userProperties: Record<string, any>) {
+    public async addUserInfo(
+        { userId, userProperties }: { userId: string, userProperties: Record<string, any> }
+    ) {
         await this.ensureInitialized();
         if (!this.endUserId) {
             throw new Error('Cannot add user info before tracker initialization');
         }
         this.userProperties = userProperties;
         await this.api.sendUserData(this.endUserId, userProperties, this.sessionId);
+        if (userId) {
+            this.endUserId = userId;
+        }
     }
 
     /**
-     * Authenticate user using existing userInfo data
+     * Add user identification information to the tracker
      * @param authFields Array of field names to check for existing users (e.g., ['email', 'phoneNumber'])
      */
-    public async auth(authFields: string[]) {
+    private async auth(id: string) {
         await this.ensureInitialized();
         if (!this.endUserId) {
             throw new Error('Cannot authenticate before tracker initialization');
         }
-        if (!this.userProperties || Object.keys(this.userProperties).length === 0) {
-            throw new Error('No user info available. Call addUserInfo() first.');
-        }
-        const response = await this.api.sendUserAuth(this.endUserId, this.userProperties, this.sessionId, authFields);
+        const response = await this.api.sendUserAuth(this.endUserId, { id }, this.sessionId, ["id"]);
         if (response && response.userId && response.userId !== this.endUserId) {
-            // Update endUserId and cookie if backend returns a new userId
             this.endUserId = response.userId;
             this.setCookie(`human_behavior_end_user_id_${this.apiKey}`, response.userId, 365);
         }
@@ -903,6 +904,56 @@ export class HumanBehaviorTracker {
         }
     }
 
+    /**
+     * Delete a cookie by setting its expiration date to the past
+     * @param name The name of the cookie to delete
+     */
+    private deleteCookie(name: string) {
+        if (!isBrowser) return;
+        
+        try {
+            // Delete cookie by setting expiration to past
+            document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/; SameSite=Lax`;
+            logDebug(`Deleted cookie: ${name}`);
+        } catch (error) {
+            logError(`Failed to delete cookie: ${name}`, error);
+        }
+        
+        // Also remove from localStorage
+        try {
+            localStorage.removeItem(name);
+            logDebug(`Removed from localStorage: ${name}`);
+        } catch (error) {
+            logError(`Failed to remove from localStorage: ${name}`, error);
+        }
+    }
+
+    /**
+     * Log out the current user by clearing all user-related data
+     * This will delete the user ID cookie, clear localStorage, and reset user properties
+     */
+    public logout(): void {
+        if (!isBrowser) return;
+        
+        try {      
+            // Clear user ID cookie and localStorage
+            const userIdCookieName = `human_behavior_end_user_id_${this.apiKey}`;
+            this.deleteCookie(userIdCookieName);
+            
+            // Clear session data from localStorage
+            localStorage.removeItem('human_behavior_session_id');
+            localStorage.removeItem('human_behavior_last_activity');
+            
+            // Reset user-related properties
+            this.endUserId = null;
+            this.userProperties = {};
+            
+            logInfo('User logged out - cleared all user data and cookies');
+        } catch (error) {
+            logError('Error during logout:', error);
+        }
+    }
+
     /**
      * Start redaction functionality for sensitive input fields
      * @param options Optional configuration for redaction behavior

package/rollup.config.js

@@ -1,106 +0,0 @@
-import typescript from '@rollup/plugin-typescript';
-import resolve from '@rollup/plugin-node-resolve';
-import commonjs from '@rollup/plugin-commonjs';
-import terser from '@rollup/plugin-terser';
-import dts from 'rollup-plugin-dts';
-
-// Only React should be external since it's typically provided by the host application
-const external = ['react', 'react-dom'];
-
-// Global variables for UMD build
-const globals = {
-  react: 'React',
-  'react-dom': 'ReactDOM'
-};
-
-export default [
-  // Main SDK bundle
-  {
-    input: 'src/index.ts',
-    output: [
-      {
-        file: 'dist/cjs/index.js',
-        format: 'cjs',
-        name: 'HumanBehaviorTracker',
-        globals,
-        exports: 'named',
-        sourcemap: true
-      },
-      {
-        file: 'dist/esm/index.js',
-        format: 'es',
-        sourcemap: true
-      },
-      {
-        file: 'dist/index.min.js',
-        format: 'umd',
-        name: 'HumanBehaviorTracker',
-        globals,
-        exports: 'auto',
-        sourcemap: true,
-        plugins: [terser()]
-      }
-    ],
-    plugins: [
-      resolve(),
-      commonjs(),
-      typescript({
-        tsconfig: './tsconfig.json',
-        declaration: false
-      })
-    ],
-    external
-  },
-  
-  // React component bundle
-  {
-    input: './src/react/index.tsx',
-    output: [
-      {
-        file: 'dist/cjs/react/index.js',
-        format: 'cjs',
-        name: 'HumanBehaviorReact',
-        globals: {
-          ...globals,
-          '..': 'HumanBehaviorTracker'
-        },
-        exports: 'named',
-        sourcemap: true
-      },
-      {
-        file: 'dist/esm/react/index.js',
-        format: 'es',
-        sourcemap: true
-      }
-    ],
-    plugins: [
-      resolve(),
-      commonjs(),
-      typescript({
-        tsconfig: './tsconfig.json',
-        declaration: false
-      })
-    ],
-    external: [...external, '..']
-  },
-  
-  // Type definition bundles - generate these separately
-  {
-    input: 'src/index.ts',
-    output: {
-      file: 'dist/types/index.d.ts',
-      format: 'es'
-    },
-    plugins: [dts()],
-    external
-  },
-  {
-    input: 'src/react/index.tsx',
-    output: {
-      file: 'dist/types/react/index.d.ts',
-      format: 'es'
-    },
-    plugins: [dts()],
-    external: [...external, '..']
-  }
-]; 

package/simple-demo.html

@@ -1,26 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>HumanBehavior Simple Demo</title>
-</head>
-<body>
-    <h1>HumanBehavior Tracker Demo</h1>
-    <p>This page initializes the HumanBehavior tracker. Check the console for status.</p>
-    
-    <button>Click me to test recording</button>
-    <input type="text" placeholder="Type something">
-    <input type="password" placeholder="Password (will be redacted)">
-
-    <script src="./dist/index.min.js"></script>
-    <script>
-        // Initialize the tracker
-        const tracker = HumanBehaviorTracker.init('13c3e029-ca45-4a3c-a33b-f5dcb297e31c', {
-            redactFields: ['input[type="password"]']
-        });
-        
-        console.log('HumanBehavior tracker initialized:', tracker);
-    </script>
-</body>
-</html>