react-native-nitro-sqlite 9.8.2 → 10.0.0

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

@@ -1,3 +1,11 @@
 import type { NitroSQLiteConnection, NitroSQLiteConnectionOptions } from '../types';
+/**
+ * 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 declare function open(options: NitroSQLiteConnectionOptions): NitroSQLiteConnection;
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/operations/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,qBAAqB,EACrB,4BAA4B,EAK7B,MAAM,UAAU,CAAA;AAYjB,wBAAgB,IAAI,CAClB,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAwEvB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/operations/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,qBAAqB,EACrB,4BAA4B,EAK7B,MAAM,UAAU,CAAA;AAejB;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAClB,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAgIvB"}

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

@@ -1,3 +1,13 @@
 import type { Transaction } from '../types';
-export declare const transaction: <Result = void>(dbName: string, transactionCallback: (tx: Transaction) => Promise<Result>, isExclusive?: boolean) => Promise<Result>;
+import type { DatabaseQueueKey } from '../DatabaseQueue';
+/** 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 declare const transaction: <Result = void>(dbName: string, transactionCallback: (tx: Transaction) => Promise<Result>, isExclusive?: boolean, queueKey?: DatabaseQueueKey) => Promise<Result>;
 //# sourceMappingURL=transaction.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../../src/operations/transaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,UAAU,CAAA;AAIjB,eAAO,MAAM,WAAW,GAAU,MAAM,GAAG,IAAI,EAC7C,QAAQ,MAAM,EACd,qBAAqB,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,EACzD,qBAAmB,oBA+EpB,CAAA"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../../src/operations/transaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,UAAU,CAAA;AAGjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAU,MAAM,GAAG,IAAI,EAC7C,QAAQ,MAAM,EACd,qBAAqB,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,EACzD,qBAAmB,EACnB,WAAU,gBAAyB,oBAqGpC,CAAA"}

package/lib/typescript/commonjs/specs/NitroSQLite.nitro.d.ts

@@ -1,20 +1,101 @@
 import type { HybridObject } from 'react-native-nitro-modules';
 import type { BatchQueryCommand, BatchQueryResult, FileLoadResult, SQLiteQueryParams } from '../types';
 import type { NitroSQLiteQueryResult } from './NitroSQLiteQueryResult.nitro';
+import type { NitroSQLitePreparedStatement } from './NitroSQLitePreparedStatement.nitro';
+/** Native database operations exposed through `NitroSQLite.native`.
+ * These calls bypass the managed connection queue. Coordinate them with any
+ * transaction or pending operation on the same database yourself.
+ */
 export interface NitroSQLite extends HybridObject<{
     ios: 'c++';
     android: 'c++';
 }> {
-    open(dbName: string, location?: string): void;
+    /** Open a name-based default connection, creating the database unless `readOnly` is true.
+     * @param dbName Database file name and default connection key.
+     * @param location Directory relative to the platform database directory.
+     * @param readOnly Open an existing database without write access.
+     */
+    open(dbName: string, location?: string, readOnly?: boolean): void;
+    /** Open a separate native handle, even when the database file is already open.
+     * Independent connections require a thread-safe SQLite build.
+     * @param dbName Database file name.
+     * @param location Directory relative to the platform database directory.
+     * @param readOnly Open an existing database without write access.
+     * @returns An opaque ID to pass to native connection operations.
+     */
+    openConnection(dbName: string, location?: string, readOnly?: boolean): string;
+    /** Check whether a native connection ID is still open.
+     * @param connectionId ID returned by `openConnection`.
+     */
+    isConnectionOpen(connectionId: string): boolean;
+    /** Close a default connection by name or an independent connection by ID. */
     close(dbName: string): void;
-    drop(dbName: string, location?: string): void;
+    /** Delete a database and close the indicated connection if open.
+     * Deletion fails while another connection or attachment uses the database file.
+     * @param dbName Database file name.
+     * @param location Directory relative to the platform database directory.
+     * @param connectionId Optional ID of the independent connection to close.
+     */
+    drop(dbName: string, location?: string, connectionId?: string): void;
+    /** Attach a database file to an open main database under an SQL schema alias.
+     * @param mainDbName Name of the open main database.
+     * @param dbNameToAttach File name of the database to attach.
+     * @param alias SQL schema name for the attached database.
+     * @param location Directory relative to the platform database directory.
+     */
     attach(mainDbName: string, dbNameToAttach: string, alias: string, location?: string): void;
+    /** Detach an attached database by its alias.
+     * @param mainDbName Name of the open main database.
+     * @param alias SQL schema name used when attaching.
+     */
     detach(mainDbName: string, alias: string): void;
+    /** Execute one SQL statement synchronously on the calling thread.
+     * @param dbName Name of an open database.
+     * @param query SQL statement with optional positional placeholders.
+     * @param params Positional values bound to SQL placeholders.
+     * @returns Native query rows, affected row count, insert ID, and metadata.
+     */
     execute(dbName: string, query: string, params?: SQLiteQueryParams): NitroSQLiteQueryResult;
+    /** Execute one SQL statement on a background thread.
+     * @param dbName Name of an open database.
+     * @param query SQL statement with optional positional placeholders.
+     * @param params Positional values bound to SQL placeholders.
+     * @returns A promise of the native query result.
+     */
     executeAsync(dbName: string, query: string, params?: SQLiteQueryParams): Promise<NitroSQLiteQueryResult>;
+    /** Prepare one SQL statement on an open native connection for repeated execution.
+     * Finalize the returned statement before closing its connection.
+     * @param dbName Name or ID of an open database connection.
+     * @param query SQL statement with optional positional placeholders.
+     * @returns A native statement with synchronous and asynchronous execution methods.
+     */
+    prepare(dbName: string, query: string): NitroSQLitePreparedStatement;
+    /** Execute commands in one exclusive transaction on the calling thread.
+     * An empty batch throws; a failed command rolls back the batch.
+     * @param dbName Name of an open database.
+     * @param commands SQL commands and optional parameter sets.
+     * @returns Total affected row count.
+     */
     executeBatch(dbName: string, commands: BatchQueryCommand[]): BatchQueryResult;
+    /** Execute commands in one exclusive transaction on a background thread.
+     * An empty batch rejects; a failed command rolls back the batch.
+     * @param dbName Name of an open database.
+     * @param commands SQL commands and optional parameter sets.
+     * @returns A promise of the total affected row count.
+     */
     executeBatchAsync(dbName: string, commands: BatchQueryCommand[]): Promise<BatchQueryResult>;
+    /** Import a SQL file in one exclusive transaction on the calling thread.
+     * Each non-empty line is treated as one statement.
+     * @param dbName Name of an open database.
+     * @param location Path to the SQL file.
+     * @returns Number of executed commands and affected rows.
+     */
     loadFile(dbName: string, location: string): FileLoadResult;
+    /** Import a SQL file on a background thread.
+     * @param dbName Name of an open database.
+     * @param location Path to the SQL file.
+     * @returns A promise of the command and affected row counts.
+     */
     loadFileAsync(dbName: string, location: string): Promise<FileLoadResult>;
 }
 //# sourceMappingURL=NitroSQLite.nitro.d.ts.map

