snowtransfer 0.9.0 → 0.10.0

package/README.md

@@ -1,7 +1,7 @@
 # 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)
+[![GitHub stars](https://img.shields.io/github/stars/DasWolke/SnowTransfer.svg)](https://github.com/DasWolke/SnowTransfer/stargazers) [![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
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'events';
-import { FormData, Response, File } from 'undici';
+import { Response, FormData, File } from 'undici';
 import { RESTGetAPIAuditLogQuery, RESTGetAPIAuditLogResult, RESTGetAPIAutoModerationRulesResult, RESTGetAPIAutoModerationRuleResult, RESTPostAPIAutoModerationRuleJSONBody, RESTPostAPIAutoModerationRuleResult, RESTPatchAPIAutoModerationRuleJSONBody, RESTPatchAPIAutoModerationRuleResult, RESTDeleteAPIAutoModerationRuleResult, RESTGetAPIGatewayResult, RESTGetAPIGatewayBotResult, RESTGetAPIChannelResult, RESTPatchAPIChannelJSONBody, RESTPatchAPIChannelResult, APIThreadChannel, RESTDeleteAPIChannelResult, RESTGetAPIChannelMessagesQuery, RESTGetAPIChannelMessagesResult, RESTGetAPIChannelMessageResult, RESTPostAPIChannelMessageJSONBody, RESTPostAPIChannelMessageResult, RESTPostAPIChannelMessageCrosspostResult, RESTPutAPIChannelMessageReactionResult, RESTDeleteAPIChannelMessageUserReactionResult, RESTDeleteAPIChannelMessageReactionResult, RESTGetAPIChannelMessageReactionUsersQuery, RESTGetAPIChannelMessageReactionUsersResult, RESTDeleteAPIChannelAllMessageReactionsResult, RESTPatchAPIChannelMessageJSONBody, RESTPatchAPIChannelMessageResult, RESTDeleteAPIChannelMessageResult, RESTPostAPIChannelMessagesBulkDeleteResult, RESTPutAPIChannelPermissionJSONBody, RESTPutAPIChannelPermissionResult, RESTGetAPIChannelInvitesResult, RESTPostAPIChannelInviteJSONBody, RESTPostAPIChannelInviteResult, RESTDeleteAPIChannelPermissionResult, RESTPostAPIChannelFollowersResult, RESTPostAPIChannelTypingResult, RESTGetAPIChannelPinsResult, RESTPutAPIChannelPinResult, RESTDeleteAPIChannelPinResult, RESTPostAPIChannelMessagesThreadsJSONBody, RESTPostAPIChannelMessagesThreadsResult, RESTPostAPIChannelThreadsJSONBody, APITextBasedChannel, ChannelType, RESTPutAPIChannelThreadMembersResult, RESTDeleteAPIChannelThreadMembersResult, RESTGetAPIChannelThreadMemberResult, RESTGetAPIChannelThreadMembersQuery, RESTGetAPIChannelThreadMembersResult, RESTGetAPIChannelThreadsArchivedQuery, RESTGetAPIChannelThreadsArchivedPublicResult, RESTGetAPIChannelThreadsArchivedPrivateResult, RESTGetAPIChannelUsersThreadsArchivedResult, RESTGetAPIGuildEmojisResult, RESTGetAPIGuildEmojiResult, RESTPostAPIGuildEmojiJSONBody, RESTPostAPIGuildEmojiResult, RESTPatchAPIGuildEmojiJSONBody, RESTPatchAPIGuildEmojiResult, RESTDeleteAPIGuildEmojiResult, RESTGetAPIStickerResult, RESTGetAPIGuildStickersResult, RESTGetAPIGuildStickerResult, RESTPostAPIGuildStickerFormDataBody, RESTPostAPIGuildStickerResult, RESTPatchAPIGuildStickerJSONBody, RESTPatchAPIGuildStickerResult, RESTDeleteAPIGuildStickerResult, RESTPostAPIGuildsJSONBody, RESTPostAPIGuildsResult, RESTGetAPIGuildResult, RESTGetAPIGuildPreviewResult, RESTPatchAPIGuildJSONBody, RESTPatchAPIGuildResult, RESTDeleteAPIGuildResult, RESTGetAPIGuildChannelsResult, RESTPostAPIGuildChannelJSONBody, RESTPostAPIGuildChannelResult, RESTPatchAPIGuildChannelPositionsJSONBody, RESTPatchAPIGuildChannelPositionsResult, RESTGetAPIGuildThreadsResult, RESTGetAPIGuildMemberResult, RESTGetAPIGuildMembersQuery, RESTGetAPIGuildMembersResult, RESTGetAPIGuildMembersSearchQuery, RESTGetAPIGuildMembersSearchResult, RESTPutAPIGuildMemberJSONBody, RESTPutAPIGuildMemberResult, RESTPatchAPIGuildMemberJSONBody, RESTPatchAPIGuildMemberResult, RESTPatchAPICurrentGuildMemberJSONBody, APIGuildMember, RESTPutAPIGuildMemberRoleResult, RESTDeleteAPIGuildMemberRoleResult, RESTDeleteAPIGuildMemberResult, RESTGetAPIGuildBansQuery, RESTGetAPIGuildBansResult, RESTGetAPIGuildBanResult, RESTPutAPIGuildBanJSONBody, RESTPutAPIGuildBanResult, RESTDeleteAPIGuildBanResult, RESTGetAPIGuildRolesResult, RESTPostAPIGuildRoleJSONBody, RESTPostAPIGuildRoleResult, RESTPatchAPIGuildRolePositionsJSONBody, RESTPatchAPIGuildRolePositionsResult, RESTPatchAPIGuildRoleJSONBody, RESTPatchAPIGuildRoleResult, RESTDeleteAPIGuildRoleResult, RESTGetAPIGuildPruneCountQuery, RESTGetAPIGuildPruneCountResult, RESTPostAPIGuildPruneJSONBody, RESTPostAPIGuildPruneResult, RESTGetAPIGuildVoiceRegionsResult, RESTGetAPIGuildInvitesResult, RESTGetAPIGuildIntegrationsResult, RESTDeleteAPIGuildIntegrationResult, RESTGetAPIGuildWidgetSettingsResult, RESTPatchAPIGuildWidgetSettingsJSONBody, RESTPatchAPIGuildWidgetSettingsResult, APIGuildWidget, RESTGetAPIGuildVanityUrlResult, RESTGetAPIGuildWelcomeScreenResult, RESTPatchAPIGuildWelcomeScreenJSONBody, RESTPatchAPIGuildWelcomeScreenResult, RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody, RESTPatchAPIGuildVoiceStateCurrentMemberResult, RESTPatchAPIGuildVoiceStateUserJSONBody, RESTPatchAPIGuildVoiceStateUserResult, RESTGetAPIGuildScheduledEventsResult, RESTPostAPIGuildScheduledEventJSONBody, RESTPostAPIGuildScheduledEventResult, RESTGetAPIGuildScheduledEventResult, RESTPatchAPIGuildScheduledEventJSONBody, RESTPatchAPIGuildScheduledEventResult, RESTDeleteAPIGuildScheduledEventResult, RESTGetAPIGuildScheduledEventUsersQuery, RESTGetAPIGuildScheduledEventUsersResult, RESTGetAPITemplateResult, RESTPostAPITemplateCreateGuildJSONBody, RESTPostAPITemplateCreateGuildResult, RESTGetAPIGuildTemplatesResult, RESTPostAPIGuildTemplatesJSONBody, RESTPostAPIGuildTemplatesResult, RESTPutAPIGuildTemplateSyncResult, RESTPatchAPIGuildTemplateJSONBody, RESTPatchAPIGuildTemplateResult, RESTDeleteAPIGuildTemplateResult, RESTPostAPIChannelWebhookJSONBody, RESTPostAPIChannelWebhookResult, RESTGetAPIChannelWebhooksResult, RESTGetAPIGuildWebhooksResult, RESTGetAPIWebhookResult, RESTPatchAPIWebhookWithTokenJSONBody, RESTPatchAPIWebhookWithTokenResult, RESTPatchAPIWebhookJSONBody, RESTPatchAPIWebhookResult, RESTDeleteAPIWebhookResult, RESTPostAPIWebhookWithTokenJSONBody, RESTPostAPIWebhookWithTokenQuery, RESTPostAPIWebhookWithTokenResult, RESTPostAPIWebhookWithTokenWaitResult, RESTPostAPIWebhookWithTokenSlackQuery, RESTPostAPIWebhookWithTokenSlackResult, RESTPostAPIWebhookWithTokenSlackWaitResult, RESTPostAPIWebhookWithTokenGitHubQuery, RESTPostAPIWebhookWithTokenGitHubResult, RESTPostAPIWebhookWithTokenGitHubWaitResult, RESTGetAPIWebhookWithTokenMessageResult, RESTPatchAPIWebhookWithTokenMessageJSONBody, RESTPatchAPIWebhookWithTokenMessageResult, RESTDeleteAPIWebhookWithTokenMessageResult, RESTGetAPIApplicationCommandsResult, RESTPostAPIApplicationCommandsJSONBody, RESTPostAPIApplicationCommandsResult, RESTGetAPIApplicationCommandResult, RESTPatchAPIApplicationCommandJSONBody, RESTPatchAPIApplicationCommandResult, RESTPutAPIApplicationCommandsJSONBody, RESTPutAPIApplicationCommandsResult, RESTGetAPIApplicationGuildCommandsResult, RESTPostAPIApplicationGuildCommandsJSONBody, RESTPostAPIApplicationGuildCommandsResult, RESTGetAPIApplicationGuildCommandResult, RESTPatchAPIApplicationGuildCommandJSONBody, RESTPatchAPIApplicationGuildCommandResult, RESTPutAPIApplicationGuildCommandsJSONBody, RESTPutAPIApplicationGuildCommandsResult, RESTGetAPIApplicationCommandPermissionsResult, RESTPutAPIApplicationCommandPermissionsJSONBody, RESTPutAPIApplicationCommandPermissionsResult, RESTPostAPIInteractionCallbackJSONBody, RESTGetAPIInteractionOriginalResponseResult, RESTPatchAPIInteractionOriginalResponseJSONBody, RESTPatchAPIInteractionOriginalResponseResult, RESTDeleteAPIInteractionOriginalResponseResult, RESTPostAPIInteractionFollowupJSONBody, RESTPostAPIInteractionFollowupResult, RESTGetAPIInteractionFollowupResult, RESTPatchAPIInteractionFollowupJSONBody, RESTPatchAPIInteractionFollowupResult, RESTDeleteAPIInteractionFollowupResult, RESTGetAPIInviteQuery, RESTGetAPIInviteResult, RESTDeleteAPIInviteResult, RESTPostAPIStageInstanceJSONBody, RESTPostAPIStageInstanceResult, RESTGetAPIStageInstanceResult, RESTPatchAPIStageInstanceJSONBody, RESTPatchAPIStageInstanceResult, RESTDeleteAPIStageInstanceResult, RESTGetAPICurrentUserResult, RESTGetAPIUserResult, RESTPatchAPICurrentUserJSONBody, RESTPatchAPICurrentUserResult, RESTGetAPICurrentUserGuildsQuery, RESTGetAPICurrentUserGuildsResult, RESTDeleteAPICurrentUserGuildResult, RESTPostAPICurrentUserCreateDMChannelResult, RESTGetAPICurrentUserConnectionsResult, RESTGetAPICurrentUserApplicationRoleConnectionResult, RESTPutAPICurrentUserApplicationRoleConnectionJSONBody, RESTPutAPICurrentUserApplicationRoleConnectionResult, RESTGetAPIVoiceRegionsResult } from 'discord-api-types/v10';
 import { Readable } from 'stream';
 import { ReadableStream } from 'stream/web';
@@ -20,12 +20,12 @@ declare class DiscordAPIError extends Error {
  * Ratelimiter used for handling the ratelimits imposed by the rest api
  * @protected
  */
-declare class Ratelimiter {
+declare class Ratelimiter<B extends typeof GlobalBucket = typeof GlobalBucket> {
     /**
      * An object of Buckets that store rate limit info
      */
     buckets: {
-        [routeKey: string]: LocalBucket;
+        [routeKey: string]: InstanceType<B>;
     };
     /**
      * If you're being globally rate limited
@@ -39,6 +39,10 @@ declare class Ratelimiter {
      * Timeout that resets the global ratelimit once the timeframe has passed
      */
     globalResetTimeout: NodeJS.Timeout | null;
+    /**
+     * The constructor function to call new on when creating buckets to cache and use
+     */
+    BucketConstructor: B;
     /**
      * If you're being globally rate limited
      */
@@ -61,44 +65,34 @@ declare class Ratelimiter {
      * @param url Endpoint of the request
      * @param method Http method used by the request
      */
-    queue(fn: (bucket: LocalBucket) => any, url: string, method: string): void;
+    queue(fn: (bucket: InstanceType<B>) => any, url: string, method: string): void;
 }
 /**
  * Bucket used for saving ratelimits
  * @protected
  */
 declare class LocalBucket {
-    ratelimiter: Ratelimiter;
-    routeKey: string;
-    /**
-     * array of functions waiting to be executed
-     */
-    fnQueue: Array<{
-        fn: (...args: Array<any>) => any;
-        callback: () => any;
-    }>;
-    /**
-     * Number of functions that may be executed during the timeframe set in limitReset
-     */
     limit: number;
+    reset: number;
     /**
      * Remaining amount of executions during the current timeframe
      */
     remaining: number;
     /**
-     * Timeframe in milliseconds until the ratelimit resets
+     * array of functions waiting to be executed
      */
-    reset: number;
+    fnQueue: Array<() => any>;
     /**
      * Timeout that calls the reset function once the timeframe passed
      */
     resetTimeout: NodeJS.Timeout | null;
     /**
-     * Create a new bucket
-     * @param ratelimiter ratelimiter used for ratelimiting requests
-     * @param routeKey Key used internally to routify requests. Assigned by ratelimiter
+     * Create a new base bucket
+     * @param limit Number of functions that may be executed during the timeframe set in reset
+     * @param reset Timeframe in milliseconds until the ratelimit resets after first
+     * @param remaining Remaining amount of executions during the current timeframe
      */
-    constructor(ratelimiter: Ratelimiter, routeKey: string);
+    constructor(limit?: number, reset?: number, remaining?: number);
     /**
      * Queue a function to be executed
      * @param fn function to be executed
@@ -113,12 +107,34 @@ declare class LocalBucket {
     /**
      * Reset the remaining tokens to the base limit
      */
-    private resetRemaining;
+    resetRemaining(): void;
     /**
      * Clear the current queue of events to be sent
      */
     dropQueue(): void;
 }
+/**
+ * Extended bucket that respects global ratelimits
+ * @protected
+ */
+declare class GlobalBucket extends LocalBucket {
+    ratelimiter: Ratelimiter;
+    routeKey: string;
+    /**
+     * Create a new bucket that respects global rate limits
+     * @param ratelimiter ratelimiter used for ratelimiting requests. Assigned by ratelimiter
+     * @param routeKey Key used internally to routify requests. Assigned by ratelimiter
+     */
+    constructor(ratelimiter: Ratelimiter, routeKey: string);
+    /**
+     * Check if there are any functions in the queue that haven't been executed yet
+     */
+    checkQueue(): void;
+    /**
+     * Reset the remaining tokens to the base limit
+     */
+    resetRemaining(): void;
+}
 type HandlerEvents = {
     request: [string, {
         endpoint: string;
@@ -213,21 +229,18 @@ declare class RequestHandler extends EventEmitter {
 
 type ___RequestHandler_DiscordAPIError = DiscordAPIError;
 declare const ___RequestHandler_DiscordAPIError: typeof DiscordAPIError;
+type ___RequestHandler_GlobalBucket = GlobalBucket;
+declare const ___RequestHandler_GlobalBucket: typeof GlobalBucket;
 type ___RequestHandler_HTTPMethod = HTTPMethod;
+type ___RequestHandler_HandlerEvents = HandlerEvents;
 type ___RequestHandler_LocalBucket = LocalBucket;
 declare const ___RequestHandler_LocalBucket: typeof LocalBucket;
-type ___RequestHandler_Ratelimiter = Ratelimiter;
+type ___RequestHandler_Ratelimiter<B extends typeof GlobalBucket = typeof GlobalBucket> = Ratelimiter<B>;
 declare const ___RequestHandler_Ratelimiter: typeof Ratelimiter;
 type ___RequestHandler_RequestHandler = RequestHandler;
 declare const ___RequestHandler_RequestHandler: typeof RequestHandler;
 declare namespace ___RequestHandler {
-  export {
-    ___RequestHandler_DiscordAPIError as DiscordAPIError,
-    ___RequestHandler_HTTPMethod as HTTPMethod,
-    ___RequestHandler_LocalBucket as LocalBucket,
-    ___RequestHandler_Ratelimiter as Ratelimiter,
-    ___RequestHandler_RequestHandler as RequestHandler,
-  };
+  export { ___RequestHandler_DiscordAPIError as DiscordAPIError, ___RequestHandler_GlobalBucket as GlobalBucket, type ___RequestHandler_HTTPMethod as HTTPMethod, type ___RequestHandler_HandlerEvents as HandlerEvents, ___RequestHandler_LocalBucket as LocalBucket, ___RequestHandler_Ratelimiter as Ratelimiter, ___RequestHandler_RequestHandler as RequestHandler };
 }
 
 /**
@@ -247,7 +260,7 @@ declare class AuditLogMethods {
     /**
      * Get the audit logs of the specified guild id
      * @param guildId id of a guild
-     * @param data optional audit log filter values
+     * @param options optional audit log filter values
      * @returns An object with [audit log data](https://discord.com/developers/docs/resources/audit-log#audit-log-object)
      *
      * | Permissions needed | Condition |
@@ -263,7 +276,7 @@ declare class AuditLogMethods {
      * }
      * const channel = await client.auditLog.getAuditLog("guild id", data)
      */
-    getAuditLog(guildId: string, data?: RESTGetAPIAuditLogQuery): Promise<RESTGetAPIAuditLogResult>;
+    getAuditLog(guildId: string, options?: RESTGetAPIAuditLogQuery): Promise<RESTGetAPIAuditLogResult>;
 }
 
 /**
@@ -501,6 +514,7 @@ declare class ChannelMethods {
     /**
      * Get a list of messages from a channel
      * @param channelId Id of the channel
+     * @param options Options for getting channel messages
      * @returns Array of [discord message](https://discord.com/developers/docs/resources/channel#message-object) objects
      *
      * | Permissions needed   | Condition                                                                        |
@@ -538,9 +552,10 @@ declare class ChannelMethods {
      * Creates a new Message within a channel or thread
      *
      * **Make sure to use a filename with a proper extension (e.g. png, jpeg, etc.) when you want to upload files**
-     * @param channelId Id of the Channel or thread to sent a message to
+     * @param channelId Id of the Channel or thread to send a message to
      * @param data Data to send, if data is a string it will be used as the content of the message,
      * if data is not a string you should take a look at the properties below to know what you may send
+     * @param options Options for sending this message
      * @returns [discord message](https://discord.com/developers/docs/resources/channel#message-object) object
      *
      * | Permissions needed       | Condition                                                     |
@@ -584,6 +599,29 @@ declare class ChannelMethods {
     }, options?: {
         disableEveryone?: boolean;
     }): Promise<RESTPostAPIChannelMessageResult>;
+    /**
+     * Creates a new voice Message within a channel or thread
+     * @param channelId Id of the Channel or thread to send a message to
+     * @param data Buffer of the audio file to send. Tested file types are ogg, mp3, m4a, wav, flac. Other file types work, but some can only be embedded on mobile. Try it and see:tm:
+     * @param audioDurationSeconds The duration of the audio file in seconds
+     * @param waveform A preview of the entire voice message, with 1 byte per datapoint encoded in base64. Clients sample the recording at most once per 100 milliseconds, but will downsample so that no more than 256 datapoints are in the waveform. If you have no clue what you're doing, leave this as an empty string
+     * @returns non editable [discord message](https://discord.com/developers/docs/resources/channel#message-object) object
+     *
+     * | Permissions needed       | Condition                                                     |
+     * |--------------------------|---------------------------------------------------------------|
+     * | VIEW_CHANNEL             | if channel is not a DM channel                                |
+     * | READ_MESSAGE_HISTORY     | if channel is not a DM channel and message is a reply         |
+     * | SEND_MESSAGES            | if channel is not a DM channel and if channel is not a thread |
+     * | SEND_MESSAGES_IN_THREADS | if channel is a thread                                        |
+     *
+     * @example
+     * // Send a voice message that has a duration of 6 seconds
+     * const client = new SnowTransfer("TOKEN")
+     * // fileData will be a buffer with the data of the ogg audio
+     * const fileData = fs.readFileSync("6-second-long-audio.ogg") // You should probably use fs.promises.readFile, since it is asynchronous, synchronous methods block the thread.
+     * client.channel.createVoiceMessage("channel id", fileData, 6)
+     */
+    createVoiceMessage(channelId: string, data: Buffer, audioDurationSeconds: number, waveform?: string): Promise<RESTPostAPIChannelMessageResult>;
     /**
      * Crosspost a message in a news channel to all following channels
      * @param channelId Id of the news channel
@@ -683,7 +721,7 @@ declare class ChannelMethods {
      * @param channelId Id of the channel
      * @param messageId Id of the message
      * @param emoji reaction emoji
-     * @param query Options for getting users
+     * @param options Options for getting users
      * @returns Array of [user objects](https://discord.com/developers/docs/resources/user#user-object)
      *
      * | Permissions needed   | Condition                      |
@@ -696,7 +734,7 @@ declare class ChannelMethods {
      * const client = new SnowTransfer("TOKEN")
      * const reactions = await client.channel.getReactions("channel Id", "message Id", encodeURIComponent("awooo:322522663304036352"))
      */
-    getReactions(channelId: string, messageId: string, emoji: string, query?: RESTGetAPIChannelMessageReactionUsersQuery): Promise<RESTGetAPIChannelMessageReactionUsersResult>;
+    getReactions(channelId: string, messageId: string, emoji: string, options?: RESTGetAPIChannelMessageReactionUsersQuery): Promise<RESTGetAPIChannelMessageReactionUsersResult>;
     /**
      * Delete all reactions from a message in a guild channel
      * @param channelId Id of the guild channel
@@ -719,6 +757,7 @@ declare class ChannelMethods {
      * @param channelId Id of the channel
      * @param messageId Id of the message
      * @param data Data to send
+     * @param options Options for editing this message
      * @returns [discord message](https://discord.com/developers/docs/resources/channel#message-object) object
      *
      * | Permissions needed | Condition                                        |
@@ -1067,6 +1106,7 @@ declare class ChannelMethods {
     /**
      * Gets all members within a thread
      * @param channelId Id of the Thread
+     * @param options Options for getting members
      * @returns Array of [thread members](https://discord.com/developers/docs/resources/channel#thread-member-object)
      *
      * | Permissions needed           | Condition |
@@ -1081,10 +1121,11 @@ declare class ChannelMethods {
      * const client = new SnowTransfer("TOKEN")
      * const members = await client.channel.getThreadMembers("thread id")
      */
-    getThreadMembers(channelId: string, query?: RESTGetAPIChannelThreadMembersQuery): Promise<RESTGetAPIChannelThreadMembersResult>;
+    getThreadMembers(channelId: string, options?: RESTGetAPIChannelThreadMembersQuery): Promise<RESTGetAPIChannelThreadMembersResult>;
     /**
      * Gets all threads that are public and archived within a guild channel
      * @param channelId Id of the guild channel
+     * @param options Options for getting threads
      * @returns Object containing [public threads](https://discord.com/developers/docs/resources/channel#channel-object), [thread members](https://discord.com/developers/docs/resources/channel#thread-member-object) of the CurrentUser, and if there are more results in the pagination
      *
      * | Permissions needed          | Condition |
@@ -1096,12 +1137,13 @@ declare class ChannelMethods {
      * const client = new SnowTransfer("TOKEN")
      * const result = await client.channel.getChannelArchivedPublicThreads("channel id")
      */
-    getChannelArchivedPublicThreads(channelId: string, query?: RESTGetAPIChannelThreadsArchivedQuery): Promise<RESTGetAPIChannelThreadsArchivedPublicResult>;
+    getChannelArchivedPublicThreads(channelId: string, options?: RESTGetAPIChannelThreadsArchivedQuery): Promise<RESTGetAPIChannelThreadsArchivedPublicResult>;
     /**
      * Gets all threads that are private and archived within a guild channel
      *
      * CurrentUser must be a member of the thread if they do not have MANAGE_THREADS permissions
      * @param channelId Id of the Channel
+     * @param options Options for getting threads
      * @returns Object containing [private threads](https://discord.com/developers/docs/resources/channel#channel-object), [thread members](https://discord.com/developers/docs/resources/channel#thread-member-object) of the CurrentUser, and if there are more results in the pagination
      *
      * | Permissions needed          | Condition                            |
@@ -1114,12 +1156,13 @@ declare class ChannelMethods {
      * const client = new SnowTransfer("TOKEN")
      * const result = await client.channel.getChannelArchivedPrivateThreads("channel id")
      */
-    getChannelArchivedPrivateThreads(channelId: string, query?: RESTGetAPIChannelThreadsArchivedQuery): Promise<RESTGetAPIChannelThreadsArchivedPrivateResult>;
+    getChannelArchivedPrivateThreads(channelId: string, options?: RESTGetAPIChannelThreadsArchivedQuery): Promise<RESTGetAPIChannelThreadsArchivedPrivateResult>;
     /**
      * Gets all threads that are private and archived within a guild channel that the CurrentUser is apart of
      *
      * CurrentUser must be a member of the thread if they do not have MANAGE_THREADS permissions
      * @param channelId Id of the Channel
+     * @param options Option for getting threads
      * @returns Object containing [private threads](https://discord.com/developers/docs/resources/channel#channel-object), [thread members](https://discord.com/developers/docs/resources/channel#thread-member-object) of the CurrentUser, and if there are more results in the pagination
      *
      * | Permissions needed                | Condition                                  |
@@ -1130,7 +1173,7 @@ declare class ChannelMethods {
      * const client = new SnowTransfer("TOKEN")
      * const result = await client.channel.getChannelArchivedPrivateThreadsUser("channel id")
      */
-    getChannelArchivedPrivateThreadsUser(channelId: string, query?: RESTGetAPIChannelThreadsArchivedQuery): Promise<RESTGetAPIChannelUsersThreadsArchivedResult>;
+    getChannelArchivedPrivateThreadsUser(channelId: string, options?: RESTGetAPIChannelThreadsArchivedQuery): Promise<RESTGetAPIChannelUsersThreadsArchivedResult>;
 }
 
 /**
@@ -1322,6 +1365,7 @@ declare class GuildAssetsMethods {
      * Delete a guild sticker
      * @param guildId Id of the guild
      * @param stickerId Id of the sticker
+     * @param reason Reason for deleting the sticker
      * @returns Resolves the Promise on successful execution
      *
      * | Permissions needed         | Condition |
@@ -1460,6 +1504,7 @@ declare class GuildMethods {
      * Batch update the positions of channels. Only those being moved needs to be included here
      * @param guildId Id of the guild
      * @param data Positional data to send
+     * @param reason Reason for updating the channels' positions
      * @returns Resolves the Promise on successful execution
      *
      * | Permissions needed | Condition |
@@ -1469,7 +1514,7 @@ declare class GuildMethods {
      * @example
      * // Sets the position of a channel to 2 under a category channel
      * const client = new SnowTransfer("TOKEN")
-     * client.guild.updateChannelPositions("guild id", [{ id: "channel id", position: 2, category_id: "category id" }], "they looked out of order")
+     * client.guild.updateChannelPositions("guild id", [{ id: "channel id", position: 2, parent_id: "category id" }], "they looked out of order")
      */
     updateChannelPositions(guildId: string, data: RESTPatchAPIGuildChannelPositionsJSONBody, reason?: string): Promise<RESTPatchAPIGuildChannelPositionsResult>;
     /**
@@ -1500,7 +1545,7 @@ declare class GuildMethods {
      *
      * CurrentUser must be a member of the guild
      * @param guildId Id of the guild
-     * @param data query data
+     * @param options query data
      * @returns list of [guild members](https://discord.com/developers/docs/resources/guild#guild-member-object-guild-member-structure)
      *
      * | Intents       |
@@ -1512,7 +1557,7 @@ declare class GuildMethods {
      * const client = new SnowTransfer("TOKEN")
      * const members = await client.guild.getGuildMembers("guild id", { limit: 10 })
      */
-    getGuildMembers(guildId: string, data?: RESTGetAPIGuildMembersQuery): Promise<RESTGetAPIGuildMembersResult>;
+    getGuildMembers(guildId: string, options?: RESTGetAPIGuildMembersQuery): Promise<RESTGetAPIGuildMembersResult>;
     /**
      * Get a list of guild members that match a query
      * @param guildId Id of the guild
@@ -1621,7 +1666,7 @@ declare class GuildMethods {
      * @param guildId Id of the guild
      * @param memberId Id of the guild member
      * @param roleId Id of the role
-     * @param data object with reason property
+     * @param reason The reason for the role to be removed
      * @returns Resolves the Promise on successful execution
      *
      * | Permissions needed | Condition |
@@ -1654,7 +1699,7 @@ declare class GuildMethods {
     /**
      * Get bans of a guild
      * @param guildId Id of the guild
-     * @param query Query string options
+     * @param options Query string options
      * @returns List of [bans](https://discord.com/developers/docs/resources/guild#ban-object-ban-structure)
      *
      * | Permissions needed | Condition |
@@ -1763,6 +1808,7 @@ declare class GuildMethods {
      * Modify the positions of roles
      * @param guildId Id of the guild
      * @param data Role data to update
+     * @param reason Reason for moving the roles
      * @returns array of [roles](https://discord.com/developers/docs/topics/permissions#role-object)
      *
      * | Permissions needed | Condition |
@@ -1813,7 +1859,7 @@ declare class GuildMethods {
     /**
      * Get the amount of members that would be pruned when a prune with the passed amount of days would be started
      * @param guildId Id of the guild
-     * @param data Object with prune data
+     * @param options Object with prune data
      * @returns Object with a "pruned" key indicating the amount of members that would be pruned
      *
      * | Permissions needed | Condition |
@@ -1824,7 +1870,7 @@ declare class GuildMethods {
      * const client = new SnowTransfer("TOKEN")
      * const data = await client.guild.getGuildPruneCount("guildId", { days: 7 })
      */
-    getGuildPruneCount(guildId: string, query?: RESTGetAPIGuildPruneCountQuery): Promise<RESTGetAPIGuildPruneCountResult>;
+    getGuildPruneCount(guildId: string, options?: RESTGetAPIGuildPruneCountQuery): Promise<RESTGetAPIGuildPruneCountResult>;
     /**
      * Start a prune
      * @param guildId Id of the guild
@@ -1893,6 +1939,7 @@ declare class GuildMethods {
      * Delete a guild integration
      * @param guildId Id of the guild
      * @param integrationId Id of the integration
+     * @param reason Reason for removing the integration
      * @returns Resolves the Promise on successful execution
      *
      * | Permissions needed | Condition |
@@ -2012,6 +2059,7 @@ declare class GuildMethods {
     /**
      * Updates a user's voice state in a stage channel
      * @param guildId Id of the guild
+     * @param userId Id of the user
      * @param data Data of the voice state
      * @returns Resolves the Promise on successful execution
      *
@@ -2151,7 +2199,7 @@ declare class GuildScheduledEventMethods {
      * const client = new SnowTransfer("TOKEN")
      * const users = await client.guildScheduledEvent.getGuildScheduledEventUsers(guildId, eventId)
      */
-    getGuildScheduledEventUsers(guildId: string, eventId: string, query?: RESTGetAPIGuildScheduledEventUsersQuery): Promise<RESTGetAPIGuildScheduledEventUsersResult>;
+    getGuildScheduledEventUsers(guildId: string, eventId: string, options?: RESTGetAPIGuildScheduledEventUsersQuery): Promise<RESTGetAPIGuildScheduledEventUsersResult>;
 }
 
 /**
@@ -2487,13 +2535,11 @@ declare class WebhookMethods {
      * @param threadId Id of the thread the message was sent in
      * @returns Resolves the Promise on successful execution
      */
-    deleteWebhookMessage(webhookId: string, token: string, messageId: string, threadID?: string): Promise<RESTDeleteAPIWebhookWithTokenMessageResult>;
+    deleteWebhookMessage(webhookId: string, token: string, messageId: string, threadId?: string): Promise<RESTDeleteAPIWebhookWithTokenMessageResult>;
 }
 
 declare namespace __Webhooks {
-  export {
-    WebhookMethods as default,
-  };
+  export { WebhookMethods as default };
 }
 
 /**
@@ -2509,6 +2555,7 @@ declare class InteractionMethods {
      *
      * You can access the methods listed via `client.interaction.method`, where `client` is an initialized SnowTransfer instance
      * @param requestHandler request handler that calls the rest api
+     * @param webhooks WebhookMethods class that handles webhook related stuff
      */
     constructor(requestHandler: InstanceType<(typeof ___RequestHandler)["RequestHandler"]>, webhooks: InstanceType<typeof __Webhooks>);
     /**
@@ -2823,7 +2870,7 @@ declare class InviteMethods {
     /**
      * Get the invite data on an invite id
      * @param inviteId Id of the invite
-     * @param query Query params for additional metadata fields
+     * @param options Query params for additional metadata fields
      * @returns [Invite Object](https://discord.com/developers/docs/resources/invite#invite-object)
      *
      * @example
@@ -2831,7 +2878,7 @@ declare class InviteMethods {
      * const client = new SnowTransfer("TOKEN")
      * const invite = await client.invite.getInvite("inviteId", { with_counts: true })
      */
-    getInvite(inviteId: string, query?: RESTGetAPIInviteQuery): Promise<RESTGetAPIInviteResult>;
+    getInvite(inviteId: string, options?: RESTGetAPIInviteQuery): Promise<RESTGetAPIInviteResult>;
     /**
      * Delete an invite
      * @param inviteId
@@ -2883,7 +2930,7 @@ declare class StageInstanceMethods {
         reason?: string;
     }): Promise<RESTPostAPIStageInstanceResult>;
     /**
-     * Gets the stage instance assocuated to a stage channel if it exists
+     * Gets the stage instance associated to a stage channel if it exists
      * @param channelId Id of the stage channel
      * @returns a [stage instance](https://discord.com/developers/docs/resources/stage-instance#auto-closing-stage-instance-structure) object
      *
@@ -2914,6 +2961,7 @@ declare class StageInstanceMethods {
     /**
      * Delete an existing stage instance
      * @param channelId Id of the stage channel
+     * @param reason Reason for deleting the stage instance
      * @returns a [stage instance](https://discord.com/developers/docs/resources/stage-instance#auto-closing-stage-instance-structure) object
      *
      * | Permissions needed | Condition |
@@ -2984,13 +3032,14 @@ declare class UserMethods {
     updateSelf(data: RESTPatchAPICurrentUserJSONBody): Promise<RESTPatchAPICurrentUserResult>;
     /**
      * Get guilds of the current user
+     * @param options Options for getting guilds
      * @returns Array of [partial guild objects](https://discord.com/developers/docs/resources/guild#guild-object)
      *
      * @example
      * const client = new SnowTransfer("TOKEN")
      * const guilds = await client.user.getGuilds()
      */
-    getGuilds(query?: RESTGetAPICurrentUserGuildsQuery): Promise<RESTGetAPICurrentUserGuildsResult>;
+    getGuilds(options?: RESTGetAPICurrentUserGuildsQuery): Promise<RESTGetAPICurrentUserGuildsResult>;
     /**
      * Leaves a guild
      * @param guildId Id of the guild
@@ -3118,7 +3167,7 @@ declare const Constants: {
     SEARCH_MEMBERS_MAX_RESULTS: 1000;
     BULK_DELETE_MESSAGES_MIN: 2;
     BULK_DELETE_MESSAGES_MAX: 100;
-    OK_STATUS_CODES: number[];
+    OK_STATUS_CODES: Set<number>;
     standardMultipartHandler(data: {
         files: Array<{
             name: string;
@@ -3145,6 +3194,7 @@ declare const Endpoints: {
     APPLICATION_GUILD_COMMAND: (appID: string, guildID: string, cmdID: string) => "/applications/{app_id}/guilds/{guild_id}/commands/{cmd_id}";
     APPLICATION_GUILD_COMMANDS: (appID: string, guildID: string) => "/applications/{app_id}/guilds/{guild_id}/commands";
     CHANNEL: (chanID: string) => "/channels/{channel_id}";
+    CHANNEL_ATTACHMENTS: (chanID: string) => "/channels/{channel_id}/attachments";
     CHANNEL_BULK_DELETE: (chanID: string) => "/channels/{channel_id}/messages/bulk-delete";
     CHANNEL_FOLLOWERS: (chanID: string) => "/channels/{channel_id}/followers";
     CHANNEL_INVITES: (chanID: string) => "/channels/{channel_id}/invites";
@@ -3262,4 +3312,4 @@ declare class SnowTransfer {
     });
 }
 
-export { AuditLogMethods, AutoModerationMethods, BotMethods, ChannelMethods, Constants, Endpoints, GuildAssetsMethods, GuildMethods, GuildScheduledEventMethods, GuildTemplateMethods, InteractionMethods, InviteMethods, SnowTransfer, StageInstanceMethods, UserMethods, VoiceMethods, WebhookMethods };
+export { AuditLogMethods, AutoModerationMethods, BotMethods, ChannelMethods, Constants, DiscordAPIError, Endpoints, GlobalBucket, GuildAssetsMethods, GuildMethods, GuildScheduledEventMethods, GuildTemplateMethods, type HTTPMethod, type HandlerEvents, InteractionMethods, InviteMethods, LocalBucket, Ratelimiter, RequestHandler, SnowTransfer, StageInstanceMethods, UserMethods, VoiceMethods, WebhookMethods };