humanbehavior-js 0.2.7 → 0.2.8

package/dist/types/index.d.ts

@@ -213,8 +213,9 @@ declare class HumanBehaviorTracker {
      */
     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
+     * Clear user data and reset session when user signs out of the site
+     * This should be called when a user logs out of your application to prevent
+     * data contamination between different users
      */
     logout(): void;
     /**
@@ -309,6 +310,25 @@ declare class HumanBehaviorAPI {
     }>): Promise<any>;
 }
 
+/**
+ * Server-side utilities for HumanBehavior SDK
+ */
+interface ServerSideUserData {
+    email: string;
+    name?: string;
+    image?: string;
+    provider?: string;
+    [key: string]: any;
+}
+/**
+ * Identify user from server-side (NextAuth, Firebase, etc.)
+ * Use this in your auth events to track users immediately on sign-in
+ */
+declare function identifyUser(userData: ServerSideUserData, apiKey: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+
 declare enum LogLevel {
     NONE = 0,
     ERROR = 1,
@@ -342,5 +362,5 @@ declare const logWarn: (message: string, ...args: any[]) => void;
 declare const logInfo: (message: string, ...args: any[]) => void;
 declare const logDebug: (message: string, ...args: any[]) => void;
 
-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 };
+export { HumanBehaviorAPI, HumanBehaviorTracker, LogLevel, MAX_CHUNK_SIZE_BYTES, RedactionManager, HumanBehaviorTracker as default, identifyUser, isChunkSizeExceeded, logDebug, logError, logInfo, logWarn, logger, redactionManager, splitLargeEvent, validateSingleEventSize };
+export type { LoggerConfig, RedactionOptions, ServerSideUserData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanbehavior-js",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "SDK for HumanBehavior session and event recording",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/src/index.ts

@@ -13,6 +13,9 @@ export * from './api';
 // Export redaction functionality
 export * from './redact';
 
+// Export server-side utilities
+export * from './server';
+
 // Export logger functionality
 export * from './utils/logger';
 

package/src/react/index.tsx

@@ -11,6 +11,7 @@ interface HumanBehaviorInterface {
   addUserInfo: ({ userId, userProperties }: { userId?: string, userProperties: Record<string, any> }) => Promise<string>;
   start: () => void;
   stop: () => void;
+  logout: () => void;
   viewLogs: () => void;
 }
 
@@ -173,6 +174,7 @@ const defaultImplementation: HumanBehaviorInterface = {
   },
   start: () => {},
   stop: () => {},
+  logout: () => {},
   viewLogs: () => {},
 };
 
@@ -195,6 +197,9 @@ const createQueuingImplementation = (queueEvent: (event: any) => void): HumanBeh
   stop: () => {
     // Stop is a no-op when not initialized
   },
+  logout: () => {
+    // Logout is a no-op when not initialized
+  },
   viewLogs: () => {
     logWarn('Logs are not available until HumanBehaviorTracker is initialized');
   }

package/src/server.ts

@@ -0,0 +1,51 @@
+/**
+ * Server-side utilities for HumanBehavior SDK
+ */
+
+export interface ServerSideUserData {
+  email: string;
+  name?: string;
+  image?: string;
+  provider?: string;
+  [key: string]: any; // Allow additional properties
+}
+
+/**
+ * Identify user from server-side (NextAuth, Firebase, etc.)
+ * Use this in your auth events to track users immediately on sign-in
+ */
+export async function identifyUser(
+  userData: ServerSideUserData,
+  apiKey: string
+): Promise<{ success: boolean; error?: string }> {
+  try {
+    const response = await fetch('https://ingest.humanbehavior.co/api/ingestion/user', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`
+      },
+      body: JSON.stringify({
+        userId: userData.email,
+        userAttributes: userData,
+        sessionId: null, // Will be set by client-side session recording
+        posthogName: userData.email || userData.name || null // Update posthogName with email
+      })
+    });
+    
+    if (!response.ok) {
+      const errorText = await response.text();
+      return { 
+        success: false, 
+        error: `Failed to identify user: ${response.status} ${response.statusText} - ${errorText}` 
+      };
+    }
+    
+    return { success: true };
+  } catch (error) {
+    return { 
+      success: false, 
+      error: error instanceof Error ? error.message : 'Unknown error' 
+    };
+  }
+} 

package/src/tracker.ts

@@ -1008,8 +1008,9 @@ export class HumanBehaviorTracker {
     }
 
     /**
-     * Log out the current user by clearing all user-related data
-     * This will delete the user ID cookie, clear localStorage, and reset user properties
+     * Clear user data and reset session when user signs out of the site
+     * This should be called when a user logs out of your application to prevent
+     * data contamination between different users
      */
     public logout(): void {
         if (!isBrowser) return;
@@ -1027,7 +1028,14 @@ export class HumanBehaviorTracker {
             this.endUserId = null;
             this.userProperties = {};
             
-            logInfo('User logged out - cleared all user data and cookies');
+            // Generate a new session ID for the next user
+            this.sessionId = uuidv1();
+            if (isBrowser) {
+                localStorage.setItem('human_behavior_session_id', this.sessionId);
+                localStorage.setItem('human_behavior_last_activity', Date.now().toString());
+            }
+            
+            logInfo('User logged out - cleared all user data and started fresh session');
         } catch (error) {
             logError('Error during logout:', error);
         }