@stimulcross/rate-limiter 0.0.6 → 0.0.8

package/lib/interfaces/rate-limiter-run-options.d.ts

@@ -48,5 +48,11 @@ export interface RateLimiterRunOptions {
      * @default Infinity
      */
     maxWaitMs?: number;
+    /**
+     * Forces the task to be enqueued even if the queue has reached maximum capacity.
+     *
+     * @default false
+     */
+    shouldForceEnqueue?: boolean;
 }
 //# sourceMappingURL=rate-limiter-run-options.d.ts.map

package/lib/limiters/abstract-rate-limiter.d.ts

@@ -18,6 +18,7 @@ export interface ExecutionContext {
     readonly priority?: Priority;
     readonly signal?: AbortSignal;
     readonly maxWaitMs?: number;
+    readonly shouldForceEnqueue?: boolean;
 }
 /** @internal */
 export declare abstract class AbstractRateLimiter<TState extends object, TStatus extends RateLimiterStatus | RateLimiterStatus[], TResult = unknown> implements RateLimiter<TStatus> {

package/lib/limiters/abstract-rate-limiter.js

@@ -18,7 +18,7 @@ export class AbstractRateLimiter {
     _generateId;
     _isDestroyed = false;
     constructor(options) {
-        this._logger = createLogger({ context: new.target.name, minLevel: 'WARNING', ...options?.loggerOptions });
+        this._logger = createLogger({ context: new.target.name, ...options?.loggerOptions });
         this._clock = options?.clock ?? defaultClock;
         this._store = options?.store ?? new InMemoryStateStore(this._clock);
         this._executor = new RateLimiterExecutor(this._logger, this._clock, options?.queue);
@@ -37,6 +37,7 @@ export class AbstractRateLimiter {
             priority: options.priority,
             signal: options.signal,
             maxWaitMs: options.maxWaitMs,
+            shouldForceEnqueue: options.shouldForceEnqueue,
         };
         await this._ensureCanExecute(ctx);
         return await this._runInternal(fn, ctx);
@@ -79,6 +80,7 @@ export class AbstractRateLimiter {
                 priority: ctx.priority,
                 signal: ctx.signal,
                 expiresAt,
+                shouldForceEnqueue: ctx.shouldForceEnqueue,
             });
         }
         catch (e) {
@@ -107,7 +109,7 @@ export class AbstractRateLimiter {
         return e instanceof RateLimitError && e.code !== RateLimitErrorCode.LimitExceeded;
     }
     async _ensureCanExecute(ctx) {
-        if (this._executor.isQueueFull) {
+        if (this._executor.isQueueFull && !ctx.shouldForceEnqueue) {
             this._shouldPrintDebug &&
                 this._logger.debug(`[DROP OVERFLOW] [id: ${ctx.id}, key: ${ctx.key}] - prt: ${ctx.priority ?? Priority.Normal} | q: ${this._executor.queueSize}/${this._executor.queueCapacity}`);
             let retryAt;

package/lib/limiters/http-response-based/http-response-based.limiter.js

@@ -45,7 +45,7 @@ export class HttpResponseBasedLimiter {
     _fallbackResetDelayMs;
     _isDestroyed = false;
     constructor(options) {
-        this._logger = createLogger({ context: new.target.name, minLevel: 'WARNING', ...options.loggerOptions });
+        this._logger = createLogger({ context: new.target.name, ...options.loggerOptions });
         this._clock = options.clock ?? defaultClock;
         this._store = options.store ?? new InMemoryStateStore(this._clock);
         this._executor = new RateLimiterExecutor(this._logger, this._clock, options.queue);

package/lib/runtime/rate-limiter.executor.d.ts

@@ -8,6 +8,7 @@ export interface RateLimiterExecutionOptions {
     expiresAt?: number;
     priority?: number;
     signal?: AbortSignal;
+    shouldForceEnqueue?: boolean;
 }
 /** @internal */
 export interface RateLimiterExecutorQueueOptions {

package/lib/runtime/rate-limiter.executor.js

@@ -46,8 +46,13 @@ export class RateLimiterExecutor {
                 priorityQueue.remove(task);
                 this._drain();
             });
+        const isEnqueued = this._queue.enqueue(task, task.priority, options.shouldForceEnqueue);
+        if (!isEnqueued) {
+            this._shouldPrintDebug &&
+                this._logger.debug(`[DROP OVERFLOW] [id: ${options.id}, key: ${options.key}] - ${this._getStateDebugString(task.priority)}`);
+            throw new RateLimitError(RateLimitErrorCode.QueueOverflow);
+        }
         this._tickets.add(runAt);
-        this._queue.enqueue(task, task.priority);
         if (task.expiresAt !== undefined) {
             this._expiryHeap.push(task);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stimulcross/rate-limiter",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "A collection of client-side rate limiters for Node.js and browsers.",
   "type": "module",
   "engines": {
@@ -56,7 +56,6 @@
     "@commitlint/cli": "^20.4.4",
     "@leancodepl/resolve-eslint-flat-config": "^9.7.4",
     "@stimulcross/commitlint-config": "^2.0.0",
-    "@stimulcross/eslint-config-node": "^2.0.0",
     "@stimulcross/eslint-config-typescript": "^2.0.0",
     "@stimulcross/prettier-config": "^2.0.0",
     "@types/node": "^25.5.0",