@xapp/chat-widget 1.87.0 → 1.87.1

package/dist/index.es.js

@@ -1,4 +1,4 @@
-import require$$1, { useCallback, useState, useEffect, useRef, createContext, useContext, useMemo, memo, useLayoutEffect } from 'react';
+import require$$1, { useCallback, useState, useEffect, useRef, createContext, useMemo, useContext, memo, useLayoutEffect } from 'react';
 export { default as React } from 'react';
 import require$$0, { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { useSelector, useDispatch, Provider } from 'react-redux';
@@ -313,10 +313,14 @@ var ActionBarCta = function (_a) {
     var _m = useState(false), isVisible = _m[0], setIsVisible = _m[1];
     var _o = useState(false), isAnimating = _o[0], setIsAnimating = _o[1];
     var _p = useState(false), isDismissed = _p[0], setIsDismissed = _p[1];
-    var message = isMobile && ((_b = config.mobile) === null || _b === void 0 ? void 0 : _b.message) ? config.mobile.message : config.message;
+    // For mobile overrides: null means "explicitly disabled", undefined means "use desktop default"
+    var mobileMessage = isMobile ? (_b = config.mobile) === null || _b === void 0 ? void 0 : _b.message : undefined;
+    var message = mobileMessage !== undefined ? mobileMessage : config.message;
     var delay = isMobile && ((_c = config.mobile) === null || _c === void 0 ? void 0 : _c.delay) !== undefined ? config.mobile.delay : ((_d = config.delay) !== null && _d !== void 0 ? _d : 0);
-    var timeout = isMobile && ((_e = config.mobile) === null || _e === void 0 ? void 0 : _e.timeout) !== undefined ? config.mobile.timeout : config.timeout;
-    var animation = isMobile && ((_f = config.mobile) === null || _f === void 0 ? void 0 : _f.animation) ? config.mobile.animation : config.animation;
+    var mobileTimeout = isMobile ? (_e = config.mobile) === null || _e === void 0 ? void 0 : _e.timeout : undefined;
+    var timeout = mobileTimeout !== undefined ? mobileTimeout : config.timeout;
+    var mobileAnimation = isMobile ? (_f = config.mobile) === null || _f === void 0 ? void 0 : _f.animation : undefined;
+    var animation = mobileAnimation !== undefined ? mobileAnimation : config.animation;
     var animationDelay = isMobile && ((_g = config.mobile) === null || _g === void 0 ? void 0 : _g.animationDelay) !== undefined
         ? config.mobile.animationDelay
         : ((_h = config.animationDelay) !== null && _h !== void 0 ? _h : delay);
@@ -1779,14 +1783,14 @@ function useOpenUrlCallback() {
     }, [env]);
 }
 
-function writeMessage(msg, user) {
+function writeMessage(msg, user, timestamp) {
     return {
         type: "synthetic",
         detail: {
             type: "write_msg",
             user: user,
             msg: msg,
-            timestamp: +new Date()
+            timestamp: timestamp !== undefined ? timestamp : +new Date()
         }
     };
 }
@@ -1798,16 +1802,19 @@ function executeAction(text, meta) {
         attributes = __assign(__assign({}, attributes), { currentUrl: window.location.href });
         var _a = meta || {}, token = _a.token, rest = __rest(_a, ["token"]);
         attributes = __assign(__assign({}, attributes), rest);
+        // Add user message to Redux BEFORE sending to server
+        // to ensure it appears above the bot's streaming response
+        var visitor = getState().visitor;
+        var userMsgTimestamp = +new Date();
+        dispatch(writeMessage({
+            text: !token ? text : "".concat(text, " (from the list)"),
+        }, visitor, userMsgTimestamp));
         chatServer.sendChatMsg({ text: text, token: token, attributes: attributes }, function (err) {
             if (err) {
                 log("Error sending message", err);
                 return;
             }
         });
-        var visitor = getState().visitor;
-        dispatch(writeMessage({
-            text: !token ? text : "".concat(text, " (from the list)"),
-        }, visitor));
     }; };
 }
 
@@ -3071,18 +3078,66 @@ function storeIdentity(userId, sessionId) {
 }
 /**
  * Clears stored MCP session (but preserves userId for returning user identification).
+ * Optionally clears the stored lastSeq for the given sessionId.
  */
