revbot.js 0.1.4 → 0.1.6

package/dist/index.d.mts

@@ -278,6 +278,10 @@ interface clientOptions {
         /** The number of retries for failed REST requests. */
         retries: number;
     };
+    MessageCache?: {
+        /** The maximum size of the cache. */
+        maxSize?: number;
+    };
     /** Configuration for WebSocket connections. */
     ws?: {
         /** The interval for sending heartbeats in milliseconds. */
@@ -2314,11 +2318,25 @@ declare abstract class BaseManager<Holds extends {
     id: string;
 }, R = unknown> {
     protected readonly client: client;
+    /** Shared default max size for all managers (can be changed globally). */
+    static defaultMaxSize: number;
+    /** Insertion ordered cache of items this manager holds. */
     readonly cache: Map<string, Holds>;
+    /** Instance level max size (can be changed per manager instance). */
+    protected maxSize: number;
     Holds: any;
-    constructor(client: client);
+    constructor(client: client, maxSize?: number);
+    /**
+     * Adds a raw object to the cache, constructing the holdable class.
+     * Automatically evicts oldest entries if the max size is exceeded.
+     */
     _add(raw: R): Holds;
+    /** Remove an entry by id. */
     _remove(id: string): void;
+    /** Adjust the maximum size for this manager at runtime. */
+    setMaxSize(size: number): void;
+    /** Force eviction until cache size is within the limit. */
+    protected enforceMaxSize(): void;
     abstract readonly holds: (new (...args: any[]) => Holds) | null;
     resolve(resolvable: Holds): Holds | null;
     resolve(resolvable: string | R): Holds | null;
@@ -2423,7 +2441,7 @@ interface MessageQueryOptions {
 declare class MessageManager extends BaseManager<MessageStruct, Message> {
     protected readonly channel: Channel;
     holds: typeof MessageStruct;
-    constructor(channel: Channel);
+    constructor(channel: Channel, maxSize?: number);
     /**
      *
      * @param content The content to send. Can be a string or an object with the following properties:

package/dist/index.d.ts

@@ -278,6 +278,10 @@ interface clientOptions {
         /** The number of retries for failed REST requests. */
         retries: number;
     };
+    MessageCache?: {
+        /** The maximum size of the cache. */
+        maxSize?: number;
+    };
     /** Configuration for WebSocket connections. */
     ws?: {
         /** The interval for sending heartbeats in milliseconds. */
@@ -2314,11 +2318,25 @@ declare abstract class BaseManager<Holds extends {
     id: string;
 }, R = unknown> {
     protected readonly client: client;
+    /** Shared default max size for all managers (can be changed globally). */
+    static defaultMaxSize: number;
+    /** Insertion ordered cache of items this manager holds. */
     readonly cache: Map<string, Holds>;
+    /** Instance level max size (can be changed per manager instance). */
+    protected maxSize: number;
     Holds: any;
-    constructor(client: client);
+    constructor(client: client, maxSize?: number);
+    /**
+     * Adds a raw object to the cache, constructing the holdable class.
+     * Automatically evicts oldest entries if the max size is exceeded.
+     */
     _add(raw: R): Holds;
+    /** Remove an entry by id. */
     _remove(id: string): void;
+    /** Adjust the maximum size for this manager at runtime. */
+    setMaxSize(size: number): void;
+    /** Force eviction until cache size is within the limit. */
+    protected enforceMaxSize(): void;
     abstract readonly holds: (new (...args: any[]) => Holds) | null;
     resolve(resolvable: Holds): Holds | null;
     resolve(resolvable: string | R): Holds | null;
@@ -2423,7 +2441,7 @@ interface MessageQueryOptions {
 declare class MessageManager extends BaseManager<MessageStruct, Message> {
     protected readonly channel: Channel;
     holds: typeof MessageStruct;
-    constructor(channel: Channel);
+    constructor(channel: Channel, maxSize?: number);
     /**
      *
      * @param content The content to send. Can be a string or an object with the following properties:

package/dist/index.js

@@ -158,20 +158,48 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/managers/baseManager.ts
-var BaseManager = class {
-  constructor(client3) {
+var _BaseManager = class _BaseManager {
+  constructor(client3, maxSize = _BaseManager.defaultMaxSize) {
     this.client = client3;
+    /** Insertion ordered cache of items this manager holds. */
     this.cache = /* @__PURE__ */ new Map();
+    this.maxSize = maxSize;
   }
+  /**
+   * Adds a raw object to the cache, constructing the holdable class.
+   * Automatically evicts oldest entries if the max size is exceeded.
+   */
   _add(raw) {
     if (!this.holds) throw new Error("Holds is not defined");
     const obj = new this.holds(this.client, raw);
     this.cache.set(obj.id, obj);
+    this.enforceMaxSize();
     return obj;
   }
+  /** Remove an entry by id. */
   _remove(id) {
     this.cache.delete(id);
   }
+  /** Adjust the maximum size for this manager at runtime. */
+  setMaxSize(size) {
+    if (!Number.isFinite(size) || size < -1)
+      throw new RangeError("maxSize must be a non-negative finite number");
+    this.maxSize = size;
+    this.enforceMaxSize();
+  }
+  /** Force eviction until cache size is within the limit. */
+  enforceMaxSize() {
+    if (this.maxSize === -1) return;
+    if (this.maxSize === 0) {
+      this.cache.clear();
+      return;
+    }
+    while (this.cache.size > this.maxSize) {
+      const oldestKey = this.cache.keys().next().value;
+      if (oldestKey === void 0) break;
+      this.cache.delete(oldestKey);
+    }
+  }
   resolve(resolvable) {
     var _a;
     const id = this.resolveId(resolvable);
@@ -191,6 +219,9 @@ var BaseManager = class {
     return this.cache;
   }
 };
+/** Shared default max size for all managers (can be changed globally). */
+_BaseManager.defaultMaxSize = -1;
+var BaseManager = _BaseManager;
 
 // src/utils/bitField.ts
 var DEFAULT_BIT = 0;
@@ -485,6 +516,9 @@ var DEFAULT_CLIENT_OPTIONS = {
     timeout: 15e3,
     retries: 3
   },
+  MessageCache: {
+    maxSize: 1e3
+  },
   ws: {
     heartbeatInterval: 3e4,
     reconnect: true
@@ -2733,8 +2767,8 @@ var import_stream2 = require("stream");
 var import_form_data2 = __toESM(require("form-data"));
 var import_axios2 = __toESM(require("axios"));
 var MessageManager = class extends BaseManager {
-  constructor(channel) {
-    super(channel.client);
+  constructor(channel, maxSize = 1e3) {
+    super(channel.client, maxSize);
     this.channel = channel;
     this.holds = MessageStruct;
   }
@@ -3243,7 +3277,7 @@ var import_node_events = require("events");
 var import_axios4 = require("axios");
 
 // package.json
-var version = "0.1.4";
+var version = "0.1.6";
 
 // src/rest/restUtils/rateLimitQueue.ts
 var import_axios3 = __toESM(require("axios"));