@capgo/capacitor-fast-sql 8.1.0 → 8.2.0

package/README.md

@@ -65,7 +65,7 @@ This plugin provides direct native SQLite database access with a custom communic
 - **Direct Native SQLite**: Full SQL support with transactions, batch operations, and binary data
 - **Sync-Friendly**: Designed for local sync systems (CRDTs, operational transforms, etc.)
 - **IndexedDB Replacement**: Provides reliable alternative to broken/limited IndexedDB implementations
-- **Cross-Platform**: iOS, Android, and Web (using sql.js + IndexedDB for persistence)
+- **Cross-Platform**: iOS, Android, and Web (using [@sqlite.org/sqlite-wasm](https://github.com/sqlite/sqlite-wasm) with OPFS persistence)
 - **Optional RAG VectorStore**: Persist many named vector stores for retrieval-augmented generation without adding a native dependency
 
 ## iOS Configuration
@@ -154,25 +154,50 @@ pod 'CapgoCapacitorFastSql/SQLCipher', :path => '../../node_modules/@capgo/capac
 
 Then run `pod install` in the `ios/App` directory. If you skip this subspec, keep `encrypted: false`.
 
-## 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.
+## Web Platform
+
+On the web, this plugin uses the official [@sqlite.org/sqlite-wasm](https://github.com/sqlite/sqlite-wasm) build with [OPFS](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) for persistence. SQLite reads and writes the database file directly — it is not loaded entirely into RAM or mirrored through IndexedDB.
+
+For OPFS to work, your web server must send Cross-Origin Isolation headers:
+
+```http
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+```
+
+With Vite:
+
+```typescript
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  server: {
+    headers: {
+      'Cross-Origin-Opener-Policy': 'same-origin',
+      'Cross-Origin-Embedder-Policy': 'require-corp',
+    },
+  },
+  optimizeDeps: {
+    exclude: ['@sqlite.org/sqlite-wasm'],
+  },
+});
+```
+
+Optional web configuration (call before the first `connect()`):
+
+```typescript
+import { CapgoCapacitorFastSql, FastSQL } from '@capgo/capacitor-fast-sql';
+
+await CapgoCapacitorFastSql.configureWeb({
+  useOpfs: true,
+});
+
+const db = await FastSQL.connect({ database: 'myapp' });
+```
+
+`configureWeb()` is a no-op on iOS and Android — it is safe to call unconditionally.
+
+> **Note:** Existing databases previously stored in IndexedDB by sql.js are not migrated automatically. Re-seed or import data after upgrading if needed.
 
 ## Usage
 
@@ -486,11 +511,10 @@ Get the native Capacitor plugin version.
 configureWeb(config: WebConfig) => Promise<void>
 ```
 
-Configure web-specific options for the sql.js WASM module.
+Configure web-specific options for the official SQLite 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.
+Call this **before** the first `connect()` call if you need to disable OPFS
+or supply a custom Worker. This method is a no-op on iOS and Android.
 
 | Param        | Type                                            | Description                 |
 | ------------ | ----------------------------------------------- | --------------------------- |
@@ -611,14 +635,17 @@ buffer as needed.
 
 #### 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.
+Web platform configuration for the official SQLite Wasm module.
+Use with `configureWeb()` before the first `connect()`.
 
-| 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. |
+OPFS persistence requires Cross-Origin Isolation headers on your web server:
+`Cross-Origin-Opener-Policy: same-origin` and
+`Cross-Origin-Embedder-Policy: require-corp`.
+
+| Prop          | Type                                                        | Description                                                                                                                                                  | Default           |
+| ------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- |
+| **`useOpfs`** | <code>boolean</code>                                        | Prefer OPFS persistence via a Web Worker (default: `true`). When OPFS is unavailable, the plugin falls back to a non-persistent database and logs a warning. | <code>true</code> |
+| **`worker`**  | <code><a href="#sqlitewebworker">SqliteWebWorker</a></code> | Custom Worker instance or factory for SQLite Wasm. Advanced: override the default worker from `@sqlite.org/sqlite-wasm`.                                     |                   |
 
 
 ### Type Aliases
@@ -636,6 +663,14 @@ SQL value types supported by the plugin
 <code>ArrayBufferTypes[keyof ArrayBufferTypes]</code>
 
 
+#### SqliteWebWorker
+
+Browser Worker instance or a factory that returns one.
+Used to override the default SQLite Wasm worker.
+
+<code>Worker | (() =&gt; Worker)</code>
+
+
 ### Enums
 
 

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.1.0";
+    private final String pluginVersion = "8.2.0";
 
     private Map<String, DatabaseConnection> databases = new HashMap<>();
     private SQLHTTPServer server;

package/dist/esm/definitions.d.ts

@@ -74,23 +74,31 @@ export interface SQLConnectionOptions {
     performancePresets?: 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.
+ * Browser Worker instance or a factory that returns one.
+ * Used to override the default SQLite Wasm worker.
+ */
+export type SqliteWebWorker = Worker | (() => Worker);
+/**
+ * Web platform configuration for the official SQLite Wasm module.
+ * Use with `configureWeb()` before the first `connect()`.
+ *
+ * OPFS persistence requires Cross-Origin Isolation headers on your web server:
+ * `Cross-Origin-Opener-Policy: same-origin` and
+ * `Cross-Origin-Embedder-Policy: require-corp`.
  */
 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'
+     * Prefer OPFS persistence via a Web Worker (default: `true`).
+     * When OPFS is unavailable, the plugin falls back to a non-persistent database
+     * and logs a warning.
+     * @default true
      */
-    sqlJsUrl?: string;
+    useOpfs?: boolean;
     /**
-     * URL to the sql.js WebAssembly binary (`sql-wasm.wasm`).
-     * When omitted, the plugin loads from the cdnjs CDN.
-     * @example '/assets/sql-wasm.wasm'
+     * Custom Worker instance or factory for SQLite Wasm.
+     * Advanced: override the default worker from `@sqlite.org/sqlite-wasm`.
      */
-    wasmUrl?: string;
+    worker?: SqliteWebWorker;
 }
 /**
  * Transaction isolation levels
@@ -255,11 +263,10 @@ export interface CapgoCapacitorFastSqlPlugin {
         version: string;
     }>;
     /**
-     * Configure web-specific options for the sql.js WASM module.
+     * Configure web-specific options for the official SQLite 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.
+     * Call this **before** the first `connect()` call if you need to disable OPFS
+     * or supply a custom Worker. This method is a no-op on iOS and Android.
      *
      * @param config - Web configuration options
      * @returns Promise that resolves when the configuration is applied
@@ -268,8 +275,7 @@ export interface CapgoCapacitorFastSqlPlugin {
      * ```typescript
      * // Configure once at app startup (web only)
      * await CapgoCapacitorFastSql.configureWeb({
-     *   sqlJsUrl: '/assets/sql-wasm.js',
-     *   wasmUrl: '/assets/sql-wasm.wasm',
+     *   useOpfs: true,
      * });
      * const db = await FastSQL.connect({ database: 'myapp' });
      * ```

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

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

package/dist/esm/web.d.ts

@@ -1,27 +1,24 @@
 import { WebPlugin } from '@capacitor/core';
 import type { CapgoCapacitorFastSqlPlugin, SQLConnectionOptions, SQLResult, SQLValue, IsolationLevel, WebConfig } from './definitions';
 /**
- * Web implementation using sql.js (SQLite compiled to WebAssembly)
+ * Web implementation using the official SQLite Wasm build with OPFS persistence.
  *
- * This provides a compatible API on the web platform, storing databases
- * in IndexedDB for persistence.
+ * Databases are stored in the Origin Private File System when available (requires
+ * Cross-Origin Isolation: COOP/COEP). No full-database copy is kept in RAM or
+ * IndexedDB — SQLite reads/writes the OPFS file directly from a worker.
  */
 export declare class CapgoCapacitorFastSqlWeb extends WebPlugin implements CapgoCapacitorFastSqlPlugin {
     private databases;
-    private sqlPromise;
+    private promiserPromise;
     private nextPort;
     private webConfig;
-    constructor();
     /**
      * Configure web-specific options (no-op on native platforms).
-     * Must be called before connect() when using locally bundled sql.js files.
+     * Must be called before connect() when overriding the default worker.
      */
     configureWeb(config: WebConfig): Promise<void>;
-    /**
-     * Load sql.js library (lazy – called on first connect()).
-     * Returns the cached promise so callers can await it directly.
-     */
-    private loadSqlJs;
+    private getPromiser;
+    private dbPath;
     connect(options: SQLConnectionOptions): Promise<{
         port: number;
         token: string;
@@ -51,22 +48,8 @@ export declare class CapgoCapacitorFastSqlWeb extends WebPlugin implements Capgo
     rollbackTransaction(options: {
         database: string;
     }): Promise<void>;
-    /**
-     * Generate a random authentication token
-     */
+    private applyPerformanceConfig;
     private generateToken;
-    /**
-     * Get last insert row ID
-     */
-    private getLastInsertId;
-    /**
-     * Save database to IndexedDB
-     */
-    private saveToIndexedDB;
-    /**
-     * Load database from IndexedDB
-     */
-    private loadFromIndexedDB;
     getPluginVersion(): Promise<{
         version: string;
     }>;

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

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,SAAS,EACV,MAAM,eAAe,CAAC;AAMvB;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,SAAU,YAAW,2BAA2B;IAC5F,OAAO,CAAC,SAAS,CAAoE;IACrF,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAiB;;IAMlC;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD;;;OAGG;IACH,OAAO,CAAC,SAAS;IA4BX,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BlG,UAAU,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxD,aAAa,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAYtF,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;IAiClG,gBAAgB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/F,iBAAiB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D,mBAAmB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;YACW,eAAe;IAgC7B;;OAEG;YACW,iBAAiB;IAgCzB,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGvD"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,SAAS,EACV,MAAM,eAAe,CAAC;AAcvB;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,SAAU,YAAW,2BAA2B;IAC5F,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,eAAe,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAiB;IAElC;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,MAAM;IAIR,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAmDlG,UAAU,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxD,aAAa,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAYtF,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;IA6ClG,gBAAgB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/F,iBAAiB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D,mBAAmB,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAOzD,sBAAsB;IAkBpC,OAAO,CAAC,aAAa;IAMf,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGvD"}

package/dist/esm/web.js

@@ -1,76 +1,75 @@
 import { WebPlugin } from '@capacitor/core';
-import { applyPerformanceConfig } from './performance-config';
-const DEFAULT_SQLJS_URL = 'https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.js';
-const DEFAULT_WASM_URL = 'https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.wasm';
+import { sqlite3Worker1Promiser } from '@sqlite.org/sqlite-wasm';
 /**
- * Web implementation using sql.js (SQLite compiled to WebAssembly)
+ * Web implementation using the official SQLite Wasm build with OPFS persistence.
  *
- * This provides a compatible API on the web platform, storing databases
- * in IndexedDB for persistence.
+ * Databases are stored in the Origin Private File System when available (requires
+ * Cross-Origin Isolation: COOP/COEP). No full-database copy is kept in RAM or
+ * IndexedDB — SQLite reads/writes the OPFS file directly from a worker.
  */
 export class CapgoCapacitorFastSqlWeb extends WebPlugin {
     constructor() {
-        super();
+        super(...arguments);
         this.databases = new Map();
-        this.sqlPromise = null;
+        this.promiserPromise = null;
         this.nextPort = 9000;
         this.webConfig = {};
     }
     /**
      * Configure web-specific options (no-op on native platforms).
-     * Must be called before connect() when using locally bundled sql.js files.
+     * Must be called before connect() when overriding the default worker.
      */
     async configureWeb(config) {
         this.webConfig = config;
-        // Reset any in-progress load so the next connect() uses the new config
-        this.sqlPromise = null;
+        this.promiserPromise = null;
     }
-    /**
-     * Load sql.js library (lazy – called on first connect()).
-     * Returns the cached promise so callers can await it directly.
-     */
-    loadSqlJs() {
-        var _a, _b;
-        if (!this.sqlPromise) {
-            const jsUrl = (_a = this.webConfig.sqlJsUrl) !== null && _a !== void 0 ? _a : DEFAULT_SQLJS_URL;
-            const wasmUrl = (_b = this.webConfig.wasmUrl) !== null && _b !== void 0 ? _b : DEFAULT_WASM_URL;
-            this.sqlPromise = new Promise((resolve, reject) => {
-                try {
-                    // Load sql.js from the configured URL (CDN or local bundle)
-                    const script = document.createElement('script');
-                    script.src = jsUrl;
-                    script.onload = async () => {
-                        const initSqlJs = window.initSqlJs;
-                        const SQL = await initSqlJs({
-                            locateFile: (file) => (file.endsWith('.wasm') ? wasmUrl : file),
-                        });
-                        resolve(SQL);
-                    };
-                    script.onerror = reject;
-                    document.head.appendChild(script);
-                }
-                catch (error) {
-                    reject(error);
-                }
-            });
+    getPromiser() {
+        if (!this.promiserPromise) {
+            const config = this.webConfig.worker !== undefined ? { worker: this.webConfig.worker } : undefined;
+            this.promiserPromise = sqlite3Worker1Promiser.v2(config);
         }
-        return this.sqlPromise;
+        return this.promiserPromise;
+    }
+    dbPath(database) {
+        return `/capgo-fast-sql/${database}.sqlite3`;
     }
     async connect(options) {
-        const SQL = await this.loadSqlJs();
-        // Check if database already exists in IndexedDB
-        const savedData = await this.loadFromIndexedDB(options.database);
-        let db;
-        if (savedData) {
-            db = new SQL.Database(savedData);
+        if (this.databases.has(options.database)) {
+            const existing = this.databases.get(options.database);
+            return {
+                port: existing.port,
+                token: existing.token,
+                database: options.database,
+            };
+        }
+        const promiser = await this.getPromiser();
+        const path = this.dbPath(options.database);
+        const useOpfs = this.webConfig.useOpfs !== false;
+        let openResult;
+        if (useOpfs) {
+            try {
+                openResult = await promiser('open', {
+                    filename: `file:${path}?vfs=opfs`,
+                });
+            }
+            catch (opfsError) {
+                console.warn('[CapgoCapacitorFastSql] OPFS unavailable; web database will not persist across reloads. ' +
+                    'Serve with Cross-Origin-Opener-Policy: same-origin and Cross-Origin-Embedder-Policy: require-corp.', opfsError);
+                openResult = await promiser('open', { filename: path });
+            }
         }
         else {
-            db = new SQL.Database();
+            openResult = await promiser('open', { filename: path });
+        }
+        const dbId = openResult.result.dbId;
+        const persistent = Boolean(openResult.result.persistent);
+        if (!dbId) {
+            throw new Error('Failed to open SQLite Wasm database: missing dbId');
         }
-        applyPerformanceConfig(db, options);
+        await this.applyPerformanceConfig(promiser, dbId, options);
         const token = this.generateToken();
         const port = this.nextPort++;
-        this.databases.set(options.database, { db, token, port });
+        this.databases.set(options.database, { dbId, token, port, persistent });
         return {
             port,
             token,
@@ -82,10 +81,9 @@ export class CapgoCapacitorFastSqlWeb extends WebPlugin {
         if (!dbInfo) {
             throw new Error(`Database '${options.database}' is not connected`);
         }
-        // Save to IndexedDB before closing
-        const data = dbInfo.db.export();
-        await this.saveToIndexedDB(options.database, data);
-        dbInfo.db.close();
+        const promiser = await this.getPromiser();
+        // OPFS-backed DBs persist automatically; no export/IndexedDB write needed.
+        await promiser({ type: 'close', dbId: dbInfo.dbId, args: {} });
         this.databases.delete(options.database);
     }
     async getServerInfo(options) {
@@ -99,32 +97,45 @@ export class CapgoCapacitorFastSqlWeb extends WebPlugin {
         };
     }
     async execute(options) {
+        var _a, _b, _c, _d;
         const dbInfo = this.databases.get(options.database);
         if (!dbInfo) {
             throw new Error(`Database '${options.database}' is not connected`);
         }
         try {
-            const stmt = dbInfo.db.prepare(options.statement);
-            if (options.params) {
-                stmt.bind(options.params);
-            }
+            const promiser = await this.getPromiser();
             const rows = [];
-            while (stmt.step()) {
-                const row = stmt.getAsObject();
-                rows.push(row);
-            }
-            stmt.free();
-            // Get changes and last insert ID
-            const changes = dbInfo.db.getRowsModified();
-            const insertId = this.getLastInsertId(dbInfo.db);
+            // countChanges / lastInsertRowId are supported by Worker1 at runtime but
+            // omitted from the published Worker1ExecArgs typings.
+            const result = await promiser({
+                type: 'exec',
+                dbId: dbInfo.dbId,
+                args: {
+                    sql: options.statement,
+                    bind: options.params,
+                    rowMode: 'object',
+                    countChanges: true,
+                    lastInsertRowId: true,
+                    callback: (msg) => {
+                        if (msg.rowNumber != null && msg.row && typeof msg.row === 'object' && !Array.isArray(msg.row)) {
+                            rows.push(msg.row);
+                        }
+                    },
+                },
+            });
+            const execResult = result.result;
+            const rowsAffected = Number((_a = execResult.changeCount) !== null && _a !== void 0 ? _a : 0);
+            const rawInsertId = execResult.lastInsertRowId;
+            const insertId = rawInsertId !== undefined && rawInsertId !== null ? Number(rawInsertId) : undefined;
             return {
                 rows,
-                rowsAffected: changes,
-                insertId: insertId > 0 ? insertId : undefined,
+                rowsAffected,
+                insertId: insertId !== undefined && insertId > 0 ? insertId : undefined,
             };
         }
         catch (error) {
-            throw new Error(`SQL execution failed: ${error.message}`);
+            const message = (_d = (_c = (_b = error === null || error === void 0 ? void 0 : error.result) === null || _b === void 0 ? void 0 : _b.message) !== null && _c !== void 0 ? _c : error === null || error === void 0 ? void 0 : error.message) !== null && _d !== void 0 ? _d : String(error);
+            throw new Error(`SQL execution failed: ${message}`);
         }
     }
     async beginTransaction(options) {
@@ -145,87 +156,22 @@ export class CapgoCapacitorFastSqlWeb extends WebPlugin {
             statement: 'ROLLBACK',
         });
     }
-    /**
-     * Generate a random authentication token
-     */
+    async applyPerformanceConfig(promiser, dbId, options) {
+        await promiser({ type: 'exec', dbId, args: { sql: 'PRAGMA foreign_keys = ON' } });
+        if (options.walMode) {
+            await promiser({ type: 'exec', dbId, args: { sql: 'PRAGMA journal_mode = WAL' } });
+        }
+        if (options.performancePresets) {
+            await promiser({ type: 'exec', dbId, args: { sql: 'PRAGMA synchronous = NORMAL' } });
+            await promiser({ type: 'exec', dbId, args: { sql: 'PRAGMA busy_timeout = 5000' } });
+            await promiser({ type: 'exec', dbId, args: { sql: 'PRAGMA cache_size = -2000' } });
+        }
+    }
     generateToken() {
         return Array.from(crypto.getRandomValues(new Uint8Array(32)))
             .map((b) => b.toString(16).padStart(2, '0'))
             .join('');
     }
-    /**
-     * Get last insert row ID
-     */
-    getLastInsertId(db) {
-        try {
-            const result = db.exec('SELECT last_insert_rowid()');
-            if (result.length > 0 && result[0].values.length > 0) {
-                return result[0].values[0][0];
-            }
-        }
-        catch (_a) {
-            // Ignore error
-        }
-        return -1;
-    }
-    /**
-     * Save database to IndexedDB
-     */
-    async saveToIndexedDB(dbName, data) {
-        return new Promise((resolve, reject) => {
-            const request = indexedDB.open('CapacitorNativeSQL', 1);
-            request.onerror = () => reject(request.error);
-            request.onupgradeneeded = (event) => {
-                const db = event.target.result;
-                if (!db.objectStoreNames.contains('databases')) {
-                    db.createObjectStore('databases');
-                }
-            };
-            request.onsuccess = () => {
-                const db = request.result;
-                const transaction = db.transaction(['databases'], 'readwrite');
-                const store = transaction.objectStore('databases');
-                const putRequest = store.put(data, dbName);
-                putRequest.onsuccess = () => {
-                    db.close();
-                    resolve();
-                };
-                putRequest.onerror = () => {
-                    db.close();
-                    reject(putRequest.error);
-                };
-            };
-        });
-    }
-    /**
-     * Load database from IndexedDB
-     */
-    async loadFromIndexedDB(dbName) {
-        return new Promise((resolve, reject) => {
-            const request = indexedDB.open('CapacitorNativeSQL', 1);
-            request.onerror = () => reject(request.error);
-            request.onupgradeneeded = (event) => {
-                const db = event.target.result;
-                if (!db.objectStoreNames.contains('databases')) {
-                    db.createObjectStore('databases');
-                }
-            };
-            request.onsuccess = () => {
-                const db = request.result;
-                const transaction = db.transaction(['databases'], 'readonly');
-                const store = transaction.objectStore('databases');
-                const getRequest = store.get(dbName);
-                getRequest.onsuccess = () => {
-                    db.close();
-                    resolve(getRequest.result || null);
-                };
-                getRequest.onerror = () => {
-                    db.close();
-                    reject(getRequest.error);
-                };
-            };
-        });
-    }
     async getPluginVersion() {
         return { version: 'web' };
     }