stores-com / petty-cache / 24942414827

100%

main: 100%

Build Type

Pull #62

github

Committed by freshlogic

Commit Message

feat: add debounce — distributed first-signal-fires debounce primitive

Coordinates "first signal in a quiet window does the work; subsequent
signals are absorbed" across processes via Redis. Uses a single
SETNX with PX TTL for atomicity. Cleans up state on callback throw so
the next caller can retry immediately.

The callback receives a refreshDate (Date) so callers can set scheduling
fields like Azure Service Bus's scheduledEnqueueTimeUtc directly without
recomputing the fire time.

Reference: imitates BullMQ's job-deduplication mechanic (SET NX PX) but
with a callback API rather than queue-coupled events. See
https://docs.bullmq.io/guide/jobs/deduplication

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Pull Request Pull Request #62: feat: add debounce — distributed first-signal-fires debounce primitive

Coverage Stats

411 of 413 branches covered (99.52%)

Branch coverage included in aggregate %.

45 of 47 new or added lines in 1 file covered. (95.74%)

2 existing lines in 1 file now uncovered.

1194 of 1196 relevant lines covered (99.83%)

49.2 hits per line