Skip to content

armgit / dify

Public Imported from GitHub
0

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.

47.9 KB
Raw Blame
import type { FetchOptionType } from './fetch'
import type { RequestGuard } from './request-guard'
import type { MessageEnd, MessageReplace, ThoughtItem } from '@/app/components/base/chat/chat/type'
import type { VisionFile } from '@/types/app'
import type {
  DataSourceNodeCompletedResponse,
  DataSourceNodeErrorResponse,
  DataSourceNodeProcessingResponse,
} from '@/types/pipeline'
import type {
  AgentLogResponse,
  HumanInputFormFilledResponse,
  HumanInputFormTimeoutResponse,
  HumanInputRequiredResponse,
  IterationFinishedResponse,
  IterationNextResponse,
  IterationStartedResponse,
  LoopFinishedResponse,
  LoopNextResponse,
  LoopStartedResponse,
  NodeFinishedResponse,
  NodeStartedResponse,
  ParallelBranchFinishedResponse,
  ParallelBranchStartedResponse,
  ReasoningChunkResponse,
  TextChunkResponse,
  TextReplaceResponse,
  WorkflowFinishedResponse,
  WorkflowPausedResponse,
  WorkflowStartedResponse,
} from '@/types/workflow'
import { ORPCError } from '@orpc/client'
import Cookies from 'js-cookie'
import { discardRegistrationSessionState } from '@/app/components/base/amplitude/registration-session-state'
import { toast } from '@/app/notifications'
import {
  API_PREFIX,
  CSRF_COOKIE_NAME,
  CSRF_HEADER_NAME,
  PASSPORT_HEADER_NAME,
  PUBLIC_API_PREFIX,
  WEB_APP_SHARE_CODE_HEADER_NAME,
} from '@/config'
import { asyncRunSafe } from '@/utils'
import { isClient } from '@/utils/client'
import { resolveLoginRedirectTarget } from '@/utils/login-redirect'
import { basePath } from '@/utils/var'
import { base, ContentType, getBaseOptions } from './fetch'
import { httpErrorFromXhr, isHttpErrorStatus, isTransientHttpError } from './http-error'
import { refreshAccessTokenOrReLogin } from './refresh-token'
import { captureRequestGuard } from './request-guard'
import { getWebAppPublicApiPath, resolveWebAppAddress } from './webapp-address'
import {
  beginWebAppAuthorizationRecovery,
  clearWebAppPassport,
  completeWebAppAuthorizationRecovery,
  getWebAppPassport,
} from './webapp-auth'

const TIME_OUT = 100000

const canRecoverWebAppAuthorization = (guard: RequestGuard | undefined) =>
  guard?.isActive() !== false

const isWebAppAuthorizationEndpoint = (url: string) =>
  /\/(?:login(?:\/|\?|$)|passport(?:\?|$))/.test(url)

const recoverEnvironmentWebAppAuthorization = (
  error: { code?: string | number; message?: string; reason?: unknown },
  url?: string,
) => {
  const address = resolveWebAppAddress()
  if (
    address?.kind !== 'environment' ||
    (error.reason !== 'APPDEPLOY_UNAUTHORIZED' && error.code !== 'unauthorized') ||
    (url && isWebAppAuthorizationEndpoint(url))
  )
    return false

  if (!beginWebAppAuthorizationRecovery(address)) {
    requiredWebSSOLogin(error.message, 403)
    return true
  }

  clearWebAppPassport(address)
  window.location.reload()
  return true
}

const handleWebAppAuthorizationError = (
  error: { code?: string | number; message?: string; reason?: unknown },
  url?: string,
) => {
  if (
    error.reason === 'APPDEPLOY_WEB_APP_ACCESS_DENIED' ||
    error.code === 'web_app_access_denied'
  ) {
    requiredWebSSOLogin(error.message, 403)
    return true
  }
  return recoverEnvironmentWebAppAuthorization(error, url)
}

const isAbortError = (error: unknown) => {
  if (typeof error === 'string') return error === 'AbortError' || error.startsWith('AbortError:')

  return (
    typeof error === 'object' && error !== null && 'name' in error && error.name === 'AbortError'
  )
}

const shouldNotifyStreamError = (error: unknown) =>
  !isAbortError(error) && !String(error).includes('TypeError: Cannot assign to read only property')

export type IOnDataMoreInfo = {
  event?: string
  conversationId?: string
  taskId?: string
  messageId: string
  errorMessage?: string
  errorCode?: string
}

export type IOnData = (message: string, isFirstMessage: boolean, moreInfo: IOnDataMoreInfo) => void
type IOnThought = (though: ThoughtItem) => void
type IOnFile = (file: VisionFile) => void
type IOnMessageEnd = (messageEnd: MessageEnd) => void
export type IOnMessageReplace = (messageReplace: MessageReplace) => void
export type IOnCompleted = (hasError?: boolean, errorMessage?: string) => void
export type IOnError = (msg: string, code?: string, identity?: IOnDataMoreInfo) => void

const reportStreamResponseError = async (
  response: Response,
  onError: IOnError | undefined,
  onNotifyError?: IOnError,
) => {
  let errorMessage = 'Server Error'
  let errorCode: string | undefined
  try {
    const data: unknown = await response.json()
    if (typeof data === 'object' && data !== null && 'message' in data) {
      const message = data.message
      if (typeof message === 'string' && message) errorMessage = message
    }
    if (typeof data === 'object' && data !== null && 'code' in data) {
      const code = data.code
      if (typeof code === 'string' && code) errorCode = code
    }
  } catch {}

  if (errorCode) {
    onError?.(errorMessage, errorCode)
    onNotifyError?.(errorMessage, errorCode)
  } else {
    onError?.(errorMessage)
    onNotifyError?.(errorMessage)
  }
}

const handleGuardedStreamResponseError = async (
  response: Response,
  guard: RequestGuard | undefined,
  onError: IOnError | undefined,
  onCompleted: IOnCompleted | undefined,
) => {
  if (!guard) return false
  const data = await response
    .clone()
    .json()
    .catch(() => undefined)
  if (!guard.handleError(response.status, data, response) && canRecoverWebAppAuthorization(guard))
    return false
  const message =
    typeof data?.message === 'string' ? data.message : 'The request is no longer active.'
  if (onError) onError(message, typeof data?.code === 'string' ? data.code : undefined)
  else onCompleted?.(true, message)
  return true
}

