release: v0.2.5 — 质量加固 + Bug修复 + 性能优化 + SQL扩展

README.md

@@ -1,10 +1,10 @@
 # MetonaSqlark
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.2.4-blue?style=flat-square" alt="version">
+  <img src="https://img.shields.io/badge/version-0.2.5-blue?style=flat-square" alt="version">
   <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="license">
   <img src="https://img.shields.io/badge/coverage-91.0%25-brightgreen?style=flat-square" alt="coverage">
-  <img src="https://img.shields.io/badge/tests-701%20passed-success?style=flat-square" alt="tests">
+  <img src="https://img.shields.io/badge/tests-721%20passed-success?style=flat-square" alt="tests">
 </p>
 
 > 基于 TypeScript 的**前端关系型数据库**，支持完整 SQL 查询、Query Builder 链式 API、与 **AriaEngine 自研页面式存储引擎**。
@@ -13,17 +13,18 @@
 
 ## ✨ 特性
 
-- 🚀 **AriaEngine 自研存储引擎** — LSM-Tree 页面式存储，4KB Slotted Page、WAL 崩溃恢复、LZ4 压缩
+- 🚀 **AriaEngine 自研存储引擎** — LSM-Tree 页面式存储，4KB Slotted Page、WAL 崩溃恢复（full 模式真正同步）、LZ4 压缩
 - 💾 **OPFS 自研存储后端** — 纯浏览器文件系统，零 IndexedDB 依赖，二进制页面文件
-- 🔒 **生产级数据安全** — WAL CRC 完整性校验、`RESTRICT` 外键约束、Hybrid 提交原子性
+- 🔒 **生产级数据安全** — WAL CRC 完整性校验、`RESTRICT` 外键约束、Hybrid 提交原子性、SQL 注入防护
 - 🛡 **输入校验全覆盖** — `maxLength`/`min`/`max` 约束、类型检查、必填验证
 - 💾 **多引擎架构** — Memory / IndexedDB / OPFS / Hybrid(write-through) / Aria 五种模式
-- 📝 **完整 SQL 支持** — SELECT/JOIN/子查询/GROUP BY/HAVING/ORDER BY/LIMIT/BETWEEN/IF NOT EXISTS
+- 📝 **完整 SQL 支持** — SELECT/JOIN/子查询/GROUP BY/HAVING/ORDER BY/LIMIT/BETWEEN/IF NOT EXISTS/ALTER TABLE/TRUNCATE TABLE
 - 🔗 **Query Builder API** — 链式 `.select().where().orderBy().limit().execute()`
-- 🔄 **事务回滚** — Memory/IndexedDB/Hybrid/Aria 四引擎事务原子性，自动回滚
+- 🔄 **事务回滚** — Memory/IndexedDB/Hybrid/Aria 四引擎事务原子性，自动回滚，MVCC 版本链接入读写路径
 - 🌲 **RB-Tree 完整实现** — 标准红黑树插入+删除修复，O(log n) 保证
+- ⚡ **性能优化** — SSTableReader 二分查找统一、IndexedDB 索引利用、crypto 实例化避免全局状态
 - 🌐 **浏览器兼容** — Chrome 80+ / Firefox 80+ / Safari 14+ / Edge 80+ / Node.js 16+
-- 🧪 **701 测试 · 91.0% 覆盖率** — 32 套件，生产级质量保证
+- 🧪 **721 测试 · 91.0% 覆盖率** — 37 套件，生产级质量保证
 
 ---
 
