Enum UploadSessionLifecycle 

pub enum UploadSessionLifecycle {
    Open {
        expires_at_ms: u64,
        staged_content: Option<ContentRef>,
    },
    Completed {
        completed_at_ms: u64,
        content_ref: ContentRef,
    },
    Aborted {
        aborted_at_ms: u64,
    },
}

Lifecycle of a durable upload session: one live state and two terminal ones, with no way back.

A session opens with a lease and either completes or is aborted. The compare-and-swap that makes one of those two land is the serialization point for the whole upload — provider state follows the durable transition, never the other way around — so whichever transition wins is simply what happened, and the loser reports a terminal error rather than undoing anything. Nothing returns a session to open: a client that wants another try begins another session, which mints its own content identity.

Variants

Open

The one state that may stage bytes and complete. Live until its lease passes, after which garbage collection aborts it.

Fields

expires_at_ms: u64

Unix-millisecond instant after which the session is abandoned. The record carries it so no session transition depends on an object’s provider timestamp.

staged_content: Option<ContentRef>

Content this session has already written and proven, or None before any bytes have passed validation.

Only a service-proxied session stages: the other transports write past this server, so what they wrote is established at completion. Staged content lives here rather than beside the state because it is the one thing about an open session that changes, and because a terminal session has no use for it — a completed one names its content once, below.

Completed

Terminal: the content is durable and verified. This is the only state a receipt may be minted from, and the content reference it carries is what every re-mint and idempotent completion retry answers with.

Fields

completed_at_ms: u64

Unix-millisecond stamp written by the completing compare-and-swap, and the only input to when the content may be reclaimed.

content_ref: ContentRef

Verified immutable content this session settled on, and the one place a completed session’s reference exists.

Aborted

Terminal: the session will never select content. Its content identity was never published — a receipt exists only for a completed session — so the object it named belongs to nobody and is deleted.

Fields

aborted_at_ms: u64

Unix-millisecond stamp written by the aborting compare-and-swap, and the only input to when the record may be deleted.

Trait Implementations

impl Clone for UploadSessionLifecycle

fn clone(&self) -> UploadSessionLifecycle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UploadSessionLifecycle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UploadSessionLifecycle

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for UploadSessionLifecycle

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for UploadSessionLifecycle

impl PartialEq for UploadSessionLifecycle

fn eq(&self, other: &UploadSessionLifecycle) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for UploadSessionLifecycle

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UploadSessionLifecycle