@open-discord-bots/framework 0.3.1 → 0.3.3

package/dist/api/main.js

@@ -43,7 +43,7 @@ export class ODMain {
     constructor(managers, project) {
         this.project = project;
         this.versions = managers.versions;
-        this.versions.add(ODVersion.fromString("opendiscord:api", "v0.3.1"));
+        this.versions.add(ODVersion.fromString("opendiscord:api", "v0.3.3"));
         this.versions.add(ODVersion.fromString("opendiscord:livestatus", "v2.0.0"));
         this.debugfile = managers.debugfile;
         this.console = managers.console;

package/dist/api/modules/fuse.d.ts

@@ -150,6 +150,12 @@ export interface ODSharedFuseList {
     messageBuildersLoading: boolean;
     /**Load the default Open Discord modal builders. */
     modalBuildersLoading: boolean;
+    /**Load the default Open Discord shared components. */
+    sharedComponentsLoading: boolean;
+    /**Load the default Open Discord message components. */
+    messageComponentsLoading: boolean;
+    /**Load the default Open Discord modal components. */
+    modalComponentsLoading: boolean;
     /**Load the default Open Discord command responders. */
     commandRespondersLoading: boolean;
     /**Load the default Open Discord button responders. */

package/dist/api/modules/fuse.js

@@ -86,6 +86,9 @@ export class ODSharedFuseManager extends ODFuseManager {
             embedBuildersLoading: true,
             messageBuildersLoading: true,
             modalBuildersLoading: true,
+            sharedComponentsLoading: true,
+            messageComponentsLoading: true,
+            modalComponentsLoading: true,
             commandRespondersLoading: true,
             buttonRespondersLoading: true,
             dropdownRespondersLoading: true,

package/dist/api/modules/responder.d.ts

@@ -171,8 +171,8 @@ export declare class ODCommandResponderInstance extends ODBaseResponderInstance
     cmd: ODSlashCommand | ODTextCommand;
     /**The type/source of instance. (from text or slash command) */
     type: "message" | "interaction";
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean;
     /**The manager for all options of this command. */
     options: ODCommandResponderInstanceOptions;
     /**The user who triggered this command. */
@@ -252,8 +252,8 @@ export declare class ODButtonResponderManager<IdList extends ODButtonResponderMa
 export declare class ODButtonResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.ButtonInteraction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean;
     /**The user who triggered this button. */
     user: discord.User;
     /**The guild member who triggered this button. */
@@ -361,8 +361,8 @@ export declare class ODDropdownResponderInstanceValues {
 export declare class ODDropdownResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.AnySelectMenuInteraction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean;
     /**The dropdown type. */
     type: ODDropdownData["type"];
     /**The manager for all values of this dropdown. */
@@ -467,8 +467,8 @@ export declare class ODModalResponderInstanceValues {
 export declare class ODModalResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.ModalSubmitInteraction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean;
     /**The manager for all fields of this modal. */
     values: ODModalResponderInstanceValues;
     /**The user who triggered this modal. */
@@ -543,8 +543,8 @@ export declare class ODContextMenuResponderManager<IdList extends ODContextMenuR
 export declare class ODContextMenuResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.ContextMenuCommandInteraction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean;
     /**The context menu wich is the source of this instance. */
     menu: ODContextMenu;
     /**The user who triggered this context menu. */

package/dist/api/modules/responder.js

@@ -372,8 +372,8 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
     cmd;
     /**The type/source of instance. (from text or slash command) */
     type;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The manager for all options of this command. */
     options;
     /**The user who triggered this command. */
@@ -397,27 +397,27 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
         this.guild = interaction.guild;
         this.channel = interaction.channel;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this command!**"
-                            } });
-                    }
-                    else {
-                        const errorResponse = await errorCallback(this, (this.type == "interaction") ? "slash" : "text");
-                        //auto-delete timeout error message after 5sec when text-based
-                        if (errorResponse.success && this.type == "message")
-                            setTimeout(() => {
-                                if (errorResponse.message?.deletable)
-                                    errorResponse.message?.delete();
-                            }, 5000);
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this command!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    const errorResponse = await errorCallback(this, (this.type == "interaction") ? "slash" : "text");
+                    //auto-delete timeout error message after 5sec when text-based
+                    if (errorResponse.success && this.type == "message")
+                        setTimeout(() => {
+                            if (errorResponse.message?.deletable)
+                                errorResponse.message?.delete();
+                        }, 5000);
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this command. */
@@ -427,18 +427,18 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
             if (this.type == "interaction" && this.interaction instanceof discord.ChatInputCommandInteraction) {
                 if (this.interaction.replied || this.interaction.deferred) {
                     const sent = await this.interaction.editReply(finalMessage);
-                    this.didReply = true;
+                    this.ignoreResponderTimeout = true;
                     return { success: true, message: sent };
                 }
                 else {
                     const sent = await this.interaction.reply(finalMessage);
-                    this.didReply = true;
+                    this.ignoreResponderTimeout = true;
                     return { success: true, message: await sent.fetch() };
                 }
             }
             else if (this.type == "message" && this.interaction instanceof discord.Message && this.interaction.channel.type != discord.ChannelType.GroupDM) {
                 const sent = await this.interaction.channel.send(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else
@@ -450,23 +450,23 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this command. */
     async defer(ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.type != "interaction" || !(this.interaction instanceof discord.ChatInputCommandInteraction))
             return false;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         const msgFlags = ephemeral ? [discord.MessageFlags.Ephemeral] : [];
         await this.interaction.deferReply({ flags: msgFlags });
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this command. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.type != "interaction" || !(this.interaction instanceof discord.ChatInputCommandInteraction))
             return false;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
 }
@@ -553,8 +553,8 @@ export class ODButtonResponderManager extends ODManager {
 export class ODButtonResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The user who triggered this button. */
     user;
     /**The guild member who triggered this button. */
@@ -576,21 +576,21 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
         this.channel = interaction.channel;
         this.message = interaction.message;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this button!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "button");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this button!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "button");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this button. */
@@ -599,12 +599,12 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
@@ -618,12 +618,12 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else {
                 const sent = await this.interaction.update(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
@@ -633,6 +633,7 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this button. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
@@ -642,15 +643,14 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
         else {
             await this.interaction.deferUpdate();
         }
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this button. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
     getMessageComponent(type, id) {
@@ -839,8 +839,8 @@ export class ODDropdownResponderInstanceValues {
 export class ODDropdownResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The dropdown type. */
     type;
     /**The manager for all values of this dropdown. */
@@ -884,21 +884,21 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
         this.channel = interaction.channel;
         this.message = interaction.message;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this dropdown!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "dropdown");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this dropdown!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "dropdown");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this dropdown. */
@@ -907,12 +907,12 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
@@ -926,12 +926,12 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else {
                 const sent = await this.interaction.update(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
@@ -941,6 +941,7 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this dropdown. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
@@ -950,15 +951,14 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
         else {
             await this.interaction.deferUpdate();
         }
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this dropdown. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
     getMessageComponent(type, id) {
@@ -1088,8 +1088,8 @@ export class ODModalResponderInstanceValues {
 export class ODModalResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The manager for all fields of this modal. */
     values;
     /**The user who triggered this modal. */
@@ -1109,21 +1109,21 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         this.guild = interaction.guild;
         this.channel = interaction.channel;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this modal!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "modal");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this modal!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "modal");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this modal. */
@@ -1131,7 +1131,7 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         try {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             const sent = await this.interaction.followUp(finalMessage);
-            this.didReply = true;
+            this.ignoreResponderTimeout = true;
             return { success: true, message: sent };
         }
         catch {
@@ -1144,12 +1144,12 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
@@ -1159,6 +1159,7 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this modal. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
@@ -1168,7 +1169,6 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         else {
             await this.interaction.deferUpdate();
         }
-        this.didReply = true;
         return true;
     }
 }
@@ -1241,8 +1241,8 @@ export class ODContextMenuResponderManager extends ODManager {
 export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The context menu wich is the source of this instance. */
     menu;
     /**The user who triggered this context menu. */
@@ -1272,21 +1272,21 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
         else
             throw new ODSystemError("ODContextMenuResponderInstance: Invalid context menu type. Should be of the type User/Message!");
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this context menu!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "context-menu");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this context menu!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "context-menu");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this context menu. */
@@ -1295,12 +1295,12 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
@@ -1314,7 +1314,7 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else
@@ -1326,21 +1326,21 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this context menu. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
             const msgFlags = ephemeral ? [discord.MessageFlags.Ephemeral] : [];
             await this.interaction.deferReply({ flags: msgFlags });
         }
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this context menu. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
 }

package/dist/utilities/index.d.ts

@@ -1,4 +1,5 @@
 import * as api from "../api/index.js";
+import * as discord from "discord.js";
 /**## sharedFuses `utility variable`
  * All shared fuses from Open Discord. Please use `opendiscord.sharedFuses` instead!
  */
@@ -55,6 +56,12 @@ export declare function ordinalNumber(num: number): string;
  * Trim/remove all emoji's from a Javascript string.
  */
 export declare function trimEmojis(text: string): string;
+/**## getMessageFromBuildResult `utility function`
+ * Get the final `messageCreateOptions` from a returned build result from builders/components.
+ */
+export declare function getMessageFromBuildResult(build: api.ODMessageBuildResult | api.ODMessageComponentBuildResult, type: "interaction" | "message"): discord.MessageCreateOptions & {
+    flags: number[];
+};
 /**## easterEggs `utility object`
  * Object containing data for Open Ticket easter eggs.
  */

package/dist/utilities/index.js

@@ -1,6 +1,7 @@
 import * as fs from "fs";
 import ansis from "ansis";
 import * as api from "../api/index.js";
+import * as discord from "discord.js";
 /**## sharedFuses `utility variable`
  * All shared fuses from Open Discord. Please use `opendiscord.sharedFuses` instead!
  */
@@ -163,6 +164,32 @@ export function ordinalNumber(num) {
 export function trimEmojis(text) {
     return text.replace(/(\p{Extended_Pictographic}(?:\uFE0F|\uFE0E)?(?:\u200D\p{Extended_Pictographic}(?:\uFE0F|\uFE0E)?)*)/gu, "");
 }
+/**## getMessageFromBuildResult `utility function`
+ * Get the final `messageCreateOptions` from a returned build result from builders/components.
+ */
+export function getMessageFromBuildResult(build, type) {
+    const msgFlags = [];
+    let msgData;
+    if ('message' in build) {
+        //USING BUILDERS (deprecated)
+        msgData = build.message;
+        if (build.ephemeral)
+            msgFlags.push(discord.MessageFlags.Ephemeral);
+    }
+    else {
+        //USING COMPONENTS
+        msgData = build.msg;
+        if (type == "interaction" && build.ephemeral)
+            msgFlags.push(discord.MessageFlags.Ephemeral); //disabled with regular messages
+        if (build.componentsV2)
+            msgFlags.push(discord.MessageFlags.IsComponentsV2);
+        if (build.supressEmbeds)
+            msgFlags.push(discord.MessageFlags.SuppressEmbeds);
+        if (build.supressNotifications)
+            msgFlags.push(discord.MessageFlags.SuppressNotifications);
+    }
+    return Object.assign(msgData, { flags: msgFlags });
+}
 /**## easterEggs `utility object`
  * Object containing data for Open Ticket easter eggs.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@open-discord-bots/framework",
     "author": "DJj123dj",
-    "version": "0.3.1",
+    "version": "0.3.3",
     "description": "The core framework of the popular open-source discord bots: Open Ticket & Open Moderation.",
     "main": "dist/index.js",
     "module": "dist/index.js",

package/src/api/main.ts

@@ -150,7 +150,7 @@ export abstract class ODMain implements ODMainManagers {
     constructor(managers:ODMainManagers,project:ODProjectType){
         this.project = project
         this.versions = managers.versions
-        this.versions.add(ODVersion.fromString("opendiscord:api","v0.3.1"))
+        this.versions.add(ODVersion.fromString("opendiscord:api","v0.3.3"))
         this.versions.add(ODVersion.fromString("opendiscord:livestatus","v2.0.0"))
 
         this.debugfile = managers.debugfile

package/src/api/modules/fuse.ts

@@ -177,6 +177,13 @@ export interface ODSharedFuseList {
     /**Load the default Open Discord modal builders. */
     modalBuildersLoading:boolean,
 
+    /**Load the default Open Discord shared components. */
+    sharedComponentsLoading:boolean,
+    /**Load the default Open Discord message components. */
+    messageComponentsLoading:boolean,
+    /**Load the default Open Discord modal components. */
+    modalComponentsLoading:boolean,
+
     /**Load the default Open Discord command responders. */
     commandRespondersLoading:boolean,
     /**Load the default Open Discord button responders. */
@@ -310,6 +317,10 @@ export class ODSharedFuseManager extends ODFuseManager<ODSharedFuseList> {
             messageBuildersLoading:true,
             modalBuildersLoading:true,
 
+            sharedComponentsLoading:true,
+            messageComponentsLoading:true,
+            modalComponentsLoading:true,
+
             commandRespondersLoading:true,
             buttonRespondersLoading:true,
             dropdownRespondersLoading:true,

package/src/api/modules/responder.ts

@@ -419,8 +419,8 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
     cmd:ODSlashCommand|ODTextCommand
     /**The type/source of instance. (from text or slash command) */
     type: "message"|"interaction"
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean = false
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean = false
     /**The manager for all options of this command. */
     options: ODCommandResponderInstanceOptions
     /**The user who triggered this command. */
@@ -446,24 +446,23 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
 
 
         setTimeout(async () => {
-            if (!this.didReply){
-                try {
-                    if (!errorCallback){
-                        this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
-                            content:":x: **Something went wrong while replying to this command!**"
-                        }})
-                    }else{
-                        const errorResponse = await errorCallback(this,(this.type == "interaction") ? "slash" : "text")
-                        
-                        //auto-delete timeout error message after 5sec when text-based
-                        if (errorResponse.success && this.type == "message") setTimeout(() => {
-                            if (errorResponse.message?.deletable) errorResponse.message?.delete()
-                        },5000)
-                    }
+            if (this.ignoreResponderTimeout) return
+            try {
+                if (!errorCallback){
+                    this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
+                        content:":x: **Something went wrong while replying to this command!**"
+                    }})
+                }else{
+                    const errorResponse = await errorCallback(this,(this.type == "interaction") ? "slash" : "text")
                     
-                }catch(err){
-                    process.emit("uncaughtException",err)
+                    //auto-delete timeout error message after 5sec when text-based
+                    if (errorResponse.success && this.type == "message") setTimeout(() => {
+                        if (errorResponse.message?.deletable) errorResponse.message?.delete()
+                    },5000)
                 }
+                
+            }catch(err){
+                process.emit("uncaughtException",err)
             }
         },timeoutMs ?? 2500)
     }
