share

type DownloadFileReq struct {
	Code string `thrift:"code,1,required" json:"code,required" query:"code,required"`
}

type DownloadFileResp struct {
	// 文件下载使用流式响应，此消息用于 JSON 错误响应
	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 GetShareReq struct {
	Code string `thrift:"code,1,required" json:"code,required" path:"code,required"`
	// 取件密码经请求头传递（2026-10-16 拍板「一步到位」）：query 形态有访问日志/
	// 浏览器历史/Referer 泄漏面，与 /share/download 停收 ?password= 同批收敛
	Password *string `thrift:"password,2,optional" header:"X-Share-Password" json:"password,omitempty"`
}

type GetShareResp 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    *ShareDetail `thrift:"data,3,required" form:"data,required" json:"data,required"`
}

type PickupRecord struct {
	// RFC3339Nano
	PickedAt string `thrift:"picked_at,1,required" form:"picked_at,required" json:"picked_at,required"`
	// 取件人 IP（可信代理解析后）
	IP string `thrift:"ip,2,required" form:"ip,required" json:"ip,required"`
	// 交付面：select/retrieve/download
	Channel *string `thrift:"channel,3,optional" form:"channel" json:"channel,omitempty"`
}

type ShareData struct {
	Code string `thrift:"code,1,required" form:"code,required" json:"code,required"`
	URL  string `thrift:"url,2,required" form:"url,required" json:"url,required"`
	// 6 位取件码（2026-10-08 起文本/文件/永久分享同权铸造：pickup_code → code 映射，
	// 真相源落 DB file_codes.pickup_code，有 TTL 时另写 KV 加速；E2E 密文分享跳过为空）
	PickupCode *string `thrift:"pickup_code,3,optional" form:"pickup_code" json:"pickup_code,omitempty"`
	// 秒传去重命中（2026-10-12，D1=A 同用户内）：本次未写入新存储对象，
	// 分享引用调用者自己历史同 hash+size 文件的既有对象
	Deduped *bool `thrift:"deduped,4,optional" form:"deduped" json:"deduped,omitempty"`
}

type ShareDetail struct {
	Code     string `thrift:"code,1,required" form:"code,required" json:"code,required"`
	Text     string `thrift:"text,2,required" form:"text,required" json:"text,required"`
	FileName string `thrift:"file_name,3,required" form:"file_name,required" json:"file_name,required"`
	// 后端格式化前的字节数字符串
	FileSize    string `thrift:"file_size,4,required" form:"file_size,required" json:"file_size,required"`
	URL         string `thrift:"url,5,required" form:"url,required" json:"url,required"`
	HasPassword bool   `thrift:"has_password,6,required" form:"has_password,required" json:"has_password,required"`
	ExpireTime  string `thrift:"expire_time,7,required" form:"expire_time,required" json:"expire_time,required"`
	// ---- 以下为此前 handler ad-hoc map 附加字段(v0.6.0 入契约) ----
	DownloadURL *string `thrift:"download_url,8,optional" form:"download_url" json:"download_url,omitempty"`
	// 下载令牌(功能关闭时不下发)
	Token *string `thrift:"token,9,optional" form:"token" json:"token,omitempty"`
	// E2E 密文,前端以链接 #fragment 密钥解密
	Encrypted *bool `thrift:"encrypted,10,optional" form:"encrypted" json:"encrypted,omitempty"`
	// 多文件分享(前端显示"打包下载")
	IsMulti *bool `thrift:"is_multi,11,optional" form:"is_multi" json:"is_multi,omitempty"`
	// 文件清单(含单文件,前端统一渲染)
	Files []*ShareFileItem `thrift:"files,12,optional,list<ShareFileItem>" form:"files" json:"files,omitempty"`
	// 文件备注(可空,取件页展示)
	Note *string `thrift:"note,13,optional" form:"note" json:"note,omitempty"`
}

