@cosmicdrift/kumiko-framework 0.413.1 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (463) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +63 -13
  4. package/agents/api/framework-event-store.md +14 -0
  5. package/agents/api/framework-ui-types.md +149 -21
  6. package/agents/api/renderer-web.md +93 -9
  7. package/agents/api/testing-helpers.md +3 -2
  8. package/agents/api/testing-stack.md +3 -0
  9. package/agents/api/types.md +205 -14
  10. package/agents/api.md +7 -7
  11. package/agents/boot-rules.md +63 -9
  12. package/agents/examples/api-docs.md +2 -6
  13. package/agents/examples/auth-mfa.md +57 -10
  14. package/agents/examples/chat-channels.md +2 -0
  15. package/agents/examples/currencies-global.md +1 -0
  16. package/agents/examples/env-composition.md +7 -11
  17. package/agents/examples/managed-pages.md +90 -1
  18. package/agents/examples/pwa-shell.md +210 -0
  19. package/agents/examples/rate-limiting.md +3 -3
  20. package/agents/examples/record-detail-layout.md +1537 -67
  21. package/agents/examples/workflow-engine.md +16 -12
  22. package/agents/examples.md +1 -0
  23. package/agents/features-index.md +4 -2
  24. package/agents/features.md +22 -7
  25. package/agents/widgets.md +19 -1
  26. package/dist/api/api-constants.d.ts +1 -0
  27. package/dist/api/api-constants.js +4 -0
  28. package/dist/api/auth-middleware.js +4 -3
  29. package/dist/api/auth-routes-shared.js +2 -1
  30. package/dist/api/entity-read-access.d.ts +1 -0
  31. package/dist/api/entity-read-access.js +18 -0
  32. package/dist/api/export/export-route.d.ts +6 -1
  33. package/dist/api/export/export-route.js +27 -1
  34. package/dist/api/export/export-rows.js +19 -3
  35. package/dist/api/routes.d.ts +2 -0
  36. package/dist/api/routes.js +9 -1
  37. package/dist/api/server-extra-routes.js +2 -1
  38. package/dist/api/server-feature-http-routes.d.ts +9 -0
  39. package/dist/api/server-feature-http-routes.js +109 -0
  40. package/dist/api/server-middleware.js +2 -19
  41. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  42. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  43. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  44. package/dist/api/server-rate-limit-wiring.js +37 -0
  45. package/dist/api/server-routes.d.ts +4 -12
  46. package/dist/api/server-routes.js +12 -171
  47. package/dist/api/server-schema-route.d.ts +3 -0
  48. package/dist/api/server-schema-route.js +58 -0
  49. package/dist/api/server-wiring.js +2 -37
  50. package/dist/api/server.js +3 -1
  51. package/dist/compliance/override-schema.js +5 -5
  52. package/dist/compliance/sub-processors.js +10 -1
  53. package/dist/crypto/index.d.ts +1 -1
  54. package/dist/crypto/index.js +1 -1
  55. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  56. package/dist/crypto/pii-field-encryption.js +16 -1
  57. package/dist/db/apply-entity-event.js +4 -0
  58. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  59. package/dist/db/bun-sql-connection-codes.js +7 -0
  60. package/dist/db/collect-table-metas.js +4 -1
  61. package/dist/db/config-seed.js +1 -1
  62. package/dist/db/derived-field-sql.js +15 -13
  63. package/dist/db/derived-related-sql.d.ts +2 -2
  64. package/dist/db/derived-related-sql.js +4 -2
  65. package/dist/db/dialect.d.ts +3 -0
  66. package/dist/db/dialect.js +1 -3
  67. package/dist/db/driver-row-coercion.js +2 -2
  68. package/dist/db/driver-value-preparation.js +1 -1
  69. package/dist/db/eagerload.js +15 -12
  70. package/dist/db/entity-table-meta.d.ts +2 -0
  71. package/dist/db/entity-table-meta.js +7 -0
  72. package/dist/db/event-store-executor-context.js +13 -8
  73. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  74. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  75. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  76. package/dist/db/event-store-executor-read-filter.js +28 -11
  77. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  78. package/dist/db/event-store-executor-read-search.js +6 -6
  79. package/dist/db/event-store-executor-read-sort.js +3 -3
  80. package/dist/db/event-store-executor-read-where.js +14 -5
  81. package/dist/db/event-store-executor-read.js +7 -7
  82. package/dist/db/event-store-executor-write.js +50 -95
  83. package/dist/db/executor-managed-tables.js +4 -1
  84. package/dist/db/index.d.ts +4 -2
  85. package/dist/db/index.js +4 -2
  86. package/dist/db/known-table-names.d.ts +1 -0
  87. package/dist/db/known-table-names.js +7 -5
  88. package/dist/db/list-aggregate-labels.d.ts +1 -0
  89. package/dist/db/list-aggregate-labels.js +9 -1
  90. package/dist/db/migrate-generator.js +23 -4
  91. package/dist/db/migrate-rls-diff.d.ts +1 -0
  92. package/dist/db/migrate-rls-diff.js +15 -1
  93. package/dist/db/migrate-runner.js +2 -2
  94. package/dist/db/money.d.ts +1 -1
  95. package/dist/db/money.js +1 -4
  96. package/dist/db/parent-ref-clause.d.ts +6 -2
  97. package/dist/db/parent-ref-clause.js +76 -23
  98. package/dist/db/parent-ref-global-hosts.d.ts +20 -0
  99. package/dist/db/parent-ref-global-hosts.js +47 -0
  100. package/dist/db/production-schema-command-hint.d.ts +1 -0
  101. package/dist/db/production-schema-command-hint.js +3 -0
  102. package/dist/db/queries/backfill-pii.js +55 -29
  103. package/dist/db/queries/ddl.js +13 -2
  104. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  105. package/dist/db/queries/event-store-open-streams.js +33 -0
  106. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  107. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  108. package/dist/db/queries/event-store.js +0 -1
  109. package/dist/db/queries/raw-sql.js +0 -1
  110. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  111. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  112. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  113. package/dist/db/queries/rls-boot-catalog.js +13 -8
  114. package/dist/db/queries/rls-shape.d.ts +2 -1
  115. package/dist/db/queries/rls-shape.js +10 -0
  116. package/dist/db/queries/session-advisory-lock.js +2 -1
  117. package/dist/db/queries/test-stack.js +7 -7
  118. package/dist/db/query.js +16 -11
  119. package/dist/db/rebuild-marker.js +11 -2
  120. package/dist/db/render-rls-ddl.d.ts +2 -0
  121. package/dist/db/render-rls-ddl.js +16 -11
  122. package/dist/db/replay-migration-sql.js +1 -1
  123. package/dist/db/row-level-security-boot-check.js +18 -5
  124. package/dist/db/row-level-security-connection.js +25 -12
  125. package/dist/db/row-level-security-scope.d.ts +2 -1
  126. package/dist/db/row-level-security-scope.js +9 -5
  127. package/dist/db/sql-identifier.d.ts +1 -0
  128. package/dist/db/sql-identifier.js +3 -0
  129. package/dist/db/system-tenant-read-db.d.ts +5 -0
  130. package/dist/db/system-tenant-read-db.js +28 -0
  131. package/dist/db/table-builder.d.ts +3 -1
  132. package/dist/db/table-builder.js +18 -8
  133. package/dist/db/table-info.d.ts +1 -2
  134. package/dist/db/table-introspection.d.ts +3 -0
  135. package/dist/db/table-introspection.js +6 -0
  136. package/dist/db/table-push.d.ts +1 -0
  137. package/dist/db/table-push.js +7 -1
  138. package/dist/db/tenant-db-runner.d.ts +3 -0
  139. package/dist/db/tenant-db-runner.js +19 -1
  140. package/dist/db/transaction-serialization.d.ts +1 -0
  141. package/dist/db/transaction-serialization.js +20 -3
  142. package/dist/db/where-clause.js +11 -2
  143. package/dist/db/write-ownership-failures.d.ts +25 -0
  144. package/dist/db/write-ownership-failures.js +82 -0
  145. package/dist/engine/boot-validator/boot-check.js +7 -1
  146. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  147. package/dist/engine/boot-validator/boot-phases.js +3 -2
  148. package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
  149. package/dist/engine/boot-validator/boot-rules.js +4 -0
  150. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  151. package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
  152. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  153. package/dist/engine/boot-validator/config-deps.js +0 -28
  154. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  155. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  156. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  157. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  158. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  159. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  160. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  161. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  162. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  163. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  164. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  165. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  166. package/dist/engine/boot-validator/entity-list-screens.js +33 -6
  167. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  168. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  169. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  170. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  171. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  172. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  173. package/dist/engine/boot-validator/list-row-guidance.js +129 -0
  174. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  175. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  176. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  177. package/dist/engine/boot-validator/list-sort-summary.js +149 -0
  178. package/dist/engine/boot-validator/list-table-options.js +15 -1
  179. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  180. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  181. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  182. package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
  183. package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
  184. package/dist/engine/boot-validator/named-filter-rules.js +32 -2
  185. package/dist/engine/boot-validator/ownership.js +10 -1
  186. package/dist/engine/boot-validator/parent-ref.js +87 -50
  187. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  188. package/dist/engine/boot-validator/projection-list-screens.js +31 -1
  189. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  190. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  191. package/dist/engine/boot-validator/query-output-guidance.js +39 -0
  192. package/dist/engine/boot-validator/query-refs.js +24 -1
  193. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  194. package/dist/engine/boot-validator/row-decoration.js +16 -0
  195. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  196. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  197. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  198. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  199. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  200. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  201. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  202. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  203. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  204. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  205. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  206. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  207. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  208. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  209. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  210. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  211. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  212. package/dist/engine/boot-validator/screens-lists.js +19 -3
  213. package/dist/engine/boot-validator/screens.js +1 -1
  214. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  215. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  216. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  217. package/dist/engine/boot-validator/zod-shape.js +19 -1
  218. package/dist/engine/build-app-schema.js +4 -0
  219. package/dist/engine/config-helpers.d.ts +1 -2
  220. package/dist/engine/config-helpers.js +6 -7
  221. package/dist/engine/define-feature.js +1 -0
  222. package/dist/engine/define-handler.d.ts +1 -0
  223. package/dist/engine/define-handler.js +4 -2
  224. package/dist/engine/definition-violations.js +2 -2
  225. package/dist/engine/entity-handlers.js +3 -8
  226. package/dist/engine/entity-list-runtime-options.js +9 -8
  227. package/dist/engine/factories.d.ts +2 -0
  228. package/dist/engine/feature-config-events-jobs.js +1 -0
  229. package/dist/engine/feature-entity-handlers.js +5 -2
  230. package/dist/engine/field-access.d.ts +1 -1
  231. package/dist/engine/field-access.js +7 -10
  232. package/dist/engine/find-entity.js +3 -3
  233. package/dist/engine/form-derivations.js +3 -3
  234. package/dist/engine/index.d.ts +3 -3
  235. package/dist/engine/index.js +2 -2
  236. package/dist/engine/named-filter-roles.d.ts +3 -0
  237. package/dist/engine/named-filter-roles.js +23 -0
  238. package/dist/engine/pipeline.js +0 -1
  239. package/dist/engine/project-app-schema-for-roles.js +17 -2
  240. package/dist/engine/qualified-name.js +0 -1
  241. package/dist/engine/registry-facade.js +1 -2
  242. package/dist/engine/registry-state.d.ts +1 -1
  243. package/dist/engine/registry-state.js +5 -2
  244. package/dist/engine/registry-validate.js +2 -1
  245. package/dist/engine/resolve-named-list-filters.js +5 -2
  246. package/dist/engine/schema-builder.js +6 -10
  247. package/dist/engine/screen-helpers.d.ts +12 -0
  248. package/dist/engine/screen-helpers.js +17 -1
  249. package/dist/engine/soft-delete-cleanup.js +1 -5
  250. package/dist/engine/state-machine.js +0 -1
  251. package/dist/engine/steps/_database-clock.d.ts +2 -0
  252. package/dist/engine/steps/_database-clock.js +6 -0
  253. package/dist/engine/steps/compute.js +1 -1
  254. package/dist/engine/steps/retry.js +5 -1
  255. package/dist/engine/steps/return.js +0 -1
  256. package/dist/engine/steps/wait-for-event.js +2 -1
  257. package/dist/engine/steps/wait.js +2 -1
  258. package/dist/engine/system-user.d.ts +2 -2
  259. package/dist/engine/system-user.js +2 -2
  260. package/dist/engine/types/handlers.d.ts +1 -1
  261. package/dist/engine/types/handlers.js +1 -1
  262. package/dist/engine/types/screen.d.ts +1 -1
  263. package/dist/engine/types/screen.js +1 -1
  264. package/dist/engine/webhook-contracts.d.ts +2 -3
  265. package/dist/engine/webhook-contracts.js +2 -25
  266. package/dist/engine/webhook-events.js +48 -29
  267. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  268. package/dist/engine/webhook-payload-strictness.js +53 -0
  269. package/dist/env/_zod-introspect.d.ts +1 -0
  270. package/dist/env/dry-run.d.ts +1 -1
  271. package/dist/env/dry-run.js +1 -1
  272. package/dist/env/field-meta.d.ts +4 -0
  273. package/dist/env/field-meta.js +67 -0
  274. package/dist/env/field-rules.d.ts +9 -0
  275. package/dist/env/field-rules.js +46 -0
  276. package/dist/env/index.d.ts +3 -3
  277. package/dist/env/index.js +16 -71
  278. package/dist/env/internals.d.ts +3 -0
  279. package/dist/env/internals.js +1 -2
  280. package/dist/env/required-env.d.ts +3 -1
  281. package/dist/env/required-env.js +5 -2
  282. package/dist/errors/serialize.js +2 -2
  283. package/dist/errors/write-error-info.js +0 -2
  284. package/dist/es-ops/operations-schema.js +18 -7
  285. package/dist/event-store/admin-api.js +3 -3
  286. package/dist/event-store/event-store.js +0 -3
  287. package/dist/event-store/index.d.ts +1 -0
  288. package/dist/event-store/index.js +1 -0
  289. package/dist/event-store/transfer.js +1 -1
  290. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  291. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  292. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  293. package/dist/files/bind-pending-file-refs.js +54 -27
  294. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  295. package/dist/files/create-file-ref.d.ts +4 -1
  296. package/dist/files/create-file-ref.js +14 -3
  297. package/dist/files/default-file-guard.js +4 -1
  298. package/dist/files/file-claim.d.ts +6 -0
  299. package/dist/files/file-claim.js +17 -0
  300. package/dist/files/file-field-slots.d.ts +2 -0
  301. package/dist/files/file-field-slots.js +28 -0
  302. package/dist/files/file-ref-entity.d.ts +3 -0
  303. package/dist/files/file-ref-entity.js +2 -0
  304. package/dist/files/file-ref-table.d.ts +3 -0
  305. package/dist/files/file-routes.d.ts +4 -1
  306. package/dist/files/file-routes.js +80 -16
  307. package/dist/files/in-memory-provider.d.ts +1 -1
  308. package/dist/files/in-memory-provider.js +2 -1
  309. package/dist/files/index.d.ts +1 -1
  310. package/dist/files/index.js +1 -1
  311. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  312. package/dist/files/invalid-file-ref-error.js +15 -0
  313. package/dist/files/local-provider.js +9 -2
  314. package/dist/files/provider-resolver.js +1 -1
  315. package/dist/files/rebind-file-ref.d.ts +3 -2
  316. package/dist/files/rebind-file-ref.js +24 -18
  317. package/dist/files/resolve-file-handles.d.ts +13 -0
  318. package/dist/files/resolve-file-handles.js +57 -0
  319. package/dist/files/storage-tracking.d.ts +1 -1
  320. package/dist/files/storage-tracking.js +5 -2
  321. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  322. package/dist/files/types.d.ts +4 -0
  323. package/dist/files/types.js +10 -0
  324. package/dist/files/upload-field-resolution.d.ts +1 -0
  325. package/dist/files/upload-field-resolution.js +16 -2
  326. package/dist/files/upload-ledger.js +1 -1
  327. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  328. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  329. package/dist/i18n/required-surface-keys.js +19 -4
  330. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  331. package/dist/internal/boot-rule-table-expectations.js +29 -0
  332. package/dist/internal/row-level-security.d.ts +1 -0
  333. package/dist/internal/row-level-security.js +1 -0
  334. package/dist/internal/testing.d.ts +1 -0
  335. package/dist/internal/testing.js +1 -0
  336. package/dist/jobs/index.d.ts +1 -0
  337. package/dist/jobs/index.js +1 -0
  338. package/dist/jobs/job-load-events.d.ts +10 -0
  339. package/dist/jobs/job-load-events.js +12 -0
  340. package/dist/jobs/job-runner-context.js +6 -158
  341. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  342. package/dist/jobs/job-runner-dispatch.js +57 -0
  343. package/dist/jobs/job-runner-event-triggers.js +18 -9
  344. package/dist/jobs/job-runner-execution.js +2 -2
  345. package/dist/jobs/job-runner-facets.d.ts +48 -0
  346. package/dist/jobs/job-runner-facets.js +156 -0
  347. package/dist/jobs/job-runner-gates.js +19 -11
  348. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  349. package/dist/jobs/job-runner-helpers.js +18 -3
  350. package/dist/jobs/job-runner-scope.d.ts +1 -0
  351. package/dist/jobs/job-runner-scope.js +2 -0
  352. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  353. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  354. package/dist/jobs/job-runner.js +31 -70
  355. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  356. package/dist/jobs/obliterate-job-queues.js +23 -0
  357. package/dist/lifecycle/lifecycle.js +1 -1
  358. package/dist/migrations/event-header-scrub.d.ts +11 -0
  359. package/dist/migrations/event-header-scrub.js +33 -0
  360. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  361. package/dist/migrations/event-payload-scrub.js +36 -4
  362. package/dist/migrations/index.d.ts +1 -0
  363. package/dist/migrations/index.js +2 -0
  364. package/dist/migrations/kumiko-drift.d.ts +5 -2
  365. package/dist/migrations/kumiko-drift.js +51 -14
  366. package/dist/migrations/pending-rebuilds.js +4 -5
  367. package/dist/observability/sensitive-filter.js +0 -12
  368. package/dist/pipeline/aggregate-type-removal.js +17 -4
  369. package/dist/pipeline/context-services.d.ts +2 -0
  370. package/dist/pipeline/context-services.js +5 -2
  371. package/dist/pipeline/dispatch-batch.js +4 -3
  372. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  373. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  374. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  375. package/dist/pipeline/dispatch-nested-write.js +119 -0
  376. package/dist/pipeline/dispatch-query.js +10 -3
  377. package/dist/pipeline/dispatch-scope.js +4 -3
  378. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  379. package/dist/pipeline/dispatch-shared.js +6 -38
  380. package/dist/pipeline/dispatch-write.d.ts +0 -1
  381. package/dist/pipeline/dispatch-write.js +3 -302
  382. package/dist/pipeline/dispatcher-utils.js +6 -0
  383. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  384. package/dist/pipeline/effective-system-scope.js +22 -0
  385. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  386. package/dist/pipeline/event-dispatcher-delivery.js +17 -9
  387. package/dist/pipeline/event-dispatcher.d.ts +4 -1
  388. package/dist/pipeline/event-dispatcher.js +6 -7
  389. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  390. package/dist/pipeline/handler-context-auth.js +3 -4
  391. package/dist/pipeline/handler-context-db.js +11 -4
  392. package/dist/pipeline/handler-context-dispatch.js +2 -2
  393. package/dist/pipeline/handler-context-events.d.ts +8 -3
  394. package/dist/pipeline/handler-context-events.js +20 -65
  395. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  396. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  397. package/dist/pipeline/handler-context-notify.js +2 -0
  398. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  399. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  400. package/dist/pipeline/handler-context-projection.js +39 -0
  401. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  402. package/dist/pipeline/handler-context-scope.js +14 -2
  403. package/dist/pipeline/index.d.ts +1 -1
  404. package/dist/pipeline/index.js +1 -1
  405. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  406. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  407. package/dist/pipeline/member-reader.js +4 -2
  408. package/dist/pipeline/msp-rebuild.js +1 -1
  409. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  410. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  411. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  412. package/dist/pipeline/projection-rebuild.js +16 -7
  413. package/dist/pipeline/projection-state.js +4 -6
  414. package/dist/pipeline/system-hooks.js +36 -6
  415. package/dist/pipeline/write-result-masking.js +31 -3
  416. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  417. package/dist/pipeline/write-transition-guard.js +95 -0
  418. package/dist/schema-cli/shared.d.ts +2 -0
  419. package/dist/schema-cli/shared.js +4 -2
  420. package/dist/schema-cli/validate-command.js +43 -28
  421. package/dist/search/meilisearch-adapter.js +14 -9
  422. package/dist/search/reindex-entity.d.ts +2 -0
  423. package/dist/search/reindex-entity.js +32 -4
  424. package/dist/search/reindex-tenants-search.js +20 -4
  425. package/dist/time/tz-context.js +1 -1
  426. package/dist/ui-types/card-column-roles.d.ts +4 -0
  427. package/dist/ui-types/card-column-roles.js +6 -3
  428. package/dist/ui-types/index.d.ts +2 -2
  429. package/dist/ui-types/index.js +1 -1
  430. package/dist/utils/ids.js +0 -1
  431. package/dist/utils/index.d.ts +1 -0
  432. package/dist/utils/index.js +1 -0
  433. package/dist/utils/return-path-limit.d.ts +1 -0
  434. package/dist/utils/return-path-limit.js +1 -0
  435. package/package.json +5 -3
  436. package/presets/biome-app.json +39 -21
  437. package/presets/biome-plugins/admin-api.grit +10 -0
  438. package/presets/biome-plugins/error-reasons.grit +53 -0
  439. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  440. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  441. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  442. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  443. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  444. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  445. package/presets/biome-plugins/no-date-api.grit +9 -0
  446. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  447. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  448. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  449. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  450. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  451. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  452. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  453. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  454. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  455. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  456. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  457. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  458. package/presets/biome-plugins/test-title.grit +20 -0
  459. package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
  460. package/presets/biome-rules.json +465 -0
  461. package/src/changes.json +309 -0
  462. package/dist/engine/minor-units.d.ts +0 -2
  463. package/dist/engine/minor-units.js +0 -8
