snowtransfer 0.3.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 DasWolke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# A minimalistic rest client for the discord api
+
+---
+[![GitHub stars](https://img.shields.io/github/stars/DasWolke/SnowTransfer.svg)](https://github.com/DasWolke/SnowTransfer/stargazers) [![Travis](https://img.shields.io/travis/DasWolke/SnowTransfer.svg)](https://github.com/DasWolke/SnowTransfer) [![npm](https://img.shields.io/npm/dm/snowtransfer.svg)](https://www.npmjs.com/package/snowtransfer) [![npm](https://img.shields.io/npm/v/snowtransfer.svg)](https://www.npmjs.com/package/snowtransfer)
+
+Part of the WeatherStack
+
+SnowTransfer is a small library specially made to **only** cover the REST/HTTP area of the discord api.
+It makes no assumptions about the rest of your stack, therefore you can use it anywhere as long as you use node 8 or higher.
+
+### Some of the things that make SnowTransfer awesome:
+- No requirement for other components
+- Full coverage of the discord rest api
+- Well documented
+
+### General Usecase:
+SnowTransfer is not your everyday library,
+especially compared to other libraries, it makes sense to use it when you:
+- Want to build a microservice based bot, where casual discord libraries would not be suitable since they assume the availability of other components like a gateway or a cache
+- Only need a simple rest client that can be wrapped easily.
+
+### Microservice Bots:
+I've written a general whitepaper on the idea of microservice bots, which you can find on gist: [Microservice Bot Whitepaper](https://gist.github.com/DasWolke/c9d7dfe6a78445011162a12abd32091d)
+
+### Documentation:
+You can find the docs at [https://daswolke.github.io/SnowTransfer/](https://daswolke.github.io/SnowTransfer/)
+
+### Installation:
+To install SnowTransfer, make sure that you have node 8 or higher and npm installed on your computer.
+
+Then run the following command in a terminal `npm install snowtransfer`
+
+## Example:
+```js
+const { SnowTransfer } = require('snowtransfer');
+const client = new SnowTransfer('DISCORD BOT TOKEN');
+const request = async () => {
+	const message = await client.channel.createMessage('channel id', 'hi there');
+	console.log(message);
+};
+request().then(() => {
+	// message was sent to discord
+}).catch(e => {
+	// an error occurred
+});
+```

package/dist/Constants.d.ts

@@ -0,0 +1,8 @@
+declare const _default: {
+    REST_API_VERSION: 9;
+    GET_CHANNEL_MESSAGES_MAX_RESULTS: 100;
+    BULK_DELETE_MESSAGES_MIN: 2;
+    BULK_DELETE_MESSAGES_MAX: 100;
+    OK_STATUS_CODES: number[];
+};
+export = _default;

package/dist/Constants.js

@@ -0,0 +1,8 @@
+"use strict";
+module.exports = {
+    REST_API_VERSION: 9,
+    GET_CHANNEL_MESSAGES_MAX_RESULTS: 100,
+    BULK_DELETE_MESSAGES_MIN: 2,
+    BULK_DELETE_MESSAGES_MAX: 100,
+    OK_STATUS_CODES: [200, 201, 204, 304]
+};

package/dist/Endpoints.d.ts

@@ -0,0 +1,89 @@
+declare const _default: {
+    BASE_URL: string;
+    BASE_HOST: string;
+    CDN_URL: string;
+    APPLICATION_COMMAND: (appID: string, cmdID: string) => string;
+    APPLICATION_COMMAND_PERMISSIONS: (appID: string, guildID: string, cmdID: string) => string;
+    APPLICATION_COMMANDS: (appID: string) => string;
+    APPLICATION_GUILD_COMMAND: (appID: string, guildID: string, cmdID: string) => string;
+    APPLICATION_GUILD_COMMANDS: (appID: string, guildID: string) => string;
+    CHANNEL: (chanID: string) => string;
+    CHANNEL_BULK_DELETE: (chanID: string) => string;
+    CHANNEL_INVITES: (chanID: string) => string;
+    CHANNEL_MESSAGE: (chanID: string, msgID: string) => string;
+    CHANNEL_MESSAGE_CROSSPOST: (chanID: string, msgID: string) => string;
+    CHANNEL_MESSAGE_REACTION: (chanID: string, msgID: string, reaction: string) => string;
+    CHANNEL_MESSAGE_REACTION_USER: (chanID: string, msgID: string, reaction: string, userID: string) => string;
+    CHANNEL_MESSAGE_REACTIONS: (chanID: string, msgID: string) => string;
+    CHANNEL_MESSAGE_THREADS: (chanID: string, msgID: string) => string;
+    CHANNEL_MESSAGES: (chanID: string) => string;
+    CHANNEL_PERMISSION: (chanID: string, overID: string) => string;
+    CHANNEL_PERMISSIONS: (chanID: string) => string;
+    CHANNEL_PIN: (chanID: string, msgID: string) => string;
+    CHANNEL_PINS: (chanID: string) => string;
+    CHANNEL_RECIPIENT: (groupID: string, userID: string) => string;
+    CHANNEL_THREADS: (chanID: string) => string;
+    CHANNEL_THREAD_MEMBER: (chanID: string, memberID: string) => string;
+    CHANNEL_THREAD_MEMBERS: (chanID: any) => string;
+    CHANNEL_THREADS_ARCHIVED_PRIVATE: (chanID: string) => string;
+    CHANNEL_THREADS_ARCHIVED_PRIVATE_USER: (chanID: string) => string;
+    CHANNEL_THREADS_ARCHIVED_PUBLIC: (chanID: string) => string;
+    CHANNEL_TYPING: (chanID: string) => string;
+    CHANNEL_WEBHOOKS: (chanID: string) => string;
+    CHANNELS: string;
+    GATEWAY: string;
+    GATEWAY_BOT: string;
+    GUILD: (guildID: string) => string;
+    GUILD_APPLICATION_COMMAND_PERMISSIONS: (appID: string, guildID: string) => string;
+    GUILD_AUDIT_LOGS: (guildID: string) => string;
+    GUILD_BAN: (guildID: string, memberID: string) => string;
+    GUILD_BANS: (guildID: string) => string;
+    GUILD_CHANNELS: (guildID: string) => string;
+    GUILD_EMOJI: (guildID: string, emojiID: string) => string;
+    GUILD_EMOJIS: (guildID: string) => string;
+    GUILD_INVITES: (guildID: string) => string;
+    GUILD_INTEGRATION: (guildID: string, integrationID: string) => string;
+    GUILD_INTEGRATIONS: (guildID: string) => string;
+    GUILD_MEMBER: (guildID: string, memberID: string) => string;
+    GUILD_MEMBER_NICK: (guildID: string, memberID: string) => string;
+    GUILD_MEMBER_ROLE: (guildID: string, memberID: string, roleID: string) => string;
+    GUILD_MEMBERS: (guildID: string) => string;
+    GUILD_MEMBERS_SEARCH: (guildID: string) => string;
+    GUILD_PREVIEW: (guildID: string) => string;
+    GUILD_PRUNE: (guildID: string) => string;
+    GUILD_ROLE: (guildID: string, roleID: string) => string;
+    GUILD_ROLES: (guildID: string) => string;
+    GUILD_STICKER: (guildID: string, stickerID: string) => string;
+    GUILD_STICKERS: (guildID: string) => string;
+    GUILD_TEMPLATE: (guildID: string, code: string) => string;
+    GUILD_THREADS_ACTIVE: (guildID: string) => string;
+    GUILD_TEMPLATES: (guildID: string) => string;
+    GUILD_VANITY: (guildID: string) => string;
+    GUILD_VOICE_REGIONS: (guildID: string) => string;
+    GUILD_VOICE_STATE_USER: (guildID: string, memberID: string) => string;
+    GUILD_WEBHOOKS: (guildID: string) => string;
+    GUILD_WELCOME_SCREEN: (guildID: string) => string;
+    GUILD_WIDGET: (guildID: string) => string;
+    GUILD_WIDGET_IMAGE: (guildID: string) => string;
+    GUILD_WIDGET_SETTINGS: (guildID: string) => string;
+    GUILDS: string;
+    INTERACTION_CALLBACK: (interactionID: string, token: string) => string;
+    INVITE: (inviteID: string) => string;
+    OAUTH2_APPLICATION: (appID: string) => string;
+    STAGE_INSTANCE_CHANNEL: (chanID: string) => string;
+    STAGE_INSTANCES: string;
+    STICKER: (stickerID: string) => string;
+    TEMPLATE: (code: string) => string;
+    USER: (userID: string) => string;
+    USER_CHANNELS: (userID: string) => string;
+    USER_GUILD: (userID: string, guildID: string) => string;
+    USER_GUILDS: (userID: string) => string;
+    USERS: string;
+    VOICE_REGIONS: string;
+    WEBHOOK: (hookID: string) => string;
+    WEBHOOK_TOKEN: (hookID: string, token: string) => string;
+    WEBHOOK_TOKEN_GITHUB: (hookID: string, token: string) => string;
+    WEBHOOK_TOKEN_MESSAGE: (hookID: string, token: string, msgID: string) => string;
+    WEBHOOK_TOKEN_SLACK: (hookID: string, token: string) => string;
+};
+export = _default;

package/dist/Endpoints.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+/**
+ * Mostly taken from https://github.com/abalabahaha/eris/blob/master/lib/rest/Endpoints.js
+ *
+ * Removed User-only endpoints
+ * @private
+ */
+const Constants_1 = __importDefault(require("./Constants"));
+module.exports = {
+    BASE_URL: "/api/v" + Constants_1.default.REST_API_VERSION,
+    BASE_HOST: "https://discord.com",
+    CDN_URL: "https://cdn.discordapp.com",
+    APPLICATION_COMMAND: (appID, cmdID) => `/applications/${appID}/commands/${cmdID}`,
+    APPLICATION_COMMAND_PERMISSIONS: (appID, guildID, cmdID) => `/applications/${appID}/guilds/${guildID}/commands/${cmdID}/permissions`,
+    APPLICATION_COMMANDS: (appID) => `/applications/${appID}/commands`,
+    APPLICATION_GUILD_COMMAND: (appID, guildID, cmdID) => `/applications/${appID}/guilds/${guildID}/commands/${cmdID}`,
+    APPLICATION_GUILD_COMMANDS: (appID, guildID) => `/applications/${appID}/guilds/${guildID}/commands`,
+    CHANNEL: (chanID) => `/channels/${chanID}`,
+    CHANNEL_BULK_DELETE: (chanID) => `/channels/${chanID}/messages/bulk-delete`,
+    CHANNEL_INVITES: (chanID) => `/channels/${chanID}/invites`,
+    CHANNEL_MESSAGE: (chanID, msgID) => `/channels/${chanID}/messages/${msgID}`,
+    CHANNEL_MESSAGE_CROSSPOST: (chanID, msgID) => `/channels/${chanID}/messages/${msgID}/crosspost`,
+    CHANNEL_MESSAGE_REACTION: (chanID, msgID, reaction) => `/channels/${chanID}/messages/${msgID}/reactions/${reaction}`,
+    CHANNEL_MESSAGE_REACTION_USER: (chanID, msgID, reaction, userID) => `/channels/${chanID}/messages/${msgID}/reactions/${reaction}/${userID}`,
+    CHANNEL_MESSAGE_REACTIONS: (chanID, msgID) => `/channels/${chanID}/messages/${msgID}/reactions`,
+    CHANNEL_MESSAGE_THREADS: (chanID, msgID) => `/channels/${chanID}/messages/${msgID}/threads`,
+    CHANNEL_MESSAGES: (chanID) => `/channels/${chanID}/messages`,
+    CHANNEL_PERMISSION: (chanID, overID) => `/channels/${chanID}/permissions/${overID}`,
+    CHANNEL_PERMISSIONS: (chanID) => `/channels/${chanID}/permissions`,
+    CHANNEL_PIN: (chanID, msgID) => `/channels/${chanID}/pins/${msgID}`,
+    CHANNEL_PINS: (chanID) => `/channels/${chanID}/pins`,
+    CHANNEL_RECIPIENT: (groupID, userID) => `/channels/${groupID}/recipients/${userID}`,
+    CHANNEL_THREADS: (chanID) => `/channels/${chanID}/threads`,
+    CHANNEL_THREAD_MEMBER: (chanID, memberID) => `/channels/${chanID}/thread-members/${memberID}`,
+    CHANNEL_THREAD_MEMBERS: (chanID) => `/channels/${chanID}/thread-members`,
+    CHANNEL_THREADS_ARCHIVED_PRIVATE: (chanID) => `/channels/${chanID}/threads/archived/private`,
+    CHANNEL_THREADS_ARCHIVED_PRIVATE_USER: (chanID) => `/channels/${chanID}/users/@me/threads/archived/private`,
+    CHANNEL_THREADS_ARCHIVED_PUBLIC: (chanID) => `/channels/${chanID}/threads/archived/public`,
+    CHANNEL_TYPING: (chanID) => `/channels/${chanID}/typing`,
+    CHANNEL_WEBHOOKS: (chanID) => `/channels/${chanID}/webhooks`,
+    CHANNELS: "/channels",
+    GATEWAY: "/gateway",
+    GATEWAY_BOT: "/gateway/bot",
+    GUILD: (guildID) => `/guilds/${guildID}`,
+    GUILD_APPLICATION_COMMAND_PERMISSIONS: (appID, guildID) => `/applications/${appID}/guilds/${guildID}/commands/permissions`,
+    GUILD_AUDIT_LOGS: (guildID) => `/guilds/${guildID}/audit-logs`,
+    GUILD_BAN: (guildID, memberID) => `/guilds/${guildID}/bans/${memberID}`,
+    GUILD_BANS: (guildID) => `/guilds/${guildID}/bans`,
+    GUILD_CHANNELS: (guildID) => `/guilds/${guildID}/channels`,
+    GUILD_EMOJI: (guildID, emojiID) => `/guilds/${guildID}/emojis/${emojiID}`,
+    GUILD_EMOJIS: (guildID) => `/guilds/${guildID}/emojis`,
+    GUILD_INVITES: (guildID) => `/guilds/${guildID}/invites`,
+    GUILD_INTEGRATION: (guildID, integrationID) => `/guilds/${guildID}/integrations/${integrationID}`,
+    GUILD_INTEGRATIONS: (guildID) => `/guilds/${guildID}/integrations`,
+    GUILD_MEMBER: (guildID, memberID) => `/guilds/${guildID}/members/${memberID}`,
+    GUILD_MEMBER_NICK: (guildID, memberID) => `/guilds/${guildID}/members/${memberID}/nick`,
+    GUILD_MEMBER_ROLE: (guildID, memberID, roleID) => `/guilds/${guildID}/members/${memberID}/roles/${roleID}`,
+    GUILD_MEMBERS: (guildID) => `/guilds/${guildID}/members`,
+    GUILD_MEMBERS_SEARCH: (guildID) => `/guilds/${guildID}/members/search`,
+    GUILD_PREVIEW: (guildID) => `/guilds/${guildID}/preview`,
+    GUILD_PRUNE: (guildID) => `/guilds/${guildID}/prune`,
+    GUILD_ROLE: (guildID, roleID) => `/guilds/${guildID}/roles/${roleID}`,
+    GUILD_ROLES: (guildID) => `/guilds/${guildID}/roles`,
+    GUILD_STICKER: (guildID, stickerID) => `/guilds/${guildID}/stickers/${stickerID}`,
+    GUILD_STICKERS: (guildID) => `/guilds/${guildID}/stickers`,
+    GUILD_TEMPLATE: (guildID, code) => `/guilds/${guildID}/templates/${code}`,
+    GUILD_THREADS_ACTIVE: (guildID) => `/guilds/${guildID}/threads/active`,
+    GUILD_TEMPLATES: (guildID) => `/guilds/${guildID}/templates`,
+    GUILD_VANITY: (guildID) => `/guilds/${guildID}/vanity-url`,
+    GUILD_VOICE_REGIONS: (guildID) => `/guilds/${guildID}/regions`,
+    GUILD_VOICE_STATE_USER: (guildID, memberID) => `/guilds/${guildID}/voice-states/${memberID}`,
+    GUILD_WEBHOOKS: (guildID) => `/guilds/${guildID}/webhooks`,
+    GUILD_WELCOME_SCREEN: (guildID) => `/guilds/${guildID}/welcome-screen`,
+    GUILD_WIDGET: (guildID) => `/guilds/${guildID}/widget.json`,
+    GUILD_WIDGET_IMAGE: (guildID) => `/guilds/${guildID}/widget.png`,
+    GUILD_WIDGET_SETTINGS: (guildID) => `/guilds/${guildID}/widget`,
+    GUILDS: "/guilds",
+    INTERACTION_CALLBACK: (interactionID, token) => `/interactions/${interactionID}/${token}/callback`,
+    INVITE: (inviteID) => `/invite/${inviteID}`,
+    OAUTH2_APPLICATION: (appID) => `/oauth2/applications/${appID}`,
+    STAGE_INSTANCE_CHANNEL: (chanID) => `/stage-instances/${chanID}`,
+    STAGE_INSTANCES: "/stage-instances",
+    STICKER: (stickerID) => `/stickers/${stickerID}`,
+    TEMPLATE: (code) => `/guilds/templates/${code}`,
+    USER: (userID) => `/users/${userID}`,
+    USER_CHANNELS: (userID) => `/users/${userID}/channels`,
+    USER_GUILD: (userID, guildID) => `/users/${userID}/guilds/${guildID}`,
+    USER_GUILDS: (userID) => `/users/${userID}/guilds`,
+    USERS: "/users",
+    VOICE_REGIONS: "/voice/regions",
+    WEBHOOK: (hookID) => `/webhooks/${hookID}`,
+    WEBHOOK_TOKEN: (hookID, token) => `/webhooks/${hookID}/${token}`,
+    WEBHOOK_TOKEN_GITHUB: (hookID, token) => `/webhooks/${hookID}/${token}/github`,
+    WEBHOOK_TOKEN_MESSAGE: (hookID, token, msgID) => `/webhooks/${hookID}/${token}/messages/${msgID}`,
+    WEBHOOK_TOKEN_SLACK: (hookID, token) => `/webhooks/${hookID}/${token}/slack`,
+};

package/dist/Ratelimiter.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="node" />
+import LocalBucket from "./ratelimitBuckets/LocalBucket";
+/**
+ * Ratelimiter used for handling the ratelimits imposed by the rest api
+ * @protected
+ */
+declare class Ratelimiter {
+    buckets: {
+        [routeKey: string]: LocalBucket;
+    };
+    global: boolean;
+    globalResetAt: number;
+    /**
+     * This is an interval to constantly check Buckets which should be reset or unreferenced from the RateLimiter to be swept by the garbage collector.
+     * This 1 timeout is more performant as compared to potentially many more ticking timers to reset individual bucket remaining values.
+     *
+     * YOU SHOULD NEVER OVERRIDE THIS UNLESS YOU KNOW WHAT YOU'RE DOING. REQUESTS MAY POSSIBLY NEVER EXECUTE WITHOUT THIS AND/OR MEMORY MAY SLOWLY CLIMB OVER TIME.
+     */
+    protected _timeout: NodeJS.Timeout;
+    protected _timeoutFN: () => void;
+    protected _timeoutDuration: number;
+    constructor();
+    /**
+     * Returns a key for saving ratelimits for routes
+     * (Taken from https://github.com/abalabahaha/eris/blob/master/lib/rest/RequestHandler.js) -> I luv u abal <3
+     * @param url url to reduce to a key something like /channels/266277541646434305/messages/266277541646434305/
+     * @param method method of the request, usual http methods like get, etc.
+     * @returns reduced url: /channels/266277541646434305/messages/:id/
+     */
+    routify(url: string, method: string): string;
+    /**
+     * Queue a rest call to be executed
+     * @param fn function to call once the ratelimit is ready
+     * @param url Endpoint of the request
+     * @param method Http method used by the request
+     */
+    queue(fn: (bucket: import("./ratelimitBuckets/LocalBucket")) => any, url: string, method: string): void;
+}
+export = Ratelimiter;

package/dist/Ratelimiter.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const LocalBucket_1 = __importDefault(require("./ratelimitBuckets/LocalBucket"));
+/**
+ * Ratelimiter used for handling the ratelimits imposed by the rest api
+ * @protected
+ */
+class Ratelimiter {
+    constructor() {
+        this.buckets = {};
+        this.global = false;
+        this.globalResetAt = 0;
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const limiter = this;
+        this._timeoutFN = function () {
+            for (const routeKey of Object.keys(limiter.buckets)) {
+                const bkt = limiter.buckets[routeKey];
+                if (bkt.resetAt && bkt.resetAt < Date.now()) {
+                    if (bkt.fnQueue.length)
+                        bkt.resetRemaining();
+                    else
+                        delete limiter.buckets[routeKey];
+                }
+                else if (!bkt.resetAt && limiter.global && limiter.globalResetAt < Date.now()) {
+                    if (bkt.fnQueue.length)
+                        bkt.checkQueue();
+                    else
+                        delete limiter.buckets[routeKey];
+                }
+            }
+        };
+        this._timeoutDuration = 1000;
+        this._timeout = setInterval(() => {
+            limiter._timeoutFN();
+        }, limiter._timeoutDuration);
+    }
+    /**
+     * Returns a key for saving ratelimits for routes
+     * (Taken from https://github.com/abalabahaha/eris/blob/master/lib/rest/RequestHandler.js) -> I luv u abal <3
+     * @param url url to reduce to a key something like /channels/266277541646434305/messages/266277541646434305/
+     * @param method method of the request, usual http methods like get, etc.
+     * @returns reduced url: /channels/266277541646434305/messages/:id/
+     */
+    routify(url, method) {
+        let route = url.replace(/\/([a-z-]+)\/(?:\d+)/g, function (match, p) {
+            return p === "channels" || p === "guilds" || p === "webhooks" ? match : `/${p}/:id`;
+        }).replace(/\/reactions\/[^/]+/g, "/reactions/:id").replace(/^\/webhooks\/(\d+)\/[A-Za-z0-9-_]{64,}/, "/webhooks/$1/:token");
+        if (method.toUpperCase() === "DELETE" && route.endsWith("/messages/:id")) { // Delete Messsage endpoint has its own ratelimit
+            route = method + route;
+        }
+        return route;
+    }
+    /**
+     * Queue a rest call to be executed
+     * @param fn function to call once the ratelimit is ready
+     * @param url Endpoint of the request
+     * @param method Http method used by the request
+     */
+    queue(fn, url, method) {
+        const routeKey = this.routify(url, method);
+        if (!this.buckets[routeKey]) {
+            this.buckets[routeKey] = new LocalBucket_1.default(this);
+        }
+        this.buckets[routeKey].queue(fn);
+    }
+}
+module.exports = Ratelimiter;

package/dist/RequestHandler.d.ts

@@ -0,0 +1,112 @@
+/// <reference types="node" />
+import { EventEmitter } from "events";
+import c from "centra";
+declare type HTTPMethod = "get" | "post" | "patch" | "head" | "put" | "delete" | "connect" | "options" | "trace";
+declare class DiscordAPIError extends Error {
+    method: HTTPMethod;
+    path: string;
+    code: number;
+    httpStatus: number;
+    constructor(path: string, error: any, method: HTTPMethod, status: number);
+    static flattenErrors(obj: Record<string, any>, key?: string): string[];
+}
+interface HandlerEvents {
+    request: [string, {
+        endpoint: string;
+        method: HTTPMethod;
+        dataType: "json" | "multipart";
+        data: any;
+    }];
+    done: [string, c.Response];
+    requestError: [string, Error];
+    rateLimit: [{
+        timeout: number;
+        limit: number;
+        method: HTTPMethod;
+        path: string;
+        route: string;
+    }];
+}
+interface RequestHandler {
+    addListener<E extends keyof HandlerEvents>(event: E, listener: (...args: HandlerEvents[E]) => any): this;
+    emit<E extends keyof HandlerEvents>(event: E, ...args: HandlerEvents[E]): boolean;
+    eventNames(): Array<keyof HandlerEvents>;
+    listenerCount(event: keyof HandlerEvents): number;
+    listeners(event: keyof HandlerEvents): Array<(...args: Array<any>) => any>;
+    off<E extends keyof HandlerEvents>(event: E, listener: (...args: HandlerEvents[E]) => any): this;
+    on<E extends keyof HandlerEvents>(event: E, listener: (...args: HandlerEvents[E]) => any): this;
+    once<E extends keyof HandlerEvents>(event: E, listener: (...args: HandlerEvents[E]) => any): this;
+    prependListener<E extends keyof HandlerEvents>(event: E, listener: (...args: HandlerEvents[E]) => any): this;
+    prependOnceListener<E extends keyof HandlerEvents>(event: E, listener: (...args: HandlerEvents[E]) => any): this;
+    rawListeners(event: keyof HandlerEvents): Array<(...args: Array<any>) => any>;
+    removeAllListeners(event?: keyof HandlerEvents): this;
+    removeListener<E extends keyof HandlerEvents>(event: E, listener: (...args: HandlerEvents[E]) => any): this;
+}
+/**
+ * Request Handler class
+ */
+declare class RequestHandler extends EventEmitter {
+    ratelimiter: import("./Ratelimiter");
+    options: {
+        baseHost: string;
+        baseURL: string;
+        headers: {
+            Authorization: string;
+            "User-Agent": string;
+        };
+    };
+    latency: number;
+    apiURL: string;
+    static DiscordAPIErrror: typeof DiscordAPIError;
+    /**
+     * Create a new request handler
+     * @param ratelimiter ratelimiter to use for ratelimiting requests
+     * @param options options
+     */
+    constructor(ratelimiter: import("./Ratelimiter"), options: {
+        token: string;
+        baseHost: string;
+    });
+    /**
+     * Request a route from the discord api
+     * @param endpoint endpoint to request
+     * @param method http method to use
+     * @param dataType type of the data being sent
+     * @param data data to send, if any
+     * @param amount amount of requests previously executed
+     * @returns Result of the request
+     */
+    request(endpoint: string, method: HTTPMethod, dataType?: "json" | "multipart", data?: any | undefined, amount?: number): Promise<any>;
+    /**
+     * Calculate the time difference between the local server and discord
+     * @param dateHeader Date header value returned by discord
+     * @returns Offset in milliseconds
+     */
+    private _getOffsetDateFromHeader;
+    /**
+     * Apply the received ratelimit headers to the ratelimit bucket
+     * @param bkt Ratelimit bucket to apply the headers to
+     * @param headers Http headers received from discord
+     * @param offsetDate Unix timestamp of the current date + offset to discord time
+     * @param reactions Whether to use reaction ratelimits (1/250ms)
+     */
+    private _applyRatelimitHeaders;
+    /**
+     * Execute a normal json request
+     * @param endpoint Endpoint to use
+     * @param data Data to send
+     * @param useParams Whether to send the data in the body or use query params
+     * @param amount amount of requests previously executed
+     * @returns Result of the request
+     */
+    private _request;
+    /**
+     * Execute a multipart/form-data request
+     * @param endpoint Endpoint to use
+     * @param method Http Method to use
+     * @param data data to send
+     * @returns Result of the request
+     */
+    private _multiPartRequest;
+}
+export = RequestHandler;