@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
@@ -69,6 +69,31 @@ export const SCREEN_KIND_RULES = {
69
69
  summary: "createScreen resolves to a registered screen in the same feature.",
70
70
  fix: "Point createScreen at a screen of this feature.",
71
71
  },
72
+ createPlacementWithoutCreate: {
73
+ id: "entity-list/create-placement-without-create",
74
+ summary: 'createPlacement "toolbar" moves the create button, so the list has one (no allowCreate: false).',
75
+ fix: "Remove createPlacement or drop allowCreate: false.",
76
+ },
77
+ toolbarSortWithoutSortOptions: {
78
+ id: "entity-list/toolbar-sort-without-sort-options",
79
+ summary: "toolbarSort draws the sortOptions as a select in the filter row, so it needs sortOptions.",
80
+ fix: "Declare sortOptions or remove toolbarSort.",
81
+ },
82
+ narrowFacetsInvalid: {
83
+ id: "list/narrow-facets-invalid",
84
+ summary: 'narrowFacets is "pills".',
85
+ fix: 'Use "pills", or remove narrowFacets.',
86
+ },
87
+ toolbarActionsPlacementInvalid: {
88
+ id: "list/toolbar-actions-placement-invalid",
89
+ summary: 'toolbarActionsPlacement is "header" or "toolbar".',
90
+ fix: 'Use "header" or "toolbar", or remove toolbarActionsPlacement.',
91
+ },
92
+ toolbarActionsPlacementWithoutActions: {
93
+ id: "list/toolbar-actions-placement-without-actions",
94
+ summary: 'toolbarActionsPlacement "toolbar" moves the toolbarActions, so the list declares some.',
95
+ fix: "Declare toolbarActions or remove toolbarActionsPlacement.",
96
+ },
72
97
  configEditFieldsEmpty: {
73
98
  id: "config-edit/fields-empty",
74
99
  summary: "A configEdit screen declares at least one field.",
@@ -1,6 +1,7 @@
1
1
  import type { FeatureDefinition } from "../types/index.ts";
2
2
  import type { EditRelatedListSection, ListColumnSpec, ListFacetSpec, RowAction, ScreenDefinition } from "../types/screen.ts";
3
3
  import type { NavigateSourceScreenType, NavigateTargetLookups } from "./screens-actions.ts";
4
+ import { resolveRowActionNavigateTarget } from "./screens-actions.ts";
4
5
  export declare function validateExplicitListScreenExists(featureName: string, screenId: string, screen: ScreenDefinition, screensByShortId: ReadonlyMap<string, unknown>): void;
5
6
  export declare function validateScreenHasNavArea(feature: FeatureDefinition, screenId: string, screen: ScreenDefinition, featureMap: ReadonlyMap<string, FeatureDefinition>): void;
6
7
  type RelatedListSectionValidation = {
@@ -33,8 +34,11 @@ export type ListActionTargetContext = NavigateTargetLookups & {
33
34
  readonly screens: FeatureDefinition["screens"];
34
35
  readonly allWriteHandlerQns: ReadonlySet<string>;
35
36
  };
36
- export declare function validateListActionTargets(ctx: ListActionTargetContext, actionLabel: "rowAction" | "emptyState action", action: RowAction): void;
37
- export declare function validateRowActionTarget(ctx: ListActionTargetContext, actionLabel: "rowAction" | "emptyState action" | "action", paramsLabel: "rowAction" | "emptyState action", action: RowAction): void;
37
+ type NavigateTargetCheck = (action: Extract<RowAction, {
38
+ readonly kind: "navigate";
39
+ }>, target: ReturnType<typeof resolveRowActionNavigateTarget>) => void;
40
+ export declare function validateListActionTargets(ctx: ListActionTargetContext, actionLabel: "rowAction" | "emptyState action", action: RowAction, onNavigateTarget?: NavigateTargetCheck): void;
41
+ export declare function validateRowActionTarget(ctx: ListActionTargetContext, actionLabel: "rowAction" | "emptyState action" | "action", paramsLabel: "rowAction" | "emptyState action", action: RowAction, onNavigateTarget?: NavigateTargetCheck): void;
38
42
  export declare function rejectInertColumnSortable(featureName: string, screenId: string, screenType: "entityList" | "projectionList", column: {
39
43
  readonly field: string;
40
44
  readonly sortable?: boolean;
@@ -42,6 +46,8 @@ export declare function rejectInertColumnSortable(featureName: string, screenId:
42
46
  export declare function validateColumnRendererForm(featureName: string, screenId: string, column: {
43
47
  readonly field: string;
44
48
  readonly renderer?: unknown;
49
+ readonly linkScreenField?: string;
50
+ readonly linkParamsField?: string;
45
51
  }): void;
46
52
  export declare function validateEnumOptionTones(prefix: string, column: {
47
53
  readonly field: string;
@@ -7,6 +7,9 @@ import { explicitListScreenId, normalizeListColumn, resolveNavParentScreen, scre
7
7
  import { bootRuleError } from "./boot-rule.js";
8
8
  import { ENTITY_LIST_RULES } from "./entity-list-screens-rules.js";
9
9
  import { validateListBulkActions } from "./list-bulk-actions.js";
10
+ import { validateListRowGuidance } from "./list-row-guidance.js";
11
+ import { LIST_ROW_GUIDANCE_RULES } from "./list-row-guidance-rules.js";
12
+ import { rejectSummaryRowOnRelatedList } from "./list-sort-summary.js";
10
13
  import { validateListTableOptions } from "./list-table-options.js";
11
14
  import { validateRelatedListGroupingRules } from "./related-list-table-rules.js";
12
15
  import { assertWriteHandlerRegistered, isRowClickAction, rejectRedirectOnListRowAction, resolveRowActionNavigateTarget, validateClientActionName, validateDrawerTargetAction, validateRowActionNavigateParams, } from "./screens-actions.js";
@@ -87,6 +90,9 @@ export function validateScreenHasNavArea(feature, screenId, screen, featureMap)
87
90
  // both render a relatedList whose rows come from an arbitrary query.
88
91
  function validateRelatedListTableAndBulk(args) {
89
92
  const { featureName, where, section } = args;
93
+ // Before the grouping rules: an expandableRow's "only table.grouping" rule would otherwise
94
+ // swallow a summaryRow with a less specific message.
95
+ rejectSummaryRowOnRelatedList(`[Feature ${featureName}] ${where}`, section.table);
90
96
  validateRelatedListGroupingRules(`[Feature ${featureName}] ${where}`, section, args.screenType === "entityList expandableRow");
91
97
  validateListTableOptions(`[Feature ${featureName}] ${where}`, section.table, section.columns);
92
98
  if (section.rowActions !== undefined)
@@ -113,8 +119,10 @@ export function validateRelatedListSection(args) {
113
119
  if (section.entity !== undefined) {
114
120
  assertRefTargetRegistered(`[Feature ${featureName}] ${where}`, "entity", section.entity, featureName, featureMap);
115
121
  }
122
+ validateListRowGuidance(featureName, args.screenId, "relatedList", section, undefined, where);
116
123
  for (const col of section.columns) {
117
124
  const normalizedCol = normalizeListColumn(col);
125
+ validateColumnRendererForm(featureName, args.screenId, normalizedCol);
118
126
  validateEnumOptionTones(`[Feature ${featureName}] ${where}`, normalizedCol);
119
127
  if (normalizedCol.refEntity !== undefined) {
120
128
  assertRefTargetRegistered(`[Feature ${featureName}] ${where}`, `column "${normalizedCol.field}" (refEntity)`, normalizedCol.refEntity, featureName, featureMap);
@@ -153,19 +161,20 @@ function rejectEmptyStateActionParams(ctx, actionLabel, action) {
153
161
  }
154
162
  // Target checks shared by list/related-list rowActions and emptyState.action:
155
163
  // navigate target + params, drawer target, write-handler registration.
156
- export function validateListActionTargets(ctx, actionLabel, action) {
164
+ export function validateListActionTargets(ctx, actionLabel, action, onNavigateTarget) {
157
165
  rejectRedirectOnListRowAction(ctx.featureName, ctx.screenId, ctx.screenType, action);
158
166
  if (actionLabel === "emptyState action")
159
167
  rejectEmptyStateActionParams(ctx, actionLabel, action);
160
- validateRowActionTarget(ctx, actionLabel, actionLabel, action);
168
+ validateRowActionTarget(ctx, actionLabel, actionLabel, action, onNavigateTarget);
161
169
  }
162
170
  // Header actions have always reported navigate-params errors under the
163
171
  // "rowAction" label, which validateRowActionNavigateParams only knows in list
164
172
  // labels — hence paramsLabel apart from actionLabel.
165
- export function validateRowActionTarget(ctx, actionLabel, paramsLabel, action) {
173
+ export function validateRowActionTarget(ctx, actionLabel, paramsLabel, action, onNavigateTarget) {
166
174
  const { featureName, screenId, screenType } = ctx;
167
175
  if (action.kind === "navigate") {
168
176
  const target = resolveRowActionNavigateTarget(featureName, screenId, screenType, actionLabel, action, ctx.allScreenQns, ctx.navTargetShortIds, ctx.screensByShortId, ctx.detailForScreens);
177
+ onNavigateTarget?.(action, target);
169
178
  validateRowActionNavigateParams(featureName, screenId, screenType, ctx.screenEntity, action, target, paramsLabel);
170
179
  }
171
180
  else if (action.kind === "drawer") {
@@ -269,6 +278,13 @@ export function rejectInertColumnSortable(featureName, screenId, screenType, col
269
278
  // failure.
270
279
  export function validateColumnRendererForm(featureName, screenId, column) {
271
280
  validateEnumOptionTones(`[Feature ${featureName}] Screen "${screenId}"`, column);
281
+ if (column.linkParamsField !== undefined && column.linkScreenField === undefined) {
282
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.linkParamsWithoutScreenField, {
283
+ message: `[Feature ${featureName}] Screen "${screenId}" column "${column.field}" sets linkParamsField ` +
284
+ `without linkScreenField — the params belong to the linkScreenField target. ` +
285
+ `Set linkScreenField or remove linkParamsField.`,
286
+ });
287
+ }
272
288
  const renderer = column.renderer;
273
289
  // skip: only the PlatformComponent form ({ react: { __component: "..." } })
274
290
  // is validated structurally. Function, string-QN and null/undefined
@@ -119,8 +119,8 @@ function validateScreenPrelude(ctx, screenId, screen) {
119
119
  export function validateScreens(feature, featureMap, allWriteHandlerQns, allScreenQns, configKeyDefsByQn, screensByShortId, detailForScreens) {
120
120
  const ctx = buildScreenValidationContext(feature, featureMap, allWriteHandlerQns, allScreenQns, configKeyDefsByQn, screensByShortId, detailForScreens);
121
121
  for (const [screenId, screen] of Object.entries(feature.screens)) {
122
- validateScreenPrelude(ctx, screenId, screen);
123
122
  rejectUnknownScreenKind(feature.name, screenId, screen);
123
+ validateScreenPrelude(ctx, screenId, screen);
124
124
  validateScreenOfKind(ctx, screenId, screen.type, screen);
125
125
  }
126
126
  }
@@ -0,0 +1,2 @@
1
+ import type { FeatureDefinition } from "../types/index.ts";
2
+ export declare function validateSortNulls(feature: FeatureDefinition): void;
@@ -0,0 +1,15 @@
1
+ import { bootRuleError } from "./boot-rule.js";
2
+ import { ENTITY_STRUCTURE_RULES } from "./entity-structure-rules.js";
3
+ export function validateSortNulls(feature) {
4
+ for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
5
+ for (const [fieldName, field] of Object.entries(entity.fields)) {
6
+ if (!("sortNulls" in field) || field.sortNulls === undefined)
7
+ continue;
8
+ if (field.sortable === true)
9
+ continue;
10
+ throw bootRuleError(ENTITY_STRUCTURE_RULES.sortNullsNeedsSortable, {
11
+ message: `Field "${fieldName}" on entity "${entityName}" sets sortNulls without sortable: true; the null order only applies to a sortable field. Add sortable: true or drop sortNulls.`,
12
+ });
13
+ }
14
+ }
15
+ }
@@ -1,5 +1,6 @@
1
- import { type ZodType } from "zod";
1
+ import { ZodType } from "zod";
2
2
  import type { $ZodType } from "zod/v4/core";
3
+ export declare function getZodStringLiterals(schema: ZodType | undefined): readonly string[] | undefined;
3
4
  export declare function getZodObjectShape(schema: ZodType | undefined): Record<string, ZodType> | undefined;
4
5
  export declare function getZodRowShape(schema: ZodType | undefined): Record<string, ZodType> | undefined;
5
6
  export declare function collectZodObjectKeys(schema: $ZodType | undefined): ReadonlySet<string>;
@@ -1,4 +1,4 @@
1
- import { ZodArray, ZodCatch, ZodDefault, ZodIntersection, ZodLazy, ZodMap, ZodNever, ZodNonOptional, ZodNullable, ZodObject, ZodOptional, ZodPipe, ZodPrefault, ZodPromise, ZodReadonly, ZodRecord, ZodSet, ZodTuple, ZodUnion, ZodXor, } from "zod";
1
+ import { ZodArray, ZodCatch, ZodDefault, ZodEnum, ZodIntersection, ZodLazy, ZodLiteral, ZodMap, ZodNever, ZodNonOptional, ZodNullable, ZodObject, ZodOptional, ZodPipe, ZodPrefault, ZodPromise, ZodReadonly, ZodRecord, ZodSet, ZodTuple, ZodType, ZodUnion, ZodXor, } from "zod";
2
2
  import { bootRuleError } from "./boot-rule.js";
3
3
  import { HANDLER_FIELD_REFERENCE_RULES } from "./handler-field-references-rules.js";
4
4
  // Drills through wrapper types (.nullable(), .optional(), .default()) a
@@ -21,6 +21,24 @@ function unwrapZodType(schema) {
21
21
  }
22
22
  return current;
23
23
  }
24
+ // The closed set of string values a schema accepts (enum, literal, union of those), or undefined
25
+ // when it accepts anything else (plain z.string(), refinements, ...) and cannot be enumerated.
26
+ export function getZodStringLiterals(schema) {
27
+ if (schema === undefined)
28
+ return undefined;
29
+ const unwrapped = unwrapZodType(schema);
30
+ if (unwrapped instanceof ZodEnum)
31
+ return Object.values(unwrapped.enum).map(String);
32
+ if (unwrapped instanceof ZodLiteral) {
33
+ const values = [...unwrapped.values];
34
+ return values.every((value) => typeof value === "string") ? values.map(String) : undefined;
35
+ }
36
+ if (unwrapped instanceof ZodUnion) {
37
+ const parts = unwrapped.options.map((option) => option instanceof ZodType ? getZodStringLiterals(option) : undefined);
38
+ return parts.every((part) => part !== undefined) ? parts.flat() : undefined;
39
+ }
40
+ return undefined;
41
+ }
24
42
  // Non-ZodObject schemas (e.g. a z.union across payload shapes) and an
25
43
  // absent schema both fall through to "shape unknown" — callers treat that
26
44
  // as "capability absent" and skip the check rather than throwing, the same
@@ -32,6 +32,7 @@ import { collectUrlPrefillFieldsByScreenQn } from "./boot-validator/url-prefill-
32
32
  import { buildConfigFeatureSchema, SETTINGS_HUB_FEATURE, } from "./build-config-feature-schema.js";
33
33
  import { isEncryptedAtRest } from "./config-helpers.js";
34
34
  import { isListQueryWithoutSearchableFields } from "./entity-list-searchability.js";
35
+ import { projectNamedFilterRoles } from "./named-filter-roles.js";
35
36
  import { projectQueryLiveEntities } from "./project-query-live-entities.js";
36
37
  import { QnTypes, qualifyEntityName } from "./qualified-name.js";
37
38
  const log = createFallbackLogger("kumiko");
@@ -285,6 +286,9 @@ function projectScreens(featureName, screens, registry, urlPrefillFieldsByScreen
285
286
  return projectConfigEditScreen(screen, encryptedConfigKeyQns);
286
287
  if (screen.type === "projectionList")
287
288
  return projectProjectionListScreen(screen, registry);
289
+ if (screen.type === "entityList") {
290
+ return projectNamedFilterRoles(screen, registry.features.get(featureName)?.entities?.[screen.entity]?.namedFilters);
291
+ }
288
292
  if (screen.type === "entityEdit") {
289
293
  const { writeExcludedFields: _authoredExclusions, ...authoredScreen } = screen;
290
294
  return {
@@ -7,7 +7,7 @@ export declare const access: {
7
7
  readonly systemAdmin: readonly string[];
8
8
  readonly system: readonly string[];
9
9
  readonly privileged: readonly string[];
10
- readonly authenticated: readonly string[];
10
+ readonly builtinUserRoles: readonly string[];
11
11
  readonly anonymous: readonly string[];
12
12
  readonly roles: (...roles: string[]) => readonly string[];
13
13
  readonly withSystem: (roles: readonly string[]) => readonly string[];
@@ -28,7 +28,6 @@ type ConfigKeyOptions<T extends ConfigKeyType> = {
28
28
  } : never;
29
29
  computed?: ConfigComputedFn<T>;
30
30
  validate?: ConfigValidateFn<T>;
31
- allowPerRequest?: T extends "text" ? never : boolean;
32
31
  required?: boolean;
33
32
  env?: string;
34
33
  inheritedToTenant?: boolean;
@@ -17,7 +17,10 @@ export const access = {
17
17
  systemAdmin: ["SystemAdmin"], // @cast-boundary schema-walk
18
18
  system: ["system"], // @cast-boundary schema-walk
19
19
  privileged: ["system", "SystemAdmin"], // @cast-boundary schema-walk
20
- authenticated: ["User", "Admin", "SystemAdmin"], // @cast-boundary schema-walk
20
+ // Only the built-in user roles, not every signed-in caller: a member holding just an app role
21
+ // is not covered. For "any signed-in user" declare `anySignedIn: true` (next to the anonymous
22
+ // role) or `openToAll` instead.
23
+ builtinUserRoles: ["User", "Admin", "SystemAdmin"], // @cast-boundary schema-walk
21
24
  anonymous: ["anonymous"], // @cast-boundary schema-walk
22
25
  roles: (...roles) => roles,
23
26
  // Tenant self-service roles PLUS the system actor — for tenant-scope keys a
@@ -61,7 +64,6 @@ function createConfigKey(scope, type, opts = {}) {
61
64
  ...(opts.pattern ? { pattern: opts.pattern } : {}),
62
65
  computed: opts.computed,
63
66
  validate: opts.validate,
64
- ...(opts.allowPerRequest === true ? { allowPerRequest: true } : {}),
65
67
  ...(opts.required === true ? { required: true } : {}),
66
68
  ...(opts.env ? { env: opts.env } : {}),
67
69
  ...(opts.inheritedToTenant === false ? { inheritedToTenant: false } : {}),
@@ -73,15 +75,12 @@ function createConfigKey(scope, type, opts = {}) {
73
75
  // --- Public API ---
74
76
  // Generic on the type-tag so `r.config({keys})` can propagate it into the
75
77
  // returned `ConfigKeyHandle<T>` — that's what narrows `ctx.config(handle)`.
76
- // @wrapper-known semantic-alias
77
78
  export function createTenantConfig(type, opts) {
78
79
  return createConfigKey("tenant", type, opts);
79
80
  }
80
- // @wrapper-known semantic-alias
81
81
  export function createSystemConfig(type, opts) {
82
82
  return createConfigKey("system", type, opts);
83
83
  }
84
- // @wrapper-known semantic-alias
85
84
  export function createUserConfig(type, opts) {
86
85
  return createConfigKey("user", type, opts);
87
86
  }
@@ -91,8 +90,8 @@ export function createUserConfig(type, opts) {
91
90
  // from the seeds-record-key during r.config() processing.
92
91
  // Scope-agnostic seed. The scope is derived from the matching keyDef in
93
92
  // define-feature.ts (via `seed.scope ?? keyDef.scope`). NOT usable for
94
- // user-scope keys — those need an explicit tenantId+userId, use
95
- // `createUserSeed` instead.
93
+ // user-scope keys — those need an explicit tenantId+userId, so write the
94
+ // literal `{ value, scope: "user", tenantId, userId }`.
96
95
  export function createSeed(opts) {
97
96
  return { value: opts.value, key: "" };
98
97
  }
@@ -95,6 +95,7 @@ export function defineFeature(name, setup, settings) {
95
95
  adoptsBundledLists() {
96
96
  state.adoptsBundledLists = true;
97
97
  },
98
+ // guard:dup-ok builder setter shape, sharing would add a parameter per line
98
99
  uiHints(hints) {
99
100
  if (state.uiHints !== undefined) {
100
101
  throw bootRuleError(FEATURE_DEFINITION_RULES.uiHintsTwice, {
@@ -14,6 +14,7 @@ export declare function defineQueryHandler<const TName extends string, TSchema e
14
14
  export declare const PAGED_QUERY_HANDLER_BRAND = "__kumikoPagedQueryHandler";
15
15
  export declare function isPagedQueryHandler(def: object): boolean;
16
16
  export declare function isEntityConventionQueryHandler(def: object): boolean;
17
+ export declare function isEntityConventionWriteHandler(def: object): boolean;
17
18
  export type PagedQueryHandlerDefinition<TName extends string = string, TSchema extends ZodType = ZodType, TRow = unknown, TMap extends object = KumikoEventTypeMap> = QueryHandlerDefinition<TName, TSchema, CursorResult<TRow>, TMap> & {
18
19
  readonly [PAGED_QUERY_HANDLER_BRAND]: true;
19
20
  };
@@ -1,4 +1,4 @@
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 { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
3
3
  import { bootRuleError } from "./boot-validator/boot-rule.js";
4
4
  import { DEFINITION_HANDLER_RULES } from "./boot-validator/definition-handlers-rules.js";
@@ -72,7 +72,6 @@ export function defineWriteHandler(def,
72
72
  };
73
73
  if ("perform" in def && def.perform !== undefined) {
74
74
  const performDef = def.perform;
75
- // @wrapper-known semantic-alias
76
75
  const compiledHandler = async (event, ctx) => {
77
76
  return runPipeline(performDef, event, ctx);
78
77
  };
@@ -110,6 +109,9 @@ export function isPagedQueryHandler(def) {
110
109
  export function isEntityConventionQueryHandler(def) {
111
110
  return propertyOf(def, ENTITY_CONVENTION_QUERY_BRAND) === true;
112
111
  }
112
+ export function isEntityConventionWriteHandler(def) {
113
+ return propertyOf(def, ENTITY_CONVENTION_WRITE_BRAND) === true;
114
+ }
113
115
  // A projectionList screen's query must resolve to { rows, nextCursor, total? }
114
116
  // (CursorResult<T>) — the renderer used to read rowsQuery.data?.rows and
115
117
  // silently show an empty list otherwise; the renderer now guards against a
@@ -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";