JianFeeeee
13fcb00acc
Sha256 clamp relay_key 过 160 字节上限，避免服务端 400 被 worker 当暂时失败让位，导致邮件驱动会话无本地 UI 静默挂死。 新增 relay_key.go / relay-key.js + 15 个纯函数测试。
21 lines
850 B
TypeScript
21 lines
850 B
TypeScript
/** 服务端 relay_key 列宽（字节）。 */
|
||
export const RELAY_KEY_MAX_BYTES: number;
|
||
|
||
/** UTF-8 字节数。 */
|
||
export function byteLength(s: string | null | undefined): number;
|
||
|
||
/** 按字节截断，回退到最近的字符边界（不产生半个字符）。 */
|
||
export function truncateToBytes(s: string | null | undefined, maxBytes: number): string;
|
||
|
||
/**
|
||
* 把 relay_key 收敛到服务端能接受的长度。
|
||
* 未超限时原样返回；超限时保留可读前缀 + `:sha256:<原始键的完整哈希>`。
|
||
*/
|
||
export function clampRelayKey(key: string | null | undefined, limit?: number): string;
|
||
|
||
/**
|
||
* 这次失败是不是「永远不会成功」。
|
||
* 4xx（除 408 / 429）= 永久；408 / 429 / 5xx / 无 status = 暂时。
|
||
*/
|
||
export function isPermanentFailure(err: { status?: number | string } | null | undefined): boolean;
|