@sendbird/ai-agent-messenger-react-native 1.7.0 → 1.8.0

package/dist/index.d.ts

@@ -22,6 +22,8 @@ import { JSX } from 'react/jsx-runtime';
 import { LayoutChangeEvent } from 'react-native';
 import { LogLevel } from '@sendbird/chat';
 import { MMKV } from 'react-native-mmkv';
+import { MultipleFilesMessage } from '@sendbird/chat/message';
+import { MultipleFilesMessageCreateParams } from '@sendbird/chat/message';
 import { NativeScrollEvent } from 'react-native';
 import { NativeSyntheticEvent } from 'react-native';
 import { PropsWithChildren } from 'react';
@@ -229,13 +231,13 @@ declare interface AIAgentConfig {
                 photoEnabled?: boolean;
             };
             /**
-             * (React-Native only) Whether to enable the gallery option in the attachment menu.
+             * Whether to enable the gallery/photo option in the attachment menu.
              * */
             gallery?: {
                 photoEnabled?: boolean;
             };
             /**
-             * (React-Native only) Whether to enable the file option in the attachment menu.
+             * Whether to enable the file option in the attachment menu.
              * */
             fileEnabled?: boolean;
         };
@@ -294,8 +296,11 @@ declare interface AIAgentConversationContextValue {
         loadNext: () => Promise<void>;
         sendUserMessage: (params: UserMessageCreateParams) => Promise<UserMessage>;
         sendFileMessage: (params: FileMessageCreateParams) => Promise<FileMessage>;
-        deleteMessage: (message: UserMessage | FileMessage) => Promise<void>;
-        resendMessage: (message: UserMessage | FileMessage) => Promise<UserMessage | FileMessage>;
+        sendMultipleFilesMessage: (params: MultipleFilesMessageCreateParams) => Promise<MultipleFilesMessage>;
+        deleteMessage: (message: UserMessage | FileMessage | MultipleFilesMessage) => Promise<void>;
+        resendMessage: (
+        message: UserMessage | FileMessage | MultipleFilesMessage,
+        ) => Promise<UserMessage | FileMessage | MultipleFilesMessage>;
         resetNewMessages: () => void;
     };
 
@@ -376,7 +381,6 @@ declare interface AIAgentMessengerSessionContextValue {
     userSession: null | UserSession;
     aiAgentInfo: null | AIAgentInfo;
     launcherInfo: null | LauncherInfo;
-    presentMethod: PresentMethod;
 
     connectionError?: Error;
 
@@ -488,10 +492,6 @@ queryParams?: AIAgentQueryParams;
 * @description AIAgent global default config.
 * */
 config?: AIAgentConfig;
-/**
-* @internal Used for conversation initial render stat tracking.
-*/
-presentMethod?: PresentMethod;
 } & {
 children?: ReactNode | undefined;
 } & RefAttributes<AIAgentMessengerSessionRef>>;
