tiny-essentials 1.8.5 → 1.9.1

package/dist/TinyRateLimiter.js

@@ -0,0 +1,236 @@
+/******/ (() => { // webpackBootstrap
+/******/ 	"use strict";
+/******/ 	// The require scope
+/******/ 	var __webpack_require__ = {};
+/******/ 	
+/************************************************************************/
+/******/ 	/* webpack/runtime/define property getters */
+/******/ 	(() => {
+/******/ 		// define getter functions for harmony exports
+/******/ 		__webpack_require__.d = (exports, definition) => {
+/******/ 			for(var key in definition) {
+/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
+/******/ 				}
+/******/ 			}
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
+/******/ 	(() => {
+/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+/******/ 	})();
+/******/ 	
+/************************************************************************/
+var __webpack_exports__ = {};
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  TinyRateLimiter: () => (/* reexport */ libs_TinyRateLimiter)
+});
+
+;// ./src/v1/libs/TinyRateLimiter.mjs
+/**
+ * Class representing a flexible rate limiter per user.
+ *
+ * This rate limiter can be configured by maximum number of hits,
+ * time interval, or a combination of both. It supports automatic
+ * cleanup of inactive users to optimize memory usage.
+ *
+ * @class
+ */
+class TinyRateLimiter {
+  /**
+   * @param {Object} options
+   * @param {number} [options.maxHits] - Max interactions allowed
+   * @param {number} [options.interval] - Time window in milliseconds
+   * @param {number} [options.cleanupInterval] - Interval for automatic cleanup (ms)
+   * @param {number} [options.maxIdle=300000] - Max idle time for a user before being cleaned (ms)
+   */
+  constructor({ maxHits, interval, cleanupInterval, maxIdle = 300000 }) {
+    /** @param {number|undefined} val */
+    const isPositiveInteger = (val) =>
+      typeof val === 'number' && Number.isFinite(val) && val >= 1 && Number.isInteger(val);
+
+    const isMaxHitsValid = isPositiveInteger(maxHits);
+    const isIntervalValid = isPositiveInteger(interval);
+    const isCleanupValid = isPositiveInteger(cleanupInterval);
+    const isMaxIdleValid = isPositiveInteger(maxIdle);
+
+    if (!isMaxHitsValid && !isIntervalValid)
+      throw new Error("RateLimiter requires at least one valid option: 'maxHits' or 'interval'.");
+    if (maxHits !== undefined && !isMaxHitsValid)
+      throw new Error("'maxHits' must be a positive integer if defined.");
+    if (interval !== undefined && !isIntervalValid)
+      throw new Error("'interval' must be a positive integer in milliseconds if defined.");
+    if (cleanupInterval !== undefined && !isCleanupValid)
+      throw new Error("'cleanupInterval' must be a positive integer in milliseconds if defined.");
+    if (!isMaxIdleValid) throw new Error("'maxIdle' must be a positive integer in milliseconds.");
+
+    this.maxHits = isMaxHitsValid ? maxHits : null;
+    this.interval = isIntervalValid ? interval : null;
+    this.cleanupInterval = isCleanupValid ? cleanupInterval : null;
+    this.maxIdle = maxIdle;
+
+    /** @type {Map<string, number[]>} */
+    this.userData = new Map();
+
+    /** @type {Map<string, number>} */
+    this.lastSeen = new Map();
+
+    // Start automatic cleanup only if cleanupInterval is valid
+    if (this.cleanupInterval !== null)
+      this._cleanupTimer = setInterval(() => this._cleanup(), this.cleanupInterval);
+  }
+
+  /**
+   * Get the interval window in milliseconds.
+   *
+   * @returns {number} The interval value.
+   * @throws {Error} If interval is not a valid finite number.
+   */
+  getInterval() {
+    if (typeof this.interval !== 'number' || !Number.isFinite(this.interval))
+      throw new Error("'interval' is not a valid finite number.");
+    return this.interval;
+  }
+
+  /**
+   * Get the maximum number of allowed hits.
+   *
+   * @returns {number} The maxHits value.
+   * @throws {Error} If maxHits is not a valid finite number.
+   */
+  getMaxHits() {
+    if (typeof this.maxHits !== 'number' || !Number.isFinite(this.maxHits)) {
+      throw new Error("'maxHits' is not a valid finite number.");
+    }
+    return this.maxHits;
+  }
+
+  /**
+   * Register a hit for a specific user
+   * @param {string} userId
+   */
+  hit(userId) {
+    const now = Date.now();
+
+    if (!this.userData.has(userId)) {
+      this.userData.set(userId, []);
+    }
+
+    const history = this.userData.get(userId);
+    if (!history) throw new Error(`No data found for userId: ${userId}`);
+
+    history.push(now);
+    this.lastSeen.set(userId, now);
+
+    // Clean up old entries
+    if (this.interval !== null) {
+      const interval = this.getInterval();
+      const cutoff = now - interval;
+      while (history.length && history[0] < cutoff) {
+        history.shift();
+      }
+    }
+
+    // Optional: keep only the last N entries for memory optimization
+    if (this.maxHits !== null) {
+      const maxHits = this.getMaxHits();
+      if (history.length > maxHits) {
+        history.splice(0, history.length - maxHits);
+      }
+    }
+  }
+
+  /**
+   * Check if the user is currently rate limited
+   * @param {string} userId
+   * @returns {boolean}
+   */
+  isRateLimited(userId) {
+    const now = Date.now();
+
+    if (!this.userData.has(userId)) return false;
+
+    const history = this.userData.get(userId);
+    if (!history) throw new Error(`No data found for userId: ${userId}`);
+
+    if (this.interval !== null) {
+      const interval = this.getInterval();
+      const recent = history.filter((t) => t > now - interval);
+      if (this.maxHits !== null) {
+        return recent.length >= this.getMaxHits();
+      }
+      return recent.length > 0;
+    }
+
+    if (this.maxHits !== null) {
+      return history.length >= this.getMaxHits();
+    }
+
+    return false;
+  }
+
+  /**
+   * Manually reset user data
+   * @param {string} userId
+   */
+  reset(userId) {
+    this.userData.delete(userId);
+    this.lastSeen.delete(userId);
+  }
+
+  /**
+   * Set hit timestamps for a user
+   * @param {string} userId
+   * @param {number[]} timestamps
+   */
+  setData(userId, timestamps) {
+    this.userData.set(userId, timestamps);
+    this.lastSeen.set(userId, Date.now());
+  }
+
+  /**
+   * Get timestamps from user
+   * @param {string} userId
+   * @returns {number[]}
+   */
+  getData(userId) {
+    return this.userData.get(userId) || [];
+  }
+
+  /**
+   * Cleanup old/inactive users
+   * @private
+   */
+  _cleanup() {
+    const now = Date.now();
+    for (const [userId, last] of this.lastSeen.entries()) {
+      if (now - last > this.maxIdle) {
+        this.userData.delete(userId);
+        this.lastSeen.delete(userId);
+      }
+    }
+  }
+
+  /**
+   * Destroy the rate limiter, stopping all intervals
+   */
+  destroy() {
+    if (this._cleanupTimer) clearInterval(this._cleanupTimer);
+    this.userData.clear();
+    this.lastSeen.clear();
+  }
+}
+
+/* harmony default export */ const libs_TinyRateLimiter = (TinyRateLimiter);
+
+;// ./src/v1/build/TinyRateLimiter.mjs
+
+
+
+
+window.TinyRateLimiter = __webpack_exports__.TinyRateLimiter;
+/******/ })()
+;

