discord.js 15.0.0-dev.1765454516-df0c28afc → 15.0.0-dev.1766016119-427636ee7

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "discord.js",
-  "version": "15.0.0-dev.1765454516-df0c28afc",
+  "version": "15.0.0-dev.1766016119-427636ee7",
   "description": "A powerful library for interacting with the Discord API",
   "main": "./src/index.js",
   "types": "./typings/index.d.ts",
@@ -61,12 +61,12 @@
     "magic-bytes.js": "^1.12.1",
     "tslib": "^2.8.1",
     "undici": "7.16.0",
-    "@discordjs/builders": "2.0.0-dev.1765454516-df0c28afc",
-    "@discordjs/formatters": "1.0.0-dev.1765454516-df0c28afc",
-    "@discordjs/rest": "3.0.0-dev.1765454516-df0c28afc",
-    "@discordjs/collection": "3.0.0-dev.1765454516-df0c28afc",
-    "@discordjs/util": "2.0.0-dev.1765454516-df0c28afc",
-    "@discordjs/ws": "3.0.0-dev.1765454516-df0c28afc"
+    "@discordjs/collection": "3.0.0-dev.1766016119-427636ee7",
+    "@discordjs/builders": "2.0.0-dev.1766016119-427636ee7",
+    "@discordjs/formatters": "1.0.0-dev.1766016119-427636ee7",
+    "@discordjs/util": "2.0.0-dev.1766016119-427636ee7",
+    "@discordjs/ws": "3.0.0-dev.1766016119-427636ee7",
+    "@discordjs/rest": "3.0.0-dev.1766016119-427636ee7"
   },
   "devDependencies": {
     "@favware/cliff-jumper": "^6.0.0",

package/src/index.js

@@ -105,6 +105,8 @@ exports.ActionRow = require('./structures/ActionRow.js').ActionRow;
 exports.Activity = require('./structures/Presence.js').Activity;
 exports.AnnouncementChannel = require('./structures/AnnouncementChannel.js').AnnouncementChannel;
 exports.AnonymousGuild = require('./structures/AnonymousGuild.js').AnonymousGuild;
+exports.AuthorizingIntegrationOwners =
+  require('./structures/AuthorizingIntegrationOwners.js').AuthorizingIntegrationOwners;
 exports.Application = require('./structures/interfaces/Application.js').Application;
 exports.ApplicationCommand = require('./structures/ApplicationCommand.js').ApplicationCommand;
 exports.ApplicationEmoji = require('./structures/ApplicationEmoji.js').ApplicationEmoji;

package/src/managers/RoleManager.js

@@ -81,6 +81,17 @@ class RoleManager extends CachedManager {
     return this._add(data, cache);
   }
 
+  /**
+   * Fetches the member count of each role in the guild.
+   * <info>This does not include the `@everyone` role.</info>
+   *
+   * @returns {Promise<Collection<Snowflake, number>>} A collection mapping role ids to their respective member counts.
+   */
+  async fetchMemberCounts() {
+    const data = await this.client.rest.get(Routes.guildRoleMemberCounts(this.guild.id));
+    return new Collection(Object.entries(data));
+  }
+
   /**
    * Data that can be resolved to a Role object. This can be:
    * - A Role

package/src/structures/AuthorizingIntegrationOwners.js

@@ -0,0 +1,64 @@
+'use strict';
+
+const { ApplicationIntegrationType } = require('discord-api-types/v10');
+const { Base } = require('./Base.js');
+
+/**
+ * Represents the owners of an authorizing integration.
+ *
+ * @extends {Base}
+ */
+class AuthorizingIntegrationOwners extends Base {
+  constructor(client, data) {
+    super(client);
+
+    Object.defineProperty(this, 'data', { value: data });
+
+    // Support accessing authorizingIntegrationOwners[ApplicationIntegrationType.GuildInstall] or similar, + forward compatibility if new installation types get added
+    for (const value of Object.values(ApplicationIntegrationType)) {
+      if (typeof value !== 'number') {
+        continue;
+      }
+
+      Object.defineProperty(this, value, { value: this.data[value] });
+    }
+
+    /**
+     * The id of the guild where the integration is installed, if applicable.
+     *
+     * @type {?Snowflake}
+     */
+    this.guildId = this.data[ApplicationIntegrationType.GuildInstall] ?? null;
+
+    /**
+     * The id of the user on which the integration is installed, if applicable.
+     *
+     * @type {?Snowflake}
+     */
+    this.userId = this.data[ApplicationIntegrationType.UserInstall] ?? null;
+  }
+
+  /**
+   * The guild where the integration is installed, if applicable.
+   *
+   * @type {?Guild}
+   */
+  get guild() {
+    return (this.guildId && this.client.guilds.cache.get(this.guildId)) ?? null;
+  }
+
+  /**
+   * The user on which the integration is installed, if applicable.
+   *
+   * @type {?User}
+   */
+  get user() {
+    return (this.userId && this.client.users.cache.get(this.userId)) ?? null;
+  }
+
+  toJSON() {
+    return this.data;
+  }
+}
+
+exports.AuthorizingIntegrationOwners = AuthorizingIntegrationOwners;

package/src/structures/BaseInteraction.js

@@ -5,6 +5,7 @@ const { DiscordSnowflake } = require('@sapphire/snowflake');
 const { InteractionType, ApplicationCommandType, ComponentType } = require('discord-api-types/v10');
 const { SelectMenuTypes } = require('../util/Constants.js');
 const { PermissionsBitField } = require('../util/PermissionsBitField.js');
+const { AuthorizingIntegrationOwners } = require('./AuthorizingIntegrationOwners.js');
 const { Base } = require('./Base.js');
 
 /**
@@ -123,12 +124,15 @@ class BaseInteraction extends Base {
     );
 
     /**
-     * Mapping of installation contexts that the interaction was authorized for the related user or guild ids
+     * Mapping of integration types that the application was authorized for the related user or guild ids
      *
-     * @type {APIAuthorizingIntegrationOwnersMap}
+     * @type {AuthorizingIntegrationOwners}
      * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-authorizing-integration-owners-object}
      */
-    this.authorizingIntegrationOwners = data.authorizing_integration_owners;
+    this.authorizingIntegrationOwners = new AuthorizingIntegrationOwners(
+      this.client,
+      data.authorizing_integration_owners,
+    );
 
     /**
      * Context where the interaction was triggered from

package/src/structures/Message.js

@@ -414,8 +414,8 @@ class Message extends Base {
        * @property {Snowflake} id The interaction's id
        * @property {InteractionType} type The type of the interaction
        * @property {User} user The user that invoked the interaction
-       * @property {APIAuthorizingIntegrationOwnersMap} authorizingIntegrationOwners
-       * Ids for installation context(s) related to an interaction
+       * @property {AuthorizingIntegrationOwners} authorizingIntegrationOwners
+       * Mapping of integration types that the application was authorized for the related user or guild ids
        * @property {?Snowflake} originalResponseMessageId
        * Id of the original response message. Present only on follow-up messages
        * @property {?Snowflake} interactedMessageId
@@ -1109,7 +1109,7 @@ class Message extends Base {
    * method allows you to see if there are differences in content, embeds, attachments, nonce and tts properties.
    *
    * @param {Message} message The message to compare it to
-   * @param {APIMessage} rawData Raw data passed through the WebSocket about this message
+   * @param {APIMessage} [rawData] Raw data passed through the WebSocket about this message
    * @returns {boolean}
    */
   equals(message, rawData) {

package/src/util/APITypes.js

@@ -35,11 +35,6 @@
  * @see {@link https://discord-api-types.dev/api/discord-api-types-v10/enum/ApplicationIntegrationType}
  */
 
-/**
- * @external APIAuthorizingIntegrationOwnersMap
- * @see {@link https://discord-api-types.dev/api/discord-api-types-v10#APIAuthorizingIntegrationOwnersMap}
- */
-
 /**
  * @external APIAutoModerationAction
  * @see {@link https://discord-api-types.dev/api/discord-api-types-v10/interface/APIAutoModerationAction}

package/src/util/Transformers.js

@@ -2,6 +2,7 @@
 
 const { isJSONEncodable } = require('@discordjs/util');
 const snakeCase = require('lodash.snakecase');
+const { AuthorizingIntegrationOwners } = require('../structures/AuthorizingIntegrationOwners.js');
 
 /**
  * Transforms camel-cased keys into snake cased keys
@@ -48,7 +49,10 @@ function _transformAPIMessageInteractionMetadata(client, messageInteractionMetad
     id: messageInteractionMetadata.id,
     type: messageInteractionMetadata.type,
     user: client.users._add(messageInteractionMetadata.user),
-    authorizingIntegrationOwners: messageInteractionMetadata.authorizing_integration_owners,
+    authorizingIntegrationOwners: new AuthorizingIntegrationOwners(
+      client,
+      messageInteractionMetadata.authorizing_integration_owners,
+    ),
     originalResponseMessageId: messageInteractionMetadata.original_response_message_id ?? null,
     interactedMessageId: messageInteractionMetadata.interacted_message_id ?? null,
     triggeringInteractionMetadata: messageInteractionMetadata.triggering_interaction_metadata

package/typings/index.d.mts

@@ -1927,7 +1927,7 @@ export class BaseInteraction<Cached extends CacheType = CacheType> extends Base
   private readonly _cacheType: Cached;
   protected constructor(client: Client<true>, data: GatewayInteractionCreateDispatchData);
   public applicationId: Snowflake;
-  public authorizingIntegrationOwners: APIAuthorizingIntegrationOwnersMap;
+  public authorizingIntegrationOwners: AuthorizingIntegrationOwners;
   public get channel(): CacheTypeReducer<
     Cached,
     GuildTextBasedChannel | null,
@@ -2242,7 +2242,7 @@ export class Message<InGuild extends boolean = boolean> extends Base {
       | MessagePayload
       | string,
   ): Promise<OmitPartialGroupDMChannel<Message<InGuild>>>;
-  public equals(message: Message, rawData: unknown): boolean;
+  public equals(message: Message, rawData?: APIMessage): boolean;
   public fetchReference(): Promise<OmitPartialGroupDMChannel<Message<InGuild>>>;
   public fetchWebhook(): Promise<Webhook>;
   public crosspost(): Promise<OmitPartialGroupDMChannel<Message<InGuild>>>;
@@ -2265,6 +2265,22 @@ export class Message<InGuild extends boolean = boolean> extends Base {
   public inGuild(): this is Message<true>;
 }
 
+export class AuthorizingIntegrationOwners extends Base {
+  private constructor(client: Client<true>, data: APIAuthorizingIntegrationOwnersMap);
+  private readonly data: APIAuthorizingIntegrationOwnersMap;
+
+  // Getters from types
+  public readonly [ApplicationIntegrationType.GuildInstall]?: Snowflake;
+  public readonly [ApplicationIntegrationType.UserInstall]?: Snowflake;
+
+  public readonly guildId: Snowflake | null;
+  public get guild(): Guild | null;
+  public readonly userId: Snowflake | null;
+  public get user(): User | null;
+
+  public toJSON(): APIAuthorizingIntegrationOwnersMap;
+}
+
 export class Attachment {
   private constructor(data: APIAttachment);
   private readonly attachment: BufferResolvable | Stream;
@@ -4707,6 +4723,7 @@ export class RoleManager extends CachedManager<Snowflake, Role, RoleResolvable>
   public botRoleFor(user: UserResolvable): Role | null;
   public fetch(id: Snowflake, options?: BaseFetchOptions): Promise<Role>;
   public fetch(id?: undefined, options?: BaseFetchOptions): Promise<Collection<Snowflake, Role>>;
+  public fetchMemberCounts(): Promise<Collection<Snowflake, number>>;
   public create(options?: RoleCreateOptions): Promise<Role>;
   public edit(role: RoleResolvable, options: RoleEditOptions): Promise<Role>;
   public delete(role: RoleResolvable, reason?: string): Promise<void>;
@@ -6642,7 +6659,7 @@ export interface MessageChannelComponentCollectorOptions<
 }
 
 export interface MessageInteractionMetadata {
-  authorizingIntegrationOwners: APIAuthorizingIntegrationOwnersMap;
+  authorizingIntegrationOwners: AuthorizingIntegrationOwners;
   id: Snowflake;
   interactedMessageId: Snowflake | null;
   originalResponseMessageId: Snowflake | null;

package/typings/index.d.ts

@@ -1927,7 +1927,7 @@ export class BaseInteraction<Cached extends CacheType = CacheType> extends Base
   private readonly _cacheType: Cached;
   protected constructor(client: Client<true>, data: GatewayInteractionCreateDispatchData);
   public applicationId: Snowflake;
-  public authorizingIntegrationOwners: APIAuthorizingIntegrationOwnersMap;
+  public authorizingIntegrationOwners: AuthorizingIntegrationOwners;
   public get channel(): CacheTypeReducer<
     Cached,
     GuildTextBasedChannel | null,
@@ -2242,7 +2242,7 @@ export class Message<InGuild extends boolean = boolean> extends Base {
       | MessagePayload
       | string,
   ): Promise<OmitPartialGroupDMChannel<Message<InGuild>>>;
-  public equals(message: Message, rawData: unknown): boolean;
+  public equals(message: Message, rawData?: APIMessage): boolean;
   public fetchReference(): Promise<OmitPartialGroupDMChannel<Message<InGuild>>>;
   public fetchWebhook(): Promise<Webhook>;
   public crosspost(): Promise<OmitPartialGroupDMChannel<Message<InGuild>>>;
@@ -2265,6 +2265,22 @@ export class Message<InGuild extends boolean = boolean> extends Base {
   public inGuild(): this is Message<true>;
 }
 
+export class AuthorizingIntegrationOwners extends Base {
+  private constructor(client: Client<true>, data: APIAuthorizingIntegrationOwnersMap);
+  private readonly data: APIAuthorizingIntegrationOwnersMap;
+
+  // Getters from types
+  public readonly [ApplicationIntegrationType.GuildInstall]?: Snowflake;
+  public readonly [ApplicationIntegrationType.UserInstall]?: Snowflake;
+
+  public readonly guildId: Snowflake | null;
+  public get guild(): Guild | null;
+  public readonly userId: Snowflake | null;
+  public get user(): User | null;
+
+  public toJSON(): APIAuthorizingIntegrationOwnersMap;
+}
+
 export class Attachment {
   private constructor(data: APIAttachment);
   private readonly attachment: BufferResolvable | Stream;
@@ -4707,6 +4723,7 @@ export class RoleManager extends CachedManager<Snowflake, Role, RoleResolvable>
   public botRoleFor(user: UserResolvable): Role | null;
   public fetch(id: Snowflake, options?: BaseFetchOptions): Promise<Role>;
   public fetch(id?: undefined, options?: BaseFetchOptions): Promise<Collection<Snowflake, Role>>;
+  public fetchMemberCounts(): Promise<Collection<Snowflake, number>>;
   public create(options?: RoleCreateOptions): Promise<Role>;
   public edit(role: RoleResolvable, options: RoleEditOptions): Promise<Role>;
   public delete(role: RoleResolvable, reason?: string): Promise<void>;
@@ -6642,7 +6659,7 @@ export interface MessageChannelComponentCollectorOptions<
 }
 
 export interface MessageInteractionMetadata {
-  authorizingIntegrationOwners: APIAuthorizingIntegrationOwnersMap;
+  authorizingIntegrationOwners: AuthorizingIntegrationOwners;
   id: Snowflake;
   interactedMessageId: Snowflake | null;
   originalResponseMessageId: Snowflake | null;