tiny-essentials 1.24.0 → 1.24.2

package/dist/legacy/libs/custom_module_loader.mjs

@@ -1,87 +0,0 @@
-import objType from '../get/objType.mjs';
-/**
- * A custom module manager to validate and run hooks on external modules dynamically.
- * Especially useful for plugin-like systems or hooks in systems like payment handlers.
- * @namespace custom_module_manager
- */
-const custom_module_manager = {
-    /**
-     * Validates if the given object has valid custom or default module arrays.
-     * @param {Record<string, any>} custom_modules - The object containing module definitions.
-     * @param {string} type - The specific type of module to validate.
-     * @returns {boolean} Whether the module is valid.
-     * @deprecated
-     *
-     * @example
-     * custom_module_manager.validator(myModules, 'paypal'); // true or false
-     */
-    validator: function (custom_modules, type) {
-        if (custom_modules &&
-            custom_modules[type] &&
-            (Array.isArray(custom_modules[type].custom) || Array.isArray(custom_modules[type].default)))
-            return true;
-        else
-            return false;
-    },
-    /**
-     * Executes all functions inside the given modules.
-     * Accepts either an array of functions or an object with typed module arrays.
-     *
-     * @param {Record<string, function>|function[]} custom_modules - The modules or functions to run.
-     * @param {*} db_prepare - A value to pass to each module when called.
-     * @param {string} hookType - A string representing the hook (e.g., 'before', 'after').
-     * @param {Record<string, any>} [options] - Optional. Object with keys matching types in `custom_modules`.
-     *
-     * @returns {Promise<void>}
-     * @deprecated
-     *
-     * @example
-     * await custom_module_manager.run(customModules, db, 'after', { paypal: true });
-     */
-    run: async function (custom_modules, db_prepare, hookType, options) {
-        /**
-         * @async
-         * @param {string} [type]
-         */
-        const run_custom_module = async function (type) {
-            let module_list = null;
-            if (typeof type === 'string') {
-                // @ts-ignore
-                if (custom_modules && typeof custom_modules[type] === 'function')
-                    // @ts-ignore
-                    module_list = custom_modules[type];
-            }
-            else
-                module_list = custom_modules;
-            if (Array.isArray(module_list)) {
-                for (const item in module_list) {
-                    if (typeof module_list[item] === 'function') {
-                        try {
-                            await module_list[item](db_prepare, hookType);
-                        }
-                        catch (err) {
-                            console.error(err);
-                        }
-                    }
-                    else {
-                        const err = new Error(`The Custom Paypal Module value needs to be a Function!\nArray: ${type}\nIndex: ${item}`);
-                        console.error(err);
-                        console.error(err.message);
-                    }
-                }
-            }
-        };
-        if (objType(options, 'object')) {
-            for (const item in options) {
-                // @ts-ignore
-                if (options[item] && Array.isArray(custom_modules[item]))
-                    await run_custom_module(item);
-            }
-        }
-        else {
-            if (Array.isArray(custom_modules))
-                await run_custom_module();
-        }
-    },
-};
-export default custom_module_manager;

package/dist/legacy/libs/dice.cjs

@@ -1,37 +0,0 @@
-'use strict';
-
-/**
- * A simple random number generator (dice roller) utility.
- * Supports a vanilla dice roll from 1 to N.
- * @namespace tinyDice
- */
-const tinyDice = {
-  /**
-   * Generates a random integer between 1 and `obj`, inclusive.
-   * @param {number} obj - The maximum value of the dice.
-   * @returns {number} The result of the dice roll.
-   * @deprecated
-   *
-   * @example
-   * const result = tinyDice.vanilla(6); // 1 to 6
-   */
-  vanilla: function (obj) {
-    return Number(Math.floor(Math.random() * (obj - 1 + 1) + 1));
-  },
-
-  /**
-   * Returns the stringified version of the `vanilla()` method.
-   * Useful for injecting the dice logic in client environments.
-   * @param {number} obj - Unused in the function body.
-   * @returns {string} The function source code of `vanilla`.
-   * @deprecated
-   *
-   * @example
-   * const clientScript = tinyDice.getClientVanilla();
-   */
-  getClientVanilla: function (obj) {
-    return tinyDice.vanilla.toString();
-  },
-};
-
-module.exports = tinyDice;

package/dist/legacy/libs/dice.d.mts

@@ -1,6 +0,0 @@
-export default tinyDice;
-declare namespace tinyDice {
-    function vanilla(obj: number): number;
-    function getClientVanilla(obj: number): string;
-}
-//# sourceMappingURL=dice.d.mts.map

