MetonaTeam/MetonaSqlark
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

test(P0): v0.8.0 验证基座与工程门禁根治

Browse Source 
工作流 C-1 / C-3 前半 + 测试代码类型检查。

【故障注入基座】新增 tests/helpers/storage-harness.ts + faulty-backend.ts
- TransactionalFileStore：忠实 OPFS 提交语义（close 才可见）+ 字节级故障注入
  （failNextWrite/Append/Delete、truncateAppendTo 撕裂写、crashPending 真崩溃）
- 删除旧 opfs-mock：读返回内部引用、keepExistingData:false 不截断、close 空实现
  导致"提交前可见"等真实缺陷无法被测出（31 个测试文件迁移至新 harness）
- 删除 aria-opfs-backend 内的第三份重复 mock（含从未被断言使用的 writeCalls 死代码
  与 entry.content.subarray 恒等分支）
- FaultyBackend：包装任意 IStorageBackend 注入故障；crash() 明确区别于 close()
  （后者是优雅停机，会刷完写队列 —— 这正是此前所有"崩溃恢复"测试的真相）
- 16 条基座自测证明注入真的生效（含 close 不能当崩溃的对照组）

【覆盖率口径】jest.config.cjs
- 移除 '!src/**/index.ts'（该 glob 把 AriaEngine 主实现等 15 个实现文件整体
  排除出统计，与 v0.2.6 曾承认过的问题同源），改为只排除纯类型声明文件并附理由
- 新增 coverageThreshold 门禁（此前完全不存在）
- 真实基线：语句 90.66% / 分支 82.94% / 函数 94.36% / 行 93.43%
- 修正 testMatch 使 tests/helpers 下的测试可被发现

【测试代码类型检查】tsconfig.test.json + npm run typecheck:tests
- 修复 103 个测试代码类型错误（此前 babel 剥离类型 + tsconfig 排除 tests，全部隐藏）
- 新增 tests/helpers/assertions.ts：nonNull/decode/rows/object/engineMethod/expectCode
  以断言收窄替代 as any
- 消除 21 个 lint warning（含 v043-hardening 中定义后从未调用的 mockOPFS 死代码）
- parser.test.ts 12 处 toBeDefined() 空断言升级为结构断言（并新增 AND/OR 优先级用例，
  当前红灯，对应总账第 11 项，将在工作流 A 修复）

【版本契约】新增 tests/version-contract.test.ts
- 校验 src VERSION / package.json / dist 三者一致，替代两处硬编码版本字面量

