js-discord-modularcommand 1.1.0 → 2.0.0

package/dist/cooldown.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @file Manages command cooldowns for users to prevent spam.
+ * @author vicentefelipechile
+ * @license MIT
+ */
+/**
+ * @interface CooldownStatus
+ * @description Represents the cooldown status of a user for a specific command.
+*/
+interface CooldownStatus {
+    /** Indicates if the user is currently on cooldown. */
+    inCooldown: boolean;
+    /** The remaining time in seconds until the cooldown expires. It will be 0 if the user is not in cooldown. */
+    waitTime: number;
+}
+/**
+ * Registers a new command and its cooldown duration in the internal maps.
+ * @param {string} name - The name of the command to register.
+ * @param {number} duration - The cooldown duration in seconds.
+ * @returns {void}
+ */
+export declare function cooldownRegister(name: string, duration: number): void;
+/**
+ * Gets the last execution timestamp for a user on a specific command.
+ * @param {string} name - The name of the command.
+ * @param {string} userId - The ID of the user.
+ * @returns {number | undefined} The timestamp (in milliseconds) of the last execution, or `undefined` if not found.
+ */
+export declare function cooldownGetUser(name: string, userId: string): number | undefined;
+/**
+ * Sets the current timestamp for a user on a specific command, effectively starting their cooldown.
+ * @param {string} name - The name of the command.
+ * @param {string} userId - The ID of the user.
+ * @returns {void}
+ */
+export declare function cooldownSetUser(name: string, userId: string): void;
+/**
+ * Checks if a user is currently on cooldown for a specific command.
+ * @param {string} name - The name of the command.
+ * @param {string} userId - The ID of the user.
+ * @returns {CooldownStatus} An object indicating if the user is in cooldown and the remaining time.
+ */
+export default function isUserInCooldown(name: string, userId: string): CooldownStatus;
+export {};

package/dist/cooldown.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * @file Manages command cooldowns for users to prevent spam.
+ * @author vicentefelipechile
+ * @license MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cooldownRegister = cooldownRegister;
+exports.cooldownGetUser = cooldownGetUser;
+exports.cooldownSetUser = cooldownSetUser;
+exports.default = isUserInCooldown;
+// =================================================================================================
+// Module-level State
+// =================================================================================================
+/**
+ * @description Stores the cooldown duration configured for each command.
+ * @maps Command name (string) to its cooldown duration in seconds (number).
+ */
+const COMMAND_CONFIG = new Map();
+/**
+ * @description Stores the last execution timestamp for each user on a specific command.
+ * @maps Command name (string) to another Map, which in turn maps a user's ID (string) to the execution timestamp (number).
+ */
+const COOLDOWNS_MAP = new Map();
+// =================================================================================================
+// Public Functions
+// =================================================================================================
+/**
+ * Registers a new command and its cooldown duration in the internal maps.
+ * @param {string} name - The name of the command to register.
+ * @param {number} duration - The cooldown duration in seconds.
+ * @returns {void}
+ */
+function cooldownRegister(name, duration) {
+    COMMAND_CONFIG.set(name, duration);
+    COOLDOWNS_MAP.set(name, new Map());
+}
+;
+/**
+ * Gets the last execution timestamp for a user on a specific command.
+ * @param {string} name - The name of the command.
+ * @param {string} userId - The ID of the user.
+ * @returns {number | undefined} The timestamp (in milliseconds) of the last execution, or `undefined` if not found.
+ */
+function cooldownGetUser(name, userId) {
+    return COOLDOWNS_MAP.get(name)?.get(userId);
+}
+/**
+ * Sets the current timestamp for a user on a specific command, effectively starting their cooldown.
+ * @param {string} name - The name of the command.
+ * @param {string} userId - The ID of the user.
+ * @returns {void}
+ */
+function cooldownSetUser(name, userId) {
+    COOLDOWNS_MAP.get(name)?.set(userId, Date.now());
+}
+/**
+ * Checks if a user is currently on cooldown for a specific command.
+ * @param {string} name - The name of the command.
+ * @param {string} userId - The ID of the user.
+ * @returns {CooldownStatus} An object indicating if the user is in cooldown and the remaining time.
+ */
+function isUserInCooldown(name, userId) {
+    const lastTime = cooldownGetUser(name, userId);
+    // If the user has never used the command, they are not on cooldown.
+    if (lastTime === undefined) {
+        return { inCooldown: false, waitTime: 0 };
+    }
+    const timePassed = (Date.now() - lastTime) / 1000; // Time passed in seconds
+    const cooldownCommand = COMMAND_CONFIG.get(name);
+    // This error indicates a developer mistake, as a command should be registered before being checked.
+    if (cooldownCommand === undefined) {
+        throw new Error(`Command '${name}' isn't registered in the cooldown system.`);
+    }
+    if (timePassed < cooldownCommand) {
+        // If the time passed is less than the required cooldown, the user is still on cooldown.
+        return { inCooldown: true, waitTime: cooldownCommand - timePassed };
+    }
+    // Otherwise, the cooldown has expired.
+    return { inCooldown: false, waitTime: 0 };
+}