type ShareFileItem struct {
	ID   int64  `thrift:"id,1,required" form:"id,required" json:"id,required"`
	Name string `thrift:"name,2,required" form:"name,required" json:"name,required"`
	Size int64  `thrift:"size,3,required" form:"size,required" json:"size,required"`
}

type ShareFileReq struct {
	// 文件通过 multipart/form-data 上传
	ExpireValue int32  `thrift:"expire_value,1,required" form:"expire_value,required" json:"expire_value,required"`
	ExpireStyle string `thrift:"expire_style,2,required" form:"expire_style,required" json:"expire_style,required"`
	RequireAuth bool   `thrift:"require_auth,3,required" form:"require_auth,required" json:"require_auth,required"`
	// 密码保护:require_auth 时必填
	Password *string `thrift:"password,4,optional" form:"password" json:"password,omitempty"`
	// 文件备注(可空):随分享展示给取件人,文件+文本一并投递(2026-10-12 #489)
	Note *string `thrift:"note,5,optional" form:"note" json:"note,omitempty"`
}

type ShareFileResp 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    *ShareData `thrift:"data,3,required" form:"data,required" json:"data,required"`
}

type ShareService interface {
	// ShareText 分享文本
	ShareText(ctx context.Context, req *ShareTextReq) (r *ShareTextResp, err error)
	// ShareFile 分享文件
	ShareFile(ctx context.Context, req *ShareFileReq) (r *ShareFileResp, err error)
	// GetShare 获取分享内容
	GetShare(ctx context.Context, req *GetShareReq) (r *GetShareResp, err error)
	// DownloadFile 下载文件
	DownloadFile(ctx context.Context, req *DownloadFileReq) (r *DownloadFileResp, err error)
	// ==================== 用户分享管理（2026-10-09 自 customHandler 收敛进 IDL） ====================
	// UserSharesList 我的分享列表（登录用户；认证在 handler 内 requireLogin 语义不变）
	UserSharesList(ctx context.Context, req *UserSharesListReq) (r *UserSharesListResp, err error)
	// UserSharesBatchDelete 批量软删除（回收站）
	UserSharesBatchDelete(ctx context.Context, req *UserShareCodesReq) (r *UserShareOpResp, err error)
	// UserSharesBatchExtend 批量延期
	UserSharesBatchExtend(ctx context.Context, req *UserShareBatchExtendReq) (r *UserShareOpResp, err error)
	// UserSharesRestore 恢复软删除的分享
	UserSharesRestore(ctx context.Context, req *UserShareCodeReq) (r *UserShareOpResp, err error)
	// UserSharesHardDelete 永久删除（仅回收站内）
	UserSharesHardDelete(ctx context.Context, req *UserShareCodeReq) (r *UserShareOpResp, err error)
}

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

type ShareServiceDownloadFileArgs struct {
	Req *DownloadFileReq `thrift:"req,1"`
}

type ShareServiceDownloadFileResult struct {
	Success *DownloadFileResp `thrift:"success,0,optional"`
}

type ShareServiceGetShareArgs struct {
	Req *GetShareReq `thrift:"req,1"`
}

type ShareServiceGetShareResult struct {
	Success *GetShareResp `thrift:"success,0,optional"`
}

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

type ShareServiceShareFileArgs struct {
	Req *ShareFileReq `thrift:"req,1"`
}

type ShareServiceShareFileResult struct {
	Success *ShareFileResp `thrift:"success,0,optional"`
}

type ShareServiceShareTextArgs struct {
	Req *ShareTextReq `thrift:"req,1"`
}

type ShareServiceShareTextResult struct {
	Success *ShareTextResp `thrift:"success,0,optional"`
}

type ShareServiceUserSharesBatchDeleteArgs struct {
	Req *UserShareCodesReq `thrift:"req,1"`
}

type ShareServiceUserSharesBatchDeleteResult struct {
	Success *UserShareOpResp `thrift:"success,0,optional"`
}

