/** 服务端 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;