chunk

type ChunkService interface {
	// ChunkUploadInit 初始化分片上传
	ChunkUploadInit(ctx context.Context, req *ChunkUploadInitReq) (r *ChunkUploadInitResp, err error)
	// ChunkUpload 上传单个分片
	ChunkUpload(ctx context.Context, req *ChunkUploadReq) (r *ChunkUploadResp, err error)
	// ChunkUploadStatus 查询上传进度
	ChunkUploadStatus(ctx context.Context, req *ChunkUploadStatusReq) (r *ChunkUploadStatusResp, err error)
	// ChunkUploadComplete 完成上传
	ChunkUploadComplete(ctx context.Context, req *ChunkUploadCompleteReq) (r *ChunkUploadCompleteResp, err error)
	// ChunkUploadCancel 取消上传
	ChunkUploadCancel(ctx context.Context, req *ChunkUploadCancelReq) (r *ChunkUploadCancelResp, err error)
}

type ChunkServiceChunkUploadArgs struct {
	Req *ChunkUploadReq `thrift:"req,1"`
}

type ChunkServiceChunkUploadCancelArgs struct {
	Req *ChunkUploadCancelReq `thrift:"req,1"`
}

type ChunkServiceChunkUploadCancelResult struct {
	Success *ChunkUploadCancelResp `thrift:"success,0,optional"`
}

type ChunkServiceChunkUploadCompleteArgs struct {
	Req *ChunkUploadCompleteReq `thrift:"req,1"`
}

type ChunkServiceChunkUploadCompleteResult struct {
	Success *ChunkUploadCompleteResp `thrift:"success,0,optional"`
}

type ChunkServiceChunkUploadInitArgs struct {
	Req *ChunkUploadInitReq `thrift:"req,1"`
}

type ChunkServiceChunkUploadInitResult struct {
	Success *ChunkUploadInitResp `thrift:"success,0,optional"`
}

type ChunkServiceChunkUploadResult struct {
	Success *ChunkUploadResp `thrift:"success,0,optional"`
}

type ChunkServiceChunkUploadStatusArgs struct {
	Req *ChunkUploadStatusReq `thrift:"req,1"`
}

type ChunkServiceChunkUploadStatusResult struct {
	Success *ChunkUploadStatusResp `thrift:"success,0,optional"`
}

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

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

type ChunkUploadCancelReq struct {
	UploadID string `thrift:"upload_id,1,required" json:"upload_id,required" path:"upload_id,required"`
}

type ChunkUploadCancelResp struct {
	Code    int32  `thrift:"code,1,required" form:"code,required" json:"code,required"`
	Message string `thrift:"message,2,required" form:"message,required" json:"message,required"`
}

type ChunkUploadCompleteData struct {
	ShareCode string `thrift:"share_code,1,required" form:"share_code,required" json:"share_code,required"`
	ShareURL  string `thrift:"share_url,2,required" form:"share_url,required" json:"share_url,required"`
	FileName  string `thrift:"file_name,3,required" form:"file_name,required" json:"file_name,required"`
	FileSize  int64  `thrift:"file_size,4,required" form:"file_size,required" json:"file_size,required"`
}

type ChunkUploadCompleteReq struct {
	UploadID    string `thrift:"upload_id,1,required" json:"upload_id,required" path:"upload_id,required"`
	ExpireValue int32  `thrift:"expire_value,2,required" form:"expire_value,required" json:"expire_value,required"`
	ExpireStyle string `thrift:"expire_style,3,required" form:"expire_style,required" json:"expire_style,required"`
	RequireAuth bool   `thrift:"require_auth,4,required" form:"require_auth,required" json:"require_auth,required"`
	// 密码保护:require_auth 时必填(此前 handler form 直读+二次解析 body)
	Password *string `thrift:"password,5,optional" form:"password" json:"password,omitempty"`
	// 自定义取件码(P3):仅登录用户可指定(此前 handler form 直读+二次解析 body)
	CustomCode *string `thrift:"custom_code,6,optional" form:"custom_code" json:"custom_code,omitempty"`
	// 文件备注(可空,随分享展示给取件人;2026-10-12 #489)
	Note *string `thrift:"note,7,optional" form:"note" json:"note,omitempty"`
}

type ChunkUploadCompleteResp struct {
	Code    int32                    `thrift:"code,1,required" form:"code,required" json:"code,required"`
	Message string                   `thrift:"message,2,required" form:"message,required" json:"message,required"`
	Data    *ChunkUploadCompleteData `thrift:"data,3,required" form:"data,required" json:"data,required"`
}

type ChunkUploadData struct {
	ChunkIndex int32  `thrift:"chunk_index,1,required" form:"chunk_index,required" json:"chunk_index,required"`
	ChunkHash  string `thrift:"chunk_hash,2,required" form:"chunk_hash,required" json:"chunk_hash,required"`
}

