@capgo/capacitor-fast-sql 8.0.24 → 8.0.25

package/README.md

@@ -125,6 +125,26 @@ const db = await FastSQL.connect({
 
 If SQLCipher is not installed and `encrypted: true` is passed, the plugin returns a clear error message instead of crashing.
 
+## Web Platform
+
+On the web, this plugin uses [sql.js](https://sql.js.org/) (SQLite compiled to WebAssembly) with IndexedDB for persistence.
+
+By default, the plugin loads `sql-wasm.js` and `sql-wasm.wasm` from the cdnjs CDN. If you want to bundle these files with your web application (to avoid a CDN dependency), call `configureWeb()` once at startup **before** the first `connect()`:
+
+```typescript
+import { CapgoCapacitorFastSql, FastSQL } from '@capgo/capacitor-fast-sql';
+
+// Point to your locally bundled sql.js files
+await CapgoCapacitorFastSql.configureWeb({
+  sqlJsUrl: '/assets/sql-wasm.js',
+  wasmUrl: '/assets/sql-wasm.wasm',
+});
+
+const db = await FastSQL.connect({ database: 'myapp' });
+```
+
+`configureWeb()` is a no-op on iOS and Android — it is safe to call unconditionally.
+
 ## Usage
 
 ### Basic Example
@@ -219,6 +239,7 @@ await kv.remove('session');
 * [`commitTransaction(...)`](#committransaction)
 * [`rollbackTransaction(...)`](#rollbacktransaction)
 * [`getPluginVersion()`](#getpluginversion)
+* [`configureWeb(...)`](#configureweb)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 * [Enums](#enums)
@@ -374,6 +395,27 @@ Get the native Capacitor plugin version.
 --------------------
 
 
+### configureWeb(...)
+
+```typescript
+configureWeb(config: WebConfig) => Promise<void>
+```
+
+Configure web-specific options for the sql.js WASM module.
+
+Call this **before** the first `connect()` call to load sql.js from a
+locally bundled path instead of the default CDN. This method is a no-op
+on iOS and Android.
+
+| Param        | Type                                            | Description                 |
+| ------------ | ----------------------------------------------- | --------------------------- |
+| **`config`** | <code><a href="#webconfig">WebConfig</a></code> | - Web configuration options |
+
+**Since:** 0.0.1
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -480,6 +522,18 @@ buffer as needed.
 | **slice** | (begin: number, end?: number \| undefined) =&gt; <a href="#arraybuffer">ArrayBuffer</a> | Returns a section of an <a href="#arraybuffer">ArrayBuffer</a>. |
 
 
+#### WebConfig
+
+Web platform configuration for the sql.js WASM module.
+Use with `configureWeb()` to load sql.js
+from a locally bundled path instead of the default CDN.
+
+| Prop           | Type                | Description                                                                                                |
+| -------------- | ------------------- | ---------------------------------------------------------------------------------------------------------- |
+| **`sqlJsUrl`** | <code>string</code> | URL to the sql.js JavaScript file (`sql-wasm.js`). When omitted, the plugin loads from the cdnjs CDN.      |
+| **`wasmUrl`**  | <code>string</code> | URL to the sql.js WebAssembly binary (`sql-wasm.wasm`). When omitted, the plugin loads from the cdnjs CDN. |
+
+
 ### Type Aliases
 
 

package/android/build.gradle

@@ -54,7 +54,7 @@ dependencies {
     implementation 'androidx.sqlite:sqlite:2.6.2'
     implementation 'com.google.code.gson:gson:2.13.2'
     implementation 'org.nanohttpd:nanohttpd:2.3.1'
-    compileOnly 'net.zetetic:sqlcipher-android:4.13.0'
+    compileOnly 'net.zetetic:sqlcipher-android:4.14.0'
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

package/android/src/main/java/app/capgo/capacitor/fastsql/CapgoCapacitorFastSqlPlugin.java

@@ -19,7 +19,7 @@ import java.util.Map;
 @CapacitorPlugin(name = "CapgoCapacitorFastSql")
 public class CapgoCapacitorFastSqlPlugin extends Plugin {
 
-    private final String pluginVersion = "8.0.24";
+    private final String pluginVersion = "8.0.25";
 
     private Map<String, DatabaseConnection> databases = new HashMap<>();
     private SQLHTTPServer server;
@@ -235,6 +235,12 @@ public class CapgoCapacitorFastSqlPlugin extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void configureWeb(PluginCall call) {
+        // No-op on Android — web configuration is only relevant on the web platform.
+        call.resolve();
+    }
+
     @PluginMethod
     public void getPluginVersion(PluginCall call) {
         JSObject ret = new JSObject();

package/android/src/main/java/app/capgo/capacitor/fastsql/EncryptedSQLDatabase.java

@@ -17,7 +17,7 @@ import org.json.JSONObject;
 public class EncryptedSQLDatabase implements DatabaseConnection {
 
     private SQLiteDatabase db;
-    private boolean inTransaction = false;
+    private volatile boolean inTransaction = false;
 
     public EncryptedSQLDatabase(String path, String encryptionKey) throws Exception {
         if (encryptionKey == null || encryptionKey.isEmpty()) {
@@ -119,28 +119,27 @@ public class EncryptedSQLDatabase implements DatabaseConnection {
         }
     }
 
-    public void beginTransaction() throws Exception {
+    public synchronized void beginTransaction() throws Exception {
         if (inTransaction) {
             throw new Exception("Transaction already active");
         }
-        db.beginTransaction();
+        db.execSQL("BEGIN TRANSACTION");
         inTransaction = true;
     }
 
-    public void commitTransaction() throws Exception {
+    public synchronized void commitTransaction() throws Exception {
         if (!inTransaction) {
             throw new Exception("No transaction active");
         }
-        db.setTransactionSuccessful();
-        db.endTransaction();
+        db.execSQL("COMMIT");
         inTransaction = false;
     }
 
-    public void rollbackTransaction() throws Exception {
+    public synchronized void rollbackTransaction() throws Exception {
         if (!inTransaction) {
             throw new Exception("No transaction active");
         }
-        db.endTransaction();
+        db.execSQL("ROLLBACK");
         inTransaction = false;
     }
 

package/android/src/main/java/app/capgo/capacitor/fastsql/SQLDatabase.java

@@ -18,7 +18,7 @@ import org.json.JSONObject;
 public class SQLDatabase implements DatabaseConnection {
 
     private SQLiteDatabase db;
-    private boolean inTransaction = false;
+    private volatile boolean inTransaction = false;
 
     public SQLDatabase(String path) {
         this.db = SQLiteDatabase.openOrCreateDatabase(path, null);
@@ -113,28 +113,27 @@ public class SQLDatabase implements DatabaseConnection {
         }
     }
 
-    public void beginTransaction() throws Exception {
+    public synchronized void beginTransaction() throws Exception {
         if (inTransaction) {
             throw new Exception("Transaction already active");
         }
-        db.beginTransaction();
+        db.execSQL("BEGIN TRANSACTION");
         inTransaction = true;
     }
 
-    public void commitTransaction() throws Exception {
+    public synchronized void commitTransaction() throws Exception {
         if (!inTransaction) {
             throw new Exception("No transaction active");
         }
-        db.setTransactionSuccessful();
-        db.endTransaction();
+        db.execSQL("COMMIT");
         inTransaction = false;
     }
 
-    public void rollbackTransaction() throws Exception {
+    public synchronized void rollbackTransaction() throws Exception {
         if (!inTransaction) {
             throw new Exception("No transaction active");
         }
-        db.endTransaction();
+        db.execSQL("ROLLBACK");
         inTransaction = false;
     }
 

package/dist/esm/definitions.d.ts

@@ -59,6 +59,25 @@ export interface SQLConnectionOptions {
      */
     readOnly?: boolean;
 }
+/**
+ * Web platform configuration for the sql.js WASM module.
+ * Use with `configureWeb()` to load sql.js
+ * from a locally bundled path instead of the default CDN.
+ */
+export interface WebConfig {
+    /**
+     * URL to the sql.js JavaScript file (`sql-wasm.js`).
+     * When omitted, the plugin loads from the cdnjs CDN.
+     * @example '/assets/sql-wasm.js'
+     */
+    sqlJsUrl?: string;
+    /**
+     * URL to the sql.js WebAssembly binary (`sql-wasm.wasm`).
+     * When omitted, the plugin loads from the cdnjs CDN.
+     * @example '/assets/sql-wasm.wasm'
+     */
+    wasmUrl?: string;
+}
 /**
  * Transaction isolation levels
  */
@@ -221,5 +240,26 @@ export interface CapgoCapacitorFastSqlPlugin {
     getPluginVersion(): Promise<{
         version: string;
     }>;
+    /**
+     * Configure web-specific options for the sql.js WASM module.
+     *
+     * Call this **before** the first `connect()` call to load sql.js from a
+     * locally bundled path instead of the default CDN. This method is a no-op
+     * on iOS and Android.
+     *
+     * @param config - Web configuration options
+     * @returns Promise that resolves when the configuration is applied
+     * @since 0.0.1
+     * @example
+     * ```typescript
+     * // Configure once at app startup (web only)
+     * await CapgoCapacitorFastSql.configureWeb({
+     *   sqlJsUrl: '/assets/sql-wasm.js',
+     *   wasmUrl: '/assets/sql-wasm.wasm',
+     * });
+     * const db = await FastSQL.connect({ database: 'myapp' });
+     * ```
+     */
+    configureWeb(config: WebConfig): Promise<void>;
 }
 //# sourceMappingURL=definitions.d.ts.map

package/dist/esm/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,eAAe,qBAAqB;IACpC,aAAa,mBAAmB;IAChC,cAAc,oBAAoB;IAClC,YAAY,iBAAiB;CAC9B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAC9C,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IAEH;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IAEH;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnG;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhG;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;;;;;;;;;;;;;OAiBG;IACH,mBAAmB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;;;;;;;;OAWG;IACH,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}

package/dist/esm/fast-sql.d.ts

@@ -1,5 +1,5 @@
 import type { SQLConnectionOptions } from './definitions';
-import { SQLConnection } from './sql-connection';
+import type { SQLConnection } from './sql-connection';
 /**
  * FastSQL - High-level API for managing SQL connections
  *

package/dist/esm/fast-sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fast-sql.d.ts","sourceRoot":"","sources":["../../src/fast-sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAyC;IAEnE;;;;;OAKG;WACU,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAmB3E;;;;OAIG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxD;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI5D;;OAEG;WACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3C;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;CAGpC"}
+{"version":3,"file":"fast-sql.d.ts","sourceRoot":"","sources":["../../src/fast-sql.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAyC;IAEnE;;;;;OAKG;WACU,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAyB3E;;;;OAIG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxD;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI5D;;OAEG;WACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3C;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM,EAAE;CAGpC"}

package/dist/esm/fast-sql.js

@@ -1,5 +1,7 @@
+import { Capacitor } from '@capacitor/core';
+import { NativeSQLConnection } from './native-sql-connection';
 import { CapgoCapacitorFastSql } from './plugin';
-import { SQLConnection } from './sql-connection';
+import { WebSQLConnection } from './web-sql-connection';
 /**
  * FastSQL - High-level API for managing SQL connections
  *
@@ -21,8 +23,15 @@ export class FastSQL {
         }
         // Connect via native plugin
         const info = await CapgoCapacitorFastSql.connect(options);
-        // Create connection instance
-        const connection = new SQLConnection(info.database, info.port, info.token);
+        // Create connection instance appropriate for the current platform
+        let connection;
+        const platform = Capacitor.getPlatform();
+        if (platform === 'android' || platform === 'ios') {
+            connection = new NativeSQLConnection(info.database, info.port, info.token);
+        }
+        else {
+            connection = new WebSQLConnection(info.database, CapgoCapacitorFastSql);
+        }
         // Store connection
         this.connections.set(options.database, connection);
         return connection;

package/dist/esm/helpers.js

@@ -3,4 +3,3 @@
  * Import these separately: import { FastSQL, SQLConnection } from '@capgo/capacitor-fast-sql/helpers';
  */
 export { FastSQL } from './fast-sql';
-export { SQLConnection } from './sql-connection';

package/dist/esm/index.d.ts

@@ -1,7 +1,9 @@
 export * from './definitions';
 export { CapgoCapacitorFastSql } from './plugin';
 export { FastSQL } from './fast-sql';
-export { SQLConnection } from './sql-connection';
+export type { SQLConnection } from './sql-connection';
+export { NativeSQLConnection } from './native-sql-connection';
+export { WebSQLConnection } from './web-sql-connection';
 export { KeyValueStore } from './key-value';
 export type { KeyValueStoreOptions, KeyValueValue } from './key-value';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/index.js

@@ -2,5 +2,6 @@ export * from './definitions';
 export { CapgoCapacitorFastSql } from './plugin';
 // Re-export helper classes for convenience
 export { FastSQL } from './fast-sql';
-export { SQLConnection } from './sql-connection';
+export { NativeSQLConnection } from './native-sql-connection';
+export { WebSQLConnection } from './web-sql-connection';
 export { KeyValueStore } from './key-value';

package/dist/esm/native-sql-connection.d.ts

@@ -0,0 +1,95 @@
+import type { SQLValue, SQLRow, SQLResult, SQLBatchOperation } from './definitions';
+import { IsolationLevel } from './definitions';
+import type { SQLConnection } from './sql-connection';
+/**
+ * SQL Connection class that uses HTTP protocol for efficient communication
+ * with native SQLite databases, bypassing Capacitor's standard bridge.
+ *
+ * Inspired by capacitor-blob-writer's approach to avoid serialization overhead.
+ */
+export declare class NativeSQLConnection implements SQLConnection {
+    private port;
+    private token;
+    private database;
+    private baseUrl;
+    private inTransaction;
+    constructor(database: string, port: number, token: string);
+    /**
+     * Get the database name
+     */
+    getDatabaseName(): string;
+    /**
+     * Execute a SQL query via HTTP protocol for optimal performance
+     *
+     * @param statement - SQL statement to execute
+     * @param params - Parameters to bind to the statement
+     * @returns Query results
+     */
+    execute(statement: string, params?: SQLValue[]): Promise<SQLResult>;
+    /**
+     * Execute multiple SQL statements in a batch for better performance
+     *
+     * @param operations - Array of SQL operations to execute
+     * @returns Array of results for each operation
+     */
+    executeBatch(operations: SQLBatchOperation[]): Promise<SQLResult[]>;
+    /**
+     * Begin a transaction
+     *
+     * @param isolationLevel - Optional isolation level
+     */
+    beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
+    /**
+     * Commit the current transaction
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback the current transaction
+     */
+    rollback(): Promise<void>;
+    /**
+     * Execute operations within a transaction automatically
+     *
+     * @param callback - Function containing operations to execute
+     * @param isolationLevel - Optional isolation level
+     */
+    transaction<T>(callback: (conn: SQLConnection) => Promise<T>, isolationLevel?: IsolationLevel): Promise<T>;
+    /**
+     * Query helper for SELECT statements
+     *
+     * @param statement - SELECT statement
+     * @param params - Query parameters
+     * @returns Array of rows
+     */
+    query(statement: string, params?: SQLValue[]): Promise<SQLRow[]>;
+    /**
+     * Execute helper for INSERT/UPDATE/DELETE statements
+     *
+     * @param statement - SQL statement
+     * @param params - Statement parameters
+     * @returns Number of affected rows and insert ID if applicable
+     */
+    run(statement: string, params?: SQLValue[]): Promise<{
+        rowsAffected: number;
+        insertId?: number;
+    }>;
+    /**
+     * Serialize parameters for transmission
+     * Binary data (Uint8Array) is converted to base64 for JSON transport
+     */
+    private serializeParams;
+    /**
+     * Deserialize result from server
+     * Base64-encoded binary data is converted back to Uint8Array
+     */
+    private deserializeResult;
+    /**
+     * Convert Uint8Array to base64 string
+     */
+    private uint8ArrayToBase64;
+    /**
+     * Convert base64 string to Uint8Array
+     */
+    private base64ToUint8Array;
+}
+//# sourceMappingURL=native-sql-connection.d.ts.map

package/dist/esm/native-sql-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-sql-connection.d.ts","sourceRoot":"","sources":["../../src/native-sql-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;gBAElB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAOzD;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAuBzE;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyBzE;;;;OAIG;IACG,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBtE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/B;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhH;;;;;;OAMG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtE;;;;;;OAMG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAQvG;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}