@ihoomanai/chat-widget 3.0.11 → 3.0.13

package/src/types.ts

@@ -606,6 +606,7 @@ export type WidgetEvent =
   | 'connection:change'
   | 'newConversation'
   | 'escalation:start'
+  | 'escalation:accepted'
   | 'escalation:end'
   | 'survey:shown'
   | 'survey:submitted'

package/src/widget.ts

@@ -17,7 +17,7 @@ import type {
   WidgetView,
 } from './types';
 
-const VERSION = '3.0.11';
+const VERSION = '3.0.13';
 const STORAGE_PREFIX = 'ihooman_chat_';
 const DEFAULT_SERVER_URL = 'https://api.ihooman.ai';
 
@@ -197,6 +197,32 @@ function emit(event: WidgetEvent, data?: unknown): void {
   }
 }
 
+/**
+ * Track an analytics event to the server
+ */
+async function trackAnalyticsEvent(
+  eventType: string,
+  metadata?: Record<string, unknown>
+): Promise<void> {
+  if (!config.widgetId || !config.serverUrl) return;
+  
+  try {
+    const url = `${config.serverUrl}/widget-analytics/track?widget_id=${encodeURIComponent(config.widgetId)}`;
+    await fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        event_type: eventType,
+        session_id: state.sessionId,
+        visitor_id: state.visitorId,
+        metadata: metadata || {},
+      }),
+    });
+  } catch (e) {
+    console.debug('[IhoomanChat] Failed to track event:', eventType, e);
+  }
+}
+
 function getCurrentScrollDepth(): number {
   const scrollTop = window.scrollY || document.documentElement.scrollTop;
   const scrollHeight = document.documentElement.scrollHeight - window.innerHeight;
@@ -557,6 +583,11 @@ function setupEventListeners(): void {
   const proactiveSecondaryBtn = elements.proactiveToast?.querySelector('.ihooman-proactive-toast-btn.secondary');
   if (proactivePrimaryBtn) {
     proactivePrimaryBtn.addEventListener('click', () => {
+      // Track click for the most recently shown proactive message
+      const lastShownId = shownProactiveIds[shownProactiveIds.length - 1];
+      if (lastShownId) {
+        trackAnalyticsEvent('proactive_clicked', { message_id: lastShownId });
+      }
       hideProactiveToast();
       open();
       emit('proactive:clicked');
@@ -1052,6 +1083,15 @@ async function handleSurveySubmit(): Promise<void> {
       }),
     });
     
+    // Track survey submission analytics
+    trackAnalyticsEvent('survey_submitted', {
+      survey_id: config.surveyConfig?.id,
+      rating,
+      comment: comment || null,
+      session_id: state.sessionId,
+      visitor_id: state.visitorId,
+    });
+    
     // Mark survey as completed for this session
     storage('survey_completed_' + state.sessionId, true);
     
@@ -1076,6 +1116,13 @@ function checkAndShowSurvey(): void {
   // Don't show if not enough messages (at least 2 exchanges)
   if (state.messages.length < 4) return;
   
+  // Track survey displayed analytics
+  trackAnalyticsEvent('survey_displayed', {
+    survey_id: config.surveyConfig.id,
+    session_id: state.sessionId,
+    visitor_id: state.visitorId,
+  });
+  
   // Show the survey
   showView('survey');
   emit('survey:shown', config.surveyConfig);
@@ -1089,6 +1136,15 @@ function showSurvey(): void {
     console.warn('[IhoomanChat] No survey configured');
     return;
   }
+  
+  // Track survey displayed analytics
+  trackAnalyticsEvent('survey_displayed', {
+    survey_id: config.surveyConfig.id,
+    session_id: state.sessionId,
+    visitor_id: state.visitorId,
+    trigger: 'manual',
+  });
+  
   showView('survey');
   emit('survey:shown', config.surveyConfig);
 }
@@ -1122,6 +1178,14 @@ function handleSendClick(): void {
   if (elements.sendBtn) elements.sendBtn.disabled = true;
 
   addMessage(content, 'user');
+  
+  // Track message sent analytics
+  trackAnalyticsEvent('message_sent', {
+    session_id: state.sessionId,
+    visitor_id: state.visitorId,
+    message_length: content.length,
+  });
+  
   showTyping();
   sendMessageToServer(content);
 }
@@ -1163,6 +1227,15 @@ async function sendMessageToServer(content: string): Promise<void> {
         escalation_offered: data.escalation_offered,
         quick_replies: data.quick_replies,
       });
+      
+      // Track message received analytics
+      trackAnalyticsEvent('message_received', {
+        session_id: state.sessionId,
+        visitor_id: state.visitorId,
+        message_length: data.response.length,
+        has_sources: !!data.sources,
+        confidence: data.confidence,
+      });
     }
   } catch (error) {
     hideTyping();
@@ -1300,6 +1373,9 @@ function showProactiveMessage(pm: ProactiveMessage): void {
   storage('shown_proactive', shownProactiveIds);
   storage('proactive_cooldowns', proactiveCooldowns);
   
+  // Track analytics event
+  trackAnalyticsEvent('proactive_displayed', { message_id: pm.id });
+  
   // Show toast
   if (elements.proactiveToast) {
     const content = elements.proactiveToast.querySelector('.ihooman-proactive-toast-content');
@@ -1422,17 +1498,55 @@ function connectWebSocket(chatEndpoint?: string): void {
         } else if (data.type === 'message') {
           hideTyping();
           const sender = data.sender === 'user' ? 'user' : 'bot';
+          
+          // Check if this is an agent-related system message
+          const metadata = data.metadata || {};
+          if (metadata.agent_accepted) {
+            // Agent has accepted the escalation - update status
+            isLiveAgentMode = true;
+            updateStatusBar('connected', '🟢 Connected to live agent');
+            emit('escalation:accepted', { type: 'live_agent' });
+          }
+          if (metadata.closed_by_agent) {
+            // Agent has closed the conversation - return to AI mode
+            isLiveAgentMode = false;
+            stopLiveAgentPolling();
+            updateStatusBar('hidden');
+            emit('escalation:end', { type: 'live_agent' });
+          }
+          
+          // Track message received analytics
+          trackAnalyticsEvent('message_received', {
+            session_id: state.sessionId,
+            visitor_id: state.visitorId,
+            sender: data.sender,
+            is_system_message: metadata.is_system_message || false,
+          });
+          
           addMessage(data.content, sender, {
             confidence: data.confidence,
             agent_name: data.agent_name,
             escalation_offered: data.escalation_offered,
             escalated: data.escalated,
             quick_replies: data.quick_replies,
+            ...metadata,
           });
         } else if (data.type === 'typing') {
           data.is_typing ? showTyping() : hideTyping();
         } else if (data.type === 'pong') {
           // Heartbeat response
+        } else if (data.type === 'agent_status') {
+          // Handle agent status updates
+          if (data.status === 'connected') {
+            isLiveAgentMode = true;
+            updateStatusBar('connected', '🟢 Connected to live agent');
+            emit('escalation:accepted', { type: 'live_agent' });
+          } else if (data.status === 'disconnected') {
+            isLiveAgentMode = false;
+            stopLiveAgentPolling();
+            updateStatusBar('hidden');
+            emit('escalation:end', { type: 'live_agent' });
+          }
         } else if (data.type === 'error') {
           console.error('WebSocket server error:', data.message);
           emit('error', { message: data.message });
@@ -1504,6 +1618,10 @@ function open(): void {
   
   hideProactiveToast();
   setTimeout(() => elements.input?.focus(), 300);
+  
+  // Track widget open event
+  trackAnalyticsEvent('widget_open');
+  
   emit('open');
 }
 
@@ -1514,6 +1632,9 @@ function close(): void {
   if (elements.toggle) elements.toggle.classList.remove('open');
   if (elements.window) elements.window.classList.remove('open');
   
+  // Track widget close event
+  trackAnalyticsEvent('widget_close');
+  
   // Check if we should show survey after closing (if conversation had enough messages)
   if (config.surveyConfig && state.messages.length >= 4) {
     const surveyCompleted = state.sessionId && storage<boolean>('survey_completed_' + state.sessionId);