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

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activities/LoadInlineBannerActivity.js

@@ -0,0 +1,25 @@
+import React, { useMemo } from "react";
+import { defaultInlineBannerStyle } from "../defaultStyles/defaultInLineBannerStyle";
+import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
+import { mergeStyles } from "@fluentui/merge-styles";
+const LoadInlineBannerActivity = _ref => {
+  let {
+    webChatContainerProps,
+    persistentChatHistory,
+    id
+  } = _ref;
+  const localizedTexts = useMemo(() => ({
+    ...defaultMiddlewareLocalizedTexts,
+    ...(webChatContainerProps === null || webChatContainerProps === void 0 ? void 0 : webChatContainerProps.localizedTexts)
+  }), [webChatContainerProps === null || webChatContainerProps === void 0 ? void 0 : webChatContainerProps.localizedTexts]);
+  const bannerStyle = mergeStyles(persistentChatHistory === null || persistentChatHistory === void 0 ? void 0 : persistentChatHistory.bannerStyle, defaultInlineBannerStyle);
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
+    id: id,
+    className: bannerStyle,
+    role: "status",
+    "aria-live": "polite",
+    "aria-label": localizedTexts.PREVIOUS_MESSAGES_LOADING,
+    "aria-busy": "true"
+  }, localizedTexts.PREVIOUS_MESSAGES_LOADING));
+};
+export default LoadInlineBannerActivity;

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activityMiddleware.js

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable react/display-name */
 /******
  * ActivityMiddleware
  * 
@@ -7,8 +9,10 @@
  * 3. Decodes certain html characters that came through from chat services
  ******/
 
+import LazyLoadActivity, { LazyLoadHandler } from "./activities/LazyLoadActivity";
 import { LogLevel, TelemetryEvent } from "../../../../../common/telemetry/TelemetryConstants";
 import { Constants } from "../../../../../common/Constants";
+import ConversationDividerActivity from "./activities/ConversationDividerActivity";
 import { DirectLineActivityType } from "../../enums/DirectLineActivityType";
 import { DirectLineSenderRole } from "../../enums/DirectLineSenderRole";
 import React from "react";
@@ -17,6 +21,7 @@ import { defaultSystemMessageStyles } from "./defaultStyles/defaultSystemMessage
 import { defaultUserMessageStyles } from "./defaultStyles/defaultUserMessageStyles";
 import { escapeHtml } from "../../../../../common/utils";
 const loggedSystemMessages = new Array();