@@ -475,16 +474,16 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
             if (this.type == "interaction" && this.interaction instanceof discord.ChatInputCommandInteraction){
                 if (this.interaction.replied || this.interaction.deferred){
                     const sent = await this.interaction.editReply(finalMessage)
-                    this.didReply = true
+                    this.ignoreResponderTimeout = true
                     return {success:true,message:sent}
                 }else{
                     const sent = await this.interaction.reply(finalMessage)
-                    this.didReply = true
+                    this.ignoreResponderTimeout = true
                     return {success:true,message:await sent.fetch()}
                 }
             }else if (this.type == "message" && this.interaction instanceof discord.Message && this.interaction.channel.type != discord.ChannelType.GroupDM){
                 const sent = await this.interaction.channel.send(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:sent}
             }else return {success:false,message:null}
         }catch{
@@ -493,19 +492,19 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this command. */
     async defer(ephemeral:boolean){
+        this.ignoreResponderTimeout = true
         if (this.type != "interaction" || !(this.interaction instanceof discord.ChatInputCommandInteraction)) return false
         if (this.interaction.deferred || this.interaction.replied) return false
         const msgFlags: number[] = ephemeral ? [discord.MessageFlags.Ephemeral] : []
         await this.interaction.deferReply({flags:msgFlags})
-        this.didReply = true
         return true
     }
     /**Show a modal as reply to this command. */
     async modal(modal:ODModalBuildResult){
+        this.ignoreResponderTimeout = true
         if (this.type != "interaction" || !(this.interaction instanceof discord.ChatInputCommandInteraction)) return false
         if (this.interaction.deferred || this.interaction.replied) return false
         await this.interaction.showModal(modal.modal)
-        this.didReply = true
         return true
     }
 }
