@zeitar/throttle 1.0.0

package/dist/policy/__tests__/TokenBucket.test.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const TokenBucket_1 = require("../TokenBucket");
+const Rate_1 = require("../Rate");
+describe('TokenBucket', () => {
+    describe('constructor', () => {
+        it('should create a bucket with default values', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test-bucket', 10, rate);
+            expect(bucket.getId()).toBe('test-bucket');
+            expect(bucket.getBurstSize()).toBe(10);
+            expect(bucket.getRate()).toBe(rate);
+        });
+        it('should initialize with full tokens by default', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate);
+            const now = Date.now() / 1000;
+            expect(bucket.getAvailableTokens(now)).toBe(10);
+        });
+        it('should accept custom initial tokens', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5);
+            const now = Date.now() / 1000;
+            expect(bucket.getAvailableTokens(now)).toBe(5);
+        });
+        it('should accept custom timer', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const timer = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5, timer);
+            expect(bucket.getTimer()).toBe(timer);
+        });
+    });
+    describe('getAvailableTokens', () => {
+        it('should return initial tokens when no time has passed', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const now = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5, now);
+            expect(bucket.getAvailableTokens(now)).toBe(5);
+        });
+        it('should add tokens based on elapsed time', () => {
+            const rate = Rate_1.Rate.perSecond(1); // 1 token per second
+            const now = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5, now);
+            // After 3 seconds, should have 5 + 3 = 8 tokens
+            expect(bucket.getAvailableTokens(now + 3)).toBe(8);
+        });
+        it('should cap tokens at burst size', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const now = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5, now);
+            // After 100 seconds, should cap at 10 (burst size)
+            expect(bucket.getAvailableTokens(now + 100)).toBe(10);
+        });
+        it('should handle fractional refills correctly', () => {
+            const rate = Rate_1.Rate.perSecond(2); // 2 tokens per second
+            const now = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 0, now);
+            // After 2.5 seconds, should have floor(2.5 * 2) = 5 tokens
+            expect(bucket.getAvailableTokens(now + 2.5)).toBe(5);
+        });
+        it('should use current time when not provided', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 10);
+            const tokens = bucket.getAvailableTokens();
+            expect(tokens).toBeGreaterThanOrEqual(0);
+            expect(tokens).toBeLessThanOrEqual(10);
+        });
+    });
+    describe('setTokens and setTimer', () => {
+        it('should update tokens', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5);
+            bucket.setTokens(3);
+            const now = Date.now() / 1000;
+            expect(bucket.getAvailableTokens(now)).toBe(3);
+        });
+        it('should update timer', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5, 1000);
+            bucket.setTimer(2000);
+            expect(bucket.getTimer()).toBe(2000);
+        });
+    });
+    describe('getExpirationTime', () => {
+        it('should calculate expiration based on refill time', () => {
+            const rate = Rate_1.Rate.perSecond(1); // 1 token per second
+            const now = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 0, now);
+            // With 0 tokens and burst size 10, needs 10 seconds to refill
+            // Expiration = ceil(1000 + 10) = 1010
+            expect(bucket.getExpirationTime()).toBe(1010);
+        });
+        it('should handle partial buckets', () => {
+            const rate = Rate_1.Rate.perSecond(2); // 2 tokens per second
+            const now = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5, now);
+            // With 5 tokens, needs 5 more tokens = 2.5 seconds
+            // Rate.calculateTimeForTokens(10) = ceil(10 * 1 / 2) = 5
+            // Expiration = ceil(1000 + 5) = 1005
+            expect(bucket.getExpirationTime()).toBe(1005);
+        });
+    });
+    describe('toJSON and fromJSON', () => {
+        it('should serialize to JSON', () => {
+            const rate = Rate_1.Rate.perSecond(2);
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 5, 1000);
+            const json = bucket.toJSON();
+            expect(json).toEqual({
+                id: 'test',
+                tokens: 5,
+                burstSize: 10,
+                timer: 1000,
+                rate: {
+                    interval: 1,
+                    amount: 2,
+                },
+            });
+        });
+        it('should deserialize from JSON', () => {
+            const json = {
+                id: 'test-bucket',
+                tokens: 7,
+                burstSize: 15,
+                timer: 2000,
+                rate: {
+                    interval: 60,
+                    amount: 10,
+                },
+            };
+            const bucket = TokenBucket_1.TokenBucket.fromJSON(json);
+            expect(bucket.getId()).toBe('test-bucket');
+            expect(bucket.getBurstSize()).toBe(15);
+            expect(bucket.getTimer()).toBe(2000);
+            expect(bucket.getRate().getInterval()).toBe(60);
+            expect(bucket.getRate().getAmount()).toBe(10);
+            expect(bucket.getAvailableTokens(2000)).toBe(7);
+        });
+        it('should round-trip serialize/deserialize', () => {
+            const rate = Rate_1.Rate.perHour(100);
+            const bucket = new TokenBucket_1.TokenBucket('round-trip', 50, rate, 25, 5000);
+            const json = bucket.toJSON();
+            const restored = TokenBucket_1.TokenBucket.fromJSON(json);
+            expect(restored.getId()).toBe(bucket.getId());
+            expect(restored.getBurstSize()).toBe(bucket.getBurstSize());
+            expect(restored.getTimer()).toBe(bucket.getTimer());
+            expect(restored.getAvailableTokens(5000)).toBe(bucket.getAvailableTokens(5000));
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle zero tokens', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test', 10, rate, 0);
+            const now = Date.now() / 1000;
+            expect(bucket.getAvailableTokens(now)).toBe(0);
+        });
+        it('should handle burst size of 1', () => {
+            const rate = Rate_1.Rate.perSecond(1);
+            const bucket = new TokenBucket_1.TokenBucket('test', 1, rate, 1);
+            const now = Date.now() / 1000;
+            expect(bucket.getAvailableTokens(now)).toBe(1);
+        });
+        it('should handle very fast refill rates', () => {
+            const rate = Rate_1.Rate.perSecond(1000);
+            const now = 1000;
+            const bucket = new TokenBucket_1.TokenBucket('test', 100, rate, 0, now);
+            // After 0.1 seconds, should have 100 tokens (rate is 1000/s)
+            expect(bucket.getAvailableTokens(now + 0.1)).toBe(100);
+        });
+    });
+});
+//# sourceMappingURL=TokenBucket.test.js.map

