spec 把 5 值 HTTP 方法子集改名(HttpMethodSchema → HttpMethodSubsetSchema、HttpMethodType → HttpMethodSubset),packages/types 两处 import 需跟名

[qq9340100]

在 objectstack#5832(PR objectstack-ai/objectstack#5976)实施过程中实证发现的下游跟名项。现在还不红 —— 本仓消费的是已发布的 @objectstack/spec,等它升到含该改名的版本时才会断。

上游改了什么

packages/spec/src/shared/http.zod.ts 在同一个文件里声明了两个内容不同的 enum,而它们经 schemaNameFromExportKey 剥掉 Schema 后缀后同名(HttpMethod 7 值 / HttpMethodSchema 5 值,都发布成 shared/HttpMethod),后写覆盖前写,导致发布出去的 JSON Schema 与参考页只描述了 5 值那份。修法是把 5 值那份改名:

	改前	改后
schema const	HttpMethodSchema	HttpMethodSubsetSchema
类型别名	HttpMethodType	HttpMethodSubset

7 值的 HttpMethod(裸名)与其值域一字未动;5 值那份的运行时值域也一字未动,只是换了名字。

本仓要改的两处

• packages/types/src/zod/objectql.zod.ts:26 — import { HttpMethodSchema as SpecHttpMethodSchema } from '@objectstack/spec/...',以及 :41 的 export const HttpMethodSchema = SpecHttpMethodSchema;
• packages/types/src/objectql.ts:44 — export type { HttpMethodType as HttpMethod } from '@objectstack/spec/ui';(该行上方 :36 的注释也提到 HttpMethodType,一并更新)

packages/types/src/__tests__/spec-subschema-parity.test.ts:30,49,71 也 import 了 HttpMethodSchema,跟着改即可。

⚠️ 不要把 import 换成 spec 的 HttpMethod 而保留本仓对外的名字不动。 spec 的 HttpMethod 是 7 值那一个;换过去会把本仓对外暴露的类型悄悄放宽两个值(多出 HEAD/OPTIONS),而 HttpRequestSchema.method 运行时仍只接受 5 值 —— method: 'HEAD' 会通过编译、在 .parse() 抛错。这正是 objectstack#4691 当初拒绝合并这两个名字的理由。只跟名,不改跨包语义。

时机

等 @objectstack/spec 升到含 objectstack-ai/objectstack#5976 的版本(v17 rc 线)时一并做;在此之前本仓保持现状即可。

Blocked-by: objectstack-ai/objectstack#5832

---

Generated by Claude Code

[claude]

分诊:入队(pm:queue)+ 暂阻(pm:blocked,Blocked-by: objectstack-ai/objectstack#5832)。⛔ 不打 domain:* —— objectui 是整仓座位,路由无需域标签。

• 落点锚定(origin/main 实测,前提成立):packages/types/src/zod/objectql.zod.ts:26(HttpMethodSchema as SpecHttpMethodSchema)与 :41(export const HttpMethodSchema = SpecHttpMethodSchema)、packages/types/src/objectql.ts:44(export type { HttpMethodType as HttpMethod },上方 :36-39 注释同批),外加 __tests__/spec-subschema-parity.test.ts。纯跟名,零形状变化。
• 为什么 blocked 而非直接可派:上游改名尚在 objectstack PR #5976(issue #5832,domain:spec 已在飞)。本仓消费的是已发布的 @objectstack/spec,今天还不红;提前改会立刻红。解锁判据同 [tracking] 抬 spec pin 至 rc.4+(发布后):联动适配清单 —— 等 rc.4 的单都挂这里 #3374 的硬判据 —— 以 lockfile 实际解析版本抬到含该改名的 rc 为准,不看 package.json 的 ^ 区间。
• 查重 / 收敛:同文件的前序单 spec v17 下一个 rc 将移除 @objectstack/spec/ui 的 HttpMethod 导出 —— @object-ui/types 需迁移(一行,零形状变化) #3235(spec 移除 @objectstack/spec/ui 的 HttpMethod 导出)已 closed completed,objectql.ts:36-44 的现状正是它的产物,故本条不是重复而是下一棒;它同时是 [tracking] 抬 spec pin 至 rc.4+(发布后):联动适配清单 —— 等 rc.4 的单都挂这里 #3374 联动清单里 spec v17 下一个 rc 将移除 @objectstack/spec/ui 的 HttpMethod 导出 —— @object-ui/types 需迁移(一行,零形状变化) #3235 那一行的后继。已在 [tracking] 抬 spec pin 至 rc.4+(发布后):联动适配清单 —— 等 rc.4 的单都挂这里 #3374 留言登记,派发入口唯一。
• 采信正文的陷阱警告(转达给将来的 dev):⛔ 不得把 import 换成 spec 的裸名 HttpMethod(7 值)——那会把本仓对外类型悄悄放宽 HEAD/OPTIONS,而 HttpRequestSchema.method 运行时仍只收 5 值,method: 'HEAD' 会编译通过、.parse() 抛错。这正是 objectstack#4691 拒绝合并两名的理由。只跟名,不改跨包语义。

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code