@sendbird/ai-agent-messenger-react 1.27.0 → 1.28.0

package/dist/index.d.ts

@@ -392,6 +392,14 @@ declare type AIAgentChatSDKParams = ChatSDKSendbirdChatParams<[ChatSDKGroupChann
 
 declare interface AIAgentClientHandlers {
     onCustomEvent?: (event: CustomEvent_2) => void;
+    /**
+     * Called whenever the SDK opens an external URL — markdown links, admin-message
+     * URLs, citation links, CTA buttons, and non-media file-preview clicks.
+     * Provide this to intercept link navigation (analytics, deep links, custom
+     * schemes). When omitted, the SDK falls back to `window.open` on web and
+     * `Linking.openURL` on React Native.
+     */
+    onClickLink?: (params: { url: string }) => void;
 }
 
 declare type AIAgentCommonIconName =
@@ -1288,6 +1296,7 @@ declare type BaseMessageProps<T> = T & {
     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;
+    onClickLink?: (params: { url: string }) => void;
 
     children?: ReactNode;
 };
@@ -2829,6 +2838,9 @@ export declare const IncomingMessageLayout: {
                     url: string;
                     type: string;
                 }) => void;
+                onClickLink?: (params: {
+                    url: string;
+                }) => void;
                 children?: ReactNode;
             }) | ({
                 messageType: "file";
@@ -2903,6 +2915,9 @@ export declare const IncomingMessageLayout: {
                     url: string;
                     type: string;
                 }) => void;
+                onClickLink?: (params: {
+                    url: string;
+                }) => void;
                 children?: ReactNode;
             }) | ({
                 messageType: "multipleFiles";
@@ -2977,6 +2992,9 @@ export declare const IncomingMessageLayout: {
                     url: string;
                     type: string;
                 }) => void;
+                onClickLink?: (params: {
+                    url: string;
+                }) => void;
                 children?: ReactNode;
             })) => ReactNode;
             CTAButton: ({ extendedMessagePayload, onClickCTA, }: IncomingMessageProps) => ReactNode;
@@ -3082,6 +3100,9 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickLink?: (params: {
+    url: string;
+    }) => void;
     children?: ReactNode;
     }) | ({
     messageType: "file";
@@ -3156,6 +3177,9 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickLink?: (params: {
+    url: string;
+    }) => void;
     children?: ReactNode;
     }) | ({
     messageType: "multipleFiles";
@@ -3230,6 +3254,9 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickLink?: (params: {
+    url: string;
+    }) => void;
     children?: ReactNode;
     })) => ReactNode;
     CTAButton: ({ extendedMessagePayload, onClickCTA, }: IncomingMessageProps) => ReactNode;
@@ -3330,6 +3357,9 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickLink?: (params: {
+    url: string;
+    }) => void;
     children?: ReactNode;
     }) | ({
     messageType: "file";
@@ -3404,6 +3434,9 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickLink?: (params: {
+    url: string;
+    }) => void;
     children?: ReactNode;
     }) | ({
     messageType: "multipleFiles";
@@ -3478,6 +3511,9 @@ export declare const IncomingMessageLayout: {
     url: string;
     type: string;
     }) => void;
+    onClickLink?: (params: {
+    url: string;
+    }) => void;
     children?: ReactNode;
     })) => ReactNode;
     CTAButton: ({ extendedMessagePayload, onClickCTA, }: IncomingMessageProps) => ReactNode;
@@ -3601,6 +3637,9 @@ export declare const IncomingMessageLayout: {
                 url: string;
                 type: string;
             }) => void;
+            onClickLink?: (params: {
+                url: string;
+            }) => void;
             children?: ReactNode;
         }) | ({
             messageType: "file";
@@ -3675,6 +3714,9 @@ export declare const IncomingMessageLayout: {
                 url: string;
                 type: string;
             }) => void;
+            onClickLink?: (params: {
+                url: string;
+            }) => void;
             children?: ReactNode;
         }) | ({
             messageType: "multipleFiles";
@@ -3749,6 +3791,9 @@ export declare const IncomingMessageLayout: {
                 url: string;
                 type: string;
             }) => void;
+            onClickLink?: (params: {
+                url: string;
+            }) => void;
             children?: ReactNode;
         })) => ReactNode;
     }) => null;
@@ -3980,7 +4025,7 @@ declare type MessageType_2 = OutgoingMessageProps['messageType'];
 declare interface MessengerContextValue extends AIAgentContextValue {
     rootElement: HTMLElement;
     agentPreviewConfigs?: AgentPreviewConfigs;
-    handlers?: AgentClientHandlers;
+    handlers: ResolvedHandlers;
     state: {
         opened: boolean;
         setOpened: (value: boolean) => void;
@@ -4502,6 +4547,12 @@ declare type ReleaseDisabledByValue =
 | 'reconnecting'
 | 'handoff_pending';
 
+declare interface ResolvedHandlers extends AgentClientHandlers {
+    onClickLink: (params: {
+        url: string;
+    }) => void;
+}
+
 declare type SBUFoundationProps<T = NonNullable<unknown>> = T & {
     className?: string;
     children?: ReactNode;