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

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

@@ -7,70 +7,42 @@ exports.detectAndCleanXSS = void 0;
 var _dompurify = _interopRequireDefault(require("dompurify"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /**
- * Detects potential Cross-Site Scripting (XSS) attacks in text input and sanitizes the content.
+ * Sanitizes text input and detects XSS attack patterns.
  * 
- * This function performs comprehensive XSS detection using pattern matching for common attack vectors
- * and then sanitizes the input using DOMPurify with strict configuration. It's designed to protect
- * against various XSS techniques including script injection, event handler injection, style-based
- * attacks, and encoded payloads.
+ * Sanitizes first with DOMPurify, then checks for malicious patterns in both
+ * the original and sanitized text to catch mutation XSS attacks.
  * 
- * Security patterns detected:
- * - JavaScript protocol URLs (javascript:)
- * - HTML event handlers (onmouseover, onclick, etc.)
- * - Script tags (<script>)
- * - CSS expression() functions
- * - CSS url() functions
- * - Position-based CSS attacks (position: fixed/absolute)
- * - VBScript protocol URLs
- * - Data URLs with HTML content
- * - Fragment identifiers with escaped quotes
- * - HTML entity-encoded angle brackets
- * 
- * @param text - The input text to be analyzed and sanitized
- * @returns An object containing:
- *   - cleanText: The sanitized version of the input text with all HTML tags and attributes removed
- *   - isXSSDetected: Boolean flag indicating whether potential XSS patterns were found in the original text
+ * @param text - Input text to sanitize
+ * @returns Object with cleanText (sanitized) and isXSSDetected flag
  */
 const detectAndCleanXSS = text => {
-  // Comprehensive array of regular expressions to detect common XSS attack patterns
-  const xssPatterns = [/javascript\s*:/gi,
-  // JavaScript protocol URLs (with optional spaces)
-  /vbscript\s*:/gi,
-  // VBScript protocol URLs (with optional spaces)
-  /on\w+\s*=/gi,
-  // HTML event handlers (onmouseover, onclick, onload, etc.)
-  /<\s*script/gi,
-  // Script tag opening (with optional spaces)
-  /expression\s*\(/gi,
-  // CSS expression() function (IE-specific)
-  /url\s*\(/gi,
-  // CSS url() function
-  /style\s*=.*position\s*:\s*fixed/gi,
-  // CSS position fixed attacks
-  /style\s*=.*position\s*:\s*absolute/gi,
-  // CSS position absolute attacks
-  /data\s*:\s*text\s*\/\s*html/gi,
-  // Data URLs containing HTML
-  /#.*\\"/gi,
-  // Fragment identifiers with escaped quotes
-  /&gt;.*&lt;/gi // HTML entity-encoded angle brackets indicating tag structure
-  ];
-
-  // Check if any XSS patterns are detected in the input text
-  const isXSSDetected = xssPatterns.some(pattern => pattern.test(text));
-
-  // Clean the text using DOMPurify with strict config
+  // Sanitize first to prevent mutation XSS (e.g., "s<iframe></iframe>tyle" → "style")
   const cleanText = _dompurify.default.sanitize(text, {
     ALLOWED_TAGS: [],
-    // No HTML tags allowed in title
     ALLOWED_ATTR: [],
     KEEP_CONTENT: true,
-    // Keep text content
     ALLOW_DATA_ATTR: false,
     ALLOW_UNKNOWN_PROTOCOLS: false,
     SANITIZE_DOM: true,
     FORCE_BODY: false
   });
+  const contentChanged = text !== cleanText;
+
+  // Non-global regex patterns to avoid stateful .test() issues
+  const xssPatterns = [/javascript\s*:/i, /vbscript\s*:/i, /on\w+\s*=/i,
+  // Event handlers
+  /<\s*script/i, /<\s*iframe/i, /<\s*object/i, /<\s*embed/i, /<\s*svg/i, /expression\s*\(/i,
+  // IE CSS expressions
+  /style\s*=.*position\s*:\s*(fixed|absolute)/i, /data\s*:\s*text\s*\/\s*html/i, /#.*\\"/i, /&(lt|gt|#x3c|#60|#x3e|#62);/i,
+  // HTML entities
+  /&#x?[0-9a-f]+;.*</i, /\u003c.*\u003e/i,
+  // Unicode escapes
+  /src\s*=\s*["']?\s*javascript:/i, /href\s*=\s*["']?\s*javascript:/i];
+  const hasXSSPattern = xssPatterns.some(pattern => {
+    return pattern.test(text) || pattern.test(cleanText);
+  });
+  const hasHTMLStructure = /<[^>]+>/.test(text) && !/<[^>]+>/.test(cleanText);
+  const isXSSDetected = contentChanged || hasXSSPattern || hasHTMLStructure;
   return {
     cleanText,
     isXSSDetected

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/ActivitySubscriber/BotAuthActivitySubscriber.js

@@ -44,7 +44,7 @@ const extractSasUrl = async attachment => {
   }
   return sasUrl;
 };
-const fetchBotAuthConfig = async (retries, interval) => {
+const fetchBotAuthConfig = async (retries, interval, fallback) => {
   _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.INFO, {
     Event: _TelemetryConstants.TelemetryEvent.SetBotAuthProviderFetchConfig
   });
@@ -60,13 +60,23 @@ const fetchBotAuthConfig = async (retries, interval) => {
   });
   if (retries === 1) {
     // Base Case
-    throw new Error();
+    if (response !== undefined) {
+      return response;
+    }
+    if (fallback !== undefined) {
+      _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.WARN, {
+        Event: _TelemetryConstants.TelemetryEvent.SetBotAuthProviderNotFound,
+        Description: `Failed to fetch bot auth config after maximum retries. Using fallback value: ${fallback}`
+      });
+      return fallback;
+    }
+    throw new Error("Failed to fetch bot auth config after maximum retries");
   }
   await delay(interval);
   if (response !== undefined) {
     return response;
   }
-  return await fetchBotAuthConfig(--retries, interval);
+  return await fetchBotAuthConfig(--retries, interval, fallback);
 };
 let BotAuthActivitySubscriber = /*#__PURE__*/function () {
   function BotAuthActivitySubscriber() {
@@ -76,6 +86,7 @@ let BotAuthActivitySubscriber = /*#__PURE__*/function () {
     _defineProperty(this, "signInCardSeen", void 0);
     _defineProperty(this, "fetchBotAuthConfigRetries", void 0);
     _defineProperty(this, "fetchBotAuthConfigRetryInterval", void 0);
+    _defineProperty(this, "fallbackShowSignInCard", void 0);
     this.signInCardSeen = new Set();
     this.fetchBotAuthConfigRetries = 3;
     this.fetchBotAuthConfigRetryInterval = 1000;
@@ -85,6 +96,11 @@ let BotAuthActivitySubscriber = /*#__PURE__*/function () {
     if (optionalParams.fetchBotAuthConfigRetryInterval) {
       this.fetchBotAuthConfigRetryInterval = optionalParams.fetchBotAuthConfigRetryInterval;
     }
+    this.fallbackShowSignInCard = optionalParams.fallbackShowSignInCard;
+    _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.INFO, {
+      Event: _TelemetryConstants.TelemetryEvent.SetBotAuthProviderFetchConfig,
+      Description: `BotAuthActivitySubscriber initialized with fallbackShowSignInCard: ${optionalParams.fallbackShowSignInCard}`
+    });
   }
   _createClass(BotAuthActivitySubscriber, [{
     key: "applicable",
@@ -129,7 +145,7 @@ let BotAuthActivitySubscriber = /*#__PURE__*/function () {
         _omnichannelChatComponents.BroadcastService.postMessage(event);
       }
       try {
-        const response = await fetchBotAuthConfig(this.fetchBotAuthConfigRetries, this.fetchBotAuthConfigRetryInterval);
+        const response = await fetchBotAuthConfig(this.fetchBotAuthConfigRetries, this.fetchBotAuthConfigRetryInterval, this.fallbackShowSignInCard);
         if (response === false) {
           _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.INFO, {
             Event: _TelemetryConstants.TelemetryEvent.SetBotAuthProviderHideCard
@@ -140,9 +156,10 @@ let BotAuthActivitySubscriber = /*#__PURE__*/function () {
           });
           return activity;
         }
-      } catch {
+      } catch (e) {
         _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.INFO, {
-          Event: _TelemetryConstants.TelemetryEvent.SetBotAuthProviderNotFound
+          Event: _TelemetryConstants.TelemetryEvent.SetBotAuthProviderNotFound,
+          ExceptionDetails: e instanceof Error ? e.message : JSON.stringify(e)
         });
         //this is to ensure listener continues waiting for response
         if (this.signInCardSeen.has(signInId)) {

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;