preview

var (
	// ErrShareNotFound 分享不存在/已过期/不可见（统一 404 语义）
	ErrShareNotFound = errors.New("share not found or expired")
	// ErrShareBlocked 分享被封禁或待审（走 errcode 管控语义）
	ErrShareBlocked = errors.New("share blocked")
	// ErrPasswordRequired 密码保护分享未通过密码校验（含防爆破锁定态）
	ErrPasswordRequired = errors.New("password required")
	// ErrLocked 密码错误次数过多，临时锁定
	ErrLocked = errors.New("too many attempts, temporarily locked")
	// ErrShareNotReady 分享未完成上传（占位分享；与 select/download 同码同文案）
	ErrShareNotReady = errors.New("share not uploaded yet")

	// ErrPickupExhausted 取件次数已用完（2026-10-24：此前次数耗尽混作「已过期」
	// ⇒ 预览面返回 404「分享不存在或已过期」，与文档承诺的 10003 对不上）。
	ErrPickupExhausted = errors.New("pickup count exhausted")
	// ErrPreviewUnavailable 预览不可用（生成失败/存储不可达）
	ErrPreviewUnavailable = errors.New("preview unavailable")
	// ErrPreviewBusy 生成并发闸满（防 CPU/内存耗尽：图片解码与 ffmpeg 均为重活，
	// 攻击者跨 IP 并发预览未缓存的大图/视频可打满 CPU——限流按 IP 计数堵不住分布式）
	ErrPreviewBusy = errors.New("preview generation busy")
)