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

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,39 @@ export declare enum TelemetryEvent {
     UXLCWChatButtonLoadingStart = "UXLCWChatButtonLoadingStart",
     UXLCWChatButtonLoadingCompleted = "UXLCWChatButtonLoadingCompleted",
     UXConfirmationPaneStart = "UXConfirmationPaneStart",
+    UXCitationPaneStart = "UXCitationPaneStart",
     UXConfirmationPaneCompleted = "UXConfirmationPaneCompleted",
+    UXCitationPaneCompleted = "UXCitationPaneCompleted",
     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/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/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;

package/lib/types/components/webchatcontainerstateful/common/utils/fontUtils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utility functions for font handling and emoji support
+ */
+/**
+ * Creates a font family optimized for iOS emoji support
+ * Uses system-ui as the primary font for better emoji rendering on iOS
+ * @param primaryFont - The base font family string (optional, used as fallback)
+ * @returns Font family string optimized for iOS emoji support
+ */
+export declare const createIOSOptimizedEmojiFont: (primaryFont?: string) => string;

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

@@ -0,0 +1,12 @@
+export interface ICitation {
+    id: string;
+    text?: string;
+    title?: string;
+    type?: string;
+    position?: number;
+    entityType?: string;
+    entityContext?: string;
+    url?: string;
+    searchSourceId?: string;
+    chunkId?: string;
+}

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;