update

type Asset struct {
	Name string `json:"name"`
	URL  string `json:"url"`
	Size int64  `json:"size"`
}

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
	// Writable 为真表示二进制所在目录可写。
	Writable bool
	// OS 与 Arch 是当前平台，用来挑发布资产。
	OS   string
	Arch string
	// Err 是探测过程中的错误描述，空串表示探测正常。
	Err string
}

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 Service struct {
	// contains filtered or unexported fields
}

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

type UpdateProgress struct {
	Phase Phase `json:"phase" doc:"idle / downloading / installing / restarting / ready / failed"`
	// Version 是这次要装的版本。
	Version string `json:"version,omitempty"`
	// Downloaded 与 Total 只在下载阶段有意义，Total 为 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:"是否运行在容器中"`
	// 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"`
}

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