@eshal-bot/chat-widget 0.2.19 → 0.2.21

package/dist/chat-widget.esm.js

@@ -1 +1 @@
-export{e as default}from"./chat-widget-index-ClEAcv15.esm.js";import"react";import"react-dom/client";import"react/jsx-runtime";import"react-dom";
+export{e as default}from"./chat-widget-index-BcyXZWaW.esm.js";import"react";import"react-dom/client";import"react/jsx-runtime";import"react-dom";

package/dist/chat-widget.js

@@ -7955,6 +7955,22 @@
     }
   }
 
+  /** HTTP status the backend answers for an erased conversation. */
+  const CONVERSATION_ERASED_STATUS = 410;
+
+  /**
+   * Thrown when the conversation this widget holds was erased in the console
+   * ("Erase permanently", on the conversation or its contact). The backend
+   * answers every widget call on it with 410 `conversation_erased`; the caller
+   * starts a new conversation instead of treating it as a failed send.
+   */
+  class ConversationErasedError extends Error {
+    constructor(message = 'This conversation was erased') {
+      super(message);
+      this.name = 'ConversationErasedError';
+    }
+  }
+
   // ============================================================================
   // NETWORK
   // ============================================================================
@@ -7991,6 +8007,9 @@
         signal
       } : {})
     });
+    if (response.status === CONVERSATION_ERASED_STATUS) {
+      throw new ConversationErasedError();
+    }
     if (!response.ok) {
       throw new Error(`HTTP error! status: ${response.status}`);
     }
@@ -8372,7 +8391,13 @@
       stale: s.stale
     })).filter(s => s.source_id || s.url || s.source_type === 'database') : [];
   };
-  const processStream = async (stream, setMessages, onTerminal) => {
+
+  /**
+   * @param {Function} [onHumanHandoff] - called when the server answers with the
+   *   human_handoff marker: a person owns the conversation, so the caller starts
+   *   listening for their replies (and anything else pushed to the widget).
+   */
+  const processStream = async (stream, setMessages, onTerminal, onHumanHandoff) => {
     const updateMessage = createMessageUpdater(setMessages);
     const reader = stream.getReader();
     const decoder = new TextDecoder();
@@ -8490,6 +8515,7 @@
             // human agent's reply arrives via the SSE EventSource instead.
             if (parsed.type === 'human_handoff') {
               markTerminal();
+              if (typeof onHumanHandoff === 'function') onHumanHandoff();
               continue;
             }
 
@@ -12242,6 +12268,16 @@
       return generateWidgetSessionId();
     });
 
+    // Erase permanently (console): the conversation this widget holds was
+    // erased, and every widget call on it now answers 410 conversation_erased.
+    // Set below once resetConversation exists; the history fetch, the live
+    // stream, the hand-off and sendMessage all call it to start a new
+    // conversation instead of showing or reviving the erased one.
+    const conversationErasedRef = reactExports.useRef(() => {});
+    // The visitor's message whose send was refused because the conversation
+    // was erased. Re-sent on the new conversation once it exists.
+    const pendingResendRef = reactExports.useRef(null);
+
     // Handoff EventSource - receives human agent messages in real-time
     const handoffEventSourceRef = reactExports.useRef(null);
     const HANDOFF_TRIGGER = "Connect with a human representative";
@@ -12252,6 +12288,11 @@
     // over the SSE EventSource instead. The ref mirrors the state for a
     // synchronous read inside sendMessage (whose useCallback deps are fixed).
     const [isHandedOff, setIsHandedOff] = reactExports.useState(false);
+    // A rating an agent asked for from the Inbox (backend
+    // services/csatRequest.ts): { format, prompt, requestedAt }, or null. Set by
+    // the live csat_request event, or by /history when the widget was not
+    // listening at the time; the chat window shows its rating card for it.
+    const [csatRequest, setCsatRequest] = reactExports.useState(null);
     const isHandedOffRef = reactExports.useRef(false);
     const markHandedOff = reactExports.useCallback(() => {
       isHandedOffRef.current = true;
@@ -12413,6 +12454,10 @@
           headers,
           credentials: 'include'
         });
+        if (res.status === CONVERSATION_ERASED_STATUS) {
+          conversationErasedRef.current(null);
+          return;
+        }
         if (!res.ok) return;
         const data = await res.json();
         const serverMsgs = Array.isArray(data?.messages) ? data.messages : [];
