feat: user-installables

examples/userCommand.js

@@ -0,0 +1,52 @@
+const Eris = require("eris");
+
+const Constants = Eris.Constants;
+
+const bot = new Eris("Bot token", {
+    intents: []
+});
+
+bot.on("ready", () => {
+    console.log("connected!")
+    bot.createCommand({
+        type: Constants.ApplicationCommandTypes.CHAT_INPUT,
+        name: "ping",
+        description: "Reply with pong",
+        options: [],
+        /* The following 2 lines set the state of the application command as both user installable and guild installable */
+        contexts: [Constants.ApplicationCommandContextType.GUILD, Constants.ApplicationCommandContextType.BOT_DM, Constants.ApplicationCommandContextType.PRIVATE],
+        integration_types: [Constants.ApplicationCommandIntegrationTypes.GUILD_INSTALL, Constants.ApplicationCommandIntegrationTypes.USER_INSTALL]
+    })
+})
+
+bot.on("interactionCreate", (interaction) => {
+    if(interaction instanceof Eris.CommandInteraction) {
+        if(interaction.data.name === "ping") {
+            let where = ""
+            /**
+             * <CommandInteraction>.context includes information of where the command was executed.
+             * if <CommandInteraction>.context matches ...
+             *    Constants.ApplicationCommandContextType.GUILD it means it is executed from a server
+             *    Constants.ApplicationCommandContextType.BOT_DM it means it is executed from the bot's DM
+             *    Constants.ApplicationCommandContextType.PRIVATE it means it is executed as a user installable
+             * 
+             * Incase of BOT_DM and PRIVATE, the CommandInteraction will lose all its guild related properties such as the guild information and member data
+             */
+            const context = interaction.context
+
+            if(context === Constants.ApplicationCommandContextType.GUILD) {
+                where = "as a server interaction."
+            } else if(context === Constants.ApplicationCommandContextType.BOT_DM) {
+                where = "as a bot DM interaction."
+            } else if(context === Constants.ApplicationCommandContextType.PRIVATE) {
+                where = "as a private interaction (user installable)."
+            } else {
+                where = "as a server interaction."
+            }
+
+            interaction.createMessage(`🏓 pong ${where}`)
+        }
+    }
+})
+
+bot.connect()

index.d.ts

@@ -224,6 +224,8 @@ declare namespace Eris {
     description: U extends Constants["ApplicationCommandTypes"]["CHAT_INPUT"] ? string : "" | void;
     name: string;
     type?: U;
+    contexts: Number[];
+    integration_types: Number[];
   }
   /** Generic T is `true` if editing Guild scoped commands, and `false` if not */
   interface ApplicationCommandBulkEditOptions<T extends boolean, U = ApplicationCommandTypes> extends ApplicationCommandCreateOptions<T, U> {
@@ -1897,6 +1899,15 @@ declare namespace Eris {
   interface Constants {
     GATEWAY_VERSION: 9;
     REST_VERSION: 9;
+    ApplicationCommandContextType: {
+      GUILD:   0,
+      BOT_DM:  1,
+      PRIVATE: 2
+    }
+    ApplicationCommandIntegrationTypes: {
+      GUILD_INSTALL:   0,
+      USER_INSTALL:    1
+    }
     ActivityFlags: {
       INSTANCE:                    1;
       JOIN:                        2;
@@ -3514,6 +3525,7 @@ declare namespace Eris {
     member: T extends AnyGuildChannel ? Member : undefined;
     type: Constants["InteractionTypes"]["APPLICATION_COMMAND"];
     user: T extends AnyGuildChannel ? undefined : User;
+    context?: number
     acknowledge(flags?: number): Promise<void>;
     createFollowup(content: string | InteractionContent, file?: FileContent | FileContent[]): Promise<Message>;
     createMessage(content: string | InteractionContent, file?: FileContent | FileContent[]): Promise<void>;

lib/Client.js

@@ -641,6 +641,8 @@ class Client extends EventEmitter {
      * @arg {Boolean} [command.nsfw=false] Whether the command is age-restricted
      * @arg {Array<Object>} [command.options] The application command [options](https://discord.dev/interactions/application-commands#application-command-object-application-command-option-structure)
      * @arg {Number} [command.type=1] The command type, either `1` for `CHAT_INPUT`, `2` for `USER` or `3` for `MESSAGE`
+     * @arg {Number[]?} [command.contexts] Configure if the command is a user-installable GUILD=0 BOT_DM=1 PRIVATE=2 [more info](https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-context-types)
+     * @arg {Number[]?} [command.integration_types] Configure the installation state of the slash command GUILD_INSTALL=0 USER_INSTALL=1 [more info](https://discord.com/developers/docs/resources/application#application-object-application-integration-types)
      * @returns {Promise<ApplicationCommand>} Resolves with the created application command
      */
     createCommand(command) {

lib/Constants.js

@@ -15,6 +15,17 @@ module.exports.ActivityFlags = {
     EMBEDDED:                    1 << 8
 };
 
+module.exports.ApplicationCommandContextType = {
+    GUILD:   0,
+    BOT_DM:  1,
+    PRIVATE: 2
+}
+
+module.exports.ApplicationCommandIntegrationTypes = {
+    GUILD_INSTALL:   0,
+    USER_INSTALL:    1
+}
+
 module.exports.ActivityTypes = {
     GAME:      0,
     STREAMING: 1,

lib/structures/ApplicationCommand.js

@@ -19,6 +19,7 @@ const Permission = require("./Permission");
  * @prop {Array<Object>?} options The [options](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure) associated with this command
  * @prop {Number} type The [command type](https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-types)
  * @prop {String} version The ID of the version of this command
+ * @prop {Number[]?} contexts The context of the command (if the command is a user-installable or a guild-installable)
  */
 class ApplicationCommand extends Base {
     constructor(data, client) {
@@ -56,6 +57,9 @@ class ApplicationCommand extends Base {
         if(data.nsfw !== undefined) {
             this.nsfw = data.nsfw;
         }
+        if(data.contexts !== undefined) {
+            this.contexts = data.contexts
+        } 
     }
 
     /**

lib/structures/CommandInteraction.js

@@ -34,6 +34,7 @@ const {InteractionResponseTypes} = require("../Constants");
  * @prop {String?} guildID The ID of the guild in which the interaction was created
  * @prop {Member?} member The member who triggered the interaction (This is only sent when the interaction is invoked within a guild)
  * @prop {User?} user The user who triggered the interaction (This is only sent when the interaction is invoked within a dm)
+ * @prop {Number} context Where the interaction is sent from GUILD=0 BOT_DM=1 PRIVATE=2 [more info](https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-context-types)
  */
 class CommandInteraction extends Interaction {
     constructor(data, client) {
@@ -45,6 +46,8 @@ class CommandInteraction extends Interaction {
 
         this.data = JSON.parse(JSON.stringify(data.data));
 
+        this.context = data.context
+
         if(data.data.resolved !== undefined) {
             //Users
             if(data.data.resolved.users !== undefined) {
@@ -105,7 +108,7 @@ class CommandInteraction extends Interaction {
                 this.member = this.channel.guild.members.update(data.member, this.channel.guild);
             } else {
                 const guild = this._client.guilds.get(data.guild_id);
-                this.member = guild.members.update(data.member, guild);
+                this.member = guild?.members?.update(data.member, guild);
             }
         }