@discordjs/core 2.3.0 → 2.4.0

package/dist/index.js

@@ -20,14 +20,15 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   API: () => API,
   ApplicationCommandsAPI: () => ApplicationCommandsAPI,
   ApplicationsAPI: () => ApplicationsAPI,
   ChannelsAPI: () => ChannelsAPI,
   Client: () => Client,
   GatewayAPI: () => GatewayAPI,
+  GatewayRateLimitError: () => import_util2.GatewayRateLimitError,
   GuildsAPI: () => GuildsAPI,
   InteractionsAPI: () => InteractionsAPI,
   InvitesAPI: () => InvitesAPI,
@@ -35,6 +36,7 @@ __export(src_exports, {
   OAuth2API: () => OAuth2API,
   PollAPI: () => PollAPI,
   RoleConnectionsAPI: () => RoleConnectionsAPI,
+  SoundboardSoundsAPI: () => SoundboardSoundsAPI,
   StageInstancesAPI: () => StageInstancesAPI,
   StickersAPI: () => StickersAPI,
   ThreadsAPI: () => ThreadsAPI,
@@ -44,7 +46,7 @@ __export(src_exports, {
   version: () => version,
   withFiles: () => withFiles
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/api/applicationCommands.ts
 var import_rest = require("@discordjs/rest");
@@ -792,6 +794,20 @@ var ChannelsAPI = class {
       signal
     });
   }
+  /**
+   * Sends a soundboard sound in a channel
+   *
+   * @see {@link https://discord.com/developers/docs/resources/soundboard#send-soundboard-sound}
+   * @param channelId - The id of the channel to send the soundboard sound in
+   * @param body - The data for sending the soundboard sound
+   * @param options - The options for sending the soundboard sound
+   */
+  async sendSoundboardSound(channelId, body, { signal } = {}) {
+    return this.rest.post(import_v103.Routes.sendSoundboardSound(channelId), {
+      body,
+      signal
+    });
+  }
   /**
    * Adds a recipient to a group DM channel
    *
@@ -1012,7 +1028,7 @@ var GuildsAPI = class {
     });
   }
   /**
-   * Fetches all the members of a guild
+   * Fetches members of a guild.
    *
    * @see {@link https://discord.com/developers/docs/resources/guild#list-guild-members}
    * @param guildId - The id of the guild
@@ -1883,6 +1899,73 @@ var GuildsAPI = class {
       signal
     });
   }
+  /**
+   * Fetches all the soundboard sounds for a guild
+   *
+   * @see {@link https://discord.com/developers/docs/resources/soundboard#list-guild-soundboard-sounds}
+   * @param guildId - The id of the guild to fetch the soundboard sounds for
+   * @param options - The options for fetching the soundboard sounds
+   */
+  async getSoundboardSounds(guildId, { signal } = {}) {
+    return this.rest.get(import_v106.Routes.guildSoundboardSounds(guildId), {
+      signal
+    });
+  }
+  /**
+   * Fetches a soundboard sound for a guild
+   *
+   * @see {@link https://discord.com/developers/docs/resources/soundboard#get-guild-soundboard-sound}
+   * @param guildId - The id of the guild to fetch the soundboard sound for
+   * @param soundId - The id of the soundboard sound to fetch
+   * @param options - The options for fetching the soundboard sound
+   */
+  async getSoundboardSound(guildId, soundId, { signal } = {}) {
+    return this.rest.get(import_v106.Routes.guildSoundboardSound(guildId, soundId), {
+      signal
+    });
+  }
+  /**
+   * Creates a new soundboard sound for a guild
+   *
+   * @see {@link https://discord.com/developers/docs/resources/soundboard#create-guild-soundboard-sound}
+   * @param guildId - The id of the guild to create the soundboard sound for
+   * @param body - The data for creating the soundboard sound
+   * @param options - The options for creating the soundboard sound
+   */
+  async createSoundboardSound(guildId, body, { reason, signal } = {}) {
+    return this.rest.post(import_v106.Routes.guildSoundboardSounds(guildId), {
+      body,
+      reason,
+      signal
+    });
+  }
+  /**
+   * Edits a soundboard sound for a guild
+   *
+   * @see {@link https://discord.com/developers/docs/resources/soundboard#modify-guild-soundboard-sound}
+   * @param guildId - The id of the guild to edit the soundboard sound for
+   * @param soundId - The id of the soundboard sound to edit
+   * @param body - The data for editing the soundboard sound
+   * @param options - The options for editing the soundboard sound
+   */
+  async editSoundboardSound(guildId, soundId, body, { reason, signal } = {}) {
+    return this.rest.patch(import_v106.Routes.guildSoundboardSound(guildId, soundId), {
+      body,
+      reason,
+      signal
+    });
+  }
+  /**
+   * Deletes a soundboard sound for a guild
+   *
+   * @see {@link https://discord.com/developers/docs/resources/soundboard#delete-guild-soundboard-sound}
+   * @param guildId - The id of the guild to delete the soundboard sound for
+   * @param soundId - The id of the soundboard sound to delete
+   * @param options - The options for deleting the soundboard sound
+   */
+  async deleteSoundboardSound(guildId, soundId, { reason, signal } = {}) {
+    await this.rest.delete(import_v106.Routes.guildSoundboardSound(guildId, soundId), { reason, signal });
+  }
   /**
    * Modifies incident actions for a guild.
    *
@@ -1900,6 +1983,7 @@ var GuildsAPI = class {
 };
 
 // src/api/interactions.ts
+var import_rest4 = require("@discordjs/rest");
 var import_v107 = require("discord-api-types/v10");
 var InteractionsAPI = class {
   constructor(rest, webhooks) {
@@ -1909,17 +1993,9 @@ var InteractionsAPI = class {
   static {
     __name(this, "InteractionsAPI");
   }
-  /**
-   * Replies to an interaction
-   *
-   * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
-   * @param interactionId - The id of the interaction
-   * @param interactionToken - The token of the interaction
-   * @param body - The callback data for replying
-   * @param options - The options for replying
-   */
-  async reply(interactionId, interactionToken, { files, ...data }, { signal } = {}) {
-    await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+  async reply(interactionId, interactionToken, { files, with_response, ...data }, { signal } = {}) {
+    const response = await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+      query: (0, import_rest4.makeURLSearchParams)({ with_response }),
       files,
       auth: false,
       body: {
@@ -1928,18 +2004,11 @@ var InteractionsAPI = class {
       },
       signal
     });
+    return with_response ? response : void 0;
   }
-  /**
-   * Defers the reply to an interaction
-   *
-   * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
-   * @param interactionId - The id of the interaction
-   * @param interactionToken - The token of the interaction
-   * @param data - The data for deferring the reply
-   * @param options - The options for deferring
-   */
-  async defer(interactionId, interactionToken, data, { signal } = {}) {
-    await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+  async defer(interactionId, interactionToken, { with_response, ...data } = {}, { signal } = {}) {
+    const response = await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+      query: (0, import_rest4.makeURLSearchParams)({ with_response }),
       auth: false,
       body: {
         type: import_v107.InteractionResponseType.DeferredChannelMessageWithSource,
@@ -1947,23 +2016,18 @@ var InteractionsAPI = class {
       },
       signal
     });
+    return with_response ? response : void 0;
   }
-  /**
-   * Defers an update from a message component interaction
-   *
-   * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
-   * @param interactionId - The id of the interaction
-   * @param interactionToken - The token of the interaction
-   * @param options - The options for deferring
-   */
-  async deferMessageUpdate(interactionId, interactionToken, { signal } = {}) {
-    await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+  async deferMessageUpdate(interactionId, interactionToken, { with_response } = {}, { signal } = {}) {
+    const response = await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+      query: (0, import_rest4.makeURLSearchParams)({ with_response }),
       auth: false,
       body: {
         type: import_v107.InteractionResponseType.DeferredMessageUpdate
       },
       signal
     });
+    return with_response ? response : void 0;
   }
   /**
    * Reply to a deferred interaction
@@ -2023,17 +2087,9 @@ var InteractionsAPI = class {
   async deleteReply(applicationId, interactionToken, messageId, { signal } = {}) {
     await this.webhooks.deleteMessage(applicationId, interactionToken, messageId ?? "@original", {}, { signal });
   }
-  /**
-   * Updates the message the component interaction was triggered on
-   *
-   * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
-   * @param interactionId - The id of the interaction
-   * @param interactionToken - The token of the interaction
-   * @param callbackData - The callback data for updating the interaction
-   * @param options - The options for updating the interaction
-   */
-  async updateMessage(interactionId, interactionToken, { files, ...data }, { signal } = {}) {
-    await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+  async updateMessage(interactionId, interactionToken, { files, with_response, ...data }, { signal } = {}) {
+    const response = await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+      query: (0, import_rest4.makeURLSearchParams)({ with_response }),
       files,
       auth: false,
       body: {
@@ -2042,47 +2098,34 @@ var InteractionsAPI = class {
       },
       signal
     });
+    return with_response ? response : void 0;
   }
-  /**
-   * Sends an autocomplete response to an interaction
-   *
-   * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
-   * @param interactionId - The id of the interaction
-   * @param interactionToken - The token of the interaction
-   * @param callbackData - The callback data for the autocomplete response
-   * @param options - The options for sending the autocomplete response
-   */
-  async createAutocompleteResponse(interactionId, interactionToken, callbackData, { signal } = {}) {
-    await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+  async createAutocompleteResponse(interactionId, interactionToken, { with_response, ...data }, { signal } = {}) {
+    const response = await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+      query: (0, import_rest4.makeURLSearchParams)({ with_response }),
       auth: false,
       body: {
         type: import_v107.InteractionResponseType.ApplicationCommandAutocompleteResult,
-        data: callbackData
+        data
       },
       signal
     });
+    return with_response ? response : void 0;
   }