package/dist/legacy/libs/dice.mjs

@@ -1,33 +0,0 @@
-/**
- * A simple random number generator (dice roller) utility.
- * Supports a vanilla dice roll from 1 to N.
- * @namespace tinyDice
- */
-const tinyDice = {
-    /**
-     * Generates a random integer between 1 and `obj`, inclusive.
-     * @param {number} obj - The maximum value of the dice.
-     * @returns {number} The result of the dice roll.
-     * @deprecated
-     *
-     * @example
-     * const result = tinyDice.vanilla(6); // 1 to 6
-     */
-    vanilla: function (obj) {
-        return Number(Math.floor(Math.random() * (obj - 1 + 1) + 1));
-    },
-    /**
-     * Returns the stringified version of the `vanilla()` method.
-     * Useful for injecting the dice logic in client environments.
-     * @param {number} obj - Unused in the function body.
-     * @returns {string} The function source code of `vanilla`.
-     * @deprecated
-     *
-     * @example
-     * const clientScript = tinyDice.getClientVanilla();
-     */
-    getClientVanilla: function (obj) {
-        return tinyDice.vanilla.toString();
-    },
-};
-export default tinyDice;

package/dist/legacy/libs/markdown.cjs

@@ -1,97 +0,0 @@
-'use strict';
-
-/**
- * A lightweight Markdown parser that can convert to HTML or BBCode.
- * @namespace markdownManager
- */
-const markdownManager = {
-  /**
-   * A dictionary of Markdown element conversion rules.
-   *
-   * Each key represents a Markdown syntax identifier (like `h1`, `strong`, `image`, etc.),
-   * and its value contains the regular expression used to match the Markdown element,
-   * along with its HTML and BBCode equivalents.
-   *
-   * @type {{
-   *   [key: string]: {
-   *     regex: RegExp,              // The regex pattern used to identify the Markdown syntax.
-   *     result: string,             // The HTML output replacement string, using capture groups.
-   *     bbcode: string              // The BBCode equivalent of the Markdown syntax.
-   *   }
-   * }}
-   */
-  values: {
-    h3: {
-      regex: /^### (.*$)/gim,
-      result: '<h3>$1</h3>',
-      bbcode: '[h3]$1[/h3]',
-    },
-    h2: {
-      regex: /^## (.*$)/gim,
-      result: '<h2>$1</h2>',
-      bbcode: '[h2]$1[/h2]',
-    },
-    h1: {
-      regex: /^# (.*$)/gim,
-      result: '<h1>$1</h1>',
-      bbcode: '[h1]$1[/h1]',
-    },
-    blockquote: {
-      regex: /^\> (.*$)/gim,
-      result: '<blockquote>$1</blockquote>',
-      bbcode: '[blockquote]$1[/blockquote]',
-    },
-    strong: {
-      regex: /\*\*(.*)\*\*/gim,
-      result: '<strong>$1</strong>',
-      bbcode: '[b]$1[/b]',
-    },
-    italic: {
-      regex: /\*(.*)\*/gim,
-      result: '<i>$1</i>',
-      bbcode: '[i]$1[/i]',
-    },
-    image: {
-      regex: /!\[(.*?)\]\((.*?)\)/gim,
-      result: "<img alt='$1' src='$2' />",
-      bbcode: '[img="$2"]',
-    },
-    url: {
-      regex: /\[(.*?)\]\((.*?)\)/gim,
-      result: "<a href='$2'>$1</a>",
-      bbcode: '[href="$2"]$1[/i]',
-    },
-    br: {
-      regex: /\n$/gim,
-      result: '<br />',
-      bbcode: '\n',
-    },
-  },
-
-  /**
-   * Parses Markdown content into HTML or BBCode.
-   * @param {string} markdownText - The input Markdown string.
-   * @param {'result' | 'bbcode'} [type='result'] - The desired output type.
-   * @returns {string} The converted string.
-   * @deprecated
-   *
-   * @example
-   * markdownManager.parseMarkdown("**bold**"); // <strong>bold</strong>
-   * markdownManager.parseMarkdown("**bold**", "bbcode"); // [b]bold[/b]
-   */
-  parseMarkdown: function (markdownText, type = 'result') {
-    let htmlText = markdownText;
-
-    for (const item in markdownManager.values) {
-      const rule = markdownManager.values[item];
-      const replacer = rule[type];
-
-      if (typeof replacer === 'string' || typeof replacer === 'function')
-        htmlText = htmlText.replace(rule.regex, replacer);
-    }
-
-    return htmlText.trim();
-  },
-};
-
-module.exports = markdownManager;