package/dist/index.d.ts

@@ -1,13 +1,10 @@
-import { ModularCommand, ModularButton, RegisterCommand } from "./modularcommand";
+import { LOCALE_DELAY, LOCALE_ERROR, LOCALE_FORBIDDEN, LOCALE_NSFW } from "./locales";
+import ModularCommandHandler from "./interaction";
+import { CommandData } from "./types";
 import ModularModal from "./modularmodal";
-import { LOCALE_DELAY, LOCALE_ERROR, LOCALE_FORBIDDEN, LOCALE_NSFW, FormatSecondsLocale } from "./locales";
+import ModularCommand from "./modularcommand";
+import ModularButton from "./modularbutton";
+import RegisterCommand from "./registercommand";
+import LoadCommand from "./loadcommands";
 export default ModularCommand;
-export { ModularCommand };
-export { ModularButton };
-export { ModularModal };
-export { RegisterCommand };
-export { FormatSecondsLocale };
-export { LOCALE_DELAY };
-export { LOCALE_ERROR };
-export { LOCALE_FORBIDDEN };
-export { LOCALE_NSFW };
+export { ModularCommand, ModularButton, ModularModal, CommandData, RegisterCommand, LoadCommand, ModularCommandHandler, LOCALE_DELAY, LOCALE_ERROR, LOCALE_FORBIDDEN, LOCALE_NSFW };

package/dist/index.js

@@ -3,17 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOCALE_NSFW = exports.LOCALE_FORBIDDEN = exports.LOCALE_ERROR = exports.LOCALE_DELAY = exports.FormatSecondsLocale = exports.RegisterCommand = exports.ModularModal = exports.ModularButton = exports.ModularCommand = void 0;
-const modularcommand_1 = require("./modularcommand");
-Object.defineProperty(exports, "ModularCommand", { enumerable: true, get: function () { return modularcommand_1.ModularCommand; } });
-Object.defineProperty(exports, "ModularButton", { enumerable: true, get: function () { return modularcommand_1.ModularButton; } });
-Object.defineProperty(exports, "RegisterCommand", { enumerable: true, get: function () { return modularcommand_1.RegisterCommand; } });
-const modularmodal_1 = __importDefault(require("./modularmodal"));
-exports.ModularModal = modularmodal_1.default;
+exports.LOCALE_NSFW = exports.LOCALE_FORBIDDEN = exports.LOCALE_ERROR = exports.LOCALE_DELAY = exports.ModularCommandHandler = exports.LoadCommand = exports.RegisterCommand = exports.ModularModal = exports.ModularButton = exports.ModularCommand = void 0;
 const locales_1 = require("./locales");
 Object.defineProperty(exports, "LOCALE_DELAY", { enumerable: true, get: function () { return locales_1.LOCALE_DELAY; } });
 Object.defineProperty(exports, "LOCALE_ERROR", { enumerable: true, get: function () { return locales_1.LOCALE_ERROR; } });
 Object.defineProperty(exports, "LOCALE_FORBIDDEN", { enumerable: true, get: function () { return locales_1.LOCALE_FORBIDDEN; } });
 Object.defineProperty(exports, "LOCALE_NSFW", { enumerable: true, get: function () { return locales_1.LOCALE_NSFW; } });
