direct

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

type Settings struct {
	// Endpoint addresses this source. Type is always [forge.SourceTypeDirect];
	// Name selects which configured source this is, and scopes the subtree the
	// fields below are read from.
	//
	// Host is unused: a direct source is addressed entirely by its URL template,
	// which is why two of them must differ by Name rather than by Host.
	Endpoint forge.Endpoint

	// URLTemplate composes the download URL. Required.
	//
	// Placeholders: {version}, {os}, {arch}, {tool}, {ext}.
	URLTemplate string

	// ChecksumURLTemplate and SignatureURLTemplate compose the URLs of the
	// checksums manifest and its detached signature. Empty disables that
	// capability, which the caller sees as [forge.ErrNotSupported].
	ChecksumURLTemplate  string
	SignatureURLTemplate string

	// VersionURL, VersionFormat and VersionKey describe where the latest version
	// is published and how to read it. PinnedVersion short-circuits them.
	VersionURL    string
	VersionFormat string
	VersionKey    string
	PinnedVersion string

	// ToolName fills the {tool} placeholder. A caller that names the tool in
	// URLTemplate directly needs none.
	ToolName string

	// HTTPTransport is the transport this provider builds its client on, so
	// several providers share one connection pool. Nil means it builds its own.
	// Set through the registry with [forge.WithHTTPTransport].
	HTTPTransport http.RoundTripper

	// HTTPClient replaces the client this provider would have built, redirect
	// policy included. Unlike the four provider modules, it IS used for asset
	// downloads here, because every URL this package fetches comes from the
	// operator's own template rather than from release metadata. See
	// connection.go. Set through the registry with [forge.WithHTTPClient].
	HTTPClient *http.Client

	// Credential yields the token this provider authenticates with.
	//
	// Nil is not an error: [NewReleaseProvider] composes the default — the
	// configured key, then TokenFallbackEnv — so construction from
	// configuration alone keeps working. Set it to take over entirely, which
	// is also how a caller holding a token already passes one in:
	//
	//	Credential: forge.StaticCredential(token)
	Credential forge.CredentialSource

	// TokenFallbackEnv names the environment variable consulted last when
	// Credential is nil. Empty means no fallback; the registered factory
	// supplies [DefaultTokenEnv].
	TokenFallbackEnv string

	// Logger receives this provider's diagnostics. Nil discards them, and is
	// never [slog.Default]. See [forge.WithLogger] for the registry route.
	Logger *slog.Logger

	// ConfigWarning describes a configuration problem detected while building
	// these settings. It is NOT an error: the settings are usable and the
	// provider will build. [NewReleaseProvider] logs it at WARN.
	//
	// [SettingsFromConfig] sets it when the configuration it was handed looks
	// like a pre-scoped subtree rather than the root — a mistake that resolves
	// no credential and reports nothing, so a diagnostic is the only way a
	// caller learns of it. See [forge.PreScopedConfig] and spec 0011.
	ConfigWarning error
}