@capawesome/capacitor-libsql 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,12 @@
 # @capawesome/capacitor-libsql
 
-Capacitor plugin for libSQL databases.
+Capacitor plugin for [libSQL](https://docs.turso.tech/libsql) databases.[^1]
+
+<div class="capawesome-z29o10a">
+  <a href="https://cloud.capawesome.io/" target="_blank">
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
+  </a>
+</div>
 
 ## Installation
 
@@ -14,8 +20,68 @@ npx cap sync
 ```typescript
 import { Libsql } from '@capawesome/capacitor-libsql';
 
-const echo = async () => {
-  await Libsql.echo();
+const connectToLocalDatabase = async () => {
+  const { connectionId } = await Libsql.connect({
+    path: 'database.db',
+  });
+  console.log('Connected to database with ID:', connectionId);
+};
+
+const connectToRemoteDatabase = async () => {
+  const { connectionId } = await Libsql.connect({
+    url: 'libsql://your-database-url.turso.io',
+    authToken: 'your-auth-token',
+  });
+  console.log('Connected to remote database with ID:', connectionId);
+};
+
+const query = async () => {
+  const result = await Libsql.query({
+    connectionId: 'my-connection-id',
+    statement: 'SELECT * FROM my_table',
+  });
+  console.log('Query result:', result.rows);
+};
+
+const execute = async () => {
+  await Libsql.execute({
+    connectionId: 'my-connection-id',
+    statement: 'INSERT INTO my_table (column1, column2) VALUES (?, ?)',
+    values: ['value1', 'value2'],
+  });
+  console.log('Insert executed successfully');
+};
+
+const performTransaction = async () => {
+  const { transactionId } = await Libsql.beginTransaction({
+    connectionId: 'my-connection-id',
+  });
+  try {
+    await Libsql.execute({
+      connectionId: 'my-connection-id',
+      statement: 'UPDATE my_table SET column1 = ? WHERE column2 = ?',
+      values: ['new_value', 'value2'],
+      transactionId,
+    });
+    await Libsql.commitTransaction({
+      connectionId: 'my-connection-id',
+      transactionId,
+    });
+    console.log('Transaction committed successfully');
+  } catch (error) {
+    await Libsql.rollbackTransaction({
+      connectionId: 'my-connection-id',
+      transactionId,
+    });
+    console.error('Transaction rolled back due to error:', error);
+  }
+};
+
+const sync = async () => {
+  await Libsql.sync({
+    connectionId: 'my-connection-id',
+  });
+  console.log('Database synchronized successfully');
 };
 ```
 
@@ -299,3 +365,5 @@ Only available on iOS.
 <code>string | number | null</code>
 
 </docgen-api>
+
+[^1]: This project is not affiliated with, endorsed by, sponsored by, or approved by CHISELSTRIKE INC. or any of their affiliates or subsidiaries.

package/ios/Plugin/Libsql.swift

@@ -54,7 +54,11 @@ import Libsql
             }
 
             if let values = options.values, !values.isEmpty {
-                try connection.execute(options.statement, values as! [ValueRepresentable])
+                guard let valueRepresentables = values as? [ValueRepresentable] else {
+                    completion(LibsqlError.invalidValues)
+                    return
+                }
+                try connection.execute(options.statement, valueRepresentables)
             } else {
                 try connection.execute(options.statement)
             }
@@ -76,7 +80,11 @@ import Libsql
                 let values = options.values?[safe: index]
 
                 if let values = values, !values.isEmpty {
-                    try connection.execute(statement, values as! [ValueRepresentable])
+                    guard let valueRepresentables = values as? [ValueRepresentable] else {
+                        completion(LibsqlError.invalidValues)
+                        return
+                    }
+                    try connection.execute(statement, valueRepresentables)
                 } else {
                     try connection.execute(statement)
                 }
@@ -113,7 +121,11 @@ import Libsql
             }
 
             if let values = options.values, !values.isEmpty {
-                rows = try connection.query(options.statement, values as! [ValueRepresentable])
+                guard let valueRepresentables = values as? [ValueRepresentable] else {
+                    completion(nil, LibsqlError.invalidValues)
+                    return
+                }
+                rows = try connection.query(options.statement, valueRepresentables)
             } else {
                 rows = try connection.query(options.statement)
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/capacitor-libsql",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Capacitor plugin for libSQL databases.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",