@componentor/fs 3.0.43 → 3.0.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@componentor/fs",
-  "version": "3.0.43",
+  "version": "3.0.45",
   "description": "High-performance OPFS-based Node.js fs polyfill with true sync API, VFS binary format, and bidirectional OPFS mirroring",
   "license": "MIT",
   "author": "Componentor",

package/readme.md

@@ -604,6 +604,32 @@ Make sure `opfsSync` is enabled (it's `true` by default). Files are mirrored to
 
 See [CHANGELOG.md](./CHANGELOG.md) for the full version history.
 
+### v3.0.45 (2026)
+
+**Fixes:**
+- Eliminate "Array buffer allocation failed" on multi-hundred-MB VFS operations (pnpm install of large monorepos like Directus): every hot path that previously staged a full-file or full-data-region buffer now streams through a bounded 4 MB scratch buffer via the underlying sync access handle — `growPathTable`, `fwrite` grow, `append`, `truncate` extend, and `copy`
+- Fix POSIX "hole" semantics: writes past EOF and extending `truncate` now zero-fill the gap instead of exposing stale bytes from previously-freed blocks
+
+**Tests:**
+- Sparse-write coverage (in-block hole, cross-block hole, pos === size)
+- Chunk-boundary coverage for `append`, `fwrite` grow, `truncate` extend, and `copy` across 5 MB buffers
+- Self-copy and `COPYFILE_EXCL` regression tests
+
+### v3.0.44 (2026)
+
+**Fixes:**
+- Coalesce per-path OPFS sync notifications in `sync-relay.worker.ts` — a single chunked 100 MB upload now triggers one full-file read instead of ~1500, eliminating `RangeError: Array buffer allocation failed` on repeated large uploads (e.g. Strapi multipart)
+- Cancel pending debounced syncs on `UNLINK`/`RMDIR`; reroute on `RENAME`
+- Route `OP.SYMLINK` mirror through the same debounced flusher
+
+**Memory:**
+- Replace `scanOPFSEntries` with streaming `populateVFSFromOPFS`: chunked `SyncAccessHandle` + `engine.append`, init peak memory bounded by 2 MB instead of sum of all OPFS file sizes
+- `renameInOPFS` copies via two `SyncAccessHandle`s in 2 MB chunks instead of `file.arrayBuffer()`
+- Coalesce pending `write` events for the same path in the OPFS sync queue — newer payload supersedes older, frees stale `ArrayBuffer` for GC
+
+**Tests:**
+- Update `vfs-engine` test for the 100K default inode count
+
 ### v3.0.43 (2026)
 
 **Docs:**