package/lib/typescript/commonjs/specs/NitroSQLite.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroSQLite.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroSQLite.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAClB,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAE5E,MAAM,WAAW,WACf,SAAQ,YAAY,CAAC;IACnB,GAAG,EAAE,KAAK,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;CACf,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAAA;IACP,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/C,OAAO,CACL,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,sBAAsB,CAAA;IACzB,YAAY,CACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAClC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,CAAA;IAC7E,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAA;IAC1D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACzE"}
+{"version":3,"file":"NitroSQLite.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroSQLite.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAClB,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AAExF;;;GAGG;AACH,MAAM,WAAW,WACf,SAAQ,YAAY,CAAC;IACnB,GAAG,EAAE,KAAK,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;CACf,CAAC;IACF;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACjE;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC7E;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/C,6EAA6E;IAC7E,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpE;;;;;OAKG;IAEH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAAA;IACP;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/C;;;;;OAKG;IACH,OAAO,CACL,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,sBAAsB,CAAA;IACzB;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAClC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,4BAA4B,CAAA;IACpE;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,CAAA;IAC7E;;;;;OAKG;IACH,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAA;IAC1D;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACzE"}

package/lib/typescript/commonjs/specs/NitroSQLitePreparedStatement.nitro.d.ts

@@ -0,0 +1,26 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type { SQLiteQueryParams } from '../types';
+import type { NitroSQLiteQueryResult } from './NitroSQLiteQueryResult.nitro';
+/** Native prepared statement returned by `NitroSQLite.native.prepare()`. */
+export interface NitroSQLitePreparedStatement extends HybridObject<{
+    ios: 'c++';
+    android: 'c++';
+}> {
+    /** Whether the native statement has been finalized. */
+    readonly isFinalized: boolean;
+    /** Execute on the calling thread, replacing the previous parameter bindings.
+     * Throws after finalization or connection closure.
+     * @param params Values bound to positional placeholders.
+     * @returns Native query rows, affected row count, insert ID, and metadata.
+     */
+    execute(params?: SQLiteQueryParams): NitroSQLiteQueryResult;
+    /** Execute on a background thread, replacing the previous parameter bindings.
+     * Rejects after finalization or connection closure.
+     * @param params Values bound to positional placeholders.
+     * @returns A promise of the native query result.
+     */
+    executeAsync(params?: SQLiteQueryParams): Promise<NitroSQLiteQueryResult>;
+    /** Release the native statement. Repeated calls are safe. */
+    finalize(): void;
+}
+//# sourceMappingURL=NitroSQLitePreparedStatement.nitro.d.ts.map