+let lastRenderedAt = 0; // Track last rendered receivedAt timestamp for deduplication
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const handleSystemMessage = (next, args, card, renderMarkdown, systemMessageStyleProps) => {
   var _card$activity, _card$activity$channe, _card$activity$channe2, _card$activity2, _card$activity2$chann, _card$activity3, _card$activity3$chann, _card$activity3$chann2, _card$activity4, _card$activity4$chann, _card$activity5, _card$activity5$chann, _card$nextVisibleActi, _card$nextVisibleActi2, _card$activity6, _card$activity6$chann, _card$activity7, _card$nextVisibleActi3, _card$activity8;
@@ -81,6 +86,43 @@ export const createActivityMiddleware = (renderMarkdown, systemMessageStyleProps
     if (isTagIncluded(card, Constants.systemMessageTag)) {
       return handleSystemMessage(next, args, card, renderMarkdown, systemMessageStyleProps);
     }
+    if (isTagIncluded(card, Constants.persistentChatHistoryMessagePullTriggerTag)) {
+      var _card$activity9, _card$activity9$chann, _card$activity9$chann2;
+      // Safety check: if this is a new chat session and flag is false, auto-correct it
+      if (!LazyLoadHandler.hasMoreHistoryAvailable) {
+        LazyLoadHandler.setHasMoreHistoryAvailable(true);
+      }
+      const receivedAt = card === null || card === void 0 ? void 0 : (_card$activity9 = card.activity) === null || _card$activity9 === void 0 ? void 0 : (_card$activity9$chann = _card$activity9.channelData) === null || _card$activity9$chann === void 0 ? void 0 : (_card$activity9$chann2 = _card$activity9$chann.webChat) === null || _card$activity9$chann2 === void 0 ? void 0 : _card$activity9$chann2.receivedAt;
+      if (receivedAt < lastRenderedAt) {
+        card.activity = null;
+        return () => false;
+      }
+      lastRenderedAt = receivedAt;
+
+      // Return a function that checks availability at render time
+      return () => {
+        // Double-check at render time in case history availability changed
+        if (!LazyLoadHandler.hasMoreHistoryAvailable) {
+          return null;
+        }
+        return /*#__PURE__*/React.createElement(LazyLoadActivity, null);
+      };
+    }
+    if (isTagIncluded(card, Constants.persistentChatHistoryMessageTag)) {
+      const userMessageStyles = {
+        ...defaultUserMessageStyles,
+        ...userMessageStyleProps
+      };
+      return function () {
+        return /*#__PURE__*/React.createElement("div", {
+          className: card.activity.from.role === DirectLineSenderRole.User ? Constants.sentMessageClassName : Constants.receivedMessageClassName,
+          style: userMessageStyles
+        }, next(...args)(...arguments));
+      };
+    }
+    if (isTagIncluded(card, Constants.conversationDividerTag)) {
+      return /*#__PURE__*/React.createElement(ConversationDividerActivity, null);
+    }
     if (card.activity.text && card.activity.type === DirectLineActivityType.Message) {
       if (!card.activity.channelData.isHtmlEncoded && card.activity.channelId === Constants.webchatChannelId) {
         card.activity.text = escapeHtml(card.activity.text);

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activityStatusMiddleware.js

@@ -1,5 +1,6 @@
 import { Constants, WebChatMiddlewareConstants } from "../../../../../common/Constants";
 import { DeliveredTimestamp } from "./timestamps/DeliveredTimestamp";
+import { HistoryMessageTimestamp } from "./timestamps/HistoryMessageTimestamp";
 import { NotDeliveredTimestamp } from "./timestamps/NotDeliveredTimestamp";
 import React from "react";
 import { SendStatus } from "../../enums/SendStatus";
@@ -26,6 +27,11 @@ export const activityStatusMiddleware = () => next => args => {
     current_role = role,
     current_timestamp = timestamp;
   let sameTimestampGroupTemp = sameTimestampGroup;
+  if (tags !== null && tags !== void 0 && tags.includes(Constants.persistentChatHistoryMessageTag)) {
+    return /*#__PURE__*/React.createElement(HistoryMessageTimestamp, {
+      args: args
+    });
+  }
   if (args[WebChatMiddlewareConstants.nextVisibleActivity]) {
     const {
       nextVisibleActivity: {
@@ -35,6 +41,7 @@ export const activityStatusMiddleware = () => next => args => {
         timestamp
       }
     } = args;
+
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const next_name = name,
       next_timestamp = timestamp;
@@ -61,4 +68,10 @@ export const activityStatusMiddleware = () => next => args => {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ;
   }
+};
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const createActivityStatusMiddleware = function () {
+  let locale = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "en-us";
+  return activityStatusMiddleware;
 };

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/defaultStyles/defaultInLineBannerStyle.js

@@ -0,0 +1,13 @@
+import { defaultSystemMessageStyles } from "./defaultSystemMessageStyles";
+// Adjust the import path if necessary
+
+export const defaultInlineBannerStyle = {
+  ...defaultSystemMessageStyles,
+  visibility: "visible",
+  height: "20px",
+  display: "flex",
+  justifyContent: "center",
+  alignItems: "center",
+  margin: "5px 10px",
+  cursor: "pointer"
+};

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/DeliveredTimestamp.js

@@ -4,7 +4,7 @@ import { Stack } from "@fluentui/react";
 import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
 import { defaultTimestampContentStyles } from "../defaultStyles/defaultTimestampContentStyles";
 import { getTimestampHourMinute } from "../../../../../../common/utils";
-import { useChatContextStore } from "../../../../../..";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
 
 /* eslint @typescript-eslint/no-explicit-any: "off" */
 export const DeliveredTimestamp = _ref => {

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/HistoryMessageTimestamp.js

@@ -0,0 +1,52 @@
+import React from "react";
+import { Stack } from "@fluentui/react";
+import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
+import { defaultTimestampContentStyles } from "../defaultStyles/defaultTimestampContentStyles";
+import { getTimestampHourMinute } from "../../../../../../common/utils";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const HistoryMessageTimestamp = _ref => {
+  var _state$domainStates$r, _state$domainStates$r2, _state$domainStates$m;
+  let {
+    args
+  } = _ref;
+  const [state] = useChatContextStore();
+  const dir = ((_state$domainStates$r = state.domainStates.renderingMiddlewareProps) === null || _state$domainStates$r === void 0 ? void 0 : _state$domainStates$r.timestampDir) ?? state.domainStates.globalDir;
+  const {
+    activity: {
+      timestamp,
+      from: {
+        name,
+        role
+      }
+    }
+  } = args;
+  const contentStyles = {
+    ...defaultTimestampContentStyles,
+    ...((_state$domainStates$r2 = state.domainStates.renderingMiddlewareProps) === null || _state$domainStates$r2 === void 0 ? void 0 : _state$domainStates$r2.timestampContentStyleProps)
+  };
+  const getTimeElement = timestamp => {
+    const timeString = getTimestampHourMinute(timestamp);
+    const isAmPmFormat = timeString.toLowerCase().includes("am") || timeString.toLowerCase().includes("pm");
+    if (dir === "rtl" && isAmPmFormat) {
+      return /*#__PURE__*/React.createElement("span", {
+        dir: "ltr"
+      }, timeString);
+    } else {
+      return /*#__PURE__*/React.createElement("span", {
+        dir: dir
+      }, timeString);
+    }
+  };
+  return /*#__PURE__*/React.createElement(Stack, {
+    style: contentStyles,
+    dir: dir
+  }, role === "bot" && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("span", {
+    dir: dir,
+    "aria-hidden": "false"
+  }, name, " : ", getTimeElement(timestamp))), role === "user" && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("span", {
+    "aria-hidden": "false",
+    dir: dir
+  }, " ", getTimeElement(timestamp), " - ", ((_state$domainStates$m = state.domainStates.middlewareLocalizedTexts) === null || _state$domainStates$m === void 0 ? void 0 : _state$domainStates$m.MIDDLEWARE_MESSAGE_DELIVERED) ?? defaultMiddlewareLocalizedTexts.MIDDLEWARE_MESSAGE_DELIVERED), "            "));
+};

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/NotDeliveredTimestamp.js

@@ -7,9 +7,9 @@ import { defaultTimestampFailedStyles } from "../defaultStyles/defaultTimestampF
 import { defaultTimestampRetryStyles } from "../defaultStyles/defaultTimestampRetryStyles";
 import { getTimestampHourMinute } from "../../../../../../common/utils";
 import { hooks } from "botframework-webchat";
-import { useChatContextStore } from "../../../../../..";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
 
-/* eslint @typescript-eslint/no-explicit-any: "off" */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const NotDeliveredTimestamp = _ref => {
   var _state$domainStates$r, _state$domainStates$r2, _state$domainStates$r3, _state$domainStates$r4, _state$domainStates$m, _state$domainStates$m2;
   let {

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/SendingTimestamp.js

@@ -2,7 +2,7 @@ import React from "react";
 import { Stack } from "@fluentui/react";
 import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
 import { defaultTimestampContentStyles } from "../defaultStyles/defaultTimestampContentStyles";
-import { useChatContextStore } from "../../../../../..";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
 
 /* eslint @typescript-eslint/no-explicit-any: "off" */
 export const SendingTimestamp = () => {

package/lib/types/common/Constants.d.ts

@@ -28,6 +28,9 @@ export declare class Constants {
     static readonly channelIdKey = "ChannelId-";
     static readonly ChannelId = "lcw";
     static readonly CustomerTag = "FromCustomer";
+    static persistentChatHistoryMessageTag: string;
+    static persistentChatHistoryMessagePullTriggerTag: string;
+    static conversationDividerTag: string;
     static readonly GifContentType = "image/gif";
     static readonly video = "video";
     static readonly audio = "audio";

package/lib/types/common/facades/FacadeChatSDK.d.ts

@@ -1,4 +1,4 @@
-import { ChatAdapter, ChatSDKMessage, GetAgentAvailabilityResponse, GetLiveChatTranscriptResponse, GetVoiceVideoCallingResponse, IFileInfo, IRawMessage, MaskingRules, OmnichannelChatSDK, VoiceVideoCallingOptionalParams } from "@microsoft/omnichannel-chat-sdk";
+import { ChatAdapter, ChatSDKMessage, GetAgentAvailabilityResponse, GetLiveChatTranscriptResponse, GetPersistentChatHistoryResponse, GetVoiceVideoCallingResponse, IFileInfo, IRawMessage, MaskingRules, OmnichannelChatSDK, VoiceVideoCallingOptionalParams } from "@microsoft/omnichannel-chat-sdk";
 import { IFacadeChatSDKInput } from "./types/IFacadeChatSDKInput";
 import ChatAdapterOptionalParams from "@microsoft/omnichannel-chat-sdk/lib/core/messaging/ChatAdapterOptionalParams";
 import ChatConfig from "@microsoft/omnichannel-chat-sdk/lib/core/ChatConfig";
@@ -13,6 +13,7 @@ import GetChatTokenOptionalParams from "@microsoft/omnichannel-chat-sdk/lib/core
 import GetConversationDetailsOptionalParams from "@microsoft/omnichannel-chat-sdk/lib/core/GetConversationDetailsOptionalParams";
 import GetLiveChatConfigOptionalParams from "@microsoft/omnichannel-chat-sdk/lib/core/GetLiveChatConfigOptionalParams";
 import GetLiveChatTranscriptOptionalParams from "@microsoft/omnichannel-chat-sdk/lib/core/GetLiveChatTranscriptOptionalParams";
+import GetPersistentChatHistoryOptionalParams from "@microsoft/omnichannel-chat-sdk/lib/core/GetPersistentChatHistoryOptionalParams";
 import IChatToken from "@microsoft/omnichannel-chat-sdk/lib/external/IC3Adapter/IChatToken";
 import IFileMetadata from "@microsoft/omnichannel-ic3core/lib/model/IFileMetadata";
 import IMessage from "@microsoft/omnichannel-ic3core/lib/model/IMessage";
@@ -73,4 +74,5 @@ export declare class FacadeChatSDK {
     getPostChatSurveyContext(): Promise<PostChatContext>;
     getAgentAvailability(optionalParams?: GetAgentAvailabilityOptionalParams): Promise<GetAgentAvailabilityResponse>;
     getReconnectableChats(reconnectableChatsParams?: any): Promise<any>;
+    fetchPersistentConversationHistory(getPersistentChatHistoryOptionalParams?: GetPersistentChatHistoryOptionalParams): Promise<GetPersistentChatHistoryResponse>;
 }

package/lib/types/common/telemetry/TelemetryConstants.d.ts

@@ -56,9 +56,11 @@ export declare enum BroadcastEvent {
     SyncMinimize = "SyncMinimize",
     OnWidgetError = "OnWidgetError",
     FMLTrackingCompletedAck = "FMLTrackingCompletedAck",
-    FMLTrackingCompleted = "FMLTrackingCompleted"
+    FMLTrackingCompleted = "FMLTrackingCompleted",
+    PersistentConversationReset = "PersistentConversationReset"
 }
 export declare enum TelemetryEvent {
+    FetchPersistentChatHistoryFailed = "FetchPersistentChatHistoryFailed",
     CallAdded = "CallAdded",
     LocalVideoStreamAdded = "LocalVideoStreamAdded",
     LocalVideoStreamRemoved = "LocalVideoStreamRemoved",
@@ -269,7 +271,33 @@ export declare enum TelemetryEvent {
     UXLiveChatWidgetStart = "UXLiveChatWidgetStart",
     UXLiveChatWidgetCompleted = "UXLiveChatWidgetCompleted",
     AppInsightsInitialized = "AppInsightsInitialized",
-    AppInsightsInitFailed = "AppInsightsInitFailed"
+    AppInsightsInitFailed = "AppInsightsInitFailed",
+    ConvertPersistentChatHistoryMessageToActivityFailed = "ConvertPersistentChatHistoryMessageToActivityFailed",
+    UXLCWPersistentChatHistoryInitialized = "UXLCWPersistentChatHistoryInitialized",
+    LCWPersistentChatHistoryFetchStarted = "LCWPersistentChatHistoryFetchStarted",
+    LCWPersistentChatHistoryFetchCompleted = "LCWPersistentChatHistoryFetchCompleted",
+    LCWPersistentChatHistoryFetchFailed = "LCWPersistentChatHistoryFetchFailed",
+    LCWWebChatStorePollingStarted = "LCWWebChatStorePollingStarted",
+    LCWWebChatStoreReady = "LCWWebChatStoreReady",
+    LCWWebChatConnected = "LCWWebChatConnected",
+    LCWWebChatDisconnected = "LCWWebChatDisconnected",
+    LCWWebChatConnectionCheckFailed = "LCWWebChatConnectionCheckFailed",
+    LCWPersistentConversationHandlerInitialized = "LCWPersistentConversationHandlerInitialized",
+    LCWPersistentHistoryPullBlocked = "LCWPersistentHistoryPullBlocked",
+    LCWPersistentHistoryPullCompleted = "LCWPersistentHistoryPullCompleted",
+    LCWLazyLoadInitializationStarted = "LCWLazyLoadInitializationStarted",
+    LCWLazyLoadContainerNotFound = "LCWLazyLoadContainerNotFound",
+    LCWLazyLoadInitializationCompleted = "LCWLazyLoadInitializationCompleted",
+    LCWLazyLoadSessionMetrics = "LCWLazyLoadSessionMetrics",
+    LCWLazyLoadTargetElementNotFound = "LCWLazyLoadTargetElementNotFound",
+    LCWLazyLoadScrollFailed = "LCWLazyLoadScrollFailed",
+    LCWLazyLoadActivityMounted = "LCWLazyLoadActivityMounted",
+    LCWLazyLoadReset = "LCWLazyLoadReset",
+    LCWLazyLoadNoMoreHistory = "LCWLazyLoadNoMoreHistory",
+    LCWLazyLoadDestroyed = "LCWLazyLoadDestroyed",
+    SecureEventBusUnauthorizedDispatch = "SecureEventBusUnauthorizedDispatch",
+    SecureEventBusListenerError = "SecureEventBusListenerError",
+    SecureEventBusDispatchError = "SecureEventBusDispatchError"
 }
 export interface TelemetryInput {
     scenarioType: ScenarioType;

package/lib/types/common/utils/SecureEventBus.d.ts

@@ -0,0 +1,159 @@
+/**
+ * SecureEventBus class implementing the singleton pattern for secure event communication.
+ * Provides authentication-based event dispatching to prevent unauthorized external access.
+ */
+declare class SecureEventBus {
+    private static instance;
+    private listeners;
+    private readonly authToken;
+    private eventCounter;
+    /**
+     * Private constructor to enforce singleton pattern.
+     * Generates a unique authentication token for this session.
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of SecureEventBus.
+     * Creates a new instance if one doesn't exist.
+     *
+     * @returns The singleton instance of SecureEventBus
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * ```
+     */
+    static getInstance(): SecureEventBus;
+    /**
+     * Generate a cryptographically secure authentication token.
+     * Uses crypto.getRandomValues when available, falls back to Math.random.
+     *
+     * @private
+     * @returns A 64-character hexadecimal string representing the authentication token
+     */
+    private generateAuthToken;
+    /**
+     * Get the authentication token for this SecureEventBus instance.
+     * This token is required for dispatching events and should only be used internally.
+     *
+     * @returns The authentication token string
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * const token = eventBus.getAuthToken();
+     * eventBus.dispatch('myEvent', { data: 'value' }, token);
+     * ```
+     */
+    getAuthToken(): string;
+    /**
+     * Dispatch an event with authentication to all registered listeners.
+     * Verifies the authentication token before dispatching to prevent unauthorized access.
+     *
+     * @param eventName - The name of the event to dispatch
+     * @param payload - The data to send with the event (optional)
+     * @param token - Authentication token (must match the internal token)
+     * @returns true if event was successfully dispatched, false if unauthorized or error occurred
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * const token = eventBus.getAuthToken();
+     *
+     * // Dispatch with payload
+     * const success = eventBus.dispatch('userAction', { action: 'click', target: 'button' }, token);
+     *
+     * // Dispatch without payload
+     * eventBus.dispatch('windowClosed', undefined, token);
+     * ```
+     */
+    dispatch(eventName: string, payload?: any, token?: string): boolean;
+    /**
+     * Subscribe to an event with a callback function.
+     * The callback will be executed whenever the specified event is dispatched.
+     *
+     * @param eventName - The name of the event to listen for
+     * @param callback - The function to execute when the event is fired
+     * @returns A function that can be called to unsubscribe from the event
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     *
+     * // Subscribe to an event
+     * const unsubscribe = eventBus.subscribe('chatMessage', (message) => {
+     *   console.log('New message:', message.text);
+     *   console.log('From user:', message.userId);
+     * });
+     *
+     * // Later, unsubscribe
+     * unsubscribe();
+     * ```
+     */
+    subscribe(eventName: string, callback: (payload: any) => void): () => void;
+    /**
+     * Remove all listeners for a specific event.
+     * This completely removes the event from the internal listeners map.
+     *
+     * @param eventName - The name of the event to remove all listeners for
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     *
+     * // Remove all listeners for 'chatClosed' event
+     * eventBus.removeAllListeners('chatClosed');
+     * ```
+     */
+    removeAllListeners(eventName: string): void;
+    /**
+     * Clear all listeners for all events.
+     * This resets the entire event bus to its initial state.
+     * Useful for cleanup during application shutdown or testing.
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     *
+     * // Clear all event listeners
+     * eventBus.clear();
+     * ```
+     */
+    clear(): void;
+    /**
+     * Get the number of listeners for a specific event.
+     * Useful for debugging and monitoring purposes.
+     *
+     * @param eventName - The name of the event to count listeners for
+     * @returns The number of listeners registered for the event
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     *
+     * // Check how many listeners are registered for 'userAction'
+     * const count = eventBus.getListenerCount('userAction');
+     * console.log(`${count} listeners registered for userAction`);
+     * ```
+     */
+    getListenerCount(eventName: string): number;
+    /**
+     * Get all registered event names.
+     * Returns an array of event names that currently have listeners.
+     * Useful for debugging and monitoring purposes.
+     *
+     * @returns An array of event names that have registered listeners
+     *
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     *
+     * // Get all registered events
+     * const events = eventBus.getRegisteredEvents();
+     * console.log('Active events:', events);
+     * // Output: ['userAction', 'chatMessage', 'windowResize']
+     * ```
+     */
+    getRegisteredEvents(): string[];
+}
+export default SecureEventBus;

package/lib/types/common/utils/dispatchCustomEvent.d.ts

@@ -0,0 +1,2 @@
+declare const dispatchCustomEvent: (name: string, payload?: any) => void;
+export default dispatchCustomEvent;

package/lib/types/components/livechatwidget/common/ActivitySubscriber/AddActivitySubscriber.d.ts

@@ -0,0 +1,45 @@
+import { IActivitySubscriber } from "./IActivitySubscriber";
+/**
+ * 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.
+ */
+export declare class AddActivitySubscriber implements IActivitySubscriber {
+    /**
+     * 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`.
+     */
+    observer: any;
+    /**
+     * Set to track processed activity IDs to prevent duplicate processing.
+     */
+    private processedActivityIds;
+    /**
+     * Unsubscribe function for the secure event listener
+     */
+    private unsubscribeFromSecureEvent;
+    /**
+     * Subscription for PersistentConversationReset event
+     */
+    private resetEventListener;
+    /**
+     * 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.
+     */
+    constructor();
+    /**
+     * 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).
+     */
+    next(activity: any): Promise<any>;
+    /**
+     * Reset the processed activity IDs when a conversation resets
+     */
+    reset(): void;
+}

package/lib/types/components/livechatwidget/common/ChatWidgetEvents.d.ts

@@ -0,0 +1,7 @@
+declare enum ChatWidgetEvents {
+    ADD_ACTIVITY = "CHAT_WIDGET/ADD_ACTIVITY",
+    FETCH_PERSISTENT_CHAT_HISTORY = "CHAT_WIDGET/FETCH_PERSISTENT_CHAT_HISTORY",
+    NO_MORE_HISTORY_AVAILABLE = "CHAT_WIDGET/NO_MORE_HISTORY_AVAILABLE",
+    HIDE_LOADING_BANNER = "CHAT_WIDGET/HIDE_LOADING_BANNER"
+}
+export default ChatWidgetEvents;

package/lib/types/components/livechatwidget/common/PersistentConversationHandler.d.ts

@@ -0,0 +1,28 @@
+import { FacadeChatSDK } from "../../../common/facades/FacadeChatSDK";
+import { IPersistentChatHistoryProps } from "../interfaces/IPersistentChatHistoryProps";
+/**
+ * Class responsible for handling persistent conversation history
+ */
+declare class PersistentConversationHandler {
+    private appliedProps;
+    private isLastPull;
+    private pageToken;
+    private facadeChatSDK;
+    private lastMessage;
+    private count;
+    private pageSize;
+    private isCurrentlyPulling;
+    private pageTokenInTransitSet;
+    constructor(facadeChatSDK: FacadeChatSDK, props: IPersistentChatHistoryProps);
+    private appliedPropsHandler;
+    private resetEventListener;
+    reset(): void;
+    destroy(): void;
+    pullHistory(): Promise<void>;
+    private processHistoryMessages;
+    private fetchHistoryMessages;
+    private shouldPull;
+    private processMessageToActivity;
+    private createDividerActivity;
+}
+export default PersistentConversationHandler;

package/lib/types/components/livechatwidget/common/defaultProps/defaultPersistentChatHistoryProps.d.ts

@@ -0,0 +1,2 @@
+import { IPersistentChatHistoryProps } from "../../interfaces/IPersistentChatHistoryProps";
+export declare const defaultPersistentChatHistoryProps: IPersistentChatHistoryProps;

package/lib/types/components/livechatwidget/interfaces/ILiveChatWidgetProps.d.ts

@@ -20,6 +20,7 @@ import { ILoadingPaneProps } from "@microsoft/omnichannel-chat-components/lib/ty
 import { IMockProps } from "./IMockProps";
 import { INotificationPaneProps } from "@microsoft/omnichannel-chat-components/lib/types/components/notificationpane/interfaces/INotificationPaneProps";
 import { IOOOHPaneProps } from "@microsoft/omnichannel-chat-components/lib/types/components/outofofficehourspane/interfaces/IOOOHPaneProps";
+import { IPersistentChatHistoryProps } from "./IPersistentChatHistoryProps";
 import { IPostChatSurveyPaneStatefulProps } from "../../postchatsurveypanestateful/interfaces/IPostChatSurveyPaneStatefulProps";
 import { IPreChatSurveyPaneProps } from "@microsoft/omnichannel-chat-components/lib/types/components/prechatsurveypane/interfaces/IPreChatSurveyPaneProps";
 import { IProactiveChatPaneStatefulProps } from "../../proactivechatpanestateful/interfaces/IProactiveChatPaneStatefulProps";
@@ -69,4 +70,5 @@ export interface ILiveChatWidgetProps {
     mock?: IMockProps;
     featureConfigProps?: IFeatureConfigProps;
     appInsightsConfig?: IAppInsightsConfig;
+    persistentChatHistoryProps?: IPersistentChatHistoryProps;
 }

package/lib/types/components/livechatwidget/interfaces/IPersistentChatHistoryProps.d.ts

@@ -0,0 +1,7 @@
+import { IStyle } from "@fluentui/react";
+export interface IPersistentChatHistoryProps {
+    persistentChatHistoryEnabled?: boolean;
+    pageSize?: number;
+    dividerActivityStyle?: IStyle;
+    bannerStyle?: IStyle;
+}

package/lib/types/components/webchatcontainerstateful/common/activities/botActivity.d.ts

@@ -0,0 +1,7 @@
+declare const botActivity: {
+    from: {
+        role: string;
+    };
+    type: string;
+};
+export default botActivity;

package/lib/types/components/webchatcontainerstateful/common/activities/conversationDividerActivity.d.ts

@@ -0,0 +1,10 @@
+declare const conversationDividerActivity: {
+    channelData: {
+        tags: string[];
+    };
+    from: {
+        role: string;
+    };
+    type: string;
+};
+export default conversationDividerActivity;

package/lib/types/components/webchatcontainerstateful/common/activityConverters/convertPersistentChatHistoryMessageToActivity.d.ts

@@ -0,0 +1,2 @@
+declare const convertPersistentChatHistoryMessageToActivity: (message: any) => any;
+export default convertPersistentChatHistoryMessageToActivity;

package/lib/types/components/webchatcontainerstateful/hooks/usePersistentChatHistory.d.ts

@@ -0,0 +1,4 @@
+import { FacadeChatSDK } from "../../../common/facades/FacadeChatSDK";
+import { IPersistentChatHistoryProps } from "../../livechatwidget/interfaces/IPersistentChatHistoryProps";
+declare const usePersistentChatHistory: (facadeChatSDK: FacadeChatSDK | undefined, props: IPersistentChatHistoryProps) => void;
+export default usePersistentChatHistory;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/WebChatEventSubscribers.d.ts

@@ -0,0 +1,7 @@
+import { IPersistentChatHistoryProps } from "../../livechatwidget/interfaces/IPersistentChatHistoryProps";
+/**
+ * Component to handle persistent chat history events.
+ * Uses WebChatStoreLoader instead of hooks to avoid context issues.
+ */
+declare const WebChatEventSubscribers: (props: IPersistentChatHistoryProps) => null;
+export default WebChatEventSubscribers;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activities/Constants.d.ts

@@ -0,0 +1,3 @@
+export declare const LazyLoadActivityConstants: {
+    SCROLL_ID: string;
+};

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activities/ConversationDividerActivity.d.ts

@@ -0,0 +1,4 @@
+import { IPersistentChatHistoryProps } from "../../../../../livechatwidget/interfaces/IPersistentChatHistoryProps";
+import React from "react";
+declare const ConversationDividerActivity: (props: IPersistentChatHistoryProps) => React.JSX.Element;
+export default ConversationDividerActivity;