const handlePublicStreamResponseError = async (
  response: Response,
  onError: IOnError | undefined,
  onNotifyError: IOnError | undefined,
  silent: boolean | undefined,
  requestGuard: RequestGuard | undefined,
  onCompleted: IOnCompleted | undefined,
) => {
  let data: { code?: string; message?: string; reason?: unknown } | undefined
  try {
    data = (await response.clone().json()) as typeof data
  } catch {}

  if (data && requestGuard?.handleError(response.status, data, response)) {
    const message = data.message || 'Server Error'
    if (onError) onError(message, data.code)
    else onCompleted?.(true, message)
    return
  }
  if (!canRecoverWebAppAuthorization(requestGuard)) {
    const message = data?.message || 'Server Error'
    if (onError) onError(message, typeof data?.code === 'string' ? data.code : undefined)
    else onCompleted?.(true, message)
    return
  }
  if (data) {
    if (handleWebAppAuthorizationError(data)) return
    if (data.code === 'web_sso_auth_required' || data.code === 'unauthorized') {
      requiredWebSSOLogin()
      return
    }
  }

  if (onNotifyError && !silent) await reportStreamResponseError(response, onError, onNotifyError)
  else if (!silent)
    await reportStreamResponseError(response, onError, (message) => toast.error(message))
  else await reportStreamResponseError(response, onError)
}

type UnhandledEventError = {
  conversationId?: string
  errorCode?: string
  errorMessage: string
  messageId?: string
}
type IOnUnhandledEvent = (event: Record<string, unknown>) => UnhandledEventError | void

type IOnWorkflowStarted = (workflowStarted: WorkflowStartedResponse) => void
type IOnWorkflowFinished = (workflowFinished: WorkflowFinishedResponse) => void
type IOnNodeStarted = (nodeStarted: NodeStartedResponse) => void
type IOnNodeFinished = (nodeFinished: NodeFinishedResponse) => void
type IOnIterationStarted = (workflowStarted: IterationStartedResponse) => void
type IOnIterationNext = (workflowStarted: IterationNextResponse) => void
type IOnNodeRetry = (nodeFinished: NodeFinishedResponse) => void
type IOnIterationFinished = (workflowFinished: IterationFinishedResponse) => void
type IOnParallelBranchStarted = (parallelBranchStarted: ParallelBranchStartedResponse) => void
type IOnParallelBranchFinished = (parallelBranchFinished: ParallelBranchFinishedResponse) => void
type IOnTextChunk = (textChunk: TextChunkResponse) => void
type IOnReasoning = (reasoningChunk: ReasoningChunkResponse) => void
type IOnTTSChunk = (messageId: string, audioStr: string, audioType?: string) => void
type IOnTTSEnd = (messageId: string, audioStr: string) => void
type IOnTextReplace = (textReplace: TextReplaceResponse) => void
type IOnLoopStarted = (workflowStarted: LoopStartedResponse) => void
type IOnLoopNext = (workflowStarted: LoopNextResponse) => void
type IOnLoopFinished = (workflowFinished: LoopFinishedResponse) => void
type IOnAgentLog = (agentLog: AgentLogResponse) => void

type IOHumanInputRequired = (humanInputRequired: HumanInputRequiredResponse) => void
type IOnHumanInputFormFilled = (humanInputFormFilled: HumanInputFormFilledResponse) => void
type IOnHumanInputFormTimeout = (humanInputFormTimeout: HumanInputFormTimeoutResponse) => void
type IOWorkflowPaused = (workflowPaused: WorkflowPausedResponse) => void
type IOnDataSourceNodeProcessing = (
  dataSourceNodeProcessing: DataSourceNodeProcessingResponse,
) => void
type IOnDataSourceNodeCompleted = (dataSourceNodeCompleted: DataSourceNodeCompletedResponse) => void
type IOnDataSourceNodeError = (dataSourceNodeError: DataSourceNodeErrorResponse) => void

export type IOtherOptions = {
  isPublicAPI?: boolean
  isMarketplaceAPI?: boolean
  bodyStringify?: boolean
  needAllResponseContent?: boolean
  deleteContentType?: boolean
  silent?: boolean

  /** If true, behaves like standard fetch: no URL prefix, returns raw Response */
  fetchCompat?: boolean
  request?: Request

  onData?: IOnData // for stream
  onReasoning?: IOnReasoning
  onThought?: IOnThought
  onFile?: IOnFile
  onMessageEnd?: IOnMessageEnd
  onMessageReplace?: IOnMessageReplace
  onError?: IOnError
  /** Replaces the default global error notification for this request. */
  onNotifyError?: IOnError
  onUnhandledEvent?: IOnUnhandledEvent
  onCompleted?: IOnCompleted // for stream
  getAbortController?: (abortController: AbortController) => void

  onWorkflowStarted?: IOnWorkflowStarted
  onWorkflowFinished?: IOnWorkflowFinished
  onNodeStarted?: IOnNodeStarted
  onNodeFinished?: IOnNodeFinished
  onIterationStart?: IOnIterationStarted
  onIterationNext?: IOnIterationNext
  onIterationFinish?: IOnIterationFinished
  onNodeRetry?: IOnNodeRetry
  onParallelBranchStarted?: IOnParallelBranchStarted
  onParallelBranchFinished?: IOnParallelBranchFinished
  onTextChunk?: IOnTextChunk
  onTTSChunk?: IOnTTSChunk
  onTTSEnd?: IOnTTSEnd
  onTextReplace?: IOnTextReplace
  onLoopStart?: IOnLoopStarted
  onLoopNext?: IOnLoopNext
  onLoopFinish?: IOnLoopFinished
  onAgentLog?: IOnAgentLog
  onHumanInputRequired?: IOHumanInputRequired
  onHumanInputFormFilled?: IOnHumanInputFormFilled
  onHumanInputFormTimeout?: IOnHumanInputFormTimeout
  onWorkflowPaused?: IOWorkflowPaused

  // Pipeline data source node run
  onDataSourceNodeProcessing?: IOnDataSourceNodeProcessing
  onDataSourceNodeCompleted?: IOnDataSourceNodeCompleted
  onDataSourceNodeError?: IOnDataSourceNodeError
}