-Object.defineProperty(exports, "FormatSecondsLocale", { enumerable: true, get: function () { return locales_1.FormatSecondsLocale; } });
-exports.default = modularcommand_1.ModularCommand;
+const interaction_1 = __importDefault(require("./interaction"));
+exports.ModularCommandHandler = interaction_1.default;
+const modularmodal_1 = __importDefault(require("./modularmodal"));
+exports.ModularModal = modularmodal_1.default;
+const modularcommand_1 = __importDefault(require("./modularcommand"));
+exports.ModularCommand = modularcommand_1.default;
+const modularbutton_1 = __importDefault(require("./modularbutton"));
+exports.ModularButton = modularbutton_1.default;
+const registercommand_1 = __importDefault(require("./registercommand"));
+exports.RegisterCommand = registercommand_1.default;
+const loadcommands_1 = __importDefault(require("./loadcommands"));
+exports.LoadCommand = loadcommands_1.default;
+exports.default = modularcommand_1.default;

package/dist/interaction.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file Contains the logic for handling Discord bot interactions.
+ * @author vicentefelipechile
+ * @license MIT
+ */
+import { BaseInteraction, CommandInteraction, MessageComponentInteraction, ModalSubmitInteraction } from "discord.js";
+import { ClientWithCommands } from "./types";
+/**
+ * @interface InteractionHandlerArgs
+ * @description Defines the arguments for the custom interaction handler function.
+ */
+interface InteractionHandlerArgs {
+    /** The interaction received from Discord. */
+    interaction: CommandInteraction | MessageComponentInteraction | ModalSubmitInteraction;
+}
+/**
+ * @type InteractionHandler
+ * @description A function signature for a custom interaction handler.
+ * @returns {Promise<boolean | undefined>} A promise that resolves to `false` to stop the default handler, or `true`/`undefined` to continue.
+ */
+type InteractionHandler = (args: InteractionHandlerArgs) => Promise<boolean | undefined>;
+/**
+ * @description Creates a modular command handler function for the Discord client.
+ * @param {ClientWithCommands} client The Discord client instance with a commands collection.
+ * @param {InteractionHandler} customHandler A custom function to handle interactions before the default logic.
+ * @returns {(interaction: BaseInteraction) = Promise<void>} The main interaction handler function.
+ */
+export default function ModularCommandHandler(client: ClientWithCommands, customHandler: InteractionHandler): (interaction: BaseInteraction) => Promise<void>;
+export {};

package/dist/interaction.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * @file Contains the logic for handling Discord bot interactions.
+ * @author vicentefelipechile
+ * @license MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = ModularCommandHandler;
+const discord_js_1 = require("discord.js");
+const locales_1 = require("./locales");
+// =================================================================================================
+// Main Handler Function
+// =================================================================================================
+/**
+ * @description Creates a modular command handler function for the Discord client.
+ * @param {ClientWithCommands} client The Discord client instance with a commands collection.
+ * @param {InteractionHandler} customHandler A custom function to handle interactions before the default logic.
+ * @returns {(interaction: BaseInteraction) = Promise<void>} The main interaction handler function.
+ */
+function ModularCommandHandler(client, customHandler) {
+    if (!client.commands) {
+        throw new Error(`Client is missing the 'commands' collection.`);
+    }
+    if (!(client.commands instanceof discord_js_1.Collection)) {
+        throw new Error(`Client.commands is not an instance of Discord.js Collection.`);
+    }
+    const handler = async (interaction) => {
+        if (!interaction.isChatInputCommand() && !interaction.isMessageComponent() && !interaction.isModalSubmit()) {
+            return;
+        }
+        const response = await customHandler({ interaction });
+        if (response === false)
+            return;
+        let commandName;
+        if (interaction.isChatInputCommand()) {
+            commandName = interaction.commandName;
+        }
+        else if (interaction.customId) {
+            commandName = interaction.customId.split('_')[0];
+        }
+        else {
+            const errorMessage = locales_1.LOCALE_ERROR[interaction.locale];
+            if (interaction.replied || interaction.deferred) {
+                await interaction.followUp({ content: errorMessage, flags: discord_js_1.MessageFlags.Ephemeral });
+            }
+            else {
+                await interaction.reply({ content: errorMessage, flags: discord_js_1.MessageFlags.Ephemeral });
+            }
+            console.error(`Interaction does not have a commandName or customId: ${interaction.id}`);
+            return;
+        }
+        const command = client.commands.get(commandName);
+        if (command === undefined) {
+            console.error(`No command found for interaction: ${interaction.id} with command name: ${commandName}`);
+            return;
+        }
+        try {
+            if (interaction.isChatInputCommand()) {
+                await command.execute(interaction);
+            }
+            else if (interaction.isButton() && command.buttonExecute) {
+                await command.buttonExecute(interaction);
+            }
+            else if (interaction.isMessageComponent() && command.componentExecute) {
+                await command.componentExecute(interaction);
+            }
+            else if (interaction.isModalSubmit() && command.modalExecute) {
+                await command.modalExecute(interaction);
+            }
+        }
+        catch (error) {
+            const errorMessage = locales_1.LOCALE_ERROR[interaction.locale];
+            if (interaction.replied || interaction.deferred) {
+                await interaction.followUp({ content: errorMessage, flags: discord_js_1.MessageFlags.Ephemeral });
+            }
+            else {
+                await interaction.reply({ content: errorMessage, flags: discord_js_1.MessageFlags.Ephemeral });
+            }
+            console.error(`Error handling interaction: ${interaction.id}`, error);
+        }
+    };
+    return handler;
+}

