@powersync/op-sqlite 0.0.0-dev-20251030153614 → 0.0.0-dev-20251106124255

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/op-sqlite",
-  "version": "0.0.0-dev-20251030153614",
+  "version": "0.0.0-dev-20251106124255",
   "description": "PowerSync - sync Postgres or MongoDB with SQLite in your React Native app for offline-first and real-time data",
   "source": "./src/index.ts",
   "main": "./lib/commonjs/index.js",
@@ -59,13 +59,13 @@
   },
   "peerDependencies": {
     "@op-engineering/op-sqlite": "^13.0.0 || ^14.0.0",
-    "@powersync/common": "0.0.0-dev-20251030153614",
+    "@powersync/common": "0.0.0-dev-20251106124255",
     "react": "*",
     "react-native": "*"
   },
   "dependencies": {
     "async-lock": "^1.4.0",
-    "@powersync/common": "0.0.0-dev-20251030153614"
+    "@powersync/common": "0.0.0-dev-20251106124255"
   },
   "devDependencies": {
     "@op-engineering/op-sqlite": "^14.0.2",

package/src/db/OPSQLiteConnection.ts

@@ -10,6 +10,8 @@ import {
 
 export type OPSQLiteConnectionOptions = {
   baseDB: DB;
+  debugMode: boolean;
+  connectionName: string;
 };
 
 export type OPSQLiteUpdateNotification = {
@@ -35,6 +37,16 @@ export class OPSQLiteConnection extends BaseObserver<DBAdapterListener> {
     this.DB.updateHook((update) => {
       this.addTableUpdate(update);
     });
+
+    if (options.debugMode) {
+      const c = this.options.connectionName;
+      this.execute = withDebug(this.execute.bind(this), `[SQL execute ${c}]`);
+      this.executeRaw = withDebug(this.executeRaw.bind(this), `[SQL executeRaw ${c}]`);
+      this.executeBatch = withDebug(this.executeBatch.bind(this), `[SQL executeBatch ${c}]`);
+      this.get = withDebug(this.get.bind(this), `[SQL get ${c}]`);
+      this.getAll = withDebug(this.getAll.bind(this), `[SQL getAll ${c}]`);
+      this.getOptional = withDebug(this.getOptional.bind(this), `[SQL getOptional ${c}]`);
+    }
   }
 
   addTableUpdate(update: OPSQLiteUpdateNotification) {
@@ -133,3 +145,19 @@ export class OPSQLiteConnection extends BaseObserver<DBAdapterListener> {
     await this.get("PRAGMA table_info('sqlite_master')");
   }
 }
+
+function withDebug<T extends (sql: string, ...args: any[]) => Promise<any>>(fn: T, name: string): T {
+  return (async (sql: string, ...args: any[]): Promise<any> => {
+    const start = performance.now();
+    try {
+      const r = await fn(sql, ...args);
+      const duration = performance.now() - start;
+      console.log(name, `[${duration.toFixed(1)}ms]`, sql);
+      return r;
+    } catch (e: any) {
+      const duration = performance.now() - start;
+      console.error(name, `[ERROR: ${e.message}]`, `[${duration.toFixed(1)}ms]`, sql);
+      throw e;
+    }
+  }) as T;
+}

package/src/db/OPSqliteAdapter.ts

@@ -12,6 +12,7 @@ export type OPSQLiteAdapterOptions = {
   name: string;
   dbLocation?: string;
   sqliteOptions?: SqliteOptions;
+  debugMode?: boolean;
 };
 
 enum LockType {
@@ -50,7 +51,7 @@ export class OPSQLiteDBAdapter extends BaseObserver<DBAdapterListener> implement
       this.options.sqliteOptions!;
     const dbFilename = this.options.name;
 
-    this.writeConnection = await this.openConnection(dbFilename);
+    this.writeConnection = await this.openConnection('w');
 
     const baseStatements = [
       `PRAGMA busy_timeout = ${lockTimeoutMs}`,
@@ -89,7 +90,7 @@ export class OPSQLiteDBAdapter extends BaseObserver<DBAdapterListener> implement
 
     this.readConnections = [];
     for (let i = 0; i < READ_CONNECTIONS; i++) {
-      const conn = await this.openConnection(dbFilename);
+      const conn = await this.openConnection(`r-${i}`);
       for (let statement of readConnectionStatements) {
         await conn.execute(statement);
       }
@@ -97,8 +98,8 @@ export class OPSQLiteDBAdapter extends BaseObserver<DBAdapterListener> implement
     }
   }
 
-  protected async openConnection(filenameOverride?: string): Promise<OPSQLiteConnection> {
-    const dbFilename = filenameOverride ?? this.options.name;
+  protected async openConnection(connectionName: string): Promise<OPSQLiteConnection> {
+    const dbFilename = this.options.name;
     const DB: DB = this.openDatabase(dbFilename, this.options.sqliteOptions?.encryptionKey ?? undefined);
 
     //Load extensions for all connections
@@ -108,7 +109,9 @@ export class OPSQLiteDBAdapter extends BaseObserver<DBAdapterListener> implement
     await DB.execute('SELECT powersync_init()');
 
     return new OPSQLiteConnection({
-      baseDB: DB
+      baseDB: DB,
+      debugMode: this.options.debugMode ?? false,
+      connectionName
     });
   }
 

package/src/db/OPSqliteDBOpenFactory.ts

@@ -19,7 +19,8 @@ export class OPSqliteOpenFactory implements SQLOpenFactory {
     return new OPSQLiteDBAdapter({
       name: this.options.dbFilename,
       dbLocation: this.options.dbLocation,
-      sqliteOptions: this.sqliteOptions
+      sqliteOptions: this.sqliteOptions,
+      debugMode: this.options.debugMode
     });
   }
 }