stores-com / petty-cache / 24942391608

100%

main: 100%

push

github

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>

418 of 421 branches covered (99.29%)

Branch coverage included in aggregate %.

60 of 66 new or added lines in 1 file covered. (90.91%)

1209 of 1215 relevant lines covered (99.51%)

48.59 hits per line