@vanira/sdk 0.0.31 → 0.0.33

package/dist/api/services/ChatService.d.ts

@@ -9,10 +9,10 @@ export interface ChatMessage {
 export declare class ChatService {
     static setChatUrl(url: string): void;
     static createChatProspect(prospectGroupId: string): Promise<string>;
-    static fetchWelcomeMessage(agentId: string, prospectId: string, widgetId?: string, pkKey?: string): Promise<ChatMessage & {
+    static fetchWelcomeMessage(agentId: string, prospectId: string, widgetId?: string, _pkKey?: string): Promise<ChatMessage & {
         chatId?: string;
     }>;
-    static sendChatMessage(agentId: string, prospectId: string, message: string, chatId: string | null, onChunk: (text: string) => void, onWidget: (widget: any) => void, onDone: (newChatId: string | null) => void, widgetId?: string, pkKey?: string): Promise<void>;
+    static sendChatMessage(agentId: string, prospectId: string, message: string, chatId: string | null, onChunk: (text: string) => void, onWidget: (widget: any) => void, onDone: (newChatId: string | null) => void, widgetId?: string, _pkKey?: string): Promise<void>;
     static listenForAdminReplies(inboxId: string, sender: string, onMessage: (content: string) => void): {
         close: () => void;
     };

package/dist/core/VaniraAI.d.ts

@@ -134,6 +134,22 @@ export declare class VaniraAI {
      * client.triggerInterrupt('user_opened_checkout', { cart_value: 299 });
      */
     triggerInterrupt(actionName: string, data?: Record<string, any>): void;
+    /**
+     * Upload a file (photo, document, screenshot) to the AI agent during a live call.
+     * Handles the HTTP upload and DataChannel notification automatically.
+     *
+     * @param file     - File or Blob to upload (JPEG, PNG, GIF, WebP, PDF — max 50 MB)
+     * @param reason   - Routing key: 'general' | 'kyc_photo' | 'damage_photo' | 'selfie' | 'document' | 'screenshot'
+     * @param message  - Optional text the user wants to say about the file
+     * @returns        `{ media_id, url }` on success
+     *
+     * @example
+     * const { media_id, url } = await client.uploadMedia(file, 'damage_photo', 'Photo of the damage');
+     */
+    uploadMedia(file: File | Blob, reason?: string, message?: string): Promise<{
+        media_id: string;
+        url: string;
+    }>;
     private _setStatus;
     private _inferServerUrl;
     private _assertConnected;

package/dist/core/WebRTCClient.d.ts

@@ -74,6 +74,18 @@ export declare class WebRTCClient {
      * Trigger a client-side interrupt — cuts AI audio and forces it to react to a UI event.
      */
     triggerActionInterrupt(): void;
+    /**
+     * Uploads a file (photo, document, screenshot) to the media server
+     * and notifies the AI agent via the WebRTC control DataChannel.
+     *
+     * @param file The file to upload (image, PDF, document)
+     * @param reason Routing key for backend processing (default: 'general')
+     * @param message Optional user text message about the file
+     */
+    uploadMedia(file: File | Blob, reason?: string, message?: string): Promise<{
+        media_id: string;
+        url: string;
+    }>;
     /**
      * Fetch active STUN/TURN ICE servers from the Vanira API.
      * @param apiKey  Your sk_live_* or pk_live_* key