@discordjs/rest 3.0.0-dev.1784246195-c73e2a76d → 3.0.0-dev.1784551164-2de90a767

package/README.md

@@ -25,7 +25,7 @@
 
 ## Installation
 
-**Node.js 22.12.0 or newer is required.**
+**Node.js 24.17.0 or newer is required.**
 
 ```sh
 npm install @discordjs/rest

package/dist/index.d.mts

@@ -7,8 +7,8 @@ import { RawFile, Awaitable } from '@discordjs/util';
 export { RawFile } from '@discordjs/util';
 import { ImageSize, Snowflake } from 'discord-api-types/v10';
 export { ImageSize } from 'discord-api-types/v10';
-import { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';
 import * as url from 'url';
+import { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';
 
 interface IHandler {
     /**
@@ -901,14 +901,27 @@ declare class REST extends AsyncEventEmitter<RestEvents> {
     private static generateRouteData;
 }
 
+/**
+ * Options for serializing URL search parameters.
+ */
+interface MakeURLSearchParamsOptions {
+    /**
+     * How array values should be serialized.
+     *
+     * @defaultValue `'repeat'`
+     * @see {@link https://docs.discord.com/developers/reference#array-query-strings}
+     */
+    arrayFormat?: 'comma' | 'repeat';
+}
 /**
  * Creates and populates an URLSearchParams instance from an object, stripping
  * out null and undefined values, while also coercing non-strings to strings.
  *
- * @param options - The options to use
+ * @param parameters - The parameters to use
+ * @param options - The options for serializing URL search parameters
  * @returns A populated URLSearchParams instance
  */
-declare function makeURLSearchParams<OptionsType extends object>(options?: Readonly<OptionsType>): url.URLSearchParams;
+declare function makeURLSearchParams<ParametersType extends object>(parameters?: Readonly<ParametersType>, options?: MakeURLSearchParamsOptions): url.URLSearchParams;
 /**
  * Converts the response to usable data
  *
@@ -928,4 +941,4 @@ declare function calculateUserDefaultAvatarIndex(userId: Snowflake): number;
  */
 declare const version: string;
 
-export { ALLOWED_EXTENSIONS, ALLOWED_SIZES, ALLOWED_STICKER_EXTENSIONS, type APIRequest, AUTH_UUID_NAMESPACE, type AuthData, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, type CDNOptions, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordError, type DiscordErrorData, type DiscordErrorFieldInformation, type DiscordErrorGroupWrapper, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, type GetRetryBackoffFunction, type GetTimeoutFunction, HTTPError, type HandlerRequestData, type HashData, type IHandler, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RequestBody, type RequestData, type RequestHeaders, RequestMethod, type ResponseLike, type RestEvents, type RestEventsMap, type RouteData, type RouteLike, type StickerExtension, calculateUserDefaultAvatarIndex, makeURLSearchParams, parseResponse, version };
+export { ALLOWED_EXTENSIONS, ALLOWED_SIZES, ALLOWED_STICKER_EXTENSIONS, type APIRequest, AUTH_UUID_NAMESPACE, type AuthData, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, type CDNOptions, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordError, type DiscordErrorData, type DiscordErrorFieldInformation, type DiscordErrorGroupWrapper, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, type GetRetryBackoffFunction, type GetTimeoutFunction, HTTPError, type HandlerRequestData, type HashData, type IHandler, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type MakeURLSearchParamsOptions, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RequestBody, type RequestData, type RequestHeaders, RequestMethod, type ResponseLike, type RestEvents, type RestEventsMap, type RouteData, type RouteLike, type StickerExtension, calculateUserDefaultAvatarIndex, makeURLSearchParams, parseResponse, version };

package/dist/index.d.ts

@@ -7,8 +7,8 @@ import { RawFile, Awaitable } from '@discordjs/util';
 export { RawFile } from '@discordjs/util';
 import { ImageSize, Snowflake } from 'discord-api-types/v10';
 export { ImageSize } from 'discord-api-types/v10';
-import { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';
 import * as url from 'url';
+import { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';
 
 interface IHandler {
     /**
@@ -901,14 +901,27 @@ declare class REST extends AsyncEventEmitter<RestEvents> {
     private static generateRouteData;
 }
 
+/**
+ * Options for serializing URL search parameters.
+ */
+interface MakeURLSearchParamsOptions {
+    /**
+     * How array values should be serialized.
+     *
+     * @defaultValue `'repeat'`
+     * @see {@link https://docs.discord.com/developers/reference#array-query-strings}
+     */
+    arrayFormat?: 'comma' | 'repeat';
+}
 /**
  * Creates and populates an URLSearchParams instance from an object, stripping
  * out null and undefined values, while also coercing non-strings to strings.
  *
- * @param options - The options to use
+ * @param parameters - The parameters to use
+ * @param options - The options for serializing URL search parameters
  * @returns A populated URLSearchParams instance
  */
-declare function makeURLSearchParams<OptionsType extends object>(options?: Readonly<OptionsType>): url.URLSearchParams;
+declare function makeURLSearchParams<ParametersType extends object>(parameters?: Readonly<ParametersType>, options?: MakeURLSearchParamsOptions): url.URLSearchParams;
 /**
  * Converts the response to usable data
  *
@@ -928,4 +941,4 @@ declare function calculateUserDefaultAvatarIndex(userId: Snowflake): number;
  */
 declare const version: string;
 
-export { ALLOWED_EXTENSIONS, ALLOWED_SIZES, ALLOWED_STICKER_EXTENSIONS, type APIRequest, AUTH_UUID_NAMESPACE, type AuthData, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, type CDNOptions, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordError, type DiscordErrorData, type DiscordErrorFieldInformation, type DiscordErrorGroupWrapper, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, type GetRetryBackoffFunction, type GetTimeoutFunction, HTTPError, type HandlerRequestData, type HashData, type IHandler, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RequestBody, type RequestData, type RequestHeaders, RequestMethod, type ResponseLike, type RestEvents, type RestEventsMap, type RouteData, type RouteLike, type StickerExtension, calculateUserDefaultAvatarIndex, makeURLSearchParams, parseResponse, version };
+export { ALLOWED_EXTENSIONS, ALLOWED_SIZES, ALLOWED_STICKER_EXTENSIONS, type APIRequest, AUTH_UUID_NAMESPACE, type AuthData, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, type CDNOptions, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordError, type DiscordErrorData, type DiscordErrorFieldInformation, type DiscordErrorGroupWrapper, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, type GetRetryBackoffFunction, type GetTimeoutFunction, HTTPError, type HandlerRequestData, type HashData, type IHandler, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type MakeURLSearchParamsOptions, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RequestBody, type RequestData, type RequestHeaders, RequestMethod, type ResponseLike, type RestEvents, type RestEventsMap, type RouteData, type RouteLike, type StickerExtension, calculateUserDefaultAvatarIndex, makeURLSearchParams, parseResponse, version };

package/dist/index.js

@@ -144,7 +144,7 @@ var import_v102 = require("discord-api-types/v10");
 // src/lib/utils/constants.ts
 var import_util = require("@discordjs/util");
 var import_v10 = require("discord-api-types/v10");
-var DefaultUserAgent = `DiscordBot (https://discord.js.org, 3.0.0-dev.1784246195-c73e2a76d)`;
+var DefaultUserAgent = `DiscordBot (https://discord.js.org, 3.0.0-dev.1784551164-2de90a767)`;
 var DefaultUserAgentAppendix = (0, import_util.getUserAgentAppendix)();
 var DefaultRestOptions = {
   agent: null,
@@ -624,10 +624,29 @@ function serializeSearchParam(value) {
   }
 }
 __name(serializeSearchParam, "serializeSearchParam");
-function makeURLSearchParams(options) {
+function makeURLSearchParams(parameters, options = {}) {
   const params = new URLSearchParams();
-  if (!options) return params;
-  for (const [key, value] of Object.entries(options)) {
+  if (!parameters) return params;
+  const { arrayFormat = "repeat" } = options;
+  for (const [key, value] of Object.entries(parameters)) {
+    if (Array.isArray(value)) {
+      const commaSeparatedElements = arrayFormat === "comma" ? [] : null;
+      for (const element of value) {
+        const serialized2 = serializeSearchParam(element);
+        if (serialized2 === null) {
+          continue;
+        }
+        if (commaSeparatedElements) {
+          commaSeparatedElements.push(serialized2);
+        } else {
+          params.append(key, serialized2);
+        }
+      }
+      if (commaSeparatedElements?.length) {
+        params.append(key, commaSeparatedElements.join(","));
+      }
+      continue;
+    }
     const serialized = serializeSearchParam(value);
     if (serialized !== null) params.append(key, serialized);
   }
@@ -1545,7 +1564,7 @@ var REST = class _REST extends import_async_event_emitter.AsyncEventEmitter {
 };
 
 // src/shared.ts
-var version = "3.0.0-dev.1784246195-c73e2a76d";
+var version = "3.0.0-dev.1784551164-2de90a767";
 
 // src/index.ts
 setDefaultStrategy((0, import_util2.shouldUseGlobalFetchAndWebSocket)() ? fetch : makeRequest);