/** * Per-key rate limiter for repeated errors. Prevents log/emit floods and the * unbounded map growth that a per-event log would cause when a broken key * keeps producing failures. */ export class ErrorRateLimiter { private lastAt: Map = new Map(); private counts: Map = new Map(); constructor( private readonly throttleMs: number = 1000, private readonly windowMs: number = 60_000, private readonly maxPerWindow: number = 5, ) {} reset() { this.lastAt.clear(); this.counts.clear(); } countFor(key: string): number { return this.counts.get(key) ?? 0; } /** * Returns true if the caller should emit for this key. Invokes `onSuppress` * exactly once per window when the per-window limit is first crossed. */ shouldEmit(key: string, onSuppress?: () => void): boolean { const now = Date.now(); const last = this.lastAt.get(key) ?? 0; const count = this.counts.get(key) ?? 0; if (now - last > this.windowMs) { this.counts.set(key, 0); this.lastAt.set(key, now); return true; } if (now - last < this.throttleMs) return false; if (count >= this.maxPerWindow) { if (count === this.maxPerWindow) { onSuppress?.(); this.counts.set(key, count + 1); } return false; } this.lastAt.set(key, now); this.counts.set(key, count + 1); return true; } }