feat(permissions): Slash Permissions v2

index.d.ts

@@ -175,7 +175,8 @@ declare namespace Eris {
   // Application Commands
   interface ApplicationCommand<T extends ApplicationCommandTypes = ApplicationCommandTypes> {
     application_id: string;
-    defaultPermission?: boolean;
+    defaultMemberPermissions?: string;
+    dmPermission?: boolean;
     description: T extends Constants["ApplicationCommandTypes"]["CHAT_INPUT"] ? string : never;
     guild_id?: string;
     id: string;
@@ -682,6 +683,7 @@ declare namespace Eris {
     selfVideo: boolean;
   }
   interface EventListeners {
+    applicationCommandPermissionsUpdate: [applicationCommandPermissions: GuildApplicationCommandPermissions];
     callCreate: [call: Call];
     callDelete: [call: Call];
     callRing: [call: Call];
@@ -1472,8 +1474,9 @@ declare namespace Eris {
       NUMBER:            10;
     };
     ApplicationCommandPermissionTypes: {
-      ROLE: 1;
-      USER: 2;
+      ROLE:    1;
+      USER:    2;
+      CHANNEL: 3;
     };
     ApplicationCommandTypes: {
       CHAT_INPUT: 1;
@@ -2117,7 +2120,6 @@ declare namespace Eris {
     addRelationship(userID: string, block?: boolean): Promise<void>;
     addSelfPremiumSubscription(token: string, plan: string): Promise<void>;
     banGuildMember(guildID: string, userID: string, deleteMessageDays?: number, reason?: string): Promise<void>;
-    bulkEditCommandPermissions(guildID: string, permissions: { id: string; permissions: ApplicationCommandPermissions[] }[]): Promise<GuildApplicationCommandPermissions[]>;
     bulkEditCommands(commands: ApplicationCommandStructure[]): Promise<ApplicationCommand[]>;
     bulkEditGuildCommands(guildID: string, commands: ApplicationCommandStructure[]): Promise<ApplicationCommand[]>;
     closeVoiceConnection(guildID: string): void;
@@ -2234,7 +2236,7 @@ declare namespace Eris {
     createCommand(command: ApplicationCommandStructure): Promise<ApplicationCommand>;
     createGroupChannel(userIDs: string[]): Promise<GroupChannel>;
     createGuild(name: string, options?: CreateGuildOptions): Promise<Guild>;
-    createGuildCommand(guildID: string, command: ApplicationCommandStructure): Promise<ApplicationCommand>;
+    createGuildCommand(guildID: string, command: Omit<ApplicationCommandStructure, "dmPermission">): Promise<Omit<ApplicationCommand, "dmPermission">>;
     createGuildEmoji(guildID: string, options: EmojiOptions, reason?: string): Promise<Emoji>;
     createGuildFromTemplate(code: string, name: string, icon?: string): Promise<Guild>;
     createGuildSticker(guildID: string, options: CreateStickerOptions, reason?: string): Promise<Sticker>;

lib/Client.js

@@ -344,36 +344,23 @@ class Client extends EventEmitter {
         });
     }
 
-    /**
-    * Edits command permissions for a multiple commands in a guild.
-    * Note: You can only add up to 10 permission overwrites for a command.
-    * @arg {String} guildID The guild id
-    * @arg {Array<Object>} permissions An array of [partial guild command permissions](https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-guild-application-command-permissions-structure)
-    * @returns {Promise<Array<Object>>} Returns an array of [GuildApplicationCommandPermissions](https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-guild-application-command-permissions-structure) objects.
-    */
-    bulkEditCommandPermissions(guildID, permissions) {
-        if(!guildID) {
-            throw new Error("You must provide an id of the guild whose permissions you want to edit.");
-        }
-
-        return this.requestHandler.request("PUT", Endpoints.GUILD_COMMAND_PERMISSIONS(this.application.id, guildID), true, permissions);
-    }
-
     /**
     * Bulk create/edit global application commands
     * @arg {Array<Object>} commands An array of [Command objects](https://discord.com/developers/docs/interactions/application-commands#application-command-object)
     * @returns {Promise<Array>} Resolves with an array of commands objects
     */
     bulkEditCommands(commands) {
         for(const command of commands) {
-            if(command.name !== undefined){
+            if(command.name !== undefined) {
                 if(command.type === 1 || command.type === undefined) {
                     command.name = command.name.toLowerCase();
                     if(!command.name.match(/^[\w-]{1,32}$/)) {
                         throw new Error("Slash Command names must match the regular expression \"^[\\w-]{1,32}$\"");
                     }
                 }
             }
+            command.default_member_permissions = command.defaultMemberPermissions;
+            command.dm_permission = command.dmPermission;
         }
         return this.requestHandler.request("PUT", Endpoints.COMMANDS(this.application.id), true, commands);
     }
@@ -386,14 +373,15 @@ class Client extends EventEmitter {
     */
     bulkEditGuildCommands(guildID, commands) {
         for(const command of commands) {
-            if(command.name !== undefined){
+            if(command.name !== undefined) {
                 if(command.type === 1 || command.type === undefined) {
                     command.name = command.name.toLowerCase();
                     if(!command.name.match(/^[\w-]{1,32}$/)) {
                         throw new Error("Slash Command names must match the regular expression \"^[\\w-]{1,32}$\"");
                     }
                 }
             }
+            command.default_member_permissions = command.defaultMemberPermissions;
         }
         return this.requestHandler.request("PUT", Endpoints.GUILD_COMMANDS(this.application.id, guildID), true, commands);
     }
@@ -554,19 +542,21 @@ class Client extends EventEmitter {
     * @arg {String} [command.description] The command description (Slash Commands Only)
     * @arg {Array<Object>} [command.options] An array of [command options](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure)
     * @arg {Number} [type=1] The type of application command, 1 for slash command, 2 for user, and 3 for message
-    * @arg {Boolean} [command.defaultPermission=true] Whether the command is enabled by default when the app is added to a guild
-    * @returns {Promise<Object>} Resolves with a commands object
+    * @arg {String?} [command.defaultMemberPermissions] The default member [permissions](https://discord.com/developers/docs/topics/permissions) represented as a bit set
+    * @arg {Boolean?} [command.dmPermission] Indicates whether the command is available in DMs with the app. By default, commands are visible.
+     * @returns {Promise<Object>} Resolves with a commands object
     */
     createCommand(command) {
-        if(command.name !== undefined){
+        if(command.name !== undefined) {
             if(command.type === 1 || command.type === undefined) {
                 command.name = command.name.toLowerCase();
                 if(!command.name.match(/^[\w-]{1,32}$/)) {
                     throw new Error("Slash Command names must match the regular expression \"^[\\w-]{1,32}$\"");
                 }
             }
         }
-        command.default_permission = command.defaultPermission;
+        command.default_member_permissions = command.defaultMemberPermissions;
+        command.dm_permission = command.dmPermission;
         return this.requestHandler.request("POST", Endpoints.COMMANDS(this.application.id), true, command);
     }
 
@@ -624,19 +614,19 @@ class Client extends EventEmitter {
     * @arg {String} [command.description] The command description (Slash Commands Only)
     * @arg {Array<Object>} [command.options] An array of [command options](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure)
     * @arg {Number} [type=1] The type of application command, 1 for slash command, 2 for user, and 3 for message
-    * @arg {Boolean} [command.defaultPermission] Whether the command is enabled by default when the app is added to a guild
+    * @arg {String?} [command.defaultMemberPermissions] The default member [permissions](https://discord.com/developers/docs/topics/permissions) represented as a bit set
     * @returns {Promise<Object>} Resolves with a commands object
     */
     createGuildCommand(guildID, command) {
-        if(command.name !== undefined){
+        if(command.name !== undefined) {
             if(command.type === 1 || command.type === undefined) {
                 command.name = command.name.toLowerCase();
                 if(!command.name.match(/^[\w-]{1,32}$/)) {
                     throw new Error("Slash Command names must match the regular expression \"^[\\w-]{1,32}$\"");
                 }
             }
         }
-        command.default_permission = command.defaultPermission;
+        command.default_member_permissions = command.defaultMemberPermissions;
         return this.requestHandler.request("POST", Endpoints.GUILD_COMMANDS(this.application.id, guildID), true, command);
     }
 
@@ -1341,22 +1331,24 @@ class Client extends EventEmitter {
     * @arg {String} command.name The command name
     * @arg {String} [command.description] The command description (Slash Commands Only)
     * @arg {Array<Object>} [command.options] An array of [command options](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure)
-    * @arg {Boolean} [command.defaultPermission] Whether the command is enabled by default when the app is added to a guild
-    * @returns {Promise<Object>} Resolves with a commands object
+    * @arg {String?} [command.defaultMemberPermissions] The default member [permissions](https://discord.com/developers/docs/topics/permissions) represented as a bit set
+    * @arg {Boolean?} [command.dmPermission] Indicates whether the command is available in DMs with the app. By default, commands are visible.
+     * @returns {Promise<Object>} Resolves with a commands object
     */
     editCommand(commandID, command) {
         if(!commandID) {
             throw new Error("You must provide an id of the command to edit.");
         }
-        if(command.name !== undefined){
+        if(command.name !== undefined) {
             if(command.type === 1 || command.type === undefined) {
                 command.name = command.name.toLowerCase();
                 if(!command.name.match(/^[\w-]{1,32}$/)) {
                     throw new Error("Slash Command names must match the regular expression \"^[\\w-]{1,32}$\"");
                 }
             }
         }
-        command.default_permission = command.defaultPermission;
+        command.default_member_permissions = command.defaultMemberPermissions;
+        command.dm_permission = command.dmPermission;
         return this.requestHandler.request("PATCH", Endpoints.COMMAND(this.application.id, commandID), true, command);
     }
 
@@ -1434,22 +1426,22 @@ class Client extends EventEmitter {
     * @arg {String} command.name The command name
     * @arg {String} [command.description] The command description (Slash Commands Only)
     * @arg {Array<Object>} [command.options] An array of [command options](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure)
-    * @arg {Boolean} [command.defaultPermission] Whether the command is enabled by default when the app is added to a guild
+    * @arg {String?} [command.defaultMemberPermissions] The default member [permissions](https://discord.com/developers/docs/topics/permissions) represented as a bit set
     * @returns {Promise<Object>} Resolves with a commands object
     */
     editGuildCommand(guildID, commandID, command) {
         if(!commandID) {
             throw new Error("You must provide an id of the command to edit.");
         }
-        if(command.name !== undefined){
+        if(command.name !== undefined) {
             if(command.type === 1 || command.type === undefined) {
                 command.name = command.name.toLowerCase();
                 if(!command.name.match(/^[\w-]{1,32}$/)) {
                     throw new Error("Slash Command names must match the regular expression \"^[\\w-]{1,32}$\"");
                 }
             }
         }
-        command.default_permission = command.defaultPermission;
+        command.default_member_permissions = command.defaultMemberPermissions;
         return this.requestHandler.request("PATCH", Endpoints.GUILD_COMMAND(this.application.id, guildID, commandID), true, command);
     }
 

lib/Constants.js

@@ -26,8 +26,9 @@ module.exports.ApplicationCommandOptionTypes = {
 };
 
 module.exports.ApplicationCommandPermissionTypes = {
-    ROLE: 1,
-    USER: 2
+    ROLE:    1,
+    USER:    2,
+    CHANNEL: 3
 };
 
 module.exports.ApplicationCommandTypes = {

lib/gateway/Shard.js

@@ -2336,11 +2336,20 @@ class Shard extends EventEmitter {
                 /**
                 * Fired when an interaction is created
                 * @event Client#interactionCreate
-                * @prop {PingInteraction | CommandInteraction | ComponentInteraction | AutocompleteInteraction | UnknownInteraction} Interaction The Interaction that was created
+                * @prop {PingInteraction | CommandInteraction | ComponentInteraction | AutocompleteInteraction | UnknownInteraction} interaction The Interaction that was created
                 */
                 this.emit("interactionCreate", Interaction.from(packet.d, this.client));
                 break;
             }
+            case "APPLICATION_COMMAND_PERMISSIONS_UPDATE": {
+                /**
+                 * Fired when an application command's permissions are updated
+                 * @event Client#applicationCommandPermissionsUpdate
+                 * @prop {GuildApplicationCommandPermissions} guildApplicationCommandPermissions The updated command permissions
+                 */
+                this.emit("applicationCommandPermissionsUpdate", packet.d);
+                break;
+            }
             default: {
                 /**
                 * Fired when the shard encounters an unknown packet

lib/rest/Endpoints.js

@@ -41,7 +41,7 @@ module.exports.GUILD_BAN =                                   (guildID, memberID)
 module.exports.GUILD_BANS =                                            (guildID) => `/guilds/${guildID}/bans`;
 module.exports.GUILD_CHANNELS =                                        (guildID) => `/guilds/${guildID}/channels`;
 module.exports.GUILD_COMMAND =               (applicationID, guildID, commandID) => `/applications/${applicationID}/guilds/${guildID}/commands/${commandID}`;
-module.exports.GUILD_COMMAND_PERMISSIONS =                    (applicationID, guildID) => `/applications/${applicationID}/guilds/${guildID}/commands/permissions`;
+module.exports.GUILD_COMMAND_PERMISSIONS =              (applicationID, guildID) => `/applications/${applicationID}/guilds/${guildID}/commands/permissions`;
 module.exports.GUILD_COMMANDS =                         (applicationID, guildID) => `/applications/${applicationID}/guilds/${guildID}/commands`;
 module.exports.GUILD_DISCOVERY =                                       (guildID) => `/guilds/${guildID}/discovery-metadata`;
 module.exports.GUILD_DISCOVERY_CATEGORY =                  (guildID, categoryID) => `/guilds/${guildID}/discovery-categories/${categoryID}`;

lib/structures/Guild.js

@@ -411,7 +411,7 @@ class Guild extends Base {
     * @arg {String} [command.description] The command description (Slash Commands Only)
     * @arg {Array<Object>} [command.options] An array of [command options](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure)
     * @arg {Number} [type=1] The type of application command, 1 for slash command, 2 for user, and 3 for message
-    * @arg {Boolean} [command.defaultPermission] Whether the command is enabled by default when the app is added to a guild
+    * @arg {String?} [command.defaultMemberPermissions] The default member [permissions](https://discord.com/developers/docs/topics/permissions) represented as a bit set
     * @returns {Promise<Object>} Resolves with a command object
     */
     createCommand(command) {
@@ -624,7 +624,7 @@ class Guild extends Base {
     * @arg {String} command.name The command name
     * @arg {String} [command.description] The command description (Slash Commands Only)
     * @arg {Array<Object>} [command.options] An array of [command options](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure)
-    * @arg {Boolean} [command.defaultPermission] Whether the command is enabled by default when the app is added to a guild
+    * @arg {String?} [command.defaultMemberPermissions] The default member [permissions](https://discord.com/developers/docs/topics/permissions) represented as a bit set
     * @returns {Promise<Object>} Resolves with a command object
     */
     editCommand(commandID, commands) {