jtdowney / ex_acme / 2ae355855c03d6c25e8d9c5331ec784913fe580a

98%

push

github

feat: add support for Retry-After headers in ACME responses (#5)

Return `{:retry_after, seconds}` when servers send `Retry-After` headers
with 4xx/5xx responses to improve ergonomics for polling flows.

Changes:
- Extract and parse `Retry-After` headers (seconds or ISO8601 format)
- Surface retry information through all fetch functions
- Update documentation with proper backoff example

Improves compliance with RFC 8555 section 6.6 rate limiting guidelines.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Functions can return a structured {:retry_after, seconds} response so
clients can back off and poll instead of relying on fixed sleeps.

* **Documentation**
* README adds "Handling Retry-After Responses" with a sample
polling/backoff pattern; function docs now document the Retry-After
response and an outdated note was removed.

* **Tests**
* New tests validate Retry-After parsing for integer seconds and
multiple date/time formats, including edge cases.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

24 of 26 new or added lines in 1 file covered. (92.31%)

213 of 218 relevant lines covered (97.71%)

132.05 hits per line