jsql-neo 5.3.1 → 5.4.1

package/lib/web_ui.js

@@ -111,7 +111,7 @@ load();
 
 class WebUI {
   constructor(opts = {}) {
-    this.port = opts.port || 8080;
+    this.port = opts.port !== undefined ? opts.port : 8080;
     this.dataDir = opts.dataDir || '.';
     this.readonly = !!opts.readonly;
     this.host = opts.host || '127.0.0.1';

package/nativesrc/jsql-neo-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jsql-neo-core"
-version = "0.1.0"
+version = "5.4.0"
 edition = "2021"
 description = "Embedded database engine — core library (supports WASM)"
 

package/nativesrc/jsql-neo-native/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jsql-neo-native"
-version = "0.1.0"
+version = "5.4.0"
 edition = "2021"
 
 [lib]

package/nativesrc/jsql-neo-wasm/Cargo.lock

@@ -171,7 +171,7 @@ dependencies = [
 
 [[package]]
 name = "jsql-neo-core"
-version = "0.1.0"
+version = "5.4.0"
 dependencies = [
  "bincode",
  "chrono",
@@ -187,7 +187,7 @@ dependencies = [
 
 [[package]]
 name = "jsql-neo-wasm"
-version = "0.1.0"
+version = "5.4.0"
 dependencies = [
  "js-sys",
  "jsql-neo-core",

package/nativesrc/jsql-neo-wasm/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jsql-neo-wasm"
-version = "0.1.0"
+version = "5.4.0"
 edition = "2021"
 
 [lib]

package/nativesrc/jsql-neo-wasm/src/lib.rs

@@ -421,3 +421,27 @@ pub fn jsql_find_by_ids(table: &str, ids_json: &str) -> String {
         }
     })
 }
+
+#[wasm_bindgen]
+pub fn jsql_begin_tx() -> String {
+    ENGINE.with(|eng| match eng.borrow_mut().begin_tx() {
+        Ok(tx_id) => serde_json::json!({ "ok": true, "txId": tx_id }).to_string(),
+        Err(e) => format!(r#"{{"ok":false,"error":"{}"}}"#, e),
+    })
+}
+
+#[wasm_bindgen]
+pub fn jsql_commit_tx(tx_id: &str) -> String {
+    ENGINE.with(|eng| match eng.borrow_mut().commit_tx(tx_id) {
+        Ok(()) => r#"{"ok":true}"#.to_string(),
+        Err(e) => format!(r#"{{"ok":false,"error":"{}"}}"#, e),
+    })
+}
+
+#[wasm_bindgen]
+pub fn jsql_rollback_tx(tx_id: &str) -> String {
+    ENGINE.with(|eng| match eng.borrow_mut().rollback_tx(tx_id) {
+        Ok(()) => r#"{"ok":true}"#.to_string(),
+        Err(e) => format!(r#"{{"ok":false,"error":"{}"}}"#, e),
+    })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsql-neo",
-  "version": "5.3.1",
+  "version": "5.4.1",
   "description": "JSQL-NEO — Rust-powered embedded database with WASM, REST API, B-Tree indexes, WAL, crash recovery",
   "main": "index.js",
   "types": "index.d.ts",
@@ -19,7 +19,6 @@
       "types": "./wasm/browser.d.ts",
       "default": "./wasm/browser.mjs"
     },
-    "./wasm/browser_bg.mjs": "./wasm/browser_bg.mjs",
     "./wasm/browser.d.ts": "./wasm/browser.d.ts",
     "./wasm/*": "./wasm/*",
     "./lib/*.js": "./lib/*.js",
@@ -48,8 +47,9 @@
     "postinstall": "node postinstall.js",
     "test": "node test/smoke.js",
     "test:btree": "node test/btree.test.js",
+    "test:native": "node test/native.test.js",
     "test:regress": "node test/regress-5.1.0.js",
-    "test:all": "node test/smoke.js && node test/coverage.js && node test/regress-5.1.0.js && node test/btree.test.js",
+    "test:all": "node test/smoke.js && node test/native.test.js && node test/wasm.test.js && node test/coverage.js && node test/regress-5.1.0.js && node test/join.test.js && node test/btree.test.js",
     "test:coverage": "c8 --all --include='lib/**' --exclude='lib/mysql_server.js' --exclude='lib/native_client.js' --exclude='lib/wasm_client.js' --exclude='lib/mysql_compat.js' --exclude='lib/nedb_compat.js' --exclude='lib/plugin.js' --reporter=text --reporter=lcov node test/coverage.js",
     "test:orms": "node examples/orms/run-all.js"
   },

package/postinstall.js

@@ -1,38 +1,159 @@
 const { execSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const http = require('http');
+const https = require('https');
 
+const ROOT = __dirname;
+const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+
+// Server CLI binary (bin/jsql-neo-server)
 const BIN_NAME = process.platform === 'win32' ? 'jsql-neo-server.exe' : 'jsql-neo-server';
-const BP = path.join(__dirname, 'bin', BIN_NAME);
+const BP = path.join(ROOT, 'bin', BIN_NAME);
 
-function main() {
-    if (fs.existsSync(BP)) {
-        fs.chmodSync(BP, 0o755);
-        console.log(`[jsql-neo] binary ready: ${BP}`);
+// Native N-API module (native/jsql-neo-native.node)
+const NATIVE_PATH = path.join(ROOT, 'native', 'jsql-neo-native.node');
+
+// GitHub 加速代理前缀；把原始 github 链接直接拼在后面即可
+const GHPROXY = 'https://gh-proxy.com/';
+const TAG = `v${pkg.version}`;
+
+// 从 repository 字段提取 owner/repo，例如 vexify-org/JSQL-neo
+const REPO = (pkg.repository && pkg.repository.url)
+  ? pkg.repository.url.replace(/\.git$/, '').replace(/^.*github\.com\//i, '')
+  : 'vexify-org/JSQL-neo';
+
+// 与 .github/workflows/build-native.yml 中发布的资产命名保持一致
+function nativeTargetSuffix(platform = process.platform, arch = process.arch) {
+  const p = platform === 'win32' ? 'win32' : platform === 'darwin' ? 'darwin' : 'linux';
+  const a = arch === 'x64' ? 'x64' : arch === 'arm64' ? 'arm64' : arch;
+  if (p === 'linux') return `${p}-${a}-gnu`;
+  if (p === 'darwin') return `${p}-${a}`;
+  return `${p}-${a}-msvc`;
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const mod = url.startsWith('https:') ? https : http;
+    const req = mod.get(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        res.resume();
+        download(res.headers.location, dest).then(resolve, reject);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        res.resume();
+        reject(new Error(`HTTP ${res.statusCode} for ${url}`));
         return;
+      }
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      const ws = fs.createWriteStream(dest);
+      ws.on('error', reject);
+      res.pipe(ws);
+      res.on('end', () => ws.end(() => resolve()));
+    });
+    req.on('error', reject);
+  });
+}
+
+function buildNativeFromSource() {
+  const crate = path.join(ROOT, 'nativesrc', 'jsql-neo-native');
+  if (!fs.existsSync(path.join(crate, 'Cargo.toml'))) return;
+  console.log('[jsql-neo] building native module from source...');
+  try {
+    execSync('cargo build --release', { cwd: crate, stdio: 'inherit' });
+    const rel = path.join(crate, 'target', 'release');
+    const src = process.platform === 'win32'
+      ? path.join(rel, 'jsql_neo_native.dll')
+      : process.platform === 'darwin'
+        ? path.join(rel, 'libjsql_neo_native.dylib')
+        : path.join(rel, 'libjsql_neo_native.so');
+    if (fs.existsSync(src)) {
+      fs.mkdirSync(path.dirname(NATIVE_PATH), { recursive: true });
+      fs.copyFileSync(src, NATIVE_PATH);
+      fs.chmodSync(NATIVE_PATH, 0o755);
+      console.log(`[jsql-neo] native module built: native/jsql-neo-native.node`);
     }
+  } catch (e) {
+    console.warn('[jsql-neo] native build failed:', e.message);
+  }
+}
 
-    // Build from source
-    const serverDir = path.join(__dirname, '..', 'jsql-neo-server');
-    if (fs.existsSync(path.join(serverDir, 'Cargo.toml'))) {
-        console.log('[jsql-neo] building Rust server from source...');
-        try {
-            execSync('cargo build --release', { cwd: serverDir, stdio: 'inherit' });
-            const src = path.join(serverDir, 'target', 'release', BIN_NAME);
-            if (fs.existsSync(src)) {
-                fs.mkdirSync(path.join(__dirname, 'bin'), { recursive: true });
-                fs.copyFileSync(src, BP);
-                fs.chmodSync(BP, 0o755);
-                console.log(`[jsql-neo] binary built: ${BP}`);
-                return;
-            }
-        } catch (e) {
-            console.warn('[jsql-neo] cargo build failed:', e.message);
-        }
+// 尝试加载 native 模块；能成功 require 才算「可用」，否则视为不可用
+function tryLoadNative() {
+  if (!fs.existsSync(NATIVE_PATH)) return false;
+  try {
+    require(NATIVE_PATH);
+    fs.chmodSync(NATIVE_PATH, 0o755);
+    return true;
+  } catch (e) {
+    console.warn(`[jsql-neo] existing native module cannot be loaded (${e.code || e.message}), will re-acquire.`);
+    try { fs.unlinkSync(NATIVE_PATH); } catch (_) { /* ignore */ }
+    return false;
+  }
+}
+
+async function downloadAndVerify() {
+  const asset = `jsql-neo-native.${nativeTargetSuffix()}.node`;
+  const url = `${GHPROXY}https://github.com/${REPO}/releases/download/${TAG}/${asset}`;
+  console.log(`[jsql-neo] downloading native module: ${url}`);
+  try {
+    await download(url, NATIVE_PATH);
+    if (!tryLoadNative()) {
+      console.warn('[jsql-neo] downloaded module also invalid, removed.');
+      return false;
     }
+    console.log('[jsql-neo] native module downloaded: native/jsql-neo-native.node');
+    return true;
+  } catch (e) {
+    console.warn('[jsql-neo] download failed, falling back to source build:', e.message);
+    return false;
+  }
+}
+
+async function ensureNativeNode() {
+  // 已存在且能加载 → 直接用；否则删掉并从 gh-proxy.com 下载，找不到才回退源码编译
+  if (tryLoadNative()) {
+    console.log('[jsql-neo] native module ready: native/jsql-neo-native.node');
+    return;
+  }
+  if (await downloadAndVerify()) return;
+  buildNativeFromSource();
+}
+
+function ensureServerBinary() {
+  if (fs.existsSync(BP)) {
+    fs.chmodSync(BP, 0o755);
+    console.log(`[jsql-neo] binary ready: ${BP}`);
+    return;
+  }
+
+  // Build from source
+  const serverDir = path.join(ROOT, '..', 'jsql-neo-server');
+  if (fs.existsSync(path.join(serverDir, 'Cargo.toml'))) {
+    console.log('[jsql-neo] building Rust server from source...');
+    try {
+      execSync('cargo build --release', { cwd: serverDir, stdio: 'inherit' });
+      const src = path.join(serverDir, 'target', 'release', BIN_NAME);
+      if (fs.existsSync(src)) {
+        fs.mkdirSync(path.join(ROOT, 'bin'), { recursive: true });
+        fs.copyFileSync(src, BP);
+        fs.chmodSync(BP, 0o755);
+        console.log(`[jsql-neo] binary built: ${BP}`);
+        return;
+      }
+    } catch (e) {
+      console.warn('[jsql-neo] cargo build failed:', e.message);
+    }
+  }
+
+  console.warn(`[jsql-neo] server binary not found at ${BP}`);
+  console.warn('[jsql-neo] install Rust from https://rustup.rs and run: npm run build');
+}
 
-    console.warn(`[jsql-neo] binary not found at ${BP}`);
-    console.warn('[jsql-neo] install Rust from https://rustup.rs and run: npm run build');
+async function main() {
+  await ensureNativeNode();
+  ensureServerBinary();
 }
 
-main();
+main();

package/test/join.test.js

@@ -0,0 +1,110 @@
+/*
+ * Regression tests for SQL JOIN null-fill correctness.
+ * Zero runtime dependencies (uses Node builtins + in-repo libs only).
+ *
+ *   node test/join.test.js
+ *
+ * Covers:
+ *   J1 LEFT JOIN unmatched rows null-fill right-table qualified columns
+ *   J2 RIGHT JOIN unmatched rows null-fill left-table qualified columns
+ *   J3 INNER JOIN unaffected
+ *   J4 unqualified column reference in JOIN
+ *   J5 WHERE filtering on the null-filled side
+ *   J6 self-join with table alias
+ *   J7 chained joins
+ */
+const path = require('path');
+
+const ROOT = path.join(__dirname, '..');
+const Database = require(path.join(ROOT, 'lib/database'));
+const { executeSQL } = require(path.join(ROOT, 'lib/sql'));
+
+let passed = 0, failed = 0;
+function ok(name, cond, extra) {
+  if (cond) { passed++; console.log('[OK]', name); }
+  else { failed++; console.log('[FAIL]', name, extra !== undefined ? '-> ' + JSON.stringify(extra) : ''); }
+}
+
+async function setup(db) {
+  await executeSQL(db, 'CREATE TABLE a (id INT PRIMARY KEY, a_name STRING)');
+  await executeSQL(db, 'CREATE TABLE b (id INT PRIMARY KEY, a_id INT, b_name STRING)');
+  await executeSQL(db, "INSERT INTO a VALUES (1,'A1'),(2,'A2'),(3,'A3')");
+  await executeSQL(db, "INSERT INTO b VALUES (10,2,'B2'),(20,99,'B99')");
+}
+
+(async () => {
+  /* ============ J1 LEFT JOIN null-fill ============ */
+  {
+    const db = new Database(':memory:', { autoSave: false });
+    await setup(db);
+    const r = await executeSQL(db, 'SELECT a.id AS aid, a.a_name, b.id AS bid, b.b_name FROM a LEFT JOIN b ON a.id = b.a_id');
+    const row1 = r.rows[0]; // a=1 unmatched
+    ok('J1 left unmatched row', row1 && row1[0] === 1 && row1[1] === 'A1' && row1[2] === null && row1[3] === null, row1);
+    const row3 = r.rows[2]; // a=3 unmatched
+    ok('J1 second unmatched row', row3 && row3[0] === 3 && row3[2] === null, row3);
+    const row2 = r.rows[1]; // matched
+    ok('J1 matched row intact', row2 && row2[0] === 2 && row2[1] === 'A2' && row2[2] === 10 && row2[3] === 'B2', row2);
+  }
+
+  /* ============ J2 RIGHT JOIN null-fill ============ */
+  {
+    const db = new Database(':memory:', { autoSave: false });
+    await setup(db);
+    const r = await executeSQL(db, 'SELECT a.id AS aid, a.a_name, b.id AS bid, b.b_name FROM a RIGHT JOIN b ON a.id = b.a_id');
+    const b99 = r.rows[1]; // b=20 unmatched (a_id=99)
+    ok('J2 right unmatched row', b99 && b99[0] === null && b99[1] === null && b99[2] === 20 && b99[3] === 'B99', b99);
+    const b2 = r.rows[0]; // matched
+    ok('J2 matched row intact', b2 && b2[0] === 2 && b2[1] === 'A2' && b2[2] === 10 && b2[3] === 'B2', b2);
+  }
+
+  /* ============ J3 INNER JOIN ============ */
+  {
+    const db = new Database(':memory:', { autoSave: false });
+    await setup(db);
+    const r = await executeSQL(db, 'SELECT a.id AS aid, b.id AS bid FROM a INNER JOIN b ON a.id = b.a_id');
+    ok('J3 inner join', r.rows.length === 1 && r.rows[0][0] === 2 && r.rows[0][1] === 10, r.rows);
+  }
+
+  /* ============ J4 unqualified reference ============ */
+  {
+    const db = new Database(':memory:', { autoSave: false });
+    await setup(db);
+    const r = await executeSQL(db, 'SELECT a.id AS aid, b.b_name FROM a LEFT JOIN b ON a.id = b.a_id');
+    ok('J4 unprefixed id resolves to left table', r.rows[0][0] === 1 && r.rows[0][1] === null, r.rows[0]);
+  }
+
+  /* ============ J5 WHERE on null-filled side ============ */
+  {
+    const db = new Database(':memory:', { autoSave: false });
+    await setup(db);
+    const r = await executeSQL(db, "SELECT a.id AS aid, b.b_name FROM a LEFT JOIN b ON a.id = b.a_id WHERE b.id IS NULL");
+    ok('J5 left where b.id IS NULL', r.rows.length === 2 && r.rows.every(x => x[1] === null), r.rows);
+    const r2 = await executeSQL(db, "SELECT a.a_name, b.id AS bid FROM a RIGHT JOIN b ON a.id = b.a_id WHERE a.id IS NULL");
+    ok('J5 right where a.id IS NULL', r2.rows.length === 1 && r2.rows[0][0] === null && r2.rows[0][1] === 20, r2.rows);
+  }
+
+  /* ============ J6 self-join with alias ============ */
+  {
+    const db = new Database(':memory:', { autoSave: false });
+    await executeSQL(db, 'CREATE TABLE emp (id INT PRIMARY KEY, mgr_id INT, name STRING)');
+    await executeSQL(db, "INSERT INTO emp VALUES (1,NULL,'boss'),(2,1,'alice'),(3,999,'orphan')");
+    const r = await executeSQL(db, 'SELECT e.name AS ename, m.name AS mname FROM emp e LEFT JOIN emp m ON e.mgr_id = m.id');
+    ok('J6 self left join', r.rows.length === 3 && r.rows[0][0] === 'boss' && r.rows[0][1] === null && r.rows[1][1] === 'boss' && r.rows[2][1] === null, r.rows);
+  }
+
+  /* ============ J7 chained joins ============ */
+  {
+    const db = new Database(':memory:', { autoSave: false });
+    await executeSQL(db, 'CREATE TABLE a (id INT PRIMARY KEY, a_name STRING)');
+    await executeSQL(db, 'CREATE TABLE b (id INT PRIMARY KEY, a_id INT, b_name STRING)');
+    await executeSQL(db, 'CREATE TABLE c (id INT PRIMARY KEY, b_id INT, c_name STRING)');
+    await executeSQL(db, "INSERT INTO a VALUES (1,'A1'),(2,'A2'),(3,'A3')");
+    await executeSQL(db, "INSERT INTO b VALUES (10,2,'B2'),(20,99,'B99')");
+    await executeSQL(db, "INSERT INTO c VALUES (100,10,'C10'),(200,77,'C77')");
+    const r = await executeSQL(db, 'SELECT a.id AS aid, b.id AS bid, c.id AS cid, c.c_name FROM a LEFT JOIN b ON a.id = b.a_id LEFT JOIN c ON b.id = c.b_id');
+    ok('J7 chained left joins', r.rows.length === 3 && r.rows[1][1] === 10 && r.rows[1][2] === 100 && r.rows[1][3] === 'C10' && r.rows[0][1] === null && r.rows[0][2] === null, r.rows);
+  }
+
+  console.log(failed === 0 ? `\nALL ${passed} JOIN TESTS PASSED` : `\n${failed} FAILURES (${passed} passed)`);
+  process.exit(failed === 0 ? 0 : 1);
+})().catch((e) => { console.error('FATAL', e); process.exit(1); });

package/test/native.test.js

@@ -0,0 +1,159 @@
+/*
+ * Native (.node N-API) regression tests
+ *   node test/native.test.js
+ * Covers: NativeJSQL CRUD + flat row shape, shorthand/snake_case schemas,
+ * disk persistence, and the better-sqlite3 compat layer on the native engine.
+ */
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+const ROOT = path.join(__dirname, '..');
+
+let passed = 0, failed = 0;
+function ok(name, cond, extra) {
+  if (cond) { passed++; console.log('[OK]', name); }
+  else { failed++; console.log('[FAIL]', name, extra !== undefined ? JSON.stringify(extra) : ''); }
+}
+
+(async () => {
+  const { JSQL } = require(path.join(ROOT, 'lib', 'native_client'));
+
+  /* ---------- basic CRUD + flat row shape ---------- */
+  {
+    const db = new JSQL();
+    await db.start();
+    await db.createTable('users', { id: 'integer primary key auto_increment', name: 'string', age: 'integer' });
+    const ids = await db.insert('users', [{ name: 'Alice', age: 30 }, { name: 'Bob', age: 25 }]);
+    ok('batch insert returns ids', Array.isArray(ids) && ids.length === 2, ids);
+
+    const row = db.findById('users', 1);
+    ok('findById returns flat row', row && row.id === 1 && row.name === 'Alice' && row.age === 30 && !('fields' in row), row);
+
+    const rows = await db.find('users', {});
+    ok('find returns flat rows', rows.length === 2 && rows[1].name === 'Bob' && rows[1].id === 2, rows);
+    ok('filter match', (await db.find('users', { age: 25 })).length === 1);
+    ok('filter no match', (await db.find('users', { age: 99 })).length === 0);
+    ok('count', (await db.count('users')) === 2);
+
+    db.updateByIds('users', [[1, { age: 99 }]]);
+    await new Promise(r => setTimeout(r, 150));
+    ok('updateByIds applied', db.findById('users', 1).age === 99, db.findById('users', 1));
+
+    db.removeByIds('users', [2]);
+    await new Promise(r => setTimeout(r, 150));
+    ok('removeByIds applied', (await db.count('users')) === 1, await db.count('users'));
+    await db.stop();
+  }
+
+  /* ---------- shorthand and snake_case schemas ---------- */
+  {
+    const db = new JSQL();
+    await db.start();
+    await db.createTable('t2', { name: 'string unique', n: 'number', ok: 'boolean' });
+    await db.insert('t2', { name: 'x', n: 1.5, ok: true });
+    const r2 = (await db.find('t2', {}))[0];
+    ok('shorthand schema fields', r2.name === 'x' && r2.n === 1.5 && r2.ok === true, r2);
+
+    await db.createTable('t3', { id: { type: 'integer', primary_key: true, auto_increment: true }, name: { type: 'string' } });
+    await db.insert('t3', { name: 'a' });
+    await db.insert('t3', { id: 7, name: 'b' });
+    ok('snake_case pk respected', db.findById('t3', 7).name === 'b', db.findById('t3', 7));
+    ok('explicit pk bumps next id', db.findById('t3', 1).name === 'a');
+
+    await db.createTable('cfg', 'key string primary key, value string');
+    const cfgIds = await db.insert('cfg', { key: 'a', value: '1' });
+    ok('full shorthand string schema', cfgIds[0] === 'a' && db.findById('cfg', 'a').value === '1', cfgIds);
+    await db.stop();
+  }
+
+  /* ---------- disk persistence roundtrip ---------- */
+  {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'jsql-native-'));
+    const db = new JSQL({ path: dir, mode: 'disk' });
+    await db.start();
+    await db.createTable('p', { id: { type: 'integer', primaryKey: true, autoIncrement: true }, v: { type: 'string' } });
+    await db.insert('p', { v: 'persisted' });
+    await db.stop();
+    const db2 = new JSQL({ path: dir, mode: 'disk' });
+    await db2.start();
+    ok('tables restored', db2.getTables().includes('p'));
+    ok('rows persisted', (await db2.find('p', {}))[0].v === 'persisted', await db2.find('p', {}));
+    await db2.stop();
+  }
+
+  /* ---------- better-sqlite3 compat on native engine ---------- */
+  {
+    const Database = require(path.join(ROOT, 'lib', 'sqlite_compat'));
+    const db = new Database(':memory:', { engine: 'native' });
+    db.exec('CREATE TABLE t (id INTEGER PRIMARY KEY AUTOINCREMENT, name STRING, age INTEGER)');
+    const r = db.prepare('INSERT INTO t (name, age) VALUES (?, ?)').run('a', 1);
+    ok('compat run returns changes', r.changes === 1 && r.lastInsertRowid === 1, r);
+    db.prepare('INSERT INTO t (name, age) VALUES (?, ?)').run('b', 2);
+    ok('compat select', db.prepare('SELECT * FROM t WHERE age = ?').get(1).name === 'a');
+    db.prepare('UPDATE t SET age = 99 WHERE name = ?').run('b');
+    ok('compat update', db.prepare('SELECT age FROM t WHERE name = ?').get('b').age === 99);
+    db.exec('BEGIN');
+    db.prepare('INSERT INTO t (name) VALUES (?)').run('tx');
+    db.exec('ROLLBACK');
+    ok('compat rollback', db.prepare('SELECT COUNT(*) AS n FROM t').get().n === 2);
+    const buf = db.serialize();
+    db.close();
+    const db2 = new Database(':memory:', { engine: 'native' });
+    db2.deserialize(buf);
+    ok('compat serialize roundtrip', db2.prepare('SELECT COUNT(*) AS n FROM t').get().n === 2);
+    db2.close();
+  }
+
+  /* ---------- non-auto pk: id resolution by pk value ---------- */
+  {
+    const db = new JSQL();
+    await db.start();
+    await db.createTable('config', { key: { type: 'string', primaryKey: true }, value: 'string' });
+    const ids = await db.insert('config', [{ key: 'a', value: '1' }, { key: 'b', value: '2' }]);
+    ok('non-auto pk insert returns pk values', JSON.stringify(ids) === JSON.stringify(['a', 'b']), ids);
+
+    const a = db.findById('config', 'a');
+    ok('findById resolves string pk', a && a.value === '1' && !('fields' in a), a);
+    ok('findById pk miss returns null', db.findById('config', 'nope') === null);
+
+    db.updateById('config', 'b', { value: '22' });
+    await new Promise(r => setTimeout(r, 150));
+    ok('updateById resolves string pk', db.findById('config', 'b').value === '22', db.findById('config', 'b'));
+
+    db.removeById('config', 'a');
+    await new Promise(r => setTimeout(r, 150));
+    ok('removeById resolves string pk', (await db.count('config')) === 1, await db.count('config'));
+
+    db.updateByIds('config', [['b', { value: '222' }]]);
+    await new Promise(r => setTimeout(r, 150));
+    ok('updateByIds resolves string pk', db.findById('config', 'b').value === '222', db.findById('config', 'b'));
+
+    db.removeByIds('config', ['b']);
+    await new Promise(r => setTimeout(r, 150));
+    ok('removeByIds resolves string pk', (await db.count('config')) === 0, await db.count('config'));
+    await db.stop();
+  }
+
+  /* ---------- transaction aliases (beginTransaction / rollback / commit) ---------- */
+  {
+    const db = new JSQL();
+    await db.start();
+    await db.createTable('tx', { id: 'integer primary key auto_increment', name: 'string' });
+    await db.insert('tx', { name: 'n1' });
+    await db.beginTransaction();
+    await db.insert('tx', { name: 'n2' });
+    await db.rollback();
+    ok('rollback reverts insert', (await db.count('tx')) === 1, await db.count('tx'));
+    await db.beginTransaction();
+    await db.insert('tx', { name: 'n3' });
+    await db.commit();
+    ok('commit keeps insert', (await db.count('tx')) === 2, await db.count('tx'));
+    await db.stop();
+  }
+
+  console.log(`\n${passed} passed, ${failed} failed`);
+  process.exit(failed ? 1 : 0);
+})().catch(e => {
+  console.error('[FATAL]', e.stack.split('\n').slice(0, 3).join('\n'));
+  process.exit(1);
+});