react-native-nitro-sqlite 9.8.1 → 10.0.0

package/lib/module/operations/session.js

@@ -4,59 +4,135 @@ import { HybridNitroSQLite } from "../nitro.js";
 import { transaction } from "./transaction.js";
 import { executeAsyncManaged, executeManaged } from "./execute.js";
 import { executeBatch, executeBatchAsync } from "./executeBatch.js";
+import { prepare } from "./prepare.js";
 import NitroSQLiteError from "../NitroSQLiteError.js";
-import { closeDatabaseQueue, isDatabaseOpen, openDatabaseQueue, queueOperationAsync, startOperationSync } from "../DatabaseQueue.js";
+import { closeDatabaseQueue, getDatabaseQueue, isDatabaseOpen, openDatabaseQueue, queueStatementAsync, startOperationSync } from "../DatabaseQueue.js";
+/**
+ * Open a database and return a managed connection. The default connection is
+ * addressed by its name, and opening it twice throws. Set `connection` to
+ * `'independent'` to open another native handle to the same file. Async calls
+ * on each connection run in call order.
+ * @param options Database name, optional directory, connection mode, and read-only setting.
+ * @returns A connection bound to the opened native handle.
+ */
 export function open(options) {
-  openDatabaseQueue(options.name);
-  try {
-    HybridNitroSQLite.open(options.name, options.location);
-  } catch (error) {
-    closeDatabaseQueue(options.name);
-    throw NitroSQLiteError.fromError(error);
-  }
+  const {
+    name,
+    location: databaseLocation,
+    connection,
+    readOnly
+  } = options;
+  const {
+    connectionId,
+    queueKey
+  } = openNativeConnection(options);
+  const connectionQueue = getDatabaseQueue(queueKey);
+  const assertCurrentConnection = () => {
+    if (!isDatabaseOpen(queueKey) || getDatabaseQueue(queueKey) !== connectionQueue) {
+      throw new NitroSQLiteError(`Database ${name} is not open. There is no connection to the database.`);
+    }
+  };
+  const assertNoReplacement = () => {
+    if (isDatabaseOpen(queueKey) && getDatabaseQueue(queueKey) !== connectionQueue) {
+      throw new NitroSQLiteError(`Database ${name} has been reopened with another connection.`);
+    }
+  };
+  const runSyncOperation = callback => {
+    try {
+      assertCurrentConnection();
+      return startOperationSync(queueKey, callback);
+    } catch (error) {
+      throw NitroSQLiteError.fromError(error);
+    }
+  };
+  const runOperation = callback => {
+    assertCurrentConnection();
+    return callback();
+  };
   return {
     close: () => {
-      try {
-        startOperationSync(options.name, () => HybridNitroSQLite.close(options.name));
-        closeDatabaseQueue(options.name);
-      } catch (error) {
-        throw NitroSQLiteError.fromError(error);
-      }
+      runSyncOperation(() => HybridNitroSQLite.close(connectionId));
+      closeDatabaseQueue(queueKey);
     },
     delete: () => {
+      if (readOnly) {
+        throw new NitroSQLiteError(`Cannot delete read-only database ${name}.`);
+      }
+      let dropFailed = false;
       try {
-        if (!isDatabaseOpen(options.name)) {
-          HybridNitroSQLite.drop(options.name, options.location);
+        assertNoReplacement();
+        const drop = () => {
+          try {
+            if (connection === 'independent') {
+              HybridNitroSQLite.drop(name, databaseLocation, connectionId);
+            } else {
+              HybridNitroSQLite.drop(name, databaseLocation);
+            }
+          } catch (error) {
+            dropFailed = true;
+            throw error;
+          }
+        };
+        if (!isDatabaseOpen(queueKey)) {
+          drop();
           return;
         }
-        startOperationSync(options.name, () => HybridNitroSQLite.drop(options.name, options.location));
-        closeDatabaseQueue(options.name);
+        startOperationSync(queueKey, drop);
+        closeDatabaseQueue(queueKey);
       } catch (error) {
+        if (dropFailed && isDatabaseOpen(queueKey) && getDatabaseQueue(queueKey) === connectionQueue && !HybridNitroSQLite.isConnectionOpen(connectionId)) {
+          closeDatabaseQueue(queueKey);
+        }
         throw NitroSQLiteError.fromError(error);
       }
     },
-    attach: (dbNameToAttach, alias, location) => runSyncOperation(options.name, () => HybridNitroSQLite.attach(options.name, dbNameToAttach, alias, location)),
-    detach: alias => runSyncOperation(options.name, () => HybridNitroSQLite.detach(options.name, alias)),
-    transaction: fn => transaction(options.name, fn),
-    execute: (query, params) => executeManaged(options.name, query, params),
-    executeAsync: (query, params) => executeAsyncManaged(options.name, query, params),
-    executeBatch: commands => executeBatch(options.name, commands),
-    executeBatchAsync: commands => executeBatchAsync(options.name, commands),
-    loadFile: location => runSyncOperation(options.name, () => HybridNitroSQLite.loadFile(options.name, location)),
-    loadFileAsync: location => queueOperationAsync(options.name, async () => {
+    attach: (dbNameToAttach, alias, location) => runSyncOperation(() => HybridNitroSQLite.attach(connectionId, dbNameToAttach, alias, location)),
+    detach: alias => runSyncOperation(() => HybridNitroSQLite.detach(connectionId, alias)),
+    transaction: async fn => runOperation(() => transaction(connectionId, fn, false, queueKey)),
+    execute: (query, params) => runOperation(() => executeManaged(connectionId, query, params, queueKey)),
+    executeAsync: async (query, params) => runOperation(() => executeAsyncManaged(connectionId, query, params, queueKey)),
+    prepare: query => runOperation(() => prepare(connectionId, query, queueKey)),
+    executeBatch: commands => runOperation(() => executeBatch(connectionId, commands, queueKey)),
+    executeBatchAsync: async commands => runOperation(() => executeBatchAsync(connectionId, commands, queueKey)),
+    loadFile: location => runSyncOperation(() => HybridNitroSQLite.loadFile(connectionId, location)),
+    loadFileAsync: location => runOperation(() => queueStatementAsync(queueKey, async () => {
       try {
-        return await HybridNitroSQLite.loadFileAsync(options.name, location);
+        return await HybridNitroSQLite.loadFileAsync(connectionId, location);
       } catch (error) {
         throw NitroSQLiteError.fromError(error);
       }
-    })
+    }))
   };
 }
-function runSyncOperation(dbName, callback) {
+function openNativeConnection(options) {
+  if (options.connection === 'independent') {
+    let connectionId;
+    try {
+      connectionId = options.readOnly ? HybridNitroSQLite.openConnection(options.name, options.location, true) : HybridNitroSQLite.openConnection(options.name, options.location);
+      const queueKey = Symbol(options.name);
+      openDatabaseQueue(queueKey);
+      return {
+        connectionId,
+        queueKey
+      };
+    } catch (error) {
+      throw NitroSQLiteError.fromError(error);
+    }
+  }
+  openDatabaseQueue(options.name);
   try {
-    return startOperationSync(dbName, callback);
+    if (options.readOnly) {
+      HybridNitroSQLite.open(options.name, options.location, true);
+    } else {
+      HybridNitroSQLite.open(options.name, options.location);
+    }
   } catch (error) {
+    closeDatabaseQueue(options.name);
     throw NitroSQLiteError.fromError(error);
   }
+  return {
+    connectionId: options.name,
+    queueKey: options.name
+  };
 }
 //# sourceMappingURL=session.js.map

package/lib/module/operations/session.js.map

@@ -1 +1 @@
-{"version":3,"names":["HybridNitroSQLite","transaction","executeAsyncManaged","executeManaged","executeBatch","executeBatchAsync","NitroSQLiteError","closeDatabaseQueue","isDatabaseOpen","openDatabaseQueue","queueOperationAsync","startOperationSync","open","options","name","location","error","fromError","close","delete","drop","attach","dbNameToAttach","alias","runSyncOperation","detach","fn","execute","query","params","executeAsync","commands","loadFile","loadFileAsync","dbName","callback"],"sourceRoot":"../../../src","sources":["operations/session.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,aAAU;AAC5C,SAASC,WAAW,QAAQ,kBAAe;AAU3C,SAASC,mBAAmB,EAAEC,cAAc,QAAQ,cAAW;AAC/D,SAASC,YAAY,EAAEC,iBAAiB,QAAQ,mBAAgB;AAChE,OAAOC,gBAAgB,MAAM,wBAAqB;AAClD,SACEC,kBAAkB,EAClBC,cAAc,EACdC,iBAAiB,EACjBC,mBAAmB,EACnBC,kBAAkB,QACb,qBAAkB;AAEzB,OAAO,SAASC,IAAIA,CAClBC,OAAqC,EACd;EACvBJ,iBAAiB,CAACI,OAAO,CAACC,IAAI,CAAC;EAE/B,IAAI;IACFd,iBAAiB,CAACY,IAAI,CAACC,OAAO,CAACC,IAAI,EAAED,OAAO,CAACE,QAAQ,CAAC;EACxD,CAAC,CAAC,OAAOC,KAAK,EAAE;IACdT,kBAAkB,CAACM,OAAO,CAACC,IAAI,CAAC;IAChC,MAAMR,gBAAgB,CAACW,SAAS,CAACD,KAAK,CAAC;EACzC;EAEA,OAAO;IACLE,KAAK,EAAEA,CAAA,KAAM;MACX,IAAI;QACFP,kBAAkB,CAACE,OAAO,CAACC,IAAI,EAAE,MAC/Bd,iBAAiB,CAACkB,KAAK,CAACL,OAAO,CAACC,IAAI,CACtC,CAAC;QACDP,kBAAkB,CAACM,OAAO,CAACC,IAAI,CAAC;MAClC,CAAC,CAAC,OAAOE,KAAK,EAAE;QACd,MAAMV,gBAAgB,CAACW,SAAS,CAACD,KAAK,CAAC;MACzC;IACF,CAAC;IACDG,MAAM,EAAEA,CAAA,KAAM;MACZ,IAAI;QACF,IAAI,CAACX,cAAc,CAACK,OAAO,CAACC,IAAI,CAAC,EAAE;UACjCd,iBAAiB,CAACoB,IAAI,CAACP,OAAO,CAACC,IAAI,EAAED,OAAO,CAACE,QAAQ,CAAC;UACtD;QACF;QAEAJ,kBAAkB,CAACE,OAAO,CAACC,IAAI,EAAE,MAC/Bd,iBAAiB,CAACoB,IAAI,CAACP,OAAO,CAACC,IAAI,EAAED,OAAO,CAACE,QAAQ,CACvD,CAAC;QACDR,kBAAkB,CAACM,OAAO,CAACC,IAAI,CAAC;MAClC,CAAC,CAAC,OAAOE,KAAK,EAAE;QACd,MAAMV,gBAAgB,CAACW,SAAS,CAACD,KAAK,CAAC;MACzC;IACF,CAAC;IACDK,MAAM,EAAEA,CAACC,cAAsB,EAAEC,KAAa,EAAER,QAAiB,KAC/DS,gBAAgB,CAACX,OAAO,CAACC,IAAI,EAAE,MAC7Bd,iBAAiB,CAACqB,MAAM,CAACR,OAAO,CAACC,IAAI,EAAEQ,cAAc,EAAEC,KAAK,EAAER,QAAQ,CACxE,CAAC;IACHU,MAAM,EAAGF,KAAa,IACpBC,gBAAgB,CAACX,OAAO,CAACC,IAAI,EAAE,MAC7Bd,iBAAiB,CAACyB,MAAM,CAACZ,OAAO,CAACC,IAAI,EAAES,KAAK,CAC9C,CAAC;IACHtB,WAAW,EAAkByB,EAAwC,IACnEzB,WAAW,CAACY,OAAO,CAACC,IAAI,EAAEY,EAAE,CAAC;IAC/BC,OAAO,EAAEA,CACPC,KAAa,EACbC,MAA0B,KACL1B,cAAc,CAACU,OAAO,CAACC,IAAI,EAAEc,KAAK,EAAEC,MAAM,CAAC;IAClEC,YAAY,EAAEA,CACZF,KAAa,EACbC,MAA0B,KAE1B3B,mBAAmB,CAACW,OAAO,CAACC,IAAI,EAAEc,KAAK,EAAEC,MAAM,CAAC;IAClDzB,YAAY,EAAG2B,QAA6B,IAC1C3B,YAAY,CAACS,OAAO,CAACC,IAAI,EAAEiB,QAAQ,CAAC;IACtC1B,iBAAiB,EAAG0B,QAA6B,IAC/C1B,iBAAiB,CAACQ,OAAO,CAACC,IAAI,EAAEiB,QAAQ,CAAC;IAC3CC,QAAQ,EAAGjB,QAAgB,IACzBS,gBAAgB,CAACX,OAAO,CAACC,IAAI,EAAE,MAC7Bd,iBAAiB,CAACgC,QAAQ,CAACnB,OAAO,CAACC,IAAI,EAAEC,QAAQ,CACnD,CAAC;IACHkB,aAAa,EAAGlB,QAAgB,IAC9BL,mBAAmB,CAACG,OAAO,CAACC,IAAI,EAAE,YAAY;MAC5C,IAAI;QACF,OAAO,MAAMd,iBAAiB,CAACiC,aAAa,CAACpB,OAAO,CAACC,IAAI,EAAEC,QAAQ,CAAC;MACtE,CAAC,CAAC,OAAOC,KAAK,EAAE;QACd,MAAMV,gBAAgB,CAACW,SAAS,CAACD,KAAK,CAAC;MACzC;IACF,CAAC;EACL,CAAC;AACH;AAEA,SAASQ,gBAAgBA,CAASU,MAAc,EAAEC,QAAsB,EAAE;EACxE,IAAI;IACF,OAAOxB,kBAAkB,CAACuB,MAAM,EAAEC,QAAQ,CAAC;EAC7C,CAAC,CAAC,OAAOnB,KAAK,EAAE;IACd,MAAMV,gBAAgB,CAACW,SAAS,CAACD,KAAK,CAAC;EACzC;AACF","ignoreList":[]}
+{"version":3,"names":["HybridNitroSQLite","transaction","executeAsyncManaged","executeManaged","executeBatch","executeBatchAsync","prepare","NitroSQLiteError","closeDatabaseQueue","getDatabaseQueue","isDatabaseOpen","openDatabaseQueue","queueStatementAsync","startOperationSync","open","options","name","location","databaseLocation","connection","readOnly","connectionId","queueKey","openNativeConnection","connectionQueue","assertCurrentConnection","assertNoReplacement","runSyncOperation","callback","error","fromError","runOperation","close","delete","dropFailed","drop","isConnectionOpen","attach","dbNameToAttach","alias","detach","fn","execute","query","params","executeAsync","commands","loadFile","loadFileAsync","openConnection","Symbol"],"sourceRoot":"../../../src","sources":["operations/session.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/operations/transaction.js

@@ -3,25 +3,45 @@
 import { queueOperationAsync, throwIfDatabaseIsNotOpen } from "../DatabaseQueue.js";
 import { executeAsyncNative, executeNative } from "./execute.js";
 import NitroSQLiteError from "../NitroSQLiteError.js";
-export const transaction = async (dbName, transactionCallback, isExclusive = false) => {
-  throwIfDatabaseIsNotOpen(dbName);
+/** Queue a transaction for an open managed connection.
+ * Use only the supplied `tx` for work on this database inside the callback.
+ * A successful callback commits unless it explicitly committed or rolled back;
+ * a thrown error rolls back unless the transaction was already finalized.
+ * @param dbName Name of the open database.
+ * @param transactionCallback Async callback receiving the transaction handle.
+ * @param isExclusive Begin an exclusive transaction when true.
+ * @returns The callback's result after the transaction finishes.
+ */
+export const transaction = async (dbName, transactionCallback, isExclusive = false, queueKey = dbName) => {
+  throwIfDatabaseIsNotOpen(queueKey);
   let isFinished = false;
+  const pendingAsyncStatements = new Set();
+  const throwIfAsyncPending = () => {
+    if (pendingAsyncStatements.size > 0) {
+      throw new NitroSQLiteError(`Cannot run synchronous operation on transaction ${dbName} while async queries are pending. Await all tx.executeAsync calls first.`);
+    }
+  };
   const executeOnTransaction = (query, params) => {
     if (isFinished) {
       throw new NitroSQLiteError(`Cannot execute query on finalized transaction: ${dbName}`);
     }
+    throwIfAsyncPending();
     return executeNative(dbName, query, params);
   };
   const executeAsyncOnTransaction = (query, params) => {
     if (isFinished) {
       throw new NitroSQLiteError(`Cannot execute query on finalized transaction: ${dbName}`);
     }
-    return executeAsyncNative(dbName, query, params);
+    const pending = executeAsyncNative(dbName, query, params);
+    pendingAsyncStatements.add(pending);
+    pending.then(() => pendingAsyncStatements.delete(pending), () => pendingAsyncStatements.delete(pending));
+    return pending;
   };
   const commit = () => {
     if (isFinished) {
       throw new NitroSQLiteError(`Cannot execute commit on finalized transaction: ${dbName}`);
     }
+    throwIfAsyncPending();
     isFinished = true;
     return executeNative(dbName, 'COMMIT');
   };
@@ -29,10 +49,11 @@ export const transaction = async (dbName, transactionCallback, isExclusive = fal
     if (isFinished) {
       throw new NitroSQLiteError(`Cannot execute rollback on finalized transaction: ${dbName}`);
     }
+    throwIfAsyncPending();
     isFinished = true;
     return executeNative(dbName, 'ROLLBACK');
   };
-  return await queueOperationAsync(dbName, async () => {
+  return await queueOperationAsync(queueKey, async () => {
     try {
       await executeAsyncNative(dbName, isExclusive ? 'BEGIN EXCLUSIVE TRANSACTION' : 'BEGIN TRANSACTION');
       const result = await transactionCallback({
@@ -45,8 +66,12 @@ export const transaction = async (dbName, transactionCallback, isExclusive = fal
       return result;
     } catch (executionError) {
       if (!isFinished) {
+        isFinished = true;
+        // All queued native calls must finish before ROLLBACK can run
+        // synchronously on this connection.
+        await Promise.allSettled(pendingAsyncStatements);
         try {
-          rollback();
+          executeNative(dbName, 'ROLLBACK');
         } catch (rollbackError) {
           throw NitroSQLiteError.fromError(rollbackError);
         }

package/lib/module/operations/transaction.js.map

@@ -1 +1 @@
-{"version":3,"names":["queueOperationAsync","throwIfDatabaseIsNotOpen","executeAsyncNative","executeNative","NitroSQLiteError","transaction","dbName","transactionCallback","isExclusive","isFinished","executeOnTransaction","query","params","executeAsyncOnTransaction","commit","rollback","result","execute","executeAsync","executionError","rollbackError","fromError"],"sourceRoot":"../../../src","sources":["operations/transaction.ts"],"mappings":";;AAAA,SAASA,mBAAmB,EAAEC,wBAAwB,QAAQ,qBAAkB;AAOhF,SAASC,kBAAkB,EAAEC,aAAa,QAAQ,cAAW;AAC7D,OAAOC,gBAAgB,MAAM,wBAAqB;AAElD,OAAO,MAAMC,WAAW,GAAG,MAAAA,CACzBC,MAAc,EACdC,mBAAyD,EACzDC,WAAW,GAAG,KAAK,KAChB;EACHP,wBAAwB,CAACK,MAAM,CAAC;EAEhC,IAAIG,UAAU,GAAG,KAAK;EAEtB,MAAMC,oBAAoB,GAAGA,CAC3BC,KAAa,EACbC,MAA0B,KACL;IACrB,IAAIH,UAAU,EAAE;MACd,MAAM,IAAIL,gBAAgB,CACxB,kDAAkDE,MAAM,EAC1D,CAAC;IACH;IACA,OAAOH,aAAa,CAACG,MAAM,EAAEK,KAAK,EAAEC,MAAM,CAAC;EAC7C,CAAC;EAED,MAAMC,yBAAyB,GAAGA,CAChCF,KAAa,EACbC,MAA0B,KACI;IAC9B,IAAIH,UAAU,EAAE;MACd,MAAM,IAAIL,gBAAgB,CACxB,kDAAkDE,MAAM,EAC1D,CAAC;IACH;IACA,OAAOJ,kBAAkB,CAACI,MAAM,EAAEK,KAAK,EAAEC,MAAM,CAAC;EAClD,CAAC;EAED,MAAME,MAAM,GAAGA,CAAA,KAAM;IACnB,IAAIL,UAAU,EAAE;MACd,MAAM,IAAIL,gBAAgB,CACxB,mDAAmDE,MAAM,EAC3D,CAAC;IACH;IACAG,UAAU,GAAG,IAAI;IACjB,OAAON,aAAa,CAACG,MAAM,EAAE,QAAQ,CAAC;EACxC,CAAC;EAED,MAAMS,QAAQ,GAAGA,CAAA,KAAM;IACrB,IAAIN,UAAU,EAAE;MACd,MAAM,IAAIL,gBAAgB,CACxB,qDAAqDE,MAAM,EAC7D,CAAC;IACH;IACAG,UAAU,GAAG,IAAI;IACjB,OAAON,aAAa,CAACG,MAAM,EAAE,UAAU,CAAC;EAC1C,CAAC;EAED,OAAO,MAAMN,mBAAmB,CAACM,MAAM,EAAE,YAAY;IACnD,IAAI;MACF,MAAMJ,kBAAkB,CACtBI,MAAM,EACNE,WAAW,GAAG,6BAA6B,GAAG,mBAChD,CAAC;MAED,MAAMQ,MAAM,GAAG,MAAMT,mBAAmB,CAAC;QACvCO,MAAM;QACNG,OAAO,EAAEP,oBAAoB;QAC7BQ,YAAY,EAAEL,yBAAyB;QACvCE;MACF,CAAC,CAAC;MAEF,IAAI,CAACN,UAAU,EAAEK,MAAM,CAAC,CAAC;MAEzB,OAAOE,MAAM;IACf,CAAC,CAAC,OAAOG,cAAc,EAAE;MACvB,IAAI,CAACV,UAAU,EAAE;QACf,IAAI;UACFM,QAAQ,CAAC,CAAC;QACZ,CAAC,CAAC,OAAOK,aAAa,EAAE;UACtB,MAAMhB,gBAAgB,CAACiB,SAAS,CAACD,aAAa,CAAC;QACjD;MACF;MAEA,MAAMhB,gBAAgB,CAACiB,SAAS,CAACF,cAAc,CAAC;IAClD;EACF,CAAC,CAAC;AACJ,CAAC","ignoreList":[]}
+{"version":3,"names":["queueOperationAsync","throwIfDatabaseIsNotOpen","executeAsyncNative","executeNative","NitroSQLiteError","transaction","dbName","transactionCallback","isExclusive","queueKey","isFinished","pendingAsyncStatements","Set","throwIfAsyncPending","size","executeOnTransaction","query","params","executeAsyncOnTransaction","pending","add","then","delete","commit","rollback","result","execute","executeAsync","executionError","Promise","allSettled","rollbackError","fromError"],"sourceRoot":"../../../src","sources":["operations/transaction.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/specs/NitroSQLitePreparedStatement.nitro.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=NitroSQLitePreparedStatement.nitro.js.map

package/lib/module/specs/NitroSQLitePreparedStatement.nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["specs/NitroSQLitePreparedStatement.nitro.ts"],"mappings":"","ignoreList":[]}

package/lib/module/typeORM.js

@@ -8,11 +8,19 @@
 //     |_|     |_|  |_|    |______\____/|_|  \_\_|  |_| /_/    \_\_|   |_____|
 
 import * as Operations from "./operations/session.js";
-/**
- * DO NOT USE THIS! THIS IS MEANT FOR TYPEORM
- * If you are looking for a convenience wrapper use `connect`
+
+/** Callback-oriented connection returned to TypeORM. */
+
+/** Adapter for TypeORM's React Native driver. Application code should use `open()`.
+ * `openDatabase` reports success or failure through callbacks and returns the
+ * connection on success, or `null` when opening fails.
  */
 export const typeORMDriver = {
+  /** Open a database for TypeORM.
+   * @param options Database name and optional relative directory.
+   * @param ok Receives the adapter connection on success.
+   * @param fail Receives the opening error on failure.
+   */
   openDatabase: (options, ok, fail) => {
     try {
       const db = Operations.open(options);

package/lib/module/typeORM.js.map

@@ -1 +1 @@
-{"version":3,"names":["Operations","typeORMDriver","openDatabase","options","ok","fail","db","open","connection","executeSql","sql","params","okExecute","failExecute","result","executeAsync","e","transaction","fn","close","okClose","failClose","attach","dbNameToAttach","alias","location","callback","detach"],"sourceRoot":"../../src","sources":["typeORM.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAQA,OAAO,KAAKA,UAAU,MAAM,yBAAsB;AAoBlD;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,GAAG;EAC3BC,YAAY,EAAEA,CACZC,OAGC,EACDC,EAA8C,EAC9CC,IAA2B,KACa;IACxC,IAAI;MACF,MAAMC,EAAE,GAAGN,UAAU,CAACO,IAAI,CAACJ,OAAO,CAAC;MAEnC,MAAMK,UAAwC,GAAG;QAC/CC,UAAU,EAAE,MAAAA,CACVC,GAAW,EACXC,MAAqC,EACrCC,SAA8C,EAC9CC,WAAkC,KAC/B;UACH,IAAI;YACF,MAAMC,MAAM,GAAG,MAAMR,EAAE,CAACS,YAAY,CAAUL,GAAG,EAAEC,MAAM,CAAC;YAC1DC,SAAS,CAACE,MAAM,CAAC;UACnB,CAAC,CAAC,OAAOE,CAAU,EAAE;YACnBH,WAAW,CAACG,CAAW,CAAC;UAC1B;QACF,CAAC;QACDC,WAAW,EACTC,EAAsC,IACpB;UAClB,OAAOZ,EAAE,CAACW,WAAW,CAACC,EAAE,CAAC;QAC3B,CAAC;QACDC,KAAK,EAAEA,CAACC,OAAmB,EAAEC,SAA+B,KAAK;UAC/D,IAAI;YACFf,EAAE,CAACa,KAAK,CAAC,CAAC;YACVC,OAAO,CAAC,CAAC;UACX,CAAC,CAAC,OAAOJ,CAAC,EAAE;YACVK,SAAS,CAACL,CAAC,CAAC;UACd;QACF,CAAC;QACDM,MAAM,EAAEA,CACNC,cAAsB,EACtBC,KAAa,EACbC,QAA4B,EAC5BC,QAAoB,KACjB;UACHpB,EAAE,CAACgB,MAAM,CAACC,cAAc,EAAEC,KAAK,EAAEC,QAAQ,CAAC;UAC1CC,QAAQ,CAAC,CAAC;QACZ,CAAC;QACDC,MAAM,EAAEA,CAACH,KAAa,EAAEE,QAAoB,KAAK;UAC/CpB,EAAE,CAACqB,MAAM,CAACH,KAAK,CAAC;UAChBE,QAAQ,CAAC,CAAC;QACZ;MACF,CAAC;MAEDtB,EAAE,CAACI,UAAU,CAAC;MAEd,OAAOA,UAAU;IACnB,CAAC,CAAC,OAAOQ,CAAU,EAAE;MACnBX,IAAI,CAACW,CAAW,CAAC;MAEjB,OAAO,IAAI;IACb;EACF;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["Operations","typeORMDriver","openDatabase","options","ok","fail","db","open","connection","executeSql","sql","params","okExecute","failExecute","result","executeAsync","e","transaction","fn","close","okClose","failClose","attach","dbNameToAttach","alias","location","callback","detach"],"sourceRoot":"../../src","sources":["typeORM.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAQA,OAAO,KAAKA,UAAU,MAAM,yBAAsB;;AAElD;;AAwBA;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,GAAG;EAC3B;AACF;AACA;AACA;AACA;EACEC,YAAY,EAAEA,CACZC,OAGC,EACDC,EAA8C,EAC9CC,IAA2B,KACa;IACxC,IAAI;MACF,MAAMC,EAAE,GAAGN,UAAU,CAACO,IAAI,CAACJ,OAAO,CAAC;MAEnC,MAAMK,UAAwC,GAAG;QAC/CC,UAAU,EAAE,MAAAA,CACVC,GAAW,EACXC,MAAqC,EACrCC,SAA8C,EAC9CC,WAAkC,KAC/B;UACH,IAAI;YACF,MAAMC,MAAM,GAAG,MAAMR,EAAE,CAACS,YAAY,CAAUL,GAAG,EAAEC,MAAM,CAAC;YAC1DC,SAAS,CAACE,MAAM,CAAC;UACnB,CAAC,CAAC,OAAOE,CAAU,EAAE;YACnBH,WAAW,CAACG,CAAW,CAAC;UAC1B;QACF,CAAC;QACDC,WAAW,EACTC,EAAsC,IACpB;UAClB,OAAOZ,EAAE,CAACW,WAAW,CAACC,EAAE,CAAC;QAC3B,CAAC;QACDC,KAAK,EAAEA,CAACC,OAAmB,EAAEC,SAA+B,KAAK;UAC/D,IAAI;YACFf,EAAE,CAACa,KAAK,CAAC,CAAC;YACVC,OAAO,CAAC,CAAC;UACX,CAAC,CAAC,OAAOJ,CAAC,EAAE;YACVK,SAAS,CAACL,CAAC,CAAC;UACd;QACF,CAAC;QACDM,MAAM,EAAEA,CACNC,cAAsB,EACtBC,KAAa,EACbC,QAA4B,EAC5BC,QAAoB,KACjB;UACHpB,EAAE,CAACgB,MAAM,CAACC,cAAc,EAAEC,KAAK,EAAEC,QAAQ,CAAC;UAC1CC,QAAQ,CAAC,CAAC;QACZ,CAAC;QACDC,MAAM,EAAEA,CAACH,KAAa,EAAEE,QAAoB,KAAK;UAC/CpB,EAAE,CAACqB,MAAM,CAACH,KAAK,CAAC;UAChBE,QAAQ,CAAC,CAAC;QACZ;MACF,CAAC;MAEDtB,EAAE,CAACI,UAAU,CAAC;MAEd,OAAOA,UAAU;IACnB,CAAC,CAAC,OAAOQ,CAAU,EAAE;MACnBX,IAAI,CAACW,CAAW,CAAC;MAEjB,OAAO,IAAI;IACb;EACF;AACF,CAAC","ignoreList":[]}

package/lib/module/types.js

@@ -1,30 +1,69 @@
 "use strict";
 
+/** Options for `open()` and `NitroSQLite.open()`. */
+
+/** A managed connection bound to one database name. Do not use it after closing or deleting it. */
+
+/** SQLite value categories reported in query column metadata. */
 export let ColumnType = /*#__PURE__*/function (ColumnType) {
+  /** Boolean declaration. */
   ColumnType[ColumnType["BOOLEAN"] = 0] = "BOOLEAN";
+  /** Floating point declaration. */
   ColumnType[ColumnType["NUMBER"] = 1] = "NUMBER";
+  /** Integer declaration. */
   ColumnType[ColumnType["INT64"] = 2] = "INT64";
+  /** Text declaration. */
   ColumnType[ColumnType["TEXT"] = 3] = "TEXT";
+  /** Blob declaration. */
   ColumnType[ColumnType["ARRAY_BUFFER"] = 4] = "ARRAY_BUFFER";
+  /** Missing or unrecognized declaration. */
   ColumnType[ColumnType["NULL_VALUE"] = 5] = "NULL_VALUE";
   return ColumnType;
 }({});
 
+/** Values accepted by bound SQL parameters and returned in result rows. */
+
+/** Positional values for SQL placeholders. */
+
+/** A row keyed by result column names. */
+
+/** Query result with a row adapter for TypeORM-style consumers. */
+
+/** Indexable view of query rows. */
+
+/** Execute one SQL statement synchronously and return its typed rows.
+ * @param query SQL statement with optional positional placeholders.
+ * @param params Values bound to the placeholders.
+ */
+
+/** Queue one SQL statement and resolve with its typed rows.
+ * @param query SQL statement with optional positional placeholders.
+ * @param params Values bound to the placeholders.
+ */
+
 /**
- * Allows the execution of bulk of sql commands
- * inside a transaction
- * If a single query must be executed many times with different arguments, its preferred
- * to declare it a single time, and use an array of array parameters.
+ * A reusable SQL statement bound to the connection that prepared it. Each
+ * execution resets the statement and its bindings before applying new values.
+ * Finalize it before closing the connection.
  */
 
 /**
- * status: 0 or undefined for correct execution, 1 for error
- * message: if status === 1, here you will find error description
- * rowsAffected: Number of affected rows if status == 0
+ * Execute a prepared statement with optional positional values and return typed rows.
+ * Each call replaces the previous parameter bindings.
+ * @param params Values bound to the statement's positional placeholders.
  */
 
 /**
- * Result of loading a file and executing every line as a SQL command
- * Similar to BatchQueryResult
+ * Queue a prepared statement execution and resolve with typed rows. Calls on the
+ * same managed connection run in queue order.
+ * @param params Values bound to the statement's positional placeholders.
  */
+
+/** Handle valid only while its transaction callback is active. */
+
+/** One command in a batch. A nested `params` array repeats the query for each parameter set. */
+
+/** Result of a committed SQL batch. Errors are thrown rather than returned here. */
+
+/** Result of importing a SQL file in one transaction. */
 //# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["ColumnType"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAuBA,WAAYA,UAAU,0BAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAA,OAAVA,UAAU;AAAA;;AAsDtB;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["ColumnType"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAEA;;AAqBA;;AA4DA;AACA,WAAYA,UAAU,0BAAVA,UAAU;EACpB;EADUA,UAAU,CAAVA,UAAU;EAGpB;EAHUA,UAAU,CAAVA,UAAU;EAKpB;EALUA,UAAU,CAAVA,UAAU;EAOpB;EAPUA,UAAU,CAAVA,UAAU;EASpB;EATUA,UAAU,CAAVA,UAAU;EAWpB;EAXUA,UAAU,CAAVA,UAAU;EAAA,OAAVA,UAAU;AAAA;;AAetB;;AAGA;;AAGA;;AAGA;;AAOA;;AAgBA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;;AAOA;;AAYA;;AAQA;;AAMA","ignoreList":[]}

package/lib/typescript/commonjs/DatabaseQueue.d.ts

@@ -1,4 +1,5 @@
 export interface QueuedOperation {
+    kind: 'statement' | 'exclusive';
     /**
      * Starts the operation
      */
@@ -7,12 +8,19 @@ export interface QueuedOperation {
 export type DatabaseQueue = {
     queue: QueuedOperation[];
     inProgress: boolean;
+    activeStatements: number;
+    draining: boolean;
 };
-export declare function openDatabaseQueue(dbName: string): void;
-export declare function closeDatabaseQueue(dbName: string): void;
-export declare function isDatabaseOpen(dbName: string): boolean;
-export declare function throwIfDatabaseIsNotOpen(dbName: string): void;
-export declare function getDatabaseQueue(dbName: string): DatabaseQueue;
-export declare function queueOperationAsync<Result>(dbName: string, callback: () => Promise<Result>): Promise<Result>;
-export declare function startOperationSync<Result>(dbName: string, callback: () => Result): Result;
+/** Identity of a managed connection's operation queue. Application code should
+ * omit the optional queue key on package helpers; connections choose it for you.
+ */
+export type DatabaseQueueKey = string | symbol;
+export declare function openDatabaseQueue(dbName: DatabaseQueueKey): void;
+export declare function closeDatabaseQueue(dbName: DatabaseQueueKey): void;
+export declare function isDatabaseOpen(dbName: DatabaseQueueKey): boolean;
+export declare function throwIfDatabaseIsNotOpen(dbName: DatabaseQueueKey): void;
+export declare function getDatabaseQueue(dbName: DatabaseQueueKey): DatabaseQueue;
+export declare function queueOperationAsync<Result>(dbName: DatabaseQueueKey, callback: () => Promise<Result>): Promise<Result>;
+export declare function queueStatementAsync<Result>(dbName: DatabaseQueueKey, callback: () => Promise<Result>): Promise<Result>;
+export declare function startOperationSync<Result>(dbName: DatabaseQueueKey, callback: () => Result): Result;
 //# sourceMappingURL=DatabaseQueue.d.ts.map

package/lib/typescript/commonjs/DatabaseQueue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatabaseQueue.d.ts","sourceRoot":"","sources":["../../../src/DatabaseQueue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,QAQ/C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,QAUhD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,WAE5C;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,QAKtD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,iBAK9C;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,mBAwBhC;AAgBD,wBAAgB,kBAAkB,CAAC,MAAM,EACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,MAAM,GACrB,MAAM,CAiBR"}
+{"version":3,"file":"DatabaseQueue.d.ts","sourceRoot":"","sources":["../../../src/DatabaseQueue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,GAAG,WAAW,CAAA;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,UAAU,EAAE,OAAO,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAA;AAI9C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,QAazD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,QAU1D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,WAEtD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,QAKhE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,iBAKxD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAwED,wBAAgB,kBAAkB,CAAC,MAAM,EACvC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,MAAM,GACrB,MAAM,CAkBR"}

package/lib/typescript/commonjs/NitroSQLiteError.d.ts

@@ -1,12 +1,11 @@
-/**
- * Custom error class for NitroSQLite operations
- * Extends the native Error class with proper prototype chain and error handling
- */
+/** Error thrown by managed NitroSQLite operations. Native errors are wrapped with this class. */
 export default class NitroSQLiteError extends Error {
+    /** Create an error with a message and optional cause. */
     constructor(message: string, options?: ErrorOptions);
-    /**
-     * Converts an unknown error to a NitroSQLiteError
-     * Preserves stack traces and error causes when available
+    /** Convert an unknown thrown value to `NitroSQLiteError`.
+     * Existing instances pass through; `Error` values keep their stack and cause.
+     * @param error Value to normalize.
+     * @returns A NitroSQLiteError instance.
      */
     static fromError(error: unknown): NitroSQLiteError;
 }

package/lib/typescript/commonjs/NitroSQLiteError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroSQLiteError.d.ts","sourceRoot":"","sources":["../../../src/NitroSQLiteError.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAQnD;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB;CAyBnD"}
+{"version":3,"file":"NitroSQLiteError.d.ts","sourceRoot":"","sources":["../../../src/NitroSQLiteError.ts"],"names":[],"mappings":"AAEA,iGAAiG;AACjG,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,KAAK;IACjD,yDAAyD;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAQnD;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB;CAyBnD"}

package/lib/typescript/commonjs/index.d.ts

@@ -1,16 +1,23 @@
 import { open } from './operations/session';
 import { execute, executeAsync } from './operations/execute';
+import { prepare } from './operations/prepare';
 import { executeBatch, executeBatchAsync } from './operations/executeBatch';
+/** Database entry point. Prefer {@link open} for a managed connection.
+ * `native` exposes the Nitro object directly and bypasses the JavaScript queue.
+ */
 export declare const NitroSQLite: {
     native: import("./specs/NitroSQLite.nitro").NitroSQLite;
     open: typeof open;
-    transaction: <Result = void>(dbName: string, transactionCallback: (tx: import("./types").Transaction) => Promise<Result>, isExclusive?: boolean) => Promise<Result>;
+    transaction: <Result = void>(dbName: string, transactionCallback: (tx: import("./types").Transaction) => Promise<Result>, isExclusive?: boolean, queueKey?: import("./DatabaseQueue").DatabaseQueueKey) => Promise<Result>;
     execute: typeof execute;
     executeAsync: typeof executeAsync;
+    prepare: typeof prepare;
     executeBatch: typeof executeBatch;
     executeBatchAsync: typeof executeBatchAsync;
+    openConnection(dbName: string, location?: string, readOnly?: boolean): string;
+    isConnectionOpen(connectionId: string): boolean;
     close(dbName: string): void;
-    drop(dbName: string, location?: string): void;
+    drop(dbName: string, location?: string, connectionId?: string): void;
     attach(mainDbName: string, dbNameToAttach: string, alias: string, location?: string): void;
     detach(mainDbName: string, alias: string): void;
     loadFile(dbName: string, location: string): import("./types").FileLoadResult;

package/lib/typescript/commonjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAI3E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;CAYvB,CAAA;AAED,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAChE,mBAAmB,SAAS,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAI3E;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAYvB,CAAA;AAED,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAChE,mBAAmB,SAAS,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA"}

package/lib/typescript/commonjs/operations/execute.d.ts

@@ -1,10 +1,25 @@
 import type { QueryResult, QueryResultRow, SQLiteQueryParams } from '../types';
 import type { NitroSQLiteQueryResult } from '../specs/NitroSQLiteQueryResult.nitro';
+import type { DatabaseQueueKey } from '../DatabaseQueue';
+/** Execute one SQL statement synchronously by database name.
+ * Uses the managed queue when the database has an open managed connection.
+ * @param dbName Name of an open native database.
+ * @param query SQL statement with optional positional placeholders.
+ * @param params Values bound to the placeholders.
+ * @returns The query result with typed rows.
+ */
 export declare function execute<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams): QueryResult<Row>;
-export declare function executeManaged<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams): QueryResult<Row>;
+export declare function executeManaged<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams, queueKey?: DatabaseQueueKey): QueryResult<Row>;
 export declare function executeNative<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams): QueryResult<Row>;
+/** Execute one SQL statement asynchronously by database name.
+ * Uses the managed queue when the database has an open managed connection.
+ * @param dbName Name of an open native database.
+ * @param query SQL statement with optional positional placeholders.
+ * @param params Values bound to the placeholders.
+ * @returns A promise of the query result with typed rows.
+ */
 export declare function executeAsync<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams): Promise<QueryResult<Row>>;
-export declare function executeAsyncManaged<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams): Promise<QueryResult<Row>>;
+export declare function executeAsyncManaged<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams, queueKey?: DatabaseQueueKey): Promise<QueryResult<Row>>;
 export declare function executeAsyncNative<Row extends QueryResultRow = never>(dbName: string, query: string, params?: SQLiteQueryParams): Promise<QueryResult<Row>>;
 export declare function buildJSQueryResult<Row extends QueryResultRow = never>(result: NitroSQLiteQueryResult): QueryResult<Row>;
 //# sourceMappingURL=execute.d.ts.map

package/lib/typescript/commonjs/operations/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../src/operations/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAOnF,wBAAgB,OAAO,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACxD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,WAAW,CAAC,GAAG,CAAC,CAMlB;AAED,wBAAgB,cAAc,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EAC/D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,WAAW,CAAC,GAAG,CAAC,CAElB;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EAC9D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,WAAW,CAAC,GAAG,CAAC,CAOlB;AAED,wBAAsB,YAAY,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACnE,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAM3B;AAED,wBAAsB,mBAAmB,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EAC1E,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAI3B;AAED,wBAAsB,kBAAkB,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACzE,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAW3B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACnE,MAAM,EAAE,sBAAsB,GAC7B,WAAW,CAAC,GAAG,CAAC,CAWlB"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../src/operations/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAMnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACxD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,WAAW,CAAC,GAAG,CAAC,CAMlB;AAED,wBAAgB,cAAc,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EAC/D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,EAC1B,QAAQ,GAAE,gBAAyB,GAClC,WAAW,CAAC,GAAG,CAAC,CAIlB;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EAC9D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,WAAW,CAAC,GAAG,CAAC,CAOlB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACnE,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAM3B;AAED,wBAAsB,mBAAmB,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EAC1E,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,EAC1B,QAAQ,GAAE,gBAAyB,GAClC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAI3B;AAED,wBAAsB,kBAAkB,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACzE,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAW3B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,cAAc,GAAG,KAAK,EACnE,MAAM,EAAE,sBAAsB,GAC7B,WAAW,CAAC,GAAG,CAAC,CAWlB"}

package/lib/typescript/commonjs/operations/executeBatch.d.ts

@@ -1,4 +1,17 @@
 import type { BatchQueryCommand, BatchQueryResult } from '../types';
-export declare function executeBatch(dbName: string, commands: BatchQueryCommand[]): BatchQueryResult;
-export declare function executeBatchAsync(dbName: string, commands: BatchQueryCommand[]): Promise<BatchQueryResult>;
+import type { DatabaseQueueKey } from '../DatabaseQueue';
+/** Execute a batch synchronously in one exclusive transaction.
+ * Requires an open managed connection; throws if it is busy or the batch is empty.
+ * @param dbName Name of the open database.
+ * @param commands SQL commands and optional parameter sets.
+ * @returns Total affected row count.
+ */
+export declare function executeBatch(dbName: string, commands: BatchQueryCommand[], queueKey?: DatabaseQueueKey): BatchQueryResult;
+/** Queue a batch in one exclusive transaction.
+ * Requires an open managed connection; a failed command rolls back the batch.
+ * @param dbName Name of the open database.
+ * @param commands SQL commands and optional parameter sets.
+ * @returns A promise of the total affected row count.
+ */
+export declare function executeBatchAsync(dbName: string, commands: BatchQueryCommand[], queueKey?: DatabaseQueueKey): Promise<BatchQueryResult>;
 //# sourceMappingURL=executeBatch.d.ts.map

package/lib/typescript/commonjs/operations/executeBatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executeBatch.d.ts","sourceRoot":"","sources":["../../../../src/operations/executeBatch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEnE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,gBAAgB,CAUlB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}
+{"version":3,"file":"executeBatch.d.ts","sourceRoot":"","sources":["../../../../src/operations/executeBatch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,QAAQ,GAAE,gBAAyB,GAClC,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,QAAQ,GAAE,gBAAyB,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}

package/lib/typescript/commonjs/operations/prepare.d.ts

@@ -0,0 +1,13 @@
+import type { PreparedStatement } from '../types';
+import type { DatabaseQueueKey } from '../DatabaseQueue';
+/**
+ * Prepare one SQL statement on an open managed connection for repeated execution.
+ * Synchronous preparation throws if the connection is busy. Finalize the returned
+ * statement before closing the connection.
+ * @param dbName Database name or independent connection ID.
+ * @param query SQL statement with optional positional placeholders.
+ * @param queueKey Internal managed queue key; omit when using the public API.
+ * @returns A statement whose executions use the same connection queue.
+ */
+export declare function prepare(dbName: string, query: string, queueKey?: DatabaseQueueKey): PreparedStatement;
+//# sourceMappingURL=prepare.d.ts.map

package/lib/typescript/commonjs/operations/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../../src/operations/prepare.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EAIlB,MAAM,UAAU,CAAA;AAGjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,gBAAyB,GAClC,iBAAiB,CA2CnB"}