package/lib/typescript/commonjs/specs/NitroSQLitePreparedStatement.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NitroSQLitePreparedStatement.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroSQLitePreparedStatement.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAE5E,4EAA4E;AAC5E,MAAM,WAAW,4BACf,SAAQ,YAAY,CAAC;IACnB,GAAG,EAAE,KAAK,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;CACf,CAAC;IACF,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAE7B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,sBAAsB,CAAA;IAC3D;;;;OAIG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACzE,6DAA6D;IAC7D,QAAQ,IAAI,IAAI,CAAA;CACjB"}

package/lib/typescript/commonjs/specs/NitroSQLiteQueryResult.nitro.d.ts

@@ -1,32 +1,26 @@
 import type { HybridObject } from 'react-native-nitro-modules';
 import type { ColumnType, SQLiteValue } from '../types';
-/**
- * Object returned by SQL Query executions {
- *  insertId: Represent the auto-generated row id if applicable
- *  rowsAffected: Number of affected rows if result of a update query
- *  message: if status === 1, here you will find error description
- *  rows: if status is undefined or 0 this object will contain the query results
- * }
- *
- * @interface QueryResult
- */
+/** Native result of one SQL statement. The managed API also adds a `rows` adapter. */
 export interface NitroSQLiteQueryResult extends HybridObject<{
     ios: 'c++';
     android: 'c++';
 }> {
+    /** SQLite's latest row change count. For a read-only query it may reflect an earlier write. */
     readonly rowsAffected: number;
+    /** Last insert row ID for this connection. It may refer to an earlier statement. */
     readonly insertId?: number;
-    /** Query results */
+    /** Rows keyed by result column names. */
     readonly results: Record<string, SQLiteValue>[];
-    /** Table metadata */
+    /** Column metadata keyed by result column name, when available. */
     readonly metadata?: Record<string, NitroSQLiteQueryColumnMetadata>;
 }
+/** Name, declared type, and position of a result column. */
 export type NitroSQLiteQueryColumnMetadata = {
-    /** The name used for this column for this result set */
+    /** Name used for this column in the result set. */
     name: string;
-    /** 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. */
+    /** Native type category derived from the column declaration. */
     type: ColumnType;
-    /** The index for this column for this result set */
+    /** Zero-based position in the result set. */
     index: number;
 };
 //# sourceMappingURL=NitroSQLiteQueryResult.nitro.d.ts.map