@@ -136,6 +137,13 @@ await db.query(`SELECT * FROM users WHERE id IN (SELECT user_id FROM orders WHER
 // GROUP BY
 await db.query(`SELECT dept, COUNT(*) FROM employees GROUP BY dept HAVING COUNT(*) > 1`);
 
+// ALTER TABLE — 动态修改表结构 v0.2.5
+await db.query('ALTER TABLE users ADD COLUMN phone STRING');
+await db.query('ALTER TABLE users DROP COLUMN phone');
+
+// TRUNCATE TABLE — 快速清空表 v0.2.5
+await db.query('TRUNCATE TABLE old_logs');
+
 // 事务 — 自动回滚 v0.1.13
 await db.transaction(async (trx) => {
   await trx.table('users').insert({ id: '3', name: 'Charlie' });
@@ -161,7 +169,7 @@ await db2.disconnect(); // 引用计数 -1
 | `mode` | `'memory' \| 'disk' \| 'hybrid' \| 'aria'` | `'hybrid'` | 存储模式 🆕 aria |
 | `diskEngine` | `'indexeddb' \| 'opfs'` | `'indexeddb'` | 磁盘引擎（aria 模式下为存储后端） |
 | `version` | `number` | `1` | 版本号 |
-| `maxRowsPerQuery` | `number` | `0` | 查询结果行数上限（0=不限制）🆕 |
+| `maxRowsPerQuery` | `number` | `0` | 查询结果行数上限（0=不限制）✅ v0.2.5 生效 |
 | `debug` | `boolean` | `false` | 调试模式，输出详细日志 🆕 |
 | `onError` | `(error) => void` | — | 全局错误回调 🆕 |
 
@@ -270,7 +278,7 @@ const { data, loading, refresh } = useSqlarkQuery(db, 'SELECT * FROM users');
 
 ---
 
-## 🌲 AriaEngine — 自研存储引擎 (v0.2.4)
+## 🌲 AriaEngine — 自研存储引擎 (v0.2.5)
 
 AriaEngine 是内置的页面式存储引擎，对标 SQLite 的设计理念：
 
@@ -295,7 +303,7 @@ const rows = await db.query('SELECT * FROM users');
 
 ```
 ┌──────────────────────────────────────────┐
-│              AriaEngine v0.2.4           │
+│              AriaEngine v0.2.5           │
 │         (implements IStorageEngine)      │
 ├──────────────────────────────────────────┤
 │  LSM-Tree  │  Buffer Pool  │    WAL     │
@@ -316,13 +324,13 @@ const rows = await db.query('SELECT * FROM users');
 | 特性 | 说明 |
 |------|------|
 | **LSM-Tree** | MemTable (红黑树) → SSTable 多级索引，异步 Compaction，写背压 |
-| **WAL** | Write-Ahead Log 二进制格式，CRC 校验，full/batch/none 三种模式，16MB 阈值 |
-| **MVCC** | 版本链 + 快照隔离，事务读写不互斥，自动 GC（每10次检查点） |
+| **WAL** | Write-Ahead Log 二进制格式，CRC 校验，full/batch/none 三种模式（full 模式真正同步 ✅ v0.2.5），16MB 阈值自动 checkpoint |
+| **MVCC** | 版本链 + 快照隔离，事务读写不互斥，自动 GC（每10次检查点），读写路径接入版本链 ✅ v0.2.5 |
 | **Buffer Pool** | FileManager + LRU 页面缓存，256 页 ≈ 1MB 可控内存 |
 | **Bloom Filter** | FNV-1a + Murmur 双哈希，SSTable footer 序列化，查询时 probe |
-| **二级索引** | 每列独立 LSM Tree，支持 $eq/$in/$gt/$lt 范围扫描 |
-| **AES-GCM** | PBKDF2 密钥派生 + AES-256-GCM 页面级加密 |
-| **Compaction** | 异步 Leveled Compaction，Level 0 > 8 触发同步背压 |
+| **二级索引** | 每列独立 LSM Tree，支持 $eq/$in/$gt/$lt 范围扫描，SSTableReader 二分查找统一 ✅ v0.2.5 |
+| **AES-GCM** | PBKDF2 密钥派生 + AES-256-GCM 页面级加密，CryptoManager 实例化 ✅ v0.2.5 |
+| **Compaction** | 异步 Leveled Compaction，Level 0 > 8 触发同步背压，compactLevel public 接口 ✅ v0.2.5 |
 | **OPFS Backend** | 纯浏览器文件系统，Promise 队列串行写，零外部依赖 |
 
 ---
@@ -344,11 +352,11 @@ npm run typecheck # 类型检查
 
 | 指标 | 数值 |
 |------|------|
-| 测试用例 | 701 |
-| 测试套件 | 32 |
+| 测试用例 | 721 |
+| 测试套件 | 37 |
 | 行覆盖率 | 91.0% |
-| SQL 关键字 | 33 |
-| 存储引擎 | 5（Memory / IndexedDB / OPFS / Hybrid / **Aria** 🆕） |
+| SQL 关键字 | 36 |
+| 存储引擎 | 5（Memory / IndexedDB / OPFS / Hybrid / **Aria**） |
 
 ### 🌐 浏览器兼容性
 
@@ -373,7 +381,7 @@ src/
 ├── constants.ts          # 类型定义 + 配置 + DatabaseError
 ├── connection-manager.ts # 连接池管理
 ├── utils.ts              # 工具函数
-├── engine/               # 存储引擎（Memory/IndexedDB/OPFS/Aria 🆕）
+├── engine/               # 存储引擎（Memory/IndexedDB/OPFS/Aria）
 ├── hybrid/               # 混合引擎（write-through）
 ├── table/                # 表管理 + Schema 校验
 ├── query/                # AST + Builder + Compiler + Executor