package/dist/legacy/libs/markdown.d.mts

@@ -1,12 +0,0 @@
-export default markdownManager;
-declare namespace markdownManager {
-    let values: {
-        [key: string]: {
-            regex: RegExp;
-            result: string;
-            bbcode: string;
-        };
-    };
-    function parseMarkdown(markdownText: string, type?: "result" | "bbcode"): string;
-}
-//# sourceMappingURL=markdown.d.mts.map

package/dist/legacy/libs/markdown.mjs

@@ -1,90 +0,0 @@
-/**
- * A lightweight Markdown parser that can convert to HTML or BBCode.
- * @namespace markdownManager
- */
-const markdownManager = {
-    /**
-     * A dictionary of Markdown element conversion rules.
-     *
-     * Each key represents a Markdown syntax identifier (like `h1`, `strong`, `image`, etc.),
-     * and its value contains the regular expression used to match the Markdown element,
-     * along with its HTML and BBCode equivalents.
-     *
-     * @type {{
-     *   [key: string]: {
-     *     regex: RegExp,              // The regex pattern used to identify the Markdown syntax.
-     *     result: string,             // The HTML output replacement string, using capture groups.
-     *     bbcode: string              // The BBCode equivalent of the Markdown syntax.
-     *   }
-     * }}
-     */
-    values: {
-        h3: {
-            regex: /^### (.*$)/gim,
-            result: '<h3>$1</h3>',
-            bbcode: '[h3]$1[/h3]',
-        },
-        h2: {
-            regex: /^## (.*$)/gim,
-            result: '<h2>$1</h2>',
-            bbcode: '[h2]$1[/h2]',
-        },
-        h1: {
-            regex: /^# (.*$)/gim,
-            result: '<h1>$1</h1>',
-            bbcode: '[h1]$1[/h1]',
-        },
-        blockquote: {
-            regex: /^\> (.*$)/gim,
-            result: '<blockquote>$1</blockquote>',
-            bbcode: '[blockquote]$1[/blockquote]',
-        },
-        strong: {
-            regex: /\*\*(.*)\*\*/gim,
-            result: '<strong>$1</strong>',
-            bbcode: '[b]$1[/b]',
-        },
-        italic: {
-            regex: /\*(.*)\*/gim,
-            result: '<i>$1</i>',
-            bbcode: '[i]$1[/i]',
-        },
-        image: {
-            regex: /!\[(.*?)\]\((.*?)\)/gim,
-            result: "<img alt='$1' src='$2' />",
-            bbcode: '[img="$2"]',
-        },
-        url: {
-            regex: /\[(.*?)\]\((.*?)\)/gim,
-            result: "<a href='$2'>$1</a>",
-            bbcode: '[href="$2"]$1[/i]',
-        },
-        br: {
-            regex: /\n$/gim,
-            result: '<br />',
-            bbcode: '\n',
-        },
-    },
-    /**
-     * Parses Markdown content into HTML or BBCode.
-     * @param {string} markdownText - The input Markdown string.
-     * @param {'result' | 'bbcode'} [type='result'] - The desired output type.
-     * @returns {string} The converted string.
-     * @deprecated
-     *
-     * @example
-     * markdownManager.parseMarkdown("**bold**"); // <strong>bold</strong>
-     * markdownManager.parseMarkdown("**bold**", "bbcode"); // [b]bold[/b]
-     */
-    parseMarkdown: function (markdownText, type = 'result') {
-        let htmlText = markdownText;
-        for (const item in markdownManager.values) {
-            const rule = markdownManager.values[item];
-            const replacer = rule[type];
-            if (typeof replacer === 'string' || typeof replacer === 'function')
-                htmlText = htmlText.replace(rule.regex, replacer);
-        }
-        return htmlText.trim();
-    },
-};
-export default markdownManager;

package/dist/legacy/libs/percentage.cjs

@@ -1,23 +0,0 @@
-'use strict';
-
-/**
- * Simple utility to calculate percentage values.
- * @namespace percentageBase
- */
-const percentageBase = {
-  /**
-   * Calculates a percentage of a given base value.
-   * @param {number} preco - The base value.
-   * @param {number} porcentagem - The percentage to apply.
-   * @returns {number} The result of the percentage calculation.
-   * @deprecated
-   *
-   * @example
-   * percentageBase.run(200, 15); // 30
-   */
-  run: function (preco, porcentagem) {
-    return preco * (porcentagem / 100);
-  },
-};
-
-module.exports = percentageBase;

