tiny-essentials 1.2.0 → 1.3.0

package/dist/legacy/libs/capitalize.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * Capitalizes the first letter of each word in a given string.
  *

package/dist/legacy/libs/capitalize.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * Capitalizes the first letter of each word in a given string.
  *

package/dist/legacy/libs/convertBytes.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * A utility module to convert between bytes and higher order units (KB, MB, GB, etc).
  */

package/dist/legacy/libs/convertBytes.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * A utility module to convert between bytes and higher order units (KB, MB, GB, etc).
  */

package/dist/legacy/libs/custom_module_loader.cjs

@@ -2,6 +2,9 @@
 
 var objType = require('../get/objType.cjs');
 
+// @ts-nocheck
+
+
 /**
  * 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.

package/dist/legacy/libs/custom_module_loader.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import objType from '../get/objType.mjs';
 /**
  * A custom module manager to validate and run hooks on external modules dynamically.

package/dist/legacy/libs/dice.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * A simple random number generator (dice roller) utility.
  * Supports a vanilla dice roll from 1 to N.

package/dist/legacy/libs/dice.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * A simple random number generator (dice roller) utility.
  * Supports a vanilla dice roll from 1 to N.

package/dist/legacy/libs/markdown.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * A lightweight Markdown parser that can convert to HTML or BBCode.
  * @namespace markdownManager

package/dist/legacy/libs/markdown.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * A lightweight Markdown parser that can convert to HTML or BBCode.
  * @namespace markdownManager

package/dist/legacy/libs/percentage.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * Simple utility to calculate percentage values.
  * @namespace percentageBase

package/dist/legacy/libs/percentage.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * Simple utility to calculate percentage values.
  * @namespace percentageBase

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

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * Matches exactly one letter (lowercase or uppercase).
  * @param {string} [type='g'] - The flag for the regular expression (default is 'g').

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

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * Matches exactly one letter (lowercase or uppercase).
  * @param {string} [type='g'] - The flag for the regular expression (default is 'g').

package/dist/legacy/libs/replaceAsync.cjs

@@ -15,6 +15,9 @@
  * });
  */
 async function asyncReplace(str, regex, asyncFn) {
+  /**
+   * @type {any[]}
+   */
   const promises = [];
 
   // Collect promises

package/dist/legacy/libs/replaceAsync.mjs

@@ -13,6 +13,9 @@
  * });
  */
 export default async function asyncReplace(str, regex, asyncFn) {
+    /**
+     * @type {any[]}
+     */
     const promises = [];
     // Collect promises
     str.replace(regex, (match, ...args) => {

package/dist/legacy/libs/rule3.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * Rule of Three utility.
  * Performs direct or inverse proportional calculation.

package/dist/legacy/libs/rule3.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * Rule of Three utility.
  * Performs direct or inverse proportional calculation.

package/dist/legacy/libs/userLevel.cjs

@@ -16,7 +16,7 @@ class TinyLevelUp {
 
   /**
    * Validates and adjusts the user's level based on their current experience.
-   * @param {Object} user - The user object containing experience and level properties.
+   * @param {{ exp: number, level: number, totalExp: any }} user - The user object containing experience and level properties.
    * @returns {Object} The updated user object.
    */
   expValidator(user) {
@@ -46,7 +46,7 @@ class TinyLevelUp {
 
   /**
    * Calculates the total experience based on the user's level.
-   * @param {Object} user - The user object containing experience and level properties.
+   * @param {{ exp: number, level: number }} user - The user object containing experience and level properties.
    * @returns {number} The total experience of the user.
    */
   getTotalExp(user) {
@@ -67,7 +67,7 @@ class TinyLevelUp {
 
   /**
    * Gets the experience points required to reach the next level.
-   * @param {Object} user - The user object containing the level.
+   * @param {{ level: number }} user - The user object containing the level.
    * @returns {number} The experience required for the next level.
    */
   progress(user) {
@@ -76,7 +76,7 @@ class TinyLevelUp {
 
   /**
    * Gets the experience points required to reach the next level.
-   * @param {Object} user - The user object containing the level.
+   * @param {{ level: number }} user - The user object containing the level.
    * @returns {number} The experience required for the next level.
    */
   getProgress(user) {
@@ -85,7 +85,7 @@ class TinyLevelUp {
 
   /**
    * Sets the experience value for the user, adjusting their level if necessary.
-   * @param {Object} user - The user object.
+   * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
    * @param {number} value - The new experience value to set.
    * @returns {Object} The updated user object.
    */
@@ -98,9 +98,9 @@ class TinyLevelUp {
 
   /**
    * Adds experience to the user, adjusting their level if necessary.
-   * @param {Object} user - The user object.
+   * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
    * @param {number} extraExp - Additional experience to be added.
-   * @param {string} type - Type of addition ('add' or 'extra').
+   * @param {'add' | 'extra'} type - Type of addition ('add' or 'extra').
    * @param {number} multi - Multiplier for experience generation.
    * @returns {Object} The updated user object.
    */
@@ -115,9 +115,9 @@ class TinyLevelUp {
 
   /**
    * Removes experience from the user, adjusting their level if necessary.
-   * @param {Object} user - The user object.
+   * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
    * @param {number} extraExp - Experience to remove.
-   * @param {string} type - Type of removal ('add' or 'extra').
+   * @param {'add' | 'extra'} type - Type of removal ('add' or 'extra').
    * @param {number} multi - Multiplier for experience generation.
    * @returns {Object} The updated user object.
    */

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

@@ -13,16 +13,23 @@ declare class TinyLevelUp {
     expLevel: number;
     /**
      * Validates and adjusts the user's level based on their current experience.
-     * @param {Object} user - The user object containing experience and level properties.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object containing experience and level properties.
      * @returns {Object} The updated user object.
      */
-    expValidator(user: Object): Object;
+    expValidator(user: {
+        exp: number;
+        level: number;
+        totalExp: any;
+    }): Object;
     /**
      * Calculates the total experience based on the user's level.
-     * @param {Object} user - The user object containing experience and level properties.
+     * @param {{ exp: number, level: number }} user - The user object containing experience and level properties.
      * @returns {number} The total experience of the user.
      */
-    getTotalExp(user: Object): number;
+    getTotalExp(user: {
+        exp: number;
+        level: number;
+    }): number;
     /**
      * Generates random experience points based on the configured multiplier.
      * @param {number} multi - A multiplier for the generated experience.
@@ -31,39 +38,55 @@ declare class TinyLevelUp {
     expGenerator(multi?: number): number;
     /**
      * Gets the experience points required to reach the next level.
-     * @param {Object} user - The user object containing the level.
+     * @param {{ level: number }} user - The user object containing the level.
      * @returns {number} The experience required for the next level.
      */
-    progress(user: Object): number;
+    progress(user: {
+        level: number;
+    }): number;
     /**
      * Gets the experience points required to reach the next level.
-     * @param {Object} user - The user object containing the level.
+     * @param {{ level: number }} user - The user object containing the level.
      * @returns {number} The experience required for the next level.
      */
-    getProgress(user: Object): number;
+    getProgress(user: {
+        level: number;
+    }): number;
     /**
      * Sets the experience value for the user, adjusting their level if necessary.
-     * @param {Object} user - The user object.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
      * @param {number} value - The new experience value to set.
      * @returns {Object} The updated user object.
      */
-    set(user: Object, value: number): Object;
+    set(user: {
+        exp: number;
+        level: number;
+        totalExp: any;
+    }, value: number): Object;
     /**
      * Adds experience to the user, adjusting their level if necessary.
-     * @param {Object} user - The user object.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
      * @param {number} extraExp - Additional experience to be added.
-     * @param {string} type - Type of addition ('add' or 'extra').
+     * @param {'add' | 'extra'} type - Type of addition ('add' or 'extra').
      * @param {number} multi - Multiplier for experience generation.
      * @returns {Object} The updated user object.
      */
-    give(user: Object, extraExp?: number, type?: string, multi?: number): Object;
+    give(user: {
+        exp: number;
+        level: number;
+        totalExp: any;
+    }, extraExp?: number, type?: "add" | "extra", multi?: number): Object;
     /**
      * Removes experience from the user, adjusting their level if necessary.
-     * @param {Object} user - The user object.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
      * @param {number} extraExp - Experience to remove.
-     * @param {string} type - Type of removal ('add' or 'extra').
+     * @param {'add' | 'extra'} type - Type of removal ('add' or 'extra').
      * @param {number} multi - Multiplier for experience generation.
      * @returns {Object} The updated user object.
      */
-    remove(user: Object, extraExp?: number, type?: string, multi?: number): Object;
+    remove(user: {
+        exp: number;
+        level: number;
+        totalExp: any;
+    }, extraExp?: number, type?: "add" | "extra", multi?: number): Object;
 }

package/dist/legacy/libs/userLevel.mjs

@@ -13,7 +13,7 @@ class TinyLevelUp {
     }
     /**
      * Validates and adjusts the user's level based on their current experience.
-     * @param {Object} user - The user object containing experience and level properties.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object containing experience and level properties.
      * @returns {Object} The updated user object.
      */
     expValidator(user) {
@@ -39,7 +39,7 @@ class TinyLevelUp {
     }
     /**
      * Calculates the total experience based on the user's level.
-     * @param {Object} user - The user object containing experience and level properties.
+     * @param {{ exp: number, level: number }} user - The user object containing experience and level properties.
      * @returns {number} The total experience of the user.
      */
     getTotalExp(user) {
@@ -59,7 +59,7 @@ class TinyLevelUp {
     }
     /**
      * Gets the experience points required to reach the next level.
-     * @param {Object} user - The user object containing the level.
+     * @param {{ level: number }} user - The user object containing the level.
      * @returns {number} The experience required for the next level.
      */
     progress(user) {
@@ -67,7 +67,7 @@ class TinyLevelUp {
     }
     /**
      * Gets the experience points required to reach the next level.
-     * @param {Object} user - The user object containing the level.
+     * @param {{ level: number }} user - The user object containing the level.
      * @returns {number} The experience required for the next level.
      */
     getProgress(user) {
@@ -75,7 +75,7 @@ class TinyLevelUp {
     }
     /**
      * Sets the experience value for the user, adjusting their level if necessary.
-     * @param {Object} user - The user object.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
      * @param {number} value - The new experience value to set.
      * @returns {Object} The updated user object.
      */
@@ -87,9 +87,9 @@ class TinyLevelUp {
     }
     /**
      * Adds experience to the user, adjusting their level if necessary.
-     * @param {Object} user - The user object.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
      * @param {number} extraExp - Additional experience to be added.
-     * @param {string} type - Type of addition ('add' or 'extra').
+     * @param {'add' | 'extra'} type - Type of addition ('add' or 'extra').
      * @param {number} multi - Multiplier for experience generation.
      * @returns {Object} The updated user object.
      */
@@ -104,9 +104,9 @@ class TinyLevelUp {
     }
     /**
      * Removes experience from the user, adjusting their level if necessary.
-     * @param {Object} user - The user object.
+     * @param {{ exp: number, level: number, totalExp: any }} user - The user object.
      * @param {number} extraExp - Experience to remove.
-     * @param {string} type - Type of removal ('add' or 'extra').
+     * @param {'add' | 'extra'} type - Type of removal ('add' or 'extra').
      * @param {number} multi - Multiplier for experience generation.
      * @returns {Object} The updated user object.
      */

package/dist/legacy/momentjs/getAge.cjs

@@ -2,6 +2,9 @@
 
 var moment = require('moment');
 
+// @ts-nocheck
+
+
 /**
  * Calculates the age based on the given date.
  *

package/dist/legacy/momentjs/getAge.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import moment from 'moment';
 /**
  * Calculates the age based on the given date.

package/dist/legacy/momentjs/index.cjs

@@ -3,7 +3,7 @@
 var timeDuration = require('./timeDuration.cjs');
 var getAge = require('./getAge.cjs');
 
-
+// @ts-nocheck
 
 exports.timeDuration = timeDuration;
 exports.getAge = getAge;

package/dist/legacy/momentjs/index.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import timeDuration from './timeDuration.mjs';
 import getAge from './getAge.mjs';
 export { timeDuration, getAge };

package/dist/legacy/momentjs/timeDuration.cjs

@@ -2,6 +2,9 @@
 
 var moment = require('moment');
 
+// @ts-nocheck
+
+
 /**
  * Calculates the time duration between the current time and a given time offset.
  *

package/dist/legacy/momentjs/timeDuration.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import moment from 'moment';
 /**
  * Calculates the time duration between the current time and a given time offset.

package/dist/legacy/socket.io/antiFlood/index.cjs

@@ -3,7 +3,7 @@
 var install = require('./install.cjs');
 var verify = require('./verify.cjs');
 
-
+// @ts-nocheck
 
 exports.install = install;
 exports.verify = verify;

package/dist/legacy/socket.io/antiFlood/index.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import install from './install.mjs';
 import verify from './verify.mjs';
 export { verify, install };

package/dist/legacy/socket.io/antiFlood/install.cjs

@@ -2,6 +2,9 @@
 
 var userIP = require('../../http/userIP.cjs');
 
+// @ts-nocheck
+
+
 /**
  * Installs the authorization middleware for socket connections.
  *

package/dist/legacy/socket.io/antiFlood/install.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import userIp from '../../http/userIP.mjs';
 /**
  * Installs the authorization middleware for socket connections.

package/dist/legacy/socket.io/antiFlood/verify.cjs

@@ -2,6 +2,9 @@
 
 var userIP = require('../../http/userIP.cjs');
 
+// @ts-nocheck
+
+
 // Panel
 const floodPanel = {};
 

package/dist/legacy/socket.io/antiFlood/verify.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import userIp from '../../http/userIP.mjs';
 // Panel
 const floodPanel = {};

package/dist/legacy/socket.io/cookie-session.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+// @ts-nocheck
+
 /**
  * Handles the cookie session for a socket connection by simulating an Express request and response.
  * This function uses the provided session module to manage session data for the socket connection.

package/dist/legacy/socket.io/cookie-session.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * Handles the cookie session for a socket connection by simulating an Express request and response.
  * This function uses the provided session module to manage session data for the socket connection.

package/dist/legacy/socket.io/discord.cjs

@@ -2,6 +2,9 @@
 
 var getUser = require('../firebase/discord/api/getUser.cjs');
 
+// @ts-nocheck
+
+
 /**
  * Handles the Discord OAuth2 authentication for a user, stores user data in an in-memory cache,
  * and manages the user's socket connection and disconnection events.

package/dist/legacy/socket.io/discord.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import getUser from '../firebase/discord/api/getUser.mjs';
 /**
  * Handles the Discord OAuth2 authentication for a user, stores user data in an in-memory cache,

package/dist/legacy/socket.io/index.cjs

@@ -4,6 +4,9 @@ var index = require('./antiFlood/index.cjs');
 var discord = require('./discord.cjs');
 var cookieSession = require('./cookie-session.cjs');
 
+// @ts-nocheck
+
+
 const socketIo = {
   antiFlood: index,
   'cookie-session': cookieSession,

package/dist/legacy/socket.io/index.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import * as antiFlood from './antiFlood/index.mjs';
 import discord from './discord.mjs';
 import cookieSession from './cookie-session.mjs';

package/dist/v1/basics/clock.cjs

@@ -11,7 +11,8 @@
 function getTimeDuration(timeData = new Date(), durationType = 'asSeconds', now = null) {
   if (timeData instanceof Date) {
     const currentTime = now instanceof Date ? now : new Date();
-    const diffMs = timeData - currentTime;
+    /** @type {number} */
+    const diffMs = timeData.getTime() - currentTime.getTime();
 
     switch (durationType) {
       case 'asMilliseconds':
@@ -56,6 +57,17 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
     seconds: index >= 0,
   };
 
+  /**
+   * @type {{
+   *   years: number|NaN,
+   *   months: number|NaN,
+   *   days: number|NaN,
+   *   hours: number|NaN,
+   *   minutes: number|NaN,
+   *   seconds: number|NaN,
+   *   total: number|NaN
+   * }}
+   */
   const parts = {
     years: include.years ? 0 : NaN,
     months: include.months ? 0 : NaN,
@@ -76,8 +88,11 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
     // Years
     if (include.years) {
       while (
-        new Date(workingDate.getFullYear() + 1, workingDate.getMonth(), workingDate.getDate()) <=
-        targetDate
+        new Date(
+          workingDate.getFullYear() + 1,
+          workingDate.getMonth(),
+          workingDate.getDate(),
+        ).getTime() <= targetDate.getTime()
       ) {
         workingDate.setFullYear(workingDate.getFullYear() + 1);
         parts.years++;
@@ -87,8 +102,11 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
     // Months
     if (include.months) {
       while (
-        new Date(workingDate.getFullYear(), workingDate.getMonth() + 1, workingDate.getDate()) <=
-        targetDate
+        new Date(
+          workingDate.getFullYear(),
+          workingDate.getMonth() + 1,
+          workingDate.getDate(),
+        ).getTime() <= targetDate.getTime()
       ) {
         workingDate.setMonth(workingDate.getMonth() + 1);
         parts.months++;
@@ -98,15 +116,18 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
     // Days
     if (include.days) {
       while (
-        new Date(workingDate.getFullYear(), workingDate.getMonth(), workingDate.getDate() + 1) <=
-        targetDate
+        new Date(
+          workingDate.getFullYear(),
+          workingDate.getMonth(),
+          workingDate.getDate() + 1,
+        ).getTime() <= targetDate.getTime()
       ) {
         workingDate.setDate(workingDate.getDate() + 1);
         parts.days++;
       }
     }
 
-    remaining = Math.floor((targetDate - workingDate) / 1000);
+    remaining = Math.floor((targetDate.getTime() - workingDate.getTime()) / 1000);
   }
 
   if (include.hours) {
@@ -135,7 +156,16 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
 
   parts.total = +(totalMap[level] || 0).toFixed(2).replace(/\.00$/, '');
 
-  const pad = (n) => (isNaN(n) ? 'NaN' : String(n).padStart(2, '0'));
+  /**
+   * Pads a number to ensure it is at least two digits long, using leading zeros if necessary.
+   *
+   * @param {number|string} n - The number or string to pad.
+   * @returns {string} The padded string.
+   */
+  const pad = (n) => {
+    const num = typeof n === 'string' ? parseInt(n) : n;
+    return Number.isNaN(num) ? 'NaN' : String(num).padStart(2, '0');
+  };
 
   const timeString = [
     include.hours ? pad(parts.hours) : null,
@@ -146,14 +176,14 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
     .join(':');
 
   return format
-    .replace(/\{years\}/g, parts.years)
-    .replace(/\{months\}/g, parts.months)
-    .replace(/\{days\}/g, parts.days)
+    .replace(/\{years\}/g, String(parts.years))
+    .replace(/\{months\}/g, String(parts.months))
+    .replace(/\{days\}/g, String(parts.days))
     .replace(/\{hours\}/g, pad(parts.hours))
     .replace(/\{minutes\}/g, pad(parts.minutes))
     .replace(/\{seconds\}/g, pad(parts.seconds))
     .replace(/\{time\}/g, timeString)
-    .replace(/\{total\}/g, parts.total)
+    .replace(/\{total\}/g, String(parts.total))
     .trim();
 }