package/dist/loadcommands.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file Contains the logic for loading modular commands into the Discord bot client.
+ * @author vicentefelipechile
+ * @license MIT
+ */
+import { CommandData } from "./types";
+/**
+ * @description Loads one or more commands into an array.
+ * @param {CommandData[]} commandsArray The array where the loaded commands will be stored.
+ * @param {CommandData | CommandData[]} command The command(s) to load. Can be a single `CommandData` object or an array of them.
+ * @throws {TypeError} If a command is missing the `execute` function.
+ * @example
+ * ```typescript
+ * import { Collection } from "discord.js";
+ * import LoadCommand from "./loadcommands";
+ * import exampleCommand from "./commands/example";
+ *
+ * const commandsList: CommandData[] = [];
+ * LoadCommand(commandsList, exampleCommand);
+ *
+ * const client = { commands: new Collection<string, CommandData>() };
+ * for (const cmd of commandsList) {
+ *   client.commands.set(cmd.data.name, cmd);
+ * }
+ * ```
+ */
+export default function LoadCommand(commandsArray: CommandData[], command: CommandData | CommandData[]): void;

package/dist/loadcommands.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * @file Contains the logic for loading modular commands into the Discord bot client.
+ * @author vicentefelipechile
+ * @license MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = LoadCommand;
+// =================================================================================================
+// Main Loading Function
+// =================================================================================================
+/**
+ * @description Loads one or more commands into an array.
+ * @param {CommandData[]} commandsArray The array where the loaded commands will be stored.
+ * @param {CommandData | CommandData[]} command The command(s) to load. Can be a single `CommandData` object or an array of them.
+ * @throws {TypeError} If a command is missing the `execute` function.
+ * @example
+ * ```typescript
+ * import { Collection } from "discord.js";
+ * import LoadCommand from "./loadcommands";
+ * import exampleCommand from "./commands/example";
+ *
+ * const commandsList: CommandData[] = [];
+ * LoadCommand(commandsList, exampleCommand);
+ *
+ * const client = { commands: new Collection<string, CommandData>() };
+ * for (const cmd of commandsList) {
+ *   client.commands.set(cmd.data.name, cmd);
+ * }
+ * ```
+ */
+function LoadCommand(commandsArray, command) {
+    const commands = Array.isArray(command) ? command : [command];
+    for (const cmd of commands) {
+        if (typeof cmd.execute !== "function") {
+            throw new TypeError(`Command "${cmd.data.name}" is missing a required 'execute' function.`);
+        }
+        commandsArray.push(cmd);
+    }
+}

package/dist/locales.d.ts

@@ -1,51 +1,20 @@
 /**
- * @module ModularCommand Locales
- * @description Generic localization phrases used throughout the application.
+ * @file Contains the generic localization phrases used throughout the application.
+ * @author vicentefelipechile
  * @license MIT
  */
 import { Locale } from "discord.js";