package/dist/legacy/libs/percentage.d.mts

@@ -1,5 +0,0 @@
-export default percentageBase;
-declare namespace percentageBase {
-    function run(preco: number, porcentagem: number): number;
-}
-//# sourceMappingURL=percentage.d.mts.map

package/dist/legacy/libs/percentage.mjs

@@ -1,20 +0,0 @@
-/**
- * Simple utility to calculate percentage values.
- * @namespace percentageBase
- */
-const percentageBase = {
-    /**
-     * Calculates a percentage of a given base value.
-     * @param {number} preco - The base value.
-     * @param {number} porcentagem - The percentage to apply.
-     * @returns {number} The result of the percentage calculation.
-     * @deprecated
-     *
-     * @example
-     * percentageBase.run(200, 15); // 30
-     */
-    run: function (preco, porcentagem) {
-        return preco * (porcentagem / 100);
-    },
-};
-export default percentageBase;

package/dist/legacy/libs/regex/getLetter.cjs

@@ -1,24 +0,0 @@
-'use strict';
-
-/**
- * Matches exactly one letter (lowercase or uppercase).
- * @param {string} [type='g'] - The flag for the regular expression (default is 'g').
- * @returns {RegExp} The regular expression to match exactly one letter.
- * @deprecated
- */
-function oneLetter(type = 'g') {
-  return new RegExp('^[a-zA-Z]+$', type); // Matches exactly one letter
-}
-
-/**
- * Matches one or more letters (lowercase or uppercase).
- * @param {string} [type='g'] - The flag for the regular expression (default is 'g').
- * @returns {RegExp} The regular expression to match one or more letters.
- * @deprecated
- */
-function multiLetters(type = 'g') {
-  return new RegExp('[a-zA-Z]+', type); // Matches one or more letters
-}
-
-exports.multiLetters = multiLetters;
-exports.oneLetter = oneLetter;

package/dist/legacy/libs/regex/getLetter.d.mts

@@ -1,15 +0,0 @@
-/**
- * Matches exactly one letter (lowercase or uppercase).
- * @param {string} [type='g'] - The flag for the regular expression (default is 'g').
- * @returns {RegExp} The regular expression to match exactly one letter.
- * @deprecated
- */
-export function oneLetter(type?: string): RegExp;
-/**
- * Matches one or more letters (lowercase or uppercase).
- * @param {string} [type='g'] - The flag for the regular expression (default is 'g').
- * @returns {RegExp} The regular expression to match one or more letters.
- * @deprecated
- */
-export function multiLetters(type?: string): RegExp;
-//# sourceMappingURL=getLetter.d.mts.map

package/dist/legacy/libs/regex/getLetter.mjs

@@ -1,21 +0,0 @@
-/**
- * Matches exactly one letter (lowercase or uppercase).
- * @param {string} [type='g'] - The flag for the regular expression (default is 'g').
- * @returns {RegExp} The regular expression to match exactly one letter.
- * @deprecated
- */
-function oneLetter(type = 'g') {
-    return new RegExp('^[a-zA-Z]+$', type); // Matches exactly one letter
-}
-/**
- * Matches one or more letters (lowercase or uppercase).
- * @param {string} [type='g'] - The flag for the regular expression (default is 'g').
- * @returns {RegExp} The regular expression to match one or more letters.
- * @deprecated
- */
-function multiLetters(type = 'g') {
-    return new RegExp('[a-zA-Z]+', type); // Matches one or more letters
-}
-export { oneLetter, // Matches exactly one letter
-multiLetters, // Matches one or more letters
- };

package/dist/legacy/libs/replaceAsync.cjs

@@ -1,35 +0,0 @@
-'use strict';
-
-/**
- * Asynchronously replaces matches in a string using a regex and an async function.
- *
- * @param {string} str - The input string to perform replacements on.
- * @param {RegExp} regex - The regular expression to match substrings for replacement.
- * @param {Function} asyncFn - An asynchronous function that returns a replacement for each match.
- *                             It receives the same arguments as a standard `replace` callback.
- * @returns {Promise<string>} The resulting string with all async replacements applied.
- *
- * @example
- * await asyncReplace("Hello @user1 and @user2!", /@\w+/g, async (mention) => {
- *   return await getUserNameFromMention(mention);
- * });
- */
-async function asyncReplace(str, regex, asyncFn) {
-  /**
-   * @type {any[]}
-   */
-  const promises = [];
-
-  // Collect promises
-  str.replace(regex, (match, ...args) => {
-    promises.push(asyncFn(match, ...args));
-    return match;
-  });
-
-  const data = await Promise.all(promises);
-
-  // Replace using the resolved data
-  return str.replace(regex, () => data.shift());
-}
-
-module.exports = asyncReplace;