@@ -617,8 +616,8 @@ export class ODButtonResponderManager<IdList extends ODButtonResponderManagerIdC
 export class ODButtonResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.ButtonInteraction
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean = false
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean = false
     /**The user who triggered this button. */
     user: discord.User
     /**The guild member who triggered this button. */
@@ -641,19 +640,18 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
         this.message = interaction.message
         
         setTimeout(async () => {
-            if (!this.didReply){
-                try {
-                    if (!errorCallback){
-                        this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
-                            content:":x: **Something went wrong while replying to this button!**"
-                        }})
-                    }else{
-                        await errorCallback(this,"button")
-                    }
-                    
-                }catch(err){
-                    process.emit("uncaughtException",err)
+            if (this.ignoreResponderTimeout) return
+            try {
+                if (!errorCallback){
+                    this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
+                        content:":x: **Something went wrong while replying to this button!**"
+                    }})
+                }else{
+                    await errorCallback(this,"button")
                 }
+                
+            }catch(err){
+                process.emit("uncaughtException",err)
             }
         },timeoutMs ?? 2500)
     }
@@ -664,11 +662,11 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             if (this.interaction.replied || this.interaction.deferred){
                 const sent = await this.interaction.editReply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:sent}
             }else{
                 const sent = await this.interaction.reply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }
         }catch{
@@ -681,11 +679,11 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             if (this.interaction.replied || this.interaction.deferred){
                 const sent = await this.interaction.editReply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }else{
                 const sent = await this.interaction.update(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }
         }catch{
@@ -694,6 +692,7 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this button. */
     async defer(type:"reply"|"update", ephemeral:boolean){
+        this.ignoreResponderTimeout = true
         if (this.interaction.deferred || this.interaction.replied) return false
         if (type == "reply"){
             const msgFlags: number[] = ephemeral ? [discord.MessageFlags.Ephemeral] : []
@@ -701,14 +700,13 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
         }else{
             await this.interaction.deferUpdate()
         }
-        this.didReply = true
         return true
     }
     /**Show a modal as reply to this button. */
     async modal(modal:ODModalBuildResult){
+        this.ignoreResponderTimeout = true
         if (this.interaction.deferred || this.interaction.replied) return false
         await this.interaction.showModal(modal.modal)
-        this.didReply = true
         return true
     }
 
@@ -916,8 +914,8 @@ export class ODDropdownResponderInstanceValues {
 export class ODDropdownResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.AnySelectMenuInteraction
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean = false
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean = false
     /**The dropdown type. */
     type: ODDropdownData["type"]
     /**The manager for all values of this dropdown. */
@@ -957,19 +955,18 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
         this.message = interaction.message
         
         setTimeout(async () => {
-            if (!this.didReply){
-                try {
-                    if (!errorCallback){
-                        this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
-                            content:":x: **Something went wrong while replying to this dropdown!**"
-                        }})
-                    }else{
-                        await errorCallback(this,"dropdown")
-                    }
-                    
-                }catch(err){
-                    process.emit("uncaughtException",err)
+            if (this.ignoreResponderTimeout) return
+            try {
+                if (!errorCallback){
+                    this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
+                        content:":x: **Something went wrong while replying to this dropdown!**"
+                    }})
+                }else{
+                    await errorCallback(this,"dropdown")
                 }
+                
+            }catch(err){
+                process.emit("uncaughtException",err)
             }
         },timeoutMs ?? 2500)
     }
