app

type ConfigInfoResult struct {
	Path   string
	Exists bool
}

type ConfigPathResult struct {
	Target string
	Path   string
	Exists bool
}

type ConfigService struct {
	ConfigPath   string
	Load         func() (*cfgpkg.File, error)
	Save         func(path string, file *cfgpkg.File) error
	RepoMetadata func(repo string) (RepoMetadata, error)
}

type DefaultExecutableReplacer struct{}

type ExecutableReplacer interface {
	Replace(currentPath, replacementPath string) (SelfReplaceResult, error)
}

type ExternalProvider interface {
	List(ctx context.Context, only ...string) ([]extpkg.Package, []extpkg.Failure, error)
	Outdated(ctx context.Context, only ...string) ([]extpkg.Package, []extpkg.Failure, error)
	Upgrade(ctx context.Context, managerName string, names []string) (extpkg.UpgradeResult, error)
	Manager(name string) (extpkg.Manager, bool)
	Names() []string
}

type InstallAllResult struct {
	Name   string
	Target string
	Result RunResult
}

type InstallExtras struct {
	AddToConfig bool
	PackageName string
	PackageOpts install.Options
}

type InstalledLoader interface {
	Load() (*storepkg.Config, error)
}

type InstalledStore interface {
	Record(target string, entry storepkg.Entry) error
}

type Installer interface {
	InstallTarget(target string, opts install.Options, extras ...InstallExtras) (RunResult, error)
}

type LatestCheckTarget struct {
	Name       string
	Repo       string
	SourcePath string
	Package    cfgpkg.Section
	Tag        string
	Asset      string
	Prerelease bool
}

type LatestInfo struct {
	Tag            string
	PublishedAt    time.Time
	AssetID        int64
	AssetName      string
	AssetSize      int64
	AssetUpdatedAt time.Time
	AssetDigest    string
}

type LatestInfoFunc func(target LatestCheckTarget) (LatestInfo, error)

type ListItem struct {
	Name           string
	Repo           string
	SourcePath     string
	Package        cfgpkg.Section
	Target         string
	Tag            string
	Version        string
	InstalledTag   string
	Installed      bool
	InstalledAt    time.Time
	Asset          string
	AssetID        int64
	AssetSize      int64
	AssetUpdatedAt time.Time
	AssetDigest    string
	URL            string
	IsGUI          bool
	InstallMode    string
	Prerelease     bool
	IgnoreUpdate   bool
	// Manager is the external package manager that owns this package, empty for
	// packages eget installed itself.
	Manager string
}

type ListService struct {
	LoadConfig    func() (*cfgpkg.File, error)
	LoadInstalled func() (*storepkg.Config, error)
	LatestInfo    LatestInfoFunc
	OnCheckDone   func(checked, total int)
	// External and Managers add packages owned by external managers. Both are
	// optional: with a zero ManagersSelection nothing external runs at all.
	External ExternalProvider
	Managers ManagersSelection
	// OnExternalFailure reports a manager-level failure while listing. It is a
	// callback because list has no failure channel of its own.
	OnExternalFailure func(extpkg.Failure)
}

type ManagersSelection struct {
	Mode string
	// Managers restricts the selection to these manager names. Empty while Mode
	// is not off means "every configured manager".
	Managers []string
}

type OutdatedCheckFailure struct {
	Name  string
	Repo  string
	Error error
}

type OutdatedItem struct {
	Name         string
	Repo         string
	Target       string
	InstalledTag string
	LatestTag    string
	InstalledAt  time.Time
	PublishedAt  time.Time
	// Manager is set for packages owned by an external package manager.
	Manager string
}

type PackageAdder interface {
	AddPackage(repo, name string, opts install.Options) error
}

type QueryAsset = client.Asset

type QueryClient interface {
	RepoInfo(repo string) (QueryRepoInfo, error)
	LatestRelease(repo string, includePrerelease bool) (QueryRelease, error)
	ListReleases(repo string, limit int, includePrerelease bool) ([]QueryRelease, error)
	ResolveTag(repo, tag string, includePrerelease bool) (string, error)
	ReleaseAssets(repo, tag string) ([]QueryAsset, error)
}

type QueryOptions struct {
	Repo       string
	Action     string
	Tag        string
	Limit      int
	JSON       bool
	Prerelease bool
}

type QueryRelease = client.Release

type QueryRepoInfo = client.RepoInfo

type QueryResult struct {
	Action   string         `json:"action"`
	Repo     string         `json:"repo"`
	Tag      string         `json:"tag,omitempty"`
	Info     *QueryRepoInfo `json:"info,omitempty"`
	Latest   *QueryRelease  `json:"latest,omitempty"`
	Releases []QueryRelease `json:"releases,omitempty"`
	Assets   []QueryAsset   `json:"assets,omitempty"`
	URLInfo  *QueryURLInfo  `json:"url_info,omitempty"`
}