package/dist/legacy/libs/replaceAsync.d.mts

@@ -1,16 +0,0 @@
-/**
- * Asynchronously replaces matches in a string using a regex and an async function.
- *
- * @param {string} str - The input string to perform replacements on.
- * @param {RegExp} regex - The regular expression to match substrings for replacement.
- * @param {Function} asyncFn - An asynchronous function that returns a replacement for each match.
- *                             It receives the same arguments as a standard `replace` callback.
- * @returns {Promise<string>} The resulting string with all async replacements applied.
- *
- * @example
- * await asyncReplace("Hello @user1 and @user2!", /@\w+/g, async (mention) => {
- *   return await getUserNameFromMention(mention);
- * });
- */
-export default function asyncReplace(str: string, regex: RegExp, asyncFn: Function): Promise<string>;
-//# sourceMappingURL=replaceAsync.d.mts.map

package/dist/legacy/libs/replaceAsync.mjs

@@ -1,28 +0,0 @@
-/**
- * Asynchronously replaces matches in a string using a regex and an async function.
- *
- * @param {string} str - The input string to perform replacements on.
- * @param {RegExp} regex - The regular expression to match substrings for replacement.
- * @param {Function} asyncFn - An asynchronous function that returns a replacement for each match.
- *                             It receives the same arguments as a standard `replace` callback.
- * @returns {Promise<string>} The resulting string with all async replacements applied.
- *
- * @example
- * await asyncReplace("Hello @user1 and @user2!", /@\w+/g, async (mention) => {
- *   return await getUserNameFromMention(mention);
- * });
- */
-export default async function asyncReplace(str, regex, asyncFn) {
-    /**
-     * @type {any[]}
-     */
-    const promises = [];
-    // Collect promises
-    str.replace(regex, (match, ...args) => {
-        promises.push(asyncFn(match, ...args));
-        return match;
-    });
-    const data = await Promise.all(promises);
-    // Replace using the resolved data
-    return str.replace(regex, () => data.shift());
-}

package/dist/legacy/libs/rule3.cjs

@@ -1,59 +0,0 @@
-'use strict';
-
-/**
- * Rule of Three utility.
- * Performs direct or inverse proportional calculation.
- */
-const ruleOfThree = {
-  /**
-   * Returns the client-side version of the `execute` function as a string.
-   * Useful for embedding logic in the frontend.
-   *
-   * @returns {string} Function as string.
-   */
-  getClient: function () {
-    return ruleOfThree.execute.toString();
-  },
-
-  /**
-   * Executes a Rule of Three calculation.
-   *
-   * @param {number} val1 - The first reference value (numerator in direct proportion, denominator in inverse).
-   * @param {number} val2 - The second reference value (denominator in direct proportion, numerator in inverse).
-   * @param {number} val3 - The third value (numerator in direct proportion, denominator in inverse).
-   * @param {boolean} inverse - Whether the calculation should use inverse proportion (true for inverse, false for direct).
-   * @returns {number} The result of the Rule of Three operation.
-   * @deprecated
-   *
-   * Rule of Three Formula (Direct Proportion):
-   *      val1 / val2 = val3 / result
-   *
-   * For Inverse Proportion:
-   *      val1 / val3 = val2 / result
-   *
-   * Visual Representation:
-   *
-   * For Direct Proportion:
-   *      val1      val2
-   *      -----  =  ------
-   *      val3      result
-   *
-   * For Inverse Proportion:
-   *      val1      val2
-   *      -----  =  ------
-   *      val3      result
-   *
-   * @example
-   * // Direct proportion:
-   * ruleOfThree.execute(2, 6, 3, false); // → 9
-   *
-   * @example
-   * // Inverse proportion:
-   * ruleOfThree.execute(2, 6, 3, true); // → 4
-   */
-  execute: function (val1, val2, val3, inverse) {
-    return inverse ? Number(val1 * val2) / val3 : Number(val3 * val2) / val1;
-  },
-};
-
-module.exports = ruleOfThree;

package/dist/legacy/libs/rule3.d.mts

@@ -1,6 +0,0 @@
-export default ruleOfThree;
-declare namespace ruleOfThree {
-    function getClient(): string;
-    function execute(val1: number, val2: number, val3: number, inverse: boolean): number;
-}
-//# sourceMappingURL=rule3.d.mts.map