Struct FileBackedBus 

pub struct FileBackedBus { /* private fields */ }

File-backed event bus: wraps InMemoryBus with append-only JSONL persistence.

Every published event is serialized to a JSONL log file before being broadcast to live subscribers. Use FileBackedBus::replay to read back all persisted events (e.g. after a restart).

Implementations

impl FileBackedBus

pub async fn open(path: impl AsRef<Path>, capacity: usize) -> Result<Self>

Open (or create) a JSONL event log at path with the given broadcast capacity.

pub async fn replay(&self, topic_filter: Option<&str>) -> Result<Vec<Event>>

Replay all persisted events, optionally filtered by topic prefix.

pub fn log_path(&self) -> &Path

Return the path to the JSONL log file.

Trait Implementations

impl EventBus for FileBackedBus

fn publish<'life0, 'async_trait>( &'life0 self, event: Event, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Publish an event to all subscribers.

fn subscribe(&self) -> Box<dyn EventSubscriber>

Create a new subscriber that receives all future events.

fn subscriber_count(&self) -> usize

Number of active subscribers.

fn replay_since<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, topic: Option<&'life1 str>, since_id: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Event>>> + Send + 'async_trait>>

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

Replay events since a given event ID (exclusive). Returns events in order. If since_id is None, replays all events. If the bus does not support persistence, returns an empty vec.

fn gc_older_than<'life0, 'async_trait>( &'life0 self, _max_age: Duration, ) -> Pin<Box<dyn Future<Output = Result<usize>> + Send + 'async_trait>>

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

Delete events older than the given age. Returns count of deleted events. No-op for buses that don’t support persistence.