@korajs/store 1.0.0-beta.12 → 1.0.0-beta.14

package/dist/adapters/sqlite-wasm.js

@@ -1,16 +1,122 @@
 import {
-  SqliteWasmAdapter
-} from "../chunk-RJIEKEN4.js";
+  SqliteWasmAdapter,
+  deleteFromIndexedDB,
+  deleteManifestRecord,
+  listManifestRecords,
+  loadDumpFromIndexedDB,
+  readManifestRecord,
+  restoreDumpStatements
+} from "../chunk-BQSIL6TT.js";
 import {
   WebWorkerBridge
-} from "../chunk-VDBJQ75K.js";
+} from "../chunk-KK3GBONL.js";
 import {
   Mutex
 } from "../chunk-TVJEC5S2.js";
-import "../chunk-TUR7RGEP.js";
+import {
+  leaderLockName,
+  opfsPoolNameFor
+} from "../chunk-5JMGMPUE.js";
+import {
+  AdapterError,
+  StorageInUseError,
+  UnsyncedDataError
+} from "../chunk-SRHDJF5B.js";
+
+// src/adapters/local-databases.ts
+async function listLocalDatabases() {
+  return listManifestRecords();
+}
+async function withExclusiveDatabase(dbName, run) {
+  const locks = typeof navigator !== "undefined" ? navigator.locks : void 0;
+  if (!locks || typeof locks.request !== "function") {
+    return run();
+  }
+  let ran = false;
+  let result;
+  await locks.request(
+    leaderLockName(dbName),
+    { mode: "exclusive", ifAvailable: true },
+    async (lock) => {
+      if (lock === null) return;
+      ran = true;
+      result = await run();
+    }
+  );
+  if (!ran) {
+    throw new StorageInUseError(dbName);
+  }
+  return result;
+}
+async function deleteLocalDatabase(dbName, options) {
+  const record = await readManifestRecord(dbName);
+  const backend = record?.backend ?? "opfs";
+  return withExclusiveDatabase(dbName, async () => {
+    const { WebWorkerBridge: WebWorkerBridge2 } = await import("../sqlite-wasm-channel-QCCNBYCU.js");
+    const worker = new WebWorkerBridge2(options.workerUrl, options.workerResponseTimeoutMs ?? 3e4);
+    const send = async (request) => worker.send(request);
+    const reader = {
+      dbName,
+      query: async (sql, params) => {
+        const response = await send({ id: 0, type: "query", sql, params });
+        if (response.type === "error") {
+          throw new AdapterError(`Query failed: ${response.message}`, { dbName, sql });
+        }
+        return response.data ?? [];
+      }
+    };
+    try {
+      let exists;
+      if (backend === "opfs") {
+        const opened = await worker.send(
+          { id: 0, type: "open", ddlStatements: [], dbName, mustExist: true },
+          void 0,
+          { timeoutMs: Number.POSITIVE_INFINITY }
+        );
+        if (opened.type === "error" && opened.code !== "NOT_FOUND") {
+          throw new AdapterError(`Could not open "${dbName}" for deletion: ${opened.message}`, {
+            dbName,
+            code: opened.code
+          });
+        }
+        exists = opened.type === "success";
+      } else {
+        const dump = await loadDumpFromIndexedDB(dbName);
+        exists = dump !== null;
+        if (dump) {
+          await send({ id: 0, type: "open", ddlStatements: [], dbName, storage: "memory" });
+          for (const statement of restoreDumpStatements(dump, true)) {
+            await send({ id: 0, type: "execute", sql: statement.sql, params: statement.params });
+          }
+        }
+      }
+      if (exists && !options.force && options.hasUnsyncedOperations) {
+        if (await options.hasUnsyncedOperations(reader)) {
+          throw new UnsyncedDataError(dbName);
+        }
+      }
+      if (backend === "opfs" && exists) {
+        const destroyed = await send({ id: 0, type: "destroy" });
+        if (destroyed.type === "error") {
+          throw new AdapterError(`Could not delete "${dbName}": ${destroyed.message}`, { dbName });
+        }
+      }
+      if (backend === "indexeddb") {
+        await deleteFromIndexedDB(dbName);
+      }
+      await deleteManifestRecord(dbName);
+      return exists || record !== null;
+    } finally {
+      worker.terminate();
+    }
+  });
+}
 export {
   Mutex,
   SqliteWasmAdapter,
-  WebWorkerBridge
+  WebWorkerBridge,
+  deleteLocalDatabase,
+  listLocalDatabases,
+  opfsPoolNameFor
 };
 //# sourceMappingURL=sqlite-wasm.js.map

