selfupdate

type NotWritableError struct {
	Path string
	Err  error
}

type Options struct {
	// BaseURL is the release prefix. "" uses $VIGOLIUM_UPDATE_BASE_URL, then
	// DefaultBaseURL. It must be https (plain http only to a loopback host).
	BaseURL string
	// CurrentVersion is the running binary's version ("v0.5.2"). A value that
	// is not semver (a dev build) is always treated as behind.
	CurrentVersion string
	// Target is the binary to replace. "" resolves the running executable
	// through symlinks.
	Target string
	// InstallDir, when set, installs <InstallDir>/vigolium instead of replacing
	// Target. The directory is created when missing.
	InstallDir string
	// GOOS/GOARCH select the archive; "" uses the running platform.
	GOOS, GOARCH string
	// DryRun resolves the version, verifies the signed checksums and probes
	// that the target is writable, but downloads and replaces nothing.
	DryRun bool

	// Client is the HTTP client; nil uses a client with a 10 minute timeout.
	Client *http.Client
	// TrustedKeys overrides the built-in release keys. For tests only.
	TrustedKeys []string
	// MaxArchiveBytes / MaxBinaryBytes override the size caps (0 = default).
	MaxArchiveBytes int64
	MaxBinaryBytes  int64
	// VerifyBinary checks the extracted binary before it replaces anything.
	// nil runs `<path> version --json` and compares the reported version.
	VerifyBinary func(ctx context.Context, path, wantVersion string) error
	// Logf receives one line per step for human progress output. Optional.
	Logf func(format string, args ...any)
}

type Result struct {
	From            string `json:"from"`
	To              string `json:"to"`
	Path            string `json:"path"`
	BaseURL         string `json:"base_url"`
	UpdateAvailable bool   `json:"update_available"`
	Changed         bool   `json:"changed"`
	DryRun          bool   `json:"dry_run,omitempty"`
	Archive         string `json:"archive,omitempty"`
	SHA256          string `json:"sha256,omitempty"`
}