What's Changed

🔒 Security

This release backports two features to prevent unbounded memory use: theresponse_handlers keyword argument toNet::IMAP.new so response handlers can be added before the server can send any responses (#427), and themax_response_size config attribute (#445,GHSA-j3g3-5qv5-52mj,CVE-2025-43857, reported by@Masamuneee).

Known Issues

Fixed inv0.4.22: Older versions of Ruby 3.0 on Mac OS crash whennet/imap is required (#471).

Added

• ✨ Addresponse_handlers kwarg toNet::IMAP.new by@nevans in✨ Addresponse_handlers kwarg toNet::IMAP.new (backport #419 to 0.4) #427
  • Backports✨ Addresponse_handlers kwarg toNet::IMAP.new #419
• ✨ Limit max_response_size by@nevans in✨ Limit max_response_size (backport 0.4) #445
  • Backports✨ Limitmax_response_size #444

Documentation

• 📚 Backport documentation to v0.4 by@nevans in📚 Backport documentation to v0.4 #426
  • Backports📚 Improve docs for unbounded memory use and thread safety #418,📚 Impove SequenceSet docs #420, documentation only from✨ Track IMAP connection state #416, and📚 Doc improvements for open_timeout, etc #424

Other Changes

• ♻️ Update versioned default configs by@nevans in♻️ Update versioned default configs (backports #412) #413
  • Backports♻️ ReorganizeConfig.version_defaults creation #412
• ♻️ Refactorget_response by@nevans in♻️ Refactorget_response (backports #422 to 0.4) #431
  • Backports♻️ RefactorNet::IMAP#get_response (internal) #422
• ♻️ Rational config versions by@nevans in♻️ Rational config versions (backport #429 to v0.4) #430
  • Backports♻️ Rational config versions #429
• ♻️ Extract ResponseReader from get_response by@nevans in♻️ Extract ResponseReader from get_response (backport #433) #434
  • Backports♻️ Extract ResponseReader fromget_response #433
• ♻️ Refactoring by@nevans in♻️ Refactoring (backports) #436
  • Backports♻️ Refactor Config attr type coercion #417 and♻️ Refactor ResponseReader #435

Miscellaneous

• ✅ Various test improvements to v0.4 by@nevans in✅ Backport various test improvements to v0.4 #425
  • Backports✅ Make FakeServer more robust against disconnect #414,✅ Improvements to FakeServer (tests only) #415,✅ Ignore more IO errors in some FakeServer tests #421, andassert_pattern from minitest (originally in✨ Add basic ESearch support #333)

Full Changelog:v0.4.19...v0.4.20