type ShareServiceUserSharesBatchExtendArgs struct {
	Req *UserShareBatchExtendReq `thrift:"req,1"`
}

type ShareServiceUserSharesBatchExtendResult struct {
	Success *UserShareOpResp `thrift:"success,0,optional"`
}

type ShareServiceUserSharesHardDeleteArgs struct {
	Req *UserShareCodeReq `thrift:"req,1"`
}

type ShareServiceUserSharesHardDeleteResult struct {
	Success *UserShareOpResp `thrift:"success,0,optional"`
}

type ShareServiceUserSharesListArgs struct {
	Req *UserSharesListReq `thrift:"req,1"`
}

type ShareServiceUserSharesListResult struct {
	Success *UserSharesListResp `thrift:"success,0,optional"`
}

type ShareServiceUserSharesRestoreArgs struct {
	Req *UserShareCodeReq `thrift:"req,1"`
}

type ShareServiceUserSharesRestoreResult struct {
	Success *UserShareOpResp `thrift:"success,0,optional"`
}

type ShareTextReq struct {
	Text        string `thrift:"text,1,required" form:"text,required" json:"text,required"`
	ExpireValue int32  `thrift:"expire_value,2,required" form:"expire_value,required" json:"expire_value,required"`
	// minute, hour, day, week, month, year, forever, count(count=按取件次数)
	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 时必填(前端 multipart form 发送;此前 handler DefaultPostForm 直读)
	Password *string `thrift:"password,5,optional" form:"password" json:"password,omitempty"`
	// 自定义取件码(P3):仅登录用户可指定(防匿名抢注)
	CustomCode *string `thrift:"custom_code,6,optional" form:"custom_code" json:"custom_code,omitempty"`
	// E2E 密文分享:true 时文本跳过 HTML 转义(转义会破坏解密)
	Encrypted *bool `thrift:"encrypted,7,optional" form:"encrypted" json:"encrypted,omitempty"`
}

type ShareTextResp 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    *ShareData `thrift:"data,3,required" form:"data,required" json:"data,required"`
}

type UserShareBatchExtendReq struct {
	Codes []string `thrift:"codes,1,required,list<string>" form:"codes,required" json:"codes,required"`
	// 延长小时数（>0）
	Hours *int32 `thrift:"hours,2,optional" form:"hours" json:"hours,omitempty"`
	// true = 设为永久
	Forever *bool `thrift:"forever,3,optional" form:"forever" json:"forever,omitempty"`
}

type UserShareCodeReq struct {
	Code string `thrift:"code,1,required" json:"code,required" path:"code,required"`
}

type UserShareCodesReq struct {
	Codes []string `thrift:"codes,1,required,list<string>" form:"codes,required" json:"codes,required"`
}

