Add transaction example

examples/transactions/.gitignore

@@ -0,0 +1 @@
+local.db

examples/transactions/README.md

@@ -0,0 +1,27 @@
+# Local
+
+This example demonstrates how to use transactions with libSQL.
+
+## Install Dependencies
+
+```bash
+npm i
+```
+
+## Running
+
+Execute the example:
+
+```bash
+node index.mjs
+```
+
+This example will:
+
+1. Create a new table called `users`.
+2. Start a transaction.
+3. Insert multiple users within the transaction.
+4. Demonstrate how to rollback a transaction.
+5. Start another transaction.
+6. Insert more users and commit the transaction.
+7. Query and display the final state of the `users` table.

examples/transactions/index.mjs

@@ -0,0 +1,47 @@
+import { createClient } from "@libsql/client";
+
+const client = createClient({
+    url: "file:local.db",
+});
+
+await client.batch(
+    [
+        "DROP TABLE IF EXISTS users",
+        "CREATE TABLE users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)",
+        "INSERT INTO users (name) VALUES ('Iku Turso')",
+    ],
+    "write",
+);
+
+const names = ["John Doe", "Mary Smith", "Alice Jones", "Mark Taylor"];
+
+try {
+    const transaction = await client.transaction("write");
+
+    for (const name of names) {
+        await transaction.execute({
+            sql: "INSERT INTO users (name) VALUES (?)",
+            args: [name],
+        });
+    }
+    await transaction.rollback();
+
+    const secondTransaction = await client.transaction("write");
+
+    for (const name of names) {
+        await secondTransaction.execute({
+            sql: "INSERT INTO users (name) VALUES (?)",
+            args: [name],
+        });
+    }
+
+    await secondTransaction.commit();
+} catch (e) {
+    console.error(e);
+    await transaction.rollback();
+    await secondTransaction.rollback();
+}
+
+const result = await client.execute("SELECT * FROM users");
+
+console.log("Users:", result.rows);