Feat/message send router

[jackburridge]

Add AsyncFast message send router

Description

Summary

This PR adds reusable routing support for AsyncFast message send operations and refactors channel routing to share the same underlying route-matching logic.

Changes

• Extracts address pattern matching into a generic Router utility.
• Refactors channel dispatch to use ChannelRouter, keeping channel resolution behavior centralized.
• Moves ChannelNotFoundError into shared routing utilities so it can be used by both receive and send routing.
• Adds MessageSendRouter, an async context manager that routes message.send events to different send backends based on event address.
• Supports a default message sender for unmatched routes.
• Adds documentation and an example showing mixed outbound routing to Kafka and SQS.
• Adds tests for channel routing refactor coverage and message send router behavior.

Why

AsyncFast already supports address-based routing for inbound channels, but outbound message sends previously had to be wired to a single send backend. This makes it possible to route different outgoing message types to different AMGI send implementations while preserving lifecycle management through async context managers.

Testing

• Added tests for MessageSendRouter default routing.
• Added tests for explicit address-pattern routing.
• Updated channel tests for the new explicit parameter passing path.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[read-the-docs-community]

Documentation build overview

📚 AsyncFast | 🛠️ Build #32316941 | 📁 Comparing af457ca against latest (42352a9)

  🔍 Preview build  

1 files changed

+ message_send_router.html