@citadeldb/wasm 0.8.1 → 0.9.0

package/README.md

@@ -19,12 +19,24 @@ await init();
 
 const db = new CitadelDb("my-passphrase");
 
-// SQL
+// Single statement
 db.execute("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL);");
 db.execute("INSERT INTO users (id, name) VALUES (1, 'Alice'), (2, 'Bob');");
 const result = db.query("SELECT * FROM users;");
 // { columns: ["id", "name"], rows: [[1, "Alice"], [2, "Bob"]] }
 
+// Multi-statement script — returns one outcome per statement
+const outcomes = db.run(`
+    CREATE TABLE posts (id INTEGER PRIMARY KEY, title TEXT NOT NULL);
+    INSERT INTO posts VALUES (1, 'Hello'), (2, 'World');
+    SELECT * FROM posts;
+`);
+// [
+//   { type: "ok" },
+//   { type: "rowsAffected", value: 2 },
+//   { type: "query", columns: ["id", "title"], rows: [[1, "Hello"], [2, "World"]] }
+// ]
+
 // Key-value
 db.put(new Uint8Array([1, 2, 3]), new Uint8Array([4, 5, 6]));
 const value = db.get(new Uint8Array([1, 2, 3]));
@@ -45,9 +57,10 @@ db.free();
 | Method | Description |
 |--------|-------------|
 | `new CitadelDb(passphrase)` | Create an in-memory encrypted database |
-| `execute(sql)` | Execute DDL/DML, returns rows affected |
-| `executeBatch(sql)` | Execute multiple statements |
-| `query(sql)` | Execute SELECT, returns `{ columns, rows }` |
+| `execute(sql)` | Execute single DDL/DML statement, returns rows affected |
+| `query(sql)` | Execute single SELECT, returns `{ columns, rows }` |
+| `run(sql)` | Execute `;`-separated statements, returns `[{type, ...}, ...]` |
+| `executeBatch(sql)` | Execute `;`-separated statements, discards results |
 | `put(key, value)` | Insert into default table |
 | `get(key)` | Get from default table |
 | `delete(key)` | Delete from default table |

package/citadel_wasm.d.ts

@@ -37,6 +37,11 @@ export class CitadelDb {
      * Returns `{ columns: string[], rows: any[][] }`.
      */
     query(sql: string): any;
+    /**
+     * Execute `;`-separated SQL statements. Returns an array of
+     * tagged outcome objects, one per statement.
+     */
+    run(sql: string): Array<any>;
     /**
      * Get database statistics.
      * Returns `{ entryCount: number, totalPages: number, treeDepth: number }`.
@@ -70,6 +75,7 @@ export interface InitOutput {
     readonly citadeldb_new: (a: number, b: number, c: number) => void;
     readonly citadeldb_put: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly citadeldb_query: (a: number, b: number, c: number, d: number) => void;
+    readonly citadeldb_run: (a: number, b: number, c: number, d: number) => void;
     readonly citadeldb_stats: (a: number, b: number) => void;
     readonly citadeldb_tableDelete: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly citadeldb_tableGet: (a: number, b: number, c: number, d: number, e: number, f: number) => void;

package/citadel_wasm.js

@@ -168,6 +168,29 @@ export class CitadelDb {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Execute `;`-separated SQL statements. Returns an array of
+     * tagged outcome objects, one per statement.
+     * @param {string} sql
+     * @returns {Array<any>}
+     */
+    run(sql) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(sql, wasm.__wbindgen_export3, wasm.__wbindgen_export4);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.citadeldb_run(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Get database statistics.
      * Returns `{ entryCount: number, totalPages: number, treeDepth: number }`.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@citadeldb/wasm",
   "type": "module",
   "description": "WASM bindings for Citadel encrypted database",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",