@discordjs/core 3.0.0-dev.1737936740-3db8ce70a → 3.0.0-dev.1738109515-fa0d4b507

package/dist/index.mjs

@@ -3091,6 +3091,10 @@ import {
   GatewayDispatchEvents,
   GatewayOpcodes
 } from "discord-api-types/v10";
+function createTimer(controller, timeout) {
+  return setTimeout(() => controller.abort(), timeout);
+}
+__name(createTimer, "createTimer");
 var Client = class extends AsyncEventEmitter {
   static {
     __name(this, "Client");
@@ -3125,10 +3129,7 @@ var Client = class extends AsyncEventEmitter {
     const shardId = calculateShardId(options.guild_id, await this.gateway.getShardCount());
     const nonce = options.nonce ?? DiscordSnowflake.generate().toString();
     const controller = new AbortController();
-    const createTimer = /* @__PURE__ */ __name(() => setTimeout(() => {
-      controller.abort();
-    }, timeout), "createTimer");
-    let timer = createTimer();
+    let timer = createTimer(controller, timeout);
     await this.gateway.send(shardId, {
       op: GatewayOpcodes.RequestGuildMembers,
       // eslint-disable-next-line id-length
@@ -3153,11 +3154,8 @@ var Client = class extends 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") {
@@ -3194,6 +3192,86 @@ var Client = class extends 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) => calculateShardId(guildId, shardCount));
+    const controller = new AbortController();
+    let timer = createTimer(controller, timeout);
+    for (const [shardId, guildIds] of shardIds) {
+      await this.gateway.send(shardId, {
+        op: GatewayOpcodes.RequestSoundboardSounds,
+        // eslint-disable-next-line id-length
+        d: {
+          ...options,
+          guild_ids: guildIds
+        }
+      });
+    }
+    try {
+      const iterator = AsyncEventEmitter.on(this, 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;
+        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) {
+        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
    *
@@ -3249,7 +3327,7 @@ __name(withFiles, "withFiles");
 
 // src/index.ts
 export * from "discord-api-types/v10";
-var version = "3.0.0-dev.1737936740-3db8ce70a";
+var version = "3.0.0-dev.1738109515-fa0d4b507";
 export {
   API,
   ApplicationCommandsAPI,