djs-selfbot-v13 3.1.8 → 3.7.1

package/src/managers/PermissionOverwriteManager.js

@@ -1,166 +1,164 @@
-'use strict';
-
-const process = require('node:process');
-const { Collection } = require('@discordjs/collection');
-const CachedManager = require('./CachedManager');
-const { TypeError } = require('../errors');
-const PermissionOverwrites = require('../structures/PermissionOverwrites');
-const { Role } = require('../structures/Role');
-const { OverwriteTypes } = require('../util/Constants');
-
-let cacheWarningEmitted = false;
-
-/**
- * Manages API methods for guild channel permission overwrites and stores their cache.
- * @extends {CachedManager}
- */
-class PermissionOverwriteManager extends CachedManager {
-  constructor(channel, iterable) {
-    super(channel.client, PermissionOverwrites);
-    if (!cacheWarningEmitted && this._cache.constructor.name !== 'Collection') {
-      cacheWarningEmitted = true;
-      process.emitWarning(
-        `Overriding the cache handling for ${this.constructor.name} is unsupported and breaks functionality.`,
-        'UnsupportedCacheOverwriteWarning',
-      );
-    }
-
-    /**
-     * The channel of the permission overwrite this manager belongs to
-     * @type {GuildChannel}
-     */
-    this.channel = channel;
-
-    if (iterable) {
-      for (const item of iterable) {
-        this._add(item);
-      }
-    }
-  }
-
-  /**
-   * The cache of this Manager
-   * @type {Collection<Snowflake, PermissionOverwrites>}
-   * @name PermissionOverwriteManager#cache
-   */
-
-  _add(data, cache) {
-    return super._add(data, cache, { extras: [this.channel] });
-  }
-
-  /**
-   * Replaces the permission overwrites in this channel.
-   * @param {OverwriteResolvable[]|Collection<Snowflake, OverwriteResolvable>} overwrites
-   * Permission overwrites the channel gets updated with
-   * @param {string} [reason] Reason for updating the channel overwrites
-   * @returns {Promise<GuildChannel>}
-   * @example
-   * message.channel.permissionOverwrites.set([
-   *   {
-   *      id: message.author.id,
-   *      deny: [Permissions.FLAGS.VIEW_CHANNEL],
-   *   },
-   * ], 'Needed to change permissions');
-   */
-  set(overwrites, reason) {
-    if (!Array.isArray(overwrites) && !(overwrites instanceof Collection)) {
-      return Promise.reject(
-        new TypeError('INVALID_TYPE', 'overwrites', 'Array or Collection of Permission Overwrites', true),
-      );
-    }
-    return this.channel.edit({ permissionOverwrites: overwrites, reason });
-  }
-
-  /**
-   * Extra information about the overwrite
-   * @typedef {Object} GuildChannelOverwriteOptions
-   * @property {string} [reason] Reason for creating/editing this overwrite
-   * @property {number} [type] The type of overwrite, either `0` for a role or `1` for a member. Use this to bypass
-   * automatic resolution of type that results in an error for uncached structure
-   */
-
-  /**
-   * Creates or edits permission overwrites for a user or role in this channel.
-   * @param {RoleResolvable|UserResolvable} userOrRole The user or role to update
-   * @param {PermissionOverwriteOptions} options The options for the update
-   * @param {GuildChannelOverwriteOptions} [overwriteOptions] The extra information for the update
-   * @param {PermissionOverwrites} [existing] The existing overwrites to merge with this update
-   * @returns {Promise<GuildChannel>}
-   * @private
-   */
-  async upsert(userOrRole, options, overwriteOptions = {}, existing) {
-    let userOrRoleId = this.channel.guild.roles.resolveId(userOrRole) ?? this.client.users.resolveId(userOrRole);
-    let { type, reason } = overwriteOptions;
-    if (typeof type !== 'number') {
-      userOrRole = this.channel.guild.roles.resolve(userOrRole) ?? this.client.users.resolve(userOrRole);
-      if (!userOrRole) throw new TypeError('INVALID_TYPE', 'parameter', 'User nor a Role');
-      type = userOrRole instanceof Role ? OverwriteTypes.role : OverwriteTypes.member;
-    }
-
-    const { allow, deny } = PermissionOverwrites.resolveOverwriteOptions(options, existing);
-
-    await this.client.api
-      .channels(this.channel.id)
-      .permissions(userOrRoleId)
-      .put({
-        data: { id: userOrRoleId, type, allow, deny },
-        reason,
-      });
-    return this.channel;
-  }
-
-  /**
-   * Creates permission overwrites for a user or role in this channel, or replaces them if already present.
-   * @param {RoleResolvable|UserResolvable} userOrRole The user or role to update
-   * @param {PermissionOverwriteOptions} options The options for the update
-   * @param {GuildChannelOverwriteOptions} [overwriteOptions] The extra information for the update
-   * @returns {Promise<GuildChannel>}
-   * @example
-   * // Create or Replace permission overwrites for a message author
-   * message.channel.permissionOverwrites.create(message.author, {
-   *   SEND_MESSAGES: false
-   * })
-   *   .then(channel => console.log(channel.permissionOverwrites.cache.get(message.author.id)))
-   *   .catch(console.error);
-   */
-  create(userOrRole, options, overwriteOptions) {
-    return this.upsert(userOrRole, options, overwriteOptions);
-  }
-
-  /**
-   * Edits permission overwrites for a user or role in this channel, or creates an entry if not already present.
-   * @param {RoleResolvable|UserResolvable} userOrRole The user or role to update
-   * @param {PermissionOverwriteOptions} options The options for the update
-   * @param {GuildChannelOverwriteOptions} [overwriteOptions] The extra information for the update
-   * @returns {Promise<GuildChannel>}
-   * @example
-   * // Edit or Create permission overwrites for a message author
-   * message.channel.permissionOverwrites.edit(message.author, {
-   *   SEND_MESSAGES: false
-   * })
-   *   .then(channel => console.log(channel.permissionOverwrites.cache.get(message.author.id)))
-   *   .catch(console.error);
-   */
-  edit(userOrRole, options, overwriteOptions) {
-    const existing = this.cache.get(
-      this.channel.guild.roles.resolveId(userOrRole) ?? this.client.users.resolveId(userOrRole),
-    );
-    return this.upsert(userOrRole, options, overwriteOptions, existing);
-  }
-
-  /**
-   * Deletes permission overwrites for a user or role in this channel.
-   * @param {UserResolvable|RoleResolvable} userOrRole The user or role to delete
-   * @param {string} [reason] The reason for deleting the overwrite
-   * @returns {Promise<GuildChannel>}
-   */
-  async delete(userOrRole, reason) {
-    const userOrRoleId = this.channel.guild.roles.resolveId(userOrRole) ?? this.client.users.resolveId(userOrRole);
-    if (!userOrRoleId) throw new TypeError('INVALID_TYPE', 'parameter', 'User nor a Role');
-
-    await this.client.api.channels(this.channel.id).permissions(userOrRoleId).delete({ reason });
-    return this.channel;
-  }
-}
-
-module.exports = PermissionOverwriteManager;
+'use strict';
+
+const process = require('node:process');
+const { Collection } = require('@discordjs/collection');
+const CachedManager = require('./CachedManager');
+const { TypeError } = require('../errors');
+const PermissionOverwrites = require('../structures/PermissionOverwrites');
+const { Role } = require('../structures/Role');
+const { OverwriteTypes } = require('../util/Constants');
+
+let cacheWarningEmitted = false;
+
+/**
+ * Manages API methods for guild channel permission overwrites and stores their cache.
+ * @extends {CachedManager}
+ */
+class PermissionOverwriteManager extends CachedManager {
+  constructor(channel, iterable) {
+    super(channel.client, PermissionOverwrites);
+    if (!cacheWarningEmitted && this._cache.constructor.name !== 'Collection') {
+      cacheWarningEmitted = true;
+      process.emitWarning(
+        `Overriding the cache handling for ${this.constructor.name} is unsupported and breaks functionality.`,
+        'UnsupportedCacheOverwriteWarning',
+      );
+    }
+
+    /**
+     * The channel of the permission overwrite this manager belongs to
+     * @type {GuildChannel}
+     */
+    this.channel = channel;
+
+    if (iterable) {
+      for (const item of iterable) {
+        this._add(item);
+      }
+    }
+  }
+
+  /**
+   * The cache of this Manager
+   * @type {Collection<Snowflake, PermissionOverwrites>}
+   * @name PermissionOverwriteManager#cache
+   */
+
+  _add(data, cache) {
+    return super._add(data, cache, { extras: [this.channel] });
+  }
+
+  /**
+   * Replaces the permission overwrites in this channel.
+   * @param {OverwriteResolvable[]|Collection<Snowflake, OverwriteResolvable>} overwrites
+   * Permission overwrites the channel gets updated with
+   * @param {string} [reason] Reason for updating the channel overwrites
+   * @returns {Promise<GuildChannel>}
+   * @example
+   * message.channel.permissionOverwrites.set([
+   *   {
+   *      id: message.author.id,
+   *      deny: [Permissions.FLAGS.VIEW_CHANNEL],
+   *   },
+   * ], 'Needed to change permissions');
+   */
+  async set(overwrites, reason) {
+    if (!Array.isArray(overwrites) && !(overwrites instanceof Collection)) {
+      throw new TypeError('INVALID_TYPE', 'overwrites', 'Array or Collection of Permission Overwrites', true);
+    }
+    return this.channel.edit({ permissionOverwrites: overwrites, reason });
+  }
+
+  /**
+   * Extra information about the overwrite
+   * @typedef {Object} GuildChannelOverwriteOptions
+   * @property {string} [reason] Reason for creating/editing this overwrite
+   * @property {number} [type] The type of overwrite, either `0` for a role or `1` for a member. Use this to bypass
+   * automatic resolution of type that results in an error for uncached structure
+   */
+
+  /**
+   * Creates or edits permission overwrites for a user or role in this channel.
+   * @param {RoleResolvable|UserResolvable} userOrRole The user or role to update
+   * @param {PermissionOverwriteOptions} options The options for the update
+   * @param {GuildChannelOverwriteOptions} [overwriteOptions] The extra information for the update
+   * @param {PermissionOverwrites} [existing] The existing overwrites to merge with this update
+   * @returns {Promise<GuildChannel>}
+   * @private
+   */
+  async upsert(userOrRole, options, overwriteOptions = {}, existing) {
+    let userOrRoleId = this.channel.guild.roles.resolveId(userOrRole) ?? this.client.users.resolveId(userOrRole);
+    let { type, reason } = overwriteOptions;
+    if (typeof type !== 'number') {
+      userOrRole = this.channel.guild.roles.resolve(userOrRole) ?? this.client.users.resolve(userOrRole);
+      if (!userOrRole) throw new TypeError('INVALID_TYPE', 'parameter', 'User nor a Role');
+      type = userOrRole instanceof Role ? OverwriteTypes.role : OverwriteTypes.member;
+    }
+
+    const { allow, deny } = PermissionOverwrites.resolveOverwriteOptions(options, existing);
+
+    await this.client.api
+      .channels(this.channel.id)
+      .permissions(userOrRoleId)
+      .put({
+        data: { id: userOrRoleId, type, allow, deny },
+        reason,
+      });
+    return this.channel;
+  }
+
+  /**
+   * Creates permission overwrites for a user or role in this channel, or replaces them if already present.
+   * @param {RoleResolvable|UserResolvable} userOrRole The user or role to update
+   * @param {PermissionOverwriteOptions} options The options for the update
+   * @param {GuildChannelOverwriteOptions} [overwriteOptions] The extra information for the update
+   * @returns {Promise<GuildChannel>}
+   * @example
+   * // Create or Replace permission overwrites for a message author
+   * message.channel.permissionOverwrites.create(message.author, {
+   *   SEND_MESSAGES: false
+   * })
+   *   .then(channel => console.log(channel.permissionOverwrites.cache.get(message.author.id)))
+   *   .catch(console.error);
+   */
+  create(userOrRole, options, overwriteOptions) {
+    return this.upsert(userOrRole, options, overwriteOptions);
+  }
+
+  /**
+   * Edits permission overwrites for a user or role in this channel, or creates an entry if not already present.
+   * @param {RoleResolvable|UserResolvable} userOrRole The user or role to update
+   * @param {PermissionOverwriteOptions} options The options for the update
+   * @param {GuildChannelOverwriteOptions} [overwriteOptions] The extra information for the update
+   * @returns {Promise<GuildChannel>}
+   * @example
+   * // Edit or Create permission overwrites for a message author
+   * message.channel.permissionOverwrites.edit(message.author, {
+   *   SEND_MESSAGES: false
+   * })
+   *   .then(channel => console.log(channel.permissionOverwrites.cache.get(message.author.id)))
+   *   .catch(console.error);
+   */
+  edit(userOrRole, options, overwriteOptions) {
+    const existing = this.cache.get(
+      this.channel.guild.roles.resolveId(userOrRole) ?? this.client.users.resolveId(userOrRole),
+    );
+    return this.upsert(userOrRole, options, overwriteOptions, existing);
+  }
+
+  /**
+   * Deletes permission overwrites for a user or role in this channel.
+   * @param {UserResolvable|RoleResolvable} userOrRole The user or role to delete
+   * @param {string} [reason] The reason for deleting the overwrite
+   * @returns {Promise<GuildChannel>}
+   */
+  async delete(userOrRole, reason) {
+    const userOrRoleId = this.channel.guild.roles.resolveId(userOrRole) ?? this.client.users.resolveId(userOrRole);
+    if (!userOrRoleId) throw new TypeError('INVALID_TYPE', 'parameter', 'User nor a Role');
+
+    await this.client.api.channels(this.channel.id).permissions(userOrRoleId).delete({ reason });
+    return this.channel;
+  }
+}
+
+module.exports = PermissionOverwriteManager;

