Skip to main content

rullst_messaging/
lib.rs

1//! Bounded brokered-messaging contracts for Rullst applications.
2//!
3//! This crate is deliberately separate from [`rullst-connect`](https://docs.rs/rullst-connect):
4//! identity federation and event brokers have different security, availability, and delivery
5//! semantics. The initial implementation provides a deterministic in-memory broker and a shared
6//! conformance boundary for future remote adapters. It does not claim Kafka, RabbitMQ, NATS,
7//! Redis Streams, SQS/SNS, Pub/Sub, or Pulsar interoperability yet.
8
9mod admin;
10mod clock;
11mod error;
12mod memory;
13mod model;
14#[cfg(feature = "orm-outbox")]
15mod outbox_relay;
16#[cfg(feature = "sqlite")]
17mod sqlite;
18mod trace;
19mod traits;
20mod types;
21mod validation;
22mod wire;
23
24pub use admin::{DeadLetter, DeadLetterQuery, PurgeReceipt, PurgeRequest};
25pub use clock::{Clock, SystemClock};
26pub use error::{MessagingError, Result};
27pub use memory::InMemoryBroker;
28pub use model::{
29    Delivery, MessageEnvelope, PublishReceipt, PublishRequest, ReceiveRequest, RetryDisposition,
30    SubscriptionReceipt, SubscriptionRequest,
31};
32#[cfg(feature = "orm-outbox")]
33pub use outbox_relay::{OrmOutboxRelay, OrmOutboxRelayError, OutboxRelayReceipt};
34#[cfg(feature = "sqlite")]
35pub use sqlite::{MessagingKeyring, MessagingStorageKey, SqliteBroker};
36pub use trace::TraceContext;
37pub use traits::{MessageAdmin, MessageBroker};
38pub use types::{
39    AckToken, BrokerConfig, ConsumerGroup, ConsumerName, ContentType, EventKind, FailureCode,
40    IdempotencyKey, MessageHeaders, MessageId, Namespace, StartPosition, TopicName,
41};
42pub use wire::WireEnvelopeCodec;