0.8.0: express 收紧到 ^5;契约副本改为 build 时自动同步

破坏性:peerDependencies.express 从 "^4 || ^5" 收成 "^5"。
buildShrimpRouter 的 router.post("/*path") 是 Express 5 才有的写法,
声明支持 4 一直是假的。devDeps 同步升到 express 5.1 / @types/express 5,32 个测试通过。

契约同步:新增 postbuild,把 src/IShrimpType.ts 覆盖到同级 shrimp-admin 的副本
(scripts/check-admin-contract.mjs;找不到同级仓库就跳过,不影响 CI 与消费侧 prepare)。
起因是那份副本靠人工复制,漂了一整代没人发现——停在旧的 json 类型,
缺 object/array/fields/item/parse/refs,而前端对未注册类型静默回落成 string,
漂移不报错、只悄悄渲染错。

删掉 @contractVersion 版本轴:代码无人读取,且从 1.0.0 起从未移动,
期间契约实际改了好几处,数字全程说谎。副本新不新改由字节比对回答,
消费侧看钉的 tag 即可,版本收敛成 package version 一根轴。
This commit is contained in:
2026-08-10 19:42:52 +08:00
parent 19afdf3615
commit 064bc108d7
4 changed files with 471 additions and 583 deletions
+9 -5
View File
@@ -1,12 +1,16 @@
/**
* Shrimp 类型契约 — 前后端 wire protocol 定义
*
* @contractVersion 1.0.0
* 这份是契约本身。shrimp-admin/src/IShrimpType.ts 是它的副本,
* 由本仓库 postbuild 自动覆盖过去(scripts/check-admin-contract.mjs),不用手工同步。
*
* 改动此文件需要:
* 1. 升 @contractVersion(语义化版本)
* 2. 同步到 shrimp-admin/src/IShrimpType.ts,更新其 @syncedFrom
* 3. 通知消费侧对齐
* 改动此文件 = 改 wire protocol,所以:
* 1. 发版升 package version(0.x 里破坏性改动升 minor),消费侧按 tag 钉包
* 2. 通知消费侧对齐
*
* 这里原本另有一个 @contractVersion 轴,删了:它从 1.0.0 起没动过,
* 期间契约丢了 json、多了 object/array/fields/item/parse/refs,数字全程说谎。
* 副本新不新改由字节比对回答(shrimp-admin 的 npm run check:contract)。
*/
/** 业务错误码 */