package/dist/policy/__tests__/TokenBucket.test.js.map

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

package/dist/policy/__tests__/TokenBucketLimiter.test.d.ts

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

package/dist/policy/__tests__/TokenBucketLimiter.test.d.ts.map

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

package/dist/policy/__tests__/TokenBucketLimiter.test.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const TokenBucketLimiter_1 = require("../TokenBucketLimiter");
+const Rate_1 = require("../Rate");
+const InMemoryStorage_1 = require("../../storage/InMemoryStorage");
+const MaxWaitDurationExceededError_1 = require("../../errors/MaxWaitDurationExceededError");
+describe('TokenBucketLimiter', () => {
+    let storage;
+    beforeEach(() => {
+        storage = new InMemoryStorage_1.InMemoryStorage();
+    });
+    describe('consume', () => {
+        it('should accept requests when tokens are available', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            const result = await limiter.consume(5);
+            expect(result.isAccepted()).toBe(true);
+            expect(result.getRemainingTokens()).toBe(5);
+            expect(result.getLimit()).toBe(10);
+        });
+        it('should reject requests when tokens are exhausted', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter.consume(10);
+            const result = await limiter.consume(1);
+            expect(result.isAccepted()).toBe(false);
+            expect(result.getRemainingTokens()).toBe(0);
+        });
+        it('should decrement tokens on each consumption', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            const r1 = await limiter.consume(3);
+            const r2 = await limiter.consume(2);
+            const r3 = await limiter.consume(4);
+            expect(r1.getRemainingTokens()).toBe(7);
+            expect(r2.getRemainingTokens()).toBe(5);
+            expect(r3.getRemainingTokens()).toBe(1);
+        });
+        it('should refill tokens over time', async () => {
+            jest.useFakeTimers();
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(2), storage);
+            await limiter.consume(10);
+            // Wait 3 seconds, should refill 6 tokens
+            jest.advanceTimersByTime(3000);
+            const result = await limiter.consume(5);
+            expect(result.isAccepted()).toBe(true);
+            jest.useRealTimers();
+        });
+        it('should cap refilled tokens at burst size', async () => {
+            jest.useFakeTimers();
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter.consume(5);
+            // Wait 100 seconds, should cap at 10 tokens
+            jest.advanceTimersByTime(100000);
+            const result = await limiter.consume(10);
+            expect(result.isAccepted()).toBe(true);
+            jest.useRealTimers();
+        });
+        it('should provide retry time when rate limited', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter.consume(10);
+            const result = await limiter.consume(5);
+            expect(result.isAccepted()).toBe(false);
+            expect(result.getRetryAfter().getTime()).toBeGreaterThan(Date.now());
+        });
+        it('should handle fractional tokens consumption', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(2), storage);
+            const r1 = await limiter.consume(1);
+            const r2 = await limiter.consume(1);
+            expect(r1.isAccepted()).toBe(true);
+            expect(r2.isAccepted()).toBe(true);
+        });
+    });
+    describe('reserve', () => {
+        it('should reserve tokens when available', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            const reservation = await limiter.reserve(5);
+            expect(reservation.getWaitDuration()).toBe(0);
+            expect(reservation.getRateLimit().isAccepted()).toBe(true);
+            expect(reservation.getRateLimit().getRemainingTokens()).toBe(5);
+        });
+        it('should calculate wait time when tokens not available', async () => {
+            jest.useFakeTimers();
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter.consume(10);
+            const reservation = await limiter.reserve(5);
+            expect(reservation.getWaitDuration()).toBeGreaterThan(0);
+            expect(reservation.getRateLimit().isAccepted()).toBe(true);
+            jest.useRealTimers();
+        });
+        it('should throw error when exceeding maxTime', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter.consume(10);
+            await expect(limiter.reserve(5, 1)).rejects.toThrow(MaxWaitDurationExceededError_1.MaxWaitDurationExceededError);
+        });
+        it('should throw error when requesting more than burst size', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await expect(limiter.reserve(15)).rejects.toThrow('Cannot reserve 15 tokens, burst size is 10');
+        });
+        it('should wait for correct duration based on rate', async () => {
+            jest.useFakeTimers();
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(2), storage);
+            await limiter.consume(10);
+            const reservation = await limiter.reserve(4);
+            // Need 4 tokens at 2 per second = 2 seconds
+            const waitDuration = reservation.getWaitDuration();
+            expect(waitDuration).toBeGreaterThanOrEqual(1900);
+            expect(waitDuration).toBeLessThanOrEqual(2100);
+            jest.useRealTimers();
+        });
+    });
+    describe('reset', () => {
+        it('should reset the limiter state', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter.consume(10);
+            await limiter.reset();
+            const result = await limiter.consume(10);
+            expect(result.isAccepted()).toBe(true);
+        });
+        it('should start fresh after reset', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter.consume(5);
+            await limiter.reset();
+            const result = await limiter.consume(1);
+            expect(result.getRemainingTokens()).toBe(9);
+        });
+    });
+    describe('multiple limiters', () => {
+        it('should maintain separate state for different IDs', async () => {
+            const limiter1 = new TokenBucketLimiter_1.TokenBucketLimiter('user1', 10, Rate_1.Rate.perSecond(1), storage);
+            const limiter2 = new TokenBucketLimiter_1.TokenBucketLimiter('user2', 10, Rate_1.Rate.perSecond(1), storage);
+            await limiter1.consume(8);
+            await limiter2.consume(3);
+            const r1 = await limiter1.consume(1);
+            const r2 = await limiter2.consume(1);
+            expect(r1.getRemainingTokens()).toBe(1);
+            expect(r2.getRemainingTokens()).toBe(6);
+        });
+    });
+    describe('concurrent requests', () => {
+        it('should handle sequential requests correctly', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            const results = [];
+            for (let i = 0; i < 15; i++) {
+                results.push(await limiter.consume(1));
+            }
+            const accepted = results.filter(r => r.isAccepted());
+            const rejected = results.filter(r => !r.isAccepted());
+            expect(accepted.length).toBe(10);
+            expect(rejected.length).toBe(5);
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle burst size of 1', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 1, Rate_1.Rate.perSecond(1), storage);
+            const r1 = await limiter.consume(1);
+            const r2 = await limiter.consume(1);
+            expect(r1.isAccepted()).toBe(true);
+            expect(r2.isAccepted()).toBe(false);
+        });
+        it('should handle very fast refill rates', async () => {
+            jest.useFakeTimers();
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 100, Rate_1.Rate.perSecond(1000), storage);
+            await limiter.consume(100);
+            jest.advanceTimersByTime(100); // 0.1 seconds
+            const result = await limiter.consume(50);
+            expect(result.isAccepted()).toBe(true);
+            jest.useRealTimers();
+        });
+        it('should handle default parameters', async () => {
+            const limiter = new TokenBucketLimiter_1.TokenBucketLimiter('test', 10, Rate_1.Rate.perSecond(1), storage);
+            const result = await limiter.consume(); // Default 1 token
+            expect(result.isAccepted()).toBe(true);
+            expect(result.getRemainingTokens()).toBe(9);
+        });
+    });
+});
+//# sourceMappingURL=TokenBucketLimiter.test.js.map

