libfw-client 0.4.2 → 0.4.3

package/README.md

@@ -102,10 +102,10 @@ dist/libfw-client.umd.js   UMD bundle (after build:umd)
   - `downloadWindow: number` (default `4`) — in-flight byte-range window per
     single file download (how many concurrent `Range` GETs); raise it on
     high-latency links. `1` disables parallelism (sequential downloads).
-  - `downloadChunkSize: number` (default `262144`, 256 KiB) — byte range size
-    for parallel downloads; the engine reorders in-flight chunks in memory
-    (worst case ≈ `downloadWindow * downloadChunkSize` bytes) so the SDK
-    still receives data in order.
+  - `chunkSize: number` (default `2097152`, 2 MiB) — shared size used for
+    both upload chunks and parallel download ranges; the engine reorders
+    in-flight chunks in memory (worst case ≈ `downloadWindow * chunkSize`
+    bytes) so the SDK still receives data in order.
   - `downloadMode: 'auto' | 'fs' | 'browser'` (default `'auto'`) — `'fs'`
     streams downloads through the File System Access API; `'browser'` buffers
     and triggers a traditional browser download (folders become `.zip`);
@@ -130,7 +130,7 @@ dist/libfw-client.umd.js   UMD bundle (after build:umd)
 - `tuneStatus() → { phase, params, stats, capsHash } | null` — live
   adaptive-tuning status. `phase` is `uninitialized | ramping | settled |
   degraded`; `params` is `{ concurrency, uploadWindow, downloadWindow,
-  chunkSize, downloadChunkSize, compressLevel }`; `stats` is
+  chunkSize, compressLevel }`; `stats` is
   `{ rttMs, mbps }` (EWMA request RTT, last-window throughput). `null`
   until the WASM engine is initialised.
 - Events: with `autoTune` enabled, `onEvent` additionally receives

package/index.d.ts

@@ -55,10 +55,8 @@ export interface TuningParams {
   uploadWindow: number;
   /** In-flight byte-range GETs per single-file download. */
   downloadWindow: number;
-  /** Upload chunk size in bytes. */
+  /** Shared chunk size in bytes for uploads and parallel downloads. */
   chunkSize: number;
-  /** Download byte-range size in bytes. */
-  downloadChunkSize: number;
   /** zrip compression level (negative = faster, positive = smaller). */
   compressLevel: number;
 }
@@ -127,13 +125,6 @@ export interface LibfwClientOptions {
    * parallelism (sequential downloads). Default `4`.
    */
   downloadWindow?: number;
-  /**
-   * Byte range size for parallel downloads. The engine reorders in-flight
-   * chunks in memory (worst case ≈ `downloadWindow * downloadChunkSize`
-   * bytes) so the SDK still receives data strictly in order. Default
-   * `262144` (256 KiB).
-   */
-  downloadChunkSize?: number;
   /** Negotiate zrip compression. Default `true`. */
   compress?: boolean;
   /** Upload chunk size in bytes. Default 2 MiB. */
@@ -291,7 +282,7 @@ export declare class LibfwClient {
    * @returns `{ phase, params, stats, capsHash }` — `phase` is
    *   `uninitialized | ramping | settled | degraded`; `params` holds the
    *   tuned `concurrency` / `uploadWindow` / `downloadWindow` / `chunkSize`
-   *   / `downloadChunkSize` / `compressLevel`; `stats` is
+   *   / `compressLevel`; `stats` is
    *   `{ rttMs, mbps }` (EWMA request RTT, last-window throughput).
    *   `null` until the WASM engine is initialised (or when `autoTune` is
    *   disabled, `phase` stays `uninitialized`).

package/index.js

@@ -207,16 +207,11 @@ export class LibfwClient {
    *        transfer), so a single file's throughput is bounded by bandwidth
    *        instead of one connection's `chunkSize / RTT` on high-latency
    *        links. `1` disables parallelism (sequential downloads).
-   * @param {number} [options.downloadChunkSize=262144] byte range size for
-   *        parallel downloads (256 KiB default). Smaller than the upload
-   *        chunk on purpose: the engine reorders in-flight chunks in memory
-   *        (worst case ≈ `downloadWindow * downloadChunkSize` bytes) so the
-   *        SDK still receives data strictly in order.
    * @param {boolean} [options.compress=true] negotiate zrip compression
-   * @param {number} [options.chunkSize=2097152] upload chunk size in bytes
-   *        (each chunk is split into many small ~64 KiB compressed frames, so
-   *        any value works; larger = fewer, bigger POST requests — bounded
-   *        only by the server's upload limit and client memory)
+   * @param {number} [options.chunkSize=2097152] shared chunk size in bytes for
+   *        both upload chunks and parallel download ranges. The same value is
+   *        used on both paths, and any value works as long as the server and
+   *        memory budget permit it (larger = fewer, bigger requests).
    * @param {number} [options.maxRetries=3] retries per chunk/file before failing
    * @param {number} [options.baseRetryDelayMs=500] initial backoff (ms)
    * @param {number} [options.maxRetryDelayMs=30000] backoff ceiling (ms)
@@ -272,7 +267,6 @@ export class LibfwClient {
       concurrency: 4,
       uploadWindow: 8,
       downloadWindow: 4,
-      downloadChunkSize: 256 * 1024,
       compress: true,
       chunkSize: 2 * 1024 * 1024,
       maxRetries: 3,
@@ -338,7 +332,6 @@ export class LibfwClient {
       concurrency: this._options.concurrency,
       uploadWindow: this._options.uploadWindow,
       downloadWindow: this._options.downloadWindow,
-      downloadChunkSize: this._options.downloadChunkSize,
       compress: this._options.compress,
       chunkSize: this._options.chunkSize,
       maxRetries: this._options.maxRetries,
@@ -1246,8 +1239,7 @@ export class LibfwClient {
    *
    * - `phase`: `uninitialized | ramping | settled | degraded`
    * - `params`: `{ concurrency, uploadWindow, downloadWindow, chunkSize,
-   *   downloadChunkSize, compressLevel }` — the parameters the engine is
-   *   currently tuned to
+   *   compressLevel }` — the parameters the engine is currently tuned to
    * - `stats`: `{ rttMs, mbps }` — EWMA request RTT and last-window
    *   throughput of the most recent transfer
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libfw-client",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "High-performance streaming file & folder transfer SDK for the browser (libfw WASM engine + File System Access API + IndexedDB resume).",
   "license": "MIT",
   "type": "module",

