http.js
1.91 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
/**
* 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'
}