@discordeno/rest 19.0.0-next.fd518cb → 19.0.0-next.fda3003

package/dist/{types.d.ts → types/types.d.ts}

@@ -1,10 +1,11 @@
-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 { AddDmRecipientOptions, AddGuildMemberOptions, ApplicationCommandPermissions, AtLeastOne, BeginGuildPrune, BigString, Camelize, CamelizedDiscordAccessTokenResponse, CamelizedDiscordActiveThreads, CamelizedDiscordApplication, CamelizedDiscordApplicationCommand, CamelizedDiscordApplicationRoleConnection, CamelizedDiscordArchivedThreads, CamelizedDiscordAuditLog, CamelizedDiscordAutoModerationRule, CamelizedDiscordBan, CamelizedDiscordChannel, CamelizedDiscordConnection, CamelizedDiscordCurrentAuthorization, CamelizedDiscordEmoji, CamelizedDiscordEntitlement, CamelizedDiscordFollowedChannel, CamelizedDiscordGetAnswerVotesResponse, CamelizedDiscordGetGatewayBot, CamelizedDiscordGuild, CamelizedDiscordGuildApplicationCommandPermissions, CamelizedDiscordGuildOnboarding, CamelizedDiscordGuildPreview, CamelizedDiscordGuildWidget, CamelizedDiscordGuildWidgetSettings, CamelizedDiscordIntegration, CamelizedDiscordInvite, CamelizedDiscordInviteMetadata, CamelizedDiscordMember, CamelizedDiscordMemberWithUser, CamelizedDiscordMessage, CamelizedDiscordModifyGuildWelcomeScreen, CamelizedDiscordPartialGuild, CamelizedDiscordPrunedCount, CamelizedDiscordRole, CamelizedDiscordScheduledEvent, CamelizedDiscordSku, CamelizedDiscordStageInstance, CamelizedDiscordSticker, CamelizedDiscordStickerPack, CamelizedDiscordTemplate, CamelizedDiscordThreadMember, CamelizedDiscordTokenExchange, CamelizedDiscordTokenRevocation, CamelizedDiscordUser, CamelizedDiscordVanityUrl, CamelizedDiscordVoiceRegion, CamelizedDiscordWebhook, CamelizedDiscordWelcomeScreen, CreateApplicationCommand, CreateAutoModerationRuleOptions, CreateChannelInvite, CreateEntitlement, CreateForumPostWithMessage, CreateGlobalApplicationCommandOptions, CreateGuild, CreateGuildApplicationCommandOptions, CreateGuildBan, CreateGuildBulkBan, CreateGuildChannel, CreateGuildEmoji, CreateGuildFromTemplate, CreateGuildRole, CreateGuildStickerOptions, CreateMessageOptions, CreateScheduledEvent, CreateStageInstance, CreateTemplate, DeleteWebhookMessageOptions, DiscordBulkBan, EditApplication, EditAutoModerationRuleOptions, EditBotMemberOptions, EditChannelPermissionOverridesOptions, EditGuildOnboarding, EditGuildRole, EditGuildStickerOptions, EditMessage, EditOwnVoiceState, EditScheduledEvent, EditUserVoiceState, ExecuteWebhook, FileContent, GetApplicationCommandPermissionOptions, GetBans, GetEntitlements, GetGroupDmOptions, GetGuildAuditLog, GetGuildPruneCountQuery, GetInvite, GetMessagesOptions, GetPollAnswerVotes, GetReactions, GetScheduledEventUsers, GetScheduledEvents, GetUserGuilds, GetWebhookMessageOptions, InteractionCallbackData, InteractionResponse, ListArchivedThreads, ListGuildMembers, MfaLevels, ModifyChannel, ModifyGuild, ModifyGuildChannelPositions, ModifyGuildEmoji, ModifyGuildMember, ModifyGuildTemplate, ModifyRolePositions, ModifyWebhook, SearchMembers, StartThreadWithMessage, StartThreadWithoutMessage, UpsertGlobalApplicationCommandOptions, UpsertGuildApplicationCommandOptions } from '@discordeno/types';
+import type { logger } from '@discordeno/utils';
 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
@@ -18,18 +19,42 @@ export interface CreateRestManagerOptions {
          * @default https://discord.com/api
          */
         baseUrl: string;
-        /** The authorization header to attach when sending requests to the proxy. */
+        /** The authorization header value to attach when sending requests to the proxy. */
         authorization: string;
+        /**
+         * The authorization header name to use when sending requests to the proxy
+         *
+         * @remarks
+         * If the `authorization` header is used it will override any authorization that is given even if
+         * the requests uses OAuth2 Bearer tokens / Basic tokens
+         *
+         * @default "authorization" // For compatibility purposes
+         */
+        authorizationHeader?: string;
+        /**
+         * The endpoint to use in the rest proxy to update the bearer tokens
+         *
+         * @remarks
+         * Should not include a `/` in the start
+         *
+         * This value is actually required if you want to use `updateTokenQueues`
+         */
+        updateBearerTokenEndpoint?: string;
     };
     /**
      * The api versions which can be used to make requests.
      * @default 10
      */
     version?: ApiVersions;
+    /**
+     * The logger that the rest manager will use
+     * @default logger // The logger exported by `@discordeno/utils`
+     */
+    logger?: Pick<typeof logger, 'debug' | 'info' | 'warn' | 'error' | 'fatal'>;
 }
 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. */
