Struct BeginDownloadResponse 

pub struct BeginDownloadResponse {
    pub namespace_id: NamespaceId,
    pub absolute_path: AbsolutePath,
    pub revision_no: RevisionNo,
    pub content_ref: ContentRef,
    pub access: ObjectTransferAccess,
}

A short-lived capability to read one file’s content object, plus everything the reader needs to check what arrives.

The raw object key is deliberately not here, exactly as it is not in a direct_put grant: a client learns a URL that expires, not an address it can revisit.

The grant names one immutable content object, so it does not go stale when the path moves on. A commit that replaces the file writes a new object and leaves this one alone; what the capability reads is what the requested revision held when the grant was issued, and the reference says which bytes those are.

Fields

namespace_id: NamespaceId

Namespace that was read.

absolute_path: AbsolutePath

Absolute path as rendered from stored display names.

revision_no: RevisionNo

Revision the capability reads, resolved from the request.

content_ref: ContentRef

Identity, byte length, and checksum evidence for the object the capability reads. A reader checks the bytes it receives against size_bytes, and against whole_file_sha256 when the reference carries one — a direct-multipart object never will, because nobody ever hashed it with SHA-256.

access: ObjectTransferAccess

Short-lived read capability the client uses without learning the raw object key.

Trait Implementations

impl Clone for BeginDownloadResponse

fn clone(&self) -> BeginDownloadResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BeginDownloadResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BeginDownloadResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for BeginDownloadResponse

impl PartialEq for BeginDownloadResponse

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BeginDownloadResponse

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 BeginDownloadResponse