oauth2

type AuthorizationURLParams struct {
	RedirectURI        string
	Permissions        discord.Permissions
	GuildID            snowflake.ID
	DisableGuildSelect bool
	IntegrationType    discord.ApplicationIntegrationType
	Scopes             []discord.OAuth2Scope
}

type Client struct {
	ID              snowflake.ID
	Secret          string
	Rest            rest.OAuth2
	StateController StateController
}

type ConfigOpt func(config *config)

type Session struct {
	// AccessToken allows requesting user information
	AccessToken string `json:"access_token"`

	// RefreshToken allows refreshing the AccessToken
	RefreshToken string `json:"refresh_token"`

	// Scopes returns the discord.OAuth2Scope(s) of the Session
	Scopes []discord.OAuth2Scope `json:"scopes"`

	// TokenType returns the discord.TokenType of the AccessToken
	TokenType discord.TokenType `json:"token_type"`

	// Expiration returns the time.Time when the AccessToken expires and needs to be refreshed
	Expiration time.Time `json:"expiration"`
}

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

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

type StateControllerConfigOpt func(config *stateControllerConfig)