@discordjs/rest 3.0.0-dev.1756252917-50018979e → 3.0.0-dev.1756512128-cc43dadca

package/dist/index.d.mts

@@ -304,7 +304,9 @@ interface RequestData {
      */
     appendToFormData?: boolean;
     /**
-     * Alternate authorization data to use for this request only, or `false` to disable the Authorization header
+     * Alternate authorization data to use for this request only, or `false` to disable the Authorization header.
+     * When making a request to a route that includes a token (such as interactions or webhooks), set to `false`
+     * to avoid accidentally unsetting the instance token if a 401 is encountered.
      *
      * @defaultValue `true`
      */

package/dist/index.d.ts

@@ -304,7 +304,9 @@ interface RequestData {
      */
     appendToFormData?: boolean;
     /**
-     * Alternate authorization data to use for this request only, or `false` to disable the Authorization header
+     * Alternate authorization data to use for this request only, or `false` to disable the Authorization header.
+     * When making a request to a route that includes a token (such as interactions or webhooks), set to `false`
+     * to avoid accidentally unsetting the instance token if a 401 is encountered.
      *
      * @defaultValue `true`
      */

package/dist/index.js

@@ -139,7 +139,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.1756252917-50018979e)`;
+var DefaultUserAgent = `DiscordBot (https://discord.js.org, 3.0.0-dev.1756512128-cc43dadca)`;
 var DefaultUserAgentAppendix = (0, import_util.getUserAgentAppendix)();
 var DefaultRestOptions = {
   agent: null,
@@ -683,6 +683,7 @@ function normalizeRateLimitOffset(offset, route) {
 __name(normalizeRateLimitOffset, "normalizeRateLimitOffset");
 
 // src/lib/handlers/Shared.ts
+var authFalseWarningEmitted = false;
 var invalidCount = 0;
 var invalidCountResetTime = null;
 function incrementInvalidCount(manager) {
@@ -745,11 +746,21 @@ async function handleErrors(manager, res, method, url, requestData, retries) {
     throw new HTTPError(status, res.statusText, method, url, requestData);
   } else {
     if (status >= 400 && status < 500) {
+      const data = await parseResponse(res);
+      const isDiscordError = "code" in data;
       if (status === 401 && requestData.auth === true) {
+        if (isDiscordError && data.code !== 0 && !authFalseWarningEmitted) {
+          const errorText = `Encountered HTTP 401 with error ${data.code}: ${data.message}. Your token will be removed from this REST instance. If you are using @discordjs/rest directly, consider adding 'auth: false' to the request. Open an issue with your library if not.`;
+          if (typeof globalThis.process !== "undefined" && typeof globalThis.process.emitWarning === "function") {
+            globalThis.process.emitWarning(errorText);
+          } else {
+            console.warn(errorText);
+          }
+          authFalseWarningEmitted = true;
+        }
         manager.setToken(null);
       }
-      const data = await parseResponse(res);
-      throw new DiscordAPIError(data, "code" in data ? data.code : data.error, status, method, url, requestData);
+      throw new DiscordAPIError(data, isDiscordError ? data.code : data.error, status, method, url, requestData);
     }
     return res;
   }
@@ -1484,7 +1495,7 @@ var REST = class _REST extends import_async_event_emitter.AsyncEventEmitter {
 };
 
 // src/shared.ts
-var version = "3.0.0-dev.1756252917-50018979e";
+var version = "3.0.0-dev.1756512128-cc43dadca";
 
 // src/index.ts
 setDefaultStrategy((0, import_util2.shouldUseGlobalFetchAndWebSocket)() ? fetch : makeRequest);