@microsoft/omnichannel-chat-widget 1.8.3 → 1.8.4-main.21aec08

package/lib/cjs/common/utils/dispatchCustomEvent.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _SecureEventBus = _interopRequireDefault(require("./SecureEventBus"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const dispatchCustomEvent = (name, payload) => {
+  try {
+    const eventBus = _SecureEventBus.default.getInstance();
+    const authToken = eventBus.getAuthToken();
+
+    // Dispatch through the secure event bus instead of global window
+    const success = eventBus.dispatch(name, payload, authToken);
+    if (!success) {
+      console.error("Failed to dispatch secure event:", name);
+    }
+  } catch (error) {
+    console.error("Error dispatching secure custom event:", name, payload, error);
+  }
+};
+var _default = dispatchCustomEvent;
+exports.default = _default;

package/lib/cjs/common/utils.js

@@ -7,7 +7,9 @@ exports.getCustomEventValue = exports.getConversationDetailsCall = exports.getBr
 exports.getDeviceType = getDeviceType;
 exports.getWidgetEndChatEventName = exports.getWidgetCacheIdfromProps = exports.getWidgetCacheId = exports.getTimestampHourMinute = exports.getStateFromCache = exports.getLocaleDirection = exports.getIconText = exports.getDomain = void 0;
 exports.isEndConversationDueToOverflowActivity = isEndConversationDueToOverflowActivity;
-exports.setTabIndices = exports.setOcUserAgent = exports.setFocusOnSendBox = exports.setFocusOnElement = exports.preventFocusToMoveOutOfElement = exports.parseLowerCaseString = exports.parseAdaptiveCardPayload = exports.newGuid = exports.isValidCustomEvent = exports.isUndefinedOrEmpty = exports.isThisSessionPopout = exports.isNullOrUndefined = exports.isNullOrEmptyString = void 0;
+exports.parseAdaptiveCardPayload = exports.newGuid = exports.isValidCustomEvent = exports.isUndefinedOrEmpty = exports.isThisSessionPopout = exports.isNullOrUndefined = exports.isNullOrEmptyString = void 0;
+exports.parseBooleanFromConfig = parseBooleanFromConfig;
+exports.setTabIndices = exports.setOcUserAgent = exports.setFocusOnSendBox = exports.setFocusOnElement = exports.preventFocusToMoveOutOfElement = exports.parseLowerCaseString = void 0;
 var _Constants = require("./Constants");
 var _TelemetryConstants = require("./telemetry/TelemetryConstants");
 var _omnichannelChatComponents = require("@microsoft/omnichannel-chat-components");
@@ -519,4 +521,15 @@ exports.getCustomEventValue = getCustomEventValue;
 function isEndConversationDueToOverflowActivity(activity) {
   var _activity$channelData, _activity$channelData2;
   return (activity === null || activity === void 0 ? void 0 : (_activity$channelData = activity.channelData) === null || _activity$channelData === void 0 ? void 0 : _activity$channelData.tags) && Array.isArray(activity === null || activity === void 0 ? void 0 : (_activity$channelData2 = activity.channelData) === null || _activity$channelData2 === void 0 ? void 0 : _activity$channelData2.tags) && activity.channelData.tags.includes(_Constants.Constants.EndConversationDueToOverflow);
+}
+
+/**
+ * Parses a value that can be boolean or string ("true"/"false") into a boolean.
+ * Handles null/undefined by returning false.
+ * 
+ * @param value - The value to parse (can be boolean, string, null, or undefined)
+ * @returns true if value is true or "true" (case-insensitive), false otherwise
+ */
+function parseBooleanFromConfig(value) {
+  return value === true || (value === null || value === void 0 ? void 0 : value.toString().toLowerCase()) === "true";
 }

package/lib/cjs/components/chatbuttonstateful/ChatButtonStateful.js

@@ -26,7 +26,10 @@ const ChatButtonStateful = props => {
     uiTimer = (0, _utils.createTimer)();
     _TelemetryHelper.TelemetryHelper.logLoadingEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.UXLCWChatButtonLoadingStart,
-      Description: "Chat button loading started"
+      Description: "Chat button loading started",
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
   }, []);
 
@@ -49,7 +52,10 @@ const ChatButtonStateful = props => {
   ref.current = async () => {
     _TelemetryHelper.TelemetryHelper.logActionEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.LCWChatButtonClicked,
-      Description: "Chat button click action started"
+      Description: "Chat button click action started",
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
     if (state.appStates.isMinimized) {
       dispatch({
@@ -69,7 +75,10 @@ const ChatButtonStateful = props => {
     }
     _TelemetryHelper.TelemetryHelper.logActionEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.LCWChatButtonActionCompleted,
-      Description: "Chat button action completed"
+      Description: "Chat button action completed",
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
   };
   const outOfOfficeStyleProps = Object.assign({}, _defaultOutOfOfficeChatButtonStyleProps.defaultOutOfOfficeChatButtonStyleProps, outOfOfficeButtonProps === null || outOfOfficeButtonProps === void 0 ? void 0 : outOfOfficeButtonProps.styleProps);
@@ -123,7 +132,10 @@ const ChatButtonStateful = props => {
     _TelemetryHelper.TelemetryHelper.logLoadingEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.UXLCWChatButtonLoadingCompleted,
       Description: "Chat button loading completed",
-      ElapsedTimeInMilliseconds: uiTimer.milliSecondsElapsed
+      ElapsedTimeInMilliseconds: uiTimer.milliSecondsElapsed,
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
   }, []);
   (0, _react.useEffect)(() => {

package/lib/cjs/components/citationpanestateful/CitationPaneStateful.js

@@ -42,7 +42,7 @@ const CitationPaneStateful = props => {
   const [paneStyle, setPaneStyle] = (0, _react.useState)(null);
   const [isReady, setIsReady] = (0, _react.useState)(false);
 
-  // Move focus to the container
+  // Initial focus pattern (mirrors ConfirmationPaneStateful): focus first focusable element (will re-attempt after visibility becomes true)
   (0, _react.useEffect)(() => {
     (0, _utils.preventFocusToMoveOutOfElement)(controlId);
     const focusableElements = (0, _utils.findAllFocusableElement)(`#${controlId}`);
@@ -64,6 +64,25 @@ const CitationPaneStateful = props => {
     });
   }, []);
 
+  // Retry focus once pane is actually visible (isReady) in case initial attempt occurred while wrapper was visibility:hidden
+  (0, _react.useEffect)(() => {
+    if (!isReady) return;
+    const focusableElements = (0, _utils.findAllFocusableElement)(`#${controlId}`);
+    if (focusableElements && focusableElements.length > 0) {
+      const first = focusableElements[0];
+      // If focused element is not already inside the pane, move focus
+      if (!first.contains(document.activeElement) && !(document.activeElement && document.activeElement.id.startsWith(controlId))) {
+        requestAnimationFrame(() => {
+          if (first.isConnected) {
+            first.focus({
+              preventScroll: true
+            });
+          }
+        });
+      }
+    }
+  }, [isReady, controlId]);
+
   // Compute the widget bounds and set pane style accordingly (95% of widget size
   // and centered inside the widget). If the widget container can't be found,
   // fall back to the default pane styles from defaultCitationPaneProps.

package/lib/cjs/components/headerstateful/HeaderStateful.js

@@ -70,7 +70,10 @@ const HeaderStateful = props => {
       var _props$headerProps, _props$headerProps$co, _props$headerProps$co2;
       _TelemetryHelper.TelemetryHelper.logActionEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
         Event: _TelemetryConstants.TelemetryEvent.HeaderCloseButtonClicked,
-        Description: "Header Close action started."
+        Description: "Header Close action started.",
+        CustomProperties: {
+          ConversationStage: _TelemetryConstants.ConversationStage.ConversationEnd
+        }
       });
       if (localConfirmationPaneState.current !== _Constants.ConfirmationState.Ok) {
         dispatch({
@@ -85,7 +88,10 @@ const HeaderStateful = props => {
       }
       _TelemetryHelper.TelemetryHelper.logActionEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
         Event: _TelemetryConstants.TelemetryEvent.CloseChatActionCompleted,
-        Description: "Header Close action completed."
+        Description: "Header Close action completed.",
+        CustomProperties: {
+          ConversationStage: _TelemetryConstants.ConversationStage.ConversationEnd
+        }
       });
       const closeButtonId = ((_props$headerProps = props.headerProps) === null || _props$headerProps === void 0 ? void 0 : (_props$headerProps$co = _props$headerProps.controlProps) === null || _props$headerProps$co === void 0 ? void 0 : (_props$headerProps$co2 = _props$headerProps$co.closeButtonProps) === null || _props$headerProps$co2 === void 0 ? void 0 : _props$headerProps$co2.id) ?? `${controlProps.id}-close-button`;
       if (closeButtonId) {

package/lib/cjs/components/livechatwidget/common/ActivitySubscriber/AddActivitySubscriber.js

@@ -0,0 +1,127 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AddActivitySubscriber = void 0;
+var _TelemetryConstants = require("../../../../common/telemetry/TelemetryConstants");
+var _omnichannelChatComponents = require("@microsoft/omnichannel-chat-components");
+var _ChatWidgetEvents = _interopRequireDefault(require("../ChatWidgetEvents"));
+var _SecureEventBus = _interopRequireDefault(require("../../../../common/utils/SecureEventBus"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * The `AddActivitySubscriber` class is responsible for subscribing to the `ADD_ACTIVITY` event
+ * from the `ChatWidgetEvents` and notifying an observer when a new activity is added.
+ * 
+ * This class implements the `IActivitySubscriber` interface and acts as a bridge between
+ * the event system and the observer pattern.
+ */
+let AddActivitySubscriber = /*#__PURE__*/function () {
+  /**
+   * The observer that will be notified when a new activity is added.
+   * This is expected to be an object with a `next` method, such as an RxJS `Observer`.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+  /**
+   * Set to track processed activity IDs to prevent duplicate processing.
+   */
+
+  /**
+   * Unsubscribe function for the secure event listener
+   */
+
+  /**
+   * Subscription for PersistentConversationReset event
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+  /**
+   * Constructor initializes the `AddActivitySubscriber` and sets up a secure event listener
+   * for the `ChatWidgetEvents.ADD_ACTIVITY` event. When the event is triggered, it checks
+   * if the event payload contains an `activity` and notifies the observer.
+   */
+  function AddActivitySubscriber() {
+    _classCallCheck(this, AddActivitySubscriber);
+    _defineProperty(this, "observer", void 0);
+    _defineProperty(this, "processedActivityIds", new Set());
+    _defineProperty(this, "unsubscribeFromSecureEvent", null);
+    _defineProperty(this, "resetEventListener", void 0);
+    const eventBus = _SecureEventBus.default.getInstance();
+
+    // Subscribe to the secure event bus instead of global window events
+    this.unsubscribeFromSecureEvent = eventBus.subscribe(_ChatWidgetEvents.default.ADD_ACTIVITY, payload => {
+      if (payload !== null && payload !== void 0 && payload.activity) {
+        var _this$observer;
+        const activity = payload.activity;
+        const activityId = activity.id;
+        if (activity.identifier) {
+          if (this.processedActivityIds.has(activity === null || activity === void 0 ? void 0 : activity.identifier)) {
+            return; // Skip processing if already handled
+          }
+          // Add the activity ID to the processed set
+          this.processedActivityIds.add(activity === null || activity === void 0 ? void 0 : activity.identifier);
+        }
+
+        // Check if activity has an ID and if it has already been processed
+        if (activityId) {
+          if (this.processedActivityIds.has(activityId)) {
+            return; // Skip processing if already handled
+          }
+
+          // Add the activity ID to the processed set
+          this.processedActivityIds.add(activityId);
+        }
+
+        // Notify the observer with the new activity
+        (_this$observer = this.observer) === null || _this$observer === void 0 ? void 0 : _this$observer.next(activity);
+      }
+    });
+
+    // Subscribe to reset events for cleanup
+    this.resetEventListener = _omnichannelChatComponents.BroadcastService.getMessageByEventName(_TelemetryConstants.BroadcastEvent.PersistentConversationReset).subscribe(() => {
+      this.reset();
+      // Clean up the secure event listener when conversation resets
+      if (this.unsubscribeFromSecureEvent) {
+        this.unsubscribeFromSecureEvent();
+        this.unsubscribeFromSecureEvent = null;
+      }
+      // Unsubscribe from the reset event to prevent accumulation
+      if (this.resetEventListener) {
+        this.resetEventListener.unsubscribe();
+      }
+    });
+  }
+
+  /**
+   * The `next` method is a placeholder for processing the activity.
+   * This method can be overridden or extended as needed.
+   * 
+   * @param activity - The activity object to process.
+   * @returns The activity object (asynchronously).
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _createClass(AddActivitySubscriber, [{
+    key: "next",
+    value: async function next(activity) {
+      return activity;
+    }
+
+    /**
+     * Reset the processed activity IDs when a conversation resets
+     */
+  }, {
+    key: "reset",
+    value: function reset() {
+      this.processedActivityIds.clear();
+    }
+  }]);
+  return AddActivitySubscriber;
+}();
+exports.AddActivitySubscriber = AddActivitySubscriber;

package/lib/cjs/components/livechatwidget/common/ChatWidgetEvents.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var ChatWidgetEvents;
+(function (ChatWidgetEvents) {
+  ChatWidgetEvents["ADD_ACTIVITY"] = "CHAT_WIDGET/ADD_ACTIVITY";
+  ChatWidgetEvents["FETCH_PERSISTENT_CHAT_HISTORY"] = "CHAT_WIDGET/FETCH_PERSISTENT_CHAT_HISTORY";
+  ChatWidgetEvents["NO_MORE_HISTORY_AVAILABLE"] = "CHAT_WIDGET/NO_MORE_HISTORY_AVAILABLE";
+  ChatWidgetEvents["HISTORY_LOAD_ERROR"] = "CHAT_WIDGET/HISTORY_LOAD_ERROR";
+})(ChatWidgetEvents || (ChatWidgetEvents = {}));
+var _default = ChatWidgetEvents;
+exports.default = _default;

package/lib/cjs/components/livechatwidget/common/PersistentConversationHandler.js

@@ -0,0 +1,290 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _TelemetryConstants = require("../../../common/telemetry/TelemetryConstants");
+var _omnichannelChatComponents = require("@microsoft/omnichannel-chat-components");
+var _ChatWidgetEvents = _interopRequireDefault(require("./ChatWidgetEvents"));
+var _TelemetryHelper = require("../../../common/telemetry/TelemetryHelper");
+var _conversationDividerActivity = _interopRequireDefault(require("../../webchatcontainerstateful/common/activities/conversationDividerActivity"));
+var _convertPersistentChatHistoryMessageToActivity = _interopRequireDefault(require("../../webchatcontainerstateful/common/activityConverters/convertPersistentChatHistoryMessageToActivity"));
+var _utils = require("../../../common/utils");
+var _defaultPersistentChatHistoryProps = require("./defaultProps/defaultPersistentChatHistoryProps");
+var _dispatchCustomEvent = _interopRequireDefault(require("../../../common/utils/dispatchCustomEvent"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * Class responsible for handling persistent conversation history
+ */
+let PersistentConversationHandler = /*#__PURE__*/function () {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+  function PersistentConversationHandler(facadeChatSDK, props) {
+    _classCallCheck(this, PersistentConversationHandler);
+    _defineProperty(this, "appliedProps", {
+      ..._defaultPersistentChatHistoryProps.defaultPersistentChatHistoryProps
+    });
+    _defineProperty(this, "isLastPull", false);
+    _defineProperty(this, "pageToken", null);
+    _defineProperty(this, "facadeChatSDK", void 0);
+    _defineProperty(this, "lastMessage", null);
+    _defineProperty(this, "count", 0);
+    _defineProperty(this, "pageSize", _defaultPersistentChatHistoryProps.defaultPersistentChatHistoryProps.pageSize);
+    _defineProperty(this, "isCurrentlyPulling", false);
+    _defineProperty(this, "pageTokenInTransitSet", new Set());
+    _defineProperty(this, "resetEventListener", _omnichannelChatComponents.BroadcastService.getMessageByEventName(_TelemetryConstants.BroadcastEvent.PersistentConversationReset).subscribe(() => {
+      this.reset();
+    }));
+    this.facadeChatSDK = facadeChatSDK;
+    this.appliedPropsHandler(props);
+    _TelemetryHelper.TelemetryHelper.logActionEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
+      Event: _TelemetryConstants.TelemetryEvent.LCWPersistentConversationHandlerInitialized,
+      Description: "PersistentConversationHandler initialized",
+      CustomProperties: {
+        pageSize: _defaultPersistentChatHistoryProps.defaultPersistentChatHistoryProps.pageSize
+      }
+    });
+  }
+  _createClass(PersistentConversationHandler, [{
+    key: "appliedPropsHandler",
+    value: function appliedPropsHandler(props) {
+      var _this$appliedProps;
+      this.appliedProps = {
+        ..._defaultPersistentChatHistoryProps.defaultPersistentChatHistoryProps,
+        ...props
+      };
+
+      // if the props is not existent or is not a number then default to defaultPersistentChatHistoryProps.pageSize
+      this.pageSize = ((_this$appliedProps = this.appliedProps) === null || _this$appliedProps === void 0 ? void 0 : _this$appliedProps.pageSize) !== undefined && !isNaN(this.appliedProps.pageSize) ? this.appliedProps.pageSize : _defaultPersistentChatHistoryProps.defaultPersistentChatHistoryProps.pageSize;
+    }
+  }, {
+    key: "reset",
+    value: function reset() {
+      this.isLastPull = false;
+      this.pageToken = null;
+      this.lastMessage = null;
+      this.count = 0;
+      this.isCurrentlyPulling = false;
+      this.pageTokenInTransitSet.clear();
+    }
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      // Only unsubscribe when the handler is being destroyed completely
+      this.resetEventListener.unsubscribe();
+    }
+  }, {
+    key: "pullHistory",
+    value: async function pullHistory() {
+      const pullTimer = (0, _utils.createTimer)();
+
+      // Prevent concurrent pulls regardless of pageToken
+      if (this.isCurrentlyPulling) {
+        _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.WARN, {
+          Event: _TelemetryConstants.TelemetryEvent.LCWPersistentHistoryPullBlocked,
+          Description: "History pull blocked - already in progress"
+        });
+        return;
+      }
+
+      // Additional check for specific pageToken duplicates
+      if (this.pageToken && this.pageTokenInTransitSet.has(this.pageToken)) {
+        return;
+      }
+
+      // Mark as currently pulling
+      this.isCurrentlyPulling = true;
+      if (this.pageToken) {
+        this.pageTokenInTransitSet.add(this.pageToken);
+      }
+      try {
+        var _ref;
+        const messages = await this.fetchHistoryMessages();
+
+        // Handle error case - null indicates an error occurred
+        // Don't mark as last pull to allow retry on next attempt
+        if (messages == null) {
+          _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.WARN, {
+            Event: _TelemetryConstants.TelemetryEvent.LCWPersistentHistoryReturnedNull,
+            Description: "History pull returned null - Possible error occurred, will retry on next scroll",
+            ElapsedTimeInMilliseconds: pullTimer.milliSecondsElapsed
+          });
+          return;
+        }
+
+        // Handle legitimate end of history - empty array
+        if (messages.length === 0) {
+          this.isLastPull = true;
+          // Dispatch event to notify UI that no more history is available
+          (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.NO_MORE_HISTORY_AVAILABLE);
+          _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.INFO, {
+            Event: _TelemetryConstants.TelemetryEvent.LCWPersistentHistoryPullCompleted,
+            Description: "History pull completed - no more messages",
+            ElapsedTimeInMilliseconds: pullTimer.milliSecondsElapsed
+          });
+          return;
+        }
+        const messagesDescOrder = (_ref = [...messages]) === null || _ref === void 0 ? void 0 : _ref.reverse();
+        this.processHistoryMessages(messagesDescOrder);
+        _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.INFO, {
+          Event: _TelemetryConstants.TelemetryEvent.LCWPersistentHistoryPullCompleted,
+          Description: "History pull completed successfully",
+          ElapsedTimeInMilliseconds: pullTimer.milliSecondsElapsed,
+          CustomProperties: {
+            messageCount: messages.length,
+            totalProcessed: this.count
+          }
+        });
+      } finally {
+        // Always clear the pulling flag when done
+        this.isCurrentlyPulling = false;
+
+        // Remove pageToken from transit set if it was added
+        if (this.pageToken) {
+          this.pageTokenInTransitSet.delete(this.pageToken);
+        }
+      }
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  }, {
+    key: "processHistoryMessages",
+    value: function processHistoryMessages(messagesDescOrder) {
+      for (const message of messagesDescOrder) {
+        try {
+          const activity = this.processMessageToActivity(message);
+          if (activity) {
+            (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.ADD_ACTIVITY, {
+              activity
+            });
+            const dividerActivity = this.createDividerActivity(activity);
+            if (dividerActivity) {
+              (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.ADD_ACTIVITY, {
+                activity: dividerActivity
+              });
+            }
+            this.lastMessage = activity;
+          }
+        } catch (error) {
+          _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.ERROR, {
+            Event: _TelemetryConstants.TelemetryEvent.ConvertPersistentChatHistoryMessageToActivityFailed,
+            ExceptionDetails: error
+          });
+        }
+      }
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  }, {
+    key: "fetchHistoryMessages",
+    value: async function fetchHistoryMessages() {
+      if (!this.shouldPull()) {
+        // Dispatch event to ensure banner is hidden when no more pulls are needed
+        (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.NO_MORE_HISTORY_AVAILABLE);
+        return [];
+      }
+      const options = {
+        pageSize: this.pageSize,
+        pageToken: this.pageToken || undefined
+      };
+      try {
+        var _this$facadeChatSDK;
+        const response = await ((_this$facadeChatSDK = this.facadeChatSDK) === null || _this$facadeChatSDK === void 0 ? void 0 : _this$facadeChatSDK.fetchPersistentConversationHistory(options));
+        const {
+          chatMessages: messages,
+          nextPageToken: pageToken
+        } = response;
+        this.pageToken = pageToken || null;
+        if (pageToken === null) {
+          this.isLastPull = true;
+          // Dispatch event when we reach the end of available history
+          (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.NO_MORE_HISTORY_AVAILABLE);
+        }
+
+        // if chatMessages is null, return empty array
+        if (!messages) {
+          this.isLastPull = true;
+          // Dispatch event when we reach the end of available history
+          (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.NO_MORE_HISTORY_AVAILABLE);
+          return [];
+        }
+        return messages;
+      } catch (error) {
+        _TelemetryHelper.TelemetryHelper.logSDKEvent(_TelemetryConstants.LogLevel.ERROR, {
+          Event: _TelemetryConstants.TelemetryEvent.FetchPersistentChatHistoryFailed,
+          ExceptionDetails: error
+        });
+
+        // On error, dispatch HISTORY_LOAD_ERROR to hide loading banner without marking conversation as ended
+        // This allows recovery on the next attempt (e.g., transient network errors)
+        // Return null to distinguish error from legitimate empty history
+        (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.HISTORY_LOAD_ERROR);
+        return null;
+      }
+    }
+  }, {
+    key: "shouldPull",
+    value: function shouldPull() {
+      return !this.isLastPull;
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  }, {
+    key: "processMessageToActivity",
+    value: function processMessageToActivity(message) {
+      try {
+        const activity = (0, _convertPersistentChatHistoryMessageToActivity.default)(message);
+        activity.id = activity.id || `activity-${this.count}`;
+        activity.channelData = {
+          ...activity.channelData,
+          metadata: {
+            count: this.count
+          }
+        };
+
+        // Increment the count after assigning it to the activity
+        this.count += 1;
+        return activity;
+      } catch (error) {
+        _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.ERROR, {
+          Event: _TelemetryConstants.TelemetryEvent.ConvertPersistentChatHistoryMessageToActivityFailed,
+          ExceptionDetails: error
+        });
+        throw error;
+      }
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  }, {
+    key: "createDividerActivity",
+    value: function createDividerActivity(activity) {
+      var _this$lastMessage, _this$lastMessage$cha;
+      if (((_this$lastMessage = this.lastMessage) === null || _this$lastMessage === void 0 ? void 0 : (_this$lastMessage$cha = _this$lastMessage.channelData) === null || _this$lastMessage$cha === void 0 ? void 0 : _this$lastMessage$cha.conversationId) !== activity.channelData.conversationId) {
+        const rawSequenceId = activity.channelData["webchat:sequence-id"];
+        const sequenceId = typeof rawSequenceId === "number" && !isNaN(rawSequenceId) ? rawSequenceId + 1 : 1;
+        const timestamp = new Date(activity.timestamp).getTime() + 1;
+        return {
+          ..._conversationDividerActivity.default,
+          channelData: {
+            ..._conversationDividerActivity.default.channelData,
+            conversationId: activity.channelData.conversationId,
+            "webchat:sequence-id": sequenceId
+          },
+          timestamp: new Date(timestamp).toISOString(),
+          identifier: `divider-${activity.channelData.conversationId}`
+        };
+      }
+      return null;
+    }
+  }]);
+  return PersistentConversationHandler;
+}();
+var _default = PersistentConversationHandler;
+exports.default = _default;

package/lib/cjs/components/livechatwidget/common/createAdapter.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.createAdapter = void 0;
+var _AddActivitySubscriber = require("./ActivitySubscriber/AddActivitySubscriber");
 var _BotAuthActivitySubscriber = require("./ActivitySubscriber/BotAuthActivitySubscriber");
 var _ChatAdapterShim = require("./ChatAdapterShim");
 var _HiddenAdaptiveCardActivitySubscriber = require("./ActivitySubscriber/HiddenAdaptiveCardActivitySubscriber");
@@ -50,6 +51,7 @@ const createAdapter = async (facadeChatSDK, props) => {
       fetchBotAuthConfigRetryInterval: (props === null || props === void 0 ? void 0 : (_props$webChatContain3 = props.webChatContainerProps) === null || _props$webChatContain3 === void 0 ? void 0 : (_props$webChatContain4 = _props$webChatContain3.botAuthConfig) === null || _props$webChatContain4 === void 0 ? void 0 : _props$webChatContain4.fetchBotAuthConfigRetryInterval) || defaultBotAuthConfig.fetchBotAuthConfigRetryInterval
     };
     adapter = new _ChatAdapterShim.ChatAdapterShim(adapter);
+    adapter.addSubscriber(new _AddActivitySubscriber.AddActivitySubscriber());
     adapter.addSubscriber(new _PauseActivitySubscriber.PauseActivitySubscriber());
     adapter.addSubscriber(new _BotAuthActivitySubscriber.BotAuthActivitySubscriber(botAuthActivitySubscriberOptionalParams));
     // Remove this code after ICM ID:544623085 is fixed

package/lib/cjs/components/livechatwidget/common/defaultProps/defaultPersistentChatHistoryProps.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.defaultPersistentChatHistoryProps = void 0;
+const defaultPersistentChatHistoryProps = {
+  pageSize: 10,
+  dividerActivityStyle: {
+    border: "1px solid rgb(96, 94, 92, 0.5)",
+    margin: "10px 20%"
+  },
+  bannerStyle: {
+    margin: "10px auto"
+  }
+};
+exports.defaultPersistentChatHistoryProps = defaultPersistentChatHistoryProps;