@capgo/capacitor-fast-sql 7.0.1 → 7.2.6

package/README.md

@@ -8,6 +8,16 @@
 
 High-performance native SQLite plugin with HTTP server for efficient sync operations and IndexedDB replacement.
 
+## Why Fast SQL?
+
+Traditional Capacitor plugins serialize data through the JavaScript bridge, which becomes inefficient with large datasets. Fast SQL solves this by establishing a local HTTP server for direct native communication, making it ideal for:
+
+- **Local-first sync systems** (CRDTs, operational transforms)
+- **IndexedDB replacement** on platforms with broken/limited implementations
+- **Large dataset operations** requiring high throughput
+- **Batch operations** with thousands of rows
+- **Binary data storage** (BLOBs, files)
+
 ## Documentation
 
 The most complete doc is available here: https://capgo.app/docs/plugins/fast-sql/
@@ -59,10 +69,10 @@ Add to your `AndroidManifest.xml` if needed:
 ### Basic Example
 
 ```typescript
-import { NativeSQL } from '@capgo/capacitor-fast-sql';
+import { FastSQL } from '@capgo/capacitor-fast-sql';
 
 // Connect to database
-const db = await NativeSQL.connect({ database: 'myapp' });
+const db = await FastSQL.connect({ database: 'myapp' });
 
 // Create table
 await db.execute(`
@@ -85,13 +95,13 @@ const users = await db.query('SELECT * FROM users WHERE name LIKE ?', ['John%'])
 console.log('Users:', users);
 
 // Close connection
-await NativeSQL.disconnect('myapp');
+await FastSQL.disconnect('myapp');
 ```
 
 ### Transaction Example
 
 ```typescript
