@korajs/store 0.4.0 → 0.5.0

package/dist/adapters/better-sqlite3.d.cts

@@ -1,5 +1,5 @@
 import { SchemaDefinition } from '@korajs/core';
-import { S as StorageAdapter, T as Transaction, M as MigrationPlan } from '../types-DF-KDSK1.cjs';
+import { S as StorageAdapter, T as Transaction, M as MigrationPlan } from '../types-DepnRDk_.cjs';
 
 /**
  * Storage adapter backed by better-sqlite3 for Node.js environments.

package/dist/adapters/better-sqlite3.d.ts

@@ -1,5 +1,5 @@
 import { SchemaDefinition } from '@korajs/core';
-import { S as StorageAdapter, T as Transaction, M as MigrationPlan } from '../types-DF-KDSK1.js';
+import { S as StorageAdapter, T as Transaction, M as MigrationPlan } from '../types-DepnRDk_.js';
 
 /**
  * Storage adapter backed by better-sqlite3 for Node.js environments.

package/dist/adapters/indexeddb.cjs

@@ -181,9 +181,299 @@ module.exports = __toCommonJS(indexeddb_exports);
 // src/adapters/indexeddb-adapter.ts
 init_errors();
 
+// src/adapters/indexeddb-persistence-scheduler.ts
+var DEFAULT_DEBOUNCE_MS = 500;
+var IndexedDbPersistenceScheduler = class {
+  debounceMs;
+  flush;
+  onError;
+  timer = null;
+  inFlight = null;
+  disposed = false;
+  onVisibilityChange;
+  constructor(options) {
+    this.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    this.flush = options.flush;
+    this.onError = options.onError;
+    this.onVisibilityChange = () => {
+      if (typeof document !== "undefined" && document.visibilityState === "hidden") {
+        void this.flushNow();
+      }
+    };
+    if (typeof document !== "undefined") {
+      document.addEventListener("visibilitychange", this.onVisibilityChange);
+    }
+  }
+  /** Schedule a debounced snapshot write. */
+  schedule() {
+    if (this.disposed) return;
+    if (this.debounceMs <= 0) {
+      void this.flushNow();
+      return;
+    }
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+    }
+    this.timer = setTimeout(() => {
+      this.timer = null;
+      void this.flushNow();
+    }, this.debounceMs);
+  }
+  /** Cancel any pending debounce and persist immediately. */
+  async flushNow() {
+    if (this.disposed) return;
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    if (this.inFlight) {
+      await this.inFlight;
+      return;
+    }
+    this.inFlight = this.runFlush();
+    try {
+      await this.inFlight;
+    } finally {
+      this.inFlight = null;
+    }
+  }
+  dispose() {
+    this.disposed = true;
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    if (typeof document !== "undefined") {
+      document.removeEventListener("visibilitychange", this.onVisibilityChange);
+    }
+  }
+  async runFlush() {
+    try {
+      await this.flush();
+    } catch (error) {
+      this.onError?.(error);
+    }
+  }
+};
+
 // src/adapters/sqlite-wasm-adapter.ts
 var import_core2 = require("@korajs/core");
 init_errors();
