presign

type CompleteResult struct {
	*InitMeta
	ShareCode    string
	ShareURL     string
	FullShareURL string
	OwnerIP      string
	PickupCode   string // 6 位取件码（share 域铸造；永久分享/未注入 minter 为空）
}

type InitMeta struct {
	UploadID    string    `json:"upload_id"`
	ObjectKey   string    `json:"object_key"`
	FileName    string    `json:"file_name"`
	FileSize    int64     `json:"file_size"`
	ContentType string    `json:"content_type"`
	Scheme      string    `json:"scheme"`
	ExpireAt    time.Time `json:"expire_at"`
	Complete    bool      `json:"complete"`
	UserID      uint      `json:"user_id"`
	ExpireValue int32     `json:"expire_value"`
	ExpireStyle string    `json:"expire_style"`
	RequireAuth bool      `json:"require_auth"`
	// PasswordHash 为 require_auth=true 时分享密码的 bcrypt 哈希(明文不落存储)
	PasswordHash string `json:"password_hash,omitempty"`
	// FileHash 直传完成后服务端计算的 SHA-256（写入 file_codes.file_hash，秒传依据）
	// SessionTTL 直传会话/签名时效（handler 按管理配置下发；0=服务端默认 1h）
	SessionTTL time.Duration `json:"-"`
	FileHash   string        `json:"file_hash,omitempty"`
	// PickupCode 匿名取件码直传绑定（2026-10-07）：非空时 Complete 不新建分享，
	// 而是把对象回填到该占位记录（/anonymous/generate 创建）。有效期/密码以
	// 占位记录为准——本 meta 的 expire/auth 字段在绑定路径被忽略。
	PickupCode string `json:"pickup_code,omitempty"`
	// Note 文件备注（可空，随分享展示给取件人；2026-10-12 #489）
	Note string `json:"note,omitempty"`
}

type InitResult struct {
	UploadID      string            `json:"upload_id"`
	UploadURL     string            `json:"upload_url"`
	Method        string            `json:"method"`
	Headers       map[string]string `json:"headers"`
	ExpireSeconds int32             `json:"expire_seconds"`
	ObjectKey     string            `json:"object_key"`
	Scheme        string            `json:"scheme"`
	Token         string            `json:"token"`
}

type ObjectStore interface {
	PresignPutURL(ctx context.Context, objectKey string, expire time.Duration) (string, error)
	// HeadObject 直传完成核实用：对象必须真实存在并取实际大小（S3 为事实源）
	HeadObject(ctx context.Context, objectKey string) (size int64, etag string, err error)
}

type PickupBinder interface {
	// ResolvePlaceholder 校验取件码是待回填占位分享，返回其 8 位分享码
	ResolvePlaceholder(ctx context.Context, pickupCode string) (string, error)
	// BindFilePath 把直传对象回填到占位分享（file_path+size；note 非空一并写入）
	BindFilePath(ctx context.Context, shareCode, filePath string, size int64, note string) error
}

type QuickShareMeta struct {
	FileName     string
	FileSize     int64
	FileHash     string
	ExpireValue  int
	ExpireStyle  string
	RequireAuth  bool
	PasswordHash string
	Note         string // 文件备注（可空，取件页展示；2026-10-12 #489）
}

type QuickUploadResult struct {
	ShareCode    string
	FullShareURL string
}

type Service struct {
	// contains filtered or unexported fields
}

type ShareCreateReq struct {
	Channel      string // 上传通道（metrics 用；presign 恒 "presign"）
	FilePath     string
	Size         int64
	Text         string
	ExpiredAt    *time.Time
	ExpiredCount int
	RequireAuth  bool
	PasswordHash string
	UserID       *uint
	UploadType   string
	OwnerIP      string
	FileHash     string
	UploadID     string
	Note         string // 文件备注（可空，取件页展示；2026-10-12 #489）
}

type ShareCreateResp struct {
	Code         string
	ShareURL     string
	FullShareURL string
	PickupCode   string
}

type ShareServiceInterface interface {
	CreateShare(ctx context.Context, req *ShareCreateReq) (*ShareCreateResp, error)
}

type StorageWriter interface {
	SaveBytes(ctx context.Context, savePath string, data []byte) error
	DeleteFile(ctx context.Context, filePath string) error
}