binarymgr

type BinaryInfo struct {
	Path     string
	Version  string
	Checksum string
}

type EnsureResult struct {
	Info *BinaryInfo

	// Downloaded is true when this call actually downloaded and installed
	// the binary (vs. returning an existing installation or a custom path).
	Downloaded bool

	// AutoDownloadPreference is set to "true" when the user opted into
	// automatic future downloads during the prompt. Empty otherwise.
	AutoDownloadPreference string
}

type Executor func(ctx context.Context, binaryPath string, args []string) error

type Extractor func(srcPath, destDir string) (binaryPath string, err error)

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

type Platform struct {
	OS   string
	Arch string
}

type Runner struct {
	IO       *iostreams.IOStreams
	Cfg      config.Config
	Spec     Spec
	Manager  *Manager
	Executor Executor

	// Update / Install / Yes mirror the glab-owned flags after the
	// caller has parsed them out of the cobra args. Args holds the
	// remaining pass-through args destined for the managed binary.
	Update  bool
	Install bool
	Yes     bool
	Args    []string

	// UpdateCommand is the glab subcommand chain shown to users in the
	// "Run 'glab X --update'" hint (e.g. "duo cli", "orbit local").
	// Defaults to Spec.ConfigPrefix if empty.
	UpdateCommand string
}

type Spec struct {
	// DisplayName appears in user-facing prompts and log lines
	// (e.g. "GitLab Duo CLI", "Orbit local CLI").
	DisplayName string

	// ProjectID is the GitLab project ID that hosts the generic package.
	ProjectID string

	// PackageName is the generic-package name (e.g. "duo-cli", "orbit-local").
	PackageName string

	// ConfigPrefix is the config-key namespace. Keys are derived as
	// <prefix>_binary_path, _binary_version, _binary_checksum,
	// _last_update_check, _auto_run, _auto_download.
	ConfigPrefix string

	// EnvVarPrefix is the env-var namespace. Variables are derived as
	// <prefix>_BINARY_PATH, _CHECK_UPDATE.
	EnvVarPrefix string

	// MaxCompatibleMajor caps automatic updates to this major version.
	// 0 disables the cap (every newer version is considered compatible).
	MaxCompatibleMajor int

	// SupportedOS lists the GOOS values the binary is published for.
	SupportedOS []string

	// NormalizeArch converts (GOOS, GOARCH) into the upstream arch name
	// used in asset filenames (e.g. amd64 -> "x64" for duo, "x86_64"
	// for orbit). Should return ErrUnsupportedPlatform-wrapped errors
	// for unsupported combinations.
	NormalizeArch func(goos, goarch string) (string, error)

	// AssetName returns the upstream asset filename for a (os, arch) pair
	// (e.g. "duo-darwin-arm64", "orbit-local-darwin-aarch64.tar.gz").
	AssetName func(os, arch string) string

	// InstalledName returns the local filename of the installed binary
	// (e.g. "duo", "duo.exe", "orbit"). The install directory is shared
	// across managed binaries (<config-dir>/bin).
	InstalledName func(os string) string

	// Extract optionally transforms the downloaded asset into a binary on
	// disk. nil means the downloaded file IS the binary. TarGzExtractor is
	// the typical choice for tarball-distributed binaries.
	Extract Extractor
}

type UpdateCheck struct {
	HasUpdate       bool
	LatestVersion   string
	NewMajorVersion string // set when latest exceeds Spec.MaxCompatibleMajor
	NewCheckTime    time.Time
}