17 Commits

Include renames

Author	SHA1	Message	Date
thzxx	2a109ef933	feat(B-1): 统一行校验 choke point —— 消除三份分叉的校验实现（A12/A17） ... 背景（PLAN-v0.7.5.md 根因 1）： 修复前有**三份**行校验实现，覆盖面各不相同： 位置 类型 required PK非空 maxLength min/max 未知列 engine/memory.ts（disk/hybrid 共用） ✓ ✓ ✓ ✗ ✗ 静默丢弃 engine/aria/index.ts → checkFieldType ✓ ✓ ✓ ✓ ✓ 静默丢弃 table/schema.ts ✓ ✓ ✓ ✓ ✓ 静默丢弃 后果一（A12）：同一份 schema、同一条 INSERT 是否报约束错误取决于引擎选择 —— `CREATE TABLE t (name STRING(3))` + 插入 'abcdef' 在 Aria 抛错，在 memory/disk/hybrid 静默写入超长值。 后果二（A17）：四个引擎对未知列一律静默丢弃。`INSERT INTO t (id, nope) VALUES ('1',2)` 报成功，随后 `SELECT nope` 报 COLUMN_NOT_FOUND —— 同一列名在写路径与 读路径得到**相反结论**。TABLE API 直通路径尤其明显（executor 按 schema 列序 构造行，nope 那个位置根本没有值，所以连"校验 stmt.columns"都拦不住）。 根治方式： 1. 新增 src/table/validation.ts —— 唯一校验定义 `compileValidator(schema)`， 约束覆盖面取三者并集，并把**规范化**（default 填充、undefined 跳过、 __proto__ 防污染）与校验放在同一处。 三种载荷形态刻意分成三个显式入口，不合成带 options 的函数： - validateRow(row, knownColumns?) INSERT 语义（default 生效、缺列合法） - validatePartial(row) UPDATE 语义（只校验出现的列） - assertNoUnknownColumns 独立可复用的列名存在性检查 混成一个函数会让"required 是否生效"取决于调用方参数，重新引入跨路径差异。 2. MemoryEngine / AriaEngine 的私有 validateRow 改为委托；schema.ts 的公开 validateRow 同样委托（API 不变，实现只剩一份）。 3. 四个引擎新增 validatePayload(table, rows, mode)（IStorageEngine 契约）， Executor 在**任何副作用之前**调用：多行批量整体判定，错误消息一次列出全部 未知列与已知列清单。 4. executeInsert 显式校验 stmt.columns 全部存在（A17）。 5. UPDATE 的外键级联写入（applyUpdateCascade）从"直接赋值"改为过 validatePartial —— 此前 CASCADE 把新主键写进引用列时绕过 maxLength/min/max， 与 A12 属同一类"校验只在部分写入路径生效"。 连带修正（测试夹具本身不忠实，B-1 使其暴露）： - tests/engine/aria-cache.test.ts 的 makeRows 无条件返回 {id,name,age}， 部分用例的表只有 {id,name} —— 多余列被静默丢弃所以"通过"。新增 rowsFor() 按 schema 裁剪，让夹具忠实反映表结构（而不是放宽校验）。 - tests/v073-fixes.test.ts "schema 外列不持久化" 改为断言写路径即拒绝， 并保留"合法行落盘后不含额外列"的检查。 验证： - 新增 tests/v080-unified-validation.test.ts：8 项 × 4 引擎 + 9 项校验器 单元契约，共 41 断言； - 全量 84 套件 / 1499 测试通过；typecheck(src+tests) 与 lint 零错误。	2026-09-14 23:38:58 +08:00
thzxx	674da6b7b7	fix(A9/A10): 发布订阅接线 + 列对列比较与关联子查询（静默空结果根治） ... A9 db.subscribe 对本地写入永不触发 全库唯一调用 emit 的地方在 BroadcastChannel 收到**其它标签页**消息的分支里， 于是 README:232「订阅表变更」与 site/docs.html:667-679 的示例 （event.type: 'insert'|'update'|'delete'、event.row）全部不成立。 根治方式：新增 src/engine/change-notifier.ts —— IStorageEngine 装饰器， 把变更通知收敛到**引擎接口**这一个位置（三个写入入口 SQL/Table/Builder 与 事务内写入都必须经过它），避免在三条路径上各写一份变更描述逻辑。 事件语义（兑现文档承诺）：INSERT 逐行带 row+key；UPDATE/DELETE 写入前快照 受影响行、成功后逐行发事件并带更新后/删除前的行；CLEAR/DDL 表级事件。 订阅者返回 Promise 时被 await；订阅者抛错不影响写入结果（只上报 onError）。 两个实现细节值得记录： 1. 引擎被装饰后，core 里 `this.engine instanceof HybridEngine` 恒为 false → Hybrid 跨标签页重载静默失效。新增 unwrapEngine() 对**内层**引擎做能力探测。 2. 外部事件（external）绝不能重新广播 —— 否则 A↔B 互相转发形成无限循环 （实测 8 次以上且不终止）。已分离 emitExternal 路径。 A10 列对列比较与关联 IN 子查询静默空结果 1) `WHERE t.x = t.y`（唯一可解析的列对列写法）返回 []： - 引擎层 matchWhere 无 $col 上下文，把 `{ $col: ... }` 当普通对象比较； - executor.filterCorrelated 调用 matchWhere 时**没传** `{ $col: true }`。 修复：engine 层遇到未解析操作数（$col/$subquery）时**放行**而非判假 —— 引擎的过滤只允许缩小候选集，最终判定始终由带上下文的 executor 完成； executor 侧补上 `{ $col: true }`。 同时修正 MemoryEngine/AriaEngine 的索引下推：非原始值（对象）不走索引， 否则 String({...}) 得到无意义键、查找为空并短路全表扫描 → 静默空结果。 2) `WHERE id IN (SELECT user_id FROM o WHERE o.user_id = u.id)` 返回 []： 子查询执行**不传外层行上下文**，`u.id` 绑定为 null → 子查询空集 → `$in: []`。 （结构相同的 EXISTS 走另一条分支、结果正确 —— 又一处"同一语义两条路径"。） 修复：resolveOperatorSubqueries 接收并传递 contextRow；bindColumnRefs 递归 进入 $subquery 绑定外层引用；新增 lookupOuterValue 先剥外层表名/别名前缀 再取值（外层行键不带前缀，否则 `u.id` 取 undefined 被 `?? null` 静默成 null）。 ChangeNotifierEngine 能力转发 装饰器只实现 IStorageEngine 声明的成员，导致： - 可选能力缺失时抛原生 Error，破坏 `NOT_SUPPORTED` 错误码契约（14 个用例失败） → 新增 requireCapability，统一抛 NOT_SUPPORTED 并保留方法名； - 接口外方法（analyzeTable/reindexTable/vacuum）在被包装后静默消失 → 新增 requireOptionalMethod 显式转发（ANALYZE/REINDEX/VACUUM 恢复可用）。 新增 tests/v080-subscribe.test.ts（5 用例，四引擎 × 三种入口）、 tests/v080-correlated.test.ts（4 用例，含"关联 IN 与等价 EXISTS 结果一致"护栏）。	2026-09-14 22:29:51 +08:00
thzxx	765df805eb	fix(A1/A2): UPDATE 批内主键碰撞丢行 + ALTER ADD UNIQUE 形同虚设（四引擎根治） ... A1 UPDATE 批内新主键碰撞 → 静默丢行 阶段 1 只用 `table.has(newPk)` 与**语句执行前**的表比对，看不到同一语句内其它行 即将写入的新主键；阶段 2 逐行写同一个 key 互相覆盖。 实测 `UPDATE t SET id='X'`（匹配 3 行）返回 affected=3，表中只剩 1 行。 INSERT 路径在 v0.7.3 已做批内 Set 互查，UPDATE 漏了 —— 典型的"同类修复只打一半"。 根治：MemoryEngine 与 AriaEngine 的阶段 1 增加批内新主键 Set 互查， 任一行撞车即整体拒绝（DUPLICATE_KEY），不写入任何一行。 保守语义说明：这也会拒绝"两行互换主键"（A:x→y, B:y→x，最终状态合法）—— 与既有的"唯一值交换更新保守拒绝"一致，宁可显式报错也不静默丢行。 A2 ALTER ADD COLUMN ... UNIQUE 形同虚设 只写 schema 不建索引桶（Memory）／索引 LSM（Aria），而唯一性预检完全依赖索引 （`tableIndexes.get(col)` 缺失即整段跳过）—— 重复值可任意写入，四个引擎全部接受。 Memory 侧后果更严重：重启时 createTable 依 schema 建桶、回灌第二行触发 UNIQUE_VIOLATION，而该异常被 KVStoreEngine.open 的 catch 吞掉 → **行静默消失**。 根治： - MemoryEngine.alterTable ADD：index/unique 列建立索引桶并回填；回填前做存量 唯一性校验，重复则回滚本次 ALTER（删列 + 删桶）并抛 UNIQUE_VIOLATION。 - AriaEngine.alterTable ADD：复用既有 createIndex（它已实现"回填 + 存量唯一性 校验 + 失败原子清理"，是 v0.6.2/v0.7.3 的成果）—— 不重复实现以免再次漂移。 - KVStore/Hybrid 通过 Memory 引擎自动获得同等语义。 新增 tests/v080-atomicity.test.ts（4 用例，四引擎参数化）。	2026-09-14 22:02:30 +08:00
thzxx	074afd3f1e	fix(A8 + LSM 读自洽): 行所有权根治 + 读取路径不再依赖 prefetch ... A8 行引用泄漏（调用方改查询结果即改写存储） 实测：rows[0].tag = 'HACKED' 后，tag='HACKED' 与 tag='x' 两条索引查询都返回 0 行 —— 行与索引失配、该行永久查不出来；嵌套 json 值同样按引用共享。 Aria 因走反序列化路径反而幸免，又形成跨引擎差异。 根治：在 IStorageEngine 契约层写入**行所有权约定**（engine/interface.ts） —— 读出的行是副本、写入接收的行也是副本；新增 cloneRow/cloneRows （优先 structuredClone，退化路径处理 Date/嵌套对象/二进制）。 Memory/KVStore/Hybrid：find、findStream、getRow 全部返回副本。 Aria：getAllRows 此前只做 `{ ...value }` 浅拷贝（嵌套 json 仍共享引用）， 改为深拷贝；find/findStream 返回副本。 实测四种引擎：修改返回值后重读不变、索引两条查询均正确。 LSM 读取自洽（审计 P1-1：缓存未命中 = 静默丢数据） 此前 loadSSTableReader 缓存未命中返回 null，而所有调用方都是 const reader = this.loadSSTableReader(meta); if (!reader) continue; 于是**未命中就静默跳过整个 SSTable**。实测：缓存上限 4KB 而 SSTable 更大时， 300 行只能查回 59 行，且不报错。 同时"读路径必须先 prefetch"这个隐式约定，是每次读都要 drainChain + prefetch 的原因（性能悬崖的另一半）。 根治：LSM.get / rangeScan / rangeScanLazy 改为 async，未命中即 `await sstableStore.load()` 回源 + CRC 校验（损坏则自愈清理 meta）， 只有数据确实不存在才返回 null。checkUniqueSync 相应改名 checkUnique 并 async （原命名正是因为依赖 prefetch 约定）。引擎侧 12 处调用点补 await。 附带修正的缓存语义： - tryCacheSSTable：单个 SSTable 超过缓存上限时标记为常驻（pinned）， 不参与驱逐 —— 驱逐它等价于静默丢数据；内存上限因此是 cacheLimit + 单个最大 SSTable，已在代码与测试中明确。 - trimCache 跳过 pinned 条目（此前会把全部缓存一次性清空）。 - 新增 getCacheSize/getCacheLimit/getOversizedCount/setCacheLimit 访问器 （测试此前直接读私有字段 cacheSize/cacheLimitBytes —— 那是 TS 错误， 只因测试不做类型检查才没暴露）。 queryStream async 回调 此前用 constructor.name === 'AsyncFunction' 判定，对"普通函数返回 Promise" 完全失效（Promise 被静默丢弃）。现改为双条件识别并走物化路径逐行 await， async 回调被真正等待。 测试契约修正： - aria-cache：'缓存大小受上限约束' 在极小缓存下是不可成立的契约，改为断言 真正重要的不变量（数据完整；可装入时受上限约束），并新增"超大 SSTable 常驻" 用例；'缓存驱逐后全表扫描仍返回完整数据' 保留 300 行断言（此前会失败）。 - hybrid：磁盘引擎标签断言从 indexeddb（v0.6.0 已移除）改为 opfs。	2026-09-14 21:43:21 +08:00
thzxx	d4a3f4acd2	fix: v0.7.4 写语句子查询 / 约束硬化 / 真惰性流式 — UPDATE-DELETE WHERE 子查询静默 0 行（四引擎，关联引用显式 NOT_SUPPORTED + EXPLAIN 同步）/ 主键 NULL-undefined 强制拒绝 / DROP INDEX 保留建表 UNIQUE（仅索引来源可解除）/ GROUP BY-DISTINCT-UNION 键类型安全编码 / UPDATE 未知列报错 / queryStream 多语句拒绝 / KVStore 后台错误跨 reopen 清理 + Hybrid begin 补偿 / RB-Tree 删除双黑修复 + LSM 死代码清理 / findStream 迭代器化真惰性（limit 早停 O(1) 内存）/ REINDEX 单次扫描 + 48 回归	2026-08-15 15:08:33 +08:00
thzxx	50468b9b0e	fix: v0.7.3 数据正确性与边界窗口收尾 — INSERT 语句级原子（三引擎+Aria PK 批内重复）/ 索引列 IS NULL 恒空 / delete RESTRICT 破坏索引 / queryStream 子查询静默空结果 / ALTER DROP 索引残留 / UNIQUE INDEX 存量校验 / SELECT * 别名投影 / WAL BEGIN/ROLLBACK 事务边界 / aria $in 与级联重复扫描性能 / $and 等值下推 / ANALYZE 索引统计 / React-Vue hooks 生命周期 / 迁移主键兜底 + 58 回归	2026-08-14 22:53:46 +08:00
thzxx	05e6823bf1	fix: v0.7.2 语句级原子性 + 事务 DDL 拒绝 + 约束/绑定硬化 — 6 项修复 + 43 回归 + CI 重型套件串行 ... - UPDATE 语句级部分提交（P1，四引擎）：两阶段全量预检后执行，批内唯一互查， 任何一行失败整句不执行（aria 场景 WAL 与内存不再错位） - 事务内 ALTER/CREATE INDEX/DROP INDEX 残留（P1）：Memory/KVStore 显式拒绝 （对齐 Aria），createTable/dropTable 保持可回滚 - SET NULL 级联绕过 required 约束（P1）：预检阶段整体拒绝 FOREIGN_KEY_VIOLATION - bindParameters 注释误判（P2）：行注释/块注释中的 ? 与引号不再参与绑定 - 未闭合字符串静默接受 → lexer 抛 PARSE_ERROR；未知 where 操作符抛 QUERY_ERROR - UPDATE undefined 覆盖列值 → 语义化为不更新（null 仍置空） - Hybrid 写穿透非原子（P1）：磁盘失败自动重载内存对齐磁盘再抛原错误 - CI：Run tests 拆常规并行 + 重型串行（runInBand），重型测试超时余量提升， 性能护栏 kv 120→240s / opfs 150→300s（仍拦截悬崖回归） - 测试 1155 → 1198（74 套件），覆盖率 89.82% 保持	2026-08-13 15:31:16 +08:00
thzxx	f97c5a6001	fix(P2): v0.6.3 原子性/一致性/资源治理 — 8 项修复 + 12 回归 ... - KVStore 混合写单记录原子：新增 writeBatch（put+delete 同一条日志记录）， KVStoreEngine 全部混合写路径统一（兑现真原子宣称，崩溃无新旧行并存） - WAL full 模式写入失败抛错（此前 console.warn 吞错 → 崩溃即丢且无感知） - MemoryEngine SET NULL 级联索引残留：复用 removeIndexEntries（消除虚假 UNIQUE_VIOLATION） - delete 级联两阶段：先全量 RESTRICT 预检（沿 CASCADE 链递归）再执行，无部分级联 （Memory/Aria 对齐） - BufferPool 驱逐同步清理 pages Map（EvictionManager onRemove 回调，内存预算真实生效） - MVCC commit 清理已提交版本（版本链仅作事务内 undo，消除行数据双份常驻） - LSM.flush 重复入链修复（入链即置空 immutable）+ frozenMemtables 可见性时序 - rollbackToSavepoint 重建受影响表二级索引（消除过期索引条目） 测试 1114 → 1126（71 套件）；行覆盖率 89.7%；版本 0.6.3	2026-08-13 10:30:39 +08:00
thzxx	ef1934a38c	fix(P0): v0.6.2 数据正确性专项 — 深度审计 6 项修复 + 22 回归 ... - KVStoreEngine 数值主键 update 丢行（P0）：String 化主键回查不命中 → 误删 KV 行 （重启丢数据）；改为单次全表扫描 + 受影响集合过滤（兼消 O(N×M) 回查开销） - update 主键撞已有主键静默覆盖（P0，Memory/Aria）：抛 DUPLICATE_KEY，事务路径同拦截 - Aria 二级索引范围查询边界算法错误（P1）：Number(v)±1 构造 key 漏小数/字符串数据； 改全索引扫描 + matchWhere 过滤，边界语义统一 - Aria 索引列 IS NULL 返回空（P1）：null 等值/含 null 的 IN 不走索引（回退全表） - AriaEngine unique 约束未强制（P1）：insert 整批预检（批内互查+索引扫描，失败整批 不落库）+ update 排除自身旧条目检查；新增 LSM.prefetchPrefixRanges 批量预加载 - 非主键 update 索引旧值残留：统一传旧行清理（消除唯一性误报与索引膨胀） - EXPLAIN 写语句产生真实副作用（P2）：仅 SELECT 执行，UPDATE/DELETE 用 count 估算 测试 1092 → 1114（70 套件）；行覆盖率 89.6%；版本 0.6.2	2026-08-13 09:51:26 +08:00
thzxx	8a78f27f7d	fix: v0.6.1 生产可用性深度审查 — MemoryEngine 级联环无限递归（P0）/ KVStore 多表事务与级联原子化 / 未open防护统一 / 27 个异常场景测试 + aria级联回归	2026-08-10 14:29:40 +08:00
thzxx	22b0b1fad4	release: v0.4.2 — 生产就绪与崩溃自愈 + 问题清单修复 + 版本迭代	2026-08-09 19:15:37 +08:00
thzxx	a1e4f5071c	release: v0.4.1 — Aria 级联/ALTER/clearAll + 流式查询/派生表 + 正确性加固 ... 新增： - AriaEngine 外键级联（CASCADE/SET NULL/RESTRICT）+ clearAll() 重置 API - 引擎级 alterTable：Aria DROP COLUMN 重写存储行 + schema 持久化 - 流式查询 queryStream / findStream（LSM 惰性扫描不物化） - FROM 派生表 / 多列 ON 哈希连接 / COUNT(DISTINCT) / NULLS FIRST/LAST - 普通列别名 + ORDER BY 别名 + 无表查询 + 字符串常量列 - 演示页引擎切换器（Memory/Aria）+ 预设自动重置 修复： - Aria WAL DROP_TABLE 崩溃恢复（删表复活）+ 恢复后 WAL 截断 - Memory update/delete 索引维护（unique 约束绕过） - 关联 EXISTS 绑定失效 / HAVING 标量子查询 / INSERT SELECT 位置错位 - 裸布尔列条件（WHERE done / CASE WHEN done） - Aria $in 重复行 / JOIN 主表 WHERE 下推 / DROP INDEX 报错 - ORDER BY/GROUP BY/SELECT 表前缀列 + SQL '' 标准转义 质量：894 测试 · 47 套件 · 81.5% 覆盖率	2026-08-08 13:36:34 +08:00
thzxx	d544501e1c	release: v0.3.2 — 质量加固 + SQL扩展 + 表达式 + 并发同步 ... v0.2.6 质量加固: - 修复 AriaEngine 二级索引 SSTable 互相覆盖(命名空间隔离) - 修复 LSM 多版本读取顺序错误 + MergeIterator 取最新来源 - 重写 LZ4 压缩器(往返一致性 + 缓冲区溢出) - sstableCache LRU 上限 + 预加载兜底(BufferPool 配置生效) - 修复 React/Vue 集成 import type 运行时 bug + exports 子路径 - 新增 38 个测试(LZ4往返/Crypto/集成), 删除伪测试 v0.3.0 SQL 功能扩展: - 多语句 parseAll + 事务语句 BEGIN/COMMIT/ROLLBACK - INSERT INTO ... SELECT + UNION/UNION ALL + EXISTS 关联子查询 - CREATE/DROP INDEX 五引擎实现 + 别名 WHERE 修复 - benchmark 页面 + 36 个新测试 v0.3.1 表达式与性能: - CASE WHEN 表达式(SELECT 列/WHERE/聚合) - JOIN + 关联子查询逐行绑定 - WAL 批量组提交(写放大 O(N)→O(1)) - 修复 pending frozen 可见性 + flush 缓存竞争 v0.3.2 并发: - CASE WHEN 用于 WHERE/聚合 + JOIN 哈希连接 - 多标签页同步(multiTabSync + BroadcastChannel) - IndexedDB schema 持久化(reopen 后表结构恢复) - 修复 where-matcher 顶层 $not - 修复 CJS 产物 .js 被 ESM 解析(exports 空) — .cjs 后缀 + exports 修正 - 836 测试 / 44 套件 / 81.0% 覆盖率	2026-08-08 10:41:30 +08:00
thzxx	e6efa39d48	release: v0.2.1 生产加固 — WAL CRC/约束激活/Hybrid提交顺序/RESTRICT外键/浏览器兼容表/debug模式/onError回调	2026-07-27 20:47:30 +08:00
thzxx	014e92884c	release: v0.1.14 生产加固 — IDB事务原子性/多标签页感知/幂等init	2026-07-26 17:20:31 +08:00
thzxx	0f128da34a	feat: v0.1.13 — 事务回滚 + 子查询 + 外键级联 + 连接池	2026-07-26 16:31:15 +08:00
thzxx	e2a590c5b1	feat: metona-sqlark v0.1.12 — 前端TypeScript关系型数据库 ... - 4种存储引擎：Memory / IndexedDB / OPFS / Hybrid - 完整SQL支持：SELECT/INSERT/UPDATE/DELETE/JOIN/GROUP BY/HAVING/DISTINCT - Query Builder链式API + TypeScript泛型支持 - 聚合函数：COUNT/SUM/AVG/MIN/MAX - 事务、插件系统(14 hooks)、发布订阅、数据迁移、导入导出 - React/Vue框架集成 - 264个测试用例，93.46%覆盖率 - 零运行时依赖	2026-07-26 15:00:01 +08:00