type UserShareItemData struct {
	ID   int64  `thrift:"id,1,required" form:"id,required" json:"id,required"`
	Code string `thrift:"code,2,required" form:"code,required" json:"code,required"`
	// 6 位取件码（落库持久化；空 = 未铸造：E2E/历史数据）
	PickupCode *string `thrift:"pickup_code,3,optional" form:"pickup_code" json:"pickup_code,omitempty"`
	FileName   string  `thrift:"file_name,4,required" form:"file_name,required" json:"file_name,required"`
	FilePath   string  `thrift:"file_path,5,required" form:"file_path,required" json:"file_path,required"`
	Size       int64   `thrift:"size,6,required" form:"size,required" json:"size,required"`
	Text       string  `thrift:"text,7,required" form:"text,required" json:"text,required"`
	// RFC3339Nano
	ExpiredAt *string `thrift:"expired_at,8,optional" form:"expired_at" json:"expired_at,omitempty"`
	// -1=无限, 0=耗尽, >0=剩余
	ExpiredCount int32  `thrift:"expired_count,9,required" form:"expired_count,required" json:"expired_count,required"`
	UsedCount    int32  `thrift:"used_count,10,required" form:"used_count,required" json:"used_count,required"`
	RequireAuth  bool   `thrift:"require_auth,11,required" form:"require_auth,required" json:"require_auth,required"`
	UploadType   string `thrift:"upload_type,12,required" form:"upload_type,required" json:"upload_type,required"`
	// RFC3339Nano
	CreatedAt string `thrift:"created_at,13,required" form:"created_at,required" json:"created_at,required"`
	UpdatedAt string `thrift:"updated_at,14,required" form:"updated_at,required" json:"updated_at,required"`
	// 回收站
	DeletedAt   *string `thrift:"deleted_at,15,optional" form:"deleted_at" json:"deleted_at,omitempty"`
	ViewerIP    string  `thrift:"viewer_ip,16,required" form:"viewer_ip,required" json:"viewer_ip,required"`
	ViewerAt    *string `thrift:"viewer_at,17,optional" form:"viewer_at" json:"viewer_at,omitempty"`
	ViewerCount int32   `thrift:"viewer_count,18,required" form:"viewer_count,required" json:"viewer_count,required"`
	IsExpired   bool    `thrift:"is_expired,19,required" form:"is_expired,required" json:"is_expired,required"`
	IsTextShare bool    `thrift:"is_text_share,20,required" form:"is_text_share,required" json:"is_text_share,required"`
	// normal/blocked/pending_review
	Status string `thrift:"status,21,required" form:"status,required" json:"status,required"`
	// P0 多文件：子文件数
	FileCount int32 `thrift:"file_count,22,required" form:"file_count,required" json:"file_count,required"`
	// 文件备注（可空）
	Note *string `thrift:"note,23,optional" form:"note" json:"note,omitempty"`
	// 逐条取件明细（2026-10-24 新增）：一次取件 = 一次内容交付 = 一个取件凭证，
	// 同一凭证至多扣 1 次 ⇒ 明细按「取件会话」记（多文件逐个下载/断点续传算同一次）。
	// 此前 owner 侧只有「最后一次取件 IP + 累计次数」⇒ 看不到逐条历史。
	Pickups []*PickupRecord `thrift:"pickups,24,optional,list<PickupRecord>" form:"pickups" json:"pickups,omitempty"`
}

type UserShareOpResp 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    map[string]int32 `thrift:"data,3,optional" form:"data" json:"data,omitempty"`
}

type UserSharesListData struct {
	Items      []*UserShareItemData `thrift:"items,1,required,list<UserShareItemData>" form:"items,required" json:"items,required"`
	Total      int64                `thrift:"total,2,required" form:"total,required" json:"total,required"`
	Page       int32                `thrift:"page,3,required" form:"page,required" json:"page,required"`
	PageSize   int32                `thrift:"page_size,4,required" form:"page_size,required" json:"page_size,required"`
	TotalPages int64                `thrift:"total_pages,5,required" form:"total_pages,required" json:"total_pages,required"`
	HasNext    bool                 `thrift:"has_next,6,required" form:"has_next,required" json:"has_next,required"`
	HasPrev    bool                 `thrift:"has_prev,7,required" form:"has_prev,required" json:"has_prev,required"`
}

type UserSharesListReq struct {
	// all/active/expired/text/file/deleted
	Status *string `thrift:"status,1,optional" json:"status,omitempty" query:"status"`
	// 分享码/取件码/文件名模糊
	Search   *string `thrift:"search,2,optional" json:"search,omitempty" query:"search"`
	Page     *int32  `thrift:"page,3,optional" json:"page,omitempty" query:"page"`
	PageSize *int32  `thrift:"page_size,4,optional" json:"page_size,omitempty" query:"page_size"`
}

type UserSharesListResp 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    *UserSharesListData `thrift:"data,3,optional" form:"data" json:"data,omitempty"`
}