type QueryService struct {
	Client              QueryClient
	SourceForgeLatest   func(project, sourcePath string) (sourcesf.LatestInfo, error)
	SourceForgeReleases func(project, sourcePath string, limit int, includePrerelease bool) ([]sourcesf.LatestInfo, error)
	SourceForgeAssets   func(project, sourcePath, tag string) ([]string, error)
	URLInfo             func(rawURL string) (QueryURLInfo, error)
}

type QueryURLInfo = client.URLInfo

type ReleaseInfoFunc func(repo, url string) (string, time.Time, error)

type RemovableInstalledStore interface {
	Load() (*storepkg.Config, error)
	Remove(target string) error
}

type RepoMetadata struct {
	Desc     string
	Homepage string
	RepoURL  string
}

type RunResult = install.RunResult

type Runner interface {
	Run(target string, opts install.Options) (RunResult, error)
}

type SDKConfigAddItem struct {
	Name   string
	Action string
	Reason string
	Source string
}

type SDKConfigAddOptions struct {
	Name   string
	All    bool
	Force  bool
	Mirror string
}

type SDKConfigAddResult struct {
	Items []SDKConfigAddItem
}

type SearchClient interface {
	SearchRepositories(query string, limit int, sort, order string) (SearchResult, error)
}

type SearchOptions struct {
	Keyword string
	Extras  []string
	Limit   int
	Sort    string
	Order   string
}

type SearchRepo = client.SearchRepo

type SearchResult = client.SearchResult

type SearchService struct {
	Client SearchClient
}

type SelfReplaceResult struct {
	Deferred bool
}

type SelfUpdateInstaller interface {
	DownloadTarget(target string, opts install.Options) (RunResult, error)
}

type SelfUpdateOptions struct {
	CheckOnly bool
	Tag       string
	Source    string
	Asset     []string
	Install   install.Options
}

type SelfUpdateResult struct {
	CurrentVersion string
	LatestVersion  string
	Updated        bool
	Outdated       bool
	Replacement    string
	Executable     string
	Deferred       bool
}

type SelfUpdateService struct {
	CurrentVersion   string
	LatestInfo       LatestInfoFunc
	SourceLatestInfo func(source string, opts install.Options) (LatestInfo, error)
	Installer        SelfUpdateInstaller
	Replacer         ExecutableReplacer
	RuntimeGOOS      string
	RuntimeGOARCH    string
	TempDir          func() (string, error)
	ExecutablePath   func() (string, error)
}

type Service struct {
	Runner       Runner
	Store        InstalledStore
	Config       PackageAdder
	Now          func() time.Time
	ReleaseInfo  ReleaseInfoFunc
	RepoMetadata func(repo string) (RepoMetadata, error)
	LoadConfig   func() (*cfgpkg.File, error)
}

type ShowResult struct {
	Name           string
	Repo           string
	Desc           string
	Homepage       string
	RepoURL        string
	Configured     bool
	Installed      bool
	ConfigTarget   string
	InstallTarget  string
	Version        string
	Tag            string
	TagPolicy      string
	InstalledAt    time.Time
	UpdatedAt      time.Time
	Asset          string
	AssetURL       string
	Tool           string
	ExtractedFiles []string
	IsGUI          bool
	InstallMode    string
	SourcePath     string
	Options        map[string]any
}

type ShowService struct {
	LoadConfig    func() (*cfgpkg.File, error)
	LoadInstalled func() (*storepkg.Config, error)
}

type UninstallOptions struct {
	Purge bool
}

type UninstallResult struct {
	Repo         string
	RemovedFiles []string
	IsGUI        bool
	InstallMode  string
	PurgedConfig string
}

type UninstallService struct {
	Store      RemovableInstalledStore
	LoadConfig func() (*cfgpkg.File, error)
	SaveConfig func(*cfgpkg.File) error
}

type UpdatePackageResult struct {
	Name   string
	Target string
	// Manager is set for packages owned by an external package manager.
	Manager      string
	InstalledTag string
	LatestTag    string
	Updated      bool
	Result       RunResult
}

type UpdateResult struct {
	Name   string
	Target string
	Result RunResult
}

type UpdateService struct {
	Install       Installer
	LoadConfig    func() (*cfgpkg.File, error)
	LoadInstalled func() (*storepkg.Config, error)
	LatestInfo    LatestInfoFunc
	OnCheckDone   func(checked, total int)
	OnUpdateStart func(index, total int, name string)
	// OnUpdateDone reports every finished candidate update. External
	// candidates are silent otherwise: their manager output is captured, not
	// printed like the installer's own progress. Concurrent batch updates
	// call it from several goroutines.
	OnUpdateDone func(item OutdatedItem, result RunResult, err error)
	// External and Managers let updates reach packages owned by external
	// managers. Both are optional: with a zero ManagersSelection only explicit
	// "manager:pkg" targets work.
	External ExternalProvider
	Managers ManagersSelection
}