export type LimiterConfig = { capacity: number; refillPerSecond: number };export type Limiter = { tryTake(n: number): boolean; available(): number; retryAfterMs(n: number): number | undefined;};export class LimiterError extends Error { constructor(public readonly kind: "invalid_config") { super(kind); }}const finite = (v: unknown): v is number => typeof v === "number" && Number.isFinite(v);const isCount = (n: number): boolean => Number.isInteger(n) && n > 0;/** Throws LimiterError when the config is invalid. */export function createLimiter(config: LimiterConfig, now: () => number): Limiter { const capacity = config.capacity; const rate = config.refillPerSecond; if (!finite(capacity) || capacity <= 0) throw new LimiterError("invalid_config"); if (!finite(rate) || rate < 0) throw new LimiterError("invalid_config"); let tokens = capacity; let last = now(); const refill = (): void => { const t = now(); if (t > last) { tokens = Math.min(capacity, tokens + ((t - last) * rate) / 1000); last = t; } }; return { tryTake(n: number): boolean { refill(); if (!isCount(n) || tokens < n) return false; tokens -= n; return true; }, available(): number { refill(); return Math.floor(tokens); }, retryAfterMs(n: number): number | undefined { refill(); if (!isCount(n) || n > capacity) return undefined; if (tokens >= n) return 0; if (rate === 0) return undefined; return Math.ceil(((n - tokens) * 1000) / rate); }, };}