@algolia/satellite 2.4.0 → 2.5.0

package/dist/esm/Chat/ChatContextContainer/ChatContextContainer.js

@@ -0,0 +1,66 @@
+import { Children, isValidElement, useMemo, useRef } from "react";
+import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
+import { chatContextContainerStyles } from "./ChatContextContainer.styles";
+import { theme } from "./theme";
+import { IconButtonWithFeedback } from "./../../Actions";
+import { CopyIcon } from "./../../Icons";
+import { uniqueId } from "./../../utils";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The `ChatContextContainer` component wraps data with an actionable header. Intended for use with the chat interface.
+ */
+export var ChatContextContainer = function ChatContextContainer(_ref) {
+  var className = _ref.className,
+    title = _ref.title,
+    actions = _ref.actions,
+    code = _ref.code,
+    children = _ref.children;
+  var styles = chatContextContainerStyles();
+  var contentContainerRef = useRef(null);
+  var titleId = useMemo(function () {
+    return uniqueId("chat-context-container-title-");
+  }, []);
+  return /*#__PURE__*/_jsx("div", {
+    className: styles.base({
+      className: className
+    }),
+    children: /*#__PURE__*/_jsxs("div", {
+      className: styles.item(),
+      children: [/*#__PURE__*/_jsxs("div", {
+        className: styles.header(),
+        children: [/*#__PURE__*/_jsx("p", {
+          id: titleId,
+          className: styles.title(),
+          children: title !== null && title !== void 0 ? title : code
+        }), actions !== null && actions !== void 0 ? actions : /*#__PURE__*/_jsx(IconButtonWithFeedback, {
+          icon: CopyIcon,
+          variant: "subtle",
+          size: "small",
+          message: "Copy to clipboard",
+          tooltipSide: "bottom",
+          tooltipDelay: 0,
+          tooltipHideDelay: 0,
+          onClick: function onClick() {
+            var _contentContainerRef$;
+            // Fallback to unformatted HTML as text if content is JSX or array of JSX
+            var content = /*#__PURE__*/isValidElement(children) || Children.count(children) > 1 ? (_contentContainerRef$ = contentContainerRef.current) === null || _contentContainerRef$ === void 0 ? void 0 : _contentContainerRef$.innerHTML : children === null || children === void 0 ? void 0 : children.toString();
+            if (content) {
+              void navigator.clipboard.writeText(content);
+            }
+          }
+        })]
+      }), /*#__PURE__*/_jsx("div", {
+        ref: contentContainerRef,
+        role: "region",
+        "aria-labelledby": titleId,
+        className: styles.content(),
+        children: code !== undefined && typeof children === "string" ? /*#__PURE__*/_jsx(SyntaxHighlighter, {
+          PreTag: "div",
+          language: code,
+          style: theme,
+          children: children
+        }) : children
+      })]
+    })
+  });
+};

package/dist/esm/Chat/ChatContextContainer/ChatContextContainer.styles.d.ts

