Struct NotificaClient 

pub struct NotificaClient { /* private fields */ }

Async HTTP client for the Notifica webhook API.

Create one instance per application (it holds an internal connection pool) and reuse it for all notifications.

Example

use notifica_crate::{EmailPayload, Notification, NotificaClient};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = NotificaClient::new("http://localhost:8000", "my-tenant");

    client.send(
        "user_registered",
        Notification::new()
            .email(EmailPayload::new("alice@example.com").subject("Welcome!")),
    ).await?;

    Ok(())
}

Implementations

impl NotificaClient

pub fn new(base_url: impl Into<String>, tenant_id: impl Into<String>) -> Self

Create a client with default reqwest::Client settings.

Panics if base_url or tenant_id is empty.

pub fn with_http_client( base_url: impl Into<String>, tenant_id: impl Into<String>, http: Client, ) -> Self

Create a client with a custom reqwest::Client.

Use this when you need custom timeouts, TLS settings, or middleware.

pub async fn send( &self, event_name: impl Into<String>, notification: Notification, ) -> NotificaResult<()>

Send a notification to the given event name.

Calls POST {base_url}/webhook/{tenant_id}/{event_name} with the serialized Notification as the JSON body.

Returns Ok(()) on a 200 response. Any other status code is treated as NotificaError::UnexpectedResponse.