@poe-platform/safe-fs 0.1.816 → 0.1.817

package/README.md

@@ -15,6 +15,9 @@ To bound aggregate pages across multiple live stores, pass the same
 This shares a 256 KiB resident-page budget; `cache.residentBytes` reports current
 page retention. Eviction uses each store's filesystem, and each store still owns
 its `close()` cleanup. The budget excludes caller buffers and backend storage.
+Call `await storage.prepare()` before opening a directory iterator when its
+snapshot includes the scratch directory. It acquires and unlinks the backing
+handle up front, so later spills do not mutate that directory's namespace.
 `IntegerTable.entries()` replays records in unsigned key order with a fixed
 16-level node stack and batches of at most 128 records. It accepts zero-filled
 caller storage with `allocate`, `read` and `write`; mutation during traversal

package/dist/safe-fs/storage.d.ts

@@ -44,6 +44,8 @@ export declare class PagedStorage {
     private closing;
     constructor(context: PagedStorageContext, maxPages?: number, cache?: PagedStorageCache | undefined);
     allocate(length: number): number;
+    /** Acquire and unlink backing storage before observing a directory snapshot. */
+    prepare(): Promise<void>;
     private operation;
     private spill;
     private flush;

package/dist/safe-fs/storage.js

@@ -73,6 +73,11 @@ export class PagedStorage {
         this.end += length;
         return offset;
     }
+    /** Acquire and unlink backing storage before observing a directory snapshot. */
+    async prepare() {
+        await this.operation(async () => { if (!this.descriptor)
+            await this.spill(); });
+    }
     operation(action) {
         this.signal.throwIfAborted();
         const execute = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poe-platform/safe-fs",
-  "version": "0.1.816",
+  "version": "0.1.817",
   "description": "Composable filesystem with a portable core and explicit Node adapters",
   "type": "module",
   "license": "MIT",