@capgo/capacitor-fast-sql 8.2.16 → 8.2.17

package/README.md

@@ -548,14 +548,14 @@ or supply a custom Worker. This method is a no-op on iOS and Android.
 
 Database connection options
 
-| Prop                     | Type                 | Description                                                                                                                                                            | Since  |
-| ------------------------ | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
-| **`database`**           | <code>string</code>  | Database name (file will be created in app data directory)                                                                                                             |        |
-| **`encrypted`**          | <code>boolean</code> | Enable encryption (iOS/Android only)                                                                                                                                   |        |
-| **`encryptionKey`**      | <code>string</code>  | Encryption key (required if encrypted is true)                                                                                                                         |        |
-| **`readOnly`**           | <code>boolean</code> | Read-only mode                                                                                                                                                         |        |
-| **`walMode`**            | <code>boolean</code> | Enable WAL (Write-Ahead Logging) journal mode for better concurrency and performance. Executes `PRAGMA journal_mode = WAL` immediately after opening the database.     | 8.0.49 |
-| **`performancePresets`** | <code>boolean</code> | Apply recommended SQLite performance PRAGMAs after opening the database: `synchronous = NORMAL`, `busy_timeout = 5000`, `cache_size = -2000`, and `foreign_keys = ON`. | 8.0.49 |
+| Prop                     | Type                 | Description                                                                                                                                                                                                                | Since  |
+| ------------------------ | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
+| **`database`**           | <code>string</code>  | Database name (file will be created in app data directory)                                                                                                                                                                 |        |
+| **`encrypted`**          | <code>boolean</code> | Enable encryption (iOS/Android only)                                                                                                                                                                                       |        |
+| **`encryptionKey`**      | <code>string</code>  | Encryption key (required if encrypted is true)                                                                                                                                                                             |        |
+| **`readOnly`**           | <code>boolean</code> | Open an existing native database read-only. Writes and missing-file opens fail. WAL mode changes are skipped for read-only connections. The web Worker transport rejects this option instead of silently opening writable. |        |
+| **`walMode`**            | <code>boolean</code> | Enable WAL (Write-Ahead Logging) journal mode for better concurrency and performance. Executes `PRAGMA journal_mode = WAL` immediately after opening the database.                                                         | 8.0.49 |
+| **`performancePresets`** | <code>boolean</code> | Apply recommended SQLite performance PRAGMAs after opening the database: `synchronous = NORMAL`, `busy_timeout = 5000`, `cache_size = -2000`, and `foreign_keys = ON`.                                                     | 8.0.49 |
 
 
 #### SQLResult

package/android/src/main/java/app/capgo/capacitor/fastsql/CapgoCapacitorFastSqlPlugin.java

