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.
- Broker
Config - Hard bounds for a broker instance.
- Consumer
Group - Validated broker consumer group.
- Consumer
Name - Validated broker consumer name.
- Content
Type - Validated parameter-free MIME type.
- Dead
Letter - A terminal failed delivery for one consumer group.
- Dead
Letter Query - Bounded dead-letter list request.
- Delivery
- One leased at-least-once delivery.
- Event
Kind - Validated broker event kind.
- Failure
Code - Stable low-cardinality processing failure code.
- Idempotency
Key - Caller-owned idempotency key, redacted from debug output.
- InMemory
Broker - Process-local bounded broker with fan-out consumer groups and at-least-once leases.
- Message
Envelope - Versioned immutable message delivered to a consumer.
- Message
Headers - Bounded, deterministic message metadata.
- Message
Id - Broker-assigned opaque message identifier.
- Namespace
- Validated broker namespace.
- Publish
Receipt - Result of idempotent publication.
- Publish
Request - Immutable message proposed to a broker.
- Purge
Receipt - Result of explicit terminal-message cleanup.
- Purge
Request - Explicit bounded terminal-message cleanup request.
- Receive
Request - Bounded pull request for one registered consumer group.
- Subscription
Receipt - Result of idempotent subscription registration.
- Subscription
Request - Registers one consumer-group view of a topic.
- System
Clock - Production clock backed by
SystemTime. - Topic
Name - Validated broker topic.
- Trace
Context - Validated W3C
traceparentand optional strict-subsettracestatevalues. - Wire
Envelope Codec - Version-1 canonical binary codec for broker-neutral message envelopes.
Enums§
- Messaging
Error - Errors emitted by the broker-neutral messaging boundary.
- Retry
Disposition - Result of returning a delivery for retry.
- Start
Position - Position used when a consumer group is first registered.
Traits§
- Clock
- Supplies trusted broker time as non-negative Unix milliseconds.
- Message
Admin - Explicit operational surfaces that are intentionally separate from the hot delivery path.
- Message
Broker - Broker operations shared by deterministic fixtures and future remote adapters.
Type Aliases§
- Result
- Convenient result alias for messaging operations.