const discardRegistrationStateForConsoleAuthBoundary = ({
  isMarketplaceAPI,
  isPublicAPI,
}: IOtherOptions) => {
  if (isMarketplaceAPI || isPublicAPI) return
  discardRegistrationSessionState()
}

function jumpTo(url: string) {
  if (!url || !isClient) return
  const targetPath = new URL(url, window.location.origin).pathname
  if (targetPath === window.location.pathname) return
  window.location.href = url
}

const OAUTH_AUTHORIZE_PATH = '/account/oauth/authorize'
const SIGNIN_PATH = '/signin'

export const buildSigninUrlWithRedirect = (): string => {
  const loginUrl = `${isClient ? window.location.origin : ''}${basePath}/signin`
  if (!isClient) return loginUrl

  const signinPath = `${basePath}${SIGNIN_PATH}`
  if (window.location.pathname === signinPath || window.location.pathname === `${signinPath}/`)
    return loginUrl

  if (window.location.pathname.includes(OAUTH_AUTHORIZE_PATH)) {
    const currentUrl = window.location.href
    return `${loginUrl}?redirect_url=${encodeURIComponent(currentUrl)}`
  }

  const currentTarget = resolveLoginRedirectTarget(
    `${window.location.pathname}${window.location.search}${window.location.hash}`,
    { allowSameOriginAbsolute: false },
  )
  if (!currentTarget || currentTarget.kind !== 'internal') return loginUrl

  return `${loginUrl}?redirect_url=${encodeURIComponent(currentTarget.href)}`
}

function unicodeToChar(text: string) {
  if (!text) return ''

  return text.replace(/\\u([0-9a-f]{4})/gi, (_match, p1) => {
    return String.fromCharCode(Number.parseInt(p1, 16))
  })
}

const WBB_APP_LOGIN_PATH = '/webapp-signin'

export function isWebAppSigninPath(pathname: string) {
  const basePathSegment = basePath.replace(/^\/+|\/+$/g, '')
  const signinPath = `${basePathSegment ? `/${basePathSegment}` : ''}${WBB_APP_LOGIN_PATH}`
  return pathname === signinPath || pathname === `${signinPath}/`
}

export function buildWebAppSigninUrlWithRedirect(
  origin: string,
  pathname: string,
  search: string,
  message?: string,
  code?: number,
) {
  const params = new URLSearchParams()
  params.set('redirect_url', `${pathname}${search}`)
  if (message) params.set('message', message)
  if (code) params.set('code', String(code))

  return `${origin}${basePath}${WBB_APP_LOGIN_PATH}?${params.toString()}`
}

function requiredWebSSOLogin(message?: string, code?: number) {
  if (!isClient) return

  // prevent redirect loop
  if (isWebAppSigninPath(window.location.pathname)) return

  window.location.href = buildWebAppSigninUrlWithRedirect(
    window.location.origin,
    window.location.pathname,
    window.location.search,
    message,
    code,
  )
}

function formatURL(url: string, isPublicAPI: boolean) {
  let urlPrefix = API_PREFIX
  if (isPublicAPI) urlPrefix = PUBLIC_API_PREFIX
  if (url.startsWith('http://') || url.startsWith('https://')) return url
  const urlWithoutProtocol = isPublicAPI
    ? getWebAppPublicApiPath(resolveWebAppAddress(), url)
    : url.startsWith('/')
      ? url
      : `/${url}`
  return `${urlPrefix}${urlWithoutProtocol}`
}

