/**
 * HTTP / 异常归一纯函数 —— 服务无关的错误分类，「什么错算什么类」的唯一来源。
 *
 * 零副作用、零依赖。`@drama/llm` 的 map-error 与各服务的 execute 都从这里取分类，
 * 保证 429/5xx/超时/abort 的判定全仓只有一处。
 */

/** @typedef {import('./retry.js').CallErrorReason} CallErrorReason */

/**
 * @typedef {object} MappedError
 * @property {CallErrorReason} reason
 * @property {boolean} retryable
 */

/**
 * HTTP 状态码 → reason/retryable。
 * 401/403 = auth(不重试)；429 = rateLimit(重试)；408/5xx = transient(重试)；
 * 4xx 其余 = badRequest(不重试)。
 * @param {number} status
 * @returns {MappedError}
 */
export function mapHttpStatus(status) {
  if (status === 401 || status === 403) return { reason: 'auth', retryable: false }
  if (status === 429) return { reason: 'rateLimit', retryable: true }
  if (status === 408 || status >= 500) return { reason: 'transient', retryable: true }
  if (status >= 400) return { reason: 'badRequest', retryable: false }
  return { reason: 'unknown', retryable: false }
}

/**
 * 判定一个抛出的异常是否为内部超时（每 attempt 计时器的 abort reason）。
 * 内部超时用 DOMException('...', 'TimeoutError') 作 abort reason，与外部 abort（AbortError）互斥。
 * @param {unknown} err
 * @returns {boolean}
 */
export function isTimeoutError(err) {
  if (!err || typeof err !== 'object') return false
  return /** @type {{ name?:string }} */ (err).name === 'TimeoutError'
}

/**
 * 判定一个抛出的异常是否为 AbortError（外部调用方中断）。
 * DOMException name==='AbortError' 或 code==='ABORT_ERR'。
 * @param {unknown} err
 * @returns {boolean}
 */
export function isAbortError(err) {
  if (!err || typeof err !== 'object') return false
  const e = /** @type {{ name?:string, code?:string }} */ (err)
  return e.name === 'AbortError' || e.code === 'ABORT_ERR'
}