@@ -980,11 +977,11 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             if (this.interaction.replied || this.interaction.deferred){
                 const sent = await this.interaction.editReply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:sent}
             }else{
                 const sent = await this.interaction.reply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }
         }catch{
@@ -997,11 +994,11 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             if (this.interaction.replied || this.interaction.deferred){
                 const sent = await this.interaction.editReply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }else{
                 const sent = await this.interaction.update(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }
         }catch{
@@ -1010,6 +1007,7 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this dropdown. */
     async defer(type:"reply"|"update", ephemeral:boolean){
+        this.ignoreResponderTimeout = true
         if (this.interaction.deferred || this.interaction.replied) return false
         if (type == "reply"){
             const msgFlags: number[] = ephemeral ? [discord.MessageFlags.Ephemeral] : []
@@ -1017,14 +1015,13 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
         }else{
             await this.interaction.deferUpdate()
         }
-        this.didReply = true
         return true
     }
     /**Show a modal as reply to this dropdown. */
     async modal(modal:ODModalBuildResult){
+        this.ignoreResponderTimeout = true
         if (this.interaction.deferred || this.interaction.replied) return false
         await this.interaction.showModal(modal.modal)
-        this.didReply = true
         return true
     }
 
@@ -1185,8 +1182,8 @@ export class ODModalResponderInstanceValues {
 export class ODModalResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.ModalSubmitInteraction
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean = false
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean = false
     /**The manager for all fields of this modal. */
     values: ODModalResponderInstanceValues
     /**The user who triggered this modal. */
@@ -1208,19 +1205,18 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         this.channel = interaction.channel
         
         setTimeout(async () => {
-            if (!this.didReply){
-                try {
-                    if (!errorCallback){
-                        this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
-                            content:":x: **Something went wrong while replying to this modal!**"
-                        }})
-                    }else{
-                        await errorCallback(this,"modal")
-                    }
-                    
-                }catch(err){
-                    process.emit("uncaughtException",err)
+            if (this.ignoreResponderTimeout) return
+            try {
+                if (!errorCallback){
+                    this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
+                        content:":x: **Something went wrong while replying to this modal!**"
+                    }})
+                }else{
+                    await errorCallback(this,"modal")
                 }
+                
+            }catch(err){
+                process.emit("uncaughtException",err)
             }
         },timeoutMs ?? 2500)
     }
