@paymanai/payman-ask-sdk 1.2.21 → 1.2.23

package/dist/index.d.mts

@@ -246,6 +246,8 @@ type ChatInputProps = {
     showResetSession?: boolean;
     /** Handler called when the reset session button is clicked */
     onResetSession?: () => void;
+    /** React Native: called when the text input is focused (e.g. to scroll messages above the keyboard). */
+    onInputFocus?: () => void;
 };
 type MessageListProps = {
     /** Messages to display */
@@ -298,6 +300,15 @@ type MessageListProps = {
     isLoadingMoreMessages?: boolean;
     /** Whether there are more messages to load */
     hasMoreMessages?: boolean;
+    /**
+     * React Native: while true, keep scrolling to the end as layout updates (waiting for assistant reply).
+     */
+    isWaitingForResponse?: boolean;
+    /**
+     * React Native: ref to register a no-arg function that scrolls the message list to the end.
+     * Used so the parent can scroll when the input is focused and the keyboard opens.
+     */
+    scrollToEndHandleRef?: React__default.MutableRefObject<(() => void) | null>;
 };
 type MessageRowProps = {
     /** Message to display */
@@ -506,4 +517,23 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function formatDate(timestamp: string | Date): string;
 
-export { type APIConfig, type AgentMessageProps, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type ChunkDisplay, type MessageDisplay, type MessageListProps, type MessageRole, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type SessionParams, type StreamProgress, type StreamingMessageProps, type StreamingStep, type UserActionModalProps, type UserMessageProps, type WorkflowStage, cn, formatDate, usePaymanChat };
+interface ChatSessionContext {
+    sessionId?: string;
+    sessionOwnerId?: string;
+    workflowName?: string;
+    executionId?: string;
+    cfRay?: string;
+    route?: string;
+    customerId?: string;
+    customerEmail?: string;
+}
+/**
+ * Reports an error to Sentry enriched with chat session context.
+ * Tags and context are scoped to this event so they don't leak
+ * to unrelated errors.
+ *
+ * No-op when Sentry is not initialised.
+ */
+declare function captureSentryError(error: Error | string, context: ChatSessionContext): void;
+
+export { type APIConfig, type AgentMessageProps, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type ChatSessionContext, type ChunkDisplay, type MessageDisplay, type MessageListProps, type MessageRole, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type SessionParams, type StreamProgress, type StreamingMessageProps, type StreamingStep, type UserActionModalProps, type UserMessageProps, type WorkflowStage, captureSentryError, cn, formatDate, usePaymanChat };

package/dist/index.d.ts

@@ -246,6 +246,8 @@ type ChatInputProps = {
     showResetSession?: boolean;
     /** Handler called when the reset session button is clicked */
     onResetSession?: () => void;
+    /** React Native: called when the text input is focused (e.g. to scroll messages above the keyboard). */
+    onInputFocus?: () => void;
 };
 type MessageListProps = {
     /** Messages to display */
@@ -298,6 +300,15 @@ type MessageListProps = {
     isLoadingMoreMessages?: boolean;
     /** Whether there are more messages to load */
     hasMoreMessages?: boolean;
+    /**
+     * React Native: while true, keep scrolling to the end as layout updates (waiting for assistant reply).
+     */
+    isWaitingForResponse?: boolean;
+    /**
+     * React Native: ref to register a no-arg function that scrolls the message list to the end.
+     * Used so the parent can scroll when the input is focused and the keyboard opens.
+     */
+    scrollToEndHandleRef?: React__default.MutableRefObject<(() => void) | null>;
 };
 type MessageRowProps = {
     /** Message to display */
@@ -506,4 +517,23 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function formatDate(timestamp: string | Date): string;
 
-export { type APIConfig, type AgentMessageProps, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type ChunkDisplay, type MessageDisplay, type MessageListProps, type MessageRole, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type SessionParams, type StreamProgress, type StreamingMessageProps, type StreamingStep, type UserActionModalProps, type UserMessageProps, type WorkflowStage, cn, formatDate, usePaymanChat };
+interface ChatSessionContext {
+    sessionId?: string;
+    sessionOwnerId?: string;
+    workflowName?: string;
+    executionId?: string;
+    cfRay?: string;
+    route?: string;
+    customerId?: string;
+    customerEmail?: string;
+}
+/**
+ * Reports an error to Sentry enriched with chat session context.
+ * Tags and context are scoped to this event so they don't leak
+ * to unrelated errors.
+ *
+ * No-op when Sentry is not initialised.
+ */
+declare function captureSentryError(error: Error | string, context: ChatSessionContext): void;
+
+export { type APIConfig, type AgentMessageProps, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type ChatSessionContext, type ChunkDisplay, type MessageDisplay, type MessageListProps, type MessageRole, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type SessionParams, type StreamProgress, type StreamingMessageProps, type StreamingStep, type UserActionModalProps, type UserMessageProps, type WorkflowStage, captureSentryError, cn, formatDate, usePaymanChat };

package/dist/index.js

@@ -79,6 +79,114 @@ function formatElapsedTime(ms) {
   if (ms < 1e3) return `${ms}ms`;
   return `${(ms / 1e3).toFixed(1)}s`;
 }
+function captureSentryError(error, context) {
+  if (!Sentry__namespace.getClient()) return;
+  const tags = {};
+  if (context.executionId) tags.executionId = context.executionId;
+  if (context.sessionId) tags.sessionId = context.sessionId;
+  if (context.route) tags.route = context.route;
+  if (context.cfRay) tags.cfRay = context.cfRay;
+  if (context.customerId) tags.customerId = context.customerId;
+  if (context.customerEmail) tags.customerEmail = context.customerEmail;
+  const contexts = {
+    chat_session: {
+      sessionId: context.sessionId ?? null,
+      sessionOwnerId: context.sessionOwnerId ?? null,
+      executionId: context.executionId ?? null,
+      workflowName: context.workflowName ?? null,
+      cfRay: context.cfRay ?? null,
+      customerId: context.customerId ?? null,
+      customerEmail: context.customerEmail ?? null
+    }
+  };
+  if (typeof error === "string") {
+    Sentry__namespace.captureMessage(error, { level: "error", tags, contexts });
+  } else {
+    Sentry__namespace.captureException(error, { tags, contexts });
+  }
+}
+var interceptors = /* @__PURE__ */ new Set();
+var originalFetch = null;
+function patchFetch() {
+  if (originalFetch !== null) return;
+  if (typeof globalThis === "undefined" || typeof globalThis.fetch !== "function")
+    return;
+  originalFetch = globalThis.fetch;
+  globalThis.fetch = async function(input, init2) {
+    const response = await originalFetch.call(this, input, init2);
+    if (interceptors.size > 0) {
+      const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+      try {
+        const cfRay = response.headers.get("cf-ray");
+        if (cfRay) {
+          for (const entry of interceptors) {
+            if (url.includes(entry.urlPattern)) {
+              entry.listener(cfRay);
+            }
+          }
+        }
+      } catch {
+      }
+    }
+    return response;
+  };
+}
+function maybeUnpatchFetch() {
+  if (interceptors.size > 0 || originalFetch === null) return;
+  globalThis.fetch = originalFetch;
+  originalFetch = null;
+}
+function subscribeToCfRay(urlPattern, listener) {
+  const entry = { urlPattern, listener };
+  patchFetch();
+  interceptors.add(entry);
+  return () => {
+    interceptors.delete(entry);
+    maybeUnpatchFetch();
+  };
+}
+
+// src/utils/errorMessages.ts
+var WORKFLOW_FAILED = "WORKFLOW_FAILED";
+var STREAM_NOT_STARTED = "STREAM_NOT_STARTED";
+var HTTP_ERROR_PREFIX = /^HTTP\s+(\d+)\s*:\s*([\s\S]+)$/;
+function isFriendlyWorkflowError(errorDetails) {
+  if (!errorDetails) return false;
+  return errorDetails === WORKFLOW_FAILED || errorDetails === STREAM_NOT_STARTED || errorDetails.includes(WORKFLOW_FAILED);
+}
+function parseErrorPayload(payload) {
+  try {
+    const parsed = JSON.parse(payload);
+    if (typeof parsed === "string") {
+      return { message: parsed.trim() || void 0 };
+    }
+    if (typeof parsed === "object" && parsed !== null) {
+      const record = parsed;
+      return {
+        status: typeof record.status === "number" ? record.status : void 0,
+        message: typeof record.message === "string" && record.message.trim() ? record.message.trim() : void 0
+      };
+    }
+  } catch {
+  }
+  return {};
+}
+function getConflictErrorMessage(errorDetails) {
+  if (!errorDetails) return void 0;
+  const trimmedError = errorDetails.trim();
+  const httpMatch = trimmedError.match(HTTP_ERROR_PREFIX);
+  const httpStatus = httpMatch ? Number(httpMatch[1]) : void 0;
+  const rawPayload = (httpMatch ? httpMatch[2] : trimmedError).trim();
+  const payload = parseErrorPayload(rawPayload);
+  const status = payload.status ?? httpStatus;
+  if (status !== 409) {
+    return void 0;
+  }
+  if (payload.message) {
+    return payload.message;
+  }
+  return rawPayload || void 0;
+}
 function initSentryIfNeeded(dsn) {
   if (!dsn) return;
   if (Sentry__namespace.getClient()) return;
@@ -603,48 +711,6 @@ function createMarkdownComponents(options = {}) {
     td: ({ children }) => /* @__PURE__ */ jsxRuntime.jsx("td", { className: "p-3 align-middle text-sm whitespace-nowrap", children })
   };
 }
-
-// src/utils/errorMessages.ts
-var WORKFLOW_FAILED = "WORKFLOW_FAILED";
-var STREAM_NOT_STARTED = "STREAM_NOT_STARTED";
-var HTTP_ERROR_PREFIX = /^HTTP\s+(\d+)\s*:\s*([\s\S]+)$/;
-function isFriendlyWorkflowError(errorDetails) {
-  if (!errorDetails) return false;
-  return errorDetails === WORKFLOW_FAILED || errorDetails === STREAM_NOT_STARTED || errorDetails.includes(WORKFLOW_FAILED);
-}
-function parseErrorPayload(payload) {
-  try {
-    const parsed = JSON.parse(payload);
-    if (typeof parsed === "string") {
-      return { message: parsed.trim() || void 0 };
-    }
-    if (typeof parsed === "object" && parsed !== null) {
-      const record = parsed;
-      return {
-        status: typeof record.status === "number" ? record.status : void 0,
-        message: typeof record.message === "string" && record.message.trim() ? record.message.trim() : void 0
-      };
-    }
-  } catch {
-  }
-  return {};
-}
-function getConflictErrorMessage(errorDetails) {
-  if (!errorDetails) return void 0;
-  const trimmedError = errorDetails.trim();
-  const httpMatch = trimmedError.match(HTTP_ERROR_PREFIX);
-  const httpStatus = httpMatch ? Number(httpMatch[1]) : void 0;
-  const rawPayload = (httpMatch ? httpMatch[2] : trimmedError).trim();
-  const payload = parseErrorPayload(rawPayload);
-  const status = payload.status ?? httpStatus;
-  if (status !== 409) {
-    return void 0;
-  }
-  if (payload.message) {
-    return payload.message;
-  }
-  return rawPayload || void 0;
-}
 function ThinkingBlock({ text }) {
   const [isOpen, setIsOpen] = react.useState(false);
   const hasContent = typeof text === "string" && text.trim().length > 0;
@@ -2037,7 +2103,75 @@ var PaymanChat = react.forwardRef(function PaymanChat2({
       initSentryIfNeeded(config.sentryDsn);
     }
   }, [config.sentryDsn]);
-  const chat = paymanTypescriptAskSdk.useChat(config, callbacks);
+  const sentryCtxRef = react.useRef({});
+  const callbacksRef = react.useRef(callbacks);
+  callbacksRef.current = callbacks;
+  const initialSessionId = config.initialSessionId;
+  const apiHeaders = config.api.headers;
+  react.useEffect(() => {
+    sentryCtxRef.current.workflowName = config.workflowName;
+    sentryCtxRef.current.sessionOwnerId = config.sessionParams?.id;
+    if (initialSessionId) {
+      sentryCtxRef.current.sessionId = initialSessionId;
+    }
+    if (apiHeaders) {
+      sentryCtxRef.current.customerId = apiHeaders["x-paygent-wf-mcp-customer-id"] ?? sentryCtxRef.current.customerId;
+      sentryCtxRef.current.customerEmail = apiHeaders["x-paygent-wf-mcp-customer-email"] ?? sentryCtxRef.current.customerEmail;
+    }
+  }, [
+    config.workflowName,
+    config.sessionParams?.id,
+    initialSessionId,
+    apiHeaders
+  ]);
+  react.useEffect(() => {
+    const endpoint = config.api.streamEndpoint || "/api/workflows/ask/stream";
+    return subscribeToCfRay(endpoint, (cfRay) => {
+      sentryCtxRef.current.cfRay = cfRay;
+    });
+  }, [config.api.streamEndpoint]);
+  const sentryCallbacks = react.useMemo(
+    () => ({
+      onMessageSent: (msg) => callbacksRef.current.onMessageSent?.(msg),
+      onStreamStart: () => callbacksRef.current.onStreamStart?.(),
+      onStreamComplete: (message) => {
+        if (message.executionId)
+          sentryCtxRef.current.executionId = message.executionId;
+        if (message.sessionId)
+          sentryCtxRef.current.sessionId = message.sessionId;
+        const content = message.content ?? "";
+        const looksLikeRawErr = content.length >= 10 && (content.includes("errorType=") || /failed:\s*\{/.test(content));
+        const completedEmpty = !message.isStreaming && !message.isCancelled && content.length === 0 && (message.streamProgress === "completed" || message.streamProgress === "error");
+        const hasConflict = !!getConflictErrorMessage(message.errorDetails);
+        const hasFriendlyErr = isFriendlyWorkflowError(message.errorDetails);
+        const shouldCapture = message.isError || hasConflict || hasFriendlyErr || looksLikeRawErr || completedEmpty;
+        if (shouldCapture) {
+          sentryCtxRef.current.route = typeof window !== "undefined" ? window.location.pathname : void 0;
+          captureSentryError(
+            `Workflow error: ${message.errorDetails || content || "Unknown error"}`,
+            { ...sentryCtxRef.current }
+          );
+        }
+        callbacksRef.current.onStreamComplete?.(message);
+      },
+      onError: (error) => {
+        sentryCtxRef.current.route = typeof window !== "undefined" ? window.location.pathname : void 0;
+        captureSentryError(error, { ...sentryCtxRef.current });
+        callbacksRef.current.onError?.(error);
+      },
+      onSessionIdChange: (sessionId) => {
+        sentryCtxRef.current.sessionId = sessionId;
+        callbacksRef.current.onSessionIdChange?.(sessionId);
+      },
+      onExecutionTraceClick: (data) => callbacksRef.current.onExecutionTraceClick?.(data),
+      onResetSession: () => callbacksRef.current.onResetSession?.(),
+      onUserActionRequired: (req) => callbacksRef.current.onUserActionRequired?.(req),
+      onUserActionEvent: (evType, msg) => callbacksRef.current.onUserActionEvent?.(evType, msg)
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
+  const chat = paymanTypescriptAskSdk.useChat(config, sentryCallbacks);
   const {
     messages,
     sendMessage,
@@ -2382,6 +2516,7 @@ Object.defineProperty(exports, "useVoice", {
 });
 exports.PaymanChat = PaymanChat;
 exports.PaymanChatContext = PaymanChatContext;
+exports.captureSentryError = captureSentryError;
 exports.cn = cn;
 exports.formatDate = formatDate;
 exports.usePaymanChat = usePaymanChat;