@@ -0,0 +1,3 @@
1
+ import type { NamedListFilterDef } from "@cosmicdrift/kumiko-types/named-list-filters";
2
+ import type { EntityListScreenDefinition } from "../ui-types/index.ts";
3
+ export declare function projectNamedFilterRoles(screen: EntityListScreenDefinition, defs: Readonly<Record<string, NamedListFilterDef>> | undefined): EntityListScreenDefinition;
@@ -0,0 +1,23 @@
1
+ // Only a plain role rule is serializable; openToAll, anySignedIn and no rule restrict nobody.
2
+ function rolesRestrictingNamedFilter(access) {
3
+ if (access === undefined || "openToAll" in access || access.anySignedIn === true) {
4
+ return undefined;
5
+ }
6
+ return access.roles;
7
+ }
8
+ // `roles` on a ref is framework-owned: an authored value is dropped so a screen cannot widen the
9
+ // entity's access rule on the client.
10
+ function refWithEntityRoles(ref, defs) {
11
+ const { roles: _authored, ...plain } = ref;
12
+ const def = Object.hasOwn(defs, ref.id) ? defs[ref.id] : undefined;
13
+ const roles = rolesRestrictingNamedFilter(def?.access);
14
+ return roles === undefined ? plain : { ...plain, roles };
15
+ }
16
+ export function projectNamedFilterRoles(screen, defs) {
17
+ if (screen.namedFilters === undefined)
18
+ return screen;
19
+ return {
20
+ ...screen,
21
+ namedFilters: screen.namedFilters.map((ref) => refWithEntityRoles(ref, defs ?? {})),
22
+ };
23
+ }
@@ -67,7 +67,6 @@ export function stepsPipeline(closure) {
67
67
  }
