Expand description
Mutable namespace control-object envelopes and payloads.
Structs§
- Acquired
Writer - Captures the writer identity and fencing epoch a session must retain while publishing.
- Checkpoint
Record State - A checkpoint record: pins one metadata manifest (its basis) so garbage collection keeps everything the manifest references.
- Control
Object Envelope - In-memory view of a control object envelope.
- Fork
Basis - Where a fork target’s metadata basis lives before the target publishes its own manifest, and the permanent record of what it was forked from.
- Head
Identity Drift - A successor head changed one of the namespace’s immutable identity fields. Every head a namespace ever publishes carries them forward verbatim from the head that created it.
- Head
State - Carries the authoritative visibility, allocation, and fencing state of a namespace.
- Metadata
Compaction Lease State - Says who owns the objects under one streaming metadata compaction’s job prefix.
- Metadata
Root State - Cold pointer to the best known materialized metadata root.
- Upload
Session State - Tracks one durable content-upload workflow independently of commit publication.
- WalFloor
State - Earliest sequence for which incremental WAL history is retained.
- WalSegment
Pointer - Links one accepted WAL segment identity to its verified sequence range.
- Writer
Block - Who most recently acquired the writer epoch, and when.
Enums§
- Checkpoint
Owner - Durable owner and expiry policy of a checkpoint record.
- Checkpoint
Record Lifecycle - Monotonic lifecycle of a durable checkpoint record.
- Control
Object Kind - Selects one independently versioned mutable control-object family.
- Metadata
Compaction Lease Status - Lifecycle of a compaction lease: two states and one transition.
- Namespace
State - Lifecycle state recorded in the namespace head.
- Proxied
Staging - Staging progress for a service-proxied upload.
- Upload
Session Lifecycle - Monotonic lifecycle of a durable upload session.
- Upload
Session Transport - The transport never changes, and each variant stores only the state required by that upload path.
Functions§
- control_
payload_ checksum - Computes the checksum stored beside canonical JSON for a control state.
- decode_
control_ object - Decodes and verifies a durable JSON control object of
expected_kind. - encode_
control_ object - Encodes a control-object envelope as its durable JSON representation.
- encode_
control_ state - Encodes state in a control-object envelope.
- genesis_
commit_ id - The commit id every namespace’s sequence zero carries, before any commit has landed.
Type Aliases§
- Checkpoint
Record Envelope - Specializes a control envelope for a durable manifest pin.
- Head
State Envelope - Specializes a control envelope for the authoritative namespace head.
- Metadata
Compaction Lease Envelope - Specializes a control envelope for a running compaction’s ownership of its staged output.
- Metadata
Root Envelope - Specializes a control envelope for the selected materialized manifest.
- Upload
Session Envelope - Specializes a control envelope for a durable upload workflow.
- WalFloor
Envelope - Specializes a control envelope for the retained-history floor.