@citadeldb/wasm 0.8.0 → 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 |
@@ -59,11 +72,11 @@ db.free();
 
 ## SQL Support
 
-**Statements** - CREATE/DROP TABLE, ALTER TABLE (ADD/DROP/RENAME COLUMN, RENAME TABLE), CREATE/DROP INDEX, CREATE/DROP VIEW, INSERT (VALUES, SELECT), SELECT, UPDATE, DELETE, BEGIN/COMMIT/ROLLBACK, SAVEPOINT/RELEASE/ROLLBACK TO, EXPLAIN
+**Statements** - CREATE/DROP TABLE, ALTER TABLE (ADD/DROP/RENAME COLUMN, RENAME TABLE), CREATE/DROP INDEX (UNIQUE + multi-column), CREATE/DROP VIEW, INSERT (VALUES, SELECT), SELECT, UPDATE, DELETE, BEGIN/COMMIT/ROLLBACK, SAVEPOINT/RELEASE/ROLLBACK TO, SET TIME ZONE, EXPLAIN
 
-**Constraints** - PRIMARY KEY, NOT NULL, UNIQUE, DEFAULT, CHECK (column + table level), FOREIGN KEY (RESTRICT/NO ACTION)
+**Constraints** - PRIMARY KEY, NOT NULL, UNIQUE (column + table level, inline or `CREATE UNIQUE INDEX`), DEFAULT, CHECK (column + table level), FOREIGN KEY (RESTRICT/NO ACTION)
 
-**Types** - INTEGER, REAL, TEXT, BLOB, BOOLEAN
+**Types** - INTEGER, REAL, TEXT, BLOB, BOOLEAN, DATE, TIME, TIMESTAMP (with timezone), INTERVAL
 
 **Clauses** - JOINs (INNER, LEFT, RIGHT, CROSS), subqueries (scalar, IN, EXISTS, correlated), CTEs (WITH / WITH RECURSIVE), UNION/INTERSECT/EXCEPT [ALL], CASE, BETWEEN, LIKE, DISTINCT, GROUP BY/HAVING, ORDER BY, LIMIT/OFFSET
 
@@ -71,7 +84,19 @@ db.free();
 
 **Views** - CREATE/DROP VIEW, OR REPLACE, IF NOT EXISTS/IF EXISTS, column aliases, nested views
 
-**Functions** - COUNT, SUM, AVG, MIN, MAX, LENGTH, UPPER, LOWER, SUBSTR, ABS, ROUND, COALESCE, NULLIF, CAST, TYPEOF, HEX, TRIM, REPLACE, RANDOM, IIF, GLOB
+**Scalar functions**
+- Aggregate: COUNT, SUM, AVG, MIN, MAX
+- String: LENGTH, UPPER, LOWER, SUBSTR/SUBSTRING, TRIM/LTRIM/RTRIM, REPLACE, INSTR, CONCAT, HEX
+- Math: ABS, ROUND, CEIL/CEILING, FLOOR, SIGN, SQRT, RANDOM
+- Conditional: COALESCE, NULLIF, IIF, CAST, TYPEOF
+
+**Date / Time functions**
+- Current: NOW, CURRENT_DATE, CURRENT_TIME/LOCALTIME, CURRENT_TIMESTAMP/LOCALTIMESTAMP, CLOCK_TIMESTAMP, STATEMENT_TIMESTAMP, TRANSACTION_TIMESTAMP
+- Construction: MAKE_DATE, MAKE_TIME, MAKE_TIMESTAMP, MAKE_INTERVAL
+- Extraction / truncation: EXTRACT, DATE_PART, DATEPART, DATE_TRUNC, DATE_BIN
+- Conversion (SQLite-compatible): DATE, TIME, DATETIME, STRFTIME, JULIANDAY, UNIXEPOCH
+- Arithmetic: AGE, TIMEDIFF, AT_TIMEZONE, JUSTIFY_DAYS, JUSTIFY_HOURS, JUSTIFY_INTERVAL, ISFINITE
+- IANA zone support, BC dates, `+infinity`/`-infinity` sentinels, PG-normalized INTERVAL comparison
 
 **Prepared statements** - `$1, $2, ...` positional parameters with LRU statement cache
 

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.0",
+  "version": "0.9.0",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",