stores-com / petty-cache

100%

main: 100%

Pull #63

github

feat: add throttle — distributed throttle primitive

Coalesces calls for the same key across multiple processes via Redis so
that fn runs at most once per ttl window. The first caller in a window
wins the claim and fn runs to completion; subsequent calls are no-ops.
Errors thrown by fn propagate to the caller — useful for callers that
need to know whether the work succeeded so they can NACK upstream
messages, etc.

Implementation is a single SETNX with PX TTL: claim succeeds, fn runs;
claim fails, return immediately.

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

409 of 410 branches covered (99.76%)

Branch coverage included in aggregate %.

37 of 39 new or added lines in 1 file covered. (94.87%)

1186 of 1188 relevant lines covered (99.83%)

49.52 hits per line