-function clearStoredSession() {
+function clearStoredSession(sessionId) {
     if (typeof window === "undefined" || !window.localStorage) {
         return;
     }
     try {
         localStorage.removeItem(MCP_STORAGE_KEYS.SESSION_ID);
+        if (sessionId) {
+            clearStoredLastSeq(sessionId);
+        }
     }
     catch (_a) {
         // localStorage may be unavailable
     }
 }
+/**
+ * Retrieves stored lastSeq from sessionStorage for replay on reconnect.
+ * Uses sessionStorage (not localStorage) because seq is ephemeral to the browser tab.
+ */
+function getStoredLastSeq(sessionId) {
+    if (typeof window === "undefined" || !window.sessionStorage) {
+        return undefined;
+    }
+    try {
+        var stored = sessionStorage.getItem("xapp_mcp_lastSeq_".concat(sessionId));
+        return stored ? parseInt(stored, 10) : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+/**
+ * Persists lastSeq to sessionStorage for replay on reconnect.
+ */
+function storeLastSeq(sessionId, seq) {
+    if (typeof window === "undefined" || !window.sessionStorage) {
+        return;
+    }
+    try {
+        sessionStorage.setItem("xapp_mcp_lastSeq_".concat(sessionId), String(seq));
+    }
+    catch (_a) {
+        // sessionStorage may be unavailable
+    }
+}
+/**
+ * Clears stored lastSeq from sessionStorage.
+ */
+function clearStoredLastSeq(sessionId) {
+    if (typeof window === "undefined" || !window.sessionStorage) {
+        return;
+    }
+    try {
+        sessionStorage.removeItem("xapp_mcp_lastSeq_".concat(sessionId));
+    }
+    catch (_a) {
+        // sessionStorage may be unavailable
+    }
+}
 /**
  * Gets the current page context from browser globals.
  * If an override is provided, uses that instead (useful for testing).
@@ -3143,6 +3198,12 @@ var MCPChat = /** @class */ (function () {
         this.isValidatingSession = false;
         // Tool call tracking for debug mode
         this.currentToolCalls = [];
+        // TODO: isReplaying and lastSeq are tracked for future replay support.
+        // Wire up replay requests in wakeup() once the server endpoint supports it.
+        this.isReplaying = false;
+        // True when userId was assigned by the server (via connected SSE event),
+        // meaning it should not be overwritten by the default client fingerprint.
+        this.userIdIsServerAssigned = false;
         this.config = config;
         this.options = options;
         this.configurableMessages = options === null || options === void 0 ? void 0 : options.configurableMessages;
@@ -3157,6 +3218,7 @@ var MCPChat = /** @class */ (function () {
         var storedIdentity = getStoredIdentity();
         if (storedIdentity.userId) {
             this._userId = storedIdentity.userId;
+            this.userIdIsServerAssigned = true;
             log("[MCPChat] Loaded stored userId: ".concat(this._userId));
         }
         if (storedIdentity.sessionId) {
@@ -3167,6 +3229,13 @@ var MCPChat = /** @class */ (function () {
         if (config.sessionId) {
             this._sessionId = config.sessionId;
         }
+        // Load lastSeq from sessionStorage for replay on reconnect
+        if (this._sessionId) {
+            this.lastSeq = getStoredLastSeq(this._sessionId);
+            if (this.lastSeq !== undefined) {
+                log("[MCPChat] Loaded stored lastSeq: ".concat(this.lastSeq));
+            }
+        }
     }
     MCPChat.prototype.init = function (dispatch) {
         this.dispatch = dispatch;
@@ -3178,6 +3247,9 @@ var MCPChat = /** @class */ (function () {
         }
         this.setConnectionStatus("online");
         this.setAccountStatus("online");
+        // Dispatch bot joined early so it appears before the greeting.
+        // getBot() is config-derived (uses options.bot), so it's safe to call before setVisitorInfo.
+        this.userJoined(this.getBot(undefined));
         // Returning user with existing session - validate session silently
         // New user without session - initialize new session to get greeting
         if (this._sessionId) {
@@ -3221,8 +3293,9 @@ var MCPChat = /** @class */ (function () {
                         error_1 = _a.sent();
                         err("Failed to validate session: ".concat(error_1));
                         // If validation fails (network error, etc.), clear session and start fresh
+                        clearStoredSession(this._sessionId);
                         this._sessionId = "";
-                        clearStoredSession();
+                        this.lastSeq = undefined;
                         this.initializeNewSession();
                         return [3 /*break*/, 5];
                     case 4:
@@ -3244,7 +3317,9 @@ var MCPChat = /** @class */ (function () {
             // Fingerprint for user identification (can be disabled for privacy)
             fingerprint: this.config.disableFingerprinting ? undefined : getFingerprint(), 
             // Page context
-            pageContext: getPageContext(this.config.pageContextOverride) }, additionalData);
+            pageContext: getPageContext(this.config.pageContextOverride), 
+            // Client timestamp for latency measurement and clock drift detection
+            clientTime: new Date().toISOString() }, additionalData);
     };
     /**
      * Initializes a new session by calling the endpoint with { newSession: true }.
@@ -3429,14 +3504,15 @@ var MCPChat = /** @class */ (function () {
     };
     MCPChat.prototype.dispatchStreamStart = function (messageId) {
         var bot = this.getBot(undefined);
-        log("Stream started: ".concat(messageId, ", bot: ").concat(JSON.stringify(bot)));
+        var streamTimestamp = +new Date();
+        log("[dispatchStreamStart] Stream started: ".concat(messageId, ", timestamp: ").concat(streamTimestamp));
         this.dispatch({
             type: "chat",
             detail: {
                 type: "chat.stream.start",
                 user: bot,
                 messageId: messageId,
-                timestamp: +new Date(),
+                timestamp: streamTimestamp,
             },
         });
     };
@@ -3857,14 +3933,26 @@ var MCPChat = /** @class */ (function () {
                                     log("Failed to parse SSE data: ".concat(e));
                                     return;
                                 }
+                                // Track sequence number for replay on reconnect
+                                if (data.seq !== undefined && data.seq !== null) {
+                                    _this.lastSeq = data.seq;
+                                    if (_this._sessionId) {
+                                        storeLastSeq(_this._sessionId, data.seq);
+                                    }
+                                }
                                 switch (eventType) {
                                     case "connected":
                                         // Connection established
-                                        log("[SSE] Connected event received, messageId: ".concat(messageId, ", isReturningUser: ").concat(data.isReturningUser));
+                                        log("[SSE] Connected event received, messageId: ".concat(messageId, ", isReturningUser: ").concat(data.isReturningUser, ", isReplay: ").concat(data.isReplay));
+                                        // Track if this is a replay connection
+                                        if (data.isReplay) {
+                                            _this.isReplaying = true;
+                                        }
                                         // Store identity from server response
                                         if (data.userId || data.sessionId) {
                                             if (data.userId) {
                                                 _this._userId = data.userId;
+                                                _this.userIdIsServerAssigned = true;
                                             }
                                             if (data.sessionId) {
                                                 _this._sessionId = data.sessionId;
@@ -3884,9 +3972,10 @@ var MCPChat = /** @class */ (function () {
                                     case "session_expired":
                                         // Session no longer exists on server - need to start fresh
                                         log("[SSE] Session expired: ".concat(data.reason || "Session not found"));
+                                        // Clear stored session (and lastSeq) but keep userId for returning user identification
+                                        clearStoredSession(_this._sessionId);
                                         _this._sessionId = "";
-                                        // Clear stored session but keep userId for returning user identification
-                                        clearStoredSession();
+                                        _this.lastSeq = undefined;
                                         _this.stopTyping();
                                         _this.stopStreamThrottle();
                                         // Reset validation flag before starting new session
@@ -3898,10 +3987,17 @@ var MCPChat = /** @class */ (function () {
                                         break;
                                     case "text":
                                         if (data.text) {
-                                            log("[SSE] Text chunk received (".concat(data.text.length, " chars), total chunks: ").concat(textChunks.length + 1));
+                                            log("[SSE] Text chunk received (".concat(data.text.length, " chars), total chunks: ").concat(textChunks.length + 1, ", isReplay: ").concat(data.isReplay));
                                             textChunks.push(data.text);
-                                            // Buffer text for throttled dispatch
-                                            _this.bufferStreamText(data.text);
+                                            if (data.isReplay) {
+                                                // Replayed text — dispatch immediately (no throttle)
+                                                // so the user sees caught-up content instantly
+                                                _this.dispatchStreamChunk(messageId, data.text);
+                                            }
+                                            else {
+                                                // Live text — buffer for throttled dispatch
+                                                _this.bufferStreamText(data.text);
+                                            }
                                         }
                                         break;
                                     case "tool_start":
@@ -4006,6 +4102,14 @@ var MCPChat = /** @class */ (function () {
                                             resolve();
                                         }
                                         break;
+                                    case "replay_complete":
+                                        _this.isReplaying = false;
+                                        log("[SSE] Replay complete: replayed ".concat(data.replayedCount, " events, currentSeq: ").concat(data.currentSeq));
+                                        break;
+                                    case "replay_partial":
+                                        _this.isReplaying = false;
+                                        log("[SSE] Replay partial: some events unavailable, oldestAvailableSeq: ".concat(data.oldestAvailableSeq));
+                                        break;
                                     case "error":
                                         hasError = true;
                                         _this.stopTyping();
@@ -4020,6 +4124,7 @@ var MCPChat = /** @class */ (function () {
                                 // Only handle error if this is still the current message
                                 if (_this.currentMessageId === messageId && !hasError) {
                                     hasError = true;
+                                    _this.isReplaying = false;
                                     _this.stopStreamThrottle();
                                     sseError = error instanceof Error ? error : new Error(String(error));
                                     // Get status code if available
@@ -4067,9 +4172,8 @@ var MCPChat = /** @class */ (function () {
             this._attributes.currentUrl = window.location.href;
         }
         this._accessToken = this.visitorInfo.accessToken;
-        // This is for the bot
-        this.userJoined(this.getBot(undefined));
-        // Show typing indicator after bot joins if we're still waiting for initial greeting
+        // Bot joined is dispatched in init() to ensure correct ordering
+        // Show typing indicator if we're still waiting for initial greeting
         if (this.isInitializingSession) {
             this.typing();
         }
@@ -4091,20 +4195,40 @@ var MCPChat = /** @class */ (function () {
     };
     MCPChat.prototype.sleep = function () {
         this.stopStreamThrottle();
+        this.isReplaying = false;
         if (this.abortController) {
             this.abortController.abort();
             this.abortController = undefined;
         }
     };
-    MCPChat.prototype.wakeup = function () { };
+    MCPChat.prototype.wakeup = function () {
+        // When tab is foregrounded, just restore connection status.
+        // Don't validate/replay yet — the session will be validated
+        // on the next user message. This avoids creating duplicate
+        // greetings if validation fails transiently.
+        if (this._sessionId) {
+            log("[MCPChat] Wakeup - session exists, lastSeq: ".concat(this.lastSeq));
+            this.setConnectionStatus("online");
+        }
+    };
     MCPChat.prototype.startSession = function (sessionId) {
-        if (this.visitorInfo.visitorId) {
+        // userId priority:
+        // 1. Existing server-assigned userId (from localStorage or previous connected event)
+        // 2. Explicitly provided visitorId or email from host app
+        // 3. Generate a new one as last resort
+        if (this.userIdIsServerAssigned) {
+            // Keep server-assigned userId — don't overwrite with default fingerprint
+            log("[startSession] Preserving server-assigned userId: ".concat(this._userId));
+        }
+        else if (this.visitorInfo.visitorId) {
             this._userId = "".concat(this.visitorInfo.visitorId);
         }
         else if (this.visitorInfo.email) {
             this._userId = "mcp-widget-user-".concat(this.visitorInfo.email);
         }
-        else {
+        else if (!this._userId) {
+            // Only generate a new userId if we don't already have one
+            // (preserves userId loaded from localStorage or received from server)
             this._userId = "mcp-widget-user-".concat(uuid_1());
         }
         // Session ID priority:
@@ -6267,7 +6391,7 @@ function createPacketDecoderStream(maxPayload, binaryType) {
         },
     });
 }
-const protocol$1 = 4;
+const protocol = 4;
 
 /**
  * Expose `Emitter`.
@@ -7543,7 +7667,7 @@ class SocketWithoutUpgrade extends Emitter_1 {
     createTransport(name) {
         const query = Object.assign({}, this.opts.query);
         // append engine.io protocol identifier
-        query.EIO = protocol$1;
+        query.EIO = protocol;
         // transport name
         query.transport = name;
         // session id if we already have one
@@ -7918,7 +8042,7 @@ class SocketWithoutUpgrade extends Emitter_1 {
         }
     }
 }
-SocketWithoutUpgrade.protocol = protocol$1;
+SocketWithoutUpgrade.protocol = protocol;
 /**
  * This class provides a WebSocket-like interface to connect to an Engine.IO server. The connection will be established
  * with one of the available low-level transports, like HTTP long-polling, WebSocket or WebTransport.
@@ -8314,12 +8438,6 @@ const RESERVED_EVENTS$1 = [
     "newListener",
     "removeListener", // used by the Node.js EventEmitter
 ];
-/**
- * Protocol version.
- *
- * @public
- */
-const protocol = 5;
 var PacketType;
 (function (PacketType) {
     PacketType[PacketType["CONNECT"] = 0] = "CONNECT";
@@ -8616,8 +8734,7 @@ var parser = /*#__PURE__*/Object.freeze({
 	__proto__: null,
 	Decoder: Decoder,
 	Encoder: Encoder,
-	get PacketType () { return PacketType; },
-	protocol: protocol
+	get PacketType () { return PacketType; }
 });
 
 function on(obj, ev, fn) {