-  /**
-   * Sends a modal response to an interaction
-   *
-   * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
-   * @param interactionId - The id of the interaction
-   * @param interactionToken - The token of the interaction
-   * @param callbackData - The modal callback data to send
-   * @param options - The options for sending the modal
-   */
-  async createModal(interactionId, interactionToken, callbackData, { signal } = {}) {
-    await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+  async createModal(interactionId, interactionToken, { with_response, ...data }, { signal } = {}) {
+    const response = await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+      query: (0, import_rest4.makeURLSearchParams)({ with_response }),
       auth: false,
       body: {
         type: import_v107.InteractionResponseType.Modal,
-        data: callbackData
+        data
       },
       signal
     });
+    return with_response ? response : void 0;
   }
   /**
-   * Sends a premium required response to an interaction
+   * Launches an activity and returns an interaction callback object
    *
    * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
    * @param interactionId - The id of the interaction
@@ -2099,10 +2142,21 @@ var InteractionsAPI = class {
       signal
     });
   }
+  async launchActivity(interactionId, interactionToken, { with_response } = {}, { signal } = {}) {
+    const response = await this.rest.post(import_v107.Routes.interactionCallback(interactionId, interactionToken), {
+      query: (0, import_rest4.makeURLSearchParams)({ with_response }),
+      auth: false,
+      body: {
+        type: import_v107.InteractionResponseType.LaunchActivity
+      },
+      signal
+    });
+    return with_response ? response : void 0;
+  }
 };
 
 // src/api/invite.ts
-var import_rest4 = require("@discordjs/rest");
+var import_rest5 = require("@discordjs/rest");
 var import_v108 = require("discord-api-types/v10");
 var InvitesAPI = class {
   constructor(rest) {
@@ -2121,7 +2175,7 @@ var InvitesAPI = class {
    */
   async get(code, query = {}, { signal } = {}) {
     return this.rest.get(import_v108.Routes.invite(code), {
-      query: (0, import_rest4.makeURLSearchParams)(query),
+      query: (0, import_rest5.makeURLSearchParams)(query),
       signal
     });
   }
