hyperdb-wasm 0.0.26862-dev.wasm.g42f1012b → 0.0.26862-dev.wasm.g89537caa

package/dist/api.d.ts

@@ -9,15 +9,7 @@ export interface HyperDBClient {
     initialize(settings: string): Promise<WasmResult>;
     connect(): Promise<WasmResult>;
     disconnect(connection: number): Promise<WasmResult>;
-    createDatabase(databaseName: string, persistent: boolean): Promise<WasmResult>;
-    openDatabase(databaseName: string): Promise<WasmResult>;
-    listDatabases(): Promise<WasmResult>;
-    checkpointDatabase(databaseName: string): Promise<WasmResult>;
-    dropDatabase(databaseName: string): Promise<WasmResult>;
-    attachDatabase(connection: number, databaseName: string, alias: string): Promise<WasmResult>;
-    detachDatabase(connection: number, alias: string): Promise<WasmResult>;
     startQuery(connection: number, sql: string): Promise<WasmResult>;
-    startQueryWithInfo(connection: number, sql: string): Promise<WasmResult>;
     insertArrowIPCFromPath(connection: number, path: string, name: string, schema: string | null, create: boolean, internal?: boolean): Promise<WasmResult>;
     createTemporaryFile(bytes: Uint8Array): Promise<WasmResult>;
     removeFile(path: string): Promise<WasmResult>;
@@ -27,8 +19,7 @@ export interface HyperDBClient {
     removeExternalRegistration(path: string): Promise<WasmResult>;
     pollQuery(query: number): Promise<WasmResult>;
     cancelQuery(query: number): Promise<WasmResult>;
-    releaseQuery(query: number): Promise<WasmResult>;
-    releaseQueryWithInfo(query: number): Promise<WasmResult>;
+    finishQuery(query: number): Promise<WasmResult>;
     shutdown(): Promise<WasmResult>;
     terminate(): Promise<void>;
 }
@@ -37,9 +28,6 @@ export interface ArrowInsertOptions {
     readonly schema?: string;
     readonly create?: boolean;
 }
-export interface DatabaseCreateOptions {
-    readonly storage?: 'transient' | 'persistent';
-}
 export interface ExternalFileRegistration {
     readonly name: string;
     readonly url: string;
@@ -60,10 +48,6 @@ export interface HyperDBCreateOptions {
     readonly settings?: HyperDBSettings;
 }
 export type BrowserCreateOptions = BrowserClientOptions & HyperDBCreateOptions;
-export interface DatabaseMetadata {
-    readonly name: string;
-    readonly storage: 'transient' | 'persistent';
-}
 export type QueryMetricValue = null | boolean | number | string | readonly QueryMetricValue[] | {
     readonly [key: string]: QueryMetricValue;
 };
@@ -114,14 +98,9 @@ export declare class HyperDB<ExternalFileArgs extends ExternalFileArguments = Br
     static create(options?: BrowserCreateOptions): Promise<HyperDB>;
     ready(): Promise<void>;
     connect(): Promise<HyperDBConnection>;
-    createDatabase(databaseName: string, options?: DatabaseCreateOptions): Promise<void>;
-    openDatabase(databaseName: string): Promise<void>;
-    listDatabases(): Promise<DatabaseMetadata[]>;
     registerExternalFile(...args: ExternalFileArgs): Promise<string>;
     removeExternalRegistration(path: string): Promise<void>;
     protected registerExternalDirectorySource(source: unknown, mode: ExternalDirectoryMode): Promise<string>;
-    checkpointDatabase(databaseName: string): Promise<void>;
-    dropDatabase(databaseName: string): Promise<void>;
     terminate(): Promise<void>;
     private ensureRunning;
     protected runDatabaseOperation<Result>(operation: () => Promise<Result>): Promise<Result>;
@@ -135,8 +114,6 @@ export declare class HyperDBConnection {
     private closing;
     constructor(client: HyperDBClient, connection: number, onClose?: () => void);
     close(): Promise<void>;
-    attachDatabase(databaseName: string, alias?: string): Promise<void>;
-    detachDatabase(alias: string): Promise<void>;
     sendIPC(sql: string): QueryResult<AsyncIterable<Uint8Array>>;
     queryIPC(sql: string): QueryResult<Promise<Uint8Array>>;
     send<T extends TypeMap = {
@@ -149,8 +126,7 @@ export declare class HyperDBConnection {
     insertArrowIPCFromPath(path: string, options: ArrowInsertOptions): Promise<void>;
     private insertArrowIPCFromPathInternal;
     private ensureAvailable;
-    private release;
-    private releaseWithInfo;
+    private finishQuery;
     closeForTermination(): Promise<void>;
 }
 export type { HyperDBEngineClient };

package/dist/browser.d.ts

@@ -11,6 +11,8 @@ export interface BrowserClientOptions {
     readonly workerUrl?: string | URL;
     readonly engineUrl?: string | URL;
     readonly wasmUrl?: string | URL;
+    /** OPFS-relative directory mounted as the durable filesystem root. */
+    readonly storagePath?: string;
     readonly onSetupProgress?: (progress: SetupProgress) => void;
 }
 type BrowserEnvironment = {
@@ -36,6 +38,6 @@ export declare class BrowserWorker implements WorkerTransport {
     onClose(): () => void;
     terminate(): void;
 }
-export declare function resolveBrowserWorkerUrl(workerUrl: string | URL, engineUrl: string | URL, wasmUrl?: string | URL): URL;
+export declare function resolveBrowserWorkerUrl(workerUrl: string | URL, engineUrl: string | URL, wasmUrl?: string | URL, storagePath?: string): URL;
 export declare function createBrowserClient(options?: BrowserClientOptions): HyperDBEngineClient;
 export {};

package/dist/browser.js

@@ -106,36 +106,12 @@ var init_client = __esm({
       disconnect(connection) {
         return this.request({ id: this.nextId++, type: "disconnect", connection });
       }
-      createDatabase(databaseName, persistent) {
-        return this.request({ id: this.nextId++, type: "createDatabase", databaseName, persistent });
-      }
-      openDatabase(databaseName) {
-        return this.request({ id: this.nextId++, type: "openDatabase", databaseName });
-      }
-      listDatabases() {
-        return this.request({ id: this.nextId++, type: "listDatabases" });
-      }
-      checkpointDatabase(databaseName) {
-        return this.request({ id: this.nextId++, type: "checkpointDatabase", databaseName });
-      }
-      dropDatabase(databaseName) {
-        return this.request({ id: this.nextId++, type: "dropDatabase", databaseName });
-      }
-      attachDatabase(connection, databaseName, alias) {
-        return this.request({ id: this.nextId++, type: "attachDatabase", connection, databaseName, alias });
-      }
-      detachDatabase(connection, alias) {
-        return this.request({ id: this.nextId++, type: "detachDatabase", connection, alias });
-      }
       shutdown() {
         return this.request({ id: this.nextId++, type: "shutdown" });
       }
       startQuery(connection, sql, sqlTestMode = false) {
         return this.request({ id: this.nextId++, type: "startQuery", connection, sql, ...sqlTestMode && { sqlTestMode } });
       }
-      startQueryWithInfo(connection, sql) {
-        return this.request({ id: this.nextId++, type: "startQueryWithInfo", connection, sql });
-      }
       insertArrowIPCFromPath(connection, path, name, schema, create, internal = false) {
         return this.request({ id: this.nextId++, type: "insertArrowIPCFromPath", connection, path, name, schema, create, internal });
       }
@@ -161,11 +137,8 @@ var init_client = __esm({
       cancelQuery(query) {
         return this.request({ id: this.nextId++, type: "cancelQuery", query });
       }
-      releaseQuery(query) {
-        return this.request({ id: this.nextId++, type: "releaseQuery", query });
-      }
-      releaseQueryWithInfo(query) {
-        return this.request({ id: this.nextId++, type: "releaseQueryWithInfo", query });
+      finishQuery(query) {
+        return this.request({ id: this.nextId++, type: "finishQuery", query });
       }
       async terminate() {
         await this.transport.terminate();
@@ -258,10 +231,11 @@ function assertBrowserSupport(environment = globalThis) {
     throw new Error("HyperDB cannot initialize because this browser does not support the origin-private file system");
   }
 }
-function resolveBrowserWorkerUrl(workerUrl, engineUrl, wasmUrl) {
+function resolveBrowserWorkerUrl(workerUrl, engineUrl, wasmUrl, storagePath) {
   const resolved = new URL(workerUrl);
   resolved.searchParams.set("engineUrl", new URL(engineUrl).href);
   if (wasmUrl != null) resolved.searchParams.set("wasmUrl", new URL(wasmUrl).href);
+  if (storagePath != null) resolved.searchParams.set("storagePath", storagePath);
   return resolved;
 }
 function createBrowserClient(options = {}) {
@@ -269,7 +243,7 @@ function createBrowserClient(options = {}) {
   const workerUrl = options.workerUrl ?? new URL("./browser_worker.js", import.meta.url);
   const engineUrl = options.engineUrl ?? new URL("./hyperdb-wasm.js", import.meta.url);
   return new HyperDBEngineClient(
-    new BrowserWorker(new Worker(resolveBrowserWorkerUrl(workerUrl, engineUrl, options.wasmUrl), { type: "classic" })),
+    new BrowserWorker(new Worker(resolveBrowserWorkerUrl(workerUrl, engineUrl, options.wasmUrl, options.storagePath), { type: "classic" })),
     options.onSetupProgress
   );
 }
@@ -12166,7 +12140,6 @@ var HyperDBError = class extends Error {
     this.hint = hint;
   }
 };
-var maxPersistentDatabaseNameLength = 200;
 function deferred() {
   let resolve;
   let reject;
@@ -12222,26 +12195,6 @@ function normalizeArrowInsertOptions(options) {
   if (!options.name) throw new Error("Arrow insert table name must not be empty");
   return { name: options.name, schema: options.schema ?? null, create: options.create ?? true };
 }
-function validateDatabaseName(databaseName) {
-  if (!databaseName) throw new Error("Database name must not be empty");
-  if (databaseName.includes("\0")) throw new Error("Database name must not contain NUL");
-}
-function validatePersistentDatabaseName(databaseName) {
-  validateDatabaseName(databaseName);
-  if (databaseName.length > maxPersistentDatabaseNameLength) {
-    throw new Error(`Persistent database name must be at most ${maxPersistentDatabaseNameLength} characters`);
-  }
-  if (!/^[a-z0-9][a-z0-9_-]*$/.test(databaseName)) {
-    throw new Error("Persistent database name must start with a lowercase ASCII letter or digit and contain only lowercase ASCII letters, digits, hyphens, and underscores");
-  }
-  if (/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])$/.test(databaseName)) {
-    throw new Error("Persistent database name is reserved by Windows");
-  }
-}
-function validateDatabaseAlias(alias) {
-  if (!alias) throw new Error("Database alias must not be empty");
-  if (alias.includes("\0")) throw new Error("Database alias must not contain NUL");
-}
 function materializeDictionaryColumns(table) {
   const dictionaryColumns = table.schema.fields.map((field, index) => DataType.isDictionary(field.type) ? index : -1).filter((index) => index !== -1);
   if (dictionaryColumns.length === 0) return table;
@@ -12282,34 +12235,6 @@ async function initializeHyperDB(client, settings) {
   if (serialized === void 0) throw new Error("HyperDB settings must be JSON-serializable");
   expectOk(await client.initialize(serialized), "initialize HyperDB settings");
 }
-function readDatabasesFromResult(result) {
-  expectOk(result, "list databases");
-  const invalidResult = () => new Error("list databases returned invalid metadata");
-  if (result.payload.byteLength < 4) throw invalidResult();
-  const view = new DataView(result.payload.buffer, result.payload.byteOffset, result.payload.byteLength);
-  const count = view.getUint32(0, true);
-  let offset = 4;
-  const databases = [];
-  const decoder2 = new TextDecoder("utf-8", { fatal: true });
-  for (let index = 0; index < count; ++index) {
-    if (offset + 8 > result.payload.byteLength) throw invalidResult();
-    const rawStorage = view.getUint32(offset, true);
-    const nameLength = view.getUint32(offset + 4, true);
-    offset += 8;
-    if (nameLength > result.payload.byteLength - offset) throw invalidResult();
-    let name;
-    try {
-      name = decoder2.decode(result.payload.subarray(offset, offset + nameLength));
-    } catch {
-      throw invalidResult();
-    }
-    if (!name || name.includes("\0") || rawStorage !== 0 && rawStorage !== 1) throw invalidResult();
-    databases.push({ name, storage: rawStorage === 0 ? "transient" : "persistent" });
-    offset += nameLength;
-  }
-  if (offset !== result.payload.byteLength) throw invalidResult();
-  return databases;
-}
 function yieldToEventLoop() {
   return new Promise((resolve) => setTimeout(resolve, 0));
 }
@@ -12349,25 +12274,6 @@ var HyperDB = class _HyperDB {
     this.connections.add(result);
     return result;
   }
-  async createDatabase(databaseName, options = {}) {
-    validateDatabaseName(databaseName);
-    if (options.storage !== void 0 && options.storage !== "transient" && options.storage !== "persistent") {
-      throw new Error(`Unsupported database storage: ${String(options.storage)}`);
-    }
-    if (options.storage === "persistent") validatePersistentDatabaseName(databaseName);
-    await this.runDatabaseOperation(async () => {
-      expectOk(await this.client.createDatabase(databaseName, options.storage === "persistent"), "create database");
-    });
-  }
-  async openDatabase(databaseName) {
-    validatePersistentDatabaseName(databaseName);
-    await this.runDatabaseOperation(async () => {
-      expectOk(await this.client.openDatabase(databaseName), "open database");
-    });
-  }
-  listDatabases() {
-    return this.runDatabaseOperation(async () => readDatabasesFromResult(await this.client.listDatabases()));
-  }
   async registerExternalFile(...args) {
     if (args.length === 1) {
       const [sourcePath] = args;
@@ -12419,18 +12325,6 @@ var HyperDB = class _HyperDB {
       return path;
     });
   }
-  async checkpointDatabase(databaseName) {
-    validateDatabaseName(databaseName);
-    await this.runDatabaseOperation(async () => {
-      expectOk(await this.client.checkpointDatabase(databaseName), "checkpoint database");
-    });
-  }
-  async dropDatabase(databaseName) {
-    validateDatabaseName(databaseName);
-    await this.runDatabaseOperation(async () => {
-      expectOk(await this.client.dropDatabase(databaseName), "drop database");
-    });
-  }
   async terminate() {
     if (this.terminated) return;
     if (this.activeDatabaseOperations !== 0) throw new Error("database has an active operation");
@@ -12502,25 +12396,6 @@ var HyperDBConnection = class {
     }
     await this.closing;
   }
-  async attachDatabase(databaseName, alias = databaseName) {
-    validateDatabaseName(databaseName);
-    validateDatabaseAlias(alias);
-    this.ensureAvailable();
-    try {
-      expectOk(await this.client.attachDatabase(this.connection, databaseName, alias), "attach database");
-    } finally {
-      this.active = false;
-    }
-  }
-  async detachDatabase(alias) {
-    validateDatabaseAlias(alias);
-    this.ensureAvailable();
-    try {
-      expectOk(await this.client.detachDatabase(this.connection, alias), "detach database");
-    } finally {
-      this.active = false;
-    }
-  }
   sendIPC(sql) {
     const connection = this;
     const queryInfo = deferred();
@@ -12532,7 +12407,7 @@ var HyperDBConnection = class {
       try {
         connection.ensureAvailable();
         acquired = true;
-        query = readHandleFromResult(await connection.client.startQueryWithInfo(connection.connection, sql), "start query");
+        query = readHandleFromResult(await connection.client.startQuery(connection.connection, sql), "start query");
         for (; ; ) {
           let result2 = prefetched ? await prefetched : await connection.client.pollQuery(query);
           prefetched = void 0;
@@ -12574,7 +12449,7 @@ var HyperDBConnection = class {
               }
             }
             try {
-              info = await connection.releaseWithInfo(query);
+              info = decodeQueryInfo(await connection.finishQuery(query));
             } catch (error) {
               cleanupError ??= error;
             }
@@ -12667,7 +12542,7 @@ var HyperDBConnection = class {
       }
     } finally {
       try {
-        if (query !== void 0) await this.release(query);
+        if (query !== void 0) await this.finishQuery(query);
       } finally {
         if (acquire) this.active = false;
       }
@@ -12681,22 +12556,12 @@ var HyperDBConnection = class {
     }
     this.active = true;
   }
-  async release(query) {
-    let delay = 1;
-    for (; ; ) {
-      const result = await this.client.releaseQuery(query);
-      if (result.state === "ok") return;
-      if (result.state !== "pending") throw readErrorFromResult(result, "release query");
-      await new Promise((resolve) => setTimeout(resolve, delay));
-      delay = Math.min(delay * 2, 32);
-    }
-  }
-  async releaseWithInfo(query) {
+  async finishQuery(query) {
     let delay = 1;
     for (; ; ) {
-      const result = await this.client.releaseQueryWithInfo(query);
-      if (result.state === "ok") return decodeQueryInfo(result.payload);
-      if (result.state !== "pending") throw readErrorFromResult(result, "release query");
+      const result = await this.client.finishQuery(query);
+      if (result.state === "ok") return result.payload;
+      if (result.state !== "pending") throw readErrorFromResult(result, "finish query");
       await new Promise((resolve) => setTimeout(resolve, delay));
       delay = Math.min(delay * 2, 32);
     }

package/dist/browser_worker.js

@@ -48,51 +48,33 @@
     initialize;
     connect;
     disconnect;
-    createDatabase;
-    openDatabase;
-    listDatabases;
-    checkpointDatabase;
-    dropDatabase;
     shutdown;
     registerExternalFile;
     registerExternalDirectory;
     removeExternalRegistration;
-    attachDatabase;
-    detachDatabase;
     startQuery;
-    startQueryWithInfo;
     insertArrowIPCFromPath;
     pollQuery;
     cancelQuery;
-    releaseQuery;
-    releaseQueryWithInfo;
+    finishQuery;
     resultState;
     resultPayloadLength;
     free;
     nextTemporaryFile = 1;
     constructor(module) {
       this.module = module;
-      this.initialize = module.cwrap("hyperdb_wasm_initialize", "pointer", ["string"]);
+      this.initialize = module.cwrap("hyperdb_wasm_initialize", "pointer", ["string", "string"]);
       this.connect = module.cwrap("hyperdb_wasm_connect", "pointer", []);
       this.disconnect = module.cwrap("hyperdb_wasm_disconnect", "pointer", ["number"]);
-      this.createDatabase = module.cwrap("hyperdb_wasm_create_database", "pointer", ["string", "number"]);
-      this.openDatabase = module.cwrap("hyperdb_wasm_open_database", "pointer", ["string"]);
-      this.listDatabases = module.cwrap("hyperdb_wasm_list_databases", "pointer", []);
-      this.checkpointDatabase = module.cwrap("hyperdb_wasm_checkpoint_database", "pointer", ["string"]);
-      this.dropDatabase = module.cwrap("hyperdb_wasm_drop_database", "pointer", ["string"]);
       this.shutdown = module.cwrap("hyperdb_wasm_shutdown", "pointer", []);
       this.registerExternalFile = module.cwrap("hyperdb_wasm_register_external_file", "pointer", ["string", "string", "number"]);
       this.registerExternalDirectory = module.cwrap("hyperdb_wasm_register_external_directory", "pointer", ["string", "string", "number"]);
       this.removeExternalRegistration = module.cwrap("hyperdb_wasm_remove_external_registration", "pointer", ["string"]);
-      this.attachDatabase = module.cwrap("hyperdb_wasm_attach_database", "pointer", ["number", "string", "string"]);
-      this.detachDatabase = module.cwrap("hyperdb_wasm_detach_database", "pointer", ["number", "string"]);
       this.startQuery = module.cwrap("hyperdb_wasm_query_start", "pointer", ["number", "string", "number"]);
-      this.startQueryWithInfo = module.cwrap("hyperdb_wasm_query_start_with_info", "pointer", ["number", "string"]);
       this.insertArrowIPCFromPath = module.cwrap("hyperdb_wasm_arrow_insert_from_path", "pointer", ["number", "string", "string", "string", "number"]);
       this.pollQuery = module.cwrap("hyperdb_wasm_query_poll", "pointer", ["number"]);
       this.cancelQuery = module.cwrap("hyperdb_wasm_query_cancel", "pointer", ["number"]);
-      this.releaseQuery = module.cwrap("hyperdb_wasm_query_release", "pointer", ["number"]);
-      this.releaseQueryWithInfo = module.cwrap("hyperdb_wasm_query_release_with_info", "pointer", ["number"]);
+      this.finishQuery = module.cwrap("hyperdb_wasm_query_finish", "pointer", ["number"]);
       this.resultState = module.cwrap("hyperdb_wasm_result_state", "number", ["number"]);
       this.resultPayloadLength = module.cwrap("hyperdb_wasm_result_payload_len", "number", ["number"]);
       this.free = module.cwrap("hyperdb_wasm_free", null, ["pointer"]);
@@ -201,32 +183,11 @@
       switch (request.type) {
         case "initialize":
           validateCString(request.settings, "settings");
-          return this.initialize(request.settings);
+          return this.initialize(request.settings, this.module.hyperdbWasmStoragePath ?? "");
         case "connect":
           return this.connect();
         case "disconnect":
           return this.disconnect(request.connection);
-        case "createDatabase":
-          validateCString(request.databaseName, "database name");
-          return this.createDatabase(request.databaseName, Number(request.persistent));
-        case "openDatabase":
-          validateCString(request.databaseName, "database name");
-          return this.openDatabase(request.databaseName);
-        case "listDatabases":
-          return this.listDatabases();
-        case "checkpointDatabase":
-          validateCString(request.databaseName, "database name");
-          return this.checkpointDatabase(request.databaseName);
-        case "dropDatabase":
-          validateCString(request.databaseName, "database name");
-          return this.dropDatabase(request.databaseName);
-        case "attachDatabase":
-          validateCString(request.databaseName, "database name");
-          validateCString(request.alias, "database alias");
-          return this.attachDatabase(request.connection, request.databaseName, request.alias);
-        case "detachDatabase":
-          validateCString(request.alias, "database alias");
-          return this.detachDatabase(request.connection, request.alias);
         case "shutdown":
           return this.shutdown();
         case "registerExternalFile":
@@ -241,8 +202,6 @@
           return this.removeExternalRegistration(request.path);
         case "startQuery":
           return this.startQuery(request.connection, request.sql, Number(request.sqlTestMode ?? false));
-        case "startQueryWithInfo":
-          return this.startQueryWithInfo(request.connection, request.sql);
         case "insertArrowIPCFromPath": {
           const path = request.internal ? request.path : this.module.resolveHyperDBPath?.(request.path) ?? request.path;
           return this.insertArrowIPCFromPath(request.connection, path, request.name, request.schema ?? "", Number(request.create));
@@ -251,10 +210,8 @@
           return this.pollQuery(request.query);
         case "cancelQuery":
           return this.cancelQuery(request.query);
-        case "releaseQuery":
-          return this.releaseQuery(request.query);
-        case "releaseQueryWithInfo":
-          return this.releaseQueryWithInfo(request.query);
+        case "finishQuery":
+          return this.finishQuery(request.query);
       }
     }
     decodeResult(pointer) {
@@ -308,26 +265,13 @@
       case "initialize":
         return hasKeys(value, ["id", "type", "settings"]) && typeof value.settings === "string";
       case "connect":
-      case "listDatabases":
         return hasKeys(value, ["id", "type"]);
       case "disconnect":
         return hasKeys(value, ["id", "type", "connection"]) && Number.isSafeInteger(value.connection);
-      case "createDatabase":
-        return hasKeys(value, ["id", "type", "databaseName", "persistent"]) && typeof value.databaseName === "string" && typeof value.persistent === "boolean";
-      case "openDatabase":
-      case "checkpointDatabase":
-      case "dropDatabase":
-        return hasKeys(value, ["id", "type", "databaseName"]) && typeof value.databaseName === "string";
       case "shutdown":
         return hasKeys(value, ["id", "type"]);
-      case "attachDatabase":
-        return hasKeys(value, ["id", "type", "connection", "databaseName", "alias"]) && Number.isSafeInteger(value.connection) && typeof value.databaseName === "string" && typeof value.alias === "string";
-      case "detachDatabase":
-        return hasKeys(value, ["id", "type", "connection", "alias"]) && Number.isSafeInteger(value.connection) && typeof value.alias === "string";
       case "startQuery":
         return (hasKeys(value, ["id", "type", "connection", "sql"]) || hasKeys(value, ["id", "type", "connection", "sql", "sqlTestMode"])) && Number.isSafeInteger(value.connection) && typeof value.sql === "string" && (value.sqlTestMode === void 0 || typeof value.sqlTestMode === "boolean");
-      case "startQueryWithInfo":
-        return hasKeys(value, ["id", "type", "connection", "sql"]) && Number.isSafeInteger(value.connection) && typeof value.sql === "string";
       case "insertArrowIPCFromPath":
         return hasKeys(value, ["id", "type", "connection", "path", "name", "schema", "create", "internal"]) && Number.isSafeInteger(value.connection) && typeof value.path === "string" && typeof value.name === "string" && (typeof value.schema === "string" || value.schema === null) && typeof value.create === "boolean" && typeof value.internal === "boolean";
       case "createTemporaryFile":
@@ -342,8 +286,7 @@
         return hasKeys(value, ["id", "type", "path"]) && typeof value.path === "string";
       case "pollQuery":
       case "cancelQuery":
-      case "releaseQuery":
-      case "releaseQueryWithInfo":
+      case "finishQuery":
         return hasKeys(value, ["id", "type", "query"]) && Number.isSafeInteger(value.query);
       default:
         return false;
@@ -846,6 +789,21 @@
   var resolvedEngineUrl = new URL(engineUrl, self.location.href);
   var configuredWasmUrl = new URL(self.location.href).searchParams.get("wasmUrl");
   var resolvedWasmUrl = configuredWasmUrl == null ? new URL("hyperdb-wasm.wasm.br", resolvedEngineUrl) : new URL(configuredWasmUrl);
+  var configuredStoragePath = new URL(self.location.href).searchParams.get("storagePath") ?? "";
+  function normalizeStoragePath(path) {
+    const parts = [];
+    for (const part of path.replace(/^\/+/, "").split("/")) {
+      if (!part || part === ".") continue;
+      if (part === "..") {
+        if (parts.length === 0) throw new Error(`Storage path is outside the OPFS root: ${path}`);
+        parts.pop();
+      } else {
+        parts.push(part);
+      }
+    }
+    return parts.join("/");
+  }
+  var storagePath = normalizeStoragePath(configuredStoragePath);
   function isPthreadWorker() {
     const location = self.location;
     return self.name === "em-pthread" || location.search?.includes("pthread") === true;
@@ -889,24 +847,14 @@
       runtime.externalFileBackendAvailable = true;
       runtime.externalDirectoryBackend = new BrowserExternalDirectoryBackend();
       if (!runtime.OPFS) throw new Error("OPFS backend is unavailable");
-      runtime.FS.mkdirTree("/opfs");
-      runtime.FS.mount(runtime.OPFS, {}, "/opfs");
-      runtime.FS.mkdirTree("/hyperdb-persistent");
-      runtime.FS.mount(runtime.OPFS, {}, "/hyperdb-persistent");
-      runtime.FS.mkdirTree("/hyperdb-persistent/hyperdb");
-      runtime.FS.mkdirTree("/hyperdb-persistent/logs");
+      runtime.FS.mkdirTree("/mnt/fs");
+      runtime.FS.mount(runtime.OPFS, {}, "/mnt/fs");
+      if (storagePath) runtime.FS.mkdirTree(`/mnt/fs/${storagePath}`);
+      runtime.FS.mkdirTree(`${storagePath ? `/mnt/fs/${storagePath}` : "/mnt/fs"}/logs`);
+      runtime.hyperdbWasmStoragePath = storagePath;
       runtime.resolveHyperDBPath = (path) => {
-        const parts = [];
-        for (const part of path.replace(/^\/+/, "").split("/")) {
-          if (!part || part === ".") continue;
-          if (part === "..") {
-            if (parts.length === 0) throw new Error(`Arrow IPC path is outside the OPFS root: ${path}`);
-            parts.pop();
-          } else {
-            parts.push(part);
-          }
-        }
-        return `/opfs/${parts.join("/")}`;
+        const relativePath = normalizeStoragePath(path);
+        return `${storagePath ? `/mnt/fs/${storagePath}` : "/mnt/fs"}/${relativePath}`;
       };
     });
     self.importScripts(resolvedEngineUrl.href);

package/dist/client.d.ts

@@ -14,16 +14,8 @@ export declare class HyperDBEngineClient {
     initialize(settings: string): Promise<WasmResult>;
     connect(): Promise<WasmResult>;
     disconnect(connection: number): Promise<WasmResult>;
-    createDatabase(databaseName: string, persistent: boolean): Promise<WasmResult>;
-    openDatabase(databaseName: string): Promise<WasmResult>;
-    listDatabases(): Promise<WasmResult>;
-    checkpointDatabase(databaseName: string): Promise<WasmResult>;
-    dropDatabase(databaseName: string): Promise<WasmResult>;
-    attachDatabase(connection: number, databaseName: string, alias: string): Promise<WasmResult>;
-    detachDatabase(connection: number, alias: string): Promise<WasmResult>;
     shutdown(): Promise<WasmResult>;
     startQuery(connection: number, sql: string, sqlTestMode?: boolean): Promise<WasmResult>;
-    startQueryWithInfo(connection: number, sql: string): Promise<WasmResult>;
     insertArrowIPCFromPath(connection: number, path: string, name: string, schema: string | null, create: boolean, internal?: boolean): Promise<WasmResult>;
     createTemporaryFile(bytes: Uint8Array): Promise<WasmResult>;
     removeFile(path: string): Promise<WasmResult>;
@@ -33,8 +25,7 @@ export declare class HyperDBEngineClient {
     removeExternalRegistration(path: string): Promise<WasmResult>;
     pollQuery(query: number): Promise<WasmResult>;
     cancelQuery(query: number): Promise<WasmResult>;
-    releaseQuery(query: number): Promise<WasmResult>;
-    releaseQueryWithInfo(query: number): Promise<WasmResult>;
+    finishQuery(query: number): Promise<WasmResult>;
     terminate(): Promise<void>;
     private request;
     private onMessage;