@capgo/capacitor-fast-sql 8.2.16 → 8.2.18

package/README.md

@@ -383,7 +383,7 @@ bypassing Capacitor's standard bridge for better performance with sync operation
 ### connect(...)
 
 ```typescript
-connect(options: SQLConnectionOptions) => Promise<{ port: number; token: string; database: string; }>
+connect(options: SQLConnectionOptions) => Promise<{ port: number; token: string; database: string; persistent?: boolean; }>
 ```
 
 Initialize the database connection and start the HTTP server.
@@ -392,7 +392,7 @@ Initialize the database connection and start the HTTP server.
 | ------------- | --------------------------------------------------------------------- | -------------------- |
 | **`options`** | <code><a href="#sqlconnectionoptions">SQLConnectionOptions</a></code> | - Connection options |
 
-**Returns:** <code>Promise&lt;{ port: number; token: string; database: string; }&gt;</code>
+**Returns:** <code>Promise&lt;{ port: number; token: string; database: string; persistent?: boolean; }&gt;</code>
 
 **Since:** 0.0.1
 
@@ -419,7 +419,7 @@ Close database connection and stop the HTTP server.
 ### getServerInfo(...)
 
 ```typescript
-getServerInfo(options: { database: string; }) => Promise<{ port: number; token: string; }>
+getServerInfo(options: { database: string; }) => Promise<{ port: number; token: string; persistent?: boolean; }>
 ```
 
 Get the HTTP server port and token for direct communication.
@@ -428,7 +428,7 @@ Get the HTTP server port and token for direct communication.
 | ------------- | ---------------------------------- | --------------- |
 | **`options`** | <code>{ database: string; }</code> | - Database name |
 
-**Returns:** <code>Promise&lt;{ port: number; token: string; }&gt;</code>
+**Returns:** <code>Promise&lt;{ port: number; token: string; persistent?: boolean; }&gt;</code>
 
 **Since:** 0.0.1
 
@@ -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
@@ -658,10 +658,11 @@ OPFS persistence requires Cross-Origin Isolation headers on your web server:
 `Cross-Origin-Opener-Policy: same-origin` and
 `Cross-Origin-Embedder-Policy: require-corp`.
 
-| Prop          | Type                                                        | Description                                                                                                                                                  | Default           |
-| ------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- |
-| **`useOpfs`** | <code>boolean</code>                                        | Prefer OPFS persistence via a Web Worker (default: `true`). When OPFS is unavailable, the plugin falls back to a non-persistent database and logs a warning. | <code>true</code> |
-| **`worker`**  | <code><a href="#sqlitewebworker">SqliteWebWorker</a></code> | Custom Worker instance or factory for SQLite Wasm. Advanced: override the default worker from `@sqlite.org/sqlite-wasm`.                                     |                   |
+| Prop                     | Type                                                        | Description                                                                                                                                                                                                                          | Default            |
+| ------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ |
+| **`useOpfs`**            | <code>boolean</code>                                        | Prefer OPFS persistence via a Web Worker (default: `true`). When OPFS is unavailable, the plugin falls back to a non-persistent database and logs a warning.                                                                         | <code>true</code>  |
+| **`requirePersistence`** | <code>boolean</code>                                        | Reject web connections unless the Worker confirms persistent storage. Defaults to false for compatibility. Consider requiring persistence by default in the next Capacitor major, rather than changing fallback behavior in a minor. | <code>false</code> |
+| **`worker`**             | <code><a href="#sqlitewebworker">SqliteWebWorker</a></code> | Custom Worker instance or factory for SQLite Wasm. Advanced: override the default worker from `@sqlite.org/sqlite-wasm`.                                                                                                             |                    |
 
 
 ### Type Aliases

package/android/build.gradle

@@ -26,6 +26,7 @@ android {
         versionCode 1
         versionName "1.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles 'consumer-rules.pro'
     }
     buildTypes {
         release {

package/android/consumer-rules.pro

@@ -0,0 +1,14 @@
+# Consumer ProGuard rules for @capgo/capacitor-fast-sql (merged into app R8 when this AAR is a dependency).
+
+# CapgoCapacitorFastSqlPlugin uses Class.forName on this class when encrypted databases are enabled.
+# R8 must keep the type so the optional SQLCipher dependency still resolves at runtime.
+-keep class net.zetetic.database.sqlcipher.SQLiteDatabase { *; }
+
+# SQLCipher is compileOnly and also exposes types such as DatabaseErrorHandler
+# directly under net.zetetic.database. Plain-SQLite apps omit the entire artifact.
+-dontwarn net.zetetic.database.**
+
+# EncryptedSQLDatabase loads the SQLCipher JNI library by name; keep JNI method names linked from Java.
+-keepclasseswithmembernames class * {
+    native <methods>;
+}

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.18";
 
     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;
     /**
@@ -94,6 +96,13 @@ export interface WebConfig {
      * @default true
      */
     useOpfs?: boolean;
+    /**
+     * Reject web connections unless the Worker confirms persistent storage.
+     * Defaults to false for compatibility. Consider requiring persistence by default
+     * in the next Capacitor major, rather than changing fallback behavior in a minor.
+     * @default false
+     */
+    requirePersistence?: boolean;
     /**
      * Custom Worker instance or factory for SQLite Wasm.
      * Advanced: override the default worker from `@sqlite.org/sqlite-wasm`.
@@ -101,7 +110,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",
@@ -135,6 +146,8 @@ export interface CapgoCapacitorFastSqlPlugin {
         port: number;
         token: string;
         database: string;
+        /** Whether the web Worker confirms persistent storage. Absent on native. */
+        persistent?: boolean;
     }>;
     /**
      * Close database connection and stop the HTTP server.
@@ -169,6 +182,8 @@ export interface CapgoCapacitorFastSqlPlugin {
     }): Promise<{
         port: number;
         token: string;
+        /** Whether the web Worker confirms persistent storage. Absent on native. */
+        persistent?: boolean;
     }>;
     /**
      * Execute a SQL query via Capacitor bridge (for simple queries).

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"}