Struct WaterfallRouter 

pub struct WaterfallRouter { /* private fields */ }

Waterfall router: tries each provider in order, falls back to the next on failure.

Optimizes cost by trying cheaper channels (email) before expensive ones (SMS). For OTP delivery, automatically detects whether the recipient is an email address or phone number and routes accordingly.

Implementations

impl WaterfallRouter

pub fn new() -> Self

Creates an empty router with no providers.

pub fn add_sms(self, provider: Arc<dyn SmsSender>) -> Self

Adds an SMS provider to the routing chain. Providers are tried in insertion order.

pub fn add_email(self, provider: Arc<dyn EmailSender>) -> Self

Adds an email provider to the routing chain. Providers are tried in insertion order.

pub async fn send_otp( &self, recipient: &str, code: &str, app_name: &str, ) -> Result<SendResult, ChorusError>

Sends an OTP via waterfall routing. Routes to email if recipient contains @, otherwise SMS.

pub async fn send_sms( &self, msg: &SmsMessage, ) -> Result<SendResult, ChorusError>

Sends an SMS directly, trying each SMS provider in order until one succeeds.

pub async fn send_email( &self, msg: &EmailMessage, ) -> Result<SendResult, ChorusError>

Sends an email directly, trying each email provider in order until one succeeds.

Trait Implementations

impl Default for WaterfallRouter

fn default() -> Self

Returns the “default value” for a type.