export const handleStream = (
  response: Response,
  onData: IOnData,
  onCompleted?: IOnCompleted,
  onThought?: IOnThought,
  onMessageEnd?: IOnMessageEnd,
  onMessageReplace?: IOnMessageReplace,
  onFile?: IOnFile,
  onWorkflowStarted?: IOnWorkflowStarted,
  onWorkflowFinished?: IOnWorkflowFinished,
  onNodeStarted?: IOnNodeStarted,
  onNodeFinished?: IOnNodeFinished,
  onIterationStart?: IOnIterationStarted,
  onIterationNext?: IOnIterationNext,
  onIterationFinish?: IOnIterationFinished,
  onLoopStart?: IOnLoopStarted,
  onLoopNext?: IOnLoopNext,
  onLoopFinish?: IOnLoopFinished,
  onNodeRetry?: IOnNodeRetry,
  onParallelBranchStarted?: IOnParallelBranchStarted,
  onParallelBranchFinished?: IOnParallelBranchFinished,
  onTextChunk?: IOnTextChunk,
  onTTSChunk?: IOnTTSChunk,
  onTTSEnd?: IOnTTSEnd,
  onTextReplace?: IOnTextReplace,
  onAgentLog?: IOnAgentLog,
  onHumanInputRequired?: IOHumanInputRequired,
  onHumanInputFormFilled?: IOnHumanInputFormFilled,
  onHumanInputFormTimeout?: IOnHumanInputFormTimeout,
  onWorkflowPaused?: IOWorkflowPaused,
  onDataSourceNodeProcessing?: IOnDataSourceNodeProcessing,
  onDataSourceNodeCompleted?: IOnDataSourceNodeCompleted,
  onDataSourceNodeError?: IOnDataSourceNodeError,
  onReasoning?: IOnReasoning,
  onUnhandledEvent?: IOnUnhandledEvent,
) => {
  if (!response.ok) throw new Error('Network response was not ok')

  const reader = response.body?.getReader()
  const decoder = new TextDecoder('utf-8')
  let buffer = ''
  let bufferObj: Record<string, any>
  let isFirstMessage = true
  const completeWithError = (errorMessage: string, errorCode?: string) => {
    onData('', false, {
      conversationId: bufferObj?.conversation_id,
      messageId: bufferObj?.message_id ?? '',
      errorMessage,
      errorCode,
    })
    onCompleted?.(true, errorMessage)
  }

  function read() {
    let hasError = false
    reader?.read().then(
      (result: ReadableStreamReadResult<Uint8Array>) => {
        if (result.done) {
          onCompleted?.()
          return
        }
        buffer += decoder.decode(result.value, { stream: true })
        const lines = buffer.split('\n')
        buffer = lines.pop() ?? ''
        try {
          lines.forEach((message) => {
            if (hasError) return
            if (message.startsWith('data: ')) {
              // check if it starts with data:
              try {
                bufferObj = JSON.parse(message.substring(6)) as Record<string, any> // remove data: and parse as json
              } catch {
                // mute handle message cut off
                onData('', isFirstMessage, {
                  conversationId: bufferObj?.conversation_id,
                  messageId: bufferObj?.message_id,
                })
                return
              }
              if (!bufferObj || typeof bufferObj !== 'object') {
                onData('', isFirstMessage, {
                  conversationId: undefined,
                  messageId: '',
                  errorMessage: 'Invalid response data',
                  errorCode: 'invalid_data',
                })
                hasError = true
                onCompleted?.(true, 'Invalid response data')
                return
              }
              const hasErrorStatus = typeof bufferObj.status === 'number' && bufferObj.status >= 400
              if (bufferObj.event === 'error' || hasErrorStatus || !bufferObj.event) {
                onData('', false, {
                  conversationId: bufferObj.conversation_id,
                  messageId: bufferObj.message_id ?? '',
                  errorMessage: bufferObj?.message,
                  errorCode: bufferObj?.code,
                })
                hasError = true
                onCompleted?.(true, bufferObj?.message)
                return
              }
              if (bufferObj.event === 'message' || bufferObj.event === 'agent_message') {
                // can not use format here. Because message is splitted.
                onData(unicodeToChar(bufferObj.answer), isFirstMessage, {
                  event: bufferObj.event,
                  conversationId: bufferObj.conversation_id,
                  taskId: bufferObj.task_id,
                  messageId: bufferObj.id,
                })
                isFirstMessage = false
              } else if (bufferObj.event === 'agent_thought') {
                onThought?.(bufferObj as ThoughtItem)
              } else if (bufferObj.event === 'message_file') {
                onFile?.(bufferObj as VisionFile)
              } else if (bufferObj.event === 'message_end') {
                onMessageEnd?.(bufferObj as MessageEnd)
              } else if (bufferObj.event === 'message_replace') {
                onMessageReplace?.(bufferObj as MessageReplace)
              } else if (bufferObj.event === 'workflow_started') {
                onWorkflowStarted?.(bufferObj as WorkflowStartedResponse)
              } else if (bufferObj.event === 'workflow_finished') {
                onWorkflowFinished?.(bufferObj as WorkflowFinishedResponse)
              } else if (bufferObj.event === 'node_started') {
                onNodeStarted?.(bufferObj as NodeStartedResponse)
              } else if (bufferObj.event === 'node_finished') {
                onNodeFinished?.(bufferObj as NodeFinishedResponse)
              } else if (bufferObj.event === 'iteration_started') {
                onIterationStart?.(bufferObj as IterationStartedResponse)
              } else if (bufferObj.event === 'iteration_next') {
                onIterationNext?.(bufferObj as IterationNextResponse)
              } else if (bufferObj.event === 'iteration_completed') {
                onIterationFinish?.(bufferObj as IterationFinishedResponse)
              } else if (bufferObj.event === 'loop_started') {
                onLoopStart?.(bufferObj as LoopStartedResponse)
              } else if (bufferObj.event === 'loop_next') {
                onLoopNext?.(bufferObj as LoopNextResponse)
              } else if (bufferObj.event === 'loop_completed') {
                onLoopFinish?.(bufferObj as LoopFinishedResponse)
              } else if (bufferObj.event === 'node_retry') {
                onNodeRetry?.(bufferObj as NodeFinishedResponse)
              } else if (bufferObj.event === 'parallel_branch_started') {
                onParallelBranchStarted?.(bufferObj as ParallelBranchStartedResponse)
              } else if (bufferObj.event === 'parallel_branch_finished') {
                onParallelBranchFinished?.(bufferObj as ParallelBranchFinishedResponse)
              } else if (bufferObj.event === 'text_chunk') {
                onTextChunk?.(bufferObj as TextChunkResponse)
              } else if (bufferObj.event === 'reasoning_chunk') {
                onReasoning?.(bufferObj as ReasoningChunkResponse)
              } else if (bufferObj.event === 'text_replace') {
                onTextReplace?.(bufferObj as TextReplaceResponse)
              } else if (bufferObj.event === 'agent_log') {
                onAgentLog?.(bufferObj as AgentLogResponse)
              } else if (bufferObj.event === 'tts_message') {
                onTTSChunk?.(bufferObj.message_id, bufferObj.audio, bufferObj.audio_type)
              } else if (bufferObj.event === 'tts_message_end') {
                onTTSEnd?.(bufferObj.message_id, bufferObj.audio)
              } else if (bufferObj.event === 'human_input_required') {
                onHumanInputRequired?.(bufferObj as HumanInputRequiredResponse)
              } else if (bufferObj.event === 'human_input_form_filled') {
                onHumanInputFormFilled?.(bufferObj as HumanInputFormFilledResponse)
              } else if (bufferObj.event === 'human_input_form_timeout') {
                onHumanInputFormTimeout?.(bufferObj as HumanInputFormTimeoutResponse)
              } else if (bufferObj.event === 'workflow_paused') {
                onWorkflowPaused?.(bufferObj as WorkflowPausedResponse)
              } else if (bufferObj.event === 'datasource_processing') {
                onDataSourceNodeProcessing?.(bufferObj as DataSourceNodeProcessingResponse)
              } else if (bufferObj.event === 'datasource_completed') {
                onDataSourceNodeCompleted?.(bufferObj as DataSourceNodeCompletedResponse)
              } else if (bufferObj.event === 'datasource_error') {
                onDataSourceNodeError?.(bufferObj as DataSourceNodeErrorResponse)
              } else {
                const unhandledEventError = onUnhandledEvent?.(bufferObj)
                if (unhandledEventError) {
                  onData('', false, {
                    conversationId: unhandledEventError.conversationId,
                    messageId: unhandledEventError.messageId ?? '',
                    errorMessage: unhandledEventError.errorMessage,
                    errorCode: unhandledEventError.errorCode,
                  })
                  hasError = true
                  onCompleted?.(true, unhandledEventError.errorMessage)
                  return
                }
                console.warn(`Unknown event: ${bufferObj.event}`, bufferObj)
              }
            }
          })
        } catch (e) {
          onData('', false, {
            conversationId: undefined,
            messageId: '',
            errorMessage: `${e}`,
          })
          hasError = true
          onCompleted?.(true, e as string)
          return
        }
        if (!hasError) read()
      },
      (e: unknown) => {
        completeWithError(String(e), 'stream_read_error')
      },
    )
  }
  read()
}

