26 lines
1019 B
TypeScript
26 lines
1019 B
TypeScript
|
/**
|
|||
|
|
* Provider 错误分类（实施设计 5：统一映射为六类）。
|
|||
|
|
*
|
|||
|
|
* Provider 抛出的错误会被 Core 归一化成这六种之一；界面按 kind 决定提示与是否可重试，
|
|||
|
|
* 不用话术圆场（实施设计 2.5「失败显式」）。
|
|||
|
|
*/
|
|||
|
|
export const ERROR_KINDS = ['invalid_argument', 'forbidden', 'conflict', 'rate_limited', 'unavailable', 'unknown_result'] as const;
|
|||
|
|
|
|||
|
|
export type ErrorKind = (typeof ERROR_KINDS)[number];
|
|||
|
|
|
|||
|
|
export function isErrorKind(value: unknown): value is ErrorKind {
|
|||
|
|
return typeof value === 'string' && (ERROR_KINDS as readonly string[]).includes(value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** Provider 应抛这个错误，而不是裸 Error——裸 Error 会被 Core 归为 unknown_result */
|
|||
|
|
export class ProviderError extends Error {
|
|||
|
|
readonly kind: ErrorKind;
|
|||
|
|
readonly detail?: unknown;
|
|||
|
|
|
|||
|
|
constructor(kind: ErrorKind, message: string, detail?: unknown) {
|
|||
|
|
super(message);
|
|||
|
|
this.name = 'ProviderError';
|
|||
|
|
this.kind = kind;
|
|||
|
|
if (detail !== undefined) this.detail = detail;
|
|||
|
|
}
|
|||
|
|
}
|