@zeitar/throttle 1.0.0

package/dist/__tests__/RateLimiterFactory.test.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const RateLimiterFactory_1 = require("../RateLimiterFactory");
+const InMemoryStorage_1 = require("../storage/InMemoryStorage");
+const TokenBucketLimiter_1 = require("../policy/TokenBucketLimiter");
+const FixedWindowLimiter_1 = require("../policy/FixedWindowLimiter");
+const SlidingWindowLimiter_1 = require("../policy/SlidingWindowLimiter");
+const NoLimiter_1 = require("../policy/NoLimiter");
+describe('RateLimiterFactory', () => {
+    let storage;
+    beforeEach(() => {
+        storage = new InMemoryStorage_1.InMemoryStorage();
+    });
+    describe('constructor validation', () => {
+        it('should throw error when id is missing', () => {
+            const config = {
+                policy: 'token_bucket',
+                limit: 10,
+                rate: { interval: '1 second', amount: 1 },
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('Configuration must include an "id" field');
+        });
+        it('should throw error when policy is missing', () => {
+            const config = {
+                id: 'test',
+                limit: 10,
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('Configuration must include a "policy" field');
+        });
+        it('should throw error for unknown policy', () => {
+            const config = {
+                id: 'test',
+                policy: 'unknown_policy',
+                limit: 10,
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('Unknown policy');
+        });
+    });
+    describe('token bucket policy', () => {
+        it('should create TokenBucketLimiter', () => {
+            const config = {
+                policy: 'token_bucket',
+                id: 'test',
+                limit: 10,
+                rate: { interval: '1 second', amount: 1 },
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(TokenBucketLimiter_1.TokenBucketLimiter);
+        });
+        it('should validate required fields', () => {
+            const config = {
+                policy: 'token_bucket',
+                id: 'test',
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('Token bucket requires a positive "limit"');
+        });
+        it('should validate positive limit', () => {
+            const config = {
+                policy: 'token_bucket',
+                id: 'test',
+                limit: 0,
+                rate: { interval: '1 second', amount: 1 },
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('Token bucket requires a positive "limit"');
+        });
+        it('should validate rate configuration', () => {
+            const config = {
+                policy: 'token_bucket',
+                id: 'test',
+                limit: 10,
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('Token bucket requires a "rate" object');
+        });
+        it('should parse interval string correctly', () => {
+            const config = {
+                policy: 'token_bucket',
+                id: 'test',
+                limit: 10,
+                rate: { interval: '1 minute', amount: 100 },
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(TokenBucketLimiter_1.TokenBucketLimiter);
+        });
+    });
+    describe('fixed window policy', () => {
+        it('should create FixedWindowLimiter', () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+                limit: 10,
+                interval: '60 seconds',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(FixedWindowLimiter_1.FixedWindowLimiter);
+        });
+        it('should validate required fields', () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('fixed_window requires a positive "limit"');
+        });
+        it('should validate interval field', () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+                limit: 10,
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('fixed_window requires an "interval"');
+        });
+        it('should parse interval string correctly', () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+                limit: 100,
+                interval: '1 hour',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(FixedWindowLimiter_1.FixedWindowLimiter);
+        });
+    });
+    describe('sliding window policy', () => {
+        it('should create SlidingWindowLimiter', () => {
+            const config = {
+                policy: 'sliding_window',
+                id: 'test',
+                limit: 10,
+                interval: '60 seconds',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(SlidingWindowLimiter_1.SlidingWindowLimiter);
+        });
+        it('should validate required fields', () => {
+            const config = {
+                policy: 'sliding_window',
+                id: 'test',
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('sliding_window requires a positive "limit"');
+        });
+        it('should validate interval field', () => {
+            const config = {
+                policy: 'sliding_window',
+                id: 'test',
+                limit: 10,
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).toThrow('sliding_window requires an "interval"');
+        });
+        it('should parse interval string correctly', () => {
+            const config = {
+                policy: 'sliding_window',
+                id: 'test',
+                limit: 1000,
+                interval: '1 day',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(SlidingWindowLimiter_1.SlidingWindowLimiter);
+        });
+    });
+    describe('no limit policy', () => {
+        it('should create NoLimiter', () => {
+            const config = {
+                policy: 'no_limit',
+                id: 'test',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(NoLimiter_1.NoLimiter);
+        });
+        it('should not require additional fields', () => {
+            const config = {
+                policy: 'no_limit',
+                id: 'test',
+            };
+            expect(() => new RateLimiterFactory_1.RateLimiterFactory(config, storage)).not.toThrow();
+        });
+    });
+    describe('create with key', () => {
+        it('should append key to limiter id', async () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'api',
+                limit: 10,
+                interval: '60 seconds',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter1 = factory.create('user1');
+            const limiter2 = factory.create('user2');
+            // Consume from limiter1 shouldn't affect limiter2
+            await limiter1.consume(10);
+            const result1 = await limiter1.consume(1);
+            const result2 = await limiter2.consume(1);
+            expect(result1.isAccepted()).toBe(false);
+            expect(result2.isAccepted()).toBe(true);
+        });
+        it('should use base id when key is null', async () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+                limit: 10,
+                interval: '60 seconds',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter1 = factory.create(null);
+            const limiter2 = factory.create();
+            // Should share the same state
+            await limiter1.consume(5);
+            const result = await limiter2.consume(1);
+            expect(result.getRemainingTokens()).toBe(4);
+        });
+        it('should use base id when key is undefined', async () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+                limit: 10,
+                interval: '60 seconds',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter1 = factory.create(undefined);
+            const limiter2 = factory.create();
+            // Should share the same state
+            await limiter1.consume(7);
+            const result = await limiter2.consume(1);
+            expect(result.getRemainingTokens()).toBe(2);
+        });
+        it('should handle empty string key', async () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+                limit: 10,
+                interval: '60 seconds',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create('');
+            const result = await limiter.consume(5);
+            expect(result.isAccepted()).toBe(true);
+        });
+    });
+    describe('multiple limiters from same factory', () => {
+        it('should create independent limiters with different keys', async () => {
+            const config = {
+                policy: 'token_bucket',
+                id: 'api',
+                limit: 5,
+                rate: { interval: '1 second', amount: 1 },
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter1 = factory.create('user1');
+            const limiter2 = factory.create('user2');
+            const limiter3 = factory.create('user3');
+            await limiter1.consume(5);
+            await limiter2.consume(3);
+            const r1 = await limiter1.consume(1);
+            const r2 = await limiter2.consume(1);
+            const r3 = await limiter3.consume(1);
+            expect(r1.isAccepted()).toBe(false);
+            expect(r2.isAccepted()).toBe(true);
+            expect(r3.isAccepted()).toBe(true);
+        });
+    });
+    describe('complex interval strings', () => {
+        it('should handle various interval formats', () => {
+            const configs = [
+                { interval: '1 second' },
+                { interval: '30 seconds' },
+                { interval: '1 minute' },
+                { interval: '5 minutes' },
+                { interval: '1 hour' },
+                { interval: '24 hours' },
+                { interval: '1 day' },
+                { interval: '1 week' },
+            ];
+            configs.forEach(({ interval }) => {
+                const config = {
+                    policy: 'fixed_window',
+                    id: 'test',
+                    limit: 10,
+                    interval,
+                };
+                const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+                const limiter = factory.create();
+                expect(limiter).toBeInstanceOf(FixedWindowLimiter_1.FixedWindowLimiter);
+            });
+        });
+    });
+    describe('storage and lock', () => {
+        it('should use provided storage', async () => {
+            const config = {
+                policy: 'fixed_window',
+                id: 'test',
+                limit: 10,
+                interval: '60 seconds',
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage);
+            const limiter = factory.create();
+            await limiter.consume(5);
+            // Verify storage was used
+            expect(storage.size()).toBeGreaterThan(0);
+        });
+        it('should pass lock to limiters', () => {
+            const mockLock = {
+                acquire: jest.fn(async () => true),
+                release: jest.fn(async () => { }),
+                withLock: jest.fn(async (id, fn) => fn()),
+            };
+            const config = {
+                policy: 'token_bucket',
+                id: 'test',
+                limit: 10,
+                rate: { interval: '1 second', amount: 1 },
+            };
+            const factory = new RateLimiterFactory_1.RateLimiterFactory(config, storage, mockLock);
+            const limiter = factory.create();
+            expect(limiter).toBeInstanceOf(TokenBucketLimiter_1.TokenBucketLimiter);
+        });
+    });
+});
+//# sourceMappingURL=RateLimiterFactory.test.js.map

package/dist/__tests__/RateLimiterFactory.test.js.map

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

package/dist/__tests__/Reservation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Reservation.test.d.ts.map

package/dist/__tests__/Reservation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reservation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/Reservation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/Reservation.test.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Reservation_1 = require("../Reservation");
+const RateLimit_1 = require("../RateLimit");
+describe('Reservation', () => {
+    let rateLimit;
+    beforeEach(() => {
+        const retryAfter = new Date(Date.now() + 5000);
+        rateLimit = new RateLimit_1.RateLimit(5, retryAfter, true, 10);
+    });
+    describe('constructor', () => {
+        it('should create a reservation with correct values', () => {
+            const timeToAct = Date.now() + 1000;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            expect(reservation.getTimeToAct()).toBe(timeToAct);
+            expect(reservation.getRateLimit()).toBe(rateLimit);
+        });
+        it('should handle past time to act', () => {
+            const timeToAct = Date.now() - 5000;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            expect(reservation.getTimeToAct()).toBe(timeToAct);
+        });
+    });
+    describe('getTimeToAct', () => {
+        it('should return the time to act in milliseconds', () => {
+            const timeToAct = Date.now() + 2000;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            expect(reservation.getTimeToAct()).toBe(timeToAct);
+        });
+    });
+    describe('getWaitDuration', () => {
+        it('should return positive duration when time to act is in future', () => {
+            const timeToAct = Date.now() + 5000;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            const waitDuration = reservation.getWaitDuration();
+            expect(waitDuration).toBeGreaterThan(4000);
+            expect(waitDuration).toBeLessThan(6000);
+        });
+        it('should return 0 when time to act is in past', () => {
+            const timeToAct = Date.now() - 1000;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            expect(reservation.getWaitDuration()).toBe(0);
+        });
+        it('should return ~0 when time to act is now', () => {
+            const timeToAct = Date.now();
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            const waitDuration = reservation.getWaitDuration();
+            expect(waitDuration).toBeGreaterThanOrEqual(0);
+            expect(waitDuration).toBeLessThan(100);
+        });
+        it('should decrease over time', async () => {
+            const timeToAct = Date.now() + 1000;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            const duration1 = reservation.getWaitDuration();
+            await new Promise(resolve => setTimeout(resolve, 100));
+            const duration2 = reservation.getWaitDuration();
+            expect(duration2).toBeLessThan(duration1);
+        });
+    });
+    describe('getRateLimit', () => {
+        it('should return the associated RateLimit object', () => {
+            const reservation = new Reservation_1.Reservation(Date.now(), rateLimit);
+            expect(reservation.getRateLimit()).toBe(rateLimit);
+        });
+        it('should allow accessing RateLimit properties', () => {
+            const reservation = new Reservation_1.Reservation(Date.now(), rateLimit);
+            expect(reservation.getRateLimit().getRemainingTokens()).toBe(5);
+            expect(reservation.getRateLimit().getLimit()).toBe(10);
+            expect(reservation.getRateLimit().isAccepted()).toBe(true);
+        });
+    });
+    describe('wait', () => {
+        it('should resolve immediately when time to act is in past', async () => {
+            const timeToAct = Date.now() - 1000;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            const start = Date.now();
+            await reservation.wait();
+            const elapsed = Date.now() - start;
+            expect(elapsed).toBeLessThan(100);
+        });
+        it('should wait until time to act', async () => {
+            const timeToAct = Date.now() + 100;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            const start = Date.now();
+            await reservation.wait();
+            const elapsed = Date.now() - start;
+            expect(elapsed).toBeGreaterThanOrEqual(90);
+            expect(elapsed).toBeLessThan(200);
+        });
+        it('should work when time to act is now', async () => {
+            const timeToAct = Date.now();
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            const start = Date.now();
+            await reservation.wait();
+            const elapsed = Date.now() - start;
+            expect(elapsed).toBeLessThan(100);
+        });
+    });
+    describe('usage patterns', () => {
+        it('should support check-then-wait pattern', async () => {
+            const timeToAct = Date.now() + 50;
+            const reservation = new Reservation_1.Reservation(timeToAct, rateLimit);
+            if (reservation.getWaitDuration() > 0) {
+                await reservation.wait();
+            }
+            expect(Date.now()).toBeGreaterThanOrEqual(timeToAct - 10);
+        });
+    });
+});
+//# sourceMappingURL=Reservation.test.js.map

package/dist/__tests__/Reservation.test.js.map

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

package/dist/errors/InvalidIntervalError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Thrown when an invalid interval is provided to a rate limiter.
+ *
+ * An interval is considered invalid if it's less than 1 second or otherwise
+ * doesn't meet the requirements of the rate limiting policy.
+ */
+export declare class InvalidIntervalError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=InvalidIntervalError.d.ts.map

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

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

package/dist/errors/InvalidIntervalError.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidIntervalError = void 0;
+/**
+ * Thrown when an invalid interval is provided to a rate limiter.
+ *
+ * An interval is considered invalid if it's less than 1 second or otherwise
+ * doesn't meet the requirements of the rate limiting policy.
+ */
+class InvalidIntervalError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidIntervalError';
+        Object.setPrototypeOf(this, InvalidIntervalError.prototype);
+    }
+}
+exports.InvalidIntervalError = InvalidIntervalError;
+//# sourceMappingURL=InvalidIntervalError.js.map

package/dist/errors/InvalidIntervalError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidIntervalError.js","sourceRoot":"","sources":["../../src/errors/InvalidIntervalError.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAND,oDAMC"}

package/dist/errors/MaxWaitDurationExceededError.d.ts

@@ -0,0 +1,15 @@
+import type { RateLimit } from '../RateLimit';
+/**
+ * Thrown when a reservation would require waiting longer than the maximum allowed time.
+ *
+ * This exception is thrown by reserve() when the wait duration exceeds the maxTime parameter.
+ */
+export declare class MaxWaitDurationExceededError extends Error {
+    private readonly rateLimit;
+    constructor(message: string, rateLimit: RateLimit);
+    /**
+     * Get the associated RateLimit object.
+     */
+    getRateLimit(): RateLimit;
+}
+//# sourceMappingURL=MaxWaitDurationExceededError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MaxWaitDurationExceededError.d.ts","sourceRoot":"","sources":["../../src/errors/MaxWaitDurationExceededError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;IAOjD;;OAEG;IACH,YAAY,IAAI,SAAS;CAG1B"}

package/dist/errors/MaxWaitDurationExceededError.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaxWaitDurationExceededError = void 0;
+/**
+ * Thrown when a reservation would require waiting longer than the maximum allowed time.
+ *
+ * This exception is thrown by reserve() when the wait duration exceeds the maxTime parameter.
+ */
+class MaxWaitDurationExceededError extends Error {
+    constructor(message, rateLimit) {
+        super(message);
+        this.name = 'MaxWaitDurationExceededError';
+        this.rateLimit = rateLimit;
+        Object.setPrototypeOf(this, MaxWaitDurationExceededError.prototype);
+    }
+    /**
+     * Get the associated RateLimit object.
+     */
+    getRateLimit() {
+        return this.rateLimit;
+    }
+}
+exports.MaxWaitDurationExceededError = MaxWaitDurationExceededError;
+//# sourceMappingURL=MaxWaitDurationExceededError.js.map

package/dist/errors/MaxWaitDurationExceededError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaxWaitDurationExceededError.js","sourceRoot":"","sources":["../../src/errors/MaxWaitDurationExceededError.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,4BAA6B,SAAQ,KAAK;IAGrD,YAAY,OAAe,EAAE,SAAoB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAhBD,oEAgBC"}

package/dist/errors/RateLimitExceededError.d.ts

@@ -0,0 +1,27 @@
+import type { RateLimit } from '../RateLimit';
+/**
+ * Thrown when a rate limit is exceeded and the request cannot be fulfilled.
+ *
+ * Contains the RateLimit object with details about when to retry and remaining tokens.
+ */
+export declare class RateLimitExceededError extends Error {
+    private readonly rateLimit;
+    constructor(message: string, rateLimit: RateLimit);
+    /**
+     * Get the associated RateLimit object.
+     */
+    getRateLimit(): RateLimit;
+    /**
+     * Convenience method to get the retry time.
+     */
+    getRetryAfter(): Date;
+    /**
+     * Convenience method to get remaining tokens.
+     */
+    getRemainingTokens(): number;
+    /**
+     * Convenience method to get the rate limit.
+     */
+    getLimit(): number;
+}
+//# sourceMappingURL=RateLimitExceededError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimitExceededError.d.ts","sourceRoot":"","sources":["../../src/errors/RateLimitExceededError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;IAOjD;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/errors/RateLimitExceededError.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitExceededError = void 0;
+/**
+ * Thrown when a rate limit is exceeded and the request cannot be fulfilled.
+ *
+ * Contains the RateLimit object with details about when to retry and remaining tokens.
+ */
+class RateLimitExceededError extends Error {
+    constructor(message, rateLimit) {
+        super(message);
+        this.name = 'RateLimitExceededError';
+        this.rateLimit = rateLimit;
+        Object.setPrototypeOf(this, RateLimitExceededError.prototype);
+    }
+    /**
+     * Get the associated RateLimit object.
+     */
+    getRateLimit() {
+        return this.rateLimit;
+    }
+    /**
+     * Convenience method to get the retry time.
+     */
+    getRetryAfter() {
+        return this.rateLimit.getRetryAfter();
+    }
+    /**
+     * Convenience method to get remaining tokens.
+     */
+    getRemainingTokens() {
+        return this.rateLimit.getRemainingTokens();
+    }
+    /**
+     * Convenience method to get the rate limit.
+     */
+    getLimit() {
+        return this.rateLimit.getLimit();
+    }
+}
+exports.RateLimitExceededError = RateLimitExceededError;
+//# sourceMappingURL=RateLimitExceededError.js.map

package/dist/errors/RateLimitExceededError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimitExceededError.js","sourceRoot":"","sources":["../../src/errors/RateLimitExceededError.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAG/C,YAAY,OAAe,EAAE,SAAoB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;CACF;AArCD,wDAqCC"}

package/dist/errors/ReserveNotSupportedError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export declare class ReserveNotSupportedError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=ReserveNotSupportedError.d.ts.map