package/dist/adapters/sqlite-wasm.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../src/adapters/local-databases.ts"],"sourcesContent":["/// <reference lib=\"dom\" />\n/**\n * Explicit management of the local databases on this origin (W8a, NEW-STORE-7).\n *\n * Kora never evicts a database on its own: a full pool is prevented by\n * per-database pools and capacity reservation, and removing data is always an\n * explicit call that refuses while the database is open or still holds\n * operations the server has not acknowledged.\n */\n\nimport { AdapterError, StorageInUseError, UnsyncedDataError } from '../errors'\nimport { type DatabaseDump, restoreDumpStatements } from './database-dump'\nimport { leaderLockName } from './opfs-names'\nimport type { WorkerRequest, WorkerResponse } from './sqlite-wasm-channel'\nimport { deleteFromIndexedDB, loadDumpFromIndexedDB } from './sqlite-wasm-persistence'\nimport {\n\ttype LocalDatabaseRecord,\n\tdeleteManifestRecord,\n\tlistManifestRecords,\n\treadManifestRecord,\n} from './storage-manifest'\n\n/** Read-only access to a database handed to the unsynced-data check. */\nexport interface LocalDatabaseReader {\n\tdbName: string\n\tquery<T>(sql: string, params?: unknown[]): Promise<T[]>\n}\n\n/** Options for {@link deleteLocalDatabase}. */\nexport interface DeleteLocalDatabaseOptions {\n\t/** URL of the Kora SQLite worker (the same one the app's store uses). */\n\tworkerUrl: string | URL\n\t/**\n\t * Decides whether the database still holds operations the server never\n\t * acknowledged. Injected by the app layer, which knows its sync setup.\n\t * When it returns true the delete is refused with {@link UnsyncedDataError}.\n\t */\n\thasUnsyncedOperations?: (db: LocalDatabaseReader) => Promise<boolean>\n\t/** Delete even when unsynced operations exist (they are lost). */\n\tforce?: boolean\n\t/** Worker response timeout. Defaults to 30000ms. */\n\tworkerResponseTimeoutMs?: number\n}\n\n/**\n * Databases Kora has recorded on this origin (created or opened since W8a).\n * A database still in the pre-W8a shared pool appears after its first open.\n */\nexport async function listLocalDatabases(): Promise<LocalDatabaseRecord[]> {\n\treturn listManifestRecords()\n}\n\n/**\n * Hold a database's leader lock for the duration of `run`, so no tab can open\n * it meanwhile. Throws {@link StorageInUseError} when it is open somewhere.\n */\nasync function withExclusiveDatabase<T>(dbName: string, run: () => Promise<T>): Promise<T> {\n\tconst locks = typeof navigator !== 'undefined' ? navigator.locks : undefined\n\tif (!locks || typeof locks.request !== 'function') {\n\t\treturn run()\n\t}\n\tlet ran = false\n\tlet result: T | undefined\n\tawait locks.request(\n\t\tleaderLockName(dbName),\n\t\t{ mode: 'exclusive', ifAvailable: true },\n\t\tasync (lock) => {\n\t\t\tif (lock === null) return\n\t\t\tran = true\n\t\t\tresult = await run()\n\t\t},\n\t)\n\tif (!ran) {\n\t\tthrow new StorageInUseError(dbName)\n\t}\n\treturn result as T\n}\n\n/**\n * Permanently delete a local database and its OPFS pool or IndexedDB copy.\n *\n * Refuses with {@link StorageInUseError} while any tab has the database open,\n * and with {@link UnsyncedDataError} while `hasUnsyncedOperations` reports\n * unsynced operations (unless `force`). Never touches any other database.\n *\n * @returns true when something was deleted, false when the database did not exist\n */\nexport async function deleteLocalDatabase(\n\tdbName: string,\n\toptions: DeleteLocalDatabaseOptions,\n): Promise<boolean> {\n\tconst record = await readManifestRecord(dbName)\n\tconst backend = record?.backend ?? 'opfs'\n\treturn withExclusiveDatabase(dbName, async () => {\n\t\tconst { WebWorkerBridge } = await import('./sqlite-wasm-channel')\n\t\tconst worker = new WebWorkerBridge(options.workerUrl, options.workerResponseTimeoutMs ?? 30_000)\n\t\tconst send = async (request: WorkerRequest): Promise<WorkerResponse> => worker.send(request)\n\t\tconst reader: LocalDatabaseReader = {\n\t\t\tdbName,\n\t\t\tquery: async <T>(sql: string, params?: unknown[]): Promise<T[]> => {\n\t\t\t\tconst response = await send({ id: 0, type: 'query', sql, params })\n\t\t\t\tif (response.type === 'error') {\n\t\t\t\t\tthrow new AdapterError(`Query failed: ${response.message}`, { dbName, sql })\n\t\t\t\t}\n\t\t\t\treturn (response.data as T[]) ?? []\n\t\t\t},\n\t\t}\n\t\ttry {\n\t\t\tlet exists: boolean\n\t\t\tif (backend === 'opfs') {\n\t\t\t\tconst opened = await worker.send(\n\t\t\t\t\t{ id: 0, type: 'open', ddlStatements: [], dbName, mustExist: true },\n\t\t\t\t\tundefined,\n\t\t\t\t\t{ timeoutMs: Number.POSITIVE_INFINITY },\n\t\t\t\t)\n\t\t\t\tif (opened.type === 'error' && opened.code !== 'NOT_FOUND') {\n\t\t\t\t\tthrow new AdapterError(`Could not open \"${dbName}\" for deletion: ${opened.message}`, {\n\t\t\t\t\t\tdbName,\n\t\t\t\t\t\tcode: opened.code,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\texists = opened.type === 'success'\n\t\t\t} else {\n\t\t\t\tconst dump = await loadDumpFromIndexedDB<DatabaseDump>(dbName)\n\t\t\t\texists = dump !== null\n\t\t\t\tif (dump) {\n\t\t\t\t\tawait send({ id: 0, type: 'open', ddlStatements: [], dbName, storage: 'memory' })\n\t\t\t\t\tfor (const statement of restoreDumpStatements(dump, true)) {\n\t\t\t\t\t\tawait send({ id: 0, type: 'execute', sql: statement.sql, params: statement.params })\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (exists && !options.force && options.hasUnsyncedOperations) {\n\t\t\t\tif (await options.hasUnsyncedOperations(reader)) {\n\t\t\t\t\tthrow new UnsyncedDataError(dbName)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (backend === 'opfs' && exists) {\n\t\t\t\tconst destroyed = await send({ id: 0, type: 'destroy' })\n\t\t\t\tif (destroyed.type === 'error') {\n\t\t\t\t\tthrow new AdapterError(`Could not delete \"${dbName}\": ${destroyed.message}`, { dbName })\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (backend === 'indexeddb') {\n\t\t\t\tawait deleteFromIndexedDB(dbName)\n\t\t\t}\n\t\t\tawait deleteManifestRecord(dbName)\n\t\t\treturn exists || record !== null\n\t\t} finally {\n\t\t\tworker.terminate()\n\t\t}\n\t})\n}\n"],"mappings":"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","names":["WebWorkerBridge"]}

package/dist/backup-IHKVMUAM.js

@@ -0,0 +1,25 @@
+import {
+  BACKUP_VERSION,
+  BackupFormatError,
+  convertBackupV1,
+  exportBackup,
+  parseBackup,
+  readBackupManifest,
+  restoreBackup,
+  verifyBackupChecksum
+} from "./chunk-UC2LGFPV.js";
+import "./chunk-KTVNANUH.js";
+import "./chunk-QW4UU7NG.js";
+import "./chunk-J5AGXF3D.js";
+import "./chunk-SRHDJF5B.js";
+export {
+  BACKUP_VERSION,
+  BackupFormatError,
+  convertBackupV1,
+  exportBackup,
+  parseBackup,
+  readBackupManifest,
+  restoreBackup,
+  verifyBackupChecksum
+};
+//# sourceMappingURL=backup-IHKVMUAM.js.map