react-native-nitro-sqlite 9.8.1 → 10.0.0

package/lib/commonjs/typeORM.js

@@ -13,11 +13,18 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 //     | |     | |  | |    | |___| |__| | | \ \| |  | |  / ____ \| |    _| |_
 //     |_|     |_|  |_|    |______\____/|_|  \_\_|  |_| /_/    \_\_|   |_____|
 
-/**
- * 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.
  */
 const typeORMDriver = exports.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/commonjs/typeORM.js.map

@@ -1 +1 @@
-{"version":3,"names":["Operations","_interopRequireWildcard","require","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","typeORMDriver","exports","openDatabase","options","ok","fail","db","open","connection","executeSql","sql","params","okExecute","failExecute","result","executeAsync","transaction","fn","close","okClose","failClose","attach","dbNameToAttach","alias","location","callback","detach"],"sourceRoot":"../../src","sources":["typeORM.ts"],"mappings":";;;;;;AAaA,IAAAA,UAAA,GAAAC,uBAAA,CAAAC,OAAA;AAAkD,SAAAD,wBAAAE,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAJ,uBAAA,YAAAA,CAAAE,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAblD;AACA;AACA;AACA;AACA;AACA;;AA4BA;AACA;AACA;AACA;AACO,MAAMkB,aAAa,GAAAC,OAAA,CAAAD,aAAA,GAAG;EAC3BE,YAAY,EAAEA,CACZC,OAGC,EACDC,EAA8C,EAC9CC,IAA2B,KACa;IACxC,IAAI;MACF,MAAMC,EAAE,GAAG5B,UAAU,CAAC6B,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,OAAOjC,CAAU,EAAE;YACnBgC,WAAW,CAAChC,CAAW,CAAC;UAC1B;QACF,CAAC;QACDmC,WAAW,EACTC,EAAsC,IACpB;UAClB,OAAOX,EAAE,CAACU,WAAW,CAACC,EAAE,CAAC;QAC3B,CAAC;QACDC,KAAK,EAAEA,CAACC,OAAmB,EAAEC,SAA+B,KAAK;UAC/D,IAAI;YACFd,EAAE,CAACY,KAAK,CAAC,CAAC;YACVC,OAAO,CAAC,CAAC;UACX,CAAC,CAAC,OAAOtC,CAAC,EAAE;YACVuC,SAAS,CAACvC,CAAC,CAAC;UACd;QACF,CAAC;QACDwC,MAAM,EAAEA,CACNC,cAAsB,EACtBC,KAAa,EACbC,QAA4B,EAC5BC,QAAoB,KACjB;UACHnB,EAAE,CAACe,MAAM,CAACC,cAAc,EAAEC,KAAK,EAAEC,QAAQ,CAAC;UAC1CC,QAAQ,CAAC,CAAC;QACZ,CAAC;QACDC,MAAM,EAAEA,CAACH,KAAa,EAAEE,QAAoB,KAAK;UAC/CnB,EAAE,CAACoB,MAAM,CAACH,KAAK,CAAC;UAChBE,QAAQ,CAAC,CAAC;QACZ;MACF,CAAC;MAEDrB,EAAE,CAACI,UAAU,CAAC;MAEd,OAAOA,UAAU;IACnB,CAAC,CAAC,OAAO3B,CAAU,EAAE;MACnBwB,IAAI,CAACxB,CAAW,CAAC;MAEjB,OAAO,IAAI;IACb;EACF;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["Operations","_interopRequireWildcard","require","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","typeORMDriver","exports","openDatabase","options","ok","fail","db","open","connection","executeSql","sql","params","okExecute","failExecute","result","executeAsync","transaction","fn","close","okClose","failClose","attach","dbNameToAttach","alias","location","callback","detach"],"sourceRoot":"../../src","sources":["typeORM.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/types.js

@@ -4,28 +4,54 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.ColumnType = void 0;
+/** 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. */
 let ColumnType = exports.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/commonjs/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["ColumnType","exports"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;;;;;IAuBYA,UAAU,GAAAC,OAAA,CAAAD,UAAA,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","exports"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;;;;;AAEA;AAqBA;AA4DA;AAAA,IACYA,UAAU,GAAAC,OAAA,CAAAD,UAAA,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/module/DatabaseQueue.js

@@ -1,20 +1,27 @@
 "use strict";
 
 import NitroSQLiteError from "./NitroSQLiteError.js";
+
+/** Identity of a managed connection's operation queue. Application code should
+ * omit the optional queue key on package helpers; connections choose it for you.
+ */
+
 const databaseQueues = new Map();
 export function openDatabaseQueue(dbName) {
   if (isDatabaseOpen(dbName)) {
-    throw new NitroSQLiteError(`Database ${dbName} is already open. There is already a connection to the database.`);
+    throw new NitroSQLiteError(`Database ${String(dbName)} is already open. There is already a connection to the database.`);
   }
   databaseQueues.set(dbName, {
     queue: [],
-    inProgress: false
+    inProgress: false,
+    activeStatements: 0,
+    draining: false
   });
 }
 export function closeDatabaseQueue(dbName) {
   const databaseQueue = getDatabaseQueue(dbName);
   if (databaseQueue.inProgress || databaseQueue.queue.length > 0) {
-    throw new NitroSQLiteError(`Cannot close database ${dbName}. The database is busy with another operation.`);
+    throw new NitroSQLiteError(`Cannot close database ${String(dbName)}. The database is busy with another operation.`);
   }
   databaseQueues.delete(dbName);
 }
@@ -22,7 +29,7 @@ export function isDatabaseOpen(dbName) {
   return databaseQueues.has(dbName);
 }
 export function throwIfDatabaseIsNotOpen(dbName) {
-  if (!isDatabaseOpen(dbName)) throw new NitroSQLiteError(`Database ${dbName} is not open. There is no connection to the database.`);
+  if (!isDatabaseOpen(dbName)) throw new NitroSQLiteError(`Database ${String(dbName)} is not open. There is no connection to the database.`);
 }
 export function getDatabaseQueue(dbName) {
   throwIfDatabaseIsNotOpen(dbName);
@@ -30,6 +37,12 @@ export function getDatabaseQueue(dbName) {
   return queue;
 }
 export function queueOperationAsync(dbName, callback) {
+  return enqueueOperation(dbName, 'exclusive', callback);
+}
+export function queueStatementAsync(dbName, callback) {
+  return enqueueOperation(dbName, 'statement', callback);
+}
+function enqueueOperation(dbName, kind, callback) {
   const databaseQueue = getDatabaseQueue(dbName);
   return new Promise((resolve, reject) => {
     async function start() {
@@ -39,34 +52,56 @@ export function queueOperationAsync(dbName, callback) {
       } catch (error) {
         reject(error);
       } finally {
-        databaseQueue.inProgress = false;
-        startOperationAsync(databaseQueue);
+        if (kind === 'statement') {
+          databaseQueue.activeStatements--;
+          if (databaseQueue.activeStatements === 0) {
+            databaseQueue.inProgress = false;
+          }
+        } else {
+          databaseQueue.inProgress = false;
+        }
+        startNextOperations(databaseQueue);
       }
     }
     const operation = {
+      kind,
       start
     };
     databaseQueue.queue.push(operation);
-    startOperationAsync(databaseQueue);
+    startNextOperations(databaseQueue);
   });
 }
-function startOperationAsync(queue) {
-  // Queue is empty or in progress. Bail out.
-  if (queue.inProgress || queue.queue.length === 0) {
+function startNextOperations(queue) {
+  if (queue.draining || queue.inProgress && queue.activeStatements === 0) {
     return;
   }
-  queue.inProgress = true;
-  const operation = queue.queue.shift();
-  setImmediate(() => {
-    operation.start();
-  });
+  queue.draining = true;
+  try {
+    while (queue.queue.length > 0) {
+      const exclusiveIndex = queue.queue.findIndex(operation => operation.kind === 'exclusive');
+      const statementCount = exclusiveIndex === -1 ? queue.queue.length : exclusiveIndex;
+      if (statementCount > 0) {
+        const statements = queue.queue.splice(0, statementCount);
+        queue.inProgress = true;
+        queue.activeStatements += statements.length;
+        for (const statement of statements) statement.start();
+        continue;
+      }
+      if (queue.activeStatements > 0) return;
+      queue.inProgress = true;
+      queue.queue.shift().start();
+      return;
+    }
+  } finally {
+    queue.draining = false;
+  }
 }
 export function startOperationSync(dbName, callback) {
   const databaseQueue = getDatabaseQueue(dbName);
 
   // Database is busy - cannot execute synchronously
   if (databaseQueue.inProgress || databaseQueue.queue.length > 0) {
-    throw new NitroSQLiteError(`Cannot run synchronous operation on database. Database ${dbName} is busy with another operation.`);
+    throw new NitroSQLiteError(`Cannot run synchronous operation on database. Database ${String(dbName)} is busy with another operation.`);
   }
 
   // Execute synchronously
@@ -75,6 +110,7 @@ export function startOperationSync(dbName, callback) {
     return callback();
   } finally {
     databaseQueue.inProgress = false;
+    startNextOperations(databaseQueue);
   }
 }
 //# sourceMappingURL=DatabaseQueue.js.map

package/lib/module/DatabaseQueue.js.map

@@ -1 +1 @@
-{"version":3,"names":["NitroSQLiteError","databaseQueues","Map","openDatabaseQueue","dbName","isDatabaseOpen","set","queue","inProgress","closeDatabaseQueue","databaseQueue","getDatabaseQueue","length","delete","has","throwIfDatabaseIsNotOpen","get","queueOperationAsync","callback","Promise","resolve","reject","start","result","error","startOperationAsync","operation","push","shift","setImmediate","startOperationSync"],"sourceRoot":"../../src","sources":["DatabaseQueue.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NitroSQLiteError","databaseQueues","Map","openDatabaseQueue","dbName","isDatabaseOpen","String","set","queue","inProgress","activeStatements","draining","closeDatabaseQueue","databaseQueue","getDatabaseQueue","length","delete","has","throwIfDatabaseIsNotOpen","get","queueOperationAsync","callback","enqueueOperation","queueStatementAsync","kind","Promise","resolve","reject","start","result","error","startNextOperations","operation","push","exclusiveIndex","findIndex","statementCount","statements","splice","statement","shift","startOperationSync"],"sourceRoot":"../../src","sources":["DatabaseQueue.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/NitroSQLiteError.js

@@ -2,11 +2,9 @@
 
 const NITRO_SQLITE_ERROR_NAME = 'NitroSQLiteError';
 
-/**
- * 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, options) {
     super(message, options);
     this.name = NITRO_SQLITE_ERROR_NAME;
@@ -15,9 +13,10 @@ export default class NitroSQLiteError extends Error {
     Object.setPrototypeOf(this, NitroSQLiteError.prototype);
   }
 
-  /**
-   * 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) {
     if (error instanceof NitroSQLiteError) {

package/lib/module/NitroSQLiteError.js.map

@@ -1 +1 @@
-{"version":3,"names":["NITRO_SQLITE_ERROR_NAME","NitroSQLiteError","Error","constructor","message","options","name","Object","setPrototypeOf","prototype","fromError","error","nitroSQLiteError","cause","stack"],"sourceRoot":"../../src","sources":["NitroSQLiteError.ts"],"mappings":";;AAAA,MAAMA,uBAAuB,GAAG,kBAA2B;;AAE3D;AACA;AACA;AACA;AACA,eAAe,MAAMC,gBAAgB,SAASC,KAAK,CAAC;EAClDC,WAAWA,CAACC,OAAe,EAAEC,OAAsB,EAAE;IACnD,KAAK,CAACD,OAAO,EAAEC,OAAO,CAAC;IACvB,IAAI,CAACC,IAAI,GAAGN,uBAAuB;;IAEnC;IACAO,MAAM,CAACC,cAAc,CAAC,IAAI,EAAEP,gBAAgB,CAACQ,SAAS,CAAC;EACzD;;EAEA;AACF;AACA;AACA;EACE,OAAOC,SAASA,CAACC,KAAc,EAAoB;IACjD,IAAIA,KAAK,YAAYV,gBAAgB,EAAE;MACrC,OAAOU,KAAK;IACd;IAEA,IAAIA,KAAK,YAAYT,KAAK,EAAE;MAC1B,MAAMU,gBAAgB,GAAG,IAAIX,gBAAgB,CAACU,KAAK,CAACP,OAAO,EAAE;QAC3DS,KAAK,EAAEF,KAAK,CAACE;MACf,CAAC,CAAC;;MAEF;MACA,IAAIF,KAAK,CAACG,KAAK,EAAE;QACfF,gBAAgB,CAACE,KAAK,GAAGH,KAAK,CAACG,KAAK;MACtC;MACA,OAAOF,gBAAgB;IACzB;IAEA,IAAI,OAAOD,KAAK,KAAK,QAAQ,EAAE;MAC7B,OAAO,IAAIV,gBAAgB,CAACU,KAAK,CAAC;IACpC;IAEA,OAAO,IAAIV,gBAAgB,CAAC,wBAAwB,EAAE;MACpDY,KAAK,EAAEF;IACT,CAAC,CAAC;EACJ;AACF","ignoreList":[]}
+{"version":3,"names":["NITRO_SQLITE_ERROR_NAME","NitroSQLiteError","Error","constructor","message","options","name","Object","setPrototypeOf","prototype","fromError","error","nitroSQLiteError","cause","stack"],"sourceRoot":"../../src","sources":["NitroSQLiteError.ts"],"mappings":";;AAAA,MAAMA,uBAAuB,GAAG,kBAA2B;;AAE3D;AACA,eAAe,MAAMC,gBAAgB,SAASC,KAAK,CAAC;EAClD;EACAC,WAAWA,CAACC,OAAe,EAAEC,OAAsB,EAAE;IACnD,KAAK,CAACD,OAAO,EAAEC,OAAO,CAAC;IACvB,IAAI,CAACC,IAAI,GAAGN,uBAAuB;;IAEnC;IACAO,MAAM,CAACC,cAAc,CAAC,IAAI,EAAEP,gBAAgB,CAACQ,SAAS,CAAC;EACzD;;EAEA;AACF;AACA;AACA;AACA;EACE,OAAOC,SAASA,CAACC,KAAc,EAAoB;IACjD,IAAIA,KAAK,YAAYV,gBAAgB,EAAE;MACrC,OAAOU,KAAK;IACd;IAEA,IAAIA,KAAK,YAAYT,KAAK,EAAE;MAC1B,MAAMU,gBAAgB,GAAG,IAAIX,gBAAgB,CAACU,KAAK,CAACP,OAAO,EAAE;QAC3DS,KAAK,EAAEF,KAAK,CAACE;MACf,CAAC,CAAC;;MAEF;MACA,IAAIF,KAAK,CAACG,KAAK,EAAE;QACfF,gBAAgB,CAACE,KAAK,GAAGH,KAAK,CAACG,KAAK;MACtC;MACA,OAAOF,gBAAgB;IACzB;IAEA,IAAI,OAAOD,KAAK,KAAK,QAAQ,EAAE;MAC7B,OAAO,IAAIV,gBAAgB,CAACU,KAAK,CAAC;IACpC;IAEA,OAAO,IAAIV,gBAAgB,CAAC,wBAAwB,EAAE;MACpDY,KAAK,EAAEF;IACT,CAAC,CAAC;EACJ;AACF","ignoreList":[]}

package/lib/module/OnLoad.js

@@ -1,5 +1,5 @@
 "use strict";
 
-// NOOP on iOS
+// Apple platforms initialize the database directory from OnLoad.mm.
 export const init = () => {};
 //# sourceMappingURL=OnLoad.js.map

package/lib/module/index.js

@@ -4,19 +4,24 @@ import { transaction } from "./operations/transaction.js";
 import { HybridNitroSQLite } from "./nitro.js";
 import { open } from "./operations/session.js";
 import { execute, executeAsync } from "./operations/execute.js";
+import { prepare } from "./operations/prepare.js";
 import { init } from './OnLoad';
 import { executeBatch, executeBatchAsync } from "./operations/executeBatch.js";
 init();
+
+/** Database entry point. Prefer {@link open} for a managed connection.
+ * `native` exposes the Nitro object directly and bypasses the JavaScript queue.
+ */
 export const NitroSQLite = {
   ...HybridNitroSQLite,
   native: HybridNitroSQLite,
-  // Overwrite native `open` function with session-based JS abstraction,
-  // where the database name can be ommited once opened
+  // The managed open method returns a connection bound to its database name.
   open,
-  // More JS abstractions, that perform type casting and validation.
+  // Managed query methods add typed rows and normalize errors.
   transaction,
   execute,
   executeAsync,
+  prepare,
   executeBatch,
   executeBatchAsync
 };

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["transaction","HybridNitroSQLite","open","execute","executeAsync","init","executeBatch","executeBatchAsync","NitroSQLite","native","default","NitroSQLiteError","typeORMDriver"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,6BAA0B;AACtD,SAASC,iBAAiB,QAAQ,YAAS;AAC3C,SAASC,IAAI,QAAQ,yBAAsB;AAC3C,SAASC,OAAO,EAAEC,YAAY,QAAQ,yBAAsB;AAC5D,SAASC,IAAI,QAAQ,UAAU;AAC/B,SAASC,YAAY,EAAEC,iBAAiB,QAAQ,8BAA2B;AAE3EF,IAAI,CAAC,CAAC;AAEN,OAAO,MAAMG,WAAW,GAAG;EACzB,GAAGP,iBAAiB;EACpBQ,MAAM,EAAER,iBAAiB;EACzB;EACA;EACAC,IAAI;EACJ;EACAF,WAAW;EACXG,OAAO;EACPC,YAAY;EACZE,YAAY;EACZC;AACF,CAAC;AAED,SAASL,IAAI,QAAQ,yBAAsB;AAC3C,SAASQ,OAAO,IAAIC,gBAAgB,QAAQ,uBAAoB;AAEhE,SAASC,aAAa,QAAQ,cAAW","ignoreList":[]}
+{"version":3,"names":["transaction","HybridNitroSQLite","open","execute","executeAsync","prepare","init","executeBatch","executeBatchAsync","NitroSQLite","native","default","NitroSQLiteError","typeORMDriver"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,6BAA0B;AACtD,SAASC,iBAAiB,QAAQ,YAAS;AAC3C,SAASC,IAAI,QAAQ,yBAAsB;AAC3C,SAASC,OAAO,EAAEC,YAAY,QAAQ,yBAAsB;AAC5D,SAASC,OAAO,QAAQ,yBAAsB;AAC9C,SAASC,IAAI,QAAQ,UAAU;AAC/B,SAASC,YAAY,EAAEC,iBAAiB,QAAQ,8BAA2B;AAE3EF,IAAI,CAAC,CAAC;;AAEN;AACA;AACA;AACA,OAAO,MAAMG,WAAW,GAAG;EACzB,GAAGR,iBAAiB;EACpBS,MAAM,EAAET,iBAAiB;EACzB;EACAC,IAAI;EACJ;EACAF,WAAW;EACXG,OAAO;EACPC,YAAY;EACZC,OAAO;EACPE,YAAY;EACZC;AACF,CAAC;AAED,SAASN,IAAI,QAAQ,yBAAsB;AAC3C,SAASS,OAAO,IAAIC,gBAAgB,QAAQ,uBAAoB;AAEhE,SAASC,aAAa,QAAQ,cAAW","ignoreList":[]}

package/lib/module/operations/execute.js

@@ -2,15 +2,22 @@
 
 import { HybridNitroSQLite } from "../nitro.js";
 import NitroSQLiteError from "../NitroSQLiteError.js";
-import { isDatabaseOpen, queueOperationAsync, startOperationSync } from "../DatabaseQueue.js";
+import { isDatabaseOpen, queueStatementAsync, startOperationSync } from "../DatabaseQueue.js";
+/** 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 function execute(dbName, query, params) {
   if (!isDatabaseOpen(dbName)) {
     return executeNative(dbName, query, params);
   }
   return executeManaged(dbName, query, params);
 }
-export function executeManaged(dbName, query, params) {
-  return startOperationSync(dbName, () => executeNative(dbName, query, params));
+export function executeManaged(dbName, query, params, queueKey = dbName) {
+  return startOperationSync(queueKey, () => executeNative(dbName, query, params));
 }
 export function executeNative(dbName, query, params) {
   try {
@@ -20,14 +27,22 @@ export function executeNative(dbName, query, params) {
     throw NitroSQLiteError.fromError(error);
   }
 }
+
+/** 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 async function executeAsync(dbName, query, params) {
   if (!isDatabaseOpen(dbName)) {
     return executeAsyncNative(dbName, query, params);
   }
   return executeAsyncManaged(dbName, query, params);
 }
-export async function executeAsyncManaged(dbName, query, params) {
-  return queueOperationAsync(dbName, () => executeAsyncNative(dbName, query, params));
+export async function executeAsyncManaged(dbName, query, params, queueKey = dbName) {
+  return queueStatementAsync(queueKey, () => executeAsyncNative(dbName, query, params));
 }
 export async function executeAsyncNative(dbName, query, params) {
   try {

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

@@ -1 +1 @@
-{"version":3,"names":["HybridNitroSQLite","NitroSQLiteError","isDatabaseOpen","queueOperationAsync","startOperationSync","execute","dbName","query","params","executeNative","executeManaged","nativeResult","buildJSQueryResult","error","fromError","executeAsync","executeAsyncNative","executeAsyncManaged","result","resultWithRows","results","rows","_array","length","item","idx"],"sourceRoot":"../../../src","sources":["operations/execute.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,aAAU;AAE5C,OAAOC,gBAAgB,MAAM,wBAAqB;AAElD,SACEC,cAAc,EACdC,mBAAmB,EACnBC,kBAAkB,QACb,qBAAkB;AAEzB,OAAO,SAASC,OAAOA,CACrBC,MAAc,EACdC,KAAa,EACbC,MAA0B,EACR;EAClB,IAAI,CAACN,cAAc,CAACI,MAAM,CAAC,EAAE;IAC3B,OAAOG,aAAa,CAACH,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;EAC7C;EAEA,OAAOE,cAAc,CAACJ,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;AAC9C;AAEA,OAAO,SAASE,cAAcA,CAC5BJ,MAAc,EACdC,KAAa,EACbC,MAA0B,EACR;EAClB,OAAOJ,kBAAkB,CAACE,MAAM,EAAE,MAAMG,aAAa,CAACH,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC,CAAC;AAC/E;AAEA,OAAO,SAASC,aAAaA,CAC3BH,MAAc,EACdC,KAAa,EACbC,MAA0B,EACR;EAClB,IAAI;IACF,MAAMG,YAAY,GAAGX,iBAAiB,CAACK,OAAO,CAACC,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;IACrE,OAAOI,kBAAkB,CAAMD,YAAY,CAAC;EAC9C,CAAC,CAAC,OAAOE,KAAK,EAAE;IACd,MAAMZ,gBAAgB,CAACa,SAAS,CAACD,KAAK,CAAC;EACzC;AACF;AAEA,OAAO,eAAeE,YAAYA,CAChCT,MAAc,EACdC,KAAa,EACbC,MAA0B,EACC;EAC3B,IAAI,CAACN,cAAc,CAACI,MAAM,CAAC,EAAE;IAC3B,OAAOU,kBAAkB,CAACV,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;EAClD;EAEA,OAAOS,mBAAmB,CAACX,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;AACnD;AAEA,OAAO,eAAeS,mBAAmBA,CACvCX,MAAc,EACdC,KAAa,EACbC,MAA0B,EACC;EAC3B,OAAOL,mBAAmB,CAACG,MAAM,EAAE,MACjCU,kBAAkB,CAACV,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAC1C,CAAC;AACH;AAEA,OAAO,eAAeQ,kBAAkBA,CACtCV,MAAc,EACdC,KAAa,EACbC,MAA0B,EACC;EAC3B,IAAI;IACF,MAAMG,YAAY,GAAG,MAAMX,iBAAiB,CAACe,YAAY,CACvDT,MAAM,EACNC,KAAK,EACLC,MACF,CAAC;IACD,OAAOI,kBAAkB,CAAMD,YAAY,CAAC;EAC9C,CAAC,CAAC,OAAOE,KAAK,EAAE;IACd,MAAMZ,gBAAgB,CAACa,SAAS,CAACD,KAAK,CAAC;EACzC;AACF;AAEA,OAAO,SAASD,kBAAkBA,CAChCM,MAA8B,EACZ;EAClB,MAAMC,cAAc,GAAGD,MAA0B;EACjD,MAAME,OAAO,GAAGF,MAAM,CAACE,OAAgB;EAEvCD,cAAc,CAACE,IAAI,GAAG;IACpBC,MAAM,EAAEF,OAAO;IACfG,MAAM,EAAEH,OAAO,CAACG,MAAM;IACtBC,IAAI,EAAGC,GAAW,IAAKL,OAAO,CAACK,GAAG;EACpC,CAAC;EAED,OAAON,cAAc;AACvB","ignoreList":[]}
+{"version":3,"names":["HybridNitroSQLite","NitroSQLiteError","isDatabaseOpen","queueStatementAsync","startOperationSync","execute","dbName","query","params","executeNative","executeManaged","queueKey","nativeResult","buildJSQueryResult","error","fromError","executeAsync","executeAsyncNative","executeAsyncManaged","result","resultWithRows","results","rows","_array","length","item","idx"],"sourceRoot":"../../../src","sources":["operations/execute.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,aAAU;AAE5C,OAAOC,gBAAgB,MAAM,wBAAqB;AAElD,SACEC,cAAc,EACdC,mBAAmB,EACnBC,kBAAkB,QACb,qBAAkB;AAGzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CACrBC,MAAc,EACdC,KAAa,EACbC,MAA0B,EACR;EAClB,IAAI,CAACN,cAAc,CAACI,MAAM,CAAC,EAAE;IAC3B,OAAOG,aAAa,CAACH,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;EAC7C;EAEA,OAAOE,cAAc,CAACJ,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;AAC9C;AAEA,OAAO,SAASE,cAAcA,CAC5BJ,MAAc,EACdC,KAAa,EACbC,MAA0B,EAC1BG,QAA0B,GAAGL,MAAM,EACjB;EAClB,OAAOF,kBAAkB,CAACO,QAAQ,EAAE,MAClCF,aAAa,CAACH,MAAM,EAAEC,KAAK,EAAEC,MAAM,CACrC,CAAC;AACH;AAEA,OAAO,SAASC,aAAaA,CAC3BH,MAAc,EACdC,KAAa,EACbC,MAA0B,EACR;EAClB,IAAI;IACF,MAAMI,YAAY,GAAGZ,iBAAiB,CAACK,OAAO,CAACC,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;IACrE,OAAOK,kBAAkB,CAAMD,YAAY,CAAC;EAC9C,CAAC,CAAC,OAAOE,KAAK,EAAE;IACd,MAAMb,gBAAgB,CAACc,SAAS,CAACD,KAAK,CAAC;EACzC;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeE,YAAYA,CAChCV,MAAc,EACdC,KAAa,EACbC,MAA0B,EACC;EAC3B,IAAI,CAACN,cAAc,CAACI,MAAM,CAAC,EAAE;IAC3B,OAAOW,kBAAkB,CAACX,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;EAClD;EAEA,OAAOU,mBAAmB,CAACZ,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAAC;AACnD;AAEA,OAAO,eAAeU,mBAAmBA,CACvCZ,MAAc,EACdC,KAAa,EACbC,MAA0B,EAC1BG,QAA0B,GAAGL,MAAM,EACR;EAC3B,OAAOH,mBAAmB,CAACQ,QAAQ,EAAE,MACnCM,kBAAkB,CAACX,MAAM,EAAEC,KAAK,EAAEC,MAAM,CAC1C,CAAC;AACH;AAEA,OAAO,eAAeS,kBAAkBA,CACtCX,MAAc,EACdC,KAAa,EACbC,MAA0B,EACC;EAC3B,IAAI;IACF,MAAMI,YAAY,GAAG,MAAMZ,iBAAiB,CAACgB,YAAY,CACvDV,MAAM,EACNC,KAAK,EACLC,MACF,CAAC;IACD,OAAOK,kBAAkB,CAAMD,YAAY,CAAC;EAC9C,CAAC,CAAC,OAAOE,KAAK,EAAE;IACd,MAAMb,gBAAgB,CAACc,SAAS,CAACD,KAAK,CAAC;EACzC;AACF;AAEA,OAAO,SAASD,kBAAkBA,CAChCM,MAA8B,EACZ;EAClB,MAAMC,cAAc,GAAGD,MAA0B;EACjD,MAAME,OAAO,GAAGF,MAAM,CAACE,OAAgB;EAEvCD,cAAc,CAACE,IAAI,GAAG;IACpBC,MAAM,EAAEF,OAAO;IACfG,MAAM,EAAEH,OAAO,CAACG,MAAM;IACtBC,IAAI,EAAGC,GAAW,IAAKL,OAAO,CAACK,GAAG;EACpC,CAAC;EAED,OAAON,cAAc;AACvB","ignoreList":[]}

package/lib/module/operations/executeBatch.js

@@ -1,19 +1,32 @@
 "use strict";
 
 import { HybridNitroSQLite } from "../nitro.js";
-import { queueOperationAsync, startOperationSync, throwIfDatabaseIsNotOpen } from "../DatabaseQueue.js";
+import { queueStatementAsync, startOperationSync, throwIfDatabaseIsNotOpen } from "../DatabaseQueue.js";
 import NitroSQLiteError from "../NitroSQLiteError.js";
-export function executeBatch(dbName, commands) {
-  throwIfDatabaseIsNotOpen(dbName);
+/** 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 function executeBatch(dbName, commands, queueKey = dbName) {
+  throwIfDatabaseIsNotOpen(queueKey);
   try {
-    return startOperationSync(dbName, () => HybridNitroSQLite.executeBatch(dbName, commands));
+    return startOperationSync(queueKey, () => HybridNitroSQLite.executeBatch(dbName, commands));
   } catch (error) {
     throw NitroSQLiteError.fromError(error);
   }
 }
-export async function executeBatchAsync(dbName, commands) {
-  throwIfDatabaseIsNotOpen(dbName);
-  return queueOperationAsync(dbName, async () => {
+
+/** 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 async function executeBatchAsync(dbName, commands, queueKey = dbName) {
+  throwIfDatabaseIsNotOpen(queueKey);
+  return queueStatementAsync(queueKey, async () => {
     try {
       return await HybridNitroSQLite.executeBatchAsync(dbName, commands);
     } catch (error) {

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

@@ -1 +1 @@
-{"version":3,"names":["HybridNitroSQLite","queueOperationAsync","startOperationSync","throwIfDatabaseIsNotOpen","NitroSQLiteError","executeBatch","dbName","commands","error","fromError","executeBatchAsync"],"sourceRoot":"../../../src","sources":["operations/executeBatch.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,aAAU;AAC5C,SACEC,mBAAmB,EACnBC,kBAAkB,EAClBC,wBAAwB,QACnB,qBAAkB;AACzB,OAAOC,gBAAgB,MAAM,wBAAqB;AAGlD,OAAO,SAASC,YAAYA,CAC1BC,MAAc,EACdC,QAA6B,EACX;EAClBJ,wBAAwB,CAACG,MAAM,CAAC;EAEhC,IAAI;IACF,OAAOJ,kBAAkB,CAACI,MAAM,EAAE,MAChCN,iBAAiB,CAACK,YAAY,CAACC,MAAM,EAAEC,QAAQ,CACjD,CAAC;EACH,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd,MAAMJ,gBAAgB,CAACK,SAAS,CAACD,KAAK,CAAC;EACzC;AACF;AAEA,OAAO,eAAeE,iBAAiBA,CACrCJ,MAAc,EACdC,QAA6B,EACF;EAC3BJ,wBAAwB,CAACG,MAAM,CAAC;EAEhC,OAAOL,mBAAmB,CAACK,MAAM,EAAE,YAAY;IAC7C,IAAI;MACF,OAAO,MAAMN,iBAAiB,CAACU,iBAAiB,CAACJ,MAAM,EAAEC,QAAQ,CAAC;IACpE,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,MAAMJ,gBAAgB,CAACK,SAAS,CAACD,KAAK,CAAC;IACzC;EACF,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["HybridNitroSQLite","queueStatementAsync","startOperationSync","throwIfDatabaseIsNotOpen","NitroSQLiteError","executeBatch","dbName","commands","queueKey","error","fromError","executeBatchAsync"],"sourceRoot":"../../../src","sources":["operations/executeBatch.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,aAAU;AAC5C,SACEC,mBAAmB,EACnBC,kBAAkB,EAClBC,wBAAwB,QACnB,qBAAkB;AACzB,OAAOC,gBAAgB,MAAM,wBAAqB;AAIlD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAC1BC,MAAc,EACdC,QAA6B,EAC7BC,QAA0B,GAAGF,MAAM,EACjB;EAClBH,wBAAwB,CAACK,QAAQ,CAAC;EAElC,IAAI;IACF,OAAON,kBAAkB,CAACM,QAAQ,EAAE,MAClCR,iBAAiB,CAACK,YAAY,CAACC,MAAM,EAAEC,QAAQ,CACjD,CAAC;EACH,CAAC,CAAC,OAAOE,KAAK,EAAE;IACd,MAAML,gBAAgB,CAACM,SAAS,CAACD,KAAK,CAAC;EACzC;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeE,iBAAiBA,CACrCL,MAAc,EACdC,QAA6B,EAC7BC,QAA0B,GAAGF,MAAM,EACR;EAC3BH,wBAAwB,CAACK,QAAQ,CAAC;EAElC,OAAOP,mBAAmB,CAACO,QAAQ,EAAE,YAAY;IAC/C,IAAI;MACF,OAAO,MAAMR,iBAAiB,CAACW,iBAAiB,CAACL,MAAM,EAAEC,QAAQ,CAAC;IACpE,CAAC,CAAC,OAAOE,KAAK,EAAE;MACd,MAAML,gBAAgB,CAACM,SAAS,CAACD,KAAK,CAAC;IACzC;EACF,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/operations/prepare.js

@@ -0,0 +1,49 @@
+"use strict";
+
+import { HybridNitroSQLite } from "../nitro.js";
+import NitroSQLiteError from "../NitroSQLiteError.js";
+import { buildJSQueryResult } from "./execute.js";
+import { queueOperationAsync, startOperationSync } from "../DatabaseQueue.js";
+/**
+ * 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 function prepare(dbName, query, queueKey = dbName) {
+  try {
+    const nativeStatement = startOperationSync(queueKey, () => HybridNitroSQLite.prepare(dbName, query));
+    return {
+      get isFinalized() {
+        return nativeStatement.isFinalized;
+      },
+      execute: params => {
+        try {
+          return startOperationSync(queueKey, () => buildJSQueryResult(nativeStatement.execute(params)));
+        } catch (error) {
+          throw NitroSQLiteError.fromError(error);
+        }
+      },
+      executeAsync: async params => {
+        try {
+          return await queueOperationAsync(queueKey, async () => buildJSQueryResult(await nativeStatement.executeAsync(params)));
+        } catch (error) {
+          throw NitroSQLiteError.fromError(error);
+        }
+      },
+      finalize: () => {
+        try {
+          startOperationSync(queueKey, () => nativeStatement.finalize());
+        } catch (error) {
+          throw NitroSQLiteError.fromError(error);
+        }
+      }
+    };
+  } catch (error) {
+    throw NitroSQLiteError.fromError(error);
+  }
+}
+//# sourceMappingURL=prepare.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["HybridNitroSQLite","NitroSQLiteError","buildJSQueryResult","queueOperationAsync","startOperationSync","prepare","dbName","query","queueKey","nativeStatement","isFinalized","execute","params","error","fromError","executeAsync","finalize"],"sourceRoot":"../../../src","sources":["operations/prepare.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,aAAU;AAC5C,OAAOC,gBAAgB,MAAM,wBAAqB;AAOlD,SAASC,kBAAkB,QAAQ,cAAW;AAC9C,SAASC,mBAAmB,EAAEC,kBAAkB,QAAQ,qBAAkB;AAG1E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CACrBC,MAAc,EACdC,KAAa,EACbC,QAA0B,GAAGF,MAAM,EAChB;EACnB,IAAI;IACF,MAAMG,eAAe,GAAGL,kBAAkB,CAACI,QAAQ,EAAE,MACnDR,iBAAiB,CAACK,OAAO,CAACC,MAAM,EAAEC,KAAK,CACzC,CAAC;IAED,OAAO;MACL,IAAIG,WAAWA,CAAA,EAAG;QAChB,OAAOD,eAAe,CAACC,WAAW;MACpC,CAAC;MACDC,OAAO,EACLC,MAA0B,IACL;QACrB,IAAI;UACF,OAAOR,kBAAkB,CAACI,QAAQ,EAAE,MAClCN,kBAAkB,CAACO,eAAe,CAACE,OAAO,CAACC,MAAM,CAAC,CACpD,CAAC;QACH,CAAC,CAAC,OAAOC,KAAK,EAAE;UACd,MAAMZ,gBAAgB,CAACa,SAAS,CAACD,KAAK,CAAC;QACzC;MACF,CAAC;MACDE,YAAY,EAAE,MACZH,MAA0B,IACI;QAC9B,IAAI;UACF,OAAO,MAAMT,mBAAmB,CAACK,QAAQ,EAAE,YACzCN,kBAAkB,CAAC,MAAMO,eAAe,CAACM,YAAY,CAACH,MAAM,CAAC,CAC/D,CAAC;QACH,CAAC,CAAC,OAAOC,KAAK,EAAE;UACd,MAAMZ,gBAAgB,CAACa,SAAS,CAACD,KAAK,CAAC;QACzC;MACF,CAAC;MACDG,QAAQ,EAAEA,CAAA,KAAM;QACd,IAAI;UACFZ,kBAAkB,CAACI,QAAQ,EAAE,MAAMC,eAAe,CAACO,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,OAAOH,KAAK,EAAE;UACd,MAAMZ,gBAAgB,CAACa,SAAS,CAACD,KAAK,CAAC;QACzC;MACF;IACF,CAAC;EACH,CAAC,CAAC,OAAOA,KAAK,EAAE;IACd,MAAMZ,gBAAgB,CAACa,SAAS,CAACD,KAAK,CAAC;EACzC;AACF","ignoreList":[]}