@discordjs/rest 1.2.0-dev.1661256247-28bc4f4.0 → 1.2.0-dev.1662293018-8b3d006.0

package/dist/index.js

@@ -0,0 +1,1009 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports, module2) {
+    module2.exports = {
+      name: "@discordjs/rest",
+      version: "1.2.0-dev.1662293018-8b3d006.0",
+      description: "The REST API for discord.js",
+      scripts: {
+        test: "vitest run",
+        build: "tsup",
+        lint: "prettier --check . && TIMING=1 eslint src __tests__ --ext mjs,js,ts",
+        format: "prettier --write . && TIMING=1 eslint src __tests__ --ext mjs,js,ts --fix",
+        fmt: "yarn format",
+        docs: "downlevel-dts dist docs/dist --to=3.7 && docgen -i src/index.ts -c docs/index.json -o docs/docs.json --typescript && api-extractor run --local",
+        prepack: "yarn lint && yarn test && yarn build",
+        changelog: "git cliff --prepend ./CHANGELOG.md -u -c ./cliff.toml -r ../../ --include-path 'packages/rest/*'",
+        release: "cliff-jumper"
+      },
+      main: "./dist/index.js",
+      module: "./dist/index.mjs",
+      typings: "./dist/index.d.ts",
+      exports: {
+        import: "./dist/index.mjs",
+        require: "./dist/index.js",
+        types: "./dist/index.d.ts"
+      },
+      directories: {
+        lib: "src",
+        test: "__tests__"
+      },
+      files: [
+        "dist"
+      ],
+      contributors: [
+        "Crawl <icrawltogo@gmail.com>",
+        "Amish Shah <amishshah.2k@gmail.com>",
+        "SpaceEEC <spaceeec@yahoo.com>",
+        "Vlad Frangu <kingdgrizzle@gmail.com>",
+        "Antonio Roman <kyradiscord@gmail.com>"
+      ],
+      license: "Apache-2.0",
+      keywords: [
+        "discord",
+        "api",
+        "rest",
+        "discordapp",
+        "discordjs"
+      ],
+      repository: {
+        type: "git",
+        url: "git+https://github.com/discordjs/discord.js.git"
+      },
+      bugs: {
+        url: "https://github.com/discordjs/discord.js/issues"
+      },
+      homepage: "https://discord.js.org",
+      dependencies: {
+        "@discordjs/collection": "workspace:^",
+        "@sapphire/async-queue": "^1.5.0",
+        "@sapphire/snowflake": "^3.2.2",
+        "discord-api-types": "^0.37.5",
+        "file-type": "^18.0.0",
+        tslib: "^2.4.0",
+        undici: "^5.10.0"
+      },
+      devDependencies: {
+        "@discordjs/docgen": "workspace:^",
+        "@favware/cliff-jumper": "^1.8.7",
+        "@microsoft/api-extractor": "^7.30.0",
+        "@types/node": "^16.11.56",
+        "@vitest/coverage-c8": "^0.22.1",
+        "downlevel-dts": "^0.10.1",
+        eslint: "^8.23.0",
+        "eslint-config-neon": "^0.1.31",
+        prettier: "^2.7.1",
+        tsup: "^6.2.3",
+        typescript: "^4.8.2",
+        vitest: "^0.22.1"
+      },
+      engines: {
+        node: ">=16.9.0"
+      },
+      publishConfig: {
+        access: "public"
+      }
+    };
+  }
+});
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  ALLOWED_EXTENSIONS: () => ALLOWED_EXTENSIONS,
+  ALLOWED_SIZES: () => ALLOWED_SIZES,
+  ALLOWED_STICKER_EXTENSIONS: () => ALLOWED_STICKER_EXTENSIONS,
+  CDN: () => CDN,
+  DefaultRestOptions: () => DefaultRestOptions,
+  DefaultUserAgent: () => DefaultUserAgent,
+  DiscordAPIError: () => DiscordAPIError,
+  HTTPError: () => HTTPError,
+  REST: () => REST,
+  RESTEvents: () => RESTEvents,
+  RateLimitError: () => RateLimitError,
+  RequestManager: () => RequestManager,
+  RequestMethod: () => RequestMethod,
+  makeURLSearchParams: () => makeURLSearchParams,
+  parseResponse: () => parseResponse
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/lib/CDN.ts
+var import_node_url = require("url");
+
+// src/lib/utils/constants.ts
+var import_node_process = __toESM(require("process"));
+var import_v10 = require("discord-api-types/v10");
+var import_undici = require("undici");
+var Package = require_package();
+var DefaultUserAgent = `DiscordBot (${Package.homepage}, ${Package.version})`;
+var DefaultRestOptions = {
+  get agent() {
+    return (0, import_undici.getGlobalDispatcher)();
+  },
+  api: "https://discord.com/api",
+  authPrefix: "Bot",
+  cdn: "https://cdn.discordapp.com",
+  headers: {},
+  invalidRequestWarningInterval: 0,
+  globalRequestsPerSecond: 50,
+  offset: 50,
+  rejectOnRateLimit: null,
+  retries: 3,
+  timeout: 15e3,
+  userAgentAppendix: `Node.js ${import_node_process.default.version}`,
+  version: import_v10.APIVersion,
+  hashSweepInterval: 144e5,
+  hashLifetime: 864e5,
+  handlerSweepInterval: 36e5
+};
+var RESTEvents = /* @__PURE__ */ ((RESTEvents2) => {
+  RESTEvents2["Debug"] = "restDebug";
+  RESTEvents2["HandlerSweep"] = "handlerSweep";
+  RESTEvents2["HashSweep"] = "hashSweep";
+  RESTEvents2["InvalidRequestWarning"] = "invalidRequestWarning";
+  RESTEvents2["RateLimited"] = "rateLimited";
+  RESTEvents2["Response"] = "response";
+  return RESTEvents2;
+})(RESTEvents || {});
+var ALLOWED_EXTENSIONS = ["webp", "png", "jpg", "jpeg", "gif"];
+var ALLOWED_STICKER_EXTENSIONS = ["png", "json"];
+var ALLOWED_SIZES = [16, 32, 64, 128, 256, 512, 1024, 2048, 4096];
+
+// src/lib/CDN.ts
+var CDN = class {
+  constructor(base = DefaultRestOptions.cdn) {
+    this.base = base;
+  }
+  appAsset(clientId, assetHash, options) {
+    return this.makeURL(`/app-assets/${clientId}/${assetHash}`, options);
+  }
+  appIcon(clientId, iconHash, options) {
+    return this.makeURL(`/app-icons/${clientId}/${iconHash}`, options);
+  }
+  avatar(id, avatarHash, options) {
+    return this.dynamicMakeURL(`/avatars/${id}/${avatarHash}`, avatarHash, options);
+  }
+  banner(id, bannerHash, options) {
+    return this.dynamicMakeURL(`/banners/${id}/${bannerHash}`, bannerHash, options);
+  }
+  channelIcon(channelId, iconHash, options) {
+    return this.makeURL(`/channel-icons/${channelId}/${iconHash}`, options);
+  }
+  defaultAvatar(discriminator) {
+    return this.makeURL(`/embed/avatars/${discriminator}`, { extension: "png" });
+  }
+  discoverySplash(guildId, splashHash, options) {
+    return this.makeURL(`/discovery-splashes/${guildId}/${splashHash}`, options);
+  }
+  emoji(emojiId, extension) {
+    return this.makeURL(`/emojis/${emojiId}`, { extension });
+  }
+  guildMemberAvatar(guildId, userId, avatarHash, options) {
+    return this.dynamicMakeURL(`/guilds/${guildId}/users/${userId}/avatars/${avatarHash}`, avatarHash, options);
+  }
+  guildMemberBanner(guildId, userId, bannerHash, options) {
+    return this.dynamicMakeURL(`/guilds/${guildId}/users/${userId}/banner`, bannerHash, options);
+  }
+  icon(id, iconHash, options) {
+    return this.dynamicMakeURL(`/icons/${id}/${iconHash}`, iconHash, options);
+  }
+  roleIcon(roleId, roleIconHash, options) {
+    return this.makeURL(`/role-icons/${roleId}/${roleIconHash}`, options);
+  }
+  splash(guildId, splashHash, options) {
+    return this.makeURL(`/splashes/${guildId}/${splashHash}`, options);
+  }
+  sticker(stickerId, extension) {
+    return this.makeURL(`/stickers/${stickerId}`, {
+      allowedExtensions: ALLOWED_STICKER_EXTENSIONS,
+      extension: extension ?? "png"
+    });
+  }
+  stickerPackBanner(bannerId, options) {
+    return this.makeURL(`/app-assets/710982414301790216/store/${bannerId}`, options);
+  }
+  teamIcon(teamId, iconHash, options) {
+    return this.makeURL(`/team-icons/${teamId}/${iconHash}`, options);
+  }
+  guildScheduledEventCover(scheduledEventId, coverHash, options) {
+    return this.makeURL(`/guild-events/${scheduledEventId}/${coverHash}`, options);
+  }
+  dynamicMakeURL(route, hash, { forceStatic = false, ...options } = {}) {
+    return this.makeURL(route, !forceStatic && hash.startsWith("a_") ? { ...options, extension: "gif" } : options);
+  }
+  makeURL(route, { allowedExtensions = ALLOWED_EXTENSIONS, extension = "webp", size } = {}) {
+    extension = String(extension).toLowerCase();
+    if (!allowedExtensions.includes(extension)) {
+      throw new RangeError(`Invalid extension provided: ${extension}
+Must be one of: ${allowedExtensions.join(", ")}`);
+    }
+    if (size && !ALLOWED_SIZES.includes(size)) {
+      throw new RangeError(`Invalid size provided: ${size}
+Must be one of: ${ALLOWED_SIZES.join(", ")}`);
+    }
+    const url = new import_node_url.URL(`${this.base}${route}.${extension}`);
+    if (size) {
+      url.searchParams.set("size", String(size));
+    }
+    return url.toString();
+  }
+};
+__name(CDN, "CDN");
+
+// src/lib/errors/DiscordAPIError.ts
+function isErrorGroupWrapper(error) {
+  return Reflect.has(error, "_errors");
+}
+__name(isErrorGroupWrapper, "isErrorGroupWrapper");
+function isErrorResponse(error) {
+  return typeof Reflect.get(error, "message") === "string";
+}
+__name(isErrorResponse, "isErrorResponse");
+var DiscordAPIError = class extends Error {
+  constructor(rawError, code, status, method, url, bodyData) {
+    super(DiscordAPIError.getMessage(rawError));
+    this.rawError = rawError;
+    this.code = code;
+    this.status = status;
+    this.method = method;
+    this.url = url;
+    this.requestBody = { files: bodyData.files, json: bodyData.body };
+  }
+  requestBody;
+  get name() {
+    return `${DiscordAPIError.name}[${this.code}]`;
+  }
+  static getMessage(error) {
+    let flattened = "";
+    if ("code" in error) {
+      if (error.errors) {
+        flattened = [...this.flattenDiscordError(error.errors)].join("\n");
+      }
+      return error.message && flattened ? `${error.message}
+${flattened}` : error.message || flattened || "Unknown Error";
+    }
+    return error.error_description ?? "No Description";
+  }
+  static *flattenDiscordError(obj, key = "") {
+    if (isErrorResponse(obj)) {
+      return yield `${key.length ? `${key}[${obj.code}]` : `${obj.code}`}: ${obj.message}`.trim();
+    }
+    for (const [otherKey, val] of Object.entries(obj)) {
+      const nextKey = otherKey.startsWith("_") ? key : key ? Number.isNaN(Number(otherKey)) ? `${key}.${otherKey}` : `${key}[${otherKey}]` : otherKey;
+      if (typeof val === "string") {
+        yield val;
+      } else if (isErrorGroupWrapper(val)) {
+        for (const error of val._errors) {
+          yield* this.flattenDiscordError(error, nextKey);
+        }
+      } else {
+        yield* this.flattenDiscordError(val, nextKey);
+      }
+    }
+  }
+};
+__name(DiscordAPIError, "DiscordAPIError");
+
+// src/lib/errors/HTTPError.ts
+var HTTPError = class extends Error {
+  constructor(name, status, method, url, bodyData) {
+    super();
+    this.name = name;
+    this.status = status;
+    this.method = method;
+    this.url = url;
+    this.requestBody = { files: bodyData.files, json: bodyData.body };
+  }
+  requestBody;
+};
+__name(HTTPError, "HTTPError");
+
+// src/lib/errors/RateLimitError.ts
+var RateLimitError = class extends Error {
+  timeToReset;
+  limit;
+  method;
+  hash;
+  url;
+  route;
+  majorParameter;
+  global;
+  constructor({ timeToReset, limit, method, hash, url, route, majorParameter, global }) {
+    super();
+    this.timeToReset = timeToReset;
+    this.limit = limit;
+    this.method = method;
+    this.hash = hash;
+    this.url = url;
+    this.route = route;
+    this.majorParameter = majorParameter;
+    this.global = global;
+  }
+  get name() {
+    return `${RateLimitError.name}[${this.route}]`;
+  }
+};
+__name(RateLimitError, "RateLimitError");
+
+// src/lib/RequestManager.ts
+var import_node_buffer2 = require("buffer");
+var import_node_events = require("events");
+var import_node_timers2 = require("timers");
+var import_collection = require("@discordjs/collection");
+var import_snowflake = require("@sapphire/snowflake");
+var import_undici4 = require("undici");
+
+// src/lib/handlers/SequentialHandler.ts
+var import_node_timers = require("timers");
+var import_promises = require("timers/promises");
+var import_async_queue = require("@sapphire/async-queue");
+var import_undici3 = require("undici");
+
+// src/lib/utils/utils.ts
+var import_node_buffer = require("buffer");
+var import_node_url2 = require("url");
+var import_node_util = require("util");
+var import_undici2 = require("undici");
+function parseHeader(header) {
+  if (header === void 0 || typeof header === "string") {
+    return header;
+  }
+  return header.join(";");
+}
+__name(parseHeader, "parseHeader");
+function serializeSearchParam(value) {
+  switch (typeof value) {
+    case "string":
+      return value;
+    case "number":
+    case "bigint":
+    case "boolean":
+      return value.toString();
+    case "object":
+      if (value === null)
+        return null;
+      if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? null : value.toISOString();
+      }
+      if (typeof value.toString === "function" && value.toString !== Object.prototype.toString)
+        return value.toString();
+      return null;
+    default:
+      return null;
+  }
+}
+__name(serializeSearchParam, "serializeSearchParam");
+function makeURLSearchParams(options) {
+  const params = new import_node_url2.URLSearchParams();
+  if (!options)
+    return params;
+  for (const [key, value] of Object.entries(options)) {
+    const serialized = serializeSearchParam(value);
+    if (serialized !== null)
+      params.append(key, serialized);
+  }
+  return params;
+}
+__name(makeURLSearchParams, "makeURLSearchParams");
+async function parseResponse(res) {
+  const header = parseHeader(res.headers["content-type"]);
+  if (header?.startsWith("application/json")) {
+    return res.body.json();
+  }
+  return res.body.arrayBuffer();
+}
+__name(parseResponse, "parseResponse");
+function hasSublimit(bucketRoute, body, method) {
+  if (bucketRoute === "/channels/:id") {
+    if (typeof body !== "object" || body === null)
+      return false;
+    if (method !== "PATCH" /* Patch */)
+      return false;
+    const castedBody = body;
+    return ["name", "topic"].some((key) => Reflect.has(castedBody, key));
+  }
+  return true;
+}
+__name(hasSublimit, "hasSublimit");
+async function resolveBody(body) {
+  if (body == null) {
+    return null;
+  } else if (typeof body === "string") {
+    return body;
+  } else if (import_node_util.types.isUint8Array(body)) {
+    return body;
+  } else if (import_node_util.types.isArrayBuffer(body)) {
+    return new Uint8Array(body);
+  } else if (body instanceof import_node_url2.URLSearchParams) {
+    return body.toString();
+  } else if (body instanceof DataView) {
+    return new Uint8Array(body.buffer);
+  } else if (body instanceof import_node_buffer.Blob) {
+    return new Uint8Array(await body.arrayBuffer());
+  } else if (body instanceof import_undici2.FormData) {
+    return body;
+  } else if (body[Symbol.iterator]) {
+    const chunks = [...body];
+    const length = chunks.reduce((a, b) => a + b.length, 0);
+    const uint8 = new Uint8Array(length);
+    let lengthUsed = 0;
+    return chunks.reduce((a, b) => {
+      a.set(b, lengthUsed);
+      lengthUsed += b.length;
+      return a;
+    }, uint8);
+  } else if (body[Symbol.asyncIterator]) {
+    const chunks = [];
+    for await (const chunk of body) {
+      chunks.push(chunk);
+    }
+    return import_node_buffer.Buffer.concat(chunks);
+  }
+  throw new TypeError(`Unable to resolve body.`);
+}
+__name(resolveBody, "resolveBody");
+
+// src/lib/handlers/SequentialHandler.ts
+var invalidCount = 0;
+var invalidCountResetTime = null;
+var SequentialHandler = class {
+  constructor(manager, hash, majorParameter) {
+    this.manager = manager;
+    this.hash = hash;
+    this.majorParameter = majorParameter;
+    this.id = `${hash}:${majorParameter}`;
+  }
+  id;
+  reset = -1;
+  remaining = 1;
+  limit = Number.POSITIVE_INFINITY;
+  #asyncQueue = new import_async_queue.AsyncQueue();
+  #sublimitedQueue = null;
+  #sublimitPromise = null;
+  #shiftSublimit = false;
+  get inactive() {
+    return this.#asyncQueue.remaining === 0 && (this.#sublimitedQueue === null || this.#sublimitedQueue.remaining === 0) && !this.limited;
+  }
+  get globalLimited() {
+    return this.manager.globalRemaining <= 0 && Date.now() < this.manager.globalReset;
+  }
+  get localLimited() {
+    return this.remaining <= 0 && Date.now() < this.reset;
+  }
+  get limited() {
+    return this.globalLimited || this.localLimited;
+  }
+  get timeToReset() {
+    return this.reset + this.manager.options.offset - Date.now();
+  }
+  debug(message) {
+    this.manager.emit("restDebug" /* Debug */, `[REST ${this.id}] ${message}`);
+  }
+  async globalDelayFor(time) {
+    await (0, import_promises.setTimeout)(time, void 0, { ref: false });
+    this.manager.globalDelay = null;
+  }
+  async onRateLimit(rateLimitData) {
+    const { options } = this.manager;
+    if (!options.rejectOnRateLimit)
+      return;
+    const shouldThrow = typeof options.rejectOnRateLimit === "function" ? await options.rejectOnRateLimit(rateLimitData) : options.rejectOnRateLimit.some((route) => rateLimitData.route.startsWith(route.toLowerCase()));
+    if (shouldThrow) {
+      throw new RateLimitError(rateLimitData);
+    }
+  }
+  async queueRequest(routeId, url, options, requestData) {
+    let queue = this.#asyncQueue;
+    let queueType = 0 /* Standard */;
+    if (this.#sublimitedQueue && hasSublimit(routeId.bucketRoute, requestData.body, options.method)) {
+      queue = this.#sublimitedQueue;
+      queueType = 1 /* Sublimit */;
+    }
+    await queue.wait();
+    if (queueType === 0 /* Standard */) {
+      if (this.#sublimitedQueue && hasSublimit(routeId.bucketRoute, requestData.body, options.method)) {
+        queue = this.#sublimitedQueue;
+        const wait = queue.wait();
+        this.#asyncQueue.shift();
+        await wait;
+      } else if (this.#sublimitPromise) {
+        await this.#sublimitPromise.promise;
+      }
+    }
+    try {
+      return await this.runRequest(routeId, url, options, requestData);
+    } finally {
+      queue.shift();
+      if (this.#shiftSublimit) {
+        this.#shiftSublimit = false;
+        this.#sublimitedQueue?.shift();
+      }
+      if (this.#sublimitedQueue?.remaining === 0) {
+        this.#sublimitPromise?.resolve();
+        this.#sublimitedQueue = null;
+      }
+    }
+  }
+  async runRequest(routeId, url, options, requestData, retries = 0) {
+    while (this.limited) {
+      const isGlobal = this.globalLimited;
+      let limit2;
+      let timeout2;
+      let delay;
+      if (isGlobal) {
+        limit2 = this.manager.options.globalRequestsPerSecond;
+        timeout2 = this.manager.globalReset + this.manager.options.offset - Date.now();
+        if (!this.manager.globalDelay) {
+          this.manager.globalDelay = this.globalDelayFor(timeout2);
+        }
+        delay = this.manager.globalDelay;
+      } else {
+        limit2 = this.limit;
+        timeout2 = this.timeToReset;
+        delay = (0, import_promises.setTimeout)(timeout2);
+      }
+      const rateLimitData = {
+        timeToReset: timeout2,
+        limit: limit2,
+        method: options.method ?? "get",
+        hash: this.hash,
+        url,
+        route: routeId.bucketRoute,
+        majorParameter: this.majorParameter,
+        global: isGlobal
+      };
+      this.manager.emit("rateLimited" /* RateLimited */, rateLimitData);
+      await this.onRateLimit(rateLimitData);
+      if (isGlobal) {
+        this.debug(`Global rate limit hit, blocking all requests for ${timeout2}ms`);
+      } else {
+        this.debug(`Waiting ${timeout2}ms for rate limit to pass`);
+      }
+      await delay;
+    }
+    if (!this.manager.globalReset || this.manager.globalReset < Date.now()) {
+      this.manager.globalReset = Date.now() + 1e3;
+      this.manager.globalRemaining = this.manager.options.globalRequestsPerSecond;
+    }
+    this.manager.globalRemaining--;
+    const method = options.method ?? "get";
+    const controller = new AbortController();
+    const timeout = (0, import_node_timers.setTimeout)(() => controller.abort(), this.manager.options.timeout).unref();
+    let res;
+    try {
+      res = await (0, import_undici3.request)(url, { ...options, signal: controller.signal });
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError" && retries !== this.manager.options.retries) {
+        return await this.runRequest(routeId, url, options, requestData, ++retries);
+      }
+      throw error;
+    } finally {
+      (0, import_node_timers.clearTimeout)(timeout);
+    }
+    if (this.manager.listenerCount("response" /* Response */)) {
+      this.manager.emit(
+        "response" /* Response */,
+        {
+          method,
+          path: routeId.original,
+          route: routeId.bucketRoute,
+          options,
+          data: requestData,
+          retries
+        },
+        { ...res }
+      );
+    }
+    const status = res.statusCode;
+    let retryAfter = 0;
+    const limit = parseHeader(res.headers["x-ratelimit-limit"]);
+    const remaining = parseHeader(res.headers["x-ratelimit-remaining"]);
+    const reset = parseHeader(res.headers["x-ratelimit-reset-after"]);
+    const hash = parseHeader(res.headers["x-ratelimit-bucket"]);
+    const retry = parseHeader(res.headers["retry-after"]);
+    this.limit = limit ? Number(limit) : Number.POSITIVE_INFINITY;
+    this.remaining = remaining ? Number(remaining) : 1;
+    this.reset = reset ? Number(reset) * 1e3 + Date.now() + this.manager.options.offset : Date.now();
+    if (retry)
+      retryAfter = Number(retry) * 1e3 + this.manager.options.offset;
+    if (hash && hash !== this.hash) {
+      this.debug(["Received bucket hash update", `  Old Hash  : ${this.hash}`, `  New Hash  : ${hash}`].join("\n"));
+      this.manager.hashes.set(`${method}:${routeId.bucketRoute}`, { value: hash, lastAccess: Date.now() });
+    } else if (hash) {
+      const hashData = this.manager.hashes.get(`${method}:${routeId.bucketRoute}`);
+      if (hashData) {
+        hashData.lastAccess = Date.now();
+      }
+    }
+    let sublimitTimeout = null;
+    if (retryAfter > 0) {
+      if (res.headers["x-ratelimit-global"] !== void 0) {
+        this.manager.globalRemaining = 0;
+        this.manager.globalReset = Date.now() + retryAfter;
+      } else if (!this.localLimited) {
+        sublimitTimeout = retryAfter;
+      }
+    }
+    if (status === 401 || status === 403 || status === 429) {
+      if (!invalidCountResetTime || invalidCountResetTime < Date.now()) {
+        invalidCountResetTime = Date.now() + 1e3 * 60 * 10;
+        invalidCount = 0;
+      }
+      invalidCount++;
+      const emitInvalid = this.manager.options.invalidRequestWarningInterval > 0 && invalidCount % this.manager.options.invalidRequestWarningInterval === 0;
+      if (emitInvalid) {
+        this.manager.emit("invalidRequestWarning" /* InvalidRequestWarning */, {
+          count: invalidCount,
+          remainingTime: invalidCountResetTime - Date.now()
+        });
+      }
+    }
+    if (status >= 200 && status < 300) {
+      return res;
+    } else if (status === 429) {
+      const isGlobal = this.globalLimited;
+      let limit2;
+      let timeout2;
+      if (isGlobal) {
+        limit2 = this.manager.options.globalRequestsPerSecond;
+        timeout2 = this.manager.globalReset + this.manager.options.offset - Date.now();
+      } else {
+        limit2 = this.limit;
+        timeout2 = this.timeToReset;
+      }
+      await this.onRateLimit({
+        timeToReset: timeout2,
+        limit: limit2,
+        method,
+        hash: this.hash,
+        url,
+        route: routeId.bucketRoute,
+        majorParameter: this.majorParameter,
+        global: isGlobal
+      });
+      this.debug(
+        [
+          "Encountered unexpected 429 rate limit",
+          `  Global         : ${isGlobal.toString()}`,
+          `  Method         : ${method}`,
+          `  URL            : ${url}`,
+          `  Bucket         : ${routeId.bucketRoute}`,
+          `  Major parameter: ${routeId.majorParameter}`,
+          `  Hash           : ${this.hash}`,
+          `  Limit          : ${limit2}`,
+          `  Retry After    : ${retryAfter}ms`,
+          `  Sublimit       : ${sublimitTimeout ? `${sublimitTimeout}ms` : "None"}`
+        ].join("\n")
+      );
+      if (sublimitTimeout) {
+        const firstSublimit = !this.#sublimitedQueue;
+        if (firstSublimit) {
+          this.#sublimitedQueue = new import_async_queue.AsyncQueue();
+          void this.#sublimitedQueue.wait();
+          this.#asyncQueue.shift();
+        }
+        this.#sublimitPromise?.resolve();
+        this.#sublimitPromise = null;
+        await (0, import_promises.setTimeout)(sublimitTimeout, void 0, { ref: false });
+        let resolve;
+        const promise = new Promise((res2) => resolve = res2);
+        this.#sublimitPromise = { promise, resolve };
+        if (firstSublimit) {
+          await this.#asyncQueue.wait();
+          this.#shiftSublimit = true;
+        }
+      }
+      return this.runRequest(routeId, url, options, requestData, retries);
+    } else if (status >= 500 && status < 600) {
+      if (retries !== this.manager.options.retries) {
+        return this.runRequest(routeId, url, options, requestData, ++retries);
+      }
+      throw new HTTPError(res.constructor.name, status, method, url, requestData);
+    } else {
+      if (status >= 400 && status < 500) {
+        if (status === 401 && requestData.auth) {
+          this.manager.setToken(null);
+        }
+        const data = await parseResponse(res);
+        throw new DiscordAPIError(data, "code" in data ? data.code : data.error, status, method, url, requestData);
+      }
+      return res;
+    }
+  }
+};
+__name(SequentialHandler, "SequentialHandler");
+
+// src/lib/RequestManager.ts
+var getFileType = /* @__PURE__ */ __name(async () => {
+  let cached;
+  return cached ??= import("file-type");
+}, "getFileType");
+var RequestMethod = /* @__PURE__ */ ((RequestMethod2) => {
+  RequestMethod2["Delete"] = "DELETE";
+  RequestMethod2["Get"] = "GET";
+  RequestMethod2["Patch"] = "PATCH";
+  RequestMethod2["Post"] = "POST";
+  RequestMethod2["Put"] = "PUT";
+  return RequestMethod2;
+})(RequestMethod || {});
+var RequestManager = class extends import_node_events.EventEmitter {
+  agent = null;
+  globalRemaining;
+  globalDelay = null;
+  globalReset = -1;
+  hashes = new import_collection.Collection();
+  handlers = new import_collection.Collection();
+  #token = null;
+  hashTimer;
+  handlerTimer;
+  options;
+  constructor(options) {
+    super();
+    this.options = { ...DefaultRestOptions, ...options };
+    this.options.offset = Math.max(0, this.options.offset);
+    this.globalRemaining = this.options.globalRequestsPerSecond;
+    this.agent = options.agent ?? null;
+    this.setupSweepers();
+  }
+  setupSweepers() {
+    const validateMaxInterval = /* @__PURE__ */ __name((interval) => {
+      if (interval > 144e5) {
+        throw new Error("Cannot set an interval greater than 4 hours");
+      }
+    }, "validateMaxInterval");
+    if (this.options.hashSweepInterval !== 0 && this.options.hashSweepInterval !== Number.POSITIVE_INFINITY) {
+      validateMaxInterval(this.options.hashSweepInterval);
+      this.hashTimer = (0, import_node_timers2.setInterval)(() => {
+        const sweptHashes = new import_collection.Collection();
+        const currentDate = Date.now();
+        this.hashes.sweep((val, key) => {
+          if (val.lastAccess === -1)
+            return false;
+          const shouldSweep = Math.floor(currentDate - val.lastAccess) > this.options.hashLifetime;
+          if (shouldSweep) {
+            sweptHashes.set(key, val);
+          }
+          this.emit("restDebug" /* Debug */, `Hash ${val.value} for ${key} swept due to lifetime being exceeded`);
+          return shouldSweep;
+        });
+        this.emit("hashSweep" /* HashSweep */, sweptHashes);
+      }, this.options.hashSweepInterval).unref();
+    }
+    if (this.options.handlerSweepInterval !== 0 && this.options.handlerSweepInterval !== Number.POSITIVE_INFINITY) {
+      validateMaxInterval(this.options.handlerSweepInterval);
+      this.handlerTimer = (0, import_node_timers2.setInterval)(() => {
+        const sweptHandlers = new import_collection.Collection();
+        this.handlers.sweep((val, key) => {
+          const { inactive } = val;
+          if (inactive) {
+            sweptHandlers.set(key, val);
+          }
+          this.emit("restDebug" /* Debug */, `Handler ${val.id} for ${key} swept due to being inactive`);
+          return inactive;
+        });
+        this.emit("handlerSweep" /* HandlerSweep */, sweptHandlers);
+      }, this.options.handlerSweepInterval).unref();
+    }
+  }
+  setAgent(agent) {
+    this.agent = agent;
+    return this;
+  }
+  setToken(token) {
+    this.#token = token;
+    return this;
+  }
+  async queueRequest(request2) {
+    const routeId = RequestManager.generateRouteData(request2.fullRoute, request2.method);
+    const hash = this.hashes.get(`${request2.method}:${routeId.bucketRoute}`) ?? {
+      value: `Global(${request2.method}:${routeId.bucketRoute})`,
+      lastAccess: -1
+    };
+    const handler = this.handlers.get(`${hash.value}:${routeId.majorParameter}`) ?? this.createHandler(hash.value, routeId.majorParameter);
+    const { url, fetchOptions } = await this.resolveRequest(request2);
+    return handler.queueRequest(routeId, url, fetchOptions, {
+      body: request2.body,
+      files: request2.files,
+      auth: request2.auth !== false
+    });
+  }
+  createHandler(hash, majorParameter) {
+    const queue = new SequentialHandler(this, hash, majorParameter);
+    this.handlers.set(queue.id, queue);
+    return queue;
+  }
+  async resolveRequest(request2) {
+    const { options } = this;
+    let query = "";
+    if (request2.query) {
+      const resolvedQuery = request2.query.toString();
+      if (resolvedQuery !== "") {
+        query = `?${resolvedQuery}`;
+      }
+    }
+    const headers = {
+      ...this.options.headers,
+      "User-Agent": `${DefaultUserAgent} ${options.userAgentAppendix}`.trim()
+    };
+    if (request2.auth !== false) {
+      if (!this.#token) {
+        throw new Error("Expected token to be set for this request, but none was present");
+      }
+      headers.Authorization = `${request2.authPrefix ?? this.options.authPrefix} ${this.#token}`;
+    }
+    if (request2.reason?.length) {
+      headers["X-Audit-Log-Reason"] = encodeURIComponent(request2.reason);
+    }
+    const url = `${options.api}${request2.versioned === false ? "" : `/v${options.version}`}${request2.fullRoute}${query}`;
+    let finalBody;
+    let additionalHeaders = {};
+    if (request2.files?.length) {
+      const formData = new import_undici4.FormData();
+      for (const [index, file] of request2.files.entries()) {
+        const fileKey = file.key ?? `files[${index}]`;
+        if (import_node_buffer2.Buffer.isBuffer(file.data)) {
+          const { fileTypeFromBuffer } = await getFileType();
+          const contentType = file.contentType ?? (await fileTypeFromBuffer(file.data))?.mime;
+          formData.append(fileKey, new import_node_buffer2.Blob([file.data], { type: contentType }), file.name);
+        } else {
+          formData.append(fileKey, new import_node_buffer2.Blob([`${file.data}`], { type: file.contentType }), file.name);
+        }
+      }
+      if (request2.body != null) {
+        if (request2.appendToFormData) {
+          for (const [key, value] of Object.entries(request2.body)) {
+            formData.append(key, value);
+          }
+        } else {
+          formData.append("payload_json", JSON.stringify(request2.body));
+        }
+      }
+      finalBody = formData;
+    } else if (request2.body != null) {
+      if (request2.passThroughBody) {
+        finalBody = request2.body;
+      } else {
+        finalBody = JSON.stringify(request2.body);
+        additionalHeaders = { "Content-Type": "application/json" };
+      }
+    }
+    finalBody = await resolveBody(finalBody);
+    const fetchOptions = {
+      headers: { ...request2.headers, ...additionalHeaders, ...headers },
+      method: request2.method.toUpperCase()
+    };
+    if (finalBody !== void 0) {
+      fetchOptions.body = finalBody;
+    }
+    fetchOptions.dispatcher = request2.dispatcher ?? this.agent ?? void 0;
+    return { url, fetchOptions };
+  }
+  clearHashSweeper() {
+    (0, import_node_timers2.clearInterval)(this.hashTimer);
+  }
+  clearHandlerSweeper() {
+    (0, import_node_timers2.clearInterval)(this.handlerTimer);
+  }
+  static generateRouteData(endpoint, method) {
+    const majorIdMatch = /^\/(?:channels|guilds|webhooks)\/(\d{16,19})/.exec(endpoint);
+    const majorId = majorIdMatch?.[1] ?? "global";
+    const baseRoute = endpoint.replace(/\d{16,19}/g, ":id").replace(/\/reactions\/(.*)/, "/reactions/:reaction");
+    let exceptions = "";
+    if (method === "DELETE" /* Delete */ && baseRoute === "/channels/:id/messages/:id") {
+      const id = /\d{16,19}$/.exec(endpoint)[0];
+      const timestamp = import_snowflake.DiscordSnowflake.timestampFrom(id);
+      if (Date.now() - timestamp > 1e3 * 60 * 60 * 24 * 14) {
+        exceptions += "/Delete Old Message";
+      }
+    }
+    return {
+      majorParameter: majorId,
+      bucketRoute: baseRoute + exceptions,
+      original: endpoint
+    };
+  }
+};
+__name(RequestManager, "RequestManager");
+
+// src/lib/REST.ts
+var import_node_events2 = require("events");
+var REST = class extends import_node_events2.EventEmitter {
+  cdn;
+  requestManager;
+  constructor(options = {}) {
+    super();
+    this.cdn = new CDN(options.cdn ?? DefaultRestOptions.cdn);
+    this.requestManager = new RequestManager(options).on("restDebug" /* Debug */, this.emit.bind(this, "restDebug" /* Debug */)).on("rateLimited" /* RateLimited */, this.emit.bind(this, "rateLimited" /* RateLimited */)).on("invalidRequestWarning" /* InvalidRequestWarning */, this.emit.bind(this, "invalidRequestWarning" /* InvalidRequestWarning */)).on("hashSweep" /* HashSweep */, this.emit.bind(this, "hashSweep" /* HashSweep */));
+    this.on("newListener", (name, listener) => {
+      if (name === "response" /* Response */)
+        this.requestManager.on(name, listener);
+    });
+    this.on("removeListener", (name, listener) => {
+      if (name === "response" /* Response */)
+        this.requestManager.off(name, listener);
+    });
+  }
+  getAgent() {
+    return this.requestManager.agent;
+  }
+  setAgent(agent) {
+    this.requestManager.setAgent(agent);
+    return this;
+  }
+  setToken(token) {
+    this.requestManager.setToken(token);
+    return this;
+  }
+  async get(fullRoute, options = {}) {
+    return this.request({ ...options, fullRoute, method: "GET" /* Get */ });
+  }
+  async delete(fullRoute, options = {}) {
+    return this.request({ ...options, fullRoute, method: "DELETE" /* Delete */ });
+  }
+  async post(fullRoute, options = {}) {
+    return this.request({ ...options, fullRoute, method: "POST" /* Post */ });
+  }
+  async put(fullRoute, options = {}) {
+    return this.request({ ...options, fullRoute, method: "PUT" /* Put */ });
+  }
+  async patch(fullRoute, options = {}) {
+    return this.request({ ...options, fullRoute, method: "PATCH" /* Patch */ });
+  }
+  async request(options) {
+    const response = await this.raw(options);
+    return parseResponse(response);
+  }
+  async raw(options) {
+    return this.requestManager.queueRequest(options);
+  }
+};
+__name(REST, "REST");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ALLOWED_EXTENSIONS,
+  ALLOWED_SIZES,
+  ALLOWED_STICKER_EXTENSIONS,
+  CDN,
+  DefaultRestOptions,
+  DefaultUserAgent,
+  DiscordAPIError,
+  HTTPError,
+  REST,
+  RESTEvents,
+  RateLimitError,
+  RequestManager,
+  RequestMethod,
+  makeURLSearchParams,
+  parseResponse
+});
+//# sourceMappingURL=index.js.map