@cosmicdrift/kumiko-framework 0.413.1 → 0.415.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 (479) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +69 -13
  4. package/agents/api/framework-errors.md +1 -1
  5. package/agents/api/framework-event-store.md +14 -0
  6. package/agents/api/framework-ui-types.md +158 -21
  7. package/agents/api/renderer-web.md +112 -11
  8. package/agents/api/testing-helpers.md +3 -2
  9. package/agents/api/testing-stack.md +3 -0
  10. package/agents/api/types.md +248 -24
  11. package/agents/api.md +7 -7
  12. package/agents/boot-rules.md +66 -10
  13. package/agents/examples/api-docs.md +2 -6
  14. package/agents/examples/auth-mfa.md +57 -10
  15. package/agents/examples/chat-channels.md +2 -0
  16. package/agents/examples/crypto-shredding-hr.md +63 -1
  17. package/agents/examples/currencies-global.md +1 -0
  18. package/agents/examples/env-composition.md +7 -11
  19. package/agents/examples/managed-pages.md +90 -1
  20. package/agents/examples/pwa-shell.md +210 -0
  21. package/agents/examples/rate-limiting.md +3 -3
  22. package/agents/examples/record-detail-layout.md +1643 -67
  23. package/agents/examples/workflow-engine.md +16 -12
  24. package/agents/examples.md +1 -0
  25. package/agents/features-index.md +4 -2
  26. package/agents/features.md +22 -7
  27. package/agents/widgets.md +26 -1
  28. package/dist/api/api-constants.d.ts +1 -0
  29. package/dist/api/api-constants.js +4 -0
  30. package/dist/api/auth-middleware.js +4 -3
  31. package/dist/api/auth-routes-shared.js +2 -1
  32. package/dist/api/entity-read-access.d.ts +1 -0
  33. package/dist/api/entity-read-access.js +18 -0
  34. package/dist/api/export/export-route.d.ts +6 -1
  35. package/dist/api/export/export-route.js +27 -1
  36. package/dist/api/export/export-rows.js +19 -3
  37. package/dist/api/request-context-internals.d.ts +2 -0
  38. package/dist/api/request-context-scopes.js +9 -2
  39. package/dist/api/request-context.js +1 -1
  40. package/dist/api/routes.d.ts +2 -0
  41. package/dist/api/routes.js +9 -1
  42. package/dist/api/server-event-dispatcher.js +3 -0
  43. package/dist/api/server-extra-routes.js +2 -1
  44. package/dist/api/server-feature-http-routes.d.ts +9 -0
  45. package/dist/api/server-feature-http-routes.js +109 -0
  46. package/dist/api/server-middleware.js +2 -19
  47. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  48. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  49. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  50. package/dist/api/server-rate-limit-wiring.js +37 -0
  51. package/dist/api/server-routes.d.ts +4 -12
  52. package/dist/api/server-routes.js +12 -171
  53. package/dist/api/server-schema-route.d.ts +3 -0
  54. package/dist/api/server-schema-route.js +58 -0
  55. package/dist/api/server-wiring.js +2 -37
  56. package/dist/api/server.js +3 -1
  57. package/dist/compliance/override-schema.js +5 -5
  58. package/dist/compliance/sub-processors.js +10 -1
  59. package/dist/crypto/index.d.ts +1 -1
  60. package/dist/crypto/index.js +1 -1
  61. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  62. package/dist/crypto/pii-field-encryption.js +16 -1
  63. package/dist/db/apply-entity-event.js +4 -0
  64. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  65. package/dist/db/bun-sql-connection-codes.js +7 -0
  66. package/dist/db/collect-table-metas.js +4 -1
  67. package/dist/db/config-seed.js +1 -1
  68. package/dist/db/derived-field-sql.js +15 -13
  69. package/dist/db/derived-related-sql.d.ts +2 -2
  70. package/dist/db/derived-related-sql.js +4 -2
  71. package/dist/db/dialect.d.ts +3 -0
  72. package/dist/db/dialect.js +1 -3
  73. package/dist/db/driver-row-coercion.js +2 -2
  74. package/dist/db/driver-value-preparation.js +1 -1
  75. package/dist/db/eagerload.js +15 -12
  76. package/dist/db/entity-table-meta.d.ts +2 -0
  77. package/dist/db/entity-table-meta.js +7 -0
  78. package/dist/db/event-store-executor-context.js +13 -8
  79. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  80. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  81. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  82. package/dist/db/event-store-executor-read-filter.js +28 -11
  83. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  84. package/dist/db/event-store-executor-read-search.js +6 -6
  85. package/dist/db/event-store-executor-read-sort.js +3 -3
  86. package/dist/db/event-store-executor-read-where.js +14 -5
  87. package/dist/db/event-store-executor-read.js +7 -7
  88. package/dist/db/event-store-executor-write.js +50 -95
  89. package/dist/db/executor-managed-tables.js +4 -1
  90. package/dist/db/index.d.ts +4 -2
  91. package/dist/db/index.js +4 -2
  92. package/dist/db/known-table-names.d.ts +1 -0
  93. package/dist/db/known-table-names.js +7 -5
  94. package/dist/db/list-aggregate-labels.d.ts +1 -0
  95. package/dist/db/list-aggregate-labels.js +9 -1
  96. package/dist/db/migrate-generator.js +23 -4
  97. package/dist/db/migrate-rls-diff.d.ts +1 -0
  98. package/dist/db/migrate-rls-diff.js +15 -1
  99. package/dist/db/migrate-runner.js +2 -2
  100. package/dist/db/money.d.ts +1 -1
  101. package/dist/db/money.js +1 -4
  102. package/dist/db/parent-ref-clause.d.ts +6 -2
  103. package/dist/db/parent-ref-clause.js +105 -24
  104. package/dist/db/parent-ref-global-hosts.d.ts +23 -0
  105. package/dist/db/parent-ref-global-hosts.js +85 -0
  106. package/dist/db/production-schema-command-hint.d.ts +1 -0
  107. package/dist/db/production-schema-command-hint.js +3 -0
  108. package/dist/db/queries/backfill-pii.js +55 -29
  109. package/dist/db/queries/ddl.js +13 -2
  110. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  111. package/dist/db/queries/event-store-open-streams.js +33 -0
  112. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  113. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  114. package/dist/db/queries/event-store.js +0 -1
  115. package/dist/db/queries/raw-sql.js +0 -1
  116. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  117. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  118. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  119. package/dist/db/queries/rls-boot-catalog.js +13 -9
  120. package/dist/db/queries/rls-shape.d.ts +3 -1
  121. package/dist/db/queries/rls-shape.js +31 -6
  122. package/dist/db/queries/session-advisory-lock.js +2 -1
  123. package/dist/db/queries/test-stack.js +7 -7
  124. package/dist/db/query.js +16 -11
  125. package/dist/db/rebuild-marker.js +11 -2
  126. package/dist/db/render-rls-ddl.d.ts +2 -0
  127. package/dist/db/render-rls-ddl.js +16 -11
  128. package/dist/db/replay-migration-sql.js +1 -1
  129. package/dist/db/row-level-security-boot-check.js +18 -5
  130. package/dist/db/row-level-security-connection.js +25 -12
  131. package/dist/db/row-level-security-scope.d.ts +2 -1
  132. package/dist/db/row-level-security-scope.js +9 -5
  133. package/dist/db/sql-identifier.d.ts +1 -0
  134. package/dist/db/sql-identifier.js +3 -0
  135. package/dist/db/system-tenant-read-db.d.ts +5 -0
  136. package/dist/db/system-tenant-read-db.js +28 -0
  137. package/dist/db/table-builder.d.ts +3 -1
  138. package/dist/db/table-builder.js +18 -8
  139. package/dist/db/table-info.d.ts +1 -2
  140. package/dist/db/table-introspection.d.ts +3 -0
  141. package/dist/db/table-introspection.js +6 -0
  142. package/dist/db/table-push.d.ts +1 -0
  143. package/dist/db/table-push.js +7 -1
  144. package/dist/db/tenant-db-runner.d.ts +3 -0
  145. package/dist/db/tenant-db-runner.js +19 -1
  146. package/dist/db/transaction-serialization.d.ts +1 -0
  147. package/dist/db/transaction-serialization.js +20 -3
  148. package/dist/db/where-clause.js +11 -2
  149. package/dist/db/write-ownership-failures.d.ts +25 -0
  150. package/dist/db/write-ownership-failures.js +82 -0
  151. package/dist/engine/boot-validator/boot-check.js +7 -1
  152. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  153. package/dist/engine/boot-validator/boot-phases.js +3 -2
  154. package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
  155. package/dist/engine/boot-validator/boot-rules.js +4 -0
  156. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  157. package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
  158. package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
  159. package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
  160. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  161. package/dist/engine/boot-validator/config-deps.js +0 -28
  162. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  163. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  164. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  165. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  166. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  167. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  168. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  169. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  170. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  171. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  172. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  173. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  174. package/dist/engine/boot-validator/entity-list-screens.js +35 -13
  175. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  176. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  177. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  178. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  179. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  180. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  181. package/dist/engine/boot-validator/list-row-guidance.js +143 -0
  182. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  183. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  184. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  185. package/dist/engine/boot-validator/list-sort-summary.js +160 -0
  186. package/dist/engine/boot-validator/list-table-options.js +15 -1
  187. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  188. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  189. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  190. package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
  191. package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
  192. package/dist/engine/boot-validator/named-filter-rules.js +42 -2
  193. package/dist/engine/boot-validator/ownership.js +10 -1
  194. package/dist/engine/boot-validator/parent-ref.js +87 -50
  195. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  196. package/dist/engine/boot-validator/projection-list-screens.js +32 -1
  197. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  198. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  199. package/dist/engine/boot-validator/query-output-guidance.js +40 -0
  200. package/dist/engine/boot-validator/query-refs.js +34 -1
  201. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  202. package/dist/engine/boot-validator/row-decoration.js +16 -0
  203. package/dist/engine/boot-validator/screens-actions.js +1 -1
  204. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  205. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  206. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  207. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  208. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  209. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  210. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  211. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  212. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  213. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  214. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  215. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  216. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  217. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  218. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  219. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  220. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  221. package/dist/engine/boot-validator/screens-lists.js +19 -3
  222. package/dist/engine/boot-validator/screens.js +1 -1
  223. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  224. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  225. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  226. package/dist/engine/boot-validator/zod-shape.js +19 -1
  227. package/dist/engine/build-app-schema.js +4 -0
  228. package/dist/engine/config-helpers.d.ts +1 -2
  229. package/dist/engine/config-helpers.js +6 -7
  230. package/dist/engine/define-feature.js +1 -0
  231. package/dist/engine/define-handler.d.ts +1 -0
  232. package/dist/engine/define-handler.js +4 -2
  233. package/dist/engine/definition-violations.js +2 -2
  234. package/dist/engine/entity-handlers.js +3 -8
  235. package/dist/engine/entity-list-runtime-options.js +9 -8
  236. package/dist/engine/factories.d.ts +2 -0
  237. package/dist/engine/feature-config-events-jobs.js +1 -0
  238. package/dist/engine/feature-entity-handlers.js +5 -2
  239. package/dist/engine/field-access.d.ts +1 -1
  240. package/dist/engine/field-access.js +7 -10
  241. package/dist/engine/find-entity.js +3 -3
  242. package/dist/engine/form-derivations.js +3 -3
  243. package/dist/engine/index.d.ts +3 -3
  244. package/dist/engine/index.js +2 -2
  245. package/dist/engine/named-filter-roles.d.ts +3 -0
  246. package/dist/engine/named-filter-roles.js +15 -0
  247. package/dist/engine/pipeline.js +0 -1
  248. package/dist/engine/project-app-schema-for-roles.js +17 -2
  249. package/dist/engine/qualified-name.js +0 -1
  250. package/dist/engine/registry-facade.js +1 -2
  251. package/dist/engine/registry-state.d.ts +1 -1
  252. package/dist/engine/registry-state.js +5 -2
  253. package/dist/engine/registry-validate.js +2 -1
  254. package/dist/engine/resolve-named-list-filters.js +5 -2
  255. package/dist/engine/schema-builder.js +9 -11
  256. package/dist/engine/screen-helpers.d.ts +12 -0
  257. package/dist/engine/screen-helpers.js +17 -1
  258. package/dist/engine/soft-delete-cleanup.js +3 -5
  259. package/dist/engine/state-machine.js +0 -1
  260. package/dist/engine/steps/_database-clock.d.ts +2 -0
  261. package/dist/engine/steps/_database-clock.js +6 -0
  262. package/dist/engine/steps/compute.js +1 -1
  263. package/dist/engine/steps/retry.js +5 -1
  264. package/dist/engine/steps/return.js +0 -1
  265. package/dist/engine/steps/wait-for-event.js +2 -1
  266. package/dist/engine/steps/wait.js +2 -1
  267. package/dist/engine/system-user.d.ts +2 -2
  268. package/dist/engine/system-user.js +2 -2
  269. package/dist/engine/types/handlers.d.ts +1 -1
  270. package/dist/engine/types/handlers.js +1 -1
  271. package/dist/engine/types/screen.d.ts +1 -1
  272. package/dist/engine/types/screen.js +1 -1
  273. package/dist/engine/webhook-contracts.d.ts +2 -3
  274. package/dist/engine/webhook-contracts.js +2 -25
  275. package/dist/engine/webhook-events.js +48 -29
  276. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  277. package/dist/engine/webhook-payload-strictness.js +53 -0
  278. package/dist/env/_zod-introspect.d.ts +1 -0
  279. package/dist/env/dry-run.d.ts +1 -1
  280. package/dist/env/dry-run.js +1 -1
  281. package/dist/env/field-meta.d.ts +4 -0
  282. package/dist/env/field-meta.js +67 -0
  283. package/dist/env/field-rules.d.ts +9 -0
  284. package/dist/env/field-rules.js +46 -0
  285. package/dist/env/index.d.ts +3 -3
  286. package/dist/env/index.js +16 -71
  287. package/dist/env/internals.d.ts +3 -0
  288. package/dist/env/internals.js +1 -2
  289. package/dist/env/required-env.d.ts +3 -1
  290. package/dist/env/required-env.js +5 -2
  291. package/dist/errors/reasons.d.ts +1 -0
  292. package/dist/errors/reasons.js +4 -0
  293. package/dist/errors/serialize.js +2 -2
  294. package/dist/errors/write-error-info.js +0 -2
  295. package/dist/es-ops/operations-schema.js +18 -7
  296. package/dist/event-store/admin-api.js +3 -3
  297. package/dist/event-store/event-store.js +0 -3
  298. package/dist/event-store/index.d.ts +1 -0
  299. package/dist/event-store/index.js +1 -0
  300. package/dist/event-store/transfer.js +1 -1
  301. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  302. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  303. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  304. package/dist/files/bind-pending-file-refs.js +54 -27
  305. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  306. package/dist/files/create-file-ref.d.ts +4 -1
  307. package/dist/files/create-file-ref.js +14 -3
  308. package/dist/files/default-file-guard.js +4 -1
  309. package/dist/files/file-claim.d.ts +6 -0
  310. package/dist/files/file-claim.js +17 -0
  311. package/dist/files/file-field-slots.d.ts +2 -0
  312. package/dist/files/file-field-slots.js +28 -0
  313. package/dist/files/file-ref-entity.d.ts +3 -0
  314. package/dist/files/file-ref-entity.js +2 -0
  315. package/dist/files/file-ref-table.d.ts +3 -0
  316. package/dist/files/file-routes.d.ts +4 -1
  317. package/dist/files/file-routes.js +80 -16
  318. package/dist/files/in-memory-provider.d.ts +1 -1
  319. package/dist/files/in-memory-provider.js +2 -1
  320. package/dist/files/index.d.ts +1 -1
  321. package/dist/files/index.js +1 -1
  322. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  323. package/dist/files/invalid-file-ref-error.js +15 -0
  324. package/dist/files/local-provider.js +9 -2
  325. package/dist/files/provider-resolver.js +1 -1
  326. package/dist/files/rebind-file-ref.d.ts +3 -2
  327. package/dist/files/rebind-file-ref.js +24 -18
  328. package/dist/files/resolve-file-handles.d.ts +13 -0
  329. package/dist/files/resolve-file-handles.js +57 -0
  330. package/dist/files/storage-tracking.d.ts +1 -1
  331. package/dist/files/storage-tracking.js +5 -2
  332. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  333. package/dist/files/types.d.ts +4 -0
  334. package/dist/files/types.js +10 -0
  335. package/dist/files/upload-field-resolution.d.ts +1 -0
  336. package/dist/files/upload-field-resolution.js +16 -2
  337. package/dist/files/upload-ledger.js +1 -1
  338. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  339. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  340. package/dist/i18n/required-surface-keys.js +21 -5
  341. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  342. package/dist/internal/boot-rule-table-expectations.js +29 -0
  343. package/dist/internal/row-level-security.d.ts +1 -0
  344. package/dist/internal/row-level-security.js +1 -0
  345. package/dist/internal/testing.d.ts +1 -0
  346. package/dist/internal/testing.js +1 -0
  347. package/dist/jobs/index.d.ts +1 -0
  348. package/dist/jobs/index.js +1 -0
  349. package/dist/jobs/job-load-events.d.ts +10 -0
  350. package/dist/jobs/job-load-events.js +12 -0
  351. package/dist/jobs/job-runner-context.js +6 -158
  352. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  353. package/dist/jobs/job-runner-dispatch.js +57 -0
  354. package/dist/jobs/job-runner-event-triggers.js +18 -9
  355. package/dist/jobs/job-runner-execution.js +5 -2
  356. package/dist/jobs/job-runner-facets.d.ts +48 -0
  357. package/dist/jobs/job-runner-facets.js +156 -0
  358. package/dist/jobs/job-runner-gates.js +19 -11
  359. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  360. package/dist/jobs/job-runner-helpers.js +18 -3
  361. package/dist/jobs/job-runner-scope.d.ts +1 -0
  362. package/dist/jobs/job-runner-scope.js +2 -0
  363. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  364. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  365. package/dist/jobs/job-runner-types.d.ts +1 -0
  366. package/dist/jobs/job-runner.js +39 -70
  367. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  368. package/dist/jobs/obliterate-job-queues.js +23 -0
  369. package/dist/lifecycle/lifecycle.js +1 -1
  370. package/dist/migrations/event-header-scrub.d.ts +11 -0
  371. package/dist/migrations/event-header-scrub.js +33 -0
  372. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  373. package/dist/migrations/event-payload-scrub.js +36 -4
  374. package/dist/migrations/index.d.ts +1 -0
  375. package/dist/migrations/index.js +2 -0
  376. package/dist/migrations/kumiko-drift.d.ts +5 -2
  377. package/dist/migrations/kumiko-drift.js +51 -14
  378. package/dist/migrations/pending-rebuilds.js +4 -5
  379. package/dist/observability/sensitive-filter.js +0 -12
  380. package/dist/pipeline/aggregate-type-removal.js +17 -4
  381. package/dist/pipeline/context-services.d.ts +2 -0
  382. package/dist/pipeline/context-services.js +5 -2
  383. package/dist/pipeline/dispatch-batch.js +4 -3
  384. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  385. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  386. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  387. package/dist/pipeline/dispatch-nested-write.js +119 -0
  388. package/dist/pipeline/dispatch-query.js +10 -3
  389. package/dist/pipeline/dispatch-scope.js +4 -3
  390. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  391. package/dist/pipeline/dispatch-shared.js +6 -38
  392. package/dist/pipeline/dispatch-write.d.ts +0 -1
  393. package/dist/pipeline/dispatch-write.js +3 -302
  394. package/dist/pipeline/dispatcher-utils.js +6 -0
  395. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  396. package/dist/pipeline/effective-system-scope.js +22 -0
  397. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  398. package/dist/pipeline/event-dispatcher-delivery.js +20 -9
  399. package/dist/pipeline/event-dispatcher.d.ts +6 -1
  400. package/dist/pipeline/event-dispatcher.js +6 -7
  401. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  402. package/dist/pipeline/handler-context-auth.js +3 -4
  403. package/dist/pipeline/handler-context-db.js +11 -4
  404. package/dist/pipeline/handler-context-dispatch.js +2 -2
  405. package/dist/pipeline/handler-context-events.d.ts +8 -3
  406. package/dist/pipeline/handler-context-events.js +20 -65
  407. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  408. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  409. package/dist/pipeline/handler-context-notify.js +2 -0
  410. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  411. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  412. package/dist/pipeline/handler-context-projection.js +39 -0
  413. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  414. package/dist/pipeline/handler-context-scope.js +14 -2
  415. package/dist/pipeline/index.d.ts +1 -1
  416. package/dist/pipeline/index.js +1 -1
  417. package/dist/pipeline/irreversible-operation-gate.js +36 -10
  418. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  419. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  420. package/dist/pipeline/member-reader.js +4 -2
  421. package/dist/pipeline/msp-rebuild.js +1 -1
  422. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  423. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  424. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  425. package/dist/pipeline/projection-rebuild.js +16 -7
  426. package/dist/pipeline/projection-state.js +4 -6
  427. package/dist/pipeline/system-hooks.js +36 -6
  428. package/dist/pipeline/write-result-masking.js +31 -3
  429. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  430. package/dist/pipeline/write-transition-guard.js +95 -0
  431. package/dist/schema-cli/shared.d.ts +2 -0
  432. package/dist/schema-cli/shared.js +4 -2
  433. package/dist/schema-cli/validate-command.js +43 -28
  434. package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
  435. package/dist/search/meilisearch-adapter-internals.js +5 -0
  436. package/dist/search/meilisearch-adapter.d.ts +1 -0
  437. package/dist/search/meilisearch-adapter.js +17 -11
  438. package/dist/search/reindex-entity.d.ts +2 -0
  439. package/dist/search/reindex-entity.js +32 -4
  440. package/dist/search/reindex-tenants-search.js +20 -4
  441. package/dist/time/tz-context.js +1 -1
  442. package/dist/ui-types/card-column-roles.d.ts +6 -0
  443. package/dist/ui-types/card-column-roles.js +21 -3
  444. package/dist/ui-types/index.d.ts +3 -3
  445. package/dist/ui-types/index.js +2 -2
  446. package/dist/utils/ids.js +0 -1
  447. package/dist/utils/index.d.ts +1 -0
  448. package/dist/utils/index.js +1 -0
  449. package/dist/utils/return-path-limit.d.ts +1 -0
  450. package/dist/utils/return-path-limit.js +1 -0
  451. package/package.json +5 -3
  452. package/presets/biome-app.json +39 -21
  453. package/presets/biome-plugins/admin-api.grit +10 -0
  454. package/presets/biome-plugins/error-reasons.grit +53 -0
  455. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  456. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  457. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  458. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  459. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  460. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  461. package/presets/biome-plugins/no-date-api.grit +11 -0
  462. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  463. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  464. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  465. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  466. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  467. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  468. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  469. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  470. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  471. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  472. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  473. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  474. package/presets/biome-plugins/test-title.grit +20 -0
  475. package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
  476. package/presets/biome-rules.json +467 -0
  477. package/src/changes.json +366 -0
  478. package/dist/engine/minor-units.d.ts +0 -2
  479. package/dist/engine/minor-units.js +0 -8
