jsql-neo 6.0.0-beta2 → 6.0.2

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. The browser. **And it fits in one npm package.**
 
-> **v5.6.0** — official release build · [github.com/vexify-org/JSQL-neo](https://github.com/vexify-org/JSQL-neo)
+> **v6.0.1** — official release build · [github.com/vexify-org/JSQL-neo](https://github.com/vexify-org/JSQL-neo)
 
 ![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)
@@ -124,6 +124,7 @@ For the complete Chinese edition of every topic below, jump to the [中文版](#
 - [Migration Tools](#migration-tools)
 - [Storage & Performance](#storage--performance)
 - [Security](#security)
+- [Plugin System](#plugin-system)
 - [Errors](#errors)
 - [TypeScript](#typescript)
 - [Architecture](#architecture)
@@ -232,7 +233,7 @@ npm install && npm run build                 # option 3: from source
 Verify:
 
 ```bash
-node -e "console.log(require('jsql-neo/package.json').version)"   # 5.6.0
+node -e "console.log(require('jsql-neo/package.json').version)"   # 6.0.1
 ```
 
 ### 30-second demo
@@ -410,7 +411,7 @@ Auth failure returns the standard `Access denied for user 'x'@'...' (using passw
 
 The server answers the system probes ORMs and GUI tools run at connect time:
 
-- `SELECT VERSION()` → `8.0.0-jsql-neo`
+- `SELECT VERSION()` → `8.0.1-jsql-neo`
 - System variables: `@@version`, `@@version_comment`, …
 - `SHOW DATABASES / SHOW TABLES / SHOW COLUMNS / SHOW CREATE TABLE`
 - `information_schema.tables / columns / statistics`
@@ -1064,7 +1065,7 @@ SELECT AGE('2026-08-12', '2020-01-01');             -- '6 years 7 mons 11 days'
 **Conditional / null** — `IF(cond, a, b)`, `IIF`, `IFNULL(a, b)`, `COALESCE(...)`, `NULLIF`,
 `ISNULL`, `CASE WHEN ... THEN ... ELSE ... END` (search/simple form, works with aggregates).
 
-**System & misc** — `VERSION()` → `8.0.0-jsql-neo`, `DATABASE()`, `USER()`/`CURRENT_USER`,
+**System & misc** — `VERSION()` → `8.0.1-jsql-neo`, `DATABASE()`, `USER()`/`CURRENT_USER`,
 `LAST_INSERT_ID()`, `ROW_COUNT()`, `CAST`/`CONVERT`, `JSON_EXTRACT(doc, '$.path')`,
 `JSON_OBJECT`/`JSON_ARRAY`, `JSON_UNQUOTE`, `JSON_CONTAINS`, `JSON_SET/INSERT/REPLACE/REMOVE`,
 `UUID()`, `TYPEOF(x)`, `PRINT(x)`.
@@ -1091,15 +1092,21 @@ ORDER BY avg_sal DESC;
 
 ### Operators
 
-**Arithmetic** — `+ - * / % MOD DIV ^` (power, PG style).
+**Arithmetic** — `+ - * / %`，以及 `MOD` / `DIV` / `POWER()`。
 
 **Comparison** — `= <> != < <= > >=`, `IS NULL`, `IS TRUE/FALSE` (three-valued),
 `BETWEEN a AND b`, `IN (...)`, `LIKE`/`NOT LIKE`, `ILIKE` (case-insensitive),
-`RLIKE`/`REGEXP`, `~ ~* !~ !~*` (PG regex), `EXISTS`, `ANY`/`ALL`/`SOME`, `<=>` (NULL-safe).
+`RLIKE`/`REGEXP`, `EXISTS`, `= ANY` / `> ALL` / `SOME`.
 
-**Logic** — `AND OR NOT XOR` (short-circuit), MySQL aliases `&&` `||`.
+**Logic** — `AND OR NOT` (short-circuit).
 
-**Bitwise** — `& | ^ ~ << >>`.
+**Bitwise** — `& | ^ ~ << >>`（`^` 是按位异或，`~` 是按位取反）。
+
+> **运算符方言说明。** `^` 与 `~` 在 MySQL（位运算）和 PostgreSQL（`^` 为幂、
+> `~` 为正则匹配）中含义冲突，本实现统一采用 **MySQL 语义**：`^` = 按位异或、
+> `~` = 按位取反。需要幂运算请用 `POWER(x, n)`，需要正则请用 `REGEXP` / `~*`。
+> 因此 PG 风格的 `^`（幂）、`~ ~* !~ !~*`（正则）与 JSON 操作符
+> （`-> ->> #> #>> @> <@`）**暂不支持**。
 
 **JSON (PG style)** — `->` (JSON result), `->>` (text), `#>`, `#>>` (paths), `@>` `<@`
 (containment), `?` `?|` `?&` (key existence).
@@ -1457,7 +1464,7 @@ jsql mod --engine wasm        # switch engine (restart required)
 
 ```bash
 $ jsql version
-jsql-neo v5.6.0
+jsql-neo v6.0.1
 engine: native (napi) | wasm | js
 node: v22.0.0  platform: linux x64
 ```
@@ -1478,7 +1485,7 @@ jsql tui --memory -q                      # memory mode, quiet
 jsql tui --prompt 'db> ' --no-color
 ```
 
-The status bar shows: `db=<name> dialect=<d> mode=<tui|batch> ver=5.6.0`.
+The status bar shows: `db=<name> dialect=<d> mode=<tui|batch> ver=6.0.1`.
 
 ### Keyboard shortcuts
 
@@ -1753,6 +1760,105 @@ normalization on data dirs and import/export paths; Web UI db-name whitelist (no
 }
 ```
 
+## Plugin System
+
+JSQL-NEO ships with a unified plugin system that works across all three engine implementations:
+**Native** (`NativeJSQL`), **WASM** (`JSQL`), and **Pure JS** (`Database`). Full documentation
+is in [PLUGINS.md](./PLUGINS.md).
+
+### Quick start
+
+```js
+const { Database, Plugin } = require('jsql-neo');
+const db = new Database();
+
+db.use({
+  name: 'my-plugin',
+  install(db, ctx) {
+    db.myFlag = true;
+  },
+  hooks: {
+    beforeInsert(table, data) { /* modify data */ return data; },
+    afterInsert(table, data, ids) {},
+    beforeUpdate(table, id, data) { return true; },   // false = abort
+    afterUpdate(table, id, data, result) {},
+    beforeDelete(table, id) { return true; },
+    afterDelete(table, id, result) {},
+    beforeFind(table, query) { return true; },
+    afterFind(table, query, result) {},
+  },
+});
+```
+
+### Hooks reference (18 unified hooks)
+
+| Hook | Parameters | Return | Description |
+|---|---|---|---|
+| `beforeInsert` | `(table, data[])` | modified data / `false` to abort | pre-insert |
+| `afterInsert` | `(table, data[], ids)` | — | post-insert |
+| `beforeUpdate` | `(table, id, data)` | `true`/`false` | pre-update |
+| `afterUpdate` | `(table, id, data, result)` | — | post-update |
+| `beforeDelete` | `(table, id)` | `true`/`false` | pre-delete |
+| `afterDelete` | `(table, id, result)` | — | post-delete |
+| `beforeFind` | `(table, query)` | `true`/`false` | pre-query |
+| `afterFind` | `(table, query, result)` | — | post-query |
+| `beforeCreateTable` | `(name, schema)` | `true`/`false` | pre-DDL |
+| `afterCreateTable` | `(name, schema)` | — | post-DDL |
+| `beforeDropTable` | `(name)` | `true`/`false` | pre-drop |
+| `afterDropTable` | `(name)` | — | post-drop |
+| `beforeFlush` | `()` | `true`/`false` | pre-flush |
+| `afterFlush` | `()` | — | post-flush |
+| `beforeCount` | `(table)` | `true`/`false` | pre-count |
+| `afterCount` | `(table, count)` | — | post-count |
+| `onStart` | `()` | — | engine start |
+| `onStop` | `()` | — | engine stop |
+
+### Events
+
+| Event | Payload |
+|---|---|
+| `insert` | `{ table, count, ids }` |
+| `update` | `{ table, id, data }` |
+| `delete` | `{ table, ids }` |
+| `createTable` | `{ name, schema }` |
+| `dropTable` | `{ name }` |
+| `start` / `stop` | `{}` |
+
+### Plugin helper class
+
+```js
+const timestampPlugin = new Plugin('timestamp')
+  .on('beforeInsert', (table, data) => {
+    data.forEach(r => r.created_at = new Date().toISOString());
+    return data;
+  })
+  .onEvent((ev, payload) => console.log(ev))
+  .install((db, ctx) => {})
+  .build();
+
+db.use(timestampPlugin);
+```
+
+### Module system (CLI)
+
+```bash
+jsql mod add --address /path/mod.js     # register module
+jsql mod enable <name>                   # enable (auto-enables dependencies)
+jsql mod disable <name>                  # disable (cascades)
+jsql mod list | ls [--json]             # list
+```
+
+Modules persist to `~/.config/jsql/mod.config`. Circular dependencies are rejected;
+disabling cascades to dependents.
+
+> **插件没有沙箱，请只装可信来源的模块。** 两条装载路径都不做隔离：
+> - `db.use(plugin)` —— 直接把插件对象挂进核心，与核心同权；
+> - `jsql mod add <dir>` —— 模块文件走普通 `require()`，同样与核心同权，
+>   可访问 `fs` / `child_process` 等一切 Node API。
+>
+> 早期文档曾写"模块文件在 VM 沙箱中执行"，实际代码中不存在 vm 隔离，此处已更正。
+> 需要隔离时请在进程级解决（容器 / 子进程 / 单独的用户与权限）。
+
 ---
 
 ## TypeScript
@@ -2378,7 +2484,7 @@ createMysqlServer({
 
 支持常见系统查询，让 ORM 与 GUI 工具的初始化探测流程正常工作：
 
-- `SELECT VERSION()` → `8.0.0-jsql-neo`
+- `SELECT VERSION()` → `8.0.1-jsql-neo`
 - `SELECT @@version` / `@@version_comment` 等系统变量
 - `SHOW DATABASES` / `SHOW TABLES` / `SHOW COLUMNS FROM t` / `SHOW CREATE TABLE t`
 - `information_schema.tables` / `information_schema.columns` / `information_schema.statistics`
@@ -2410,7 +2516,7 @@ SELECT TABLE_NAME, TABLE_ROWS FROM information_schema.tables WHERE TABLE_SCHEMA
 
 | 函数 | 行为 |
 |---|---|
-| `VERSION()` | `8.0.0-jsql-neo` |
+| `VERSION()` | `8.0.1-jsql-neo` |
 | `NOW()` / `CURRENT_TIMESTAMP` | `YYYY-MM-DD HH:MM:SS`（UTC） |
 | `CONCAT(a, b, ...)` | 字符串拼接 |
 | `GROUP_CONCAT(x)` | 聚合拼接（逗号分隔） |
@@ -3104,26 +3210,28 @@ SELECT * FROM orders LIMIT 40 OFFSET 20;    -- 标准偏移语法
 | `BEGIN` / `START TRANSACTION` | 开启事务 |
 | `COMMIT` | 提交 |
 | `ROLLBACK` | 回滚 |
-| `SAVEPOINT sp` / `ROLLBACK TO SAVEPOINT sp` / `RELEASE SAVEPOINT sp` | 保存点 |
+| `SAVEPOINT sp` / `RELEASE SAVEPOINT sp` | 保存点（**仅登记**，无快照能力） |
+| `ROLLBACK TO SAVEPOINT sp` | **不支持**——会抛错，不会静默"假成功" |
 | 自动事务 | 无显式事务时单语句原子 |
 
 事务保证：
 
 - 读已提交（read committed）隔离级别的等价语义
 - 事务内修改对事务外不可见（提交前），提交后原子可见
-- 回滚撤销本事务全部修改（含保存点回滚）
+- 回滚撤销本事务全部修改
 - 支持跨表事务（引擎级提交日志）
 
 ```sql
 BEGIN;
 UPDATE accounts SET balance = balance - 100 WHERE id = 1;
 UPDATE accounts SET balance = balance + 100 WHERE id = 2;
-SAVEPOINT sp1;
-UPDATE accounts SET balance = balance - 100 WHERE id = 3;
-ROLLBACK TO SAVEPOINT sp1;      -- 撤销 id=3 的修改
 COMMIT;
 ```
 
+> **`ROLLBACK TO SAVEPOINT` 目前不可用。** 引擎没有保存点/快照能力，无法只回退到某个
+> 保存点。这里刻意选择"抛错"而不是"静默成功"——假装回滚成功会让调用方误以为数据已还原。
+> 需要部分回滚时请用 `ROLLBACK` 放弃整个事务。
+
 #### 其他语句
 
 | 语句 | 说明 |
@@ -3245,7 +3353,7 @@ INTERVAL 单位：`DAY` `HOUR` `MINUTE` `SECOND` `WEEK` `MONTH` `YEAR` 及其组
 
 | 函数 | 说明 | 示例 |
 |---|---|---|
-| `VERSION()` | 服务器版本 | `8.0.0-jsql-neo` |
+| `VERSION()` | 服务器版本 | `8.0.1-jsql-neo` |
 | `DATABASE()` | 当前库名 | `DATABASE()` |
 | `USER()` / `CURRENT_USER` | 当前用户 | `USER()` → `root` |
 | `LAST_INSERT_ID()` | 最近自增 ID | 配合 AUTO_INCREMENT 使用 |
@@ -4042,7 +4150,7 @@ Data dir: /root/.jsql-neo/data
 
 ```bash
 $ jsql version
-jsql-neo v5.6.0
+jsql-neo v6.0.1
 engine: native (napi) | wasm | js
 node: v22.0.0
 platform: linux x64
@@ -4711,7 +4819,7 @@ jsql-neo/
 ├── index.js                     # ★ 公共 API 出口
 ├── index.d.ts                   # TypeScript 声明
 ├── test/                        # 测试套件
-├── docs/                        # 文档（本文件即索引）
+├── PLUGINS.md                   # 插件与模块文档（与 README 同级，无 docs/ 目录）
 ├── src/rust/                    # Rust 引擎源码（native + wasm）
 ├── data/                        # 默认数据目录（运行时创建）
 └── package.json
@@ -4902,7 +5010,7 @@ npm run typecheck
 - `src/rust/`：Rust 引擎（native + wasm 同源）
 - `lib/`：Node 侧全部逻辑（协议/解析/TUI/兼容层）
 - `test/`：单元 + 集成测试
-- `docs/`：扩展文档
+- 扩展文档位于仓库根目录：`PLUGINS.md`（插件与模块）。本仓库**没有** `docs/` 目录。
 
 ---
 
@@ -5119,7 +5227,7 @@ Apache License
 
 *JSQL-NEO — One engine to rule them all. MySQL. PostgreSQL. MongoDB. Redis. SQL. TypeScript. The browser.*
 
-*文档版本：v5.6.0 · 最后更新：2026-08-12*
+*文档版本：v6.0.1 · 最后更新：2026-09-27*
 
 ---
 
@@ -6594,7 +6702,7 @@ FROM orders;
 #### 会话信息
 
 ```sql
-SELECT VERSION();                  -- '8.0.0-jsql-neo'
+SELECT VERSION();                  -- '8.0.1-jsql-neo'
 SELECT DATABASE();                 -- 'app'
 SELECT USER();                     -- 'root@localhost'
 SELECT CURRENT_USER;               -- 'root@localhost'
@@ -6889,7 +6997,7 @@ Usage: jsql version
 
 输出版本与环境信息：
 
-  jsql-neo v5.6.0
+  jsql-neo v6.0.1
   engine: native (napi) | wasm | js
   node: v22.0.0
   platform: linux x64
@@ -7545,7 +7653,7 @@ CI（GitHub Actions）矩阵：`node 20/22` × `linux/macos/windows` × `native/
 
 *JSQL-NEO — One engine to rule them all. MySQL. PostgreSQL. MongoDB. Redis. SQL. TypeScript. The browser.*
 
-*文档版本：v5.4.0 · 共 19 个附录 · 最后更新：2026-08-12*
+*文档版本：v6.0.1 · 共 19 个附录 · 最后更新：2026-09-27*
 
 ---
 
@@ -8152,4 +8260,4 @@ npm test
 
 *JSQL-NEO — One engine to rule them all. MySQL. PostgreSQL. MongoDB. Redis. SQL. TypeScript. The browser.*
 
-*文档版本：v5.4.0 · 附录 A–Z · 全文 6000+ 行 · 最后更新：2026-08-12*
+*文档版本：v6.0.1 · 附录 A–Z · 全文 6000+ 行 · 最后更新：2026-09-27*

package/index.d.ts

@@ -85,7 +85,7 @@ declare namespace JSQLNeo {
 
   export class JSQL {
     constructor(opts?: JSQLOptions);
-    use(plugin: JSQLPlugin | ((db: JSQL) => void)): this;
+    use(plugin: JSQLPlugin | string | ((db: JSQL) => void), opts?: Record<string, unknown>): this;
     on(event: JSQLHook, fn: (...args: any[]) => unknown): this;
     onEvent(fn: (event: string, data: unknown) => void): this;
     start(): Promise<void>;
@@ -113,6 +113,15 @@ declare namespace JSQLNeo {
      * @returns 单条语句返回单个结果对象（含 columns/rows），多条返回数组。
      */
     query(sql: string, paramsOrOpts?: unknown[] | Record<string, unknown>, opts?: Record<string, unknown>): Promise<any>;
+    exists(table: string, filter?: Record<string, unknown>): Promise<boolean>;
+    prepare(sql: string): PreparedStatement;
+  }
+
+  export interface PreparedStatement {
+    sql: string;
+    all(...params: unknown[]): Promise<any>;
+    get(...params: unknown[]): Promise<Record<string, unknown> | null>;
+    run(...params: unknown[]): Promise<any>;
   }
 
   export class NativeJSQL extends JSQL {}
@@ -309,6 +318,9 @@ declare namespace JSQLNeo {
     createTable(name: string, schema: Schema): Promise<unknown>;
     insert(table: string, data: Record<string, unknown>): Promise<unknown>;
     find(table: string, filter?: Record<string, unknown>): Promise<Row[]>;
+    exists(table: string, filter?: Record<string, unknown>): boolean;
+    prepare(sql: string): PreparedStatement;
+    query(sql: string, paramsOrOpts?: unknown[] | SQLOptions, opts?: SQLOptions): Promise<SQLResult>;
     update(table: string, filter: Record<string, unknown>, data: Record<string, unknown>): Promise<number>;
     remove(table: string, filter: Record<string, unknown>): Promise<number>;
     findOne(table: string, filter?: Record<string, unknown>): Promise<Row | null>;
@@ -316,12 +328,14 @@ declare namespace JSQLNeo {
     getTables(): Promise<string[]>;
     dropTable(name: string): Promise<void>;
     getTableSchema(name: string): Promise<Schema | null>;
+    use(plugin: JSQLPlugin | string | ((db: Database) => void), opts?: Record<string, unknown>): this;
   }
 
   export class Table {
     constructor(name: string, schema: Schema, db?: unknown);
     insert(data: Record<string, unknown>): Promise<unknown>;
     find(filter?: Record<string, unknown>): Promise<Row[]>;
+    exists(filter?: Record<string, unknown>): boolean;
     updateById(id: number | string, data: Record<string, unknown>): Promise<unknown>;
     removeById(id: number | string): Promise<unknown>;
     count(): Promise<number>;
@@ -329,15 +343,27 @@ declare namespace JSQLNeo {
 
   export class Query {
     constructor(table: unknown);
+    where(conditions: Record<string, unknown>): this;
+    orderBy(field: string, dir?: 'asc' | 'desc'): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    get(): Row[];
+    first(): Row | null;
+    exists(): boolean;
+    count(): number;
     exec(): Promise<Row[]>;
     then(resolve: (rows: Row[]) => unknown, reject?: (err: Error) => unknown): Promise<unknown>;
   }
 
   export class BTree {
-    constructor(order?: number);
+    constructor(order?: number, unique?: boolean);
     insert(key: unknown, value: unknown): void;
-    find(key: unknown): unknown;
-    range(min: unknown, max: unknown): unknown[];
+    search(key: unknown): number[];
+    searchMany(keys: unknown[]): number[];
+    prefix(prefix: string): number[];
+    range(min: unknown, max: unknown): number[];
+    greaterThan(min: unknown): number[];
+    lessThan(max: unknown): number[];
   }
 
   export class Cache {

package/index.js

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

package/lib/btree.js

@@ -50,20 +50,27 @@ class BTree {
         this._size++;
     }
 
+    _lowerBound(keys, key) {
+        let lo = 0, hi = keys.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (keys[mid] < key) lo = mid + 1;
+            else hi = mid;
+        }
+        return lo;
+    }
+
     _insertNonFull(node, key, rowIndex) {
         if (node.leaf) {
-            // 查找插入位置
-            let i = node.keys.length - 1;
-            while (i >= 0 && key < node.keys[i]) i--;
-            i++;
+            const i = this._lowerBound(node.keys, key);
 
-            if (i > 0 && node.keys[i - 1] === key) {
+            if (i < node.keys.length && node.keys[i] === key) {
                 if (this._unique) {
                     this._size--;
                     return;
                 }
-                if (!node.values[i - 1].includes(rowIndex)) {
-                    node.values[i - 1].push(rowIndex);
+                if (!node.values[i].includes(rowIndex)) {
+                    node.values[i].push(rowIndex);
                 }
                 this._size--;
                 return;
@@ -119,8 +126,7 @@ class BTree {
      * （分隔键副本可能在左子树作为最大值，或在右子树作为最小值）。
      */
     _route(node, key) {
-        let i = 0;
-        while (i < node.keys.length && key > node.keys[i]) i++;
+        let i = this._lowerBound(node.keys, key);
         if (i < node.keys.length && node.keys[i] === key) {
             return this._getMax(node.children[i]).key === key ? i : i + 1;
         }
@@ -134,8 +140,43 @@ class BTree {
     search(key) {
         let node = this._root;
         while (!node.leaf) node = node.children[this._route(node, key)];
-        const i = node.keys.indexOf(key);
-        return i === -1 ? [] : node.values[i];
+        const i = this._lowerBound(node.keys, key);
+        return (i < node.keys.length && node.keys[i] === key) ? node.values[i] : [];
+    }
+
+    searchMany(keys) {
+        if (!keys || keys.length === 0) return [];
+        const out = [];
+        const seen = new Set();
+        for (let i = 0; i < keys.length; i++) {
+            const hits = this.search(keys[i]);
+            for (let j = 0; j < hits.length; j++) {
+                const idx = hits[j];
+                if (!seen.has(idx)) {
+                    seen.add(idx);
+                    out.push(idx);
+                }
+            }
+        }
+        return out;
+    }
+
+    prefix(prefix) {
+        if (prefix === undefined || prefix === null) return [];
+        const p = String(prefix);
+        const result = [];
+        let node = this._findLeaf(p);
+        while (node) {
+            for (let i = 0; i < node.keys.length; i++) {
+                const k = node.keys[i];
+                const s = k === undefined || k === null ? '' : String(k);
+                if (s < p) continue;
+                if (!s.startsWith(p)) return result;
+                result.push(...node.values[i]);
+            }
+            node = node.next;
+        }
+        return result;
     }
 
     /**
@@ -173,6 +214,18 @@ class BTree {
         return result;
     }
 
+    greaterThanEqual(min) {
+        const result = [];
+        let node = this._findLeaf(min);
+        while (node) {
+            for (let i = 0; i < node.keys.length; i++) {
+                if (node.keys[i] >= min) result.push(...node.values[i]);
+            }
+            node = node.next;
+        }
+        return result;
+    }
+
     /**
      * 小于查询（严格开区间，不含 max 本身）
      */
@@ -190,12 +243,24 @@ class BTree {
         return result;
     }
 
+    lessThanEqual(max) {
+        const result = [];
+        let node = this._root;
+        while (!node.leaf) node = node.children[0];
+        while (node) {
+            for (let i = 0; i < node.keys.length; i++) {
+                if (node.keys[i] <= max) result.push(...node.values[i]);
+                else return result;
+            }
+            node = node.next;
+        }
+        return result;
+    }
+
     _findLeaf(key) {
         let node = this._root;
         while (!node.leaf) {
-            let i = 0;
-            while (i < node.keys.length && key > node.keys[i]) i++;
-            node = node.children[i];
+            node = node.children[this._lowerBound(node.keys, key)];
         }
         return node;
     }
@@ -216,8 +281,8 @@ class BTree {
 
     _removeFromNode(node, key, rowIndex) {
         if (node.leaf) {
-            const i = node.keys.indexOf(key);
-            if (i === -1) return false;
+            const i = this._lowerBound(node.keys, key);
+            if (i >= node.keys.length || node.keys[i] !== key) return false;
             if (!node.values[i].includes(rowIndex)) return false;
             const vals = node.values[i].filter(v => v !== rowIndex);
             if (vals.length === 0) {

package/lib/database.js

@@ -435,6 +435,17 @@ class Database {
         if (!name || name.length > 64 || name === '.' || name === '..' || /[\x00-\x1f/\\]|\.\./.test(name)) {
             throw createError('ER_BAD_TABLE_NAME', name);
         }
+        if (typeof schema === 'string') {
+            const parsed = {};
+            for (const seg of schema.split(',')) {
+                const trimmed = seg.trim();
+                if (!trimmed) continue;
+                const parts = trimmed.split(/\s+/);
+                const field = parts.shift();
+                parsed[field] = parts.join(' ').toLowerCase().trim() || 'string';
+            }
+            schema = parsed;
+        }
         if (!this._runHooks('beforeCreateTable', [name, schema])) throw createError('ER_PLUGIN_ABORT', 'createTable aborted by plugin');
         if (this._tables[name] || (this._dirMode && this._meta.tables[name])) {
             throw createError('ER_TABLE_EXISTS_ERROR', name);
@@ -1076,10 +1087,11 @@ class Database {
 
     /**
      * 注册插件
-     * @param {object|function} plugin - { name, version, install(db, ctx), hooks, api, onEvent } 或函数 (作为 install)
+     * @param {object|function|string} plugin - { name, version, install(db, ctx), hooks, api, onEvent }、函数或内置插件名
+     * @param {object} [opts] - 传给内置插件工厂的配置，例如 db.use('timestamps', { createdField: 'created_at' })
      */
-    use(plugin) {
-        return applyPlugin(this, plugin);
+    use(plugin, opts) {
+        return applyPlugin(this, plugin, opts);
     }
 
     _buildCtx(plugin) {
@@ -1212,7 +1224,7 @@ class Database {
         if (!table) throw createError('ER_NO_SUCH_TABLE', tableName);
         if (!this._runHooks('beforeFind', [tableName, { filter, opts }])) return [];
         const { limit, offset = 0 } = opts;
-        let rows = table._applyFilter(table._rows, filter || {});
+        let rows = table._applyFilterOptimized(table._rows, filter || {});
         if (limit > 0) rows = rows.slice(offset, offset + limit);
         else if (offset > 0) rows = rows.slice(offset);
         this._touchTable(tableName);
@@ -1220,6 +1232,25 @@ class Database {
         return rows;
     }
 
+    exists(tableName, filter = {}) {
+        const table = this._ensureTable(tableName);
+        if (!table) throw createError('ER_NO_SUCH_TABLE', tableName);
+        this._touchTable(tableName);
+        return table.exists(filter);
+    }
+
+    async query(sql, paramsOrOpts, opts) {
+        const { executeSQL } = require('./sql');
+        if (!this._runHooks('beforeQuery', [sql, paramsOrOpts, opts])) return null;
+        const result = await executeSQL(this, sql, paramsOrOpts, opts);
+        this._runHooks('afterQuery', [sql, paramsOrOpts, opts, result]);
+        return result;
+    }
+
+    prepare(sql) {
+        return require('./prepared').createPrepared(this, sql);
+    }
+
     findById(tableName, id) {
         const table = this._ensureTable(tableName);
         if (!table) throw createError('ER_NO_SUCH_TABLE', tableName);

package/lib/mongo_server.js

@@ -322,7 +322,7 @@ class MongoServer {
           localTime: new Date(), logicalSessionTimeoutMinutes: 30, connectionId: 1,
         };
       case 'ping': return { ok: 1 };
-      case 'buildInfo': return { ok: 1, version: '5.6.0-jsql-neo', gitVersion: 'jsql-neo', versionArray: [5, 6, 0, 0] };
+      case 'buildInfo': return { ok: 1, version: '6.0.0-jsql-neo', gitVersion: 'jsql-neo', versionArray: [6, 0, 0, 0] };
       case 'getParameter': return { ok: 1 };
       case 'endSessions': return { ok: 1 };
       case 'listDatabases':

package/lib/native_client.js

@@ -499,11 +499,15 @@ class JSQL {
     this._buffer[table].push(arr[0]);
     this._bufferSize++;
     const flushed = await this._flush();
-    return flushed && flushed[table] ? flushed[table] : null;
+    const result = flushed && flushed[table] ? flushed[table] : null;
+    this._emit('insert', { table, count: arr.length, ids: result });
+    this._runHooks('afterInsert', [table, filtered, result]);
+    return result;
   }
 
   async createTable(name, schema) {
     await this._flush();
+    if (typeof schema === 'string') schema = parseSchemaString(schema);
     if (!this._runHooks('beforeCreateTable', [name, schema])) return null;
     const r = safeParse(native.jsqlCreateTable(name, JSON.stringify(mapNativeSchema(schema))));
     if (r && r.ok === false) throw new Error(r.error || 'create table failed');
@@ -656,6 +660,15 @@ class JSQL {
     return result;
   }
 
+  async exists(table, filter = {}) {
+    const rows = await this.find(table, filter, { limit: 1 });
+    return Array.isArray(rows) && rows.length > 0;
+  }
+
+  prepare(sql) {
+    return require('./prepared').createPrepared(this, sql);
+  }
+
   async stop() {
     this._flushOpsNow();
     await this._flush();