Skip to main content

Crate rullst_messaging

Crate rullst_messaging 

Source
Expand description

Bounded brokered-messaging contracts for Rullst applications.

This crate is deliberately separate from rullst-connect: identity federation and event brokers have different security, availability, and delivery semantics. The initial implementation provides a deterministic in-memory broker and a shared conformance boundary for future remote adapters. It does not claim Kafka, RabbitMQ, NATS, Redis Streams, SQS/SNS, Pub/Sub, or Pulsar interoperability yet.

Structs§

AckToken
Single-use acknowledgement capability, redacted from debug output.
BrokerConfig
Hard bounds for a broker instance.
ConsumerGroup
Validated broker consumer group.
ConsumerName
Validated broker consumer name.
ContentType
Validated parameter-free MIME type.
DeadLetter
A terminal failed delivery for one consumer group.
DeadLetterQuery
Bounded dead-letter list request.
Delivery
One leased at-least-once delivery.
EventKind
Validated broker event kind.
FailureCode
Stable low-cardinality processing failure code.
IdempotencyKey
Caller-owned idempotency key, redacted from debug output.
InMemoryBroker
Process-local bounded broker with fan-out consumer groups and at-least-once leases.
MessageEnvelope
Versioned immutable message delivered to a consumer.
MessageHeaders
Bounded, deterministic message metadata.
MessageId
Broker-assigned opaque message identifier.
Namespace
Validated broker namespace.
PublishReceipt
Result of idempotent publication.
PublishRequest
Immutable message proposed to a broker.
PurgeReceipt
Result of explicit terminal-message cleanup.
PurgeRequest
Explicit bounded terminal-message cleanup request.
ReceiveRequest
Bounded pull request for one registered consumer group.
SubscriptionReceipt
Result of idempotent subscription registration.
SubscriptionRequest
Registers one consumer-group view of a topic.
SystemClock
Production clock backed by SystemTime.
TopicName
Validated broker topic.
TraceContext
Validated W3C traceparent and optional strict-subset tracestate values.
WireEnvelopeCodec
Version-1 canonical binary codec for broker-neutral message envelopes.

Enums§

MessagingError
Errors emitted by the broker-neutral messaging boundary.
RetryDisposition
Result of returning a delivery for retry.
StartPosition
Position used when a consumer group is first registered.

Traits§

Clock
Supplies trusted broker time as non-negative Unix milliseconds.
MessageAdmin
Explicit operational surfaces that are intentionally separate from the hot delivery path.
MessageBroker
Broker operations shared by deterministic fixtures and future remote adapters.

Type Aliases§

Result
Convenient result alias for messaging operations.