@sendbird/ai-agent-messenger-react 1.37.0 → 1.38.0

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import { ComponentType } from 'react';
 import { Context } from 'react';
 import type { Conversation as Conversation_2 } from '@sendbird/chat/aiAgent';
 import type { ConversationStatus } from '@sendbird/chat/aiAgent';
+import type { CPAAuthorizationErrorCode } from '@sendbird/chat/aiAgent';
 import { CSSProperties } from 'react';
 import type { DeskChannelFilter } from '@sendbird/chat/aiAgent';
 import type { FileMessage } from '@sendbird/chat/message';
@@ -226,6 +227,11 @@ countryCode?: string;
 context?: Record<string, string>;
 /**
 * @public
+* @description Customer-provided authorization codes to submit after the messenger session connects.
+* */
+cpaAuthorizationCodes?: CPAAuthorizationCode[];
+/**
+* @public
 * @description AIAgent global default query parameters.
 * */
 queryParams?: AIAgentQueryParams;
@@ -579,6 +585,7 @@ declare interface AIAgentContextValue {
     language: string;
     countryCode?: string;
     context?: Record<string, string>;
+    cpaAuthorizationCodes?: CPAAuthorizationCode[];
 
     logger: Loggable;
     dispatcher: Dispatcher;
@@ -623,11 +630,7 @@ declare interface AIAgentConversationContextValue {
     };
 
     state: {
-        streamAnimation: {
-            isAnimating: boolean;
-            start: (id: string | number) => void;
-            stop: (id: string | number) => void;
-        };
+        streamAnimation: StreamAnimation;
         input: InputState;
     };
 
@@ -745,6 +748,8 @@ declare interface AIAgentInterface {
     countryCode?: string;
     /** The context object for AI Agent */
     context?: Record<string, string>;
+    /** Customer-provided authorization codes to submit after authentication connects */
+    cpaAuthorizationCodes?: CPAAuthorizationCode[];
 
     /** @internal Agent version for conversation initialization */
     agentVersion?: number;
@@ -778,6 +783,8 @@ declare interface AIAgentInterface {
     getContextObject: (channelUrl: string) => Promise<ContextObject>;
     /** Requests a nudge message to be shown above the launcher. Fire-and-forget: the result is only broadcast to onNudgeMessageReceived subscribers */
     requestNudgeMessage: (params: RequestNudgeMessageParams) => Promise<void>;
+    /** Submits customer-provided authorization codes for the current user */
+    submitCPAAuthorizationCodes: (authCodes: CPAAuthorizationCode[]) => Promise<SubmitCPAAuthorizationCodesResponse>;
     /** Clears memories saved for the current user */
     clearUserMemories: (params?: ClearUserMemoriesParams) => Promise<void>;
 
@@ -836,6 +843,7 @@ declare interface AIAgentMessengerSessionContextValue {
     createConversation: (params: ConversationCreateParams) => Promise<string>;
     searchConversation: (params: SearchConversationParams) => Promise<string[]>;
     refreshActiveChannel: () => Promise<string>;
+    submitCPAAuthorizationCodes: (authCodes: CPAAuthorizationCode[]) => Promise<SubmitCPAAuthorizationCodesResponse>;
 
     authenticate: () => Promise<MessengerSettingsResponse>;
     deauthenticate: () => Promise<void>;
@@ -848,6 +856,7 @@ declare interface AIAgentMessengerSessionRef {
     chatSDK: AIAgentContextValue['chatSDK'];
     authenticate: () => Promise<MessengerSettingsResponse>;
     deauthenticate: () => Promise<void>;
+    submitCPAAuthorizationCodes: (authCodes: CPAAuthorizationCode[]) => Promise<SubmitCPAAuthorizationCodesResponse>;
     getContextObject: () => Promise<ContextObject>;
     updateContext: {
         /** Updates the context of the active conversation initialized at session start. */
@@ -963,6 +972,11 @@ export declare type AIAgentProps = PropsWithChildren<{
      * @description Context object for the AI agent client. This is injected when the messenger is first loaded and can provide additional context that may influence how the AI responds to user conversations.
      * */
     context?: Record<string, string>;
+    /**
+     * @public
+     * @description Customer-provided authorization codes to submit after the messenger session connects.
+     * */
+    cpaAuthorizationCodes?: CPAAuthorizationCode[];
     /**
      * @public
      * @description AIAgent global default query parameters.
@@ -1469,6 +1483,8 @@ declare type ChatSDKConversation = Conversation_2;
 
 declare type ChatSDKConversationStatus = ConversationStatus;
 
+declare type ChatSDKCPAAuthorizationErrorCode = CPAAuthorizationErrorCode;
+
 declare type ChatSDKDeskChannelFilter = DeskChannelFilter;
 
 declare type ChatSDKFileMessage = FileMessage;
@@ -2794,6 +2810,19 @@ declare interface ConversationScrollContextValue {
 
 declare type ConversationScrollMode = 'auto' | 'fixed';
 
+declare interface CPAAuthorizationCode {
+    key: string;
+    code: string;
+    redirectURI?: string;
+}
+
+declare interface CPAAuthorizationResult {
+    key: string;
+    status: 'ok' | 'error';
+    errorCode?: ChatSDKCPAAuthorizationErrorCode;
+    errorMessage?: string;
+}
+
 declare type CSATSubmitParams = {
     csatType: string;
     csat?: number;
@@ -3035,6 +3064,7 @@ export declare interface ExtendedMessagePayload {
 declare type ExternalAuthTokenExpiredData = {
     channelUrl: string;
     aiAgentId: string;
+    cpaKey: string;
 };
 
 export declare interface FeedbackInfo {
@@ -3185,6 +3215,12 @@ BaseMessageProps<{
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    /**
+     * Fired (layout effect) when this row starts/stops holding its text — the stream animation is
+     * running but nothing is visible yet. The row renders nothing while holding, so the list draws its
+     * single typing row on the row's behalf and keeps the held row out of the accessibility tree.
+     */
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
 
     // fallbacks
     messageTemplateErrorFallback?: ReactNode;
@@ -3275,6 +3311,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3353,6 +3390,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3431,6 +3469,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3505,6 +3544,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3583,6 +3623,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3661,6 +3702,7 @@ export declare const IncomingMessageLayout: {
                 onStreamAnimationStart?: () => void;
                 onStreamAnimationProgress?: () => void;
                 onStreamAnimationComplete?: () => void;
+                onStreamAnimationHoldChange?: (holding: boolean) => void;
                 messageTemplateErrorFallback?: ReactNode;
                 messageTemplateLoadingFallback?: ReactNode;
             } & {
@@ -3767,6 +3809,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -3845,6 +3888,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -3923,6 +3967,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -3997,6 +4042,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4075,6 +4121,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4153,6 +4200,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4254,6 +4302,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4332,6 +4381,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4410,6 +4460,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4484,6 +4535,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4562,6 +4614,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4640,6 +4693,7 @@ export declare const IncomingMessageLayout: {
     onStreamAnimationStart?: () => void;
     onStreamAnimationProgress?: () => void;
     onStreamAnimationComplete?: () => void;
+    onStreamAnimationHoldChange?: (holding: boolean) => void;
     messageTemplateErrorFallback?: ReactNode;
     messageTemplateLoadingFallback?: ReactNode;
     } & {
@@ -4764,6 +4818,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -4842,6 +4897,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -4920,6 +4976,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -4996,6 +5053,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -5074,6 +5132,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -5152,6 +5211,7 @@ export declare const IncomingMessageLayout: {
             onStreamAnimationStart?: () => void;
             onStreamAnimationProgress?: () => void;
             onStreamAnimationComplete?: () => void;
+            onStreamAnimationHoldChange?: (holding: boolean) => void;
             messageTemplateErrorFallback?: ReactNode;
             messageTemplateLoadingFallback?: ReactNode;
         } & {
@@ -5633,6 +5693,9 @@ declare class MessagePendingStuckStatsTracker extends MultiStatsTrackerBase<Mess
     }
 }
 
+/** How a message's sender is drawn: the typing row's user and every message row's sender share this. */
+declare type MessageSenderInfo = { userId: string; nickname: string; profileUrl?: string };
+
 declare interface MessageTemplateCache {
     set(key: string, value: string): void;
     get(key: string): string | null;
@@ -6636,6 +6699,25 @@ declare enum StewardTaskStatus {
     CANCELED = 'CANCELED',
 }
 
+declare type StreamAnimation = {
+    isAnimating: boolean;
+    start: (id: string | number) => void;
+    stop: (id: string | number) => void;
+    isHolding: (id: string | number) => boolean;
+    /**
+     * Set while a row holds its streamed text. The list draws a single typing row, so it falls back to
+     * this when nobody is typing — a live typing signal always wins.
+     *
+     * Never carries a thinking message, deliberately: a row enters the hold only after its reply started
+     * streaming, so the agent's thinking phase is over by then — the frame is held back by our own start
+     * gate, not by the agent still thinking. Relaying the last thinking text here would report a state it
+     * has already left, so the typing row falls back to dots for this window.
+     */
+    heldTypingInfo?: TypingRowInfo;
+    holdStart: (id: string | number, info: TypingRowInfo) => void;
+    holdStop: (id: string | number) => void;
+};
+
 declare type StreamMeasure = {
     channelUrl?: string;
     deliveryTimer: TimeoutId | null;
@@ -7166,6 +7248,10 @@ export declare type StringSet = {
     CHANNEL_FROZEN: string;
 };
 
+declare interface SubmitCPAAuthorizationCodesResponse {
+    cpaAuthorizations: CPAAuthorizationResult[];
+}
+
 declare type SystemBaseMessageProps<T> = T & BaseMessageProps<{}>;
 
 declare type SystemCSATMessageProps = SystemMessageProps & {
@@ -7513,6 +7599,16 @@ declare type TypingMeasure = {
     userMessageId?: number;
 };
 
+/**
+ * What the list's single typing row renders, whoever it is drawn for. `user.userId` identifies the row
+ * it stands in for, which is how the typing bridge tells the awaited reply from anyone else's.
+ */
+declare type TypingRowInfo = {
+    user: MessageSenderInfo;
+    isBot: boolean;
+    thinkingMessage?: string;
+};
+
 declare type TypingTurnEntry = {
     requestId: string;
     record: StatsRecord<TypingIndicatorAbsentTimeoutStats, TypingMeasure>;