@@ -1230,7 +1226,7 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         try {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             const sent = await this.interaction.followUp(finalMessage)
-            this.didReply = true
+            this.ignoreResponderTimeout = true
             return {success:true,message:sent}
         }catch{
             return {success:false,message:null}
@@ -1242,11 +1238,11 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             if (this.interaction.replied || this.interaction.deferred){
                 const sent = await this.interaction.editReply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }else{
                 const sent = await this.interaction.reply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }
         }catch{
@@ -1255,6 +1251,7 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this modal. */
     async defer(type:"reply"|"update", ephemeral:boolean){
+        this.ignoreResponderTimeout = true
         if (this.interaction.deferred || this.interaction.replied) return false
         if (type == "reply"){
             const msgFlags: number[] = ephemeral ? [discord.MessageFlags.Ephemeral] : []
@@ -1262,7 +1259,6 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         }else{
             await this.interaction.deferUpdate()
         }
-        this.didReply = true
         return true
     }
 }
@@ -1359,8 +1355,8 @@ export class ODContextMenuResponderManager<IdList extends ODContextMenuResponder
 export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction: discord.ContextMenuCommandInteraction
-    /**Did a worker already reply to this instance/interaction? */
-    didReply: boolean = false
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    protected ignoreResponderTimeout: boolean = false
     /**The context menu wich is the source of this instance. */
     menu:ODContextMenu
     /**The user who triggered this context menu. */
