Class OAuthHelper

A helper to make using authenticated oauth requests without needing a new client instance.

Index

Constructors

Methods

addGuildMember getApplication getCurrentAuthorizationInformation getCurrentConnections getCurrentGuildMember getCurrentGuilds getCurrentUser revokeToken updateRoleConnection constructURL

Constructors

constructor

new OAuthHelper(manager, token): OAuthHelper
Parameters
- manager: RESTManager
- token: string
Returns OAuthHelper
- Defined in lib/rest/OAuthHelper.ts:33

Methods

addGuildMember

addGuildMember(guildID, userID, options?): Promise<undefined | Member>
Parameters
- guildID: string
- userID: string
- Optional options: Omit<AddMemberOptions, "accessToken">
Returns Promise<undefined | Member>
- Defined in lib/rest/OAuthHelper.ts:69

getApplication

getApplication(): Promise<OAuthApplication>
Get the current OAuth2 application's information.

Returns Promise<OAuthApplication>
- Defined in lib/rest/OAuthHelper.ts:76

getCurrentAuthorizationInformation

getCurrentAuthorizationInformation(): Promise<AuthorizationInformation>
Get information about the current authorization.

Returns Promise<AuthorizationInformation>
- Defined in lib/rest/OAuthHelper.ts:87

getCurrentConnections

getCurrentConnections(): Promise<Connection[]>
Get the connections of the currently authenticated user.

Note: Requires the connections scope.

Returns Promise<Connection[]>
- Defined in lib/rest/OAuthHelper.ts:105

getCurrentGuildMember

getCurrentGuildMember(guild): Promise<Member>
Get the guild member information about the currently authenticated user.

Note: Requires the guilds.members.read scope.
Parameters
- guild: string
  the ID of the guild
Returns Promise<Member>
- Defined in lib/rest/OAuthHelper.ts:130

getCurrentGuilds

getCurrentGuilds(): Promise<OAuthGuild[]>
Get the currently authenticated user's guilds. Note these are missing several properties gateway guilds have.

Returns Promise<OAuthGuild[]>
- Defined in lib/rest/OAuthHelper.ts:141

getCurrentUser

getCurrentUser(): Promise<ExtendedUser>
Get the currently authenticated user's information.

Note: This does not touch the client's cache in any way.

Returns Promise<ExtendedUser>
- Defined in lib/rest/OAuthHelper.ts:154

revokeToken

revokeToken(options): Promise<void>
Revoke the used access token.
Parameters
- options: Omit<RevokeTokenOptions, "token">
  The options for revoking the token.
Returns Promise<void>
- Defined in lib/rest/OAuthHelper.ts:167

updateRoleConnection

updateRoleConnection(applicationID, data): Promise<RoleConnection>
Update the authenticated user's role connection object for an application. This requires the role_connections.write scope.
Parameters
- applicationID: string
  The ID of the application.
- data: UpdateUserApplicationRoleConnectionOptions
  The metadata to update.
Returns Promise<RoleConnection>
- Defined in lib/rest/OAuthHelper.ts:184

`Static` constructURL

constructURL(options): string
Construct an oauth authorization url.
Parameters
- options: OAuthURLOptions
  The options to construct the url with.
Returns string
- Defined in lib/rest/OAuthHelper.ts:42