shared

type EnvProvider struct {
	// EnvVars is a list of environment variables to check for a token.
	EnvVars []EnvVar
}

type EnvVar struct {
	// Name is the name of the environment variable.
	Name string

	// Type is an optional field that denotes what type of token this.
	Type string
}

type Provider interface {
	// Token returns a valid token or an error if no token is found.
	Token() (*Token, error)
}

type Token struct {
	// FetchedAt is the time that the token was fetched at. This does not
	// need to be set by providers as it is set by the [token.Fetch]
	// function.
	FetchedAt time.Time

	// Value is the token value.
	Value string

	// Source is the source of the token, this is set depending on the
	// provider that provided the token (e.g., `gh` for the Github CLI).
	Source string

	// Type is the type of the token, this is set depending on the
	// provider that provided the token.
	Type string
}