@capgo/capacitor-fast-sql 8.2.16 → 8.2.18

package/dist/plugin.js

@@ -3,7 +3,9 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
 
     var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
     /**
-     * Transaction isolation levels
+     * Transaction isolation levels. Only Serializable is supported by the current
+     * SQLite backends. Other values are retained for source compatibility but reject
+     * before starting a transaction; they are not silently mapped to another level.
      */
     exports.IsolationLevel = void 0;
     (function (IsolationLevel) {
@@ -17,6 +19,12 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
         web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.CapgoCapacitorFastSqlWeb()),
     });
 
+    function assertSupportedIsolation(level) {
+        if (level !== undefined && level !== exports.IsolationLevel.Serializable) {
+            throw new Error('Only SERIALIZABLE transaction isolation is supported');
+        }
+    }
+
     /**
      * SQL Connection class that uses HTTP protocol for efficient communication
      * with native SQLite databases, bypassing Capacitor's standard bridge.
@@ -29,7 +37,12 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             this.database = database;
             this.port = port;
             this.token = token;
-            this.baseUrl = `http://localhost:${port}`;
+            this.baseUrl = `http://127.0.0.1:${port}`;
+        }
+        browserFetch(input, init) {
+            const savedFetch = Reflect.get(globalThis, 'CapacitorWebFetch');
+            const browserFetch = typeof savedFetch === 'function' ? savedFetch : globalThis.fetch;
+            return browserFetch.call(globalThis, input, init);
         }
         /**
          * Get the database name
@@ -45,7 +58,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          * @returns Query results
          */
         async execute(statement, params) {
-            const response = await fetch(`${this.baseUrl}/execute`, {
+            const response = await this.browserFetch(`${this.baseUrl}/execute`, {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
@@ -71,7 +84,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          * @returns Array of results for each operation
          */
         async executeBatch(operations) {
-            const response = await fetch(`${this.baseUrl}/batch`, {
+            const response = await this.browserFetch(`${this.baseUrl}/batch`, {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
@@ -98,10 +111,11 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          * @param isolationLevel - Optional isolation level
          */
         async beginTransaction(isolationLevel) {
+            assertSupportedIsolation(isolationLevel);
             if (this.inTransaction) {
                 throw new Error('Transaction already in progress');
             }
-            const response = await fetch(`${this.baseUrl}/transaction/begin`, {
+            const response = await this.browserFetch(`${this.baseUrl}/transaction/begin`, {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
@@ -125,7 +139,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             if (!this.inTransaction) {
                 throw new Error('No transaction in progress');
             }
-            const response = await fetch(`${this.baseUrl}/transaction/commit`, {
+            const response = await this.browserFetch(`${this.baseUrl}/transaction/commit`, {
                 method: 'POST',
                 headers: {
                     Authorization: `Bearer ${this.token}`,
@@ -145,7 +159,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             if (!this.inTransaction) {
                 throw new Error('No transaction in progress');
             }
-            const response = await fetch(`${this.baseUrl}/transaction/rollback`, {
+            const response = await this.browserFetch(`${this.baseUrl}/transaction/rollback`, {
                 method: 'POST',
                 headers: {
                     Authorization: `Bearer ${this.token}`,
@@ -306,6 +320,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          * @param isolationLevel - Optional isolation level
          */
         async beginTransaction(isolationLevel) {
+            assertSupportedIsolation(isolationLevel);
             if (this.inTransaction) {
                 throw new Error('Transaction already in progress');
             }
@@ -400,12 +415,40 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          * @returns SQLConnection instance for executing queries
          */
         static async connect(options) {
-            // Check if already connected
-            const existing = this.connections.get(options.database);
+            var _a;
+            const saved = this.openOptions.get(options.database);
+            if (saved && !this.optionsMatch(saved, options)) {
+                throw new Error(`Database '${options.database}' is already opening or open with different options`);
+            }
+            const existing = (_a = this.connections.get(options.database)) !== null && _a !== void 0 ? _a : this.opening.get(options.database);
             if (existing) {
                 this.sharedConnections.add(options.database);
                 return existing;
             }
+            const snapshot = Object.assign({}, options);
+            this.openOptions.set(options.database, snapshot);
+            const pending = this.open(snapshot);
+            this.opening.set(options.database, pending);
+            try {
+                return await pending;
+            }
+            catch (error) {
+                this.openOptions.delete(options.database);
+                this.sharedConnections.delete(options.database);
+                throw error;
+            }
+            finally {
+                this.opening.delete(options.database);
+            }
+        }
+        static optionsMatch(left, right) {
+            return (Boolean(left.encrypted) === Boolean(right.encrypted) &&
+                left.encryptionKey === right.encryptionKey &&
+                Boolean(left.readOnly) === Boolean(right.readOnly) &&
+                Boolean(left.walMode) === Boolean(right.walMode) &&
+                Boolean(left.performancePresets) === Boolean(right.performancePresets));
+        }
+        static async open(options) {
             // Connect via native plugin
             const info = await CapgoCapacitorFastSql.connect(options);
             // Create connection instance appropriate for the current platform
@@ -428,6 +471,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          */
         static async disconnect(database) {
             var _a;
+            await this.opening.get(database);
             const connection = this.connections.get(database);
             if (!connection) {
                 throw new Error(`Database '${database}' is not connected`);
@@ -440,6 +484,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             await CapgoCapacitorFastSql.disconnect({ database });
             // Remove connection
             this.connections.delete(database);
+            this.openOptions.delete(database);
             this.sharedConnections.delete(database);
             this.connectionRetainers.delete(database);
             this.pendingDisconnects.delete(database);
@@ -491,7 +536,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          * Close all open connections
          */
         static async disconnectAll() {
-            const databases = Array.from(this.connections.keys());
+            const databases = Array.from(new Set([...this.connections.keys(), ...this.opening.keys()]));
             await Promise.all(databases.map((db) => {
                 this.connectionRetainers.delete(db);
                 this.pendingDisconnects.delete(db);
@@ -507,6 +552,8 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             return Array.from(this.connections.keys());
         }
     }
+    FastSQL.opening = new Map();
+    FastSQL.openOptions = new Map();
     FastSQL.connections = new Map();
     FastSQL.sharedConnections = new Set();
     FastSQL.connectionRetainers = new Map();
@@ -858,8 +905,11 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
                 .map((row) => this.rowToGetResult(row))
                 .filter(params.predicate)
                 .map((row) => row.id);
-            for (const id of ids) {
-                await this.connection.run(`DELETE FROM ${VECTOR_TABLE} WHERE store = ? AND id = ?`, [this.store, id]);
+            for (let offset = 0; offset < ids.length; offset += 100) {
+                await this.connection.executeBatch(ids.slice(offset, offset + 100).map((id) => ({
+                    statement: `DELETE FROM ${VECTOR_TABLE} WHERE store = ? AND id = ?`,
+                    params: [this.store, id],
+                })));
             }
         }
         async query(params) {
@@ -16886,7 +16936,13 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
          * Must be called before connect() when overriding the default worker.
          */
         async configureWeb(config) {
-            this.webConfig = config;
+            if (this.promiserPromise || this.databases.size > 0) {
+                throw new Error('Configure web storage before opening the first database');
+            }
+            if (config.requirePersistence && config.useOpfs === false) {
+                throw new Error('requirePersistence requires OPFS');
+            }
+            this.webConfig = Object.assign({}, config);
             this.promiserPromise = null;
         }
         getPromiser() {
@@ -16897,28 +16953,37 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             return this.promiserPromise;
         }
         dbPath(database) {
+            if (!database || database === '.' || database === '..' || /[/\\\0]/.test(database)) {
+                throw new Error('Database must be a non-empty file name without path separators');
+            }
             return `/capgo-fast-sql/${database}.sqlite3`;
         }
         async connect(options) {
+            if (options.readOnly) {
+                throw new Error('Read-only opens are not supported by the SQLite Wasm Worker transport');
+            }
             if (this.databases.has(options.database)) {
                 const existing = this.databases.get(options.database);
                 return {
                     port: existing.port,
                     token: existing.token,
                     database: options.database,
+                    persistent: existing.persistent,
                 };
             }
-            const promiser = await this.getPromiser();
             const path = this.dbPath(options.database);
+            const promiser = await this.getPromiser();
             const useOpfs = this.webConfig.useOpfs !== false;
             let openResult;
             if (useOpfs) {
                 try {
                     openResult = await promiser('open', {
-                        filename: `file:${path}?vfs=opfs`,
+                        filename: `file:/capgo-fast-sql/${encodeURIComponent(options.database)}.sqlite3?vfs=opfs`,
                     });
                 }
                 catch (opfsError) {
+                    if (this.webConfig.requirePersistence)
+                        throw opfsError;
                     console.warn('[CapgoCapacitorFastSql] OPFS unavailable; web database will not persist across reloads. ' +
                         'Serve with Cross-Origin-Opener-Policy: same-origin and Cross-Origin-Embedder-Policy: require-corp.', opfsError);
                     openResult = await promiser('open', { filename: path });
@@ -16932,7 +16997,16 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             if (!dbId) {
                 throw new Error('Failed to open SQLite Wasm database: missing dbId');
             }
-            await this.applyPerformanceConfig(promiser, dbId, options);
+            try {
+                if (this.webConfig.requirePersistence && !persistent) {
+                    throw new Error('SQLite Worker did not confirm persistent storage');
+                }
+                await this.applyPerformanceConfig(promiser, dbId, options);
+            }
+            catch (error) {
+                await promiser({ type: 'close', dbId, args: {} });
+                throw error;
+            }
             const token = this.generateToken();
             const port = this.nextPort++;
             this.databases.set(options.database, { dbId, token, port, persistent });
@@ -16940,6 +17014,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
                 port,
                 token,
                 database: options.database,
+                persistent,
             };
         }
         async disconnect(options) {
@@ -16960,6 +17035,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             return {
                 port: dbInfo.port,
                 token: dbInfo.token,
+                persistent: dbInfo.persistent,
             };
         }
         async execute(options) {
@@ -17007,6 +17083,7 @@ var capacitorCapgoCapacitorFastSql = (function (exports, core) {
             }
         }
         async beginTransaction(options) {
+            assertSupportedIsolation(options.isolationLevel);
             await this.execute({
                 database: options.database,
                 statement: 'BEGIN TRANSACTION',