package/dist/TinyRateLimiter.min.js

@@ -0,0 +1 @@
+(()=>{"use strict";var t={d:(e,i)=>{for(var s in i)t.o(i,s)&&!t.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:i[s]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{TinyRateLimiter:()=>i});const i=class{constructor({maxHits:t,interval:e,cleanupInterval:i,maxIdle:s=3e5}){const r=t=>"number"==typeof t&&Number.isFinite(t)&&t>=1&&Number.isInteger(t),n=r(t),a=r(e),l=r(i),o=r(s);if(!n&&!a)throw new Error("RateLimiter requires at least one valid option: 'maxHits' or 'interval'.");if(void 0!==t&&!n)throw new Error("'maxHits' must be a positive integer if defined.");if(void 0!==e&&!a)throw new Error("'interval' must be a positive integer in milliseconds if defined.");if(void 0!==i&&!l)throw new Error("'cleanupInterval' must be a positive integer in milliseconds if defined.");if(!o)throw new Error("'maxIdle' must be a positive integer in milliseconds.");this.maxHits=n?t:null,this.interval=a?e:null,this.cleanupInterval=l?i:null,this.maxIdle=s,this.userData=new Map,this.lastSeen=new Map,null!==this.cleanupInterval&&(this._cleanupTimer=setInterval((()=>this._cleanup()),this.cleanupInterval))}getInterval(){if("number"!=typeof this.interval||!Number.isFinite(this.interval))throw new Error("'interval' is not a valid finite number.");return this.interval}getMaxHits(){if("number"!=typeof this.maxHits||!Number.isFinite(this.maxHits))throw new Error("'maxHits' is not a valid finite number.");return this.maxHits}hit(t){const e=Date.now();this.userData.has(t)||this.userData.set(t,[]);const i=this.userData.get(t);if(!i)throw new Error(`No data found for userId: ${t}`);if(i.push(e),this.lastSeen.set(t,e),null!==this.interval){const t=e-this.getInterval();for(;i.length&&i[0]<t;)i.shift()}if(null!==this.maxHits){const t=this.getMaxHits();i.length>t&&i.splice(0,i.length-t)}}isRateLimited(t){const e=Date.now();if(!this.userData.has(t))return!1;const i=this.userData.get(t);if(!i)throw new Error(`No data found for userId: ${t}`);if(null!==this.interval){const t=this.getInterval(),s=i.filter((i=>i>e-t));return null!==this.maxHits?s.length>=this.getMaxHits():s.length>0}return null!==this.maxHits&&i.length>=this.getMaxHits()}reset(t){this.userData.delete(t),this.lastSeen.delete(t)}setData(t,e){this.userData.set(t,e),this.lastSeen.set(t,Date.now())}getData(t){return this.userData.get(t)||[]}_cleanup(){const t=Date.now();for(const[e,i]of this.lastSeen.entries())t-i>this.maxIdle&&(this.userData.delete(e),this.lastSeen.delete(e))}destroy(){this._cleanupTimer&&clearInterval(this._cleanupTimer),this.userData.clear(),this.lastSeen.clear()}};window.TinyRateLimiter=e.TinyRateLimiter})();

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;
 

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