package/lib/typescript/commonjs/specs/NitroSQLiteQueryResult.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroSQLiteQueryResult.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroSQLiteQueryResult.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,sBACf,SAAQ,YAAY,CAAC;IACnB,GAAG,EAAE,KAAK,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;CACf,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAA;IAE/C,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAA;CACnE;AASD,MAAM,MAAM,8BAA8B,GAAG;IAC3C,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IAEZ,uLAAuL;IACvL,IAAI,EAAE,UAAU,CAAA;IAEhB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;CACd,CAAA"}
+{"version":3,"file":"NitroSQLiteQueryResult.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroSQLiteQueryResult.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEvD,sFAAsF;AACtF,MAAM,WAAW,sBACf,SAAQ,YAAY,CAAC;IACnB,GAAG,EAAE,KAAK,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;CACf,CAAC;IACF,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAA;IAE/C,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAA;CACnE;AASD,4DAA4D;AAC5D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IAEZ,gEAAgE;IAChE,IAAI,EAAE,UAAU,CAAA;IAEhB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;CACd,CAAA"}

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

@@ -1,16 +1,27 @@
 import type { Transaction, SQLiteQueryParams, QueryResultRow, QueryResult } from './types';
+/** Callback-oriented connection returned to TypeORM. */
 interface TypeOrmNitroSQLiteConnection {
+    /** Execute SQL asynchronously and report the result through a callback. */
     executeSql: <RowData extends QueryResultRow = never>(sql: string, params: SQLiteQueryParams | undefined, okExecute: (res: QueryResult<RowData>) => void, failExecute: (msg: string) => void) => Promise<void>;
+    /** Run TypeORM work in a managed transaction. */
     transaction: (fn: (tx: Transaction) => Promise<void>) => Promise<void>;
+    /** Close the connection and report completion through callbacks. */
     close: (okClose: () => void, failClose: (e: unknown) => void) => void;
+    /** Attach another database and invoke `callback` after it succeeds. */
     attach: (dbNameToAttach: string, alias: string, location: string | undefined, callback: () => void) => void;
+    /** Detach an attached database and invoke `callback` after it succeeds. */
     detach: (alias: string, callback: () => void) => void;
 }
-/**
- * DO NOT USE THIS! THIS IS MEANT FOR TYPEORM
- * If you are looking for a convenience wrapper use `connect`
+/** 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 declare 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: {
         name: string;
         location?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"typeORM.d.ts","sourceRoot":"","sources":["../../../src/typeORM.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAA;AAGhB,UAAU,4BAA4B;IACpC,UAAU,EAAE,CAAC,OAAO,SAAS,cAAc,GAAG,KAAK,EACjD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAC9C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAC/B,OAAO,CAAC,IAAI,CAAC,CAAA;IAClB,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAA;IACrE,MAAM,EAAE,CACN,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,IAAI,KACjB,IAAI,CAAA;IACT,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;CACtD;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;4BAEb;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,MACG,CAAC,EAAE,EAAE,4BAA4B,KAAK,IAAI,QACxC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAC1B,4BAA4B,GAAG,IAAI;CAuDvC,CAAA"}
+{"version":3,"file":"typeORM.d.ts","sourceRoot":"","sources":["../../../src/typeORM.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAA;AAGhB,wDAAwD;AACxD,UAAU,4BAA4B;IACpC,2EAA2E;IAC3E,UAAU,EAAE,CAAC,OAAO,SAAS,cAAc,GAAG,KAAK,EACjD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAC9C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAC/B,OAAO,CAAC,IAAI,CAAC,CAAA;IAClB,iDAAiD;IACjD,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,oEAAoE;IACpE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAA;IACrE,uEAAuE;IACvE,MAAM,EAAE,CACN,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,IAAI,KACjB,IAAI,CAAA;IACT,2EAA2E;IAC3E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;CACtD;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB;;;;OAIG;4BAEQ;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,MACG,CAAC,EAAE,EAAE,4BAA4B,KAAK,IAAI,QACxC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAC1B,4BAA4B,GAAG,IAAI;CAuDvC,CAAA"}

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

@@ -1,78 +1,181 @@
 import type { NitroSQLiteQueryResult } from './specs/NitroSQLiteQueryResult.nitro';
+/** Options for `open()` and `NitroSQLite.open()`. */
 export interface NitroSQLiteConnectionOptions {
+    /** Database file name. Only one managed connection may use a name at a time. */
     name: string;
+    /** Directory relative to the platform's database directory. */
     location?: string;
+    /**
+     * Choose a connection to the database file. The default connection is addressed
+     * by `name`, so opening it twice throws. Each `independent` connection has its
+     * own native handle and operation queue and can share a file with other connections.
+     * Defaults to `'default'`.
+     */
+    connection?: 'default' | 'independent';
+    /**
+     * Open an existing database without write access. Opening fails if the file does
+     * not exist. A read-only connection cannot write, attach, or delete a database.
+     * Defaults to `false`.
+     */
+    readOnly?: boolean;
 }
