js-discord-modularcommand 3.0.0 → 3.2.0

package/dist/modularbutton.js

@@ -25,6 +25,12 @@ class ModularButton {
     constructor(customId, command) {
         /** Use other mechanisms to handle button interactions. */
         this.execute = async () => { };
+        if (!customId || typeof customId !== "string") {
+            throw new Error("Custom ID must be a non-empty string.");
+        }
+        if (!command.name || typeof command.name !== "string") {
+            throw new Error("ModularCommand must have a valid name.");
+        }
         this.buttonObject = new discord_js_1.ButtonBuilder()
             .setCustomId(`${command.name}_${customId}`);
         this.command = command;
@@ -60,7 +66,14 @@ class ModularButton {
      * @returns {ButtonBuilder} The built ButtonBuilder instance with localized label.
      */
     build(locale) {
-        this.buttonObject.setLabel(locale[`${this.command.name}.${this.buttonId}`]);
+        if (!locale || typeof locale !== "object") {
+            throw new Error("Locale must be a valid object.");
+        }
+        const labelKey = `${this.command.name}.${this.buttonId}`;
+        if (!locale[labelKey]) {
+            throw new Error(`Locale key "${labelKey}" not found in the provided locale object.`);
+        }
+        this.buttonObject.setLabel(locale[labelKey]);
         return this.buttonObject;
     }
 }

package/dist/modularcommand.js

@@ -65,6 +65,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setDescription(description) {
+        if (!description || typeof description !== "string") {
+            throw new Error("Description must be a non-empty string.");
+        }
         this.description = description;
         return this;
     }
@@ -75,6 +78,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationsDescription(localizations) {
+        if (!localizations || typeof localizations !== "object") {
+            throw new Error("Localizations must be a valid object.");
+        }
         return this.setLocalizationDescription(localizations);
     }
     /**
@@ -83,6 +89,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationDescription(localizations) {
+        if (!localizations || typeof localizations !== "object") {
+            throw new Error("Localizations must be a valid object.");
+        }
         this.description = localizations[discord_js_1.Locale.EnglishUS] || this.description;
         this.descriptionLocalizations = {
             ...this.descriptionLocalizations,
@@ -96,6 +105,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationOptions(localizations) {
+        if (!localizations || typeof localizations !== "object") {
+            throw new Error("Localizations must be a valid object.");
+        }
         this.optionsLocalizations = {
             ...this.optionsLocalizations,
             ...localizations,
@@ -108,6 +120,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationPhrases(localizationPhrases) {
+        if (!localizationPhrases || typeof localizationPhrases !== "object") {
+            throw new Error("Localization phrases must be a valid object.");
+        }
         this.localizationPhrases = {
             ...this.localizationPhrases,
             ...localizationPhrases,
@@ -120,6 +135,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationSubCommands(localizations) {
+        if (!localizations || typeof localizations !== "object") {
+            throw new Error("Localizations must be a valid object.");
+        }
         this.subCommandLocalizations = {
             ...this.subCommandLocalizations,
             ...localizations,
@@ -132,6 +150,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setExecute(executeFunction) {
+        if (!executeFunction || typeof executeFunction !== "function") {
+            throw new Error("Execute function must be a valid function.");
+        }
         this.execute = executeFunction;
         return this;
     }
@@ -142,6 +163,12 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setComponentExecute(componentId, executeFunction) {
+        if (!componentId || typeof componentId !== "string") {
+            throw new Error("Component ID must be a non-empty string.");
+        }
+        if (!executeFunction || typeof executeFunction !== "function") {
+            throw new Error("Execute function must be a valid function.");
+        }
         this.componentId = componentId;
         this.componentExecute = executeFunction;
         return this;
@@ -152,6 +179,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setPermissionCheck(permissionCheckFunction) {
+        if (!permissionCheckFunction || typeof permissionCheckFunction !== "function") {
+            throw new Error("Permission check function must be a valid function.");
+        }
         this.permissionCheck = permissionCheckFunction;
         return this;
     }
@@ -161,6 +191,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     setCooldown(cooldown) {
+        if (typeof cooldown !== "number" || cooldown < 0) {
+            throw new Error("Cooldown must be a non-negative number.");
+        }
         this.cooldown = cooldown;
         return this;
     }
@@ -177,6 +210,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     addOption(option) {
+        if (!option || typeof option !== "object") {
+            throw new Error("Option must be a valid object.");
+        }
         this.options.push(option);
         return this;
     }
@@ -186,6 +222,9 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     addSubCommand(subCommand) {
+        if (!subCommand || typeof subCommand !== "object") {
+            throw new Error("SubCommand must be a valid object.");
+        }
         this.subCommands.push(subCommand);
         return this;
     }
@@ -196,6 +235,12 @@ class ModularCommand {
      * @returns {ModularCommand} The command instance for chaining.
      */
     addCustomIDHandler(customId, handlerFunction) {
+        if (!customId || typeof customId !== "string") {
+            throw new Error("Custom ID must be a non-empty string.");
+        }
+        if (!handlerFunction || typeof handlerFunction !== "function") {
+            throw new Error("Handler function must be a valid function.");
+        }
         this.customIdHandlers[customId] = handlerFunction;
         return this;
     }
@@ -205,6 +250,9 @@ class ModularCommand {
      * @returns {ModularModal} The created modal instance.
      */
     addModal(modalId) {
+        if (!modalId || typeof modalId !== "string") {
+            throw new Error("Modal ID must be a non-empty string.");
+        }
         const modal = new modularmodal_js_1.default(modalId, this);
         this.modals.set(modalId, modal);
         return modal;
@@ -216,6 +264,12 @@ class ModularCommand {
      * @return {ModularButton} The created button instance.
      */
     addButton(customId, execute) {
+        if (!customId || typeof customId !== "string") {
+            throw new Error("Custom ID must be a non-empty string.");
+        }
+        if (!execute || typeof execute !== "function") {
+            throw new Error("Execute function must be a valid function.");
+        }
         const button = new modularbutton_js_1.default(customId, this);
         button.setExecute(execute);
         this.buttons.set(customId, button);
@@ -228,6 +282,9 @@ class ModularCommand {
      * @returns {ModularSelectMenu} The created select menu instance.
      */
     addSelectMenu(selectMenuId) {
+        if (!selectMenuId || typeof selectMenuId !== "string") {
+            throw new Error("Select Menu ID must be a non-empty string.");
+        }
         const menu = new modularselectmenu_js_1.default(selectMenuId, this);
         this.selectMenus.set(selectMenuId, menu);
         this.selectMenusArray.push(menu);

package/dist/modularmodal.js

@@ -26,6 +26,12 @@ class ModularModal {
     constructor(modalId, command) {
         /** The function to execute when the modal is submitted. */
         this.execute = async () => { };
+        if (!modalId || typeof modalId !== "string") {
+            throw new Error("Modal ID must be a non-empty string.");
+        }
+        if (!command.name || typeof command.name !== "string") {
+            throw new Error("ModularCommand must have a valid name.");
+        }
         this.customId = `${command.name}_${modalId}`;
         this.modalId = modalId;
         this.command = command;
@@ -52,6 +58,9 @@ class ModularModal {
      * @returns {this} The current ModularModal instance for method chaining.
      */
     setExecute(executeFunction) {
+        if (!executeFunction || typeof executeFunction !== "function") {
+            throw new Error("Execute function must be a valid function.");
+        }
         this.execute = executeFunction;
         return this;
     }
@@ -61,6 +70,9 @@ class ModularModal {
      * @returns {TextInputBuilder} The created text input instance.
      */
     newTextInput(id) {
+        if (!id || typeof id !== "string") {
+            throw new Error("Text input ID must be a non-empty string.");
+        }
         const textInput = new discord_js_1.TextInputBuilder()
             .setCustomId(id);
         this.modalInputs.set(id, textInput);
@@ -74,16 +86,25 @@ class ModularModal {
      * @returns {ModalBuilder} The fully constructed modal object ready to be sent to a user.
      */
     build(locale) {
-        this.modalObject.setTitle(locale[`${this.command.name}.${this.modalId}.title`]);
+        if (!locale || typeof locale !== "object") {
+            throw new Error("Locale must be a valid object.");
+        }
+        const titleKey = `${this.command.name}.${this.modalId}.title`;
+        if (!locale[titleKey]) {
+            throw new Error(`Missing locale entry for modal title: ${titleKey}`);
+        }
+        this.modalObject.setTitle(locale[titleKey]);
         this.modalInputs.forEach((input, id) => {
             const labelKey = `${this.command.name}.${id}.label`;
             const placeholderKey = `${this.command.name}.${id}.placeholder`;
-            if (locale[labelKey]) {
-                input.setLabel(locale[labelKey]);
+            if (!locale[labelKey]) {
+                throw new Error(`Missing locale entry for text input label: ${labelKey}`);
             }
-            if (locale[placeholderKey]) {
-                input.setPlaceholder(locale[placeholderKey]);
+            if (!locale[placeholderKey]) {
+                throw new Error(`Missing locale entry for text input placeholder: ${placeholderKey}`);
             }
+            input.setLabel(locale[labelKey]);
+            input.setPlaceholder(locale[placeholderKey]);
         });
         return this.modalObject;
     }

package/dist/modularselectmenu.js

@@ -26,6 +26,12 @@ class ModularSelectMenu {
     constructor(selectMenuId, command) {
         /** The function to execute when the select menu is interacted with. */
         this.execute = async () => { };
+        if (!selectMenuId || typeof selectMenuId !== "string") {
+            throw new Error("Select Menu ID must be a non-empty string.");
+        }
+        if (!command.name || typeof command.name !== "string") {
+            throw new Error("ModularCommand must have a valid name.");
+        }
         this.selectMenuId = selectMenuId;
         this.command = command;
         this.customId = `${command.name}_${selectMenuId}`;
@@ -52,6 +58,9 @@ class ModularSelectMenu {
      * @returns {this} The current ModularSelectMenu instance for method chaining.
      */
     setExecute(executeFunction) {
+        if (!executeFunction || typeof executeFunction !== "function") {
+            throw new Error("Execute function must be a valid function.");
+        }
         this.execute = executeFunction;
         return this;
     }
@@ -62,6 +71,9 @@ class ModularSelectMenu {
      * @returns {StringSelectMenuOptionBuilder} The created option instance for further configuration (e.g., `setDefault`).
      */
     addOption(value) {
+        if (!value || typeof value !== "string") {
+            throw new Error("Option value must be a non-empty string.");
+        }
         const option = new discord_js_1.StringSelectMenuOptionBuilder().setValue(value);
         this.options.set(value, option);
         return option;
@@ -72,6 +84,9 @@ class ModularSelectMenu {
      * @returns {StringSelectMenuBuilder} The fully constructed select menu object ready to be sent to a user.
      */
     build(locale) {
+        if (!locale || typeof locale !== "object") {
+            throw new Error("Locale must be a valid object.");
+        }
         const placeholderKey = `${this.command.name}.${this.selectMenuId}.placeholder`;
         if (locale[placeholderKey]) {
             this.selectMenuObject.setPlaceholder(locale[placeholderKey]);

package/dist/registercommand.js

@@ -50,35 +50,64 @@ const cooldown_1 = __importStar(require("./cooldown"));
 const locales_1 = require("./locales");
 /**
  * @description Gets localized description for a subcommand.
+ * Supports multiple languages and falls back to default description if not found.
  * @param {ModularCommand} command The command instance.
  * @param {string} subCommandName The name of the subcommand.
  * @param {string} defaultDescription The default description.
+ * @param {string} locale The locale to use (defaults to EnglishUS).
  * @returns {string} The localized description.
  */
-function getLocalizedSubCommandDescription(command, subCommandName, defaultDescription) {
+function getLocalizedSubCommandDescription(command, subCommandName, defaultDescription, locale = discord_js_1.Locale.EnglishUS) {
     if (!command.subCommandLocalizations)
         return defaultDescription;
     const localizations = command.subCommandLocalizations;
+    const key = `${subCommandName}.description`;
+    // Try to get the localization for the requested locale
+    const targetLocalizations = localizations[locale];
+    if (targetLocalizations?.[key]) {
+        return targetLocalizations[key];
+    }
+    // Fall back to English if the requested locale is not found
     const enLocalizations = localizations[discord_js_1.Locale.EnglishUS];
-    return enLocalizations?.[`${subCommandName}.description`] || defaultDescription;
+    if (enLocalizations?.[key]) {
+        return enLocalizations[key];
+    }
+    else {
+        throw new Error(`Missing localization for subcommand '${subCommandName}' in command '${command.name}'`);
+    }
 }
 /**
  * @description Gets localized description for a subcommand option.
+ * Supports multiple languages and falls back to default description if not found.
  * @param {ModularCommand} command The command instance.
  * @param {string} subCommandName The name of the subcommand.
  * @param {string} optionName The name of the option.
  * @param {string} defaultDescription The default description.
+ * @param {string} locale The locale to use (defaults to EnglishUS).
  * @returns {string} The localized description.
  */
-function getLocalizedOptionDescription(command, subCommandName, optionName, defaultDescription) {
+function getLocalizedOptionDescription(command, subCommandName, optionName, defaultDescription, locale = discord_js_1.Locale.EnglishUS) {
     if (!command.subCommandLocalizations)
         return defaultDescription;
     const localizations = command.subCommandLocalizations;
+    const key = `${subCommandName}.${optionName}.description`;
+    // Try to get the localization for the requested locale
+    const targetLocalizations = localizations[locale];
+    if (targetLocalizations?.[key]) {
+        return targetLocalizations[key];
+    }
+    // Fall back to English if the requested locale is not found
     const enLocalizations = localizations[discord_js_1.Locale.EnglishUS];
-    return enLocalizations?.[`${subCommandName}.${optionName}.description`] || defaultDescription;
+    if (enLocalizations?.[key]) {
+        return enLocalizations[key];
+    }
+    else {
+        throw new Error(`Missing localization for option '${optionName}' in subcommand '${subCommandName}' for command '${command.name}'`);
+    }
 }
 /**
  * @description Creates an option builder function with common configuration.
+ * Supports multi-language descriptions through LocalizationMap.
  * @param {CommandOption} opt The option configuration.
  * @param {string} description The resolved description.
  * @returns {Function} The option builder function.
@@ -140,8 +169,14 @@ function processSubCommands(commandBuilder, command, options) {
         return;
     command.subCommands.forEach(subCmd => {
         commandBuilder.addSubcommand((subcommand) => {
+            if (typeof subCmd.name !== 'string' || subCmd.name.trim() === '') {
+                throw new Error("A subcommand is missing a name.");
+            }
             // Get localized description for subcommand
             const subCmdDescription = getLocalizedSubCommandDescription(command, subCmd.name, subCmd.description);
+            if (typeof subCmdDescription !== 'string' || subCmdDescription.trim() === '') {
+                throw new Error(`Subcommand '${subCmd.name}' is missing a description.`);
+            }
             subcommand
                 .setName(subCmd.name)
                 .setDescription(subCmdDescription);
@@ -378,10 +413,12 @@ function createSelectMenuExecutor(command) {
 function RegisterCommand(commands) {
     commands = Array.isArray(commands) ? commands : [commands];
     return commands.map(command => {
-        if (command.name === undefined)
+        if (typeof command.name !== 'string' || command.name.trim() === '') {
             throw new Error("A command is missing a name.");
-        if (command.description === undefined)
+        }
+        if (typeof command.description !== 'string' || command.description.trim() === '') {
             throw new Error(`Command "${command.name}" is missing a description.`);
+        }
         // Build SlashCommand Data
         const commandBuilder = new discord_js_1.SlashCommandBuilder()
             .setName(command.name)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-discord-modularcommand",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "",
   "keywords": [
     "discord",
@@ -9,7 +9,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/vicentefelipechile/js-discord-modularcommand.git"
+    "url": "git+https://github.com/vicentefelipechile/js-discord-modularcommand.git"
   },
   "license": "MIT",
   "author": "vicentefelipechile",