asx-rs 0.14.0

AS2 and AS4 B2B messaging library for Rust — signing, encryption, MDN, and ebMS3/AS4 profile support
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

use super::{
    AsxError, AsxEvent, BackpressureAction, ErrorCode, ErrorContext, EventBus, EventEmissionMode,
    Result, SessionContext,
};

pub(super) fn validate_lagged_backpressure(bus: &EventBus, session: &SessionContext) -> Result<()> {
    if bus.backpressure.action == BackpressureAction::FailClosed
        && let Some(max_lagged) = bus.backpressure.max_lagged
    {
        // Window-aware read: resets a stale count from an expired window so a
        // past burst cannot wedge FailClosed forever (see current_window_lagged).
        let lagged = bus.metrics.current_window_lagged();
        if lagged >= max_lagged {
            return Err(AsxError::new(
                ErrorCode::ReliabilityFailure,
                format!(
                    "event bus backpressure threshold exceeded: \
                     {lagged} lagged events in window (limit {max_lagged})"
                ),
                ErrorContext::new("event_bus_emit").with_session_id(session.session_id()),
            ));
        }
    }
    Ok(())
}

pub(super) fn handle_broadcast_send_failure(
    bus: &EventBus,
    session: &SessionContext,
    event: &AsxEvent,
    dropped: u64,
) -> Result<()> {
    tracing::warn!(
        session_id = %session.session_id(),
        partner_id = %session.partner_id(),
        event_kind = event.kind(),
        dropped,
        emission_mode = ?bus.emission_mode,
        "event bus dropped event"
    );

    if bus.backpressure.action == BackpressureAction::FailClosed
        && let Some(max_dropped) = bus.backpressure.max_dropped
        && dropped >= max_dropped
    {
        return Err(AsxError::new(
            ErrorCode::ReliabilityFailure,
            format!(
                "event bus backpressure threshold exceeded: \
                 {dropped} dropped events (limit {max_dropped})"
            ),
            ErrorContext::new("event_bus_emit").with_session_id(session.session_id()),
        ));
    }

    match bus.emission_mode {
        EventEmissionMode::BestEffort => Ok(()),
        EventEmissionMode::StrictWithAuditFallback | EventEmissionMode::StrictTransactional => {
            Err(AsxError::new(
                ErrorCode::ReliabilityFailure,
                "event bus send failed (no active subscribers)",
                ErrorContext::new("event_bus_emit").with_session_id(session.session_id()),
            ))
        }
    }
}