Struct FallbackClient 

pub struct FallbackClient { /* private fields */ }

An SmsClient that tries a list of providers in order, returning the first successful response.

This is the pattern every consumer re-invents for primary / backup failover. FallbackClient encapsulates it once so you don’t have to.

All errors from intermediate providers are collected; if every provider fails, the last error is returned (with a summary of all failures in the message).

Example

use sms_core::FallbackClient;

let client = FallbackClient::new(vec![
    Arc::new(primary_client),
    Arc::new(backup_client),
]);

// Tries primary first; on failure, tries backup.
let response = client.send(SendRequest { .. }).await?;

Implementations

impl FallbackClient

pub fn new(providers: Vec<Arc<dyn SmsClient>>) -> Self

Create a new fallback chain.

Providers are tried in the order given. The list must contain at least one provider.

pub fn from_clients(clients: Vec<Box<dyn SmsClient>>) -> Self

Convenience builder that wraps each client in an Arc for you.

pub fn len(&self) -> usize

Returns how many providers are in the chain.

pub fn is_empty(&self) -> bool

Returns true if the chain is empty (should never happen after new).

Trait Implementations

impl SmsClient for FallbackClient

fn send<'life0, 'life1, 'async_trait>( &'life0 self, req: SendRequest<'life1>, ) -> Pin<Box<dyn Future<Output = Result<SendResponse, SmsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Try each provider in order. Returns the first success or, if all fail, an error summarizing every failure.