@zeitar/throttle 1.0.0

package/dist/errors/ReserveNotSupportedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReserveNotSupportedError.d.ts","sourceRoot":"","sources":["../../src/errors/ReserveNotSupportedError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAK5B"}

package/dist/errors/ReserveNotSupportedError.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReserveNotSupportedError = void 0;
+/**
+ * Thrown when reserve() is called on a limiter that doesn't support reservations.
+ *
+ * Some limiters (like CompoundLimiter) don't support the reserve pattern and will
+ * throw this exception if reserve() is called.
+ */
+class ReserveNotSupportedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ReserveNotSupportedError';
+        Object.setPrototypeOf(this, ReserveNotSupportedError.prototype);
+    }
+}
+exports.ReserveNotSupportedError = ReserveNotSupportedError;
+//# sourceMappingURL=ReserveNotSupportedError.js.map

package/dist/errors/ReserveNotSupportedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReserveNotSupportedError.js","sourceRoot":"","sources":["../../src/errors/ReserveNotSupportedError.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAND,4DAMC"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @throttle - TypeScript Rate Limiter Library
+ *
+ * A production-ready rate limiting library supporting multiple algorithms:
+ * - Token Bucket: Allows bursts with steady refill rate
+ * - Fixed Window: Simple window-based limiting
+ * - Sliding Window: Smoothed rate limiting across window boundaries
+ * - No Limit: Pass-through for testing/conditional scenarios
+ */
+export type { LimiterInterface } from './LimiterInterface';
+export type { LimiterStateInterface } from './LimiterStateInterface';
+export type { RateLimiterFactoryInterface } from './RateLimiterFactoryInterface';
+export { RateLimit } from './RateLimit';
+export { Reservation } from './Reservation';
+export { RateLimiterFactory, type RateLimiterConfig, type TokenBucketConfig, type FixedWindowConfig, type SlidingWindowConfig, type NoLimitConfig, } from './RateLimiterFactory';
+export { CompoundRateLimiterFactory } from './CompoundRateLimiterFactory';
+export { CompoundLimiter } from './CompoundLimiter';
+export type { StorageInterface } from './storage/StorageInterface';
+export { InMemoryStorage } from './storage/InMemoryStorage';
+export type { LockInterface } from './storage/LockInterface';
+export { NoLock } from './storage/LockInterface';
+export { Rate } from './policy/Rate';
+export { TokenBucket } from './policy/TokenBucket';
+export { TokenBucketLimiter } from './policy/TokenBucketLimiter';
+export { Window } from './policy/Window';
+export { FixedWindowLimiter } from './policy/FixedWindowLimiter';
+export { SlidingWindow } from './policy/SlidingWindow';
+export { SlidingWindowLimiter } from './policy/SlidingWindowLimiter';
+export { NoLimiter } from './policy/NoLimiter';
+export { InvalidIntervalError } from './errors/InvalidIntervalError';
+export { MaxWaitDurationExceededError } from './errors/MaxWaitDurationExceededError';
+export { RateLimitExceededError } from './errors/RateLimitExceededError';
+export { ReserveNotSupportedError } from './errors/ReserveNotSupportedError';
+export { TimeUtil } from './util/TimeUtil';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAGjF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * @throttle - TypeScript Rate Limiter Library
+ *
+ * A production-ready rate limiting library supporting multiple algorithms:
+ * - Token Bucket: Allows bursts with steady refill rate
+ * - Fixed Window: Simple window-based limiting
+ * - Sliding Window: Smoothed rate limiting across window boundaries
+ * - No Limit: Pass-through for testing/conditional scenarios
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeUtil = exports.ReserveNotSupportedError = exports.RateLimitExceededError = exports.MaxWaitDurationExceededError = exports.InvalidIntervalError = exports.NoLimiter = exports.SlidingWindowLimiter = exports.SlidingWindow = exports.FixedWindowLimiter = exports.Window = exports.TokenBucketLimiter = exports.TokenBucket = exports.Rate = exports.NoLock = exports.InMemoryStorage = exports.CompoundLimiter = exports.CompoundRateLimiterFactory = exports.RateLimiterFactory = exports.Reservation = exports.RateLimit = void 0;
+// Core classes
+var RateLimit_1 = require("./RateLimit");
+Object.defineProperty(exports, "RateLimit", { enumerable: true, get: function () { return RateLimit_1.RateLimit; } });
+var Reservation_1 = require("./Reservation");
+Object.defineProperty(exports, "Reservation", { enumerable: true, get: function () { return Reservation_1.Reservation; } });
+// Factories
+var RateLimiterFactory_1 = require("./RateLimiterFactory");
+Object.defineProperty(exports, "RateLimiterFactory", { enumerable: true, get: function () { return RateLimiterFactory_1.RateLimiterFactory; } });
+var CompoundRateLimiterFactory_1 = require("./CompoundRateLimiterFactory");
+Object.defineProperty(exports, "CompoundRateLimiterFactory", { enumerable: true, get: function () { return CompoundRateLimiterFactory_1.CompoundRateLimiterFactory; } });
+var CompoundLimiter_1 = require("./CompoundLimiter");
+Object.defineProperty(exports, "CompoundLimiter", { enumerable: true, get: function () { return CompoundLimiter_1.CompoundLimiter; } });
+var InMemoryStorage_1 = require("./storage/InMemoryStorage");
+Object.defineProperty(exports, "InMemoryStorage", { enumerable: true, get: function () { return InMemoryStorage_1.InMemoryStorage; } });
+var LockInterface_1 = require("./storage/LockInterface");
+Object.defineProperty(exports, "NoLock", { enumerable: true, get: function () { return LockInterface_1.NoLock; } });
+// Policy implementations
+var Rate_1 = require("./policy/Rate");
+Object.defineProperty(exports, "Rate", { enumerable: true, get: function () { return Rate_1.Rate; } });
+var TokenBucket_1 = require("./policy/TokenBucket");
+Object.defineProperty(exports, "TokenBucket", { enumerable: true, get: function () { return TokenBucket_1.TokenBucket; } });
+var TokenBucketLimiter_1 = require("./policy/TokenBucketLimiter");
+Object.defineProperty(exports, "TokenBucketLimiter", { enumerable: true, get: function () { return TokenBucketLimiter_1.TokenBucketLimiter; } });
+var Window_1 = require("./policy/Window");
+Object.defineProperty(exports, "Window", { enumerable: true, get: function () { return Window_1.Window; } });
+var FixedWindowLimiter_1 = require("./policy/FixedWindowLimiter");
+Object.defineProperty(exports, "FixedWindowLimiter", { enumerable: true, get: function () { return FixedWindowLimiter_1.FixedWindowLimiter; } });
+var SlidingWindow_1 = require("./policy/SlidingWindow");
+Object.defineProperty(exports, "SlidingWindow", { enumerable: true, get: function () { return SlidingWindow_1.SlidingWindow; } });
+var SlidingWindowLimiter_1 = require("./policy/SlidingWindowLimiter");
+Object.defineProperty(exports, "SlidingWindowLimiter", { enumerable: true, get: function () { return SlidingWindowLimiter_1.SlidingWindowLimiter; } });
+var NoLimiter_1 = require("./policy/NoLimiter");
+Object.defineProperty(exports, "NoLimiter", { enumerable: true, get: function () { return NoLimiter_1.NoLimiter; } });
+// Exceptions
+var InvalidIntervalError_1 = require("./errors/InvalidIntervalError");
+Object.defineProperty(exports, "InvalidIntervalError", { enumerable: true, get: function () { return InvalidIntervalError_1.InvalidIntervalError; } });
+var MaxWaitDurationExceededError_1 = require("./errors/MaxWaitDurationExceededError");
+Object.defineProperty(exports, "MaxWaitDurationExceededError", { enumerable: true, get: function () { return MaxWaitDurationExceededError_1.MaxWaitDurationExceededError; } });
+var RateLimitExceededError_1 = require("./errors/RateLimitExceededError");
+Object.defineProperty(exports, "RateLimitExceededError", { enumerable: true, get: function () { return RateLimitExceededError_1.RateLimitExceededError; } });
+var ReserveNotSupportedError_1 = require("./errors/ReserveNotSupportedError");
+Object.defineProperty(exports, "ReserveNotSupportedError", { enumerable: true, get: function () { return ReserveNotSupportedError_1.ReserveNotSupportedError; } });
+// Utilities
+var TimeUtil_1 = require("./util/TimeUtil");
+Object.defineProperty(exports, "TimeUtil", { enumerable: true, get: function () { return TimeUtil_1.TimeUtil; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAOH,eAAe;AACf,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAEpB,YAAY;AACZ,2DAO8B;AAN5B,wHAAA,kBAAkB,OAAA;AAOpB,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AACnC,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAIxB,6DAA4D;AAAnD,kHAAA,eAAe,OAAA;AAExB,yDAAiD;AAAxC,uGAAA,MAAM,OAAA;AAEf,yBAAyB;AACzB,sCAAqC;AAA5B,4FAAA,IAAI,OAAA;AACb,oDAAmD;AAA1C,0GAAA,WAAW,OAAA;AACpB,kEAAiE;AAAxD,wHAAA,kBAAkB,OAAA;AAC3B,0CAAyC;AAAhC,gGAAA,MAAM,OAAA;AACf,kEAAiE;AAAxD,wHAAA,kBAAkB,OAAA;AAC3B,wDAAuD;AAA9C,8GAAA,aAAa,OAAA;AACtB,sEAAqE;AAA5D,4HAAA,oBAAoB,OAAA;AAC7B,gDAA+C;AAAtC,sGAAA,SAAS,OAAA;AAElB,aAAa;AACb,sEAAqE;AAA5D,4HAAA,oBAAoB,OAAA;AAC7B,sFAAqF;AAA5E,4IAAA,4BAA4B,OAAA;AACrC,0EAAyE;AAAhE,gIAAA,sBAAsB,OAAA;AAC/B,8EAA6E;AAApE,oIAAA,wBAAwB,OAAA;AAEjC,YAAY;AACZ,4CAA2C;AAAlC,oGAAA,QAAQ,OAAA"}

package/dist/policy/FixedWindowLimiter.d.ts

@@ -0,0 +1,36 @@
+import type { LimiterInterface } from '../LimiterInterface';
+import type { StorageInterface } from '../storage/StorageInterface';
+import type { LockInterface } from '../storage/LockInterface';
+import { RateLimit } from '../RateLimit';
+import { Reservation } from '../Reservation';
+/**
+ * Fixed window rate limiter implementation.
+ *
+ * Divides time into fixed windows and counts hits within each window.
+ * Simple and efficient, but can allow bursts at window boundaries.
+ */
+export declare class FixedWindowLimiter implements LimiterInterface {
+    private readonly id;
+    private readonly limit;
+    private readonly intervalInSeconds;
+    private readonly storage;
+    private readonly lock;
+    constructor(id: string, limit: number, intervalInSeconds: number, storage: StorageInterface, lock?: LockInterface);
+    /**
+     * Reserve tokens with optional maximum wait time.
+     */
+    reserve(tokens?: number, maxTime?: number | null): Promise<Reservation>;
+    /**
+     * Try to consume tokens immediately.
+     */
+    consume(tokens?: number): Promise<RateLimit>;
+    /**
+     * Reset the rate limiter state.
+     */
+    reset(): Promise<void>;
+    /**
+     * Get existing window or create a new one.
+     */
+    private getOrCreateWindow;
+}
+//# sourceMappingURL=FixedWindowLimiter.d.ts.map

package/dist/policy/FixedWindowLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedWindowLimiter.d.ts","sourceRoot":"","sources":["../../src/policy/FixedWindowLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAGnC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,gBAAgB,EACzB,IAAI,CAAC,EAAE,aAAa;IAStB;;OAEG;IACG,OAAO,CAAC,MAAM,GAAE,MAAU,EAAE,OAAO,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAoDtF;;OAEG;IACG,OAAO,CAAC,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IA4BrD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;YACW,iBAAiB;CAWhC"}

package/dist/policy/FixedWindowLimiter.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixedWindowLimiter = void 0;
+const RateLimit_1 = require("../RateLimit");
+const Reservation_1 = require("../Reservation");
+const MaxWaitDurationExceededError_1 = require("../errors/MaxWaitDurationExceededError");
+const Window_1 = require("./Window");
+const TimeUtil_1 = require("../util/TimeUtil");
+const LockInterface_1 = require("../storage/LockInterface");
+/**
+ * Fixed window rate limiter implementation.
+ *
+ * Divides time into fixed windows and counts hits within each window.
+ * Simple and efficient, but can allow bursts at window boundaries.
+ */
+class FixedWindowLimiter {
+    constructor(id, limit, intervalInSeconds, storage, lock) {
+        this.id = id;
+        this.limit = limit;
+        this.intervalInSeconds = intervalInSeconds;
+        this.storage = storage;
+        this.lock = lock ?? new LockInterface_1.NoLock();
+    }
+    /**
+     * Reserve tokens with optional maximum wait time.
+     */
+    async reserve(tokens = 1, maxTime = null) {
+        return this.lock.withLock(this.id, async () => {
+            const now = TimeUtil_1.TimeUtil.now();
+            const window = await this.getOrCreateWindow(now);
+            const availableTokens = window.getAvailableTokens(now);
+            if (tokens > this.limit) {
+                throw new Error(`Cannot reserve ${tokens} tokens, limit is ${this.limit}`);
+            }
+            let timeToAct;
+            let waitTime;
+            if (availableTokens >= tokens) {
+                // Tokens available now
+                timeToAct = now;
+                waitTime = 0;
+                window.add(tokens, now);
+            }
+            else {
+                // Need to wait for next window
+                const windowEnd = window.getTimer() + this.intervalInSeconds;
+                waitTime = windowEnd - now;
+                timeToAct = windowEnd;
+            }
+            // Check max wait time
+            if (maxTime !== null && waitTime > maxTime) {
+                const retryAfter = new Date((now + waitTime) * 1000);
+                const rateLimit = new RateLimit_1.RateLimit(availableTokens, retryAfter, false, this.limit);
+                throw new MaxWaitDurationExceededError_1.MaxWaitDurationExceededError(`Cannot reserve ${tokens} tokens within ${maxTime} seconds`, rateLimit);
+            }
+            await this.storage.save(window);
+            const retryAfter = new Date(timeToAct * 1000);
+            const rateLimit = new RateLimit_1.RateLimit(Math.max(0, availableTokens - tokens), retryAfter, true, this.limit);
+            return new Reservation_1.Reservation(timeToAct * 1000, rateLimit); // Convert to ms
+        });
+    }
+    /**
+     * Try to consume tokens immediately.
+     */
+    async consume(tokens = 1) {
+        return this.lock.withLock(this.id, async () => {
+            const now = TimeUtil_1.TimeUtil.now();
+            const window = await this.getOrCreateWindow(now);
+            const availableTokens = window.getAvailableTokens(now);
+            if (availableTokens >= tokens) {
+                // Success
+                window.add(tokens, now);
+                await this.storage.save(window);
+                return new RateLimit_1.RateLimit(availableTokens - tokens, new Date(now * 1000), true, this.limit);
+            }
+            else {
+                // Rate limit exceeded - need to wait for next window
+                const waitTime = window.calculateTimeForTokens(tokens, now);
+                const retryAfter = new Date((now + waitTime) * 1000);
+                return new RateLimit_1.RateLimit(availableTokens, retryAfter, false, this.limit);
+            }
+        });
+    }
+    /**
+     * Reset the rate limiter state.
+     */
+    async reset() {
+        await this.lock.withLock(this.id, async () => {
+            await this.storage.delete(this.id);
+        });
+    }
+    /**
+     * Get existing window or create a new one.
+     */
+    async getOrCreateWindow(now) {
+        const state = await this.storage.fetch(this.id);
+        if (state instanceof Window_1.Window) {
+            return state;
+        }
+        // Create new window aligned to interval boundary
+        const windowStart = Math.floor(now / this.intervalInSeconds) * this.intervalInSeconds;
+        return new Window_1.Window(this.id, this.intervalInSeconds, this.limit, 0, windowStart);
+    }
+}
+exports.FixedWindowLimiter = FixedWindowLimiter;
+//# sourceMappingURL=FixedWindowLimiter.js.map

package/dist/policy/FixedWindowLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedWindowLimiter.js","sourceRoot":"","sources":["../../src/policy/FixedWindowLimiter.ts"],"names":[],"mappings":"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"}

package/dist/policy/NoLimiter.d.ts

@@ -0,0 +1,23 @@
+import type { LimiterInterface } from '../LimiterInterface';
+import { RateLimit } from '../RateLimit';
+import { Reservation } from '../Reservation';
+/**
+ * No-op rate limiter that always accepts requests.
+ *
+ * Useful for testing, feature flags, or conditional rate limiting scenarios.
+ */
+export declare class NoLimiter implements LimiterInterface {
+    /**
+     * Always returns an immediate reservation with maximum tokens.
+     */
+    reserve(_tokens?: number, _maxTime?: number | null): Promise<Reservation>;
+    /**
+     * Always returns an accepted rate limit with maximum tokens.
+     */
+    consume(_tokens?: number): Promise<RateLimit>;
+    /**
+     * No-op reset (nothing to reset).
+     */
+    reset(): Promise<void>;
+}
+//# sourceMappingURL=NoLimiter.d.ts.map

package/dist/policy/NoLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoLimiter.d.ts","sourceRoot":"","sources":["../../src/policy/NoLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,SAAU,YAAW,gBAAgB;IAChD;;OAEG;IACG,OAAO,CAAC,OAAO,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAWxF;;OAEG;IACG,OAAO,CAAC,OAAO,GAAE,MAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAStD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/policy/NoLimiter.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoLimiter = void 0;
+const RateLimit_1 = require("../RateLimit");
+const Reservation_1 = require("../Reservation");
+/**
+ * No-op rate limiter that always accepts requests.
+ *
+ * Useful for testing, feature flags, or conditional rate limiting scenarios.
+ */
+class NoLimiter {
+    /**
+     * Always returns an immediate reservation with maximum tokens.
+     */
+    async reserve(_tokens = 1, _maxTime = null) {
+        const now = Date.now();
+        const rateLimit = new RateLimit_1.RateLimit(Number.MAX_SAFE_INTEGER, new Date(now), true, Number.MAX_SAFE_INTEGER);
+        return new Reservation_1.Reservation(now, rateLimit);
+    }
+    /**
+     * Always returns an accepted rate limit with maximum tokens.
+     */
+    async consume(_tokens = 1) {
+        return new RateLimit_1.RateLimit(Number.MAX_SAFE_INTEGER, new Date(), true, Number.MAX_SAFE_INTEGER);
+    }
+    /**
+     * No-op reset (nothing to reset).
+     */
+    async reset() {
+        // No-op
+    }
+}
+exports.NoLimiter = NoLimiter;
+//# sourceMappingURL=NoLimiter.js.map

package/dist/policy/NoLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoLimiter.js","sourceRoot":"","sources":["../../src/policy/NoLimiter.ts"],"names":[],"mappings":";;;AACA,4CAAyC;AACzC,gDAA6C;AAE7C;;;;GAIG;AACH,MAAa,SAAS;IACpB;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB,CAAC,EAAE,WAA0B,IAAI;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,qBAAS,CAC7B,MAAM,CAAC,gBAAgB,EACvB,IAAI,IAAI,CAAC,GAAG,CAAC,EACb,IAAI,EACJ,MAAM,CAAC,gBAAgB,CACxB,CAAC;QACF,OAAO,IAAI,yBAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB,CAAC;QAC/B,OAAO,IAAI,qBAAS,CAClB,MAAM,CAAC,gBAAgB,EACvB,IAAI,IAAI,EAAE,EACV,IAAI,EACJ,MAAM,CAAC,gBAAgB,CACxB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,QAAQ;IACV,CAAC;CACF;AAjCD,8BAiCC"}

package/dist/policy/Rate.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Configuration object for token bucket refill rates.
+ *
+ * Defines how many tokens are added per time interval.
+ */
+export declare class Rate {
+    private readonly intervalInSeconds;
+    private readonly amount;
+    constructor(intervalInSeconds: number, amount: number);
+    /**
+     * Get the interval in seconds.
+     */
+    getInterval(): number;
+    /**
+     * Get the amount of tokens per interval.
+     */
+    getAmount(): number;
+    /**
+     * Create a rate of N tokens per second.
+     */
+    static perSecond(amount: number): Rate;
+    /**
+     * Create a rate of N tokens per minute.
+     */
+    static perMinute(amount: number): Rate;
+    /**
+     * Create a rate of N tokens per hour.
+     */
+    static perHour(amount: number): Rate;
+    /**
+     * Create a rate of N tokens per day.
+     */
+    static perDay(amount: number): Rate;
+    /**
+     * Create a rate of N tokens per week.
+     */
+    static perWeek(amount: number): Rate;
+    /**
+     * Create a rate of N tokens per month (30 days).
+     */
+    static perMonth(amount: number): Rate;
+    /**
+     * Create a rate of N tokens per year (365 days).
+     */
+    static perYear(amount: number): Rate;
+    /**
+     * Create a rate from a string like "1 hour-100" or "60 seconds-5".
+     *
+     * Format: "{interval}-{amount}" where interval is a duration string.
+     */
+    static fromString(rateString: string): Rate;
+    /**
+     * Calculate the time (in seconds) needed to accumulate N tokens.
+     */
+    calculateTimeForTokens(tokens: number): number;
+    /**
+     * Calculate when the next token will be available.
+     */
+    calculateNextTokenAvailability(now?: number): Date;
+    /**
+     * Calculate how many new tokens are added during a given duration.
+     */
+    calculateNewTokensDuringInterval(durationInSeconds: number): number;
+    /**
+     * Calculate the refill interval (time per token in seconds).
+     */
+    getRefillInterval(): number;
+}
+//# sourceMappingURL=Rate.d.ts.map

package/dist/policy/Rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rate.d.ts","sourceRoot":"","sources":["../../src/policy/Rate.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAiBrD;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAmB3C;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9C;;OAEG;IACH,8BAA8B,CAAC,GAAG,GAAE,MAAuB,GAAG,IAAI;IAKlE;;OAEG;IACH,gCAAgC,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM;IAInE;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B"}

package/dist/policy/Rate.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Rate = void 0;
+const InvalidIntervalError_1 = require("../errors/InvalidIntervalError");
+const TimeUtil_1 = require("../util/TimeUtil");
+/**
+ * Configuration object for token bucket refill rates.
+ *
+ * Defines how many tokens are added per time interval.
+ */
+class Rate {
+    constructor(intervalInSeconds, amount) {
+        if (intervalInSeconds < 1) {
+            throw new InvalidIntervalError_1.InvalidIntervalError(`Interval must be at least 1 second, got ${intervalInSeconds}`);
+        }
+        if (amount < 1) {
+            throw new InvalidIntervalError_1.InvalidIntervalError(`Amount must be at least 1, got ${amount}`);
+        }
+        this.intervalInSeconds = intervalInSeconds;
+        this.amount = amount;
+    }
+    /**
+     * Get the interval in seconds.
+     */
+    getInterval() {
+        return this.intervalInSeconds;
+    }
+    /**
+     * Get the amount of tokens per interval.
+     */
+    getAmount() {
+        return this.amount;
+    }
+    /**
+     * Create a rate of N tokens per second.
+     */
+    static perSecond(amount) {
+        return new Rate(1, amount);
+    }
+    /**
+     * Create a rate of N tokens per minute.
+     */
+    static perMinute(amount) {
+        return new Rate(60, amount);
+    }
+    /**
+     * Create a rate of N tokens per hour.
+     */
+    static perHour(amount) {
+        return new Rate(3600, amount);
+    }
+    /**
+     * Create a rate of N tokens per day.
+     */
+    static perDay(amount) {
+        return new Rate(86400, amount);
+    }
+    /**
+     * Create a rate of N tokens per week.
+     */
+    static perWeek(amount) {
+        return new Rate(604800, amount);
+    }
+    /**
+     * Create a rate of N tokens per month (30 days).
+     */
+    static perMonth(amount) {
+        return new Rate(2592000, amount);
+    }
+    /**
+     * Create a rate of N tokens per year (365 days).
+     */
+    static perYear(amount) {
+        return new Rate(31536000, amount);
+    }
+    /**
+     * Create a rate from a string like "1 hour-100" or "60 seconds-5".
+     *
+     * Format: "{interval}-{amount}" where interval is a duration string.
+     */
+    static fromString(rateString) {
+        const parts = rateString.split('-');
+        if (parts.length !== 2) {
+            throw new Error(`Invalid rate format: ${rateString}. Expected format: "interval-amount"`);
+        }
+        const [intervalStr, amountStr] = parts;
+        const interval = TimeUtil_1.TimeUtil.durationToSeconds(intervalStr.trim());
+        const amount = parseInt(amountStr.trim(), 10);
+        if (isNaN(amount)) {
+            throw new Error(`Invalid amount in rate string: ${amountStr}`);
+        }
+        return new Rate(interval, amount);
+    }
+    /**
+     * Calculate the time (in seconds) needed to accumulate N tokens.
+     */
+    calculateTimeForTokens(tokens) {
+        return Math.ceil((tokens * this.intervalInSeconds) / this.amount);
+    }
+    /**
+     * Calculate when the next token will be available.
+     */
+    calculateNextTokenAvailability(now = TimeUtil_1.TimeUtil.now()) {
+        const secondsToWait = this.intervalInSeconds / this.amount;
+        return new Date((now + secondsToWait) * 1000);
+    }
+    /**
+     * Calculate how many new tokens are added during a given duration.
+     */
+    calculateNewTokensDuringInterval(durationInSeconds) {
+        return Math.floor((durationInSeconds * this.amount) / this.intervalInSeconds);
+    }
+    /**
+     * Calculate the refill interval (time per token in seconds).
+     */
+    getRefillInterval() {
+        return this.intervalInSeconds / this.amount;
+    }
+}
+exports.Rate = Rate;
+//# sourceMappingURL=Rate.js.map

package/dist/policy/Rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rate.js","sourceRoot":"","sources":["../../src/policy/Rate.ts"],"names":[],"mappings":"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"}

package/dist/policy/SlidingWindow.d.ts

@@ -0,0 +1,74 @@
+import type { LimiterStateInterface } from '../LimiterStateInterface';
+/**
+ * Serializable state for SlidingWindowLimiter.
+ *
+ * Tracks hit counts across current and previous windows to implement
+ * a sliding window algorithm.
+ */
+export declare class SlidingWindow implements LimiterStateInterface {
+    private readonly id;
+    private hitCount;
+    private hitCountForLastWindow;
+    private windowEndAt;
+    private readonly intervalInSeconds;
+    constructor(id: string, intervalInSeconds: number, hitCount?: number, hitCountForLastWindow?: number, windowEndAt?: number);
+    getId(): string;
+    /**
+     * Get the expiration time in seconds since epoch.
+     */
+    getExpirationTime(): number;
+    /**
+     * Create a new window from a previous window (window transition).
+     */
+    static createFromPreviousWindow(id: string, intervalInSeconds: number, previousWindow: SlidingWindow, now: number): SlidingWindow;
+    /**
+     * Check if the window has expired.
+     */
+    isExpired(now?: number): boolean;
+    /**
+     * Add hits to the current window.
+     */
+    add(hits: number): void;
+    /**
+     * Get the sliding window hit count at a given time.
+     *
+     * Uses the formula:
+     * (previousWindowHits * (1 - percentIntoCurrentWindow)) + currentWindowHits
+     */
+    getHitCount(now?: number): number;
+    /**
+     * Get the current window's hit count (not sliding).
+     */
+    getCurrentWindowHitCount(): number;
+    /**
+     * Get the previous window's hit count.
+     */
+    getPreviousWindowHitCount(): number;
+    /**
+     * Get when the current window ends.
+     */
+    getWindowEndAt(): number;
+    /**
+     * Get the interval in seconds.
+     */
+    getInterval(): number;
+    /**
+     * Calculate time needed for N tokens to become available.
+     */
+    calculateTimeForTokens(maxSize: number, tokens: number, now?: number): number;
+    /**
+     * Convert to JSON for serialization.
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Create from JSON.
+     */
+    static fromJSON(data: {
+        id: string;
+        hitCount: number;
+        hitCountForLastWindow: number;
+        windowEndAt: number;
+        intervalInSeconds: number;
+    }): SlidingWindow;
+}
+//# sourceMappingURL=SlidingWindow.d.ts.map

package/dist/policy/SlidingWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlidingWindow.d.ts","sourceRoot":"","sources":["../../src/policy/SlidingWindow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGtE;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,qBAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAGzC,EAAE,EAAE,MAAM,EACV,iBAAiB,EAAE,MAAM,EACzB,QAAQ,CAAC,EAAE,MAAM,EACjB,qBAAqB,CAAC,EAAE,MAAM,EAC9B,WAAW,CAAC,EAAE,MAAM;IAStB,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAK3B;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,EAAE,EAAE,MAAM,EACV,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,aAAa,EAC7B,GAAG,EAAE,MAAM,GACV,aAAa;IAYhB;;OAEG;IACH,SAAS,CAAC,GAAG,GAAE,MAAuB,GAAG,OAAO;IAIhD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIvB;;;;;OAKG;IACH,WAAW,CAAC,GAAG,GAAE,MAAuB,GAAG,MAAM;IAmBjD;;OAEG;IACH,wBAAwB,IAAI,MAAM;IAIlC;;OAEG;IACH,yBAAyB,IAAI,MAAM;IAInC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAuB,GAAG,MAAM;IAgB7F;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUjC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,GAAG,aAAa;CASlB"}