51 lines
3.2 KiB
TypeScript
51 lines
3.2 KiB
TypeScript
// 恢复提案展示与错误文案（纯函数）：管理端 UsersPanel 与本人 MyAccountSettings
|
|
// 共用，vitest 锁定语义防漂移。后端 409 两种含义按响应体区分：
|
|
// OWNER_PROOF_UNAVAILABLE=无合格会话证明；其余 conflict=已有活动提案。
|
|
import type { RecoveryProposal } from './api'
|
|
|
|
export const recoveryStatusLabel: Record<RecoveryProposal['status'], string> = {
|
|
pending: '待本人确认',
|
|
confirmed: '已确认，待兑换设密',
|
|
completed: '已完成',
|
|
revoked: '已撤销',
|
|
expired: '已过期',
|
|
}
|
|
|
|
/** 管理端视角的下一步指引：提案成立后动作在属主侧（设置 → 账号）。 */
|
|
export function recoveryProposalHint(status: RecoveryProposal['status']): string {
|
|
if (status === 'pending') return '等待该用户在「设置 → 账号」由本人确认；确认后一次性 Key 只在其会话内出现'
|
|
if (status === 'confirmed') return '该用户已确认；请提醒其尽快在受限会话中完成新密码设置，到期未用需重新生成'
|
|
return ''
|
|
}
|
|
|
|
/** 建立提案后的结果提示：以服务端返回或重读的当前状态为准。同一 idempotencyKey
|
|
* 的重复响应只回状态（可能已是终态），管理员任何时候都拿不到设密能力。 */
|
|
export function recoveryProposalNotice(owner: string, status: RecoveryProposal['status']): string {
|
|
if (status === 'pending') return `已为 ${owner} 建立恢复提案：请该用户在「设置 → 账号」由本人确认；确认后一次性 Key 只在其会话内出现，管理员不会收到设密能力`
|
|
if (status === 'confirmed') return `${owner} 的恢复提案已由本人确认。只有目标本人可以取得设密能力；管理员不会收到设密能力`
|
|
return `${owner} 的恢复提案${recoveryStatusLabel[status]}。如需再次恢复，请核对下方记录`
|
|
}
|
|
|
|
export interface RecoveryAttempt { userId: string; stateVersion: number; key: string }
|
|
|
|
/** 提案请求标识：同一账号、同一状态版本的显式重试沿用上次未确定结果的 key，
|
|
* 让响应丢失后的重试落到同一提案而不是重复创建；账号或状态版本变化才换新 key。 */
|
|
export function recoveryAttemptKey(previous: RecoveryAttempt | null, userId: string, stateVersion: number, fresh: () => string): string {
|
|
return previous?.userId === userId && previous.stateVersion === stateVersion ? previous.key : fresh()
|
|
}
|
|
|
|
/** 4xx 是服务端明确拒绝（提案未创建）；网络失败或 5xx 时提案可能已提交，结果未确定。 */
|
|
export function recoveryProposalRejected(raw: string): boolean {
|
|
return /\b4\d\d:/.test(raw)
|
|
}
|
|
|
|
export function recoveryProposalErrorMessage(raw: string): string {
|
|
if (raw.includes('OWNER_PROOF_UNAVAILABLE')) {
|
|
return '无法发起：该账号没有可用的合格会话证明（需该用户当前在任一设备保持完整密码登录）。历史来源或已锁死账号请走服务器本地处置'
|
|
}
|
|
if (raw.includes('409')) return '该用户已有进行中的恢复提案；请先撤销旧提案或等它完成/过期'
|
|
if (raw.includes('403')) return '需要管理员身份'
|
|
if (raw.includes('404')) return '用户不存在或已被移除'
|
|
return raw.replace(/^\d{3}:\s*/, '')
|
|
}
|