+
+// src/multi-tab/shared-worker-bridge.ts
+init_errors();
+var SW_REQUEST = "kora-sw-request";
+var SW_RESPONSE = "kora-sw-response";
+var SharedWorkerClientBridge = class {
+  constructor(sharedWorker, dbName, workerUrl, timeoutMs = 3e4) {
+    this.dbName = dbName;
+    this.workerUrl = workerUrl;
+    this.timeoutMs = timeoutMs;
+    this.port = sharedWorker.port;
+    this.port.start();
+    this.port.addEventListener("message", (event) => {
+      const data = event.data;
+      if (data?.type !== SW_RESPONSE) {
+        return;
+      }
+      const entry = this.pending.get(data.requestId);
+      if (entry) {
+        this.pending.delete(data.requestId);
+        entry.resolve(data.response);
+      }
+    });
+  }
+  dbName;
+  workerUrl;
+  port;
+  pending = /* @__PURE__ */ new Map();
+  timeoutMs;
+  terminated = false;
+  async send(request) {
+    if (this.terminated) {
+      return {
+        id: request.id,
+        type: "error",
+        message: "SharedWorker bridge terminated",
+        code: "BRIDGE_TERMINATED"
+      };
+    }
+    const requestId = crypto.randomUUID();
+    const msg = {
+      type: SW_REQUEST,
+      requestId,
+      dbName: this.dbName,
+      workerUrl: this.workerUrl,
+      request
+    };
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(requestId);
+        reject(new WorkerTimeoutError(`shared-worker:${request.type}`, this.timeoutMs));
+      }, this.timeoutMs);
+      this.pending.set(requestId, {
+        resolve: (response) => {
+          clearTimeout(timer);
+          resolve(response);
+        },
+        reject: (error) => {
+          clearTimeout(timer);
+          reject(error);
+        }
+      });
+      this.port.postMessage(msg);
+    });
+  }
+  terminate() {
+    if (this.terminated) {
+      return;
+    }
+    this.terminated = true;
+    this.port.close();
+    for (const [, entry] of this.pending) {
+      entry.reject(new Error("SharedWorker bridge terminated"));
+    }
+    this.pending.clear();
+  }
+};
+
+// src/multi-tab/tab-storage.ts
+init_errors();
+var RPC_REQUEST = "kora-worker-request";
+var RPC_RESPONSE = "kora-worker-response";
+function isSharedWorkerStorageSupported() {
+  return typeof globalThis !== "undefined" && typeof SharedWorker !== "undefined";
+}
+function isMultiTabStorageSupported() {
+  return typeof globalThis !== "undefined" && typeof BroadcastChannel !== "undefined" && typeof navigator !== "undefined" && typeof navigator.locks?.request === "function";
+}
+async function acquireTabStorageSession(dbName) {
+  const channelName = `kora-storage-${dbName}`;
+  if (!isMultiTabStorageSupported()) {
+    return { role: "leader", channelName };
+  }
+  return new Promise((resolve) => {
+    let releaseHeld;
+    void navigator.locks.request(
+      `kora-leader-${dbName}`,
+      { mode: "exclusive", ifAvailable: true },
+      (lock) => {
+        if (lock === null) {
+          resolve({ role: "follower", channelName });
+          return;
+        }
+        resolve({
+          role: "leader",
+          channelName,
+          releaseLock: async () => {
+            releaseHeld?.();
+          }
+        });
+        return new Promise((release) => {
+          releaseHeld = release;
+        });
+      }
+    );
+  });
+}
+function startLeaderRpcRelay(channelName, bridge) {
+  const channel = new BroadcastChannel(channelName);
+  const onMessage = (event) => {
+    const data = event.data;
+    if (data?.type !== RPC_REQUEST) {
+      return;
+    }
+    void bridge.send(data.request).then((response) => {
+      const msg = {
+        type: RPC_RESPONSE,
+        requestId: data.requestId,
+        response
+      };
+      channel.postMessage(msg);
+    }).catch((error) => {
+      const message = error instanceof Error ? error.message : "Worker RPC failed";
+      const msg = {
+        type: RPC_RESPONSE,
+        requestId: data.requestId,
+        response: {
+          id: data.request.id,
+          type: "error",
+          message,
+          code: "LEADER_RPC_ERROR"
+        }
+      };
+      channel.postMessage(msg);
+    });
+  };
+  channel.addEventListener("message", onMessage);
+  return () => {
+    channel.removeEventListener("message", onMessage);
+    channel.close();
+  };
+}
+var FollowerBroadcastBridge = class {
+  channel;
+  pending = /* @__PURE__ */ new Map();
+  timeoutMs;
+  terminated = false;
+  constructor(channelName, timeoutMs = 3e4) {
+    this.timeoutMs = timeoutMs;
+    this.channel = new BroadcastChannel(channelName);
+    this.channel.addEventListener("message", (event) => {
+      const data = event.data;
+      if (data?.type !== RPC_RESPONSE) {
+        return;
+      }
+      const entry = this.pending.get(data.requestId);
+      if (entry) {
+        this.pending.delete(data.requestId);
+        entry.resolve(data.response);
+      }
+    });
+  }
+  async send(request) {
+    if (this.terminated) {
+      return {
+        id: request.id,
+        type: "error",
+        message: "Follower bridge terminated",
+        code: "BRIDGE_TERMINATED"
+      };
+    }
+    const requestId = crypto.randomUUID();
+    const msg = { type: RPC_REQUEST, requestId, request };
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(requestId);
+        reject(new WorkerTimeoutError(`follower-rpc:${request.type}`, this.timeoutMs));
+      }, this.timeoutMs);
+      this.pending.set(requestId, {
+        resolve: (response) => {
+          clearTimeout(timer);
+          resolve(response);
+        },
+        reject: (error) => {
+          clearTimeout(timer);
+          reject(error);
+        }
+      });
+      this.channel.postMessage(msg);
+    });
+  }
+  terminate() {
+    if (this.terminated) {
+      return;
+    }
+    this.terminated = true;
+    this.channel.close();
+    for (const [, entry] of this.pending) {
+      entry.reject(new Error("Follower bridge terminated"));
+    }
+    this.pending.clear();
+  }
+};
+
+// src/adapters/sqlite-wasm-adapter.ts
 init_sqlite_wasm_channel();
 var SqliteWasmAdapter = class {
   bridge = null;
@@ -191,26 +481,52 @@ var SqliteWasmAdapter = class {
   mutex = new Mutex();
   injectedBridge;
   workerUrl;
+  sharedWorkerUrl;
+  workerResponseTimeoutMs;
   dbName;
+  tabSession = null;
+  sharedWorker = null;
   constructor(options = {}) {
     this.injectedBridge = options.bridge;
     this.workerUrl = options.workerUrl;
+    this.sharedWorkerUrl = options.sharedWorkerUrl;
+    this.workerResponseTimeoutMs = options.workerResponseTimeoutMs ?? 3e4;
     this.dbName = options.dbName ?? "kora-db";
   }
   async open(schema) {
     if (this.opened) return;
     if (this.injectedBridge) {
       this.bridge = this.injectedBridge;
+    } else if (this.sharedWorkerUrl && this.workerUrl && isSharedWorkerStorageSupported()) {
+      const workerUrlString = typeof this.workerUrl === "string" ? this.workerUrl : this.workerUrl.href;
+      const sharedUrl = typeof this.sharedWorkerUrl === "string" ? this.sharedWorkerUrl : this.sharedWorkerUrl.href;
+      this.sharedWorker = new SharedWorker(sharedUrl, { name: `kora-sw-${this.dbName}` });
+      this.bridge = new SharedWorkerClientBridge(this.sharedWorker, this.dbName, workerUrlString);
     } else if (this.workerUrl) {
+      this.tabSession = await acquireTabStorageSession(this.dbName);
       const { WebWorkerBridge: WebWorkerBridge2 } = await Promise.resolve().then(() => (init_sqlite_wasm_channel(), sqlite_wasm_channel_exports));
-      this.bridge = new WebWorkerBridge2(this.workerUrl);
+      if (this.tabSession.role === "leader") {
+        const workerBridge = new WebWorkerBridge2(this.workerUrl, this.workerResponseTimeoutMs);
+        this.tabSession.stopRelay = startLeaderRpcRelay(this.tabSession.channelName, workerBridge);
+        this.bridge = workerBridge;
+      } else {
+        this.bridge = new FollowerBroadcastBridge(
+          this.tabSession.channelName,
+          this.workerResponseTimeoutMs
+        );
+      }
     } else {
       throw new AdapterError(
         'SqliteWasmAdapter requires either a bridge (for testing) or a workerUrl (for browsers). Pass { bridge: new MockWorkerBridge() } for tests, or { workerUrl: "/worker.js" } for browsers.'
       );
     }
     const ddlStatements = (0, import_core2.generateFullDDL)(schema);
-    const response = await this.sendRequest({ id: 0, type: "open", ddlStatements });
+    const response = await this.sendRequest({
+      id: 0,
+      type: "open",
+      ddlStatements,
+      dbName: this.dbName
+    });
     if (response.type === "error") {
       throw new AdapterError(`Failed to open database: ${response.message}`, {
         code: response.code,
@@ -224,6 +540,12 @@ var SqliteWasmAdapter = class {
     try {
       await this.sendRequest({ id: 0, type: "close" });
     } finally {
+      this.tabSession?.stopRelay?.();
+      if (this.tabSession?.releaseLock) {
+        await this.tabSession.releaseLock();
+      }
+      this.tabSession = null;
+      this.sharedWorker = null;
       this.bridge.terminate();
       this.bridge = null;
       this.opened = false;
@@ -356,6 +678,32 @@ var IDB_DATABASE_NAME = "kora-persistence";
 var IDB_STORE_NAME = "databases";
 var IDB_VERSION = 1;
 var DUMP_SUFFIX = "::dump";
+function isIndexedDbQuotaError(error) {
+  if (error instanceof DOMException && error.name === "QuotaExceededError") {
+    return true;
+  }
+  if (error instanceof PersistenceError && error.context?.quotaExceeded === true) {
+    return true;
+  }
+  if (error instanceof Error && /quota/i.test(error.message)) {
+    return true;
+  }
+  return false;
+}
+function rejectWithIdbError(reject, message, context, event) {
+  const domError = event.target?.error;
+  if (domError && isIndexedDbQuotaError(domError)) {
+    reject(
+      new PersistenceError(message, {
+        ...context,
+        quotaExceeded: true,
+        cause: domError.message
+      })
+    );
+    return;
+  }
+  reject(new PersistenceError(message, context));
+}
 function openIdb() {
   return new Promise((resolve, reject) => {
     const request = indexedDB.open(IDB_DATABASE_NAME, IDB_VERSION);
@@ -382,7 +730,12 @@ async function saveToIndexedDB(dbName, data) {
       const store = tx.objectStore(IDB_STORE_NAME);
       store.put(data, dbName);
       tx.oncomplete = () => resolve();
-      tx.onerror = () => reject(new PersistenceError(`Failed to save database "${dbName}" to IndexedDB`, { dbName }));
+      tx.onerror = (event) => rejectWithIdbError(
+        reject,
+        `Failed to save database "${dbName}" to IndexedDB`,
+        { dbName },
+        event
+      );
     });
   } finally {
     idb.close();
@@ -396,7 +749,12 @@ async function saveDumpToIndexedDB(dbName, dump) {
       const store = tx.objectStore(IDB_STORE_NAME);
       store.put(dump, `${dbName}${DUMP_SUFFIX}`);
       tx.oncomplete = () => resolve();
-      tx.onerror = () => reject(new PersistenceError(`Failed to save dump for database "${dbName}"`, { dbName }));
+      tx.onerror = (event) => rejectWithIdbError(
+        reject,
+        `Failed to save dump for database "${dbName}"`,
+        { dbName },
+        event
+      );
     });
   } finally {
     idb.close();
@@ -452,12 +810,21 @@ async function loadDumpFromIndexedDB(dbName) {
 var IndexedDbAdapter = class {
   inner;
   dbName;
+  emitter;
+  scheduler;
   constructor(options = {}) {
     this.dbName = options.dbName ?? "kora-db";
+    this.emitter = options.emitter;
     this.inner = new SqliteWasmAdapter({
       bridge: options.bridge,
       workerUrl: options.workerUrl,
-      dbName: this.dbName
+      dbName: this.dbName,
+      workerResponseTimeoutMs: options.workerResponseTimeoutMs
+    });
+    this.scheduler = new IndexedDbPersistenceScheduler({
+      debounceMs: options.persistenceDebounceMs,
+      flush: () => this.writeSnapshot(),
+      onError: (error) => this.handlePersistenceError(error)
     });
   }
   async open(schema) {
@@ -471,32 +838,55 @@ var IndexedDbAdapter = class {
     }
   }
   async close() {
-    await this.persistSnapshot();
+    await this.scheduler.flushNow();
+    this.scheduler.dispose();
     await this.inner.close();
   }
   async execute(sql, params) {
     await this.inner.execute(sql, params);
-    await this.persistSnapshot();
+    this.scheduler.schedule();
   }
   async query(sql, params) {
     return this.inner.query(sql, params);
   }
   async transaction(fn) {
     await this.inner.transaction(fn);
-    await this.persistSnapshot();
+    this.scheduler.schedule();
   }
   async migrate(from, to, migration) {
     await this.inner.migrate(from, to, migration);
-    await this.persistSnapshot();
+    this.scheduler.schedule();
   }
-  async persistSnapshot() {
-    try {
-      const data = await this.inner.exportDatabase();
-      await saveToIndexedDB(this.dbName, data);
-      const dump = await this.exportDump();
-      await saveDumpToIndexedDB(this.dbName, dump);
-    } catch {
+  /**
+   * Force an immediate snapshot write to IndexedDB (skips debounce).
+   * Useful before tab unload or in tests.
+   */
+  async flushPersistence() {
+    await this.scheduler.flushNow();
+  }
+  async writeSnapshot() {
+    const data = await this.inner.exportDatabase();
+    await saveToIndexedDB(this.dbName, data);
+    const dump = await this.exportDump();
+    await saveDumpToIndexedDB(this.dbName, dump);
+  }
+  handlePersistenceError(error) {
+    const message = error instanceof Error ? error.message : "IndexedDB persistence failed";
+    const code = error instanceof PersistenceError ? error.code : "PERSISTENCE_FAILED";
+    const quotaExceeded = isIndexedDbQuotaError(error);
+    if (quotaExceeded) {
+      this.emitter?.emit({
+        type: "store:quota-exceeded",
+        dbName: this.dbName,
+        message
+      });
     }
+    this.emitter?.emit({
+      type: "store:persistence-error",
+      dbName: this.dbName,
+      message,
+      code: quotaExceeded ? "QUOTA_EXCEEDED" : code
+    });
   }
   async restoreFromDumpFallback() {
     const dump = await loadDumpFromIndexedDB(this.dbName);
@@ -541,7 +931,10 @@ var IndexedDbAdapter = class {
 };
 function ensureSafeIdentifier(identifier) {
   if (!/^[a-zA-Z0-9_]+$/.test(identifier)) {
-    throw new AdapterError(`Unsafe SQL identifier: ${identifier}`);
+    throw new PersistenceError(`Unsafe SQL identifier: ${identifier}`, {
+      code: "UNSAFE_IDENTIFIER",
+      identifier
+    });
   }
   return identifier;
 }