@op-engineering/op-sqlite 1.0.11 → 1.0.12

package/README.md

@@ -8,32 +8,17 @@
 </div>
 <br />
 
-OP SQLite embeds the latest version of SQLite and provides a low-level (JSI-backed) API to execute SQL queries.
+OP SQLite embeds the latest version of SQLite and provides a low-level API to execute SQL queries.
 
 **Current SQLite version: 3.44.0**
 
-Created by [@ospfranco](https://twitter.com/ospfranco). Also created `react-native-quick-sqlite`, this is the next version. You can expect a new version once Static Hermes is out.
-
-**Please consider Sponsoring**, none of this work is for free. I pay for it with my time and knowledge. If you are a company in need of help with your React Native/React apps feel free to reach out. I also do a lot of C++ and nowadays Rust.
-
-## Coming up
-
-I will gladly review bug fixes, but in order for me to continue support and add new features, I ask you to sponsor me. Some of the things that can still be done to make this package faster and more complete:
-
-- Prepared statements
-- Inlining functions
-- Batching queries
-- Update hook
+Created by [@ospfranco](https://twitter.com/ospfranco). **Please consider Sponsoring**, none of this work is for free. I pay for it with my time and knowledge. If you are a company in need of help with your React Native/React apps feel free to reach out. I also do a lot of C++ and nowadays Rust.
 
 ## Benchmarks
 
-You can find the [benchmarking code in the example app](https://github.com/OP-Engineering/op-sqlite/blob/main/example/src/Database.ts#L44). Non JSI libraries are not even a contender anymore, you should expect anywhere between a 5x to a 8x improvement over sqlite-storage, sqlite2 and so on. Loading a 300k record database (in milliseconds).
+You can find the [benchmarking code in the example app](https://github.com/OP-Engineering/op-sqlite/blob/main/example/src/Database.ts#L44). You should expect anywhere between a 5x to a 8x improvement over non-JSI packages, and now a 5x to 8x improvement over quick-sqlite and expo-sqlite. Loading a 300k record database (in milliseconds).
 
-| Library      | iPhone 15 Pro | Galaxy S22 |
-| ------------ | ------------- | ---------- |
-| quick-sqlite | 2719ms        | 8851ms     |
-| expo-sqlite  | 2293ms        | 10626ms    |
-| op-sqlite    | 507ms         | 1125ms     |
+![benchmark](benchmark.png)
 
 Memory consumption is also is also 1/4 compared to `react-native-quick-sqlite`. This query used to take 1.2gb of peak memory usage, now runs in 250mbs.
 
@@ -231,7 +216,7 @@ db.executeAsync(
 
 ### Blobs
 
-Blobs are supported via `ArrayBuffer`, you need to be careful about the semantics though. You cannot instanciate an instance of `ArrayBuffer` directly, nor pass a typed array directly. Here is an example:
+Blobs are supported via `ArrayBuffer`, you need to be careful about the semantics though. You cannot instantiate an instance of `ArrayBuffer` directly, nor pass a typed array directly. Here is an example:
 
 ```ts
 db = open({
@@ -296,6 +281,28 @@ const { rowsAffected, commands } = db
   });
 ```
 
+## Update hook
+
+You can subscribe to changes in your database by using an update hook:
+
+```ts
+// Bear in mind: rowId is not your table primary key but the internal rowId sqlite uses
+// to keep track of the table rows
+db.updateHook(({ rowId, table, operation, row = {} }) => {
+  console.warn(`Hook has been called, rowId: ${rowId}, ${table}, ${operation}`);
+  // Will contain the entire row that changed
+  // only on UPDATE and INSERT operations
+  console.warn(JSON.stringify(row, null, 2));
+});
+
+db.execute('INSERT INTO "User" (id, name, age, networth) VALUES(?, ?, ?, ?)', [
+  id,
+  name,
+  age,
+  networth,
+]);
+```
+
 ## Use built-in SQLite
 
 On iOS you can use the embedded SQLite, when running `pod-install` add an environment flag:

package/cpp/bindings.cpp

@@ -9,6 +9,7 @@
 #include "macros.h"
 #include <iostream>
 #include "DumbHostObject.h"
+#include <unordered_map>
 
 namespace opsqlite {
 
@@ -17,11 +18,19 @@ namespace jsi = facebook::jsi;
 std::string basePath;
 std::shared_ptr<react::CallInvoker> invoker;
 ThreadPool pool;
+std::unordered_map<std::string, std::shared_ptr<jsi::Value>> updateHooks = std::unordered_map<std::string, std::shared_ptr<jsi::Value>>();
+
+
+// React native will try to clean the module on JS context invalidation (CodePush/Hot Reload)
+// The clearState function is called and we use this flag to prevent any ongoing
+// operations from continuing work and can return early
 bool invalidated = false;
 
 void clearState() {
     invalidated = true;
+    // Will terminate all operations and database connections
     sqliteCloseAll();
+    // We then join all the threads before the context gets invalidated
     pool.restartPool();
 }
 
@@ -428,7 +437,47 @@ void install(jsi::Runtime &rt, std::shared_ptr<react::CallInvoker> jsCallInvoker
         return promise;
     });
     
-    
+    auto updateHook = HOSTFN("updateHook", 2)
+    {
+        if (sizeof(args) < 2)
+        {
+            throw jsi::JSError(rt, "[op-sqlite][loadFileAsync] Incorrect parameters: dbName and callback needed");
+            return {};
+        }
+        
+        auto dbName = args[0].asString(rt).utf8(rt);
+        auto callback = std::make_shared<jsi::Value>(rt, args[1]);
+        updateHooks[dbName] = callback;
+        
+        auto hook = [&rt, callback](std::string dbName, std::string tableName, std::string operation, int rowId) {
+            std::vector<JSVariant> params;
+            std::vector<DumbHostObject> results;
+            std::shared_ptr<std::vector<DynamicHostObject>> metadata = std::make_shared<std::vector<DynamicHostObject>>();;
+            
+            if(operation != "DELETE") {
+                std::string query = "SELECT * FROM " + tableName + " where rowid = " + std::to_string(rowId) + ";";
+                sqliteExecute(dbName, query, &params, &results, metadata);
+            }
+            
+            invoker->invokeAsync([&rt, results = std::make_shared<std::vector<DumbHostObject>>(results), callback, tableName = std::move(tableName), operation = std::move(operation), &rowId]
+                                 {
+                auto res = jsi::Object(rt);
+                res.setProperty(rt, "table", jsi::String::createFromUtf8(rt, tableName));
+                res.setProperty(rt, "operation", jsi::String::createFromUtf8(rt, operation));
+                res.setProperty(rt, "rowId", jsi::Value(rowId));
+                if(results->size() != 0) {
+                    res.setProperty(rt, "row", jsi::Object::createFromHostObject(rt, std::make_shared<DumbHostObject>(results->at(0))));
+                }
+                
+                callback->asObject(rt).asFunction(rt).call(rt, res);
+                
+            });
+        };
+        
+        registerUpdateHook(dbName, std::move(hook));
+        
+        return {};
+    });
     
     jsi::Object module = jsi::Object(rt);
     
@@ -442,6 +491,7 @@ void install(jsi::Runtime &rt, std::shared_ptr<react::CallInvoker> jsCallInvoker
     module.setProperty(rt, "executeBatch", std::move(executeBatch));
     module.setProperty(rt, "executeBatchAsync", std::move(executeBatchAsync));
     module.setProperty(rt, "loadFile", std::move(loadFile));
+    module.setProperty(rt, "updateHook", std::move(updateHook));
     
     rt.global().setProperty(rt, "__OPSQLiteProxy", std::move(module));
 }

package/cpp/bridge.cpp

@@ -14,6 +14,12 @@
 namespace opsqlite {
 
     std::unordered_map<std::string, sqlite3 *> dbMap = std::unordered_map<std::string, sqlite3 *>();
+    std::unordered_map<
+        std::string,
+        std::function<void (std::string dbName, std::string tableName, std::string operation, int rowId)>> callbackMap =
+            std::unordered_map<
+                std::string,
+                std::function<void (std::string dbName, std::string tableName, std::string operation, int rowId)>>();
 
     bool folder_exists(const std::string &foldername)
     {
@@ -90,10 +96,8 @@ namespace opsqlite {
                 .message = sqlite3_errmsg(db)
             };
         }
-        else
-        {
-            dbMap[dbName] = db;
-        }
+
+        dbMap[dbName] = db;
         
         return BridgeResult{
             .type = SQLiteOk,
@@ -250,6 +254,7 @@ namespace opsqlite {
         sqlite3 *db = dbMap[dbName];
         
         sqlite3_stmt *statement;
+        const char *errorMessage;
         const char *remainingStatement = nullptr;
         
         bool isConsuming = true;
@@ -377,6 +382,7 @@ namespace opsqlite {
                         break;
                         
                     default:
+                        errorMessage = sqlite3_errmsg(db);
                         isFailed = true;
                         isConsuming = false;
                 }
@@ -388,10 +394,10 @@ namespace opsqlite {
         
         if (isFailed)
         {
-            const char *message = sqlite3_errmsg(db);
+        
             return {
                 .type = SQLiteError,
-                .message = "[op-sqlite] SQLite code: " + std::to_string(result) + " execution error: " + std::string(message)
+                .message = "[op-sqlite] SQLite code: " + std::to_string(result) + " execution error: " + std::string(errorMessage)
             };
         }
         
@@ -475,12 +481,67 @@ namespace opsqlite {
 
     void sqliteCloseAll() {
         for (auto const& x : dbMap) {
+            // Interrupt will make all pending operations to fail with SQLITE_INTERRUPT
+            // The ongoing work from threads will then fail ASAP
             sqlite3_interrupt(x.second);
-            // In certain cases, this will return SQLITE_OK, mark the database connection as an unusable "zombie",
-            // and deallocate the connection later.
+            // Each DB connection can then be safely interrupted
             sqlite3_close_v2(x.second);
         }
         dbMap.clear();
     }
+
+std::string operationToString(int operation_type) {
+    switch (operation_type) {
+        case SQLITE_INSERT:
+            return "INSERT";
+        
+        case SQLITE_DELETE:
+            return "DELETE";
+            
+        case SQLITE_UPDATE:
+            return "UPDATE";
+            
+        default:
+            throw std::invalid_argument("Uknown SQLite operation on hook");
+    }
+}
+
+void update_callback ( void *dbName, int operation_type,
+    char const *database, char const *table,
+    sqlite3_int64 rowid)
+    {
+    std::string &strDbName = *(static_cast<std::string*>(dbName));
+    auto callback = callbackMap[strDbName];
+    callback(strDbName, std::string(table), operationToString(operation_type), static_cast<int>(rowid));
+    }
     
+    BridgeResult registerUpdateHook(std::string const dbName, std::function<void (std::string dbName, std::string tableName, std::string operation, int rowId)> const callback) {
+        if (dbMap.count(dbName) == 0)
+        {
+            return {
+                SQLiteError,
+                "[op-sqlite] Database not opened: " + dbName
+            };
+        }
+        
+        sqlite3 *db = dbMap[dbName];
+        callbackMap[dbName] = callback;
+        const std::string *key = nullptr;
+        
+        // TODO find a more elegant way to retrieve a reference to the key
+        for (auto const& element : dbMap) {
+            if(element.first == dbName) {
+                key = &element.first;
+            }
+        }
+        
+        sqlite3_update_hook(
+          db,
+          &update_callback,
+          (void *)key);
+        
+        return {
+            SQLiteOk
+        };
+    }
 }

package/cpp/bridge.h

@@ -31,6 +31,8 @@ BridgeResult sqliteExecuteLiteral(std::string const dbName, std::string const &q
 
 void sqliteCloseAll();
 
+BridgeResult registerUpdateHook(std::string const dbName, std::function<void (std::string dbName, std::string tableName, std::string operation, int rowId)> const callback);
+
 }
 
 #endif /* bridge_h */

package/lib/commonjs/index.js

@@ -204,7 +204,8 @@ const open = options => {
     executeAsync: (query, params) => OPSQLite.executeAsync(options.name, query, params),
     executeBatch: commands => OPSQLite.executeBatch(options.name, commands),
     executeBatchAsync: commands => OPSQLite.executeBatchAsync(options.name, commands),
-    loadFile: location => OPSQLite.loadFile(options.name, location)
+    loadFile: location => OPSQLite.loadFile(options.name, location),
+    updateHook: callback => OPSQLite.updateHook(options.name, callback)
   };
 };
 exports.open = open;

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["global","__OPSQLiteProxy","OPSQLiteModule","NativeModules","OPSQLite","Error","nativeCallSyncHook","install","result","proxy","locks","enhanceQueryResult","rows","_array","length","item","idx","_open","open","dbName","location","inMemory","queue","inProgress","_close","close","_execute","execute","query","params","sanitizedParams","map","p","ArrayBuffer","isView","buffer","_executeAsync","executeAsync","res","transaction","fn","isFinalized","commit","rollback","run","executionError","rollbackError","startNextTransaction","Promise","resolve","reject","tx","start","then","catch","push","shift","setImmediate","options","name","delete","attach","dbNameToAttach","alias","detach","executeBatch","commands","executeBatchAsync","loadFile"],"sources":["index.ts"],"sourcesContent":["import { NativeModules } from 'react-native';\n\ndeclare global {\n  function nativeCallSyncHook(): unknown;\n  var __OPSQLiteProxy: object | undefined;\n}\n\nif (global.__OPSQLiteProxy == null) {\n  const OPSQLiteModule = NativeModules.OPSQLite;\n\n  if (OPSQLiteModule == null) {\n    throw new Error('Base module not found. Maybe try rebuilding the app.');\n  }\n\n  // Check if we are running on-device (JSI)\n  if (global.nativeCallSyncHook == null || OPSQLiteModule.install == null) {\n    throw new Error(\n      'Failed to install op-sqlite: React Native is not running on-device. OPSQLite can only be used when synchronous method invocations (JSI) are possible. If you are using a remote debugger (e.g. Chrome), switch to an on-device debugger (e.g. Flipper) instead.'\n    );\n  }\n\n  // Call the synchronous blocking install() function\n  const result = OPSQLiteModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Failed to install op-sqlite: The native OPSQLite Module could not be installed! Looks like something went wrong when installing JSI bindings: ${result}`\n    );\n  }\n\n  // Check again if the constructor now exists. If not, throw an error.\n  if (global.__OPSQLiteProxy == null) {\n    throw new Error(\n      'Failed to install op-sqlite, the native initializer function does not exist. Are you trying to use OPSQLite from different JS Runtimes?'\n    );\n  }\n}\n\nconst proxy = global.__OPSQLiteProxy;\nexport const OPSQLite = proxy as ISQLite;\n\n/**\n * Object returned by SQL Query executions {\n *  insertId: Represent the auto-generated row id if applicable\n *  rowsAffected: Number of affected rows if result of a update query\n *  message: if status === 1, here you will find error description\n *  rows: if status is undefined or 0 this object will contain the query results\n * }\n *\n * @interface QueryResult\n */\nexport type QueryResult = {\n  insertId?: number;\n  rowsAffected: number;\n  rows?: {\n    /** Raw array with all dataset */\n    _array: any[];\n    /** The lengh of the dataset */\n    length: number;\n    /** A convenience function to acess the index based the row object\n     * @param idx the row index\n     * @returns the row structure identified by column names\n     */\n    item: (idx: number) => any;\n  };\n  /**\n   * Query metadata, avaliable only for select query results\n   */\n  metadata?: ColumnMetadata[];\n};\n\n/**\n * Column metadata\n * Describes some information about columns fetched by the query\n */\nexport type ColumnMetadata = {\n  /** The name used for this column for this resultset */\n  name: string;\n  /** The declared column type for this column, when fetched directly from a table or a View resulting from a table column. \"UNKNOWN\" for dynamic values, like function returned ones. */\n  type: string;\n  /**\n   * The index for this column for this resultset*/\n  index: number;\n};\n\n/**\n * Allows the execution of bulk of sql commands\n * inside a transaction\n * If a single query must be executed many times with different arguments, its preferred\n * to declare it a single time, and use an array of array parameters.\n */\nexport type SQLBatchTuple = [string] | [string, Array<any> | Array<Array<any>>];\n\n/**\n * status: 0 or undefined for correct execution, 1 for error\n * message: if status === 1, here you will find error description\n * rowsAffected: Number of affected rows if status == 0\n */\nexport type BatchQueryResult = {\n  rowsAffected?: number;\n};\n\n/**\n * Result of loading a file and executing every line as a SQL command\n * Similar to BatchQueryResult\n */\nexport interface FileLoadResult extends BatchQueryResult {\n  commands?: number;\n}\n\nexport interface Transaction {\n  commit: () => QueryResult;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    query: string,\n    params?: any[] | undefined\n  ) => Promise<QueryResult>;\n  rollback: () => QueryResult;\n}\n\nexport interface PendingTransaction {\n  /*\n   * The start function should not throw or return a promise because the\n   * queue just calls it and does not monitor for failures or completions.\n   *\n   * It should catch any errors and call the resolve or reject of the wrapping\n   * promise when complete.\n   *\n   * It should also automatically commit or rollback the transaction if needed\n   */\n  start: () => void;\n}\n\ninterface ISQLite {\n  open: (dbName: string, location?: string, inMemory?: boolean) => void;\n  close: (dbName: string) => void;\n  delete: (dbName: string, location?: string) => void;\n  attach: (\n    mainDbName: string,\n    dbNameToAttach: string,\n    alias: string,\n    location?: string\n  ) => void;\n  detach: (mainDbName: string, alias: string) => void;\n  transaction: (\n    dbName: string,\n    fn: (tx: Transaction) => Promise<void>\n  ) => Promise<void>;\n  execute: (dbName: string, query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    dbName: string,\n    query: string,\n    params?: any[]\n  ) => Promise<QueryResult>;\n  executeBatch: (dbName: string, commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (\n    dbName: string,\n    commands: SQLBatchTuple[]\n  ) => Promise<BatchQueryResult>;\n  loadFile: (dbName: string, location: string) => Promise<FileLoadResult>;\n}\n\nconst locks: Record<\n  string,\n  { queue: PendingTransaction[]; inProgress: boolean }\n> = {};\n\n// Enhance some host functions\n\n// Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\nfunction enhanceQueryResult(result: QueryResult): void {\n  // Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\n  if (result.rows == null) {\n    result.rows = {\n      _array: [],\n      length: 0,\n      item: (idx: number) => result.rows?._array[idx],\n    };\n  } else {\n    result.rows.item = (idx: number) => result.rows?._array[idx];\n  }\n}\n\nconst _open = OPSQLite.open;\nOPSQLite.open = (dbName: string, location?: string, inMemory?: boolean) => {\n  _open(dbName, location, !!inMemory);\n\n  locks[dbName] = {\n    queue: [],\n    inProgress: false,\n  };\n};\n\nconst _close = OPSQLite.close;\nOPSQLite.close = (dbName: string) => {\n  _close(dbName);\n  delete locks[dbName];\n};\n\nconst _execute = OPSQLite.execute;\nOPSQLite.execute = (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): QueryResult => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const result = _execute(dbName, query, sanitizedParams);\n  enhanceQueryResult(result);\n  return result;\n};\n\nconst _executeAsync = OPSQLite.executeAsync;\nOPSQLite.executeAsync = async (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): Promise<QueryResult> => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const res = await _executeAsync(dbName, query, sanitizedParams);\n  enhanceQueryResult(res);\n  return res;\n};\n\nOPSQLite.transaction = async (\n  dbName: string,\n  fn: (tx: Transaction) => Promise<void>\n): Promise<void> => {\n  if (!locks[dbName]) {\n    throw Error(`SQLite Error: No lock found on db: ${dbName}`);\n  }\n\n  let isFinalized = false;\n\n  // Local transaction context object implementation\n  const execute = (query: string, params?: any[]): QueryResult => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.execute(dbName, query, params);\n  };\n\n  const executeAsync = (query: string, params?: any[] | undefined) => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.executeAsync(dbName, query, params);\n  };\n\n  const commit = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute commit on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'COMMIT');\n    isFinalized = true;\n    return result;\n  };\n\n  const rollback = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute rollback on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'ROLLBACK');\n    isFinalized = true;\n    return result;\n  };\n\n  async function run() {\n    try {\n      await OPSQLite.executeAsync(dbName, 'BEGIN TRANSACTION');\n\n      await fn({\n        commit,\n        execute,\n        executeAsync,\n        rollback,\n      });\n\n      if (!isFinalized) {\n        commit();\n      }\n    } catch (executionError) {\n      if (!isFinalized) {\n        try {\n          rollback();\n        } catch (rollbackError) {\n          throw rollbackError;\n        }\n      }\n\n      throw executionError;\n    } finally {\n      locks[dbName].inProgress = false;\n      isFinalized = false;\n      startNextTransaction(dbName);\n    }\n  }\n\n  return await new Promise((resolve, reject) => {\n    const tx: PendingTransaction = {\n      start: () => {\n        run().then(resolve).catch(reject);\n      },\n    };\n\n    locks[dbName].queue.push(tx);\n    startNextTransaction(dbName);\n  });\n};\n\nconst startNextTransaction = (dbName: string) => {\n  if (!locks[dbName]) {\n    throw Error(`Lock not found for db: ${dbName}`);\n  }\n\n  if (locks[dbName].inProgress) {\n    // Transaction is already in process bail out\n    return;\n  }\n\n  if (locks[dbName].queue.length) {\n    locks[dbName].inProgress = true;\n    const tx = locks[dbName].queue.shift();\n\n    if (!tx) {\n      throw new Error('Could not get a operation on datebase');\n    }\n\n    setImmediate(() => {\n      tx.start();\n    });\n  }\n};\n\nexport type OPSQLiteConnection = {\n  close: () => void;\n  delete: () => void;\n  attach: (dbNameToAttach: string, alias: string, location?: string) => void;\n  detach: (alias: string) => void;\n  transaction: (fn: (tx: Transaction) => Promise<void>) => Promise<void>;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (query: string, params?: any[]) => Promise<QueryResult>;\n  executeBatch: (commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (commands: SQLBatchTuple[]) => Promise<BatchQueryResult>;\n  loadFile: (location: string) => Promise<FileLoadResult>;\n};\n\nexport const open = (options: {\n  name: string;\n  location?: string;\n  inMemory?: boolean;\n}): OPSQLiteConnection => {\n  OPSQLite.open(options.name, options.location, options.inMemory);\n\n  return {\n    close: () => OPSQLite.close(options.name),\n    delete: () => OPSQLite.delete(options.name, options.location),\n    attach: (dbNameToAttach: string, alias: string, location?: string) =>\n      OPSQLite.attach(options.name, dbNameToAttach, alias, location),\n    detach: (alias: string) => OPSQLite.detach(options.name, alias),\n    transaction: (fn: (tx: Transaction) => Promise<void>) =>\n      OPSQLite.transaction(options.name, fn),\n    execute: (query: string, params?: any[] | undefined): QueryResult =>\n      OPSQLite.execute(options.name, query, params),\n    executeAsync: (\n      query: string,\n      params?: any[] | undefined\n    ): Promise<QueryResult> =>\n      OPSQLite.executeAsync(options.name, query, params),\n    executeBatch: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatch(options.name, commands),\n    executeBatchAsync: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatchAsync(options.name, commands),\n    loadFile: (location: string) => OPSQLite.loadFile(options.name, location),\n  };\n};\n"],"mappings":"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"}
+{"version":3,"names":["global","__OPSQLiteProxy","OPSQLiteModule","NativeModules","OPSQLite","Error","nativeCallSyncHook","install","result","proxy","locks","enhanceQueryResult","rows","_array","length","item","idx","_open","open","dbName","location","inMemory","queue","inProgress","_close","close","_execute","execute","query","params","sanitizedParams","map","p","ArrayBuffer","isView","buffer","_executeAsync","executeAsync","res","transaction","fn","isFinalized","commit","rollback","run","executionError","rollbackError","startNextTransaction","Promise","resolve","reject","tx","start","then","catch","push","shift","setImmediate","options","name","delete","attach","dbNameToAttach","alias","detach","executeBatch","commands","executeBatchAsync","loadFile","updateHook","callback"],"sources":["index.ts"],"sourcesContent":["import { NativeModules } from 'react-native';\n\ndeclare global {\n  function nativeCallSyncHook(): unknown;\n  var __OPSQLiteProxy: object | undefined;\n}\n\nif (global.__OPSQLiteProxy == null) {\n  const OPSQLiteModule = NativeModules.OPSQLite;\n\n  if (OPSQLiteModule == null) {\n    throw new Error('Base module not found. Maybe try rebuilding the app.');\n  }\n\n  // Check if we are running on-device (JSI)\n  if (global.nativeCallSyncHook == null || OPSQLiteModule.install == null) {\n    throw new Error(\n      'Failed to install op-sqlite: React Native is not running on-device. OPSQLite can only be used when synchronous method invocations (JSI) are possible. If you are using a remote debugger (e.g. Chrome), switch to an on-device debugger (e.g. Flipper) instead.'\n    );\n  }\n\n  // Call the synchronous blocking install() function\n  const result = OPSQLiteModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Failed to install op-sqlite: The native OPSQLite Module could not be installed! Looks like something went wrong when installing JSI bindings: ${result}`\n    );\n  }\n\n  // Check again if the constructor now exists. If not, throw an error.\n  if (global.__OPSQLiteProxy == null) {\n    throw new Error(\n      'Failed to install op-sqlite, the native initializer function does not exist. Are you trying to use OPSQLite from different JS Runtimes?'\n    );\n  }\n}\n\nconst proxy = global.__OPSQLiteProxy;\nexport const OPSQLite = proxy as ISQLite;\n\n/**\n * Object returned by SQL Query executions {\n *  insertId: Represent the auto-generated row id if applicable\n *  rowsAffected: Number of affected rows if result of a update query\n *  message: if status === 1, here you will find error description\n *  rows: if status is undefined or 0 this object will contain the query results\n * }\n *\n * @interface QueryResult\n */\nexport type QueryResult = {\n  insertId?: number;\n  rowsAffected: number;\n  rows?: {\n    /** Raw array with all dataset */\n    _array: any[];\n    /** The lengh of the dataset */\n    length: number;\n    /** A convenience function to acess the index based the row object\n     * @param idx the row index\n     * @returns the row structure identified by column names\n     */\n    item: (idx: number) => any;\n  };\n  /**\n   * Query metadata, avaliable only for select query results\n   */\n  metadata?: ColumnMetadata[];\n};\n\n/**\n * Column metadata\n * Describes some information about columns fetched by the query\n */\nexport type ColumnMetadata = {\n  /** The name used for this column for this resultset */\n  name: string;\n  /** The declared column type for this column, when fetched directly from a table or a View resulting from a table column. \"UNKNOWN\" for dynamic values, like function returned ones. */\n  type: string;\n  /**\n   * The index for this column for this resultset*/\n  index: number;\n};\n\n/**\n * Allows the execution of bulk of sql commands\n * inside a transaction\n * If a single query must be executed many times with different arguments, its preferred\n * to declare it a single time, and use an array of array parameters.\n */\nexport type SQLBatchTuple = [string] | [string, Array<any> | Array<Array<any>>];\n\nexport type UpdateHookOperation = 'INSERT' | 'DELETE' | 'UPDATE';\n\n/**\n * status: 0 or undefined for correct execution, 1 for error\n * message: if status === 1, here you will find error description\n * rowsAffected: Number of affected rows if status == 0\n */\nexport type BatchQueryResult = {\n  rowsAffected?: number;\n};\n\n/**\n * Result of loading a file and executing every line as a SQL command\n * Similar to BatchQueryResult\n */\nexport interface FileLoadResult extends BatchQueryResult {\n  commands?: number;\n}\n\nexport interface Transaction {\n  commit: () => QueryResult;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    query: string,\n    params?: any[] | undefined\n  ) => Promise<QueryResult>;\n  rollback: () => QueryResult;\n}\n\nexport interface PendingTransaction {\n  /*\n   * The start function should not throw or return a promise because the\n   * queue just calls it and does not monitor for failures or completions.\n   *\n   * It should catch any errors and call the resolve or reject of the wrapping\n   * promise when complete.\n   *\n   * It should also automatically commit or rollback the transaction if needed\n   */\n  start: () => void;\n}\n\ninterface ISQLite {\n  open: (dbName: string, location?: string, inMemory?: boolean) => void;\n  close: (dbName: string) => void;\n  delete: (dbName: string, location?: string) => void;\n  attach: (\n    mainDbName: string,\n    dbNameToAttach: string,\n    alias: string,\n    location?: string\n  ) => void;\n  detach: (mainDbName: string, alias: string) => void;\n  transaction: (\n    dbName: string,\n    fn: (tx: Transaction) => Promise<void>\n  ) => Promise<void>;\n  execute: (dbName: string, query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    dbName: string,\n    query: string,\n    params?: any[]\n  ) => Promise<QueryResult>;\n  executeBatch: (dbName: string, commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (\n    dbName: string,\n    commands: SQLBatchTuple[]\n  ) => Promise<BatchQueryResult>;\n  loadFile: (dbName: string, location: string) => Promise<FileLoadResult>;\n  updateHook: (\n    dbName: string,\n    callback: (params: {\n      table: string;\n      operation: UpdateHookOperation;\n      row?: any;\n      rowId: number;\n    }) => void\n  ) => void;\n}\n\nconst locks: Record<\n  string,\n  { queue: PendingTransaction[]; inProgress: boolean }\n> = {};\n\n// Enhance some host functions\n\n// Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\nfunction enhanceQueryResult(result: QueryResult): void {\n  // Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\n  if (result.rows == null) {\n    result.rows = {\n      _array: [],\n      length: 0,\n      item: (idx: number) => result.rows?._array[idx],\n    };\n  } else {\n    result.rows.item = (idx: number) => result.rows?._array[idx];\n  }\n}\n\nconst _open = OPSQLite.open;\nOPSQLite.open = (dbName: string, location?: string, inMemory?: boolean) => {\n  _open(dbName, location, !!inMemory);\n\n  locks[dbName] = {\n    queue: [],\n    inProgress: false,\n  };\n};\n\nconst _close = OPSQLite.close;\nOPSQLite.close = (dbName: string) => {\n  _close(dbName);\n  delete locks[dbName];\n};\n\nconst _execute = OPSQLite.execute;\nOPSQLite.execute = (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): QueryResult => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const result = _execute(dbName, query, sanitizedParams);\n  enhanceQueryResult(result);\n  return result;\n};\n\nconst _executeAsync = OPSQLite.executeAsync;\nOPSQLite.executeAsync = async (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): Promise<QueryResult> => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const res = await _executeAsync(dbName, query, sanitizedParams);\n  enhanceQueryResult(res);\n  return res;\n};\n\nOPSQLite.transaction = async (\n  dbName: string,\n  fn: (tx: Transaction) => Promise<void>\n): Promise<void> => {\n  if (!locks[dbName]) {\n    throw Error(`SQLite Error: No lock found on db: ${dbName}`);\n  }\n\n  let isFinalized = false;\n\n  // Local transaction context object implementation\n  const execute = (query: string, params?: any[]): QueryResult => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.execute(dbName, query, params);\n  };\n\n  const executeAsync = (query: string, params?: any[] | undefined) => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.executeAsync(dbName, query, params);\n  };\n\n  const commit = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute commit on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'COMMIT');\n    isFinalized = true;\n    return result;\n  };\n\n  const rollback = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute rollback on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'ROLLBACK');\n    isFinalized = true;\n    return result;\n  };\n\n  async function run() {\n    try {\n      await OPSQLite.executeAsync(dbName, 'BEGIN TRANSACTION');\n\n      await fn({\n        commit,\n        execute,\n        executeAsync,\n        rollback,\n      });\n\n      if (!isFinalized) {\n        commit();\n      }\n    } catch (executionError) {\n      if (!isFinalized) {\n        try {\n          rollback();\n        } catch (rollbackError) {\n          throw rollbackError;\n        }\n      }\n\n      throw executionError;\n    } finally {\n      locks[dbName].inProgress = false;\n      isFinalized = false;\n      startNextTransaction(dbName);\n    }\n  }\n\n  return await new Promise((resolve, reject) => {\n    const tx: PendingTransaction = {\n      start: () => {\n        run().then(resolve).catch(reject);\n      },\n    };\n\n    locks[dbName].queue.push(tx);\n    startNextTransaction(dbName);\n  });\n};\n\nconst startNextTransaction = (dbName: string) => {\n  if (!locks[dbName]) {\n    throw Error(`Lock not found for db: ${dbName}`);\n  }\n\n  if (locks[dbName].inProgress) {\n    // Transaction is already in process bail out\n    return;\n  }\n\n  if (locks[dbName].queue.length) {\n    locks[dbName].inProgress = true;\n    const tx = locks[dbName].queue.shift();\n\n    if (!tx) {\n      throw new Error('Could not get a operation on datebase');\n    }\n\n    setImmediate(() => {\n      tx.start();\n    });\n  }\n};\n\nexport type OPSQLiteConnection = {\n  close: () => void;\n  delete: () => void;\n  attach: (dbNameToAttach: string, alias: string, location?: string) => void;\n  detach: (alias: string) => void;\n  transaction: (fn: (tx: Transaction) => Promise<void>) => Promise<void>;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (query: string, params?: any[]) => Promise<QueryResult>;\n  executeBatch: (commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (commands: SQLBatchTuple[]) => Promise<BatchQueryResult>;\n  loadFile: (location: string) => Promise<FileLoadResult>;\n  updateHook: (\n    callback: (params: {\n      table: string;\n      operation: UpdateHookOperation;\n      row?: any;\n      rowId: number;\n    }) => void\n  ) => void;\n};\n\nexport const open = (options: {\n  name: string;\n  location?: string;\n  inMemory?: boolean;\n}): OPSQLiteConnection => {\n  OPSQLite.open(options.name, options.location, options.inMemory);\n\n  return {\n    close: () => OPSQLite.close(options.name),\n    delete: () => OPSQLite.delete(options.name, options.location),\n    attach: (dbNameToAttach: string, alias: string, location?: string) =>\n      OPSQLite.attach(options.name, dbNameToAttach, alias, location),\n    detach: (alias: string) => OPSQLite.detach(options.name, alias),\n    transaction: (fn: (tx: Transaction) => Promise<void>) =>\n      OPSQLite.transaction(options.name, fn),\n    execute: (query: string, params?: any[] | undefined): QueryResult =>\n      OPSQLite.execute(options.name, query, params),\n    executeAsync: (\n      query: string,\n      params?: any[] | undefined\n    ): Promise<QueryResult> =>\n      OPSQLite.executeAsync(options.name, query, params),\n    executeBatch: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatch(options.name, commands),\n    executeBatchAsync: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatchAsync(options.name, commands),\n    loadFile: (location: string) => OPSQLite.loadFile(options.name, location),\n    updateHook: (callback) => OPSQLite.updateHook(options.name, callback),\n  };\n};\n"],"mappings":";;;;;;AAAA;AAOA,IAAIA,MAAM,CAACC,eAAe,IAAI,IAAI,EAAE;EAClC,MAAMC,cAAc,GAAGC,0BAAa,CAACC,QAAQ;EAE7C,IAAIF,cAAc,IAAI,IAAI,EAAE;IAC1B,MAAM,IAAIG,KAAK,CAAC,sDAAsD,CAAC;EACzE;;EAEA;EACA,IAAIL,MAAM,CAACM,kBAAkB,IAAI,IAAI,IAAIJ,cAAc,CAACK,OAAO,IAAI,IAAI,EAAE;IACvE,MAAM,IAAIF,KAAK,CACb,iQAAiQ,CAClQ;EACH;;EAEA;EACA,MAAMG,MAAM,GAAGN,cAAc,CAACK,OAAO,EAAE;EACvC,IAAIC,MAAM,KAAK,IAAI,EAAE;IACnB,MAAM,IAAIH,KAAK,CACZ,iJAAgJG,MAAO,EAAC,CAC1J;EACH;;EAEA;EACA,IAAIR,MAAM,CAACC,eAAe,IAAI,IAAI,EAAE;IAClC,MAAM,IAAII,KAAK,CACb,yIAAyI,CAC1I;EACH;AACF;AAEA,MAAMI,KAAK,GAAGT,MAAM,CAACC,eAAe;AAC7B,MAAMG,QAAQ,GAAGK,KAAgB;;AAExC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AATA;AAoIA,MAAMC,KAGL,GAAG,CAAC,CAAC;;AAEN;;AAEA;AACA,SAASC,kBAAkB,CAACH,MAAmB,EAAQ;EACrD;EACA,IAAIA,MAAM,CAACI,IAAI,IAAI,IAAI,EAAE;IACvBJ,MAAM,CAACI,IAAI,GAAG;MACZC,MAAM,EAAE,EAAE;MACVC,MAAM,EAAE,CAAC;MACTC,IAAI,EAAGC,GAAW;QAAA;QAAA,uBAAKR,MAAM,CAACI,IAAI,iDAAX,aAAaC,MAAM,CAACG,GAAG,CAAC;MAAA;IACjD,CAAC;EACH,CAAC,MAAM;IACLR,MAAM,CAACI,IAAI,CAACG,IAAI,GAAIC,GAAW;MAAA;MAAA,wBAAKR,MAAM,CAACI,IAAI,kDAAX,cAAaC,MAAM,CAACG,GAAG,CAAC;IAAA;EAC9D;AACF;AAEA,MAAMC,KAAK,GAAGb,QAAQ,CAACc,IAAI;AAC3Bd,QAAQ,CAACc,IAAI,GAAG,CAACC,MAAc,EAAEC,QAAiB,EAAEC,QAAkB,KAAK;EACzEJ,KAAK,CAACE,MAAM,EAAEC,QAAQ,EAAE,CAAC,CAACC,QAAQ,CAAC;EAEnCX,KAAK,CAACS,MAAM,CAAC,GAAG;IACdG,KAAK,EAAE,EAAE;IACTC,UAAU,EAAE;EACd,CAAC;AACH,CAAC;AAED,MAAMC,MAAM,GAAGpB,QAAQ,CAACqB,KAAK;AAC7BrB,QAAQ,CAACqB,KAAK,GAAIN,MAAc,IAAK;EACnCK,MAAM,CAACL,MAAM,CAAC;EACd,OAAOT,KAAK,CAACS,MAAM,CAAC;AACtB,CAAC;AAED,MAAMO,QAAQ,GAAGtB,QAAQ,CAACuB,OAAO;AACjCvB,QAAQ,CAACuB,OAAO,GAAG,CACjBR,MAAc,EACdS,KAAa,EACbC,MAA0B,KACV;EAChB,MAAMC,eAAe,GAAGD,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAEE,GAAG,CAAEC,CAAC,IAAK;IACzC,IAAIC,WAAW,CAACC,MAAM,CAACF,CAAC,CAAC,EAAE;MACzB,OAAOA,CAAC,CAACG,MAAM;IACjB;IAEA,OAAOH,CAAC;EACV,CAAC,CAAC;EAEF,MAAMxB,MAAM,GAAGkB,QAAQ,CAACP,MAAM,EAAES,KAAK,EAAEE,eAAe,CAAC;EACvDnB,kBAAkB,CAACH,MAAM,CAAC;EAC1B,OAAOA,MAAM;AACf,CAAC;AAED,MAAM4B,aAAa,GAAGhC,QAAQ,CAACiC,YAAY;AAC3CjC,QAAQ,CAACiC,YAAY,GAAG,OACtBlB,MAAc,EACdS,KAAa,EACbC,MAA0B,KACD;EACzB,MAAMC,eAAe,GAAGD,MAAM,aAANA,MAAM,uBAANA,MAAM,CAAEE,GAAG,CAAEC,CAAC,IAAK;IACzC,IAAIC,WAAW,CAACC,MAAM,CAACF,CAAC,CAAC,EAAE;MACzB,OAAOA,CAAC,CAACG,MAAM;IACjB;IAEA,OAAOH,CAAC;EACV,CAAC,CAAC;EAEF,MAAMM,GAAG,GAAG,MAAMF,aAAa,CAACjB,MAAM,EAAES,KAAK,EAAEE,eAAe,CAAC;EAC/DnB,kBAAkB,CAAC2B,GAAG,CAAC;EACvB,OAAOA,GAAG;AACZ,CAAC;AAEDlC,QAAQ,CAACmC,WAAW,GAAG,OACrBpB,MAAc,EACdqB,EAAsC,KACpB;EAClB,IAAI,CAAC9B,KAAK,CAACS,MAAM,CAAC,EAAE;IAClB,MAAMd,KAAK,CAAE,sCAAqCc,MAAO,EAAC,CAAC;EAC7D;EAEA,IAAIsB,WAAW,GAAG,KAAK;;EAEvB;EACA,MAAMd,OAAO,GAAG,CAACC,KAAa,EAAEC,MAAc,KAAkB;IAC9D,IAAIY,WAAW,EAAE;MACf,MAAMpC,KAAK,CACR,gEAA+Dc,MAAO,EAAC,CACzE;IACH;IACA,OAAOf,QAAQ,CAACuB,OAAO,CAACR,MAAM,EAAES,KAAK,EAAEC,MAAM,CAAC;EAChD,CAAC;EAED,MAAMQ,YAAY,GAAG,CAACT,KAAa,EAAEC,MAA0B,KAAK;IAClE,IAAIY,WAAW,EAAE;MACf,MAAMpC,KAAK,CACR,gEAA+Dc,MAAO,EAAC,CACzE;IACH;IACA,OAAOf,QAAQ,CAACiC,YAAY,CAAClB,MAAM,EAAES,KAAK,EAAEC,MAAM,CAAC;EACrD,CAAC;EAED,MAAMa,MAAM,GAAG,MAAM;IACnB,IAAID,WAAW,EAAE;MACf,MAAMpC,KAAK,CACR,iEAAgEc,MAAO,EAAC,CAC1E;IACH;IACA,MAAMX,MAAM,GAAGJ,QAAQ,CAACuB,OAAO,CAACR,MAAM,EAAE,QAAQ,CAAC;IACjDsB,WAAW,GAAG,IAAI;IAClB,OAAOjC,MAAM;EACf,CAAC;EAED,MAAMmC,QAAQ,GAAG,MAAM;IACrB,IAAIF,WAAW,EAAE;MACf,MAAMpC,KAAK,CACR,mEAAkEc,MAAO,EAAC,CAC5E;IACH;IACA,MAAMX,MAAM,GAAGJ,QAAQ,CAACuB,OAAO,CAACR,MAAM,EAAE,UAAU,CAAC;IACnDsB,WAAW,GAAG,IAAI;IAClB,OAAOjC,MAAM;EACf,CAAC;EAED,eAAeoC,GAAG,GAAG;IACnB,IAAI;MACF,MAAMxC,QAAQ,CAACiC,YAAY,CAAClB,MAAM,EAAE,mBAAmB,CAAC;MAExD,MAAMqB,EAAE,CAAC;QACPE,MAAM;QACNf,OAAO;QACPU,YAAY;QACZM;MACF,CAAC,CAAC;MAEF,IAAI,CAACF,WAAW,EAAE;QAChBC,MAAM,EAAE;MACV;IACF,CAAC,CAAC,OAAOG,cAAc,EAAE;MACvB,IAAI,CAACJ,WAAW,EAAE;QAChB,IAAI;UACFE,QAAQ,EAAE;QACZ,CAAC,CAAC,OAAOG,aAAa,EAAE;UACtB,MAAMA,aAAa;QACrB;MACF;MAEA,MAAMD,cAAc;IACtB,CAAC,SAAS;MACRnC,KAAK,CAACS,MAAM,CAAC,CAACI,UAAU,GAAG,KAAK;MAChCkB,WAAW,GAAG,KAAK;MACnBM,oBAAoB,CAAC5B,MAAM,CAAC;IAC9B;EACF;EAEA,OAAO,MAAM,IAAI6B,OAAO,CAAC,CAACC,OAAO,EAAEC,MAAM,KAAK;IAC5C,MAAMC,EAAsB,GAAG;MAC7BC,KAAK,EAAE,MAAM;QACXR,GAAG,EAAE,CAACS,IAAI,CAACJ,OAAO,CAAC,CAACK,KAAK,CAACJ,MAAM,CAAC;MACnC;IACF,CAAC;IAEDxC,KAAK,CAACS,MAAM,CAAC,CAACG,KAAK,CAACiC,IAAI,CAACJ,EAAE,CAAC;IAC5BJ,oBAAoB,CAAC5B,MAAM,CAAC;EAC9B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM4B,oBAAoB,GAAI5B,MAAc,IAAK;EAC/C,IAAI,CAACT,KAAK,CAACS,MAAM,CAAC,EAAE;IAClB,MAAMd,KAAK,CAAE,0BAAyBc,MAAO,EAAC,CAAC;EACjD;EAEA,IAAIT,KAAK,CAACS,MAAM,CAAC,CAACI,UAAU,EAAE;IAC5B;IACA;EACF;EAEA,IAAIb,KAAK,CAACS,MAAM,CAAC,CAACG,KAAK,CAACR,MAAM,EAAE;IAC9BJ,KAAK,CAACS,MAAM,CAAC,CAACI,UAAU,GAAG,IAAI;IAC/B,MAAM4B,EAAE,GAAGzC,KAAK,CAACS,MAAM,CAAC,CAACG,KAAK,CAACkC,KAAK,EAAE;IAEtC,IAAI,CAACL,EAAE,EAAE;MACP,MAAM,IAAI9C,KAAK,CAAC,uCAAuC,CAAC;IAC1D;IAEAoD,YAAY,CAAC,MAAM;MACjBN,EAAE,CAACC,KAAK,EAAE;IACZ,CAAC,CAAC;EACJ;AACF,CAAC;AAuBM,MAAMlC,IAAI,GAAIwC,OAIpB,IAAyB;EACxBtD,QAAQ,CAACc,IAAI,CAACwC,OAAO,CAACC,IAAI,EAAED,OAAO,CAACtC,QAAQ,EAAEsC,OAAO,CAACrC,QAAQ,CAAC;EAE/D,OAAO;IACLI,KAAK,EAAE,MAAMrB,QAAQ,CAACqB,KAAK,CAACiC,OAAO,CAACC,IAAI,CAAC;IACzCC,MAAM,EAAE,MAAMxD,QAAQ,CAACwD,MAAM,CAACF,OAAO,CAACC,IAAI,EAAED,OAAO,CAACtC,QAAQ,CAAC;IAC7DyC,MAAM,EAAE,CAACC,cAAsB,EAAEC,KAAa,EAAE3C,QAAiB,KAC/DhB,QAAQ,CAACyD,MAAM,CAACH,OAAO,CAACC,IAAI,EAAEG,cAAc,EAAEC,KAAK,EAAE3C,QAAQ,CAAC;IAChE4C,MAAM,EAAGD,KAAa,IAAK3D,QAAQ,CAAC4D,MAAM,CAACN,OAAO,CAACC,IAAI,EAAEI,KAAK,CAAC;IAC/DxB,WAAW,EAAGC,EAAsC,IAClDpC,QAAQ,CAACmC,WAAW,CAACmB,OAAO,CAACC,IAAI,EAAEnB,EAAE,CAAC;IACxCb,OAAO,EAAE,CAACC,KAAa,EAAEC,MAA0B,KACjDzB,QAAQ,CAACuB,OAAO,CAAC+B,OAAO,CAACC,IAAI,EAAE/B,KAAK,EAAEC,MAAM,CAAC;IAC/CQ,YAAY,EAAE,CACZT,KAAa,EACbC,MAA0B,KAE1BzB,QAAQ,CAACiC,YAAY,CAACqB,OAAO,CAACC,IAAI,EAAE/B,KAAK,EAAEC,MAAM,CAAC;IACpDoC,YAAY,EAAGC,QAAyB,IACtC9D,QAAQ,CAAC6D,YAAY,CAACP,OAAO,CAACC,IAAI,EAAEO,QAAQ,CAAC;IAC/CC,iBAAiB,EAAGD,QAAyB,IAC3C9D,QAAQ,CAAC+D,iBAAiB,CAACT,OAAO,CAACC,IAAI,EAAEO,QAAQ,CAAC;IACpDE,QAAQ,EAAGhD,QAAgB,IAAKhB,QAAQ,CAACgE,QAAQ,CAACV,OAAO,CAACC,IAAI,EAAEvC,QAAQ,CAAC;IACzEiD,UAAU,EAAGC,QAAQ,IAAKlE,QAAQ,CAACiE,UAAU,CAACX,OAAO,CAACC,IAAI,EAAEW,QAAQ;EACtE,CAAC;AACH,CAAC;AAAC"}

package/lib/module/index.js

@@ -198,7 +198,8 @@ export const open = options => {
     executeAsync: (query, params) => OPSQLite.executeAsync(options.name, query, params),
     executeBatch: commands => OPSQLite.executeBatch(options.name, commands),
     executeBatchAsync: commands => OPSQLite.executeBatchAsync(options.name, commands),
-    loadFile: location => OPSQLite.loadFile(options.name, location)
+    loadFile: location => OPSQLite.loadFile(options.name, location),
+    updateHook: callback => OPSQLite.updateHook(options.name, callback)
   };
 };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","global","__OPSQLiteProxy","OPSQLiteModule","OPSQLite","Error","nativeCallSyncHook","install","result","proxy","locks","enhanceQueryResult","rows","_array","length","item","idx","_open","open","dbName","location","inMemory","queue","inProgress","_close","close","_execute","execute","query","params","sanitizedParams","map","p","ArrayBuffer","isView","buffer","_executeAsync","executeAsync","res","transaction","fn","isFinalized","commit","rollback","run","executionError","rollbackError","startNextTransaction","Promise","resolve","reject","tx","start","then","catch","push","shift","setImmediate","options","name","delete","attach","dbNameToAttach","alias","detach","executeBatch","commands","executeBatchAsync","loadFile"],"sources":["index.ts"],"sourcesContent":["import { NativeModules } from 'react-native';\n\ndeclare global {\n  function nativeCallSyncHook(): unknown;\n  var __OPSQLiteProxy: object | undefined;\n}\n\nif (global.__OPSQLiteProxy == null) {\n  const OPSQLiteModule = NativeModules.OPSQLite;\n\n  if (OPSQLiteModule == null) {\n    throw new Error('Base module not found. Maybe try rebuilding the app.');\n  }\n\n  // Check if we are running on-device (JSI)\n  if (global.nativeCallSyncHook == null || OPSQLiteModule.install == null) {\n    throw new Error(\n      'Failed to install op-sqlite: React Native is not running on-device. OPSQLite can only be used when synchronous method invocations (JSI) are possible. If you are using a remote debugger (e.g. Chrome), switch to an on-device debugger (e.g. Flipper) instead.'\n    );\n  }\n\n  // Call the synchronous blocking install() function\n  const result = OPSQLiteModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Failed to install op-sqlite: The native OPSQLite Module could not be installed! Looks like something went wrong when installing JSI bindings: ${result}`\n    );\n  }\n\n  // Check again if the constructor now exists. If not, throw an error.\n  if (global.__OPSQLiteProxy == null) {\n    throw new Error(\n      'Failed to install op-sqlite, the native initializer function does not exist. Are you trying to use OPSQLite from different JS Runtimes?'\n    );\n  }\n}\n\nconst proxy = global.__OPSQLiteProxy;\nexport const OPSQLite = proxy as ISQLite;\n\n/**\n * Object returned by SQL Query executions {\n *  insertId: Represent the auto-generated row id if applicable\n *  rowsAffected: Number of affected rows if result of a update query\n *  message: if status === 1, here you will find error description\n *  rows: if status is undefined or 0 this object will contain the query results\n * }\n *\n * @interface QueryResult\n */\nexport type QueryResult = {\n  insertId?: number;\n  rowsAffected: number;\n  rows?: {\n    /** Raw array with all dataset */\n    _array: any[];\n    /** The lengh of the dataset */\n    length: number;\n    /** A convenience function to acess the index based the row object\n     * @param idx the row index\n     * @returns the row structure identified by column names\n     */\n    item: (idx: number) => any;\n  };\n  /**\n   * Query metadata, avaliable only for select query results\n   */\n  metadata?: ColumnMetadata[];\n};\n\n/**\n * Column metadata\n * Describes some information about columns fetched by the query\n */\nexport type ColumnMetadata = {\n  /** The name used for this column for this resultset */\n  name: string;\n  /** The declared column type for this column, when fetched directly from a table or a View resulting from a table column. \"UNKNOWN\" for dynamic values, like function returned ones. */\n  type: string;\n  /**\n   * The index for this column for this resultset*/\n  index: number;\n};\n\n/**\n * Allows the execution of bulk of sql commands\n * inside a transaction\n * If a single query must be executed many times with different arguments, its preferred\n * to declare it a single time, and use an array of array parameters.\n */\nexport type SQLBatchTuple = [string] | [string, Array<any> | Array<Array<any>>];\n\n/**\n * status: 0 or undefined for correct execution, 1 for error\n * message: if status === 1, here you will find error description\n * rowsAffected: Number of affected rows if status == 0\n */\nexport type BatchQueryResult = {\n  rowsAffected?: number;\n};\n\n/**\n * Result of loading a file and executing every line as a SQL command\n * Similar to BatchQueryResult\n */\nexport interface FileLoadResult extends BatchQueryResult {\n  commands?: number;\n}\n\nexport interface Transaction {\n  commit: () => QueryResult;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    query: string,\n    params?: any[] | undefined\n  ) => Promise<QueryResult>;\n  rollback: () => QueryResult;\n}\n\nexport interface PendingTransaction {\n  /*\n   * The start function should not throw or return a promise because the\n   * queue just calls it and does not monitor for failures or completions.\n   *\n   * It should catch any errors and call the resolve or reject of the wrapping\n   * promise when complete.\n   *\n   * It should also automatically commit or rollback the transaction if needed\n   */\n  start: () => void;\n}\n\ninterface ISQLite {\n  open: (dbName: string, location?: string, inMemory?: boolean) => void;\n  close: (dbName: string) => void;\n  delete: (dbName: string, location?: string) => void;\n  attach: (\n    mainDbName: string,\n    dbNameToAttach: string,\n    alias: string,\n    location?: string\n  ) => void;\n  detach: (mainDbName: string, alias: string) => void;\n  transaction: (\n    dbName: string,\n    fn: (tx: Transaction) => Promise<void>\n  ) => Promise<void>;\n  execute: (dbName: string, query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    dbName: string,\n    query: string,\n    params?: any[]\n  ) => Promise<QueryResult>;\n  executeBatch: (dbName: string, commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (\n    dbName: string,\n    commands: SQLBatchTuple[]\n  ) => Promise<BatchQueryResult>;\n  loadFile: (dbName: string, location: string) => Promise<FileLoadResult>;\n}\n\nconst locks: Record<\n  string,\n  { queue: PendingTransaction[]; inProgress: boolean }\n> = {};\n\n// Enhance some host functions\n\n// Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\nfunction enhanceQueryResult(result: QueryResult): void {\n  // Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\n  if (result.rows == null) {\n    result.rows = {\n      _array: [],\n      length: 0,\n      item: (idx: number) => result.rows?._array[idx],\n    };\n  } else {\n    result.rows.item = (idx: number) => result.rows?._array[idx];\n  }\n}\n\nconst _open = OPSQLite.open;\nOPSQLite.open = (dbName: string, location?: string, inMemory?: boolean) => {\n  _open(dbName, location, !!inMemory);\n\n  locks[dbName] = {\n    queue: [],\n    inProgress: false,\n  };\n};\n\nconst _close = OPSQLite.close;\nOPSQLite.close = (dbName: string) => {\n  _close(dbName);\n  delete locks[dbName];\n};\n\nconst _execute = OPSQLite.execute;\nOPSQLite.execute = (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): QueryResult => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const result = _execute(dbName, query, sanitizedParams);\n  enhanceQueryResult(result);\n  return result;\n};\n\nconst _executeAsync = OPSQLite.executeAsync;\nOPSQLite.executeAsync = async (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): Promise<QueryResult> => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const res = await _executeAsync(dbName, query, sanitizedParams);\n  enhanceQueryResult(res);\n  return res;\n};\n\nOPSQLite.transaction = async (\n  dbName: string,\n  fn: (tx: Transaction) => Promise<void>\n): Promise<void> => {\n  if (!locks[dbName]) {\n    throw Error(`SQLite Error: No lock found on db: ${dbName}`);\n  }\n\n  let isFinalized = false;\n\n  // Local transaction context object implementation\n  const execute = (query: string, params?: any[]): QueryResult => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.execute(dbName, query, params);\n  };\n\n  const executeAsync = (query: string, params?: any[] | undefined) => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.executeAsync(dbName, query, params);\n  };\n\n  const commit = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute commit on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'COMMIT');\n    isFinalized = true;\n    return result;\n  };\n\n  const rollback = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute rollback on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'ROLLBACK');\n    isFinalized = true;\n    return result;\n  };\n\n  async function run() {\n    try {\n      await OPSQLite.executeAsync(dbName, 'BEGIN TRANSACTION');\n\n      await fn({\n        commit,\n        execute,\n        executeAsync,\n        rollback,\n      });\n\n      if (!isFinalized) {\n        commit();\n      }\n    } catch (executionError) {\n      if (!isFinalized) {\n        try {\n          rollback();\n        } catch (rollbackError) {\n          throw rollbackError;\n        }\n      }\n\n      throw executionError;\n    } finally {\n      locks[dbName].inProgress = false;\n      isFinalized = false;\n      startNextTransaction(dbName);\n    }\n  }\n\n  return await new Promise((resolve, reject) => {\n    const tx: PendingTransaction = {\n      start: () => {\n        run().then(resolve).catch(reject);\n      },\n    };\n\n    locks[dbName].queue.push(tx);\n    startNextTransaction(dbName);\n  });\n};\n\nconst startNextTransaction = (dbName: string) => {\n  if (!locks[dbName]) {\n    throw Error(`Lock not found for db: ${dbName}`);\n  }\n\n  if (locks[dbName].inProgress) {\n    // Transaction is already in process bail out\n    return;\n  }\n\n  if (locks[dbName].queue.length) {\n    locks[dbName].inProgress = true;\n    const tx = locks[dbName].queue.shift();\n\n    if (!tx) {\n      throw new Error('Could not get a operation on datebase');\n    }\n\n    setImmediate(() => {\n      tx.start();\n    });\n  }\n};\n\nexport type OPSQLiteConnection = {\n  close: () => void;\n  delete: () => void;\n  attach: (dbNameToAttach: string, alias: string, location?: string) => void;\n  detach: (alias: string) => void;\n  transaction: (fn: (tx: Transaction) => Promise<void>) => Promise<void>;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (query: string, params?: any[]) => Promise<QueryResult>;\n  executeBatch: (commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (commands: SQLBatchTuple[]) => Promise<BatchQueryResult>;\n  loadFile: (location: string) => Promise<FileLoadResult>;\n};\n\nexport const open = (options: {\n  name: string;\n  location?: string;\n  inMemory?: boolean;\n}): OPSQLiteConnection => {\n  OPSQLite.open(options.name, options.location, options.inMemory);\n\n  return {\n    close: () => OPSQLite.close(options.name),\n    delete: () => OPSQLite.delete(options.name, options.location),\n    attach: (dbNameToAttach: string, alias: string, location?: string) =>\n      OPSQLite.attach(options.name, dbNameToAttach, alias, location),\n    detach: (alias: string) => OPSQLite.detach(options.name, alias),\n    transaction: (fn: (tx: Transaction) => Promise<void>) =>\n      OPSQLite.transaction(options.name, fn),\n    execute: (query: string, params?: any[] | undefined): QueryResult =>\n      OPSQLite.execute(options.name, query, params),\n    executeAsync: (\n      query: string,\n      params?: any[] | undefined\n    ): Promise<QueryResult> =>\n      OPSQLite.executeAsync(options.name, query, params),\n    executeBatch: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatch(options.name, commands),\n    executeBatchAsync: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatchAsync(options.name, commands),\n    loadFile: (location: string) => OPSQLite.loadFile(options.name, location),\n  };\n};\n"],"mappings":"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"}
+{"version":3,"names":["NativeModules","global","__OPSQLiteProxy","OPSQLiteModule","OPSQLite","Error","nativeCallSyncHook","install","result","proxy","locks","enhanceQueryResult","rows","_array","length","item","idx","_open","open","dbName","location","inMemory","queue","inProgress","_close","close","_execute","execute","query","params","sanitizedParams","map","p","ArrayBuffer","isView","buffer","_executeAsync","executeAsync","res","transaction","fn","isFinalized","commit","rollback","run","executionError","rollbackError","startNextTransaction","Promise","resolve","reject","tx","start","then","catch","push","shift","setImmediate","options","name","delete","attach","dbNameToAttach","alias","detach","executeBatch","commands","executeBatchAsync","loadFile","updateHook","callback"],"sources":["index.ts"],"sourcesContent":["import { NativeModules } from 'react-native';\n\ndeclare global {\n  function nativeCallSyncHook(): unknown;\n  var __OPSQLiteProxy: object | undefined;\n}\n\nif (global.__OPSQLiteProxy == null) {\n  const OPSQLiteModule = NativeModules.OPSQLite;\n\n  if (OPSQLiteModule == null) {\n    throw new Error('Base module not found. Maybe try rebuilding the app.');\n  }\n\n  // Check if we are running on-device (JSI)\n  if (global.nativeCallSyncHook == null || OPSQLiteModule.install == null) {\n    throw new Error(\n      'Failed to install op-sqlite: React Native is not running on-device. OPSQLite can only be used when synchronous method invocations (JSI) are possible. If you are using a remote debugger (e.g. Chrome), switch to an on-device debugger (e.g. Flipper) instead.'\n    );\n  }\n\n  // Call the synchronous blocking install() function\n  const result = OPSQLiteModule.install();\n  if (result !== true) {\n    throw new Error(\n      `Failed to install op-sqlite: The native OPSQLite Module could not be installed! Looks like something went wrong when installing JSI bindings: ${result}`\n    );\n  }\n\n  // Check again if the constructor now exists. If not, throw an error.\n  if (global.__OPSQLiteProxy == null) {\n    throw new Error(\n      'Failed to install op-sqlite, the native initializer function does not exist. Are you trying to use OPSQLite from different JS Runtimes?'\n    );\n  }\n}\n\nconst proxy = global.__OPSQLiteProxy;\nexport const OPSQLite = proxy as ISQLite;\n\n/**\n * Object returned by SQL Query executions {\n *  insertId: Represent the auto-generated row id if applicable\n *  rowsAffected: Number of affected rows if result of a update query\n *  message: if status === 1, here you will find error description\n *  rows: if status is undefined or 0 this object will contain the query results\n * }\n *\n * @interface QueryResult\n */\nexport type QueryResult = {\n  insertId?: number;\n  rowsAffected: number;\n  rows?: {\n    /** Raw array with all dataset */\n    _array: any[];\n    /** The lengh of the dataset */\n    length: number;\n    /** A convenience function to acess the index based the row object\n     * @param idx the row index\n     * @returns the row structure identified by column names\n     */\n    item: (idx: number) => any;\n  };\n  /**\n   * Query metadata, avaliable only for select query results\n   */\n  metadata?: ColumnMetadata[];\n};\n\n/**\n * Column metadata\n * Describes some information about columns fetched by the query\n */\nexport type ColumnMetadata = {\n  /** The name used for this column for this resultset */\n  name: string;\n  /** The declared column type for this column, when fetched directly from a table or a View resulting from a table column. \"UNKNOWN\" for dynamic values, like function returned ones. */\n  type: string;\n  /**\n   * The index for this column for this resultset*/\n  index: number;\n};\n\n/**\n * Allows the execution of bulk of sql commands\n * inside a transaction\n * If a single query must be executed many times with different arguments, its preferred\n * to declare it a single time, and use an array of array parameters.\n */\nexport type SQLBatchTuple = [string] | [string, Array<any> | Array<Array<any>>];\n\nexport type UpdateHookOperation = 'INSERT' | 'DELETE' | 'UPDATE';\n\n/**\n * status: 0 or undefined for correct execution, 1 for error\n * message: if status === 1, here you will find error description\n * rowsAffected: Number of affected rows if status == 0\n */\nexport type BatchQueryResult = {\n  rowsAffected?: number;\n};\n\n/**\n * Result of loading a file and executing every line as a SQL command\n * Similar to BatchQueryResult\n */\nexport interface FileLoadResult extends BatchQueryResult {\n  commands?: number;\n}\n\nexport interface Transaction {\n  commit: () => QueryResult;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    query: string,\n    params?: any[] | undefined\n  ) => Promise<QueryResult>;\n  rollback: () => QueryResult;\n}\n\nexport interface PendingTransaction {\n  /*\n   * The start function should not throw or return a promise because the\n   * queue just calls it and does not monitor for failures or completions.\n   *\n   * It should catch any errors and call the resolve or reject of the wrapping\n   * promise when complete.\n   *\n   * It should also automatically commit or rollback the transaction if needed\n   */\n  start: () => void;\n}\n\ninterface ISQLite {\n  open: (dbName: string, location?: string, inMemory?: boolean) => void;\n  close: (dbName: string) => void;\n  delete: (dbName: string, location?: string) => void;\n  attach: (\n    mainDbName: string,\n    dbNameToAttach: string,\n    alias: string,\n    location?: string\n  ) => void;\n  detach: (mainDbName: string, alias: string) => void;\n  transaction: (\n    dbName: string,\n    fn: (tx: Transaction) => Promise<void>\n  ) => Promise<void>;\n  execute: (dbName: string, query: string, params?: any[]) => QueryResult;\n  executeAsync: (\n    dbName: string,\n    query: string,\n    params?: any[]\n  ) => Promise<QueryResult>;\n  executeBatch: (dbName: string, commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (\n    dbName: string,\n    commands: SQLBatchTuple[]\n  ) => Promise<BatchQueryResult>;\n  loadFile: (dbName: string, location: string) => Promise<FileLoadResult>;\n  updateHook: (\n    dbName: string,\n    callback: (params: {\n      table: string;\n      operation: UpdateHookOperation;\n      row?: any;\n      rowId: number;\n    }) => void\n  ) => void;\n}\n\nconst locks: Record<\n  string,\n  { queue: PendingTransaction[]; inProgress: boolean }\n> = {};\n\n// Enhance some host functions\n\n// Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\nfunction enhanceQueryResult(result: QueryResult): void {\n  // Add 'item' function to result object to allow the sqlite-storage typeorm driver to work\n  if (result.rows == null) {\n    result.rows = {\n      _array: [],\n      length: 0,\n      item: (idx: number) => result.rows?._array[idx],\n    };\n  } else {\n    result.rows.item = (idx: number) => result.rows?._array[idx];\n  }\n}\n\nconst _open = OPSQLite.open;\nOPSQLite.open = (dbName: string, location?: string, inMemory?: boolean) => {\n  _open(dbName, location, !!inMemory);\n\n  locks[dbName] = {\n    queue: [],\n    inProgress: false,\n  };\n};\n\nconst _close = OPSQLite.close;\nOPSQLite.close = (dbName: string) => {\n  _close(dbName);\n  delete locks[dbName];\n};\n\nconst _execute = OPSQLite.execute;\nOPSQLite.execute = (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): QueryResult => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const result = _execute(dbName, query, sanitizedParams);\n  enhanceQueryResult(result);\n  return result;\n};\n\nconst _executeAsync = OPSQLite.executeAsync;\nOPSQLite.executeAsync = async (\n  dbName: string,\n  query: string,\n  params?: any[] | undefined\n): Promise<QueryResult> => {\n  const sanitizedParams = params?.map((p) => {\n    if (ArrayBuffer.isView(p)) {\n      return p.buffer;\n    }\n\n    return p;\n  });\n\n  const res = await _executeAsync(dbName, query, sanitizedParams);\n  enhanceQueryResult(res);\n  return res;\n};\n\nOPSQLite.transaction = async (\n  dbName: string,\n  fn: (tx: Transaction) => Promise<void>\n): Promise<void> => {\n  if (!locks[dbName]) {\n    throw Error(`SQLite Error: No lock found on db: ${dbName}`);\n  }\n\n  let isFinalized = false;\n\n  // Local transaction context object implementation\n  const execute = (query: string, params?: any[]): QueryResult => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.execute(dbName, query, params);\n  };\n\n  const executeAsync = (query: string, params?: any[] | undefined) => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute query on finalized transaction: ${dbName}`\n      );\n    }\n    return OPSQLite.executeAsync(dbName, query, params);\n  };\n\n  const commit = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute commit on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'COMMIT');\n    isFinalized = true;\n    return result;\n  };\n\n  const rollback = () => {\n    if (isFinalized) {\n      throw Error(\n        `SQLite Error: Cannot execute rollback on finalized transaction: ${dbName}`\n      );\n    }\n    const result = OPSQLite.execute(dbName, 'ROLLBACK');\n    isFinalized = true;\n    return result;\n  };\n\n  async function run() {\n    try {\n      await OPSQLite.executeAsync(dbName, 'BEGIN TRANSACTION');\n\n      await fn({\n        commit,\n        execute,\n        executeAsync,\n        rollback,\n      });\n\n      if (!isFinalized) {\n        commit();\n      }\n    } catch (executionError) {\n      if (!isFinalized) {\n        try {\n          rollback();\n        } catch (rollbackError) {\n          throw rollbackError;\n        }\n      }\n\n      throw executionError;\n    } finally {\n      locks[dbName].inProgress = false;\n      isFinalized = false;\n      startNextTransaction(dbName);\n    }\n  }\n\n  return await new Promise((resolve, reject) => {\n    const tx: PendingTransaction = {\n      start: () => {\n        run().then(resolve).catch(reject);\n      },\n    };\n\n    locks[dbName].queue.push(tx);\n    startNextTransaction(dbName);\n  });\n};\n\nconst startNextTransaction = (dbName: string) => {\n  if (!locks[dbName]) {\n    throw Error(`Lock not found for db: ${dbName}`);\n  }\n\n  if (locks[dbName].inProgress) {\n    // Transaction is already in process bail out\n    return;\n  }\n\n  if (locks[dbName].queue.length) {\n    locks[dbName].inProgress = true;\n    const tx = locks[dbName].queue.shift();\n\n    if (!tx) {\n      throw new Error('Could not get a operation on datebase');\n    }\n\n    setImmediate(() => {\n      tx.start();\n    });\n  }\n};\n\nexport type OPSQLiteConnection = {\n  close: () => void;\n  delete: () => void;\n  attach: (dbNameToAttach: string, alias: string, location?: string) => void;\n  detach: (alias: string) => void;\n  transaction: (fn: (tx: Transaction) => Promise<void>) => Promise<void>;\n  execute: (query: string, params?: any[]) => QueryResult;\n  executeAsync: (query: string, params?: any[]) => Promise<QueryResult>;\n  executeBatch: (commands: SQLBatchTuple[]) => BatchQueryResult;\n  executeBatchAsync: (commands: SQLBatchTuple[]) => Promise<BatchQueryResult>;\n  loadFile: (location: string) => Promise<FileLoadResult>;\n  updateHook: (\n    callback: (params: {\n      table: string;\n      operation: UpdateHookOperation;\n      row?: any;\n      rowId: number;\n    }) => void\n  ) => void;\n};\n\nexport const open = (options: {\n  name: string;\n  location?: string;\n  inMemory?: boolean;\n}): OPSQLiteConnection => {\n  OPSQLite.open(options.name, options.location, options.inMemory);\n\n  return {\n    close: () => OPSQLite.close(options.name),\n    delete: () => OPSQLite.delete(options.name, options.location),\n    attach: (dbNameToAttach: string, alias: string, location?: string) =>\n      OPSQLite.attach(options.name, dbNameToAttach, alias, location),\n    detach: (alias: string) => OPSQLite.detach(options.name, alias),\n    transaction: (fn: (tx: Transaction) => Promise<void>) =>\n      OPSQLite.transaction(options.name, fn),\n    execute: (query: string, params?: any[] | undefined): QueryResult =>\n      OPSQLite.execute(options.name, query, params),\n    executeAsync: (\n      query: string,\n      params?: any[] | undefined\n    ): Promise<QueryResult> =>\n      OPSQLite.executeAsync(options.name, query, params),\n    executeBatch: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatch(options.name, commands),\n    executeBatchAsync: (commands: SQLBatchTuple[]) =>\n      OPSQLite.executeBatchAsync(options.name, commands),\n    loadFile: (location: string) => OPSQLite.loadFile(options.name, location),\n    updateHook: (callback) => OPSQLite.updateHook(options.name, callback),\n  };\n};\n"],"mappings":"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"}

package/lib/typescript/index.d.ts

@@ -52,6 +52,7 @@ export type ColumnMetadata = {
  * to declare it a single time, and use an array of array parameters.
  */
 export type SQLBatchTuple = [string] | [string, Array<any> | Array<Array<any>>];
+export type UpdateHookOperation = 'INSERT' | 'DELETE' | 'UPDATE';
 /**
  * status: 0 or undefined for correct execution, 1 for error
  * message: if status === 1, here you will find error description
@@ -88,6 +89,12 @@ interface ISQLite {
     executeBatch: (dbName: string, commands: SQLBatchTuple[]) => BatchQueryResult;
     executeBatchAsync: (dbName: string, commands: SQLBatchTuple[]) => Promise<BatchQueryResult>;
     loadFile: (dbName: string, location: string) => Promise<FileLoadResult>;
+    updateHook: (dbName: string, callback: (params: {
+        table: string;
+        operation: UpdateHookOperation;
+        row?: any;
+        rowId: number;
+    }) => void) => void;
 }
 export type OPSQLiteConnection = {
     close: () => void;
@@ -100,6 +107,12 @@ export type OPSQLiteConnection = {
     executeBatch: (commands: SQLBatchTuple[]) => BatchQueryResult;
     executeBatchAsync: (commands: SQLBatchTuple[]) => Promise<BatchQueryResult>;
     loadFile: (location: string) => Promise<FileLoadResult>;
+    updateHook: (callback: (params: {
+        table: string;
+        operation: UpdateHookOperation;
+        row?: any;
+        rowId: number;
+    }) => void) => void;
 };
 export declare const open: (options: {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@op-engineering/op-sqlite",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Next generation SQLite for React Native",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/index.ts

@@ -90,6 +90,8 @@ export type ColumnMetadata = {
  */
 export type SQLBatchTuple = [string] | [string, Array<any> | Array<Array<any>>];
 
+export type UpdateHookOperation = 'INSERT' | 'DELETE' | 'UPDATE';
+
 /**
  * status: 0 or undefined for correct execution, 1 for error
  * message: if status === 1, here you will find error description
@@ -157,6 +159,15 @@ interface ISQLite {
     commands: SQLBatchTuple[]
   ) => Promise<BatchQueryResult>;
   loadFile: (dbName: string, location: string) => Promise<FileLoadResult>;
+  updateHook: (
+    dbName: string,
+    callback: (params: {
+      table: string;
+      operation: UpdateHookOperation;
+      row?: any;
+      rowId: number;
+    }) => void
+  ) => void;
 }
 
 const locks: Record<
@@ -363,6 +374,14 @@ export type OPSQLiteConnection = {
   executeBatch: (commands: SQLBatchTuple[]) => BatchQueryResult;
   executeBatchAsync: (commands: SQLBatchTuple[]) => Promise<BatchQueryResult>;
   loadFile: (location: string) => Promise<FileLoadResult>;
+  updateHook: (
+    callback: (params: {
+      table: string;
+      operation: UpdateHookOperation;
+      row?: any;
+      rowId: number;
+    }) => void
+  ) => void;
 };
 
 export const open = (options: {
@@ -392,5 +411,6 @@ export const open = (options: {
     executeBatchAsync: (commands: SQLBatchTuple[]) =>
       OPSQLite.executeBatchAsync(options.name, commands),
     loadFile: (location: string) => OPSQLite.loadFile(options.name, location),
+    updateHook: (callback) => OPSQLite.updateHook(options.name, callback),
   };
 };