+/** A managed connection bound to one database name. Do not use it after closing or deleting it. */
 export interface NitroSQLiteConnection {
+    /** Close the connection. Throws if a queued operation is running or pending. */
     close(): void;
+    /** Delete the database file and end this connection. Throws if the connection is busy.
+     * This also closes the native handle if it is open.
+     */
     delete(): void;
+    /** Attach another database under `alias` for queries against this connection.
+     * @param dbNameToAttach File name of the database to attach.
+     * @param alias SQL schema name for the attached database.
+     * @param location Directory relative to the platform database directory.
+     */
     attach(dbNameToAttach: string, alias: string, location?: string): void;
+    /** Detach the database identified by `alias`.
+     * @param alias SQL schema name used when attaching the database.
+     */
     detach(alias: string): void;
+    /** Run a callback in a queued transaction. The callback must use `tx` for database work.
+     * It commits on success and rolls back on error unless explicitly finalized.
+     * Awaiting another queued operation for this database inside the callback deadlocks.
+     * Synchronous connection methods throw while this transaction is active.
+     * @param transactionCallback Async callback receiving the transaction handle.
+     * @returns The callback's result after the transaction finishes.
+     */
     transaction: <Result = void>(transactionCallback: (tx: Transaction) => Promise<Result>) => Promise<Result>;
+    /** Execute one SQL statement synchronously. Throws while the connection is busy. */
     execute: ExecuteQuery;
+    /** Queue one SQL statement and resolve with its result. */
     executeAsync: ExecuteAsyncQuery;
+    /**
+     * Prepare one SQL statement on this connection for repeated execution.
+     * Finalize the returned statement before closing the connection.
+     * @param query SQL statement with optional positional placeholders.
+     */
+    prepare(query: string): PreparedStatement;
+    /** Execute commands in one exclusive transaction. Throws while the connection is busy.
+     * @param commands SQL commands and optional parameter sets.
+     * @returns Total affected row count.
+     */
     executeBatch(commands: BatchQueryCommand[]): BatchQueryResult;
+    /** Queue commands in one exclusive transaction.
+     * @param commands SQL commands and optional parameter sets.
+     * @returns A promise of the total affected row count.
+     */
     executeBatchAsync(commands: BatchQueryCommand[]): Promise<BatchQueryResult>;
+    /** Execute one non-empty SQL command per file line in an exclusive transaction.
+     * `location` is a path to the SQL file; multi-line statements are unsupported.
+     * @param location Path to the SQL file.
+     * @returns Number of executed commands and affected rows.
+     */
     loadFile(location: string): FileLoadResult;
+    /** Queue the file import and resolve with its command and row counts.
+     * @param location Path to the SQL file.
+     */
     loadFileAsync(location: string): Promise<FileLoadResult>;
 }
+/** SQLite value categories reported in query column metadata. */
 export declare enum ColumnType {
+    /** Boolean declaration. */
     BOOLEAN = 0,
+    /** Floating point declaration. */
     NUMBER = 1,
+    /** Integer declaration. */
     INT64 = 2,
+    /** Text declaration. */
     TEXT = 3,
+    /** Blob declaration. */
     ARRAY_BUFFER = 4,
+    /** Missing or unrecognized declaration. */
     NULL_VALUE = 5
 }