package/src/managers/PresenceManager.js

@@ -1,58 +1,71 @@
-'use strict';
-
-const CachedManager = require('./CachedManager');
-const { Presence } = require('../structures/Presence');
-
-/**
- * Manages API methods for Presences and holds their cache.
- * @extends {CachedManager}
- */
-class PresenceManager extends CachedManager {
-  constructor(client, iterable) {
-    super(client, Presence, iterable);
-  }
-
-  /**
-   * The cache of Presences
-   * @type {Collection<Snowflake, Presence>}
-   * @name PresenceManager#cache
-   */
-
-  _add(data, cache) {
-    return super._add(data, cache, { id: data.user.id });
-  }
-
-  /**
-   * Data that can be resolved to a Presence object. This can be:
-   * * A Presence
-   * * A UserResolvable
-   * * A Snowflake
-   * @typedef {Presence|UserResolvable|Snowflake} PresenceResolvable
-   */
-
-  /**
-   * Resolves a {@link PresenceResolvable} to a {@link Presence} object.
-   * @param {PresenceResolvable} presence The presence resolvable to resolve
-   * @returns {?Presence}
-   */
-  resolve(presence) {
-    const presenceResolvable = super.resolve(presence);
-    if (presenceResolvable) return presenceResolvable;
-    const UserResolvable = this.client.users.resolveId(presence);
-    return super.resolve(UserResolvable);
-  }
-
-  /**
-   * Resolves a {@link PresenceResolvable} to a {@link Presence} id.
-   * @param {PresenceResolvable} presence The presence resolvable to resolve
-   * @returns {?Snowflake}
-   */
-  resolveId(presence) {
-    const presenceResolvable = super.resolveId(presence);
-    if (presenceResolvable) return presenceResolvable;
-    const userResolvable = this.client.users.resolveId(presence);
-    return this.cache.has(userResolvable) ? userResolvable : null;
-  }
-}
-
-module.exports = PresenceManager;
+'use strict';
+
+const CachedManager = require('./CachedManager');
+const { Presence } = require('../structures/Presence');
+
+/**
+ * Manages API methods for Presences and holds their cache.
+ * @extends {CachedManager}
+ */
+class PresenceManager extends CachedManager {
+  constructor(client, iterable) {
+    super(client, Presence, iterable);
+  }
+
+  /**
+   * The cache of Presences
+   * @type {Collection<Snowflake, Presence>}
+   * @name PresenceManager#cache
+   */
+
+  _add(data, cache) {
+    return super._add(data, cache, { id: data.user.id });
+  }
+
+  /**
+   * Data that can be resolved to a Presence object. This can be:
+   * * A Presence
+   * * A UserResolvable
+   * * A Snowflake
+   * @typedef {Presence|UserResolvable|Snowflake} PresenceResolvable
+   */
+
+  /**
+   * Resolves a {@link PresenceResolvable} to a {@link Presence} object.
+   * @param {PresenceResolvable} presence The presence resolvable to resolve
+   * @returns {?Presence}
+   */
+  resolve(presence) {
+    const presenceResolvable = super.resolve(presence);
+    if (presenceResolvable) return presenceResolvable;
+    const userId = this.client.users.resolveId(presence);
+    return this.cache.get(userId) ?? null;
+  }
+
+  /**
+   * Resolves a {@link PresenceResolvable} to a {@link Presence} id.
+   * @param {PresenceResolvable} presence The presence resolvable to resolve
+   * @returns {?Snowflake}
+   */
+  resolveId(presence) {
+    const presenceResolvable = super.resolveId(presence);
+    if (presenceResolvable) return presenceResolvable;
+    const userId = this.client.users.resolveId(presence);
+    return this.cache.has(userId) ? userId : null;
+  }
+
+  /**
+   * Fetches the overall user presence for all of the user's non-offline friends and implicit relationships.
+   * @returns {Promise<Collection<Snowflake, Presence>>}
+   */
+  async fetch() {
+    const data = await this.client.api.presences.get();
+    // https://docs.discord.food/resources/presence#endpoints
+    data.presences.forEach(presence => {
+      this._add(presence, true);
+    });
+    return this.cache;
+  }
+}
+
+module.exports = PresenceManager;

