@paymanai/payman-ask-sdk 1.2.22 → 1.2.23

package/dist/index.d.mts

@@ -517,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

@@ -517,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;