djs-selfbot-v13 3.1.7 → 3.2.2

package/src/util/RoleFlags.js

@@ -0,0 +1,37 @@
+'use strict';
+
+const BitField = require('./BitField');
+
+/**
+ * Data structure that makes it easy to interact with an {@link GuildMember#flags} bitfield.
+ * @extends {BitField}
+ */
+class RoleFlags extends BitField {}
+
+/**
+ * @name RoleFlags
+ * @kind constructor
+ * @memberof RoleFlags
+ * @param {BitFieldResolvable} [bits=0] Bit(s) to read from
+ */
+
+/**
+ * Numeric guild member flags. All available properties:
+ * * `IN_PROMPT`
+ * @type {Object}
+ * @see {@link https://discord.com/developers/docs/topics/permissions#role-object-role-flags}
+ */
+RoleFlags.FLAGS = {
+  IN_PROMPT: 1 << 0,
+};
+
+/**
+ * Data that can be resolved to give a role flag bitfield. This can be:
+ * * A string (see {@link RoleFlags.FLAGS})
+ * * A role flag
+ * * An instance of RoleFlags
+ * * An Array of RoleFlagsResolvable
+ * @typedef {string|number|RoleFlags|RoleFlagsResolvable[]} RoleFlagsResolvable
+ */
+
+module.exports = RoleFlags;

package/src/util/Sweepers.js

@@ -7,7 +7,7 @@ const { TypeError } = require('../errors/DJSError.js');
 /**
  * @typedef {Function} GlobalSweepFilter
  * @returns {Function|null} Return `null` to skip sweeping, otherwise a function passed to `sweep()`,
- * See {@link [Collection#sweep](https://discord.js.org/docs/packages/collection/stable/Collection:Class?scrollTo=sweep)}
+ * See {@link [Collection#sweep](https://discord.js.org/docs/packages/collection/stable/Collection:Class#sweep)}
  * for the definition of this function.
  */
 

package/src/util/Util.js

@@ -1,16 +1,23 @@
 'use strict';
 
+const { Agent } = require('node:http');
 const { parse } = require('node:path');
 const process = require('node:process');
+const { setTimeout } = require('node:timers');
 const { Collection } = require('@discordjs/collection');
 const fetch = require('node-fetch');
-const { Colors } = require('./Constants');
-const { RangeError, TypeError } = require('../errors');
+const { Colors, Events } = require('./Constants');
+const { Error: DiscordError, RangeError, TypeError } = require('../errors');
 const has = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
 const isObject = d => typeof d === 'object' && d !== null;
 
 let deprecationEmittedForSplitMessage = false;
 let deprecationEmittedForRemoveMentions = false;
+let deprecationEmittedForResolveAutoArchiveMaxLimit = false;
+
+const TextSortableGroupTypes = ['GUILD_TEXT', 'GUILD_ANNOUCMENT', 'GUILD_FORUM'];
+const VoiceSortableGroupTypes = ['GUILD_VOICE', 'GUILD_STAGE_VOICE'];
+const CategorySortableGroupTypes = ['GUILD_CATEGORY'];
 
 /**
  * Contains various general-purpose utility methods.
@@ -134,6 +141,7 @@ class Util extends null {
    * @property {boolean} [numberedList=false] Whether to escape numbered lists
    * @property {boolean} [maskedLink=false] Whether to escape masked links
    */
