feat(Guild): Edit MFA level (#1473)

Co-authored-by: bsian03 <[email protected]>

index.d.ts

@@ -110,6 +110,7 @@ declare namespace Eris {
   type GuildScheduledEventPrivacyLevel = Constants["GuildScheduledEventPrivacyLevel"][keyof Constants["GuildScheduledEventPrivacyLevel"]];
   type GuildScheduledEventStatus = Constants["GuildScheduledEventStatus"][keyof Constants["GuildScheduledEventStatus"]];
   type GuildWidgetStyles = Constants["GuildWidgetStyles"][keyof Constants["GuildWidgetStyles"]];
+  type MFALevel = Constants["MFALevels"][keyof Constants["MFALevels"]];
   type NSFWLevel = Constants["GuildNSFWLevels"][keyof Constants["GuildNSFWLevels"]];
   type PossiblyUncachedGuild = Guild | Uncached;
   type PossiblyUncachedGuildScheduledEvent = GuildScheduledEvent | Uncached;
@@ -147,7 +148,6 @@ declare namespace Eris {
   type MessageActivityTypes = Constants["MessageActivityTypes"][keyof Constants["MessageActivityTypes"]];
   type MessageContent = string | AdvancedMessageContent;
   type MessageContentEdit = string | AdvancedMessageContentEdit;
-  type MFALevel = Constants["MFALevels"][keyof Constants["MFALevels"]];
   type PossiblyUncachedMessage = Message | { channel: TextableChannel | { id: string; guild?: Uncached }; guildID?: string; id: string };
 
   // Permission
@@ -1142,6 +1142,9 @@ declare namespace Eris {
     expireBehavior?: string;
     expireGracePeriod?: string;
   }
+  interface MFALevelResponse {
+    level: MFALevel;
+  }
   interface PruneMemberOptions extends GetPruneOptions {
     computePruneCount?: boolean;
     reason?: string;
@@ -2641,6 +2644,7 @@ declare namespace Eris {
     ): Promise<Emoji>;
     editGuildIntegration(guildID: string, integrationID: string, options: IntegrationOptions): Promise<void>;
     editGuildMember(guildID: string, memberID: string, options: MemberOptions, reason?: string): Promise<Member>;
+    editGuildMFALevel(guildID: string, level: MFALevel, reason?: string): Promise<MFALevelResponse>;
     editGuildScheduledEvent<T extends GuildScheduledEventEntityTypes>(guildID: string, eventID: string, event: GuildScheduledEventEditOptions<T>, reason?: string): Promise<GuildScheduledEvent<T>>;
     editGuildSticker(guildID: string, stickerID: string, options?: EditStickerOptions, reason?: string): Promise<Sticker>;
     editGuildTemplate(guildID: string, code: string, options: GuildTemplateOptions): Promise<GuildTemplate>;
@@ -3067,6 +3071,7 @@ declare namespace Eris {
     editEmoji(emojiID: string, options: { name: string; roles?: string[] }, reason?: string): Promise<Emoji>;
     editIntegration(integrationID: string, options: IntegrationOptions): Promise<void>;
     editMember(memberID: string, options: MemberOptions, reason?: string): Promise<Member>;
+    editMFALevel(level: MFALevel, reason?: string): Promise<MFALevelResponse>;
     /** @deprecated */
     editNickname(nick: string): Promise<void>;
     editRole(roleID: string, options: RoleOptions): Promise<Role>;

lib/Client.js

@@ -1784,6 +1784,20 @@ class Client extends EventEmitter {
         }).then((member) => new Member(member, this.guilds.get(guildID), this));
     }
 
+    /**
+     * Edit a guild's MFA level (multi-factor authentication). Note: The bot account must be the owner of the guild to be able to edit the MFA status.
+     * @arg {String} guildID The ID of the guild
+     * @arg {Number} level The new MFA level, `0` to disable MFA, `1` to enable it
+     * @arg {String} [reason] The reason to be displayed in audit logs
+     * @returns {Promise<Object>} An object containing a `level` (Number) key, indicating the new MFA level
+     */
+    editGuildMFALevel(guildID, level, reason) {
+        return this.requestHandler.request("POST", Endpoints.GUILD_MFA_LEVEL(guildID), true, {
+            level: level,
+            reason: reason
+        });
+    }
+
     /**
      * Edit a guild scheduled event
      * @arg {String} guildID The guild ID where the event will be edited

lib/structures/Guild.js

@@ -827,6 +827,16 @@ class Guild extends Base {
         return this._client.editGuildMember.call(this._client, this.id, memberID, options, reason);
     }
 
+    /**
+     * Edit the guild's MFA level (multi-factor authentication). Note: The bot account must be the owner of the guild to be able to edit the MFA status.
+     * @param {Number} level The new MFA level, `0` to disable MFA, `1` to enable it
+     * @param {String} [reason] The reason to be displayed in audit logs
+     * @returns {Promise<Object>} An object containing a `level` (Number) key, indicating the new MFA level
+     */
+    editMFALevel(level, reason) {
+        return this._client.editGuildMFALevel.call(this._client, this.id, level, reason);
+    }
+
     /**
      * [DEPRECATED] Edit the bot's nickname in the guild
      * @arg {String} nick The nickname