update

type Asset struct {
	Name string `json:"name"`
	URL  string `json:"url"`
	Size int64  `json:"size"`
	// SHA256 是 GitHub 接口给出的内容摘要（十六进制小写）；老的发布没有，为空。
	SHA256 string `json:"-"`
}

type Backup struct {
	Name string `json:"name" doc:"备份文件名，删除时用它定位"`
	// Version 是这份备份对应的版本，从文件名解析。
	Version string `json:"version"`
	Size    int64  `json:"size" doc:"字节数"`
	// CreatedAt 取自文件名里的时间戳，不是文件的修改时间——
	// 拷贝、迁移都会改后者，而备份是哪天的这件事不该跟着变。
	CreatedAt time.Time `json:"createdAt"`
}

type BuildInfo struct {
	Version  string `json:"version"`
	Commit   string `json:"commit"`
	Date     string `json:"date"`
	Platform string `json:"platform"`
}

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

type Environment struct {
	// Executable 是当前二进制的绝对路径，已解开符号链接。
	//
	// 解符号链接是必须的：不少部署把 /usr/local/bin/lumo 指到带版本号的实体文件，
	// 替换链接本身会把那套版本管理弄乱，而替换实体才是站长想要的。
	Executable string
	// Dir 是二进制所在目录，新版本先落到这里再原地改名。
	Dir string
	// Container 为真表示跑在容器里。
	Container bool
	// Persistent 为真表示程序文件落在挂载卷上，活得比容器长。
	// 不在容器里时恒为真（宿主机的磁盘本来就不会因为谁重建而消失）。
	Persistent bool
	// MountPoint 是程序文件所属的挂载点，排障时的第一手线索。
	MountPoint string
	// Writable 为真表示二进制所在目录可写。
	Writable bool
	// OS 与 Arch 是当前平台，用来挑发布资产。
	OS   string
	Arch string
	// Err 是探测过程中的错误描述，空串表示探测正常。
	Err string
}

type FetchHooks struct {
	// Source 在开始用某个下载来源时调用，参数是它的域名。
	Source func(name string)
	// Progress 汇报这个来源已下载与总共的字节数，已节流；换来源时从 0 重新算。
	Progress func(done, total int64)
}

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

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

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

type Phase string

type Release struct {
	Tag         string    `json:"tag"`
	Name        string    `json:"name"`
	Notes       string    `json:"notes"`
	HTMLURL     string    `json:"htmlUrl"`
	PublishedAt time.Time `json:"publishedAt"`
	Prerelease  bool      `json:"prerelease"`
	// Version 是从 Tag 解析出的版本，解析失败时为零值。
	Version Version `json:"-"`
	// Asset 是当前平台的发布包。
	Asset Asset `json:"asset"`
	// Checksums 是校验和清单，没有它就不允许安装（见 download.go）。
	Checksums Asset `json:"-"`
}

type Rollback struct {
	// From 是在线升级装过的版本，也就是本该在跑的那个。
	From string `json:"from"`
	// To 是现在实际在跑的版本。
	To string `json:"to"`
	// At 是那次升级的时刻，用来让站长对上「我那天确实升过级」。
	At time.Time `json:"at"`
}

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

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

type UpdateProgress struct {
	Phase Phase `json:"phase" doc:"idle / connecting / downloading / installing / restarting / ready / failed"`
	// Version 是这次要装的版本。
	Version string `json:"version,omitempty"`
	// Source 是正在用的下载来源（域名），测速之前为空。
	Source string `json:"source,omitempty" doc:"正在用的下载来源"`
	// Downloaded 与 Total 只在下载阶段有意义，Total 为 0 表示源没给出长度。换来源时 Downloaded 从 0 重新算。
	Downloaded int64 `json:"downloaded" doc:"已下载字节数"`
	Total      int64 `json:"total" doc:"发布包总字节数，0 表示未知"`
	// Backup 是这次升级留下的备份文件名。
	Backup string `json:"backup,omitempty"`
	// Error 是失败原因，可直接显示。
	Error     string     `json:"error,omitempty"`
	StartedAt *time.Time `json:"startedAt,omitempty"`
	// UpdatedAt 是状态最后一次变化的时刻，界面用它判断任务是不是卡住了。
	UpdatedAt *time.Time `json:"updatedAt,omitempty"`
}

type UpdateStatus struct {
	Enabled bool      `json:"enabled" doc:"功能是否启用，关闭时其余字段仅供展示"`
	Current BuildInfo `json:"current"`
	// Latest 是查到的最新发布，尚未检查或检查失败时为 null。
	Latest *Release `json:"latest,omitempty"`
	// HasUpdate 为真表示 Latest 比当前版本新。
	HasUpdate bool `json:"hasUpdate"`
	// VersionComparable 为假表示当前版本号解析不出来（源码直接构建的开发版），
	// 此时不做「有没有新版本」的判断，只把查到的最新版本摆出来。
	VersionComparable bool       `json:"versionComparable"`
	CheckedAt         *time.Time `json:"checkedAt,omitempty"`
	CheckError        string     `json:"checkError,omitempty"`
	// CanUpdate 为假表示这台机器上不能就地升级，原因在 Reason 里。
	CanUpdate bool   `json:"canUpdate"`
	Reason    string `json:"reason,omitempty" doc:"不能就地升级的原因"`
	Container bool   `json:"container" doc:"是否运行在容器中"`
	// Persistent 为真表示程序文件在挂载卷上，重建容器不会把它换回去。
	Persistent bool `json:"persistent" doc:"程序文件是否活得比容器长"`
	// MountPoint 是程序文件所属的挂载点，容器里排障用。
	MountPoint string `json:"mountPoint,omitempty"`
	// Image 是容器部署该换成的镜像标签，仅在容器里且查到新版本时有值。
	Image string `json:"image,omitempty" doc:"容器部署要换成的镜像引用"`
	// Rollback 非空表示当前跑的版本比在线升级装过的那个旧——多半是容器被重建，
	// 回到了镜像里的版本。
	Rollback *Rollback `json:"rollback,omitempty"`
	// Executable 是当前程序的路径，排障时要看的第一样东西。
	Executable    string         `json:"executable,omitempty"`
	Repo          string         `json:"repo" doc:"更新源仓库"`
	AutoCheck     bool           `json:"autoCheck"`
	CheckInterval string         `json:"checkInterval" doc:"自动检查间隔"`
	Prerelease    bool           `json:"prerelease" doc:"是否把预发布版本算作升级目标"`
	Progress      UpdateProgress `json:"progress"`
	Backups       []Backup       `json:"backups"`
	BackupDir     string         `json:"backupDir"`
	// KeepBackups 是升级后自动保留的备份份数，0 表示不自动清理。
	KeepBackups int `json:"keepBackups"`
	// Mirrors 是下载加速地址，升级时与 GitHub 直连一起测速，挑快的下。
	Mirrors []string `json:"mirrors" doc:"下载加速地址（前缀），空表示只直连 GitHub"`
	// MirrorsCustom 为假表示用的是内置地址，站长没改过。
	MirrorsCustom  bool     `json:"mirrorsCustom" doc:"加速地址是否被站长改过"`
	DefaultMirrors []string `json:"defaultMirrors" doc:"内置的加速地址"`
}

type Version struct {
	Major int
	Minor int
	Patch int
	// Prerelease 是 `-` 之后、`+` 之前的部分，空串表示正式版。
	Prerelease string
	// Raw 是去掉 v 前缀后的原文，回显给界面用。
	Raw string
}