web

type CacheProvider interface {
	ResolveCacheDir() (string, error)
	List(cacheDir string, opts appcache.ListOptions) (appcache.ListResult, error)
	Status(cacheDir string) (appcache.StatusResult, error)
}

type ConfigProvider interface {
	ConfigInfo() (app.ConfigInfoResult, error)
	ConfigExport(out io.Writer, withGlobal bool) error
	ConfigGet(key string) (any, error)
	ConfigSet(key, value string) error
}

type Deps struct {
	List   ListProvider
	Show   ShowProvider
	Query  QueryProvider
	Search SearchProvider
	Config ConfigProvider
	Cache  CacheProvider
	Ext    ExtProvider

	// Machine handlers serve the cache mirror protocol on its original paths
	// (/manifest.json, /download/*, /files/*).
	Manifest http.HandlerFunc
	Download http.HandlerFunc
	File     http.HandlerFunc

	// AssetCandidates lists the assets matching a target without downloading,
	// so the install form can offer an explicit choice.
	AssetCandidates func(ctx context.Context, target string) ([]string, error)

	// ListWithManagers returns the list provider scoped to a manager selection,
	// which is how /api/outdated filters to eget-only or one external manager
	// without rebuilding the service.
	ListWithManagers func(app.ManagersSelection) ListProvider
}

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

type ExtProvider interface {
	Names() []string
	Manager(name string) (extpkg.Manager, bool)
	Path(manager extpkg.Manager) (string, bool)
	List(ctx context.Context, only ...string) ([]extpkg.Package, []extpkg.Failure, error)
	Outdated(ctx context.Context, only ...string) ([]extpkg.Package, []extpkg.Failure, error)
}

type ListProvider interface {
	ListPackages() ([]app.ListItem, error)
	ListInstalledPackages() ([]app.ListItem, error)
	ListOutdatedPackages() ([]app.OutdatedItem, []app.OutdatedCheckFailure, int, error)
	FindPackage(name string) (*app.ListItem, error)
}

type LogLine struct {
	Time    time.Time `json:"time"`
	Level   string    `json:"level"`
	Message string    `json:"message"`
}

type Options struct {
	Host           string
	Port           int
	Token          string
	ReadOnly       bool
	AllowMutations bool
	Version        string
	CacheRoot      string
	NoCacheIndex   bool
	// AllowHosts adds names to the Host header allow list.
	AllowHosts []string
	JSONLog    bool
	LogWriter  io.Writer
	// TaskStore is the tasks.json path (empty disables persistence).
	TaskStore string
	// TaskRunners maps a task kind to its implementation. Write endpoints are
	// unavailable when it is empty.
	TaskRunners map[string]TaskRunner
}

type QueryProvider interface {
	Query(opts app.QueryOptions) (app.QueryResult, error)
}

type SearchProvider interface {
	Search(opts app.SearchOptions) (app.SearchResult, error)
}

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

type ShowProvider interface {
	ShowPackage(target string) (app.ShowResult, error)
}

type Task struct {
	ID         string         `json:"id"`
	Kind       string         `json:"kind"`
	Params     map[string]any `json:"params,omitempty"`
	Status     TaskStatus     `json:"status"`
	CreatedAt  time.Time      `json:"createdAt"`
	StartedAt  *time.Time     `json:"startedAt,omitempty"`
	FinishedAt *time.Time     `json:"finishedAt,omitempty"`
	Progress   TaskProgress   `json:"progress"`
	Logs       []LogLine      `json:"logs,omitempty"`
	Result     any            `json:"result,omitempty"`
	Error      string         `json:"error,omitempty"`
}

type TaskProgress struct {
	Percent float64 `json:"percent"`
	Phase   string  `json:"phase,omitempty"`
	Current int64   `json:"current,omitempty"`
	Total   int64   `json:"total,omitempty"`
}

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

type TaskRunner func(ctx context.Context, params map[string]any, report *TaskReporter) (any, error)

type TaskStatus string