const baseFetch = base

type UploadOptions = {
  xhr: XMLHttpRequest
  method?: string
  url?: string
  headers?: Record<string, string>
  data: FormData
  onprogress?: (this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => void
}

type UploadResponse = {
  id: string
  [key: string]: unknown
}

/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const upload = async (
  options: UploadOptions,
  isPublicAPI?: boolean,
  url?: string,
  searchParams?: string,
): Promise<UploadResponse> => {
  const requestGuard = captureRequestGuard(
    options.url || url || '/files/upload',
    isPublicAPI,
    options.method || 'POST',
  )
  requestGuard?.beforeRequest()
  const address = resolveWebAppAddress()
  const shareCode = address?.code
  const publicApiPrefix = PUBLIC_API_PREFIX
  const urlPrefix = isPublicAPI ? publicApiPrefix : API_PREFIX
  const defaultOptions = {
    method: 'POST',
    url:
      (url
        ? `${urlPrefix}${isPublicAPI ? getWebAppPublicApiPath(address, url) : url}`
        : `${urlPrefix}${isPublicAPI ? getWebAppPublicApiPath(address, '/files/upload') : '/files/upload'}`) +
      (searchParams || ''),
    headers: {
      [CSRF_HEADER_NAME]: Cookies.get(CSRF_COOKIE_NAME()) || '',
      [PASSPORT_HEADER_NAME]: getWebAppPassport(address),
      [WEB_APP_SHARE_CODE_HEADER_NAME]: shareCode || '',
    },
  }
  const mergedOptions = {
    ...defaultOptions,
    ...options,
    url: options.url || defaultOptions.url,
    headers: { ...defaultOptions.headers, ...options.headers } as Record<string, string>,
  }
  return new Promise((resolve, reject) => {
    const xhr = mergedOptions.xhr
    xhr.open(mergedOptions.method, mergedOptions.url)
    for (const key in mergedOptions.headers) xhr.setRequestHeader(key, mergedOptions.headers[key]!)

    xhr.withCredentials = true
    xhr.responseType = 'json'
    xhr.onreadystatechange = function () {
      if (xhr.readyState === 4 && xhr.status !== 0) {
        if (!isHttpErrorStatus(xhr.status)) resolve(xhr.response)
        else {
          const error = httpErrorFromXhr(xhr)
          if (requestGuard?.handleError(xhr.status, xhr.response, error)) {
            reject(error)
            return
          }
          if (isPublicAPI && !canRecoverWebAppAuthorization(requestGuard)) {
            reject(new DOMException('The upload is no longer active.', 'AbortError'))
            return
          }
          if (
            isPublicAPI &&
            (xhr.status === 401 || xhr.status === 403) &&
            typeof xhr.response === 'object' &&
            xhr.response !== null
          )
            handleWebAppAuthorizationError(xhr.response)
          reject(error)
        }
      }
    }
    xhr.onerror = () => reject(new TypeError('Failed to fetch'))
    xhr.onabort = () => reject(new DOMException('The operation was aborted.', 'AbortError'))
    xhr.ontimeout = () => reject(new DOMException('The operation timed out.', 'TimeoutError'))
    if (mergedOptions.onprogress) xhr.upload.onprogress = mergedOptions.onprogress
    xhr.send(mergedOptions.data)
  })
}

/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const ssePost = async (
  url: string,
  fetchOptions: FetchOptionType,
  otherOptions: IOtherOptions,
) => {
  const {
    isPublicAPI = false,
    onData,
    onReasoning,
    onCompleted,
    onThought,
    onFile,
    onMessageEnd,
    onMessageReplace,
    onWorkflowStarted,
    onWorkflowFinished,
    onNodeStarted,
    onNodeFinished,
    onIterationStart,
    onIterationNext,
    onIterationFinish,
    onNodeRetry,
    onParallelBranchStarted,
    onParallelBranchFinished,
    onTextChunk,
    onTTSChunk,
    onTTSEnd,
    onTextReplace,
    onAgentLog,
    onError,
    onNotifyError,
    getAbortController,
    onLoopStart,
    onLoopNext,
    onLoopFinish,
    onHumanInputRequired,
    onHumanInputFormFilled,
    onHumanInputFormTimeout,
    onWorkflowPaused,
    onDataSourceNodeProcessing,
    onDataSourceNodeCompleted,
    onDataSourceNodeError,
    onUnhandledEvent,
    silent,
  } = otherOptions
  const requestGuard = captureRequestGuard(url, isPublicAPI, 'POST')
  if (requestGuard?.isActive() === false) {
    onCompleted?.(true, 'The request is no longer active.')
    return
  }
  const abortController = new AbortController()

  // No need to get token from localStorage, cookies will be sent automatically

  const baseOptions = getBaseOptions()
  const shareCode = resolveWebAppAddress()?.code
  const options = Object.assign(
    {},
    baseOptions,
    {
      method: 'POST',
      signal: abortController.signal,
      headers: new Headers({
        [CSRF_HEADER_NAME]: Cookies.get(CSRF_COOKIE_NAME())! || '',
        [WEB_APP_SHARE_CODE_HEADER_NAME]: shareCode || '',
        [PASSPORT_HEADER_NAME]: getWebAppPassport(resolveWebAppAddress()),
      }),
    } as RequestInit,
    fetchOptions,
  )
  options.headers = new Headers(options.headers)

  const contentType = options.headers.get('Content-Type')
  if (!contentType) options.headers.set('Content-Type', ContentType.json)

  getAbortController?.(abortController)

  const urlWithPrefix = formatURL(url, isPublicAPI)

  const { body } = options
  if (body) options.body = JSON.stringify(body)

  globalThis
    .fetch(urlWithPrefix, options as RequestInit)
    .then(async (res) => {
      if (!/^[23]\d{2}$/.test(String(res.status))) {
        if (await handleGuardedStreamResponseError(res, requestGuard, onError, onCompleted)) return
        if (res.status === 401 || (res.status === 403 && isPublicAPI)) {
          if (isPublicAPI) {
            void handlePublicStreamResponseError(
              res,
              onError,
              onNotifyError,
              silent,
              requestGuard,
              onCompleted,
            )
          } else {
            refreshAccessTokenOrReLogin(TIME_OUT)
              .then(() => {
                ssePost(url, fetchOptions, otherOptions)
              })
              .catch((err) => {
                const errorMessage = String(err)
                console.error(err)
                onError?.(errorMessage)
              })
          }
        } else {
          if (onNotifyError && !silent) void reportStreamResponseError(res, onError, onNotifyError)
          else if (!silent)
            void reportStreamResponseError(res, onError, (message) => toast.error(message))
          else void reportStreamResponseError(res, onError)
        }
        return
      }
      return handleStream(
        res,
        (str: string, isFirstMessage: boolean, moreInfo: IOnDataMoreInfo) => {
          if (moreInfo.errorMessage) {
            onError?.(moreInfo.errorMessage, moreInfo.errorCode, moreInfo)
            // These errors can happen when a stream is intentionally stopped or its page is left.
            if (!silent && shouldNotifyStreamError(moreInfo.errorMessage)) {
              if (onNotifyError) onNotifyError(moreInfo.errorMessage, moreInfo.errorCode)
              else toast.error(moreInfo.errorMessage)
            }
            return
          }
          onData?.(str, isFirstMessage, moreInfo)
        },
        onCompleted,
        onThought,
        onMessageEnd,
        onMessageReplace,
        onFile,
        onWorkflowStarted,
        onWorkflowFinished,
        onNodeStarted,
        onNodeFinished,
        onIterationStart,
        onIterationNext,
        onIterationFinish,
        onLoopStart,
        onLoopNext,
        onLoopFinish,
        onNodeRetry,
        onParallelBranchStarted,
        onParallelBranchFinished,
        onTextChunk,
        onTTSChunk,
        onTTSEnd,
        onTextReplace,
        onAgentLog,
        onHumanInputRequired,
        onHumanInputFormFilled,
        onHumanInputFormTimeout,
        onWorkflowPaused,
        onDataSourceNodeProcessing,
        onDataSourceNodeCompleted,
        onDataSourceNodeError,
        onReasoning,
        onUnhandledEvent,
      )
    })
    .catch((e) => {
      const errorMessage = String(e)
      if (!silent && shouldNotifyStreamError(e)) {
        if (onNotifyError) onNotifyError(errorMessage)
        else toast.error(errorMessage)
      }
      onError?.(errorMessage)
    })
}

/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const sseGet = async (
  url: string,
  fetchOptions: FetchOptionType,
  otherOptions: IOtherOptions,
) => {
  const {
    isPublicAPI = false,
    onData,
    onReasoning,
    onCompleted,
    onThought,
    onFile,
    onMessageEnd,
    onMessageReplace,
    onWorkflowStarted,
    onWorkflowFinished,
    onNodeStarted,
    onNodeFinished,
    onIterationStart,
    onIterationNext,
    onIterationFinish,
    onNodeRetry,
    onParallelBranchStarted,
    onParallelBranchFinished,
    onTextChunk,
    onTTSChunk,
    onTTSEnd,
    onTextReplace,
    onAgentLog,
    onError,
    onNotifyError,
    getAbortController,
    onLoopStart,
    onLoopNext,
    onLoopFinish,
    onHumanInputRequired,
    onHumanInputFormFilled,
    onHumanInputFormTimeout,
    onWorkflowPaused,
    onDataSourceNodeProcessing,
    onDataSourceNodeCompleted,
    onDataSourceNodeError,
    onUnhandledEvent,
    silent,
  } = otherOptions
  const requestGuard = captureRequestGuard(url, isPublicAPI, 'GET')
  if (requestGuard?.isActive() === false) {
    onCompleted?.(true, 'The request is no longer active.')
    return
  }
  const abortController = new AbortController()

  const baseOptions = getBaseOptions()
  const shareCode = resolveWebAppAddress()?.code
  const options = Object.assign(
    {},
    baseOptions,
    {
      signal: abortController.signal,
      headers: new Headers({
        [CSRF_HEADER_NAME]: Cookies.get(CSRF_COOKIE_NAME())! || '',
        [WEB_APP_SHARE_CODE_HEADER_NAME]: shareCode || '',
        [PASSPORT_HEADER_NAME]: getWebAppPassport(resolveWebAppAddress()),
      }),
    } as RequestInit,
    fetchOptions,
  )
  options.headers = new Headers(options.headers)

  const contentType = options.headers.get('Content-Type')
  if (!contentType) options.headers.set('Content-Type', ContentType.json)

  getAbortController?.(abortController)

  const urlWithPrefix = formatURL(url, isPublicAPI)

  globalThis
    .fetch(urlWithPrefix, options as RequestInit)
    .then(async (res) => {
      if (!/^[23]\d{2}$/.test(String(res.status))) {
        if (await handleGuardedStreamResponseError(res, requestGuard, onError, onCompleted)) return
        if (res.status === 401 || (res.status === 403 && isPublicAPI)) {
          if (isPublicAPI) {
            void handlePublicStreamResponseError(
              res,
              onError,
              onNotifyError,
              silent,
              requestGuard,
              onCompleted,
            )
          } else {
            refreshAccessTokenOrReLogin(TIME_OUT)
              .then(() => {
                sseGet(url, fetchOptions, otherOptions)
              })
              .catch((err) => {
                const errorMessage = String(err)
                console.error(err)
                onError?.(errorMessage)
              })
          }
        } else {
          if (onNotifyError && !silent) void reportStreamResponseError(res, onError, onNotifyError)
          else if (!silent)
            void reportStreamResponseError(res, onError, (message) => toast.error(message))
          else void reportStreamResponseError(res, onError)
        }
        return
      }
      return handleStream(
        res,
        (str: string, isFirstMessage: boolean, moreInfo: IOnDataMoreInfo) => {
          if (moreInfo.errorMessage) {
            onError?.(moreInfo.errorMessage, moreInfo.errorCode, moreInfo)
            // These errors can happen when a stream is intentionally stopped or its page is left.
            if (!silent && shouldNotifyStreamError(moreInfo.errorMessage)) {
              if (onNotifyError) onNotifyError(moreInfo.errorMessage, moreInfo.errorCode)
              else toast.error(moreInfo.errorMessage)
            }
            return
          }
          onData?.(str, isFirstMessage, moreInfo)
        },
        onCompleted,
        onThought,
        onMessageEnd,
        onMessageReplace,
        onFile,
        onWorkflowStarted,
        onWorkflowFinished,
        onNodeStarted,
        onNodeFinished,
        onIterationStart,
        onIterationNext,
        onIterationFinish,
        onLoopStart,
        onLoopNext,
        onLoopFinish,
        onNodeRetry,
        onParallelBranchStarted,
        onParallelBranchFinished,
        onTextChunk,
        onTTSChunk,
        onTTSEnd,
        onTextReplace,
        onAgentLog,
        onHumanInputRequired,
        onHumanInputFormFilled,
        onHumanInputFormTimeout,
        onWorkflowPaused,
        onDataSourceNodeProcessing,
        onDataSourceNodeCompleted,
        onDataSourceNodeError,
        onReasoning,
        onUnhandledEvent,
      )
    })
    .catch((e) => {
      const errorMessage = String(e)
      if (!silent && shouldNotifyStreamError(e)) {
        if (onNotifyError) onNotifyError(errorMessage)
        else toast.error(errorMessage)
      }
      onError?.(errorMessage)
    })
}

export type GeneratorStreamCallbacks = {
  /** Fired once when the planner stage finishes — carries the high-level plan. */
  onPlan?: (data: Record<string, unknown>) => void
  /** Fired once when the builder + validation finish — carries the final graph envelope. */
  onResult?: (data: Record<string, unknown>) => void
  onError?: (message: string) => void
  onCompleted?: () => void
  getAbortController?: (abortController: AbortController) => void
}

/**
 * Dedicated SSE consumer for the workflow generator's plan-first stream
 * (`/workflow-generate/stream`). Kept separate from ``ssePost`` /
 * ``handleStream`` on purpose: those are wired to the chat / workflow-run event
 * vocabulary (``message``, ``node_finished``, …) and threading two more
 * positional callbacks through that shared, high-blast-radius path isn't worth
 * it. This helper reuses the same cookie-auth + CSRF + abort setup but
 * only understands the generator's two events: ``plan`` then ``result``.
 * @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception.
 */
export const sseGeneratorPost = (
  url: string,
  body: unknown,
  { onPlan, onResult, onError, onCompleted, getAbortController }: GeneratorStreamCallbacks,
) => {
  const abortController = new AbortController()
  const baseOptions = getBaseOptions()
  const options = Object.assign({}, baseOptions, {
    method: 'POST',
    signal: abortController.signal,
    headers: new Headers({
      [CSRF_HEADER_NAME]: Cookies.get(CSRF_COOKIE_NAME())! || '',
      'Content-Type': ContentType.json,
    }),
    body: JSON.stringify(body),
  } as RequestInit)

  getAbortController?.(abortController)

  const urlWithPrefix = formatURL(url, false)

  const fail = (e: unknown) => {
    // Aborts are intentional (modal close / regenerate) — never surface them.
    if (e instanceof Error && e.name === 'AbortError') return
    onError?.(`${e}`)
  }

  globalThis
    .fetch(urlWithPrefix, options)
    .then((res) => {
      if (!/^[23]\d{2}$/.test(String(res.status))) {
        if (res.status === 401) {
          refreshAccessTokenOrReLogin(TIME_OUT)
            .then(() =>
              sseGeneratorPost(url, body, {
                onPlan,
                onResult,
                onError,
                onCompleted,
                getAbortController,
              }),
            )
            .catch(() => onError?.('Unauthorized'))
          return
        }
        res
          .json()
          .then((data: { message?: string }) => onError?.(data?.message || 'Server Error'))
          .catch(() => onError?.('Server Error'))
        return
      }

      const reader = res.body?.getReader()
      const decoder = new TextDecoder('utf-8')
      let buffer = ''
      const read = () => {
        reader
          ?.read()
          .then(({ done, value }) => {
            if (done) {
              onCompleted?.()
              return
            }
            buffer += decoder.decode(value, { stream: true })
            const lines = buffer.split('\n')
            // Process every complete line; keep the trailing partial in the buffer.
            lines.slice(0, -1).forEach((message) => {
              if (!message.startsWith('data: ')) return
              let obj: Record<string, unknown>
              try {
                obj = JSON.parse(message.slice(6))
              } catch {
                // A chunk boundary split the JSON — it'll re-arrive intact next read.
                return
              }
              if (obj.event === 'plan') onPlan?.(obj)
              else if (obj.event === 'result') onResult?.(obj)
            })
            buffer = lines[lines.length - 1] || ''
            read()
          })
          .catch(fail)
      }
      read()
    })
    .catch(fail)
}

// base request
/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const request = async <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  try {
    const otherOptionsForBaseFetch = otherOptions || {}
    const { isPublicAPI = false, silent } = otherOptionsForBaseFetch
    const requestGuard = captureRequestGuard(
      url,
      isPublicAPI,
      otherOptions?.request?.method || (options as RequestInit).method,
    )
    const [err, resp] = await asyncRunSafe<T>(baseFetch(url, options, otherOptionsForBaseFetch))
    if (err === null) {
      const address = resolveWebAppAddress()
      if (
        isPublicAPI &&
        canRecoverWebAppAuthorization(requestGuard) &&
        address?.kind === 'environment' &&
        !isWebAppAuthorizationEndpoint(url)
      )
        completeWebAppAuthorizationRecovery(address)
      return resp
    }
    if (err instanceof ORPCError && requestGuard?.handleError(err.status, err.data, err))
      return Promise.reject(err)
    if (requestGuard?.isActive() === false) return Promise.reject(err)
    if (err instanceof ORPCError && (err.status === 401 || (err.status === 403 && isPublicAPI))) {
      if (!isClient) return Promise.reject(err)

      const errRespData = { code: err.code, message: err.message, reason: err.data?.reason }
      if (!err.data) {
        if (err.status === 401) {
          discardRegistrationStateForConsoleAuthBoundary(otherOptionsForBaseFetch)
          window.location.href = buildSigninUrlWithRedirect()
        }
        return Promise.reject(err)
      }
      if (/\/login/.test(url)) return Promise.reject(err)
      if (handleWebAppAuthorizationError(errRespData, url)) return Promise.reject(err)
      // special code
      const { code, message } = errRespData
      if (code === 'web_sso_auth_required') {
        requiredWebSSOLogin()
        return Promise.reject(err)
      }
      if (err.status === 403) return Promise.reject(err)
      if (code === 'unauthorized_and_force_logout') {
        // Cookies will be cleared by the backend
        discardRegistrationStateForConsoleAuthBoundary(otherOptionsForBaseFetch)
        window.location.reload()
        return Promise.reject(err)
      }
      if (isPublicAPI && code === 'unauthorized') {
        requiredWebSSOLogin()
        return Promise.reject(err)
      }
      if (code === 'init_validate_failed') {
        if (!silent) toast.error(message, { timeout: 4000 })
        return Promise.reject(err)
      }
      if (code === 'not_init_validated') {
        jumpTo(`${window.location.origin}${basePath}/init`)
        return Promise.reject(err)
      }
      if (code === 'not_setup') {
        jumpTo(`${window.location.origin}${basePath}/install`)
        return Promise.reject(err)
      }

      // refresh token
      const [refreshErr] = await asyncRunSafe(refreshAccessTokenOrReLogin(TIME_OUT))
      if (refreshErr === null) return baseFetch<T>(url, options, otherOptionsForBaseFetch)
      // Preserve the transient failure so callers can retry instead of treating the session as ended.
      if (isTransientHttpError(refreshErr)) return Promise.reject(refreshErr)
      // /device is the device-flow chooser; logged-out is a valid state
      // there. Redirecting to /signin loses the user_code context and
      // the post-login flow lands on /apps instead of returning here.
      if (window.location.pathname === `${basePath}/device`) return Promise.reject(err)
      discardRegistrationStateForConsoleAuthBoundary(otherOptionsForBaseFetch)
      if (window.location.pathname !== `${basePath}/signin`) {
        jumpTo(buildSigninUrlWithRedirect())
        return Promise.reject(err)
      }
      if (!silent) {
        toast.error(message)
        return Promise.reject(err)
      }
      jumpTo(buildSigninUrlWithRedirect())
      return Promise.reject(err)
    } else {
      return Promise.reject(err)
    }
  } catch (error) {
    console.error(error)
    return Promise.reject(error)
  }
}

