@magemetrics/ai 0.11.4 → 0.11.6

package/dist/react/index.d.ts

@@ -6,6 +6,7 @@ import { DirectAuthProvider } from '@magemetrics/core';
 import { ExternalAuthProvider } from '@magemetrics/core';
 import { ExternalAuthProviderConfig } from '@magemetrics/core';
 import { FetchNextPageOptions } from '@tanstack/react-query';
+import { FileUIPart } from 'ai';
 import { ForwardRefExoticComponent } from 'react';
 import { InfiniteData } from '@tanstack/react-query';
 import { InfiniteQueryObserverResult } from '@tanstack/react-query';
@@ -92,6 +93,7 @@ declare interface ChatComponent extends default_2.MemoExoticComponent<(props: Ch
 export declare interface ChatContextValue {
     flowId: string | undefined | null;
     enableSpeechToText?: boolean;
+    enableFileUpload?: boolean;
 }
 
 /**
@@ -142,9 +144,10 @@ export declare interface ChatInputContextValue {
     isAwaitingUserAnswer: boolean;
     onRetry?: () => void;
     onStop?: () => void;
-    sendMessage: (text: string, isEditing: boolean) => void;
+    sendMessage: (text: string, isEditing: boolean, files?: FileUIPart[]) => void;
     lastUserMessage?: string;
     enableSpeechToText?: boolean;
+    enableFileUpload?: boolean;
 }
 
 declare const ChatInputDefault: default_2.FC;
@@ -152,6 +155,7 @@ declare const ChatInputDefault: default_2.FC;
 declare interface ChatProps {
     flowId: string | undefined | null;
     enableSpeechToText?: boolean;
+    enableFileUpload?: boolean;
     children?: default_2.ReactNode;
 }
 
@@ -205,6 +209,7 @@ declare interface ConfigurableChatComponent extends default_2.FC<ConfigurableCha
 declare type ConfigurableChatComponentProps = {
     flowId: string | undefined | null;
     enableSpeechToText?: boolean;
+    enableFileUpload?: boolean;
     disableCanvas?: boolean;
     children?: default_2.ReactNode;
     /**
@@ -236,6 +241,7 @@ declare interface ConversationContentProps {
     topBar?: React.ReactNode;
     disableCanvas?: boolean;
     enableSpeechToText?: boolean;
+    enableFileUpload?: boolean;
     children?: React.ReactNode;
 }
 
@@ -280,6 +286,51 @@ export { ExternalAuthProvider }
 
 export { ExternalAuthProviderConfig }
 
+export declare interface FileAttachment {
+    /** Unique ID for this attachment (for React keys and removal) */
+    id: string;
+    /** Original file name */
+    filename: string;
+    /** File size in bytes */
+    size: number;
+    /** The FileUIPart ready to be sent via sendMessage */
+    filePart: FileUIPart;
+    /** Validation error, if any */
+    error?: string;
+}
+
+export declare interface FileUploadConfig {
+    /** Maximum file size per file in bytes. Default: 10 * 1024 * 1024 (10 MB) */
+    maxFileSize?: number;
+    /** Maximum combined file size in bytes. Default: 20 * 1024 * 1024 (20 MB) */
+    maxCombinedSize?: number;
+}
+
+export declare interface FileUploadController {
+    /** Currently attached files (valid and invalid) */
+    attachments: FileAttachment[];
+    /** Whether all attachments are valid and ready to send */
+    isReady: boolean;
+    /** Whether any file is currently being read (FileReader in progress) */
+    isProcessing: boolean;
+    /** Total size of all valid attachments in bytes */
+    totalSize: number;
+    /** Combined size limit error, if total exceeds maxCombinedSize */
+    combinedSizeError?: string;
+    /** Add files from a FileList (e.g., from an input[type=file]) */
+    addFiles: (files: FileList) => void;
+    /** Remove a specific attachment by ID */
+    removeFile: (id: string) => void;
+    /** Clear all attachments */
+    clearFiles: () => void;
+    /** Get all valid FileUIParts for sendMessage */
+    getFileParts: () => FileUIPart[];
+    /** Open the native file picker (programmatic trigger) */
+    openFilePicker: () => void;
+    /** Ref to attach to a hidden file input element */
+    fileInputRef: React.RefObject<HTMLInputElement | null>;
+}
+
 /**
  * This module handles the formatting and normalization of table cell values for display and sorting.
  *
@@ -317,6 +368,12 @@ declare const FrontendCanvasSchema: z.ZodObject<{
     is_public: z.ZodBoolean;
 }, z.core.$strip>;
 
+declare const FrontendRecommendationsSchema: z.ZodObject<{
+    starter: z.ZodString;
+    explanation: z.ZodString;
+    type: z.ZodString;
+}, z.core.$strip>;
+
 declare const FrontendReportSchema: z.ZodObject<{
     status: z.ZodNullable<z.ZodString>;
     title: z.ZodString;
@@ -549,6 +606,8 @@ export declare type PublicChatProps = Omit<ConversationContentProps, "children">
     appearance?: AppearanceConfig;
 };
 
+export declare type Recommendation = z.infer<typeof FrontendRecommendationsSchema>;
+
 declare type Report_2 = z.infer<typeof FrontendReportSchema>;
 export { Report_2 as Report }
 
@@ -646,6 +705,8 @@ declare type StartOptions = DisplayControlProps & {
     autoFocus?: boolean;
     /** Whether speech-to-text controls should be shown */
     enableSpeechToText?: boolean;
+    /** Whether file upload should be enabled in the chat input */
+    enableFileUpload?: boolean;
 };
 
 declare type TableFilters = Record<string, TableFilterValue>;
@@ -955,6 +1016,8 @@ export declare const useDownloadReportData: (options?: UseMutationOptions<Export
     mutateAsync: UseMutateAsyncFunction<ExportReportDataResult, Error, ExportReportDataParams, unknown>;
 };
 
+export declare function useFileUpload(config?: FileUploadConfig): FileUploadController;
+
 export declare const useMageMetricsApiUrl: () => string;
 
 export declare const useMageMetricsClient: () => MageMetricsClient;
@@ -970,6 +1033,12 @@ user_id: string | null;
 application_id?: number | null | undefined;
 }[], Error>;
 
+export declare const useRecommendations: (count: number) => UseQueryResult<    {
+starter: string;
+explanation: string;
+type: string;
+}[], Error>;
+
 export declare const useReport: (reportId: number) => {
     data: {
         created_at: string;