+import LOCALE_DELAY, { ModularLocale } from "./modularlocale";
 /**
- * @description Function to handle seconds format
- * @param phrase The phrase to format
- * @param time The time in seconds
- * @returns The formatted string
- * @example ```javascript
- * const phraseLocale = LOCALE_DELAY[Locale.EnglishUS];
- * const phrasePlural = FormatSecondsLocale(phraseLocale, 90);
- * console.log(phrasePlural); // 'You must wait 1 minute 30 seconds before using this command again.'
- *
- * const phraseSingular = FormatSecondsLocale(phraseLocale, 60);
- * console.log(phraseSingular); // 'You must wait 1 minute before using this command again.'
- * ```
- */
-declare function FormatSecondsLocale(phrase: string, time: number): string;
-/**
- * @description Localization phrases for delay commands.
- * @example
- * const example = LOCALE_DELAY[Locale.EnglishUS];
- *
- * console.log(FormatTimeLocale(example, 5)); // 'You must wait 5 seconds before using this command again.'
- * console.log(FormatTimeLocale(example, 63)); // 'You must wait 3 seconds and 1 minute before using this command again.'
- */
-declare const LOCALE_DELAY: Record<Locale, string>;
-/**
- * @description Localization phrases for various commands.
- * @example ```js
- * const example = LOCALE_FORBIDDEN[Locale.EnglishUS];
- * console.log(example); // 'You do not have permission to use this command.'
- * ```
+ * @description Localization phrases for various commands, specifically for permission errors.
  */
 declare const LOCALE_FORBIDDEN: Record<Locale, string>;
 /**
- * @description Localization phrases for NSFW commands.
- * @example ```js
- * const example = LOCALE_NSFW[Locale.EnglishUS];
- * console.log(example); // 'This command can only be used in NSFW channels.'
- * ```
+ * @description Localization phrases for NSFW command usage errors.
  */
 declare const LOCALE_NSFW: Record<Locale, string>;
 /**
-* Error messages for different locales.
-*/
+ * @description Localization phrases for general application errors.
+ */
 declare const LOCALE_ERROR: Record<Locale, string>;
-export { FormatSecondsLocale, LOCALE_DELAY, LOCALE_ERROR, LOCALE_FORBIDDEN, LOCALE_NSFW };
+export { LOCALE_DELAY, LOCALE_ERROR, LOCALE_FORBIDDEN, LOCALE_NSFW, ModularLocale };

package/dist/locales.js