@@ -46,8 +71,12 @@ export interface RestManager {
      * Mostly used only for intern functions.
      */
     isProxied: boolean;
-    /** The authorization header to attach when sending requests to the proxy. */
+    /** The authorization header value to attach when sending requests to the proxy. */
     authorization?: string;
+    /** The authorization header name to attach when sending requests to the proxy */
+    authorizationHeader: string;
+    /** The endpoint to use for `updateTokenQueues` when working with a rest proxy */
+    updateBearerTokenEndpoint?: string;
     /** The maximum amount of times a request should be retried. Defaults to Infinity */
     maxRetryCount: number;
     /** Whether or not the manager is rate limited globally across all requests. Defaults to false. */
@@ -64,8 +93,15 @@ export interface RestManager {
     invalidBucket: InvalidRequestBucket;
     /** The routes that are available for this manager. */
     routes: RestRoutes;
+    /** The logger to use for the rest manager */
+    logger: Pick<typeof logger, 'debug' | 'info' | 'warn' | 'error' | 'fatal'>;
+    /** Allows the user to inject custom headers that will be sent with every request. */
+    createBaseHeaders: () => Record<string, string>;
+    /** 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;
+    checkRateLimits: (url: string, requestAuthorization: string) => number | false;
+    updateTokenQueues: (oldToken: string, newToken: string) => Promise<void>;
     /** 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. */
@@ -73,7 +109,7 @@ export interface RestManager {
     /** 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 */
-    processHeaders: (url: string, headers: Headers) => string | undefined;
+    processHeaders: (url: string, headers: Headers, requestAuthorization: string) => string | undefined;
     /** Sends a request to the api. */
     sendRequest: (options: SendRequestOptions) => Promise<void>;
     /** Split a url to separate rate limit buckets based on major/minor parameters. */
@@ -161,6 +197,35 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/channel#add-thread-member}
      */
     addThreadMember: (channelId: BigString, userId: BigString) => Promise<void>;
+    /**
+     * Adds a recipient to a group DM.
+     *
+     * @param channelId - The ID of the group dm to add the user to.
+     * @param userId - The user ID of the user to add to the group dm.
+     * @param options - The options for adding the user
+     *
+     * @remarks
+     * Requires an OAuth2 access token with the `gdm.join` scope
+     *
+     * @see {@link https://discord.com/developers/docs/resources/channel#group-dm-add-recipient}
+     */
+    addDmRecipient: (channelId: BigString, userId: BigString, options: AddDmRecipientOptions) => Promise<void>;
+    /**
+     * Adds a member to a guild.
+     *
+     * @param guildId - The ID of the thread to add the member to.
+     * @param userId - The user ID of the member to add to the thread.
+     * @param options - The options for the add of a guild member
+     *
+     * @remarks
+     * Requires the bot to be in the specified server
+     * Requires an OAuth2 access token with the `guilds.join` scope
+     *
+     * Fires a _Guild Member Add_ gateway event.
+     *
+     * @see {@link https://discord.com/developers/docs/resources/guild#add-guild-member}
+     */
+    addGuildMember: (guildId: BigString, userId: BigString, options: AddGuildMemberOptions) => Promise<void>;
     /**
      * Creates an automod rule in a guild.
      *
@@ -206,7 +271,7 @@ export interface RestManager {
      * @returns An instance of the created {@link CamelizedDiscordEmoji}.
      *
      * @remarks
-     * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * Requires the `CREATE_GUILD_EXPRESSIONS` permission.
      *
      * Emojis have a maximum file size of 256 kilobits. Attempting to upload a larger emoji will cause the route to return 400 Bad Request.
      *
@@ -216,12 +281,12 @@ export interface RestManager {
      */
     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.
+     * Creates a new thread in a forum channel or media 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.
+     * @returns An instance of {@link CamelizedDiscordChannel} with a nested {@link CamelizedDiscordChannel} object.
      *
      * @remarks
      * Requires the `CREATE_MESSAGES` permission.
@@ -229,25 +294,27 @@ export interface RestManager {
      * Fires a _Thread Create_ gateway event.
      * Fires a _Message Create_ gateway event.
      *
-     * @see {@link https://discord.com/developers/docs/resources/channel#start-thread-in-forum-channel}
-     *
-     * @experimental
+     * @see {@link https://discord.com/developers/docs/resources/channel#start-thread-in-forum-or-media-channel}
      */
     createForumThread: (channelId: BigString, options: CreateForumPostWithMessage, reason?: string) => Promise<CamelizedDiscordChannel>;
     /**
      * Creates an application command accessible globally; across different guilds and channels.
      *
      * @param command - The command to create.
-     * @returns An instance of the created {@link ApplicationCommand}.
+     * @param options - Additional options for the endpoint
+     * @returns An instance of the created {@link CamelizedDiscordApplicationCommand}.
      *
      * @remarks
      * ⚠️ Creating a command with the same name as an existing command for your application will overwrite the old command.
      * ⚠️ Global commands once created are cached for periods of __an hour__, so changes made to existing commands will take an hour to surface.
      * ⚠️ You can only create up to 200 _new_ commands daily.
      *
+     * When using the bearer token the token needs the `applications.commands.update` scope and must be a `Client grant` token.
+     *  You will be able to update only your own application commands
+     *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#create-global-application-command}
      */
-    createGlobalApplicationCommand: (command: CreateApplicationCommand) => Promise<CamelizedDiscordApplicationCommand>;
+    createGlobalApplicationCommand: (command: CreateApplicationCommand, options?: CreateGlobalApplicationCommandOptions) => Promise<CamelizedDiscordApplicationCommand>;
     /**
      * Creates a guild.
      *
@@ -267,21 +334,25 @@ export interface RestManager {
      *
      * @param command - The command to create.
      * @param guildId - The ID of the guild to create the command for.
-     * @returns An instance of the created {@link ApplicationCommand}.
+     * @param options - Additional options for the endpoint
+     * @returns An instance of the created {@link CamelizedDiscordApplicationCommand}.
      *
      * @remarks
      * ⚠️ Creating a command with the same name as an existing command for your application will overwrite the old command.
      * ⚠️ You can only create up to 200 _new_ commands daily.
      *
+     * When using the bearer token the token needs the `applications.commands.update` scope and must be a `Client grant` token.
+     *  You will be able to update only your own application commands
+     *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#create-guild-application-command}
      */
-    createGuildApplicationCommand: (command: CreateApplicationCommand, guildId: BigString) => Promise<CamelizedDiscordApplicationCommand>;
+    createGuildApplicationCommand: (command: CreateApplicationCommand, guildId: BigString, options?: CreateGuildApplicationCommandOptions) => Promise<CamelizedDiscordApplicationCommand>;
     /**
      * Creates a guild from a template.
      *
      * @param templateCode - The code of the template.
      * @param options - The parameters for the creation of the guild.
-     * @returns An instance of the created {@link Guild}.
+     * @returns An instance of the created {@link CamelizedDiscordGuild}.
      *
      * @remarks
      * ⚠️ This route can only be used by bots in __fewer than 10 guilds__.
@@ -299,7 +370,7 @@ export interface RestManager {
      * @return A {@link CamelizedDiscordSticker}
      *
      * @remarks
-     * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * Requires the `CREATE_GUILD_EXPRESSIONS` permission.
      * Fires a Guild Stickers Update Gateway event.
      * Every guilds has five free sticker slots by default, and each Boost level will grant access to more slots.
      * Lottie stickers can only be uploaded on guilds that have either the `VERIFIED` and/or the `PARTNERED` guild feature.
@@ -312,7 +383,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to create the template from.
      * @param options - The parameters for the creation of the template.
-     * @returns An instance of the created {@link Template}.
+     * @returns An instance of the created {@link CamelizedDiscordTemplate}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -363,12 +434,12 @@ 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}.
+     * @returns An instance of the created {@link CamelizedDiscordScheduledEvent}.
      *
      * @remarks
      * Requires the `MANAGE_EVENTS` permission.
      *
-     * A guild can only have a maximum of 100 events with a status of {@link ScheduledEventStatus.Active} or {@link ScheduledEventStatus.Scheduled} (inclusive).
+     * A guild can only have a maximum of 100 events with a status of {@link ScheduledEventStatus}.Active or {@link ScheduledEventStatus}.Scheduled (inclusive).
      *
      * Fires a _Guild Scheduled Event Create_ gateway event.
      *
@@ -428,7 +499,7 @@ export interface RestManager {
      *
      * @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}.
+     * @returns nothing
      *
      * @remarks
      * For community guilds, the _Rules_, _Guidelines_ and _Community Update_ channels cannot be deleted.
@@ -472,7 +543,8 @@ export interface RestManager {
      * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
-     * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * For emojis created by the current user, requires either the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.
+     * For other emojis, requires the `MANAGE_GUILD_EXPRESSIONS` permission.
      *
      * Fires a _Guild Emojis Update_ gateway event.
      *
@@ -531,7 +603,8 @@ export interface RestManager {
      * @return A {@link CamelizedDiscordSticker}
      *
      * @remarks
-     * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * For stickers created by the current user, requires either the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.
+     * For other stickers, requires the `MANAGE_GUILD_EXPRESSIONS` permission.
      * Fires a Guild Stickers Update Gateway event.
      * Every guilds has five free sticker slots by default, and each Boost level will grant access to more slots.
      * Lottie stickers can only be uploaded on guilds that have either the `VERIFIED` and/or the `PARTNERED` guild feature.
@@ -786,14 +859,14 @@ export interface RestManager {
      * @param commandId - The ID of the command to edit the permissions of.
      * @param bearerToken - The bearer token to use to make the request.
      * @param options - The parameters for the edit of the command permissions.
-     * @returns An instance of the edited {@link ApplicationCommandPermission}.
+     * @returns An instance of the edited {@link CamelizedDiscordGuildApplicationCommandPermissions}.
      *
      * @remarks
      * The bearer token requires the `applications.commands.permissions.update` scope to be enabled, and to have access to the guild whose ID has been provided in the parameters.
      *
      * @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.
      *
@@ -812,12 +885,13 @@ export interface RestManager {
      */
     editAutomodRule: (guildId: BigString, ruleId: BigString, options: Partial<EditAutoModerationRuleOptions>, reason?: string) => Promise<CamelizedDiscordAutoModerationRule>;
     /**
-     * Modifies the bot's username or avatar.
+     * Modifies the bot's username, avatar or banner.
      * NOTE: username: if changed may cause the bot's discriminator to be randomized.
      */
     editBotProfile: (options: {
         username?: string;
         botAvatarURL?: string | null;
+        botBannerURL?: string | null;
     }) => Promise<CamelizedDiscordUser>;
     /**
      * Edits a channel's settings.
@@ -828,7 +902,7 @@ export interface RestManager {
      * @returns An instance of the edited {@link CamelizedDiscordChannel}.
      *
      * @remarks
-     * If editing a channel of type {@link ChannelTypes.GroupDm}:
+     * If editing a channel of type {@link ChannelTypes}.GroupDm:
      * - Fires a _Channel Update_ gateway event.
      *
      * If editing a thread channel:
@@ -844,7 +918,7 @@ export interface RestManager {
      *
      *   - Only permissions the bot user has in the guild or parent channel can be allowed/denied __unless__ the bot user has a `MANAGE_ROLES` permission override in the channel.
      *
-     * - If modifying a channel of type {@link ChannelTypes.GuildCategory}:
+     * - If modifying a channel of type {@link ChannelTypes}.GuildCategory:
      *     - Fires a _Channel Update_ gateway event for each child channel impacted in this change.
      * - Otherwise:
      *     - Fires a _Channel Update_ gateway event.
@@ -891,7 +965,8 @@ export interface RestManager {
      * @returns An instance of the updated {@link CamelizedDiscordEmoji}.
      *
      * @remarks
-     * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * For emojis created by the current user, requires either the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.
+     * For other emojis, requires the `MANAGE_GUILD_EXPRESSIONS` permission.
      *
      * Fires a `Guild Emojis Update` gateway event.
      *
@@ -904,7 +979,7 @@ export interface RestManager {
      * @param token - The interaction token to use, provided in the original interaction.
      * @param messageId - The ID of the message to edit.
      * @param options - The parameters for the edit of the message.
-     * @returns An instance of the edited {@link Message}.
+     * @returns An instance of the edited {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * Unlike `editMessage()`, this endpoint allows the bot user to act without needing to see the channel the message is in.
@@ -921,7 +996,7 @@ export interface RestManager {
      *
      * @param commandId - The ID of the command to edit.
      * @param options - The parameters for the edit of the command.
-     * @returns An instance of the edited {@link ApplicationCommand}.
+     * @returns An instance of the edited {@link CamelizedDiscordApplicationCommand}.
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#edit-global-application-command}
      */
@@ -933,12 +1008,12 @@ export interface RestManager {
      * @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}.
+     * @returns An instance of the edited {@link CamelizedDiscordGuild}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
      *
-     * If attempting to add or remove the {@link GuildFeatures.Community} feature:
+     * If attempting to add or remove the {@link GuildFeatures}.Community feature:
      * - Requires the `ADMINISTRATOR` permission.
      *
      * Fires a _Guild Update_ gateway event.
@@ -952,7 +1027,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild the command is registered in.
      * @param commandId - The ID of the command to edit.
      * @param options - The parameters for the edit of the command.
-     * @returns An instance of the edited {@link ApplicationCommand}.
+     * @returns An instance of the edited {@link CamelizedDiscordApplicationCommand}.
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command}
      */
@@ -969,7 +1044,8 @@ export interface RestManager {
      * @return A {@link CamelizedDiscordSticker}
      *
      * @remarks
-     * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * For stickers created by the current user, requires either the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.
+     * For other stickers, requires the `MANAGE_GUILD_EXPRESSIONS` permission.
      * Fires a Guild Stickers Update Gateway event.
      *
      * @see {@link https://discord.com/developers/docs/resources/sticker#modify-guild-sticker}
@@ -981,7 +1057,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild to edit a template of.
      * @param templateCode - The code of the template to edit.
      * @param options - The parameters for the edit of the template.
-     * @returns An instance of the edited {@link Template}.
+     * @returns An instance of the edited {@link CamelizedDiscordTemplate}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -997,7 +1073,7 @@ export interface RestManager {
      * @param channelId - The ID of the channel to edit the message in.
      * @param messageId - The IDs of the message to edit.
      * @param options - The parameters for the edit of the message.
-     * @returns An instance of the edited {@link Message}.
+     * @returns An instance of the edited {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * If editing another user's message:
@@ -1014,7 +1090,7 @@ export interface RestManager {
      *
      * @param token - The interaction token to use, provided in the original interaction.
      * @param options - The parameters for the edit of the response.
-     * @returns An instance of the edited {@link Message}.
+     * @returns An instance of the edited {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * Unlike `editMessage()`, this endpoint allows the bot user to act without needing to see the channel the message is in.
@@ -1025,7 +1101,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.
      *
@@ -1099,14 +1175,14 @@ export interface RestManager {
      * @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}.
+     * @returns An instance of the edited {@link CamelizedDiscordScheduledEvent}.
      *
      * @remarks
      * Requires the `MANAGE_EVENTS` permission.
      *
      * To start or end an event, modify the event's `status` property.
      *
-     * The `entity_metadata` property is discarded for events whose `entity_type` is not {@link ScheduledEventEntityType.External}.
+     * The `entity_metadata` property is discarded for events whose `entity_type` is not {@link ScheduledEventEntityType}.External.
      *
      * Fires a _Guild Scheduled Event Update_ gateway event.
      *
@@ -1143,6 +1219,20 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state}
      */
     editUserVoiceState: (guildId: BigString, options: EditUserVoiceState) => Promise<void>;
+    /**
+     * Edit the current user application role connection for the application.
+     *
+     * @param bearerToken - The access token of the user
+     * @param applicationId - The id of the application to edit the role connection
+     * @param options - The options to edit
+     * @returns {CamelizedDiscordApplicationRoleConnection}
+     *
+     * @remarks
+     * This requires the `role_connections.write` scope.
+     *
+     * @see {@link https://discord.com/developers/docs/resources/user#update-user-application-role-connection}
+     */
+    editUserApplicationRoleConnection: (bearerToken: string, applicationId: BigString, options: CamelizedDiscordApplicationRoleConnection) => Promise<CamelizedDiscordApplicationRoleConnection>;
     /**
      * Edits a webhook.
      *
@@ -1196,7 +1286,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}.
+     * @returns An instance of the edited {@link CamelizedDiscordWelcomeScreen}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1211,7 +1301,7 @@ export interface RestManager {
      *
      * @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}.
+     * @returns An instance of the edited {@link CamelizedDiscordGuildWidgetSettings}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1240,6 +1330,7 @@ export interface RestManager {
      *
      * @param sourceChannelId - The ID of the announcement channel to follow.
      * @param targetChannelId - The ID of the target channel - the channel to cross-post to.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      * @returns An instance of {@link CamelizedDiscordFollowedChannel}.
      *
      * @remarks
@@ -1249,7 +1340,7 @@ export interface RestManager {
      *
      * @see {@link https://discord.com/developers/docs/resources/channel#follow-announcement-channel}
      */
-    followAnnouncement: (sourceChannelId: BigString, targetChannelId: BigString) => Promise<CamelizedDiscordFollowedChannel>;
+    followAnnouncement: (sourceChannelId: BigString, targetChannelId: BigString, reason?: string) => Promise<CamelizedDiscordFollowedChannel>;
     /**
      * Gets the list of all active threads for a guild.
      *
@@ -1266,31 +1357,73 @@ export interface RestManager {
     getActiveThreads: (guildId: BigString) => Promise<CamelizedDiscordActiveThreads>;
     /** Get the applications info */
     getApplicationInfo: () => Promise<CamelizedDiscordApplication>;
+    /**
+     * Edit properties of the app associated with the requesting bot user.
+     *
+     * @remarks
+     * Only properties that are passed will be updated.
+     */
+    editApplicationInfo: (body: EditApplication) => Promise<CamelizedDiscordApplication>;
+    /**
+     * Get the current authentication info for the authenticated user
+     *
+     * @param bearerToken - Any OAuth2 derived access token
+     * @returns An instance of {@link CamelizedDiscordCurrentAuthorization}
+     *
+     * @remarks
+     * The user object is not defined if the scopes do not include `identify`.
+     * In the user object, if defined, the email is not included if the scopes do not include `email`
+     */
+    getCurrentAuthenticationInfo: (bearerToken: string) => Promise<CamelizedDiscordCurrentAuthorization>;
+    /**
+     * Exchange the information to get a OAuth2 accessToken token
+     *
+     * @param clientId - Application's client id
+     * @param clientSecret - application's client secret
+     * @param options - The options to make the exchange with discord
+     */
+    exchangeToken: (clientId: BigString, clientSecret: string, options: CamelizedDiscordTokenExchange) => Promise<CamelizedDiscordAccessTokenResponse>;
+    /**
+     * Revoke an access_token
+     *
+     * @param clientId - Application's client id
+     * @param clientSecret - application's client secret
+     * @param options - The options to revoke the access_token
+     */
+    revokeToken: (clientId: BigString, clientSecret: string, options: CamelizedDiscordTokenRevocation) => Promise<void>;
     /**
      * Gets the permissions of a guild application command.
      *
      * @param guildId - The ID of the guild the command is registered in.
      * @param commandId - The ID of the command to get the permissions of.
-     * @returns An instance of {@link ApplicationCommandPermission}.
+     * @param options - The OAuth2 related optional parameters for the endpoint
+     * @returns An instance of {@link CamelizedDiscordGuildApplicationCommandPermissions}.
+     *
+     * @remarks
+     * Then specifying the options object the access token passed-in requires the OAuth2 scope `applications.commands.permissions.update`
      *
      * @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, options?: GetApplicationCommandPermissionOptions) => Promise<CamelizedDiscordGuildApplicationCommandPermissions>;
     /**
-     * Gets the permissions of all application commands registered in a guild by the ID of the guild.
+     * Gets the permissions of all application commands registered in a guild by the ID of the guild and optionally an external application.
      *
      * @param guildId - The ID of the guild to get the permissions objects of.
-     * @returns A collection of {@link ApplicationCommandPermission} objects assorted by command ID.
+     * @param options - The OAuth2 related optional parameters for the endpoint
+     * @returns A collection of {@link CamelizedDiscordGuildApplicationCommandPermissions} objects assorted by command ID.
+     *
+     * @remarks
+     * Then specifying the options object the access token passed-in requires the OAuth2 scope `applications.commands.permissions.update`
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#get-guild-application-command-permissions}
      */
-    getApplicationCommandPermissions: (guildId: BigString) => Promise<CamelizedDiscordApplicationCommandPermissions[]>;
+    getApplicationCommandPermissions: (guildId: BigString, options?: GetApplicationCommandPermissionOptions) => Promise<CamelizedDiscordGuildApplicationCommandPermissions[]>;
     /**
      * Gets a guild's audit log.
      *
      * @param guildId - The ID of the guild to get the audit log of.
      * @param options - The parameters for the fetching of the audit log.
-     * @returns An instance of {@link AuditLog}.
+     * @returns An instance of {@link CamelizedDiscordAuditLog}.
      *
      * @remarks
      * Requires the `VIEW_AUDIT_LOG` permission.
@@ -1326,7 +1459,7 @@ export interface RestManager {
     /**
      * Gets the list of available voice regions.
      *
-     * @returns A collection of {@link VoiceRegions | VoiceRegion} objects assorted by voice region ID.
+     * @returns A collection of {@link CamelizedDiscordVoiceRegion} objects assorted by voice region ID.
      */
     getAvailableVoiceRegions: () => Promise<CamelizedDiscordVoiceRegion[]>;
     /**
@@ -1364,7 +1497,7 @@ export interface RestManager {
      * @returns An instance of {@link CamelizedDiscordChannel}.
      *
      * @remarks
-     * If the channel is a thread, a {@link ThreadMember} object is included in the result.
+     * If the channel is a thread, a {@link CamelizedDiscordThreadMember} object is included in the result.
      *
      * @see {@link https://discord.com/developers/docs/resources/channel#get-channel}
      */
@@ -1416,6 +1549,22 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/user#create-dm}
      */
     getDmChannel: (userId: BigString) => Promise<CamelizedDiscordChannel>;
+    /**
+     * Create a new group DM channel with multiple users.
+     *
+     * @param options - The options for create a new group dm
+     * @returns An instance of {@link CamelizedDiscordChannel}.
+     *
+     * @remarks
+     * The access tokens require to have the `gdm.join` scope
+     *
+     * This endpoint is limited to 10 active group DMs.
+     *
+     * Fires a _Channel create_ gateway event.
+     *
+     * @see {@link https://discord.com/developers/docs/resources/user#create-group-dm}
+     */
+    getGroupDmChannel: (options: GetGroupDmOptions) => Promise<CamelizedDiscordChannel>;
     /**
      * Gets an emoji by its ID.
      *
@@ -1423,6 +1572,10 @@ export interface RestManager {
      * @param emojiId - The ID of the emoji to get.
      * @returns An instance of {@link CamelizedDiscordEmoji}.
      *
+     * @remarks
+     * Includes the `user` field if the bot has the `MANAGE_GUILD_EXPRESSIONS` permission,
+     * or if the bot created the emoji and has the the `CREATE_GUILD_EXPRESSIONS` permission.
+     *
      * @see {@link https://discord.com/developers/docs/resources/emoji#get-guild-emoji}
      */
     getEmoji: (guildId: BigString, emojiId: BigString) => Promise<CamelizedDiscordEmoji>;
@@ -1432,6 +1585,9 @@ export interface RestManager {
      * @param guildId - The ID of the guild which to get the emojis of.
      * @returns A collection of {@link CamelizedDiscordEmoji} objects assorted by emoji ID.
      *
+     * @remarks
+     * Includes `user` fields if the bot has the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.
+     *
      * @see {@link https://discord.com/developers/docs/resources/emoji#list-guild-emojis}
      */
     getEmojis: (guildId: BigString) => Promise<CamelizedDiscordEmoji[]>;
@@ -1440,7 +1596,7 @@ export interface RestManager {
      *
      * @param token - The interaction token to use, provided in the original interaction.
      * @param messageId - The ID of the message to get.
-     * @returns An instance of {@link Message}.
+     * @returns An instance of {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * Unlike `getMessage()`, this endpoint allows the bot user to act without:
@@ -1458,7 +1614,7 @@ export interface RestManager {
      * Gets a global application command by its ID.
      *
      * @param commandId - The ID of the command to get.
-     * @returns An instance of {@link ApplicationCommand}.
+     * @returns An instance of {@link CamelizedDiscordApplicationCommand}.
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#get-global-application-command}
      */
@@ -1466,7 +1622,7 @@ export interface RestManager {
     /**
      * Gets the list of your bot's global application commands.
      *
-     * @returns A collection of {@link ApplicationCommand} objects assorted by command ID.
+     * @returns A collection of {@link CamelizedDiscordApplicationCommand} objects assorted by command ID.
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#get-global-application-commands}
      */
@@ -1476,19 +1632,32 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to get.
      * @param options - The parameters for the fetching of the guild.
-     * @returns An instance of {@link Guild}.
+     * @returns An instance of {@link CamelizedDiscordGuild}.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#get-guild}
      */
     getGuild: (guildId: BigString, options?: {
         counts?: boolean;
     }) => Promise<CamelizedDiscordGuild>;
+    /**
+     * Get the user guilds.
+     *
+     * @param bearerToken - The access token of the user, if unspecified the bot token is used instead
+     * @param options - The parameters for the fetching of the guild.
+     * @returns An instance of {@link CamelizedDiscordGuild}.
+     *
+     * @remarks
+     * If used with an access token, the token needs to have the `guilds` scope
+     *
+     * @see {@link https://discord.com/developers/docs/resources/user#get-current-user-guilds}
+     */
+    getGuilds: (bearerToken?: string, options?: GetUserGuilds) => Promise<CamelizedDiscordPartialGuild[]>;
     /**
      * Gets a guild application command by its ID.
      *
      * @param guildId - The ID of the guild the command is registered in.
      * @param commandId - The ID of the command to get.
-     * @returns An instance of {@link ApplicationCommand}.
+     * @returns An instance of {@link CamelizedDiscordApplicationCommand}.
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#get-guild-application-command}
      */
@@ -1497,7 +1666,7 @@ export interface RestManager {
      * Gets the list of application commands registered by your bot in a guild.
      *
      * @param guildId - The ID of the guild the commands are registered in.
-     * @returns A collection of {@link ApplicationCommand} objects assorted by command ID.
+     * @returns A collection of {@link CamelizedDiscordApplicationCommand} objects assorted by command ID.
      *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#get-global-application-commandss}
      */
@@ -1506,10 +1675,10 @@ export interface RestManager {
      * Gets the preview of a guild by a guild's ID.
      *
      * @param guildId - The ID of the guild to get the preview of.
-     * @returns An instance of {@link GuildPreview}.
+     * @returns An instance of {@link CamelizedDiscordGuildPreview}.
      *
      * @remarks
-     * If the bot user is not in the guild, the guild must be lurkable.
+     * If the bot user is not in the guild, the guild must be discoverable.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#get-guild-preview}
      */
@@ -1521,7 +1690,7 @@ export interface RestManager {
      * @param stickerId The ID of the sticker to get
      * @return A {@link CamelizedDiscordSticker}
      *
-     * @remarks Includes the user field if the bot has the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * @remarks Includes the user field if the bot has the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.
      *
      * @see {@link https://discord.com/developers/docs/resources/sticker#get-guild-sticker}
      */
@@ -1532,7 +1701,7 @@ export interface RestManager {
      * @param guildId The ID of the guild to get
      * @returns A collection of {@link CamelizedDiscordSticker} objects assorted by sticker ID.
      *
-     * @remarks Includes user fields if the bot has the `MANAGE_EMOJIS_AND_STICKERS` permission.
+     * @remarks Includes user fields if the bot has the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.
      *
      * @see {@link https://discord.com/developers/docs/resources/sticker#list-guild-stickers}
      */
@@ -1541,7 +1710,7 @@ export interface RestManager {
      * Gets a template by its code.
      *
      * @param templateCode - The code of the template to get.
-     * @returns An instance of {@link Template}.
+     * @returns An instance of {@link CamelizedDiscordTemplate}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1553,7 +1722,7 @@ export interface RestManager {
      * Gets the list of templates for a guild.
      *
      * @param guildId - The ID of the guild to get the list of templates for.
-     * @returns A collection of {@link Template} objects assorted by template code.
+     * @returns A collection of {@link CamelizedDiscordTemplate} objects assorted by template code.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1577,7 +1746,7 @@ export interface RestManager {
      * Gets the list of integrations attached to a guild.
      *
      * @param guildId - The ID of the guild to get the list of integrations from.
-     * @returns A collection of {@link Integration} objects assorted by integration ID.
+     * @returns A collection of {@link CamelizedDiscordIntegration} objects assorted by integration ID.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1599,7 +1768,7 @@ export interface RestManager {
      * Gets the list of invites for a guild.
      *
      * @param guildId - The ID of the guild to get the invites from.
-     * @returns A collection of {@link InviteMetadata | Invite} objects assorted by invite code.
+     * @returns A collection of {@link CamelizedDiscordInviteMetadata} objects assorted by invite code.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1612,7 +1781,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel from which to get the message.
      * @param messageId - The ID of the message to get.
-     * @returns An instance of {@link Message}.
+     * @returns An instance of {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * Requires that the bot user be able to see the contents of the channel in which the message was posted.
@@ -1628,7 +1797,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel from which to get the messages.
      * @param options - The parameters for the fetching of the messages.
-     * @returns A collection of {@link Message} objects assorted by message ID.
+     * @returns A collection of {@link CamelizedDiscordMessage} objects assorted by message ID.
      *
      * @remarks
      * Requires that the bot user be able to see the contents of the channel in which the messages were posted.
@@ -1640,18 +1809,18 @@ export interface RestManager {
      */
     getMessages: (channelId: BigString, options?: GetMessagesOptions) => Promise<CamelizedDiscordMessage[]>;
     /**
-     * Returns the list of sticker packs available to Nitro subscribers.
+     * Returns the list of sticker packs available.
      *
-     * @returns A collection of {@link StickerPack} objects assorted by sticker ID.
+     * @returns A collection of {@link CamelizedDiscordStickerPack} objects assorted by sticker ID.
      *
-     * @see {@link https://discord.com/developers/docs/resources/sticker#list-nitro-sticker-packs}
+     * @see {@link https://discord.com/developers/docs/resources/sticker#list-sticker-packs}
      */
-    getNitroStickerPacks: () => Promise<CamelizedDiscordStickerPack[]>;
+    getStickerPacks: () => Promise<CamelizedDiscordStickerPack[]>;
     /**
      * Gets the initial message response to an interaction.
      *
      * @param token - The interaction token to use, provided in the original interaction.
-     * @returns An instance of {@link Message}.
+     * @returns An instance of {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * Unlike `getMessage()`, this endpoint allows the bot user to act without:
@@ -1667,7 +1836,7 @@ export interface RestManager {
      * Gets the pinned messages for a channel.
      *
      * @param channelId - The ID of the channel to get the pinned messages for.
-     * @returns A collection of {@link Message} objects assorted by message ID.
+     * @returns A collection of {@link CamelizedDiscordMessage} objects assorted by message ID.
      *
      * @remarks
      * Requires that the bot user be able to see the contents of the channel in which the messages were posted.
@@ -1689,7 +1858,7 @@ export interface RestManager {
      * Requires the `READ_MESSAGE_HISTORY` permission.
      * Requires the `MANAGE_THREADS` permission.
      *
-     * Returns threads of type {@link ChannelTypes.GuildPrivateThread}.
+     * Returns threads of type {@link ChannelTypes}.GuildPrivateThread.
      *
      * Threads are ordered by the `archive_timestamp` property included in the metadata of the object in descending order.
      *
@@ -1706,7 +1875,7 @@ export interface RestManager {
      * @remarks
      * Requires the `READ_MESSAGE_HISTORY` permission.
      *
-     * Returns threads of type {@link ChannelTypes.GuildPrivateThread}.
+     * Returns threads of type {@link ChannelTypes}.GuildPrivateThread.
      *
      * Threads are ordered by the `id` property in descending order.
      *
@@ -1721,7 +1890,7 @@ export interface RestManager {
      * @returns A number indicating the number of members that would be kicked.
      *
      * @remarks
-     * Requires the `KICK_MEMBERS` permission.
+     * Requires the `MANAGE_GUILD` and `KICK_MEMBERS` permissions.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#get-guild-prune-count}
      */
@@ -1731,13 +1900,13 @@ export interface RestManager {
      *
      * @param channelId - The ID of the channel to get the archived threads for.
      * @param options - The parameters for the fetching of threads.
-     * @returns An instance of {@link ArchivedThreads}.
+     * @returns An instance of {@link CamelizedDiscordArchivedThreads}.
      *
      * @remarks
      * Requires the `READ_MESSAGE_HISTORY` permission.
      *
-     * If called on a channel of type {@link ChannelTypes.GuildText}, returns threads of type {@link ChannelTypes.GuildPublicThread}.
-     * If called on a channel of type {@link ChannelTypes.GuildNews}, returns threads of type {@link ChannelTypes.GuildNewsThread}.
+     * If called on a channel of type {@link ChannelTypes}.GuildText, returns threads of type {@link ChannelTypes}.GuildPublicThread.
+     * If called on a channel of type {@link ChannelTypes}.GuildNews, returns threads of type {@link ChannelTypes}.GuildNewsThread.
      *
      * Threads are ordered by the `archive_timestamp` property included in the metadata of the object in descending order.
      *
@@ -1748,10 +1917,10 @@ export interface RestManager {
      * Gets the list of roles for a guild.
      *
      * @param guildId - The ID of the guild to get the list of roles for.
-     * @returns A collection of {@link DisorcRole} objects assorted by role ID.
+     * @returns A collection of {@link CamelizedDiscordRole} objects assorted by role ID.
      *
      * @remarks
-     * ⚠️ This endpoint should be used sparingly due to {@link User} objects already being included in guild payloads.
+     * ⚠️ This endpoint should be used sparingly due to {@link CamelizedDiscordRole} objects already being included in guild payloads.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#get-guild-roles}
      */
@@ -1762,7 +1931,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild to get the scheduled event from.
      * @param eventId - The ID of the scheduled event to get.
      * @param options - The parameters for the fetching of the scheduled event.
-     * @returns An instance of {@link ScheduledEvent}.
+     * @returns An instance of {@link CamelizedDiscordScheduledEvent}.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild-scheduled-event#get-guild-scheduled-event}
      */
@@ -1774,7 +1943,7 @@ export interface RestManager {
      *
      * @param guildId - The ID of the guild to get the scheduled events from.
      * @param options - The parameters for the fetching of the scheduled events.
-     * @returns A collection of {@link ScheduledEvent} objects assorted by event ID.
+     * @returns A collection of {@link CamelizedDiscordScheduledEvent} objects assorted by event ID.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild-scheduled-event#list-scheduled-events-for-guild}
      */
@@ -1785,7 +1954,7 @@ export interface RestManager {
      * @param guildId - The ID of the guild to get the subscribers to the scheduled event from.
      * @param eventId - The ID of the scheduled event to get the subscribers of.
      * @param options - The parameters for the fetching of the subscribers.
-     * @returns A collection of {@link User} objects assorted by user ID.
+     * @returns A collection of {@link CamelizedDiscordUser} objects assorted by user ID.
      *
      * @remarks
      * Requires the `MANAGE_EVENTS` permission.
@@ -1847,7 +2016,7 @@ export interface RestManager {
      * @param messageId - The ID of the message to get the users for.
      * @param reaction - The reaction for which to get the users.
      * @param options - The parameters for the fetching of the users.
-     * @returns A collection of {@link User} objects assorted by user ID.
+     * @returns A collection of {@link CamelizedDiscordUser} objects assorted by user ID.
      *
      * @see {@link https://discord.com/developers/docs/resources/channel#get-reactions}
      */
@@ -1859,11 +2028,46 @@ export interface RestManager {
      * @returns {CamelizedDiscordUser}
      */
     getUser: (id: BigString) => Promise<CamelizedDiscordUser>;
+    /**
+     * Get the current user data.
+     *
+     * @param bearerToken - The access token of the user
+     * @returns {CamelizedDiscordUser}
+     *
+     * @remarks
+     * This requires the `identify` scope.
+     *
+     * To get the mail this also requires the `email` scope
+     */
+    getCurrentUser: (bearerToken: string) => Promise<CamelizedDiscordUser>;
+    /**
+     * Get the current user connections.
+     *
+     * @param bearerToken - The access token of the user
+     * @returns {CamelizedDiscordConnection[]}
+     *
+     * @remarks
+     * This requires the `connections` scope.
+     */
+    getUserConnections: (bearerToken: string) => Promise<CamelizedDiscordConnection[]>;
+    /**
+     * Get the current user application role connection for the application.
+     *
+     * @param bearerToken - The access token of the user
+     * @param applicationId - The id of the application to get the role connection
+     * @returns {CamelizedDiscordApplicationRoleConnection}
+     *
+     * @remarks
+     * The access token requires the `role_connections.write` scope.
+     *
+     * @see {@link https://discord.com/developers/docs/resources/user#get-user-application-role-connection}
+     */
+    getUserApplicationRoleConnection: (bearerToken: string, applicationId: BigString) => Promise<CamelizedDiscordApplicationRoleConnection>;
     /**
      * Gets information about the vanity url of a guild.
      *
      * @param guildId - The ID of the guild to get the vanity url information for.
-     * @returns An instance of {@link VanityUrl}.
+     * @returns An instance of {@link CamelizedDiscordVanityUrl}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1877,7 +2081,7 @@ export interface RestManager {
      * Gets the list of voice regions for a guild.
      *
      * @param guildId - The ID of the guild to get the voice regions for.
-     * @returns A collection of {@link VoiceRegions | VoiceRegion} objects assorted by voice region ID.
+     * @returns A collection of {@link CamelizedDiscordVoiceRegion} objects assorted by voice region ID.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#get-guild-voice-regions}
      */
@@ -1920,7 +2124,7 @@ export interface RestManager {
      * Gets the welcome screen for a guild.
      *
      * @param guildId - The ID of the guild to get the welcome screen for.
-     * @returns An instance of {@link WelcomeScreen}.
+     * @returns An instance of {@link CamelizedDiscordWelcomeScreen}.
      *
      * @remarks
      * If the welcome screen is not enabled:
@@ -1933,7 +2137,10 @@ export interface RestManager {
      * Gets the guild widget by guild ID.
      *
      * @param guildId - The ID of the guild to get the widget of.
-     * @returns An instance of {@link GuildWidget}.
+     * @returns An instance of {@link CamelizedDiscordGuildWidget}.
+     *
+     * @remarks
+     * Fires an `INVITE_CREATED` Gateway event when an invite channel is defined and a new `Invite` is generated.
      *
      * @see {@link https://discord.com/developers/docs/resources/guild#get-guild-widget}
      */
@@ -1942,7 +2149,7 @@ export interface RestManager {
      * Gets the settings of a guild's widget.
      *
      * @param guildId - The ID of the guild to get the widget of.
-     * @returns An instance of {@link GuildWidgetSettings}.
+     * @returns An instance of {@link CamelizedDiscordGuildWidgetSettings}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -1992,7 +2199,7 @@ export interface RestManager {
      *
      * @param channelId - The ID of the announcement channel.
      * @param messageId - The ID of the message to cross-post.
-     * @returns An instance of the cross-posted {@link Message}.
+     * @returns An instance of the cross-posted {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * Requires the `SEND_MESSAGES` permission.
@@ -2028,7 +2235,7 @@ export interface RestManager {
      * @param userId - The user ID of the thread member to remove.
      *
      * @remarks
-     * If the thread is of type {@link ChannelTypes.GuildPrivateThread}, requires to be the creator of the thread.
+     * If the thread is of type {@link ChannelTypes}.GuildPrivateThread, requires to be the creator of the thread.
      * Otherwise, requires the `MANAGE_THREADS` permission.
      *
      * Requires the thread not be archived.
@@ -2038,6 +2245,15 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/channel#remove-thread-member}
      */
     removeThreadMember: (channelId: BigString, userId: BigString) => Promise<void>;
+    /**
+     * Removes a member from a Group DM.
+     *
+     * @param channelId - The ID of the channel to remove the recipient user of.
+     * @param userId - The user ID of the user to remove.
+     *
+     * @see {@link https://discord.com/developers/docs/resources/channel#group-dm-remove-recipient}
+     */
+    removeDmRecipient: (channelId: BigString, userId: BigString) => Promise<void>;
     /**
      * Sends a message to a channel.
      *
@@ -2070,7 +2286,7 @@ export interface RestManager {
      *
      * @param token - The interaction token to use, provided in the original interaction.
      * @param options - The parameters for the creation of the message.
-     * @returns An instance of the created {@link Message}.
+     * @returns An instance of the created {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * ⚠️ Interaction tokens are only valid for _15 minutes_.
@@ -2092,7 +2308,7 @@ export interface RestManager {
      * @param interactionId - The ID of the interaction to respond to.
      * @param token - The interaction token to use, provided in the original interaction.
      * @param options - The parameters for the creation of the message.
-     * @returns An instance of the created {@link Message}.
+     * @returns An instance of the created {@link CamelizedDiscordMessage}.
      *
      * @remarks
      * ⚠️ Interaction tokens are only valid for _15 minutes_.
@@ -2115,12 +2331,12 @@ export interface RestManager {
      * @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}.
+     * @returns An instance of the created {@link CamelizedDiscordChannel}.
      *
      * @remarks
-     * If called on a channel of type {@link ChannelTypes.GuildText}, creates a {@link ChannelTypes.GuildPublicThread}.
-     * If called on a channel of type {@link ChannelTypes.GuildNews}, creates a {@link ChannelTypes.GuildNewsThread}.
-     * Does not work on channels of type {@link ChannelTypes.GuildForum}.
+     * If called on a channel of type {@link ChannelTypes}.GuildText, creates a {@link ChannelTypes}.GuildPublicThread.
+     * If called on a channel of type {@link ChannelTypes}.GuildNews, creates a {@link ChannelTypes}.GuildNewsThread.
+     * Does not work on channels of type {@link ChannelTypes}.GuildForum.
      *
      * The ID of the created thread will be the same as the ID of the source message.
      *
@@ -2145,11 +2361,34 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/channel#start-thread-without-message}
      */
     startThreadWithoutMessage: (channelId: BigString, options: StartThreadWithoutMessage, reason?: string) => Promise<CamelizedDiscordChannel>;
+    /**
+     * Get a list of users that voted for this specific answer.
+     *
+     * @param channelId - The ID of the channel in which the message with the poll lives
+     * @param messageId - The ID of the message in which the poll lives
+     * @param answerId - The ID of the answer to get the users that voted that answer
+     * @param options - The options for the request
+     * @returns The list of users that voted for the specific answer.
+     */
+    getPollAnswerVoters: (channelId: BigString, messageId: BigString, answerId: number, options?: GetPollAnswerVotes) => Promise<CamelizedDiscordGetAnswerVotesResponse>;
+    /**
+     * Immediately ends the poll.
+     *
+     * @param channelId - The ID of the channel in which the message with the poll lives
+     * @param messageId - The ID of the message in which the poll lives
+     * @returns The message with the expired poll
+     *
+     * @remarks
+     * You cannot end polls from other users.
+     *
+     * Fires a _Message Update_ gateway event
+     */
+    endPoll: (channelId: BigString, messageId: BigString) => Promise<CamelizedDiscordMessage>;
     /**
      * Synchronises a template with the current state of a guild.
      *
      * @param guildId - The ID of the guild to synchronise a template of.
-     * @returns An instance of the edited {@link Template}.
+     * @returns An instance of the edited {@link CamelizedDiscordTemplate}.
      *
      * @remarks
      * Requires the `MANAGE_GUILD` permission.
@@ -2160,12 +2399,14 @@ export interface RestManager {
      */
     syncGuildTemplate: (guildId: BigString) => Promise<CamelizedDiscordTemplate>;
     /**
-     * Triggers a typing indicator for the bot user.
+     * Triggers a typing indicator for the specified channel, which expires after 10 seconds.
      *
      * @param channelId - The ID of the channel in which to trigger the typing indicator.
      *
      * @remarks
-     * Generally, bots should _not_ use this route.
+     * Generally bots should **not** use this route.
+     * However, if a bot is responding to a command and expects the computation to take a few seconds,
+     * this endpoint may be called to let the user know that the bot is processing their message.
      *
      * Fires a _Typing Start_ gateway event.
      *
@@ -2176,38 +2417,46 @@ export interface RestManager {
      * Re-registers the list of global application commands, overwriting the previous commands completely.
      *
      * @param commands - The list of commands to use to overwrite the previous list.
-     * @returns A collection of {@link ApplicationCommand} objects assorted by command ID.
+     * @param options - Additional options for the endpoint.
+     * @returns A collection of {@link CamelizedDiscordApplicationCommand} objects assorted by command ID.
      *
      * @remarks
      * ❗ Commands that are not present in the `commands` array will be __deleted__.
      *
      * ⚠️ Commands that do not already exist will count towards the daily limit of _200_ new commands.
      *
+     * When using the bearer token the token needs the `applications.commands.update` scope and must be a `Client grant` token.
+     *  You will be able to update only your own application commands
+     *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-global-application-commands}
      */
-    upsertGlobalApplicationCommands: (commands: CreateApplicationCommand[]) => Promise<CamelizedDiscordApplicationCommand[]>;
+    upsertGlobalApplicationCommands: (commands: CreateApplicationCommand[], options?: UpsertGlobalApplicationCommandOptions) => Promise<CamelizedDiscordApplicationCommand[]>;
     /**
      * Re-registers the list of application commands registered in a guild, overwriting the previous commands completely.
      *
      * @param guildId - The ID of the guild whose list of commands to overwrite.
      * @param commands - The list of commands to use to overwrite the previous list.
-     * @returns A collection of {@link ApplicationCommand} objects assorted by command ID.
+     * @param options - Additional options for the endpoint.
+     * @returns A collection of {@link CamelizedDiscordApplicationCommand} objects assorted by command ID.
      *
      * @remarks
      * ❗ Commands that are not present in the `commands` array will be __deleted__.
      *
      * ⚠️ Commands that do not already exist will count towards the daily limit of _200_ new commands.
      *
+     * When using the bearer token the token needs the `applications.commands.update` scope and must be a `Client grant` token.
+     *  You will be able to update only your own application commands
+     *
      * @see {@link https://discord.com/developers/docs/interactions/application-commands#bulk-overwrite-guild-application-commands}
      */
-    upsertGuildApplicationCommands: (guildId: BigString, commands: CreateApplicationCommand[]) => Promise<CamelizedDiscordApplicationCommand[]>;
+    upsertGuildApplicationCommands: (guildId: BigString, commands: CreateApplicationCommand[], options?: UpsertGuildApplicationCommandOptions) => Promise<CamelizedDiscordApplicationCommand[]>;
     /**
      * 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.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
      *
      * @remarks
      * Requires the `BAN_MEMBERS` permission.
@@ -2217,6 +2466,23 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/guild#create-guild-ban}
      */
     banMember: (guildId: BigString, userId: BigString, options?: CreateGuildBan, reason?: string) => Promise<void>;
+    /**
+     * Bans up to 200 users from a guild.
+     *
+     * @param guildId - The ID of the guild to ban the users from.
+     * @param options - The users to ban and the other options for the ban.
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
+     *
+     * @remarks
+     * Requires the `BAN_MEMBERS` and `MANAGE_GUILD` permissions.
+     *
+     * If all provided users fail to be banned, discord will respond with an error (code: `500000: Failed to ban users`)
+     *
+     * Fires as many _Guild Ban Add_ gateway events as many user where banned.
+     *
+     * @see {@link https://discord.com/developers/docs/resources/guild#bulk-guild-ban}
+     */
+    bulkBanMembers: (guildId: BigString, options: CreateGuildBulkBan, reason?: string) => Promise<Camelize<DiscordBulkBan>>;
     /**
      * Edits the nickname of the bot user.
      *
@@ -2259,6 +2525,19 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/guild#get-guild-member}
      */
     getMember: (guildId: BigString, userId: BigString) => Promise<CamelizedDiscordMemberWithUser>;
+    /**
+     * Gets the current member object.
+     *
+     * @param bearerToken - The access token of the user
+     * @param guildId - The ID of the guild to get the member object for.
+     * @returns An instance of {@link CamelizedDiscordMemberWithUser}.
+     *
+     * @remarks
+     * The access tokens needs the `guilds.members.read` scope
+     *
+     * @see {@link https://discord.com/developers/docs/resources/user#get-current-user-guild-member}
+     */
+    getCurrentMember: (guildId: BigString, bearerToken: string) => Promise<CamelizedDiscordMemberWithUser>;
     /**
      * Gets the list of members for a guild.
      *
@@ -2323,7 +2602,7 @@ export interface RestManager {
      * @returns A number indicating how many members were pruned.
      *
      * @remarks
-     * Requires the `KICK_MEMBERS` permission.
+     * Requires the `MANAGE_GUILD` and `KICK_MEMBERS` permissions.
      *
      * ❗ Requests to this endpoint will time out for large guilds. To prevent this from happening, set the {@link BeginGuildPrune.computePruneCount} property of the {@link options} object parameter to `false`. This will begin the process of pruning, and immediately return `undefined`, rather than wait for the process to complete before returning the actual count of members that have been kicked.
      *
@@ -2381,6 +2660,63 @@ export interface RestManager {
      * @see {@link https://discord.com/developers/docs/resources/channel#unpin-message}
      */
     unpinMessage: (channelId: BigString, messageId: BigString, reason?: string) => Promise<void>;
+    /**
+     * Get the guild onboarding
+     *
+     * @param guildId - The guild to get the onboarding from
+     */
+    getGuildOnboarding: (guildId: BigString) => Promise<CamelizedDiscordGuildOnboarding>;
+    /**
+     * Modifies the onboarding configuration of the guild.
+     *
+     * @param guildId - The guild to get the onboarding from
+     * @param {string} [reason] - An optional reason for the action, to be included in the audit log.
+     *
+     * @remarks
+     * Requires the `MANAGE_GUILD` and `MANAGE_ROLES` permissions.
+     *
+     * Onboarding enforces constraints when enabled. These constraints are:
+     *  - at least 7 default channels
+     *  - at least 5 of the 7 channels must allow sending messages to the @everyone role
+     *
+     * The `mode` field modifies what is considered when enforcing these constraints.
+     */
+    editGuildOnboarding: (guildId: BigString, options: EditGuildOnboarding, reason?: string) => Promise<CamelizedDiscordGuildOnboarding>;
+    /**
+     * Returns all entitlements for a given app, active and expired.
+     *
+     * @param applicationId - The id of the application to get the entitlements
+     * @param {GetEntitlements} [options] - The optional query params for the endpoint
+     */
+    listEntitlements: (applicationId: BigString, options?: GetEntitlements) => Promise<CamelizedDiscordEntitlement[]>;
+    /**
+     * Creates a test entitlement to a given SKU for a given guild or user. Discord will act as though that user or guild has entitlement to your premium offering.
+     *
+     * @param applicationId - The id of the application to create the entitlement
+     * @param body - The options for new entitlement
+     *
+     * @remarks
+     * This endpoint returns a partial entitlement object.
+     * It will not contain subscription_id, starts_at, or ends_at, as it's valid in perpetuity.
+     */
+    createTestEntitlement: (applicationId: BigString, body: CreateEntitlement) => Promise<Partial<CamelizedDiscordEntitlement>>;
+    /**
+     * Deletes a currently-active test entitlement. Discord will act as though that user or guild no longer has entitlement to your premium offering.
+     *
+     * @param applicationId - The id of the application from where delete the entitlement
+     * @param entitlementId - The id of the entitlement to delete
+     */
+    deleteTestEntitlement: (applicationId: BigString, entitlementId: BigString) => Promise<void>;
+    /**
+     * For One-Time Purchase consumable SKUs, marks a given entitlement for the user as consumed. The entitlement will have `consumed: true` when using {@link RestManager.listEntitlements | List Entitlements}
+     */
+    consumeEntitlement: (applicationId: BigString, entitlementId: BigString) => Promise<void>;
+    /**
+     * Returns all SKUs for a given application
+     *
+     * @param applicationId - The id of the application to get the SKUs
+     */
+    listSkus: (applicationId: BigString) => Promise<CamelizedDiscordSku[]>;
 }
 export type RequestMethods = 'GET' | 'POST' | 'DELETE' | 'PATCH' | 'PUT';
 export type ApiVersions = 9 | 10;