@@ -1388,19 +1384,18 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
         else throw new ODSystemError("ODContextMenuResponderInstance: Invalid context menu type. Should be of the type User/Message!")
         
         setTimeout(async () => {
-            if (!this.didReply){
-                try {
-                    if (!errorCallback){
-                        this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
-                            content:":x: **Something went wrong while replying to this context menu!**"
-                        }})
-                    }else{
-                        await errorCallback(this,"context-menu")
-                    }
-                    
-                }catch(err){
-                    process.emit("uncaughtException",err)
+            if (this.ignoreResponderTimeout) return
+            try {
+                if (!errorCallback){
+                    this.reply({id:new ODId("opendiscord:unknown-error"), ephemeral:true, message:{
+                        content:":x: **Something went wrong while replying to this context menu!**"
+                    }})
+                }else{
+                    await errorCallback(this,"context-menu")
                 }
+                
+            }catch(err){
+                process.emit("uncaughtException",err)
             }
         },timeoutMs ?? 2500)
     }
@@ -1411,11 +1406,11 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             if (this.interaction.replied || this.interaction.deferred){
                 const sent = await this.interaction.editReply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:sent}
             }else{
                 const sent = await this.interaction.reply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }
         }catch{
@@ -1428,7 +1423,7 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build,"interaction")
             if (this.interaction.replied || this.interaction.deferred){
                 const sent = await this.interaction.editReply(finalMessage)
-                this.didReply = true
+                this.ignoreResponderTimeout = true
                 return {success:true,message:await sent.fetch()}
             }else throw new ODSystemError("Unable to update context menu interaction!")
         }catch{
@@ -1437,19 +1432,19 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
     }
     /**Defer this context menu. */
     async defer(type:"reply", ephemeral:boolean){
+        this.ignoreResponderTimeout = true
         if (this.interaction.deferred || this.interaction.replied) return false
         if (type == "reply"){
             const msgFlags: number[] = ephemeral ? [discord.MessageFlags.Ephemeral] : []
             await this.interaction.deferReply({flags:msgFlags})
         }
-        this.didReply = true
         return true
     }
     /**Show a modal as reply to this context menu. */
     async modal(modal:ODModalBuildResult){
+        this.ignoreResponderTimeout = true
         if (this.interaction.deferred || this.interaction.replied) return false
         await this.interaction.showModal(modal.modal)
-        this.didReply = true
         return true
     }
 }

