Struct TransferBuilder 

pub struct TransferBuilder<'a, E> { /* private fields */ }

Builds a streaming transfer. Obtained from Cx::upload / Cx::download; finished with start, which subscribes and returns the key.

Implementations

impl<'a, E> TransferBuilder<'a, E>

pub fn method(self, m: impl Into<String>) -> Self

Override the upload method (default PUT). No effect on download.

pub fn multipart(self, field: impl Into<String>) -> Self

Send as multipart/form-data: the file becomes a part named field, emitted after any text field()s. Flips the default method to POST (an explicit method() wins). Upload-only.

pub fn field(self, name: impl Into<String>, value: impl Into<String>) -> Self

Add a text field to the multipart body (order preserved). No effect unless multipart() was called; no effect on download.

pub fn filename(self, name: impl Into<String>) -> Self

Override the multipart file part’s filename= (default: inferred from the source).

pub fn file_content_type(self, ct: impl Into<String>) -> Self

Override the multipart file part’s Content-Type (default: application/octet-stream).

Honored on iOS and Android. On the web shell the browser derives the part’s content type from the Blob’s own MIME type, so this override is native-only in v1.

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

Add a request header (order preserved, repeats allowed).

pub fn bearer(self, token: impl AsRef<str>) -> Self

Sugar for header("Authorization", format!("Bearer {token}")).

pub fn start( self, key: impl Into<String>, on_event: impl Fn(TransferEvent) -> E + Send + 'static, ) -> String

Subscribe under key. on_event fires per progress tick and once at Done. Returns key so the caller can cx.unsubscribe(key).