+
   /**
    * Escapes any Discord-flavour markdown in a string.
    * @param {string} text Content to escape
@@ -216,6 +224,7 @@ class Util extends null {
     if (maskedLink) text = Util.escapeMaskedLink(text);
     return text;
   }
+
   /**
    * Escapes code block markdown in a string.
    * @param {string} text Content to escape
@@ -224,6 +233,7 @@ class Util extends null {
   static escapeCodeBlock(text) {
     return text.replaceAll('```', '\\`\\`\\`');
   }
+
   /**
    * Escapes inline code markdown in a string.
    * @param {string} text Content to escape
@@ -232,6 +242,7 @@ class Util extends null {
   static escapeInlineCode(text) {
     return text.replace(/(?<=^|[^`])``?(?=[^`]|$)/g, match => (match.length === 2 ? '\\`\\`' : '\\`'));
   }
+
   /**
    * Escapes italic markdown in a string.
    * @param {string} text Content to escape
@@ -249,6 +260,7 @@ class Util extends null {
       return `\\_${match}`;
     });
   }
+
   /**
    * Escapes bold markdown in a string.
    * @param {string} text Content to escape
@@ -261,6 +273,7 @@ class Util extends null {
       return '\\*\\*';
     });
   }
+
   /**
    * Escapes underline markdown in a string.
    * @param {string} text Content to escape
@@ -273,6 +286,7 @@ class Util extends null {
       return '\\_\\_';
     });
   }
+
   /**
    * Escapes strikethrough markdown in a string.
    * @param {string} text Content to escape
@@ -281,6 +295,7 @@ class Util extends null {
   static escapeStrikethrough(text) {
     return text.replaceAll('~~', '\\~\\~');
   }
+
   /**
    * Escapes spoiler markdown in a string.
    * @param {string} text Content to escape
@@ -289,6 +304,7 @@ class Util extends null {
   static escapeSpoiler(text) {
     return text.replaceAll('||', '\\|\\|');
   }
+
   /**
    * Escapes escape characters in a string.
    * @param {string} text Content to escape
@@ -297,6 +313,7 @@ class Util extends null {
   static escapeEscape(text) {
     return text.replaceAll('\\', '\\\\');
   }
+
   /**
    * Escapes heading characters in a string.
    * @param {string} text Content to escape
@@ -305,6 +322,7 @@ class Util extends null {
   static escapeHeading(text) {
     return text.replaceAll(/^( {0,2}[*-] +)?(#{1,3} )/gm, '$1\\$2');
   }
+
   /**
    * Escapes bulleted list characters in a string.
    * @param {string} text Content to escape
@@ -313,6 +331,7 @@ class Util extends null {
   static escapeBulletedList(text) {
     return text.replaceAll(/^( *)[*-]( +)/gm, '$1\\-$2');
   }
+
   /**
    * Escapes numbered list characters in a string.
    * @param {string} text Content to escape
@@ -321,6 +340,7 @@ class Util extends null {
   static escapeNumberedList(text) {
     return text.replaceAll(/^( *\d+)\./gm, '$1\\.');
   }
+
   /**
    * Escapes masked link characters in a string.
    * @param {string} text Content to escape
@@ -330,6 +350,16 @@ class Util extends null {
     return text.replaceAll(/\[.+\]\(.+\)/gm, '\\$&');
   }
 
+  /**
+   * @typedef {Object} FetchRecommendedShardsOptions
+   * @property {number} [guildsPerShard=1000] Number of guilds assigned per shard
+   * @property {number} [multipleOf=1] The multiple the shard count should round up to. (16 for large bot sharding)
+   */
+
+  static fetchRecommendedShards() {
+    throw new DiscordError('INVALID_USER_API');
+  }
+
   /**
    * Parses emoji info out of a string. The string must be one of:
    * * A UTF-8 emoji (no id)
@@ -576,7 +606,7 @@ class Util extends null {
           return user ? Util._removeMentions(`@${user.username}`) : input;
         }
 
-        const member = channel.guild.members.cache.get(id);
+        const member = channel.guild?.members.cache.get(id);
         if (member) {
           return Util._removeMentions(`@${member.displayName}`);
         } else {
@@ -619,26 +649,22 @@ class Util extends null {
 
   /**
    * Resolves the maximum time a guild's thread channels should automatically archive in case of no recent activity.
-   * @deprecated
+   * @param {Guild} guild The guild to resolve this limit from.
+   * @deprecated This will be removed in the next major version.
    * @returns {number}
    */
   static resolveAutoArchiveMaxLimit() {
+    if (!deprecationEmittedForResolveAutoArchiveMaxLimit) {
+      process.emitWarning(
+        // eslint-disable-next-line max-len
+        "The Util.resolveAutoArchiveMaxLimit method and the 'MAX' option are deprecated and will be removed in the next major version.",
+        'DeprecationWarning',
+      );
+      deprecationEmittedForResolveAutoArchiveMaxLimit = true;
+    }
     return 10080;
   }
 
