hyperdb-wasm 0.0.27136-dev.wasm.gd997ff1c → 0.0.27136-dev.wasm.ged3c25a2

package/dist/node_external_directory.d.ts

@@ -9,20 +9,21 @@ export declare class NodeExternalDirectoryBackend implements ExternalDirectoryBa
         readonly locator: string;
     };
     registered(path: string, locator: string): void;
+    releaseGeneration(locator: string, generation: string): Promise<void>;
     removed(pathOrLocator: string): Promise<void>;
     list(locator: string): Promise<readonly string[]>;
     listEntries(locator: string, path: string): Promise<readonly {
         readonly name: string;
         readonly kind: 'file' | 'directory';
     }[]>;
-    lookup(locator: string, path: string): Promise<{
+    lookup(locator: string, path: string, generation: string): Promise<{
         readonly kind: 'directory';
     } | {
         readonly kind: 'file';
         readonly locator: string;
         readonly size: number;
     } | undefined>;
-    open(locator: string, path: string): Promise<{
+    open(locator: string, path: string, generation: string): Promise<{
         readonly locator: string;
         readonly size: number;
     }>;
@@ -36,6 +37,7 @@ export declare class NodeExternalDirectoryBackend implements ExternalDirectoryBa
     private getDirectory;
     private getWritableDirectory;
     private getOpenWriter;
+    private closeFile;
     private cleanupWriter;
     private enqueue;
 }

package/dist/node_worker.js

@@ -2,7 +2,7 @@
 import { closeSync, createReadStream, fstatSync, openSync, read, statSync } from "node:fs";
 import { opendir as opendir2, stat } from "node:fs/promises";
 import { createRequire } from "node:module";
-import { basename as basename2, dirname, isAbsolute as isAbsolute2, join as join2, resolve as resolve2 } from "node:path";
+import { basename as basename2, dirname, isAbsolute as isAbsolute2, join as join2, posix, resolve as resolve2 } from "node:path";
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { Readable } from "node:stream";
 import { parentPort, workerData } from "node:worker_threads";
@@ -70,6 +70,7 @@ var HyperDBBindings = class {
   registerExternalFile;
   registerExternalDirectory;
   removeExternalRegistration;
+  refreshExternalDirectory;
   projectExternalFile;
   projectExternalDirectory;
   startQuery;
@@ -80,6 +81,7 @@ var HyperDBBindings = class {
   resultPayloadLength;
   free;
   mountedPaths = /* @__PURE__ */ new Set();
+  mountedDirectoryPaths = /* @__PURE__ */ new Set();
   constructor(module2) {
     this.module = module2;
     this.initialize = module2.cwrap("hyperdb_wasm_initialize", "pointer", ["string", "string", "number"]);
@@ -89,6 +91,7 @@ var HyperDBBindings = class {
     this.registerExternalFile = module2.cwrap("hyperdb_wasm_register_external_file", "pointer", ["string", "string", "number", "number"]);
     this.registerExternalDirectory = module2.cwrap("hyperdb_wasm_register_external_directory", "pointer", ["string", "string", "number", "number"]);
     this.removeExternalRegistration = module2.cwrap("hyperdb_wasm_remove_external_registration", "pointer", ["string", "number"]);
+    this.refreshExternalDirectory = module2.cwrap("hyperdb_wasm_refresh_external_directory", "pointer", ["string", "number"]);
     this.projectExternalFile = module2.cwrap("hyperdb_wasm_project_external_file", "pointer", ["string", "string", "number", "number"]);
     this.projectExternalDirectory = module2.cwrap("hyperdb_wasm_project_external_directory", "pointer", ["string", "string", "number"]);
     this.startQuery = module2.cwrap("hyperdb_wasm_query_start", "pointer", ["number", "string", "number", "number"]);
@@ -108,20 +111,32 @@ var HyperDBBindings = class {
       if (registration.kind === "directory") return this.mountDirectory(request, request.source.path);
       return this.mountFile(request, registration.locator, registration.size, this.module.externalFileBackend);
     }
-    if (request.type === "mount" && request.source.kind === "browser-file" && !this.module.externalFileBackendAvailable) {
-      return { response: { id: request.id, type: "response", result: { state: "error", error: "Blob external files are supported only by the browser client" } }, transfer: [] };
-    }
     if (request.type === "mount" && request.source.kind === "browser-directory") {
       return this.mountDirectory(request, request.source.handle);
     }
     if (request.type === "mount" && request.source.kind === "browser-file") {
-      return this.mountFile(request, request.source.url, safeInteger(request.source.size, "external file size"));
+      validateCString(request.path, "external registration path");
+      const backend = this.module.externalDirectoryBackend;
+      if (!backend?.registerFile) {
+        return { response: { id: request.id, type: "response", result: { state: "error", error: "Browser external files are supported only by the browser client" } }, transfer: [] };
+      }
+      const file = backend.registerFile(request.source.file);
+      return this.mountFile(request, file.locator, file.size, backend);
+    }
+    if (request.type === "refreshMount") {
+      validateCString(request.path, "external registration path");
+      if (!this.module.externalDirectoryBackend) return { response: { id: request.id, type: "response", result: { state: "error", error: "External directories are not supported by this client" } }, transfer: [] };
+      if (!this.mountedDirectoryPaths.has(request.path)) {
+        const error = this.mountedPaths.has(request.path) ? "Only directory mounts can be refreshed" : "External directory registration was not found";
+        return { response: { id: request.id, type: "response", result: { state: "error", error } }, transfer: [] };
+      }
     }
     if (request.type === "unmount" && (this.module.externalFileBackend || this.module.externalDirectoryBackend)) {
       validateCString(request.path, "external registration path");
       const pointer2 = safeInteger(this.removeExternalRegistration(request.path, request.id), "result pointer");
       const result2 = this.decodeResult(pointer2);
       if (result2.state === "ok" || result2.state === "error" && result2.error === "External registration was not found" && this.mountedPaths.has(request.path)) {
+        this.mountedDirectoryPaths.delete(request.path);
         const cleanup = async () => {
           await Promise.all([
             this.module.externalFileBackend?.removed(request.path),
@@ -133,12 +148,14 @@ var HyperDBBindings = class {
       }
       return { response: { id: request.id, type: "response", result: result2 }, transfer: [] };
     }
-    if (request.type === "unmount" && !this.module.externalFileBackendAvailable) {
+    if (request.type === "unmount") {
       return { response: { id: request.id, type: "response", result: { state: "error", error: "External files are not supported by this client" } }, transfer: [] };
     }
     const pointer = safeInteger(this.invoke(request), "result pointer");
     const result = this.decodeResult(pointer);
     if (request.type === "shutdown" && result.state === "ok") {
+      this.mountedPaths.clear();
+      this.mountedDirectoryPaths.clear();
       const completion = completionFor([
         this.module.externalFileBackend?.shutdown(),
         this.module.externalDirectoryBackend?.shutdown()
@@ -173,6 +190,8 @@ var HyperDBBindings = class {
       case "unmount":
         validateCString(request.path, "external registration path");
         return this.removeExternalRegistration(request.path, request.id);
+      case "refreshMount":
+        return this.refreshExternalDirectory(request.path, request.id);
       case "startQuery":
         validateCStringContents(request.sql, "SQL");
         return this.startQuery(request.connection, request.sql, Number(request.sqlTestMode ?? false), request.id);
@@ -193,13 +212,13 @@ var HyperDBBindings = class {
     try {
       const result = this.decodeResult(safeInteger(this.registerExternalFile(request.path, locator, size, request.id), "result pointer"));
       if (result.state !== "ok") {
-        backend?.removed(locator);
-        return { response: { id: request.id, type: "response", result }, transfer: [] };
+        const completion = completionFor([backend.removed(locator)]);
+        return { response: { id: request.id, type: "response", result }, transfer: [], ...completion && { completion } };
       }
       path = new TextDecoder("utf-8", { fatal: true }).decode(result.payload);
       const projection = this.decodeResult(safeInteger(this.projectExternalFile(path, locator, size, request.id), "result pointer"));
       if (projection.state !== "ok") throw new Error(resultError(projection));
-      backend?.registered(path, locator);
+      backend.registered(path, locator);
       registered = true;
       this.mountedPaths.add(path);
       return { response: { id: request.id, type: "response", result }, transfer: [] };
@@ -214,12 +233,15 @@ var HyperDBBindings = class {
       }
       if (rollbackError !== void 0) {
         if (path !== void 0) {
-          backend?.registered(path, locator);
+          backend.registered(path, locator);
           this.mountedPaths.add(path);
         }
         throw new Error(`mount failed and rollback also failed: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`, { cause: error });
       }
-      backend?.removed(registered && path !== void 0 ? path : locator);
+      const completion = completionFor([backend.removed(registered && path !== void 0 ? path : locator)]);
+      if (completion) {
+        return { response: { id: request.id, type: "response", result: { state: "error", error: error instanceof Error ? error.message : String(error) } }, transfer: [], completion };
+      }
       throw error;
     }
   }
@@ -243,12 +265,14 @@ var HyperDBBindings = class {
           if (projection.state !== "ok") throw new Error(resultError(projection));
           backend.registered(path, registration.locator);
           this.mountedPaths.add(path);
+          this.mountedDirectoryPaths.add(path);
         } catch (error) {
           const cleanupPointer = safeInteger(this.removeExternalRegistration(path, request.id), "result pointer");
           const cleanup = this.decodeResult(cleanupPointer);
           if (cleanup.state !== "ok") {
             backend.registered(path, registration.locator);
             this.mountedPaths.add(path);
+            this.mountedDirectoryPaths.add(path);
             preserveBackend = true;
             throw new Error(`mount failed and rollback also failed: ${resultError(cleanup)}`, { cause: error });
           }
@@ -342,7 +366,7 @@ function isEngineRequest(value) {
       if (!hasKeys(value, ["id", "type", "source", "path", "mode"]) || typeof value.path !== "string" || !value.path.startsWith("/mnt/external/") || new TextEncoder().encode(value.path.slice("/mnt/external/".length)).byteLength === 0 || new TextEncoder().encode(value.path.slice("/mnt/external/".length)).byteLength > 200 || value.path.slice("/mnt/external/".length).split("/").some((component) => !component || component === "." || component === ".." || !/^[A-Za-z0-9._-]+$/.test(component)) || value.mode !== "read" && value.mode !== "readwrite" || !isRecord(value.source)) return false;
       switch (value.source.kind) {
         case "browser-file":
-          return value.mode === "read" && hasKeys(value.source, ["kind", "name", "url", "size"]) && typeof value.source.name === "string" && typeof value.source.url === "string" && typeof value.source.size === "number" && Number.isSafeInteger(value.source.size) && value.source.size >= 0;
+          return value.mode === "read" && hasKeys(value.source, ["kind", "file"]) && typeof File !== "undefined" && value.source.file instanceof File;
         case "browser-directory":
           return hasKeys(value.source, ["kind", "handle"]) && isRecord(value.source.handle) && value.source.handle.kind === "directory";
         case "node-path":
@@ -352,6 +376,7 @@ function isEngineRequest(value) {
       }
     }
     case "unmount":
+    case "refreshMount":
       return hasKeys(value, ["id", "type", "path"]) && typeof value.path === "string" && !!value.path && !value.path.includes("\0");
     case "pollQuery":
     case "cancelQuery":
@@ -449,9 +474,14 @@ function installHttpRuntime(module2, transport2) {
   };
   module2.hyperdbWasmFetchCancel = (id) => fetches.get(id)?.abort();
 }
-function installExternalDirectoryRuntime(module2) {
+function installExternalDirectoryRuntime(module2, transport2) {
   const backend = module2.externalDirectoryBackend;
   if (!backend) return;
+  module2.hyperdbWasmExternalDirectoryReleaseGeneration = (locator, generation) => {
+    void Promise.resolve().then(() => backend.releaseGeneration(locator, generation)).catch(() => {
+      transport2.postMessage({ type: "log", text: "External directory generation cleanup failed; mount removal will retry" });
+    });
+  };
   const listComplete = module2._hyperdb_wasm_external_directory_list_complete;
   const openComplete = module2._hyperdb_wasm_external_directory_open_complete;
   if (listComplete) {
@@ -464,8 +494,8 @@ function installExternalDirectoryRuntime(module2) {
     };
   }
   if (openComplete) {
-    module2.hyperdbWasmExternalDirectoryOpenStart = (id, locator, path) => {
-      void backend.open(locator, path).then((file) => {
+    module2.hyperdbWasmExternalDirectoryOpenStart = (id, locator, path, generation) => {
+      void backend.open(locator, path, generation).then((file) => {
         openComplete(id, safePointer(module2.stringToNewUTF8(file.locator), "external file locator pointer"), file.size);
       }).catch((error) => openComplete(id, 0, isNotFoundError(error) ? -2 : -1));
     };
@@ -554,8 +584,8 @@ function installFilesystemProjectionRuntime(module2) {
       complete(id, safePointer(module2.stringToNewUTF8(JSON.stringify(encoded)), "filesystem listing pointer"), 0);
     }).catch(() => complete(id, 0, -1));
   };
-  module2.hyperdbWasmFilesystemLookupStart = (id, locator, path) => {
-    const lookup = module2.externalDirectoryBackend?.lookup?.(locator, path);
+  module2.hyperdbWasmFilesystemLookupStart = (id, locator, path, generation) => {
+    const lookup = module2.externalDirectoryBackend?.lookup?.(locator, path, generation);
     if (!lookup) {
       complete(id, 0, -1);
       return;
@@ -567,13 +597,7 @@ function installFilesystemProjectionRuntime(module2) {
     }).catch(() => complete(id, 0, -1));
   };
   module2.hyperdbWasmFilesystemReadStart = (id, locator, offset, length, expectedSize, pointerValue) => {
-    const read2 = module2.externalFileBackend?.read(locator, offset, length, expectedSize) ?? module2.externalDirectoryBackend?.read(locator, offset, length, expectedSize) ?? (locator.startsWith("blob:") ? fetch(locator, { headers: { Range: `bytes=${offset}-${offset + length - 1}` } }).then(async (response) => {
-      const contentRange = /^bytes (\d+)-(\d+)\/(\d+)$/.exec(response.headers.get("content-range") ?? "");
-      if (response.status !== 206 || !contentRange || contentRange[1] !== String(offset) || contentRange[2] !== String(offset + length - 1) || contentRange[3] !== String(expectedSize)) {
-        throw new Error("Blob URL returned an invalid byte range");
-      }
-      return new Uint8Array(await response.arrayBuffer());
-    }) : void 0);
+    const read2 = module2.externalFileBackend?.read(locator, offset, length, expectedSize) ?? module2.externalDirectoryBackend?.read(locator, offset, length, expectedSize);
     if (!read2) {
       complete(id, 0, -1);
       return;
@@ -620,7 +644,7 @@ function configureWorker(module2, transport2, configureFilesystem = () => void 0
       configureFilesystem(module2);
       installHttpRuntime(module2, transport2);
       installHostFileRuntime(module2);
-      installExternalDirectoryRuntime(module2);
+      installExternalDirectoryRuntime(module2, transport2);
       installFilesystemProjectionRuntime(module2);
       bindings = new HyperDBBindings(module2);
       transport2.postMessage({ type: "ready" });
@@ -705,13 +729,25 @@ var NodeExternalDirectoryBackend = class {
     const info = lstatSync(root);
     if (info.isSymbolicLink() || !info.isDirectory()) throw new Error("External directory path must identify a directory");
     const locator = `${directoryLocatorPrefix}${randomUUID()}`;
-    this.directories.set(locator, { root, mode, files: /* @__PURE__ */ new Map(), locators: /* @__PURE__ */ new Set(), temporaryPaths: /* @__PURE__ */ new Set() });
+    this.directories.set(locator, { root, mode, generations: /* @__PURE__ */ new Map(), locators: /* @__PURE__ */ new Set(), temporaryPaths: /* @__PURE__ */ new Set() });
     return { name: basename(root) || "root", locator };
   }
   registered(path, locator) {
     if (!this.directories.has(locator)) throw new Error("External directory registration is unavailable");
     this.paths.set(path, locator);
   }
+  async releaseGeneration(locator, generation) {
+    const directory = this.directories.get(locator);
+    const state = directory?.generations.get(generation);
+    if (!directory || !state) return;
+    directory.generations.delete(generation);
+    await Promise.all([...state.locators].map(async (fileLocator) => {
+      const file = this.files.get(fileLocator);
+      if (file) await this.closeFile(file);
+      this.files.delete(fileLocator);
+      directory.locators.delete(fileLocator);
+    }));
+  }
   async removed(pathOrLocator) {
     const locator = this.paths.get(pathOrLocator) ?? pathOrLocator;
     const directory = this.directories.get(locator);
@@ -732,7 +768,7 @@ var NodeExternalDirectoryBackend = class {
         directory.locators.delete(fileLocator);
         continue;
       }
-      fileCleanup.push(file.descriptor.close().then(() => {
+      fileCleanup.push(this.closeFile(file).then(() => {
         this.files.delete(fileLocator);
         directory.locators.delete(fileLocator);
       }));
@@ -782,7 +818,7 @@ var NodeExternalDirectoryBackend = class {
     entries.sort((left, right) => left.name.localeCompare(right.name));
     return entries;
   }
-  async lookup(locator, path) {
+  async lookup(locator, path, generation) {
     const directory = this.getDirectory(locator);
     const segments = relativeSegments(path);
     await ensureDirectory(directory.root, segments.slice(0, -1), false);
@@ -792,15 +828,20 @@ var NodeExternalDirectoryBackend = class {
       if (info.isSymbolicLink()) throw new Error("External directory must not contain symbolic links");
       if (info.isDirectory()) return { kind: "directory" };
       if (!info.isFile()) throw new Error("External directory contains an unsupported entry");
-      return { kind: "file", ...await this.open(locator, path) };
+      return { kind: "file", ...await this.open(locator, path, generation) };
     } catch (error) {
       if (isNotFound(error)) return void 0;
       throw error;
     }
   }
-  async open(locator, path) {
+  async open(locator, path, generation) {
     const directory = this.getDirectory(locator);
-    const cached = directory.files.get(path);
+    let state = directory.generations.get(generation);
+    if (!state) {
+      state = { files: /* @__PURE__ */ new Map(), locators: /* @__PURE__ */ new Set() };
+      directory.generations.set(generation, state);
+    }
+    const cached = state.files.get(path);
     if (cached) {
       const file = await cached;
       return { locator: file.locator, size: file.size };
@@ -819,18 +860,19 @@ var NodeExternalDirectoryBackend = class {
         const file = { locator: `${fileLocatorPrefix}${randomUUID()}`, descriptor, size: Number(openedInfo.size) };
         this.files.set(file.locator, file);
         directory.locators.add(file.locator);
+        state.locators.add(file.locator);
         return file;
       } catch (error) {
         await descriptor.close();
         throw error;
       }
     })();
-    directory.files.set(path, snapshot);
+    state.files.set(path, snapshot);
     try {
       const file = await snapshot;
       return { locator: file.locator, size: file.size };
     } catch (error) {
-      directory.files.delete(path);
+      if (state.files.get(path) === snapshot) state.files.delete(path);
       throw error;
     }
   }
@@ -927,7 +969,7 @@ var NodeExternalDirectoryBackend = class {
         }
         throw failure;
       }
-      this.getDirectory(state.locator).files.delete(state.path);
+      for (const generation of this.getDirectory(state.locator).generations.values()) generation.files.delete(state.path);
     }, true);
     return operation.then(() => {
       this.writers.delete(writer);
@@ -945,7 +987,7 @@ var NodeExternalDirectoryBackend = class {
   }
   async shutdown() {
     await Promise.all([...this.directories.keys()].map((locator) => this.removed(locator)));
-    await Promise.all([...this.files.values()].map((file) => file.descriptor.close()));
+    await Promise.all([...this.files.values()].map((file) => this.closeFile(file)));
     this.files.clear();
     this.paths.clear();
     this.directories.clear();
@@ -966,8 +1008,14 @@ var NodeExternalDirectoryBackend = class {
     if (!state || state.terminal) throw new Error("External directory writer is not open");
     return state;
   }
+  closeFile(file) {
+    return file.closing ??= file.descriptor.close().catch((error) => {
+      delete file.closing;
+      throw error;
+    });
+  }
   async cleanupWriter(state) {
-    this.directories.get(state.locator)?.files.delete(state.path);
+    for (const generation of this.directories.get(state.locator)?.generations.values() ?? []) generation.files.delete(state.path);
     if (state.descriptor) {
       await state.descriptor.close();
       state.descriptor = void 0;
@@ -1022,7 +1070,15 @@ configureWorker(module, transport, (runtime) => {
   runtime.FS.mount(nodeFS, { root: storagePath }, "/mnt/fs");
   runtime.FS.mkdirTree("/mnt/fs/logs");
   const nodeRuntimeFS = runtime.FS;
-  const shouldAccessHostPath = (path) => isAbsolute2(path) && !nodeRuntimeFS.analyzePath(path).exists;
+  const shouldAccessHostPath = (path) => {
+    if (!isAbsolute2(path)) return false;
+    let prefix = "/";
+    for (const component of path.split("/")) {
+      prefix = posix.join(prefix, component);
+      if (prefix === "/mnt/external") return false;
+    }
+    return !nodeRuntimeFS.analyzePath(path).exists;
+  };
   runtime.hyperdbWasmShouldOpenHostFile = shouldAccessHostPath;
   runtime.hyperdbWasmShouldListHostDirectory = shouldAccessHostPath;
   runtime.externalDirectoryBackend = new NodeExternalDirectoryBackend();

package/dist/protocol.d.ts

@@ -10,9 +10,7 @@ export interface HyperDBErrorData {
 }
 export type MountSource = {
     readonly kind: 'browser-file';
-    readonly name: string;
-    readonly url: string;
-    readonly size: number;
+    readonly file: File;
 } | {
     readonly kind: 'browser-directory';
     readonly handle: unknown;
@@ -51,6 +49,10 @@ export type EngineRequest = {
     id: RequestId;
     type: 'unmount';
     path: string;
+} | {
+    id: RequestId;
+    type: 'refreshMount';
+    path: string;
 } | {
     id: RequestId;
     type: 'pollQuery';

package/dist/raw.browser.js

@@ -93,6 +93,9 @@ var HyperDBEngineClient = class {
   unmount(path) {
     return this.request({ id: this.nextId++, type: "unmount", path });
   }
+  refreshMount(path) {
+    return this.request({ id: this.nextId++, type: "refreshMount", path });
+  }
   pollQuery(query) {
     return this.request({ id: this.nextId++, type: "pollQuery", query });
   }
@@ -209,6 +212,7 @@ var HyperDBBindings = class {
   registerExternalFile;
   registerExternalDirectory;
   removeExternalRegistration;
+  refreshExternalDirectory;
   projectExternalFile;
   projectExternalDirectory;
   startQuery;
@@ -219,6 +223,7 @@ var HyperDBBindings = class {
   resultPayloadLength;
   free;
   mountedPaths = /* @__PURE__ */ new Set();
+  mountedDirectoryPaths = /* @__PURE__ */ new Set();
   constructor(module) {
     this.module = module;
     this.initialize = module.cwrap("hyperdb_wasm_initialize", "pointer", ["string", "string", "number"]);
@@ -228,6 +233,7 @@ var HyperDBBindings = class {
     this.registerExternalFile = module.cwrap("hyperdb_wasm_register_external_file", "pointer", ["string", "string", "number", "number"]);
     this.registerExternalDirectory = module.cwrap("hyperdb_wasm_register_external_directory", "pointer", ["string", "string", "number", "number"]);
     this.removeExternalRegistration = module.cwrap("hyperdb_wasm_remove_external_registration", "pointer", ["string", "number"]);
+    this.refreshExternalDirectory = module.cwrap("hyperdb_wasm_refresh_external_directory", "pointer", ["string", "number"]);
     this.projectExternalFile = module.cwrap("hyperdb_wasm_project_external_file", "pointer", ["string", "string", "number", "number"]);
     this.projectExternalDirectory = module.cwrap("hyperdb_wasm_project_external_directory", "pointer", ["string", "string", "number"]);
     this.startQuery = module.cwrap("hyperdb_wasm_query_start", "pointer", ["number", "string", "number", "number"]);
@@ -247,20 +253,32 @@ var HyperDBBindings = class {
       if (registration.kind === "directory") return this.mountDirectory(request, request.source.path);
       return this.mountFile(request, registration.locator, registration.size, this.module.externalFileBackend);
     }
-    if (request.type === "mount" && request.source.kind === "browser-file" && !this.module.externalFileBackendAvailable) {
-      return { response: { id: request.id, type: "response", result: { state: "error", error: "Blob external files are supported only by the browser client" } }, transfer: [] };
-    }
     if (request.type === "mount" && request.source.kind === "browser-directory") {
       return this.mountDirectory(request, request.source.handle);
     }
     if (request.type === "mount" && request.source.kind === "browser-file") {
-      return this.mountFile(request, request.source.url, safeInteger(request.source.size, "external file size"));
+      validateCString(request.path, "external registration path");
+      const backend = this.module.externalDirectoryBackend;
+      if (!backend?.registerFile) {
+        return { response: { id: request.id, type: "response", result: { state: "error", error: "Browser external files are supported only by the browser client" } }, transfer: [] };
+      }
+      const file = backend.registerFile(request.source.file);
+      return this.mountFile(request, file.locator, file.size, backend);
+    }
+    if (request.type === "refreshMount") {
+      validateCString(request.path, "external registration path");
+      if (!this.module.externalDirectoryBackend) return { response: { id: request.id, type: "response", result: { state: "error", error: "External directories are not supported by this client" } }, transfer: [] };
+      if (!this.mountedDirectoryPaths.has(request.path)) {
+        const error = this.mountedPaths.has(request.path) ? "Only directory mounts can be refreshed" : "External directory registration was not found";
+        return { response: { id: request.id, type: "response", result: { state: "error", error } }, transfer: [] };
+      }
     }
     if (request.type === "unmount" && (this.module.externalFileBackend || this.module.externalDirectoryBackend)) {
       validateCString(request.path, "external registration path");
       const pointer2 = safeInteger(this.removeExternalRegistration(request.path, request.id), "result pointer");
       const result2 = this.decodeResult(pointer2);
       if (result2.state === "ok" || result2.state === "error" && result2.error === "External registration was not found" && this.mountedPaths.has(request.path)) {
+        this.mountedDirectoryPaths.delete(request.path);
         const cleanup = async () => {
           await Promise.all([
             this.module.externalFileBackend?.removed(request.path),
@@ -272,12 +290,14 @@ var HyperDBBindings = class {
       }
       return { response: { id: request.id, type: "response", result: result2 }, transfer: [] };
     }
-    if (request.type === "unmount" && !this.module.externalFileBackendAvailable) {
+    if (request.type === "unmount") {
       return { response: { id: request.id, type: "response", result: { state: "error", error: "External files are not supported by this client" } }, transfer: [] };
     }
     const pointer = safeInteger(this.invoke(request), "result pointer");
     const result = this.decodeResult(pointer);
     if (request.type === "shutdown" && result.state === "ok") {
+      this.mountedPaths.clear();
+      this.mountedDirectoryPaths.clear();
       const completion = completionFor([
         this.module.externalFileBackend?.shutdown(),
         this.module.externalDirectoryBackend?.shutdown()
@@ -312,6 +332,8 @@ var HyperDBBindings = class {
       case "unmount":
         validateCString(request.path, "external registration path");
         return this.removeExternalRegistration(request.path, request.id);
+      case "refreshMount":
+        return this.refreshExternalDirectory(request.path, request.id);
       case "startQuery":
         validateCStringContents(request.sql, "SQL");
         return this.startQuery(request.connection, request.sql, Number(request.sqlTestMode ?? false), request.id);
@@ -332,13 +354,13 @@ var HyperDBBindings = class {
     try {
       const result = this.decodeResult(safeInteger(this.registerExternalFile(request.path, locator, size, request.id), "result pointer"));
       if (result.state !== "ok") {
-        backend?.removed(locator);
-        return { response: { id: request.id, type: "response", result }, transfer: [] };
+        const completion = completionFor([backend.removed(locator)]);
+        return { response: { id: request.id, type: "response", result }, transfer: [], ...completion && { completion } };
       }
       path = new TextDecoder("utf-8", { fatal: true }).decode(result.payload);
       const projection = this.decodeResult(safeInteger(this.projectExternalFile(path, locator, size, request.id), "result pointer"));
       if (projection.state !== "ok") throw new Error(resultError(projection));
-      backend?.registered(path, locator);
+      backend.registered(path, locator);
       registered = true;
       this.mountedPaths.add(path);
       return { response: { id: request.id, type: "response", result }, transfer: [] };
@@ -353,12 +375,15 @@ var HyperDBBindings = class {
       }
       if (rollbackError !== void 0) {
         if (path !== void 0) {
-          backend?.registered(path, locator);
+          backend.registered(path, locator);
           this.mountedPaths.add(path);
         }
         throw new Error(`mount failed and rollback also failed: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`, { cause: error });
       }
-      backend?.removed(registered && path !== void 0 ? path : locator);
+      const completion = completionFor([backend.removed(registered && path !== void 0 ? path : locator)]);
+      if (completion) {
+        return { response: { id: request.id, type: "response", result: { state: "error", error: error instanceof Error ? error.message : String(error) } }, transfer: [], completion };
+      }
       throw error;
     }
   }
@@ -382,12 +407,14 @@ var HyperDBBindings = class {
           if (projection.state !== "ok") throw new Error(resultError(projection));
           backend.registered(path, registration.locator);
           this.mountedPaths.add(path);
+          this.mountedDirectoryPaths.add(path);
         } catch (error) {
           const cleanupPointer = safeInteger(this.removeExternalRegistration(path, request.id), "result pointer");
           const cleanup = this.decodeResult(cleanupPointer);
           if (cleanup.state !== "ok") {
             backend.registered(path, registration.locator);
             this.mountedPaths.add(path);
+            this.mountedDirectoryPaths.add(path);
             preserveBackend = true;
             throw new Error(`mount failed and rollback also failed: ${resultError(cleanup)}`, { cause: error });
           }