downloader

type AddTorrentOptions struct {
	// AddAtPaused 是否以暂停状态添加种子
	// true: 种子添加后处于暂停状态，需要手动启动
	// false: 种子添加后自动开始下载（默认行为）
	// 注意：此参数替代了原有的 autoStart 配置，逻辑相反
	// autoStart=true 等价于 AddAtPaused=false
	AddAtPaused bool

	// SavePath 保存路径（可选）
	// 空字符串表示使用下载器默认路径
	SavePath string

	// Category 种子分类（可选）
	Category string

	// Tags 种子标签（可选，逗号分隔）
	Tags string

	// UploadSpeedLimitMB 上传速度限制 (MB/s)
	// 0 表示不限制
	UploadSpeedLimitMB int

	// AdvanceOptions 高级选项（可选）
	// 用于传递客户端特定的高级配置
	AdvanceOptions map[string]any
}

type AddTorrentResult struct {
	Success bool   // 是否成功
	Message any    // 消息（错误信息或成功信息）
	ID      string // 种子ID（成功时返回）
	Hash    string // 种子哈希
}

type ClientStatus struct {
	UpSpeed int64 // 上传速度 (bytes/s)
	UpData  int64 // 总上传量 (bytes)
	DlSpeed int64 // 下载速度 (bytes/s)
	DlData  int64 // 总下载量 (bytes)
}

type DownloadTaskInfo struct {
	Name          string
	Hash          string
	SizeLeft      int64
	DownloadSpeed int64
	ETA           time.Duration
}

type Downloader interface {
	// Authenticate 认证连接到下载器
	// 返回错误如果认证失败
	Authenticate() error

	// Ping 检查下载器连接是否正常
	Ping() (bool, error)

	// GetClientVersion 获取下载器版本
	GetClientVersion() (string, error)

	// GetClientStatus 获取下载器状态（上传/下载速度等）
	GetClientStatus() (ClientStatus, error)

	// GetClientFreeSpace 获取下载器所在磁盘的可用空间
	// 返回可用空间（字节）
	GetClientFreeSpace(ctx context.Context) (int64, error)

	// GetAllTorrents 获取所有种子列表
	GetAllTorrents() ([]Torrent, error)

	// GetTorrentsBy 根据过滤条件获取种子列表
	GetTorrentsBy(filter TorrentFilter) ([]Torrent, error)

	// GetTorrent 获取单个种子信息
	GetTorrent(id string) (Torrent, error)

	// AddTorrentEx 添加种子到下载器（新接口）
	// url: 种子URL或磁力链接
	// opt: 添加选项
	AddTorrentEx(url string, opt AddTorrentOptions) (AddTorrentResult, error)

	// AddTorrentFileEx 添加种子文件到下载器（新接口）
	// fileData: 种子文件的二进制数据
	// opt: 添加选项
	AddTorrentFileEx(fileData []byte, opt AddTorrentOptions) (AddTorrentResult, error)

	// PauseTorrent 暂停种子
	PauseTorrent(id string) error

	// ResumeTorrent 恢复种子
	ResumeTorrent(id string) error

	// RemoveTorrent 删除种子
	// removeData: 是否同时删除数据文件
	RemoveTorrent(id string, removeData bool) error

	// GetClientPaths 获取下载器配置的保存路径列表
	GetClientPaths() ([]string, error)

	// GetClientLabels 获取下载器配置的标签列表
	GetClientLabels() ([]string, error)

	// GetType 获取下载器类型
	GetType() DownloaderType

	// GetName 获取下载器实例名称
	GetName() string

	// IsHealthy 检查下载器是否健康可用
	IsHealthy() bool

	// Close 关闭下载器连接，释放资源
	Close() error

	// AddTorrent 添加种子到下载器（旧接口，向后兼容）
	// Deprecated: 请使用 AddTorrentFileEx 替代
	AddTorrent(fileData []byte, category, tags string) error

	// AddTorrentWithPath 添加种子到下载器并指定下载路径（旧接口，向后兼容）
	// Deprecated: 请使用 AddTorrentFileEx 替代
	AddTorrentWithPath(fileData []byte, category, tags, downloadPath string) error

	// CheckTorrentExists 检查种子是否已存在于下载器中
	// torrentHash: 种子的 info hash
	// 返回 true 如果种子存在
	CheckTorrentExists(torrentHash string) (bool, error)

	// GetDiskSpace 获取下载器所在磁盘的可用空间
	// Deprecated: 请使用 GetClientFreeSpace 替代
	GetDiskSpace(ctx context.Context) (int64, error)

	// CanAddTorrent 检查是否有足够空间添加指定大小的种子
	// fileSize: 种子文件大小（字节）
	CanAddTorrent(ctx context.Context, fileSize int64) (bool, error)

	// ProcessSingleTorrentFile 处理单个种子文件
	// filePath: 种子文件路径
	// category: 分类
	// tags: 标签
	ProcessSingleTorrentFile(ctx context.Context, filePath, category, tags string) error
}

