Struct ClientConfig 

pub struct ClientConfig {
    pub concurrency: usize,
    pub upload_window: usize,
    pub download_window: usize,
    pub download_chunk_size: u64,
    pub compress: bool,
    pub chunk_size: u64,
    pub max_retries: u32,
    pub base_retry_delay_ms: u32,
    pub max_retry_delay_ms: u32,
    pub timeout_ms: u32,
    pub ws_url: Option<String>,
}

Runtime configuration of the WASM engine.

Fields

concurrency: usize

Maximum number of concurrently-transferring files (default 4).

upload_window: usize

In-flight chunk window for a single file’s upload (default 8).

Independent of concurrency: one file keeps up to upload_window chunks in flight, so a high-latency link stays saturated (throughput is bounded by bandwidth, not chunk_size / RTT).

download_window: usize

In-flight byte-range window for a single file’s download (default 4).

A large file is downloaded as download_window concurrent Range GETs so its throughput is bounded by bandwidth instead of one connection’s chunk_size / RTT (tus-style parallel transfer). Set to 1 to fall back to the sequential single-connection path.

download_chunk_size: u64

Chunk size for parallel downloads (default 256 KiB).

Smaller than the upload chunk on purpose: the WASM engine reorders in-flight chunks in memory so the SDK keeps receiving them in order (append-mode writes), and download_window * download_chunk_size is that buffer’s worst-case size.

compress: bool

Request zrip compression from the server / compress uploads.

chunk_size: u64

Fixed chunk size used to slice files (default 2 MiB).

max_retries: u32

Maximum retries per chunk/file (default 3).

base_retry_delay_ms: u32

Initial backoff delay in ms (default 500).

max_retry_delay_ms: u32

Backoff ceiling in ms (default 30s).

timeout_ms: u32

Per-request timeout in ms (default 60s).

ws_url: Option<String>

Optional explicit WebSocket endpoint (e.g. wss://host/ws).

When None the engine derives the ws(s):// URL from the HTTP baseUrl passed to each transfer method.

Implementations

impl ClientConfig

pub fn from_js(opts: &JsValue) -> ClientConfig

Parse configuration from a JS object literal, e.g. { concurrency: 4, compress: true, chunkSize: 2097152 }.

Safe to call with null/undefined (returns defaults) — this also keeps native (non-wasm) unit tests runnable.

pub fn backoff_ms(&self, attempt: u32) -> u32

Exponential backoff delay for a failed attempt (0-based).

2^attempt * base, clamped to max. Bounded so a hung peer cannot grow the delay without limit.

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfig

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

Formats the value using the given formatter.

impl Default for ClientConfig

fn default() -> Self

Returns the “default value” for a type.