-const db = await NativeSQL.connect({ database: 'myapp' });
+const db = await FastSQL.connect({ database: 'myapp' });
 
 try {
   await db.transaction(async (tx) => {
@@ -109,7 +119,7 @@ try {
 ### Batch Operations
 
 ```typescript
-const db = await NativeSQL.connect({ database: 'myapp' });
+const db = await FastSQL.connect({ database: 'myapp' });
 
 const results = await db.executeBatch([
   { statement: 'INSERT INTO logs (message) VALUES (?)', params: ['Log 1'] },
@@ -131,6 +141,7 @@ const results = await db.executeBatch([
 * [`rollbackTransaction(...)`](#rollbacktransaction)
 * [`getPluginVersion()`](#getpluginversion)
 * [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
 * [Enums](#enums)
 
 </docgen-index>
@@ -138,7 +149,7 @@ const results = await db.executeBatch([
 <docgen-api>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-Native SQL Plugin for high-performance SQLite database access.
+Fast SQL Plugin for high-performance SQLite database access.
 
 This plugin uses a custom HTTP-based protocol for efficient data transfer,
 bypassing Capacitor's standard bridge for better performance with sync operations.
@@ -151,8 +162,8 @@ connect(options: SQLConnectionOptions) => Promise<{ port: number; token: string;
 
 Initialize the database connection and start the HTTP server.
 
-| Param         | Type                                                                  | Description         |
-| ------------- | --------------------------------------------------------------------- | ------------------- |
+| Param         | Type                                                                  | Description          |
+| ------------- | --------------------------------------------------------------------- | -------------------- |
 | **`options`** | <code><a href="#sqlconnectionoptions">SQLConnectionOptions</a></code> | - Connection options |
 
 **Returns:** <code>Promise&lt;{ port: number; token: string; database: string; }&gt;</code>
@@ -170,8 +181,8 @@ disconnect(options: { database: string; }) => Promise<void>
 
 Close database connection and stop the HTTP server.
 
-| Param         | Type                               | Description           |
-| ------------- | ---------------------------------- | --------------------- |
+| Param         | Type                               | Description              |
+| ------------- | ---------------------------------- | ------------------------ |
 | **`options`** | <code>{ database: string; }</code> | - Database name to close |
 
 **Since:** 0.0.1
@@ -207,9 +218,9 @@ execute(options: { database: string; statement: string; params?: SQLValue[]; })
 Execute a SQL query via Capacitor bridge (for simple queries).
 For better performance with large datasets, use the HTTP protocol directly via SQLConnection class.
 
-| Param         | Type                                                                                         | Description        |
-| ------------- | -------------------------------------------------------------------------------------------- | ------------------ |
-| **`options`** | <code>{ database: string; statement: string; params?: <a href="#sqlvalue">SQLValue</a>[]; }</code> | - Query parameters |
+| Param         | Type                                                                       | Description        |
+| ------------- | -------------------------------------------------------------------------- | ------------------ |
+| **`options`** | <code>{ database: string; statement: string; params?: SQLValue[]; }</code> | - Query parameters |
 
 **Returns:** <code>Promise&lt;<a href="#sqlresult">SQLResult</a>&gt;</code>
 
@@ -226,8 +237,8 @@ beginTransaction(options: { database: string; isolationLevel?: IsolationLevel; }
 
 Begin a database transaction.
 
-| Param         | Type                                                                                                   | Description             |
-| ------------- | ------------------------------------------------------------------------------------------------------ | ----------------------- |
+| Param         | Type                                                                                              | Description           |
+| ------------- | ------------------------------------------------------------------------------------------------- | --------------------- |
 | **`options`** | <code>{ database: string; isolationLevel?: <a href="#isolationlevel">IsolationLevel</a>; }</code> | - Transaction options |
 
 **Since:** 0.0.1
@@ -291,23 +302,23 @@ Get the native Capacitor plugin version.
 
 Database connection options
 
-| Prop                | Type                 | Description                                         |
-| ------------------- | -------------------- | --------------------------------------------------- |
+| Prop                | Type                 | Description                                                |
+| ------------------- | -------------------- | ---------------------------------------------------------- |
 | **`database`**      | <code>string</code>  | Database name (file will be created in app data directory) |
-| **`encrypted`**     | <code>boolean</code> | Enable encryption (iOS/Android only)                |
-| **`encryptionKey`** | <code>string</code>  | Encryption key (required if encrypted is true)      |
-| **`readOnly`**      | <code>boolean</code> | Read-only mode                                      |
+| **`encrypted`**     | <code>boolean</code> | Enable encryption (iOS/Android only)                       |
+| **`encryptionKey`** | <code>string</code>  | Encryption key (required if encrypted is true)             |
+| **`readOnly`**      | <code>boolean</code> | Read-only mode                                             |
 
 
 #### SQLResult
 
 Result of a SQL query execution
 
-| Prop                | Type                                          | Description                                                      |
-| ------------------- | --------------------------------------------- | ---------------------------------------------------------------- |
-| **`rows`**          | <code><a href="#sqlrow">SQLRow</a>[]</code>  | Rows returned by the query (for SELECT statements)               |
-| **`rowsAffected`**  | <code>number</code>                           | Number of rows affected by the query (for INSERT/UPDATE/DELETE) |
-| **`insertId`**      | <code>number</code>                           | ID of the last inserted row (for INSERT statements with auto-increment) |
+| Prop               | Type                  | Description                                                             |
+| ------------------ | --------------------- | ----------------------------------------------------------------------- |
+| **`rows`**         | <code>SQLRow[]</code> | Rows returned by the query (for SELECT statements)                      |
+| **`rowsAffected`** | <code>number</code>   | Number of rows affected by the query (for INSERT/UPDATE/DELETE)         |
+| **`insertId`**     | <code>number</code>   | ID of the last inserted row (for INSERT statements with auto-increment) |
 
 
 #### SQLRow
@@ -315,19 +326,79 @@ Result of a SQL query execution
 SQL row result - values indexed by column name
 
 
-### Enums
+#### Uint8Array
 
+A typed array of 8-bit unsigned integer values. The contents are initialized to 0. If the
+requested number of bytes could not be allocated an exception is raised.
+
+| Prop                    | Type                                                        | Description                                                                  |
+| ----------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| **`BYTES_PER_ELEMENT`** | <code>number</code>                                         | The size in bytes of each element in the array.                              |
+| **`buffer`**            | <code><a href="#arraybufferlike">ArrayBufferLike</a></code> | The <a href="#arraybuffer">ArrayBuffer</a> instance referenced by the array. |
+| **`byteLength`**        | <code>number</code>                                         | The length in bytes of the array.                                            |
+| **`byteOffset`**        | <code>number</code>                                         | The offset in bytes of the array.                                            |
+| **`length`**            | <code>number</code>                                         | The length of the array.                                                     |
+
+| Method             | Signature                                                                                                                                                                      | Description                                                                                                                                                                                                                                 |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **copyWithin**     | (target: number, start: number, end?: number \| undefined) =&gt; this                                                                                                          | Returns the this object after copying a section of the array identified by start and end to the same array starting at position target                                                                                                      |
+| **every**          | (predicate: (value: number, index: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; unknown, thisArg?: any) =&gt; boolean                                            | Determines whether all the members of an array satisfy the specified test.                                                                                                                                                                  |
+| **fill**           | (value: number, start?: number \| undefined, end?: number \| undefined) =&gt; this                                                                                             | Returns the this object after filling the section identified by start and end with value                                                                                                                                                    |
+| **filter**         | (predicate: (value: number, index: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; any, thisArg?: any) =&gt; <a href="#uint8array">Uint8Array</a>                   | Returns the elements of an array that meet the condition specified in a callback function.                                                                                                                                                  |
+| **find**           | (predicate: (value: number, index: number, obj: <a href="#uint8array">Uint8Array</a>) =&gt; boolean, thisArg?: any) =&gt; number \| undefined                                  | Returns the value of the first element in the array where predicate is true, and undefined otherwise.                                                                                                                                       |
+| **findIndex**      | (predicate: (value: number, index: number, obj: <a href="#uint8array">Uint8Array</a>) =&gt; boolean, thisArg?: any) =&gt; number                                               | Returns the index of the first element in the array where predicate is true, and -1 otherwise.                                                                                                                                              |
+| **forEach**        | (callbackfn: (value: number, index: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; void, thisArg?: any) =&gt; void                                                 | Performs the specified action for each element in an array.                                                                                                                                                                                 |
+| **indexOf**        | (searchElement: number, fromIndex?: number \| undefined) =&gt; number                                                                                                          | Returns the index of the first occurrence of a value in an array.                                                                                                                                                                           |
+| **join**           | (separator?: string \| undefined) =&gt; string                                                                                                                                 | Adds all the elements of an array separated by the specified separator string.                                                                                                                                                              |
+| **lastIndexOf**    | (searchElement: number, fromIndex?: number \| undefined) =&gt; number                                                                                                          | Returns the index of the last occurrence of a value in an array.                                                                                                                                                                            |
+| **map**            | (callbackfn: (value: number, index: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; number, thisArg?: any) =&gt; <a href="#uint8array">Uint8Array</a>               | Calls a defined callback function on each element of an array, and returns an array that contains the results.                                                                                                                              |
+| **reduce**         | (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; number) =&gt; number                       | Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.                      |
+| **reduce**         | (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; number, initialValue: number) =&gt; number |                                                                                                                                                                                                                                             |
+| **reduce**         | &lt;U&gt;(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; U, initialValue: U) =&gt; U            | Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.                      |
+| **reduceRight**    | (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; number) =&gt; number                       | Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function. |
+| **reduceRight**    | (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; number, initialValue: number) =&gt; number |                                                                                                                                                                                                                                             |
+| **reduceRight**    | &lt;U&gt;(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; U, initialValue: U) =&gt; U            | Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function. |
+| **reverse**        | () =&gt; <a href="#uint8array">Uint8Array</a>                                                                                                                                  | Reverses the elements in an Array.                                                                                                                                                                                                          |
+| **set**            | (array: <a href="#arraylike">ArrayLike</a>&lt;number&gt;, offset?: number \| undefined) =&gt; void                                                                             | Sets a value or an array of values.                                                                                                                                                                                                         |
+| **slice**          | (start?: number \| undefined, end?: number \| undefined) =&gt; <a href="#uint8array">Uint8Array</a>                                                                            | Returns a section of an array.                                                                                                                                                                                                              |
+| **some**           | (predicate: (value: number, index: number, array: <a href="#uint8array">Uint8Array</a>) =&gt; unknown, thisArg?: any) =&gt; boolean                                            | Determines whether the specified callback function returns true for any element of an array.                                                                                                                                                |
+| **sort**           | (compareFn?: ((a: number, b: number) =&gt; number) \| undefined) =&gt; this                                                                                                    | Sorts an array.                                                                                                                                                                                                                             |
+| **subarray**       | (begin?: number \| undefined, end?: number \| undefined) =&gt; <a href="#uint8array">Uint8Array</a>                                                                            | Gets a new <a href="#uint8array">Uint8Array</a> view of the <a href="#arraybuffer">ArrayBuffer</a> store for this array, referencing the elements at begin, inclusive, up to end, exclusive.                                                |
+| **toLocaleString** | () =&gt; string                                                                                                                                                                | Converts a number to a string by using the current locale.                                                                                                                                                                                  |
+| **toString**       | () =&gt; string                                                                                                                                                                | Returns a string representation of an array.                                                                                                                                                                                                |
+| **valueOf**        | () =&gt; <a href="#uint8array">Uint8Array</a>                                                                                                                                  | Returns the primitive value of the specified object.                                                                                                                                                                                        |
+
+
+#### ArrayLike
+
+| Prop         | Type                |
+| ------------ | ------------------- |
+| **`length`** | <code>number</code> |
+
+
+#### ArrayBufferTypes
+
+Allowed <a href="#arraybuffer">ArrayBuffer</a> types for the buffer of an ArrayBufferView and related Typed Arrays.
+
+| Prop              | Type                                                |
+| ----------------- | --------------------------------------------------- |
+| **`ArrayBuffer`** | <code><a href="#arraybuffer">ArrayBuffer</a></code> |
 
-#### IsolationLevel
 
-Transaction isolation levels
+#### ArrayBuffer
 
-| Members                | Value                          |
-| ---------------------- | ------------------------------ |
-| **`ReadUncommitted`**  | <code>'READ UNCOMMITTED'</code> |
-| **`ReadCommitted`**    | <code>'READ COMMITTED'</code>   |
-| **`RepeatableRead`**   | <code>'REPEATABLE READ'</code>  |
-| **`Serializable`**     | <code>'SERIALIZABLE'</code>     |
+Represents a raw buffer of binary data, which is used to store data for the
+different typed arrays. ArrayBuffers cannot be read from or written to directly,
+but can be passed to a typed array or DataView Object to interpret the raw
+buffer as needed.
+
+| Prop             | Type                | Description                                                                     |
+| ---------------- | ------------------- | ------------------------------------------------------------------------------- |
+| **`byteLength`** | <code>number</code> | Read-only. The length of the <a href="#arraybuffer">ArrayBuffer</a> (in bytes). |
+
+| Method    | Signature                                                                               | Description                                                     |
+| --------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
+| **slice** | (begin: number, end?: number \| undefined) =&gt; <a href="#arraybuffer">ArrayBuffer</a> | Returns a section of an <a href="#arraybuffer">ArrayBuffer</a>. |
 
 
 ### Type Aliases
@@ -335,6 +406,26 @@ Transaction isolation levels
 
 #### SQLValue
 
-<code>string | number | boolean | null | Uint8Array</code>
+SQL value types supported by the plugin
+
+<code>string | number | boolean | null | <a href="#uint8array">Uint8Array</a></code>
+
+
+#### ArrayBufferLike
+
+<code>ArrayBufferTypes[keyof ArrayBufferTypes]</code>
+
+
+### Enums
+
+
+#### IsolationLevel
+
+| Members               | Value                           |
+| --------------------- | ------------------------------- |
+| **`ReadUncommitted`** | <code>'READ UNCOMMITTED'</code> |
+| **`ReadCommitted`**   | <code>'READ COMMITTED'</code>   |
+| **`RepeatableRead`**  | <code>'REPEATABLE READ'</code>  |
+| **`Serializable`**    | <code>'SERIALIZABLE'</code>     |
 
 </docgen-api>

package/android/build.gradle

@@ -18,7 +18,7 @@ buildscript {
 apply plugin: 'com.android.library'
 
 android {
-    namespace 'app.capgo.capacitor.fastsql'
+    namespace "app.capgo.capacitor.fastsql"
     compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
     defaultConfig {
         minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23

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

@@ -6,7 +6,6 @@ import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
-
 import java.io.File;
 import java.util.HashMap;
 import java.util.Map;
@@ -20,6 +19,8 @@ import java.util.Map;
 @CapacitorPlugin(name = "CapgoCapacitorFastSql")
 public class CapgoCapacitorFastSqlPlugin extends Plugin {
 
+    private final String PLUGIN_VERSION = "7.2.6";
+
     private Map<String, SQLDatabase> databases = new HashMap<>();
     private SQLHTTPServer server;
 
@@ -213,6 +214,13 @@ public class CapgoCapacitorFastSqlPlugin extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void getPluginVersion(PluginCall call) {
+        JSObject ret = new JSObject();
+        ret.put("version", PLUGIN_VERSION);
+        call.resolve(ret);
+    }
+
     private File getDatabasePath(String database) {
         File dataDir = getContext().getFilesDir();
         return new File(dataDir, database + ".db");

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

@@ -4,21 +4,19 @@ import android.database.Cursor;
 import android.database.sqlite.SQLiteDatabase;
 import android.database.sqlite.SQLiteStatement;
 import android.util.Base64;
-
 import com.getcapacitor.JSArray;
 import com.getcapacitor.JSObject;
-
+import java.util.ArrayList;
+import java.util.List;
 import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-import java.util.ArrayList;
-import java.util.List;
-
 /**
  * SQLite database wrapper for Android
  */
 public class SQLDatabase {
+
     private SQLiteDatabase db;
     private boolean inTransaction = false;
 
@@ -41,9 +39,8 @@ public class SQLDatabase {
 
         // Check if this is a query (SELECT) or a modification (INSERT/UPDATE/DELETE)
         String trimmedStatement = statement.trim().toUpperCase();
-        boolean isQuery = trimmedStatement.startsWith("SELECT") ||
-                         trimmedStatement.startsWith("PRAGMA") ||
-                         trimmedStatement.startsWith("EXPLAIN");
+        boolean isQuery =
+            trimmedStatement.startsWith("SELECT") || trimmedStatement.startsWith("PRAGMA") || trimmedStatement.startsWith("EXPLAIN");
 
         if (isQuery) {
             return executeQuery(statement, params);

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

@@ -7,15 +7,12 @@ import com.google.gson.JsonArray;
 import com.google.gson.JsonElement;
 import com.google.gson.JsonObject;
 import com.google.gson.JsonParser;
-
-import org.json.JSONArray;
-import org.json.JSONObject;
-
+import fi.iki.elonen.NanoHTTPD; // Note: org.nanohttpd:nanohttpd:2.3.1 still uses fi.iki.elonen package
 import java.io.IOException;
 import java.security.SecureRandom;
 import java.util.Map;
-
-import fi.iki.elonen.NanoHTTPD;  // Note: org.nanohttpd:nanohttpd:2.3.1 still uses fi.iki.elonen package
+import org.json.JSONArray;
+import org.json.JSONObject;
 
 /**
  * HTTP server for efficient SQL operations
@@ -24,6 +21,7 @@ import fi.iki.elonen.NanoHTTPD;  // Note: org.nanohttpd:nanohttpd:2.3.1 still us
  * bridge for better performance with large datasets and sync operations.
  */
 public class SQLHTTPServer extends NanoHTTPD {
+
     private final String token;
     private final Map<String, SQLDatabase> databases;
     private final Gson gson = new Gson();
@@ -80,8 +78,7 @@ public class SQLHTTPServer extends NanoHTTPD {
                 return newFixedLengthResponse(Response.Status.NOT_FOUND, "text/plain", "Endpoint not found");
             }
         } catch (Exception e) {
-            return newFixedLengthResponse(Response.Status.INTERNAL_ERROR, "text/plain",
-                    "Error: " + e.getMessage());
+            return newFixedLengthResponse(Response.Status.INTERNAL_ERROR, "text/plain", "Error: " + e.getMessage());
         }
     }
 

package/dist/esm/definitions.d.ts

@@ -69,14 +69,14 @@ export declare enum IsolationLevel {
     Serializable = "SERIALIZABLE"
 }
 /**
- * Native SQL Plugin for high-performance SQLite database access.
+ * Fast SQL Plugin for high-performance SQLite database access.
  *
  * This plugin uses a custom HTTP-based protocol for efficient data transfer,
  * bypassing Capacitor's standard bridge for better performance with sync operations.
  *
  * @since 0.0.1
  */
-export interface CapgoCapacitorNativeSqlPlugin {
+export interface CapgoCapacitorFastSqlPlugin {
     /**
      * Initialize the database connection and start the HTTP server.
      *
@@ -86,7 +86,7 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @since 0.0.1
      * @example
      * ```typescript
-     * const conn = await CapgoCapacitorNativeSql.connect({ database: 'myapp' });
+     * const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
      * console.log('Connected on port:', conn.port);
      * ```
      */
@@ -104,7 +104,7 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @since 0.0.1
      * @example
      * ```typescript
-     * await CapgoCapacitorNativeSql.disconnect({ database: 'myapp' });
+     * await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });
      * ```
      */
     disconnect(options: {
@@ -119,7 +119,7 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @since 0.0.1
      * @example
      * ```typescript
-     * const info = await CapgoCapacitorNativeSql.getServerInfo({ database: 'myapp' });
+     * const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
      * console.log('Server port:', info.port);
      * ```
      */
@@ -139,7 +139,7 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @since 0.0.1
      * @example
      * ```typescript
-     * const result = await CapgoCapacitorNativeSql.execute({
+     * const result = await CapgoCapacitorFastSql.execute({
      *   database: 'myapp',
      *   statement: 'SELECT * FROM users WHERE age > ?',
      *   params: [18]
@@ -161,9 +161,9 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @since 0.0.1
      * @example
      * ```typescript
-     * await CapgoCapacitorNativeSql.beginTransaction({ database: 'myapp' });
+     * await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
      * // Execute multiple operations
-     * await CapgoCapacitorNativeSql.commitTransaction({ database: 'myapp' });
+     * await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
      * ```
      */
     beginTransaction(options: {
@@ -179,7 +179,7 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @since 0.0.1
      * @example
      * ```typescript
-     * await CapgoCapacitorNativeSql.commitTransaction({ database: 'myapp' });
+     * await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
      * ```
      */
     commitTransaction(options: {
@@ -195,11 +195,11 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @example
      * ```typescript
      * try {
-     *   await CapgoCapacitorNativeSql.beginTransaction({ database: 'myapp' });
+     *   await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
      *   // Operations...
-     *   await CapgoCapacitorNativeSql.commitTransaction({ database: 'myapp' });
+     *   await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });
      * } catch (error) {
-     *   await CapgoCapacitorNativeSql.rollbackTransaction({ database: 'myapp' });
+     *   await CapgoCapacitorFastSql.rollbackTransaction({ database: 'myapp' });
      * }
      * ```
      */
@@ -214,7 +214,7 @@ export interface CapgoCapacitorNativeSqlPlugin {
      * @since 0.0.1
      * @example
      * ```typescript
-     * const { version } = await CapgoCapacitorNativeSql.getPluginVersion();
+     * const { version } = await CapgoCapacitorFastSql.getPluginVersion();
      * console.log('Plugin version:', version);
      * ```
      */

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,6BAA6B;IAC5C;;;;;;;;;;;;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;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;KACrB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvB;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,OAAO,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB;;;;;;;;;;;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":"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"}

package/dist/esm/{native-sql.d.ts → fast-sql.d.ts}

@@ -1,12 +1,12 @@
 import type { SQLConnectionOptions } from './definitions';
 import { SQLConnection } from './sql-connection';
 /**
- * NativeSQL - High-level API for managing SQL connections
+ * FastSQL - High-level API for managing SQL connections
  *
  * This class provides a convenient interface for opening/closing database connections
  * and managing multiple databases simultaneously.
  */
-export declare class NativeSQL {
+export declare class FastSQL {
     private static connections;
     /**
      * Open a database connection
@@ -39,4 +39,4 @@ export declare class NativeSQL {
      */
     static getOpenDatabases(): string[];
 }
-//# sourceMappingURL=native-sql.d.ts.map
+//# sourceMappingURL=fast-sql.d.ts.map

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

@@ -0,0 +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;IAkB3E;;;;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/{native-sql.js → fast-sql.js}

@@ -1,12 +1,12 @@
-import { CapgoCapacitorNativeSql } from './plugin';
+import { CapgoCapacitorFastSql } from './plugin';
 import { SQLConnection } from './sql-connection';
 /**
- * NativeSQL - High-level API for managing SQL connections
+ * FastSQL - High-level API for managing SQL connections
  *
  * This class provides a convenient interface for opening/closing database connections
  * and managing multiple databases simultaneously.
  */
-export class NativeSQL {
+export class FastSQL {
     /**
      * Open a database connection
      *
@@ -19,7 +19,7 @@ export class NativeSQL {
             return this.connections.get(options.database);
         }
         // Connect via native plugin
-        const info = await CapgoCapacitorNativeSql.connect(options);
+        const info = await CapgoCapacitorFastSql.connect(options);
         // Create connection instance
         const connection = new SQLConnection(info.database, info.port, info.token);
         // Store connection
@@ -37,7 +37,7 @@ export class NativeSQL {
             throw new Error(`Database '${database}' is not connected`);
         }
         // Disconnect via native plugin
-        await CapgoCapacitorNativeSql.disconnect({ database });
+        await CapgoCapacitorFastSql.disconnect({ database });
         // Remove connection
         this.connections.delete(database);
     }
@@ -66,4 +66,4 @@ export class NativeSQL {
         return Array.from(this.connections.keys());
     }
 }
-NativeSQL.connections = new Map();
+FastSQL.connections = new Map();

package/dist/esm/helpers.d.ts

@@ -1,7 +1,7 @@
 /**
  * Helper classes for easier SQL operations
- * Import these separately: import { NativeSQL, SQLConnection } from '@capgo/capacitor-native-sql/helpers';
+ * Import these separately: import { FastSQL, SQLConnection } from '@capgo/capacitor-fast-sql/helpers';
  */
-export { NativeSQL } from './native-sql';
+export { FastSQL } from './fast-sql';
 export { SQLConnection } from './sql-connection';
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/helpers.js

@@ -1,6 +1,6 @@
 /**
  * Helper classes for easier SQL operations
- * Import these separately: import { NativeSQL, SQLConnection } from '@capgo/capacitor-native-sql/helpers';
+ * Import these separately: import { FastSQL, SQLConnection } from '@capgo/capacitor-fast-sql/helpers';
  */
-export { NativeSQL } from './native-sql';
+export { FastSQL } from './fast-sql';
 export { SQLConnection } from './sql-connection';

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 export * from './definitions';
-export { CapgoCapacitorNativeSql } from './plugin';
-export { NativeSQL } from './native-sql';
+export { CapgoCapacitorFastSql } from './plugin';
+export { FastSQL } from './fast-sql';
 export { SQLConnection } from './sql-connection';
 //# 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,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,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,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 export * from './definitions';
-export { CapgoCapacitorNativeSql } from './plugin';
+export { CapgoCapacitorFastSql } from './plugin';
 // Re-export helper classes for convenience
-export { NativeSQL } from './native-sql';
+export { FastSQL } from './fast-sql';
 export { SQLConnection } from './sql-connection';

package/dist/esm/plugin.d.ts

@@ -1,3 +1,3 @@
-import type { CapgoCapacitorNativeSqlPlugin } from './definitions';
-export declare const CapgoCapacitorNativeSql: CapgoCapacitorNativeSqlPlugin;
+import type { CapgoCapacitorFastSqlPlugin } from './definitions';
+export declare const CapgoCapacitorFastSql: CapgoCapacitorFastSqlPlugin;
 //# sourceMappingURL=plugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAEnE,eAAO,MAAM,uBAAuB,+BAGhC,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAEjE,eAAO,MAAM,qBAAqB,6BAEhC,CAAC"}