-  /**
-   * Lazily evaluates a callback function (yea it's v14 :yay:)
-   * @param {Function} cb The callback to lazily evaluate
-   * @returns {Function}
-   * @example
-   * const User = lazy(() => require('./User'));
-   * const user = new (User())(client, data);
-   */
-  static lazy(cb) {
-    let defaultValue;
-    return () => (defaultValue ??= cb());
-  }
-
   /**
    * Transforms an API guild forum tag to camel-cased guild forum tag.
    * @param {APIGuildForumTag} tag The tag to transform
@@ -704,11 +730,44 @@ class Util extends null {
     };
   }
 
-  static async getAttachments(client, channelId, ...files) {
-    files = files.flat(2);
+  /**
+   * Gets an array of the channel types that can be moved in the channel group. For example, a GuildText channel would
+   * return an array containing the types that can be ordered within the text channels (always at the top), and a voice
+   * channel would return an array containing the types that can be ordered within the voice channels (always at the
+   * bottom).
+   * @param {ChannelType} type The type of the channel
+   * @returns {ChannelType[]}
+   * @ignore
+   */
+  static getSortableGroupTypes(type) {
+    switch (type) {
+      case 'GUILD_TEXT':
+      case 'GUILD_ANNOUNCEMENT':
+      case 'GUILD_FORUM':
+        return TextSortableGroupTypes;
+      case 'GUILD_VOICE':
+      case 'GUILD_STAGE_VOICE':
+        return VoiceSortableGroupTypes;
+      case 'GUILD_CATEGORY':
+        return CategorySortableGroupTypes;
+      default:
+        return [type];
+    }
+  }
+
+  /**
+   * Calculates the default avatar index for a given user id.
+   * @param {Snowflake} userId - The user id to calculate the default avatar index for
+   * @returns {number}
+   */
+  static calculateUserDefaultAvatarIndex(userId) {
+    return Number(BigInt(userId) >> 22n) % 6;
+  }
+
+  static async getUploadURL(client, channelId, files) {
     if (!files.length) return [];
     files = files.map((file, i) => ({
-      filename: file.name ?? file.attachment?.name ?? file.attachment?.filename ?? 'file.jpg',
+      filename: file.name,
       // 25MB = 26_214_400bytes
       file_size: Math.floor((26_214_400 / 10) * Math.random()),
       id: `${i}`,
@@ -726,6 +785,7 @@ class Util extends null {
       fetch(url, {
         method: 'PUT',
         body: data,
+        duplex: 'half', // Node.js v20
       })
         .then(res => {
           if (res.ok) {
@@ -738,22 +798,88 @@ class Util extends null {
     });
   }
 
-  static testImportModule(name) {
-    try {
-      require.resolve(name);
-      return true;
-    } catch {
-      return false;
-    }
+  /**
+   * Lazily evaluates a callback function (yea it's v14 :yay:)
+   * @param {Function} cb The callback to lazily evaluate
+   * @returns {Function}
+   * @example
+   * const User = lazy(() => require('./User'));
+   * const user = new (User())(client, data);
+   */
+  static lazy(cb) {
+    let defaultValue;
+    return () => (defaultValue ??= cb());
   }
 
   /**
-   * Calculates the default avatar index for a given user id.
-   * @param {Snowflake} userId - The user id to calculate the default avatar index for
-   * @returns {number}
+   * Hacking check object instanceof Proxy-agent
+   * @param {Object} object any
+   * @returns {boolean}
    */
-  static calculateUserDefaultAvatarIndex(userId) {
-    return Number(BigInt(userId) >> 22n) % 6;
+  static verifyProxyAgent(object) {
+    return typeof object == 'object' && object.httpAgent instanceof Agent && object.httpsAgent instanceof Agent;
+  }
+
+  static createPromiseInteraction(client, nonce, timeoutMs = 5_000, isHandlerDeferUpdate = false, parent) {
+    return new Promise((resolve, reject) => {
+      // Waiting for MsgCreate / ModalCreate
+      let dataFromInteractionSuccess;
+      let dataFromNormal;
+      const handler = data => {
+        // UnhandledPacket
+        if (isHandlerDeferUpdate && data.d?.nonce == nonce && data.t == 'INTERACTION_SUCCESS') {
+          // Interaction#deferUpdate
+          client.removeListener(Events.MESSAGE_CREATE, handler);
+          client.removeListener(Events.UNHANDLED_PACKET, handler);
+          client.removeListener(Events.INTERACTION_MODAL_CREATE, handler);
+          dataFromInteractionSuccess = parent;
+        }
+        if (data.nonce !== nonce) return;
+        clearTimeout(timeout);
+        client.removeListener(Events.MESSAGE_CREATE, handler);
+        client.removeListener(Events.INTERACTION_MODAL_CREATE, handler);
+        if (isHandlerDeferUpdate) client.removeListener(Events.UNHANDLED_PACKET, handler);
+        client.decrementMaxListeners();
+        dataFromNormal = data;
+        resolve(data);
+      };
+      const timeout = setTimeout(() => {
+        if (dataFromInteractionSuccess || dataFromNormal) {
+          resolve(dataFromNormal || dataFromInteractionSuccess);
+          return;
+        }
+        client.removeListener(Events.MESSAGE_CREATE, handler);
+        client.removeListener(Events.INTERACTION_MODAL_CREATE, handler);
+        if (isHandlerDeferUpdate) client.removeListener(Events.UNHANDLED_PACKET, handler);
+        client.decrementMaxListeners();
+        reject(new Error('INTERACTION_FAILED'));
+      }, timeoutMs).unref();
+      client.incrementMaxListeners();
+      client.on(Events.MESSAGE_CREATE, handler);
+      client.on(Events.INTERACTION_MODAL_CREATE, handler);
+      if (isHandlerDeferUpdate) client.on(Events.UNHANDLED_PACKET, handler);
+    });
+  }
+
+  static clearNullOrUndefinedObject(object) {
+    const data = {};
+    const keys = Object.keys(object);
+
+    for (const key of keys) {
+      const value = object[key];
+      if (value === undefined || value === null || (Array.isArray(value) && value.length === 0)) {
+        continue;
+      } else if (!Array.isArray(value) && typeof value === 'object') {
+        const cleanedValue = Util.clearNullOrUndefinedObject(value);
+        if (cleanedValue !== undefined) {
+          data[key] = cleanedValue;
+        }
+      } else {
+        data[key] = value;
+      }
+    }
+
+    return Object.keys(data).length > 0 ? data : undefined;
   }
 }
 

package/typings/enums.d.ts

@@ -8,67 +8,7 @@ export const enum ActivityTypes {
   WATCHING = 3,
   CUSTOM = 4,
   COMPETING = 5,
-}
-
-export const enum DMScanLevel {
-  NOT_SCAN = 0,
-  NOT_FRIEND = 1,
-  EVERYONE = 2,
-}
-
-export const enum stickerAnimationMode {
-  ALWAYS = 0,
-  INTERACTION = 1,
-  NEVER = 2,
-}
-
-export const enum NitroType {
-  NONE = 0,
-  NITRO_CLASSIC = 1,
-  NITRO_BOOST = 2,
-  NITRO_BASIC = 3,
-}
-
-export const enum RelationshipTypes {
-  NONE = 0,
-  FRIEND = 1,
-  BLOCKED = 2,
-  PENDING_INCOMING = 3,
-  PENDING_OUTGOING = 4,
-  IMPLICIT = 5,
-}
-
-export const enum localeSetting {
-  DANISH = 'da',
-  GERMAN = 'de',
-  ENGLISH_UK = 'en-GB',
-  ENGLISH_US = 'en-US',
-  SPANISH = 'es-ES',
-  FRENCH = 'fr',
-  CROATIAN = 'hr',
-  ITALIAN = 'it',
-  LITHUANIAN = 'lt',
-  HUNGARIAN = 'hu',
-  DUTCH = 'nl',
-  NORWEGIAN = 'no',
-  POLISH = 'pl',
-  BRAZILIAN_PORTUGUESE = 'pt-BR',
-  ROMANIA_ROMANIAN = 'ro',
-  FINNISH = 'fi',
-  SWEDISH = 'sv-SE',
-  VIETNAMESE = 'vi',
-  TURKISH = 'tr',
-  CZECH = 'cs',
-  GREEK = 'el',
-  BULGARIAN = 'bg',
-  RUSSIAN = 'ru',
-  UKRAINIAN = 'uk',
-  HINDI = 'hi',
-  THAI = 'th',
-  CHINA_CHINESE = 'zh-CN',
-  JAPANESE = 'ja',
-  TAIWAN_CHINESE = 'zh-TW',
-  KOREAN = 'ko',
+  HANG = 6,
 }
 
 export const enum ApplicationCommandTypes {
@@ -147,6 +87,11 @@ export const enum ForumLayoutType {
   GALLERY_VIEW = 2,
 }
 
+export const enum MessagePollLayoutType {
+  DEFAULT = 1,
+  IMAGE_ONLY_ANSWERS,
+}
+
 export const enum MessageTypes {
   DEFAULT,
   RECIPIENT_ADD,
@@ -203,13 +148,6 @@ export const enum GuildScheduledEventStatuses {
   CANCELED = 4,
 }
 
-export const enum HypeSquadType {
-  LEAVE = 0,
-  HOUSE_BRAVERY = 1,
-  HOUSE_BRILLIANCE = 2,
-  HOUSE_BALANCE = 3,
-}
-
 export const enum InteractionResponseTypes {
   PONG = 1,
   CHANNEL_MESSAGE_WITH_SOURCE = 4,
@@ -230,7 +168,15 @@ export const enum InteractionTypes {
 
 export const enum InviteTargetType {
   STREAM = 1,
-  EMBEDDED_APPLICATION = 2,
+  EMBEDDED_APPLICATION,
+  ROLE_SUBSCRIPTIONS,
+  CREATOR_PAGE,
+}
+
+export const enum InviteType {
+  GUILD,
+  GROUP_DM,
+  FRIEND,
 }
 
 export const enum MembershipStates {
@@ -249,8 +195,6 @@ export const enum MessageButtonStyles {
 export const enum MessageComponentTypes {
   ACTION_ROW = 1,
   BUTTON = 2,
-  /** @deprecated Use `STRING_SELECT` instead */
-  SELECT_MENU = 3,
   STRING_SELECT = 3,
   TEXT_INPUT = 4,
   USER_SELECT = 5,
@@ -260,8 +204,6 @@ export const enum MessageComponentTypes {
 }
 
 export const enum SelectMenuComponentTypes {
-  /** @deprecated Use `STRING_SELECT` instead */
-  SELECT_MENU = 3,
   STRING_SELECT = 3,
   USER_SELECT = 5,
   ROLE_SELECT = 6,
@@ -344,3 +286,12 @@ export enum ApplicationRoleConnectionMetadataTypes {
   BOOLEAN_EQUAL,
   BOOLEAN_NOT_EQUAL,
 }
+
+export const enum RelationshipType {
+  NONE = 0,
+  FRIEND = 1,
+  BLOCKED = 2,
+  PENDING_INCOMING = 3,
+  PENDING_OUTGOING = 4,
+  IMPLICIT = 5,
+}