oauth2

type Client struct {
	ID     discord.Snowflake
	Secret string
	Config
}

type Config struct {
	Logger            log.Logger
	RestClient        rest.Client
	RestClientConfig  *rest.Config
	OAuth2Service     rest.OAuth2Service
	SessionController SessionController
	StateController   StateController
}

type ConfigOpt func(config *Config)

type Session interface {
	// AccessToken allows requesting user information
	AccessToken() string

	// RefreshToken allows refreshing the AccessToken
	RefreshToken() string

	// Scopes returns the discord.ApplicationScope(s) of the Session
	Scopes() []discord.ApplicationScope

	// TokenType returns the discord.TokenType of the AccessToken
	TokenType() discord.TokenType

	// Expiration returns the time.Time when the AccessToken expires and needs to be refreshed
	Expiration() time.Time

	// Webhook returns the discord.IncomingWebhook when the discord.ApplicationScopeWebhookIncoming is set
	Webhook() *discord.IncomingWebhook
}

type SessionController interface {
	// GetSession returns the Session for the given identifier or nil if none was found
	GetSession(identifier string) Session

	// CreateSession creates a new Session from the given identifier, access token, refresh token, scope, token type, expiration and webhook
	CreateSession(identifier string, accessToken string, refreshToken string, scopes []discord.ApplicationScope, tokenType discord.TokenType, expiration time.Time, webhook *discord.IncomingWebhook) Session

	// CreateSessionFromExchange creates a new Session from the given identifier and discord.AccessTokenExchange payload
	CreateSessionFromExchange(identifier string, exchange discord.AccessTokenExchange) Session
}

type StateController interface {
	// GenerateNewState generates a new random state to be used as a state
	GenerateNewState(redirectURI string) string

	// ConsumeState validates a state and returns the redirect url or nil if it is invalid
	ConsumeState(state string) *string
}