@capgo/capacitor-fast-sql 8.0.24 → 8.0.25

package/dist/esm/web-sql-connection.js

@@ -0,0 +1,122 @@
+/**
+ * Web implementation of SQLConnection that calls the Capacitor plugin directly,
+ * avoiding HTTP network requests which are not available on the web platform.
+ */
+export class WebSQLConnection {
+    constructor(database, plugin) {
+        this.inTransaction = false;
+        this.database = database;
+        this.plugin = plugin;
+    }
+    /**
+     * Get the database name
+     */
+    getDatabaseName() {
+        return this.database;
+    }
+    /**
+     * Execute a SQL query via the Capacitor plugin
+     *
+     * @param statement - SQL statement to execute
+     * @param params - Parameters to bind to the statement
+     * @returns Query results
+     */
+    async execute(statement, params) {
+        return this.plugin.execute({ database: this.database, statement, params });
+    }
+    /**
+     * Execute multiple SQL statements in a batch, sequentially
+     *
+     * @param operations - Array of SQL operations to execute
+     * @returns Array of results for each operation
+     */
+    async executeBatch(operations) {
+        const results = [];
+        for (const op of operations) {
+            results.push(await this.execute(op.statement, op.params));
+        }
+        return results;
+    }
+    /**
+     * Begin a transaction
+     *
+     * @param isolationLevel - Optional isolation level
+     */
+    async beginTransaction(isolationLevel) {
+        if (this.inTransaction) {
+            throw new Error('Transaction already in progress');
+        }
+        await this.plugin.beginTransaction({ database: this.database, isolationLevel });
+        this.inTransaction = true;
+    }
+    /**
+     * Commit the current transaction
+     */
+    async commit() {
+        if (!this.inTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        await this.plugin.commitTransaction({ database: this.database });
+        this.inTransaction = false;
+    }
+    /**
+     * Rollback the current transaction
+     */
+    async rollback() {
+        if (!this.inTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        await this.plugin.rollbackTransaction({ database: this.database });
+        this.inTransaction = false;
+    }
+    /**
+     * Execute operations within a transaction automatically
+     *
+     * @param callback - Function containing operations to execute
+     * @param isolationLevel - Optional isolation level
+     */
+    async transaction(callback, isolationLevel) {
+        await this.beginTransaction(isolationLevel);
+        try {
+            const result = await callback(this);
+            await this.commit();
+            return result;
+        }
+        catch (error) {
+            if (this.inTransaction) {
+                try {
+                    await this.rollback();
+                }
+                catch (rollbackError) {
+                    throw new Error(`Transaction failed and rollback failed: ${String(rollbackError)}; original error: ${String(error)}`);
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Query helper for SELECT statements
+     *
+     * @param statement - SELECT statement
+     * @param params - Query parameters
+     * @returns Array of rows
+     */
+    async query(statement, params) {
+        const result = await this.execute(statement, params);
+        return result.rows;
+    }
+    /**
+     * 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
+     */
+    async run(statement, params) {
+        const result = await this.execute(statement, params);
+        return {
+            rowsAffected: result.rowsAffected,
+            insertId: result.insertId,
+        };
+    }
+}

package/dist/esm/web.d.ts

@@ -1,5 +1,5 @@
 import { WebPlugin } from '@capacitor/core';
-import type { CapgoCapacitorFastSqlPlugin, SQLConnectionOptions, SQLResult, SQLValue, IsolationLevel } from './definitions';
+import type { CapgoCapacitorFastSqlPlugin, SQLConnectionOptions, SQLResult, SQLValue, IsolationLevel, WebConfig } from './definitions';
 /**
  * Web implementation using sql.js (SQLite compiled to WebAssembly)
  *
@@ -10,9 +10,16 @@ export declare class CapgoCapacitorFastSqlWeb extends WebPlugin implements Capgo
     private databases;
     private sqlPromise;
     private nextPort;
+    private webConfig;
     constructor();
     /**
-     * Load sql.js library
+     * Configure web-specific options (no-op on native platforms).
+     * Must be called before connect() when using locally bundled sql.js files.
+     */
+    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;
     connect(options: SQLConnectionOptions): Promise<{

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,EACf,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,SAAU,YAAW,2BAA2B;IAC5F,OAAO,CAAC,SAAS,CAAoE;IACrF,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAQ;;IAOxB;;OAEG;YACW,SAAS;IAuBjB,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;IAyBlG,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;AAE5C,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,SAAS,EACV,MAAM,eAAe,CAAC;AAKvB;;;;;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;IAyBlG,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"}

package/dist/esm/web.js

@@ -1,4 +1,6 @@
 import { WebPlugin } from '@capacitor/core';
+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';
 /**
  * Web implementation using sql.js (SQLite compiled to WebAssembly)
  *
@@ -11,36 +13,50 @@ export class CapgoCapacitorFastSqlWeb extends WebPlugin {
         this.databases = new Map();
         this.sqlPromise = null;
         this.nextPort = 9000;
-        this.loadSqlJs();
+        this.webConfig = {};
     }
     /**
-     * Load sql.js library
+     * Configure web-specific options (no-op on native platforms).
+     * Must be called before connect() when using locally bundled sql.js files.
      */
-    async loadSqlJs() {
-        if (this.sqlPromise)
-            return;
-        this.sqlPromise = new Promise((resolve, reject) => {
-            try {
-                // Load sql.js from CDN
-                const script = document.createElement('script');
-                script.src = 'https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.js';
-                script.onload = async () => {
-                    const initSqlJs = window.initSqlJs;
-                    const SQL = await initSqlJs({
-                        locateFile: (file) => `https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/${file}`,
-                    });
-                    resolve(SQL);
-                };
-                script.onerror = reject;
-                document.head.appendChild(script);
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
+    async configureWeb(config) {
+        this.webConfig = config;
+        // Reset any in-progress load so the next connect() uses the new config
+        this.sqlPromise = 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);
+                }
+            });
+        }
+        return this.sqlPromise;
     }
     async connect(options) {
-        const SQL = await this.sqlPromise;
+        const SQL = await this.loadSqlJs();
         // Check if database already exists in IndexedDB
         const savedData = await this.loadFromIndexedDB(options.database);
         let db;

package/dist/plugin.cjs.js

@@ -23,7 +23,7 @@ const CapgoCapacitorFastSql = core.registerPlugin('CapgoCapacitorFastSql', {
  *
  * Inspired by capacitor-blob-writer's approach to avoid serialization overhead.
  */
-class SQLConnection {
+class NativeSQLConnection {
     constructor(database, port, token) {
         this.inTransaction = false;
         this.database = database;
@@ -261,6 +261,129 @@ class SQLConnection {
     }
 }
 
+/**
+ * Web implementation of SQLConnection that calls the Capacitor plugin directly,
+ * avoiding HTTP network requests which are not available on the web platform.
+ */
+class WebSQLConnection {
+    constructor(database, plugin) {
+        this.inTransaction = false;
+        this.database = database;
+        this.plugin = plugin;
+    }
+    /**
+     * Get the database name
+     */
+    getDatabaseName() {
+        return this.database;
+    }
+    /**
+     * Execute a SQL query via the Capacitor plugin
+     *
+     * @param statement - SQL statement to execute
+     * @param params - Parameters to bind to the statement
+     * @returns Query results
+     */
+    async execute(statement, params) {
+        return this.plugin.execute({ database: this.database, statement, params });
+    }
+    /**
+     * Execute multiple SQL statements in a batch, sequentially
+     *
+     * @param operations - Array of SQL operations to execute
+     * @returns Array of results for each operation
+     */
+    async executeBatch(operations) {
+        const results = [];
+        for (const op of operations) {
+            results.push(await this.execute(op.statement, op.params));
+        }
+        return results;
+    }
+    /**
+     * Begin a transaction
+     *
+     * @param isolationLevel - Optional isolation level
+     */
+    async beginTransaction(isolationLevel) {
+        if (this.inTransaction) {
+            throw new Error('Transaction already in progress');
+        }
+        await this.plugin.beginTransaction({ database: this.database, isolationLevel });
+        this.inTransaction = true;
+    }
+    /**
+     * Commit the current transaction
+     */
+    async commit() {
+        if (!this.inTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        await this.plugin.commitTransaction({ database: this.database });
+        this.inTransaction = false;
+    }
+    /**
+     * Rollback the current transaction
+     */
+    async rollback() {
+        if (!this.inTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        await this.plugin.rollbackTransaction({ database: this.database });
+        this.inTransaction = false;
+    }
+    /**
+     * Execute operations within a transaction automatically
+     *
+     * @param callback - Function containing operations to execute
+     * @param isolationLevel - Optional isolation level
+     */
+    async transaction(callback, isolationLevel) {
+        await this.beginTransaction(isolationLevel);
+        try {
+            const result = await callback(this);
+            await this.commit();
+            return result;
+        }
+        catch (error) {
+            if (this.inTransaction) {
+                try {
+                    await this.rollback();
+                }
+                catch (rollbackError) {
+                    throw new Error(`Transaction failed and rollback failed: ${String(rollbackError)}; original error: ${String(error)}`);
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Query helper for SELECT statements
+     *
+     * @param statement - SELECT statement
+     * @param params - Query parameters
+     * @returns Array of rows
+     */
+    async query(statement, params) {
+        const result = await this.execute(statement, params);
+        return result.rows;
+    }
+    /**
+     * 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
+     */
+    async run(statement, params) {
+        const result = await this.execute(statement, params);
+        return {
+            rowsAffected: result.rowsAffected,
+            insertId: result.insertId,
+        };
+    }
+}
+
 /**
  * FastSQL - High-level API for managing SQL connections
  *
@@ -282,8 +405,15 @@ 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 = core.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;
@@ -513,6 +643,8 @@ class KeyValueStore {
     }
 }
 
+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';
 /**
  * Web implementation using sql.js (SQLite compiled to WebAssembly)
  *
@@ -525,36 +657,50 @@ class CapgoCapacitorFastSqlWeb extends core.WebPlugin {
         this.databases = new Map();
         this.sqlPromise = null;
         this.nextPort = 9000;
-        this.loadSqlJs();
+        this.webConfig = {};
     }
     /**
-     * Load sql.js library
+     * Configure web-specific options (no-op on native platforms).
+     * Must be called before connect() when using locally bundled sql.js files.
      */
-    async loadSqlJs() {
-        if (this.sqlPromise)
-            return;
-        this.sqlPromise = new Promise((resolve, reject) => {
-            try {
-                // Load sql.js from CDN
-                const script = document.createElement('script');
-                script.src = 'https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.js';
-                script.onload = async () => {
-                    const initSqlJs = window.initSqlJs;
-                    const SQL = await initSqlJs({
-                        locateFile: (file) => `https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/${file}`,
-                    });
-                    resolve(SQL);
-                };
-                script.onerror = reject;
-                document.head.appendChild(script);
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
+    async configureWeb(config) {
+        this.webConfig = config;
+        // Reset any in-progress load so the next connect() uses the new config
+        this.sqlPromise = 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);
+                }
+            });
+        }
+        return this.sqlPromise;
     }
     async connect(options) {
-        const SQL = await this.sqlPromise;
+        const SQL = await this.loadSqlJs();
         // Check if database already exists in IndexedDB
         const savedData = await this.loadFromIndexedDB(options.database);
         let db;
@@ -735,5 +881,6 @@ var web = /*#__PURE__*/Object.freeze({
 exports.CapgoCapacitorFastSql = CapgoCapacitorFastSql;
 exports.FastSQL = FastSQL;
 exports.KeyValueStore = KeyValueStore;
-exports.SQLConnection = SQLConnection;
+exports.NativeSQLConnection = NativeSQLConnection;
+exports.WebSQLConnection = WebSQLConnection;
 //# sourceMappingURL=plugin.cjs.js.map