jsql-neo 4.1.2 → 4.2.0

package/README.md

@@ -1,6 +1,6 @@
-# JSQL-NEO v4.1.1
+# JSQL-NEO v4.2.0
 
-Rust-powered embedded database with **three engines + SQL + Redis-style storage** in one npm package.
+Rust-powered embedded database with **three engines + SQL + MySQL-compatible server + Redis-style storage** in one npm package.
 
 > **Docs & Help:** [https://help.vexify.top](https://help.vexify.top)  
 > **GitHub:** [https://github.com/vexify-org/JSQL-neo](https://github.com/vexify-org/JSQL-neo)
@@ -33,7 +33,54 @@ await jsql.executeSQL(db, 'DELETE FROM users WHERE id = 2');
 await db.stop();
 ```
 
-Supported: `CREATE/DROP TABLE`, `INSERT` (multi-row, `ON DUPLICATE KEY UPDATE`), `SELECT` (`WHERE`/`ORDER BY`/`LIMIT`/`OFFSET`/`GROUP BY`/`HAVING`/aggregates), `UPDATE`, `DELETE`, prepared statements with `?` placeholders.
+Supported SQL: `CREATE/DROP TABLE` (incl. `IF [NOT] EXISTS`), `CREATE/DROP DATABASE`, `USE` / `SHOW DATABASES` / `SHOW TABLES [FROM db]`, `INSERT` (multi-row, `ON DUPLICATE KEY UPDATE`), `SELECT` (`WHERE` / `ORDER BY` / `LIMIT` / `OFFSET` / `GROUP BY` / `HAVING` / aggregates `COUNT`/`SUM`/`AVG`/`MIN`/`MAX` / `DISTINCT` / `JOIN` / `UNION [ALL]` / `CASE WHEN` / subqueries `IN (…)` & scalar `(SELECT …)` / `BETWEEN`/`LIKE`/`IS NULL`), `UPDATE`, `DELETE`, `BEGIN`/`COMMIT`/`ROLLBACK`, prepared statements with `?` placeholders.
+
+Type names accept MySQL aliases: `INTEGER/INT/BIGINT/TINYINT/SMALLINT`, `STRING/TEXT/VARCHAR(n)/CHAR(n)`, `FLOAT/DOUBLE/REAL/NUMERIC/DECIMAL`, `BOOLEAN/BOOL`, `DATE/DATETIME/TIMESTAMP`, `JSON/OBJECT/ARRAY`.
+
+## MySQL-Compatible Server (multi-database)
+
+A native MySQL protocol server on TCP 3306 — any `mysql` / `mysql2` / GUI client connects directly.
+
+```bash
+npx jsql server start --port 3306 --data-dir ./data        # 后台常驻
+npx jsql server status                                     # 状态
+npx jsql server stop                                       # 停止
+```
+
+**Multi-database & 一键建表:** each database is an independent directory (`<dataDir>/<db>`).
+
+```sql
+-- 随意连接即可直接建表（自动落到默认库 default）
+CREATE TABLE users (id INTEGER PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50));
+
+-- 一条 SQL 跨库建库+建表（库不存在自动创建）
+CREATE TABLE shop.orders (id INTEGER PRIMARY KEY, amount FLOAT, `user` STRING);
+
+-- 连接时指定尚不存在的库会自动创建：mysql -uroot -D mydb
+-- 查询/增删改也能带库前缀：INSERT INTO shop.orders ..., SELECT * FROM shop.orders, SHOW TABLES FROM shop;
+```
+
+- 连接指定未存在的库 → **自动建库**，无需先 `CREATE DATABASE`
+- 未 `USE` 任何库 → 落到默认库，可直接 `CREATE TABLE`
+- 全量多库 DDL/DML 支持 `db.table` 点号语法 + `SHOW TABLES FROM db`
+- **多用户 + 库级权限**: 每个用户可配置可访问的数据库白名单（`{ user: { password, databases: [...] } }`）
+
+```json
+{ "port": 3306, "dataDir": "/var/lib/jsql",
+  "auth": { "admin": { "password": "secret", "databases": ["shop", "blog"] }, "reader": "readpass" } }
+```
+
+## Transactions
+
+```js
+db.begin();            // 默认 REPEATABLE_READ：begin 时保存行快照
+db.insert('t', { id: 2 });
+db.rollback();         // 删除新增、还原更新、恢复自增 —— 回滚生效
+db.begin(); db.insert('t', { id: 3 }); db.commit();
+// 也支持 SQL：BEGIN ... COMMIT / ROLLBACK
+```
+
+`begin(isolationLevel)` 可选 `'REPEATABLE_READ'`（快照回滚，默认）或 `'READ_COMMITTED'`（仅回滚自增）。
 
 ## Redis-Style Storage Modes
 
@@ -107,29 +154,58 @@ db.save();
 | `updateById(table, id, data)` | ✅ | ✅ | ✅ | O(1) PK update |
 | `removeById(table, id)` | ✅ | ✅ | ✅ | O(1) PK delete |
 | `dropTable(name)` | ✅ | ✅ | ✅ | Remove table |
+| `insertMany(table, items)` | ✅ | ✅ | ✅ | Batch insert |
+| `update(table, query, updates)` | ✅ | ✅ | ✅ | Batch update by query |
+| `delete(table, query)` | ✅ | ✅ | ✅ | Batch delete by query |
+| `truncate(table)` | ✅ | ✅ | ✅ | Delete all rows |
+| `begin()/commit()/rollback()` | ✅ | ✅ | ✅ | Transactions (snapshot rollback) |
 | `executeSQL(db, sql, params?)` | ✅ | ✅ | ✅ | Run SQL statements |
 
 ## Schema Field Options
 
 ```js
 {
-  type: 'string' | 'integer' | 'float' | 'boolean',
-  primaryKey: true,       // PK field (auto-indexed)
+  type: 'string' | 'integer' | 'float' | 'boolean' | 'date' | 'object' | 'array',
+  primaryKey: true,       // PK field (auto-indexed) — `primary: true` 也接受
   autoIncrement: true,    // Auto-generate integer PK
+  unique: true,           // Unique constraint (auto-indexed)
   length: 32,             // Max string length
   default: 'value',       // Default value
-  nullable: true          // Allow null
+  nullable: true,         // Allow null
+  required: true,         // Not-null constraint
+  foreignKey: { table, field, onDelete },  // FK constraint
+  check: (val) => bool,   // CHECK constraint
+  computed: (row) => val  // Computed field
 }
 ```
 
 ## Features
 
-- Three engines: Native (N-API Rust), WASM (wasm-pack Rust), Pure JS (local JSON)
-- SQL engine with prepared statements
-- Redis-style hybrid/disk storage: memory-first + async flush + LRU eviction + lazy reload
-- O(1) primary key hash index (`FxHashMap` / `Map`)
-- B-Tree indexing for range queries
-- WAL + snapshot crash recovery (server engine)
-- Batch insert / update / delete
-- Cursor-based pagination
-- Transaction support (server engine)
+**Engines & Storage**
+- Three engines with one shared API: Native (N-API Rust, fastest), WASM (wasm-pack, zero native deps), Pure JS (`Database`)
+- Redis-style storage modes: `memory` / `hybrid` (async flush + LRU eviction + lazy reload) / `disk` (fast flush, memory as cache)
+- Atomic per-table files (`<dir>/<table>.jsql.json` + `meta.json`, tmp + rename)
+- WAL + snapshot crash recovery
+- O(1) primary-key hash index (`FxHashMap` / `Map`) + B-Tree range indexes
+
+**SQL**
+- Full statement coverage: DDL / DML / SELECT (aggregates, `GROUP BY`/`HAVING`, `JOIN`, `UNION`, `CASE WHEN`, subqueries) / transactions
+- Prepared statements with `?` placeholders
+- MySQL type-name aliases + `db.table` cross-database syntax + `SHOW TABLES FROM db`
+
+**MySQL Server & CLI**
+- MySQL protocol server (TCP 3306), compatible with `mysql`/`mysql2`/GUI clients
+- Multi-database (one dir per DB), auto-create on connect / on `db.table` usage, default-DB fallback for one-click `CREATE TABLE`
+- Multi-user authentication with per-database access lists (`1044`/`1049` enforcement)
+- `jsql server start/stop/status` background daemon with graceful shutdown
+
+**Data API**
+- Typed schema with constraints: PK / auto-increment / unique / required / length / default / FK / CHECK / computed fields
+- Batch insert / update / delete, cursor-based pagination, upsert
+- Transactions with snapshot rollback (default `REPEATABLE_READ`)
+- CSV import/export, JSON schema validation, soft delete, versioning, views, triggers, attachable databases
+- Hooks & change events (`beforeInsert`/`afterUpdate`/…) for plugins and audit
+
+**Security**
+- SQL injection hardening: comments/`LOAD_FILE`/dangerous statements blocked by default, ReDoS-safe regex
+- Rate-limited auth (max auth fails), oversized-row protection, safe name/path validation (`..` blocked)

package/lib/database.js

@@ -92,8 +92,8 @@ class Database {
         this._walPath = this._filePath ? this._filePath + '.wal' : null;
         this._walOps = [];          // WAL 操作日志
 
-        // 事务隔离
-        this._isolationLevel = options.isolationLevel || 'READ_COMMITTED';
+        // 事务隔离：默认 REPEATABLE_READ（begin 时保存行快照，rollback 可回滚）
+        this._isolationLevel = options.isolationLevel || 'REPEATABLE_READ';
 
         // JSql 格式 (binary block-based)
         this._jsqlMode = this._filePath && this._filePath.endsWith('.jsql');
@@ -1286,6 +1286,49 @@ class Database {
         return { ok: true, count: removed };
     }
 
+    insertMany(tableName, items) {
+        const table = this._ensureTable(tableName);
+        if (!table) throw createError('ER_NO_SUCH_TABLE', tableName);
+        const arr = Array.isArray(items) ? items : [items];
+        if (!this._runHooks('beforeInsert', [tableName, arr])) return [];
+        const inserted = table.insertMany(arr);
+        this._emit('insert', { table: tableName, count: arr.length });
+        this._runHooks('afterInsert', [tableName, arr, inserted]);
+        this._markDirty(tableName);
+        return inserted;
+    }
+
+    update(tableName, query, updates) {
+        const table = this._ensureTable(tableName);
+        if (!table) throw createError('ER_NO_SUCH_TABLE', tableName);
+        if (!this._runHooks('beforeUpdate', [tableName, query, updates])) return 0;
+        const count = table.update(query, updates);
+        this._emit('update', { table: tableName, query, count });
+        this._runHooks('afterUpdate', [tableName, query, updates, count]);
+        this._markDirty(tableName);
+        return count;
+    }
+
+    delete(tableName, query = {}) {
+        const table = this._ensureTable(tableName);
+        if (!table) throw createError('ER_NO_SUCH_TABLE', tableName);
+        if (!this._runHooks('beforeDelete', [tableName, query])) return 0;
+        const count = table.remove(query);
+        this._emit('delete', { table: tableName, query, count });
+        this._runHooks('afterDelete', [tableName, query, count]);
+        this._markDirty(tableName);
+        return count;
+    }
+
+    truncate(tableName) {
+        const table = this._ensureTable(tableName);
+        if (!table) throw createError('ER_NO_SUCH_TABLE', tableName);
+        const count = table.truncate();
+        this._emit('delete', { table: tableName, count });
+        this._markDirty(tableName);
+        return count;
+    }
+
     async stop() {
         this._runHooks('onStop', []);
         this._emit('stop', {});

package/lib/table.js

@@ -133,10 +133,11 @@ class Table {
         this._dateFields = {};       // { fieldName: 'date'|'datetime'|'timestamp' }
 
         for (const [field, def] of Object.entries(schema)) {
-            if (def.primaryKey) this._primaryKey = field;
+            const isPk = !!(def.primaryKey || def.primary === true);
+            if (isPk) this._primaryKey = field;
             if (def.autoIncrement) {
                 this._autoIncrementField = field;
-                if (def.primaryKey) this._primaryKey = field;
+                if (isPk) this._primaryKey = field;
             }
             if (def.default !== undefined) {
                 this._defaults[field] = def.default;
@@ -177,7 +178,7 @@ class Table {
     _autoCreateBTrees() {
         for (const [field, def] of Object.entries(this._schema)) {
             if (field === '_softDelete') continue;
-            if (def.primaryKey || def.unique) {
+            if (def.primaryKey || def.primary === true || def.unique) {
                 this._btrees[field] = new BTree(64, true);
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jsql-neo",
-    "version": "4.1.2",
+    "version": "4.2.0",
     "description": "JSQL-NEO — Rust-powered embedded database with WASM, REST API, B-Tree indexes, WAL, crash recovery",
     "main": "index.js",
     "bin": {