libfw-client 0.3.0 → 0.3.2

package/index.js

@@ -191,11 +191,16 @@ export class LibfwClient {
    *        (same-origin when empty). The engine drives all control commands
    *        and data transfer over plain HTTP (parallel `Range` downloads,
    *        tus-style chunked uploads) — no WebSocket is used.
-   * @param {number} [options.concurrency=4] max concurrently-transferring files
-   * @param {number} [options.uploadWindow=8] in-flight chunk window for a
-   *        single file's upload; independent of `concurrency`, keeps a
-   *        high-latency link saturated (raise it to reduce upload stutter;
-   *        keep within your server's connection limit, ~6 for HTTP/1.1)
+   * @param {number} [options.concurrency=4] global cap on concurrent
+   *        in-flight HTTP transfers (files and per-file chunk/range windows
+   *        combined). Every chunk upload and range download takes a shared
+   *        permit, so this is what actually bounds the engine's network
+   *        parallelism — set it to your server/browser connection budget
+   *        (e.g. 1 = strictly one transfer at a time).
+   * @param {number} [options.uploadWindow=8] per-file scheduling window for a
+   *        single file's upload: keeps that file's read/compress pipeline
+   *        full on high-latency links, but the TOTAL in-flight requests never
+   *        exceed `concurrency`
    * @param {number} [options.downloadWindow=4] in-flight byte-range window
    *        for a single file's download. Large files are fetched as
    *        `downloadWindow` concurrent `Range` GETs (tus-style parallel
@@ -209,6 +214,9 @@ export class LibfwClient {
    *        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.maxRetries=3] retries per chunk/file before failing
    * @param {number} [options.baseRetryDelayMs=500] initial backoff (ms)
    * @param {number} [options.maxRetryDelayMs=30000] backoff ceiling (ms)
@@ -665,11 +673,14 @@ export class LibfwClient {
         this._fallback.buffers.set(path, buf);
         this._fallback.order.push(path);
       }
-      // A chunk whose absolute offset is at or before the last one delivered
-      // means the engine restarted this file (an internal retry re-delivers
-      // the same byte range) — drop the partial buffer so the prefix is not
-      // duplicated in the produced blob/zip.
-      if (offset <= buf.len) {
+      // A chunk whose absolute offset is BEFORE the buffered span means the
+      // engine restarted this file (an internal retry re-delivers the same
+      // byte range) — drop the partial buffer so the prefix is not duplicated
+      // in the produced blob/zip. Note: `offset === buf.len` is the NORMAL
+      // next-chunk case (chunk N ends exactly where chunk N+1 begins), so it
+      // must NOT be treated as a restart — otherwise the first chunk of every
+      // browser-mode download is silently dropped.
+      if (offset < buf.len) {
         buf.chunks = [];
         buf.len = 0;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libfw-client",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "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

@@ -97,6 +97,7 @@ export interface InitOutput {
     readonly libfwclient_upload: (a: number, b: number, c: number, d: number, e: number) => any;
     readonly wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke___wasm_bindgen_1e05ddb24c0b7df4___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_1e05ddb24c0b7df4___JsError___true_: (a: number, b: number, c: any) => [number, number];
     readonly wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke___js_sys_bb6c79d0abe11c10___Function_fn_wasm_bindgen_1e05ddb24c0b7df4___JsValue_____wasm_bindgen_1e05ddb24c0b7df4___sys__Undefined___js_sys_bb6c79d0abe11c10___Function_fn_wasm_bindgen_1e05ddb24c0b7df4___JsValue_____wasm_bindgen_1e05ddb24c0b7df4___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen_1e05ddb24c0b7df4___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;
     readonly __wbindgen_exn_store: (a: number) => void;

package/pkg/libfw_client.js

@@ -227,6 +227,9 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_fffb441def202758: function(arg0) {
             arg0._wbg_cb_unref();
         },
+        __wbg_abort_4426bc6bd4153680: function() { return handleError(function (arg0) {
+            arg0.abort();
+        }, arguments); },
         __wbg_apply_3ac86a26fdb56c05: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = arg0.apply(arg1, arg2);
             return ret;
@@ -243,6 +246,9 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
+        __wbg_clearInterval_2e2069e95ad09d4f: function(arg0, arg1) {
+            arg0.clearInterval(arg1);
+        },
         __wbg_encodeURIComponent_d0140ae6e13eb27b: function(arg0, arg1) {
             const ret = encodeURIComponent(getStringFromWasm0(arg0, arg1));
             return ret;
@@ -324,6 +330,10 @@ function __wbg_get_imports() {
             const ret = new Array();
             return ret;
         },
+        __wbg_new_6b1dd7bed0e5462c: function() { return handleError(function () {
+            const ret = new XMLHttpRequest();
+            return ret;
+        }, arguments); },
         __wbg_new_aec3e25493d729fe: function(arg0, arg1) {
             try {
                 var state0 = {a: arg0, b: arg1};
@@ -380,10 +390,17 @@ function __wbg_get_imports() {
             const ret = new Request(getStringFromWasm0(arg0, arg1), arg2);
             return ret;
         }, arguments); },
+        __wbg_now_86c0d4ba3fa605b8: function() {
+            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); },
         __wbg_prototypesetcall_4770620bbe4688a0: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
@@ -406,10 +423,24 @@ function __wbg_get_imports() {
             const ret = arg0.read();
             return ret;
         },
+        __wbg_readyState_e916e521239696c1: function(arg0) {
+            const ret = arg0.readyState;
+            return ret;
+        },
         __wbg_resolve_2191a4dfe481c25b: function(arg0) {
             const ret = Promise.resolve(arg0);
             return ret;
         },
+        __wbg_send_4a966e8f532ab09b: function() { return handleError(function (arg0, arg1, arg2) {
+            arg0.send(arg1 === 0 ? undefined : getArrayU8FromWasm0(arg1, arg2));
+        }, arguments); },
+        __wbg_setInterval_93ec7461c3650c76: function() { return handleError(function (arg0, arg1, arg2) {
+            const ret = arg0.setInterval(arg1, arg2);
+            return ret;
+        }, arguments); },
+        __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;
@@ -434,6 +465,18 @@ function __wbg_get_imports() {
         __wbg_set_method_5532d59b92d76467: function(arg0, arg1, arg2) {
             arg0.method = getStringFromWasm0(arg1, arg2);
         },
+        __wbg_set_onabort_549ef96670787286: function(arg0, arg1) {
+            arg0.onabort = arg1;
+        },
+        __wbg_set_onerror_c810587e53729112: function(arg0, arg1) {
+            arg0.onerror = arg1;
+        },
+        __wbg_set_onprogress_ba0113ededd552ae: function(arg0, arg1) {
+            arg0.onprogress = arg1;
+        },
+        __wbg_set_onreadystatechange_14ce44725c7e0789: function(arg0, arg1) {
+            arg0.onreadystatechange = arg1;
+        },
         __wbg_static_accessor_GLOBAL_4ef717fb391d88b7: function() {
             const ret = typeof global === 'undefined' ? null : global;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
@@ -450,6 +493,10 @@ function __wbg_get_imports() {
             const ret = typeof window === 'undefined' ? null : window;
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
+        __wbg_status_bab532bcb3b5d775: function() { return handleError(function (arg0) {
+            const ret = arg0.status;
+            return ret;
+        }, arguments); },
         __wbg_status_c45b3b9b3033184a: function(arg0) {
             const ret = arg0.status;
             return ret;
@@ -462,17 +509,26 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1);
             return ret;
         },
+        __wbg_upload_65cdbdfcc901f1b1: function() { return handleError(function (arg0) {
+            const ret = arg0.upload;
+            return ret;
+        }, arguments); },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 145, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 163, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke___wasm_bindgen_1e05ddb24c0b7df4___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_1e05ddb24c0b7df4___JsError___true_);
             return ret;
         },
-        __wbindgen_cast_0000000000000002: function(arg0) {
+        __wbindgen_cast_0000000000000002: function(arg0, arg1) {
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 5, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke_______true_);
+            return ret;
+        },
+        __wbindgen_cast_0000000000000003: function(arg0) {
             // Cast intrinsic for `F64 -> Externref`.
             const ret = arg0;
             return ret;
         },
-        __wbindgen_cast_0000000000000003: function(arg0, arg1) {
+        __wbindgen_cast_0000000000000004: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
@@ -493,6 +549,10 @@ function __wbg_get_imports() {
     };
 }
 
+function wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke_______true_(arg0, arg1) {
+    wasm.wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke_______true_(arg0, arg1);
+}
+
 function wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke___wasm_bindgen_1e05ddb24c0b7df4___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_1e05ddb24c0b7df4___JsError___true_(arg0, arg1, arg2) {
     const ret = wasm.wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke___wasm_bindgen_1e05ddb24c0b7df4___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_1e05ddb24c0b7df4___JsError___true_(arg0, arg1, arg2);
     if (ret[1]) {

package/pkg/libfw_client_bg.wasm.d.ts

@@ -18,6 +18,7 @@ export const libfwclient_total_bytes: (a: number) => number;
 export const libfwclient_upload: (a: number, b: number, c: number, d: number, e: number) => any;
 export const wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke___wasm_bindgen_1e05ddb24c0b7df4___JsValue__core_9b3796e30d99ddb7___result__Result_____wasm_bindgen_1e05ddb24c0b7df4___JsError___true_: (a: number, b: number, c: any) => [number, number];
 export const wasm_bindgen_1e05ddb24c0b7df4___convert__closures_____invoke___js_sys_bb6c79d0abe11c10___Function_fn_wasm_bindgen_1e05ddb24c0b7df4___JsValue_____wasm_bindgen_1e05ddb24c0b7df4___sys__Undefined___js_sys_bb6c79d0abe11c10___Function_fn_wasm_bindgen_1e05ddb24c0b7df4___JsValue_____wasm_bindgen_1e05ddb24c0b7df4___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
+export const wasm_bindgen_1e05ddb24c0b7df4___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;
 export const __wbindgen_exn_store: (a: number) => void;

package/pkg/package.json

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