type DownloaderConfig interface {
	// GetType 获取下载器类型
	GetType() DownloaderType
	// GetURL 获取下载器 URL
	GetURL() string
	// GetUsername 获取用户名
	GetUsername() string
	// GetPassword 获取密码
	GetPassword() string
	// GetAutoStart 获取是否自动开始下载
	// Deprecated: 请使用 AddTorrentOptions.AddAtPaused 替代
	// autoStart=true 等价于 AddAtPaused=false
	GetAutoStart() bool
	// Validate 验证配置是否有效
	Validate() error
}

type DownloaderDBRecord struct {
	Name      string
	Type      DownloaderType
	URL       string
	Username  string
	Password  string
	IsDefault bool
	Enabled   bool
	AutoStart bool
}

type DownloaderFactory func(config DownloaderConfig, name string) (Downloader, error)

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

type DownloaderStatus struct {
	Name        string    `json:"name"`
	Type        string    `json:"type"`
	IsHealthy   bool      `json:"is_healthy"`
	IsDefault   bool      `json:"is_default"`
	LastChecked time.Time `json:"last_checked"`
	ErrorCount  int       `json:"error_count"`
}

type DownloaderType string

type GenericConfig struct {
	Type      DownloaderType `json:"type"`
	URL       string         `json:"url"`
	Username  string         `json:"username"`
	Password  string         `json:"password"`
	AutoStart bool           `json:"auto_start"`
}

type ReconnectConfig struct {
	MaxRetries     int           // 最大重试次数
	InitialBackoff time.Duration // 初始退避时间
	MaxBackoff     time.Duration // 最大退避时间
	Multiplier     float64       // 退避时间乘数
}

type Torrent struct {
	ID              string       // 种子ID
	InfoHash        string       // 种子哈希
	Name            string       // 种子名称
	Progress        float64      // 下载进度 (0.0-1.0)
	IsCompleted     bool         // 是否已完成
	Ratio           float64      // 分享率
	DateAdded       int64        // 添加时间 (Unix timestamp)
	SavePath        string       // 保存路径
	Label           string       // 标签
	State           TorrentState // 状态
	TotalSize       int64        // 总大小 (bytes)
	UploadSpeed     int64        // 上传速度 (bytes/s)
	DownloadSpeed   int64        // 下载速度 (bytes/s)
	TotalUploaded   int64        // 总上传量 (bytes)
	TotalDownloaded int64        // 总下载量 (bytes)
	Raw             any          // 原始数据
	ClientID        string       // 客户端ID
}

type TorrentFilter struct {
	IDs      []string      // 按ID过滤
	Hashes   []string      // 按哈希过滤
	Complete *bool         // 按完成状态过滤
	State    *TorrentState // 按状态过滤
}

type TorrentState string