Repository navigation
client realtime declared ≠ enforced:subscribeData 回调把 RealtimeEventPayload 硬铸成 DataEvent,顶层 recordId/changes/id 运行时是 undefined #4626
Description
Activity
🔒 CLAIM — pm-dispatch round 7
branch:claude/issue-4626-data-event-contract
worktree:objectstack-issue-4626PM 裁决:同 #4602,方案 1 生产者履约——已声明的
DataEvent合同必须成真,不在消费侧留双铸或容错。与 #4602 的差别在于本题确有信封读者(webhook auto-enqueuer 直读data.record.*),因此:- 该 enqueuer 在同一个 PR 内迁移到履约后的事件形状——它在仓内,不构成"不可动的外部依赖";
- 生产者是 ObjectQL engine 热路径:每事件生成 uuid + zod parse 的开销必须实测(不是估计)。若实测代价确实可观,停手按 needs_decision 回报并附数据,由维护者裁是否需要 fast-path(例如仅在有订阅者时构造完整事件);
- 边界校验与 pin 测试规格同 fix(metadata,client): subscribeMetadata 交付真正的 MetadataEvent——生产者履约 + 边界校验 (#4602) #4628(PR 已合并,照抄形状,保持词汇一致)。
Generated by Claude Code
- added a commit that references this issue
on Aug 2, 2026 - added 4 commits that reference this issue
on Aug 3, 2026 - added a commit that references this issue
on Oct 7, 2026
#4602(subscribeMetadata/MetadataEvent 同病)修复时的范围外发现,按第十条军规立案,unassigned。#4602 的 PR 只修 metadata 侧;data 侧是同构缺陷但生产者不同,需单独裁决与实施。
现象
@objectstack/spec/api的DataEventSchema声明顶层字段id(uuid,必填)、object、recordId(必填)、changes?、before?、after?、userId?、timestamp。但:packages/objectql/src/engine.ts的data.record.*发布)发的是RealtimeEventPayload信封,record 数据嵌在payload({ recordId, after, changes }),从不生成id/userId。packages/client/src/realtime-api.tssubscribeData把信封callback(event as any as DataEvent);client-react的useDataSubscription/useDataSubscriptionCallback/useAutoRefresh同源。订阅者写
event.recordId/event.changes(类型系统说存在)运行时是undefined;必填的event.id不存在。处置方向
与 #4602 的裁决同族(生产者履约,消费端边界
DataEventSchema.safeParse响亮拒绝,删除as any as双铸)。注意 data 侧的生产者是 ObjectQL engine(热路径,每次 insert/update/delete),且 webhook auto-enqueuer 等服务端消费者直接读信封payload(packages/plugins/plugin-webhooks/src/auto-enqueuer.ts读payload.recordId ?? payload.id ?? …)——迁移时需要同时核对这些信封依赖,成本比 metadata 侧高,需单独评审。另注意
DataEventType里的data.field.changed疑似无生产者(declared ≠ enforced 同族,cf. #3197)。参照:#4602 的实施(producer 生成完整 spec 事件放入信封
payload,client 边界 parse)。