浅念
8a8ad8a18d
P4a Task 1 契约扩展批次（36 → 51 operations，gen/redocly/枚举同步守护绿）：
- photos：POST /albums/{albumId}/photos/hide-batch（photoIds 1..200，逐项
BatchHideResult {photoId, ok, code?}，部分成功语义，A16）；
- admin：POST /admin/albums/{albumId}/transfer（owner 交接，历史上传人不动，
keepAsCollaborator，A17）；
- albums：POST/GET /albums/{albumId}/watermark-jobs（WatermarkConfig 版本化
+ 历史重生成任务 state/progress/total/failed，原子切换、原图永不覆盖，
A18/A20）；
- interactions：GET /public/albums/{token}/photos/{photoId}/download
（variant=browse|original 两级开关校验；**新增错误码 DOWNLOAD_DISABLED**，
errors.ts 与 Error enum 两侧同步，A18）；
- admin 账号治理：GET /admin/users 统一为 listAdminUsers 双模式 + PATCH
/admin/users/{userId} 与 reset-password / activate / deactivate；
- admin 用户同步：GET /admin/user-sync/{status,runs,errors} + POST runs
手动补拉（互斥复用进行中批次，A29）；
- admin 用量：GET /admin/usage/summary + PUT thresholds（null 清除、
即刻重评估，A23）。
偏差登记①——/admin/users 路径冲突（P1b lookupUsersByAccount）：P4a 决策
统一为双模式端点（前缀模式沿用 P1b 语义与任何已认证工作人员可用；管理
列表模式 query/status 过滤 + 游标 + 仅 admin），响应统一 AdminUserList
（AdminUser 字段超集，游标元信息随行）。消费方同步：admin 邀请搜索
（fetchLookupUsers/类型镜像，行为不变）与 api 过渡实现（仍仅前缀模式、
limit 对齐 1..100 缺省 20；管理列表模式与仅 admin 判定随 Task 6 落地，
users-lookup e2e 已按统一形状修订）。
偏差登记②——apps/mobile 手写镜像未随本次更新：其邀请流程仍按旧 3 字段
投影消费（AdminUserList 为超集，运行时兼容，mobile IT 不经该路径）；列
为 P4a 跟进项，仅当其 e2e 破坏时处理。
Co-Authored-By: Claude Code <noreply@anthropic.com>
40 lines
2.4 KiB
TypeScript
40 lines
2.4 KiB
TypeScript
// packages/contracts/src/errors.ts
|
||
export const ErrorCodes = {
|
||
AUTH_INVALID_CREDENTIALS: 'AUTH_INVALID_CREDENTIALS',
|
||
AUTH_TOKEN_EXPIRED: 'AUTH_TOKEN_EXPIRED',
|
||
// Task 13 契约修订（已登记）：登录失败基础限速（总纲 P1）需要一个区别于
|
||
// 凭据错误的错误码——429 若复用 AUTH_INVALID_CREDENTIALS 会向客户端撒谎，
|
||
// 复用 VALIDATION_FAILED 则语义错位。与 openapi.yaml Error enum 同步增补。
|
||
AUTH_RATE_LIMITED: 'AUTH_RATE_LIMITED',
|
||
// P2 Task 1：公开互动端点（likes/visits）的基础限速 429。AUTH_RATE_LIMITED
|
||
// 语义绑死登录场景，匿名观众限速需独立通用码；与 openapi.yaml Error enum 同步增补。
|
||
RATE_LIMITED: 'RATE_LIMITED',
|
||
AUTH_FORBIDDEN: 'AUTH_FORBIDDEN',
|
||
// P1a 终审修缮①（P1b Task 1 补登）：框架级 404（未注册路由等）此前兜底映射
|
||
// ALBUM_NOT_FOUND，语义错位。业务 404 一律经 ApiException 显式携带域码；
|
||
// NOT_FOUND 仅代表"框架/路由层面的资源不存在"。与 openapi.yaml Error enum
|
||
// 同步增补。
|
||
NOT_FOUND: 'NOT_FOUND',
|
||
ALBUM_NOT_FOUND: 'ALBUM_NOT_FOUND',
|
||
ALBUM_NOT_PUBLIC: 'ALBUM_NOT_PUBLIC',
|
||
ALBUM_UPLOAD_DISABLED: 'ALBUM_UPLOAD_DISABLED',
|
||
MEMBER_CONFLICT: 'MEMBER_CONFLICT',
|
||
UPLOAD_SESSION_CONFLICT: 'UPLOAD_SESSION_CONFLICT',
|
||
UPLOAD_VERIFY_FAILED: 'UPLOAD_VERIFY_FAILED',
|
||
PHOTO_NOT_FOUND: 'PHOTO_NOT_FOUND',
|
||
PHOTO_NOT_PUBLIC: 'PHOTO_NOT_PUBLIC',
|
||
VALIDATION_FAILED: 'VALIDATION_FAILED',
|
||
// P4a Task 1：公开照片下载（/download）相册下载开关关闭时的 403。相册/照片
|
||
// 不可见仍走 404（ALBUM_NOT_PUBLIC/PHOTO_NOT_PUBLIC 不区分枚举）；「可见但
|
||
// 禁止下载」是显式语义——复用 404 会对客户端撒谎，复用 AUTH_FORBIDDEN 则
|
||
// 语义错位（匿名观众无「权限」概念）。与 openapi.yaml Error enum 同步增补
|
||
// （1:1 守护见 __tests__/events.test.ts）。
|
||
DOWNLOAD_DISABLED: 'DOWNLOAD_DISABLED',
|
||
// P2 Task 3：内部同步接口（/internal/**）HMAC 鉴权失败的 401。AUTH_TOKEN_EXPIRED
|
||
// 语义绑死观众/员工会话，服务间签名失败复用它会对客户端撒谎；与 openapi.yaml
|
||
// Error enum 同步增补（1:1 守护见 __tests__/events.test.ts）。
|
||
SYNC_AUTH_FAILED: 'SYNC_AUTH_FAILED',
|
||
INTERNAL_ERROR: 'INTERNAL_ERROR',
|
||
} as const;
|
||
export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
|