tiny-essentials 1.28.0 → 1.28.2

package/dist/v1/libs/TinyRateLimiter.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyRateLimiter');
 /**
  * Callback triggered when a group's stored hit history exceeds
  * the configured memory limit.
@@ -66,6 +68,19 @@
  * and safe to use in long-running Node.js processes.
  */
 class TinyRateLimiter {
+    /**
+     * Tracks whether the instance has been destroyed.
+     * @type {boolean}
+     */
+    #destroyed = false;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed() {
+        return this.#destroyed;
+    }
     /**
      * Maximum number of timestamps stored per group.
      * When exceeded, older entries are discarded.
@@ -170,6 +185,7 @@ class TinyRateLimiter {
      * @param {OnMemoryExceeded} callback
      */
     setOnMemoryExceeded(callback) {
+        checkDestroy(this.#destroyed);
         if (typeof callback !== 'function')
             throw new Error('onMemoryExceeded must be a function');
         this.#onMemoryExceeded = callback;
@@ -178,6 +194,7 @@ class TinyRateLimiter {
      * Removes the memory-exceeded callback.
      */
     clearOnMemoryExceeded() {
+        checkDestroy(this.#destroyed);
         this.#onMemoryExceeded = null;
     }
     /**
@@ -195,6 +212,7 @@ class TinyRateLimiter {
      * @param {OnGroupExpired} callback - A function that receives the expired groupId.
      */
     setOnGroupExpired(callback) {
+        checkDestroy(this.#destroyed);
         if (typeof callback !== 'function')
             throw new Error('onGroupExpired must be a function');
         this.#onGroupExpired = callback;
@@ -203,6 +221,7 @@ class TinyRateLimiter {
      * Removes the group-expiration callback.
      */
     clearOnGroupExpired() {
+        checkDestroy(this.#destroyed);
         this.#onGroupExpired = null;
     }
     /**
@@ -262,6 +281,7 @@ class TinyRateLimiter {
      * @returns {boolean}
      */
     isGroupId(id) {
+        checkDestroy(this.#destroyed);
         const result = this.groupFlags.get(id);
         return typeof result === 'boolean' ? result : false;
     }
@@ -271,6 +291,7 @@ class TinyRateLimiter {
      * @returns {string[]}
      */
     getUsersInGroup(groupId) {
+        checkDestroy(this.#destroyed);
         const users = [];
         for (const [userId, assignedGroup] of this.userToGroup.entries()) {
             if (assignedGroup === groupId) {
@@ -285,6 +306,7 @@ class TinyRateLimiter {
      * @param {number} ttl
      */
     setGroupTTL(groupId, ttl) {
+        checkDestroy(this.#destroyed);
         if (typeof ttl !== 'number' || !Number.isFinite(ttl) || ttl <= 0)
             throw new Error('TTL must be a positive number in milliseconds');
         this.groupTTL.set(groupId, ttl);
@@ -295,6 +317,7 @@ class TinyRateLimiter {
      * @returns {number|null}
      */
     getGroupTTL(groupId) {
+        checkDestroy(this.#destroyed);
         return this.groupTTL.get(groupId) ?? null;
     }
     /**
@@ -302,6 +325,7 @@ class TinyRateLimiter {
      * @param {string} groupId
      */
     deleteGroupTTL(groupId) {
+        checkDestroy(this.#destroyed);
         this.groupTTL.delete(groupId);
     }
     /**
@@ -315,6 +339,7 @@ class TinyRateLimiter {
      * @throws {Error} If the user belongs to another group
      */
     assignToGroup(userId, groupId) {
+        checkDestroy(this.#destroyed);
         const existingGroup = this.userToGroup.get(userId);
         if (existingGroup && existingGroup !== groupId)
             throw new Error(`User ${userId} is already assigned to group ${existingGroup}`);
@@ -363,6 +388,7 @@ class TinyRateLimiter {
      * @returns {string}
      */
     getGroupId(userId) {
+        checkDestroy(this.#destroyed);
         return this.userToGroup.get(userId) || userId; // fallback: use userId as own group
     }
     /**
@@ -388,6 +414,7 @@ class TinyRateLimiter {
      * @param {string} userId
      */
     hit(userId) {
+        checkDestroy(this.#destroyed);
         const groupId = this.getGroupId(userId);
         const now = Date.now();
         if (!this.groupData.has(groupId)) {
@@ -437,6 +464,7 @@ class TinyRateLimiter {
      * @returns {boolean}
      */
     isRateLimited(userId) {
+        checkDestroy(this.#destroyed);
         const groupId = this.getGroupId(userId);
         if (!this.groupData.has(groupId))
             return false;
@@ -468,6 +496,7 @@ class TinyRateLimiter {
      * @param {string} groupId
      */
     resetGroup(groupId) {
+        checkDestroy(this.#destroyed);
         this.groupFlags.delete(groupId);
         this.groupData.delete(groupId);
         this.lastSeen.delete(groupId);
@@ -478,6 +507,7 @@ class TinyRateLimiter {
      * @param {string} userId
      */
     resetUserGroup(userId) {
+        checkDestroy(this.#destroyed);
         this.userToGroup.delete(userId);
     }
     /**
@@ -486,6 +516,7 @@ class TinyRateLimiter {
      * @param {number[]} timestamps
      */
     setData(groupId, timestamps) {
+        checkDestroy(this.#destroyed);
         if (!Array.isArray(timestamps))
             throw new Error('timestamps must be an array of numbers.');
         for (const t of timestamps) {
@@ -504,6 +535,7 @@ class TinyRateLimiter {
      * @returns {boolean}
      */
     hasData(groupId) {
+        checkDestroy(this.#destroyed);
         return this.groupData.has(groupId);
     }
     /**
@@ -512,6 +544,7 @@ class TinyRateLimiter {
      * @returns {number[]}
      */
     getData(groupId) {
+        checkDestroy(this.#destroyed);
         return this.groupData.get(groupId) || [];
     }
     /**
@@ -519,6 +552,7 @@ class TinyRateLimiter {
      * @returns {number}
      */
     getMaxIdle() {
+        checkDestroy(this.#destroyed);
         if (typeof this.#maxIdle !== 'number' || !Number.isFinite(this.#maxIdle) || this.#maxIdle < 0) {
             throw new Error("'maxIdle' must be a non-negative finite number.");
         }
@@ -529,6 +563,7 @@ class TinyRateLimiter {
      * @param {number} ms
      */
     setMaxIdle(ms) {
+        checkDestroy(this.#destroyed);
         if (typeof ms !== 'number' || !Number.isFinite(ms) || ms < 0) {
             throw new Error("'maxIdle' must be a non-negative finite number.");
         }
@@ -559,6 +594,7 @@ class TinyRateLimiter {
      * @returns {string[]}
      */
     getActiveGroups() {
+        checkDestroy(this.#destroyed);
         return Array.from(this.groupData.keys());
     }
     /**
@@ -566,6 +602,7 @@ class TinyRateLimiter {
      * @returns {Record<string, string>}
      */
     getAllUserMappings() {
+        checkDestroy(this.#destroyed);
         return Object.fromEntries(this.userToGroup);
     }
     /**
@@ -577,6 +614,7 @@ class TinyRateLimiter {
      * @returns {number}
      */
     getInterval() {
+        checkDestroy(this.#destroyed);
         if (typeof this.#interval !== 'number' || !Number.isFinite(this.#interval)) {
             throw new Error("'interval' is not a valid finite number.");
         }
@@ -587,6 +625,7 @@ class TinyRateLimiter {
      * @returns {number}
      */
     getMaxHits() {
+        checkDestroy(this.#destroyed);
         if (typeof this.#maxHits !== 'number' || !Number.isFinite(this.#maxHits)) {
             throw new Error("'maxHits' is not a valid finite number.");
         }
@@ -598,6 +637,7 @@ class TinyRateLimiter {
      * @returns {number}
      */
     getTotalHits(groupId) {
+        checkDestroy(this.#destroyed);
         const history = this.groupData.get(groupId);
         return Array.isArray(history) ? history.length : 0;
     }
@@ -607,6 +647,7 @@ class TinyRateLimiter {
      * @returns {number|null}
      */
     getLastHit(groupId) {
+        checkDestroy(this.#destroyed);
         const history = this.groupData.get(groupId);
         return history?.length ? history[history.length - 1] : null;
     }
@@ -616,6 +657,7 @@ class TinyRateLimiter {
      * @returns {number|null}
      */
     getTimeSinceLastHit(groupId) {
+        checkDestroy(this.#destroyed);
         const last = this.getLastHit(groupId);
         return last !== null ? Date.now() - last : null;
     }
@@ -640,6 +682,7 @@ class TinyRateLimiter {
      * @returns {number|null}
      */
     getAverageHitSpacing(groupId) {
+        checkDestroy(this.#destroyed);
         return this._calculateAverageSpacing(this.groupData.get(groupId));
     }
     /**
@@ -653,6 +696,7 @@ class TinyRateLimiter {
      * }}
      */
     getMetrics(groupId) {
+        checkDestroy(this.#destroyed);
         const history = this.groupData.get(groupId);
         if (!Array.isArray(history) || history.length === 0) {
             return {
@@ -677,6 +721,8 @@ class TinyRateLimiter {
      * Destroy the rate limiter, stopping cleanup and clearing data
      */
     destroy() {
+        if (this.destroyed)
+            return;
         if (this.#cleanupTimer)
             clearInterval(this.#cleanupTimer);
         this._cleanup();
@@ -685,6 +731,8 @@ class TinyRateLimiter {
         this.userToGroup.clear();
         this.groupTTL.clear();
         this.groupFlags.clear();
+        // Lock the instance
+        this.#destroyed = true;
     }
 }
 export default TinyRateLimiter;

package/dist/v1/libs/TinySimpleDice.d.mts

@@ -1,24 +1,7 @@
-export default TinySimpleDice;
-/**
- * Represents a list of values used in dice modifier operations.
- *
- * Each entry can be either:
- * - A number (representing a fixed numeric value), or
- * - An object describing a dice roll, containing:
- *   - `value`: The rolled result.
- *   - `sides`: The number of sides of the die (e.g., 6 for a d6).
- *
- * Examples of valid entries:
- * - `5`                   → a direct numeric value
- * - `{ value: 3, sides: 6 }` → result of rolling a d6
- */
 export type DiceModifiersValues = (number | {
     value: number;
     sides: number;
 })[];
-/**
- * Represents the result after applying all dice modifiers to a roll.
- */
 export type ApplyDiceModifiersResult = {
     /**
      * - The final computed value after all modifiers and dice results are processed.
@@ -29,9 +12,6 @@ export type ApplyDiceModifiersResult = {
      */
     steps: ApplyDiceModifiersStep[];
 };
-/**
- * Represents a single step in the dice-modification process.
- */
 export type ApplyDiceModifiersStep = {
     /**
      * - The parsed tokens used in this step after normalization.
@@ -106,6 +86,7 @@ export type ApplyDiceModifiersStep = {
  * values suitable for indexing arrays or Sets.
  */
 declare class TinySimpleDice {
+    #private;
     /**
      * Safely evaluates a mathematical expression (supports +, -, *, /, %, **, parentheses, fractions and decimals).
      * This function ensures only valid math characters are processed.
@@ -222,16 +203,10 @@ declare class TinySimpleDice {
      */
     static rollArrayIndex(arr: any[] | Set<any>): number;
     /**
-     * Creates a new TinySimpleDice instance.
-     * @param {Object} options - Configuration options for the dice.
-     * @param {number} options.maxValue - Maximum value the dice can roll.
-     * @param {boolean} [options.allowZero=true] - Whether 0 is allowed as a result.
-     * @throws {TypeError} If maxValue is not a non-negative integer or allowZero is not boolean.
+     * Maximum value the dice can roll.
+     * @type {number}
      */
-    constructor({ maxValue, allowZero }: {
-        maxValue: number;
-        allowZero?: boolean | undefined;
-    });
+    get maxValue(): number;
     /**
      * Set the maximum value the dice can roll.
      * @param {number} value - New maximum value (must be a non-negative integer)
@@ -239,10 +214,10 @@ declare class TinySimpleDice {
      */
     set maxValue(value: number);
     /**
-     * Maximum value the dice can roll.
-     * @type {number}
+     * Whether 0 is allowed as a result.
+     * @type {boolean}
      */
-    get maxValue(): number;
+    get allowZero(): boolean;
     /**
      * Set whether 0 is allowed as a result.
      * @param {boolean} value - true to allow 0, false to disallow
@@ -250,15 +225,21 @@ declare class TinySimpleDice {
      */
     set allowZero(value: boolean);
     /**
-     * Whether 0 is allowed as a result.
-     * @type {boolean}
+     * Creates a new TinySimpleDice instance.
+     * @param {Object} options - Configuration options for the dice.
+     * @param {number} options.maxValue - Maximum value the dice can roll.
+     * @param {boolean} [options.allowZero=true] - Whether 0 is allowed as a result.
+     * @throws {TypeError} If maxValue is not a non-negative integer or allowZero is not boolean.
      */
-    get allowZero(): boolean;
+    constructor({ maxValue, allowZero }: {
+        maxValue: number;
+        allowZero?: boolean;
+    });
     /**
      * Rolls the dice according to the configuration.
      * @returns {number} - Random number according to the dice configuration.
      */
     roll(): number;
-    #private;
 }
+export default TinySimpleDice;
 //# sourceMappingURL=TinySimpleDice.d.mts.map