Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

@@ -0,0 +1,82 @@
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("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();
});
});