import { afterEach, describe, expect, test, vi } from "vitest"; import { MemoryAdapter } from "../adapters/memory.js"; import { createSharedStore } from "../factory.js"; import { createFixedWindowRateLimiter } from "./rate-limit-fixed.js"; afterEach(() => { vi.useRealTimers(); }); function buildLimiter(opts: { windowSeconds?: number; max?: number; now?: () => number } = {}) { const adapter = new MemoryAdapter({ now: opts.now }); const store = createSharedStore({ namespace: "ratelimit", adapter }); const limiter = createFixedWindowRateLimiter({ store, prefix: "ip", windowSeconds: opts.windowSeconds ?? 60, max: opts.max ?? 3, }); return { store, limiter }; } describe("createFixedWindowRateLimiter", () => { test("allows up to max calls in a window", async () => { const { limiter, store } = buildLimiter(); expect((await limiter.consume("k")).allowed).toBe(true); expect((await limiter.consume("k")).allowed).toBe(true); const third = await limiter.consume("k"); expect(third.allowed).toBe(true); expect(third.remaining).toBe(0); const fourth = await limiter.consume("k"); expect(fourth.allowed).toBe(false); expect(fourth.remaining).toBe(0); await store.close(); }); test("isolates buckets by key", async () => { const { limiter, store } = buildLimiter({ max: 1 }); expect((await limiter.consume("a")).allowed).toBe(true); expect((await limiter.consume("b")).allowed).toBe(true); expect((await limiter.consume("a")).allowed).toBe(false); await store.close(); }); test("reserves a weighted batch in one atomic decision", async () => { const { limiter, store } = buildLimiter({ max: 10 }); const first = await limiter.consume("batch", 7); expect(first).toMatchObject({ allowed: true, remaining: 3 }); const overflow = await limiter.consume("batch", 4); expect(overflow).toMatchObject({ allowed: false, remaining: 0 }); await expect(limiter.consume("batch", 0)).rejects.toThrow(/weight/); await store.close(); }); test("resets after the window expires", async () => { let now = 1_000; const { limiter, store } = buildLimiter({ windowSeconds: 1, max: 1, now: () => now }); expect((await limiter.consume("k")).allowed).toBe(true); expect((await limiter.consume("k")).allowed).toBe(false); now += 2_000; expect((await limiter.consume("k")).allowed).toBe(true); await store.close(); }); test("reset() drops the counter", async () => { const { limiter, store } = buildLimiter({ max: 1 }); expect((await limiter.consume("k")).allowed).toBe(true); expect((await limiter.consume("k")).allowed).toBe(false); await limiter.reset("k"); expect((await limiter.consume("k")).allowed).toBe(true); await store.close(); }); test("rejects invalid configuration", () => { const adapter = new MemoryAdapter(); const store = createSharedStore({ namespace: "ratelimit", adapter }); expect(() => createFixedWindowRateLimiter({ store, prefix: "x", windowSeconds: 0, max: 1 })).toThrow(/windowSeconds/); expect(() => createFixedWindowRateLimiter({ store, prefix: "x", windowSeconds: 1, max: 0 })).toThrow(/max/); }); test("reports a sensible resetAt", async () => { const { limiter, store } = buildLimiter({ windowSeconds: 30, max: 5 }); const decision = await limiter.consume("k"); const delta = decision.resetAt.getTime() - Date.now(); expect(delta).toBeGreaterThan(10_000); expect(delta).toBeLessThanOrEqual(30_000); await store.close(); }); });