tiny-essentials 1.9.0 → 1.9.1

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

@@ -1,4 +1,29 @@
 export default TinyLevelUp;
+/**
+ * Represents a user object used.
+ */
+export type UserEditor = {
+    /**
+     * - Current experience points of the user.
+     */
+    exp: number;
+    /**
+     * - Current level of the user.
+     */
+    level: number;
+    /**
+     * - Total accumulated experience.
+     */
+    totalExp: number;
+};
+/**
+ * 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.
  */
@@ -12,104 +37,106 @@ declare class TinyLevelUp {
     giveExp: number;
     expLevel: number;
     /**
-     * @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(): UserEditor;
+    /**
+     * 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: UserEditor): void;
     /**
-     * @typedef {{ exp: number, level: number, totalExp: any }} UserEditor
+     * 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: UserEditor): boolean;
+    /**
+     * 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(): number;
+    /**
+     * 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(): number;
     /**
      * 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.
-     */
-    expValidator(user: {
-        exp: number;
-        level: number;
-        totalExp: any;
-    }): {
-        exp: number;
-        level: number;
-        totalExp: number;
-    };
+     * @returns {UserEditor} The updated user object.
+     * @throws {Error} If any property (exp, level, totalExp) is not a valid number.
+     */
+    expValidator(user: UserEditor): UserEditor;
     /**
      * 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: {
-        exp: number;
-        level: number;
-    }): number;
+    getTotalExp(user: UserEditor): number;
     /**
      * Generates random experience points based on the configured multiplier.
      * @param {number} [multi] - A multiplier for the generated experience.
      * @returns {number} The generated experience points.
      */
     expGenerator(multi?: number): number;
+    /**
+     * 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: UserEditor): number;
     /**
      * 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: {
-        level: number;
-    }): number;
+    progress(user: UserEditor): number;
     /**
      * 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: {
-        level: number;
-    }): number;
+    getProgress(user: UserEditor): number;
     /**
      * 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.
-     */
-    set(user: {
-        exp: number;
-        level: number;
-        totalExp: any;
-    }, value: number): {
-        exp: number;
-        level: number;
-        totalExp: number;
-    };
+     * @returns {UserEditor} The updated user object.
+     */
+    set(user: UserEditor, value: number): UserEditor;
     /**
      * Adds experience to the user, adjusting their level if necessary.
      * @param {UserEditor} user - The user object.
      * @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.
-     */
-    give(user: {
-        exp: number;
-        level: number;
-        totalExp: any;
-    }, extraExp?: number, type?: "add" | "extra", multi?: number): {
-        exp: number;
-        level: number;
-        totalExp: number;
-    };
+     * @returns {UserEditor} The updated user object.
+     */
+    give(user: UserEditor, extraExp?: number, type?: "add" | "extra", multi?: number): UserEditor;
     /**
      * Removes experience from the user, adjusting their level if necessary.
      * @param {UserEditor} user - The user object.
      * @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.
-     */
-    remove(user: {
-        exp: number;
-        level: number;
-        totalExp: any;
-    }, extraExp?: number, type?: "add" | "extra", multi?: number): {
-        exp: number;
-        level: number;
-        totalExp: number;
-    };
+     * @returns {UserEditor} The updated user object.
+     */
+    remove(user: UserEditor, extraExp?: number, type?: "add" | "extra", multi?: number): UserEditor;
 }
 //# sourceMappingURL=userLevel.d.mts.map

package/dist/legacy/libs/userLevel.mjs

@@ -1,3 +1,11 @@
+/**
+ * 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.
  */
@@ -8,23 +16,93 @@ 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,
+        };
+    }
     /**
-     * @typedef {{ exp: number, level: number, totalExp: any }} UserEditor
+     * 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;
+    }
+    /**
+     * 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) {
             user.level++;
@@ -37,7 +115,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');
         }
@@ -45,13 +123,15 @@ 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;
+            totalExp += this.getExpLevelBase() * p;
         totalExp += user.exp;
         return totalExp;
     }
@@ -61,31 +141,47 @@ 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);
@@ -97,9 +193,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')
@@ -114,9 +216,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')

package/dist/v1/libs/TinyPromiseQueue.cjs

@@ -1,5 +1,15 @@
 'use strict';
 
+/**
+ * @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.
  *
@@ -9,20 +19,10 @@
  * @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();
@@ -185,8 +185,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 });
@@ -205,8 +210,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();
@@ -219,9 +232,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/v1/libs/TinyPromiseQueue.d.mts

@@ -1,4 +1,39 @@
 export default TinyPromiseQueue;
+export type QueuedTask = {
+    /**
+     * - The async task to execute.
+     */
+    task: (...args: any[]) => Promise<any> | Promise<any>;
+    /**
+     * - The resolve function from the Promise.
+     */
+    resolve: (value: any) => any;
+    /**
+     * - The reject function from the Promise.
+     */
+    reject: (reason?: any) => any;
+    /**
+     * - Optional identifier for the task.
+     */
+    id?: string | undefined;
+    /**
+     * - Optional marker for the task.
+     */
+    marker?: string | null | undefined;
+    /**
+     * - Optional delay (in ms) before the task is executed.
+     */
+    delay?: number | null | undefined;
+};
+/**
+ * @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.
  *
@@ -44,6 +79,7 @@ declare 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.
      */
     enqueuePoint(task: (...args: any[]) => Promise<any> | Promise<any>, id?: string): Promise<any>;
     /**
@@ -57,6 +93,7 @@ declare 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: (...args: any[]) => Promise<any> | Promise<any>, delay?: number | null, id?: string): Promise<any>;
     /**
@@ -65,6 +102,7 @@ declare 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: string): boolean;
     #private;

package/dist/v1/libs/TinyPromiseQueue.mjs

@@ -1,3 +1,12 @@
+/**
+ * @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.
  *
@@ -7,19 +16,10 @@
  * @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();
@@ -165,8 +165,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) => {
@@ -185,8 +190,15 @@ 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();
@@ -198,10 +210,11 @@ 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) {
             clearTimeout(this.#timeouts[id]);