deviceauth

Oct 28, 2026

Changes in this version

+ var ErrCredentialIssuerMoved = errors.New("deviceauth: credential was saved for a previous issuer")

+ func DefaultIssuerMovedNotice(moved *IssuerMovedError) string

type Client

+ func (c *Client) PreviousIssuers() []string

+ func (c *Client) ServingIssuer() string

type ClientConfig

+ FallbackIssuers []string

+ PreviousIssuers []string

type DeviceLoginOptions

+ IssuerMovedNotice string

+ type IssuerMovedError struct

+ Credential Credential

+ Issuer string

+ PreviousIssuer string

+ func (e *IssuerMovedError) Error() string

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

type Store

+ func NewMigratingStore(current Store, previous ...Store) Store

Sep 19, 2026

Changes in this version

+ var ErrCredentialScopeMismatch = errors.New("deviceauth: credential issuer or client ID does not match")

+ func ValidateRequiredScopes(granted, required []string) error

+ type Authentication struct

+ Credential Credential

+ Identity Identity

+ Login LoginResult

+ SessionToken *oauth2.Token

+ Warnings []error

+ type Client struct

+ func NewClient(config ClientConfig) (*Client, error)

+ func (c *Client) DeviceLogin(ctx context.Context, options DeviceLoginOptions) (LoginResult, error)

+ func (c *Client) DeviceLoginAndStore(ctx context.Context, options DeviceLoginOptions, store Store) (Authentication, error)

+ func (c *Client) Issuer() string

+ func (c *Client) Logout(ctx context.Context, store Store) error

+ func (c *Client) NewKeyringStore() (Store, error)

+ func (c *Client) OAuthConfig() oauth2.Config

+ func (c *Client) Revoke(ctx context.Context, token string) error

+ func (c *Client) ScopedStore(store Store) Store

+ func (c *Client) UserInfo(ctx context.Context, token *oauth2.Token) (Identity, error)

+ type ClientConfig struct

+ ClientID string

+ Issuer string

+ KeyringAccount string

+ KeyringService string

+ RequiredScopes []string

+ Scopes []string

type Credential

+ ClientID string

+ Issuer string

+ type DeviceLoginOptions struct

+ DeviceInfo DeviceInfo

+ ErrorOutput io.Writer

+ OpenBrowser func(string) error

+ Output io.Writer

+ TokenTransformer TokenTransformer

+ type Identity struct

+ Audience []string

+ Email string

+ Name string

+ Scopes []string

+ Subject string

+ type ReplacementRevocationWarning struct

+ Cause error

+ func (e *ReplacementRevocationWarning) Error() string

+ func (e *ReplacementRevocationWarning) Unwrap() error

+ type ResponseError struct

+ OAuthError string

+ Operation string

+ StatusCode int

+ func (e *ResponseError) Error() string

+ type TokenTransformer func(context.Context, *oauth2.Token) (*oauth2.Token, error)

Sep 1, 2026

Changes in this version

+ type DeviceInfo struct

+ Arch string

+ ClientVersion string

+ Name string

+ OS string

type LoginOptions

+ DeviceInfo DeviceInfo

Aug 31, 2026

Changes in this version

+ var ErrCredentialNotFound = errors.New("deviceauth: credential not found")

+ func OpenBrowser(rawURL string) error

+ type Credential struct

+ AccessToken string

+ AccountID string

+ AccountName string

+ Expiry time.Time

+ RefreshToken string

+ Scopes []string

+ TokenType string

+ type FileStore struct

+ func NewFileStore(path string) (*FileStore, error)

+ func (s *FileStore) Delete() error

+ func (s *FileStore) Load() (Credential, error)

+ func (s *FileStore) Save(credential Credential) error

+ type KeyringStore struct

+ func NewKeyringStore(service, account string) (*KeyringStore, error)

+ func (s *KeyringStore) Delete() error

+ func (s *KeyringStore) Load() (Credential, error)

+ func (s *KeyringStore) Save(credential Credential) error

+ type LoginOptions struct

+ ErrorOutput io.Writer

+ OAuthConfig oauth2.Config

+ OpenBrowser func(string) error

+ Output io.Writer

+ type LoginResult struct

+ Authorization *oauth2.DeviceAuthResponse

+ BrowserOpened bool

+ Token *oauth2.Token

+ func Login(ctx context.Context, options LoginOptions) (LoginResult, error)

+ type Store interface

+ Delete func() error

+ Load func() (Credential, error)

+ Save func(Credential) error