client

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

type ClientError struct {
	Code    string
	Message string
	Cause   error
}

type Config struct {
	// VersionTrack服务器地址
	ServerURL string
	// API密钥（必须）
	APIKey string
	// 平台信息 (windows/linux/macos)
	Platform string
	// 架构信息 (amd64/arm64)
	Arch string
	// HTTP请求超时时间
	Timeout time.Duration
	// 需要保护的文件列表（更新时不覆盖）
	PreserveFiles []string
	// 备份保留数量
	BackupCount int
	// 更新模式
	UpdateMode UpdateMode
	// 跳过的版本列表
	SkipVersions []string
}

type DownloadProgress struct {
	// 已下载字节数
	Downloaded int64
	// 总字节数
	Total int64
	// 下载速度 (bytes/second)
	Speed int64
	// 百分比
	Percentage float64
}

type ProgressCallback func(progress *DownloadProgress)

type UpdateFile struct {
	ID                 string `json:"id"`
	VersionID          string `json:"versionId"`
	FileName           string `json:"fileName"`
	FilePath           string `json:"filePath"`
	FileSize           int64  `json:"fileSize"`
	FileHash           string `json:"fileHash"`
	Platform           string `json:"platform"`
	Arch               string `json:"arch"`
	FileType           string `json:"fileType"`
	DownloadURL        string `json:"downloadUrl"`
	IsCompressed       bool   `json:"isCompressed"`
	CompressionType    string `json:"compressionType"`
	Signature          string `json:"signature"`
	SignatureAlgorithm string `json:"signatureAlgorithm"`
	UploadStatus       string `json:"uploadStatus"`
}

type UpdateInfo struct {
	// 是否有更新
	HasUpdate bool `json:"hasUpdate"`
	// 最新版本详情 - 修改为字符串类型
	LatestVersion string `json:"latestVersion"`
	// 当前版本
	CurrentVersion string `json:"currentVersion"`
	// 更新文件列表
	UpdateFiles []UpdateFile `json:"updateFiles"`
	// 是否强制更新
	IsForced bool `json:"isForced"`
	// 下载URL (从第一个匹配的文件获取)
	DownloadURL string `json:"-"`
	// 文件大小 (从第一个匹配的文件获取)
	FileSize int64 `json:"-"`
	// MD5哈希值 (从第一个匹配的文件获取)
	MD5Hash string `json:"-"`
	// 发布说明 (从版本详情获取)
	ReleaseNotes string `json:"-"`
	// 发布时间 (从版本详情获取)
	PublishedAt string `json:"-"`
	// 可用版本列表（新增）
	AvailableVersions []VersionInfo `json:"availableVersions"`
	// 更新策略（新增）
	UpdateStrategy UpdateStrategy `json:"updateStrategy"`
}

type UpdateMode string

type UpdateRecord struct {
	// 版本号
	Version string `json:"version"`
	// 更新时间
	UpdatedAt time.Time `json:"updatedAt"`
	// 更新状态
	Status string `json:"status"`
	// 备份路径
	BackupPath string `json:"backupPath"`
}

type UpdateStrategy struct {
	HasForced          bool   `json:"hasForced"`
	MinRequiredVersion string `json:"minRequiredVersion"`
}

type Updater interface {
	// CheckForUpdates 检查是否有可用更新（旧版本，保持兼容）
	CheckForUpdates(ctx context.Context, currentVersion string) (*UpdateInfo, error)

	// CheckForMultipleUpdates 检查多版本更新（新版本）
	CheckForMultipleUpdates(ctx context.Context, currentVersion string) (*UpdatesInfo, error)

	// GetRecommendedUpdate 获取推荐更新版本（自动模式）
	GetRecommendedUpdate(ctx context.Context, currentVersion string) (*VersionInfo, error)

	// UpdateToVersion 手动选择版本更新
	UpdateToVersion(ctx context.Context, targetVersion string, callback ProgressCallback) error

	// HasForcedUpdate 检查是否有强制更新
	HasForcedUpdate(ctx context.Context, currentVersion string) (*VersionInfo, error)

	// Download 下载更新文件
	Download(ctx context.Context, info *UpdateInfo, destPath string, callback ProgressCallback) error

	// DownloadVersion 下载指定版本
	DownloadVersion(ctx context.Context, versionInfo *VersionInfo, destPath string, callback ProgressCallback) error

	// Update 执行更新
	Update(ctx context.Context, info *UpdateInfo, downloadPath string) error

	// GetUpdateHistory 获取更新历史
	GetUpdateHistory() []UpdateRecord

	// Rollback 回滚到指定版本
	Rollback(ctx context.Context, version string) error
}

type UpdatesInfo struct {
	// 是否有更新
	HasUpdate bool `json:"hasUpdate"`
	// 当前版本
	CurrentVersion string `json:"currentVersion"`
	// 最新版本
	LatestVersion string `json:"latestVersion"`
	// 可用版本列表
	AvailableVersions []VersionInfo `json:"availableVersions"`
	// 更新策略
	UpdateStrategy UpdateStrategy `json:"updateStrategy"`
}

type VersionDetail struct {
	ID                 string `json:"id"`
	ProjectID          string `json:"projectId"`
	Version            string `json:"version"`
	VersionWeight      int64  `json:"versionWeight"` // 版本权重，用于排序比较
	VersionName        string `json:"versionName"`
	Changelog          string `json:"changelog"`
	Status             string `json:"status"`             // 版本状态
	IsDownloadable     bool   `json:"isDownloadable"`     // 是否可下载
	DownloadableStatus string `json:"downloadableStatus"` // 下载状态描述
	ScheduledReleaseAt string `json:"scheduledReleaseAt"` // 预定发布时间（scheduled状态使用）
	CreatedBy          string `json:"createdBy"`
	PublishedAt        string `json:"publishedAt"`
}

type VersionInfo struct {
	Version            string `json:"version"`
	VersionWeight      int64  `json:"versionWeight"` // 版本权重，用于排序比较
	Changelog          string `json:"changelog"`
	ReleaseDate        string `json:"releaseDate"`
	DownloadURL        string `json:"downloadUrl"`
	FileSize           int64  `json:"fileSize"`
	FileHash           string `json:"fileHash"`
	Status             string `json:"status"`             // 版本状态 (draft, published, recalled, archived, scheduled)
	IsDownloadable     bool   `json:"isDownloadable"`     // 是否可下载
	DownloadableStatus string `json:"downloadableStatus"` // 下载状态描述
	ScheduledReleaseAt string `json:"scheduledReleaseAt"` // 预定发布时间（scheduled状态使用）
	IsForced           bool   `json:"isForced"`           // 是否强制更新
}