authx-core 0.1.2

Core authentication primitives for authx-rs: crypto, JWT/EdDSA, RBAC/ABAC, events, and models
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

use std::sync::Arc;

use tokio::sync::broadcast;
use tracing::instrument;

use super::types::AuthEvent;

const BUS_CAPACITY: usize = 256;

/// Async broadcast event bus.
///
/// Plugins subscribe at startup and receive every event emitted during
/// request processing. Receivers that fall behind drop old events (broadcast
/// semantics — no backpressure, no blocking on slow listeners).
#[derive(Clone)]
pub struct EventBus {
    sender: Arc<broadcast::Sender<AuthEvent>>,
}

impl EventBus {
    pub fn new() -> Self {
        let (sender, _) = broadcast::channel(BUS_CAPACITY);
        Self {
            sender: Arc::new(sender),
        }
    }

    pub fn subscribe(&self) -> broadcast::Receiver<AuthEvent> {
        self.sender.subscribe()
    }

    #[instrument(skip(self, event), fields(event = event.name()))]
    pub fn emit(&self, event: AuthEvent) {
        let name = event.name();
        match self.sender.send(event) {
            Ok(n) => tracing::debug!(listeners = n, event = name, "event emitted"),
            Err(_) => tracing::debug!(event = name, "no listeners for event"),
        }
    }
}

impl Default for EventBus {
    fn default() -> Self {
        Self::new()
    }
}