Files
wmailhub/shared/src/constants.ts
T
bigcode fec96e49cc feat: v2.0.0 邮件接收架构改造 —— 移除 Node,Email Worker 直连 Console(docs/11)
- 两阶段接收:POST /internal/email/authorize(accept/reject/temporary_error)+ POST /internal/email/ingest(raw MIME 直传)
- Worker-Console 协议:Authorization: WmailHub-Worker + timestamp/nonce/body-hash/HMAC,nonce 防重放,凭据撤销即时生效
- 数据模型:nodes/node_credentials -> cloudflare_accounts/worker_credentials(迁移 0003),emails/domains 归属 account_id
- 接入流程 Connect Cloudflare Account:OAuth 自动同步域名 + 部署账号级 Email Worker + 签发 Worker 凭据;rotate 自动重部署
- 动态邮箱:创建/删除/禁用下一封邮件立即生效;拒绝码 DOMAIN_*/MAILBOX_*;超时/5xx 不伪装成邮箱不存在
- 删除 node/ 目录、旧 /api/internal/nodes 协议、ingress/enrollment 概念;dev.ts 简化为 console + email worker 双进程
- 前端:账号页 Email Worker/凭据管理,设置窗口移除默认 Ingress,仪表盘/文案同步;版本 2.0.0
- 测试 62 项全过(新增 authorize 决策矩阵 + Worker 两阶段临时错误语义);本机虚拟 E2E 12 场景全通
- docs 00-10 同步改写;README 更新
2026-09-30 13:10:26 +08:00

43 lines
1.5 KiB
TypeScript

/** WmailHub 全局常量:邮件大小限制、TTL、Webhook 策略、签名头名称 */
/** # 成员变量: 默认邮件保留时长(秒),1 天 **/
export const DEFAULT_RETENTION_SECONDS = 86_400;
/** # 成员变量: 单封邮件最大字节数(raw MIME),Cloudflare Email Worker 上限为 25MB,取保守值 20MB **/
export const MAX_EMAIL_BYTES = 20 * 1024 * 1024;
/** # 成员变量: 单封邮件最大附件数 **/
export const MAX_ATTACHMENTS = 20;
/** # 成员变量: 单个附件最大字节数 **/
export const MAX_ATTACHMENT_BYTES = 10 * 1024 * 1024;
/** # 成员变量: MIME 头最大字节数 **/
export const MAX_MIME_HEADER_BYTES = 256 * 1024;
/** # 成员变量: Webhook 单次投递超时(毫秒) **/
export const WEBHOOK_TIMEOUT_MS = 10_000;
/** # 成员变量: Webhook 最大尝试次数 **/
export const WEBHOOK_MAX_ATTEMPTS = 5;
/** # 成员变量: Webhook 首次重试退避(毫秒),之后指数递增 **/
export const WEBHOOK_RETRY_BASE_MS = 60_000;
/** # 成员变量: Webhook 签名头 **/
export const WEBHOOK_HEADERS = {
event: "X-WmailHub-Event",
delivery: "X-WmailHub-Delivery",
timestamp: "X-WmailHub-Timestamp",
signature: "X-WmailHub-Signature",
} as const;
/** # 成员变量: Email Worker 本地测试入口请求头(Worker secret 验证) **/
export const WORKER_TEST_SECRET_HEADER = "X-WmailHub-Test-Secret";
/** # 成员变量: Worker -> Console 信封传递请求头 **/
export const WORKER_ENVELOPE_HEADERS = {
recipient: "X-WmailHub-Recipient",
sender: "X-WmailHub-Sender",
} as const;