runtime

type CommandRunner interface {
	Run(ctx context.Context, name string, args ...string) ([]byte, error)
}

type CommandRunnerFunc func(ctx context.Context, name string, args ...string) ([]byte, error)

type Deps struct {
	HTTPClient apiclient.HttpRequestDoer
	// APIBaseURL overrides the compiled cloud API URL for tests. Synthetic
	// local configs supply their API URL through ConfigLoader instead.
	APIBaseURL   string
	OpenBrowser  func(string) error
	NewTimer     func(time.Duration) Timer
	NewTicker    func(time.Duration) Ticker
	ConfigLoader func() (*config.Config, error)
	// LocalMode makes session-built API clients send no credential. Local mode
	// is a single-tenant sandbox; the local server defaults an absent credential
	// to the pre-provisioned local user. Set by the local command wiring.
	LocalMode           bool
	LocalCommandRunner  CommandRunner
	UpdateCommandRunner CommandRunner
	GitCommandRunner    CommandRunner
	ExecutablePath      string
	UpdateGitHubAPIURL  string
	CommandPathPrefix   string
	// DocsCacheDir overrides the base cache directory used by `volcano docs`.
	// Empty uses os.UserCacheDir()/volcano. Tests inject a t.TempDir().
	DocsCacheDir string
	// DocsGitHubAPIURL overrides the GitHub API base (default
	// https://api.github.com) for docs sync. Tests point this at an httptest
	// server.
	DocsGitHubAPIURL string
	// DocsRawBaseURL selects raw-host downloads (e.g.
	// https://raw.githubusercontent.com) for public sources. It is empty by
	// default: downloads then go through the authenticated GitHub contents API
	// (which also works for private repos). Tests may point it at an httptest
	// server to exercise the raw-host path.
	DocsRawBaseURL string
	// Now overrides the wall clock for deterministic freshness/staleness tests.
	Now func() time.Time
}

type Ticker interface {
	C() <-chan time.Time
	Reset(time.Duration)
	Stop()
}

type Timer interface {
	C() <-chan time.Time
	Stop()
}