68
68
  // Internal: invoked by run-pipeline.ts to materialise the step list.
69
69
  // Not exported from the engine barrel — pipeline-internal plumbing.
70
- // @wrapper-known semantic-alias
71
70
  //
72
71
  // `awaits` comes off pipelineDef itself (set by defineWorkflow), not a
73
72
  // function argument — every existing buildPipelineSteps caller (runner.ts,
@@ -451,18 +451,31 @@ function projectListScreen(original, feature, indices, keptScreenQns) {
451
451
  ...(nextExpandableRow !== undefined && { expandableRow: nextExpandableRow }),
452
452
  };
453
453
  }
454
+ function projectGuidanceActions(block, feature, indices, keptScreenQns) {
455
+ if (block === undefined)
456
+ return undefined;
457
+ const nextActions = projectActionArray(block.actions, feature, indices, keptScreenQns);
458
+ if (nextActions === block.actions)
459
+ return block;
460
+ const { actions, ...rest } = block;
461
+ return { ...rest, ...(nextActions !== undefined && { actions: nextActions }) };
462
+ }
454
463
  function projectProjectionDetailScreen(screen, feature, indices, keptScreenQns) {
455
- const { metrics, header, actions, layout, listScreenId, ...rest } = screen;
464
+ const { metrics, header, actions, layout, listScreenId, banner, steps, ...rest } = screen;
456
465
  const nextMetrics = projectMetrics(metrics, indices, keptScreenQns);
457
466
  const nextHeader = projectHeader(header, indices, keptScreenQns);
458
467
  const nextActions = projectActionArray(actions, feature, indices, keptScreenQns);
459
468
  const nextLayout = projectEditLayout(layout, feature, indices, keptScreenQns);
460
469
  const nextListScreenId = projectListScreenId(listScreenId, indices, keptScreenQns);
470
+ const nextBanner = projectGuidanceActions(banner, feature, indices, keptScreenQns);
471
+ const nextSteps = projectGuidanceActions(steps, feature, indices, keptScreenQns);
461
472
  const unchanged = nextMetrics === metrics &&
462
473
  nextHeader === header &&
463
474
  nextActions === actions &&
464
475
  nextLayout === layout &&
465
- nextListScreenId === listScreenId;
476
+ nextListScreenId === listScreenId &&
477
+ nextBanner === banner &&
478
+ nextSteps === steps;
466
479
  if (unchanged)
467
480
  return screen;
468
481
  return {
@@ -472,6 +485,8 @@ function projectProjectionDetailScreen(screen, feature, indices, keptScreenQns)
472
485
  ...(nextMetrics !== undefined && { metrics: nextMetrics }),
473
486
  ...(nextActions !== undefined && { actions: nextActions }),
474
487
  ...(nextListScreenId !== undefined && { listScreenId: nextListScreenId }),
488
+ ...(nextBanner !== undefined && { banner: nextBanner }),
489
+ ...(nextSteps !== undefined && { steps: nextSteps }),
475
490
  };
476
491
  }