@@ -2138,7 +2192,7 @@ var InvitesAPI = class {
 };
 
 // src/api/monetization.ts
-var import_rest5 = require("@discordjs/rest");
+var import_rest6 = require("@discordjs/rest");
 var import_v109 = require("discord-api-types/v10");
 var MonetizationAPI = class {
   constructor(rest) {
@@ -2150,30 +2204,71 @@ var MonetizationAPI = class {
   /**
    * Fetches the SKUs for an application.
    *
-   * @see {@link https://discord.com/developers/docs/monetization/skus#list-skus}
+   * @see {@link https://discord.com/developers/docs/resources/sku#list-skus}
+   * @param applicationId - The application id to fetch SKUs for
    * @param options - The options for fetching the SKUs.
    */
   async getSKUs(applicationId, { signal } = {}) {
     return this.rest.get(import_v109.Routes.skus(applicationId), { signal });
   }
+  /**
+   * Fetches subscriptions for an SKU.
+   *
+   * @see {@link https://discord.com/developers/docs/resources/subscription#list-sku-subscriptions}
+   * @param skuId - The SKU id to fetch subscriptions for
+   * @param query - The query options for fetching subscriptions
+   * @param options - The options for fetching subscriptions
+   */
+  async getSKUSubscriptions(skuId, query = {}, { signal } = {}) {
+    return this.rest.get(import_v109.Routes.skuSubscriptions(skuId), {
+      signal,
+      query: (0, import_rest6.makeURLSearchParams)(query)
+    });
+  }
+  /**
+   * Fetches a subscription for an SKU.
+   *
+   * @see {@link https://discord.com/developers/docs/resources/subscription#get-sku-subscription}
+   * @param skuId - The SKU id to fetch subscription for
+   * @param subscriptionId - The subscription id to fetch
+   * @param options - The options for fetching the subscription
+   */
+  async getSKUSubscription(skuId, subscriptionId, { signal } = {}) {
+    return this.rest.get(import_v109.Routes.skuSubscription(skuId, subscriptionId), {
+      signal
+    });
+  }
   /**
    * Fetches the entitlements for an application.
    *
-   * @see {@link https://discord.com/developers/docs/monetization/entitlements#list-entitlements}
+   * @see {@link https://discord.com/developers/docs/resources/entitlement#list-entitlements}
    * @param applicationId - The application id to fetch entitlements for
    * @param query - The query options for fetching entitlements
    * @param options - The options for fetching entitlements
    */
-  async getEntitlements(applicationId, query, { signal } = {}) {
+  async getEntitlements(applicationId, query = {}, { signal } = {}) {
     return this.rest.get(import_v109.Routes.entitlements(applicationId), {
       signal,
-      query: (0, import_rest5.makeURLSearchParams)(query)
+      query: (0, import_rest6.makeURLSearchParams)(query)
+    });
+  }
+  /**
+   * Fetches an entitlement for an application.
+   *
+   * @see {@link https://discord.com/developers/docs/resources/entitlement#get-entitlement}
+   * @param applicationId - The application id to fetch the entitlement for
+   * @param entitlementId - The entitlement id to fetch
+   * @param options - The options for fetching the entitlement
+   */
+  async getEntitlement(applicationId, entitlementId, { signal } = {}) {
+    return this.rest.get(import_v109.Routes.entitlement(applicationId, entitlementId), {
+      signal
     });
   }
   /**
    * Creates a test entitlement for an application's SKU.
    *
-   * @see {@link https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement}
+   * @see {@link https://discord.com/developers/docs/resources/entitlement#create-test-entitlement}
    * @param applicationId - The application id to create the entitlement for
    * @param body - The data for creating the entitlement
    * @param options - The options for creating the entitlement
@@ -2187,7 +2282,7 @@ var MonetizationAPI = class {
   /**
    * Deletes a test entitlement for an application's SKU.
    *
-   * @see {@link https://discord.com/developers/docs/monetization/entitlements#delete-test-entitlement}
+   * @see {@link https://discord.com/developers/docs/resources/entitlement#delete-test-entitlement}
    * @param applicationId - The application id to delete the entitlement for
    * @param entitlementId - The entitlement id to delete
    * @param options - The options for deleting the entitlement
@@ -2198,7 +2293,7 @@ var MonetizationAPI = class {
   /**
    * Marks a given entitlement for the user as consumed. Only available for One-Time Purchase consumable SKUs.
    *
-   * @see {@link https://discord.com/developers/docs/monetization/entitlements#consume-an-entitlement}
+   * @see {@link https://discord.com/developers/docs/resources/entitlement#consume-an-entitlement}
    * @param applicationId - The application id to consume the entitlement for
    * @param entitlementId - The entitlement id to consume
    * @param options - The options for consuming the entitlement
@@ -2209,7 +2304,7 @@ var MonetizationAPI = class {
 };
 
 // src/api/oauth2.ts
-var import_rest6 = require("@discordjs/rest");
+var import_rest7 = require("@discordjs/rest");
 var import_v1010 = require("discord-api-types/v10");
 var OAuth2API = class {
   constructor(rest) {
@@ -2226,7 +2321,7 @@ var OAuth2API = class {
    */
   generateAuthorizationURL(options) {
     const url = new URL(`${import_v1010.RouteBases.api}${import_v1010.Routes.oauth2Authorization()}`);
-    url.search = (0, import_rest6.makeURLSearchParams)(options).toString();
+    url.search = (0, import_rest7.makeURLSearchParams)(options).toString();
     return url.toString();
   }
   /**
@@ -2238,7 +2333,7 @@ var OAuth2API = class {
    */
   async tokenExchange(body, { signal } = {}) {
     return this.rest.post(import_v1010.Routes.oauth2TokenExchange(), {
-      body: (0, import_rest6.makeURLSearchParams)(body),
+      body: (0, import_rest7.makeURLSearchParams)(body),
       passThroughBody: true,
       headers: {
         "Content-Type": "application/x-www-form-urlencoded"
@@ -2256,7 +2351,7 @@ var OAuth2API = class {
    */
   async refreshToken(body, { signal } = {}) {
     return this.rest.post(import_v1010.Routes.oauth2TokenExchange(), {
-      body: (0, import_rest6.makeURLSearchParams)(body),
+      body: (0, import_rest7.makeURLSearchParams)(body),
       passThroughBody: true,
       headers: {
         "Content-Type": "application/x-www-form-urlencoded"
@@ -2276,7 +2371,7 @@ var OAuth2API = class {
    */
   async getToken(body, { signal } = {}) {
     return this.rest.post(import_v1010.Routes.oauth2TokenExchange(), {
-      body: (0, import_rest6.makeURLSearchParams)(body),
+      body: (0, import_rest7.makeURLSearchParams)(body),
       passThroughBody: true,
       headers: {
         "Content-Type": "application/x-www-form-urlencoded"
@@ -2318,7 +2413,7 @@ var OAuth2API = class {
    */
   async revokeToken(applicationId, applicationSecret, body, { signal } = {}) {
     await this.rest.post(import_v1010.Routes.oauth2TokenRevocation(), {
-      body: (0, import_rest6.makeURLSearchParams)(body),
+      body: (0, import_rest7.makeURLSearchParams)(body),
       passThroughBody: true,
       headers: {
         Authorization: `Basic ${btoa(`${applicationId}:${applicationSecret}`)}`,
@@ -2331,7 +2426,7 @@ var OAuth2API = class {
 };
 
 // src/api/poll.ts
-var import_rest7 = require("@discordjs/rest");
+var import_rest8 = require("@discordjs/rest");
 var import_v1011 = require("discord-api-types/v10");
 var PollAPI = class {
   constructor(rest) {
@@ -2350,10 +2445,10 @@ var PollAPI = class {
    * @param query - The query for getting the list of voters
    * @param options - The options for getting the list of voters
    */
-  async getAnswerVoters(channelId, messageId, answerId, query, { signal } = {}) {
+  async getAnswerVoters(channelId, messageId, answerId, query = {}, { signal } = {}) {
     return this.rest.get(import_v1011.Routes.pollAnswerVoters(channelId, messageId, answerId), {
       signal,
-      query: (0, import_rest7.makeURLSearchParams)(query)
+      query: (0, import_rest8.makeURLSearchParams)(query)
     });
   }
   /**
@@ -2408,8 +2503,30 @@ var RoleConnectionsAPI = class {
   }
 };
 
-// src/api/stageInstances.ts
+// src/api/soundboardSounds.ts
 var import_v1013 = require("discord-api-types/v10");
+var SoundboardSoundsAPI = class {
+  constructor(rest) {
+    this.rest = rest;
+  }
+  static {
+    __name(this, "SoundboardSoundsAPI");
+  }
+  /**
+   * Fetches all the soundboard default sounds.
+   *
+   * @see {@link https://discord.com/developers/docs/resources/soundboard#list-default-soundboard-sounds}
+   * @param options - The options for fetching the soundboard default sounds.
+   */
+  async getSoundboardDefaultSounds({ signal } = {}) {
+    return this.rest.get(import_v1013.Routes.soundboardDefaultSounds(), {
+      signal
+    });
+  }
+};
+
+// src/api/stageInstances.ts
+var import_v1014 = require("discord-api-types/v10");
 var StageInstancesAPI = class {
   constructor(rest) {
     this.rest = rest;
@@ -2425,7 +2542,7 @@ var StageInstancesAPI = class {
    * @param options - The options for creating the new stage instance
    */
   async create(body, { reason, signal } = {}) {
-    return this.rest.post(import_v1013.Routes.stageInstances(), {
+    return this.rest.post(import_v1014.Routes.stageInstances(), {
       body,
       reason,
       signal
@@ -2439,7 +2556,7 @@ var StageInstancesAPI = class {
    * @param options - The options for fetching the stage instance
    */
   async get(channelId, { signal } = {}) {
-    return this.rest.get(import_v1013.Routes.stageInstance(channelId), { signal });
+    return this.rest.get(import_v1014.Routes.stageInstance(channelId), { signal });
   }
   /**
    * Edits a stage instance
@@ -2450,7 +2567,7 @@ var StageInstancesAPI = class {
    * @param options - The options for editing the stage instance
    */
   async edit(channelId, body, { reason, signal } = {}) {
-    return this.rest.patch(import_v1013.Routes.stageInstance(channelId), {
+    return this.rest.patch(import_v1014.Routes.stageInstance(channelId), {
       body,
       reason,
       signal
@@ -2464,12 +2581,12 @@ var StageInstancesAPI = class {
    * @param options - The options for deleting the stage instance
    */
   async delete(channelId, { reason, signal } = {}) {
-    await this.rest.delete(import_v1013.Routes.stageInstance(channelId), { reason, signal });
+    await this.rest.delete(import_v1014.Routes.stageInstance(channelId), { reason, signal });
   }
 };
 
 // src/api/sticker.ts
-var import_v1014 = require("discord-api-types/v10");
+var import_v1015 = require("discord-api-types/v10");
 var StickersAPI = class {
   constructor(rest) {
     this.rest = rest;
@@ -2485,7 +2602,7 @@ var StickersAPI = class {
    * @param options - The options for fetching the sticker pack
    */
   async getStickerPack(packId, { signal } = {}) {
-    return this.rest.get(import_v1014.Routes.stickerPack(packId), { signal });
+    return this.rest.get(import_v1015.Routes.stickerPack(packId), { signal });
   }
   /**
    * Fetches all of the sticker packs
@@ -2494,7 +2611,7 @@ var StickersAPI = class {
    * @param options - The options for fetching the sticker packs
    */
   async getStickers({ signal } = {}) {
-    return this.rest.get(import_v1014.Routes.stickerPacks(), { signal });
+    return this.rest.get(import_v1015.Routes.stickerPacks(), { signal });
   }
   /**
    * Fetches all of the sticker packs
@@ -2514,12 +2631,12 @@ var StickersAPI = class {
    * @param options - The options for fetching the sticker
    */
   async get(stickerId, { signal } = {}) {
-    return this.rest.get(import_v1014.Routes.sticker(stickerId), { signal });
+    return this.rest.get(import_v1015.Routes.sticker(stickerId), { signal });
   }
 };
 
 // src/api/thread.ts
-var import_v1015 = require("discord-api-types/v10");
+var import_v1016 = require("discord-api-types/v10");
 var ThreadsAPI = class {
   constructor(rest) {
     this.rest = rest;
@@ -2535,7 +2652,7 @@ var ThreadsAPI = class {
    * @param options - The options for joining the thread
    */
   async join(threadId, { signal } = {}) {
-    await this.rest.put(import_v1015.Routes.threadMembers(threadId, "@me"), { signal });
+    await this.rest.put(import_v1016.Routes.threadMembers(threadId, "@me"), { signal });
   }
   /**
    * Adds a member to a thread
@@ -2546,7 +2663,7 @@ var ThreadsAPI = class {
    * @param options - The options for adding the member to the thread
    */
   async addMember(threadId, userId, { signal } = {}) {
-    await this.rest.put(import_v1015.Routes.threadMembers(threadId, userId), { signal });
+    await this.rest.put(import_v1016.Routes.threadMembers(threadId, userId), { signal });
   }
   /**
    * Removes the current user from a thread
@@ -2556,7 +2673,7 @@ var ThreadsAPI = class {
    * @param options - The options for leaving the thread
    */
   async leave(threadId, { signal } = {}) {
-    await this.rest.delete(import_v1015.Routes.threadMembers(threadId, "@me"), { signal });
+    await this.rest.delete(import_v1016.Routes.threadMembers(threadId, "@me"), { signal });
   }
   /**
    * Removes a member from a thread
@@ -2567,7 +2684,7 @@ var ThreadsAPI = class {
    * @param options - The options for removing the member from the thread
    */
   async removeMember(threadId, userId, { signal } = {}) {
-    await this.rest.delete(import_v1015.Routes.threadMembers(threadId, userId), { signal });
+    await this.rest.delete(import_v1016.Routes.threadMembers(threadId, userId), { signal });
   }
   /**
    * Fetches a member of a thread
@@ -2578,7 +2695,7 @@ var ThreadsAPI = class {
    * @param options - The options for fetching the member
    */
   async getMember(threadId, userId, { signal } = {}) {
-    return this.rest.get(import_v1015.Routes.threadMembers(threadId, userId), { signal });
+    return this.rest.get(import_v1016.Routes.threadMembers(threadId, userId), { signal });
   }
   /**
    * Fetches all members of a thread
@@ -2588,13 +2705,13 @@ var ThreadsAPI = class {
    * @param options - The options for fetching the members
    */
   async getAllMembers(threadId, { signal } = {}) {
-    return this.rest.get(import_v1015.Routes.threadMembers(threadId), { signal });
+    return this.rest.get(import_v1016.Routes.threadMembers(threadId), { signal });
   }
 };
 
 // src/api/user.ts
-var import_rest8 = require("@discordjs/rest");
-var import_v1016 = require("discord-api-types/v10");
+var import_rest9 = require("@discordjs/rest");
+var import_v1017 = require("discord-api-types/v10");
 var UsersAPI = class {
   constructor(rest) {
     this.rest = rest;
@@ -2610,7 +2727,7 @@ var UsersAPI = class {
    * @param options - The options for fetching the user
    */
   async get(userId, { signal } = {}) {
-    return this.rest.get(import_v1016.Routes.user(userId), { signal });
+    return this.rest.get(import_v1017.Routes.user(userId), { signal });
   }
   /**
    * Returns the user object of the requester's account
@@ -2619,7 +2736,7 @@ var UsersAPI = class {
    * @param options - The options for fetching the current user
    */
   async getCurrent({ signal } = {}) {
-    return this.rest.get(import_v1016.Routes.user("@me"), { signal });
+    return this.rest.get(import_v1017.Routes.user("@me"), { signal });
   }
   /**
    * Returns a list of partial guild objects the current user is a member of
@@ -2629,8 +2746,8 @@ var UsersAPI = class {
    * @param options - The options for fetching the guilds
    */
   async getGuilds(query = {}, { signal } = {}) {
-    return this.rest.get(import_v1016.Routes.userGuilds(), {
-      query: (0, import_rest8.makeURLSearchParams)(query),
+    return this.rest.get(import_v1017.Routes.userGuilds(), {
+      query: (0, import_rest9.makeURLSearchParams)(query),
       signal
     });
   }
@@ -2642,7 +2759,7 @@ var UsersAPI = class {
    * @param options - The options for leaving the guild
    */
   async leaveGuild(guildId, { signal } = {}) {
-    await this.rest.delete(import_v1016.Routes.userGuild(guildId), { signal });
+    await this.rest.delete(import_v1017.Routes.userGuild(guildId), { signal });
   }
   /**
    * Edits the current user
@@ -2652,7 +2769,7 @@ var UsersAPI = class {
    * @param options - The options for editing the user
    */
   async edit(body, { signal } = {}) {
-    return this.rest.patch(import_v1016.Routes.user("@me"), { body, signal });
+    return this.rest.patch(import_v1017.Routes.user("@me"), { body, signal });
   }
   /**
    * Fetches the guild member for the current user
@@ -2662,7 +2779,7 @@ var UsersAPI = class {
    * @param options - The options for fetching the guild member
    */
   async getGuildMember(guildId, { signal } = {}) {
-    return this.rest.get(import_v1016.Routes.userGuildMember(guildId), { signal });
+    return this.rest.get(import_v1017.Routes.userGuildMember(guildId), { signal });
   }
   /**
    * Edits the guild member for the current user
@@ -2673,7 +2790,7 @@ var UsersAPI = class {
    * @param options - The options for editing the guild member
    */
   async editCurrentGuildMember(guildId, body = {}, { reason, signal } = {}) {
-    return this.rest.patch(import_v1016.Routes.guildMember(guildId, "@me"), {
+    return this.rest.patch(import_v1017.Routes.guildMember(guildId, "@me"), {
       reason,
       body,
       signal
@@ -2687,7 +2804,7 @@ var UsersAPI = class {
    * @param options - The options for opening the DM
    */
   async createDM(userId, { signal } = {}) {
-    return this.rest.post(import_v1016.Routes.userChannels(), {
+    return this.rest.post(import_v1017.Routes.userChannels(), {
       body: { recipient_id: userId },
       signal
     });
@@ -2699,7 +2816,7 @@ var UsersAPI = class {
    * @param options - The options for fetching the user's connections
    */
   async getConnections({ signal } = {}) {
-    return this.rest.get(import_v1016.Routes.userConnections(), { signal });
+    return this.rest.get(import_v1017.Routes.userConnections(), { signal });
   }
   /**
    * Gets the current user's active application role connection
@@ -2709,7 +2826,7 @@ var UsersAPI = class {
    * @param options - The options for fetching the role connections
    */
   async getApplicationRoleConnection(applicationId, { signal } = {}) {
-    return this.rest.get(import_v1016.Routes.userApplicationRoleConnection(applicationId), {
+    return this.rest.get(import_v1017.Routes.userApplicationRoleConnection(applicationId), {
       signal
     });
   }
@@ -2722,7 +2839,7 @@ var UsersAPI = class {
    * @param options - The options for updating the application role connection
    */
   async updateApplicationRoleConnection(applicationId, body, { signal } = {}) {
-    return this.rest.put(import_v1016.Routes.userApplicationRoleConnection(applicationId), {
+    return this.rest.put(import_v1017.Routes.userApplicationRoleConnection(applicationId), {
       body,
       signal
     });
@@ -2730,8 +2847,8 @@ var UsersAPI = class {
 };
 
 // src/api/webhook.ts
-var import_rest9 = require("@discordjs/rest");
-var import_v1017 = require("discord-api-types/v10");
+var import_rest10 = require("@discordjs/rest");
+var import_v1018 = require("discord-api-types/v10");
 var WebhooksAPI = class {
   constructor(rest) {
     this.rest = rest;
@@ -2748,7 +2865,7 @@ var WebhooksAPI = class {
    * @param options - The options for fetching the webhook
    */
   async get(id, { token, signal } = {}) {
-    return this.rest.get(import_v1017.Routes.webhook(id, token), {
+    return this.rest.get(import_v1018.Routes.webhook(id, token), {
       signal,
       auth: !token
     });
@@ -2763,7 +2880,7 @@ var WebhooksAPI = class {
    * @param options - The options for editing the webhook
    */
   async edit(id, body, { token, reason, signal } = {}) {
-    return this.rest.patch(import_v1017.Routes.webhook(id, token), {
+    return this.rest.patch(import_v1018.Routes.webhook(id, token), {
       reason,
       body,
       signal,
@@ -2779,7 +2896,7 @@ var WebhooksAPI = class {
    * @param options - The options for deleting the webhook
    */
   async delete(id, { token, reason, signal } = {}) {
-    await this.rest.delete(import_v1017.Routes.webhook(id, token), {
+    await this.rest.delete(import_v1018.Routes.webhook(id, token), {
       reason,
       signal,
       auth: !token
@@ -2794,15 +2911,9 @@ var WebhooksAPI = class {
    * @param body - The data for executing the webhook
    * @param options - The options for executing the webhook
    */
-  async execute(id, token, {
-    wait,
-    thread_id,
-    with_components,
-    files,
-    ...body
-  }, { signal } = {}) {
-    return this.rest.post(import_v1017.Routes.webhook(id, token), {
-      query: (0, import_rest9.makeURLSearchParams)({ wait, thread_id, with_components }),
+  async execute(id, token, { wait, thread_id, with_components, files, ...body }, { signal } = {}) {
+    return this.rest.post(import_v1018.Routes.webhook(id, token), {
+      query: (0, import_rest10.makeURLSearchParams)({ wait, thread_id, with_components }),
       files,
       body,
       auth: false,
@@ -2821,8 +2932,8 @@ var WebhooksAPI = class {
    * @param options - The options for executing the webhook
    */
   async executeSlack(id, token, body, query = {}, { signal } = {}) {
-    await this.rest.post(import_v1017.Routes.webhookPlatform(id, token, "slack"), {
-      query: (0, import_rest9.makeURLSearchParams)(query),
+    await this.rest.post(import_v1018.Routes.webhookPlatform(id, token, "slack"), {
+      query: (0, import_rest10.makeURLSearchParams)(query),
       body,
       auth: false,
       signal
@@ -2839,8 +2950,8 @@ var WebhooksAPI = class {
    * @param options - The options for executing the webhook
    */
   async executeGitHub(id, token, body, query = {}, { signal } = {}) {
-    await this.rest.post(import_v1017.Routes.webhookPlatform(id, token, "github"), {
-      query: (0, import_rest9.makeURLSearchParams)(query),
+    await this.rest.post(import_v1018.Routes.webhookPlatform(id, token, "github"), {
+      query: (0, import_rest10.makeURLSearchParams)(query),
       body,
       signal,
       auth: false
@@ -2857,8 +2968,8 @@ var WebhooksAPI = class {
    * @param options - The options for fetching the message
    */
   async getMessage(id, token, messageId, query = {}, { signal } = {}) {
-    return this.rest.get(import_v1017.Routes.webhookMessage(id, token, messageId), {
-      query: (0, import_rest9.makeURLSearchParams)(query),
+    return this.rest.get(import_v1018.Routes.webhookMessage(id, token, messageId), {
+      query: (0, import_rest10.makeURLSearchParams)(query),
       auth: false,
       signal
     });
@@ -2873,14 +2984,9 @@ var WebhooksAPI = class {
    * @param body - The data for editing the message
    * @param options - The options for editing the message
    */
-  async editMessage(id, token, messageId, {
-    thread_id,
-    with_components,
-    files,
-    ...body
-  }, { signal } = {}) {
-    return this.rest.patch(import_v1017.Routes.webhookMessage(id, token, messageId), {
-      query: (0, import_rest9.makeURLSearchParams)({ thread_id, with_components }),
+  async editMessage(id, token, messageId, { thread_id, with_components, files, ...body }, { signal } = {}) {
+    return this.rest.patch(import_v1018.Routes.webhookMessage(id, token, messageId), {
+      query: (0, import_rest10.makeURLSearchParams)({ thread_id, with_components }),
       auth: false,
       body,
       signal,
@@ -2898,8 +3004,8 @@ var WebhooksAPI = class {
    * @param options - The options for deleting the message
    */
   async deleteMessage(id, token, messageId, query = {}, { signal } = {}) {
-    await this.rest.delete(import_v1017.Routes.webhookMessage(id, token, messageId), {
-      query: (0, import_rest9.makeURLSearchParams)(query),
+    await this.rest.delete(import_v1018.Routes.webhookMessage(id, token, messageId), {
+      query: (0, import_rest10.makeURLSearchParams)(query),
       auth: false,
       signal
     });
@@ -2920,6 +3026,7 @@ var API = class {
     this.oauth2 = new OAuth2API(rest);
     this.poll = new PollAPI(rest);
     this.roleConnections = new RoleConnectionsAPI(rest);
+    this.soundboardSounds = new SoundboardSoundsAPI(rest);
     this.stageInstances = new StageInstancesAPI(rest);
     this.stickers = new StickersAPI(rest);
     this.threads = new ThreadsAPI(rest);
@@ -2942,6 +3049,7 @@ var API = class {
   oauth2;
   poll;
   roleConnections;
+  soundboardSounds;
   stageInstances;
   stickers;
   threads;
@@ -2956,7 +3064,11 @@ var import_util = require("@discordjs/util");
 var import_ws = require("@discordjs/ws");
 var import_snowflake = require("@sapphire/snowflake");
 var import_async_event_emitter = require("@vladfrangu/async_event_emitter");
-var import_v1018 = require("discord-api-types/v10");
+var import_v1019 = require("discord-api-types/v10");
+function createTimer(controller, timeout) {
+  return (0, import_node_timers.setTimeout)(() => controller.abort(), timeout);
+}
+__name(createTimer, "createTimer");
 var Client = class extends import_async_event_emitter.AsyncEventEmitter {
   static {
     __name(this, "Client");
@@ -2991,12 +3103,21 @@ var Client = class extends import_async_event_emitter.AsyncEventEmitter {
     const shardId = (0, import_util.calculateShardId)(options.guild_id, await this.gateway.getShardCount());
     const nonce = options.nonce ?? import_snowflake.DiscordSnowflake.generate().toString();
     const controller = new AbortController();
-    const createTimer = /* @__PURE__ */ __name(() => (0, import_node_timers.setTimeout)(() => {
-      controller.abort();
-    }, timeout), "createTimer");
-    let timer = createTimer();
+    let timer = createTimer(controller, timeout);
+    const onRatelimit = /* @__PURE__ */ __name(({ data }) => {
+      if (data.meta.nonce === nonce) {
+        controller.abort(new import_util.GatewayRateLimitError(data, options));
+      }
+    }, "onRatelimit");
+    const cleanup = /* @__PURE__ */ __name(() => {
+      if (timer) {
+        (0, import_node_timers.clearTimeout)(timer);
+      }
+      this.off(import_v1019.GatewayDispatchEvents.RateLimited, onRatelimit);
+    }, "cleanup");
+    this.on(import_v1019.GatewayDispatchEvents.RateLimited, onRatelimit);
     await this.gateway.send(shardId, {
-      op: import_v1018.GatewayOpcodes.RequestGuildMembers,
+      op: import_v1019.GatewayOpcodes.RequestGuildMembers,
       // eslint-disable-next-line id-length
       d: {
         ...options,
@@ -3004,7 +3125,7 @@ var Client = class extends import_async_event_emitter.AsyncEventEmitter {
       }
     });
     try {
-      const iterator = import_async_event_emitter.AsyncEventEmitter.on(this, import_v1018.GatewayDispatchEvents.GuildMembersChunk, {
+      const iterator = import_async_event_emitter.AsyncEventEmitter.on(this, import_v1019.GatewayDispatchEvents.GuildMembersChunk, {
         signal: controller.signal
       });
       for await (const [{ data }] of iterator) {
@@ -3019,21 +3140,19 @@ var Client = class extends import_async_event_emitter.AsyncEventEmitter {
           chunkIndex: data.chunk_index,
           chunkCount: data.chunk_count
         };
-        if (data.chunk_index >= data.chunk_count - 1) {
-          break;
-        } else {
-          timer = createTimer();
-        }
+        if (data.chunk_index >= data.chunk_count - 1) break;
+        timer = createTimer(controller, timeout);
       }
     } catch (error) {
       if (error instanceof Error && error.name === "AbortError") {
+        if (error.cause instanceof import_util.GatewayRateLimitError) {
+          throw error.cause;
+        }
         throw new Error("Request timed out");
       }
       throw error;
     } finally {
-      if (timer) {
-        (0, import_node_timers.clearTimeout)(timer);
-      }
+      cleanup();
     }
   }
   /**
@@ -3060,6 +3179,86 @@ var Client = class extends import_async_event_emitter.AsyncEventEmitter {
     }
     return { members, nonce, notFound, presences };
   }
+  /**
+   * Requests soundboard sounds from the gateway and returns an async iterator that yields the data from each soundboard sounds event.
+   *
+   * @see {@link https://discord.com/developers/docs/topics/gateway-events#request-soundboard-sounds}
+   * @param options - The options for the request
+   * @param timeout - The timeout for waiting for each soundboard sounds
+   * @example
+   * Requesting soundboard sounds for specific guilds
+   * ```ts
+   * for await (const { guildId, soundboardSounds } of this.requestSoundboardSoundsIterator({
+   *	guild_ids: ['1234567890', '9876543210'],
+   * })) {
+   *	console.log(`Soundboard sounds for guild ${guildId}:`, soundboardSounds);
+   * }
+   * ```
+   */
+  async *requestSoundboardSoundsIterator(options, timeout = 1e4) {
+    const shardCount = await this.gateway.getShardCount();
+    const shardIds = Map.groupBy(options.guild_ids, (guildId) => (0, import_util.calculateShardId)(guildId, shardCount));
+    const controller = new AbortController();
+    let timer = createTimer(controller, timeout);
+    for (const [shardId, guildIds] of shardIds) {
+      await this.gateway.send(shardId, {
+        op: import_v1019.GatewayOpcodes.RequestSoundboardSounds,
+        // eslint-disable-next-line id-length
+        d: {
+          ...options,
+          guild_ids: guildIds
+        }
+      });
+    }
+    try {
+      const iterator = import_async_event_emitter.AsyncEventEmitter.on(this, import_v1019.GatewayDispatchEvents.SoundboardSounds, {
+        signal: controller.signal
+      });
+      const guildIds = new Set(options.guild_ids);
+      for await (const [{ data }] of iterator) {
+        if (!guildIds.has(data.guild_id)) continue;
+        (0, import_node_timers.clearTimeout)(timer);
+        timer = void 0;
+        yield {
+          guildId: data.guild_id,
+          soundboardSounds: data.soundboard_sounds
+        };
+        guildIds.delete(data.guild_id);
+        if (guildIds.size === 0) break;
+        timer = createTimer(controller, timeout);
+      }
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new Error("Request timed out");
+      }
+      throw error;
+    } finally {
+      if (timer) {
+        (0, import_node_timers.clearTimeout)(timer);
+      }
+    }
+  }
+  /**
+   * Requests soundboard sounds from the gateway.
+   *
+   * @see {@link https://discord.com/developers/docs/topics/gateway-events#request-soundboard-sounds}
+   * @param options - The options for the request
+   * @param timeout - The timeout for waiting for each soundboard sounds event
+   * @example
+   * Requesting soundboard sounds for specific guilds
+   * ```ts
+   * const soundboardSounds = await client.requestSoundboardSounds({ guild_ids: ['1234567890', '9876543210'], });
+   *
+   * console.log(soundboardSounds.get('1234567890'));
+   * ```
+   */
+  async requestSoundboardSounds(options, timeout = 1e4) {
+    const soundboardSounds = /* @__PURE__ */ new Map();
+    for await (const data of this.requestSoundboardSoundsIterator(options, timeout)) {
+      soundboardSounds.set(data.guildId, data.soundboardSounds);
+    }
+    return soundboardSounds;
+  }
   /**
    * Updates the voice state of the bot user
    *
@@ -3069,7 +3268,7 @@ var Client = class extends import_async_event_emitter.AsyncEventEmitter {
   async updateVoiceState(options) {
     const shardId = (0, import_util.calculateShardId)(options.guild_id, await this.gateway.getShardCount());
     await this.gateway.send(shardId, {
-      op: import_v1018.GatewayOpcodes.VoiceStateUpdate,
+      op: import_v1019.GatewayOpcodes.VoiceStateUpdate,
       // eslint-disable-next-line id-length
       d: options
     });
@@ -3082,7 +3281,7 @@ var Client = class extends import_async_event_emitter.AsyncEventEmitter {
    */
   async updatePresence(shardId, options) {
     await this.gateway.send(shardId, {
-      op: import_v1018.GatewayOpcodes.PresenceUpdate,
+      op: import_v1019.GatewayOpcodes.PresenceUpdate,
       // eslint-disable-next-line id-length
       d: options
     });
@@ -3114,8 +3313,9 @@ function withFiles(files, options) {
 __name(withFiles, "withFiles");
 
 // src/index.ts
-__reExport(src_exports, require("discord-api-types/v10"), module.exports);
-var version = "2.3.0";
+__reExport(index_exports, require("discord-api-types/v10"), module.exports);
+var import_util2 = require("@discordjs/util");
+var version = "2.4.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   API,
@@ -3124,6 +3324,7 @@ var version = "2.3.0";
   ChannelsAPI,
   Client,
   GatewayAPI,
+  GatewayRateLimitError,
   GuildsAPI,
   InteractionsAPI,
   InvitesAPI,
@@ -3131,6 +3332,7 @@ var version = "2.3.0";
   OAuth2API,
   PollAPI,
   RoleConnectionsAPI,
+  SoundboardSoundsAPI,
   StageInstancesAPI,
   StickersAPI,
   ThreadsAPI,