tiny-essentials 1.9.0 → 1.9.1

package/dist/TinyLevelUp.js

@@ -30,6 +30,15 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 ;// ./src/legacy/libs/userLevel.mjs
+/**
+ * Represents a user object used.
+ *
+ * @typedef {Object} UserEditor
+ * @property {number} exp - Current experience points of the user.
+ * @property {number} level - Current level of the user.
+ * @property {number} totalExp - Total accumulated experience.
+ */
+
 /**
  * Class to manage user level-up logic based on experience points.
  */
@@ -40,26 +49,95 @@ class TinyLevelUp {
    * @param {number} expLevel - Base experience needed to level up (per level).
    */
   constructor(giveExp, expLevel) {
+    if (typeof giveExp !== 'number' || Number.isNaN(giveExp))
+      throw new Error('giveExp must be a valid number');
+    if (typeof expLevel !== 'number' || Number.isNaN(expLevel))
+      throw new Error('expLevel must be a valid number');
     this.giveExp = giveExp;
     this.expLevel = expLevel;
   }
 
   /**
-   * @typedef {{ exp: number, level: number, totalExp: number }} UserResult
+   * Creates a new user object starting at level 0 with 0 experience.
+   * @returns {UserEditor} A fresh user object.
+   */
+  createUser() {
+    return {
+      exp: 0,
+      level: 1,
+      totalExp: 0,
+    };
+  }
+
+  /**
+   * Validates if the given user object has valid numeric properties.
+   * Throws an error if any property is invalid.
+   *
+   * @param {UserEditor} user - The user object to validate.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
+   */
+  validateUser(user) {
+    if (typeof user.exp !== 'number' || Number.isNaN(user.exp))
+      throw new Error('exp must be a valid number');
+    if (typeof user.level !== 'number' || Number.isNaN(user.level))
+      throw new Error('level must be a valid number');
+    if (user.level < 1) throw new Error('level must be at least 1');
+    if (typeof user.totalExp !== 'number' || Number.isNaN(user.totalExp))
+      throw new Error('totalExp must be a valid number');
+  }
+
+  /**
+   * Checks if the given user object is valid by verifying its numeric properties.
+   *
+   * @param {UserEditor} user - The user object to check.
+   * @returns {boolean} `true` if all properties (exp, level, totalExp) are valid numbers; otherwise `false`.
+   */
+  isValidUser(user) {
+    if (typeof user.exp !== 'number' || Number.isNaN(user.exp)) return false;
+    if (typeof user.level !== 'number' || Number.isNaN(user.level)) return false;
+    if (user.level < 1) return false;
+    if (typeof user.totalExp !== 'number' || Number.isNaN(user.totalExp)) return false;
+    return true;
+  }
+
+  /**
+   * Returns the base experience value used for random experience generation.
+   * Throws an error if the internal giveExp value is not a valid number.
+   *
+   * @returns {number} The base experience value.
+   * @throws {Error} If giveExp is not a valid number.
    */
+  getGiveExpBase() {
+    if (typeof this.giveExp !== 'number' || Number.isNaN(this.giveExp))
+      throw new Error('giveExp must be a valid number');
+    return this.giveExp;
+  }
 
   /**
-   * @typedef {{ exp: number, level: number, totalExp: any }} UserEditor
+   * Returns the base experience required to level up.
+   * Throws an error if the internal expLevel value is not a valid number.
+   *
+   * @returns {number} The base experience needed per level.
+   * @throws {Error} If expLevel is not a valid number.
    */
+  getExpLevelBase() {
+    if (typeof this.expLevel !== 'number' || Number.isNaN(this.expLevel))
+      throw new Error('expLevel must be a valid number');
+    return this.expLevel;
+  }
 
   /**
    * Validates and adjusts the user's level based on their current experience.
    * @param {UserEditor} user - The user object containing experience and level properties.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   expValidator(user) {
+    const expLevel = this.getExpLevelBase();
+    this.validateUser(user);
+
     let extraValue = 0;
-    const nextLevelExp = this.expLevel * user.level;
+    const nextLevelExp = expLevel * user.level;
 
     // Level Up
     if (user.exp >= nextLevelExp) {
@@ -74,7 +152,7 @@ class TinyLevelUp {
     if (user.exp < 1 && user.level > 1) {
       user.level--;
       extraValue = Math.abs(user.exp);
-      user.exp = this.expLevel * user.level;
+      user.exp = expLevel * user.level;
 
       if (extraValue > 0) return this.remove(user, extraValue, 'extra');
     }
@@ -84,12 +162,14 @@ class TinyLevelUp {
 
   /**
    * Calculates the total experience based on the user's level.
-   * @param {{ exp: number, level: number }} user - The user object containing experience and level properties.
+   * @param {UserEditor} user - The user object containing experience and level properties.
    * @returns {number} The total experience of the user.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   getTotalExp(user) {
+    this.validateUser(user);
     let totalExp = 0;
-    for (let p = 1; p <= user.level; p++) totalExp += this.expLevel * p;
+    for (let p = 1; p <= user.level; p++) totalExp += this.getExpLevelBase() * p;
     totalExp += user.exp;
     return totalExp;
   }
@@ -100,34 +180,52 @@ class TinyLevelUp {
    * @returns {number} The generated experience points.
    */
   expGenerator(multi = 1) {
-    return Math.floor(Math.random() * this.giveExp) + 1 * multi;
+    if (typeof multi !== 'number' || Number.isNaN(multi))
+      throw new Error('multi must be a valid number');
+    return Math.floor(Math.random() * this.getGiveExpBase()) * multi;
+  }
+
+  /**
+   * Calculates how much experience is missing to next level.
+   * @param {UserEditor} user
+   * @returns {number}
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
+   */
+  getMissingExp(user) {
+    return this.getProgress(user) - user.exp;
   }
 
   /**
    * Gets the experience points required to reach the next level.
-   * @param {{ level: number }} user - The user object containing the level.
+   * @param {UserEditor} user - The user object containing the level.
    * @returns {number} The experience required for the next level.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   progress(user) {
-    return this.expLevel * user.level;
+    return this.getProgress(user);
   }
 
   /**
    * Gets the experience points required to reach the next level.
-   * @param {{ level: number }} user - The user object containing the level.
+   * @param {UserEditor} user - The user object containing the level.
    * @returns {number} The experience required for the next level.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   getProgress(user) {
-    return this.expLevel * user.level;
+    this.validateUser(user);
+    return this.getExpLevelBase() * user.level;
   }
 
   /**
    * Sets the experience value for the user, adjusting their level if necessary.
    * @param {UserEditor} user - The user object.
    * @param {number} value - The new experience value to set.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
    */
   set(user, value) {
+    if (typeof value !== 'number' || Number.isNaN(value))
+      throw new Error('value must be a valid number');
+
     user.exp = value;
     this.expValidator(user);
     user.totalExp = this.getTotalExp(user);
@@ -140,9 +238,15 @@ class TinyLevelUp {
    * @param {number} [extraExp] - Additional experience to be added.
    * @param {'add' | 'extra'} [type] - Type of addition ('add' or 'extra').
    * @param {number} [multi] - Multiplier for experience generation.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
    */
   give(user, extraExp = 0, type = 'add', multi = 1) {
+    if (typeof multi !== 'number' || Number.isNaN(multi))
+      throw new Error('multi must be a valid number');
+    if (typeof extraExp !== 'number' || Number.isNaN(extraExp))
+      throw new Error('extraExp must be a valid number');
+    if (typeof type !== 'string') throw new Error('type must be a valid string');
+
     if (type === 'add') user.exp += this.expGenerator(multi) + extraExp;
     else if (type === 'extra') user.exp += extraExp;
 
@@ -157,9 +261,15 @@ class TinyLevelUp {
    * @param {number} [extraExp] - Additional experience to remove.
    * @param {'add' | 'extra'} [type] - Type of removal ('add' or 'extra').
    * @param {number} [multi] - Multiplier for experience generation.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
    */
   remove(user, extraExp = 0, type = 'add', multi = 1) {
+    if (typeof multi !== 'number' || Number.isNaN(multi))
+      throw new Error('multi must be a valid number');
+    if (typeof extraExp !== 'number' || Number.isNaN(extraExp))
+      throw new Error('extraExp must be a valid number');
+    if (typeof type !== 'string') throw new Error('type must be a valid string');
+
     if (type === 'add') user.exp -= this.expGenerator(multi) + extraExp;
     else if (type === 'extra') user.exp -= extraExp;
 

package/dist/TinyLevelUp.min.js

@@ -1 +1 @@
-(()=>{"use strict";var e={d:(t,r)=>{for(var l in r)e.o(r,l)&&!e.o(t,l)&&Object.defineProperty(t,l,{enumerable:!0,get:r[l]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};e.d(t,{TinyLevelUp:()=>r});const r=class{constructor(e,t){this.giveExp=e,this.expLevel=t}expValidator(e){let t=0;const r=this.expLevel*e.level;return e.exp>=r&&(e.level++,t=e.exp-r,e.exp=0,t>0)?this.give(e,t,"extra"):e.exp<1&&e.level>1&&(e.level--,t=Math.abs(e.exp),e.exp=this.expLevel*e.level,t>0)?this.remove(e,t,"extra"):e}getTotalExp(e){let t=0;for(let r=1;r<=e.level;r++)t+=this.expLevel*r;return t+=e.exp,t}expGenerator(e=1){return Math.floor(Math.random()*this.giveExp)+1*e}progress(e){return this.expLevel*e.level}getProgress(e){return this.expLevel*e.level}set(e,t){return e.exp=t,this.expValidator(e),e.totalExp=this.getTotalExp(e),e}give(e,t=0,r="add",l=1){return"add"===r?e.exp+=this.expGenerator(l)+t:"extra"===r&&(e.exp+=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}remove(e,t=0,r="add",l=1){return"add"===r?e.exp-=this.expGenerator(l)+t:"extra"===r&&(e.exp-=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}};window.TinyLevelUp=t.TinyLevelUp})();
+(()=>{"use strict";var e={d:(r,t)=>{for(var a in t)e.o(t,a)&&!e.o(r,a)&&Object.defineProperty(r,a,{enumerable:!0,get:t[a]})},o:(e,r)=>Object.prototype.hasOwnProperty.call(e,r)},r={};e.d(r,{TinyLevelUp:()=>t});const t=class{constructor(e,r){if("number"!=typeof e||Number.isNaN(e))throw new Error("giveExp must be a valid number");if("number"!=typeof r||Number.isNaN(r))throw new Error("expLevel must be a valid number");this.giveExp=e,this.expLevel=r}createUser(){return{exp:0,level:1,totalExp:0}}validateUser(e){if("number"!=typeof e.exp||Number.isNaN(e.exp))throw new Error("exp must be a valid number");if("number"!=typeof e.level||Number.isNaN(e.level))throw new Error("level must be a valid number");if(e.level<1)throw new Error("level must be at least 1");if("number"!=typeof e.totalExp||Number.isNaN(e.totalExp))throw new Error("totalExp must be a valid number")}isValidUser(e){return!("number"!=typeof e.exp||Number.isNaN(e.exp)||"number"!=typeof e.level||Number.isNaN(e.level)||e.level<1||"number"!=typeof e.totalExp||Number.isNaN(e.totalExp))}getGiveExpBase(){if("number"!=typeof this.giveExp||Number.isNaN(this.giveExp))throw new Error("giveExp must be a valid number");return this.giveExp}getExpLevelBase(){if("number"!=typeof this.expLevel||Number.isNaN(this.expLevel))throw new Error("expLevel must be a valid number");return this.expLevel}expValidator(e){const r=this.getExpLevelBase();this.validateUser(e);let t=0;const a=r*e.level;return e.exp>=a&&(e.level++,t=e.exp-a,e.exp=0,t>0)?this.give(e,t,"extra"):e.exp<1&&e.level>1&&(e.level--,t=Math.abs(e.exp),e.exp=r*e.level,t>0)?this.remove(e,t,"extra"):e}getTotalExp(e){this.validateUser(e);let r=0;for(let t=1;t<=e.level;t++)r+=this.getExpLevelBase()*t;return r+=e.exp,r}expGenerator(e=1){if("number"!=typeof e||Number.isNaN(e))throw new Error("multi must be a valid number");return Math.floor(Math.random()*this.getGiveExpBase())*e}getMissingExp(e){return this.getProgress(e)-e.exp}progress(e){return this.getProgress(e)}getProgress(e){return this.validateUser(e),this.getExpLevelBase()*e.level}set(e,r){if("number"!=typeof r||Number.isNaN(r))throw new Error("value must be a valid number");return e.exp=r,this.expValidator(e),e.totalExp=this.getTotalExp(e),e}give(e,r=0,t="add",a=1){if("number"!=typeof a||Number.isNaN(a))throw new Error("multi must be a valid number");if("number"!=typeof r||Number.isNaN(r))throw new Error("extraExp must be a valid number");if("string"!=typeof t)throw new Error("type must be a valid string");return"add"===t?e.exp+=this.expGenerator(a)+r:"extra"===t&&(e.exp+=r),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}remove(e,r=0,t="add",a=1){if("number"!=typeof a||Number.isNaN(a))throw new Error("multi must be a valid number");if("number"!=typeof r||Number.isNaN(r))throw new Error("extraExp must be a valid number");if("string"!=typeof t)throw new Error("type must be a valid string");return"add"===t?e.exp-=this.expGenerator(a)+r:"extra"===t&&(e.exp-=r),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}};window.TinyLevelUp=r.TinyLevelUp})();

package/dist/TinyPromiseQueue.js

@@ -30,6 +30,16 @@ __webpack_require__.d(__webpack_exports__, {
 });
 
 ;// ./src/v1/libs/TinyPromiseQueue.mjs
+/**
+ * @typedef {Object} QueuedTask
+ * @property {(...args: any[]) => Promise<any>|Promise<any>} task - The async task to execute.
+ * @property {(value: any) => any} resolve - The resolve function from the Promise.
+ * @property {(reason?: any) => any} reject - The reject function from the Promise.
+ * @property {string|undefined} [id] - Optional identifier for the task.
+ * @property {string|null|undefined} [marker] - Optional marker for the task.
+ * @property {number|null|undefined} [delay] - Optional delay (in ms) before the task is executed.
+ */
+
 /**
  * A queue system for managing and executing asynchronous tasks sequentially, one at a time.
  *
@@ -39,20 +49,10 @@ __webpack_require__.d(__webpack_exports__, {
  * @class
  */
 class TinyPromiseQueue {
-  /**
-   * @typedef {Object} QueuedTask
-   * @property {(...args: any[]) => Promise<any>|Promise<any>} task - The async task to execute.
-   * @property {(value: any) => any} resolve - The resolve function from the Promise.
-   * @property {(reason?: any) => any} reject - The reject function from the Promise.
-   * @property {string|undefined} [id] - Optional identifier for the task.
-   * @property {string|null|undefined} [marker] - Optional marker for the task.
-   * @property {number|null|undefined} [delay] - Optional delay (in ms) before the task is executed.
-   */
-
-  /** @type {Array<QueuedTask>} */
+  /** @type {QueuedTask[]} */
   #queue = [];
   #running = false;
-  /** @type {Record<string, *>} */
+  /** @type {Record<string, ReturnType<typeof setTimeout>>} */
   #timeouts = {};
   /** @type {Set<string>} */
   #blacklist = new Set();
@@ -215,8 +215,13 @@ class TinyPromiseQueue {
    * @param {(...args: any[]) => Promise<any>|Promise<any>} task A function that returns a Promise.
    * @param {string} [id] Optional ID to identify the task in the queue.
    * @returns {Promise<any>} A Promise that resolves or rejects with the result of the task once it's processed.
+   * @throws {Error} Throws if param is invalid.
    */
   async enqueuePoint(task, id) {
+    if (typeof task !== 'function')
+      return Promise.reject(new Error('Task must be a function returning a Promise.'));
+    if (typeof id !== 'undefined' && typeof id !== 'string')
+      throw new Error('The "id" parameter must be a string.');
     if (!this.#running) return task();
     return new Promise((resolve, reject) => {
       this.#queue.push({ marker: 'POINT_MARKER', task, resolve, reject, id });
@@ -235,8 +240,16 @@ class TinyPromiseQueue {
    * @param {number|null} [delay] Optional delay (in ms) before the task is executed.
    * @param {string} [id] Optional ID to identify the task in the queue.
    * @returns {Promise<any>} A Promise that resolves or rejects with the result of the task once it's processed.
+   * @throws {Error} Throws if param is invalid.
    */
   enqueue(task, delay, id) {
+    if (typeof task !== 'function')
+      return Promise.reject(new Error('Task must be a function returning a Promise.'));
+    if (typeof delay !== 'undefined' && (typeof delay !== 'number' || delay < 0))
+      return Promise.reject(new Error('Delay must be a positive number or undefined.'));
+    if (typeof id !== 'undefined' && typeof id !== 'string')
+      throw new Error('The "id" parameter must be a string.');
+
     return new Promise((resolve, reject) => {
       this.#queue.push({ task, resolve, reject, id, delay });
       this.#processQueue();
@@ -249,9 +262,10 @@ class TinyPromiseQueue {
    *
    * @param {string} id The ID of the task to cancel.
    * @returns {boolean} True if a delay was cancelled and the task was removed.
+   * @throws {Error} Throws if `id` is not a string.
    */
   cancelTask(id) {
-    if (!id) return false;
+    if (typeof id !== 'string') throw new Error('The "id" parameter must be a string.');
     let cancelled = false;
 
     if (id in this.#timeouts) {

package/dist/TinyPromiseQueue.min.js

@@ -1 +1 @@
-(()=>{"use strict";var e={d:(t,s)=>{for(var i in s)e.o(s,i)&&!e.o(t,i)&&Object.defineProperty(t,i,{enumerable:!0,get:s[i]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};e.d(t,{TinyPromiseQueue:()=>s});const s=class{#e=[];#t=!1;#s={};#i=new Set;isRunning(){return this.#t}async#u(e){if(e&&"function"==typeof e.task&&"function"==typeof e.resolve&&"function"==typeof e.reject){const{task:t,resolve:s,reject:i,delay:u,id:n}=e;try{if(n&&this.#i.has(n))return i(new Error("The function was canceled on TinyPromiseQueue.")),this.#i.delete(n),this.#t=!1,void this.#n();u&&n&&await new Promise((e=>{const t=setTimeout((()=>{delete this.#s[n],e(null)}),u);this.#s[n]=t})),s(await t())}catch(e){i(e)}finally{this.#t=!1,this.#n()}}}async#r(){const e=[];for(;this.#e.length&&"POINT_MARKER"===this.#e[0]?.marker;)e.push(this.#e.shift());if(0===e.length)return this.#t=!1,void this.#n();await Promise.all(e.map((({task:e,resolve:t,reject:s,id:i})=>new Promise((async u=>{if(i&&this.#i.has(i))return this.#i.delete(i),s(new Error("The function was canceled on TinyPromiseQueue.")),void u(!0);await e().then(t).catch(s),u(!0)}))))),this.#t=!1,this.#n()}async#n(){if(!this.#t&&0!==this.#e.length)if(this.#t=!0,"string"!=typeof this.#e[0]?.marker||"POINT_MARKER"!==this.#e[0]?.marker){const e=this.#e.shift();this.#u(e)}else this.#r()}getIndexById(e){return this.#e.findIndex((t=>t.id===e))}getQueuedIds(){return this.#e.map(((e,t)=>({index:t,id:e.id}))).filter((e=>"string"==typeof e.id))}reorderQueue(e,t){if("number"!=typeof e||"number"!=typeof t||e<0||t<0||e>=this.#e.length||t>=this.#e.length)return;const[s]=this.#e.splice(e,1);this.#e.splice(t,0,s)}async enqueuePoint(e,t){return this.#t?new Promise(((s,i)=>{this.#e.push({marker:"POINT_MARKER",task:e,resolve:s,reject:i,id:t}),this.#n()})):e()}enqueue(e,t,s){return new Promise(((i,u)=>{this.#e.push({task:e,resolve:i,reject:u,id:s,delay:t}),this.#n()}))}cancelTask(e){if(!e)return!1;let t=!1;e in this.#s&&(clearTimeout(this.#s[e]),delete this.#s[e],t=!0);const s=this.getIndexById(e);if(-1!==s){const[e]=this.#e.splice(s,1);e?.reject?.(new Error("The function was canceled on TinyPromiseQueue.")),t=!0}return t&&this.#i.add(e),t}};window.TinyPromiseQueue=t.TinyPromiseQueue})();
+(()=>{"use strict";var e={d:(t,i)=>{for(var r in i)e.o(i,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:i[r]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};e.d(t,{TinyPromiseQueue:()=>i});const i=class{#e=[];#t=!1;#i={};#r=new Set;isRunning(){return this.#t}async#s(e){if(e&&"function"==typeof e.task&&"function"==typeof e.resolve&&"function"==typeof e.reject){const{task:t,resolve:i,reject:r,delay:s,id:n}=e;try{if(n&&this.#r.has(n))return r(new Error("The function was canceled on TinyPromiseQueue.")),this.#r.delete(n),this.#t=!1,void this.#n();s&&n&&await new Promise((e=>{const t=setTimeout((()=>{delete this.#i[n],e(null)}),s);this.#i[n]=t})),i(await t())}catch(e){r(e)}finally{this.#t=!1,this.#n()}}}async#u(){const e=[];for(;this.#e.length&&"POINT_MARKER"===this.#e[0]?.marker;)e.push(this.#e.shift());if(0===e.length)return this.#t=!1,void this.#n();await Promise.all(e.map((({task:e,resolve:t,reject:i,id:r})=>new Promise((async s=>{if(r&&this.#r.has(r))return this.#r.delete(r),i(new Error("The function was canceled on TinyPromiseQueue.")),void s(!0);await e().then(t).catch(i),s(!0)}))))),this.#t=!1,this.#n()}async#n(){if(!this.#t&&0!==this.#e.length)if(this.#t=!0,"string"!=typeof this.#e[0]?.marker||"POINT_MARKER"!==this.#e[0]?.marker){const e=this.#e.shift();this.#s(e)}else this.#u()}getIndexById(e){return this.#e.findIndex((t=>t.id===e))}getQueuedIds(){return this.#e.map(((e,t)=>({index:t,id:e.id}))).filter((e=>"string"==typeof e.id))}reorderQueue(e,t){if("number"!=typeof e||"number"!=typeof t||e<0||t<0||e>=this.#e.length||t>=this.#e.length)return;const[i]=this.#e.splice(e,1);this.#e.splice(t,0,i)}async enqueuePoint(e,t){if("function"!=typeof e)return Promise.reject(new Error("Task must be a function returning a Promise."));if(void 0!==t&&"string"!=typeof t)throw new Error('The "id" parameter must be a string.');return this.#t?new Promise(((i,r)=>{this.#e.push({marker:"POINT_MARKER",task:e,resolve:i,reject:r,id:t}),this.#n()})):e()}enqueue(e,t,i){if("function"!=typeof e)return Promise.reject(new Error("Task must be a function returning a Promise."));if(void 0!==t&&("number"!=typeof t||t<0))return Promise.reject(new Error("Delay must be a positive number or undefined."));if(void 0!==i&&"string"!=typeof i)throw new Error('The "id" parameter must be a string.');return new Promise(((r,s)=>{this.#e.push({task:e,resolve:r,reject:s,id:i,delay:t}),this.#n()}))}cancelTask(e){if("string"!=typeof e)throw new Error('The "id" parameter must be a string.');let t=!1;e in this.#i&&(clearTimeout(this.#i[e]),delete this.#i[e],t=!0);const i=this.getIndexById(e);if(-1!==i){const[e]=this.#e.splice(i,1);e?.reject?.(new Error("The function was canceled on TinyPromiseQueue.")),t=!0}return t&&this.#r.add(e),t}};window.TinyPromiseQueue=t.TinyPromiseQueue})();

package/dist/legacy/libs/userLevel.cjs

@@ -1,5 +1,14 @@
 'use strict';
 
+/**
+ * Represents a user object used.
+ *
+ * @typedef {Object} UserEditor
+ * @property {number} exp - Current experience points of the user.
+ * @property {number} level - Current level of the user.
+ * @property {number} totalExp - Total accumulated experience.
+ */
+
 /**
  * Class to manage user level-up logic based on experience points.
  */
@@ -10,26 +19,95 @@ class TinyLevelUp {
    * @param {number} expLevel - Base experience needed to level up (per level).
    */
   constructor(giveExp, expLevel) {
+    if (typeof giveExp !== 'number' || Number.isNaN(giveExp))
+      throw new Error('giveExp must be a valid number');
+    if (typeof expLevel !== 'number' || Number.isNaN(expLevel))
+      throw new Error('expLevel must be a valid number');
     this.giveExp = giveExp;
     this.expLevel = expLevel;
   }
 
   /**
-   * @typedef {{ exp: number, level: number, totalExp: number }} UserResult
+   * Creates a new user object starting at level 0 with 0 experience.
+   * @returns {UserEditor} A fresh user object.
+   */
+  createUser() {
+    return {
+      exp: 0,
+      level: 1,
+      totalExp: 0,
+    };
+  }
+
+  /**
+   * Validates if the given user object has valid numeric properties.
+   * Throws an error if any property is invalid.
+   *
+   * @param {UserEditor} user - The user object to validate.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
+   */
+  validateUser(user) {
+    if (typeof user.exp !== 'number' || Number.isNaN(user.exp))
+      throw new Error('exp must be a valid number');
+    if (typeof user.level !== 'number' || Number.isNaN(user.level))
+      throw new Error('level must be a valid number');
+    if (user.level < 1) throw new Error('level must be at least 1');
+    if (typeof user.totalExp !== 'number' || Number.isNaN(user.totalExp))
+      throw new Error('totalExp must be a valid number');
+  }
+
+  /**
+   * Checks if the given user object is valid by verifying its numeric properties.
+   *
+   * @param {UserEditor} user - The user object to check.
+   * @returns {boolean} `true` if all properties (exp, level, totalExp) are valid numbers; otherwise `false`.
+   */
+  isValidUser(user) {
+    if (typeof user.exp !== 'number' || Number.isNaN(user.exp)) return false;
+    if (typeof user.level !== 'number' || Number.isNaN(user.level)) return false;
+    if (user.level < 1) return false;
+    if (typeof user.totalExp !== 'number' || Number.isNaN(user.totalExp)) return false;
+    return true;
+  }
+
+  /**
+   * Returns the base experience value used for random experience generation.
+   * Throws an error if the internal giveExp value is not a valid number.
+   *
+   * @returns {number} The base experience value.
+   * @throws {Error} If giveExp is not a valid number.
    */
+  getGiveExpBase() {
+    if (typeof this.giveExp !== 'number' || Number.isNaN(this.giveExp))
+      throw new Error('giveExp must be a valid number');
+    return this.giveExp;
+  }
 
   /**
-   * @typedef {{ exp: number, level: number, totalExp: any }} UserEditor
+   * Returns the base experience required to level up.
+   * Throws an error if the internal expLevel value is not a valid number.
+   *
+   * @returns {number} The base experience needed per level.
+   * @throws {Error} If expLevel is not a valid number.
    */
+  getExpLevelBase() {
+    if (typeof this.expLevel !== 'number' || Number.isNaN(this.expLevel))
+      throw new Error('expLevel must be a valid number');
+    return this.expLevel;
+  }
 
   /**
    * Validates and adjusts the user's level based on their current experience.
    * @param {UserEditor} user - The user object containing experience and level properties.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   expValidator(user) {
+    const expLevel = this.getExpLevelBase();
+    this.validateUser(user);
+
     let extraValue = 0;
-    const nextLevelExp = this.expLevel * user.level;
+    const nextLevelExp = expLevel * user.level;
 
     // Level Up
     if (user.exp >= nextLevelExp) {
@@ -44,7 +122,7 @@ class TinyLevelUp {
     if (user.exp < 1 && user.level > 1) {
       user.level--;
       extraValue = Math.abs(user.exp);
-      user.exp = this.expLevel * user.level;
+      user.exp = expLevel * user.level;
 
       if (extraValue > 0) return this.remove(user, extraValue, 'extra');
     }
@@ -54,12 +132,14 @@ class TinyLevelUp {
 
   /**
    * Calculates the total experience based on the user's level.
-   * @param {{ exp: number, level: number }} user - The user object containing experience and level properties.
+   * @param {UserEditor} user - The user object containing experience and level properties.
    * @returns {number} The total experience of the user.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   getTotalExp(user) {
+    this.validateUser(user);
     let totalExp = 0;
-    for (let p = 1; p <= user.level; p++) totalExp += this.expLevel * p;
+    for (let p = 1; p <= user.level; p++) totalExp += this.getExpLevelBase() * p;
     totalExp += user.exp;
     return totalExp;
   }
@@ -70,34 +150,52 @@ class TinyLevelUp {
    * @returns {number} The generated experience points.
    */
   expGenerator(multi = 1) {
-    return Math.floor(Math.random() * this.giveExp) + 1 * multi;
+    if (typeof multi !== 'number' || Number.isNaN(multi))
+      throw new Error('multi must be a valid number');
+    return Math.floor(Math.random() * this.getGiveExpBase()) * multi;
+  }
+
+  /**
+   * Calculates how much experience is missing to next level.
+   * @param {UserEditor} user
+   * @returns {number}
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
+   */
+  getMissingExp(user) {
+    return this.getProgress(user) - user.exp;
   }
 
   /**
    * Gets the experience points required to reach the next level.
-   * @param {{ level: number }} user - The user object containing the level.
+   * @param {UserEditor} user - The user object containing the level.
    * @returns {number} The experience required for the next level.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   progress(user) {
-    return this.expLevel * user.level;
+    return this.getProgress(user);
   }
 
   /**
    * Gets the experience points required to reach the next level.
-   * @param {{ level: number }} user - The user object containing the level.
+   * @param {UserEditor} user - The user object containing the level.
    * @returns {number} The experience required for the next level.
+   * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
    */
   getProgress(user) {
-    return this.expLevel * user.level;
+    this.validateUser(user);
+    return this.getExpLevelBase() * user.level;
   }
 
   /**
    * Sets the experience value for the user, adjusting their level if necessary.
    * @param {UserEditor} user - The user object.
    * @param {number} value - The new experience value to set.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
    */
   set(user, value) {
+    if (typeof value !== 'number' || Number.isNaN(value))
+      throw new Error('value must be a valid number');
+
     user.exp = value;
     this.expValidator(user);
     user.totalExp = this.getTotalExp(user);
@@ -110,9 +208,15 @@ class TinyLevelUp {
    * @param {number} [extraExp] - Additional experience to be added.
    * @param {'add' | 'extra'} [type] - Type of addition ('add' or 'extra').
    * @param {number} [multi] - Multiplier for experience generation.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
    */
   give(user, extraExp = 0, type = 'add', multi = 1) {
+    if (typeof multi !== 'number' || Number.isNaN(multi))
+      throw new Error('multi must be a valid number');
+    if (typeof extraExp !== 'number' || Number.isNaN(extraExp))
+      throw new Error('extraExp must be a valid number');
+    if (typeof type !== 'string') throw new Error('type must be a valid string');
+
     if (type === 'add') user.exp += this.expGenerator(multi) + extraExp;
     else if (type === 'extra') user.exp += extraExp;
 
@@ -127,9 +231,15 @@ class TinyLevelUp {
    * @param {number} [extraExp] - Additional experience to remove.
    * @param {'add' | 'extra'} [type] - Type of removal ('add' or 'extra').
    * @param {number} [multi] - Multiplier for experience generation.
-   * @returns {UserResult} The updated user object.
+   * @returns {UserEditor} The updated user object.
    */
   remove(user, extraExp = 0, type = 'add', multi = 1) {
+    if (typeof multi !== 'number' || Number.isNaN(multi))
+      throw new Error('multi must be a valid number');
+    if (typeof extraExp !== 'number' || Number.isNaN(extraExp))
+      throw new Error('extraExp must be a valid number');
+    if (typeof type !== 'string') throw new Error('type must be a valid string');
+
     if (type === 'add') user.exp -= this.expGenerator(multi) + extraExp;
     else if (type === 'extra') user.exp -= extraExp;