type ChunkUploadInitData struct {
	UploadID    string `thrift:"upload_id,1,required" form:"upload_id,required" json:"upload_id,required"`
	ChunkSize   string `thrift:"chunk_size,2,required" form:"chunk_size,required" json:"chunk_size,required"`
	TotalChunks string `thrift:"total_chunks,3,required" form:"total_chunks,required" json:"total_chunks,required"`
	// Quick upload flag
	IsQuickUpload bool `thrift:"is_quick_upload,4,required" form:"is_quick_upload,required" json:"is_quick_upload,required"`
	// If quick upload, return share code directly
	ShareCode string `thrift:"share_code,5,required" form:"share_code,required" json:"share_code,required"`
	// 秒传命中时的完整分享链接（2026-10-12 建新分享语义；未命中为空）
	ShareURL *string `thrift:"share_url,6,optional" form:"share_url" json:"share_url,omitempty"`
}

type ChunkUploadInitReq struct {
	FileName    string `thrift:"file_name,1,required" form:"file_name,required" json:"file_name,required"`
	FileSize    int64  `thrift:"file_size,2,required" form:"file_size,required" json:"file_size,required"`
	FileHash    string `thrift:"file_hash,3,required" form:"file_hash,required" json:"file_hash,required"`
	ChunkSize   int32  `thrift:"chunk_size,4,required" form:"chunk_size,required" json:"chunk_size,required"`
	TotalChunks int32  `thrift:"total_chunks,5,required" form:"total_chunks,required" json:"total_chunks,required"`
	// ---- 秒传建分享元数据（2026-10-12，与 CompleteReq 同形；可选）----
	// 携带 expire_style 即视为启用秒传快速通道：命中同用户同 hash+size 历史文件时
	// 按本次元数据建新分享（引用既有对象，免传分片）；不携带则不做快速通道
	// （正常分片上传，Complete 再按其元数据建分享）。两条路径均过 CreateShare
	// 去重钩子（存储级去重恒生效）。
	ExpireValue *int32  `thrift:"expire_value,6,optional" form:"expire_value" json:"expire_value,omitempty"`
	ExpireStyle *string `thrift:"expire_style,7,optional" form:"expire_style" json:"expire_style,omitempty"`
	RequireAuth *bool   `thrift:"require_auth,8,optional" form:"require_auth" json:"require_auth,omitempty"`
	Password    *string `thrift:"password,9,optional" form:"password" json:"password,omitempty"`
	// 自定义取件码：仅登录用户可指定（与 Complete 同把关）
	CustomCode *string `thrift:"custom_code,10,optional" form:"custom_code" json:"custom_code,omitempty"`
	// 文件备注(可空,随分享展示给取件人;2026-10-12 #489)
	Note *string `thrift:"note,11,optional" form:"note" json:"note,omitempty"`
}

type ChunkUploadInitResp struct {
	Code    int32                `thrift:"code,1,required" form:"code,required" json:"code,required"`
	Message string               `thrift:"message,2,required" form:"message,required" json:"message,required"`
	Data    *ChunkUploadInitData `thrift:"data,3,required" form:"data,required" json:"data,required"`
}

type ChunkUploadReq struct {
	UploadID   string `thrift:"upload_id,1,required" json:"upload_id,required" path:"upload_id,required"`
	ChunkIndex int32  `thrift:"chunk_index,2,required" json:"chunk_index,required" path:"chunk_index,required"`
}

type ChunkUploadResp struct {
	Code    int32            `thrift:"code,1,required" form:"code,required" json:"code,required"`
	Message string           `thrift:"message,2,required" form:"message,required" json:"message,required"`
	Data    *ChunkUploadData `thrift:"data,3,required" form:"data,required" json:"data,required"`
}

type ChunkUploadStatusData struct {
	UploadID        string  `thrift:"upload_id,1,required" form:"upload_id,required" json:"upload_id,required"`
	TotalChunks     int32   `thrift:"total_chunks,2,required" form:"total_chunks,required" json:"total_chunks,required"`
	UploadedChunks  int32   `thrift:"uploaded_chunks,3,required" form:"uploaded_chunks,required" json:"uploaded_chunks,required"`
	UploadedIndexes []int32 `thrift:"uploaded_indexes,4,required,list<i32>" form:"uploaded_indexes,required" json:"uploaded_indexes,required"`
	// 百分比
	Progress int32 `thrift:"progress,5,required" form:"progress,required" json:"progress,required"`
	// uploading, completed, cancelled
	Status string `thrift:"status,6,required" form:"status,required" json:"status,required"`
}

type ChunkUploadStatusReq struct {
	UploadID string `thrift:"upload_id,1,required" json:"upload_id,required" path:"upload_id,required"`
}

type ChunkUploadStatusResp struct {
	Code    int32                  `thrift:"code,1,required" form:"code,required" json:"code,required"`
	Message string                 `thrift:"message,2,required" form:"message,required" json:"message,required"`
	Data    *ChunkUploadStatusData `thrift:"data,3,required" form:"data,required" json:"data,required"`
}