+/** Values accepted by bound SQL parameters and returned in result rows. */
 export type SQLiteValue = boolean | number | string | ArrayBuffer | null;
+/** Positional values for SQL placeholders. */
 export type SQLiteQueryParams = SQLiteValue[];
+/** A row keyed by result column names. */
 export type QueryResultRow = Record<string, SQLiteValue>;
+/** Query result with a row adapter for TypeORM-style consumers. */
 export type QueryResult<Row extends QueryResultRow = QueryResultRow> = NitroSQLiteQueryResult & {
-    /** Query results in a row format for TypeORM compatibility */
+    /** Query rows in a TypeORM-compatible collection. */
     rows: NitroSQLiteQueryResultRows<Row>;
 };
+/** Indexable view of query rows. */
 export type NitroSQLiteQueryResultRows<Row extends Record<string, SQLiteValue> = Record<string, SQLiteValue>> = {
-    /** Raw array with all dataset */
+    /** All returned rows. */
     _array: Row[];
-    /** The lengh of the dataset */
+    /** Number of returned rows. */
     length: number;
-    /** A convenience function to acess the index based the row object
-     * @param idx the row index
-     * @returns the row structure identified by column names
+    /** Get a row by zero-based index; returns `undefined` when out of range.
+     * @param idx Row index.
      */
     item: (idx: number) => Row | undefined;
 };
+/** 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.
+ */
 export type ExecuteQuery = <Row extends QueryResultRow = QueryResultRow>(query: string, params?: SQLiteValue[]) => QueryResult<Row>;
+/** 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.
+ */
 export type ExecuteAsyncQuery = <Row extends QueryResultRow = QueryResultRow>(query: string, params?: SQLiteQueryParams) => Promise<QueryResult<Row>>;
+/**
+ * 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.
+ */
+export interface PreparedStatement {
+    /** Whether `finalize()` has released the native statement. */
+    readonly isFinalized: boolean;
+    /** Execute on the calling thread. Throws if the statement is finalized, its connection is closed, or the managed connection is busy. */
+    execute: ExecutePreparedStatement;
+    /** Queue execution on a background thread and resolve with the query result. */
+    executeAsync: ExecutePreparedStatementAsync;
+    /** Release the native statement. Calling this more than once is safe. */
+    finalize(): void;
+}
+/**
+ * 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.
+ */
+export type ExecutePreparedStatement = <Row extends QueryResultRow = QueryResultRow>(params?: SQLiteQueryParams) => QueryResult<Row>;
+/**
+ * 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.
+ */
+export type ExecutePreparedStatementAsync = <Row extends QueryResultRow = QueryResultRow>(params?: SQLiteQueryParams) => Promise<QueryResult<Row>>;
+/** Handle valid only while its transaction callback is active. */
 export interface Transaction {
+    /** Commit now. Further operations on this transaction throw. */
     commit(): NitroSQLiteQueryResult;
+    /** Roll back now. Further operations on this transaction throw. */
     rollback(): NitroSQLiteQueryResult;
+    /** Execute within this transaction on the calling thread. */
     execute: ExecuteQuery;
+    /** Execute within this transaction on a background thread. */
     executeAsync: ExecuteAsyncQuery;
 }
-/**
- * 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.
- */
+/** One command in a batch. A nested `params` array repeats the query for each parameter set. */
 export interface BatchQueryCommand {
+    /** SQL statement to execute. */
     query: string;
+    /** One parameter set, or several sets for repeated execution. */
     params?: SQLiteQueryParams | SQLiteQueryParams[];
 }
-/**
- * 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
- */
+/** Result of a committed SQL batch. Errors are thrown rather than returned here. */
 export interface BatchQueryResult {
+    /** Total number of rows changed by the batch. */
     rowsAffected?: number;
 }
-/**
- * Result of loading a file and executing every line as a SQL command
- * Similar to BatchQueryResult
- */
+/** Result of importing a SQL file in one transaction. */
 export interface FileLoadResult extends BatchQueryResult {
+    /** Number of non-empty lines executed as SQL commands. */
     commands?: number;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/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/module/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/module/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/module/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/module/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/module/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"}