photo-live/packages/contracts/src/errors.ts

// 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];