@@ -0,0 +1,65 @@
+export declare const chatContextContainerStyles: import("tailwind-variants").TVReturnType<{
+    [key: string]: {
+        [key: string]: import("tailwind-merge").ClassNameValue | {
+            base?: import("tailwind-merge").ClassNameValue;
+            header?: import("tailwind-merge").ClassNameValue;
+            title?: import("tailwind-merge").ClassNameValue;
+            content?: import("tailwind-merge").ClassNameValue;
+            item?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: import("tailwind-merge").ClassNameValue | {
+            base?: import("tailwind-merge").ClassNameValue;
+            header?: import("tailwind-merge").ClassNameValue;
+            title?: import("tailwind-merge").ClassNameValue;
+            content?: import("tailwind-merge").ClassNameValue;
+            item?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {}, {
+    base: string;
+    item: string;
+    header: string;
+    title: string;
+    content: string;
+}, undefined, {
+    responsiveVariants?: boolean | ("sm" | "md" | "lg" | "xl" | "2xl")[] | {} | undefined;
+} & import("tailwind-variants/dist/config").TWMConfig & {
+    twMergeConfig: {
+        prefix: string;
+    };
+}, {
+    [key: string]: {
+        [key: string]: import("tailwind-merge").ClassNameValue | {
+            base?: import("tailwind-merge").ClassNameValue;
+            header?: import("tailwind-merge").ClassNameValue;
+            title?: import("tailwind-merge").ClassNameValue;
+            content?: import("tailwind-merge").ClassNameValue;
+            item?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {}, {
+    base: string;
+    item: string;
+    header: string;
+    title: string;
+    content: string;
+}, import("tailwind-variants").TVReturnType<unknown, {
+    base: string;
+    item: string;
+    header: string;
+    title: string;
+    content: string;
+}, undefined, import("tailwind-variants/dist/config").TVConfig<unknown, {
+    [key: string]: {
+        [key: string]: import("tailwind-merge").ClassNameValue | {
+            base?: import("tailwind-merge").ClassNameValue;
+            header?: import("tailwind-merge").ClassNameValue;
+            title?: import("tailwind-merge").ClassNameValue;
+            content?: import("tailwind-merge").ClassNameValue;
+            item?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {}>, unknown, unknown, undefined>>;

package/dist/esm/Chat/ChatContextContainer/ChatContextContainer.styles.js

@@ -0,0 +1,15 @@
+import _taggedTemplateLiteral from "@babel/runtime/helpers/taggedTemplateLiteral";
+var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5;
+import stl from "./../../styles/helpers/satellitePrefixer";
+import { tv } from "./../../styles/helpers/tv";
+export var chatContextContainerStyles = tv({
+  slots: {
+    base: stl(_templateObject || (_templateObject = _taggedTemplateLiteral(["w-full"]))),
+    item: stl(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["border border-grey-200 rounded-[4px] overflow-hidden"]))),
+    header: stl(_templateObject3 || (_templateObject3 = _taggedTemplateLiteral(["flex items-center justify-between bg-white border-b border-grey-200 transition-colors duration-500 pl-3 pr-1 min-h-8"]))),
+    // override markdown-content styles for "p" tags
+    title: stl(_templateObject4 || (_templateObject4 = _taggedTemplateLiteral(["!typo-display-caption !typo-subdued !m-0"]))),
+    // select "code" to override any selectors added by markdown-content styles
+    content: stl(_templateObject5 || (_templateObject5 = _taggedTemplateLiteral(["bg-grey-100 [&_code]:bg-grey-100 text-grey-600 [&_code]:text-grey-600 text-sm [&_code]:text-sm leading-[20px] [&_code]:leading-[20px] px-3 py-2 [&_code]:p-0 [&_code]:m-0 overflow-y-auto max-h-80 thin-scrollbar"])))
+  }
+});

package/dist/esm/Chat/ChatContextContainer/index.d.ts

@@ -0,0 +1 @@
+export * from "./ChatContextContainer";

package/dist/esm/Chat/ChatContextContainer/index.js

@@ -0,0 +1 @@
+export * from "./ChatContextContainer";

package/dist/esm/Chat/ChatContextContainer/theme.d.ts

@@ -0,0 +1,57 @@
+export declare const theme: {
+    'pre[class*="language-"]': {
+        whiteSpace: string;
+    };
+    comment: {
+        color: string;
+    };
+    tag: {
+        color: string;
+    };
+    boolean: {
+        color: string;
+    };
+    number: {
+        color: string;
+    };
+    constant: {
+        color: string;
+    };
+    symbol: {
+        color: string;
+    };
+    selector: {
+        color: string;
+    };
+    "attr-name": {
+        color: string;
+    };
+    string: {
+        color: string;
+    };
+    char: {
+        color: string;
+    };
+    inserted: {
+        color: string;
+    };
+    url: {
+        color: string;
+        background: string;
+    };
+    "attr-value": {
+        color: string;
+    };
+    function: {
+        color: string;
+    };
+    keyword: {
+        color: string;
+    };
+    bold: {
+        fontWeight: string;
+    };
+    italic: {
+        fontStyle: string;
+    };
+};

package/dist/esm/Chat/ChatContextContainer/theme.js

@@ -0,0 +1,67 @@
+import { colors } from "./../../index";
+var BACKGROUND = colors.grey[100];
+var PINK = colors.pink[700];
+var BLUE = colors.xenon[600];
+var DARK_BLUE = colors.nebula[900];
+var LIGHT_BLUE = colors.blue[800];
+var GREEN = colors.green[800];
+var ORANGE = colors.orange[700];
+
+// Based on prism theme with design token colors
+export var theme = {
+  'pre[class*="language-"]': {
+    whiteSpace: "pre"
+  },
+  comment: {
+    color: DARK_BLUE
+  },
+  tag: {
+    color: ORANGE
+  },
+  "boolean": {
+    color: BLUE
+  },
+  number: {
+    color: BLUE
+  },
+  constant: {
+    color: BLUE
+  },
+  symbol: {
+    color: BLUE
+  },
+  selector: {
+    color: GREEN
+  },
+  "attr-name": {
+    color: GREEN
+  },
+  string: {
+    color: GREEN
+  },
+  "char": {
+    color: GREEN
+  },
+  inserted: {
+    color: GREEN
+  },
+  url: {
+    color: BLUE,
+    background: BACKGROUND
+  },
+  "attr-value": {
+    color: PINK
+  },
+  "function": {
+    color: LIGHT_BLUE
+  },
+  keyword: {
+    color: PINK
+  },
+  bold: {
+    fontWeight: "bold"
+  },
+  italic: {
+    fontStyle: "italic"
+  }
+};

package/dist/esm/Chat/ChatMessage/ChatMessage.d.ts

@@ -3,11 +3,11 @@ import type { VariantProps } from "tailwind-variants";
 import { chatMessageStyles } from "./ChatMessage.styles";
 import type { IconButtonWithFeedbackProps } from "../../Actions";
 import type { UserAvatarProps } from "../../Indicators";
-declare type ChatMessageVariants = VariantProps<typeof chatMessageStyles>;
-declare type Actions<ActionsExtraData extends Record<string, any> = Record<string, any>> = Array<Omit<IconButtonWithFeedbackProps, "onClick" | "tooltipDelay" | "tooltipHideDelay"> & {
+type ChatMessageVariants = VariantProps<typeof chatMessageStyles>;
+type Actions<ActionsExtraData extends Record<string, any> = Record<string, any>> = Array<Omit<IconButtonWithFeedbackProps, "onClick" | "tooltipDelay" | "tooltipHideDelay"> & {
     onClick?: (e: MouseEvent<HTMLButtonElement>, actionsExtraData?: ActionsExtraData) => Promise<void> | void;
 }>;
-export declare type ChatMessageProps<ActionsExtraData extends Record<string, any> = Record<string, any>> = Omit<HTMLAttributes<HTMLElement>, "children" | "content"> & {
+export type ChatMessageProps<ActionsExtraData extends Record<string, any> = Record<string, any>> = Omit<HTMLAttributes<HTMLElement>, "children" | "content"> & {
     /**
      * The content of the message.
      */
@@ -62,56 +62,7 @@ export declare type ChatMessageProps<ActionsExtraData extends Record<string, any
  *
  * See the [ChatMessage documentation page](https://satellite.algolia.com/8261d6576/p/06f740-chat-message) for more information.
  */
-export declare const ChatMessage: <ActionsExtraData extends Record<string, any> = Record<string, any>>(props: Omit<HTMLAttributes<HTMLElement>, "content" | "children"> & {
-    /**
-     * The content of the message.
-     */
-    content: ReactNode;
-    /**
-     * The avatar of the message.
-     */
-    avatar?: import("../../Indicators/Avatars/types").MinimalUser | undefined;
-    /**
-     * The size of the avatar.
-     */
-    avatarSize?: UserAvatarProps["size"];
-    /**
-     * The side of the message.
-     */
-    side?: ChatMessageVariants["side"];
-    /**
-     * The variant of the message.
-     */
-    variant?: ChatMessageVariants["variant"];
-    /**
-     * The actions of the message.
-     */
-    actions?: Actions<ActionsExtraData> | undefined;
-    /**
-     * Whether to automatically hide the actions.
-     */
-    autoHideActions?: boolean | undefined;
-    /**
-     * The leading content of the message.
-     */
-    renderLeading?: ReactNode;
-    /**
-     * The actions content of the message.
-     */
-    renderActions?: ((actions?: Actions<ActionsExtraData> | undefined) => ReactNode) | undefined;
-    /**
-     * The footer content of the message.
-     */
-    renderFooter?: ReactNode;
-    /**
-     * The extra data of the actions.
-     */
-    actionsExtraData?: ActionsExtraData | undefined;
-    /**
-     * Whether to render the message in RTL.
-     */
-    rtl?: boolean | undefined;
-} & {
-    ref?: Ref<HTMLDivElement> | undefined;
+export declare const ChatMessage: <ActionsExtraData extends Record<string, any> = Record<string, any>>(props: ChatMessageProps<ActionsExtraData> & {
+    ref?: Ref<HTMLDivElement>;
 }) => ReactElement | null;
 export {};

package/dist/esm/Chat/ChatMessageError/ChatMessageError.d.ts

@@ -1,11 +1,11 @@
 import type { HTMLAttributes, ReactNode } from "react";
 import type { ButtonProps } from "../../Actions";
 import type { ChatMessageProps } from "../../Chat/ChatMessage";
-export declare type ChatMessageErrorLocale = {
+export type ChatMessageErrorLocale = {
     error?: string;
     retry?: string;
 };
-export declare type ChatMessageErrorProps = Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps, "rtl"> & {
+export type ChatMessageErrorProps = Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps, "rtl"> & {
     /**
      * Content to render as the error message.
      * If not provided, a default error message will be shown.
@@ -35,7 +35,7 @@ export declare type ChatMessageErrorProps = Omit<HTMLAttributes<HTMLElement>, "c
  *
  * See the [ChatMessageError documentation page](https://satellite.algolia.com/8261d6576/p/06f740-chat-message-error) for more information.
  */
-export declare const ChatMessageError: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps<Record<string, any>>, "rtl"> & {
+export declare const ChatMessageError: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps, "rtl"> & {
     /**
      * Content to render as the error message.
      * If not provided, a default error message will be shown.
@@ -49,14 +49,14 @@ export declare const ChatMessageError: import("react").ForwardRefExoticComponent
      * Optional actions to display below the error message.
      * If not provided, a default retry button will be shown.
      */
-    actions?: ButtonProps[] | undefined;
+    actions?: ButtonProps[];
     /**
      * Callback function to be called when the retry button is clicked.
      * If not provided, the default retry button will not have any action.
      */
-    onReload?: (() => void) | undefined;
+    onReload?: () => void;
     /**
      * Optional locale.
      */
-    locale?: ChatMessageErrorLocale | undefined;
+    locale?: ChatMessageErrorLocale;
 } & import("react").RefAttributes<HTMLElement>>;

package/dist/esm/Chat/ChatMessageLoader/ChatMessageLoader.d.ts

@@ -1,6 +1,6 @@
 import type { HTMLAttributes, ReactNode } from "react";
 import type { ChatMessageProps } from "../../Chat/ChatMessage";
-export declare type ChatMessageLoaderProps = Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps, "rtl"> & {
+export type ChatMessageLoaderProps = Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps, "rtl"> & {
     /**
      * Message to display in the loader.
      * If not provided, no message will be shown.
@@ -12,7 +12,7 @@ export declare type ChatMessageLoaderProps = Omit<HTMLAttributes<HTMLElement>, "
  *
  * See the [ChatMessageLoader documentation page](https://satellite.algolia.com/8261d6576/p/06f740-chat-message-loader) for more information.
  */
-export declare const ChatMessageLoader: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps<Record<string, any>>, "rtl"> & {
+export declare const ChatMessageLoader: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children"> & Pick<ChatMessageProps, "rtl"> & {
     /**
      * Message to display in the loader.
      * If not provided, no message will be shown.

package/dist/esm/Chat/ChatMessages/ChatMessages.d.ts

@@ -3,11 +3,11 @@ import type { ChatMessageProps } from "../../Chat/ChatMessage";
 import type { ChatMessageErrorProps } from "../../Chat/ChatMessageError";
 import type { ChatMessageLoaderProps } from "../../Chat/ChatMessageLoader";
 import type { ChatMessageBase, ChatStatus } from "../../Chat/types";
-export declare type ChatMessageLocale = {
+export type ChatMessageLocale = {
     scrollToBottomText?: string;
 };
-declare type ChatMessageWithoutContent<Message extends ChatMessageBase> = Omit<ChatMessageProps<Message>, "content">;
-export declare type ChatMessagesProps<Message extends ChatMessageBase = ChatMessageBase> = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+type ChatMessageWithoutContent<Message extends ChatMessageBase> = Omit<ChatMessageProps<Message>, "content">;
+export type ChatMessagesProps<Message extends ChatMessageBase = ChatMessageBase> = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
     /**
      * The messages to display in the chat.
      */
@@ -74,68 +74,7 @@ export declare type ChatMessagesProps<Message extends ChatMessageBase = ChatMess
  *
  * See the [ChatMessages documentation page](https://satellite.algolia.com/8261d6576/p/06f740-chat-messages) for more information.
  */
-export declare const ChatMessages: <Message extends ChatMessageBase = ChatMessageBase>(props: Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    /**
-     * The messages to display in the chat.
-     */
-    messages: Message[];
-    /**
-     * The props for the user message.
-     */
-    userMessageProps?: ChatMessageWithoutContent<Message> | ((message: Message) => ChatMessageWithoutContent<Message>) | undefined;
-    /**
-     * The props for the assistant message.
-     */
-    assistantMessageProps?: ChatMessageWithoutContent<Message> | ((message: Message) => ChatMessageWithoutContent<Message>) | undefined;
-    /**
-     * The props for the loader message.
-     */
-    loaderProps?: ChatMessageLoaderProps | undefined;
-    /**
-     * The props for the error message.
-     */
-    errorProps?: Omit<ChatMessageErrorProps, "onReload"> | undefined;
-    /**
-     * The function to render the message.
-     */
-    renderMessage?: ((message: Message) => ReactNode) | undefined;
-    /**
-     * The function to render the loader message.
-     */
-    renderLoader?: ReactNode;
-    /**
-     * The function to render the error message.
-     */
-    renderError?: ReactNode;
-    /**
-     * The status of the chat.
-     */
-    status?: ChatStatus | undefined;
-    /**
-     * The function to reload the chat.
-     */
-    onReload?: (() => void) | undefined;
-    /**
-     * Whether to hide the scroll to bottom button.
-     */
-    hideScrollToBottom?: boolean | undefined;
-    /**
-     * The class name for the scroll container.
-     */
-    scrollClassName?: string | undefined;
-    /**
-     * The class name for the content container.
-     */
-    contentClassName?: string | undefined;
-    /**
-     * The locale for the chat messages.
-     */
-    locale?: ChatMessageLocale | undefined;
-    /**
-     * Whether to enable right-to-left text direction.
-     */
-    rtl?: boolean | undefined;
-} & {
-    ref?: Ref<HTMLDivElement> | undefined;
+export declare const ChatMessages: <Message extends ChatMessageBase = ChatMessageBase>(props: ChatMessagesProps<Message> & {
+    ref?: Ref<HTMLDivElement>;
 }) => ReactElement | null;
 export {};

package/dist/esm/Chat/ChatMessages/ChatMessages.js

@@ -48,7 +48,6 @@ var ChatMessagesBase = function ChatMessagesBase(_ref, forwardedRef) {
   var contextLocale = useLocale("chatMessage");
   var locale = _objectSpread(_objectSpread(_objectSpread({}, DEFAULT_CHAT_MESSAGE_LOCALE), contextLocale), propsLocale);
   var _useStickToBottom = useStickToBottom({
-      // @ts-expect-error - Types are wrong in use-stick-to-bottom
       initial: "instant",
       resize: "smooth"
     }),

package/dist/esm/Chat/ChatPrompt/ChatPrompt.d.ts

@@ -1,14 +1,14 @@
 import type { FormEvent, KeyboardEvent, ReactNode } from "react";
 import type { ChatStatus } from "../../Chat/types";
 import type { TextAreaAutoSizeProps } from "../../Fields/TextAreaAutoSize/TextAreaAutoSize";
-export declare type ChatPromptLocale = {
+export type ChatPromptLocale = {
     textareaLabel?: string;
     emptyMessageTooltip?: string;
     stopResponseTooltip?: string;
     sendMessageTooltip?: string;
     disabledTooltip?: string;
 };
-export declare type ChatPromptProps = Omit<TextAreaAutoSizeProps, "onSubmit"> & {
+export type ChatPromptProps = Omit<TextAreaAutoSizeProps, "onSubmit"> & {
     /**
      * Content to render above the textarea (e.g., a title or instructions).
      */
@@ -72,7 +72,7 @@ export declare const ChatPrompt: import("react").ForwardRefExoticComponent<Omit<
      * If provided and non-empty, the component will use the dynamic, animated placeholder
      * text instead of any static `placeholder` prop passed in.
      */
-    placeholders?: string[] | undefined;
+    placeholders?: string[];
     /**
      * The current status of the chat prompt submit button:
      * - "submitted": The message has been sent to the API and we're awaiting the start of the response stream.
@@ -80,26 +80,26 @@ export declare const ChatPrompt: import("react").ForwardRefExoticComponent<Omit<
      * - "ready": The full response has been received and processed; a new user message can be submitted.
      * - "error": An error occurred during the API request, preventing successful completion.
      */
-    status?: ChatStatus | undefined;
+    status?: ChatStatus;
     /**
      * Whether to automatically focus the textarea when the user starts typing.
      */
-    autoFocusOnTyping?: boolean | undefined;
+    autoFocusOnTyping?: boolean;
     /**
      * Whether to enable right-to-left (RTL) layout support.
      */
-    rtl?: boolean | undefined;
+    rtl?: boolean;
     /**
      * Optional locale.
      */
-    locale?: ChatPromptLocale | undefined;
+    locale?: ChatPromptLocale;
     /**
      * Callback invoked when the user submits the form, either by clicking
      * the submit button or pressing Enter (without Shift) inside the textarea.
      */
-    onSubmit?: ((e: KeyboardEvent<HTMLTextAreaElement> | FormEvent<HTMLFormElement>) => void) | undefined;
+    onSubmit?: (e: KeyboardEvent<HTMLTextAreaElement> | FormEvent<HTMLFormElement>) => void;
     /**
      * Callback invoked when the user requests to stop the current chat response stream.
      */
-    onStop?: (() => void) | undefined;
+    onStop?: () => void;
 } & import("react").RefAttributes<HTMLTextAreaElement>>;

package/dist/esm/Chat/ChatPrompt/useFocusTyping.d.ts

@@ -1,11 +1,10 @@
-/// <reference types="react" />
 /**
  * Check if the element is a textual element.
  * @param el - The element to check.
  * @returns True if the element is a textual element, false otherwise.
  */
 export declare const isTextualElement: (el: HTMLElement) => boolean;
-declare type Editable = HTMLTextAreaElement | HTMLInputElement | HTMLElement;
+type Editable = HTMLTextAreaElement | HTMLInputElement | HTMLElement;
 export interface UseFocusOnTypingOptions {
     /**
      * Whether the hook is enabled.

package/dist/esm/Chat/helpers.d.ts

@@ -0,0 +1,28 @@
+import type { AiSdkMessage, AiSdkMessageV4, AiSdkMessageV5, ChatMessageWithSource } from "./types";
+/**
+ * Type guard to check if a message is in AI SDK v4.0 format.
+ * @param message - The message to check
+ * @returns True if the message is in v4.0 format (has string content property)
+ */
+export declare const isAiSdkMessageV4: (message: AiSdkMessage) => message is AiSdkMessageV4;
+/**
+ * Type guard to check if a message is in AI SDK v5.0 format.
+ * @param message - The message to check
+ * @returns True if the message is in v5.0 format (has parts array)
+ */
+export declare const isAiSdkMessageV5: (message: AiSdkMessage) => message is AiSdkMessageV5;
+/**
+ * Converts an AI SDK message (v4.0 or v5.0) to the universal ChatMessage format.
+ * For v4.0 messages, uses the content directly.
+ * For v5.0 messages, extracts text from parts and joins them.
+ * @param message - The AI SDK message to convert
+ * @returns A ChatMessage with the original message as source
+ */
+export declare function convertAiSdkMessage<T extends AiSdkMessage>(message: T): ChatMessageWithSource<T>;
+/**
+ * Converts an array of AI SDK messages to the universal ChatMessage format.
+ * Filters out v4.0 data messages and converts the rest using convertAiSdkMessage.
+ * @param messages - Array of AI SDK messages to convert
+ * @returns Array of converted ChatMessages
+ */
+export declare function convertAiSdkMessages<T extends AiSdkMessage>(messages: T[]): ChatMessageWithSource<T>[];

package/dist/esm/Chat/helpers.js

@@ -0,0 +1,60 @@
+/**
+ * Type guard to check if a message is in AI SDK v4.0 format.
+ * @param message - The message to check
+ * @returns True if the message is in v4.0 format (has string content property)
+ */
+export var isAiSdkMessageV4 = function isAiSdkMessageV4(message) {
+  return "content" in message && typeof message.content === "string";
+};
+
+/**
+ * Type guard to check if a message is in AI SDK v5.0 format.
+ * @param message - The message to check
+ * @returns True if the message is in v5.0 format (has parts array)
+ */
+export var isAiSdkMessageV5 = function isAiSdkMessageV5(message) {
+  return "parts" in message && Array.isArray(message.parts);
+};
+
+/**
+ * Converts an AI SDK message (v4.0 or v5.0) to the universal ChatMessage format.
+ * For v4.0 messages, uses the content directly.
+ * For v5.0 messages, extracts text from parts and joins them.
+ * @param message - The AI SDK message to convert
+ * @returns A ChatMessage with the original message as source
+ */
+export function convertAiSdkMessage(message) {
+  var content;
+  if (isAiSdkMessageV4(message)) {
+    // V4: Use content directly
+    content = message.content;
+  } else if (isAiSdkMessageV5(message)) {
+    // V5: Extract text from parts
+    content = message.parts.filter(function (p) {
+      return p.type === "text";
+    }).map(function (p) {
+      return p.text;
+    }).join("");
+  } else {
+    content = "";
+  }
+  return {
+    id: message.id,
+    role: message.role,
+    content: content,
+    source: message
+  };
+}
+
+/**
+ * Converts an array of AI SDK messages to the universal ChatMessage format.
+ * Filters out v4.0 data messages and converts the rest using convertAiSdkMessage.
+ * @param messages - Array of AI SDK messages to convert
+ * @returns Array of converted ChatMessages
+ */
+export function convertAiSdkMessages(messages) {
+  return messages.filter(function (m) {
+    return !isAiSdkMessageV4(m) || m.role !== "data";
+  }) // Skip v4 data messages
+  .map(convertAiSdkMessage);
+}