@@ -1,137 +1,53 @@
 "use strict";
 /**
- * @module ModularCommand Locales
- * @description Generic localization phrases used throughout the application.
+ * @file Contains the generic localization phrases used throughout the application.
+ * @author vicentefelipechile
  * @license MIT
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOCALE_NSFW = exports.LOCALE_FORBIDDEN = exports.LOCALE_ERROR = exports.LOCALE_DELAY = void 0;
-exports.FormatSecondsLocale = FormatSecondsLocale;
+exports.ModularLocale = exports.LOCALE_NSFW = exports.LOCALE_FORBIDDEN = exports.LOCALE_ERROR = exports.LOCALE_DELAY = void 0;
 const discord_js_1 = require("discord.js");
+const modularlocale_1 = __importStar(require("./modularlocale"));
+exports.LOCALE_DELAY = modularlocale_1.default;
+Object.defineProperty(exports, "ModularLocale", { enumerable: true, get: function () { return modularlocale_1.ModularLocale; } });
+// =================================================================================================
+// Localization Phrases
+// =================================================================================================
 /**
- * Regular expressions for time formatting
- * Used to match and replace time-related placeholders in localization strings.
- */
-/**
- * @name SECONDS
- * @description Matches the `{seconds}` placeholder in localization strings to replace it with the amount of seconds of delay.
- */
-const SECONDS = new RegExp('\\{seconds(?:\\|([^}]+))?\\}', 'g');
-/**
- * @name SECONDS_PLURAL
- * @description Matches the `{seconds|plural|...}` placeholder in localization strings, unlike SECONDS RegEx, this one handles pluralization.
- */
-const SECONDS_PLURAL = new RegExp('\\{seconds\\|plural\\|([^}]+)\\}', 'g');
-/**
- * @name MINUTES
- * @description The same as `SECONDS`, but for minutes.
- */
-const MINUTES = new RegExp('\\{minutes(?:\\|([^}]+))?\\}', 'g');
-/**
- * @name MINUTES_PLURAL
- * @description Do we really need an explanation for this RegEx?
- */
-const MINUTES_PLURAL = new RegExp('\\{minutes\\|plural\\|([^}]+)\\}', 'g');
-/**
- * @description Function to handle seconds format
- * @param phrase The phrase to format
- * @param time The time in seconds
- * @returns The formatted string
- * @example ```javascript
- * const phraseLocale = LOCALE_DELAY[Locale.EnglishUS];
- * const phrasePlural = FormatSecondsLocale(phraseLocale, 90);
- * console.log(phrasePlural); // 'You must wait 1 minute 30 seconds before using this command again.'
- *
- * const phraseSingular = FormatSecondsLocale(phraseLocale, 60);
- * console.log(phraseSingular); // 'You must wait 1 minute before using this command again.'
- * ```
- */
-function FormatSecondsLocale(phrase, time) {
-    const minutes = Math.floor(time / 60);
-    const seconds = time % 60;
-    let formattedPhrase = phrase;
-    if (minutes > 0) {
-        // Replace plural forms for minutes first
-        formattedPhrase = formattedPhrase.replace(MINUTES_PLURAL, (match, p1) => {
-            return minutes === 1 ? '' : p1;
-        });
-        // Replace minute values
-        formattedPhrase = formattedPhrase.replace(MINUTES, (match, p1) => {
-            if (p1) {
-                // Handles patterns like {minutes|y $ minuto}
-                return p1.replace('$', minutes.toString());
-            }
-            return minutes.toString();
-        });
-    }
-    else {
-        // If no minutes, remove all minute-related placeholders
-        formattedPhrase = formattedPhrase.replace(MINUTES, '').replace(MINUTES_PLURAL, '');
-    }
-    if (seconds > 0 || minutes === 0) {
-        // Replace plural forms for seconds
-        formattedPhrase = formattedPhrase.replace(SECONDS_PLURAL, (match, p1) => {
-            return seconds === 1 ? '' : p1;
-        });
-        // Replace second values
-        formattedPhrase = formattedPhrase.replace(SECONDS, seconds.toString());
-    }
-    else {
-        // If there are minutes but no seconds, remove second-related placeholders
-        formattedPhrase = formattedPhrase.replace(SECONDS, '').replace(SECONDS_PLURAL, '');
-    }
-    // Clean up any remaining empty placeholders and extra spaces
-    return formattedPhrase.replace(/\{[^}]+\}/g, '').replace(/\s+/g, ' ').trim();
-}
-/**
- * @description Localization phrases for delay commands.
- * @example
- * const example = LOCALE_DELAY[Locale.EnglishUS];
- *
- * console.log(FormatTimeLocale(example, 5)); // 'You must wait 5 seconds before using this command again.'
- * console.log(FormatTimeLocale(example, 63)); // 'You must wait 3 seconds and 1 minute before using this command again.'
- */
-const LOCALE_DELAY = {
-    [discord_js_1.Locale.SpanishLATAM]: 'Debes esperar {seconds} segundo{seconds|plural|s} {minutes|y $ minuto}{minutes|plural|s} antes de utilizar este comando denuevo.',
-    [discord_js_1.Locale.EnglishUS]: 'You must wait {seconds} second{seconds|plural|s} {minutes|and $ minute}{minutes|plural|s} before using this command again.',
-    [discord_js_1.Locale.EnglishGB]: 'Good heavens! One must exhibit a spot of patience, you see. A brief pause of {seconds} second{seconds|plural|s} {minutes|and $ minute}{minutes|plural|s} is required before another attempt, what?',
-    [discord_js_1.Locale.SpanishES]: '¡Joder, tío! ¡Que te esperes {seconds} segundo{seconds|plural|s} {minutes|y $ minuto}{minutes|plural|s}, coño! ¡No flipes y dale un respiro al bot, hostia ya!',
-    [discord_js_1.Locale.PortugueseBR]: 'Você deve esperar {seconds} segundo{seconds|plural|s} {minutes|e $ minuto}{minutes|plural|s} antes de usar este comando novamente.',
-    [discord_js_1.Locale.French]: 'Vous devez attendre {seconds} seconde{seconds|plural|s} {minutes|et $ minute}{minutes|plural|s} avant d\'utiliser cette commande à nouveau.',
-    [discord_js_1.Locale.German]: 'Sie müssen {seconds} Sekunde{seconds|plural|n} {minutes|und $ Minute}{minutes|plural|n} warten, bevor Sie diesen Befehl erneut verwenden können.',
-    [discord_js_1.Locale.Italian]: 'Devi aspettare {seconds} secondo{seconds|plural|i} {minutes|e $ minuto}{minutes|plural|i} prima di utilizzare di nuovo questo comando.',
-    [discord_js_1.Locale.Russian]: 'Вы должны подождать {seconds} секунд{seconds|plural|у} {minutes|и $ минут}{minutes|plural|ы} перед повторным использованием этой команды.',
-    [discord_js_1.Locale.ChineseCN]: '您必须等待 {seconds} 秒 {minutes|和 $ 分钟} 才能再次使用此命令。',
-    [discord_js_1.Locale.ChineseTW]: '您必須等待 {seconds} 秒 {minutes|和 $ 分鐘} 才能再次使用此命令。',
-    [discord_js_1.Locale.Japanese]: 'このコマンドを再度使用するには、{seconds} 秒 {minutes|と $ 分} 待つ必要があります。',
-    [discord_js_1.Locale.Korean]: '이 명령어를 다시 사용하려면 {seconds} 초 {minutes|하고 $ 분} 기다려야 합니다.',
-    [discord_js_1.Locale.Bulgarian]: 'Трябва да изчакате {seconds} секунд{seconds|plural|и} {minutes|и $ минут}{minutes|plural|и}, преди да използвате тази команда отново.',
-    [discord_js_1.Locale.Czech]: 'Musíte počkat {seconds} sekund{seconds|plural|u} {minutes|a $ minut}{minutes|plural|y}, než znovu použijete tento příkaz.',
-    [discord_js_1.Locale.Danish]: 'Du skal vente {seconds} sekund{seconds|plural|er} {minutes|og $ minut}{minutes|plural|ter} før du kan bruge denne kommando igen.',
-    [discord_js_1.Locale.Dutch]: 'Je moet {seconds} seconde{seconds|plural|n} {minutes|en $ minuut}{minutes|plural|en} wachten voordat je dit commando opnieuw kunt gebruiken.',
-    [discord_js_1.Locale.Finnish]: 'Sinun on odotettava {seconds} sekunti{seconds|plural|a} {minutes|ja $ minuutti}{minutes|plural|a} ennen kuin voit käyttää tätä komentoa uudelleen.',
-    [discord_js_1.Locale.Hungarian]: 'Várnod kell {seconds} másodperc{seconds|plural|et} {minutes|és $ perc}{minutes|plural|et}, mielőtt újra használhatod ezt a parancsot.',
-    [discord_js_1.Locale.Norwegian]: 'Du må vente {seconds} sekund{seconds|plural|er} {minutes|og $ minutt}{minutes|plural|er} før du kan bruke denne kommandoen igjen.',
-    [discord_js_1.Locale.Polish]: 'Musisz poczekać {seconds} sekund{seconds|plural|y} {minutes|i $ minut}{minutes|plural|y}, zanim ponownie użyjesz tego polecenia.',
-    [discord_js_1.Locale.Romanian]: 'Trebuie să aștepți {seconds} secund{seconds|plural|ă} {minutes|și $ minut}{minutes|plural|e} înainte de a folosi din nou acest comandă.',
-    [discord_js_1.Locale.Swedish]: 'Du måste vänta {seconds} sekund{seconds|plural|er} {minutes|och $ minut}{minutes|plural|er} innan du kan använda det här kommandot igen.',
-    [discord_js_1.Locale.Turkish]: 'Bu komutu tekrar kullanmadan önce {seconds} saniye {minutes|ve $ dakika} beklemelisiniz.',
-    [discord_js_1.Locale.Ukrainian]: 'Вам потрібно почекати {seconds} секунд{seconds|plural|и} {minutes|і $ хвилин}{minutes|plural|и}, перш ніж знову використовувати цю команду.',
-    [discord_js_1.Locale.Hindi]: 'आपको इस कमांड का उपयोग करने से पहले {seconds} सेकंड {minutes|और $ मिनट} इंतजार करना होगा।',
-    [discord_js_1.Locale.Indonesian]: 'Anda harus menunggu {seconds} detik {minutes|dan $ menit} sebelum menggunakan perintah ini lagi.',
-    [discord_js_1.Locale.Greek]: 'Πρέπει να περιμένετε {seconds} δευτερόλεπτ{seconds|plural|ο} {minutes|και $ λεπτό}{minutes|plural|ά} πριν χρησιμοποιήσετε ξανά αυτήν την εντολή.',
-    [discord_js_1.Locale.Croatian]: 'Morate pričekati {seconds} sekund{seconds|plural|u} {minutes|i $ minut}{minutes|plural|e} prije nego što ponovno upotrijebite ovu naredbu.',
-    [discord_js_1.Locale.Lithuanian]: 'Prieš vėl naudodamiesi šiuo komandu, turite palaukti {seconds} sekund{seconds|plural|ę} {minutes|ir $ minut}{minutes|plural|es}.',
-    [discord_js_1.Locale.Thai]: 'คุณต้องรอ {seconds} วินาที {minutes|และ $ นาที} ก่อนที่จะใช้คำสั่งนี้อีกครั้ง',
-    [discord_js_1.Locale.Vietnamese]: 'Bạn phải đợi {seconds} giây {minutes|và $ phút} trước khi sử dụng lại lệnh này.'
-};
-exports.LOCALE_DELAY = LOCALE_DELAY;
-/**
- * @description Localization phrases for various commands.
- * @example ```js
- * const example = LOCALE_FORBIDDEN[Locale.EnglishUS];
- * console.log(example); // 'You do not have permission to use this command.'
- * ```
+ * @description Localization phrases for various commands, specifically for permission errors.
  */
 const LOCALE_FORBIDDEN = {
     [discord_js_1.Locale.SpanishLATAM]: 'No tienes permiso para usar este comando.',
@@ -153,7 +69,7 @@ const LOCALE_FORBIDDEN = {
     [discord_js_1.Locale.Dutch]: 'Je hebt geen toestemming om deze opdracht te gebruiken.',
     [discord_js_1.Locale.Finnish]: 'Sinulla ei ole lupaa käyttää tätä komentoa.',
     [discord_js_1.Locale.Hungarian]: 'Nincs jogosultságod ehhez a parancshoz.',
-    [discord_js_1.Locale.Norwegian]: 'Du har ikke tillatelse til å bruke denne kommandoen.',
+    [discord_js_1.Locale.Norwegian]: 'Du har ikke behörighet til å bruke denne kommandoen.',
     [discord_js_1.Locale.Polish]: 'Nie masz uprawnień do używania tej komendy.',
     [discord_js_1.Locale.Romanian]: 'Nu ai permisiunea de a folosi acest comandă.',
     [discord_js_1.Locale.Swedish]: 'Du har inte behörighet att använda det här kommandot.',
@@ -169,11 +85,7 @@ const LOCALE_FORBIDDEN = {
 };
 exports.LOCALE_FORBIDDEN = LOCALE_FORBIDDEN;
 /**
- * @description Localization phrases for NSFW commands.
- * @example ```js
- * const example = LOCALE_NSFW[Locale.EnglishUS];
- * console.log(example); // 'This command can only be used in NSFW channels.'
- * ```
+ * @description Localization phrases for NSFW command usage errors.
  */
 const LOCALE_NSFW = {
     [discord_js_1.Locale.SpanishLATAM]: 'Este comando solo puede ser usado en canales NSFW.',
@@ -211,8 +123,8 @@ const LOCALE_NSFW = {
 };
 exports.LOCALE_NSFW = LOCALE_NSFW;
 /**
-* Error messages for different locales.
-*/
+ * @description Localization phrases for general application errors.
+ */
 const LOCALE_ERROR = {
     [discord_js_1.Locale.SpanishLATAM]: 'Ocurrió un error al procesar tu solicitud.',
     [discord_js_1.Locale.EnglishUS]: 'An error occurred while processing your request.',