libfw-client 0.4.1 → 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.1",
+  "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

@@ -17,14 +17,10 @@ export class LibfwClient {
     done_bytes(): number;
     /**
      * Download a single file at `file_path` into the chosen local directory.
-     *
-     * Resolves with the number of bytes written.
      */
     download_file(base_url: string, token: string, file_path: string): Promise<any>;
     /**
      * Download every file under the virtual `dirPath` (empty = root).
-     *
-     * Resolves with the number of bytes written.
      */
     download_folder(base_url: string, token: string, dir_path: string): Promise<any>;
     /**
@@ -33,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);
@@ -74,8 +70,6 @@ export class LibfwClient {
     tune_state(): any;
     /**
      * Upload the files reported by the JS `getFileList` callback.
-     *
-     * Resolves with the number of bytes uploaded.
      */
     upload(base_url: string, token: string): Promise<any>;
 }
@@ -111,7 +105,8 @@ export interface InitOutput {
     readonly start: () => void;
     readonly wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_b2c787b844a3ac79___JsError___true_: (a: number, b: number, c: any) => [number, number];
     readonly wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___js_sys_209827a80d159db4___Function_fn_wasm_bindgen_b2c787b844a3ac79___JsValue_____wasm_bindgen_b2c787b844a3ac79___sys__Undefined___js_sys_209827a80d159db4___Function_fn_wasm_bindgen_b2c787b844a3ac79___JsValue_____wasm_bindgen_b2c787b844a3ac79___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___web_sys_b45f848915fa3e2d___features__gen_ProgressEvent__ProgressEvent______true_: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true_: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true__2: (a: number, b: number, c: any) => void;
     readonly wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke_______true_: (a: number, b: number) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/pkg/libfw_client.js

@@ -30,8 +30,6 @@ export class LibfwClient {
     }
     /**
      * Download a single file at `file_path` into the chosen local directory.
-     *
-     * Resolves with the number of bytes written.
      * @param {string} base_url
      * @param {string} token
      * @param {string} file_path
@@ -49,8 +47,6 @@ export class LibfwClient {
     }
     /**
      * Download every file under the virtual `dirPath` (empty = root).
-     *
-     * Resolves with the number of bytes written.
      * @param {string} base_url
      * @param {string} token
      * @param {string} dir_path
@@ -76,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
      */
@@ -157,8 +153,6 @@ export class LibfwClient {
     }
     /**
      * Upload the files reported by the JS `getFileList` callback.
-     *
-     * Resolves with the number of bytes uploaded.
      * @param {string} base_url
      * @param {string} token
      * @returns {Promise<any>}
@@ -273,9 +267,16 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
+        __wbg_catch_c1a60df4c30d76d3: function(arg0, arg1) {
+            const ret = arg0.catch(arg1);
+            return ret;
+        },
         __wbg_clearInterval_2e2069e95ad09d4f: function(arg0, arg1) {
             arg0.clearInterval(arg1);
         },
+        __wbg_clearTimeout_8f80437be2324e09: function(arg0, arg1) {
+            arg0.clearTimeout(arg1);
+        },
         __wbg_encodeURIComponent_d0140ae6e13eb27b: function(arg0, arg1) {
             const ret = encodeURIComponent(getStringFromWasm0(arg0, arg1));
             return ret;
@@ -455,10 +456,6 @@ function __wbg_get_imports() {
             const ret = Date.now();
             return ret;
         },
-        __wbg_of_5f1b88183ddb5d94: function(arg0, arg1) {
-            const ret = Array.of(arg0, arg1);
-            return ret;
-        },
         __wbg_open_90286a4ce0ae2098: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5) {
             arg0.open(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), arg5 !== 0);
         }, arguments); },
@@ -476,10 +473,6 @@ function __wbg_get_imports() {
         __wbg_queueMicrotask_6a09b7bc46549209: function(arg0) {
             queueMicrotask(arg0);
         },
-        __wbg_race_ac5c7b465abcfa15: function(arg0) {
-            const ret = Promise.race(arg0);
-            return ret;
-        },
         __wbg_read_8afa15f12a160ef8: function(arg0) {
             const ret = arg0.read();
             return ret;
@@ -508,10 +501,6 @@ function __wbg_get_imports() {
         __wbg_setRequestHeader_fe390ff50d349432: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
             arg0.setRequestHeader(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
         }, arguments); },
-        __wbg_setTimeout_725a27c387d005c7: function() { return handleError(function (arg0, arg1, arg2, arg3) {
-            const ret = arg0.setTimeout(arg1, arg2, arg3);
-            return ret;
-        }, arguments); },
         __wbg_setTimeout_cfa2cf195c3738db: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = arg0.setTimeout(arg1, arg2);
             return ret;
@@ -590,6 +579,10 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1);
             return ret;
         },
+        __wbg_then_e0960b859f3ff223: function(arg0, arg1) {
+            const ret = arg0.then(arg1);
+            return ret;
+        },
         __wbg_total_21672ff1bd8d23ea: function(arg0) {
             const ret = arg0.total;
             return ret;
@@ -599,26 +592,31 @@ function __wbg_get_imports() {
             return ret;
         }, arguments); },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 196, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 209, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_b2c787b844a3ac79___JsError___true_);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("ProgressEvent")], shim_idx: 5, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___web_sys_b45f848915fa3e2d___features__gen_ProgressEvent__ProgressEvent______true_);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 5, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true_);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 7, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("ProgressEvent")], shim_idx: 5, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true__2);
+            return ret;
+        },
+        __wbindgen_cast_0000000000000004: function(arg0, arg1) {
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 8, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke_______true_);
             return ret;
         },
-        __wbindgen_cast_0000000000000004: function(arg0) {
+        __wbindgen_cast_0000000000000005: function(arg0) {
             // Cast intrinsic for `F64 -> Externref`.
             const ret = arg0;
             return ret;
         },
-        __wbindgen_cast_0000000000000005: function(arg0, arg1) {
+        __wbindgen_cast_0000000000000006: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
@@ -643,8 +641,12 @@ function wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke_______true
     wasm.wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke_______true_(arg0, arg1);
 }
 
-function wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___web_sys_b45f848915fa3e2d___features__gen_ProgressEvent__ProgressEvent______true_(arg0, arg1, arg2) {
-    wasm.wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___web_sys_b45f848915fa3e2d___features__gen_ProgressEvent__ProgressEvent______true_(arg0, arg1, arg2);
+function wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true_(arg0, arg1, arg2) {
+    wasm.wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true_(arg0, arg1, arg2);
+}
+
+function wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true__2(arg0, arg1, arg2) {
+    wasm.wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true__2(arg0, arg1, arg2);
 }
 
 function wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_b2c787b844a3ac79___JsError___true_(arg0, arg1, arg2) {

package/pkg/libfw_client_bg.wasm.d.ts

@@ -21,7 +21,8 @@ export const libfwclient_upload: (a: number, b: number, c: number, d: number, e:
 export const start: () => void;
 export const wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue__core_ed718c3d60ebd546___result__Result_____wasm_bindgen_b2c787b844a3ac79___JsError___true_: (a: number, b: number, c: any) => [number, number];
 export const wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___js_sys_209827a80d159db4___Function_fn_wasm_bindgen_b2c787b844a3ac79___JsValue_____wasm_bindgen_b2c787b844a3ac79___sys__Undefined___js_sys_209827a80d159db4___Function_fn_wasm_bindgen_b2c787b844a3ac79___JsValue_____wasm_bindgen_b2c787b844a3ac79___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
-export const wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___web_sys_b45f848915fa3e2d___features__gen_ProgressEvent__ProgressEvent______true_: (a: number, b: number, c: any) => void;
+export const wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true_: (a: number, b: number, c: any) => void;
+export const wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke___wasm_bindgen_b2c787b844a3ac79___JsValue______true__2: (a: number, b: number, c: any) => void;
 export const wasm_bindgen_b2c787b844a3ac79___convert__closures_____invoke_______true_: (a: number, b: number) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

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.1",
+  "version": "0.4.3",
   "license": "MIT",
   "repository": {
     "type": "git",