package/dist/policy/__tests__/TokenBucketLimiter.test.js.map

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

package/dist/policy/__tests__/Window.test.d.ts

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

package/dist/policy/__tests__/Window.test.d.ts.map

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

package/dist/policy/__tests__/Window.test.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Window_1 = require("../Window");
+describe('Window', () => {
+    describe('constructor', () => {
+        it('should create a window with default values', () => {
+            const window = new Window_1.Window('test-window', 60, 100);
+            expect(window.getId()).toBe('test-window');
+            expect(window.getInterval()).toBe(60);
+            expect(window.getHitCount()).toBe(0);
+        });
+        it('should accept custom initial hit count', () => {
+            const window = new Window_1.Window('test', 60, 100, 50);
+            expect(window.getHitCount()).toBe(50);
+        });
+        it('should accept custom timer', () => {
+            const timer = 1000;
+            const window = new Window_1.Window('test', 60, 100, 0, timer);
+            expect(window.getTimer()).toBe(timer);
+        });
+    });
+    describe('add', () => {
+        it('should add hits to the same window', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 0, now);
+            window.add(5, now + 10);
+            expect(window.getHitCount()).toBe(5);
+            window.add(3, now + 20);
+            expect(window.getHitCount()).toBe(8);
+        });
+        it('should reset hits when moving to a new window', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 50, now);
+            // Move to new window (60+ seconds later)
+            window.add(10, now + 70);
+            expect(window.getHitCount()).toBe(10);
+        });
+        it('should align timer to window boundary on reset', () => {
+            const now = 1000;
+            const intervalInSeconds = 60;
+            const window = new Window_1.Window('test', intervalInSeconds, 100, 0, now);
+            // Move to new window
+            const newTime = now + 125; // 2+ windows later
+            window.add(5, newTime);
+            // Timer should be aligned to window boundary
+            const expectedTimer = Math.floor(newTime / intervalInSeconds) * intervalInSeconds;
+            expect(window.getTimer()).toBe(expectedTimer);
+        });
+        it('should use current time when not provided', () => {
+            const window = new Window_1.Window('test', 60, 100);
+            window.add(5);
+            expect(window.getHitCount()).toBe(5);
+        });
+        it('should handle exact window boundary', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 10, now);
+            // Exactly at window boundary
+            window.add(5, now + 60);
+            expect(window.getHitCount()).toBe(5); // Should reset
+        });
+    });
+    describe('getAvailableTokens', () => {
+        it('should return max tokens for empty window', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 0, now);
+            expect(window.getAvailableTokens(now)).toBe(100);
+        });
+        it('should return remaining tokens in current window', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 30, now);
+            expect(window.getAvailableTokens(now + 10)).toBe(70); // 100 - 30
+        });
+        it('should return max tokens in new window', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 90, now);
+            // Move to new window
+            expect(window.getAvailableTokens(now + 70)).toBe(100);
+        });
+        it('should return 0 when window is full', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 100, now);
+            expect(window.getAvailableTokens(now + 10)).toBe(0);
+        });
+        it('should not return negative tokens', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 150, now); // Over limit
+            expect(window.getAvailableTokens(now + 10)).toBe(0);
+        });
+        it('should use current time when not provided', () => {
+            const window = new Window_1.Window('test', 60, 100, 50);
+            const available = window.getAvailableTokens();
+            expect(available).toBeGreaterThanOrEqual(0);
+            expect(available).toBeLessThanOrEqual(100);
+        });
+    });
+    describe('calculateTimeForTokens', () => {
+        it('should return 0 when tokens are already available', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 20, now);
+            // Need 50 tokens, have 80 available
+            expect(window.calculateTimeForTokens(50, now)).toBe(0);
+        });
+        it('should calculate wait time for next window', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 90, now);
+            // Need 50 tokens, only have 10 available, need to wait for next window
+            const waitTime = window.calculateTimeForTokens(50, now + 10);
+            expect(waitTime).toBe(50); // 60 - 10 seconds remaining in window
+        });
+        it('should handle exact window end', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 100, now);
+            // At window end, new window starts
+            expect(window.calculateTimeForTokens(50, now + 60)).toBe(0);
+        });
+        it('should use current time when not provided', () => {
+            const window = new Window_1.Window('test', 60, 100, 100);
+            const waitTime = window.calculateTimeForTokens(50);
+            expect(waitTime).toBeGreaterThanOrEqual(0);
+        });
+    });
+    describe('getExpirationTime', () => {
+        it('should calculate expiration as timer plus interval', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 100, 0, now);
+            expect(window.getExpirationTime()).toBe(1060); // ceil(1000 + 60)
+        });
+        it('should round up expiration time', () => {
+            const now = 1000.5;
+            const window = new Window_1.Window('test', 60, 100, 0, now);
+            expect(window.getExpirationTime()).toBe(1061); // ceil(1000.5 + 60)
+        });
+    });
+    describe('toJSON and fromJSON', () => {
+        it('should serialize to JSON', () => {
+            const window = new Window_1.Window('test', 60, 100, 50, 1000);
+            const json = window.toJSON();
+            expect(json).toEqual({
+                id: 'test',
+                hitCount: 50,
+                intervalInSeconds: 60,
+                maxSize: 100,
+                timer: 1000,
+            });
+        });
+        it('should deserialize from JSON', () => {
+            const json = {
+                id: 'test-window',
+                hitCount: 75,
+                intervalInSeconds: 120,
+                maxSize: 200,
+                timer: 2000,
+            };
+            const window = Window_1.Window.fromJSON(json);
+            expect(window.getId()).toBe('test-window');
+            expect(window.getHitCount()).toBe(75);
+            expect(window.getInterval()).toBe(120);
+            expect(window.getTimer()).toBe(2000);
+        });
+        it('should round-trip serialize/deserialize', () => {
+            const window = new Window_1.Window('round-trip', 300, 1000, 500, 5000);
+            const json = window.toJSON();
+            const restored = Window_1.Window.fromJSON(json);
+            expect(restored.getId()).toBe(window.getId());
+            expect(restored.getHitCount()).toBe(window.getHitCount());
+            expect(restored.getInterval()).toBe(window.getInterval());
+            expect(restored.getTimer()).toBe(window.getTimer());
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle interval of 1 second', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 1, 10, 0, now);
+            window.add(5, now);
+            expect(window.getAvailableTokens(now)).toBe(5);
+            // Next second is new window
+            expect(window.getAvailableTokens(now + 1)).toBe(10);
+        });
+        it('should handle max size of 1', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 60, 1, 0, now);
+            window.add(1, now);
+            expect(window.getAvailableTokens(now)).toBe(0);
+        });
+        it('should handle very large intervals', () => {
+            const now = 1000;
+            const window = new Window_1.Window('test', 86400, 10000, 5000, now); // 1 day interval
+            expect(window.getAvailableTokens(now + 1000)).toBe(5000);
+            expect(window.getAvailableTokens(now + 86400)).toBe(10000); // New window
+        });
+    });
+});
+//# sourceMappingURL=Window.test.js.map

package/dist/policy/__tests__/Window.test.js.map

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

package/dist/storage/InMemoryStorage.d.ts

@@ -0,0 +1,34 @@
+import type { LimiterStateInterface } from '../LimiterStateInterface';
+import type { StorageInterface } from './StorageInterface';
+/**
+ * In-memory storage implementation for rate limiter state.
+ *
+ * This storage is non-persistent and will be lost when the process restarts.
+ * Suitable for single-instance applications or testing.
+ */
+export declare class InMemoryStorage implements StorageInterface {
+    private readonly storage;
+    /**
+     * Save a state object to memory.
+     */
+    save(state: LimiterStateInterface): Promise<void>;
+    /**
+     * Fetch a state object from memory.
+     *
+     * Automatically cleans up expired entries.
+     */
+    fetch(id: string): Promise<LimiterStateInterface | null>;
+    /**
+     * Delete a state object from memory.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Clear all stored state (useful for testing).
+     */
+    clear(): void;
+    /**
+     * Get the number of stored entries (useful for testing).
+     */
+    size(): number;
+}
+//# sourceMappingURL=InMemoryStorage.d.ts.map