Expand description
Durable, bounded, and transport-neutral large snapshot bootstrap contracts.
This crate defines portable manifests, deterministic chunks, restart guards, snapshot leases, staging generations, and atomic activation evidence. Database transactions, object storage, authorization, and application payload interpretation stay in adapters.
Structs§
- Activation
Evidence - Complete fail-closed evidence required by the atomic activation transaction.
- Activation
Outcome - Result of the one atomic activation transaction.
- Authority
Epoch - Monotonic identity of one authoritative history for an
AuthorityId. - Authority
Id - Stable identity of one logical authoritative deployment.
- Bootstrap
Job - Complete durable job record; manifest identity and scope cannot drift on resume.
- Bootstrap
JobId - Durable identity for one local bootstrap attempt.
- Bootstrap
Preflight - Disk and memory budgets checked before transfer begins.
- Bootstrap
Status - Payload-free job status.
- Bootstrap
Store Error - Payload-free adapter failure classification.
- Built
Snapshot - Verified build result; adapters publish the manifest only after every chunk is durable.
- Chunk
Descriptor - One ordered, independently verifiable manifest entry.
- ChunkId
- Stable content-bound chunk identity, independent from a temporary URL.
- Chunk
Progress - Persisted resume metadata; object identity prevents cross-object range append.
- Chunk
Read - One bounded read from a service, HTTP range endpoint, object store, or CDN.
- Chunking
Config - Deterministic chunking and hard resource limits.
- Entity
Range - Inclusive deterministic entity range represented by one chunk.
- Pending
Intent Plan - Payload-free commitment to pending intent preserved across activation.
- Projection
Schema Version - Application projection schema understood by the snapshot payload codec.
- Range
Resume Guard - Stable identity required before appending bytes to a partial chunk.
- Replica
Generation - Monotonic local replica generation; staging and active data never share a generation.
- Snapshot
Boundary - One immutable authoritative state boundary.
- Snapshot
Chunk - Bounded encoded chunk produced alongside a manifest.
- Snapshot
Install Capability - Explicit local adapter snapshot capabilities.
- Snapshot
Lease - Server guarantee that the journal delta after a snapshot boundary remains readable.
- Snapshot
Manifest - Immutable, versioned description of a complete snapshot.
- Snapshot
Request - Request used to capture one database-neutral consistent read view.
- Verified
Activation - Validated activation token passed to an adapter transaction.
Enums§
- Bootstrap
Error - Portable workflow validation failure.
- Bootstrap
Mutation Policy - Policy for local mutations while a replacement generation is staged.
- Bootstrap
State - Durable workflow states. Only the declared transition graph is accepted.
- Bootstrap
Store Error Kind - Retry semantics for adapter failures.
- Chunk
Location - Opaque, refreshable location selected by a transport adapter.
- Chunk
State - Durable state for one independently retryable chunk.
- Compression
Kind - Encoding applied to one chunk object.
- Snapshot
Install Feature - Adapter capability statement used by deployment certification.
Constants§
- MANIFEST_
FORMAT_ VERSION - Current portable large-bootstrap manifest format.
Traits§
- Snapshot
Chunk Source - Transfer adapter for manifests and bounded/ranged chunk reads.
- Snapshot
Lease Store - Authority adapter contract for journal-retention lease acquisition and renewal.
- Snapshot
Read View - Open consistent database view from which bounded canonical snapshot entities are streamed.
- Snapshot
Sink - Local adapter contract for bounded staging and one atomic logical generation swap.
- Snapshot
Source - Authority adapter capable of opening a consistent, scoped snapshot read view.
Functions§
- verify_
activation - Checks every activation guard without mutating local state.