Skip to content

Durability

object-log’s own vocabulary—not Kafka acks. Consumers map externally.

LevelMeaning
BufferedAccepted into the flush buffer; may be lost on crash before flush
DurableObject PUT completed; survives crash; no offset yet
SequencedDurable and sequencer commit returned; stable offsets

Mapping example (consumer-side)

ExternalTypical mapping
fire-and-forget / acks=0Buffered (+ optional later flush)
“bytes on media”Durable
“has a stable offset” / acks=allSequenced

Failure semantics

EventVisibility
PUT fails after retriesNo durable or sequenced ack
Commit failsNo sequenced ack; object may be orphaned; retry uses a fresh key
Duplicate outcomePrior base_offset; no second visibility

Orphan cleanup: reap_orphans with live_object_ids() — only when writers on that data prefix are quiescent.