plugin

type CatalogClient struct {
	// BaseURL is the catalog base URL for fetching manifests.
	BaseURL string

	// HTTPClient is the HTTP client used for catalog requests.
	HTTPClient *http.Client

	// GetEnv returns the value of an environment variable.
	GetEnv func(key string) string
}

type DigestMatch struct {
	Version  *plugintypes.Version
	Platform *plugintypes.Platform
}

type Handler struct {
	// ReadDir lists directory entries.
	ReadDir func(name string) ([]os.DirEntry, error)

	// Stat returns file info, following symlinks.
	Stat func(name string) (os.FileInfo, error)

	// GetEnv returns the value of an environment variable.
	GetEnv func(key string) string

	// HomeDir returns the current user's home directory.
	HomeDir func() (string, error)
}

type Installer struct {
	// HTTPClient is the HTTP client used for downloading plugin archives.
	HTTPClient *http.Client
}

type Plugin struct {
	// Name is the plugin name, e.g. "operator" (derived from "flux-operator").
	Name string

	// Path is the absolute path to the plugin binary.
	Path string
}

type UpdateResult struct {
	// Name is the plugin name.
	Name string

	// FromVersion is the currently installed version.
	FromVersion string

	// ToVersion is the latest available version.
	ToVersion string

	// Skipped is true when the update was not performed.
	Skipped bool

	// SkipReason explains why the update was skipped.
	SkipReason string

	// Manifest is the resolved plugin manifest for the update.
	Manifest *plugintypes.Manifest

	// Version is the resolved target version for the update.
	Version *plugintypes.Version

	// Platform is the resolved platform entry for the update.
	Platform *plugintypes.Platform

	// Err is set when the update check itself failed.
	Err error
}