thzxx
0dba1abf2a
工作流 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
46 lines
1.9 KiB
TypeScript
46 lines
1.9 KiB
TypeScript
/**
|
||
* 版本一致性契约测试（v0.8.0）
|
||
*
|
||
* 背景：此前版本号被硬编码在多个测试文件里（tests/v025-fixes.test.ts:31、
|
||
* tests/v033-fixes.test.ts:406），每次发版必须手改测试；而且只校验 src 常量，
|
||
* 与 package.json / dist 产物之间没有任何一致性检查 —— 三者可以静默漂移。
|
||
*
|
||
* 本测试把"版本号"变成一个单点校验的契约：
|
||
* 1. src/constants.ts 的 VERSION 是合法 semver；
|
||
* 2. package.json 的 version 与 VERSION 完全一致；
|
||
* 3. （可选）dist 产物存在时，其内嵌 VERSION 必须与上述一致。
|
||
*
|
||
* 第 3 条让"dist 与 src 漂移"（CI 无同步校验）变成红灯。
|
||
*/
|
||
import { readFileSync, existsSync } from 'fs';
|
||
import { join } from 'path';
|
||
import { VERSION } from '../src/constants';
|
||
|
||
const ROOT = join(__dirname, '..');
|
||
|
||
describe('[v0.8.0] 版本一致性契约', () => {
|
||
test('src/constants.ts VERSION 是合法语义化版本', () => {
|
||
expect(VERSION).toMatch(/^\d+\.\d+\.\d+$/);
|
||
});
|
||
|
||
test('package.json version 与 VERSION 常量一致', () => {
|
||
const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8')) as { version: string };
|
||
expect(pkg.version).toBe(VERSION);
|
||
});
|
||
|
||
test('dist 产物内嵌 VERSION 与源码一致（dist 存在时）', () => {
|
||
const distFile = join(ROOT, 'dist', 'metona-sqlark.esm.js');
|
||
if (!existsSync(distFile)) {
|
||
// dist 未构建时不失败（CI 会先 build），但要显式跳过而不是静默通过
|
||
expect(existsSync(distFile)).toBe(false);
|
||
return;
|
||
}
|
||
const content = readFileSync(distFile, 'utf8');
|
||
// 构建产物把源码常量内联为 `const VERSION = 'x.y.z';`
|
||
// （见 rollup 输出，不要去扫描文件里全部字符串字面量 —— 那会命中无关数字）
|
||
const match = content.match(/\bVERSION\s*=\s*['"](\d+\.\d+\.\d+)['"]/);
|
||
expect(match).not.toBeNull();
|
||
expect(match![1]).toBe(VERSION);
|
||
});
|
||
});
|