@@ -19,7 +19,7 @@ import java.util.Map;
 @CapacitorPlugin(name = "CapgoCapacitorFastSql")
 public class CapgoCapacitorFastSqlPlugin extends Plugin {
 
-    private final String pluginVersion = "8.2.16";
+    private final String pluginVersion = "8.2.17";
 
     private Map<String, DatabaseConnection> databases = new HashMap<>();
     private SQLHTTPServer server;
@@ -31,6 +31,7 @@ public class CapgoCapacitorFastSqlPlugin extends Plugin {
             call.reject("Database name is required");
             return;
         }
+        boolean readOnly = call.getBoolean("readOnly", false);
         boolean encrypted = call.getBoolean("encrypted", false);
         String encryptionKey = call.getString("encryptionKey");
         boolean walMode = call.getBoolean("walMode", false);
@@ -42,6 +43,10 @@ public class CapgoCapacitorFastSqlPlugin extends Plugin {
 
         // Check if already connected
         if (databases.containsKey(database)) {
+            if (databases.get(database).isReadOnly() != readOnly) {
+                call.reject("Database is already open with a different readOnly option");
+                return;
+            }
             if (server != null) {
                 JSObject ret = new JSObject();
                 ret.put("port", server.getPort());
@@ -69,9 +74,9 @@ public class CapgoCapacitorFastSqlPlugin extends Plugin {
                     );
                     return;
                 }
-                db = new EncryptedSQLDatabase(dbFile.getAbsolutePath(), encryptionKey, walMode, performancePresets);
+                db = new EncryptedSQLDatabase(dbFile.getAbsolutePath(), encryptionKey, walMode, performancePresets, readOnly);
             } else {
-                db = new SQLDatabase(dbFile.getAbsolutePath(), walMode, performancePresets);
+                db = new SQLDatabase(dbFile.getAbsolutePath(), walMode, performancePresets, readOnly);
             }
             databases.put(database, db);
 
@@ -173,6 +178,10 @@ public class CapgoCapacitorFastSqlPlugin extends Plugin {
 
     @PluginMethod
     public void beginTransaction(PluginCall call) {
+        if (!"SERIALIZABLE".equals(call.getString("isolationLevel", "SERIALIZABLE"))) {
+            call.reject("Only SERIALIZABLE transaction isolation is supported");
+            return;
+        }
         String database = call.getString("database");
         if (database == null) {
             call.reject("Database name is required");
@@ -250,8 +259,22 @@ public class CapgoCapacitorFastSqlPlugin extends Plugin {
         call.resolve(ret);
     }
 
-    private File getDatabasePath(String database) {
-        File dataDir = getContext().getFilesDir();
-        return new File(dataDir, database + ".db");
+    private File getDatabasePath(String database) throws java.io.IOException {
+        if (
+            database.isEmpty() ||
+            database.equals(".") ||
+            database.equals("..") ||
+            database.indexOf('/') >= 0 ||
+            database.indexOf('\\') >= 0 ||
+            database.indexOf(0) >= 0
+        ) {
+            throw new java.io.IOException("Database must be a non-empty file name without path separators");
+        }
+        File dataDir = getContext().getFilesDir().getCanonicalFile();
+        File dbFile = new File(dataDir, database + ".db").getCanonicalFile();
+        if (!dataDir.equals(dbFile.getParentFile())) {
+            throw new java.io.IOException("Database path must remain inside app storage");
+        }
+        return dbFile;
     }
 }

package/android/src/main/java/app/capgo/capacitor/fastsql/DatabaseConnection.java

@@ -12,5 +12,7 @@ public interface DatabaseConnection {
 
     void rollbackTransaction() throws Exception;
 
+    boolean isReadOnly();
+
     void close();
 }

package/android/src/main/java/app/capgo/capacitor/fastsql/EncryptedSQLDatabase.java

@@ -5,9 +5,9 @@ import android.util.Base64;
 import com.getcapacitor.JSArray;
 import com.getcapacitor.JSObject;
 import java.nio.charset.StandardCharsets;
-import java.util.ArrayList;
-import java.util.List;
+import net.zetetic.database.sqlcipher.SQLiteCursor;
 import net.zetetic.database.sqlcipher.SQLiteDatabase;
+import net.zetetic.database.sqlcipher.SQLiteProgram;
 import net.zetetic.database.sqlcipher.SQLiteStatement;
 import org.json.JSONObject;
 
@@ -20,6 +20,11 @@ public class EncryptedSQLDatabase implements DatabaseConnection {
     private volatile boolean inTransaction = false;
 
     public EncryptedSQLDatabase(String path, String encryptionKey, boolean walMode, boolean performancePresets) throws Exception {
+        this(path, encryptionKey, walMode, performancePresets, false);
+    }
+
+    public EncryptedSQLDatabase(String path, String encryptionKey, boolean walMode, boolean performancePresets, boolean readOnly)
+        throws Exception {
         if (encryptionKey == null || encryptionKey.isEmpty()) {
             throw new Exception("Encryption key is required when encrypted is true");
         }
@@ -34,8 +39,14 @@ public class EncryptedSQLDatabase implements DatabaseConnection {
             );
         }
         byte[] keyBytes = encryptionKey.getBytes(StandardCharsets.UTF_8);
-        this.db = SQLiteDatabase.openOrCreateDatabase(path, keyBytes, null, null);
-        SQLPerformanceConfig.apply(db::execSQL, walMode, performancePresets);
+        this.db = readOnly
+            ? SQLiteDatabase.openDatabase(path, keyBytes, null, SQLiteDatabase.OPEN_READONLY, null)
+            : SQLiteDatabase.openOrCreateDatabase(path, keyBytes, null, null);
+        SQLPerformanceConfig.apply(db::execSQL, walMode && !readOnly, performancePresets);
+    }
+
+    public boolean isReadOnly() {
+        return db.isReadOnly();
     }
 
     public void close() {
@@ -49,23 +60,24 @@ public class EncryptedSQLDatabase implements DatabaseConnection {
             throw new Exception("Database is not open");
         }
 
-        String trimmedStatement = statement.trim().toUpperCase();
-        boolean isQuery =
-            trimmedStatement.startsWith("SELECT") || trimmedStatement.startsWith("PRAGMA") || trimmedStatement.startsWith("EXPLAIN");
-
-        if (isQuery) {
-            return executeQuery(statement, params);
-        } else {
-            return executeUpdate(statement, params);
-        }
-    }
-
-    private JSObject executeQuery(String statement, JSArray params) throws Exception {
-        Cursor cursor = null;
+        Cursor cursor = db.rawQueryWithFactory(
+            (database, driver, editTable, query) -> {
+                try {
+                    bindParams(query, params);
+                } catch (Exception error) {
+                    throw new IllegalArgumentException("Invalid query parameters", error);
+                }
+                return new SQLiteCursor(driver, editTable, query);
+            },
+            statement,
+            new String[0],
+            null
+        );
         try {
-            String[] bindArgs = convertParamsToStringArray(params);
-            cursor = db.rawQuery(statement, bindArgs);
-
+            if (cursor.getColumnCount() == 0) {
+                cursor.close();
+                return executeUpdate(statement, params);
+            }
             JSArray rows = new JSArray();
             while (cursor.moveToNext()) {
                 JSObject row = new JSObject();
@@ -142,32 +154,7 @@ public class EncryptedSQLDatabase implements DatabaseConnection {
         inTransaction = false;
     }
 
-    private String[] convertParamsToStringArray(JSArray params) throws Exception {
-        if (params == null || params.length() == 0) {
-            return new String[0];
-        }
-
-        List<String> args = new ArrayList<>();
-        for (int i = 0; i < params.length(); i++) {
-            Object value = params.get(i);
-
-            if (value == null || value == JSONObject.NULL) {
-                args.add(null);
-            } else if (value instanceof JSONObject) {
-                JSONObject obj = (JSONObject) value;
-                if (obj.has("_type") && "binary".equals(obj.getString("_type"))) {
-                    args.add(obj.getString("_data"));
-                } else {
-                    args.add(value.toString());
-                }
-            } else {
-                args.add(value.toString());
-            }
-        }
-        return args.toArray(new String[0]);
-    }
-
-    private void bindParams(SQLiteStatement stmt, JSArray params) throws Exception {
+    private void bindParams(SQLiteProgram stmt, JSArray params) throws Exception {
         if (params == null || params.length() == 0) {
             return;
         }

package/android/src/main/java/app/capgo/capacitor/fastsql/SQLDatabase.java

@@ -1,15 +1,14 @@
 package app.capgo.capacitor.fastsql;
 
 import android.database.Cursor;
+import android.database.sqlite.SQLiteCursor;
 import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteProgram;
 import android.database.sqlite.SQLiteStatement;
 import android.util.Base64;
 import com.getcapacitor.JSArray;
 import com.getcapacitor.JSObject;
-import java.util.ArrayList;
-import java.util.List;
 import org.json.JSONArray;
-import org.json.JSONException;
 import org.json.JSONObject;
 
 /**
@@ -21,8 +20,18 @@ public class SQLDatabase implements DatabaseConnection {
     private volatile boolean inTransaction = false;
 
     public SQLDatabase(String path, boolean walMode, boolean performancePresets) throws Exception {
-        this.db = SQLiteDatabase.openOrCreateDatabase(path, null);
-        SQLPerformanceConfig.apply(db::execSQL, walMode, performancePresets);
+        this(path, walMode, performancePresets, false);
+    }
+
+    public SQLDatabase(String path, boolean walMode, boolean performancePresets, boolean readOnly) throws Exception {
+        this.db = readOnly
+            ? SQLiteDatabase.openDatabase(path, null, SQLiteDatabase.OPEN_READONLY)
+            : SQLiteDatabase.openOrCreateDatabase(path, null);
+        SQLPerformanceConfig.apply(db::execSQL, walMode && !readOnly, performancePresets);
+    }
+
+    public boolean isReadOnly() {
+        return db.isReadOnly();
     }
 
     public void close() {
@@ -36,25 +45,24 @@ public class SQLDatabase implements DatabaseConnection {
             throw new Exception("Database is not open");
         }
 
-        // Check if this is a query (SELECT) or a modification (INSERT/UPDATE/DELETE)
-        String trimmedStatement = statement.trim().toUpperCase();
-        boolean isQuery =
-            trimmedStatement.startsWith("SELECT") || trimmedStatement.startsWith("PRAGMA") || trimmedStatement.startsWith("EXPLAIN");
-
-        if (isQuery) {
-            return executeQuery(statement, params);
-        } else {
-            return executeUpdate(statement, params);
-        }
-    }
-
-    private JSObject executeQuery(String statement, JSArray params) throws Exception {
-        Cursor cursor = null;
+        Cursor cursor = db.rawQueryWithFactory(
+            (database, driver, editTable, query) -> {
+                try {
+                    bindParams(query, params);
+                } catch (Exception error) {
+                    throw new IllegalArgumentException("Invalid query parameters", error);
+                }
+                return new SQLiteCursor(driver, editTable, query);
+            },
+            statement,
+            new String[0],
+            null
+        );
         try {
-            // Prepare statement with parameters
-            String[] bindArgs = convertParamsToStringArray(params);
-            cursor = db.rawQuery(statement, bindArgs);
-
+            if (cursor.getColumnCount() == 0) {
+                cursor.close();
+                return executeUpdate(statement, params);
+            }
             // Build result
             JSArray rows = new JSArray();
             while (cursor.moveToNext()) {
@@ -136,33 +144,7 @@ public class SQLDatabase implements DatabaseConnection {
         inTransaction = false;
     }
 
-    private String[] convertParamsToStringArray(JSArray params) throws JSONException {
-        if (params == null || params.length() == 0) {
-            return null;
-        }
-
-        List<String> args = new ArrayList<>();
-        for (int i = 0; i < params.length(); i++) {
-            Object value = params.get(i);
-            if (value == null || value == JSONObject.NULL) {
-                args.add(null);
-            } else if (value instanceof JSONObject) {
-                JSONObject obj = (JSONObject) value;
-                if (obj.has("_type") && "binary".equals(obj.getString("_type"))) {
-                    // For queries, we can't bind binary data as string
-                    // This is a limitation - for binary data, use executeUpdate
-                    args.add(obj.getString("_data"));
-                } else {
-                    args.add(value.toString());
-                }
-            } else {
-                args.add(value.toString());
-            }
-        }
-        return args.toArray(new String[0]);
-    }
-
-    private void bindParams(SQLiteStatement stmt, JSArray params) throws Exception {
+    private void bindParams(SQLiteProgram stmt, JSArray params) throws Exception {
         if (params == null || params.length() == 0) {
             return;
         }

package/android/src/main/java/app/capgo/capacitor/fastsql/SQLHTTPServer.java

@@ -33,7 +33,7 @@ public class SQLHTTPServer extends NanoHTTPD {
     });
 
     public SQLHTTPServer(Map<String, DatabaseConnection> databases) throws IOException {
-        super(findAvailablePort());
+        super("127.0.0.1", 0);
         this.databases = databases;
         this.token = generateToken();
     }
@@ -152,14 +152,22 @@ public class SQLHTTPServer extends NanoHTTPD {
             HttpRequestJsonParams.populateJsArrayFromParamsJson(paramsJson, params, rawParamsArray);
 
             JSObject result = db.execute(statement, params);
-            results.put(new JSONObject(result.toString()));
+            results.put(result);
         }
 
         return newFixedLengthResponse(Response.Status.OK, "application/json", results.toString());
     }
 
     private Response handleBeginTransaction(IHTTPSession session, DatabaseConnection db) throws Exception {
-        readRequestBody(session); // drain any body to keep the connection clean for keep-alive
+        String body = readRequestBody(session);
+        JSONObject request = body.isEmpty() ? new JSONObject() : new JSONObject(body);
+        if (!"SERIALIZABLE".equals(request.optString("isolationLevel", "SERIALIZABLE"))) {
+            return newFixedLengthResponse(
+                Response.Status.BAD_REQUEST,
+                "text/plain",
+                "Only SERIALIZABLE transaction isolation is supported"
+            );
+        }
         db.beginTransaction();
         return newFixedLengthResponse(Response.Status.OK, "application/json", "{}");
     }
@@ -193,24 +201,4 @@ public class SQLHTTPServer extends NanoHTTPD {
         }
         return sb.toString();
     }
-
-    private static int findAvailablePort() {
-        // Try ports in the range 9000-9100
-        for (int port = 9000; port < 9100; port++) {
-            try {
-                NanoHTTPD testServer = new NanoHTTPD(port) {
-                    @Override
-                    public Response serve(IHTTPSession session) {
-                        return null;
-                    }
-                };
-                testServer.start(NanoHTTPD.SOCKET_READ_TIMEOUT, false);
-                testServer.stop();
-                return port;
-            } catch (IOException e) {
-                // Port not available, try next one
-            }
-        }
-        return 9000; // Fallback
-    }
 }

package/dist/esm/definitions.d.ts

@@ -55,7 +55,9 @@ export interface SQLConnectionOptions {
      */
     encryptionKey?: string;
     /**
-     * Read-only mode
+     * Open an existing native database read-only. Writes and missing-file opens fail.
+     * WAL mode changes are skipped for read-only connections.
+     * The web Worker transport rejects this option instead of silently opening writable.
      */
     readOnly?: boolean;
     /**
@@ -101,7 +103,9 @@ export interface WebConfig {
     worker?: SqliteWebWorker;
 }
 /**
- * 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.
  */
 export declare enum IsolationLevel {
     ReadUncommitted = "READ UNCOMMITTED",

package/dist/esm/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}

package/dist/esm/definitions.js

@@ -1,5 +1,7 @@
 /**
- * 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.
  */
 export var IsolationLevel;
 (function (IsolationLevel) {

package/dist/esm/fast-sql.d.ts

@@ -7,6 +7,8 @@ import type { SQLConnection } from './sql-connection';
  * and managing multiple databases simultaneously.
  */
 export declare class FastSQL {
+    private static opening;
+    private static openOptions;
     private static connections;
     private static sharedConnections;
     private static connectionRetainers;
@@ -18,6 +20,8 @@ export declare class FastSQL {
      * @returns SQLConnection instance for executing queries
      */
     static connect(options: SQLConnectionOptions): Promise<SQLConnection>;
+    private static optionsMatch;
+    private static open;
     /**
      * Close a database connection
      *

package/dist/esm/fast-sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fast-sql.d.ts","sourceRoot":"","sources":["../../src/fast-sql.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAyC;IACnE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA0B;IAC1D,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAkC;IACpE,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA0B;IAE3D;;;;;OAKG;WACU,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IA0B3E;;;;OAIG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxD;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI5D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO/C;;OAEG;WACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBlE;;OAEG;WACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3C;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;CAGpC"}
+{"version":3,"file":"fast-sql.d.ts","sourceRoot":"","sources":["../../src/fast-sql.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,OAAO,CAA6C;IACnE,OAAO,CAAC,MAAM,CAAC,WAAW,CAA2C;IACrE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAyC;IACnE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA0B;IAC1D,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAkC;IACpE,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA0B;IAE3D;;;;;OAKG;WACU,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IA0B3E,OAAO,CAAC,MAAM,CAAC,YAAY;mBAUN,IAAI;IAmBzB;;;;OAIG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxD;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI5D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO/C;;OAEG;WACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBlE;;OAEG;WACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3C;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;CAGpC"}

package/dist/esm/fast-sql.js

@@ -16,12 +16,40 @@ export class FastSQL {
      * @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
@@ -44,6 +72,7 @@ export class FastSQL {
      */
     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`);
@@ -56,6 +85,7 @@ export class FastSQL {
         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);
@@ -107,7 +137,7 @@ export class FastSQL {
      * 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);
@@ -123,6 +153,8 @@ export class FastSQL {
         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();

package/dist/esm/native-sql-connection.d.ts

@@ -14,6 +14,7 @@ export declare class NativeSQLConnection implements SQLConnection {
     private baseUrl;
     private inTransaction;
     constructor(database: string, port: number, token: string);
+    private browserFetch;
     /**
      * Get the database name
      */

package/dist/esm/native-sql-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-sql-connection.d.ts","sourceRoot":"","sources":["../../src/native-sql-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;gBAElB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAOzD;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAuBzE;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyBzE;;;;OAIG;IACG,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBtE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/B;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhH;;;;;;OAMG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtE;;;;;;OAMG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAQvG;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}
+{"version":3,"file":"native-sql-connection.d.ts","sourceRoot":"","sources":["../../src/native-sql-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;gBAElB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAOzD,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAuBzE;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyBzE;;;;OAIG;IACG,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BtE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/B;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhH;;;;;;OAMG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtE;;;;;;OAMG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAQvG;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/esm/native-sql-connection.js

@@ -1,4 +1,5 @@
 import { IsolationLevel } from './definitions';
+import { assertSupportedIsolation } from './transaction-isolation';
 /**
  * SQL Connection class that uses HTTP protocol for efficient communication
  * with native SQLite databases, bypassing Capacitor's standard bridge.
@@ -11,7 +12,12 @@ export class NativeSQLConnection {
         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
@@ -27,7 +33,7 @@ export class NativeSQLConnection {
      * @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',
@@ -53,7 +59,7 @@ export class NativeSQLConnection {
      * @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',
@@ -80,10 +86,11 @@ export class NativeSQLConnection {
      * @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',
@@ -107,7 +114,7 @@ export class NativeSQLConnection {
         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}`,
@@ -127,7 +134,7 @@ export class NativeSQLConnection {
         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}`,

package/dist/esm/transaction-isolation.d.ts

@@ -0,0 +1,3 @@
+import { IsolationLevel } from './definitions';
+export declare function assertSupportedIsolation(level?: IsolationLevel): void;
+//# sourceMappingURL=transaction-isolation.d.ts.map

package/dist/esm/transaction-isolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-isolation.d.ts","sourceRoot":"","sources":["../../src/transaction-isolation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAIrE"}