refactor(oauth2): separate OAuth2 scopes

Author: Vitor

deno/payloads/v10/oauth2.ts

@@ -2,34 +2,44 @@
  * Types extracted from https://discord.com/developers/docs/topics/oauth2
  */
 
-export enum OAuth2Scopes {
+export enum OAuth2PublicUserScopes {
 	/**
-	 * For oauth2 bots, this puts the bot in the user's selected guild by default
+	 * Allows your app to read build data for a user's applications
 	 */
-	Bot = 'bot',
+	ApplicationsBuildsRead = 'applications.builds.read',
+	/**
+	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
+	/**
+	 * Allows your app to read entitlements for a user's applications
+	 */
+	ApplicationsEntitlements = 'applications.entitlements',
+	/**
+	 * Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications
+	 */
+	ApplicationsStoreUpdate = 'applications.store.update',
 	/**
 	 * Allows [/users/@me/connections](https://discord.com/developers/docs/resources/user#get-user-connections)
 	 * to return linked third-party accounts
 	 *
 	 * See https://discord.com/developers/docs/resources/user#get-user-connections
 	 */
 	Connections = 'connections',
-	/**
-	 * Allows your app to see information about the user's DMs and group DMs - requires Discord approval
-	 */
-	DMChannelsRead = 'dm_channels.read',
 	/**
 	 * Enables [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) to return an `email`
 	 *
 	 * See https://discord.com/developers/docs/resources/user#get-current-user
 	 */
 	Email = 'email',
 	/**
-	 * Allows [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) without `email`
+	 * Allows your app to join users to a group dm
 	 *
-	 * See https://discord.com/developers/docs/resources/user#get-current-user
+	 * See https://discord.com/developers/docs/resources/channel#group-dm-add-recipient
 	 */
-	Identify = 'identify',
+	GroupDMJoins = 'gdm.join',
 	/**
 	 * Allows [/users/@me/guilds](https://discord.com/developers/docs/resources/user#get-current-user-guilds)
 	 * to return basic information about all of a user's guilds
@@ -51,78 +61,92 @@ export enum OAuth2Scopes {
 	 */
 	GuildsMembersRead = 'guilds.members.read',
 	/**
-	 * Allows your app to join users to a group dm
+	 * Allows [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) without `email`
 	 *
-	 * See https://discord.com/developers/docs/resources/channel#group-dm-add-recipient
+	 * See https://discord.com/developers/docs/resources/user#get-current-user
 	 */
-	GroupDMJoins = 'gdm.join',
+	Identify = 'identify',
 	/**
 	 * For local rpc server api access, this allows you to read messages from all client channels
 	 * (otherwise restricted to channels/guilds your app creates)
 	 */
 	MessagesRead = 'messages.read',
 	/**
-	 * For local rpc server access, this allows you to control a user's local Discord client - requires Discord approval
+	 * For local rpc server api access, this allows you to receive notifications pushed out to the user
 	 */
-	RPC = 'rpc',
+	RPCNotificationsRead = 'rpc.notifications.read',
+}
+
+export enum OAuth2GuildScopes {
 	/**
-	 * For local rpc server api access, this allows you to receive notifications pushed out to the user - requires Discord approval
+	 * Allows your app to use Application Commands in a guild
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
-	RPCNotificationsRead = 'rpc.notifications.read',
+	ApplicationsCommands = 'applications.commands',
 	/**
-	 * This generates a webhook that is returned in the oauth token response for authorization code grants
+	 * For oauth2 bots, this puts the bot in the user's selected guild by default
 	 */
-	WebhookIncoming = 'webhook.incoming',
+	Bot = 'bot',
+}
+
+export enum OAuth2OtherScopes {
 	/**
-	 * Allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval
+	 * Allows your app to update its Application Commands via this bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
-	Voice = 'voice',
+	ApplicationsCommandsUpdate = 'applications.commands.update',
 	/**
-	 * Allows your app to upload/update builds for a user's applications - requires Discord approval
+	 * This generates a webhook that is returned in the oauth token response for authorization code grants
 	 */
-	ApplicationsBuildsUpload = 'applications.builds.upload',
+	WebhookIncoming = 'webhook.incoming',
+}
+
+export enum OAuth2RestrictedUserScopes {
 	/**
-	 * Allows your app to read build data for a user's applications
+	 * For local rpc server access, this allows you to control a user's local Discord client
 	 */
-	ApplicationsBuildsRead = 'applications.builds.read',
+	RPC = 'rpc',
 	/**
-	 * Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications
+	 * For local rpc server access, this allows you to update a user's activity
 	 */
-	ApplicationsStoreUpdate = 'applications.store.update',
+	RPCActivitiesWrite = 'rpc.activities.write',
 	/**
-	 * Allows your app to read entitlements for a user's applications
+	 * For local rpc server access, this allows you to read a user's voice settings and listen for voice events
 	 */
-	ApplicationsEntitlements = 'applications.entitlements',
+	RPCVoiceRead = 'rpc.voice.read',
 	/**
-	 * Allows your app to know a user's friends and implicit relationships - requires Discord approval
+	 * For local rpc server access, this allows you to update a user's voice settings
 	 */
-	RelationshipsRead = 'relationships.read',
+	RPCVoiceWrite = 'rpc.voice.write',
+}
+
+export enum OAuth2PrivateUserScopes {
 	/**
-	 * Allows your app to fetch data from a user's "Now Playing/Recently Played" list - requires Discord approval
+	 * Allows your app to fetch data from a user's "Now Playing/Recently Played" list
 	 */
 	ActivitiesRead = 'activities.read',
 	/**
-	 * Allows your app to update a user's activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER)
+	 * Allows your app to update a user's activity (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER)
 	 *
 	 * See https://discord.com/developers/docs/game-sdk/activities
 	 */
 	ActivitiesWrite = 'activities.write',
 	/**
-	 * Allows your app to use Application Commands in a guild
-	 *
-	 * See https://discord.com/developers/docs/interactions/application-commands
+	 * Allows your app to upload/update builds for a user's applications
 	 */
-	ApplicationsCommands = 'applications.commands',
+	ApplicationsBuildsUpload = 'applications.builds.upload',
 	/**
-	 * Allows your app to update its Application Commands via this bearer token - client credentials grant only
-	 *
-	 * See https://discord.com/developers/docs/interactions/application-commands
+	 * Allows your app to see information about the user's DMs and group DMs
 	 */
-	ApplicationsCommandsUpdate = 'applications.commands.update',
+	DMChannelsRead = 'dm_channels.read',
 	/**
-	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
-	 *
-	 * See https://discord.com/developers/docs/interactions/application-commands
+	 * Allows your app to know a user's friends and implicit relationships
 	 */
-	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
+	RelationshipsRead = 'relationships.read',
+	/**
+	 * Allows your app to connect to voice on user's behalf and see all the voice members
+	 */
+	Voice = 'voice',
 }

deno/payloads/v9/oauth2.ts

@@ -2,34 +2,44 @@
  * Types extracted from https://discord.com/developers/docs/topics/oauth2
  */
 
-export enum OAuth2Scopes {
+export enum OAuth2PublicUserScopes {
 	/**
-	 * For oauth2 bots, this puts the bot in the user's selected guild by default
+	 * Allows your app to read build data for a user's applications
 	 */
-	Bot = 'bot',
+	ApplicationsBuildsRead = 'applications.builds.read',
+	/**
+	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
+	/**
+	 * Allows your app to read entitlements for a user's applications
+	 */
+	ApplicationsEntitlements = 'applications.entitlements',
+	/**
+	 * Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications
+	 */
+	ApplicationsStoreUpdate = 'applications.store.update',
 	/**
 	 * Allows [/users/@me/connections](https://discord.com/developers/docs/resources/user#get-user-connections)
 	 * to return linked third-party accounts
 	 *
 	 * See https://discord.com/developers/docs/resources/user#get-user-connections
 	 */
 	Connections = 'connections',
-	/**
-	 * Allows your app to see information about the user's DMs and group DMs - requires Discord approval
-	 */
-	DMChannelsRead = 'dm_channels.read',
 	/**
 	 * Enables [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) to return an `email`
 	 *
 	 * See https://discord.com/developers/docs/resources/user#get-current-user
 	 */
 	Email = 'email',
 	/**
-	 * Allows [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) without `email`
+	 * Allows your app to join users to a group dm
 	 *
-	 * See https://discord.com/developers/docs/resources/user#get-current-user
+	 * See https://discord.com/developers/docs/resources/channel#group-dm-add-recipient
 	 */
-	Identify = 'identify',
+	GroupDMJoins = 'gdm.join',
 	/**
 	 * Allows [/users/@me/guilds](https://discord.com/developers/docs/resources/user#get-current-user-guilds)
 	 * to return basic information about all of a user's guilds
@@ -51,78 +61,92 @@ export enum OAuth2Scopes {
 	 */
 	GuildsMembersRead = 'guilds.members.read',
 	/**
-	 * Allows your app to join users to a group dm
+	 * Allows [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) without `email`
 	 *
-	 * See https://discord.com/developers/docs/resources/channel#group-dm-add-recipient
+	 * See https://discord.com/developers/docs/resources/user#get-current-user
 	 */
-	GroupDMJoins = 'gdm.join',
+	Identify = 'identify',
 	/**
 	 * For local rpc server api access, this allows you to read messages from all client channels
 	 * (otherwise restricted to channels/guilds your app creates)
 	 */
 	MessagesRead = 'messages.read',
 	/**
-	 * For local rpc server access, this allows you to control a user's local Discord client - requires Discord approval
+	 * For local rpc server api access, this allows you to receive notifications pushed out to the user
 	 */
-	RPC = 'rpc',
+	RPCNotificationsRead = 'rpc.notifications.read',
+}
+
+export enum OAuth2GuildScopes {
 	/**
-	 * For local rpc server api access, this allows you to receive notifications pushed out to the user - requires Discord approval
+	 * Allows your app to use Application Commands in a guild
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
-	RPCNotificationsRead = 'rpc.notifications.read',
+	ApplicationsCommands = 'applications.commands',
 	/**
-	 * This generates a webhook that is returned in the oauth token response for authorization code grants
+	 * For oauth2 bots, this puts the bot in the user's selected guild by default
 	 */
-	WebhookIncoming = 'webhook.incoming',
+	Bot = 'bot',
+}
+
+export enum OAuth2OtherScopes {
 	/**
-	 * Allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval
+	 * Allows your app to update its Application Commands via this bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
 	 */
-	Voice = 'voice',
+	ApplicationsCommandsUpdate = 'applications.commands.update',
 	/**
-	 * Allows your app to upload/update builds for a user's applications - requires Discord approval
+	 * This generates a webhook that is returned in the oauth token response for authorization code grants
 	 */
-	ApplicationsBuildsUpload = 'applications.builds.upload',
+	WebhookIncoming = 'webhook.incoming',
+}
+
+export enum OAuth2RestrictedUserScopes {
 	/**
-	 * Allows your app to read build data for a user's applications
+	 * For local rpc server access, this allows you to control a user's local Discord client
 	 */
-	ApplicationsBuildsRead = 'applications.builds.read',
+	RPC = 'rpc',
 	/**
-	 * Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications
+	 * For local rpc server access, this allows you to update a user's activity
 	 */
-	ApplicationsStoreUpdate = 'applications.store.update',
+	RPCActivitiesWrite = 'rpc.activities.write',
 	/**
-	 * Allows your app to read entitlements for a user's applications
+	 * For local rpc server access, this allows you to read a user's voice settings and listen for voice events
 	 */
-	ApplicationsEntitlements = 'applications.entitlements',
+	RPCVoiceRead = 'rpc.voice.read',
 	/**
-	 * Allows your app to know a user's friends and implicit relationships - requires Discord approval
+	 * For local rpc server access, this allows you to update a user's voice settings
 	 */
-	RelationshipsRead = 'relationships.read',
+	RPCVoiceWrite = 'rpc.voice.write',
+}
+
+export enum OAuth2PrivateUserScopes {
 	/**
-	 * Allows your app to fetch data from a user's "Now Playing/Recently Played" list - requires Discord approval
+	 * Allows your app to fetch data from a user's "Now Playing/Recently Played" list
 	 */
 	ActivitiesRead = 'activities.read',
 	/**
-	 * Allows your app to update a user's activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER)
+	 * Allows your app to update a user's activity (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER)
 	 *
 	 * See https://discord.com/developers/docs/game-sdk/activities
 	 */
 	ActivitiesWrite = 'activities.write',
 	/**
-	 * Allows your app to use Application Commands in a guild
-	 *
-	 * See https://discord.com/developers/docs/interactions/application-commands
+	 * Allows your app to upload/update builds for a user's applications
 	 */
-	ApplicationsCommands = 'applications.commands',
+	ApplicationsBuildsUpload = 'applications.builds.upload',
 	/**
-	 * Allows your app to update its Application Commands via this bearer token - client credentials grant only
-	 *
-	 * See https://discord.com/developers/docs/interactions/application-commands
+	 * Allows your app to see information about the user's DMs and group DMs
 	 */
-	ApplicationsCommandsUpdate = 'applications.commands.update',
+	DMChannelsRead = 'dm_channels.read',
 	/**
-	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
-	 *
-	 * See https://discord.com/developers/docs/interactions/application-commands
+	 * Allows your app to know a user's friends and implicit relationships
 	 */
-	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
+	RelationshipsRead = 'relationships.read',
+	/**
+	 * Allows your app to connect to voice on user's behalf and see all the voice members
+	 */
+	Voice = 'voice',
 }