djs-selfbot-v13 3.1.6 → 3.1.7

package/src/managers/ClientUserSettingManager.js

@@ -2,19 +2,109 @@
 
 const { Collection } = require('@discordjs/collection');
 const BaseManager = require('./BaseManager');
-const { TypeError } = require('../errors/DJSError');
+const GuildFolderManager = require('./GuildFolderManager');
+const { Error, TypeError } = require('../errors/DJSError');
+const GuildFolder = require('../structures/GuildFolder');
 const { CustomStatus } = require('../structures/RichPresence');
-const { ActivityTypes } = require('../util/Constants');
-
+const { localeSetting, DMScanLevel, stickerAnimationMode } = require('../util/Constants');
 /**
  * Manages API methods for users and stores their cache.
  * @extends {BaseManager}
  * @see {@link https://luna.gitlab.io/discord-unofficial-docs/user_settings.html}
  */
 class ClientUserSettingManager extends BaseManager {
-  #rawSetting = {};
   constructor(client) {
     super(client);
+    /**
+     * Raw data
+     * @type {Object}
+     */
+    this.rawSetting = {};
+    /**
+     * Language
+     * @type {?string}
+     */
+    this.locale = null;
+    /**
+     * From: Setting => ACTIVITY SETTINGS => Activity Status => Display current activity as a status message
+     * @type {?boolean}
+     */
+    this.activityDisplay = null;
+    /**
+     * Disable Direct Message from servers
+     * @type {Collection<Snowflake, boolean>}
+     */
+    this.disableDMfromServer = new Collection();
+    /**
+     * Allow direct messages from server members
+     * @type {?boolean}
+     */
+    this.DMfromServerMode = null;
+    /**
+     * Display images
+     * @type {?boolean}
+     */
+    this.displayImage = null;
+    /**
+     * Display linked images
+     * @type {?boolean}
+     */
+    this.linkedImageDisplay = null;
+    /**
+     * From: Setting => APP SETTINGS => Accessibility => Automatically play GIFs when Discord is focused.
+     * @type {?boolean}
+     */
+    this.autoplayGIF = null;
+    /**
+     * Show embeds and preview website links pasted into chat
+     * @type {?boolean}
+     */
+    this.previewLink = null;
+    /**
+     * From: Setting => APP SETTINGS => Accessibility => Play Animated Emojis
+     * @type {?boolean}
+     */
+    this.animatedEmojis = null;
+    /**
+     * From: Setting => APP SETTINGS => Accessibility => Text-to-speech => Allow playback
+     * @type {?boolean}
+     */
+    this.allowTTS = null;
+    /**
+     * From: Setting => APP SETTINGS => Appearance => Message Display => Compact Mode
+     * @type {?boolean}
+     */
+    this.compactMode = null;
+    /**
+     * From: Setting => APP SETTINGS => Text & Images => Emoji => Convert Emoticons
+     * @type {?boolean}
+     */
+    this.convertEmoticons = null;
+    /**
+     * SAFE DIRECT MESSAGING
+     * @type {?DMScanLevel}
+     */
+    this.DMScanLevel = null;
+    /**
+     * From: Setting => APP SETTINGS => Appearance => Theme
+     * @type {'dark' | 'light' | null}
+     */
+    this.theme = '';
+    /**
+     * Developer Mode (Copy ID, etc.)
+     * @type {?boolean}
+     */
+    this.developerMode = null;
+    /**
+     * AFK timeout (receives notifications)
+     * @type {?number}
+     */
+    this.afkTimeout = null;
+    /**
+     * Sticker animation mode
+     * @type {?stickerAnimationMode}
+     */
+    this.stickerAnimationMode = null;
     /**
      * WHO CAN ADD YOU AS A FRIEND ?
      * @type {?object}
@@ -25,240 +115,153 @@ class ClientUserSettingManager extends BaseManager {
       mutual_friends: null,
       mutual_guilds: null,
     };
+    /**
+     * From: Setting => APP SETTINGS => Text & Images => Emoji => Show emoji reactions
+     * @type {?boolean}
+     */
+    this.showEmojiReactions = null;
+    /**
+     * Custom Stauts
+     * @type {?object}
+     * @see {@link https://luna.gitlab.io/discord-unofficial-docs/custom_status.html#customstatus-structure}
+     */
+    this.customStatus = null;
+    /**
+     * Guild folder and position
+     * @type {GuildFolderManager}
+     */
+    this.guildFolder = new GuildFolderManager(client);
+    // Todo: add new method from Discum
   }
   /**
    * Patch data file
-   * https://luna.gitlab.io/discord-unofficial-docs/docs/user_settings
+   * https://github.com/Merubokkusu/Discord-S.C.U.M/blob/master/discum/user/user.py
    * @private
    * @param {Object} data Raw Data to patch
    */
   _patch(data = {}) {
-    this.#rawSetting = Object.assign(this.#rawSetting, data);
-    this.client.emit('debug', `[SETTING > ClientUser] Sync setting`);
+    this.rawSetting = Object.assign(this.rawSetting, data);
     if ('locale' in data) {
-      /**
-       * The user's chosen language option
-       * @type {?string}
-       * @see {@link https://discord.com/developers/docs/reference#locales}
-       */
-      this.locale = data.locale;
+      this.locale = localeSetting[data.locale];
     }
     if ('show_current_game' in data) {
-      /**
-       * Show playing status for detected/added games
-       * <info>Setting => ACTIVITY SETTINGS => Activity Status => Display current activity as a status message</info>
-       * @type {?boolean}
-       */
       this.activityDisplay = data.show_current_game;
     }
     if ('default_guilds_restricted' in data) {
-      /**
-       * Allow DMs from guild members by default on guild join
-       * @type {?boolean}
-       */
-      this.allowDMsFromGuild = data.default_guilds_restricted;
+      this.DMfromServerMode = data.default_guilds_restricted;
     }
     if ('inline_attachment_media' in data) {
-      /**
-       * Display images and video when uploaded directly
-       * @type {?boolean}
-       */
       this.displayImage = data.inline_attachment_media;
     }
     if ('inline_embed_media' in data) {
-      /**
-       * Display images and video when linked
-       * @type {?boolean}
-       */
       this.linkedImageDisplay = data.inline_embed_media;
     }
     if ('gif_auto_play' in data) {
-      /**
-       * Play GIFs without hovering over them
-       * <info>Setting => APP SETTINGS => Accessibility => Automatically play GIFs when Discord is focused.</info>
-       * @type {?boolean}
-       */
       this.autoplayGIF = data.gif_auto_play;
     }
     if ('render_embeds' in data) {
-      /**
-       * Show embeds and preview website links pasted into chat
-       * @type {?boolean}
-       */
       this.previewLink = data.render_embeds;
     }
     if ('animate_emoji' in data) {
-      /**
-       * Play animated emoji without hovering over them
-       * <info>Setting => APP SETTINGS => Accessibility => Play Animated Emojis</info>
-       * @type {?boolean}
-       */
-      this.animatedEmoji = data.animate_emoji;
+      this.animatedEmojis = data.animate_emoji;
     }
     if ('enable_tts_command' in data) {
-      /**
-       * Enable /tts command and playback
-       * <info>Setting => APP SETTINGS => Accessibility => Text-to-speech => Allow playback</info>
-       * @type {?boolean}
-       */
       this.allowTTS = data.enable_tts_command;
     }
     if ('message_display_compact' in data) {
-      /**
-       * Use compact mode
-       * <info>Setting => APP SETTINGS => Appearance => Message Display => Compact Mode</info>
-       * @type {?boolean}
-       */
       this.compactMode = data.message_display_compact;
     }
     if ('convert_emoticons' in data) {
-      /**
-       * Convert "old fashioned" emoticons to emojis
-       * <info>Setting => APP SETTINGS => Text & Images => Emoji => Convert Emoticons</info>
-       * @type {?boolean}
-       */
       this.convertEmoticons = data.convert_emoticons;
     }
     if ('explicit_content_filter' in data) {
-      /**
-       * Content filter level
-       * <info>
-       * * `0`: Off
-       * * `1`: Friends excluded
-       * * `2`: Scan everyone
-       * </info>
-       * @type {?number}
-       */
-      this.DMScanLevel = data.explicit_content_filter;
+      this.DMScanLevel = DMScanLevel[data.explicit_content_filter];
     }
     if ('theme' in data) {
-      /**
-       * Client theme
-       * <info>Setting => APP SETTINGS => Appearance => Theme
-       * * `dark`
-       * * `light`
-       * </info>
-       * @type {?string}
-       */
       this.theme = data.theme;
     }
     if ('developer_mode' in data) {
-      /**
-       * Show the option to copy ids in right click menus
-       * @type {?boolean}
-       */
       this.developerMode = data.developer_mode;
     }
     if ('afk_timeout' in data) {
-      /**
-       * How many seconds being idle before the user is marked as "AFK"; this handles when push notifications are sent
-       * @type {?number}
-       */
-      this.afkTimeout = data.afk_timeout;
+      this.afkTimeout = data.afk_timeout * 1000; // Second => milisecond
     }
     if ('animate_stickers' in data) {
-      /**
-       * When stickers animate
-       * <info>
-       * * `0`: Always
-       * * `1`: On hover/focus
-       * * `2`: Never
-       * </info>
-       * @type {?number}
-       */
-      this.stickerAnimationMode = data.animate_stickers;
+      this.stickerAnimationMode = stickerAnimationMode[data.animate_stickers];
     }
     if ('render_reactions' in data) {
-      /**
-       * Display reactions
-       * <info>Setting => APP SETTINGS => Text & Images => Emoji => Show emoji reactions</info>
-       * @type {?boolean}
-       */
       this.showEmojiReactions = data.render_reactions;
     }
-    if ('status' in data) {
-      this.client.presence.status = data.status;
-      if (!('custom_status' in data)) {
-        this.client.emit('debug', '[SETTING > ClientUser] Sync status');
-        this.client.user.setStatus(data.status);
-      }
-    }
     if ('custom_status' in data) {
-      this.customStatus = data.custom_status;
-      const activities = this.client.presence.activities.filter(
-        a => ![ActivityTypes.CUSTOM, 'CUSTOM'].includes(a.type),
-      );
-      if (data.custom_status) {
-        const custom = new CustomStatus();
-        custom.setState(data.custom_status.text);
-        let emoji;
-        if (data.custom_status.emoji_id) {
-          emoji = this.client.emojis.cache.get(data.custom_status.emoji_id);
-        } else if (data.custom_status.emoji_name) {
-          emoji = `:${data.custom_status.emoji_name}:`;
-        }
-        if (emoji) custom.setEmoji(emoji);
-        activities.push(custom);
-      }
-      this.client.emit('debug', '[SETTING > ClientUser] Sync activities & status');
-      this.client.user.setPresence({ activities });
+      this.customStatus = data.custom_status || {}; // Thanks PinkDuwc._#3443 reported this issue
+      this.customStatus.status = data.status;
     }
     if ('friend_source_flags' in data) {
-      // Todo
+      this.addFriendFrom = {
+        all: data.friend_source_flags.all || false,
+        mutual_friends: data.friend_source_flags.all ? true : data.friend_source_flags.mutual_friends,
+        mutual_guilds: data.friend_source_flags.all ? true : data.friend_source_flags.mutual_guilds,
+      };
     }
-    if ('restricted_guilds' in data) {
-      /**
-       * Disable Direct Message from servers
-       * @type {Collection<Snowflake, Guild>}
-       */
-      this.disableDMfromGuilds = new Collection(
-        data.restricted_guilds.map(guildId => [guildId, this.client.guilds.cache.get(guildId)]),
+    if ('guild_folders' in data) {
+      data.guild_folders.map((folder, index) =>
+        this.guildFolder.cache.set(index, new GuildFolder(this.client, folder)),
       );
     }
+    if ('restricted_guilds' in data) {
+      this.disableDMfromServer = new Collection(data.restricted_guilds.map(guildId => [guildId, true]));
+    }
   }
-
-  /**
-   * Raw data
-   * @type {Object}
-   */
-  get raw() {
-    return this.#rawSetting;
-  }
-
   async fetch() {
+    if (this.client.bot) throw new Error('INVALID_BOT_METHOD');
     const data = await this.client.api.users('@me').settings.get();
     this._patch(data);
     return this;
   }
-
   /**
    * Edit data
-   * @param {any} data Data to edit
+   * @param {Object} data Data to edit
+   * @private
    */
   async edit(data) {
+    if (this.client.bot) throw new Error('INVALID_BOT_METHOD');
     const res = await this.client.api.users('@me').settings.patch({ data });
     this._patch(res);
     return this;
   }
-
   /**
-   * Toggle compact mode
-   * @returns {Promise<this>}
+   * Set compact mode
+   * @param {boolean | null} value Compact mode enable or disable
+   * @returns {boolean}
    */
-  toggleCompactMode() {
-    return this.edit({ message_display_compact: !this.compactMode });
+  async setDisplayCompactMode(value) {
+    if (typeof value !== 'boolean' && value !== null) {
+      throw new TypeError('INVALID_TYPE', 'value', 'boolean | null', true);
+    }
+    if (!value) value = !this.compactMode;
+    if (value !== this.compactMode) {
+      await this.edit({ message_display_compact: value });
+    }
+    return this.compactMode;
   }
   /**
    * Discord Theme
-   * @param {string} value Theme to set (dark | light)
-   * @returns {Promise<this>}
+   * @param {null |dark |light} value Theme to set
+   * @returns {theme}
    */
-  setTheme(value) {
+  async setTheme(value) {
     const validValues = ['dark', 'light'];
+    if (typeof value !== 'string' && value !== null) {
+      throw new TypeError('INVALID_TYPE', 'value', 'string | null', true);
+    }
     if (!validValues.includes(value)) {
-      throw new TypeError('INVALID_TYPE', 'value', 'dark | light', true);
+      if (value == validValues[0]) value = validValues[1];
+      else value = validValues[0];
+    }
+    if (value !== this.theme) {
+      await this.edit({ theme: value });
     }
-    return this.edit({ theme: value });
+    return this.theme;
   }
 
   /**
@@ -273,11 +276,10 @@ class ClientUserSettingManager extends BaseManager {
   /**
    * Set custom status
    * @param {?CustomStatus | CustomStatusOption} options CustomStatus
-   * @returns {Promise<this>}
    */
   setCustomStatus(options) {
     if (typeof options !== 'object') {
-      return this.edit({ custom_status: null });
+      this.edit({ custom_status: null });
     } else if (options instanceof CustomStatus) {
       options = options.toJSON();
       let data = {
@@ -296,7 +298,7 @@ class ClientUserSettingManager extends BaseManager {
           data.emoji_name = typeof options.emoji?.name === 'string' ? options.emoji?.name : null;
         }
       }
-      return this.edit({ custom_status: data });
+      this.edit({ custom_status: data });
     } else {
       let data = {
         emoji_name: null,
@@ -325,8 +327,124 @@ class ClientUserSettingManager extends BaseManager {
         data.expires_at = new Date(options.expires).toISOString();
       }
       if (['online', 'idle', 'dnd', 'invisible'].includes(options.status)) this.edit({ status: options.status });
-      return this.edit({ custom_status: data });
+      this.edit({ custom_status: data });
+    }
+  }
+
+  /**
+   * * Locale Setting, must be one of:
+   * * `DANISH`
+   * * `GERMAN`
+   * * `ENGLISH_UK`
+   * * `ENGLISH_US`
+   * * `SPANISH`
+   * * `FRENCH`
+   * * `CROATIAN`
+   * * `ITALIAN`
+   * * `LITHUANIAN`
+   * * `HUNGARIAN`
+   * * `DUTCH`
+   * * `NORWEGIAN`
+   * * `POLISH`
+   * * `BRAZILIAN_PORTUGUESE`
+   * * `ROMANIA_ROMANIAN`
+   * * `FINNISH`
+   * * `SWEDISH`
+   * * `VIETNAMESE`
+   * * `TURKISH`
+   * * `CZECH`
+   * * `GREEK`
+   * * `BULGARIAN`
+   * * `RUSSIAN`
+   * * `UKRAINIAN`
+   * * `HINDI`
+   * * `THAI`
+   * * `CHINA_CHINESE`
+   * * `JAPANESE`
+   * * `TAIWAN_CHINESE`
+   * * `KOREAN`
+   * @param {localeSetting} value Locale to set
+   * @returns {locale}
+   */
+  async setLocale(value) {
+    if (typeof value !== 'string') {
+      throw new TypeError('INVALID_TYPE', 'value', 'string', true);
+    }
+    if (!localeSetting[value]) throw new Error('INVALID_LOCALE');
+    if (localeSetting[value] !== this.locale) {
+      await this.edit({ locale: localeSetting[value] });
+    }
+    return this.locale;
+  }
+  // TODO: Guild positions & folders
+  // Change Index in Array [Hidden]
+  /**
+   *
+   * @param {Array} array Array
+   * @param {number} from Index1
+   * @param {number} to Index2
+   * @returns {Array}
+   * @private
+   */
+  _move(array, from, to) {
+    array.splice(to, 0, array.splice(from, 1)[0]);
+    return array;
+  }
+  // TODO: Move Guild
+  // folder to folder
+  // folder to home
+  // home to home
+  // home to folder
+  /**
+   * Change Guild Position (from * to Folder or Home)
+   * @param {GuildIDResolve} guildId guild.id
+   * @param {number} newPosition Guild Position
+   * * **WARNING**: Type = `FOLDER`, newPosition is the guild's index in the Folder.
+   * @param {number} type Move to folder or home
+   * * `FOLDER`: 1
+   * * `HOME`: 2
+   * @param {FolderID} folderId If you want to move to folder
+   * @private
+   */
+  guildChangePosition(guildId, newPosition, type, folderId) {
+    // Get Guild default position
+    // Escape
+    const oldGuildFolderPosition = this.rawSetting.guild_folders.findIndex(value => value.guild_ids.includes(guildId));
+    const newGuildFolderPosition = this.rawSetting.guild_folders.findIndex(value =>
+      value.guild_ids.includes(this.rawSetting.guild_positions[newPosition]),
+    );
+    if (type == 2 || `${type}`.toUpperCase() == 'HOME') {
+      // Delete GuildID from Folder and create new Folder
+      // Check it is folder
+      const folder = this.rawSetting.guild_folders[oldGuildFolderPosition];
+      if (folder.id) {
+        this.rawSetting.guild_folders[oldGuildFolderPosition].guild_ids = this.rawSetting.guild_folders[
+          oldGuildFolderPosition
+        ].guild_ids.filter(v => v !== guildId);
+      }
+      this.rawSetting.guild_folders = this._move(
+        this.rawSetting.guild_folders,
+        oldGuildFolderPosition,
+        newGuildFolderPosition,
+      );
+      this.rawSetting.guild_folders[newGuildFolderPosition].id = null;
+    } else if (type == 1 || `${type}`.toUpperCase() == 'FOLDER') {
+      // Delete GuildID from oldFolder
+      this.rawSetting.guild_folders[oldGuildFolderPosition].guild_ids = this.rawSetting.guild_folders[
+        oldGuildFolderPosition
+      ].guild_ids.filter(v => v !== guildId);
+      // Index new Folder
+      const folderIndex = this.rawSetting.guild_folders.findIndex(value => value.id == folderId);
+      const folder = this.rawSetting.guild_folders[folderIndex];
+      folder.guild_ids.push(guildId);
+      folder.guild_ids = [...new Set(folder.guild_ids)];
+      folder.guild_ids = this._move(
+        folder.guild_ids,
+        folder.guild_ids.findIndex(v => v == guildId),
+        newPosition,
+      );
     }
+    this.edit({ guild_folders: this.rawSetting.guild_folders });
   }
 
   /**

package/src/managers/DeveloperPortalManager.js

@@ -0,0 +1,104 @@
+'use strict';
+
+const { Collection } = require('@discordjs/collection');
+const BaseManager = require('./BaseManager');
+const DeveloperPortalApplication = require('../structures/DeveloperPortalApplication');
+const Team = require('../structures/Team');
+
+/**
+ * Manages API methods for users and stores their cache.
+ * @extends {BaseManager}
+ */
+class DeveloperPortalManager extends BaseManager {
+  constructor(client) {
+    super(client);
+    /**
+     * A collection of all the applications the client has.
+     * @type {Collection<Snowflake, DeveloperPortalApplication>}
+     * @readonly
+     */
+    this.applications = new Collection();
+    /**
+     * A collection of all the teams the client has.
+     * @type {Collection<Snowflake, Team>}
+     * @readonly
+     */
+    this.teams = new Collection(); // Collection<Snowflake, Team>
+  }
+  /**
+   * Fetches all the applications & teams the client has.
+   * @returns {Promise<DeveloperPortalManager>}
+   */
+  async fetch() {
+    const promise1 = this.client.api.applications.get({
+      query: {
+        with_team_applications: true,
+      },
+    });
+    const promise2 = this.client.api.teams.get();
+    const [applications, teams] = await Promise.all([promise1, promise2]);
+    for (const team of teams) {
+      this.teams.set(team.id, new Team(this.client, team));
+    }
+    for (const application of applications) {
+      this.applications.set(application.id, new DeveloperPortalApplication(this.client, application));
+    }
+    return this;
+  }
+
+  /**
+   * Creates a new Team.
+   * @param {string} name Name of the team
+   * @returns {Promise<Team>}
+   */
+  async createTeam(name) {
+    const team = await this.client.api.teams.post({
+      data: {
+        name: name,
+      },
+    });
+
+    this.teams.set(team.id, new Team(this.client, team));
+    return this.teams.get(team.id);
+  }
+
+  /**
+   * Creates a new application.
+   * @param {string} name Name of the application
+   * @param {?Snowflake | Team} teamId The team to create the application in
+   * @returns {Promise<DeveloperPortalApplication>}
+   */
+  async createApplication(name, teamId = null) {
+    teamId = teamId instanceof Team ? teamId.id : teamId;
+    const application = await this.client.api.applications.post({
+      data: {
+        name,
+        team_id: teamId,
+      },
+    });
+    this.applications.set(application.id, new DeveloperPortalApplication(this.client, application));
+    return this.applications.get(application.id);
+  }
+
+  /**
+   * Deletes an application.
+   * @param {Snowflake} id Application ID
+   * @param {?number} MFACode 2FA code (if 2FA is enabled)
+   * @returns {Promise<void>}
+   */
+  async deleteApplication(id, MFACode) {
+    if (MFACode) {
+      await this.client.api.applications[`${id}/delete`].post({
+        query: {
+          code: MFACode,
+        },
+      });
+    } else {
+      await this.client.api.applications[`${id}/delete`].post();
+    }
+    this.applications.delete(id);
+    return undefined;
+  }
+}
+
+module.exports = DeveloperPortalManager;

package/src/managers/GuildApplicationCommandManager.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const ApplicationCommandManager = require('./ApplicationCommandManager');
+const ApplicationCommandPermissionsManager = require('./ApplicationCommandPermissionsManager');
+
+/**
+ * An extension for guild-specific application commands.
+ * @extends {ApplicationCommandManager}
+ */
+class GuildApplicationCommandManager extends ApplicationCommandManager {
+  constructor(guild, iterable) {
+    super(guild.client, iterable);
+
+    /**
+     * The guild that this manager belongs to
+     * @type {Guild}
+     */
+    this.guild = guild;
+
+    /**
+     * The manager for permissions of arbitrary commands on this guild
+     * @type {ApplicationCommandPermissionsManager}
+     */
+    this.permissions = new ApplicationCommandPermissionsManager(this);
+  }
+}
+
+module.exports = GuildApplicationCommandManager;