package/src/utilities/index.ts

@@ -1,6 +1,7 @@
 import * as fs from "fs"
 import ansis from "ansis"
 import * as api from "../api/index.js"
+import * as discord from "discord.js"
 
 /**## sharedFuses `utility variable`
  * All shared fuses from Open Discord. Please use `opendiscord.sharedFuses` instead!
@@ -166,6 +167,27 @@ export function trimEmojis(text:string){
     return text.replace(/(\p{Extended_Pictographic}(?:\uFE0F|\uFE0E)?(?:\u200D\p{Extended_Pictographic}(?:\uFE0F|\uFE0E)?)*)/gu,"")
 }
 
+/**## getMessageFromBuildResult `utility function`
+ * Get the final `messageCreateOptions` from a returned build result from builders/components.
+ */
+export function getMessageFromBuildResult(build:api.ODMessageBuildResult|api.ODMessageComponentBuildResult,type:"interaction"|"message"){
+    const msgFlags: number[] = []
+    let msgData: discord.MessageCreateOptions
+    if ('message' in build){
+        //USING BUILDERS (deprecated)
+        msgData = build.message
+        if (build.ephemeral) msgFlags.push(discord.MessageFlags.Ephemeral)
+    }else{
+        //USING COMPONENTS
+        msgData = build.msg
+        if (type == "interaction" && build.ephemeral) msgFlags.push(discord.MessageFlags.Ephemeral) //disabled with regular messages
+        if (build.componentsV2) msgFlags.push(discord.MessageFlags.IsComponentsV2)
+        if (build.supressEmbeds) msgFlags.push(discord.MessageFlags.SuppressEmbeds)
+        if (build.supressNotifications) msgFlags.push(discord.MessageFlags.SuppressNotifications)
+    }
+    return Object.assign(msgData,{flags:msgFlags})
+}
+
 /**## easterEggs `utility object`
  * Object containing data for Open Ticket easter eggs.
  */