477
492
  function projectEntityEditScreen(screen, feature, indices, keptScreenQns) {
@@ -103,7 +103,6 @@ export function isValidQn(value) {
103
103
  // True if `name` is a valid QN segment (lowercase letters, digits, dashes;
104
104
  // starts with a letter). Same rule as `QN_SEGMENT` — kept public so feature
105
105
  // registration can reject bad names at the source instead of at registry-boot.
106
- // @wrapper-known semantic-alias
107
106
  export function isKebabSegment(name) {
108
107
  return QN_SEGMENT.test(name);
109
108
  }
@@ -1,5 +1,5 @@
1
1
  import { filterByPhase, filterOwned } from "./registry-state.js";
2
- import { assertUniqueWebhookWireNames, createWebhookContractResolver, } from "./webhook-contracts.js";
2
+ import { createWebhookContractResolver, } from "./webhook-contracts.js";
3
3
  function isFeatureSystemScoped(state, featureName) {
4
4
  if (!featureName)
5
5
  return false;
@@ -10,7 +10,6 @@ function isFeatureSystemScoped(state, featureName) {
10
10
  // return-object literal, only the closure-captured variable changed
11
11
  // (state.X instead of bare X, done in the RegistryState-threading step).
12
12
  export function buildRegistryFacade(state) {
13
- assertUniqueWebhookWireNames([...state.featureMap.values()]);
14
13
  let resolver;
15
14
  const webhookContracts = () => {
16
15
  resolver ??= createWebhookContractResolver([...state.featureMap.values()]);
@@ -23,7 +23,7 @@ export type SearchableReferenceField = {
23
23
  };
24
24
  export type SortableReferenceField = SearchableReferenceField;
25
25
  export declare const IMPLICIT_PROJECTION_SUFFIX: "-entity";
26
- export declare function buildImplicitProjection(featureName: string, entityName: string, entity: EntityDefinition, qualify: typeof qualifyEntityName, backingTable?: unknown, extensions?: readonly EntityProjectionExtension[]): ProjectionDefinition;
26
+ export declare function buildImplicitProjection(featureName: string, entityName: string, entity: EntityDefinition, qualify: typeof qualifyEntityName, backingTable?: unknown, extensions?: readonly EntityProjectionExtension[], readsSystemRows?: boolean): ProjectionDefinition;
27
27
  export declare const qualify: typeof qualifyEntityName;
28
28
  export type RegistryState = {
29
29
  featureMap: Map<string, FeatureDefinition>;
@@ -2,7 +2,7 @@ import { applyEntityEvent } from "../db/apply-entity-event.js";
2
2
  import { assertBackingTableSuperset, deriveEntityTableMeta } from "../db/entity-table-meta.js";
3
3
  import { markExecutorManagedTable } from "../db/executor-managed-tables.js";
4
4
  import { asEntityTableMeta } from "../db/query.js";
5
- import { buildEntityTable } from "../db/table-builder.js";
5
+ import { buildEntityTable, declareSystemRowsReadable } from "../db/table-builder.js";
6
6
  import { qualifyEntityName } from "./qualified-name.js";
7
7
  export const IMPLICIT_PROJECTION_SUFFIX = "-entity";
8
8
  // Each `r.entity` registration gets an implicit projection with generated
@@ -11,7 +11,7 @@ export const IMPLICIT_PROJECTION_SUFFIX = "-entity";
11
11
  // events through this definition. Both call applyEntityEvent, ensuring live
12
12
  // and rebuild use the same logic (also covered by
13
13
  // implicit-projection-equivalence.integration.ts).
14
- export function buildImplicitProjection(featureName, entityName, entity, qualify, backingTable, extensions = []) {
14
+ export function buildImplicitProjection(featureName, entityName, entity, qualify, backingTable, extensions = [], readsSystemRows = false) {
15
15
  const name = qualify(featureName, "projection", `${entityName}${IMPLICIT_PROJECTION_SUFFIX}`);
16
16
  // Backing table (r.entity({ name, ...def, backingTable })) is the one physical table
17
17
  // object shared by executor-writes, rebuild-replay, test-push and
@@ -21,6 +21,9 @@ export function buildImplicitProjection(featureName, entityName, entity, qualify
21
21
  const drizzleTable = backingTable !== undefined
22
22
  ? resolveBackingTable(entityName, entity, backingTable)
23
23
  : buildEntityTable(entityName, entity);
24
+ // Push paths read the table's own meta, so the reference-data-derived flag must land there too.
25
+ if (readsSystemRows)
26
+ declareSystemRowsReadable(drizzleTable);
24
27
  markExecutorManagedTable(drizzleTable, { entityName, entity });
25
28
  // applyEntityEvent returns ApplyResult, but SingleStreamApplyFn expects
26
29
  // Promise<void>. The row is irrelevant during rebuild, so we discard it.
@@ -1,6 +1,7 @@
1
1
  import { isRateLimitDisabled } from "@cosmicdrift/kumiko-types/handlers";
2
2
  import { configureEventPiiCatalog } from "../crypto/event-pii.js";
3
3
  import { hasSearchablePlaintext, isSensitiveLabelField } from "../db/entity-field-encryption.js";
4
+ import { entityReadsSystemRows } from "../db/entity-table-meta.js";
4
5
  import { entityEventName } from "../db/event-store-executor-context.js";
5
6
  import { resolveMaxPerTenant } from "../jobs/max-per-tenant.js";
6
7
  import { bindHookEscapeHatchGrant } from "../pipeline/system-identity-switch.js";
@@ -253,7 +254,7 @@ export function buildImplicitProjections(state, features) {
253
254
  }
254
255
  }
255
256
  for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
256
- const def = buildImplicitProjection(feature.name, entityName, entity, qualify, feature.entityTables?.[entityName], feature.entityProjectionExtensions?.[entityName] ?? []);
257
+ const def = buildImplicitProjection(feature.name, entityName, entity, qualify, feature.entityTables?.[entityName], feature.entityProjectionExtensions?.[entityName] ?? [], entityReadsSystemRows(feature, entityName, entity));
257
258
  if (state.projectionMap.has(def.name)) {
258
259
  throw new Error(`Implicit projection "${def.name}" kollidiert mit einer explizit registrierten r.projection. ` +
259
260
  `Implicit-Projections werden für jede r.entity mit "-entity"-Suffix angelegt — ` +
@@ -1,3 +1,4 @@
1
+ import { rowMetaFieldNames } from "../db/table-builder.js";
1
2
  import { AccessDeniedError, ValidationError } from "../errors/index.js";
2
3
  import { hasAccess } from "./access.js";
3
4
  export async function resolveNamedListFilters(ctx, user, entityName, name) {
@@ -19,10 +20,12 @@ export async function resolveNamedListFilters(ctx, user, entityName, name) {
19
20
  throw new AccessDeniedError();
20
21
  }
21
22
  const conditions = await def.filters({ ctx, user, now: ctx.tz.now() });
22
- const entityFields = ctx.registry.getEntity(entityName)?.fields ?? {};
23
+ const entity = ctx.registry.getEntity(entityName);
24
+ const entityFields = entity?.fields ?? {};
25
+ const rowMeta = rowMetaFieldNames(entity?.softDelete === true);
23
26
  for (const condition of conditions) {
24
27
  // Fail closed: a condition on a non-column is dropped by the list filter and would widen the queue.
25
- if (condition.field !== "id" && !Object.hasOwn(entityFields, condition.field)) {
28
+ if (!Object.hasOwn(entityFields, condition.field) && !rowMeta.has(condition.field)) {
26
29
  throw new Error(`Named filter "${name}" of entity "${entityName}" filters on unknown field "${condition.field}".`);
27
30
  }
28
31
  }
@@ -1,3 +1,4 @@
1
+ import { isFileHandle } from "@cosmicdrift/kumiko-types/identifiers";
1
2
  import * as z from "zod";
2
3
  import { moneyPayloadToMinorUnits } from "../db/money.js";
3
4
  import { isValidIanaTimeZone } from "../time/index.js";
@@ -272,11 +273,11 @@ function locatedTimestampToZod() {
272
273
  z.object({ utc, tz, at: at.optional() }),
273
274
  ]);
274
275
  }
276
+ // A fileRef UUID (the type of fileRefsTable.id) or the handle of a pending anonymous upload,
277
+ // which the executor resolves to the bare UUID before anything is stored.
278
+ const fileRefReferenceToZod = () => z.union([z.uuid(), z.string().refine(isFileHandle, { message: "invalid file handle" })]);
275
279
  function fileListFieldToZod(field) {
276
- // Multi file: array of fileRef UUIDs. Same story as the singular
277
- // variant — the element type has to match the UUID column on
278
- // fileRefsTable.id.
279
- const ids = z.array(z.uuid());
280
+ const ids = z.array(fileRefReferenceToZod());
280
281
  return field.maxCount === undefined ? ids : ids.max(field.maxCount);
281
282
  }
282
283
  export function fieldToZod(field, currencies, opts = {}) {
@@ -335,12 +336,7 @@ export function fieldToZod(field, currencies, opts = {}) {
335
336
  return locatedTimestampToZod();
336
337
  case "file":
337
338
  case "image":
338
- // Single file: stores a fileRef UUID — must match fileRefsTable.id
339
- // (uuid column). Pre-fix this was z.number() from an era when the
340
- // column was (wrongly) integer; the table-builder fix to uuid needs
341
- // a matching validation-layer fix here or the CRUD pipeline rejects
342
- // every valid UUID with "expected number".
343
- return z.uuid();
339
+ return fileRefReferenceToZod();
344
340
  case "files":
345
341
  case "images":
346
342
  return fileListFieldToZod(field);
@@ -27,6 +27,17 @@ export declare function normalizeListColumn(c: ListColumnSpec): Exclude<ListColu
27
27
  * (form-condition closures) reuse it; three hand-rolled copies had
28
28
  * already drifted in shape. */
29
29
  export declare function evalFieldCondition(cond: FieldCondition, values: Record<string, unknown>): boolean;
30
+ type EmptyStateText = {
31
+ readonly title: string;
32
+ readonly description?: string | undefined;
33
+ };
34
+ /** Picks the first emptyState variant whose `when` matches the record, else the base emptyState.
35
+ * Shared by the renderer and the specs' tests so they cannot diverge. */
36
+ export declare function pickEmptyStateText<Variant extends EmptyStateText & {
37
+ readonly when: FieldCondition;
38
+ }, EmptyState extends EmptyStateText & {
39
+ readonly variants?: readonly Variant[];
40
+ }>(emptyState: EmptyState | undefined, record: Readonly<Record<string, unknown>>): EmptyState | Variant | undefined;
30
41
  export declare function isRecordLocked(lockedWhen: FieldCondition | undefined, row: Readonly<Record<string, unknown>>): boolean;
31
42
  type SelectOptionRules = Pick<SelectFieldDef, "options" | "conditionalOptions">;
32
43
  export type UnavailableSelectOption = {
@@ -36,6 +47,7 @@ export type UnavailableSelectOption = {
36
47
  };
37
48
  /** Options of a select field that are offered for the given row values, in declaration order. */
38
49
  export declare function availableSelectOptions(field: SelectOptionRules, values: Record<string, unknown>): readonly string[];
50
+ export declare function stableJson(value: unknown): string;
39
51
  export declare function isUnchangedValue(a: unknown, b: unknown): boolean;
40
52
  /** Select values that violate a `conditionalOptions` rule. With `previous`, a field is only
41
53
  * checked when it or one of its condition fields changed, so legacy rows stay editable. */
@@ -113,6 +113,14 @@ export function evalFieldCondition(cond, values) {
113
113
  return !cond.notIn.includes(val);
114
114
  return val !== cond.ne;
115
115
  }
116
+ /** Picks the first emptyState variant whose `when` matches the record, else the base emptyState.
117
+ * Shared by the renderer and the specs' tests so they cannot diverge. */
118
+ export function pickEmptyStateText(emptyState, record) {
119
+ if (emptyState === undefined)
120
+ return undefined;
121
+ return (emptyState.variants?.find((variant) => evalFieldCondition(variant.when, { ...record })) ??
122
+ emptyState);
123
+ }
116
124
  // A row that lacks the condition's field counts as locked: an unreadable lock state
117
125
  // must not open the record.
118
126
  export function isRecordLocked(lockedWhen, row) {
@@ -129,8 +137,16 @@ export function availableSelectOptions(field, values) {
129
137
  return field.options;
130
138
  return field.options.filter((option) => rules.every((rule) => !rule.options.includes(option) || evalFieldCondition(rule.when, values)));
131
139
  }
140
+ // Key-order-stable: stored jsonb and schema-parsed rows order object keys differently.
141
+ export function stableJson(value) {
142
+ return JSON.stringify(value, (_key, nested) => {
143
+ if (!nested || typeof nested !== "object" || Array.isArray(nested))
144
+ return nested;
145
+ return Object.fromEntries(Object.entries(nested).sort(([a], [b]) => a.localeCompare(b)));
146
+ });
147
+ }
132
148
  export function isUnchangedValue(a, b) {
133
- return JSON.stringify(a) === JSON.stringify(b);
149
+ return stableJson(a) === stableJson(b);
134
150
  }
135
151
  /** Select values that violate a `conditionalOptions` rule. With `previous`, a field is only
136
152
  * checked when it or one of its condition fields changed, so legacy rows stay editable. */
@@ -67,11 +67,7 @@ export const softDeleteCleanupJob = async (_payload, ctx) => {
67
67
  // explicitly tenant-filtered below as defense-in-depth — otherwise a
68
68
  // tenant with a short grace would purge another tenant's still-within-grace
69
69
  // rows.
70
- const tenantId = ctx.systemUser?.tenantId ?? ctx._tenantId;
71
- if (tenantId === undefined) {
72
- // skip: cron fired without a perTenant fan-out tenant — nothing scoped to purge
73
- return;
74
- }
70
+ const tenantId = ctx.systemUser.tenantId;
75
71
  const graceDays = await resolveGraceDays(ctx, tenantId, db);
76
72
  const cutoff = ctx.tz.now().subtract({ hours: graceDays * 24 });
77
73
  for (const proj of registry.getAllProjections().values()) {
@@ -39,7 +39,6 @@ export function defineTransitions(map) {
39
39
  * form. Both are supported; the graph method is the idiomatic API for new
40
40
  * code.
41
41
  */
42
- // @wrapper-known semantic-alias
43
42
  export function guardTransition(transitions, from, to) {
44
43
  transitions.assertTransition(from, to);
45
44
  }
@@ -0,0 +1,2 @@
1
+ import type { PipelineCtx } from "../types/step.ts";
2
+ export declare function databaseNowIso(ctx: PipelineCtx): Promise<string>;
@@ -0,0 +1,6 @@
1
+ import { legacyDateToInstant } from "../../time/legacy-date.js";
2
+ // The resume scan compares wakeAt against Postgres now(); deriving it from the app clock would
3
+ // fire timers early or late by the host's clock skew.
4
+ export async function databaseNowIso(ctx) {
5
+ return legacyDateToInstant(await ctx.db.databaseNow()).toString();
6
+ }
@@ -19,7 +19,7 @@ defineStep({
19
19
  kind: "compute",
20
20
  defaultFailureStrategy: "throw",
21
21
  resultKey: (args) => args.name,
22
- run: (args, ctx) => args.fn(ctx), // @wrapper-known semantic-alias
22
+ run: (args, ctx) => args.fn(ctx),
23
23
  });
24
24
  export function buildComputeStep(name, fn) {
25
25
  return {
@@ -6,9 +6,11 @@
6
6
  // event and returns SUSPEND_SENTINEL to suspend. The Resume-Loop picks it up
7
7
  // after the backoff duration and re-enters the step at the same index.
8
8
  // After all attempts exhausted, the original error propagates.
9
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
9
10
  import { createFallbackLogger } from "../../logging/index.js";
10
11
  import { defineStep } from "../define-step.js";
11
12
  import { runStepList } from "../run-pipeline.js";
13
+ import { databaseNowIso } from "./_database-clock.js";
12
14
  import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_RETRY_SCHEDULED_TYPE, } from "./_step-dispatch-constants.js";
13
15
  import { describeWorkflowStepError } from "./describe-workflow-step-error.js";
14
16
  import { unwrapWorkflowStepError } from "./workflow-step-error.js";
@@ -42,7 +44,9 @@ defineStep({
42
44
  error: String(unwrapWorkflowStepError(error)),
43
45
  });
44
46
  const backoffMs = calculateBackoff(attempt, args.backoff);
45
- const wakeAt = Temporal.Now.instant().add({ milliseconds: backoffMs }).toString();
47
+ const wakeAt = Temporal.Instant.from(await databaseNowIso(ctx))
48
+ .add({ milliseconds: backoffMs })
49
+ .toString();
46
50
  await ctx.events.unsafeAppend({
47
51
  aggregateId: ctx.workflow.runId,
48
52
  aggregateType: WORKFLOW_AGGREGATE_TYPE,
@@ -14,7 +14,6 @@ defineStep({
14
14
  kind: "return",
15
15
  defaultFailureStrategy: "throw",
16
16
  resultKey: () => RETURN_RESULT_KEY,
17
- // @wrapper-known semantic-alias
18
17
  run: (args, ctx) => resolveRequired(args.resolver, ctx),
19
18
  });
20
19
  export function buildReturnStep(resolver) {
@@ -21,6 +21,7 @@
21
21
  // result), so a subsequent step only ever sees the matched event's payload
22
22
  // after a resume seeds it in.
23
23
  import { defineStep } from "../define-step.js";
24
+ import { databaseNowIso } from "./_database-clock.js";
24
25
  import { addDuration } from "./_duration-utils.js";
25
26
  import { resolveOptional, resolveRequired } from "./_resolver-utils.js";
26
27
  import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_WAITING_FOR_EVENT_TYPE, } from "./_step-dispatch-constants.js";
@@ -36,7 +37,7 @@ defineStep({
36
37
  }
37
38
  const timeout = resolveRequired(args.timeout, ctx);
38
39
  const resolvedMatch = resolveOptional(args.match, ctx);
39
- const now = Temporal.Now.instant().toString();
40
+ const now = await databaseNowIso(ctx);
40
41
  const timeoutAt = timeout.startsWith("P") || timeout.startsWith("PT") ? addDuration(now, timeout) : timeout;
41
42
  await ctx.events.unsafeAppend({
42
43
  aggregateId: ctx.workflow.runId,
@@ -9,6 +9,7 @@
9
9
  // The `for` resolver accepts ISO-8601 duration strings ("PT1H", "P1D")
10
10
  // or absolute ISO timestamps ("2026-05-16T12:00:00Z").
11
11
  import { defineStep } from "../define-step.js";
12
+ import { databaseNowIso } from "./_database-clock.js";
12
13
  import { addDuration } from "./_duration-utils.js";
13
14
  import { resolveRequired } from "./_resolver-utils.js";
14
15
  import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_WAITING_TYPE, } from "./_step-dispatch-constants.js";
@@ -22,7 +23,7 @@ defineStep({
22
23
  "sync handlers cannot suspend (use r.step.webhook.send with mode: 'deferred' instead).");
23
24
  }
24
25
  const duration = resolveRequired(args.for, ctx);
25
- const now = Temporal.Now.instant().toString();
26
+ const now = await databaseNowIso(ctx);
26
27
  const wakeAt = duration.startsWith("P") || duration.startsWith("PT") ? addDuration(now, duration) : duration;
27
28
  await ctx.events.unsafeAppend({
28
29
  aggregateId: ctx.workflow.runId,
@@ -1,9 +1,9 @@
1
+ import { ANONYMOUS_ROLE } from "./types/handlers.ts";
1
2
  import { SYSTEM_USER_ID, type TenantId } from "./types/identifiers.ts";
2
3
  import type { SessionUser } from "./types/index.ts";
3
- export { SYSTEM_USER_ID };
4
+ export { ANONYMOUS_ROLE, SYSTEM_USER_ID };
4
5
  export declare const SYSTEM_ROLE: "system";
5
6
  export declare function createSystemUser(tenantId: TenantId, extraRoles?: readonly string[]): SessionUser;
6
7
  export declare const ANONYMOUS_USER_ID = "anonymous";
7
- export declare const ANONYMOUS_ROLE: "anonymous";
8
8
  export declare function isAnonymousSessionUser(user: Pick<SessionUser, "roles">): boolean;
9
9
  export declare function createAnonymousUser(tenantId: TenantId): SessionUser;
@@ -1,5 +1,6 @@
1
+ import { ANONYMOUS_ROLE } from "./types/handlers.js";
1
2
  import { SYSTEM_USER_ID } from "./types/identifiers.js";
2
- export { SYSTEM_USER_ID };
3
+ export { ANONYMOUS_ROLE, SYSTEM_USER_ID };
3
4
  export const SYSTEM_ROLE = "system";
4
5
  // extraRoles: hasAccess has no system bypass — handlers gate on
5
6
  // explicit roles. Callers that must reach handlers gated e.g. on
@@ -19,7 +20,6 @@ export function createSystemUser(tenantId, extraRoles = []) {
19
20
  // like SYSTEM_ROLE: the boot-validator rejects apps that declare these as
20
21
  // custom roles.
21
22
  export const ANONYMOUS_USER_ID = "anonymous";
22
- export const ANONYMOUS_ROLE = "anonymous";
23
23
  export function isAnonymousSessionUser(user) {
24
24
  return user.roles.includes(ANONYMOUS_ROLE);
25
25
  }
@@ -1,2 +1,2 @@
1
1
  export type * from "@cosmicdrift/kumiko-types/handlers";
2
- export { isOpenToAllGranted, isUiAccessGranted } from "@cosmicdrift/kumiko-types/handlers";
2
+ export { ANONYMOUS_ROLE, isOpenToAllGranted, isUiAccessGranted, } from "@cosmicdrift/kumiko-types/handlers";
@@ -1 +1 @@
1
- export { isOpenToAllGranted, isUiAccessGranted } from "@cosmicdrift/kumiko-types/handlers";
1
+ export { ANONYMOUS_ROLE, isOpenToAllGranted, isUiAccessGranted, } from "@cosmicdrift/kumiko-types/handlers";
@@ -1,2 +1,2 @@
1
1
  export type * from "@cosmicdrift/kumiko-types/screen";
2
- export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
2
+ export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
@@ -1 +1 @@
1
- export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
1
+ export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
@@ -1,5 +1,6 @@
1
- import type { WebhookEventContract } from "@cosmicdrift/kumiko-types/feature";
1
+ import type { WebhookEntityVerb, WebhookEventContract } from "@cosmicdrift/kumiko-types/feature";
2
2
  import type { FeatureDefinition } from "./types/index.ts";
3
+ export declare const WEBHOOK_ENTITY_VERBS: readonly WebhookEntityVerb[];
3
4
  export type WebhookContractResolver = {
4
5
  /** Declared contract, or one derived from an entity lifecycle event (`entity.verb`). */
5
6
  get(qualifiedName: string): WebhookEventContract | undefined;
@@ -8,5 +9,3 @@ export type WebhookContractResolver = {
8
9
  };
9
10
  /** Works on the feature list so a boot check, which has no registry, resolves the same contracts. */
10
11
  export declare function createWebhookContractResolver(features: readonly FeatureDefinition[]): WebhookContractResolver;
11
- /** Receivers tell events apart by wire name, so two contracts must never share one. */
12
- export declare function assertUniqueWebhookWireNames(features: readonly FeatureDefinition[]): void;
@@ -2,7 +2,7 @@ import * as z from "zod";
2
2
  import { DEFAULT_CURRENCIES } from "./field-helpers.js";
3
3
  import { personalFieldNames } from "./personal-data-fields.js";
4
4
  import { fieldToZod } from "./schema-builder.js";
5
- const ENTITY_VERBS = ["created", "updated", "deleted"];
5
+ export const WEBHOOK_ENTITY_VERBS = ["created", "updated", "deleted"];
6
6
  const CONTRACT_VERSION = 1;
7
7
  // money and locatedTimestamp are stored as several flat columns (amount plus currency, instant
8
8
  // plus zone); the event shape of such a field is not mapped yet, so they stay out instead of
@@ -112,7 +112,7 @@ function entityVerbOf(qualifiedName) {
112
112
  const dot = qualifiedName.lastIndexOf(".");
113
113
  if (dot <= 0)
114
114
  return undefined;
115
- const verb = ENTITY_VERBS.find((candidate) => candidate === qualifiedName.slice(dot + 1));
115
+ const verb = WEBHOOK_ENTITY_VERBS.find((candidate) => candidate === qualifiedName.slice(dot + 1));
116
116
  return verb === undefined ? undefined : { entity: qualifiedName.slice(0, dot), verb };
117
117
  }
118
118
  /** Works on the feature list so a boot check, which has no registry, resolves the same contracts. */
@@ -147,26 +147,3 @@ export function createWebhookContractResolver(features) {
147
147
  },
148
148
  };
149
149
  }
150
- /** Receivers tell events apart by wire name, so two contracts must never share one. */
151
- export function assertUniqueWebhookWireNames(features) {
152
- const qnByWireName = new Map();
153
- const claim = (wireName, qn) => {
154
- const existing = qnByWireName.get(wireName);
155
- if (existing !== undefined && existing !== qn) {
156
- throw new Error(`Webhook wire name "${wireName}" is used by both "${existing}" and "${qn}"; give one of them another wireName.`);
157
- }
158
- qnByWireName.set(wireName, qn);
159
- };
160
- for (const feature of features) {
161
- for (const def of Object.values(feature.webhookEvents ?? {}))
162
- claim(def.wireName, def.qn);
163
- }
164
- for (const feature of features) {
165
- for (const [name, entity] of Object.entries(feature.entities ?? {})) {
166
- if (entity.webhookEvents !== true)
167
- continue;
168
- for (const verb of ENTITY_VERBS)
169
- claim(`${name}.${verb}`, `${name}.${verb}`);
170
- }
171
- }
172
- }
@@ -3,6 +3,7 @@ import { bootRuleError } from "./boot-validator/boot-rule.js";
3
3
  import { DEFINITION_WEBHOOK_EVENT_RULES } from "./boot-validator/definition-webhook-events-rules.js";
4
4
  import { isObjectArgument, throwObjectArgumentRequired } from "./object-form.js";
5
5
  import { isKebabSegment, toKebab } from "./qualified-name.js";
6
+ import { findOpenPayloadShape } from "./webhook-payload-strictness.js";
6
7
  /** Delivery sends the returned payload, never the input: zod strips keys the contract does not
7
8
  * declare, so a field added to the source row cannot leak into a webhook by accident. */
8
9
  export function parseWebhookPayload(contract, payload) {
@@ -22,9 +23,17 @@ export function parseWebhookPayload(contract, payload) {
22
23
  * included, even when the event payload carries them. */
23
24
  export function toEntityWebhookPayload(contract, event) {
24
25
  const { aggregateId, payload } = event;
25
- const shaped = contract.verb === "created"
26
- ? { ...payload, id: aggregateId }
27
- : { id: aggregateId, changes: payload["changes"], previous: payload["previous"] };
26
+ const shaped = (() => {
27
+ switch (contract.verb) {
28
+ case "created":
29
+ return { ...payload, id: aggregateId };
30
+ case "updated":
31
+ case "deleted":
32
+ return { id: aggregateId, changes: payload["changes"], previous: payload["previous"] };
33
+ case undefined:
34
+ throw new Error("toEntityWebhookPayload needs an entity-derived contract; a declared contract has no verb.");
35
+ }
36
+ })();
28
37
  return parseWebhookPayload(contract, shaped);
29
38
  }
30
39
  export function formatWebhookPayloadIssues(issues) {
@@ -32,6 +41,41 @@ export function formatWebhookPayloadIssues(issues) {
32
41
  .map((issue) => `${issue.path === "" ? "(root)" : issue.path}: ${issue.message}`)
33
42
  .join("; ");
34
43
  }
44
+ function assertValidWebhookEventDefinition(where, definition) {
45
+ const { name, description, payload, version } = definition;
46
+ if (typeof name !== "string" || !isKebabSegment(name)) {
47
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.nameNotKebab, {
48
+ message: `${where}: name must be kebab-case, got ${JSON.stringify(name)}`,
49
+ });
50
+ }
51
+ if (typeof description !== "string" || description.trim() === "") {
52
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.descriptionEmpty, {
53
+ message: `${where}("${name}"): description must be a non-empty sentence`,
54
+ });
55
+ }
56
+ if (!(payload instanceof ZodObject)) {
57
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadNotZodObject, {
58
+ message: `${where}("${name}"): payload must be a zod object schema`,
59
+ });
60
+ }
61
+ const openShape = findOpenPayloadShape(payload);
62
+ if (openShape !== undefined) {
63
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadOpenShape, {
64
+ message: `${where}("${name}"): payload lets undeclared keys through at ${openShape}; use closed objects (no looseObject, passthrough or catchall)`,
65
+ });
66
+ }
67
+ if (!Number.isInteger(version) || version < 1) {
68
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.versionInvalid, {
69
+ message: `${where}("${name}"): version must be a positive integer`,
70
+ });
71
+ }
72
+ if (definition.wireName !== undefined &&
73
+ (typeof definition.wireName !== "string" || definition.wireName.trim() === "")) {
74
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.wireNameEmpty, {
75
+ message: `${where}("${name}"): wireName must be a non-empty string`,
76
+ });
77
+ }
78
+ }
35
79
  export function buildWebhookEventMethods(state, featureName) {
36
80
  return {
37
81
  defineWebhookEvent(definition) {
@@ -39,32 +83,7 @@ export function buildWebhookEventMethods(state, featureName) {
39
83
  throwObjectArgumentRequired(featureName, "defineWebhookEvent");
40
84
  const { name, description, payload, version } = definition;
41
85
  const where = `[Feature ${featureName}] defineWebhookEvent`;
42
- if (typeof name !== "string" || !isKebabSegment(name)) {
43
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.nameNotKebab, {
44
- message: `${where}: name must be kebab-case, got ${JSON.stringify(name)}`,
45
- });
46
- }
47
- if (typeof description !== "string" || description.trim() === "") {
48
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.descriptionEmpty, {
49
- message: `${where}("${name}"): description must be a non-empty sentence`,
50
- });
51
- }
52
- if (!(payload instanceof ZodObject)) {
53
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadNotZodObject, {
54
- message: `${where}("${name}"): payload must be a zod object schema`,
55
- });
56
- }
57
- if (!Number.isInteger(version) || version < 1) {
58
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.versionInvalid, {
59
- message: `${where}("${name}"): version must be a positive integer`,
60
- });
61
- }
62
- if (definition.wireName !== undefined &&
63
- (typeof definition.wireName !== "string" || definition.wireName.trim() === "")) {
64
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.wireNameEmpty, {
65
- message: `${where}("${name}"): wireName must be a non-empty string`,
66
- });
67
- }
86
+ assertValidWebhookEventDefinition(where, definition);
68
87
  const wireName = definition.wireName?.trim() ?? name;
69
88
  const qn = `${toKebab(featureName)}:${name}`;
70
89
  if (state.webhookEvents[qn] !== undefined) {
@@ -0,0 +1,7 @@
1
+ import type { $ZodType } from "zod/v4/core";
2
+ /**
3
+ * Path of the first object that would let undeclared keys through, else undefined.
4
+ * Only open object shapes count: record/any/unknown are explicitly declared field types
5
+ * carrying one named value, so they do not smuggle unknown keys of the row into the payload.
6
+ */
7
+ export declare function findOpenPayloadShape(schema: $ZodType, path?: string, visited?: Set<$ZodType>): string | undefined;