9 Commits

Include renames

Author	SHA1	Message	Date
thzxx	567d150257	feat(A37): 未限定列可作比较操作数 + WHERE/JOIN ON 列引用存在性校验 ... 两个此前互相纠缠的缺陷（PLAN §5 #35/#37、§3 根因 7 的最后一块）。 ① 未限定列不能作比较操作数（语法层） parser 只把 `a.b` 形态当列引用，裸标识符一律走字面量解析，于是： WHERE x = y → PARSE_ERROR: Expected value, got "y" ON k = k → 同上 列对列比较被迫写成 `WHERE t.x = t.y` —— 而多表 JOIN 里未限定列恰恰是最 自然的写法（`ON user_id = id`）。 修法：操作数位置上的 IDENTIFIER **必然是列引用**（字面量各有自己的 token 类型：NUMBER/STRING/TRUE/FALSE/NULL），这一条不需要猜测。 * 排查记录：这里试错了两次。起初用 peekToken 判"下一个是否运算符"， 实测仍报错 —— 因为进入该分支时运算符**已被 parseComparisonOp 消费**， `peek` 是 EOF/AND 而非运算符。最终按"位置"判定，不再依赖 lookahead。 ② `$col` 引用到不存在的列 → 静默空集（语义层） 投影侧早有列存在性校验，WHERE 侧一直没有：`$col` 取不到值 → UNRESOLVED → 比较判 UNKNOWN → **所有行被过滤且不报错**。实测修复前： SELECT id FROM t WHERE id = oops → [] SELECT id FROM t WHERE id = t.oops → [] SELECT id FROM t WHERE x = nope → [] SELECT ... FROM l JOIN r ON l.k = r.nope → []（连接不上任何行） 用户看到的是"没有数据"，与"列名拼错"完全无法区分。 修法：新增 `validateWhereColumns`（WHERE 的键位 + `$col` 值位，含 `$and`/`$or`/`$not` 内部）与 `validateJoinOnColumns`（ON 两侧归属判定）， 两者共用同一遍历实现。 契约变更： - 拼错的列名 → `COLUMN_NOT_FOUND`（此前 PARSE_ERROR 或静默空集）； - JOIN 的 WHERE 里裸写两表同名列 → 歧义报错（SQL 标准要求限定）； - `ON k = k` 这类裸写法仍按"取主表列"解释（不因两表同名而拒绝， 否则会把常见等值连接写法判为错误）。 附带修正：`schema.ts ↔ validation.ts` 的**循环依赖**（rollup 构建告警 "Circular dependency"）。`checkFieldType` 的实现搬到 validation.ts（唯一校验 定义），schema.ts 重新导出以保持公开 API —— 依赖方向改为单向 （validation ← schema）。循环依赖在 ESM 下求值顺序不稳定，是难查的运行时陷阱。 验证：新增 tests/v080-column-resolution.test.ts（4 引擎 × 8 项，共 32 断言， 期望值全部逐个实测得出）；tests/v080-correlated.test.ts 的"裸 x = y 为 PARSE_ERROR"用例改为断言两种写法等价。 全量 86 套件 / 1697 测试通过；e2e 14 项通过（真实 Chromium + OPFS）； typecheck(src+tests)、lint、build 零错误/零告警；dist 已重建。	2026-09-15 01:21:58 +08:00
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	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	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	cbe407eb49	fix: v0.7.1 API 修复与防御统一 — static create / 未 open 防护 / 原型污染 / lint 清零 ... - MetonaSqlark.create 静态工厂（README 示例在 ESM/Node 下此前 TypeError）， 独立 create 函数委托静态实现 - close 未初始化防御（engine undefined 不再崩溃） - AriaEngine hasTable/getTableNames/getTableSchema 统一 ensureOpen - 事务回滚失败不掩盖原始错误 - __proto__ 列名防护：Executor 列映射 Object.create(null) + schema 校验拒绝 - lint 清零（移除 5 处未使用导入） 测试 1147 → 1155（73 套件）；行覆盖率 89.8%；版本 0.7.1	2026-08-13 11:14:42 +08:00
thzxx	57415975ea	feat: v0.7.0 参数化查询 + 事务增量 flush + 复合主键语义硬化 + EXPLAIN 真实索引信息 ... - 参数化查询 db.query(sql, params)：词法层 ? 绑定 + SQL 字面量安全编码 （'' 转义/注入防护）；参数计数不匹配 PARAM_ERROR；对象参数显式拒绝 - KVStoreEngine 事务增量 flush：行级变更追踪，commit 仅写改动行 （1000 行表改 1 行：日志 1 条目 vs 整表 1000 条目）；级联影响表漏写修复 （txFullTables 同步加入 txDirtyTables）；移除每次 commit 全量 checkpoint （阈值自动 checkpoint + close 统一截断） - 复合主键显式拒绝：createSchema 校验期 SCHEMA_ERROR + ALTER ADD 主键列防护 （此前静默取第一个主键，其余标记失效） - EXPLAIN usingIndex 真实命中信息：pk / index:col / none 测试 1126 → 1147（72 套件）；行覆盖率 89.8%；版本 0.7.0	2026-08-13 10:57:26 +08:00
thzxx	e6efa39d48	release: v0.2.1 生产加固 — WAL CRC/约束激活/Hybrid提交顺序/RESTRICT外键/浏览器兼容表/debug模式/onError回调	2026-07-27 20:47:30 +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