package/src/managers/ReactionManager.js

@@ -1,67 +1,67 @@
-'use strict';
-
-const CachedManager = require('./CachedManager');
-const MessageReaction = require('../structures/MessageReaction');
-
-/**
- * Manages API methods for reactions and holds their cache.
- * @extends {CachedManager}
- */
-class ReactionManager extends CachedManager {
-  constructor(message, iterable) {
-    super(message.client, MessageReaction, iterable);
-
-    /**
-     * The message that this manager belongs to
-     * @type {Message}
-     */
-    this.message = message;
-  }
-
-  _add(data, cache) {
-    return super._add(data, cache, { id: data.emoji.id ?? data.emoji.name, extras: [this.message] });
-  }
-
-  /**
-   * The reaction cache of this manager
-   * @type {Collection<string|Snowflake, MessageReaction>}
-   * @name ReactionManager#cache
-   */
-
-  /**
-   * Data that can be resolved to a MessageReaction object. This can be:
-   * * A MessageReaction
-   * * A Snowflake
-   * * The Unicode representation of an emoji
-   * @typedef {MessageReaction|Snowflake} MessageReactionResolvable
-   */
-
-  /**
-   * Resolves a {@link MessageReactionResolvable} to a {@link MessageReaction} object.
-   * @method resolve
-   * @memberof ReactionManager
-   * @instance
-   * @param {MessageReactionResolvable} reaction The MessageReaction to resolve
-   * @returns {?MessageReaction}
-   */
-
-  /**
-   * Resolves a {@link MessageReactionResolvable} to a {@link MessageReaction} id.
-   * @method resolveId
-   * @memberof ReactionManager
-   * @instance
-   * @param {MessageReactionResolvable} reaction The MessageReaction to resolve
-   * @returns {?Snowflake}
-   */
-
-  /**
-   * Removes all reactions from a message.
-   * @returns {Promise<Message>}
-   */
-  async removeAll() {
-    await this.client.api.channels(this.message.channelId).messages(this.message.id).reactions.delete();
-    return this.message;
-  }
-}
-
-module.exports = ReactionManager;
+'use strict';
+
+const CachedManager = require('./CachedManager');
+const MessageReaction = require('../structures/MessageReaction');
+
+/**
+ * Manages API methods for reactions and holds their cache.
+ * @extends {CachedManager}
+ */
+class ReactionManager extends CachedManager {
+  constructor(message, iterable) {
+    super(message.client, MessageReaction, iterable);
+
+    /**
+     * The message that this manager belongs to
+     * @type {Message}
+     */
+    this.message = message;
+  }
+
+  _add(data, cache) {
+    return super._add(data, cache, { id: data.emoji.id ?? data.emoji.name, extras: [this.message] });
+  }
+
+  /**
+   * The reaction cache of this manager
+   * @type {Collection<string|Snowflake, MessageReaction>}
+   * @name ReactionManager#cache
+   */
+
+  /**
+   * Data that can be resolved to a MessageReaction object. This can be:
+   * * A MessageReaction
+   * * A Snowflake
+   * * The Unicode representation of an emoji
+   * @typedef {MessageReaction|Snowflake} MessageReactionResolvable
+   */
+
+  /**
+   * Resolves a {@link MessageReactionResolvable} to a {@link MessageReaction} object.
+   * @method resolve
+   * @memberof ReactionManager
+   * @instance
+   * @param {MessageReactionResolvable} reaction The MessageReaction to resolve
+   * @returns {?MessageReaction}
+   */
+
+  /**
+   * Resolves a {@link MessageReactionResolvable} to a {@link MessageReaction} id.
+   * @method resolveId
+   * @memberof ReactionManager
+   * @instance
+   * @param {MessageReactionResolvable} reaction The MessageReaction to resolve
+   * @returns {?Snowflake}
+   */
+
+  /**
+   * Removes all reactions from a message.
+   * @returns {Promise<Message>}
+   */
+  async removeAll() {
+    await this.client.api.channels(this.message.channelId).messages(this.message.id).reactions.delete();
+    return this.message;
+  }
+}
+
+module.exports = ReactionManager;