jsql-neo 6.4.0-beta.13 → 6.4.0-beta.15

package/README.md

@@ -3,7 +3,7 @@
 > **One engine to rule them all** — a Rust-powered embedded database that speaks your language:
 > MySQL, PostgreSQL, MongoDB, Redis, SQL, TypeScript, **and the browser**.
 
-> **v6.4.0-beta.13** — official release build · [github.com/vexify-org/JSQL-neo](https://github.com/vexify-org/JSQL-neo) · [jsql.vexify.top](https://jsql.vexify.top)
+> **v6.4.0-beta.15** — official release build · [github.com/vexify-org/JSQL-neo](https://github.com/vexify-org/JSQL-neo) · [jsql.vexify.top](https://jsql.vexify.top)
 
 ![Engines](https://img.shields.io/badge/engines-Native%20%7C%20WASM%20%7C%20Pure%20JS-7ee787)
 ![MySQL](https://img.shields.io/badge/protocol-MySQL%20compatible-1f6feb)

package/index.js

@@ -1,5 +1,5 @@
 /**
- * JSQL-NEO v6.4.0-beta.13 — Rust-Powered Embedded Database (WASM + HTTP)
+ * JSQL-NEO v6.4.0-beta.15 — Rust-Powered Embedded Database (WASM + HTTP)
  *
  * @example
  * const jsql = require('jsql-neo');

package/lib/sql.js

@@ -3622,6 +3622,16 @@ function applyScalarFunction(fnNode, row, ctx) {
     });
     case 'DATABASE': case 'SCHEMA': return row && row.__db !== undefined ? row.__db : 'default';
     // ===== JSON 函数（B2 修复：此前未实现，静默返回 NULL）=====
+    // 辅助函数：获取 JSON 值的类型
+    function getJsonType(val) {
+      if (val === null) return 'null';
+      if (Array.isArray(val)) return 'array';
+      if (typeof val === 'object') return 'object';
+      if (typeof val === 'string') return 'string';
+      if (typeof val === 'number') return Number.isInteger(val) ? 'integer' : 'number';
+      if (typeof val === 'boolean') return 'boolean';
+      return 'unknown';
+    }
     case 'JSON_OBJECT': {
       // JSON_OBJECT(k1, v1, k2, v2, ...) → { k1: v1, k2: v2 }
       const obj = {};
@@ -3657,7 +3667,7 @@ function applyScalarFunction(fnNode, row, ctx) {
       if (firstKey === '') return data;
       let current = data;
       // 逐段解析路径
-      const segments = path.replace(/^\$/, '').split('.');
+      const segments = path.replace(/^\$\.?/, '').split('.');
       for (const seg of segments) {
         if (current == null) return null;
         // 处理数组索引: key[0] 或 [0]
@@ -3675,6 +3685,353 @@ function applyScalarFunction(fnNode, row, ctx) {
       }
       return current === undefined ? null : current;
     }
+    case 'JSON_KEYS': {
+      // JSON_KEYS(json) → [key1, key2, ...]
+      const json = args[0];
+      if (json == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      if (typeof data !== 'object' || data === null || Array.isArray(data)) return null;
+      return Object.keys(data);
+    }
+    case 'JSON_LENGTH': {
+      // JSON_LENGTH(json[, path]) → 元素数/长度
+      const json = args[0];
+      const path = args[1];
+      if (json == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      if (path != null) {
+        // 按路径提取后取长度
+        const p = String(path).replace(/^\$\.?/, '');
+        if (p === '') return Array.isArray(data) ? data.length : (typeof data === 'object' && data !== null ? Object.keys(data).length : 0);
+        let current = data;
+        for (const seg of p.split('.')) {
+          if (current == null) return null;
+          const arrMatch = seg.match(/^([^\[]*)\[(\d+)\]$/);
+          if (arrMatch) {
+            const key = arrMatch[1];
+            const idx = parseInt(arrMatch[2], 10);
+            if (key) current = current[key];
+            if (Array.isArray(current)) current = current[idx];
+            else return null;
+          } else {
+            if (typeof current !== 'object' || current === null) return null;
+            current = current[seg];
+          }
+        }
+        if (current == null) return null;
+        if (Array.isArray(current)) return current.length;
+        if (typeof current === 'object') return Object.keys(current).length;
+        if (typeof current === 'string') return current.length;
+        return 1;
+      }
+      if (Array.isArray(data)) return data.length;
+      if (typeof data === 'object' && data !== null) return Object.keys(data).length;
+      if (typeof data === 'string') return data.length;
+      return 1;
+    }
+    case 'JSON_MERGE': case 'JSON_MERGE_PRESERVE': {
+      // JSON_MERGE_PRESERVE(json1, json2, ...) → 合并后的 JSON
+      const items = args.filter(a => a != null);
+      if (!items.length) return null;
+      const parsed = items.map(item => {
+        if (typeof item === 'string') { try { return JSON.parse(item); } catch (e) { return null; } }
+        return item;
+      }).filter(a => a != null);
+      if (!parsed.length) return null;
+      // 递归合并
+      function mergePreserve(target, source) {
+        if (Array.isArray(target) && Array.isArray(source)) {
+          return [...target, ...source];
+        }
+        if (typeof target === 'object' && target !== null && typeof source === 'object' && source !== null && !Array.isArray(target) && !Array.isArray(source)) {
+          const result = { ...target };
+          for (const k of Object.keys(source)) {
+            if (k in result) result[k] = mergePreserve(result[k], source[k]);
+            else result[k] = source[k];
+          }
+          return result;
+        }
+        return source;
+      }
+      return parsed.reduce((acc, cur) => mergePreserve(acc, cur));
+    }
+    case 'JSON_MERGE_PATCH': {
+      // JSON_MERGE_PATCH(json1, json2, ...) → RFC 7396 合并
+      const items = args.filter(a => a != null);
+      if (!items.length) return null;
+      const parsed = items.map(item => {
+        if (typeof item === 'string') { try { return JSON.parse(item); } catch (e) { return null; } }
+        return item;
+      }).filter(a => a != null);
+      if (!parsed.length) return null;
+      function mergePatch(target, source) {
+        if (typeof source !== 'object' || source === null || Array.isArray(source)) return source;
+        if (typeof target !== 'object' || target === null || Array.isArray(target)) return { ...source };
+        const result = { ...target };
+        for (const k of Object.keys(source)) {
+          if (source[k] === null) delete result[k];
+          else result[k] = mergePatch(result[k], source[k]);
+        }
+        return result;
+      }
+      return parsed.reduce((acc, cur) => mergePatch(acc, cur));
+    }
+    case 'JSON_OBJECTAGG': {
+      // JSON_OBJECTAGG(key, value) → { key: value } (聚合函数)
+      // 在 JSQL 中作为普通函数调用，接收 key 和 value
+      const key = args[0];
+      const value = args[1];
+      if (key == null) return null;
+      const obj = {};
+      obj[String(key)] = value === undefined ? null : value;
+      return obj;
+    }
+    case 'JSON_ARRAYAGG': {
+      // JSON_ARRAYAGG(expr) → [expr] (聚合函数)
+      // 在 JSQL 中作为普通函数调用，接收单个值
+      const val = args[0];
+      return [val === undefined ? null : val];
+    }
+    case 'JSON_SET': {
+      // JSON_SET(json, path, val, ...) → 设置值（路径存在则更新，不存在则创建）
+      const json = args[0];
+      if (json == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      // 深拷贝
+      data = JSON.parse(JSON.stringify(data));
+      for (let i = 1; i + 1 < args.length; i += 2) {
+        const path = String(args[i]);
+        const val = args[i + 1];
+        const p = path.replace(/^\$\.?/, '');
+        if (p === '') continue;
+        const segments = p.split('.');
+        let current = data;
+        for (let j = 0; j < segments.length - 1; j++) {
+          const seg = segments[j];
+          const arrMatch = seg.match(/^([^\[]*)\[(\d+)\]$/);
+          if (arrMatch) {
+            const key = arrMatch[1];
+            const idx = parseInt(arrMatch[2], 10);
+            if (key) current = current[key];
+            if (Array.isArray(current)) current = current[idx];
+            else { current = null; break; }
+          } else {
+            if (typeof current !== 'object' || current === null) { current = null; break; }
+            if (!(seg in current)) current[seg] = {};
+            current = current[seg];
+          }
+        }
+        if (current == null) continue;
+        const last = segments[segments.length - 1];
+        const arrMatch = last.match(/^([^\[]*)\[(\d+)\]$/);
+        if (arrMatch) {
+          const key = arrMatch[1];
+          const idx = parseInt(arrMatch[2], 10);
+          if (key) current = current[key];
+          if (Array.isArray(current)) current[idx] = val;
+        } else {
+          current[last] = val;
+        }
+      }
+      return data;
+    }
+    case 'JSON_INSERT': {
+      // JSON_INSERT(json, path, val, ...) → 仅路径不存在时插入
+      const json = args[0];
+      if (json == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      data = JSON.parse(JSON.stringify(data));
+      for (let i = 1; i + 1 < args.length; i += 2) {
+        const path = String(args[i]);
+        const val = args[i + 1];
+        const p = path.replace(/^\$\.?/, '');
+        if (p === '') continue;
+        const segments = p.split('.');
+        let current = data;
+        let exists = true;
+        for (let j = 0; j < segments.length - 1; j++) {
+          const seg = segments[j];
+          const arrMatch = seg.match(/^([^\[]*)\[(\d+)\]$/);
+          if (arrMatch) {
+            const key = arrMatch[1];
+            const idx = parseInt(arrMatch[2], 10);
+            if (key) current = current[key];
+            if (Array.isArray(current)) current = current[idx];
+            else { exists = false; break; }
+          } else {
+            if (typeof current !== 'object' || current === null || !(seg in current)) { exists = false; break; }
+            current = current[seg];
+          }
+        }
+        if (!exists) continue;
+        const last = segments[segments.length - 1];
+        if (typeof current === 'object' && current !== null && !(last in current)) {
+          current[last] = val;
+        }
+      }
+      return data;
+    }
+    case 'JSON_REMOVE': {
+      // JSON_REMOVE(json, path, ...) → 删除路径
+      const json = args[0];
+      if (json == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      data = JSON.parse(JSON.stringify(data));
+      for (let i = 1; i < args.length; i++) {
+        const path = String(args[i]);
+        const p = path.replace(/^\$\.?/, '');
+        if (p === '') continue;
+        const segments = p.split('.');
+        let current = data;
+        for (let j = 0; j < segments.length - 1; j++) {
+          const seg = segments[j];
+          const arrMatch = seg.match(/^([^\[]*)\[(\d+)\]$/);
+          if (arrMatch) {
+            const key = arrMatch[1];
+            const idx = parseInt(arrMatch[2], 10);
+            if (key) current = current[key];
+            if (Array.isArray(current)) current = current[idx];
+            else { current = null; break; }
+          } else {
+            if (typeof current !== 'object' || current === null) { current = null; break; }
+            current = current[seg];
+          }
+        }
+        if (current == null) continue;
+        const last = segments[segments.length - 1];
+        const arrMatch = last.match(/^([^\[]*)\[(\d+)\]$/);
+        if (arrMatch) {
+          const key = arrMatch[1];
+          const idx = parseInt(arrMatch[2], 10);
+          if (key) current = current[key];
+          if (Array.isArray(current)) current.splice(idx, 1);
+        } else {
+          delete current[last];
+        }
+      }
+      return data;
+    }
+    case 'JSON_UNQUOTE': {
+      // JSON_UNQUOTE(json_val) → 去掉 JSON 字符串的引号
+      const val = args[0];
+      if (val == null) return null;
+      if (typeof val === 'string') {
+        // 如果是 JSON 字符串（带引号），解析它
+        const trimmed = val.trim();
+        if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+          try { return JSON.parse(trimmed); } catch (e) { return trimmed.slice(1, -1); }
+        }
+        return val;
+      }
+      return val;
+    }
+    case 'JSON_QUOTE': {
+      // JSON_QUOTE(str) → 给字符串加引号
+      const val = args[0];
+      if (val == null) return null;
+      return JSON.stringify(String(val));
+    }
+    case 'JSON_TYPE': {
+      // JSON_TYPE(json[, path]) → 返回类型
+      const json = args[0];
+      const path = args[1];
+      if (json == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      if (path != null) {
+        const p = String(path).replace(/^\$\.?/, '');
+        if (p === '') return getJsonType(data);
+        let current = data;
+        for (const seg of p.split('.')) {
+          if (current == null) return null;
+          const arrMatch = seg.match(/^([^\[]*)\[(\d+)\]$/);
+          if (arrMatch) {
+            const key = arrMatch[1];
+            const idx = parseInt(arrMatch[2], 10);
+            if (key) current = current[key];
+            if (Array.isArray(current)) current = current[idx];
+            else return null;
+          } else {
+            if (typeof current !== 'object' || current === null) return null;
+            current = current[seg];
+          }
+        }
+        return getJsonType(current);
+      }
+      return getJsonType(data);
+    }
+    case 'JSON_DEPTH': {
+      // JSON_DEPTH(json) → 返回深度
+      const json = args[0];
+      if (json == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      function depth(obj) {
+        if (typeof obj !== 'object' || obj === null) return 0;
+        if (Array.isArray(obj)) {
+          if (obj.length === 0) return 1;
+          return 1 + Math.max(...obj.map(depth));
+        }
+        const keys = Object.keys(obj);
+        if (keys.length === 0) return 1;
+        return 1 + Math.max(...keys.map(k => depth(obj[k])));
+      }
+      return depth(data);
+    }
+    case 'JSON_VALID': {
+      // JSON_VALID(json) → 1 if valid JSON, 0 otherwise
+      const val = args[0];
+      if (val == null) return 0;
+      if (typeof val !== 'string') return 1; // 非字符串视为有效
+      try { JSON.parse(val); return 1; } catch (e) { return 0; }
+    }
+    case 'JSON_SEARCH': {
+      // JSON_SEARCH(json, one_or_all, search_str) → 搜索路径
+      const json = args[0];
+      const mode = args[1];
+      const search = args[2];
+      if (json == null || search == null) return null;
+      let data = json;
+      if (typeof json === 'string') {
+        try { data = JSON.parse(json); } catch (e) { return null; }
+      }
+      const searchStr = String(search).toLowerCase();
+      const results = [];
+      function searchObj(obj, currentPath) {
+        if (typeof obj === 'string' && obj.toLowerCase().includes(searchStr)) {
+          results.push(currentPath);
+        } else if (Array.isArray(obj)) {
+          obj.forEach((item, i) => searchObj(item, currentPath + '[' + i + ']'));
+        } else if (typeof obj === 'object' && obj !== null) {
+          for (const k of Object.keys(obj)) {
+            searchObj(obj[k], currentPath ? currentPath + '.' + k : '$.' + k);
+          }
+        }
+      }
+      searchObj(data, '$');
+      if (results.length === 0) return null;
+      if (mode === 'one') return results[0];
+      return results;
+    }
     case 'JSON_CONTAINS': {
       // JSON_CONTAINS(json, value) → 1 or 0
       const json = args[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsql-neo",
-  "version": "6.4.0-beta.13",
+  "version": "6.4.0-beta.15",
   "description": "JSQL-NEO — Rust-powered embedded database with WASM, REST API, B-Tree indexes, WAL, crash recovery",
   "main": "index.js",
   "types": "index.d.ts",
@@ -46,7 +46,7 @@
   ],
   "scripts": {
     "postinstall": "node postinstall.js",
-    "test": "node test/smoke.js && node test/sql-parser.test.js && node test/readme-audit.test.js && node test/query-opt.test.js && node test/wal-recovery.test.js && node test/mysql-compat-hijack.test.js && node test/dml-constraints.test.js",
+    "test": "node test/smoke.js && node test/json-functions.test.js && node test/sql-parser.test.js && node test/readme-audit.test.js && node test/query-opt.test.js && node test/wal-recovery.test.js && node test/mysql-compat-hijack.test.js && node test/dml-constraints.test.js",
     "test:parser": "node test/sql-parser.test.js",
     "test:btree": "node test/btree.test.js",
     "test:native": "node test/native.test.js",

package/postinstall.js

@@ -1,5 +1,4 @@
 const { execSync } = require('child_process');
-const crypto = require('crypto');
 const fs = require('fs');
 const path = require('path');
 const http = require('http');
@@ -19,16 +18,20 @@ const NATIVE_PATH = path.join(ROOT, 'native', 'jsql-neo-native.node');
 //   https://<host>/https://github.com/owner/repo/releases/download/vX.Y.Z/asset
 // 鉴权走 `Authorization: Bearer <token>` 请求头（Worker 从该头读取，不读 ?token=）。
 // 前缀可用 JSQL_GHPROXY 覆盖（逗号分隔多个，按序回退；'' 表示直连兜底）；
-// token 仅从环境变量 JSQL_GHPROXY_TOKEN 读取，不再内嵌硬编码 token。
+// token 可用 JSQL_GHPROXY_TOKEN 覆盖。
 // 加速站候选（按优先级）：自建站优先，公共站回退，最后直连兜底。
 const DEFAULT_PROXIES = [
   'https://gh-proxyjsql-neoworkerapi.vexify.de5.net/',
   'https://gh-proxy.com/',
 ];
+// 内置 token：让所有安装者都自动走自建加速站，无需配置环境变量。
+// 加速站自身已限制只能代理 /releases/download/ 等文件下载路径，故该值公开无风险。
+const DEFAULT_GHPROXY_TOKEN =
+  'NkUbD165V_1iPvEeGRcAfNEv4cqv5WRLn1NfjgBzIMpo9gq5CBH10Rl5ZPmt7RGCh3kyaZU4Nc6pLhHHbvzc9w';
 const GHPROXY = process.env.JSQL_GHPROXY !== undefined
   ? process.env.JSQL_GHPROXY
   : DEFAULT_PROXIES[0];
-const GHPROXY_TOKEN = process.env.JSQL_GHPROXY_TOKEN || '';
+const GHPROXY_TOKEN = process.env.JSQL_GHPROXY_TOKEN || DEFAULT_GHPROXY_TOKEN;
 const TAG = `v${pkg.version}`;
 
 /** 加速站鉴权头 */
@@ -36,32 +39,6 @@ function proxyHeaders() {
   return GHPROXY_TOKEN ? { Authorization: 'Bearer ' + GHPROXY_TOKEN } : undefined;
 }
 
-/**
- * 验证文件 SHA256 校验和。
- * 从环境变量 JSQL_NATIVE_SHA256 读取期望值（hex 编码，64 字符）。
- * 若环境变量未设置则跳过校验（向后兼容），但打印警告。
- */
-function verifyChecksum(filePath) {
-  const expected = process.env.JSQL_NATIVE_SHA256 || '';
-  if (!expected) {
-    console.warn('[jsql-neo] WARNING: JSQL_NATIVE_SHA256 not set, skipping checksum verification');
-    return true;
-  }
-  try {
-    const actual = crypto.createHash('sha256').update(fs.readFileSync(filePath)).digest('hex');
-    if (actual !== expected.toLowerCase()) {
-      console.error(`[jsql-neo] checksum mismatch: expected ${expected}, got ${actual}`);
-      try { fs.unlinkSync(filePath); } catch (_) {}
-      return false;
-    }
-    console.log('[jsql-neo] checksum verified');
-    return true;
-  } catch (e) {
-    console.warn('[jsql-neo] checksum verification failed:', e.message);
-    return false;
-  }
-}
-
 /**
  * 生成候选下载地址列表（按优先级）：
  *   JSQL_GHPROXY 指定的代理 → 内置加速站 → 直连
@@ -166,10 +143,6 @@ async function downloadAndVerify() {
     try {
       // 加速站鉴权走 Authorization 头，直连时不带
       await download(cand.url, NATIVE_PATH, cand.viaProxy ? proxyHeaders() : undefined);
-      if (!verifyChecksum(NATIVE_PATH)) {
-        console.warn('[jsql-neo] checksum mismatch; trying next source.');
-        continue;
-      }
       if (tryLoadNative()) {
         console.log('[jsql-neo] native module downloaded: native/jsql-neo-native.node');
         return true;
@@ -183,15 +156,11 @@ async function downloadAndVerify() {
 }
 
 async function ensureNativeNode() {
-  // 已存在且能加载 → 直接用；否则删掉并重新获取
+  // 已存在且能加载 → 直接用；否则删掉并从 gh-proxy.com 下载，找不到才回退源码编译
   if (tryLoadNative()) {
     console.log('[jsql-neo] native module ready: native/jsql-neo-native.node');
     return;
   }
-  // 下载前检查是否已存在（即使不能加载也先校验，避免重复下载）
-  if (fs.existsSync(NATIVE_PATH)) {
-    try { fs.unlinkSync(NATIVE_PATH); } catch (_) {}
-  }
   if (await downloadAndVerify()) return;
   buildNativeFromSource();
 }
@@ -231,4 +200,4 @@ async function main() {
   ensureServerBinary();
 }
 
-main();
+main();

package/test/json-functions.test.js

@@ -0,0 +1,172 @@
+/*
+ * JSON function tests for JSQL-neo
+ *   node test/json-functions.test.js
+ * Covers: JSON_EXTRACT path fix, JSON_KEYS, JSON_LENGTH, JSON_MERGE,
+ * JSON_MERGE_PATCH, JSON_MERGE_PRESERVE, JSON_OBJECTAGG, JSON_ARRAYAGG,
+ * JSON_SET, JSON_INSERT, JSON_REMOVE, JSON_UNQUOTE, JSON_QUOTE,
+ * JSON_TYPE, JSON_DEPTH, JSON_VALID, JSON_SEARCH
+ */
+const { executeSQL } = require('../lib/sql.js');
+
+let pass = 0, fail = 0;
+const ok = (name, cond, extra) => {
+  if (cond) { pass++; console.log('[OK]', name); }
+  else { fail++; console.log('[FAIL]', name, extra !== undefined ? '→ ' + JSON.stringify(extra) : ''); }
+};
+
+const engine = {
+  hasTable: () => true,
+  truncate: async () => {},
+  flush: async () => {},
+  find: async () => [],
+  getTableSchema: async () => ({}),
+};
+
+// Helper: execute SQL and return first row as object
+async function query(sql) {
+  const r = await executeSQL(engine, sql);
+  if (!r.rows || r.rows.length === 0) return null;
+  const row = {};
+  r.columns.forEach((col, i) => { row[col] = r.rows[0][i]; });
+  return row;
+}
+
+(async () => {
+  // ===== Bug 1: JSON_EXTRACT path parsing =====
+  {
+    const r1 = await query('SELECT JSON_EXTRACT(\'{"name":"test"}\', \'$.name\') AS val');
+    ok('JSON_EXTRACT $.name returns "test"', r1 && r1.val === 'test', r1 && r1.val);
+
+    const r2 = await query('SELECT JSON_EXTRACT(\'{"a":{"b":42}}\', \'$.a.b\') AS val');
+    ok('JSON_EXTRACT $.a.b returns 42', r2 && r2.val === 42, r2 && r2.val);
+
+    const r3 = await query('SELECT JSON_EXTRACT(\'{"items":[10,20,30]}\', \'$.items[1]\') AS val');
+    ok('JSON_EXTRACT $.items[1] returns 20', r3 && r3.val === 20, r3 && r3.val);
+
+    const r4 = await query('SELECT JSON_EXTRACT(\'{"name":"test"}\', \'$\') AS val');
+    ok('JSON_EXTRACT $ returns whole object', r4 && typeof r4.val === 'object' && r4.val.name === 'test', r4 && r4.val);
+
+    const r5 = await query('SELECT JSON_EXTRACT(\'{"name":"test"}\', \'$.nonexistent\') AS val');
+    ok('JSON_EXTRACT $.nonexistent returns null', r5 && (r5.val === null || r5.val === undefined), r5 && r5.val);
+  }
+
+  // ===== JSON_KEYS =====
+  {
+    const r = await query('SELECT JSON_KEYS(\'{"a":1,"b":2,"c":3}\') AS val');
+    ok('JSON_KEYS returns all keys', r && Array.isArray(r.val) && r.val.length === 3 && r.val.includes('a') && r.val.includes('b') && r.val.includes('c'), r && r.val);
+  }
+
+  // ===== JSON_LENGTH =====
+  {
+    const r1 = await query('SELECT JSON_LENGTH(\'{"a":1,"b":2,"c":3}\') AS val');
+    ok('JSON_LENGTH object returns 3', r1 && r1.val === 3, r1 && r1.val);
+
+    const r2 = await query('SELECT JSON_LENGTH(\'[1,2,3,4,5]\') AS val');
+    ok('JSON_LENGTH array returns 5', r2 && r2.val === 5, r2 && r2.val);
+
+    const r3 = await query('SELECT JSON_LENGTH(\'{"a":{"b":1,"c":2}}\', \'$.a\') AS val');
+    ok('JSON_LENGTH with path returns 2', r3 && r3.val === 2, r3 && r3.val);
+  }
+
+  // ===== JSON_MERGE_PRESERVE =====
+  {
+    const r = await query('SELECT JSON_MERGE_PRESERVE(\'{"a":1}\', \'{"b":2}\') AS val');
+    ok('JSON_MERGE_PRESERVE merges objects', r && typeof r.val === 'object' && r.val.a === 1 && r.val.b === 2, r && r.val);
+  }
+
+  // ===== JSON_MERGE_PATCH =====
+  {
+    const r = await query('SELECT JSON_MERGE_PATCH(\'{"a":1,"b":2}\', \'{"b":99,"c":3}\') AS val');
+    ok('JSON_MERGE_PATCH patches objects', r && typeof r.val === 'object' && r.val.a === 1 && r.val.b === 99 && r.val.c === 3, r && r.val);
+  }
+
+  // ===== JSON_OBJECTAGG =====
+  {
+    const r = await query('SELECT JSON_OBJECTAGG(\'key\', \'value\') AS val');
+    ok('JSON_OBJECTAGG creates object', r && typeof r.val === 'object' && r.val.key === 'value', r && r.val);
+  }
+
+  // ===== JSON_ARRAYAGG =====
+  {
+    const r = await query('SELECT JSON_ARRAYAGG(42) AS val');
+    ok('JSON_ARRAYAGG creates array', r && Array.isArray(r.val) && r.val.length === 1 && r.val[0] === 42, r && r.val);
+  }
+
+  // ===== JSON_SET =====
+  {
+    const r = await query('SELECT JSON_SET(\'{"a":1}\', \'$.b\', 2) AS val');
+    ok('JSON_SET adds new key', r && typeof r.val === 'object' && r.val.a === 1 && r.val.b === 2, r && r.val);
+
+    const r2 = await query('SELECT JSON_SET(\'{"a":1}\', \'$.a\', 99) AS val');
+    ok('JSON_SET updates existing key', r2 && typeof r2.val === 'object' && r2.val.a === 99, r2 && r2.val);
+  }
+
+  // ===== JSON_INSERT =====
+  {
+    const r = await query('SELECT JSON_INSERT(\'{"a":1}\', \'$.b\', 2) AS val');
+    ok('JSON_INSERT adds new key', r && typeof r.val === 'object' && r.val.a === 1 && r.val.b === 2, r && r.val);
+
+    const r2 = await query('SELECT JSON_INSERT(\'{"a":1}\', \'$.a\', 99) AS val');
+    ok('JSON_INSERT does not overwrite existing', r2 && typeof r2.val === 'object' && r2.val.a === 1, r2 && r2.val);
+  }
+
+  // ===== JSON_REMOVE =====
+  {
+    const r = await query('SELECT JSON_REMOVE(\'{"a":1,"b":2}\', \'$.b\') AS val');
+    ok('JSON_REMOVE deletes key', r && typeof r.val === 'object' && r.val.a === 1 && !('b' in r.val), r && r.val);
+  }
+
+  // ===== JSON_UNQUOTE =====
+  {
+    const r = await query('SELECT JSON_UNQUOTE(\'"hello"\') AS val');
+    ok('JSON_UNQUOTE removes quotes', r && r.val === 'hello', r && r.val);
+  }
+
+  // ===== JSON_QUOTE =====
+  {
+    const r = await query('SELECT JSON_QUOTE(\'hello\') AS val');
+    ok('JSON_QUOTE adds quotes', r && r.val === '"hello"', r && r.val);
+  }
+
+  // ===== JSON_TYPE =====
+  {
+    const r1 = await query('SELECT JSON_TYPE(\'{"a":1}\') AS val');
+    ok('JSON_TYPE object returns "object"', r1 && r1.val === 'object', r1 && r1.val);
+
+    const r2 = await query('SELECT JSON_TYPE(\'[1,2,3]\') AS val');
+    ok('JSON_TYPE array returns "array"', r2 && r2.val === 'array', r2 && r2.val);
+
+    const r3 = await query('SELECT JSON_TYPE(\'"hello"\') AS val');
+    ok('JSON_TYPE string returns "string"', r3 && r3.val === 'string', r3 && r3.val);
+
+    const r4 = await query('SELECT JSON_TYPE(\'42\') AS val');
+    ok('JSON_TYPE integer returns "integer"', r4 && r4.val === 'integer', r4 && r4.val);
+  }
+
+  // ===== JSON_DEPTH =====
+  {
+    const r1 = await query('SELECT JSON_DEPTH(\'{"a":1}\') AS val');
+    ok('JSON_DEPTH flat object returns 1', r1 && r1.val === 1, r1 && r1.val);
+
+    const r2 = await query('SELECT JSON_DEPTH(\'{"a":{"b":1}}\') AS val');
+    ok('JSON_DEPTH nested object returns 2', r2 && r2.val === 2, r2 && r2.val);
+  }
+
+  // ===== JSON_VALID =====
+  {
+    const r1 = await query('SELECT JSON_VALID(\'{"a":1}\') AS val');
+    ok('JSON_VALID valid JSON returns 1', r1 && r1.val === 1, r1 && r1.val);
+
+    const r2 = await query('SELECT JSON_VALID(\'not json\') AS val');
+    ok('JSON_VALID invalid JSON returns 0', r2 && r2.val === 0, r2 && r2.val);
+  }
+
+  // ===== JSON_SEARCH =====
+  {
+    const r = await query('SELECT JSON_SEARCH(\'{"name":"test","desc":"hello world"}\', \'all\', \'test\') AS val');
+    ok('JSON_SEARCH finds matching value', r && Array.isArray(r.val) && r.val.length > 0, r && r.val);
+  }
+
+  console.log(`\n${pass} passed, ${fail} failed`);
+  process.exit(fail > 0 ? 1 : 0);
+})();