@microsoft/omnichannel-chat-widget 1.8.3-main.ec1328d → 1.8.4-main.4478bbf

package/lib/esm/firstresponselatency/FirstResponseLatencyTracker.js

@@ -7,6 +7,7 @@ function _toPrimitive(input, hint) { if (typeof input !== "object" || input ===
 import { BroadcastEvent, LogLevel, TelemetryEvent } from "../common/telemetry/TelemetryConstants";
 import { BroadcastService } from "@microsoft/omnichannel-chat-components";
 import { TelemetryHelper } from "../common/telemetry/TelemetryHelper";
+import { Constants } from "../common/Constants";
 export let FirstResponseLatencyTracker = /*#__PURE__*/function () {
   function FirstResponseLatencyTracker() {
     _classCallCheck(this, FirstResponseLatencyTracker);
@@ -127,7 +128,8 @@ export let FirstResponseLatencyTracker = /*#__PURE__*/function () {
         CustomProperties: {
           elapsedTime,
           userMessage: this.startTrackingMessage,
-          botMessage: this.stopTrackingMessage
+          botMessage: this.stopTrackingMessage,
+          type: payload === null || payload === void 0 ? void 0 : payload.type
         }
       });
     }
@@ -168,7 +170,9 @@ export let FirstResponseLatencyTracker = /*#__PURE__*/function () {
     value: function stopClock(payload) {
       try {
         if (!payload || !payload.Id) {
-          throw new Error("Invalid payload");
+          if ((payload === null || payload === void 0 ? void 0 : payload.type) !== Constants.typing) {
+            throw new Error("Invalid payload");
+          }
         }
 
         // Only allow stopTracking if sender is valid and tracking is active

package/lib/esm/index.js

@@ -7,5 +7,6 @@ import useFacadeChatSDKStore from "./hooks/useFacadeChatSDKStore";
 export { default as LiveChatWidget } from "./components/livechatwidget/LiveChatWidget";
 export { getMockChatSDKIfApplicable } from "./components/livechatwidget/common/getMockChatSDKIfApplicable";
 export { getWidgetCacheId, getWidgetEndChatEventName, ConversationState };
+export { LiveChatWidgetMockType } from "./components/livechatwidget/interfaces/IMockProps";
 export { encodeComponentString, decodeComponentString, BroadcastService, useChatSDKStore, useChatContextStore, useFacadeChatSDKStore };
 export * from "./components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares";

package/lib/esm/plugins/newMessageEventHandler.js

@@ -78,6 +78,9 @@ export const createOnNewAdapterActivityHandler = (chatId, userId, startTime) =>
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const messageHasNoAttachments = !(activity !== null && activity !== void 0 && activity.attachments) || (activity === null || activity === void 0 ? void 0 : activity.attachments.length) === 0;
     if (messageHasNoTags && messageHasNoText && messageHasNoAttachments) {
+      if ((activity === null || activity === void 0 ? void 0 : activity.type) === Constants.typing) {
+        return true;
+      }
       return false;
     }
     return true;
@@ -106,7 +109,7 @@ export const createOnNewAdapterActivityHandler = (chatId, userId, startTime) =>
     });
   };
   const raiseMessageEvent = activity => {
-    if ((activity === null || activity === void 0 ? void 0 : activity.type) === Constants.message) {
+    if ((activity === null || activity === void 0 ? void 0 : activity.type) === Constants.message || (activity === null || activity === void 0 ? void 0 : activity.type) === Constants.typing) {
       const scenarioType = getScenarioType(activity);
       switch (scenarioType) {
         case ScenarioType.UserSendMessageStrategy:

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";
@@ -43,6 +46,7 @@ export declare class Constants {
     static readonly averageWaitTimeMessageTag = "averagewaittime";
     static readonly message = "message";
     static readonly hiddenTag = "Hidden";
+    static readonly typing = "typing";
     static readonly prefixTimestampTag = "ServerMessageTimestamp_";
     static readonly acsChannel = "ACS_CHANNEL";
     static readonly publicMessageTag = "public";
@@ -153,6 +157,8 @@ export declare class HtmlAttributeNames {
     static readonly adaptiveCardTextBlockClassName = "ac-textBlock";
     static readonly adaptiveCardToggleInputClassName = "ac-toggleInput";
     static readonly adaptiveCardActionSetClassName = "ac-actionSet";
+    static readonly ocwCitationPaneClassName = "ocw-citation-pane";
+    static readonly ocwCitationPaneTitle = "Citation";
 }
 export declare class WebChatMiddlewareConstants {
     static readonly nextVisibleActivity = "nextVisibleActivity";

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",
@@ -136,6 +138,7 @@ export declare enum TelemetryEvent {
     EmailTranscriptLoaded = "EmailTranscriptLoaded",
     OutOfOfficePaneLoaded = "OutOfOfficePaneLoaded",
     ConfirmationPaneLoaded = "ConfirmationPaneLoaded",
+    CitationPaneLoaded = "CitationPaneLoaded",
     ProactiveChatPaneLoaded = "ProactiveChatPaneLoaded",
     ReconnectChatPaneLoaded = "ReconnectChatPaneLoaded",
     HeaderCloseButtonClicked = "HeaderCloseButtonClicked",
@@ -262,11 +265,42 @@ export declare enum TelemetryEvent {
     UXLCWChatButtonLoadingStart = "UXLCWChatButtonLoadingStart",
     UXLCWChatButtonLoadingCompleted = "UXLCWChatButtonLoadingCompleted",
     UXConfirmationPaneStart = "UXConfirmationPaneStart",
+    UXCitationPaneStart = "UXCitationPaneStart",
     UXConfirmationPaneCompleted = "UXConfirmationPaneCompleted",
+    UXCitationPaneCompleted = "UXCitationPaneCompleted",
     UXLiveChatWidgetStart = "UXLiveChatWidgetStart",
     UXLiveChatWidgetCompleted = "UXLiveChatWidgetCompleted",
+    UXPostChatPaneStarted = "UXPostChatPaneStarted",
+    UXPostChatPaneCompleted = "UXPostChatPaneCompleted",
     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",
+    StartChatComplete = "StartChatComplete"
 }
 export interface TelemetryInput {
     scenarioType: ScenarioType;
@@ -277,3 +311,8 @@ export declare class TelemetryConstants {
     private static map;
     static mapEventToScenario(eventTypeOrScenarioType: TelemetryEvent): ScenarioType;
 }
+export declare enum ConversationStage {
+    Initialization = "Initialization",
+    CSREngagement = "CSR Engagement",
+    ConversationEnd = "Conversation End"
+}

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/citationpanestateful/CitationDim.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+export declare const CitationDim: React.FC<{
+    brightness?: string;
+}>;
+export default CitationDim;

package/lib/types/components/citationpanestateful/CitationPaneStateful.d.ts

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

package/lib/types/components/citationpanestateful/common/defaultProps/defaultCitationPaneProps.d.ts

@@ -0,0 +1,11 @@
+export declare const defaultCitationPaneStyles: {
+    pane: React.CSSProperties;
+};
+export declare const defaultCitationContentCSS: (controlId: string) => string;
+declare const _default: {
+    defaultCitationPaneStyles: {
+        pane: React.CSSProperties;
+    };
+    defaultCitationContentCSS: (controlId: string) => string;
+};
+export default _default;

package/lib/types/components/citationpanestateful/interfaces/ICitationPaneStatefulProps.d.ts

@@ -0,0 +1,19 @@
+import { ICitationPaneProps } from "@microsoft/omnichannel-chat-components/lib/types/components/citationpane/interfaces/ICitationPaneProps";
+export interface ICitationPaneStatefulProps extends ICitationPaneProps {
+    /**
+     * id: Optional custom ID for the citation pane container
+     */
+    id?: string;
+    /**
+     * title: Optional title for the citation pane
+     */
+    title?: string;
+    /**
+     * onClose: Optional callback function called when the citation pane is closed
+     */
+    onClose?: () => void;
+    /**
+     * contentHtml: Optional HTML content to display in the citation pane
+     */
+    contentHtml?: string;
+}

package/lib/types/components/confirmationpanestateful/common/defaultProps/defaultConfirmationPaneLocalizedTexts.d.ts

@@ -1,2 +1,2 @@
-import { IConfirmationPaneLocalizedTexts } from "../../interfaces/IConfirmationPaneLocalizedText";
+import { IConfirmationPaneLocalizedTexts } from "../../interfaces/IConfirmationPaneLocalizedTexts";
 export declare const defaultConfirmationPaneLocalizedTexts: IConfirmationPaneLocalizedTexts;

package/lib/types/components/confirmationpanestateful/interfaces/IConfirmationPaneStatefulProps.d.ts

@@ -1,4 +1,4 @@
-import { IConfirmationPaneLocalizedTexts } from "./IConfirmationPaneLocalizedText";
+import { IConfirmationPaneLocalizedTexts } from "./IConfirmationPaneLocalizedTexts";
 import { IConfirmationPaneProps } from "@microsoft/omnichannel-chat-components/lib/types/components/confirmationpane/interfaces/IConfirmationPaneProps";
 export interface IConfirmationPaneStatefulProps extends IConfirmationPaneProps {
     /**

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/common/getMockChatSDKIfApplicable.d.ts

@@ -1 +1,2 @@
-export declare const getMockChatSDKIfApplicable: (chatSDK: any, type?: string) => any;
+import { IMockProps } from "../interfaces/IMockProps";
+export declare const getMockChatSDKIfApplicable: (chatSDK: any, mockProps?: IMockProps) => any;

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

@@ -4,4 +4,5 @@ import { ILiveChatWidgetAction } from "../../../contexts/common/ILiveChatWidgetA
 import { ILiveChatWidgetProps } from "../interfaces/ILiveChatWidgetProps";
 export declare const handleStartChatError: (dispatch: Dispatch<ILiveChatWidgetAction>, facadeChatSDK: FacadeChatSDK, props: ILiveChatWidgetProps | undefined, ex: any, isStartChatSuccessful: boolean) => void;
 export declare const logWidgetLoadComplete: (additionalMessage?: string) => void;
+export declare const logStartChatComplete: (additionalMessage?: string) => void;
 export declare const logWidgetLoadWithUnexpectedError: (ex: any) => void;

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

@@ -1,7 +1,9 @@
 import ChatConfig from "@microsoft/omnichannel-chat-sdk/lib/core/ChatConfig";
+import { IAppInsightsConfig } from "../../../common/telemetry/interfaces/IAppInsightsConfig";
 import { IAudioNotificationProps } from "../../footerstateful/audionotificationstateful/interfaces/IAudioNotificationProps";
 import { ICallingContainerProps } from "@microsoft/omnichannel-chat-components/lib/types/components/callingcontainer/interfaces/ICallingContainerProps";
 import { IChatButtonProps } from "@microsoft/omnichannel-chat-components/lib/types/components/chatbutton/interfaces/IChatButtonProps";
+import { ICitationPaneStatefulProps } from "../../citationpanestateful/interfaces/ICitationPaneStatefulProps";
 import { IConfirmationPaneStatefulProps } from "../../confirmationpanestateful/interfaces/IConfirmationPaneStatefulProps";
 import { IContextDataStore } from "../../../common/interfaces/IContextDataStore";
 import { IDownloadTranscriptProps } from "../../footerstateful/downloadtranscriptstateful/interfaces/IDownloadTranscriptProps";
@@ -18,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";
@@ -27,7 +30,6 @@ import { IStartChatErrorPaneProps } from "../../startchaterrorpanestateful/inter
 import { ITelemetryConfig } from "../../../common/telemetry/interfaces/ITelemetryConfig";
 import { IWebChatContainerStatefulProps } from "../../webchatcontainerstateful/interfaces/IWebChatContainerStatefulProps";
 import { OmnichannelChatSDK } from "@microsoft/omnichannel-chat-sdk";
-import { IAppInsightsConfig } from "../../../common/telemetry/interfaces/IAppInsightsConfig";
 export interface ILiveChatWidgetProps {
     audioNotificationProps?: IAudioNotificationProps;
     callingContainerProps?: ICallingContainerProps;
@@ -51,6 +53,7 @@ export interface ILiveChatWidgetProps {
     preChatSurveyPaneProps?: IPreChatSurveyPaneProps;
     proactiveChatPaneProps?: IProactiveChatPaneStatefulProps;
     reconnectChatPaneProps?: IReconnectChatPaneStatefulProps;
+    citationPaneProps?: ICitationPaneStatefulProps;
     startChatErrorPaneProps?: IStartChatErrorPaneProps;
     styleProps?: ILiveChatWidgetStyleProps;
     telemetryConfig: ITelemetryConfig;
@@ -67,4 +70,5 @@ export interface ILiveChatWidgetProps {
     mock?: IMockProps;
     featureConfigProps?: IFeatureConfigProps;
     appInsightsConfig?: IAppInsightsConfig;
+    persistentChatHistoryProps?: IPersistentChatHistoryProps;
 }

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

@@ -1,8 +1,10 @@
-declare enum LiveChatWidgetMockType {
+import { Message } from "botframework-directlinejs";
+export declare enum LiveChatWidgetMockType {
     Test = "Test",
-    Demo = "Demo"
+    Demo = "Demo",
+    Designer = "Designer"
 }
 export interface IMockProps {
     type: LiveChatWidgetMockType;
+    mockMessages?: Message[];
 }
-export {};

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/DesignerChatAdapter.d.ts

@@ -1,8 +1,10 @@
 import { Message } from "botframework-directlinejs";
-import { Observable } from "rxjs/Observable";
 import MockAdapter from "./mockadapter";
+import { Observable } from "rxjs/Observable";
 export declare class DesignerChatAdapter extends MockAdapter {
-    constructor();
+    messages?: Message[];
+    constructor(messages?: Message[]);
+    private processMessage;
     private postUserActivity;
     postActivity(activity: Message): Observable<string>;
 }

package/lib/types/components/webchatcontainerstateful/common/DesignerChatSDK.d.ts

@@ -1,7 +1,12 @@
 import { DesignerChatAdapter } from "./DesignerChatAdapter";
+import { Message } from "botframework-directlinejs";
 import { MockChatSDK } from "./mockchatsdk";
 export declare class DesignerChatSDK extends MockChatSDK {
     constructor();
+    /**
+     * Create a chat adapter for the designer. Uses this.mockMessages if set.
+     */
+    mockMessages?: Message[];
     createChatAdapter(): DesignerChatAdapter;
     localeId: string;
     /**

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/common/utils/chatAdapterUtils.d.ts

@@ -1,4 +1,4 @@
-import { Activity, Attachment, Message, User } from "botframework-directlinejs";
+import { Activity, Attachment, AttachmentLayout, CardAction, Message, User } from "botframework-directlinejs";
 import { Subscriber } from "rxjs/Subscriber";
 export declare const customerUser: User;
 export declare const botUser: User;
@@ -9,3 +9,8 @@ export declare const postAgentMessageActivity: (activityObserver: Subscriber<Act
 export declare const postSystemMessageActivity: (activityObserver: Subscriber<Activity> | undefined, text: string, delay?: number) => void;
 export declare const postBotTypingActivity: (activityObserver: Subscriber<Activity> | undefined, delay?: number) => void;
 export declare const postBotAttachmentActivity: (activityObserver: Subscriber<Activity> | undefined, attachments?: Attachment[], delay?: number) => void;
+export declare const postAgentAttachmentActivity: (activityObserver: Subscriber<Activity> | undefined, attachments?: Attachment[], delay?: number, attachmentLayout?: AttachmentLayout) => void;
+export declare const postAgentSuggestedActionsActivity: (activityObserver: Subscriber<Activity> | undefined, text: string, suggestedActions: {
+    actions: CardAction[];
+    to?: string[];
+}, delay?: number) => void;