discordeno 16.0.0 → 17.0.0

package/README.md

@@ -6,88 +6,90 @@ Discord API library for [Deno](https://deno.land)
 
 Discordeno follows [semantic versioning](https://semver.org/)
 
-<!-- TODO: add coverage back when it is stable -->
-
 [![Discord](https://img.shields.io/discord/785384884197392384?color=7289da&logo=discord&logoColor=dark)](https://discord.com/invite/5vBgXk3UcZ)
 ![Test](https://github.com/discordeno/discordeno/workflows/Test/badge.svg)
 [![Coverage](https://img.shields.io/codecov/c/gh/discordeno/discordeno)](https://codecov.io/gh/discordeno/discordeno)
 
 ## Features
 
-- **Secure & stable**: Discordeno is actively maintained to ensure great performance and convenience.
-- **Simple, Efficient, & Lightweight**: Discordeno is simplistic, easy-to-use and versatile while being efficient and
-  lightweight. No caching by default.
-- **Functional API**: The functional API ensures overall concise yet performant code while removing the difficulties of
-  extending built-in classes and inheritance.
-- **Cross Runtime**: Supports both Deno and Node.js runtimes.
-- **Standalone REST, Gateway, Custom Cache & more**: Discordeno provides the ability to have almost every part of a bot
-  as a standalone piece.
-- **Plugins:** Designed to let you plugin and override any part of the code. Never deal with the headaches of
-  maintaining your fork just to get something customized for your needs. You can use plugins for almost anything, for
-  example we have a few official plugins.
-  - Cache plugin that enables caching everything.
-  - Sweeper plugin that enables sweepers to clean the cache every once in a while.
-  - Permission plugin checks internally all missing permissions before forwarding a request to the Discord API so that
-    the client does not get globally banned by Discord.
-- **Flexibility:** If your bot does not need certain properties from objects then you can simply remove them. For
-  example, if your bot does not need `Channel.topic` you should not have to store it. This can save you GBs of memory.
-  Doing this for any property on any object is as simple as a few lines of code.
+Discordeno is actively maintained to guarantee **excellent performance and ease.**
+
+- **Simple, Efficient, and Lightweight**: Discordeno is lightweight, simple to use, and adaptable. By default, no
+  caching.
+- **Functional API**: The functional API eliminates the challenges of extending built-in classes and inheritance while
+  ensuring overall simple but performant code.
+- **Cross Runtime**: Supports the Node.js and Deno runtimes.
+- **Standalone components**: Discordeno offers the option to have practically any component of a bot as a separate
+  piece, including standalone REST, gateways, custom caches, and more.
+- **Plugins:** Designed to allow you to overwrite any portion of the code with your own code. Never go through the
+  hassle of maintaining your fork in order to acquire something that is specifically tailored to your requirements.
+  Plugins may be used for nearly anything; for instance, we have a few authorised plugins.
+  - A caching plugin that makes anything cacheable.
+  - A plugin for sweepers that allows them to periodically clear the cache.
+  - The permission plugin internally verifies any missing permissions before sending a call to the Discord API to
+    prevent the client from receiving a Discord global ban.
+
+- **Flexibility:** You may easily delete an object's attributes if your bot doesn't require them. For instance, you
+  shouldn't be required to keep `Channel.topic` if your bot doesn't require it. You may save GBs of RAM in this way. A
+  few lines of code are all that are needed to accomplish this for any property on any object.
 
 ### REST
 
-- ✅ Freedom from Invalid Request 1 Hour Downtimes
-  - ✅ Discordeno will protect your bot from going down for an hour and will instead decrease the maximum downtime to 10
-    minutes.
-- ✅ Freedom from global rate limit errors
-  - ✅ As your bot grows, you want to handle global rate limits better. Shards don't communicate fast enough to truly
+- Freedom from 1 hour downtimes due to invalid requests
+  - By lowering the maximum downtime to 10 minutes, Discordeno will prevent your bot from being down for an hour.
+- Freedom from global rate limit errors
+  - As your bot grows, you want to handle global rate limits better. Shards don't communicate fast enough to truly
     handle it properly so this allows 1 rest handler across the entire bot.
-  - ✅ In fact, you can host multiple instances of your bot and all connect to the same rest server.
-- ✅ REST does not rest!
-  - ✅ Separate rest means if your bot for whatever reason crashes, your requests that are queued will still keep going
-    and will not be lost.
-  - ✅ Seamless updates! When you want to update and reboot the bot, you could potentially lose tons of messages or
-    responses that are in queue. Using this you could restart your bot without ever worrying about losing any responses.
-- ✅ Single source of contact to Discord API
-  - ✅ This will allow you to make requests to discord from anywhere including a bot dashboard. You no longer need to
-    have to communicate to your bot processes just to make a request or anything. Free up your bot process for
-    processing bot events.
-- ✅ Scalability! Scalability! Scalability!
+  - You may really run numerous instances of your bot on different hosts, all of which will connect to the same REST
+    server.
+- REST does not rest!
+  - Separate rest guarantees that your queued requests will continue to be processed even if your bot breaks for
+    whatever reason.
+  - Seamless updates! There's a chance you'll lose a lot of messages or replies that are waiting to be given when you
+    wish to update and restart the bot. You may restart your bot using this technique and never have to worry about
+    losing any answers.
+- Single source of contact to Discord API
+  - As a result, you will be able to send requests to Discord from any location, even a bot dashboard. You are no longer
+    need to interact with your bot processes in order to submit a request or do anything else. Your bot process should
+    be freed up to handle bot events.
+- Scalability! Scalability! Scalability!
 
 ### Gateway
 
-- ✅ **Zero Downtime Updates:**
-  - ✅ Your bot can be updated in a matter of seconds. With normal sharding, you have to restart which also has to
-    process identifying all your shards with a 1/~5s rate limit. With WS handling moved to a proxy process, this allows
-    you to instantly get the bot code restarted without any concerns of delays. If you have a bot on 200,000 servers
-    normally this would mean a 20 minute delay to restart your bot if you made a small change and restarted.
-- ✅ **Zero Downtime Resharding:**
-  - ✅ Discord stops letting your bot get added to new servers at certain points in time. For example, suppose you had
-    150,000 servers running 150 shards. The maximum amount of servers your shards could hold is 150 \* 2500 = 375,000.
-    If your bot reaches this, it can no longer join new servers until it re-shards.
-  - ✅ DD proxy provides 2 types of re-sharding. Automated and manual. You can also have both.
-    - ✅ Automated: This system will automatically begin a Zero-downtime resharding process behind the scenes when you
+- **Zero Downtime Updates:**
+  - A few seconds are needed to update your bot. When using conventional sharding, you must restart in addition to going
+    through a 1/5s rate-limited process of identifying all of your shards. As WS processing has been relocated to a
+    proxy process, you may resume the bot code right away without worrying about any delays. Normally, if you had a bot
+    that was spread across 200,000 servers, restarting it after making a simple modification would take 20 minutes.
+- **Zero Downtime Resharding:**
+  - At various periods in time, Discord stops allowing your bot to be added to new servers. Consider 150 shards
+    operating on 150,000 servers, for instance. Your shards may support a maximum of 150 * 2500 = 375,000 servers. Your
+    bot will be unable to join new servers once it reaches this point until it re-shards.
+  - DD proxy provides 2 types of re-sharding. Automated and manual. You can also have both.
+    - Automated: This system will automatically begin a Zero-downtime resharding process behind the scenes when you
       reach 80% of your maximum servers allowed by your shards. For example, since 375,000 was the max, at 300,000 we
       would begin re-sharding behind the scenes with ZERO DOWNTIME.
-      - ✅ 80% of maximum servers reached (The % of 80% is customizable.)
-      - ✅ Identify limits have room to allow re-sharding. (Also customizable)
-    - ✅ Manual: You can also trigger this manually should you choose.
-- ✅ **Horizontal Scaling:**
-  - ✅ The proxy system allows you to scale the bot horizontally. When you reach a huge size, you can either keep
-    spending more money to keep beefing up your server or you can buy several cheaper servers and scale horizontally.
-    The proxy means you can have WS handling on a completely separate system.
-- ✅ **No Loss Restarts:**
-  - ✅ When you restart a bot without the proxy system, normally you would lose many events. Users may be using commands
-    or messages are sent that will not be filtered. As your bot's grow this number rises dramatically. Users may join
-    who wont get the auto-roles or any other actions your bot should take. With the proxy system, you can keep
-    restarting your bot and never lose any events. Events will be put into a queue while your bot is down(max size of
-    queue is customizable), once the bot is available the queue will begin processing all events.
-- ✅ **Controllers:**
-  - ✅ The controller aspect gives you full control over everything inside the proxy. You can provide a function to
-    simply override the handler. For example, if you would like a certain function to do something different, instead of
-    having to fork and maintain your fork, you can just provide a function to override.
-- ✅ **Clustering With Workers:**
-  - ✅ Take full advantage of all your CPU cores by using workers to spread the load. Control how many shards per worker
-    and how many workers to maximize efficiency!
+      - 80% of maximum servers reached (The % of 80% is customizable.)
+      - Identify limits have room to allow re-sharding. (Also customizable)
+    - Manual: You can also trigger this manually should you choose.
+- **Horizontal Scaling:**
+  - The bot may be scaled horizontally thanks to the proxy mechanism. When your business grows significantly, you have
+    two options: you can either keep investing money to upgrade your server or you may expand horizontally by purchasing
+    numerous more affordable servers. The proxy enables WS handling on a totally other system.
+- **No Loss Restarts:**
+  - Without the proxy mechanism, you would typically lose numerous events while restarting a bot. Users could issue
+    instructions or send messages that are not screened. As your bot population increases, this amount grows sharply.
+    Users who don't receive the automatic roles or any other activities your bot should do may join. You may keep
+    restarting your bot thanks to the proxy technology without ever losing any events. While your bot is unavailable,
+    events will be added to a queue (the maximum size of the queue is configurable), and once the bot is back online,
+    the queue will start processing all of the events.
+- **Controllers:**
+  - You have complete control over everything inside the proxy thanks to the controller aspect. To simply override the
+    handler, you may supply a function. For instance, you may simply give a method to override a specific function if
+    you want it to behave differently rather than forking and maintaining your fork.
+- **Clustering With Workers:**
+  - Utilize all of your CPU cores to their greatest potential by distributing the workload across employees. To enhance
+    efficiency, manage how many employees and shards there are each worker!
 
 ### Custom Cache
 
@@ -122,8 +124,8 @@ await startBot(bot);
 
 ### Tools
 
-If you are a beginner, this library is not meant for you but you can check out if you still want to use this lib with
-these awesome official and unofficial templates:
+This library is not intended for beginners, however if you still want to utilise it, check out these excellent official
+and unofficial templates:
 
 **Templates**
 
@@ -134,6 +136,7 @@ these awesome official and unofficial templates:
 
 **Frameworks**
 
+- [Amethyst Framework](https://github.com/AmethystFramework/framework)
 - [Add Your Own!](https://github.com/discordeno/discordeno/pulls)
 
 **Plugins**

package/esm/gateway/shard/connect.js

@@ -7,10 +7,14 @@ export async function connect(shard) {
         shard.state = ShardState.Connecting;
     }
     shard.events.connecting?.(shard);
-    let url = shard.gatewayConfig.url;
+    let url = new URL(shard.gatewayConfig.url);
     // If not connecting to a proxy but directly to discord need to handle resuming
-    if (url === "wss://gateway.discord.gg") {
-        url = `${shard.state === ShardState.Resuming ? shard.resumeGatewayUrl : shard.gatewayConfig.url}/?v=${shard.gatewayConfig.version}&encoding=json`;
+    if (url.origin === "wss://gateway.discord.gg") {
+        if (shard.state === ShardState.Resuming) {
+            url = new URL(shard.resumeGatewayUrl);
+        }
+        url.searchParams.set("v", shard.gatewayConfig.version.toString());
+        url.searchParams.set("encoding", "json");
     }
     const socket = new dntShim.WebSocket(url);
     shard.socket = socket;

package/esm/helpers/channels/mod.js

@@ -10,6 +10,5 @@ export * from "./editChannelPermissionOverrides.js";
 export * from "./getChannel.js";
 export * from "./getChannelInvites.js";
 export * from "./getChannels.js";
-export * from "./getChannelWebhooks.js";
 export * from "./triggerTypingIndicator.js";
 export * from "./editChannelPositions.js";

package/esm/helpers/guilds/invites/createInvite.js

@@ -25,6 +25,7 @@ export async function createInvite(bot, channelId, options = {}) {
         target_type: options.targetType,
         target_user_id: options.targetUserId?.toString(),
         target_application_id: options.targetApplicationId?.toString(),
+        reason: options.reason,
     });
     return {
         code: result.code,

package/esm/helpers/interactions/responses/editFollowupMessage.js

@@ -19,11 +19,12 @@ import { InteractionResponseTypes } from "../../../types/shared.js";
  */
 export async function editFollowupMessage(bot, token, messageId, options) {
     const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.WEBHOOK_MESSAGE(bot.applicationId, token, messageId), {
-        messageId,
+        messageId: messageId.toString(),
         ...bot.transformers.reverse.interactionResponse(bot, {
             type: InteractionResponseTypes.UpdateMessage,
             data: options,
         }).data,
+        file: options.file,
     });
     return bot.transformers.message(bot, result);
 }

package/esm/helpers/interactions/responses/editOriginalInteractionResponse.js

@@ -17,9 +17,12 @@ import { InteractionResponseTypes } from "../../../types/mod.js";
  * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#edit-original-interaction-response}
  */
 export async function editOriginalInteractionResponse(bot, token, options) {
-    const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.INTERACTION_ORIGINAL_ID_TOKEN(bot.applicationId, token), bot.transformers.reverse.interactionResponse(bot, {
-        type: InteractionResponseTypes.UpdateMessage,
-        data: options,
-    }).data);
+    const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.INTERACTION_ORIGINAL_ID_TOKEN(bot.applicationId, token), {
+        ...bot.transformers.reverse.interactionResponse(bot, {
+            type: InteractionResponseTypes.UpdateMessage,
+            data: options,
+        }).data,
+        file: options.file,
+    });
     return bot.transformers.message(bot, result);
 }

package/esm/helpers/misc/getNitroStickerPacks.js

@@ -1,5 +1,12 @@
 import { Collection } from "../../util/collection.js";
-/** Returns the list of sticker packs available to Nitro subscribers. */
+/**
+ * Returns the list of sticker packs available to Nitro subscribers.
+ *
+ * @param bot The bot instance to use to make the request.
+ * @returns A collection of {@link StickerPack} objects assorted by sticker ID.
+ *
+ * @see {@link https://discord.com/developers/docs/resources/sticker#list-nitro-sticker-packs}
+ */
 export async function getNitroStickerPacks(bot) {
     const results = await bot.rest.runMethod(bot.rest, "GET", bot.constants.routes.NITRO_STICKER_PACKS());
     return new Collection(results.map((result) => {

package/esm/helpers/mod.js

@@ -6,5 +6,6 @@ export * from "./members/mod.js";
 export * from "./messages/mod.js";
 export * from "./misc/mod.js";
 export * from "./roles/mod.js";
+export * from "./stickers/mod.js";
 export * from "./templates/mod.js";
 export * from "./webhooks/mod.js";

package/esm/helpers/stickers/createGuildSticker.js

@@ -0,0 +1,25 @@
+/**
+ * Create a new sticker for the guild.
+ *
+ * @param bot The bot instance to use to make the request.
+ * @param guildId The ID of the guild to get
+ * @return A {@link Sticker}
+ *
+ * @remarks
+ * Requires the `MANAGE_EMOJIS_AND_STICKERS` 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.
+ *
+ * @see {@link https://discord.com/developers/docs/resources/sticker#create-guild-sticker}
+ */
+export async function createGuildSticker(bot, guildId, options) {
+    const result = await bot.rest.runMethod(bot.rest, "POST", bot.constants.routes.GUILD_STICKERS(guildId), {
+        name: options.name,
+        description: options.description,
+        tags: options.tags,
+        file: options.file,
+        reason: options.reason,
+    });
+    return bot.transformers.sticker(bot, result);
+}

package/esm/helpers/stickers/deleteGuildSticker.js

@@ -0,0 +1,18 @@
+/**
+ * Delete a new sticker for the guild.
+ *
+ * @param bot The bot instance to use to make the request.
+ * @param guildId The ID of the guild to get
+ * @return A {@link Sticker}
+ *
+ * @remarks
+ * Requires the `MANAGE_EMOJIS_AND_STICKERS` 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.
+ *
+ * @see {@link https://discord.com/developers/docs/resources/sticker#delete-guild-sticker}
+ */
+export async function deleteGuildSticker(bot, guildId, stickerId, reason) {
+    return await bot.rest.runMethod(bot.rest, "DELETE", bot.constants.routes.GUILD_STICKER(guildId, stickerId), reason ? { reason } : undefined);
+}

package/esm/helpers/stickers/editGuildSticker.js

@@ -0,0 +1,22 @@
+/**
+ * Edit the given sticker.
+ *
+ * @param bot The bot instance to use to make the request.
+ * @param guildId The ID of the guild to get
+ * @return A {@link Sticker}
+ *
+ * @remarks
+ * Requires the `MANAGE_EMOJIS_AND_STICKERS` permission.
+ * Fires a Guild Stickers Update Gateway event.
+ *
+ * @see {@link https://discord.com/developers/docs/resources/sticker#modify-guild-sticker}
+ */
+export async function editGuildSticker(bot, guildId, stickerId, options) {
+    const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.GUILD_STICKER(guildId, stickerId), {
+        name: options.name,
+        description: options.description,
+        tags: options.tags,
+        reason: options.reason,
+    });
+    return bot.transformers.sticker(bot, result);
+}

package/esm/helpers/stickers/getGuildSticker.js

@@ -0,0 +1,16 @@
+/**
+ * Returns a sticker object for the given guild and sticker IDs.
+ *
+ * @param bot The bot instance to use to make the request.
+ * @param guildId The ID of the guild to get
+ * @param stickerId The ID of the sticker to get
+ * @return A {@link Sticker}
+ *
+ * @remarks Includes the user field if the bot has the `MANAGE_EMOJIS_AND_STICKERS` permission.
+ *
+ * @see {@link https://discord.com/developers/docs/resources/sticker#get-guild-sticker}
+ */
+export async function getGuildSticker(bot, guildId, stickerId) {
+    const result = await bot.rest.runMethod(bot.rest, "GET", bot.constants.routes.GUILD_STICKER(guildId, stickerId));
+    return bot.transformers.sticker(bot, result);
+}

package/esm/helpers/stickers/getGuildStickers.js

@@ -0,0 +1,19 @@
+import { Collection } from "../../mod.js";
+/**
+ * Returns an array of sticker objects for the given guild.
+ *
+ * @param bot The bot instance to use to make the request.
+ * @param guildId The ID of the guild to get
+ * @returns A collection of {@link Sticker} objects assorted by sticker ID.
+ *
+ * @remarks Includes user fields if the bot has the `MANAGE_EMOJIS_AND_STICKERS` permission.
+ *
+ * @see {@link https://discord.com/developers/docs/resources/sticker#list-guild-stickers}
+ */
+export async function getGuildStickers(bot, guildId) {
+    const results = await bot.rest.runMethod(bot.rest, "GET", bot.constants.routes.GUILD_STICKERS(guildId));
+    return new Collection(results.map((result) => {
+        const pack = bot.transformers.sticker(bot, result);
+        return [pack.id, pack];
+    }));
+}

package/esm/helpers/stickers/getSticker.js

@@ -0,0 +1,13 @@
+/**
+ * Returns a sticker object for the given sticker ID.
+ *
+ * @param bot The bot instance to use to make the request.
+ * @param stickerId The ID of the sticker to get
+ * @returns A {@link Sticker}
+ *
+ * @see {@link https://discord.com/developers/docs/resources/sticker#get-sticker}
+ */
+export async function getSticker(bot, stickerId) {
+    const result = await bot.rest.runMethod(bot.rest, "GET", bot.constants.routes.STICKER(stickerId));
+    return bot.transformers.sticker(bot, result);
+}

package/esm/helpers/stickers/mod.js

@@ -0,0 +1,6 @@
+export * from "./createGuildSticker.js";
+export * from "./deleteGuildSticker.js";
+export * from "./editGuildSticker.js";
+export * from "./getGuildSticker.js";
+export * from "./getGuildStickers.js";
+export * from "./getSticker.js";

package/esm/helpers/webhooks/editOriginalWebhookMessage.js

@@ -14,9 +14,12 @@ import { InteractionResponseTypes } from "../../types/mod.js";
  * @see {@link https://discord.com/developers/docs/resources/webhook#edit-webhook-message}
  */
 export async function editOriginalWebhookMessage(bot, webhookId, token, options) {
-    const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.WEBHOOK_MESSAGE_ORIGINAL(webhookId, token, options), bot.transformers.reverse.interactionResponse(bot, {
-        type: InteractionResponseTypes.UpdateMessage,
-        data: options,
-    }).data);
+    const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.WEBHOOK_MESSAGE_ORIGINAL(webhookId, token, options), {
+        ...bot.transformers.reverse.interactionResponse(bot, {
+            type: InteractionResponseTypes.UpdateMessage,
+            data: options,
+        }).data,
+        file: options.file,
+    });
     return bot.transformers.message(bot, result);
 }

package/esm/helpers/webhooks/editWebhookMessage.js

@@ -15,9 +15,12 @@ import { InteractionResponseTypes } from "../../types/shared.js";
  * @see {@link https://discord.com/developers/docs/resources/webhook#edit-webhook-message}
  */
 export async function editWebhookMessage(bot, webhookId, token, messageId, options) {
-    const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.WEBHOOK_MESSAGE(webhookId, token, messageId, options), bot.transformers.reverse.interactionResponse(bot, {
-        type: InteractionResponseTypes.UpdateMessage,
-        data: options,
-    }).data);
+    const result = await bot.rest.runMethod(bot.rest, "PATCH", bot.constants.routes.WEBHOOK_MESSAGE(webhookId, token, messageId, options), {
+        ...bot.transformers.reverse.interactionResponse(bot, {
+            type: InteractionResponseTypes.UpdateMessage,
+            data: options,
+        }).data,
+        file: options.file,
+    });
     return bot.transformers.message(bot, result);
 }

package/esm/helpers/webhooks/{getWebhooks.js → getGuildWebhooks.js}

@@ -11,7 +11,7 @@ import { Collection } from "../../util/collection.js";
  *
  * @see {@link https://discord.com/developers/docs/resources/webhook#get-guild-webhooks}
  */
-export async function getWebhooks(bot, guildId) {
+export async function getGuildWebhooks(bot, guildId) {
     const results = await bot.rest.runMethod(bot.rest, "GET", bot.constants.routes.GUILD_WEBHOOKS(guildId));
     return new Collection(results.map((result) => {
         const webhook = bot.transformers.webhook(bot, result);

package/esm/helpers/webhooks/mod.js

@@ -7,7 +7,8 @@ export * from "./editWebhook.js";
 export * from "./editWebhookMessage.js";
 export * from "./editWebhookWithToken.js";
 export * from "./executeWebhook.js";
+export * from "./getChannelWebhooks.js";
+export * from "./getGuildWebhooks.js";
 export * from "./getWebhook.js";
 export * from "./getWebhookMessage.js";
-export * from "./getWebhooks.js";
 export * from "./getWebhookWithToken.js";

package/esm/plugins/permissions/mod.js

@@ -6,6 +6,7 @@ import { integrations } from "./src/integrations/mod.js";
 import { members } from "./src/members/mod.js";
 import { messages } from "./src/messages/mod.js";
 import { roles } from "./src/roles/mod.js";
+import { stickers } from "./src/stickers/mod.js";
 import { webhooks } from "./src/webhooks/mod.js";
 // PLUGINS MUST TAKE A BOT ARGUMENT WHICH WILL BE MODIFIED
 export function enablePermissionsPlugin(bot) {
@@ -22,6 +23,7 @@ export function enablePermissionsPlugin(bot) {
     members(bot);
     messages(bot);
     roles(bot);
+    stickers(bot);
     webhooks(bot);
     // PLUGINS MUST RETURN THE BOT
     return bot;

package/esm/plugins/permissions/src/channels/createChannel.js

@@ -3,7 +3,7 @@ import { requireBotGuildPermissions } from "../permissions.js";
 export function createChannel(bot) {
     const createChannel = bot.helpers.createChannel;
     bot.helpers.createChannel = async function (guildId, options) {
-        const guild = bot.guilds.get(guildId);
+        const guild = bot.guilds.get(bot.transformers.snowflake(guildId));
         if (guild) {
             if (options?.rateLimitPerUser && !(0 < options.rateLimitPerUser && options.rateLimitPerUser < 21600)) {
                 throw new Error("Amount of seconds a user has to wait before sending another message must be between 0-21600");
@@ -27,7 +27,7 @@ export function createChannel(bot) {
             if (options?.userLimit && options.userLimit > 99)
                 throw new Error("The user limit must be less than 99.");
             if (options?.parentId) {
-                const category = bot.channels.get(options.parentId);
+                const category = bot.channels.get(bot.transformers.snowflake(options.parentId));
                 if (category && category.type !== ChannelTypes.GuildCategory) {
                     throw new Error("The parent id must be for a category channel type.");
                 }

package/esm/plugins/permissions/src/channels/deleteChannel.js

@@ -3,7 +3,7 @@ import { requireBotChannelPermissions } from "../permissions.js";
 export function deleteChannel(bot) {
     const deleteChannel = bot.helpers.deleteChannel;
     bot.helpers.deleteChannel = async function (channelId, reason) {
-        const channel = bot.channels.get(channelId);
+        const channel = bot.channels.get(bot.transformers.snowflake(channelId));
         if (channel?.guildId) {
             const guild = bot.guilds.get(channel.guildId);
             if (!guild)
@@ -22,7 +22,7 @@ export function deleteChannel(bot) {
                 perms.push("MANAGE_CHANNELS");
             if (isVoice)
                 perms.push("CONNECT");
-            requireBotChannelPermissions(bot, channelId, perms);
+            requireBotChannelPermissions(bot, bot.transformers.snowflake(channelId), perms);
         }
         return await deleteChannel(channelId, reason);
     };

package/esm/plugins/permissions/src/channels/deleteChannelPermissionOverride.js

@@ -3,13 +3,13 @@ import { requireBotChannelPermissions } from "../permissions.js";
 export function deleteChannelPermissionOverride(bot) {
     const deleteChannelPermissionOverride = bot.helpers.deleteChannelPermissionOverride;
     bot.helpers.deleteChannelPermissionOverride = async function (channelId, overwriteId) {
-        const channel = bot.channels.get(channelId);
+        const channel = bot.channels.get(bot.transformers.snowflake(channelId));
         if (channel?.guildId) {
             const perms = ["VIEW_CHANNEL", "MANAGE_ROLES"];
             const isVoice = [ChannelTypes.GuildVoice, ChannelTypes.GuildStageVoice].includes(channel.type);
             if (isVoice)
                 perms.push("CONNECT");
-            requireBotChannelPermissions(bot, channelId, perms);
+            requireBotChannelPermissions(bot, bot.transformers.snowflake(channelId), perms);
         }
         return await deleteChannelPermissionOverride(channelId, overwriteId);
     };

package/esm/plugins/permissions/src/channels/editChannel.js

@@ -3,7 +3,7 @@ import { requireBotChannelPermissions } from "../permissions.js";
 export function editChannel(bot) {
     const editChannel = bot.helpers.editChannel;
     bot.helpers.editChannel = async function (channelId, options) {
-        const channel = bot.channels.get(channelId);
+        const channel = bot.channels.get(bot.transformers.snowflake(channelId));
         if (channel?.guildId) {
             const guild = bot.guilds.get(channel.guildId);
             if (options.rateLimitPerUser && options.rateLimitPerUser > 21600) {
@@ -55,7 +55,7 @@ export function editChannel(bot) {
                 if (options.userLimit && options.userLimit > 99)
                     throw new Error("The user limit must be less than 99.");
                 if (options.parentId) {
-                    const category = bot.channels.get(options.parentId);
+                    const category = bot.channels.get(bot.transformers.snowflake(options.parentId));
                     if (category && category.type !== ChannelTypes.GuildCategory) {
                         throw new Error("The parent id must be for a category channel type.");
                     }

package/esm/plugins/permissions/src/channels/editChannelPermissionOverrides.js

@@ -3,13 +3,13 @@ import { requireBotChannelPermissions } from "../permissions.js";
 export function editChannelPermissionOverrides(bot) {
     const editChannelPermissionOverrides = bot.helpers.editChannelPermissionOverrides;
     bot.helpers.editChannelPermissionOverrides = async function (channelId, overwrite) {
-        const channel = bot.channels.get(channelId);
+        const channel = bot.channels.get(bot.transformers.snowflake(channelId));
         if (channel?.guildId) {
             const perms = ["VIEW_CHANNEL", "MANAGE_ROLES"];
             const isVoice = [ChannelTypes.GuildVoice, ChannelTypes.GuildStageVoice].includes(channel.type);
             if (isVoice)
                 perms.push("CONNECT");
-            requireBotChannelPermissions(bot, channelId, perms);
+            requireBotChannelPermissions(bot, bot.transformers.snowflake(channelId), perms);
         }
         return await editChannelPermissionOverrides(channelId, overwrite);
     };

package/esm/plugins/permissions/src/channels/followAnnouncementChannel.js

@@ -3,19 +3,19 @@ import { requireBotChannelPermissions } from "../permissions.js";
 export function followAnnouncementChannel(bot) {
     const followAnnouncementChannel = bot.helpers.followAnnouncementChannel;
     bot.helpers.followAnnouncementChannel = async function (sourceChannelId, targetChannelId) {
-        const sourceChannel = bot.channels.get(sourceChannelId);
+        const sourceChannel = bot.channels.get(bot.transformers.snowflake(sourceChannelId));
         if (sourceChannel && sourceChannel.type !== ChannelTypes.GuildAnnouncement) {
             throw new Error("Source channel must be an announcement channel");
         }
-        const targetChannel = bot.channels.get(targetChannelId);
+        const targetChannel = bot.channels.get(bot.transformers.snowflake(targetChannelId));
         if (targetChannel) {
             const isWebhookParent = [ChannelTypes.GuildAnnouncement, ChannelTypes.GuildText].includes(targetChannel.type);
             if (!isWebhookParent) {
                 throw new Error("Target channel must be a text channel or an announcement channel");
             }
         }
-        requireBotChannelPermissions(bot, sourceChannelId, ["VIEW_CHANNEL"]);
-        requireBotChannelPermissions(bot, targetChannelId, ["VIEW_CHANNEL", "MANAGE_WEBHOOKS"]);
+        requireBotChannelPermissions(bot, bot.transformers.snowflake(sourceChannelId), ["VIEW_CHANNEL"]);
+        requireBotChannelPermissions(bot, bot.transformers.snowflake(targetChannelId), ["VIEW_CHANNEL", "MANAGE_WEBHOOKS"]);
         return await followAnnouncementChannel(sourceChannelId, targetChannelId);
     };
 }