@microsoft/omnichannel-chat-widget 1.8.7 → 2.0.0-main.5ebd4eb

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

@@ -34,6 +34,7 @@ export declare class FacadeChatSDK {
     private getAuthToken?;
     private sdkMocked;
     private disableReauthentication;
+    private pendingMidAuthUnauthenticatedState;
     isSDKMocked(): boolean;
     getChatSDK(): OmnichannelChatSDK;
     destroy(): void;
@@ -46,6 +47,34 @@ export declare class FacadeChatSDK {
     private setToken;
     private corroborateTokenIsSet;
     private tokenRing;
+    /**
+     * Sets unauthenticated state for mid-auth flow.
+     * Clears SDK internal state to prevent reconnection to previous authenticated session.
+     */
+    private setMidAuthUnauthenticatedState;
+    /** Clears authentication state in both FacadeChatSDK and underlying SDK */
+    private clearAuthState;
+    /**
+     * Migrates conversation from unauthenticated to authenticated via authenticateChat.
+     * Called after startChat() when user has a valid token but the backend conversation
+     * was started as unauthenticated.
+     */
+    private migrateConversationToAuthenticated;
+    /**
+     * Configures SDK auth state before startChat.
+     * CASE 1: Pending unauthenticated (no token) - sets deferInitialAuth=true
+     * CASE 2: Authenticated with valid token - sets SDK token and deferInitialAuth based on scenario
+     */
+    private configureMidAuthState;
+    /**
+     * CASE 1 handler: Returns true if reconnect params should be cleared (Auth -> Unauth transition)
+     */
+    private handlePendingUnauthenticatedState;
+    /**
+     * CASE 2 handler: Sets deferInitialAuth only for reconnects to unauthenticated sessions (need migration).
+     * For new chats or reconnects to authenticated sessions, SDK handles auth internally.
+     */
+    private handleAuthenticatedState;
     private validateAndExecuteCall;
     initialize(optionalParams?: InitializeOptionalParams): Promise<ChatConfig>;
     getChatReconnectContext(optionalParams?: ChatReconnectOptionalParams): Promise<ChatReconnectContext>;

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

@@ -5,7 +5,9 @@ export interface IFacadeChatSDKInput {
     chatConfig: ChatConfig;
     isAuthenticated: boolean;
     isSDKMocked: boolean;
-    getAuthToken?: (authClientFunction?: string) => Promise<string | null>;
+    getAuthToken?: (authClientFunction?: string, options?: {
+        isMidAuthEnabled: boolean;
+    }) => Promise<string | null>;
 }
 export interface PingResponse {
     result: boolean;

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

@@ -57,7 +57,9 @@ export declare enum BroadcastEvent {
     OnWidgetError = "OnWidgetError",
     FMLTrackingCompletedAck = "FMLTrackingCompletedAck",
     FMLTrackingCompleted = "FMLTrackingCompleted",
-    PersistentConversationReset = "PersistentConversationReset"
+    PersistentConversationReset = "PersistentConversationReset",
+    MidConversationAuthSucceeded = "MidConversationAuthSucceeded",// Emitted when mid-conversation auth succeeds (for reconnect support)
+    MidConversationAuthReset = "MidConversationAuthReset"
 }
 export declare enum TelemetryEvent {
     FetchPersistentChatHistoryFailed = "FetchPersistentChatHistoryFailed",
@@ -90,6 +92,10 @@ export declare enum TelemetryEvent {
     CallingSDKInitFailed = "CallingSDKInitFailed",
     CallingSDKLoadSuccess = "CallingSDKLoadSuccess",
     CallingSDKLoadFailed = "CallingSDKLoadFailed",
+    MidConversationAuthSucceeded = "MidConversationAuthSucceeded",
+    MidConversationAuthFailed = "MidConversationAuthFailed",
+    MidConversationAuthReset = "MidConversationAuthReset",
+    RecoveryEligibilityEvaluated = "RecoveryEligibilityEvaluated",
     GetConversationDetailsCallStarted = "GetConversationDetailsCallStarted",
     GetConversationDetailsCallFailed = "GetConversationDetailsCallFailed",
     EndChatSDKCallFailed = "EndChatSDKCallFailed",
@@ -179,6 +185,7 @@ export declare enum TelemetryEvent {
     QueueOverflowEvent = "QueueOverflowEvent",
     ProcessingHTMLTextMiddlewareFailed = "ProcessingHTMLTextMiddlewareFailed",
     ProcessingSanitizationMiddlewareFailed = "ProcessingSanitizationMiddlewareFailed",
+    HTMLSanitized = "HTMLSanitized",
     FormatTagsMiddlewareJSONStringifyFailed = "FormatTagsMiddlewareJSONStringifyFailed",
     AttachmentUploadValidatorMiddlewareFailed = "AttachmentUploadValidatorMiddlewareFailed",
     CitationMiddlewareFailed = "CitationMiddlewareFailed",
@@ -300,10 +307,16 @@ export declare enum TelemetryEvent {
     LCWLazyLoadNoMoreHistory = "LCWLazyLoadNoMoreHistory",
     LCWLazyLoadHistoryError = "LCWLazyLoadHistoryError",
     LCWLazyLoadDestroyed = "LCWLazyLoadDestroyed",
+    LCWLazyLoadTriggerFired = "LCWLazyLoadTriggerFired",
+    LCWLazyLoadBatchReceived = "LCWLazyLoadBatchReceived",
+    LCWLazyLoadInitialLoadComplete = "LCWLazyLoadInitialLoadComplete",
+    LCWLazyLoadScrollAnchorApplied = "LCWLazyLoadScrollAnchorApplied",
     SecureEventBusUnauthorizedDispatch = "SecureEventBusUnauthorizedDispatch",
     SecureEventBusListenerError = "SecureEventBusListenerError",
     SecureEventBusDispatchError = "SecureEventBusDispatchError",
-    StartChatComplete = "StartChatComplete"
+    StartChatComplete = "StartChatComplete",
+    AgentJoinedConversation = "AgentJoinedConversation",
+    BrowserTabHidden = "BrowserTabHidden"
 }
 export interface TelemetryInput {
     scenarioType: ScenarioType;

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

@@ -0,0 +1,24 @@
+/**
+ * Redacts the values of Azure Shared Access Signature (SAS) query parameters in any
+ * URL embedded in a telemetry payload, so customer-supplied SAS URLs (e.g. blob asset
+ * URLs in widget customization props) cannot leak credentials through Aria/AppInsights.
+ *
+ * Trigger: any URL whose query string contains `sig=`. When detected, every well-known
+ * SAS parameter value in that query is replaced with `[REDACTED]`. Other URLs and other
+ * substrings of the payload pass through unchanged.
+ *
+ * Coverage of SAS parameter names:
+ *  - Service/Blob SAS:        sig, sv, se, st, sp, spr, sr, sip
+ *  - Account SAS:             ss, srt
+ *  - User-delegation key SAS: skoid, sktid, skt, ske, sks, skv, saoid, suoid, sce, sdd
+ *  - Response header overrides: rscc, rscd, rsce, rscl, rsct
+ *
+ * Reference: https://learn.microsoft.com/en-us/rest/api/storageservices/create-service-sas
+ */
+/**
+ * Deep-walk a value and redact SAS credentials in any string it contains.
+ * Returns a new object/array (originals are not mutated); non-string leaves are
+ * passed through. Tree-shaped, JSON-like values only — not designed for class
+ * instances, prototype-bound objects, or cyclic graphs.
+ */
+export declare const sanitizeSasInPayload: <T>(value: T) => T;

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

@@ -4,9 +4,11 @@ import { ITimer } from "./interfaces/ITimer";
 export declare const setTabIndices: (elements: HTMLElement[] | null, tabIndexMap: Map<string, number>, shouldBeFocusable: boolean) => void;
 export declare const findParentFocusableElementsWithoutChildContainer: (elementId: string) => HTMLElement[] | null;
 export declare const findAllFocusableElement: (parent: string | HTMLElement) => any[] | null;
-export declare const preventFocusToMoveOutOfElement: (elementId: string) => void;
+export declare const preventFocusToMoveOutOfElement: (elementId: string) => (() => void);
+export declare const setAriaHiddenForSiblings: (elementId: string, shouldHide: boolean, stateMap: Map<Element, string | null>) => void;
 export declare const setFocusOnSendBox: () => void;
 export declare const setFocusOnElement: (selector: string | HTMLElement) => void;
+export declare const announceMessageImmediately: (message: string) => void;
 export declare const escapeHtml: (inputString: string) => string;
 export declare const getIconText: (text: string) => string;
 export declare const getLocaleDirection: (localeLCID: string) => string;

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

@@ -2,6 +2,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",
-    HISTORY_LOAD_ERROR = "CHAT_WIDGET/HISTORY_LOAD_ERROR"
+    HISTORY_LOAD_ERROR = "CHAT_WIDGET/HISTORY_LOAD_ERROR",
+    HISTORY_BATCH_LOADED = "CHAT_WIDGET/HISTORY_BATCH_LOADED"
 }
 export default ChatWidgetEvents;

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

@@ -1,7 +1,14 @@
 import ChatConfig from "@microsoft/omnichannel-chat-sdk/lib/core/ChatConfig";
 import { OmnichannelChatSDK } from "@microsoft/omnichannel-chat-sdk";
+/**
+ * Check if mid-auth is enabled based on chatConfig.
+ * Mid-auth flag lives under LiveWSAndLiveChatEngJoin.msdyn_authenticatedsigninoptional.
+ */
+declare const isMidAuthEnabled: (chatConfig: ChatConfig | undefined) => boolean;
 declare const getAuthClientFunction: (chatConfig: ChatConfig | undefined) => string | undefined;
-declare const handleAuthentication: (chatSDK: OmnichannelChatSDK, chatConfig: ChatConfig | undefined, getAuthToken: ((authClientFunction?: string) => Promise<string | null>) | undefined) => Promise<{
+declare const handleAuthentication: (chatSDK: OmnichannelChatSDK, chatConfig: ChatConfig | undefined, getAuthToken: ((authClientFunction?: string, options?: {
+    isMidAuthEnabled: boolean;
+}) => Promise<string | null>) | undefined) => Promise<{
     result: boolean;
     token: string | null;
     error?: undefined;
@@ -15,4 +22,4 @@ declare const handleAuthentication: (chatSDK: OmnichannelChatSDK, chatConfig: Ch
     };
 }>;
 declare const removeAuthTokenProvider: (chatSDK: any) => void;
-export { getAuthClientFunction, handleAuthentication, removeAuthTokenProvider };
+export { getAuthClientFunction, handleAuthentication, removeAuthTokenProvider, isMidAuthEnabled };

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

@@ -0,0 +1,17 @@
+import { ILiveChatWidgetContext } from "../../../contexts/common/ILiveChatWidgetContext";
+export declare enum RecoveryEligibilityReason {
+    ReconnectIdPresent = "ReconnectIdPresent",
+    ActiveContextPresent = "ActiveContextPresent",
+    MissingContext = "MissingContext",
+    CachedContextNonActive = "CachedContextNonActive"
+}
+export interface RecoveryEligibilityTelemetryProperties {
+    conversationState: string;
+    hasReconnectId: boolean;
+    hasLiveChatContext: boolean;
+    hasRequestId: boolean;
+    eligible: boolean;
+    reason: RecoveryEligibilityReason;
+}
+export declare const getRecoveryEligibilityTelemetryProperties: (state: ILiveChatWidgetContext, eligible: boolean) => RecoveryEligibilityTelemetryProperties;
+export declare const logRecoveryEligibilityTelemetry: (state: ILiveChatWidgetContext, eligible: boolean) => void;

package/lib/types/components/prechatsurveypanestateful/PreChatSurveyPaneStateful.d.ts

@@ -1,4 +1,10 @@
 import React from "react";
 import { IPreChatSurveyPaneStatefulParams } from "./interfaces/IPreChatSurveyPaneStatefulParams";
+import MarkdownIt from "markdown-it";
+declare global {
+    interface Window {
+        markdownit: typeof MarkdownIt;
+    }
+}
 export declare const PreChatSurveyPaneStateful: (props: IPreChatSurveyPaneStatefulParams) => React.JSX.Element;
 export default PreChatSurveyPaneStateful;

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

@@ -4,7 +4,7 @@ export declare const customerUser: User;
 export declare const botUser: User;
 export declare const agentUser: User;
 export declare const postEchoActivity: (activityObserver: Subscriber<Activity> | undefined, activity: Message, user: User, delay?: number) => void;
-export declare const postBotMessageActivity: (activityObserver: Subscriber<Activity> | undefined, text: string, tags?: string, delay?: number) => void;
+export declare const postBotMessageActivity: (activityObserver: Subscriber<Activity> | undefined, text: string, tags?: string, delay?: number, fromOverride?: Partial<User>) => void;
 export declare const postAgentMessageActivity: (activityObserver: Subscriber<Activity> | undefined, text: string, tags?: string, delay?: number) => void;
 export declare const postSystemMessageActivity: (activityObserver: Subscriber<Activity> | undefined, text: string, delay?: number) => void;
 export declare const postBotTypingActivity: (activityObserver: Subscriber<Activity> | undefined, delay?: number) => void;

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

@@ -0,0 +1 @@
+export declare const patchCitationAnchorsForA11y: (root: ParentNode) => void;

package/lib/types/components/webchatcontainerstateful/interfaces/IAdaptiveCardStyles.d.ts

@@ -7,4 +7,5 @@ export interface IAdaptiveCardStyles {
     choiceInputPadding?: string;
     buttonFlexWrap?: string;
     buttonGap?: string;
+    inputFontSize?: string;
 }

package/lib/types/components/webchatcontainerstateful/interfaces/IWebChatAction.d.ts

@@ -1,4 +1,19 @@
 export interface IWebChatAction {
     type: string;
-    payload: any;
+    payload?: any;
 }
+/**
+ * Type guard narrowing the `unknown` action received by a Redux 5 store middleware
+ * down to Web Chat's IWebChatAction shape, so middlewares can safely access `type`/`payload`.
+ */
+export declare const isWebChatAction: (action: unknown) => action is IWebChatAction;
+/**
+ * Structural middleware type matching the unknown-action contract expected by
+ * botframework-webchat's `createStore` without exposing Redux as a public dependency.
+ */
+type WebChatDispatch = (action: unknown) => unknown;
+export type WebChatStoreMiddleware = (api: {
+    dispatch: WebChatDispatch;
+    getState: () => unknown;
+}) => (next: WebChatDispatch) => WebChatDispatch;
+export {};

package/lib/types/components/webchatcontainerstateful/interfaces/IWebChatContainerStatefulProps.d.ts

@@ -25,4 +25,11 @@ export interface IWebChatContainerStatefulProps {
     adaptiveCardStyles?: IAdaptiveCardStyles;
     sendBoxTextBox?: ISendBox;
     webChatHistoryMobileAccessibilityLabel?: string;
+    /**
+     * Accessible name applied to WebChats notification toaster region
+     * (`role="log"`). When omitted, defaults to "Chat notifications" so
+     * screen readers don't announce the empty live region as "blank"
+     * (internal tracking).
+     */
+    webChatNotificationRegionAccessibilityLabel?: string;
 }

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

@@ -52,7 +52,9 @@ declare class LazyLoadHandler {
     static initialized: boolean;
     static paused: boolean;
     static observer: IntersectionObserver | null;
-    private static scrollState;
+    static preLoadScrollHeight: number;
+    private static preLoadScrollTop;
+    static initialLoadComplete: boolean;
     static pendingScrollAction: boolean;
     private static retryTimeouts;
     static resetPending: boolean;
@@ -151,40 +153,21 @@ declare class LazyLoadHandler {
      * It coordinates the entire lazy loading process:
      *
      * 1. Sets flags to prevent concurrent operations
-     * 2. Dispatches event to fetch more chat history
-     * 3. Waits for content to load
-     * 4. Executes scroll adjustment to maintain user position
+     * 2. Captures scroll state BEFORE content loads (for height-delta anchoring)
+     * 3. Dispatches event to fetch more chat history
      *
-     * Timing: Uses 300ms delay to allow content loading before scroll adjustment
+     * Scroll anchoring is triggered by HISTORY_BATCH_LOADED event (not a blind timeout).
      */
     private static handleLazyLoadTrigger;
     /**
-     * Executes reliable scroll with validation and retry logic
+     * Applies height-delta scroll anchoring after new history content is prepended.
      *
-     * This method implements a robust scroll system that:
-     * 1. Finds and validates the scroll container
-     * 2. Calculates target scroll position (current + 35px)
-     * 3. Sets up scroll state for tracking and retries
-     * 4. Initiates the scroll attempt process
-     *
-     * If no suitable container is found, schedules a retry.
+     * When content is added above the viewport, the browser keeps scrollTop constant
+     * but the content shifts down — making the viewport drift upward.
+     * Fix: scrollTop = savedScrollTop + (newScrollHeight - savedScrollHeight)
+     * This keeps the user looking at the same content they had before.
      */
-    private static executeReliableScroll;
-    /**
-     * Attempts to perform scroll with verification and retry logic
-     *
-     * This method implements a sophisticated scroll system:
-     *
-     * 1. Uses requestAnimationFrame for smooth execution
-     * 2. Performs the scroll operation
-     * 3. Verifies scroll actually occurred (5px tolerance)
-     * 4. Retries with exponential backoff if failed
-     * 5. Continues operation after max attempts
-     *
-     * The two-frame approach ensures scroll is applied and then verified
-     * after the browser has had time to process the scroll change.
-     */
-    private static attemptScroll;
+    static applyScrollAnchor(): void;
     /**
      * Finishes scroll action and prepares for next cycle
      *
@@ -192,21 +175,14 @@ declare class LazyLoadHandler {
      * Uses delays to allow content stabilization before re-enabling
      * the intersection observer for the next lazy load cycle.
      */
-    private static finishScrollAction;
-    /**
-     * Schedules retry for failed scroll operations
-     *
-     * Used when scroll container is not available or scrollable.
-     * Provides a longer delay to allow container to become ready.
-     */
-    private static scheduleScrollRetry;
+    static finishScrollAction(): void;
     /**
      * Schedules observer reset for next lazy load cycle
      *
      * After a lazy load operation completes, the observer needs to be reset
      * to detect the next time the user scrolls to the top.
      */
-    private static scheduleReset;
+    static scheduleReset(): void;
     /**
      * Finds the appropriate scroll container using multiple strategies
      *

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

@@ -9,3 +9,5 @@
 import { ILiveChatWidgetLocalizedTexts } from "../../../../../contexts/common/ILiveChatWidgetLocalizedTexts";
 import React from "react";
 export declare const createActivityMiddleware: (renderMarkdown: (text: string) => string, systemMessageStyleProps?: React.CSSProperties, userMessageStyleProps?: React.CSSProperties, localizedTexts?: ILiveChatWidgetLocalizedTexts) => () => (next: any) => (...args: any) => any;
+/** Clear module-level caches. Call on conversation end / chat close. */
+export declare const resetActivityMiddlewareCache: () => void;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/attachments/AdaptiveCardAccessibilityWrapper.d.ts

@@ -0,0 +1,18 @@
+import React from "react";
+/******
+ * AdaptiveCardAccessibilityWrapper
+ *
+ * The `adaptivecards` renderer does not set `aria-setsize` or `aria-posinset`
+ * on radio buttons rendered by Input.ChoiceSet (style: "expanded"). Without
+ * these attributes, screen readers (TalkBack, VoiceOver, NVDA) cannot announce
+ * the correct option count (e.g. "1 of 2") and may say "1 of 1" for every item.
+ *
+ * This wrapper observes the rendered card via MutationObserver and patches each
+ * radio group with the correct ARIA attributes after the card finishes rendering.
+ ******/
+declare const AdaptiveCardAccessibilityWrapper: React.FC<{
+    id?: string;
+    style?: any;
+    children: React.ReactNode;
+}>;
+export default AdaptiveCardAccessibilityWrapper;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/defaultStyles/defaultSystemMessageStyles.d.ts

@@ -8,4 +8,7 @@ export declare const defaultSystemMessageStyles: {
     fontFamily: string;
     lineHeight: string;
     padding: string;
+    WebkitTextUnderlinePosition: "under";
+    textUnderlinePosition: "under";
+    fontVariantNumeric: "lining-nums";
 };

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

@@ -1,4 +1,2 @@
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-export declare const createMessageSequenceIdOverrideMiddleware: ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+export declare const createMessageSequenceIdOverrideMiddleware: WebChatStoreMiddleware;

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

@@ -1,4 +1,2 @@
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-export declare const createMessageTimeStampMiddleware: ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+export declare const createMessageTimeStampMiddleware: WebChatStoreMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/attachmentProcessingMiddleware.d.ts

@@ -3,8 +3,6 @@
  *
  * Handles attachment sending.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const attachmentProcessingMiddleware: ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => Promise<any>;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const attachmentProcessingMiddleware: WebChatStoreMiddleware;
 export default attachmentProcessingMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/attachmentSentAnnouncementMiddleware.d.ts

@@ -0,0 +1,10 @@
+/******
+ * AttachmentSentAnnouncementMiddleware
+ *
+ * When a file attachment is successfully sent, announces the result to
+ * screen readers via an aria-live region so that assistive technology
+ * users receive immediate feedback.
+ ******/
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const attachmentSentAnnouncementMiddleware: WebChatStoreMiddleware;
+export default attachmentSentAnnouncementMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/attachmentUploadValidatorMiddleware.d.ts

@@ -4,8 +4,6 @@
  * Checks if the attachment being uploaded satisfies Omnichannel's requirement on file extensions and file size.
  ******/
 import { ILiveChatWidgetLocalizedTexts } from "../../../../../contexts/common/ILiveChatWidgetLocalizedTexts";
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const createAttachmentUploadValidatorMiddleware: (allowedFileExtensions: string, maxFileSizeSupportedByDynamics: string, localizedTexts: ILiveChatWidgetLocalizedTexts) => ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const createAttachmentUploadValidatorMiddleware: (allowedFileExtensions: string, maxFileSizeSupportedByDynamics: string, localizedTexts: ILiveChatWidgetLocalizedTexts) => WebChatStoreMiddleware;
 export default createAttachmentUploadValidatorMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/callActionMiddleware.d.ts

@@ -3,6 +3,6 @@
  *
  * Intercepts custom call actions and handles tel: URL navigation
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const createCallActionMiddleware: () => () => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const createCallActionMiddleware: () => WebChatStoreMiddleware;
 export default createCallActionMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/channelDataMiddleware.d.ts

@@ -3,8 +3,6 @@
  *
  * Adds necessary tags if not present so that the rendering middlewares can process them later.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const channelDataMiddleware: (addConversationalSurveyTagsCallback: any) => ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const channelDataMiddleware: (addConversationalSurveyTagsCallback: any) => WebChatStoreMiddleware;
 export default channelDataMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/citationsMiddleware.d.ts

@@ -1,4 +1,4 @@
 import { ILiveChatWidgetAction } from "../../../../../contexts/common/ILiveChatWidgetAction";
 import { ILiveChatWidgetContext } from "../../../../../contexts/common/ILiveChatWidgetContext";
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-export declare const createCitationsMiddleware: (state: ILiveChatWidgetContext, dispatch: (action: ILiveChatWidgetAction) => void) => () => (next: (action: IWebChatAction) => void) => (action: IWebChatAction) => void;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+export declare const createCitationsMiddleware: (state: ILiveChatWidgetContext, dispatch: (action: ILiveChatWidgetAction) => void) => WebChatStoreMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/conversationEndMiddleware.d.ts

@@ -4,8 +4,6 @@
  * This middleware is invoked when the conversation is ended by the agent/bot.
  * The callback is then invoked to hide the send box (by default).
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const createConversationEndMiddleware: (conversationEndCallback: any, startConversationalSurveyCallback: any, endConversationalSurveyCallback: any) => ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const createConversationEndMiddleware: (conversationEndCallback: any, startConversationalSurveyCallback: any, endConversationalSurveyCallback: any) => WebChatStoreMiddleware;
 export default createConversationEndMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/customEventMiddleware.d.ts

@@ -4,7 +4,7 @@
  * This middleware is invoked when a custom event is received.
  * The callback is then invoked to handle the custom event.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
 import { BroadcastService } from "@microsoft/omnichannel-chat-components";
 export declare const isValidCustomEvent: (activity: {
     channelData?: {
@@ -18,5 +18,5 @@ export declare const isValidCustomEvent: (activity: {
         role: string;
     };
 }) => boolean;
-declare const createCustomEventMiddleware: (broadcastservice: typeof BroadcastService) => () => (next: (action: IWebChatAction) => void) => (action: IWebChatAction) => void;
+declare const createCustomEventMiddleware: (broadcastservice: typeof BroadcastService) => WebChatStoreMiddleware;
 export default createCustomEventMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/dataMaskingMiddleware.d.ts

@@ -4,8 +4,6 @@
  * Applies data masking rules that Omnichannel Admin has configured.
  ******/
 import { IDataMaskingInfo } from "../../../interfaces/IDataMaskingInfo";
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const createDataMaskingMiddleware: (dataMaskingInfo: IDataMaskingInfo) => ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const createDataMaskingMiddleware: (dataMaskingInfo: IDataMaskingInfo) => WebChatStoreMiddleware;
 export default createDataMaskingMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/gifUploadMiddleware.d.ts

@@ -3,8 +3,6 @@
  *
  * Ensures that GIF are properly uploaded.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const gifUploadMiddleware: ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const gifUploadMiddleware: WebChatStoreMiddleware;
 export default gifUploadMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/htmlPlayerMiddleware.d.ts

@@ -3,8 +3,6 @@
  *
  * Ensures that video/audio attachment are properly rendered.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const htmlPlayerMiddleware: ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const htmlPlayerMiddleware: WebChatStoreMiddleware;
 export default htmlPlayerMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/htmlTextMiddleware.d.ts

@@ -3,8 +3,6 @@
  *
  * Ensures that links within messages are processed so that the caller website cannot be traced.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const htmlTextMiddleware: (honorsTargetInHTMLLinks?: boolean) => ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const htmlTextMiddleware: (honorsTargetInHTMLLinks?: boolean) => WebChatStoreMiddleware;
 export default htmlTextMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/localizedStringsBotInitialsMiddleware.d.ts

@@ -1,5 +1,3 @@
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-export declare const localizedStringsBotInitialsMiddleware: (onInitialsChange?: (initials: string) => void) => ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+export declare const localizedStringsBotInitialsMiddleware: (onInitialsChange?: (initials: string) => void) => WebChatStoreMiddleware;
 export declare const getOverriddenLocalizedStrings: (existingOverrides?: any) => (strings: any) => any;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/maxMessageSizeValidator.d.ts

@@ -4,8 +4,6 @@
  * Enforces a max character limit that the sender can send to comply to Omnichannel chat services' limitation.
  ******/
 import { ILiveChatWidgetLocalizedTexts } from "../../../../../contexts/common/ILiveChatWidgetLocalizedTexts";
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const createMaxMessageSizeValidator: (localizedTexts: ILiveChatWidgetLocalizedTexts) => ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const createMaxMessageSizeValidator: (localizedTexts: ILiveChatWidgetLocalizedTexts) => WebChatStoreMiddleware;
 export default createMaxMessageSizeValidator;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/preProcessingMiddleware.d.ts

@@ -3,8 +3,6 @@
  *
  * Adds necessary fields for the activity for the other middlewares to function as expected.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const preProcessingMiddleware: ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => Promise<any>;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const preProcessingMiddleware: WebChatStoreMiddleware;
 export default preProcessingMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/queueOverflowHandlerMiddleware.d.ts

@@ -1,5 +1,5 @@
 import { Dispatch } from "react";
 import { ILiveChatWidgetAction } from "../../../../../contexts/common/ILiveChatWidgetAction";
 import { ILiveChatWidgetContext } from "../../../../../contexts/common/ILiveChatWidgetContext";
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-export declare const createQueueOverflowMiddleware: (state: ILiveChatWidgetContext, dispatch: Dispatch<ILiveChatWidgetAction>) => () => (next: (action: IWebChatAction) => void) => (action: IWebChatAction) => void;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+export declare const createQueueOverflowMiddleware: (state: ILiveChatWidgetContext, dispatch: Dispatch<ILiveChatWidgetAction>) => WebChatStoreMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/sanitizationMiddleware.d.ts

@@ -3,8 +3,6 @@
  *
  * Sanitizes the text.
  ******/
-import { IWebChatAction } from "../../../interfaces/IWebChatAction";
-declare const sanitizationMiddleware: ({ dispatch }: {
-    dispatch: any;
-}) => (next: any) => (action: IWebChatAction) => any;
+import { WebChatStoreMiddleware } from "../../../interfaces/IWebChatAction";
+declare const sanitizationMiddleware: WebChatStoreMiddleware;
 export default sanitizationMiddleware;

package/lib/types/components/webchatcontainerstateful/webchatcontroller/notification/NotificationHandler.d.ts

@@ -1,6 +1,13 @@
 import { NotificationLevel } from "../enums/NotificationLevel";
 export declare class NotificationHandler {
+    private static clearTimeoutId;
     private static notify;
+    /**
+     * Announces a message immediately to screen readers via an aria-live="assertive" region.
+     * This ensures notifications interrupt the current screen reader output
+     * instead of waiting for it to finish reading other content.
+     */
+    private static announceToScreenReader;
     static dismissNotification(id: string): void;
     static notifyError(id: string, message: string): void;
     static notifyWarning(id: string, message: string): void;