@discordjs/rest 2.6.1 → 2.6.3

package/README.md

@@ -5,12 +5,13 @@
 	</p>
 	<br />
 	<p>
-		<a href="https://discord.gg/djs"><img src="https://img.shields.io/discord/222078108977594368?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
+		<a href="https://discord.gg/djs"><img src="https://img.shields.io/badge/join_us-on_discord-5865F2?logo=discord&logoColor=white" alt="Discord server" /></a>
 		<a href="https://www.npmjs.com/package/@discordjs/rest"><img src="https://img.shields.io/npm/v/@discordjs/rest.svg?maxAge=3600" alt="npm version" /></a>
 		<a href="https://www.npmjs.com/package/@discordjs/rest"><img src="https://img.shields.io/npm/dt/@discordjs/rest.svg?maxAge=3600" alt="npm downloads" /></a>
 		<a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Tests status" /></a>
-		<a href="https://github.com/discordjs/discord.js/commits/main/packages/rest" ><img alt="Last commit." src="https://img.shields.io/github/last-commit/discordjs/discord.js?logo=github&logoColor=ffffff&path=packages%2Frest"></a>
-		<a href="https://codecov.io/gh/discordjs/discord.js" ><img src="https://codecov.io/gh/discordjs/discord.js/branch/main/graph/badge.svg?precision=2&flag=rest" alt="Code coverage" /></a>
+		<a href="https://github.com/discordjs/discord.js/commits/main/packages/rest"><img alt="Last commit." src="https://img.shields.io/github/last-commit/discordjs/discord.js?logo=github&logoColor=ffffff&path=packages%2Frest" /></a>
+		<a href="https://opencollective.com/discordjs"><img src="https://img.shields.io/opencollective/backers/discordjs?maxAge=3600&logo=opencollective" alt="backers" /></a>
+		<a href="https://codecov.io/gh/discordjs/discord.js"><img src="https://codecov.io/gh/discordjs/discord.js/branch/main/graph/badge.svg?precision=2&flag=rest" alt="Code coverage" /></a>
 	</p>
 	<p>
 		<a href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-vercel.svg" alt="Vercel" /></a>
