@open-discord-bots/framework 0.4.7 → 0.5.0

package/dist/api/main.js

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

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

@@ -2,7 +2,7 @@ import { ODId, ODValidId, ODManagerData, ODNoGeneric, ODManager, ODValidButtonCo
 import * as discord from "discord.js";
 import { ODWorkerManager, ODWorkerCallback } from "./worker.js";
 import { ODDebugger } from "./console.js";
-import { ODMessage, ODMessageInstance } from "./builder.js";
+import { ODMessage, ODMessageInstance, ODModalBuildResult } from "./builder.js";
 /**## ODComponentFactoryInstance `class`
  * An Open Discord component factory instance.
  *
@@ -395,9 +395,12 @@ export type ODValidModalComponents = ODLabelComponent | ODTextComponent;
  * A modal builder with **components v2** support.
  * Add questions, select menu's & labels to this modal using `addComponent()`.
  */
-export declare class ODModalComponent extends ODGroupComponent<ODModalComponentData, ODValidModalComponents, discord.ModalBuilder> {
+export declare class ODModalComponent extends ODGroupComponent<ODModalComponentData, ODValidModalComponents, ODModalBuildResult> {
     constructor(id: ODValidId, data?: Partial<ODModalComponentData>);
-    build(): Promise<discord.ModalBuilder>;
+    build(): Promise<{
+        id: ODId;
+        modal: discord.ModalBuilder;
+    }>;
     /**Set the title of the modal. */
     setTitle(title: string): this;
     /**Set the custom id of this modal. */

package/dist/api/modules/component.js

@@ -538,11 +538,14 @@ export class ODModalComponent extends ODGroupComponent {
                     components.push(res.toJSON());
             }
         }
-        return new discord.ModalBuilder({
-            components,
-            title: this.data.title,
-            customId: this.data.customId
-        });
+        return {
+            id: new ODId(this.id),
+            modal: new discord.ModalBuilder({
+                components,
+                title: this.data.title,
+                customId: this.data.customId
+            })
+        };
     }
     /**Set the title of the modal. */
     setTitle(title) {

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

@@ -351,7 +351,9 @@ export declare class ODDropdownResponderInstanceValues {
     /**Get the selected users. */
     getUserValues(): Promise<discord.User[]>;
     /**Get the selected channels. */
-    getChannelValues(): Promise<discord.GuildBasedChannel[]>;
+    getChannelValues(): Promise<discord.Channel[]>;
+    /**Get the selected mentionables. */
+    getMentionableValues(): Promise<(discord.User | discord.Role)[]>;
 }
 /**## ODDropdownResponderInstance `class`
  * This is an Open Discord dropdown responder instance.
@@ -458,6 +460,25 @@ export declare class ODModalResponderInstanceValues {
     /**Get the value of a text field. */
     getTextField(name: string, required: true): string;
     getTextField(name: string, required: false): string | null;
+    /**Get the state of a single checkbox field. */
+    getSingleCheckbox(name: string): boolean;
+    /**Get the selected checkboxes of a checkbox group. */
+    getCheckboxGroup(name: string): string[];
+    /**Get the selected value of a radio group. */
+    getRadioGroup(name: string, required: true): string;
+    getRadioGroup(name: string, required: false): string | null;
+    /**Get the selected values of a string/text dropdown. */
+    getStringDropdownValues(name: string): string[];
+    /**Get the selected values of a role dropdown. */
+    getRoleDropdownValues(name: string): Promise<discord.Role[]>;
+    /**Get the selected values of a user dropdown. */
+    getUserDropdownValues(name: string): Promise<discord.User[]>;
+    /**Get selected values of a channel dropdown. */
+    getChannelDropdownValues(name: string): Promise<discord.Channel[]>;
+    /**Get the selected values of a mentionable dropdown. */
+    getMentionableDropdownValues(name: string): Promise<(discord.User | discord.Role)[]>;
+    /**Get the uploaded files of a modal file upload component. */
+    getUploadedFiles(name: string): Promise<discord.Attachment[]>;
 }
 /**## ODModalResponderInstance `class`
  * This is an Open Discord modal responder instance.

package/dist/api/modules/responder.js

@@ -781,6 +781,8 @@ export class ODDropdownResponderInstanceValues {
     }
     /**Get the selected values. */
     getStringValues() {
+        if (this.type != "string" || !this.interaction.isStringSelectMenu())
+            throw new ODSystemError("ODDropdownResponderInstanceValues:getStringValues() dropdown type isn't 'role'!");
         try {
             return this.interaction.values;
         }
@@ -791,16 +793,20 @@ export class ODDropdownResponderInstanceValues {
     }
     /**Get the selected roles. */
     async getRoleValues() {
-        if (this.type != "role")
-            throw new ODSystemError("ODDropdownResponderInstanceValues:getRoleValues() dropdown type isn't role!");
+        if (this.type != "role" || !this.interaction.isRoleSelectMenu())
+            throw new ODSystemError("ODDropdownResponderInstanceValues:getRoleValues() dropdown type isn't 'role'!");
         try {
             const result = [];
-            for (const id of this.interaction.values) {
-                if (!this.interaction.guild)
-                    break;
-                const role = await this.interaction.guild.roles.fetch(id);
-                if (role)
+            if (!this.interaction.guild)
+                return result;
+            for (const role of this.interaction.roles.toJSON()) {
+                if (role instanceof discord.Role)
                     result.push(role);
+                else {
+                    const fetchedRole = await this.interaction.guild.roles.fetch(role.id);
+                    if (fetchedRole)
+                        result.push(fetchedRole);
+                }
             }
             return result;
         }
@@ -811,16 +817,10 @@ export class ODDropdownResponderInstanceValues {
     }
     /**Get the selected users. */
     async getUserValues() {
-        if (this.type != "role")
-            throw new ODSystemError("ODDropdownResponderInstanceValues:getUserValues() dropdown type isn't user!");
+        if (this.type != "user" || !this.interaction.isUserSelectMenu())
+            throw new ODSystemError("ODDropdownResponderInstanceValues:getUserValues() dropdown type isn't 'user'!");
         try {
-            const result = [];
-            for (const id of this.interaction.values) {
-                const user = await this.interaction.client.users.fetch(id);
-                if (user)
-                    result.push(user);
-            }
-            return result;
+            return this.interaction.users.toJSON();
         }
         catch (err) {
             process.emit("uncaughtException", err);
@@ -829,16 +829,18 @@ export class ODDropdownResponderInstanceValues {
     }
     /**Get the selected channels. */
     async getChannelValues() {
-        if (this.type != "role")
-            throw new ODSystemError("ODDropdownResponderInstanceValues:getChannelValues() dropdown type isn't channel!");
+        if (this.type != "channel" || !this.interaction.isChannelSelectMenu())
+            throw new ODSystemError("ODDropdownResponderInstanceValues:getChannelValues() dropdown type isn't 'channel'!");
         try {
             const result = [];
-            for (const id of this.interaction.values) {
-                if (!this.interaction.guild)
-                    break;
-                const guild = await this.interaction.guild.channels.fetch(id);
-                if (guild)
-                    result.push(guild);
+            for (const channel of this.interaction.channels.toJSON()) {
+                if (channel instanceof discord.BaseChannel)
+                    result.push(channel);
+                else {
+                    const fetchedChannel = await this.interaction.client.channels.fetch(channel.id);
+                    if (fetchedChannel)
+                        result.push(fetchedChannel);
+                }
             }
             return result;
         }
@@ -847,6 +849,31 @@ export class ODDropdownResponderInstanceValues {
             throw new ODSystemError("ODDropdownResponderInstanceValues:getChannelValues() invalid values!");
         }
     }
+    /**Get the selected mentionables. */
+    async getMentionableValues() {
+        if (this.type != "mentionable" || !this.interaction.isMentionableSelectMenu())
+            throw new ODSystemError("ODDropdownResponderInstanceValues:getMentionableValues() dropdown type isn't 'mentionable'!");
+        try {
+            const result = [];
+            result.push(...this.interaction.users.toJSON());
+            if (!this.interaction.guild)
+                return result;
+            for (const role of this.interaction.roles.toJSON()) {
+                if (role instanceof discord.Role)
+                    result.push(role);
+                else {
+                    const fetchedRole = await this.interaction.guild.roles.fetch(role.id);
+                    if (fetchedRole)
+                        result.push(fetchedRole);
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODDropdownResponderInstanceValues:getMentionableValues() invalid values!");
+        }
+    }
 }
 /**## ODDropdownResponderInstance `class`
  * This is an Open Discord dropdown responder instance.
@@ -1089,16 +1116,149 @@ export class ODModalResponderInstanceValues {
     }
     getTextField(name, required) {
         try {
-            const data = this.interaction.fields.getField(name, discord.ComponentType.TextInput);
-            if (!data && required)
-                throw new ODSystemError("ODModalResponderInstanceValues:getTextField() field not found!");
-            return (data) ? data.value : null;
+            const data = this.interaction.fields.getTextInputValue(name);
+            if (data.length < 1 && required)
+                throw new ODSystemError("ODModalResponderInstanceValues:getTextField() field required, found empty!");
+            return (data.length < 1) ? data : null;
         }
         catch (err) {
             process.emit("uncaughtException", err);
             throw new ODSystemError("ODModalResponderInstanceValues:getTextField() field not found!");
         }
     }
+    /**Get the state of a single checkbox field. */
+    getSingleCheckbox(name) {
+        try {
+            return this.interaction.fields.getCheckbox(name);
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getSingleCheckbox() field not found!");
+        }
+    }
+    /**Get the selected checkboxes of a checkbox group. */
+    getCheckboxGroup(name) {
+        try {
+            return [...this.interaction.fields.getCheckboxGroup(name)];
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getCheckboxGroup() field not found!");
+        }
+    }
+    getRadioGroup(name, required) {
+        try {
+            const data = this.interaction.fields.getRadioGroup(name);
+            if (typeof data !== "string" && required)
+                throw new ODSystemError("ODModalResponderInstanceValues:getRadioGroup() field required, found empty!");
+            return data;
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getRadioGroup() field not found!");
+        }
+    }
+    /**Get the selected values of a string/text dropdown. */
+    getStringDropdownValues(name) {
+        try {
+            return [...this.interaction.fields.getStringSelectValues(name)];
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getStringDropdownValues() field not found!");
+        }
+    }
+    /**Get the selected values of a role dropdown. */
+    async getRoleDropdownValues(name) {
+        try {
+            const result = [];
+            if (!this.interaction.guild)
+                return result;
+            for (const role of (this.interaction.fields.getSelectedRoles(name)?.toJSON() ?? [])) {
+                if (!role)
+                    continue;
+                else if (role instanceof discord.Role)
+                    result.push(role);
+                else {
+                    const fetchedRole = await this.interaction.guild.roles.fetch(role.id);
+                    if (fetchedRole)
+                        result.push(fetchedRole);
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getRoleDropdownValues() field not found!");
+        }
+    }
+    /**Get the selected values of a user dropdown. */
+    async getUserDropdownValues(name) {
+        try {
+            const result = (this.interaction.fields.getSelectedUsers(name)?.toJSON() ?? []);
+            return result;
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getUserDropdownValues() field not found!");
+        }
+    }
+    /**Get selected values of a channel dropdown. */
+    async getChannelDropdownValues(name) {
+        try {
+            const result = [];
+            for (const channel of (this.interaction.fields.getSelectedChannels(name)?.toJSON() ?? [])) {
+                if (channel instanceof discord.BaseChannel)
+                    result.push(channel);
+                else {
+                    const fetchedChannel = await this.interaction.client.channels.fetch(channel.id);
+                    if (fetchedChannel)
+                        result.push(fetchedChannel);
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getChannelDropdownValues() field not found!");
+        }
+    }
+    /**Get the selected values of a mentionable dropdown. */
+    async getMentionableDropdownValues(name) {
+        try {
+            const result = [];
+            result.push(...(this.interaction.fields.getSelectedUsers(name)?.toJSON() ?? []));
+            if (!this.interaction.guild)
+                return result;
+            for (const role of (this.interaction.fields.getSelectedRoles(name)?.toJSON() ?? [])) {
+                if (!role)
+                    continue;
+                else if (role instanceof discord.Role)
+                    result.push(role);
+                else {
+                    const fetchedRole = await this.interaction.guild.roles.fetch(role.id);
+                    if (fetchedRole)
+                        result.push(fetchedRole);
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getMentionableDropdownValues() field not found!");
+        }
+    }
+    /**Get the uploaded files of a modal file upload component. */
+    async getUploadedFiles(name) {
+        try {
+            const result = (this.interaction.fields.getUploadedFiles(name)?.toJSON() ?? []);
+            return result;
+        }
+        catch (err) {
+            process.emit("uncaughtException", err);
+            throw new ODSystemError("ODModalResponderInstanceValues:getUploadedFiles() field not found!");
+        }
+    }
 }
 /**## ODModalResponderInstance `class`
  * This is an Open Discord modal responder instance.

package/package.json

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