@@ -551,6 +551,7 @@ declare interface AIAgentStringSet {
         header_title: string;
         ended: string;
         footer_title: string;
+        multiple_files_count: (count: number) => string;
     };
 
     date_format: {
@@ -645,7 +646,9 @@ declare type BaseMessageProps<T> = T & {
     maxBodyWidth?: number;
 
     // handlers
+    /** @deprecated Use onClickMediaFiles instead */
     onClickMedia?: (params: { url: string; type: string }) => void;
+    onClickMediaFiles?: (params: { files: Array<{ url: string; type: string; name?: string }>; index: number }) => void;
     onClickFile?: (params: { url: string; type: string }) => void;
 
     children?: ReactNode;
@@ -712,12 +715,14 @@ declare interface CommandPayloads {
     [CommandType.ConversationClose]: undefined | CloseConversationCommandParams;
     [CommandType.MessengerSettingsUpdated]: MessengerSettingsUpdatedParams;
     [CommandType.ActiveChannelUpdated]: ActiveChannelUpdatedParams;
+    [CommandType.AnonymousSessionTokenExpired]: undefined;
 }
 
 declare enum CommandType {
     ConversationClose = 'conv.close',
     MessengerSettingsUpdated = 'messenger.settings.updated',
     ActiveChannelUpdated = 'active.channel.updated',
+    AnonymousSessionTokenExpired = 'anon.token.expired',
 }
 
 declare type CommunityDocumentPickerModule = typeof CommunityDocumentPicker;
@@ -823,11 +828,11 @@ declare interface ConversationHeaderTemplateProps {
 }
 
 declare class ConversationInitialRenderStats extends AIAgentBaseStats {
-    private presentMethod: PresentMethod;
+    private presentMethod: PresentMethod = 'direct_present';
 
-    constructor(presentMethod: PresentMethod) {
-        super();
-        this.presentMethod = presentMethod;
+    setPresentMethod(method: PresentMethod): this {
+        this.presentMethod = method;
+        return this;
     }
 
     protected getMetricKey(): string {
@@ -870,18 +875,18 @@ declare class ConversationInitialRenderStats extends AIAgentBaseStats {
  */
 declare class ConversationInitialRenderStatsTracker {
     private readonly commitCallback: StatsAppendCallback;
-    private readonly presentMethod: PresentMethod;
+    private presentMethod: PresentMethod = 'direct_present';
     private stats: ConversationInitialRenderStats | null = null;
 
-    constructor(commitCallback: StatsAppendCallback, presentMethod: PresentMethod) {
+    constructor(commitCallback: StatsAppendCallback) {
         this.commitCallback = commitCallback;
-        this.presentMethod = presentMethod;
     }
 
     private getOrCreateStats(): ConversationInitialRenderStats {
         if (!this.stats || this.stats.isCommitted()) {
-            this.stats = new ConversationInitialRenderStats(this.presentMethod);
-            this.stats.setCommitCallback(this.commitCallback);
+            this.stats = new ConversationInitialRenderStats()
+            .setCommitCallback(this.commitCallback)
+            .setPresentMethod(this.presentMethod);
         }
         return this.stats;
     }
@@ -957,6 +962,11 @@ declare class ConversationInitialRenderStatsTracker {
         this.stats?.commit();
     }
 
+    setPresentMethod(method: PresentMethod): void {
+        this.presentMethod = method;
+        this.stats?.setPresentMethod(method);
+    }
+
     clear(): void {
         this.stats = null;
     }
@@ -1602,6 +1612,14 @@ export declare const IncomingMessageLayout: {
                     url: string;
                     type: string;
                 }) => void;
+                onClickMediaFiles?: (params: {
+                    files: Array<{
+                        url: string;
+                        type: string;
+                        name?: string;
+                    }>;
+                    index: number;
+                }) => void;
                 onClickFile?: (params: {
                     url: string;
                     type: string;
@@ -1666,6 +1684,86 @@ export declare const IncomingMessageLayout: {
                     url: string;
                     type: string;
                 }) => void;
+                onClickMediaFiles?: (params: {
+                    files: Array<{
+                        url: string;
+                        type: string;
+                        name?: string;
+                    }>;
+                    index: number;
+                }) => void;
+                onClickFile?: (params: {
+                    url: string;
+                    type: string;
+                }) => void;
+                children?: ReactNode;
+            }) | ({
+                messageType: "multipleFiles";
+                message: string;
+                files: {
+                    type: string;
+                    url: string;
+                    name: string;
+                }[];
+            } & {
+                sender: {
+                    nickname: string;
+                    profileUrl?: string;
+                };
+                suggestedRepliesVisible?: boolean;
+                suggestedRepliesDirection?: "vertical" | "horizontal";
+                isBotMessage?: boolean;
+                isTyping?: boolean;
+                isStreaming?: boolean;
+                isHandedOff?: boolean;
+                isConversationClosed?: boolean;
+                isFeedbackEnabled?: boolean;
+                isFeedbackCommentEnabled?: boolean;
+                isSenderAvatarVisible?: boolean;
+                onGetCachedMessageTemplate?: (templateKey: string) => string | null;
+                onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
+                onHandleTemplateInternalAction?: (action: Action) => void;
+                onClickSuggestedReply?: (params: {
+                    reply: string;
+                }) => void;
+                onClickCTA?: (params: {
+                    url: string;
+                }) => void;
+                onClickCitation?: (citation: CitationInfo) => void;
+                onFeedbackUpdate?: (params: {
+                    rating: "good" | "bad";
+                    comment?: string;
+                } | null) => void;
+                onSubmitForm?: (params: {
+                    key: string;
+                    data: Record<string, FormFieldValue>;
+                }) => Promise<void>;
+                onCancelForm?: (params: {
+                    key: string;
+                }) => Promise<void>;
+                onStreamAnimationStart?: () => void;
+                onStreamAnimationProgress?: () => void;
+                onStreamAnimationComplete?: () => void;
+                messageTemplateErrorFallback?: ReactNode;
+                messageTemplateLoadingFallback?: ReactNode;
+            } & {
+                data?: string;
+                createdAt?: number;
+                extendedMessagePayload?: Partial<ExtendedMessagePayload>;
+                groupType?: MessageGroupType;
+                maxBodyWidth?: number;
+                onClickMedia?: (params: {
+                    url: string;
+                    type: string;
+                }) => void;
+                onClickMediaFiles?: (params: {
+                    files: Array<{
+                        url: string;
+                        type: string;
+                        name?: string;
+                    }>;
+                    index: number;
+                }) => void;
                 onClickFile?: (params: {
                     url: string;
                     type: string;
@@ -1763,6 +1861,14 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickMediaFiles?: (params: {
+    files: Array<{
+    url: string;
+    type: string;
+    name?: string;
+    }>;
+    index: number;
+    }) => void;
     onClickFile?: (params: {
     url: string;
     type: string;
@@ -1827,6 +1933,86 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickMediaFiles?: (params: {
+    files: Array<{
+    url: string;
+    type: string;
+    name?: string;
+    }>;
+    index: number;
+    }) => void;
+    onClickFile?: (params: {
+    url: string;
+    type: string;
+    }) => void;
+    children?: ReactNode;
+    }) | ({
+    messageType: "multipleFiles";
+    message: string;
+    files: {
+    type: string;
+    url: string;
+    name: string;
+    }[];
+    } & {
+    sender: {
+    nickname: string;
+    profileUrl?: string;
+    };
+    suggestedRepliesVisible?: boolean;
+    suggestedRepliesDirection?: "vertical" | "horizontal";
+    isBotMessage?: boolean;
+    isTyping?: boolean;
+    isStreaming?: boolean;
+    isHandedOff?: boolean;
+    isConversationClosed?: boolean;
+    isFeedbackEnabled?: boolean;
+    isFeedbackCommentEnabled?: boolean;
+    isSenderAvatarVisible?: boolean;
+    onGetCachedMessageTemplate?: (templateKey: string) => string | null;
+    onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
+    onHandleTemplateInternalAction?: (action: Action) => void;
+    onClickSuggestedReply?: (params: {
+    reply: string;
+    }) => void;
+    onClickCTA?: (params: {
+    url: string;
+    }) => void;
+    onClickCitation?: (citation: CitationInfo) => void;
+    onFeedbackUpdate?: (params: {
+    rating: "good" | "bad";
+    comment?: string;
+    } | null) => void;
+    onSubmitForm?: (params: {
+    key: string;
+    data: Record<string, FormFieldValue>;
+    }) => Promise<void>;
+    onCancelForm?: (params: {
+    key: string;
+    }) => Promise<void>;
+    onStreamAnimationStart?: () => void;
+    onStreamAnimationProgress?: () => void;
+    onStreamAnimationComplete?: () => void;
+    messageTemplateErrorFallback?: ReactNode;
+    messageTemplateLoadingFallback?: ReactNode;
+    } & {
+    data?: string;
+    createdAt?: number;
+    extendedMessagePayload?: Partial<ExtendedMessagePayload>;
+    groupType?: MessageGroupType;
+    maxBodyWidth?: number;
+    onClickMedia?: (params: {
+    url: string;
+    type: string;
+    }) => void;
+    onClickMediaFiles?: (params: {
+    files: Array<{
+    url: string;
+    type: string;
+    name?: string;
+    }>;
+    index: number;
+    }) => void;
     onClickFile?: (params: {
     url: string;
     type: string;
@@ -1919,6 +2105,14 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickMediaFiles?: (params: {
+    files: Array<{
+    url: string;
+    type: string;
+    name?: string;
+    }>;
+    index: number;
+    }) => void;
     onClickFile?: (params: {
     url: string;
     type: string;
@@ -1983,6 +2177,86 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickMediaFiles?: (params: {
+    files: Array<{
+    url: string;
+    type: string;
+    name?: string;
+    }>;
+    index: number;
+    }) => void;
+    onClickFile?: (params: {
+    url: string;
+    type: string;
+    }) => void;
+    children?: ReactNode;
+    }) | ({
+    messageType: "multipleFiles";
+    message: string;
+    files: {
+    type: string;
+    url: string;
+    name: string;
+    }[];
+    } & {
+    sender: {
+    nickname: string;
+    profileUrl?: string;
+    };
+    suggestedRepliesVisible?: boolean;
+    suggestedRepliesDirection?: "vertical" | "horizontal";
+    isBotMessage?: boolean;
+    isTyping?: boolean;
+    isStreaming?: boolean;
+    isHandedOff?: boolean;
+    isConversationClosed?: boolean;
+    isFeedbackEnabled?: boolean;
+    isFeedbackCommentEnabled?: boolean;
+    isSenderAvatarVisible?: boolean;
+    onGetCachedMessageTemplate?: (templateKey: string) => string | null;
+    onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
+    onHandleTemplateInternalAction?: (action: Action) => void;
+    onClickSuggestedReply?: (params: {
+    reply: string;
+    }) => void;
+    onClickCTA?: (params: {
+    url: string;
+    }) => void;
+    onClickCitation?: (citation: CitationInfo) => void;
+    onFeedbackUpdate?: (params: {
+    rating: "good" | "bad";
+    comment?: string;
+    } | null) => void;
+    onSubmitForm?: (params: {
+    key: string;
+    data: Record<string, FormFieldValue>;
+    }) => Promise<void>;
+    onCancelForm?: (params: {
+    key: string;
+    }) => Promise<void>;
+    onStreamAnimationStart?: () => void;
+    onStreamAnimationProgress?: () => void;
+    onStreamAnimationComplete?: () => void;
+    messageTemplateErrorFallback?: ReactNode;
+    messageTemplateLoadingFallback?: ReactNode;
+    } & {
+    data?: string;
+    createdAt?: number;
+    extendedMessagePayload?: Partial<ExtendedMessagePayload>;
+    groupType?: MessageGroupType;
+    maxBodyWidth?: number;
+    onClickMedia?: (params: {
+    url: string;
+    type: string;
+    }) => void;
+    onClickMediaFiles?: (params: {
+    files: Array<{
+    url: string;
+    type: string;
+    name?: string;
+    }>;
+    index: number;
+    }) => void;
     onClickFile?: (params: {
     url: string;
     type: string;
@@ -2090,6 +2364,14 @@ export declare const IncomingMessageLayout: {
                 url: string;
                 type: string;
             }) => void;
+            onClickMediaFiles?: (params: {
+                files: Array<{
+                    url: string;
+                    type: string;
+                    name?: string;
+                }>;
+                index: number;
+            }) => void;
             onClickFile?: (params: {
                 url: string;
                 type: string;
@@ -2154,6 +2436,86 @@ export declare const IncomingMessageLayout: {
                 url: string;
                 type: string;
             }) => void;
+            onClickMediaFiles?: (params: {
+                files: Array<{
+                    url: string;
+                    type: string;
+                    name?: string;
+                }>;
+                index: number;
+            }) => void;
+            onClickFile?: (params: {
+                url: string;
+                type: string;
+            }) => void;
+            children?: ReactNode;
+        }) | ({
+            messageType: "multipleFiles";
+            message: string;
+            files: {
+                type: string;
+                url: string;
+                name: string;
+            }[];
+        } & {
+            sender: {
+                nickname: string;
+                profileUrl?: string;
+            };
+            suggestedRepliesVisible?: boolean;
+            suggestedRepliesDirection?: "vertical" | "horizontal";
+            isBotMessage?: boolean;
+            isTyping?: boolean;
+            isStreaming?: boolean;
+            isHandedOff?: boolean;
+            isConversationClosed?: boolean;
+            isFeedbackEnabled?: boolean;
+            isFeedbackCommentEnabled?: boolean;
+            isSenderAvatarVisible?: boolean;
+            onGetCachedMessageTemplate?: (templateKey: string) => string | null;
+            onRequestMessageTemplate?: (templateKey: string) => Promise<string>;
+            onHandleTemplateInternalAction?: (action: Action) => void;
+            onClickSuggestedReply?: (params: {
+                reply: string;
+            }) => void;
+            onClickCTA?: (params: {
+                url: string;
+            }) => void;
+            onClickCitation?: (citation: CitationInfo) => void;
+            onFeedbackUpdate?: (params: {
+                rating: "good" | "bad";
+                comment?: string;
+            } | null) => void;
+            onSubmitForm?: (params: {
+                key: string;
+                data: Record<string, FormFieldValue>;
+            }) => Promise<void>;
+            onCancelForm?: (params: {
+                key: string;
+            }) => Promise<void>;
+            onStreamAnimationStart?: () => void;
+            onStreamAnimationProgress?: () => void;
+            onStreamAnimationComplete?: () => void;
+            messageTemplateErrorFallback?: ReactNode;
+            messageTemplateLoadingFallback?: ReactNode;
+        } & {
+            data?: string;
+            createdAt?: number;
+            extendedMessagePayload?: Partial<ExtendedMessagePayload>;
+            groupType?: MessageGroupType;
+            maxBodyWidth?: number;
+            onClickMedia?: (params: {
+                url: string;
+                type: string;
+            }) => void;
+            onClickMediaFiles?: (params: {
+                files: Array<{
+                    url: string;
+                    type: string;
+                    name?: string;
+                }>;
+                index: number;
+            }) => void;
             onClickFile?: (params: {
                 url: string;
                 type: string;
@@ -2195,6 +2557,15 @@ declare type IncomingMessageUnion =
         url: string;
         name: string;
     };
+}>
+| IncomingBaseMessageProps<{
+    messageType: 'multipleFiles';
+    message: string;
+    files: {
+        type: string;
+        url: string;
+        name: string;
+    }[];
 }>;
 
 declare type InputState = {
@@ -2394,6 +2765,7 @@ declare interface MessengerSettingsResponse {
         upload_size_limit_per_type: Record<string, number>;
         supported_image_mime_types: string[];
         supported_file_mime_types: string[];
+        max_attachment_count?: number;
     };
 }
 
@@ -2523,10 +2895,10 @@ export declare const OutgoingMessageLayout: {
     defaults: {
         template: ComponentType<OutgoingMessageProps>;
         components: {
-            SendingStatus: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+            SendingStatus: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
                 containerStyle?: ViewStyle;
             }) => ReactNode;
-            SentTime: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+            SentTime: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
                 containerStyle?: ViewStyle;
             }) => ReactNode;
             MessageBody: (props: OutgoingMessageBodyProps) => ReactNode;
@@ -2537,26 +2909,26 @@ export declare const OutgoingMessageLayout: {
         children?: ReactNode;
     }) => JSX.Element;
     Context: Context<LayoutContextValue<OutgoingMessageProps, {
-    SendingStatus: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+    SendingStatus: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
     containerStyle?: ViewStyle;
     }) => ReactNode;
-    SentTime: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+    SentTime: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
     containerStyle?: ViewStyle;
     }) => ReactNode;
     MessageBody: (props: OutgoingMessageBodyProps) => ReactNode;
     }>>;
     useContext: () => LayoutContextValue<OutgoingMessageProps, {
-    SendingStatus: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+    SendingStatus: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
     containerStyle?: ViewStyle;
     }) => ReactNode;
-    SentTime: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+    SentTime: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
     containerStyle?: ViewStyle;
     }) => ReactNode;
     MessageBody: (props: OutgoingMessageBodyProps) => ReactNode;
     }>;
 } & {
     SentTime: (props: {
-        component: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+        component: ({ createdAt, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
             containerStyle?: ViewStyle;
         }) => ReactNode;
     }) => null;
@@ -2564,7 +2936,7 @@ export declare const OutgoingMessageLayout: {
         component: (props: OutgoingMessageBodyProps) => ReactNode;
     }) => null;
     SendingStatus: (props: {
-        component: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user"> & {
+        component: ({ sendingStatus, containerStyle }: OutgoingMessageProps<"file" | "user" | "multipleFiles"> & {
             containerStyle?: ViewStyle;
         }) => ReactNode;
     }) => null;
@@ -2590,6 +2962,18 @@ declare type OutgoingMessageUnion =
         aspectRatio: string;
         localFile?: unknown;
     };
+}>
+| OutgoingBaseMessageProps<{
+    messageType: 'multipleFiles';
+    message: string;
+    files: {
+        type: string;
+        url: string;
+        name: string;
+    }[];
+    metadata: {
+        localFiles?: unknown[];
+    };
 }>;
 
 declare interface PaletteColor {
@@ -2813,6 +3197,7 @@ declare type SystemMessageUnion =
     csatExpireAt?: number;
     isResolvedWhenDeterminedByUser?: boolean;
     onSubmitCSAT: (params: CSATSubmitParams) => Promise<void>;
+    onScrollToBottom?: () => void;
 }>;
 
 declare type TextField = {