@@ -32,8 +32,8 @@ export function runDefinitionStep(feature, check, step) {
32
32
  }
33
33
  catch (thrown) {
34
34
  if (isRuntimeCrash(thrown)) {
35
- // Follow-up of an earlier violation (a failed step returned undefined); without one it is a real bug.
36
- if (collector.length === 0)
35
+ // Follow-up of an earlier violation of this feature (a failed step returned undefined); without one it is a real bug.
36
+ if (!collector.some((violation) => violation.feature === feature))
37
37
  throw thrown;
38
38
  return undefined;
39
39
  }
@@ -1,5 +1,5 @@
1
1
  import { isSqlDerivedField, } from "@cosmicdrift/kumiko-types/fields";
2
- import { ENTITY_CONVENTION_QUERY_BRAND } from "@cosmicdrift/kumiko-types/handlers";
2
+ import { ENTITY_CONVENTION_QUERY_BRAND, ENTITY_CONVENTION_WRITE_BRAND, } from "@cosmicdrift/kumiko-types/handlers";
3
3
  import { listAggregatePayloadSchema, } from "@cosmicdrift/kumiko-types/list-aggregate-types";
4
4
  import * as z from "zod";
5
5
  import { collectReferenceFields, enrichRowWithReferences, enrichWithReferences, } from "../db/eagerload.js";
@@ -357,6 +357,7 @@ export function defineEntityWriteHandler(name, entity, options) {
357
357
  name,
358
358
  schema,
359
359
  handler,
360
+ [ENTITY_CONVENTION_WRITE_BRAND]: true,
360
361
  access: options.access,
361
362
  ...(options.description !== undefined && { description: options.description }),
362
363
  ...(agentHints !== undefined && { agent: agentHints }),
@@ -502,27 +503,21 @@ export function defineEntityQueryHandler(name, entity, options) {
502
503
  // runtime that entity.softDelete === true. A compile-time-only check
503
504
  // would need a Branded-EntityDefinition with `softDelete: true` literal
504
505
  // — feasible but not yet wired; the runtime guard catches misuse.
505
- // @wrapper-known semantic-alias
506
506
  export function defineEntityCreateHandler(entityName, entity, options) {
507
507
  return defineEntityWriteHandler(`${entityName}:create`, entity, options);
508
508
  }
509
- // @wrapper-known semantic-alias
510
509
  export function defineEntityUpdateHandler(entityName, entity, options) {
511
510
  return defineEntityWriteHandler(`${entityName}:update`, entity, options);
512
511
  }
513
- // @wrapper-known semantic-alias
514
512
  export function defineEntityDeleteHandler(entityName, entity, options) {
515
513
  return defineEntityWriteHandler(`${entityName}:delete`, entity, options);
516
514
  }
517
- // @wrapper-known semantic-alias
518
515
  export function defineEntityRestoreHandler(entityName, entity, options) {
519
516
  return defineEntityWriteHandler(`${entityName}:restore`, entity, options);
520
517
  }
521
- // @wrapper-known semantic-alias
522
518
  export function defineEntityListHandler(entityName, entity, options) {
523
519
  return defineEntityQueryHandler(`${entityName}:list`, entity, options);
524
520
  }
525
- // @wrapper-known semantic-alias
526
521
  export function defineEntityDetailHandler(entityName, entity, options) {
527
522
  return defineEntityQueryHandler(`${entityName}:detail`, entity, options);
528
523
  }
@@ -568,7 +563,7 @@ export function defineProjectionQueryHandler(name, projectionQualifiedName, opti
568
563
  // helper is a drop-in for the inline `async (_q, ctx) => ctx.dispatch.queryProjection(...)`
569
564
  // handler. Wrap the result in the caller's handler when you need
570
565
  // pagination envelopes or added metadata.
571
- handler: async (_query, ctx) => ctx.dispatch.queryProjection(projectionQualifiedName, options.unsafeAllTenants ? { unsafeAllTenants: true } : undefined), // @wrapper-known semantic-alias
566
+ handler: async (_query, ctx) => ctx.dispatch.queryProjection(projectionQualifiedName, options.unsafeAllTenants ? { unsafeAllTenants: true } : undefined),
572
567
  access: options.access,
573
568
  ...(escapeHatch && { escapeHatch }),
574
569
  };
@@ -1,4 +1,4 @@
1
- import { collectEntityDetailAccess, collectEntityReadAccess } from "../api/entity-read-access.js";
1
+ import { collectEntityDetailAccess, collectEntityQueryAccess } from "../api/entity-read-access.js";
2
2
  import { resolveTableName } from "../db/entity-table-meta.js";
3
3
  import { labelListAggregateGroups } from "../db/list-aggregate-labels.js";
4
4
  import { buildEntityTable } from "../db/table-builder.js";
@@ -18,12 +18,15 @@ function memoizePerRegistry(collect) {
18
18
  };
19
19
  }
20
20
  const detailAccessOf = memoizePerRegistry(collectEntityDetailAccess);
21
- const readAccessOf = memoizePerRegistry(collectEntityReadAccess);
21
+ const queryAccessOf = memoizePerRegistry(collectEntityQueryAccess);
22
22
  // An entity with a backingTable is read from that table; the implicit projection holds it.
23
- function readTableOf(ctx, entityName, entity) {
24
- const implicit = ctx.registry
23
+ function implicitProjectionOf(ctx, entityName) {
24
+ return ctx.registry
25
25
  .getProjectionsForSource(entityName)
26
26
  .find((projection) => projection.name.endsWith(`:projection:${entityName}${IMPLICIT_PROJECTION_SUFFIX}`));
27
+ }
28
+ function readTableOf(ctx, entityName, entity) {
29
+ const implicit = implicitProjectionOf(ctx, entityName);
27
30
  return implicit?.table ?? buildEntityTable(entityName, entity);
28
31
  }
29
32
  const readModelOwnersOf = memoizePerRegistry((registry) => {
@@ -66,7 +69,7 @@ export function entityListRuntime(ctx, entityName, user) {
66
69
  const parentVisibility = parentVisibilityFor(ctx, user);
67
70
  const resolveEntity = (name) => ctx.registry.getEntity(name);
68
71
  const resolveTable = readTableResolver(ctx, "entityListRuntime");
69
- const readRules = readAccessOf(ctx.registry);
72
+ const readRules = queryAccessOf(ctx.registry);
70
73
  return {
71
74
  runtimeOptions: {
72
75
  ...(ctx.services.searchAdapter !== undefined && {
@@ -100,9 +103,7 @@ export function entityListRuntime(ctx, entityName, user) {
100
103
  // An entity with a backingTable reads and writes that table, whose name the entity's own
101
104
  // `table` does not say; the implicit projection holds the table the executor really uses.
102
105
  function physicalReadTableName(ctx, entityName, entity) {
103
- const implicit = ctx.registry
104
- .getProjectionsForSource(entityName)
105
- .find((projection) => projection.name.endsWith(`:projection:${entityName}${IMPLICIT_PROJECTION_SUFFIX}`));
106
+ const implicit = implicitProjectionOf(ctx, entityName);
106
107
  return implicit !== undefined
107
108
  ? extractTableInfo(implicit.table).name
108
109
  : resolveTableName(entityName, entity, undefined);
@@ -192,6 +192,8 @@ export declare function createEntity<const F, const T extends EntityTenancy = "t
192
192
  /** Event stream lives on SYSTEM_TENANT_ID (tenant-independent aggregate, e.g.
193
193
  * user) instead of the creator's tenant. See EntityDefinition.systemStream. */
194
194
  readonly systemStream?: boolean;
195
+ /** See EntityDefinition.systemRowsReadable. */
196
+ readonly systemRowsReadable?: boolean;
195
197
  /** See EntityDefinition.webhookEvents. */
196
198
  readonly webhookEvents?: boolean;
197
199
  readonly eventVersion?: number;
@@ -214,6 +214,7 @@ export function buildConfigEventsJobsMethods(state, name) {
214
214
  }
215
215
  state.metrics[shortName] = { shortName, ...metricOptions };
216
216
  },
217
+ // guard:dup-ok builder setter shape, sharing would add a parameter per line
217
218
  envSchema(schema) {
218
219
  if (state.envSchema !== undefined) {
219
220
  throw bootRuleError(DEFINITION_CONFIG_EVENTS_JOBS_RULES.envSchemaTwice, {
@@ -1,9 +1,9 @@
1
- import { ENTITY_CONVENTION_QUERY_BRAND } from "@cosmicdrift/kumiko-types/handlers";
1
+ import { ENTITY_CONVENTION_QUERY_BRAND, ENTITY_CONVENTION_WRITE_BRAND, } from "@cosmicdrift/kumiko-types/handlers";
2
2
  import { toTableName } from "../db/table-builder.js";
3
3
  import { bootRuleError } from "./boot-validator/boot-rule.js";
4
4
  import { DEFINITION_HANDLER_RULES } from "./boot-validator/definition-handlers-rules.js";
5
5
  import { HANDLER_ACCESS_RULES } from "./boot-validator/entity-handler-access-rules.js";
6
- import { isEntityConventionQueryHandler, isPagedQueryHandler, PAGED_QUERY_HANDLER_BRAND, } from "./define-handler.js";
6
+ import { isEntityConventionQueryHandler, isEntityConventionWriteHandler, isPagedQueryHandler, PAGED_QUERY_HANDLER_BRAND, } from "./define-handler.js";
7
7
  import { assertEscapeHatchAccessIsSystemAdminOnly, registerCrudHandlers, } from "./entity-handlers.js";
8
8
  import { agentSlots, transactionPhaseSlots } from "./handler-definition-slots.js";
9
9
  import { resolveName } from "./handler-helpers.js";
@@ -119,6 +119,9 @@ export function buildEntityHandlerMethods(state, name) {
119
119
  handler: def.handler,
120
120
  access: def.access,
121
121
  ...agentSlots(def),
122
+ ...(isEntityConventionWriteHandler(def) && {
123
+ [ENTITY_CONVENTION_WRITE_BRAND]: true,
124
+ }),
122
125
  ...(def.excludedFields && { excludedFields: def.excludedFields }),
123
126
  ...(def.unsafeSkipTransitionGuard && { unsafeSkipTransitionGuard: true }),
124
127
  ...(def.rateLimit && { rateLimit: def.rateLimit }),
@@ -6,5 +6,5 @@ export declare function dropEmptyWriteOnlyValues<T extends Readonly<Record<strin
6
6
  export declare function userMayReadFieldInBulk(entity: EntityDefinition, fieldName: string, user: Pick<SessionUser, "roles">): boolean;
7
7
  export declare function filterReadFields(entity: EntityDefinition, data: Readonly<Record<string, unknown>>, user: SessionUser): Record<string, unknown>;
8
8
  export declare function checkWriteFieldRoles(entity: EntityDefinition, changes: Readonly<Record<string, unknown>>, user: SessionUser): string | null;
9
- export declare function checkWriteFieldOwnership(entity: EntityDefinition, submittedChanges: Readonly<Record<string, unknown>>, user: SessionUser, oldRow?: Readonly<Record<string, unknown>>, rowContext?: Readonly<Record<string, unknown>>): string | null;
9
+ export declare function checkWriteFieldOwnership(entity: EntityDefinition, submittedChanges: Readonly<Record<string, unknown>>, user: SessionUser, oldRow?: Readonly<Record<string, unknown>>, rowContext?: Readonly<Record<string, unknown>>, checkEmbeddedSubFields?: boolean): string | null;
10
10
  export declare function userHasWriteRole(user: Pick<SessionUser, "roles">, accessMap: OwnershipMap): boolean;
@@ -1,4 +1,5 @@
1
1
  import { normalizeAccessEntry, userCanReadFieldRow, userCanWriteFieldRow, } from "./ownership.js";
2
+ import { isUnchangedValue } from "./screen-helpers.js";
2
3
  function writeOnlyFieldNames(entity) {
3
4
  const names = [];
4
5
  for (const [name, field] of Object.entries(entity.fields)) {
@@ -145,12 +146,15 @@ export function checkWriteFieldRoles(entity, changes, user) {
145
146
  //
146
147
  // Returns the denied field name for the caller to wrap into an
147
148
  // `ownership_denied` error with scope: "field", or null if all fields pass.
148
- export function checkWriteFieldOwnership(entity, submittedChanges, user, oldRow, rowContext = submittedChanges) {
149
+ export function checkWriteFieldOwnership(entity, submittedChanges, user, oldRow, rowContext = submittedChanges,
150
+ // Off for the nested-write parent check: it asserts ownership of an existing row, nothing is
151
+ // being written to its embedded sub-fields.
152
+ checkEmbeddedSubFields = true) {
149
153
  for (const key of Object.keys(submittedChanges)) {
150
154
  const field = entity.fields[key];
151
155
  if (!field)
152
156
  continue;
153
- if (field.type === "embedded") {
157
+ if (field.type === "embedded" && checkEmbeddedSubFields) {
154
158
  const deniedSubField = deniedEmbeddedSubField(field, submittedChanges[key], oldRow?.[key], user);
155
159
  if (deniedSubField)
156
160
  return `${key}.${deniedSubField}`;
@@ -185,13 +189,6 @@ function embeddedRows(value) {
185
189
  return value.map((row) => (isRecord(row) ? row : undefined));
186
190
  return isRecord(value) ? [value] : [];
187
191
  }
188
- function stableJson(value) {
189
- return JSON.stringify(value, (_key, nested) => {
190
- if (!nested || typeof nested !== "object" || Array.isArray(nested))
191
- return nested;
192
- return Object.fromEntries(Object.entries(nested).sort(([a], [b]) => a.localeCompare(b)));
193
- });
194
- }
195
192
  // Sub-field write rules of an embedded field, enforced on save. Rows are paired by index;
196
193
  // a sub-field counts as written when its value differs between old and new row (an added or
197
194
  // removed row that carries a value counts too). The rule is evaluated against the embedded
@@ -206,7 +203,7 @@ function deniedEmbeddedSubField(field, newValue, oldValue, user) {
206
203
  for (let i = 0; i < Math.max(newRows.length, oldRows.length); i++) {
207
204
  const newRow = newRows[i];
208
205
  const oldRow = oldRows[i];
209
- if (stableJson(newRow?.[subKey]) === stableJson(oldRow?.[subKey]))
206
+ if (isUnchangedValue(newRow?.[subKey], oldRow?.[subKey]))
210
207
  continue;
211
208
  const rowAfter = newRow ?? oldRow ?? {};
212
209
  if (!userCanWriteFieldRow(user, accessMap, oldRow ?? rowAfter, rowAfter))
@@ -1,8 +1,8 @@
1
1
  export function findEntity(features, entityName) {
2
2
  for (const feature of features.values()) {
3
- const entity = feature.entities?.[entityName];
4
- if (entity)
5
- return entity;
3
+ const entities = feature.entities;
4
+ if (entities && Object.hasOwn(entities, entityName))
5
+ return entities[entityName];
6
6
  }
7
7
  return undefined;
8
8
  }
@@ -1,6 +1,6 @@
1
+ import { toMajorUnits, toMinorUnits } from "@cosmicdrift/kumiko-types/minor-units";
1
2
  import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
2
3
  import { computeDerivedCellValue, roundDerivedCellValue, withDerivedCells, } from "./embedded-derived.js";
3
- import { MINOR_UNIT_SCALE, toMinorUnits } from "./minor-units.js";
4
4
  function readMoneyOperand(raw) {
5
5
  if (typeof raw === "number")
6
6
  return { minor: toMinorUnits(raw), currency: undefined };
@@ -172,8 +172,8 @@ export function applyFormDerivations(values, screen) {
172
172
  const currency = targetCurrency(targetField, result[target], sourceCurrency);
173
173
  result[target] =
174
174
  currency === undefined
175
- ? { amount: minor / MINOR_UNIT_SCALE }
176
- : { amount: minor / MINOR_UNIT_SCALE, currency };
175
+ ? { amount: toMajorUnits(minor) }
176
+ : { amount: toMajorUnits(minor), currency };
177
177
  }
178
178
  else if (targetField.type === "decimal") {
179
179
  result[target] = roundDerivedCellValue(computed, targetField);
@@ -6,7 +6,7 @@ export type { ExtensionOptionsArgs, ExtensionOptionsFor, KumikoExtensionOptionsM
6
6
  export type { BootOptionName, SecretKeyDefinition, SecretKeyHandle, SecretNamespaceDefinition, SecretNamespaceHandle, SecretNamespaceOptions, WebhookEntityVerb, WebhookEventContract, WebhookEventHandle, } from "@cosmicdrift/kumiko-types/feature";
7
7
  export type { FeatureRegistrar } from "@cosmicdrift/kumiko-types/feature-registrar";
8
8
  export type { DeriveContext, EntityDefinition, FieldDefinition, JsonbFieldDef, ResolvedPiiFlags, RetentionDef, } from "@cosmicdrift/kumiko-types/fields";
9
- export type { AccessRule, AgentEffect, AgentHandlerHints, AgentRisk, AuthClaimsContext, BeforeTransactionResult, ChatSendFailureCode, ClaimKeyType, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchUseEvent, EventDef, JobContext, JobDeferral, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, QueryHandlerDef, RateLimitPer, RoleAccessPersonalData, RoleAccessRule, StreamHandlerDef, TenantWriteTarget, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "@cosmicdrift/kumiko-types/handlers";
9
+ export type { AccessRule, AgentEffect, AgentHandlerHints, AgentRisk, AuthClaimsContext, BeforeTransactionResult, ChatSendFailureCode, ClaimKeyType, DeliveryAttemptLogEntry, DeliveryAttemptLogFactory, DeliveryAttemptLogFn, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchUseEvent, EventDef, JobContext, JobDeferral, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, QueryHandlerDef, RateLimitPer, RoleAccessPersonalData, RoleAccessRule, StreamHandlerDef, TenantWriteTarget, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "@cosmicdrift/kumiko-types/handlers";
10
10
  export { DELIVERY_FAILURE_CODES, DELIVERY_SKIP_REASONS, HTTP_ERROR_CODE_PATTERN, isDeliveryErrorCode, isOpenToAllGranted, } from "@cosmicdrift/kumiko-types/handlers";
11
11
  export type { DeleteContext, PostDeleteHookFn, PostSaveHookFn, PreDeleteHookFn, PreSaveHookFn, SaveContext, ValidationError, ValidationHookFn, } from "@cosmicdrift/kumiko-types/hooks";
12
12
  export type { EntityId } from "@cosmicdrift/kumiko-types/identifiers";
@@ -87,7 +87,7 @@ export type { AssignableAppRoles } from "./role-assignment.ts";
87
87
  export { assignableAppRolesFromUsages, assignableAppRolesOf, BUILT_IN_MEMBERSHIP_ROLES, canActorAssignRole, findForbiddenRoleAssignment, isAssignableByRole, mergeAssignedRoles, } from "./role-assignment.ts";
88
88
  export { runPipeline, runStepList } from "./run-pipeline.ts";
89
89
  export { buildInsertSchema, buildUpdateSchema, fieldToZod, SYSTEM_ONLY_JSON_SCHEMA_KEY, } from "./schema-builder.ts";
90
- export { isFieldsEditSection, normalizeEditField, normalizeListColumn, sectionFieldSpecs, } from "./screen-helpers.ts";
90
+ export { isFieldsEditSection, isUnchangedValue, normalizeEditField, normalizeListColumn, screenShortId, sectionFieldSpecs, } from "./screen-helpers.ts";
91
91
  export { DEFAULT_GRACE_DAYS as SOFT_DELETE_DEFAULT_GRACE_DAYS, readSoftDeleteGraceDays, SOFT_DELETE_GRACE_DAYS_KEY, } from "./soft-delete-cleanup.ts";
92
92
  export type { TransitionGraph } from "./state-machine.ts";
93
93
  export { defineTransitions, guardTransition } from "./state-machine.ts";
@@ -104,6 +104,6 @@ export { isSystemTenant, isUuid, parseTenantId, SYSTEM_TENANT_ID } from "./types
104
104
  export type { AppContext, BeforeTransactionContext, FeatureDefinition, HandlerAuth, HandlerContext, HandlerDb, HandlerDispatch, HandlerEvents, HandlerObservability, JobDispatch, JobEvents, JobObservability, QueryEvent, Registry, ReservationContext, SessionUser, TenantId, } from "./types/index.ts";
105
105
  export type { AwaitedEventType, PipelineCtx, StepInstance, StepResolver, } from "./types/step.ts";
106
106
  export { walkStepInstances } from "./walk-step-instances.ts";
107
- export { createWebhookContractResolver, type WebhookContractResolver, } from "./webhook-contracts.ts";
107
+ export { createWebhookContractResolver, WEBHOOK_ENTITY_VERBS, type WebhookContractResolver, } from "./webhook-contracts.ts";
108
108
  export { formatWebhookPayloadIssues, parseWebhookPayload, toEntityWebhookPayload, type WebhookPayloadIssue, type WebhookPayloadResult, } from "./webhook-events.ts";
109
109
  export { withFormDerivations } from "./with-form-derivations.ts";
@@ -70,7 +70,7 @@ export { resolveNamedListFilters } from "./resolve-named-list-filters.js";
70
70
  export { assignableAppRolesFromUsages, assignableAppRolesOf, BUILT_IN_MEMBERSHIP_ROLES, canActorAssignRole, findForbiddenRoleAssignment, isAssignableByRole, mergeAssignedRoles, } from "./role-assignment.js";
71
71
  export { runPipeline, runStepList } from "./run-pipeline.js";
72
72
  export { buildInsertSchema, buildUpdateSchema, fieldToZod, SYSTEM_ONLY_JSON_SCHEMA_KEY, } from "./schema-builder.js";
73
- export { isFieldsEditSection, normalizeEditField, normalizeListColumn, sectionFieldSpecs, } from "./screen-helpers.js";
73
+ export { isFieldsEditSection, isUnchangedValue, normalizeEditField, normalizeListColumn, screenShortId, sectionFieldSpecs, } from "./screen-helpers.js";
74
74
  export { DEFAULT_GRACE_DAYS as SOFT_DELETE_DEFAULT_GRACE_DAYS, readSoftDeleteGraceDays, SOFT_DELETE_GRACE_DAYS_KEY, } from "./soft-delete-cleanup.js";
75
75
  export { defineTransitions, guardTransition } from "./state-machine.js";
76
76
  export { evaluateEventMatch } from "./steps/_event-match.js";
@@ -84,6 +84,6 @@ export { findTierResolverUsage, isTierResolverPlugin, requireTierResolverPlugin,
84
84
  export { findOverDeepTransferChain, resolveTransferAdjacency as resolveEntityTransferAdjacency, } from "./transfer-adjacency.js";
85
85
  export { isSystemTenant, isUuid, parseTenantId, SYSTEM_TENANT_ID } from "./types/identifiers.js";
86
86
  export { walkStepInstances } from "./walk-step-instances.js";
87
- export { createWebhookContractResolver, } from "./webhook-contracts.js";
87
+ export { createWebhookContractResolver, WEBHOOK_ENTITY_VERBS, } from "./webhook-contracts.js";
88
88
  export { formatWebhookPayloadIssues, parseWebhookPayload, toEntityWebhookPayload, } from "./webhook-events.js";
89
89
  export { withFormDerivations } from "./with-form-derivations.js";
@@ -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,15 @@
1
+ // `access` on a ref is framework-owned: an authored value is dropped so a screen cannot widen the
2
+ // entity filter's access rule on the client. A rule is plain data (roles, openToAll), safe to serialize.
3
+ function refWithEntityAccess(ref, defs) {
4
+ const { access: _authored, ...plain } = ref;
5
+ const def = Object.hasOwn(defs, ref.id) ? defs[ref.id] : undefined;
6
+ return def?.access === undefined ? plain : { ...plain, access: def.access };
7
+ }
8
+ export function projectNamedFilterRoles(screen, defs) {
9
+ if (screen.namedFilters === undefined)
10
+ return screen;
11
+ return {
12
+ ...screen,
13
+ namedFilters: screen.namedFilters.map((ref) => refWithEntityAccess(ref, defs ?? {})),
14
+ };
15
+ }
@@ -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);
@@ -351,7 +347,9 @@ export function fieldToZod(field, currencies, opts = {}) {
351
347
  // validator's; checking it here would require a database round trip during
352
348
  // parsing.
353
349
  // Multi-mode accepts an array of UUIDs.
354
- return field.multiple === true ? z.array(z.uuid()) : z.uuid();
350
+ return field.multiple === true
351
+ ? z.array(z.uuid().meta({ references: field.entity }))
352
+ : z.uuid().meta({ references: field.entity });
355
353
  default:
356
354
  assertUnreachable(field, "field type");
357
355
  }
@@ -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()) {
@@ -171,6 +167,7 @@ export function buildSoftDeleteCleanupJob() {
171
167
  includeSystemTenant: true,
172
168
  concurrency: "skip",
173
169
  runIn: "worker",
170
+ irreversibleWithoutEntryHandler: "high-risk-or-cron-pipeline",
174
171
  };
175
172
  }
176
173
  export function buildSoftDeleteCleanupSystemJob() {
@@ -180,6 +177,7 @@ export function buildSoftDeleteCleanupSystemJob() {
180
177
  trigger: { maintenance: true },
181
178
  concurrency: "skip",
182
179
  runIn: "worker",
180
+ irreversibleWithoutEntryHandler: "high-risk-or-cron-pipeline",
183
181
  escapeHatch: {
184
182
  reason: "hard-deletes expired soft-deleted rows of global entities (e.g. user) once, system-wide",
185
183
  grants: ["unsafeRaw"],
@@ -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
+ }