@discordeno/rest 19.0.0-next.fdf0d53 → 19.0.0-next.fe00a6f

package/dist/types.d.ts

@@ -1,10 +1,10 @@
-import type { ApplicationCommandPermissions, AtLeastOne, BeginGuildPrune, BigString, Camelize, CamelizedDiscordActiveThreads, CamelizedDiscordApplication, CamelizedDiscordApplicationCommand, CamelizedDiscordApplicationCommandPermissions, CamelizedDiscordArchivedThreads, CamelizedDiscordAuditLog, CamelizedDiscordAutoModerationRule, CamelizedDiscordBan, CamelizedDiscordChannel, CamelizedDiscordEmoji, CamelizedDiscordFollowedChannel, CamelizedDiscordGetGatewayBot, CamelizedDiscordGuild, CamelizedDiscordGuildPreview, CamelizedDiscordGuildWidget, CamelizedDiscordGuildWidgetSettings, CamelizedDiscordIntegration, CamelizedDiscordInvite, CamelizedDiscordInviteMetadata, CamelizedDiscordMember, CamelizedDiscordMemberWithUser, CamelizedDiscordMessage, CamelizedDiscordModifyGuildWelcomeScreen, CamelizedDiscordPrunedCount, CamelizedDiscordRole, CamelizedDiscordScheduledEvent, CamelizedDiscordStageInstance, CamelizedDiscordSticker, CamelizedDiscordStickerPack, CamelizedDiscordTemplate, CamelizedDiscordThreadMember, CamelizedDiscordUser, CamelizedDiscordVanityUrl, CamelizedDiscordVoiceRegion, CamelizedDiscordWebhook, CamelizedDiscordWelcomeScreen, CreateApplicationCommand, CreateAutoModerationRuleOptions, CreateChannelInvite, CreateForumPostWithMessage, CreateGuild, CreateGuildBan, CreateGuildChannel, CreateGuildEmoji, CreateGuildFromTemplate, CreateGuildRole, CreateGuildStickerOptions, CreateMessageOptions, CreateScheduledEvent, CreateStageInstance, CreateTemplate, DeleteWebhookMessageOptions, EditAutoModerationRuleOptions, EditBotMemberOptions, EditChannelPermissionOverridesOptions, EditGuildRole, EditGuildStickerOptions, EditMessage, EditOwnVoiceState, EditScheduledEvent, EditUserVoiceState, ExecuteWebhook, FileContent, GetBans, GetGuildAuditLog, GetGuildPruneCountQuery, GetInvite, GetMessagesOptions, GetReactions, GetScheduledEvents, GetScheduledEventUsers, GetWebhookMessageOptions, InteractionCallbackData, InteractionResponse, ListArchivedThreads, ListGuildMembers, MfaLevels, ModifyChannel, ModifyGuild, ModifyGuildChannelPositions, ModifyGuildEmoji, ModifyGuildMember, ModifyGuildTemplate, ModifyRolePositions, ModifyWebhook, SearchMembers, StartThreadWithMessage, StartThreadWithoutMessage } from '@discordeno/types';
+import type { ApplicationCommandPermissions, AtLeastOne, BeginGuildPrune, BigString, Camelize, CamelizedDiscordActiveThreads, CamelizedDiscordApplication, CamelizedDiscordApplicationCommand, CamelizedDiscordArchivedThreads, CamelizedDiscordAuditLog, CamelizedDiscordAutoModerationRule, CamelizedDiscordBan, CamelizedDiscordChannel, CamelizedDiscordEmoji, CamelizedDiscordFollowedChannel, CamelizedDiscordGetGatewayBot, CamelizedDiscordGuild, CamelizedDiscordGuildApplicationCommandPermissions, CamelizedDiscordGuildPreview, CamelizedDiscordGuildWidget, CamelizedDiscordGuildWidgetSettings, CamelizedDiscordIntegration, CamelizedDiscordInvite, CamelizedDiscordInviteMetadata, CamelizedDiscordMember, CamelizedDiscordMemberWithUser, CamelizedDiscordMessage, CamelizedDiscordModifyGuildWelcomeScreen, CamelizedDiscordPrunedCount, CamelizedDiscordRole, CamelizedDiscordScheduledEvent, CamelizedDiscordStageInstance, CamelizedDiscordSticker, CamelizedDiscordStickerPack, CamelizedDiscordTemplate, CamelizedDiscordThreadMember, CamelizedDiscordUser, CamelizedDiscordVanityUrl, CamelizedDiscordVoiceRegion, CamelizedDiscordWebhook, CamelizedDiscordWelcomeScreen, CreateApplicationCommand, CreateAutoModerationRuleOptions, CreateChannelInvite, CreateForumPostWithMessage, CreateGuild, CreateGuildBan, CreateGuildChannel, CreateGuildEmoji, CreateGuildFromTemplate, CreateGuildRole, CreateGuildStickerOptions, CreateMessageOptions, CreateScheduledEvent, CreateStageInstance, CreateTemplate, DeleteWebhookMessageOptions, EditAutoModerationRuleOptions, EditBotMemberOptions, EditChannelPermissionOverridesOptions, EditGuildRole, EditGuildStickerOptions, EditMessage, EditOwnVoiceState, EditScheduledEvent, EditUserVoiceState, ExecuteWebhook, FileContent, GetBans, GetGuildAuditLog, GetGuildPruneCountQuery, GetInvite, GetMessagesOptions, GetReactions, GetScheduledEvents, GetScheduledEventUsers, GetWebhookMessageOptions, InteractionCallbackData, InteractionResponse, ListArchivedThreads, ListGuildMembers, MfaLevels, ModifyChannel, ModifyGuild, ModifyGuildChannelPositions, ModifyGuildEmoji, ModifyGuildMember, ModifyGuildTemplate, ModifyRolePositions, ModifyWebhook, SearchMembers, StartThreadWithMessage, StartThreadWithoutMessage } from '@discordeno/types';
 import type { InvalidRequestBucket } from './invalidBucket.js';
 import type { Queue } from './queue.js';
 import type { RestRoutes } from './typings/routes.js';
 export interface CreateRestManagerOptions {
     /** The bot token which will be used to make requests. */
-    token: string;
+    token?: string;
     /**
      * For old bots that have a different bot id and application id.
      * @default bot id from token
@@ -29,7 +29,7 @@ export interface CreateRestManagerOptions {
 }
 export interface RestManager {
     /** The bot token which will be used to make requests. */
-    token: string;
+    token?: string;
     /** The application id. Normally this is not required for recent bots but old bot's application id is sometimes different from the bot id so it is required for those bots. */
     applicationId: bigint;
     /** The api version to use when making requests. Only the latest supported version will be tested. */
@@ -40,6 +40,12 @@ export interface RestManager {
      * @default https://discord.com/api
      */
     baseUrl: string;
+    /**
+     * `true` if the `baseUrl` does not start with `https://discord.com/api`.
+     *
+     * Mostly used only for intern functions.
+     */
+    isProxied: boolean;
     /** The authorization header to attach when sending requests to the proxy. */
     authorization?: string;
     /** The maximum amount of times a request should be retried. Defaults to Infinity */
@@ -58,12 +64,14 @@ export interface RestManager {
     invalidBucket: InvalidRequestBucket;
     /** The routes that are available for this manager. */
     routes: RestRoutes;
+    /** Whether or not the rest manager should keep objects in raw snake case from discord. */
+    preferSnakeCase: (enabled: boolean) => RestManager;
     /** Check the rate limits for a url or a bucket. */
     checkRateLimits: (url: string) => number | false;
     /** Reshapes and modifies the obj as needed to make it ready for discords api. */
     changeToDiscordFormat: (obj: any) => any;
     /** Creates the request body and headers that are necessary to send a request. Will handle different types of methods and everything necessary for discord. */
-    createRequest: (options: CreateRequestBodyOptions) => RequestBody;
+    createRequestBody: (method: RequestMethods, options?: CreateRequestBodyOptions) => RequestBody;
     /** This will create a infinite loop running in 1 seconds using tail recursion to keep rate limits clean. When a rate limit resets, this will remove it so the queue can proceed. */
     processRateLimitedPaths: () => void;
     /** Processes the rate limit headers and determines if it needs to be rate limited and returns the bucket id if available */
@@ -73,19 +81,19 @@ export interface RestManager {
     /** Split a url to separate rate limit buckets based on major/minor parameters. */
     simplifyUrl: (url: string, method: RequestMethods) => string;
     /** Make a request to be sent to the api. */
-    makeRequest: <T = unknown>(method: RequestMethods, url: string, options?: Omit<CreateRequestBodyOptions, 'method'>) => Promise<T>;
+    makeRequest: <T = unknown>(method: RequestMethods, url: string, options?: MakeRequestOptions) => Promise<T>;
     /** Takes a request and processes it into a queue. */
-    processRequest: (request: SendRequestOptions) => void;
+    processRequest: (request: SendRequestOptions) => Promise<void>;
     /** Make a get request to the api */
-    get: <T = void>(url: string, options?: Omit<CreateRequestBodyOptions, 'body' | 'method'>) => Promise<Camelize<T>>;
+    get: <T = void>(url: string, options?: Omit<MakeRequestOptions, 'body'>) => Promise<Camelize<T>>;
     /** Make a post request to the api. */
-    post: <T = void>(url: string, options?: Omit<CreateRequestBodyOptions, 'method'>) => Promise<Camelize<T>>;
+    post: <T = void>(url: string, options?: MakeRequestOptions) => Promise<Camelize<T>>;
     /** Make a put request to the api. */
-    put: <T = void>(url: string, options?: Omit<CreateRequestBodyOptions, 'method'>) => Promise<Camelize<T>>;
+    put: <T = void>(url: string, options?: MakeRequestOptions) => Promise<Camelize<T>>;
     /** Make a delete request to the api. */
-    delete: (url: string, options?: Omit<CreateRequestBodyOptions, 'body' | 'method'>) => Promise<void>;
+    delete: (url: string, options?: Omit<MakeRequestOptions, 'body'>) => Promise<void>;
     /** Make a patch request to the api. */
-    patch: <T = void>(url: string, options?: Omit<CreateRequestBodyOptions, 'method'>) => Promise<Camelize<T>>;
+    patch: <T = void>(url: string, options?: MakeRequestOptions) => Promise<Camelize<T>>;
     /**
      * Adds a reaction to a message.
      *
@@ -130,6 +138,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild the member to add the role to is in.
      * @param userId - The user ID of the member to add the role to.
      * @param roleId - The ID of the role to add to the member.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_ROLES` permission.
@@ -159,6 +168,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to create the rule in.
      * @param options - The parameters for the creation of the rule.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordAutoModerationRule}.
      *
      * @remarks
@@ -168,12 +178,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/auto-moderation#create-auto-moderation-rule}
      */
-    createAutomodRule: (guildId: BigString, options: CreateAutoModerationRuleOptions) => Promise<CamelizedDiscordAutoModerationRule>;
+    createAutomodRule: (guildId: BigString, options: CreateAutoModerationRuleOptions, reason?: string) => Promise<CamelizedDiscordAutoModerationRule>;
     /**
      * Creates a channel within a guild.
      *
      * @param guildId - The ID of the guild to create the channel within.
      * @param options - The parameters for the creation of the channel.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordChannel}.
      *
      * @remarks
@@ -187,12 +198,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#create-guild-channel}
      */
-    createChannel: (guildId: BigString, options: CreateGuildChannel) => Promise<CamelizedDiscordChannel>;
+    createChannel: (guildId: BigString, options: CreateGuildChannel, reason?: string) => Promise<CamelizedDiscordChannel>;
     /**
      * Creates an emoji in a guild.
      *
      * @param guildId - The ID of the guild in which to create the emoji.
      * @param options - The parameters for the creation of the emoji.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordEmoji}.
      *
      * @remarks
@@ -204,12 +216,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/emoji#create-guild-emoji}
      */
-    createEmoji: (guildId: BigString, options: CreateGuildEmoji) => Promise<CamelizedDiscordEmoji>;
+    createEmoji: (guildId: BigString, options: CreateGuildEmoji, reason?: string) => Promise<CamelizedDiscordEmoji>;
     /**
      * Creates a new thread in a forum channel, and sends a message within the created thread.
      *
      * @param channelId - The ID of the forum channel to create the thread within.
      * @param options - The parameters for the creation of the thread.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of {@link CamelizedDiscordChannel} with a nested {@link Message} object.
      *
      * @remarks
@@ -222,7 +235,7 @@ export interface RestManager {
      *
      * @experimental
      */
-    createForumThread: (channelId: BigString, options: CreateForumPostWithMessage) => Promise<CamelizedDiscordChannel>;
+    createForumThread: (channelId: BigString, options: CreateForumPostWithMessage, reason?: string) => Promise<CamelizedDiscordChannel>;
     /**
      * Creates an application command accessible globally; across different guilds and channels.
      *
@@ -284,6 +297,7 @@ export interface RestManager {
      * Create a new sticker for the guild.
      *
      * @param guildId The ID of the guild to get
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @return A {@link CamelizedDiscordSticker}
      *
      * @remarks
@@ -294,7 +308,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/sticker#create-guild-sticker}
      */
-    createGuildSticker: (guildId: BigString, options: CreateGuildStickerOptions) => Promise<CamelizedDiscordSticker>;
+    createGuildSticker: (guildId: BigString, options: CreateGuildStickerOptions, reason?: string) => Promise<CamelizedDiscordSticker>;
     /**
      * Creates a template from a guild.
      *
@@ -315,6 +329,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel to create the invite to.
      * @param options - The parameters for the creation of the invite.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordInvite}.
      *
      * @remarks
@@ -327,12 +342,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/channel#create-channel-invite}
      */
-    createInvite: (channelId: BigString, options?: CreateChannelInvite) => Promise<CamelizedDiscordInvite>;
+    createInvite: (channelId: BigString, options?: CreateChannelInvite, reason?: string) => Promise<CamelizedDiscordInvite>;
     /**
      * Creates a role in a guild.
      *
      * @param guildId - The ID of the guild to create the role in.
      * @param options - The parameters for the creation of the role.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordRole}.
      *
      * @remarks
@@ -348,6 +364,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to create the scheduled event in.
      * @param options - The parameters for the creation of the scheduled event.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link ScheduledEvent}.
      *
      * @remarks
@@ -359,11 +376,12 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild-scheduled-event#create-guild-scheduled-event}
      */
-    createScheduledEvent: (guildId: BigString, options: CreateScheduledEvent) => Promise<CamelizedDiscordScheduledEvent>;
+    createScheduledEvent: (guildId: BigString, options: CreateScheduledEvent, reason?: string) => Promise<CamelizedDiscordScheduledEvent>;
     /**
      * Creates a stage instance associated with a stage channel.
      *
      * @param options - The parameters for the creation of the stage instance.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordStageInstance}.
      *
      * @remarks
@@ -373,18 +391,19 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/stage-instance#create-stage-instance}
      */
-    createStageInstance: (options: CreateStageInstance) => Promise<CamelizedDiscordStageInstance>;
+    createStageInstance: (options: CreateStageInstance, reason?: string) => Promise<CamelizedDiscordStageInstance>;
     /**
      * Creates a webhook.
      *
      * @param channelId - The ID of the channel to create the webhook in.
      * @param options - The parameters for the creation of the webhook.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordWebhook}.
      *
      * @remarks
      * Requires the `MANAGE_WEBHOOKS` permission.
      *
-     * ⚠️ The webhook name must not contain the string 'clyde' (case-insensitive).
+     * ⚠️ The webhook name must not contain the substrings 'clyde', or 'discord' (case-insensitive).
      *
      * Fires a _Webhooks Update_ gateway event.
      *
@@ -396,6 +415,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to delete the rule from.
      * @param ruleId - The ID of the automod rule to delete.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -409,6 +429,7 @@ export interface RestManager {
      * Deletes a channel from within a guild.
      *
      * @param channelId - The ID of the channel to delete.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the deleted {@link Channel}.
      *
      * @remarks
@@ -435,6 +456,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel to delete the permission override of.
      * @param overwriteId - The ID of the permission override to delete.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_ROLES` permission.
@@ -449,6 +471,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild from which to delete the emoji.
      * @param id - The ID of the emoji to delete.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
@@ -506,6 +529,7 @@ export interface RestManager {
      * Delete a new sticker for the guild.
      *
      * @param guildId The ID of the guild to get
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @return A {@link CamelizedDiscordSticker}
      *
      * @remarks
@@ -536,6 +560,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild from which to delete the integration.
      * @param integrationId - The ID of the integration to delete from the guild.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -547,11 +572,12 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#delete-guild-integration}
      */
-    deleteIntegration: (guildId: BigString, integrationId: BigString) => Promise<void>;
+    deleteIntegration: (guildId: BigString, integrationId: BigString, reason?: string) => Promise<void>;
     /**
      * Deletes an invite to a channel.
      *
      * @param inviteCode - The invite code of the invite to delete.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_CHANNELS` permission.
@@ -566,6 +592,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel to delete the message from.
      * @param messageId - The ID of the message to delete from the channel.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * If not deleting own message:
@@ -581,6 +608,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel to delete the messages from.
      * @param messageIds - The IDs of the messages to delete from the channel.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_MESSAGES` permission.
@@ -658,6 +686,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to delete the role from.
      * @param roleId - The ID of the role to delete.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_ROLES` permission.
@@ -666,7 +695,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#delete-guild-role}
      */
-    deleteRole: (guildId: BigString, roleId: BigString) => Promise<void>;
+    deleteRole: (guildId: BigString, roleId: BigString, reason?: string) => Promise<void>;
     /**
      * Deletes a scheduled event from a guild.
      *
@@ -685,6 +714,7 @@ export interface RestManager {
      * Deletes the stage instance associated with a stage channel, if one exists.
      *
      * @param channelId - The ID of the stage channel the stage instance is associated with.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the user to be a moderator of the stage channel.
@@ -765,13 +795,14 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#edit-application-command-permissions}
      */
-    editApplicationCommandPermissions: (guildId: BigString, commandId: BigString, bearerToken: string, options: ApplicationCommandPermissions[]) => Promise<CamelizedDiscordApplicationCommandPermissions>;
+    editApplicationCommandPermissions: (guildId: BigString, commandId: BigString, bearerToken: string, options: ApplicationCommandPermissions[]) => Promise<CamelizedDiscordGuildApplicationCommandPermissions>;
     /**
      * Edits an automod rule.
      *
      * @param guildId - The ID of the guild to edit the rule in.
      * @param ruleId - The ID of the rule to edit.
      * @param options - The parameters for the edit of the rule.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link CamelizedDiscordAutoModerationRule}.
      *
      * @remarks
@@ -781,7 +812,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/auto-moderation#modify-auto-moderation-rule}
      */
-    editAutomodRule: (guildId: BigString, ruleId: BigString, options: Partial<EditAutoModerationRuleOptions>) => Promise<CamelizedDiscordAutoModerationRule>;
+    editAutomodRule: (guildId: BigString, ruleId: BigString, options: Partial<EditAutoModerationRuleOptions>, reason?: string) => Promise<CamelizedDiscordAutoModerationRule>;
     /**
      * Modifies the bot's username or avatar.
      * NOTE: username: if changed may cause the bot's discriminator to be randomized.
@@ -795,6 +826,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel to edit.
      * @param options - The parameters for the edit of the channel.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link CamelizedDiscordChannel}.
      *
      * @remarks
@@ -819,12 +851,13 @@ export interface RestManager {
      * - Otherwise:
      *     - Fires a _Channel Update_ gateway event.
      */
-    editChannel: (channelId: BigString, options: ModifyChannel) => Promise<CamelizedDiscordChannel>;
+    editChannel: (channelId: BigString, options: ModifyChannel, reason?: string) => Promise<CamelizedDiscordChannel>;
     /**
      * Edits the permission overrides for a user or role in a channel.
      *
      * @param channelId - The ID of the channel to edit the permission overrides of.
      * @param options - The permission override.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_ROLES` permission.
@@ -835,7 +868,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/channel#edit-channel-permissions}
      */
-    editChannelPermissionOverrides: (channelId: BigString, options: EditChannelPermissionOverridesOptions) => Promise<void>;
+    editChannelPermissionOverrides: (channelId: BigString, options: EditChannelPermissionOverridesOptions, reason?: string) => Promise<void>;
     /**
      * Edits the positions of a set of channels in a guild.
      *
@@ -856,6 +889,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild in which to edit the emoji.
      * @param id - The ID of the emoji to edit.
      * @param options - The parameters for the edit of the emoji.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the updated {@link CamelizedDiscordEmoji}.
      *
      * @remarks
@@ -865,7 +899,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/emoji#modify-guild-emoji}
      */
-    editEmoji: (guildId: BigString, id: BigString, options: ModifyGuildEmoji) => Promise<CamelizedDiscordEmoji>;
+    editEmoji: (guildId: BigString, id: BigString, options: ModifyGuildEmoji, reason?: string) => Promise<CamelizedDiscordEmoji>;
     /**
      * Edits a follow-up message to an interaction.
      *
@@ -900,6 +934,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild to edit.
      * @param shardId - The ID of the shard the guild is in.
      * @param options - The parameters for the edit of the guild.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link Guild}.
      *
      * @remarks
@@ -912,7 +947,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild}
      */
-    editGuild: (guildId: BigString, options: ModifyGuild) => Promise<CamelizedDiscordGuild>;
+    editGuild: (guildId: BigString, options: ModifyGuild, reason?: string) => Promise<CamelizedDiscordGuild>;
     /**
      * Edits an application command registered in a guild.
      *
@@ -924,12 +959,15 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command}
      */
     editGuildApplicationCommand: (commandId: BigString, guildId: BigString, options: CreateApplicationCommand) => Promise<CamelizedDiscordApplicationCommand>;
-    /** Modify a guild's MFA level. Requires guild ownership. */
+    /** Modify a guild's MFA level. Requires guild ownership.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
+     */
     editGuildMfaLevel: (guildId: BigString, mfaLevel: MfaLevels, reason?: string) => Promise<void>;
     /**
      * Edit the given sticker.
      *
      * @param guildId The ID of the guild to get
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @return A {@link CamelizedDiscordSticker}
      *
      * @remarks
@@ -938,7 +976,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/sticker#modify-guild-sticker}
      */
-    editGuildSticker: (guildId: BigString, stickerId: BigString, options: AtLeastOne<EditGuildStickerOptions>) => Promise<CamelizedDiscordSticker>;
+    editGuildSticker: (guildId: BigString, stickerId: BigString, options: AtLeastOne<EditGuildStickerOptions>, reason?: string) => Promise<CamelizedDiscordSticker>;
     /**
      * Edits a template's settings.
      *
@@ -989,7 +1027,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#edit-original-interaction-response}
      */
-    editOriginalInteractionResponse: (token: string, options: InteractionCallbackData) => Promise<CamelizedDiscordMessage | undefined>;
+    editOriginalInteractionResponse: (token: string, options: InteractionCallbackData) => Promise<CamelizedDiscordMessage>;
     /**
      * Edits the original webhook message.
      *
@@ -1030,6 +1068,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild to edit the role in.
      * @param roleId - The ID of the role to edit.
      * @param options - The parameters for the edit of the role.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link CamelizedDiscordRole}.
      *
      * @remarks
@@ -1039,12 +1078,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-role}
      */
-    editRole: (guildId: BigString, roleId: BigString, options: EditGuildRole) => Promise<CamelizedDiscordRole>;
+    editRole: (guildId: BigString, roleId: BigString, options: EditGuildRole, reason?: string) => Promise<CamelizedDiscordRole>;
     /**
      * Edits the positions of a set of roles.
      *
      * @param guildId - The ID of the guild to edit the role positions in.
      * @param options - The parameters for the edit of the role positions.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns A collection of {@link CamelizedDiscordRole} objects assorted by role ID.
      *
      * @remarks
@@ -1054,12 +1094,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-role-positions}
      */
-    editRolePositions: (guildId: BigString, options: ModifyRolePositions[]) => Promise<CamelizedDiscordRole[]>;
+    editRolePositions: (guildId: BigString, options: ModifyRolePositions[], reason?: string) => Promise<CamelizedDiscordRole[]>;
     /**
      * Edits a scheduled event.
      *
      * @param guildId - The ID of the guild to edit the scheduled event in.
      * @param eventId - The ID of the scheduled event to edit.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link ScheduledEvent}.
      *
      * @remarks
@@ -1073,12 +1114,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event}
      */
-    editScheduledEvent: (guildId: BigString, eventId: BigString, options: Partial<EditScheduledEvent>) => Promise<CamelizedDiscordScheduledEvent>;
+    editScheduledEvent: (guildId: BigString, eventId: BigString, options: Partial<EditScheduledEvent>, reason?: string) => Promise<CamelizedDiscordScheduledEvent>;
     /**
      * Edits a stage instance.
      *
      * @param channelId - The ID of the stage channel the stage instance is associated with.
      * @param topic - Topic of the Stage instance (1-120 characters).
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the updated {@link CamelizedDiscordStageInstance}.
      *
      * @remarks
@@ -1107,6 +1149,7 @@ export interface RestManager {
      * Edits a webhook.
      *
      * @param webhookId - The ID of the webhook to edit.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link CamelizedDiscordWebhook}.
      *
      * @remarks
@@ -1116,7 +1159,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/webhook#edit-webhook}
      */
-    editWebhook: (webhookId: BigString, options: ModifyWebhook) => Promise<CamelizedDiscordWebhook>;
+    editWebhook: (webhookId: BigString, options: ModifyWebhook, reason?: string) => Promise<CamelizedDiscordWebhook>;
     /**
      * Edits a webhook message.
      *
@@ -1154,6 +1197,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to edit the welcome screen of.
      * @param options - The parameters for the edit of the welcome screen.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link WelcomeScreen}.
      *
      * @remarks
@@ -1163,11 +1207,12 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen}
      */
-    editWelcomeScreen: (guildId: BigString, options: CamelizedDiscordModifyGuildWelcomeScreen) => Promise<CamelizedDiscordWelcomeScreen>;
+    editWelcomeScreen: (guildId: BigString, options: CamelizedDiscordModifyGuildWelcomeScreen, reason?: string) => Promise<CamelizedDiscordWelcomeScreen>;
     /**
      * Edits the settings of a guild's widget.
      *
      * @param guildId - The ID of the guild to edit the settings of the widget of.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link GuildWidgetSettings}.
      *
      * @remarks
@@ -1177,7 +1222,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-widget}
      */
-    editWidgetSettings: (guildId: BigString, options: CamelizedDiscordGuildWidgetSettings) => Promise<CamelizedDiscordGuildWidgetSettings>;
+    editWidgetSettings: (guildId: BigString, options: CamelizedDiscordGuildWidgetSettings, reason?: string) => Promise<CamelizedDiscordGuildWidgetSettings>;
     /**
      * Executes a webhook, causing a message to be posted in the channel configured for the webhook.
      *
@@ -1232,7 +1277,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#get-application-command-permissions}
      */
-    getApplicationCommandPermission: (guildId: BigString, commandId: BigString) => Promise<CamelizedDiscordApplicationCommandPermissions>;
+    getApplicationCommandPermission: (guildId: BigString, commandId: BigString) => Promise<CamelizedDiscordGuildApplicationCommandPermissions>;
     /**
      * Gets the permissions of all application commands registered in a guild by the ID of the guild.
      *
@@ -1241,7 +1286,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#get-guild-application-command-permissions}
      */
-    getApplicationCommandPermissions: (guildId: BigString) => Promise<CamelizedDiscordApplicationCommandPermissions[]>;
+    getApplicationCommandPermissions: (guildId: BigString) => Promise<CamelizedDiscordGuildApplicationCommandPermissions[]>;
     /**
      * Gets a guild's audit log.
      *
@@ -1968,6 +2013,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild the member to remove the role from is in.
      * @param userId - The user ID of the member to remove the role from.
      * @param roleId - The ID of the role to remove from the member.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `MANAGE_ROLES` permission.
@@ -2070,6 +2116,7 @@ export interface RestManager {
      * @param channelId - The ID of the channel in which to create the thread.
      * @param messageId - The ID of the message to use as the thread's point of origin.
      * @param options - The parameters to use for the creation of the thread.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link Channel | Thread}.
      *
      * @remarks
@@ -2083,12 +2130,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/channel#start-thread-from-message}
      */
-    startThreadWithMessage: (channelId: BigString, messageId: BigString, options: StartThreadWithMessage) => Promise<CamelizedDiscordChannel>;
+    startThreadWithMessage: (channelId: BigString, messageId: BigString, options: StartThreadWithMessage, reason?: string) => Promise<CamelizedDiscordChannel>;
     /**
      * Creates a thread without using a message as the thread's point of origin.
      *
      * @param channelId - The ID of the channel in which to create the thread.
      * @param options - The parameters to use for the creation of the thread.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the created {@link CamelizedDiscordChannel | Thread}.
      *
      * @remarks
@@ -2098,7 +2146,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/channel#start-thread-without-message}
      */
-    startThreadWithoutMessage: (channelId: BigString, options: StartThreadWithoutMessage) => Promise<CamelizedDiscordChannel>;
+    startThreadWithoutMessage: (channelId: BigString, options: StartThreadWithoutMessage, reason?: string) => Promise<CamelizedDiscordChannel>;
     /**
      * Synchronises a template with the current state of a guild.
      *
@@ -2158,9 +2206,9 @@ export interface RestManager {
     /**
      * Bans a user from a guild.
      *
-    
      * @param guildId - The ID of the guild to ban the user from.
      * @param userId - The ID of the user to ban from the guild.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @param options - The parameters for the creation of the ban.
      *
      * @remarks
@@ -2170,12 +2218,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#create-guild-ban}
      */
-    banMember: (guildId: BigString, userId: BigString, options?: CreateGuildBan) => Promise<void>;
+    banMember: (guildId: BigString, userId: BigString, options?: CreateGuildBan, reason?: string) => Promise<void>;
     /**
      * Edits the nickname of the bot user.
      *
      * @param guildId - The ID of the guild to edit the nickname of the bot user in.
      * @param options - The parameters for the edit of the nickname.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of the edited {@link CamelizedDiscordMember}
      *
      * @remarks
@@ -2183,12 +2232,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-current-member}
      */
-    editBotMember: (guildId: BigString, options: EditBotMemberOptions) => Promise<CamelizedDiscordMember>;
+    editBotMember: (guildId: BigString, options: EditBotMemberOptions, reason?: string) => Promise<CamelizedDiscordMember>;
     /**
      * Edits a member's properties.
      *
      * @param guildId - The ID of the guild to edit the member of.
      * @param userId - The user ID of the member to edit.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @param options - The parameters for the edit of the user.
      *
      * @remarks
@@ -2199,7 +2249,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-guild-member}
      */
-    editMember: (guildId: BigString, userId: BigString, options: ModifyGuildMember) => Promise<CamelizedDiscordMember>;
+    editMember: (guildId: BigString, userId: BigString, options: ModifyGuildMember, reason?: string) => Promise<CamelizedDiscordMember>;
     /**
      * Gets the member object by user ID.
      *
@@ -2236,6 +2286,7 @@ export interface RestManager {
     
      * @param guildId - The ID of the guild to kick the member from.
      * @param userId - The user ID of the member to kick from the guild.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `KICK_MEMBERS` permission.
@@ -2250,6 +2301,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel where the message is to be pinned.
      * @param messageId - The ID of the message to pin.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires that the bot user be able to see the contents of the channel in which the messages were posted.
@@ -2269,6 +2321,7 @@ export interface RestManager {
     
      * @param guildId - The ID of the guild to prune the members of.
      * @param options - The parameters for the pruning of members.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns A number indicating how many members were pruned.
      *
      * @remarks
@@ -2282,7 +2335,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#begin-guild-prune}
      */
-    pruneMembers: (guildId: BigString, options: BeginGuildPrune) => Promise<{
+    pruneMembers: (guildId: BigString, options: BeginGuildPrune, reason?: string) => Promise<{
         pruned: number | null;
     }>;
     /**
@@ -2303,6 +2356,7 @@ export interface RestManager {
     
      * @param guildId - The ID of the guild to unban the user in.
      * @param userId - The ID of the user to unban.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `BAN_MEMBERS` permission.
@@ -2311,12 +2365,13 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#remove-guild-ban}
      */
-    unbanMember: (guildId: BigString, userId: BigString) => Promise<void>;
+    unbanMember: (guildId: BigString, userId: BigString, reason?: string) => Promise<void>;
     /**
      * Unpins a pinned message in a channel.
      *
      * @param channelId - The ID of the channel where the message is pinned.
      * @param messageId - The ID of the message to unpin.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires that the bot user be able to see the contents of the channel in which the messages were posted.
@@ -2339,22 +2394,21 @@ export interface CreateWebhook {
 }
 export interface CreateRequestBodyOptions {
     headers?: Record<string, string>;
-    method: RequestMethods;
     body?: any;
     unauthorized?: boolean;
-    url?: string;
     reason?: string;
-    attachments?: FileContent[];
+    files?: FileContent[];
 }
+export type MakeRequestOptions = Omit<CreateRequestBodyOptions, 'method'> & Pick<SendRequestOptions, 'runThroughQueue'>;
 export interface RequestBody {
     headers: Record<string, string>;
     body?: string | FormData;
     method: RequestMethods;
 }
 export interface SendRequestOptions {
-    /** The url to send the request to. */
-    url: string;
-    /** The method to use when sending the request. */
+    /** The route to send the request to. */
+    route: string;
+    /** The method to use for sending the request. */
     method: RequestMethods;
     /** The amount of times this request has been retried. */
     retryCount: number;
@@ -2367,7 +2421,12 @@ export interface SendRequestOptions {
     /** If this request has a bucket id which it falls under for rate limit */
     bucketId?: string;
     /** Additional request options, used for things like overriding authorization header. */
-    options?: Record<string, any>;
+    requestBodyOptions?: CreateRequestBodyOptions;
+    /**
+     * Whether the request should be run through the queue.
+     * Useful for routes which do not have any rate limits.
+     */
+    runThroughQueue?: boolean;
 }
 export interface RestRateLimitedPath {
     url: string;