@microsoft/omnichannel-chat-widget 1.8.4-main.7bdb634 → 1.8.4-main.c687f88

package/README.md

@@ -268,6 +268,33 @@ const customizedFooterProp: IFooterProps = {
         setOnCustomEvent((event) => console.log(event));
         ```
 
+#### Trigger initiateEndChat event
+Customer can trigger the initiateEndChat event via BroadcastService to end a chat session.
+When needed, the payload below could be triggered:
+```js
+const endChatEvent = {
+    eventName: "InitiateEndChat",
+    payload: {
+        skipSessionCloseForPersistentChat: true
+    } //optional payload
+};
+BroadcastService.postMessage(endChatEvent);
+```
+
+The payload of the event is optional, only needed when force closing of a persistent chat session is not required.
+When chat widget receives the event without any payload, it will:
+1. set the widget to closed state, the widget panel will be minimized. Post chat survey will not be displayed.
+2. trigger a sessionclose service network request to OmniChannel services.
+
+If skipSessionCloseForPersistentChat is set to true. The session close network request will not be triggered, instead, if postChat survey is available, post chat survey will be displayed.
+
+After successfully processed initiateEndChat event. The CloseChat event is broadcasted.
+```js
+BroadcastService.getMessageByEventName("CloseChat").subscribe(async (msg) => {
+    console.log("close chat received: ", msg);
+    //more actions to unmount component and resources
+})
+```
 ## See Also
 
 [Customizations Dev Guide](https://github.com/microsoft/omnichannel-chat-widget/blob/main/docs/customizations/getstarted.md)\

package/lib/cjs/common/Constants.js

@@ -68,6 +68,7 @@ _defineProperty(Constants, "queuePositionMessageTag", "queueposition");
 _defineProperty(Constants, "averageWaitTimeMessageTag", "averagewaittime");
 _defineProperty(Constants, "message", "message");
 _defineProperty(Constants, "hiddenTag", "Hidden");
+_defineProperty(Constants, "typing", "typing");
 // messageTimestampMiddleware
 _defineProperty(Constants, "prefixTimestampTag", "ServerMessageTimestamp_");
 _defineProperty(Constants, "acsChannel", "ACS_CHANNEL");
@@ -142,6 +143,7 @@ _defineProperty(Constants, "customEventName", "customEventName");
 _defineProperty(Constants, "customEventValue", "customEventValue");
 _defineProperty(Constants, "Hidden", "Hidden");
 _defineProperty(Constants, "EndConversationDueToOverflow", "endconversationduetooverflow");
+_defineProperty(Constants, "SkipSessionCloseForPersistentChatFlag", "skipSessionCloseForPersistentChat");
 const Regex = (_class = /*#__PURE__*/_createClass(function Regex() {
   _classCallCheck(this, Regex);
 }), _defineProperty(_class, "EmailRegex", "^(?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"[^\"\\\\]*(?:\\\\.[^\"\\\\]*)*\")@(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?)*|\\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\])$"), _class);
@@ -377,6 +379,7 @@ _defineProperty(PrepareEndChatDescriptionConstants, "ConversationEndedBy", "Conv
 _defineProperty(PrepareEndChatDescriptionConstants, "PrepareEndChatError", "There's an error while preparing to end chat. Closing chat widget.");
 _defineProperty(PrepareEndChatDescriptionConstants, "WidgetLoadFailedAfterSessionInit", "SessionInit was successful, but widget load failed. Ending chat to avoid ghost chats in OC.");
 _defineProperty(PrepareEndChatDescriptionConstants, "InitiateEndChatReceived", "Received InitiateEndChat BroadcastEvent while conversation state is not Active. Ending chat.");
+_defineProperty(PrepareEndChatDescriptionConstants, "InitiateEndChatReceivedActiveChat", "Received InitiateEndChat BroadcastEvent while conversation state is Active. Updating conversation states.");
 _defineProperty(PrepareEndChatDescriptionConstants, "EndChatReceivedFromOtherTabs", "Received EndChat BroadcastEvent from other tabs. Closing this chat.");
 _defineProperty(PrepareEndChatDescriptionConstants, "CustomerCloseChatOnFailureOrPostChat", "Customer is trying to close chat widget on start chat failure or post chat pane.");
 _defineProperty(PrepareEndChatDescriptionConstants, "CustomerCloseInactiveChat", "Chat was Inactive and customer is trying to close chat widget or refreshing the page.");

package/lib/cjs/common/telemetry/AppInsightsEvents.js

@@ -6,11 +6,11 @@ Object.defineProperty(exports, "__esModule", {
 exports.AppInsightsEventMapping = void 0;
 const AppInsightsEventMapping = {
   "LCWChatButtonClicked": "LCWChatButtonActionStarted",
-  "WidgetLoadStarted": "WidgetStartChatStarted",
-  "WidgetLoadComplete": "WidgetStartChatCompleted",
-  "WidgetLoadFailed": "WidgetStartChatFailed",
-  "PrechatSubmitted": "PrechatSubmitCompleted",
-  "StartChatEventRecevied": "StartChatEventReceivedCompleted",
+  "UXLCWChatButtonLoadingStart": "LiveChatWidgetChatButtonLoadingStarted",
+  "UXLCWChatButtonLoadingCompleted": "LiveChatWidgetChatButtonLoadingCompleted",
+  "UXPrechatPaneStart": "PrechatSurveyStarted",
+  "UXPrechatPaneCompleted": "PrechatSurveyCompleted",
+  "PrechatSubmitted": "PrechatSurveySubmitCompleted",
   "EndChatEventReceived": "EndChatEventReceivedCompleted",
   "EmailTranscriptSent": "EmailTranscriptActionCompleted",
   "EmailTranscriptFailed": "EmailTranscriptActionFailed",
@@ -18,14 +18,19 @@ const AppInsightsEventMapping = {
   "HeaderMinimizeButtonClicked": "MinimizeChatActionStarted",
   "DownloadTranscriptButtonClicked": "DownloadTranscriptActionStarted",
   "EmailTranscriptButtonClicked": "EmailTranscriptButtonActionStarted",
-  "CustomerVoiceFormResponseSubmitted": "CustomerVoiceFormResponseSubmitCompleted",
-  "StartProactiveChatEventReceived": "StartProactiveChatEventReceivedCompleted",
   "ProactiveChatRejected": "ProactiveChatTimeOutCompleted",
   "MessageSent": "MessageSentCompleted",
   "MessageReceived": "MessageReceivedCompleted",
   "SystemMessageReceived": "SystemMessageReceivedCompleted",
-  "RehydrateMessageReceived": "RehydrateMessageReceivedCompleted",
+  "RehydrateMessageReceived": "ChatHistoryMessageReceivedCompleted",
   "CustomContextReceived": "CustomContextReceivedCompleted",
-  "PostChatContextCallSucceed": "PostChatContextCallCompleted"
+  "NewTokenValidationStarted": "AuthTokenValidationStarted",
+  "NewTokenValidationCompleted": "AuthTokenValidationCompleted",
+  "NewTokenValidationFailed": "AuthTokenValidationFailed",
+  "UXPostChatPaneStarted": "PostChatSurveyStarted",
+  "UXPostChatPaneCompleted": "PostChatSurveyCompleted",
+  "WidgetLoadStarted": "ChatSessionInitializationStarted",
+  "WidgetLoadComplete": "ChatSessionInitializationCompleted",
+  "WidgetLoadFailed": "ChatSessionInitializationFailed"
 };
 exports.AppInsightsEventMapping = AppInsightsEventMapping;

package/lib/cjs/common/telemetry/TelemetryConstants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TelemetryEvent = exports.TelemetryConstants = exports.ScenarioType = exports.LogLevel = exports.BroadcastEvent = void 0;
+exports.TelemetryEvent = exports.TelemetryConstants = exports.ScenarioType = exports.LogLevel = exports.ConversationStage = exports.BroadcastEvent = void 0;
 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; }
@@ -124,6 +124,7 @@ exports.TelemetryEvent = TelemetryEvent;
   TelemetryEvent["EndChatFailed"] = "EndChatFailed";
   TelemetryEvent["SettingCustomContext"] = "SettingCustomContext";
   TelemetryEvent["WebChatLoaded"] = "WebChatLoaded";
+  TelemetryEvent["PersistentChatHistoryEnabled"] = "PersistentChatHistoryEnabled";
   TelemetryEvent["LCWChatButtonActionCompleted"] = "LCWChatButtonActionCompleted";
   TelemetryEvent["LCWChatButtonClicked"] = "LCWChatButtonClicked";
   TelemetryEvent["LCWChatButtonShow"] = "LCWChatButtonShow";
@@ -288,6 +289,8 @@ exports.TelemetryEvent = TelemetryEvent;
   TelemetryEvent["UXCitationPaneCompleted"] = "UXCitationPaneCompleted";
   TelemetryEvent["UXLiveChatWidgetStart"] = "UXLiveChatWidgetStart";
   TelemetryEvent["UXLiveChatWidgetCompleted"] = "UXLiveChatWidgetCompleted";
+  TelemetryEvent["UXPostChatPaneStarted"] = "UXPostChatPaneStarted";
+  TelemetryEvent["UXPostChatPaneCompleted"] = "UXPostChatPaneCompleted";
   TelemetryEvent["AppInsightsInitialized"] = "AppInsightsInitialized";
   TelemetryEvent["AppInsightsInitFailed"] = "AppInsightsInitFailed";
   TelemetryEvent["ConvertPersistentChatHistoryMessageToActivityFailed"] = "ConvertPersistentChatHistoryMessageToActivityFailed";
@@ -303,6 +306,7 @@ exports.TelemetryEvent = TelemetryEvent;
   TelemetryEvent["LCWPersistentConversationHandlerInitialized"] = "LCWPersistentConversationHandlerInitialized";
   TelemetryEvent["LCWPersistentHistoryPullBlocked"] = "LCWPersistentHistoryPullBlocked";
   TelemetryEvent["LCWPersistentHistoryPullCompleted"] = "LCWPersistentHistoryPullCompleted";
+  TelemetryEvent["LCWPersistentHistoryReturnedNull"] = "LCWPersistentHistoryReturnedNull";
   TelemetryEvent["LCWLazyLoadInitializationStarted"] = "LCWLazyLoadInitializationStarted";
   TelemetryEvent["LCWLazyLoadContainerNotFound"] = "LCWLazyLoadContainerNotFound";
   TelemetryEvent["LCWLazyLoadInitializationCompleted"] = "LCWLazyLoadInitializationCompleted";
@@ -312,10 +316,12 @@ exports.TelemetryEvent = TelemetryEvent;
   TelemetryEvent["LCWLazyLoadActivityMounted"] = "LCWLazyLoadActivityMounted";
   TelemetryEvent["LCWLazyLoadReset"] = "LCWLazyLoadReset";
   TelemetryEvent["LCWLazyLoadNoMoreHistory"] = "LCWLazyLoadNoMoreHistory";
+  TelemetryEvent["LCWLazyLoadHistoryError"] = "LCWLazyLoadHistoryError";
   TelemetryEvent["LCWLazyLoadDestroyed"] = "LCWLazyLoadDestroyed";
   TelemetryEvent["SecureEventBusUnauthorizedDispatch"] = "SecureEventBusUnauthorizedDispatch";
   TelemetryEvent["SecureEventBusListenerError"] = "SecureEventBusListenerError";
   TelemetryEvent["SecureEventBusDispatchError"] = "SecureEventBusDispatchError";
+  TelemetryEvent["StartChatComplete"] = "StartChatComplete";
 })(TelemetryEvent || (exports.TelemetryEvent = TelemetryEvent = {}));
 let TelemetryConstants = /*#__PURE__*/function () {
   function TelemetryConstants() {
@@ -446,4 +452,11 @@ let TelemetryConstants = /*#__PURE__*/function () {
   }]);
   return TelemetryConstants;
 }();
-exports.TelemetryConstants = TelemetryConstants;
+exports.TelemetryConstants = TelemetryConstants;
+let ConversationStage;
+exports.ConversationStage = ConversationStage;
+(function (ConversationStage) {
+  ConversationStage["Initialization"] = "Initialization";
+  ConversationStage["CSREngagement"] = "CSR Engagement";
+  ConversationStage["ConversationEnd"] = "Conversation End";
+})(ConversationStage || (exports.ConversationStage = ConversationStage = {}));

package/lib/cjs/common/telemetry/TelemetryManager.js

@@ -50,7 +50,7 @@ const RegisterLoggers = () => {
       loggers.push((0, _consoleLogger.consoleLogger)());
     }
     if (((_TelemetryManager$Int9 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int9 === void 0 ? void 0 : (_TelemetryManager$Int10 = _TelemetryManager$Int9.telemetryConfig) === null || _TelemetryManager$Int10 === void 0 ? void 0 : _TelemetryManager$Int10.telemetryDisabled) === false) {
-      var _TelemetryManager$Int11, _TelemetryManager$Int20, _TelemetryManager$Int21, _TelemetryManager$Int22, _TelemetryManager$Int23;
+      var _TelemetryManager$Int11, _TelemetryManager$Int20, _TelemetryManager$Int21, _TelemetryManager$Int22, _TelemetryManager$Int23, _TelemetryManager$Int24, _TelemetryManager$Int25, _TelemetryManager$Int26;
       if ((_TelemetryManager$Int11 = TelemetryManager.InternalTelemetryData) !== null && _TelemetryManager$Int11 !== void 0 && _TelemetryManager$Int11.ariaConfig) {
         var _TelemetryManager$Int12, _TelemetryManager$Int13, _TelemetryManager$Int14, _TelemetryManager$Int15, _TelemetryManager$Int16, _TelemetryManager$Int17, _TelemetryManager$Int18, _TelemetryManager$Int19;
         loggers.push((0, _ariaTelemetryLogger.ariaTelemetryLogger)(((_TelemetryManager$Int12 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int12 === void 0 ? void 0 : (_TelemetryManager$Int13 = _TelemetryManager$Int12.ariaConfig) === null || _TelemetryManager$Int13 === void 0 ? void 0 : _TelemetryManager$Int13.ariaTelemetryKey) ?? _defaultAriaConfig.defaultAriaConfig.ariaTelemetryKey, ((_TelemetryManager$Int14 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int14 === void 0 ? void 0 : (_TelemetryManager$Int15 = _TelemetryManager$Int14.ariaConfig) === null || _TelemetryManager$Int15 === void 0 ? void 0 : _TelemetryManager$Int15.disableCookieUsage) ?? _defaultAriaConfig.defaultAriaConfig.disableCookieUsage, ((_TelemetryManager$Int16 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int16 === void 0 ? void 0 : (_TelemetryManager$Int17 = _TelemetryManager$Int16.ariaConfig) === null || _TelemetryManager$Int17 === void 0 ? void 0 : _TelemetryManager$Int17.collectorUriForTelemetry) ?? _defaultAriaConfig.defaultAriaConfig.collectorUriForTelemetry, ((_TelemetryManager$Int18 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int18 === void 0 ? void 0 : (_TelemetryManager$Int19 = _TelemetryManager$Int18.ariaConfig) === null || _TelemetryManager$Int19 === void 0 ? void 0 : _TelemetryManager$Int19.ariaTelemetryApplicationName) ?? _defaultAriaConfig.defaultAriaConfig.ariaTelemetryApplicationName));
@@ -61,12 +61,15 @@ const RegisterLoggers = () => {
           loggers.push(logger);
         });
       }
-      if (((_TelemetryManager$Int22 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int22 === void 0 ? void 0 : (_TelemetryManager$Int23 = _TelemetryManager$Int22.appInsightsConfig) === null || _TelemetryManager$Int23 === void 0 ? void 0 : _TelemetryManager$Int23.appInsightsDisabled) === false) {
-        var _TelemetryManager$Int24;
-        if ((_TelemetryManager$Int24 = TelemetryManager.InternalTelemetryData) !== null && _TelemetryManager$Int24 !== void 0 && _TelemetryManager$Int24.appInsightsConfig.appInsightsKey) {
-          var _TelemetryManager$Int25;
-          loggers.push((0, _appInsightsLogger.appInsightsLogger)((_TelemetryManager$Int25 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int25 === void 0 ? void 0 : _TelemetryManager$Int25.appInsightsConfig.appInsightsKey));
-        }
+      const chatConfigAppInsightsKey = (_TelemetryManager$Int22 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int22 === void 0 ? void 0 : _TelemetryManager$Int22.chatConfigAppInsightsKey;
+      const appInsightsKeyFromUser = (_TelemetryManager$Int23 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int23 === void 0 ? void 0 : (_TelemetryManager$Int24 = _TelemetryManager$Int23.appInsightsConfig) === null || _TelemetryManager$Int24 === void 0 ? void 0 : _TelemetryManager$Int24.appInsightsKey;
+      // when chatConfig has AppInsightsInstrumentationKey
+      if (chatConfigAppInsightsKey) {
+        loggers.push((0, _appInsightsLogger.appInsightsLogger)(chatConfigAppInsightsKey));
+      }
+      // when key set through appInsightsConfig
+      else if (appInsightsKeyFromUser && ((_TelemetryManager$Int25 = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int25 === void 0 ? void 0 : (_TelemetryManager$Int26 = _TelemetryManager$Int25.appInsightsConfig) === null || _TelemetryManager$Int26 === void 0 ? void 0 : _TelemetryManager$Int26.appInsightsDisabled) === false) {
+        loggers.push((0, _appInsightsLogger.appInsightsLogger)(appInsightsKeyFromUser));
       }
     }
   };

package/lib/cjs/common/telemetry/loggers/appInsightsLogger.js

@@ -14,15 +14,12 @@ function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "functio
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 var AllowedKeys;
 (function (AllowedKeys) {
-  AllowedKeys["LogLevel"] = "LogLevel";
-  AllowedKeys["Description"] = "Description";
-  AllowedKeys["ExceptionDetails"] = "ExceptionDetails";
-  AllowedKeys["ChannelId"] = "ChannelId";
+  AllowedKeys["OrganizationId"] = "powerplatform.analytics.resource.organization.id";
+  AllowedKeys["ConversationId"] = "powerplatform.analytics.resource.id";
+  AllowedKeys["ElapsedTimeInMilliseconds"] = "Duration";
+  AllowedKeys["Description"] = "omnichannel.description";
+  AllowedKeys["ChannelId"] = "omnichannel.channel.type";
   AllowedKeys["LCWRuntimeId"] = "ClientSessionId";
-  AllowedKeys["ConversationId"] = "LiveWorkItemId";
-  AllowedKeys["ChatId"] = "ChatThreadId";
-  AllowedKeys["OrganizationId"] = "OrganizationId";
-  AllowedKeys["ElapsedTimeInMilliseconds"] = "DurationInMilliseconds";
 })(AllowedKeys || (AllowedKeys = {}));
 let initializationPromise = null;
 const appInsightsLogger = appInsightsKey => {
@@ -95,11 +92,11 @@ const appInsightsLogger = appInsightsKey => {
         if (!_logger) return;
         const eventName = telemetryInput === null || telemetryInput === void 0 ? void 0 : (_telemetryInput$paylo = telemetryInput.payload) === null || _telemetryInput$paylo === void 0 ? void 0 : _telemetryInput$paylo.Event;
         const telemetryInfo = telemetryInput === null || telemetryInput === void 0 ? void 0 : (_telemetryInput$telem = telemetryInput.telemetryInfo) === null || _telemetryInput$telem === void 0 ? void 0 : _telemetryInput$telem.telemetryInfo;
-        const eventProperties = setEventProperties(telemetryInfo);
         if (eventName) {
           const trackingEventName = getTrackingEventName(logLevel, eventName);
-          _logger.trackEvent({
-            name: trackingEventName,
+          const eventProperties = setEventProperties(trackingEventName, telemetryInfo);
+          _logger.trackTrace({
+            message: trackingEventName,
             properties: eventProperties
           });
         }
@@ -116,17 +113,36 @@ const appInsightsLogger = appInsightsKey => {
   };
 
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  function setEventProperties(telemetryInfo) {
+  function setEventProperties(eventName, telemetryInfo) {
     const eventProperties = {};
     if (telemetryInfo) {
       for (const key in AllowedKeys) {
-        const finalKey = AllowedKeys[key]; // get renamed keys for LCWRuntimeId, ConversationId, ChatId
+        const finalKey = AllowedKeys[key]; // get renamed keys for LCWRuntimeId, ConversationId
         const value = telemetryInfo[key];
         if (value !== undefined && value !== null && value !== "") {
           eventProperties[finalKey] = value;
         }
       }
     }
+    // Include exception details in description for error events
+    if (telemetryInfo !== null && telemetryInfo !== void 0 && telemetryInfo.ExceptionDetails) {
+      eventProperties[AllowedKeys.Description] = JSON.stringify(telemetryInfo.ExceptionDetails);
+    }
+    const customProperties = (() => {
+      if (!(telemetryInfo !== null && telemetryInfo !== void 0 && telemetryInfo.CustomProperties)) {
+        return {};
+      }
+      try {
+        return typeof telemetryInfo.CustomProperties === "string" ? JSON.parse(telemetryInfo.CustomProperties) : telemetryInfo.CustomProperties;
+      } catch (error) {
+        console.warn("Failed to parse CustomProperties:", error);
+        return {};
+      }
+    })();
+    // Additional properties
+    eventProperties["ConversationStage"] = customProperties.ConversationStage ?? _TelemetryConstants.ConversationStage.CSREngagement;
+    eventProperties["Scenario"] = "Conversation Diagnostics";
+    eventProperties["powerplatform.analytics.subscenario"] = eventName.includes(": ") ? eventName.split(": ")[1] : eventName;
     return eventProperties;
   }
   function getTrackingEventName(logLevel, eventName) {

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/errorboundary/ErrorBoundary.js

@@ -19,11 +19,12 @@ function _possibleConstructorReturn(self, call) { if (call && (typeof call === "
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+// eslint-disable-next-line @typescript-eslint/ban-types
 const RenderChildrenFunction = _ref => {
   let {
     children
   } = _ref;
-  return typeof children === 'function' ? children() : children;
+  return typeof children === "function" ? children() : children;
 };
 let ErrorBoundary = /*#__PURE__*/function (_Component) {
   _inherits(ErrorBoundary, _Component);

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/ChatWidgetEvents.js

@@ -9,7 +9,7 @@ var 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["HIDE_LOADING_BANNER"] = "CHAT_WIDGET/HIDE_LOADING_BANNER";
+  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

@@ -36,7 +36,7 @@ let PersistentConversationHandler = /*#__PURE__*/function () {
     _defineProperty(this, "facadeChatSDK", void 0);
     _defineProperty(this, "lastMessage", null);
     _defineProperty(this, "count", 0);
-    _defineProperty(this, "pageSize", 4);
+    _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(() => {
@@ -48,18 +48,21 @@ let PersistentConversationHandler = /*#__PURE__*/function () {
       Event: _TelemetryConstants.TelemetryEvent.LCWPersistentConversationHandlerInitialized,
       Description: "PersistentConversationHandler initialized",
       CustomProperties: {
-        pageSize: this.pageSize
+        pageSize: _defaultPersistentChatHistoryProps.defaultPersistentChatHistoryProps.pageSize
       }
     });
   }
   _createClass(PersistentConversationHandler, [{
     key: "appliedPropsHandler",
     value: function appliedPropsHandler(props) {
+      var _this$appliedProps;
       this.appliedProps = {
         ..._defaultPersistentChatHistoryProps.defaultPersistentChatHistoryProps,
         ...props
       };
-      this.pageSize = this.appliedProps.pageSize || 4;
+
+      // 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",
@@ -104,12 +107,23 @@ let PersistentConversationHandler = /*#__PURE__*/function () {
       try {
         var _ref;
         const messages = await this.fetchHistoryMessages();
-        if (messages === null || (messages === null || messages === void 0 ? void 0 : messages.length) === 0) {
+
+        // 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);
-          // Also hide the loading banner
-          (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.HIDE_LOADING_BANNER);
           _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.INFO, {
             Event: _TelemetryConstants.TelemetryEvent.LCWPersistentHistoryPullCompleted,
             Description: "History pull completed - no more messages",
@@ -119,9 +133,6 @@ let PersistentConversationHandler = /*#__PURE__*/function () {
         }
         const messagesDescOrder = (_ref = [...messages]) === null || _ref === void 0 ? void 0 : _ref.reverse();
         this.processHistoryMessages(messagesDescOrder);
-
-        // Dispatch event to hide the loading banner after messages are processed
-        (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.HIDE_LOADING_BANNER);
         _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.INFO, {
           Event: _TelemetryConstants.TelemetryEvent.LCWPersistentHistoryPullCompleted,
           Description: "History pull completed successfully",
@@ -177,7 +188,6 @@ let PersistentConversationHandler = /*#__PURE__*/function () {
       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);
-        (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.HIDE_LOADING_BANNER);
         return [];
       }
       const options = {
@@ -203,24 +213,20 @@ let PersistentConversationHandler = /*#__PURE__*/function () {
           this.isLastPull = true;
           // Dispatch event when we reach the end of available history
           (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.NO_MORE_HISTORY_AVAILABLE);
-          // Also hide the loading banner
-          (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.HIDE_LOADING_BANNER);
           return [];
         }
-        (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.HIDE_LOADING_BANNER);
         return messages;
       } catch (error) {
         _TelemetryHelper.TelemetryHelper.logSDKEvent(_TelemetryConstants.LogLevel.ERROR, {
           Event: _TelemetryConstants.TelemetryEvent.FetchPersistentChatHistoryFailed,
           ExceptionDetails: error
         });
-        this.isLastPull = true;
-        this.pageToken = null;
-        // Dispatch event when there's an error to stop loading banner
-        (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.NO_MORE_HISTORY_AVAILABLE);
-        // Also hide the loading banner
-        (0, _dispatchCustomEvent.default)(_ChatWidgetEvents.default.HIDE_LOADING_BANNER);
-        return [];
+
+        // 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;
       }
     }
   }, {

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

@@ -5,8 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.defaultPersistentChatHistoryProps = void 0;
 const defaultPersistentChatHistoryProps = {
-  persistentChatHistoryEnabled: true,
-  pageSize: 4,
+  pageSize: 10,
   dividerActivityStyle: {
     border: "1px solid rgb(96, 94, 92, 0.5)",
     margin: "10px 20%"

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

@@ -12,6 +12,8 @@ var _omnichannelChatComponents = require("@microsoft/omnichannel-chat-components
 var _ConversationState = require("../../../contexts/common/ConversationState");
 var _LazyLoadActivity = require("../../webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activities/LazyLoadActivity");
 var _LiveChatWidgetActionType = require("../../../contexts/common/LiveChatWidgetActionType");
+var _NotificationHandler = require("../../webchatcontainerstateful/webchatcontroller/notification/NotificationHandler");
+var _NotificationScenarios = require("../../webchatcontainerstateful/webchatcontroller/enums/NotificationScenarios");
 var _TelemetryHelper = require("../../../common/telemetry/TelemetryHelper");
 var _TelemetryManager = require("../../../common/telemetry/TelemetryManager");
 var _WebChatStoreLoader = require("../../webchatcontainerstateful/webchatcontroller/WebChatStoreLoader");
@@ -201,6 +203,18 @@ const endChat = async (props, facadeChatSDK, state, dispatch, setAdapter, setWeb
       facadeChatSDK.destroy();
     }
   }
+
+  //moving logic below to before processing skipCloseChat logic to avoid race conditions of postMessage for endChatEvent for other tabs vs postMessage for CloseChat
+  //TODO: clarify if this postMessageToOtherTab actually works in production.
+  if (postMessageToOtherTab) {
+    const endChatEventName = await getEndChatEventName(facadeChatSDK, props);
+    _omnichannelChatComponents.BroadcastService.postMessage({
+      eventName: endChatEventName,
+      payload: {
+        runtimeId: _TelemetryManager.TelemetryManager.InternalTelemetryData.lcwRuntimeId
+      }
+    });
+  }
   if (!skipCloseChat) {
     try {
       var _props$webChatContain;
@@ -240,17 +254,17 @@ const endChat = async (props, facadeChatSDK, state, dispatch, setAdapter, setWeb
       });
       closeChatWidget(dispatch, setWebChatStyles, props);
       facadeChatSDK.destroy();
+
+      //always post the close chat event after chat closed and cleanup completed
+      _omnichannelChatComponents.BroadcastService.postMessage({
+        eventName: _TelemetryConstants.BroadcastEvent.CloseChat
+      });
+      _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.INFO, {
+        Event: _TelemetryConstants.TelemetryEvent.CloseChatCall,
+        Description: "Broadcasted close chat event"
+      });
     }
   }
-  if (postMessageToOtherTab) {
-    const endChatEventName = await getEndChatEventName(facadeChatSDK, props);
-    _omnichannelChatComponents.BroadcastService.postMessage({
-      eventName: endChatEventName,
-      payload: {
-        runtimeId: _TelemetryManager.TelemetryManager.InternalTelemetryData.lcwRuntimeId
-      }
-    });
-  }
 };
 exports.endChat = endChat;
 const callingStateCleanUp = dispatch => {
@@ -331,6 +345,9 @@ const closeChatStateCleanUp = dispatch => {
     payload: {}
   });
 
+  // Dismiss the chat disconnect notification banner if it was shown
+  _NotificationHandler.NotificationHandler.dismissNotification(_NotificationScenarios.NotificationScenarios.ChatDisconnect);
+
   // Clear live chat context only if chat widget is fully closed to support transcript calls after sessionclose is called
   dispatch({
     type: _LiveChatWidgetActionType.LiveChatWidgetActionType.SET_LIVE_CHAT_CONTEXT,