@@ -12449,6 +12494,18 @@
       es.onmessage = event => {
         try {
           const data = JSON.parse(event.data);
+          // Erased in the console while open: stop listening and start over.
+          // An agent asked this visitor for a rating.
+          if (data.type === 'csat_request' && data.csat) {
+            setCsatRequest(data.csat);
+            return;
+          }
+          if (data.type === 'conversation_erased') {
+            es.close();
+            if (handoffEventSourceRef.current === es) handoffEventSourceRef.current = null;
+            conversationErasedRef.current(null);
+            return;
+          }
           if (data.type === 'message_created' && data.message) {
             // Advance the backfill watermark so a later reconnect doesn't
             // re-request everything we have already rendered live.
@@ -12729,10 +12786,18 @@
             headers,
             credentials: 'include'
           });
-          if (!res.ok || cancelled) return;
+          if (cancelled) return;
+          // Erased in the console: the saved transcript must not be shown.
+          if (res.status === CONVERSATION_ERASED_STATUS) {
+            conversationErasedRef.current(null);
+            return;
+          }
+          if (!res.ok) return;
           const data = await res.json();
           const serverMsgs = Array.isArray(data?.messages) ? data.messages : [];
           const agentMsgs = serverMsgs.filter(isRepliedOutsideStream);
+          // An open rating request sent while this widget was not listening.
+          if (!cancelled && data?.csatRequest) setCsatRequest(data.csatRequest);
 
           // Merge past human-agent replies into the transcript (regardless of
           // current responder - they're real history worth showing). Shares
@@ -12942,6 +13007,10 @@
               body: JSON.stringify({
                 reason: 'User clicked handoff button'
               })
+            }).then(res => {
+              // Erased: nobody to hand off to. Start a new conversation,
+              // where the visitor can ask for a person again.
+              if (res.status === CONVERSATION_ERASED_STATUS) conversationErasedRef.current(null);
             }).catch(() => {});
           }
         };