// request methods
/**
 * @deprecated For console JSON APIs, prefer generated contract clients (`consoleClient`/`consoleQuery`)
 * only after the backend OpenAPI schema produces accurate method, path, input, and output types.
 * Keep this helper for endpoints whose generated contract is missing or too loose, and for non-console
 * flows such as public APIs, marketplace APIs, streaming, upload, or download.
 */
export const get = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return request<T>(url, Object.assign({}, options, { method: 'GET' }), otherOptions)
}

// For public API
/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const getPublic = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return get<T>(url, options, { ...otherOptions, isPublicAPI: true })
}

// For Marketplace API
/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const getMarketplace = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return get<T>(url, options, { ...otherOptions, isMarketplaceAPI: true })
}

/**
 * @deprecated For console JSON APIs, prefer generated contract clients (`consoleClient`/`consoleQuery`)
 * only after the backend OpenAPI schema produces accurate method, path, input, and output types.
 * Keep this helper for endpoints whose generated contract is missing or too loose, and for non-console
 * flows such as public APIs, marketplace APIs, streaming, upload, or download.
 */
export const post = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return request<T>(url, Object.assign({}, options, { method: 'POST' }), otherOptions)
}

// For Marketplace API
/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const postMarketplace = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return post<T>(url, options, { ...otherOptions, isMarketplaceAPI: true })
}

