Skip to content

outbox

etrack.ports.outbox

ports/outbox: where an item waits until it is delivered — stored before any network call, claimed, settled.

The transactional outbox, without the host's transaction: a sink appends what it must deliver, keyed by the key the receiver deduplicates by, and only then is it sent; a relay claims what is due, and settles each claim — delivered (ack, gone), tried again later (release), or given up (dead, with the reason, kept until someone requeues it). A claim is a lease: an item claimed by a relay that died is due again when its lease ends. Delivery is at least once: the receiver's deduplication by key makes it exactly once in effect. The guarantee begins at append — what a run held in memory before it ended is the host's to reconcile.

Entry

Bases: Struct

An item in the outbox: its key, its encoded body, where it stands, how often it was tried, when it was appended, when it is next due, and why it last failed.

EntryState

Bases: StrEnum

Where an item stands: waiting to be delivered (due or leased), or given up.

OutboxPort

Bases: Provider, Protocol

Items stored before they are sent, claimed by one relay at a time, settled one by one.