@@ -13184,6 +13253,8 @@
               if (done) break;
             }
           } catch (err) {
+            // Erased: handled once, below, like any other send.
+            if (err instanceof ConversationErasedError) throw err;
             // L4: this catch used to swallow the failure - but in a handed-off
             // conversation this POST is the ONLY path to the human agent, so a
             // dropped send meant the customer's message never reached anyone
@@ -13217,7 +13288,14 @@
               // it unable to type their next question. Retries are unaffected:
               // IncompleteStreamError is only thrown when NO terminal event
               // arrived, so nothing that reaches this callback is ever retried.
-              await processStream(stream, setMessages, releaseComposer);
+              await processStream(stream, setMessages, releaseComposer, () => {
+                // The server says a person owns this conversation (an agent
+                // took it over from the Inbox): listen for their replies, as
+                // the hand-off path already expects, with EV-4047's backfill
+                // catching anything sent before the stream opened.
+                markHandedOff();
+                void startHandoffEventSource();
+              });
               setUserMessageStatus(sentUserMessageId, "sent");
               updateActivity(organizationId);
               return {
@@ -13265,6 +13343,21 @@
           success: true
         };
       } catch (error) {
+        // Erased in the console: not a failed send. Start a new conversation
+        // and send this message again there, with no error bubble.
+        if (error instanceof ConversationErasedError) {
+          const isChat = apiType === 'inquiry' || apiType === 'complaint' || apiType === 'technical';
+          conversationErasedRef.current(isChat ? {
+            text: trimmed,
+            attachments: attachmentsPayload,
+            sessionId: bidiSessionId
+          } : null);
+          return {
+            success: false,
+            error: 'conversation_erased',
+            erased: true
+          };
+        }
         console.error("Error sending message:", error);
         if (apiType === 'inquiry' || apiType === 'complaint' || apiType === 'technical') {
           setIsLoading(false);
@@ -13317,6 +13410,16 @@
     // bubble first, then routes back through sendMessage so the retry gets the
     // full pipeline (concurrency guard, stream retries, delivery state) instead
     // of a bespoke resend path.
+    // A send refused because the conversation was erased goes out again on the
+    // new conversation, once the reset has rotated the session id.
+    reactExports.useEffect(() => {
+      const pending = pendingResendRef.current;
+      if (!pending || pending.sessionId === bidiSessionId) return;
+      pendingResendRef.current = null;
+      void sendMessage(pending.text, undefined, {
+        attachments: pending.attachments
+      });
+    }, [bidiSessionId, sendMessage]);
     const retryMessage = reactExports.useCallback(failedMessage => {
       if (!failedMessage || failedMessage.status !== 'failed') {
         return Promise.resolve({
@@ -14618,6 +14721,8 @@
       // Reset messages
       setMessages([]);
       setBidiMessages([]);
+      // The rating request belonged to the conversation being left.
+      setCsatRequest(null);
 
       // Drop the localStorage transcript for the conversation we're abandoning
       // BEFORE we rotate to a fresh sessionId, otherwise the old bucket leaks.
@@ -14688,6 +14793,22 @@
       resetConversationRef.current = resetConversation;
     }, [resetConversation]);
 
+    // The conversation was erased in the console: drop the saved transcript and
+    // start a new conversation, the same reset as after CSAT. Idempotent per
+    // conversation id, since the history fetch, the stream and a send can all
+    // learn it at once. `resend` is the visitor's refused message, sent again
+    // on the new conversation unless onboarding has to run first.
+    const erasedHandledForRef = reactExports.useRef(null);
+    reactExports.useEffect(() => {
+      conversationErasedRef.current = resend => {
+        if (erasedHandledForRef.current === bidiSessionId) return;
+        erasedHandledForRef.current = bidiSessionId;
+        const needsOnboarding = onboardingEnabled && getOnboardingQuestions(onboardingQuestions).length > 0;
+        pendingResendRef.current = resend && !needsOnboarding ? resend : null;
+        resetConversationRef.current();
+      };
+    }, [bidiSessionId, onboardingEnabled, onboardingQuestions]);
+
     // Precise inactivity timeout: schedules a setTimeout for exact remaining time,
     // then reschedules itself after each check (handles activity updates in localStorage).
     //
@@ -14850,7 +14971,9 @@
       // Session lifecycle
       sessionExpiringSoon,
       resetConversation,
-      updateMessageFeedback
+      updateMessageFeedback,
+      // Rating request from the Inbox (null when none is open).
+      csatRequest
     };
   };
 
@@ -20627,6 +20750,9 @@
     csatEnabled = false,
     csatFormat = "EMOJI",
     csatPrompt = "How was your experience?",
+    // A rating an agent asked for from the Inbox: { format, prompt } or null.
+    // Shown whether or not the automatic survey (csatEnabled) is on.
+    csatRequest = null,
     onPromptSuggestionClick,
     onboardingEnabled = false,
     onResetConversation,
@@ -20941,7 +21067,7 @@
     const handleCsatRating = async (rating, format) => {
       setCsatSubmitted(true); // optimistic UI
       setShowCsat(false);
-      markCsatSubmitted(undefined); // persist so page refresh doesn't re-show CSAT
+      markCsatSubmitted(organizationId); // persist so page refresh doesn't re-show CSAT
 
       try {
         const headers = {
@@ -21419,11 +21545,12 @@
                   label: t("chooseTopicLabel")
                 }) : null,
                 quickQuestionsHeadingLabel: filterEnabled ? t("quickQuestionsHeadingLabel") : undefined
-              }), showCsat && csatEnabled && !csatSubmitted && /*#__PURE__*/jsxRuntimeExports.jsx("div", {
+              }), (showCsat && csatEnabled || csatRequest) && !csatSubmitted && /*#__PURE__*/jsxRuntimeExports.jsx("div", {
                 className: "",
+                "data-testid": "widget-csat-card",
                 children: /*#__PURE__*/jsxRuntimeExports.jsx(CSATWidget, {
-                  format: normalizeCsatFormat(csatFormat),
-                  prompt: csatPrompt || t("howWasYourExperience"),
+                  format: normalizeCsatFormat(csatRequest?.format || csatFormat),
+                  prompt: csatRequest?.prompt || csatPrompt || t("howWasYourExperience"),
                   onRating: handleCsatRating,
                   disabled: false,
                   isDark: isDark,
@@ -21773,7 +21900,7 @@
    * value by its own test (that constant sat at 0.1.113 while this package was
    * at 0.2.2 precisely because nothing enforced it - EV-2431).
    */
-  const WIDGET_VERSION = '0.2.19';
+  const WIDGET_VERSION = '0.2.21';
 
   /**
    * API utility functions
@@ -22180,7 +22307,8 @@
       // CategoryTabsBar / CategoryFilterInline components in ChatWindow.
       widgetFilter,
       setWidgetFilter,
-      addAssistantMessage
+      addAssistantMessage,
+      csatRequest
     } = useChatState(widgetConfig ? {
       welcomeMessage: widgetConfig.welcomeMessage,
       // Per the EV-3813 note below, this hook produces customer-facing
@@ -22403,6 +22531,7 @@
           csatEnabled: widgetConfig.csatEnabled,
           csatFormat: widgetConfig.csatFormat,
           csatPrompt: widgetConfig.csatPrompt,
+          csatRequest: csatRequest,
           onboardingEnabled: widgetConfig.onboardingEnabled,
           onResetConversation: resetConversation,
           sessionExpiringSoon: sessionExpiringSoon,