authstore

Sep 22, 2026

Changes in this version

+ const MusterClientID

Sep 22, 2026

Changes in this version

+ const UserMuster

type Auth

+ func (a *Auth) LoginMuster(ctx context.Context, endpoint string) (Identity, error)

+ func (a *Auth) RequireMuster(ctx context.Context) (Token, error)

type Identity

+ Endpoint string

type Record

+ Endpoint string

+ Issuer string

type Status

+ Muster Identity

type Token

+ Endpoint string

+ func RequireMuster(ctx context.Context) (Token, error)

Sep 21, 2026

Changes in this version

+ const CircleCIExpiryWarning

+ const GitHubAppClientID

+ const Service

+ const UserCircleCI

+ const UserGitHub

+ var ErrAuthRequired = errors.New("authentication required")

+ var ErrNotFound = errors.New("no record in the keychain")

+ func OpenBrowser(url string) error

+ type Auth struct

+ func New(config Config) (*Auth, error)

+ func Open(stderr io.Writer) (*Auth, error)

+ func (a *Auth) LoginCircleCI(ctx context.Context) (Identity, error)

+ func (a *Auth) LoginGitHub(ctx context.Context) (Identity, error)

+ func (a *Auth) RequireCircleCI(_ context.Context) (Token, error)

+ func (a *Auth) RequireGitHub(ctx context.Context) (Token, error)

+ func (a *Auth) Status() (Status, error)

+ type AuthRequiredError struct

+ Cause string

+ Hint string

+ Identity string

+ func (e *AuthRequiredError) Error() string

+ func (e *AuthRequiredError) ExitCode() int

+ func (e *AuthRequiredError) ExitVerdict() agentcli.Verdict

+ func (e *AuthRequiredError) Is(target error) bool

+ type Config struct

+ Clock agentcli.Clock

+ Endpoints agentcli.Endpoints

+ HTTPClient *http.Client

+ OpenBrowser func(url string) error

+ Stderr io.Writer

+ Store Store

+ type FileStore struct

+ Path string

+ func (s *FileStore) Delete(user string) error

+ func (s *FileStore) Get(user string) (Record, error)

+ func (s *FileStore) Set(user string, record Record) error

+ type Identity struct

+ Expired bool

+ ExpiresAt *time.Time

+ Login string

+ Present bool

+ RefreshExpiresAt *time.Time

+ Refreshable bool

+ Warnings []string

+ func (i Identity) Usable() bool

+ type KeyringStore struct

+ func (KeyringStore) Delete(user string) error

+ func (KeyringStore) Get(user string) (Record, error)

+ func (KeyringStore) Set(user string, record Record) error

+ type Record struct

+ ClientID string

+ ExpiresAt time.Time

+ Login string

+ RedirectURI string

+ RefreshExpiresAt time.Time

+ RefreshToken string

+ Token string

+ type Status struct

+ CircleCI Identity

+ GitHub Identity

+ func NewStatus() Status

+ func (s Status) Check() error

+ type Store interface

+ Delete func(user string) error

+ Get func(user string) (Record, error)

+ Set func(user string, record Record) error

+ func OpenStore(endpoints agentcli.Endpoints) Store

+ type Token struct

+ ExpiresAt time.Time

+ Login string

+ Value string

+ Warning string

+ func RequireCircleCI(ctx context.Context) (Token, error)

+ func RequireGitHub(ctx context.Context) (Token, error)