【CI 门禁】.gitea/workflows/ci.yml
- lint 去掉 continue-on-error（此前永远不让 CI 变红）
- 新增 tests 类型检查、--coverage 覆盖率门禁、dist 与源码同步校验
- 版本 0.7.4 升至 0.8.0
This commit is contained in:
thzxx
2026-09-14 21:03:06 +08:00
parent c8b59bd16f
commit 0dba1abf2a
65 changed files with 1533 additions and 454 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tests/v073-fixes.test.ts
+22 -21
View File
@@ -15,6 +15,7 @@
import { MetonaSqlark } from '../src/core';
import { MemoryEngine } from '../src/engine/memory';
import { rows as rowsOf } from './helpers/assertions';
describe('v0.7.3: 索引列 IS NULL（三引擎对齐）', () => {
test.each([
@@ -28,9 +29,9 @@ describe('v0.7.3: 索引列 IS NULL（三引擎对齐）', () => {
email: { type: 'string', index: true },
});
await db.query("INSERT INTO users VALUES ('1', NULL), ('2', 'a@b.c')");
const rows = await db.query('SELECT * FROM users WHERE email IS NULL');
const rows = rowsOf<{ id: string }>(await db.query('SELECT * FROM users WHERE email IS NULL'));
expect(rows).toHaveLength(1);
expect((rows[0] as Record<string, unknown>).id).toBe('1');
expect(rows[0].id).toBe('1');
await db.close();
});
@@ -176,9 +177,9 @@ describe('v0.7.3: insert 语句级原子性', () => {
let threw = false;
try { await db.query("INSERT INTO users VALUES ('b'), ('a')"); } catch { threw = true; }
expect(threw).toBe(true);
const rows = await db.query('SELECT * FROM users');
const rows = rowsOf<{ id: string }>(await db.query('SELECT * FROM users'));
expect(rows).toHaveLength(1);
expect((rows[0] as Record<string, unknown>).id).toBe('a');
expect(rows[0].id).toBe('a');
await db.close();
});
@@ -357,9 +358,9 @@ describe('v0.7.3: SELECT * 混别名列投影', () => {
const db = await MetonaSqlark.create({ name: 'v073-star-alias', mode: 'memory' });
await db.defineTable('users', { id: { type: 'string', primaryKey: true }, name: { type: 'string' }, age: { type: 'number' } });
await db.query("INSERT INTO users VALUES ('1', 'Alice', 30)");
const rows = await db.query('SELECT *, name AS nick FROM users');
const rows = rowsOf<Record<string, unknown>>(await db.query('SELECT *, name AS nick FROM users'));
expect(rows).toHaveLength(1);
const row = rows[0] as Record<string, unknown>;
const row = rows[0];
expect(row.id).toBe('1');
expect(row.name).toBe('Alice');
expect(row.age).toBe(30);
@@ -371,8 +372,8 @@ describe('v0.7.3: SELECT * 混别名列投影', () => {
const db = await MetonaSqlark.create({ name: 'v073-star-only', mode: 'memory' });
await db.defineTable('users', { id: { type: 'string', primaryKey: true }, name: { type: 'string' } });
await db.query("INSERT INTO users VALUES ('1', 'Alice')");
const rows = await db.query('SELECT * FROM users');
expect(Object.keys(rows[0] as Record<string, unknown>).sort()).toEqual(['id', 'name']);
const rows = rowsOf<Record<string, unknown>>(await db.query('SELECT * FROM users'));
expect(Object.keys(rows[0]).sort()).toEqual(['id', 'name']);
await db.close();
});
@@ -380,8 +381,8 @@ describe('v0.7.3: SELECT * 混别名列投影', () => {
const db = await MetonaSqlark.create({ name: 'v073-star-const', mode: 'memory' });
await db.defineTable('users', { id: { type: 'string', primaryKey: true } });
await db.query("INSERT INTO users VALUES ('1')");
const rows = await db.query("SELECT *, 'lit' AS c FROM users");
const row = rows[0] as Record<string, unknown>;
const rows = rowsOf<Record<string, unknown>>(await db.query("SELECT *, 'lit' AS c FROM users"));
const row = rows[0];
expect(row.id).toBe('1');
expect(row.c).toBe('lit');
await db.close();
@@ -422,7 +423,7 @@ describe('v0.7.3: KVStore insert 持久化 validated 行', () => {
await db.query("INSERT INTO users VALUES ('1')");
await db.close();
const db2 = await MetonaSqlark.create({ name: 'v073-kv-validated', mode: 'disk', diskEngine: 'memory' });
const rows = await db2.query('SELECT * FROM users');
const rows = rowsOf<Record<string, unknown>>(await db2.query('SELECT * FROM users'));
expect(rows).toHaveLength(1);
expect(rows[0]).toEqual({ id: '1', age: 18 });
await db2.close();
@@ -434,8 +435,8 @@ describe('v0.7.3: KVStore insert 持久化 validated 行', () => {
await db.table('users').insert({ id: '1', junk: 'x' } as never);
await db.close();
const db2 = await MetonaSqlark.create({ name: 'v073-kv-extra-col', mode: 'disk', diskEngine: 'memory' });
const rows = await db2.query('SELECT * FROM users');
expect(Object.keys(rows[0] as Record<string, unknown>).sort()).toEqual(['id']);
const rows = rowsOf<Record<string, unknown>>(await db2.query('SELECT * FROM users'));
expect(Object.keys(rows[0]).sort()).toEqual(['id']);
await db2.close();
});
@@ -537,9 +538,9 @@ describe('v0.7.3: $and 等值条件下推', () => {
age: { type: 'number' },
});
await db.query("INSERT INTO users VALUES ('1', 'a', 10), ('2', 'a', 20), ('3', 'b', 10)");
const rows = await db.query("SELECT * FROM users WHERE tag = 'a' AND age = 10");
const rows = rowsOf<{ id: string }>(await db.query("SELECT * FROM users WHERE tag = 'a' AND age = 10"));
expect(rows).toHaveLength(1);
expect((rows[0] as Record<string, unknown>).id).toBe('1');
expect(rows[0].id).toBe('1');
await db.close();
});
@@ -569,15 +570,15 @@ describe('v0.7.3: SELECT 常量列 SQL 标准转义', () => {
const db = await MetonaSqlark.create({ name: 'v073-escape', mode: 'memory' });
await db.defineTable('users', { id: { type: 'string', primaryKey: true } });
await db.query("INSERT INTO users VALUES ('1')");
const rows = await db.query("SELECT 'O''Brien' AS name FROM users");
expect((rows[0] as Record<string, unknown>).name).toBe("O'Brien");
const rows = rowsOf<{ name: string }>(await db.query("SELECT 'O''Brien' AS name FROM users"));
expect(rows[0].name).toBe("O'Brien");
await db.close();
});
test("无表查询 SELECT 'a''b' AS x 转义还原", async () => {
const db = await MetonaSqlark.create({ name: 'v073-escape-notable', mode: 'memory' });
const rows = await db.query("SELECT 'a''b' AS x");
expect((rows[0] as Record<string, unknown>).x).toBe("a'b");
const rows = rowsOf<{ x: string }>(await db.query("SELECT 'a''b' AS x"));
expect(rows[0].x).toBe("a'b");
await db.close();
});
@@ -585,8 +586,8 @@ describe('v0.7.3: SELECT 常量列 SQL 标准转义', () => {
const db = await MetonaSqlark.create({ name: 'v073-escape-star', mode: 'memory' });
await db.defineTable('users', { id: { type: 'string', primaryKey: true } });
await db.query("INSERT INTO users VALUES ('1')");
const rows = await db.query("SELECT *, 'x''y' AS c FROM users");
const row = rows[0] as Record<string, unknown>;
const rows = rowsOf<Record<string, unknown>>(await db.query("SELECT *, 'x''y' AS c FROM users"));
const row = rows[0];
expect(row.id).toBe('1');
expect(row.c).toBe("x'y");
await db.close();