@paymanai/payman-ask-sdk 4.0.19 → 4.0.21

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default from 'react';
 import { MessageDisplay, AgentStage, ChatCallbacks as ChatCallbacks$1, ChatConfig as ChatConfig$1, ActiveUserAction, UserNotification } from '@paymanai/payman-typescript-ask-sdk';
-export { APIConfig, ActiveUserAction, AgentStage, ChunkDisplay, JsonSchemaField, JsonSchemaOption, MessageDisplay, MessageRole, RequestedSchema, SessionParams, StreamProgress, StreamingStep, UseChatV2Return, UseVoiceReturn, UserActionKind, UserActionRequest, UserActionStaleError, UserActionState, UserActionStatus, UserActionSubAction, UserNotification, VerificationType, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, cancelUserAction, expireUserAction, resendUserAction, submitUserAction, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
+export { APIConfig, ActiveUserAction, AgentStage, ChunkDisplay, JsonSchemaField, JsonSchemaOption, MessageDisplay, MessageRole, RequestedSchema, SessionParams, StreamProgress, StreamingStep, UseChatV2Return, UseVoiceReturn, UserActionKind, UserActionRequest, UserActionStaleError, UserActionState, UserActionStatus, UserActionSubAction, UserNotification, VerificationType, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, cancelUserAction, resendUserAction, submitUserAction, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
 import { ClassValue } from 'clsx';
 
 declare const NEGATIVE_FEEDBACK_REASONS: readonly [{

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default from 'react';
 import { MessageDisplay, AgentStage, ChatCallbacks as ChatCallbacks$1, ChatConfig as ChatConfig$1, ActiveUserAction, UserNotification } from '@paymanai/payman-typescript-ask-sdk';
-export { APIConfig, ActiveUserAction, AgentStage, ChunkDisplay, JsonSchemaField, JsonSchemaOption, MessageDisplay, MessageRole, RequestedSchema, SessionParams, StreamProgress, StreamingStep, UseChatV2Return, UseVoiceReturn, UserActionKind, UserActionRequest, UserActionStaleError, UserActionState, UserActionStatus, UserActionSubAction, UserNotification, VerificationType, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, cancelUserAction, expireUserAction, resendUserAction, submitUserAction, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
+export { APIConfig, ActiveUserAction, AgentStage, ChunkDisplay, JsonSchemaField, JsonSchemaOption, MessageDisplay, MessageRole, RequestedSchema, SessionParams, StreamProgress, StreamingStep, UseChatV2Return, UseVoiceReturn, UserActionKind, UserActionRequest, UserActionStaleError, UserActionState, UserActionStatus, UserActionSubAction, UserNotification, VerificationType, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, cancelUserAction, resendUserAction, submitUserAction, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
 import { ClassValue } from 'clsx';
 
 declare const NEGATIVE_FEEDBACK_REASONS: readonly [{

package/dist/index.js

@@ -736,7 +736,8 @@ function buildRequestBody(config, userMessage, sessionId, options) {
     sessionAttributes,
     analysisMode: options?.analysisMode,
     locale: resolveLocale(config.locale),
-    timezone: resolveTimezone(config.timezone)
+    timezone: resolveTimezone(config.timezone),
+    ...options?.attachments?.length ? { attachments: options.attachments } : {}
   };
 }
 function resolveLocale(configured) {
@@ -781,6 +782,7 @@ function buildResolveImagesUrl(config) {
   const basePath = normalizedEndpointPath.endsWith("/stream") ? normalizedEndpointPath.slice(0, -"/stream".length) : normalizedEndpointPath;
   return `${config.api.baseUrl}${basePath}/resolve-image-urls`;
 }
+var NGROK_SKIP_BROWSER_WARNING = "ngrok-skip-browser-warning";
 function buildRequestHeaders(config) {
   const headers = {
     ...config.api.headers
@@ -788,6 +790,9 @@ function buildRequestHeaders(config) {
   if (config.api.authToken) {
     headers.Authorization = `Bearer ${config.api.authToken}`;
   }
+  if (!headers[NGROK_SKIP_BROWSER_WARNING]) {
+    headers[NGROK_SKIP_BROWSER_WARNING] = "true";
+  }
   return headers;
 }
 var RAG_IMAGE_REGEX = /\/api\/rag\/chunks\/[^"'\s]+\/image/;
@@ -1068,6 +1073,81 @@ function createCancelledMessageUpdate(steps, currentMessage) {
     currentMessage: currentMessage || "Thinking..."
   };
 }
+var DEFAULT_SIGNED_URL_ENDPOINT = "/api/files/signed-url";
+function fileExtension(filename) {
+  const ext = filename.split(".").pop()?.toLowerCase().replace(/^\./, "");
+  return ext && ext.length > 0 ? ext : "bin";
+}
+function resolveMimeType(file) {
+  if (file.type && file.type.trim().length > 0) return file.type;
+  const ext = fileExtension(file.name);
+  const byExt = {
+    pdf: "application/pdf",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp"
+  };
+  return byExt[ext] ?? "application/octet-stream";
+}
+function buildSignedUrlEndpoint(config, ext) {
+  const endpoint = config.api.signedUrlEndpoint || DEFAULT_SIGNED_URL_ENDPOINT;
+  const queryParams = new URLSearchParams({ extn: ext.replace(/^\./, "") });
+  return `${config.api.baseUrl}${endpoint}?${queryParams.toString()}`;
+}
+async function requestSignedUrl(config, ext, signal) {
+  const url = buildSignedUrlEndpoint(config, ext);
+  const headers = buildRequestHeaders(config);
+  const response = await fetch(url, {
+    method: "GET",
+    headers,
+    signal
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "");
+    throw new Error(
+      errorText ? `Failed to get upload URL (${response.status}): ${errorText}` : `Failed to get upload URL (${response.status})`
+    );
+  }
+  const data = await response.json();
+  if (!data.key || !data.url) {
+    throw new Error("Signed URL response missing key or url");
+  }
+  return { key: data.key, url: data.url };
+}
+async function uploadToSignedUrl(signedUrl, file, mimeType, signal) {
+  const response = await fetch(signedUrl, {
+    method: "PUT",
+    headers: {
+      "Content-Type": mimeType,
+      "x-ms-blob-type": "BlockBlob"
+    },
+    body: file,
+    signal
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "");
+    throw new Error(
+      errorText ? `Failed to upload file (${response.status}): ${errorText}` : `Failed to upload file (${response.status})`
+    );
+  }
+}
+async function uploadAttachment(config, file, signal) {
+  const ext = fileExtension(file.name);
+  const mimeType = resolveMimeType(file);
+  const { key, url } = await requestSignedUrl(config, ext, signal);
+  await uploadToSignedUrl(url, file, mimeType, signal);
+  return {
+    tempKey: key,
+    filename: file.name,
+    mimeType
+  };
+}
+async function uploadAttachments(config, files, signal) {
+  const uploads = files.map((file) => uploadAttachment(config, file, signal));
+  return Promise.all(uploads);
+}
 var UserActionStaleError = class extends Error {
   constructor(userActionId, message = "User action is no longer actionable") {
     super(message);
@@ -1104,9 +1184,6 @@ async function cancelUserAction(config, userActionId) {
 async function resendUserAction(config, userActionId) {
   return sendUserActionRequest(config, userActionId, "resend");
 }
-async function expireUserAction(config, userActionId) {
-  return sendUserActionRequest(config, userActionId, "expired");
-}
 var EMPTY_USER_ACTION_STATE = { prompts: [], notifications: [] };
 function upsertPrompt(prompts, req) {
   const active = { ...req, status: "pending" };
@@ -1135,12 +1212,32 @@ function getStoredOrInitialMessages(config) {
 function getSessionIdFromMessages(messages) {
   return messages.find((message) => message.sessionId)?.sessionId;
 }
+var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set(["jpg", "jpeg", "png", "gif", "webp", "avif"]);
+function attachmentKindFromFile(file) {
+  const ext = file.name.split(".").pop()?.toLowerCase() ?? "";
+  if (IMAGE_EXTENSIONS.has(ext) || file.type.startsWith("image/")) return "image";
+  return "file";
+}
+function buildMessageAttachments(files) {
+  return files.map((file, index) => {
+    const kind = attachmentKindFromFile(file);
+    return {
+      id: `att-${Date.now()}-${index}`,
+      filename: file.name,
+      mimeType: file.type || "application/octet-stream",
+      // Blob URL for all local files so PDFs/docs stay previewable after send.
+      previewUrl: URL.createObjectURL(file),
+      kind
+    };
+  });
+}
 function useChatV2(config, callbacks = {}) {
   const [messages, setMessages] = react.useState(() => getStoredOrInitialMessages(config));
   const [isWaitingForResponse, setIsWaitingForResponse] = react.useState(() => {
     if (!config.userId) return false;
     return activeStreamStore.get(config.userId)?.isWaiting ?? false;
   });
+  const [isUploadingAttachments, setIsUploadingAttachments] = react.useState(false);
   const sessionIdRef = react.useRef(
     getSessionIdFromMessages(getStoredOrInitialMessages(config)) ?? config.initialSessionId ?? void 0
   );
@@ -1215,21 +1312,45 @@ function useChatV2(config, callbacks = {}) {
   );
   const sendMessage = react.useCallback(
     async (userMessage, options) => {
-      if (!userMessage.trim()) return;
+      const trimmedMessage = userMessage.trim();
+      const files = options?.files ?? [];
+      const hasPreuploadedAttachments = (options?.attachments?.length ?? 0) > 0;
+      if (!trimmedMessage && files.length === 0 && !hasPreuploadedAttachments) return;
+      let streamAttachments = options?.attachments;
+      if (!streamAttachments && files.length > 0) {
+        setIsUploadingAttachments(true);
+        try {
+          streamAttachments = await uploadAttachments(configRef.current, files);
+        } catch (error) {
+          if (error.name !== "AbortError") {
+            callbacksRef.current.onError?.(error);
+          }
+          throw error;
+        } finally {
+          setIsUploadingAttachments(false);
+        }
+      }
       if (!sessionIdRef.current && configRef.current.autoGenerateSessionId !== false) {
         sessionIdRef.current = generateId();
         callbacksRef.current.onSessionIdChange?.(sessionIdRef.current);
       }
+      const messageAttachments = files.length > 0 ? buildMessageAttachments(files) : streamAttachments?.length ? streamAttachments.map((attachment, index) => ({
+        id: `att-${Date.now()}-${index}`,
+        filename: attachment.filename,
+        mimeType: attachment.mimeType,
+        kind: attachment.mimeType.startsWith("image/") ? "image" : "file"
+      })) : void 0;
       const userMessageId = `user-${Date.now()}`;
       const userMsg = {
         id: userMessageId,
         sessionId: sessionIdRef.current,
         role: "user",
-        content: userMessage,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        content: trimmedMessage,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        attachments: messageAttachments
       };
       setMessages((prev) => [...prev, userMsg]);
-      callbacksRef.current.onMessageSent?.(userMessage);
+      callbacksRef.current.onMessageSent?.(trimmedMessage);
       setIsWaitingForResponse(true);
       callbacksRef.current.onStreamStart?.();
       const streamingId = `assistant-${Date.now()}`;
@@ -1256,11 +1377,14 @@ function useChatV2(config, callbacks = {}) {
         activeStreamStore.start(userId, abortController, initialMessages);
       }
       const newSessionId = await startStream(
-        userMessage,
+        trimmedMessage,
         streamingId,
         sessionIdRef.current,
         abortController,
-        options
+        {
+          analysisMode: options?.analysisMode,
+          attachments: streamAttachments
+        }
       );
       const finalStreamUserId = streamUserIdRef.current ?? userId;
       if (finalStreamUserId) {
@@ -1398,19 +1522,6 @@ function useChatV2(config, callbacks = {}) {
     },
     [setPromptStatus]
   );
-  const expireUserAction2 = react.useCallback(
-    async (userActionId) => {
-      setPromptStatus(userActionId, "expired");
-      try {
-        await expireUserAction(configRef.current, userActionId);
-      } catch (error) {
-        if (error instanceof UserActionStaleError) return;
-        callbacksRef.current.onError?.(error);
-        throw error;
-      }
-    },
-    [setPromptStatus]
-  );
   const dismissNotification = react.useCallback((id) => {
     setUserActionState((prev) => ({
       ...prev,
@@ -1451,6 +1562,18 @@ function useChatV2(config, callbacks = {}) {
     setMessages(config.initialMessages);
     sessionIdRef.current = getSessionIdFromMessages(config.initialMessages) ?? config.initialSessionId;
   }, [config.initialMessages, config.initialSessionId, config.userId]);
+  const hydratedSessionIdRef = react.useRef(void 0);
+  react.useEffect(() => {
+    if (config.userId) return;
+    if (!config.initialMessages?.length) return;
+    const sessionId = config.initialSessionId;
+    if (hydratedSessionIdRef.current === sessionId && messagesRef.current.length > 0) {
+      return;
+    }
+    hydratedSessionIdRef.current = sessionId;
+    setMessages(config.initialMessages);
+    sessionIdRef.current = getSessionIdFromMessages(config.initialMessages) ?? sessionId;
+  }, [config.initialMessages, config.initialSessionId, config.userId]);
   react.useEffect(() => {
     const prevUserId = prevUserIdRef.current;
     prevUserIdRef.current = config.userId;
@@ -1485,12 +1608,12 @@ function useChatV2(config, callbacks = {}) {
     getSessionId,
     getMessages,
     isWaitingForResponse,
+    isUploadingAttachments,
     sessionId: sessionIdRef.current,
     userActionState,
     submitUserAction: submitUserAction2,
     cancelUserAction: cancelUserAction2,
     resendUserAction: resendUserAction2,
-    expireUserAction: expireUserAction2,
     dismissNotification
   };
 }
@@ -6140,7 +6263,7 @@ var PaymanChatInner = react.forwardRef(function PaymanChatInner2({
   const submitUserAction2 = chat.submitUserAction ?? NOOP_ASYNC;
   const cancelUserAction2 = chat.cancelUserAction ?? NOOP_ASYNC;
   const resendUserAction2 = chat.resendUserAction ?? NOOP_ASYNC;
-  const expireUserAction2 = chat.expireUserAction ?? NOOP_ASYNC;
+  const expireUserAction = chat.expireUserAction ?? NOOP_ASYNC;
   const dismissNotification = chat.dismissNotification ?? NOOP;
   const isUserActionSupported = typeof chat.submitUserAction === "function" && typeof chat.cancelUserAction === "function" && typeof chat.resendUserAction === "function";
   const {
@@ -6541,7 +6664,7 @@ var PaymanChatInner = react.forwardRef(function PaymanChatInner2({
                   onSubmitUserAction: isUserActionSupported ? submitUserAction2 : void 0,
                   onCancelUserAction: isUserActionSupported ? cancelUserAction2 : void 0,
                   onResendUserAction: isUserActionSupported ? resendUserAction2 : void 0,
-                  onExpireUserAction: isUserActionSupported ? expireUserAction2 : void 0,
+                  onExpireUserAction: isUserActionSupported ? expireUserAction : void 0,
                   onDismissNotification: dismissNotification,
                   onSubmitFeedback: handleSubmitFeedback
                 }
@@ -6631,7 +6754,6 @@ exports.UserActionStaleError = UserActionStaleError;
 exports.cancelUserAction = cancelUserAction;
 exports.captureSentryError = captureSentryError;
 exports.cn = cn;
-exports.expireUserAction = expireUserAction;
 exports.formatDate = formatDate;
 exports.resendUserAction = resendUserAction;
 exports.submitUserAction = submitUserAction;