@@ -109,7 +110,7 @@ try {
 - [Guide][guide] ([source][guide-source])
   Also see the v13 to v14 [Update Guide][guide-update], which includes updated and removed items from the library.
 - [discord.js Discord server][discord]
-- [Discord API Discord server][discord-api]
+- [Discord Developers Discord server][discord-developers]
 - [GitHub][source]
 - [npm][npm]
 - [Related libraries][related-libs]
@@ -127,12 +128,12 @@ If you don't understand something in the documentation, you are experiencing pro
 [website]: https://discord.js.org
 [website-source]: https://github.com/discordjs/discord.js/tree/main/apps/website
 [documentation]: https://discord.js.org/docs/packages/rest/stable
-[guide]: https://discordjs.guide/
-[guide-source]: https://github.com/discordjs/guide
-[guide-update]: https://discordjs.guide/additional-info/changes-in-v14.html
+[guide]: https://discordjs.guide
+[guide-source]: https://github.com/discordjs/discord.js/tree/main/apps/guide
+[guide-update]: https://discordjs.guide/legacy/additional-info/changes-in-v14
 [discord]: https://discord.gg/djs
-[discord-api]: https://discord.gg/discord-api
+[discord-developers]: https://discord.gg/discord-developers
 [source]: https://github.com/discordjs/discord.js/tree/main/packages/rest
 [npm]: https://www.npmjs.com/package/@discordjs/rest
-[related-libs]: https://discord.com/developers/docs/topics/community-resources#libraries
+[related-libs]: https://docs.discord.com/developers/developer-tools/community-resources#libraries
 [contributing]: https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md

package/dist/index.d.mts

@@ -6,8 +6,8 @@ import { Collection } from '@discordjs/collection';
 import { Awaitable } 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 {
     /**
@@ -928,14 +928,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
  *
@@ -955,4 +968,4 @@ declare function calculateUserDefaultAvatarIndex(userId: Snowflake): number;
  */
 declare const version: string;
 
-export { ALLOWED_EXTENSIONS, ALLOWED_SIZES, ALLOWED_STICKER_EXTENSIONS, type APIRequest, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, DEPRECATION_WARNING_PREFIX, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordErrorData, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, HTTPError, type HandlerRequestData, type HashData, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type MakeURLOptions, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RawFile, 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, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, DEPRECATION_WARNING_PREFIX, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordErrorData, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, HTTPError, type HandlerRequestData, type HashData, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type MakeURLOptions, type MakeURLSearchParamsOptions, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RawFile, 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

@@ -6,8 +6,8 @@ import { Collection } from '@discordjs/collection';
 import { Awaitable } 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 {
     /**
@@ -928,14 +928,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
  *
@@ -955,4 +968,4 @@ declare function calculateUserDefaultAvatarIndex(userId: Snowflake): number;
  */
 declare const version: string;
 
-export { ALLOWED_EXTENSIONS, ALLOWED_SIZES, ALLOWED_STICKER_EXTENSIONS, type APIRequest, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, DEPRECATION_WARNING_PREFIX, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordErrorData, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, HTTPError, type HandlerRequestData, type HashData, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type MakeURLOptions, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RawFile, 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, type BaseImageURLOptions, BurstHandlerMajorIdKey, CDN, DEPRECATION_WARNING_PREFIX, DefaultRestOptions, DefaultUserAgent, DefaultUserAgentAppendix, DiscordAPIError, type DiscordErrorData, type EmojiURLOptions, type EmojiURLOptionsNotWebp, type EmojiURLOptionsWebp, type GetRateLimitOffsetFunction, HTTPError, type HandlerRequestData, type HashData, type ImageExtension, type ImageURLOptions, type InternalRequest, type InvalidRequestWarningData, type MakeURLOptions, type MakeURLSearchParamsOptions, type OAuthErrorData, OverwrittenMimeTypes, REST, RESTEvents, type RESTOptions, type RateLimitData, RateLimitError, type RateLimitQueueFilter, type RawFile, 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

@@ -127,7 +127,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, 2.6.1)`;
+var DefaultUserAgent = `DiscordBot (https://discord.js.org, 2.6.3)`;
 var DefaultUserAgentAppendix = (0, import_util.getUserAgentAppendix)();
 var DefaultRestOptions = {
   agent: null,
@@ -264,10 +264,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);
   }
@@ -343,6 +362,8 @@ var CDN = class {
     this.cdn = cdn;
     this.mediaProxy = mediaProxy;
   }
+  cdn;
+  mediaProxy;
   static {
     __name(this, "CDN");
   }
@@ -623,6 +644,11 @@ var DiscordAPIError = class _DiscordAPIError extends Error {
     this.url = url;
     this.requestBody = { files: bodyData.files, json: bodyData.body };
   }
+  rawError;
+  code;
+  status;
+  method;
+  url;
   static {
     __name(this, "DiscordAPIError");
   }
@@ -679,6 +705,9 @@ var HTTPError = class _HTTPError extends Error {
     this.url = url;
     this.requestBody = { files: bodyData.files, json: bodyData.body };
   }
+  status;
+  method;
+  url;
   static {
     __name(this, "HTTPError");
   }
@@ -779,6 +808,9 @@ var BurstHandler = class {
     this.majorParameter = majorParameter;
     this.id = `${hash}:${majorParameter}`;
   }
+  manager;
+  hash;
+  majorParameter;
   static {
     __name(this, "BurstHandler");
   }
@@ -886,6 +918,9 @@ var SequentialHandler = class {
     this.majorParameter = majorParameter;
     this.id = `${hash}:${majorParameter}`;
   }
+  manager;
+  hash;
+  majorParameter;
   static {
     __name(this, "SequentialHandler");
   }
@@ -1483,7 +1518,7 @@ var REST = class _REST extends import_async_event_emitter.AsyncEventEmitter {
 };
 
 // src/shared.ts
-var version = "2.6.1";
+var version = "2.6.3";
 
 // src/index.ts
 globalThis.FormData ??= import_undici2.FormData;