package/pkg/libfw_client.d.ts

@@ -29,8 +29,8 @@ export class LibfwClient {
     has_callbacks(): boolean;
     /**
      * Create an engine. `options` may include:
-     * `{ concurrency, uploadWindow, downloadWindow, downloadChunkSize,
-     * compress, compressLevel, chunkSize, maxRetries, baseRetryDelayMs,
+     * `{ concurrency, uploadWindow, downloadWindow, compress,
+     * compressLevel, chunkSize, maxRetries, baseRetryDelayMs,
      * maxRetryDelayMs, timeoutMs, autoTune, tuneTtlMs }`.
      */
     constructor(opts: any);

package/pkg/libfw_client.js

@@ -72,8 +72,8 @@ export class LibfwClient {
     }
     /**
      * Create an engine. `options` may include:
-     * `{ concurrency, uploadWindow, downloadWindow, downloadChunkSize,
-     * compress, compressLevel, chunkSize, maxRetries, baseRetryDelayMs,
+     * `{ concurrency, uploadWindow, downloadWindow, compress,
+     * compressLevel, chunkSize, maxRetries, baseRetryDelayMs,
      * maxRetryDelayMs, timeoutMs, autoTune, tuneTtlMs }`.
      * @param {any} opts
      */

package/pkg/package.json

@@ -2,7 +2,7 @@
   "name": "libfw-client",
   "type": "module",
   "description": "WASM engine + JS SDK for libfw browser clients",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "license": "MIT",
   "repository": {
     "type": "git",