Struct IntegrationEventBus 

pub struct IntegrationEventBus { /* private fields */ }

Central event bus for integration events across all bounded contexts

The IntegrationEventBus is the heart of cross-module communication. It receives events from publishers and dispatches them to registered handlers based on pattern matching.

Features

• Type-erased: Events are serialized to JSON, allowing loose coupling
• Pattern matching: Handlers subscribe to event patterns with wildcards
• Persistence: Optional event history for replay/audit
• Dead letter queue: Failed events are captured for debugging

Thread Safety

The bus is fully thread-safe and can be cloned and shared across tasks.

Implementations

impl IntegrationEventBus

pub fn new() -> Self

Create a new integration event bus with default configuration

pub fn with_config(config: IntegrationBusConfig) -> Self

Create a new integration event bus with custom configuration

pub async fn publish<E: IntegrationEvent>( &self, event: E, ) -> Result<(), EventError>

Publish an integration event

The event is serialized to JSON and wrapped in an envelope. It’s then broadcast to all subscribers and dispatched to matching handlers.

Errors

Returns EventError::SerializationError if the event cannot be serialized.

pub async fn publish_envelope( &self, envelope: IntegrationEventEnvelope, ) -> Result<(), EventError>

Publish a pre-built envelope

Use this when you already have an envelope (e.g., forwarding from another bus).

pub async fn register_handler(&self, handler: Arc<dyn IntegrationEventHandler>)

Register an integration event handler

The handler will be called for events matching any of its patterns.

pub fn subscribe(&self) -> Receiver<IntegrationEventEnvelope>

Subscribe to all integration events (returns a broadcast receiver)

Use this for monitoring, logging, or custom event processing.

pub async fn history(&self) -> Vec<IntegrationEventEnvelope>

Get event history (if persistence enabled)

pub async fn events_by_pattern( &self, pattern: &str, ) -> Vec<IntegrationEventEnvelope>

Get events by type pattern

pub async fn events_for_aggregate( &self, aggregate_id: &str, ) -> Vec<IntegrationEventEnvelope>

Get events for a specific aggregate

pub async fn dead_letters(&self) -> Vec<DeadLetterEntry>

Get dead letter queue entries

pub async fn clear_dead_letters(&self)

Clear dead letter queue

pub async fn clear_history(&self)

Clear event history

pub async fn handler_count(&self) -> usize

Get handler count

pub async fn registered_patterns(&self) -> Vec<String>

Get registered patterns

Trait Implementations

impl Clone for IntegrationEventBus

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for IntegrationEventBus

fn default() -> Self

Returns the “default value” for a type.