updater

type Artifact struct {
	Filename string `json:"filename"`
	Filetype string `json:"filetype,omitempty"`
	Size     int64  `json:"size,omitempty"`
	Platform string `json:"platform,omitempty"`
	Arch     string `json:"arch,omitempty"`
}

type BuiltinWindow struct {
	// HTML, if non-empty, replaces the default template entirely. The
	// replacement is expected to listen to `updater:*` events and emit
	// `updater:user:*` events using the standard Wails runtime — exactly
	// what the default template does.
	HTML string

	// CSS, if non-empty, is appended to the default template inside a final
	// <style> tag. Ignored when HTML overrides the template entirely.
	CSS string

	// Options overrides the chrome of the built-in window. Zero values fall
	// back to the framework's sensible defaults (small, centred, resizable).
	Options WindowOptions
}

type CheckRequest struct {
	CurrentVersion string
	Platform       string
	Arch           string
}

type Config struct {
	// CurrentVersion is the version currently running. Required.
	// Pass the same string you use to tag releases (e.g. "1.2.3" — no "v" prefix).
	CurrentVersion string

	// Providers are the update sources, tried in order. The first to return
	// a release is used; if a provider returns (nil, nil) the Updater treats
	// the application as up to date and stops walking the chain (fallback is
	// for "primary unreachable", not "providers disagree"). Required.
	Providers []Provider

	// PublicKey is the trust root used to verify release signatures. It is
	// the ONLY trust anchor for signature verification — the release source
	// cannot substitute its own key, since the whole point of pinning a key
	// here is to bind verification to a value the application developer set
	// at build time and the release feed cannot influence.
	//
	// When unset, releases that carry only a Digest still install (the digest
	// is checked against the streaming hash), but any release that carries a
	// Signature is rejected. Strongly recommended for any app whose
	// distribution channel might be compromised or proxied.
	PublicKey []byte

	// CheckInterval, when non-zero, makes the Updater poll providers on a
	// timer in the background. Pop-up-on-found behaviour is the same as a
	// manual Check finding an update.
	CheckInterval time.Duration

	// Platform / Arch / Channel override the per-platform defaults passed to
	// each Provider's Check. Leave empty to use runtime.GOOS / runtime.GOARCH
	// and the provider's default channel.
	Platform string
	Arch     string
	Channel  string

	// Window controls how the update UI is rendered. Not yet wired in v1 of
	// the package; see the upcoming Window option types.
	Window WindowOption
}

type ErrorInfo struct {
	Stage    Stage  `json:"stage"`
	Message  string `json:"message"`
	Provider string `json:"provider,omitempty"`
}

type Host interface {
	// Emit a custom event with the supplied data.
	Emit(name string, data ...any) bool

	// OnEvent registers a callback for a custom event. The returned function
	// removes the listener.
	OnEvent(name string, callback func(payload any)) func()

	// OpenWindow creates and shows an update window. Implementations build
	// a real Wails webview window from opts; tests return a recorder.
	OpenWindow(opts WindowOptions) WindowHandle

	// Quit asks the host application to begin its normal shutdown sequence.
	// Called by Restart after the helper has been spawned so the helper's
	// "wait for parent to exit" step actually completes.
	Quit()
}

type Meta struct {
	CurrentVersion string `json:"currentVersion"`
	SkippedVersion string `json:"skippedVersion,omitempty"`
}

type Progress struct {
	Written  int64   `json:"written"`
	Total    int64   `json:"total"`
	Rate     float64 `json:"rate"` // bytes/sec smoothed over the last ~1s
	Provider string  `json:"provider,omitempty"`
}

type Provider interface {
	// Name identifies the provider in logs and in the `provider` field of
	// progress / error event payloads. Should be stable and short
	// (e.g. "github", "keygen.sh", "appcast").
	Name() string

	// Check returns the available upgrade for the running platform. Return
	// (nil, nil) when the source confirms the caller is already up to date.
	// Errors here put the Updater into the fallback chain.
	Check(ctx context.Context, req CheckRequest) (*Release, error)

	// Download streams the artifact bytes for r to dst. Providers should
	// invoke onProgress periodically; it is never nil.
	Download(ctx context.Context, r *Release, dst io.Writer, onProgress func(written, total int64)) error
}

type Release struct {
	Version      string         `json:"version"`
	Channel      string         `json:"channel,omitempty"`
	Name         string         `json:"name,omitempty"`
	Notes        string         `json:"notes,omitempty"`
	PublishedAt  time.Time      `json:"publishedAt,omitempty"`
	Artifact     Artifact       `json:"artifact"`
	Verification *Verification  `json:"verification,omitempty"`
	Metadata     map[string]any `json:"metadata,omitempty"`

	// Provider is set by the Updater after Check; provider implementations
	// should leave it empty. Used to route a follow-up Download back to the
	// same source.
	Provider string `json:"provider,omitempty"`
}

type Stage string

type State string

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

type Verification struct {
	DigestAlgo    string `json:"digestAlgo,omitempty"`    // "sha256", "sha512"
	Digest        []byte `json:"digest,omitempty"`        // raw digest bytes
	SignatureAlgo string `json:"signatureAlgo,omitempty"` // "ed25519", "ed25519ph", "ecdsa-p256"
	Signature     []byte `json:"signature,omitempty"`     // raw signature bytes
}

type WindowHandle interface {
	EmitEvent(name string, data ...any) bool
	Show()
	Close()
}

type WindowOption interface {
	// contains filtered or unexported methods
}

type WindowOptions struct {
	Title         string
	Width, Height int
	Frameless     bool
	AlwaysOnTop   bool
	DisableResize bool
	InitialHTML   string
}

type WindowSizer interface {
	SetSize(width, height int)
}