@capacitor-community/sqlite 4.1.0-6 → 4.1.0-7

package/android/src/main/java/com/getcapacitor/community/database/sqlite/CapacitorSQLitePlugin.java

@@ -284,7 +284,7 @@ public class CapacitorSQLitePlugin extends Plugin {
         dbName = call.getString("database");
         dbVersion = call.getInt("version", 1);
 
-        boolean encrypted = call.getBoolean("encrypted", false);
+        Boolean encrypted = call.getBoolean("encrypted", false);
         if (encrypted) {
             inMode = call.getString("mode", "no-encryption");
             if (
@@ -299,10 +299,11 @@ public class CapacitorSQLitePlugin extends Plugin {
         } else {
             inMode = "no-encryption";
         }
+        boolean readOnly = call.getBoolean("readonly", false);
         Dictionary<Integer, JSONObject> upgDict = versionUpgrades.get(dbName);
         if (implementation != null) {
             try {
-                implementation.createConnection(dbName, encrypted, inMode, dbVersion, upgDict);
+                implementation.createConnection(dbName, encrypted, inMode, dbVersion, upgDict, readOnly);
                 rHandler.retResult(call, null, null);
                 return;
             } catch (Exception e) {
@@ -330,9 +331,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                implementation.open(dbName);
+                implementation.open(dbName, readOnly);
                 rHandler.retResult(call, null, null);
                 return;
             } catch (Exception e) {
@@ -360,9 +362,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                implementation.close(dbName);
+                implementation.close(dbName, readOnly);
                 rHandler.retResult(call, null, null);
                 return;
             } catch (Exception e) {
@@ -390,9 +393,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                String res = implementation.getUrl(dbName);
+                String res = implementation.getUrl(dbName, readOnly);
                 rHandler.retUrl(call, res, null);
                 return;
             } catch (Exception e) {
@@ -420,9 +424,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                Integer res = implementation.getVersion(dbName);
+                Integer res = implementation.getVersion(dbName, readOnly);
                 rHandler.retVersion(call, res, null);
                 return;
             } catch (Exception e) {
@@ -480,9 +485,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                implementation.closeConnection(dbName);
+                implementation.closeConnection(dbName, readOnly);
                 rHandler.retResult(call, null, null);
                 return;
             } catch (Exception e) {
@@ -602,9 +608,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String tableName = call.getString("table");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                Boolean res = implementation.isTableExists(dbName, tableName);
+                Boolean res = implementation.isTableExists(dbName, tableName, readOnly);
                 rHandler.retResult(call, res, null);
                 return;
             } catch (Exception e) {
@@ -794,10 +801,11 @@ public class CapacitorSQLitePlugin extends Plugin {
         }
         String statements = call.getString("statements");
         Boolean transaction = call.getBoolean("transaction", true);
+        Boolean readOnly = call.getBoolean("readonly", false);
 
         if (implementation != null) {
             try {
-                JSObject res = implementation.execute(dbName, statements, transaction);
+                JSObject res = implementation.execute(dbName, statements, transaction, readOnly);
                 rHandler.retChanges(call, res, null);
                 return;
             } catch (Exception e) {
@@ -852,9 +860,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             }
         }
         Boolean transaction = call.getBoolean("transaction", true);
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                JSObject res = implementation.executeSet(dbName, set, transaction);
+                JSObject res = implementation.executeSet(dbName, set, transaction, readOnly);
                 rHandler.retChanges(call, res, null);
                 return;
             } catch (Exception e) {
@@ -898,9 +907,10 @@ public class CapacitorSQLitePlugin extends Plugin {
         JSArray values = call.getArray("values");
 
         Boolean transaction = call.getBoolean("transaction", true);
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                JSObject res = implementation.run(dbName, statement, values, transaction);
+                JSObject res = implementation.run(dbName, statement, values, transaction, readOnly);
                 rHandler.retChanges(call, res, null);
                 return;
             } catch (Exception e) {
@@ -940,9 +950,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         JSArray values = call.getArray("values");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                JSArray res = implementation.query(dbName, statement, values);
+                JSArray res = implementation.query(dbName, statement, values, readOnly);
                 rHandler.retValues(call, res, null);
                 return;
             } catch (Exception e) {
@@ -964,9 +975,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                JSArray res = implementation.getTableList(dbName);
+                JSArray res = implementation.getTableList(dbName, readOnly);
                 rHandler.retValues(call, res, null);
                 return;
             } catch (Exception e) {
@@ -994,10 +1006,11 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
 
         if (implementation != null) {
             try {
-                Boolean res = implementation.isDBExists(dbName);
+                Boolean res = implementation.isDBExists(dbName, readOnly);
                 rHandler.retResult(call, res, null);
                 return;
             } catch (Exception e) {
@@ -1025,9 +1038,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                Boolean res = implementation.isDBOpen(dbName);
+                Boolean res = implementation.isDBOpen(dbName, readOnly);
                 rHandler.retResult(call, res, null);
                 return;
             } catch (Exception e) {
@@ -1055,9 +1069,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                implementation.deleteDatabase(dbName);
+                implementation.deleteDatabase(dbName, readOnly);
                 rHandler.retResult(call, null, null);
                 return;
             } catch (Exception e) {
@@ -1087,9 +1102,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                JSObject res = implementation.createSyncTable(dbName);
+                JSObject res = implementation.createSyncTable(dbName, readOnly);
                 rHandler.retChanges(call, res, null);
                 return;
             } catch (Exception e) {
@@ -1124,9 +1140,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String syncDate = call.getString("syncdate");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                implementation.setSyncDate(dbName, syncDate);
+                implementation.setSyncDate(dbName, syncDate, readOnly);
                 rHandler.retResult(call, null, null);
                 return;
             } catch (Exception e) {
@@ -1156,9 +1173,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                long syncDate = implementation.getSyncDate(dbName);
+                long syncDate = implementation.getSyncDate(dbName, readOnly);
                 rHandler.retSyncDate(call, syncDate, null);
                 return;
             } catch (Exception e) {
@@ -1300,10 +1318,11 @@ public class CapacitorSQLitePlugin extends Plugin {
             rHandler.retJSObject(call, retObj, msg);
             return;
         }
+        Boolean readOnly = call.getBoolean("readonly", false);
 
         if (implementation != null) {
             try {
-                JSObject res = implementation.exportToJson(dbName, expMode);
+                JSObject res = implementation.exportToJson(dbName, expMode, readOnly);
                 rHandler.retJSObject(call, res, null);
                 return;
             } catch (Exception e) {
@@ -1327,9 +1346,10 @@ public class CapacitorSQLitePlugin extends Plugin {
             return;
         }
         String dbName = call.getString("database");
+        Boolean readOnly = call.getBoolean("readonly", false);
         if (implementation != null) {
             try {
-                implementation.deleteExportedRows(dbName);
+                implementation.deleteExportedRows(dbName, readOnly);
                 rHandler.retResult(call, null, null);
                 return;
             } catch (Exception e) {

package/android/src/main/java/com/getcapacitor/community/database/sqlite/SQLite/Database.java

@@ -9,26 +9,15 @@ import static android.database.Cursor.FIELD_TYPE_STRING;
 import android.content.Context;
 import android.content.SharedPreferences;
 import android.util.Log;
-
 import androidx.sqlite.db.SimpleSQLiteQuery;
 import androidx.sqlite.db.SupportSQLiteDatabase;
 import androidx.sqlite.db.SupportSQLiteStatement;
-
 import com.getcapacitor.JSArray;
 import com.getcapacitor.JSObject;
 import com.getcapacitor.community.database.sqlite.SQLite.ImportExportJson.ExportToJson;
 import com.getcapacitor.community.database.sqlite.SQLite.ImportExportJson.ImportFromJson;
 import com.getcapacitor.community.database.sqlite.SQLite.ImportExportJson.JsonSQLite;
 import com.getcapacitor.community.database.sqlite.SQLite.ImportExportJson.UtilsJson;
-
-import net.sqlcipher.Cursor;
-import net.sqlcipher.database.SQLiteDatabase;
-import net.sqlcipher.database.SQLiteException;
-
-import org.json.JSONArray;
-import org.json.JSONException;
-import org.json.JSONObject;
-
 import java.io.File;
 import java.text.SimpleDateFormat;
 import java.util.ArrayList;
@@ -38,6 +27,12 @@ import java.util.Date;
 import java.util.Dictionary;
 import java.util.Hashtable;
 import java.util.List;
+import net.sqlcipher.Cursor;
+import net.sqlcipher.database.SQLiteDatabase;
+import net.sqlcipher.database.SQLiteException;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
 
 public class Database {
 
@@ -50,6 +45,7 @@ public class Database {
     private final Boolean _encrypted;
     private final Boolean _isEncryption;
     private final SharedPreferences _sharedPreferences;
+    private final Boolean _readOnly;
     private final File _file;
     private final int _version;
     private final GlobalSQLite _globVar;
@@ -67,14 +63,15 @@ public class Database {
     private Boolean ncDB = false;
 
     public Database(
-            Context context,
-            String dbName,
-            Boolean encrypted,
-            String mode,
-            int version,
-            Boolean isEncryption,
-            Dictionary<Integer, JSONObject> vUpgObject,
-            SharedPreferences sharedPreferences
+        Context context,
+        String dbName,
+        Boolean encrypted,
+        String mode,
+        int version,
+        Boolean isEncryption,
+        Dictionary<Integer, JSONObject> vUpgObject,
+        SharedPreferences sharedPreferences,
+        Boolean readonly
     ) {
         this._context = context;
         this._dbName = dbName;
@@ -84,6 +81,7 @@ public class Database {
         this._version = version;
         this._vUpgObject = vUpgObject;
         this._sharedPreferences = sharedPreferences;
+        this._readOnly = readonly;
         if (dbName.contains("/") && dbName.endsWith("SQLite.db")) {
             this.ncDB = true;
             this._file = new File(dbName);
@@ -154,8 +152,8 @@ public class Database {
         int curVersion;
 
         String password = _uSecret != null && _encrypted && (_mode.equals("secret") || _mode.equals("encryption"))
-                ? _uSecret.getPassphrase()
-                : "";
+            ? _uSecret.getPassphrase()
+            : "";
         if (_mode.equals("encryption")) {
             if (_isEncryption) {
                 try {
@@ -170,7 +168,7 @@ public class Database {
             }
         }
         try {
-            if (!isNCDB()) {
+            if (!isNCDB() && !this._readOnly) {
                 _db = SQLiteDatabase.openOrCreateDatabase(_file, password, null);
             } else {
                 _db = SQLiteDatabase.openDatabase(String.valueOf(_file), "", null, SQLiteDatabase.OPEN_READONLY);
@@ -187,52 +185,54 @@ public class Database {
                         _db = null;
                         throw new Exception(msg);
                     }
-                    if (!isNCDB()) {
+                    if (isNCDB() || this._readOnly) {
+                            _isOpen = true;
+                            return;
+                     }
+                     try {
+                        curVersion = _db.getVersion(); // default 0
+                    } catch (IllegalStateException e) {
+                        String msg = "Failed in get/setVersion " + e.getMessage();
+                        Log.v(TAG, msg);
+                        close();
+                        _db = null;
+                        throw new Exception(msg);
+                    } catch (SQLiteException e) {
+                        String msg = "Failed in setVersion " + e.getMessage();
+                        Log.v(TAG, msg);
+                        close();
+                        _db = null;
+                        throw new Exception(msg);
+                    }
+                    if (_version > curVersion && _vUpgObject != null && _vUpgObject.size() > 0) {
+                        //                           if (_vUpgObject != null && _vUpgObject.size() > 0) {
                         try {
-                            curVersion = _db.getVersion(); // default 0
-                        } catch (IllegalStateException e) {
-                            String msg = "Failed in get/setVersion " + e.getMessage();
-                            Log.v(TAG, msg);
-                            close();
-                            _db = null;
-                            throw new Exception(msg);
-                        } catch (SQLiteException e) {
-                            String msg = "Failed in setVersion " + e.getMessage();
-                            Log.v(TAG, msg);
-                            close();
-                            _db = null;
-                            throw new Exception(msg);
-                        }
-                        if (_version > curVersion && _vUpgObject != null && _vUpgObject.size() > 0) {
-                            //                           if (_vUpgObject != null && _vUpgObject.size() > 0) {
-                            try {
-                                this._uFile.copyFile(_context, _dbName, "backup-" + _dbName);
+                            this._uFile.copyFile(_context, _dbName, "backup-" + _dbName);
 
-                                _uUpg.onUpgrade(this, _vUpgObject, curVersion, _version);
+                            _uUpg.onUpgrade(this, _vUpgObject, curVersion, _version);
 
-                                boolean ret = _uFile.deleteBackupDB(_context, _dbName);
-                                if (!ret) {
-                                    String msg = "Failed in deleteBackupDB backup-\" + _dbName";
-                                    Log.v(TAG, msg);
-                                    close();
-                                    _db = null;
-                                    throw new Exception(msg);
-                                }
-                            } catch (Exception e) {
-                                // restore DB
-                                boolean ret = _uFile.restoreDatabase(_context, _dbName);
-                                String msg = e.getMessage();
-                                if (!ret) msg += "Failed in restoreDatabase " + _dbName;
+                            boolean ret = _uFile.deleteBackupDB(_context, _dbName);
+                            if (!ret) {
+                                String msg = "Failed in deleteBackupDB backup-\" + _dbName";
                                 Log.v(TAG, msg);
                                 close();
                                 _db = null;
                                 throw new Exception(msg);
                             }
+                        } catch (Exception e) {
+                            // restore DB
+                            boolean ret = _uFile.restoreDatabase(_context, _dbName);
+                            String msg = e.getMessage();
+                            if (!ret) msg += "Failed in restoreDatabase " + _dbName;
+                            Log.v(TAG, msg);
+                            close();
+                            _db = null;
+                            throw new Exception(msg);
                         }
-                        _isOpen = true;
-                        return;
                     }
-                } else {
+                    _isOpen = true;
+                    return;
+                 } else {
                     _isOpen = false;
                     _db = null;
                     throw new Exception("Database not opened");
@@ -778,19 +778,20 @@ public class Database {
                 JSObject row = new JSObject();
                 for (int i = 0; i < c.getColumnCount(); i++) {
                     String colName = c.getColumnName(i);
+                    int index = c.getColumnIndex(colName);
                     int type = c.getType(i);
                     switch (type) {
                         case FIELD_TYPE_STRING:
-                            row.put(colName, c.getString(c.getColumnIndex(colName)));
+                            row.put(colName, c.getString(index));
                             break;
                         case FIELD_TYPE_INTEGER:
-                            row.put(colName, c.getLong(c.getColumnIndex(colName)));
+                            row.put(colName, c.getLong(index));
                             break;
                         case FIELD_TYPE_FLOAT:
-                            row.put(colName, c.getDouble(c.getColumnIndex(colName)));
+                            row.put(colName, c.getDouble(index));
                             break;
                         case FIELD_TYPE_BLOB:
-                            row.put(colName, c.getBlob(c.getColumnIndex(colName)));
+                            row.put(colName, c.getBlob(index));
                             break;
                         case FIELD_TYPE_NULL:
                             row.put(colName, JSONObject.NULL);
@@ -879,8 +880,8 @@ public class Database {
                 Date date = new Date();
                 long syncTime = date.getTime() / 1000L;
                 String[] statements = {
-                        "CREATE TABLE IF NOT EXISTS sync_table (" + "id INTEGER PRIMARY KEY NOT NULL," + "sync_date INTEGER);",
-                        "INSERT INTO sync_table (sync_date) VALUES ('" + syncTime + "');"
+                    "CREATE TABLE IF NOT EXISTS sync_table (" + "id INTEGER PRIMARY KEY NOT NULL," + "sync_date INTEGER);",
+                    "INSERT INTO sync_table (sync_date) VALUES ('" + syncTime + "');"
                 };
                 try {
                     retObj = execute(statements);
@@ -935,7 +936,7 @@ public class Database {
             SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ");
             Date date = formatter.parse(syncDate.replaceAll("Z$", "+0000"));
             long syncTime = date.getTime() / 1000L;
-            String[] statements = {"UPDATE sync_table SET sync_date = " + syncTime + " WHERE id = 1;"};
+            String[] statements = { "UPDATE sync_table SET sync_date = " + syncTime + " WHERE id = 1;" };
             retObj = execute(statements);
             if (retObj.getInteger("changes") != Integer.valueOf(-1)) {
                 return;
@@ -1021,8 +1022,7 @@ public class Database {
         } catch (Exception e) {
             Log.e(TAG, "Error: exportToJson " + e.getMessage());
             throw new Exception(e.getMessage());
-        } finally {
-        }
+        } finally {}
     }
 
     /**

package/android/src/main/java/com/getcapacitor/community/database/sqlite/SQLite/UtilsUpgrade.java

@@ -1,16 +1,13 @@
 package com.getcapacitor.community.database.sqlite.SQLite;
 
 import android.util.Log;
-
 import com.getcapacitor.JSObject;
-
-import org.json.JSONArray;
-import org.json.JSONObject;
-
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.Dictionary;
 import java.util.List;
+import org.json.JSONArray;
+import org.json.JSONObject;
 
 public class UtilsUpgrade {
 
@@ -26,12 +23,8 @@ public class UtilsUpgrade {
      * @param targetVersion
      * @throws Exception
      */
-    public void onUpgrade(
-            Database db,
-            Dictionary<Integer, JSONObject> upgDict,
-            Integer curVersion,
-            Integer targetVersion
-    ) throws Exception {
+    public void onUpgrade(Database db, Dictionary<Integer, JSONObject> upgDict, Integer curVersion, Integer targetVersion)
+        throws Exception {
         Log.i(TAG, "UtilsUpgrade.onUpgrade: " + curVersion + " => " + targetVersion);
 
         List<Integer> sortedKeys = Collections.list(upgDict.keys());
@@ -41,9 +34,7 @@ public class UtilsUpgrade {
             if (versionKey > curVersion && versionKey <= targetVersion) {
                 JSONObject upgrade = upgDict.get(versionKey);
 
-                JSONArray statementsJson = upgrade.has("statements")
-                        ? upgrade.getJSONArray("statements")
-                        : new JSONArray();
+                JSONArray statementsJson = upgrade.has("statements") ? upgrade.getJSONArray("statements") : new JSONArray();
 
                 List<String> statements = new ArrayList<String>();
 

package/dist/esm/definitions.d.ts

@@ -347,6 +347,10 @@ export interface capConnectionOptions {
      * ["encryption", "secret", "newsecret"]
      */
     mode?: string;
+    /**
+     * Set to true (database in read-only mode) / false
+     */
+    readonly?: boolean;
 }
 export interface capAllConnectionsOptions {
     /**
@@ -360,6 +364,10 @@ export interface capSQLiteOptions {
      * The database name
      */
     database?: string;
+    /**
+     * Set to true (database in read-only mode) / false
+     */
+    readonly?: boolean;
 }
 export interface capNCDatabasePathOptions {
     /**
@@ -810,24 +818,27 @@ export interface ISQLiteConnection {
      * @param encrypted
      * @param mode
      * @param version
+     * @param readonly
      * @returns Promise<SQLiteDBConnection>
      * @since 2.9.0 refactor
      */
-    createConnection(database: string, encrypted: boolean, mode: string, version: number): Promise<SQLiteDBConnection>;
+    createConnection(database: string, encrypted: boolean, mode: string, version: number, readonly: boolean): Promise<SQLiteDBConnection>;
     /**
      * Check if a connection exists
      * @param database
+     * @param readonly
      * @returns Promise<capSQLiteResult>
      * @since 3.0.0-beta.5
      */
-    isConnection(database: string): Promise<capSQLiteResult>;
+    isConnection(database: string, readonly: boolean): Promise<capSQLiteResult>;
     /**
      * Retrieve an existing database connection
      * @param database
+     * @param readonly
      * @returns Promise<SQLiteDBConnection>
      * @since 2.9.0 refactor
      */
-    retrieveConnection(database: string): Promise<SQLiteDBConnection>;
+    retrieveConnection(database: string, readonly: boolean): Promise<SQLiteDBConnection>;
     /**
      * Retrieve all database connections
      * @returns Promise<Map<string, SQLiteDBConnection>>
@@ -837,10 +848,11 @@ export interface ISQLiteConnection {
     /**
      * Close a database connection
      * @param database
+     * @param readonly
      * @returns Promise<void>
      * @since 2.9.0 refactor
      */
-    closeConnection(database: string): Promise<void>;
+    closeConnection(database: string, readonly: boolean): Promise<void>;
     /**
      * Close all database connections
      * @returns Promise<void>
@@ -979,10 +991,10 @@ export declare class SQLiteConnection implements ISQLiteConnection {
     changeEncryptionSecret(passphrase: string, oldpassphrase: string): Promise<void>;
     clearEncryptionSecret(): Promise<void>;
     addUpgradeStatement(database: string, toVersion: number, statements: string[]): Promise<void>;
-    createConnection(database: string, encrypted: boolean, mode: string, version: number): Promise<SQLiteDBConnection>;
-    closeConnection(database: string): Promise<void>;
-    isConnection(database: string): Promise<capSQLiteResult>;
-    retrieveConnection(database: string): Promise<SQLiteDBConnection>;
+    createConnection(database: string, encrypted: boolean, mode: string, version: number, readonly: boolean): Promise<SQLiteDBConnection>;
+    closeConnection(database: string, readonly: boolean): Promise<void>;
+    isConnection(database: string, readonly: boolean): Promise<capSQLiteResult>;
+    retrieveConnection(database: string, readonly: boolean): Promise<SQLiteDBConnection>;
     getNCDatabasePath(path: string, database: string): Promise<capNCDatabasePathResult>;
     createNCConnection(databasePath: string, version: number): Promise<SQLiteDBConnection>;
     closeNCConnection(databasePath: string): Promise<void>;
@@ -1012,6 +1024,12 @@ export interface ISQLiteDBConnection {
      * @since 2.9.0 refactor
      */
     getConnectionDBName(): string;
+    /**
+     * Get SQLite DB Connection read-only mode
+     * @returns boolean
+     * @since 4.1.0
+     */
+    getConnectionReadOnly(): boolean;
     /**
      * Open a SQLite DB Connection
      * @returns Promise<void>
@@ -1143,9 +1161,11 @@ export interface ISQLiteDBConnection {
  */
 export declare class SQLiteDBConnection implements ISQLiteDBConnection {
     private dbName;
+    private readonly;
     private sqlite;
-    constructor(dbName: string, sqlite: any);
+    constructor(dbName: string, readonly: boolean, sqlite: any);
     getConnectionDBName(): string;
+    getConnectionReadOnly(): boolean;
     open(): Promise<void>;
     close(): Promise<void>;
     getUrl(): Promise<capSQLiteUrl>;