/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const postPublic = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return post<T>(url, options, { ...otherOptions, isPublicAPI: true })
}

/**
 * @deprecated For console JSON APIs, prefer generated contract clients (`consoleClient`/`consoleQuery`)
 * only after the backend OpenAPI schema produces accurate method, path, input, and output types.
 * Keep this helper for endpoints whose generated contract is missing or too loose, and for non-console
 * flows such as public APIs, marketplace APIs, streaming, upload, or download.
 */
export const del = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return request<T>(url, Object.assign({}, options, { method: 'DELETE' }), otherOptions)
}

/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const delPublic = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return del<T>(url, options, { ...otherOptions, isPublicAPI: true })
}

/**
 * @deprecated For console JSON APIs, prefer generated contract clients (`consoleClient`/`consoleQuery`)
 * only after the backend OpenAPI schema produces accurate method, path, input, and output types.
 * Keep this helper for endpoints whose generated contract is missing or too loose, and for non-console
 * flows such as public APIs, marketplace APIs, streaming, upload, or download.
 */
export const patch = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return request<T>(url, Object.assign({}, options, { method: 'PATCH' }), otherOptions)
}

/** @deprecated Use generated contract clients for new APIs. Special transports require a scoped lint exception. */
export const patchPublic = <T>(url: string, options = {}, otherOptions?: IOtherOptions) => {
  return patch<T>(url, options, { ...otherOptions, isPublicAPI: true })
}