@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
@@ -8,13 +8,16 @@ import { validateEntityListAggregateOptions } from "./entity-list-aggregate-opti
8
8
  import { LIST_ROW_META_COLUMN_NAMES } from "./entity-list-screens.js";
9
9
  import { ENTITY_LIST_RULES } from "./entity-list-screens-rules.js";
10
10
  import { validateListBulkActions } from "./list-bulk-actions.js";
11
+ import { validateListRowGuidance } from "./list-row-guidance.js";
11
12
  import { validateListTableOptions } from "./list-table-options.js";
12
- import { assertWriteHandlerRegistered, rejectRedirectOnListRowAction, resolveRowActionNavigateTarget, resolveScreenTargetQn, validateActionFieldRefs, validateAtMostOneRowClick, validateDrawerTargetAction, validateRowActionNavigateParams, } from "./screens-actions.js";
13
+ import { validateListToolbarOptions } from "./list-toolbar-options.js";
14
+ import { acceptsRowDecorationField, resolveRowDecorationFields, } from "./row-decoration.js";
15
+ import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, resolveScreenTargetQn, validateActionFieldRefs, validateAtMostOneRowClick, validateDrawerTargetAction, } from "./screens-actions.js";
13
16
  import { SCREEN_ACTION_RULES } from "./screens-actions-rules.js";
14
17
  import { validateDashboardPanelVisibleWhen } from "./screens-dashboard.js";
15
18
  import { SCREEN_KIND_RULES } from "./screens-kind-rules.js";
16
19
  import { buildUnknownFieldMessage, listActionContext, rejectEmptyColumns, rejectNonArrayInFilter, resolveScreenEntity, validateListColumnRendering, } from "./screens-kind-shared.js";
17
- import { validateRelatedListSection, validateRowActionTarget } from "./screens-lists.js";
20
+ import { validateListActionTargets, validateRelatedListSection } from "./screens-lists.js";
18
21
  function resolveEntityListFields(ctx, screenId, entityName) {
19
22
  const entityDef = resolveScreenEntity(ctx, screenId, entityName);
20
23
  const fieldNames = new Set(Object.keys(entityDef.fields));
@@ -27,7 +30,7 @@ function resolveEntityListFields(ctx, screenId, entityName) {
27
30
  const rowMeta = rowMetaFieldNames(entityDef.softDelete ?? false);
28
31
  return { entityDef, fieldNames, columnFieldNames, rowMeta };
29
32
  }
30
- function validateEntityListColumns(ctx, screenId, screen, fields) {
33
+ function validateEntityListColumns(ctx, screenId, screen, fields, decoration) {
31
34
  const featureName = ctx.feature.name;
32
35
  rejectEmptyColumns(featureName, screenId, "entityList", screen.columns.length);
33
36
  for (const col of screen.columns) {
@@ -47,6 +50,7 @@ function validateEntityListColumns(ctx, screenId, screen, fields) {
47
50
  // a typo worth failing the boot.
48
51
  if (!fields.columnFieldNames.has(normalized.field) &&
49
52
  !LIST_ROW_META_COLUMN_NAMES.has(normalized.field) &&
53
+ !acceptsRowDecorationField(decoration, normalized.field) &&
50
54
  !(normalized.label !== undefined && normalized.renderer !== undefined)) {
51
55
  throw bootRuleError(SCREEN_KIND_RULES.unknownFieldReference, {
52
56
  message: buildUnknownFieldMessage(featureName, screenId, normalized.field, screen.entity, fields.columnFieldNames),
@@ -150,29 +154,15 @@ function rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, acti
150
154
  // Pin rowActions at boot: a navigate target must exist and a writeHandler QN
151
155
  // must be registered. Typos would otherwise only surface on the first click as
152
156
  // "Screen not found" or a 404.
153
- function validateEntityListRowAction(ctx, screenId, screen, fields, action) {
157
+ function validateEntityListRowAction(ctx, screenId, screen, fields, decoration, action) {
154
158
  const featureName = ctx.feature.name;
155
- rejectRedirectOnListRowAction(featureName, screenId, "entityList", action);
156
- if (action.kind === "navigate") {
157
- const target = resolveRowActionNavigateTarget(featureName, screenId, "entityList", "rowAction", action, ctx.allScreenQns, ctx.navTargetShortIds, ctx.screensByShortId, ctx.detailForScreens);
158
- rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, action, target);
159
- // params only have a reader in actionForm and entityEdit-CREATE; on
160
- // projectionDetail/dashboard/configEdit/entityEdit-update they are
161
- // silently ignored at runtime. `custom` is deliberately exempt: it renders
162
- // an app-registered component the framework has no visibility into, so
163
- // flagging it would be a false positive on working code.
164
- //
165
- // Whether an entityEdit target lands in create or update mode is decided
166
- // by the same rule the renderer's runNavigate() uses: an explicit
167
- // entityId always forces update mode, and (absent an explicit entityId) a
168
- // same-entity target gets row["id"] auto-injected — only a cross-entity
169
- // target with no explicit entityId reaches create.
170
- validateRowActionNavigateParams(featureName, screenId, "entityList", screen.entity, action, target);
171
- }
172
- else {
173
- validateRowActionTarget(listActionContext(ctx, screenId, "entityList", screen.entity, `Screen "${screenId}" (entityList)`), "rowAction", "rowAction", action);
174
- }
175
- validateActionFieldRefs(featureName, screenId, "rowAction", action.id, action, fields.fieldNames, fields.rowMeta);
159
+ validateListActionTargets(listActionContext(ctx, screenId, "entityList", screen.entity, `Screen "${screenId}" (entityList)`), "rowAction", action, (navigateAction, target) => rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, navigateAction, target));
160
+ // skip: an undeclared decoration outputSchema leaves the action's field names unpinnable
161
+ if (decoration?.kind === "opaque")
162
+ return;
163
+ validateActionFieldRefs(featureName, screenId, "rowAction", action.id, action, decoration === undefined
164
+ ? fields.fieldNames
165
+ : new Set([...fields.fieldNames, ...decoration.names]), fields.rowMeta);
176
166
  }
177
167
  // toolbarActions, analogous to rowActions: misspelled navigate targets and
178
168
  // unregistered writeHandler QNs fail at boot instead of on the first click.
@@ -219,10 +209,24 @@ function validateEntityListExpandableRow(ctx, screenId, expandableRow, fields) {
219
209
  validateActionFieldRefs(ctx.feature.name, screenId, "toolbarAction", action.id, action, fields.fieldNames, fields.rowMeta);
220
210
  }
221
211
  }
212
+ function validateToolbarOptions(where, screen) {
213
+ if (screen.createPlacement === "toolbar" && screen.allowCreate === false) {
214
+ throw bootRuleError(SCREEN_KIND_RULES.createPlacementWithoutCreate, {
215
+ message: `${where} sets createPlacement "toolbar" with allowCreate: false — there is no create button to place. Remove createPlacement or allowCreate: false.`,
216
+ });
217
+ }
218
+ validateListToolbarOptions(where, screen);
219
+ }
222
220
  export function validateEntityListScreen(ctx, screenId, screen) {
223
221
  const featureName = ctx.feature.name;
224
222
  const fields = resolveEntityListFields(ctx, screenId, screen.entity);
225
- validateEntityListColumns(ctx, screenId, screen, fields);
223
+ const decoration = resolveRowDecorationFields(ctx.featureMap.values(), screen.rowDecoration);
224
+ validateEntityListColumns(ctx, screenId, screen, fields, decoration);
225
+ validateListRowGuidance(featureName, screenId, "entityList", screen, {
226
+ entityName: screen.entity,
227
+ fieldNames: new Set([...fields.columnFieldNames, ...LIST_ROW_META_COLUMN_NAMES]),
228
+ rowDecorationFields: decoration,
229
+ });
226
230
  // Validate pagination, sorting, and search at boot so authoring errors
227
231
  // fail before runtime debugging of empty or incorrectly sorted lists.
228
232
  if (screen.pageSize !== undefined && screen.pageSize <= 0) {
@@ -245,12 +249,13 @@ export function validateEntityListScreen(ctx, screenId, screen) {
245
249
  `Known screens in this feature: ${Object.keys(ctx.feature.screens).sort().join(", ") || "(none)"}.`,
246
250
  });
247
251
  }
252
+ validateToolbarOptions(where, screen);
248
253
  if (screen.filter !== undefined) {
249
254
  validateEntityListFilter(featureName, screenId, screen.filter, fields);
250
255
  }
251
256
  if (screen.rowActions !== undefined) {
252
257
  for (const action of screen.rowActions) {
253
- validateEntityListRowAction(ctx, screenId, screen, fields, action);
258
+ validateEntityListRowAction(ctx, screenId, screen, fields, decoration, action);
254
259
  }
255
260
  validateAtMostOneRowClick(featureName, screenId, "entityList", screen.rowActions);
256
261
  }
@@ -0,0 +1,3 @@
1
+ import type { ProjectionDetailScreenDefinition } from "../types/screen.ts";
2
+ import { type ScreenValidationContext } from "./screens-kind-shared.ts";
3
+ export declare function validateProjectionDetailGuidance(ctx: ScreenValidationContext, screenId: string, screen: ProjectionDetailScreenDefinition): void;
@@ -0,0 +1,46 @@
1
+ import { bootRuleError } from "./boot-rule.js";
2
+ import { detailGuidanceFieldRefs } from "./query-output-guidance.js";
3
+ import { validateActionHasIcon } from "./screens-actions.js";
4
+ import { PROJECTION_DETAIL_RULES } from "./screens-kind-projection-detail-rules.js";
5
+ import { validateRecordHeaderAction } from "./screens-kind-shared.js";
6
+ function validateGuidanceAction(ctx, screenId, screen, block, action) {
7
+ const featureName = ctx.feature.name;
8
+ validateActionHasIcon(featureName, screenId, "projectionDetail", `${block} action`, action);
9
+ validateRecordHeaderAction(ctx, screenId, "projectionDetail", screen.detailFor, action);
10
+ if (action.showOnTabs !== undefined) {
11
+ throw bootRuleError(PROJECTION_DETAIL_RULES.guidanceActionShowOnTabs, {
12
+ message: `[Feature ${featureName}] Screen "${screenId}" (projectionDetail) ${block} action ` +
13
+ `"${action.id}" sets showOnTabs — ${block} actions sit outside the tabs. Remove showOnTabs.`,
14
+ });
15
+ }
16
+ }
17
+ // Field existence is pinned against the query's outputSchema in query-output-columns.ts.
18
+ export function validateProjectionDetailGuidance(ctx, screenId, screen) {
19
+ for (const { option, field } of detailGuidanceFieldRefs(screen)) {
20
+ if (field.trim().length === 0) {
21
+ throw bootRuleError(PROJECTION_DETAIL_RULES.guidanceFieldEmpty, {
22
+ message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets ${option} to ` +
23
+ `an empty string. Name a query output field or remove the block.`,
24
+ });
25
+ }
26
+ }
27
+ if (screen.progress?.placement === "beside-steps" && screen.steps === undefined) {
28
+ throw bootRuleError(PROJECTION_DETAIL_RULES.progressBesideStepsWithoutSteps, {
29
+ message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets progress.placement ` +
30
+ `"beside-steps" without steps. Add steps or remove the placement.`,
31
+ });
32
+ }
33
+ const narrowLimit = screen.steps?.narrowLimit;
34
+ if (narrowLimit !== undefined && (!Number.isInteger(narrowLimit) || narrowLimit < 1)) {
35
+ throw bootRuleError(PROJECTION_DETAIL_RULES.stepsNarrowLimitInvalid, {
36
+ message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets steps.narrowLimit ` +
37
+ `"${String(narrowLimit)}", which is not a positive integer. Set a whole number of at least 1.`,
38
+ });
39
+ }
40
+ for (const action of screen.banner?.actions ?? []) {
41
+ validateGuidanceAction(ctx, screenId, screen, "banner", action);
42
+ }
43
+ for (const action of screen.steps?.actions ?? []) {
44
+ validateGuidanceAction(ctx, screenId, screen, "steps", action);
45
+ }
46
+ }
@@ -59,6 +59,26 @@ export declare const PROJECTION_DETAIL_RULES: {
59
59
  readonly summary: "A header.subtitle part navigate names a screen or an entity.";
60
60
  readonly fix: "Set screen or entity on the part's navigate.";
61
61
  };
62
+ readonly guidanceFieldEmpty: {
63
+ readonly id: "projection-detail/guidance-field-empty";
64
+ readonly summary: "The field names of breadcrumb, summary, banner, steps and progress are non-empty strings.";
65
+ readonly fix: "Name a query output field or remove the block.";
66
+ };
67
+ readonly progressBesideStepsWithoutSteps: {
68
+ readonly id: "projection-detail/progress-beside-steps-without-steps";
69
+ readonly summary: 'progress.placement "beside-steps" needs a steps block to sit next to.';
70
+ readonly fix: "Add steps to the projectionDetail or remove progress.placement.";
71
+ };
72
+ readonly stepsNarrowLimitInvalid: {
73
+ readonly id: "projection-detail/steps-narrow-limit-invalid";
74
+ readonly summary: "steps.narrowLimit is a positive integer.";
75
+ readonly fix: "Set narrowLimit to a whole number of at least 1 or remove it.";
76
+ };
77
+ readonly guidanceActionShowOnTabs: {
78
+ readonly id: "projection-detail/guidance-action-show-on-tabs";
79
+ readonly summary: "Banner and steps actions set no showOnTabs.";
80
+ readonly fix: "Remove showOnTabs.";
81
+ };
62
82
  readonly extensionContributesToFormSubmit: {
63
83
  readonly id: "projection-detail/extension-contributes-to-form-submit";
64
84
  readonly summary: "A projectionDetail extension section does not set contributesToFormSubmit.";
@@ -59,6 +59,26 @@ export const PROJECTION_DETAIL_RULES = {
59
59
  summary: "A header.subtitle part navigate names a screen or an entity.",
60
60
  fix: "Set screen or entity on the part's navigate.",
61
61
  },
62
+ guidanceFieldEmpty: {
63
+ id: "projection-detail/guidance-field-empty",
64
+ summary: "The field names of breadcrumb, summary, banner, steps and progress are non-empty strings.",
65
+ fix: "Name a query output field or remove the block.",
66
+ },
67
+ progressBesideStepsWithoutSteps: {
68
+ id: "projection-detail/progress-beside-steps-without-steps",
69
+ summary: 'progress.placement "beside-steps" needs a steps block to sit next to.',
70
+ fix: "Add steps to the projectionDetail or remove progress.placement.",
71
+ },
72
+ stepsNarrowLimitInvalid: {
73
+ id: "projection-detail/steps-narrow-limit-invalid",
74
+ summary: "steps.narrowLimit is a positive integer.",
75
+ fix: "Set narrowLimit to a whole number of at least 1 or remove it.",
76
+ },
77
+ guidanceActionShowOnTabs: {
78
+ id: "projection-detail/guidance-action-show-on-tabs",
79
+ summary: "Banner and steps actions set no showOnTabs.",
80
+ fix: "Remove showOnTabs.",
81
+ },
62
82
  extensionContributesToFormSubmit: {
63
83
  id: "projection-detail/extension-contributes-to-form-submit",
64
84
  summary: "A projectionDetail extension section does not set contributesToFormSubmit.",
@@ -3,6 +3,7 @@ import { isExtensionEditSection, isFieldsEditSection, isWriteFormEditSection, no
3
3
  import { bootRuleError } from "./boot-rule.js";
4
4
  import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, validateActionHasIcon, validatePrimaryActionTarget, } from "./screens-actions.js";
5
5
  import { rejectWriteOnlyFormField, validateFieldsXorGroups, validateFormSelectOptions, validateTabSections, } from "./screens-forms.js";
6
+ import { validateProjectionDetailGuidance } from "./screens-kind-projection-detail-guidance.js";
6
7
  import { PROJECTION_DETAIL_RULES } from "./screens-kind-projection-detail-rules.js";
7
8
  import { assertExtensionSectionHasComponent, editSectionLabel, listActionContext, navigateActionFromLink, rejectEmptySections, rejectMissingQuery, validateRecordHeaderAction, validateRecordSectionActions, } from "./screens-kind-shared.js";
8
9
  import { assertRefTargetRegistered, validateListActionTargets, validateRelatedListSection, } from "./screens-lists.js";
@@ -297,4 +298,5 @@ export function validateProjectionDetailScreen(ctx, screenId, screen) {
297
298
  validateRecordHeaderAction(ctx, screenId, "projectionDetail", screen.detailFor, action);
298
299
  validateHeaderActionShowOnTabs(featureName, screenId, screen, action);
299
300
  }
301
+ validateProjectionDetailGuidance(ctx, screenId, screen);
300
302
  }
@@ -1,6 +1,8 @@
1
1
  import { normalizeListColumn } from "../screen-helpers.js";
2
2
  import { validateListBulkActions } from "./list-bulk-actions.js";
3
+ import { validateListRowGuidance } from "./list-row-guidance.js";
3
4
  import { validateListTableOptions } from "./list-table-options.js";
5
+ import { validateListToolbarOptions } from "./list-toolbar-options.js";
4
6
  import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, validateAtMostOneRowClick, validateDrawerTargetAction, } from "./screens-actions.js";
5
7
  import { validateDashboardPanelVisibleWhen } from "./screens-dashboard.js";
6
8
  import { listActionContext, rejectEmptyColumns, rejectMissingQuery, rejectNonArrayInFilter, validateListColumnRendering, } from "./screens-kind-shared.js";
@@ -38,7 +40,9 @@ export function validateProjectionListScreen(ctx, screenId, screen) {
38
40
  for (const col of screen.columns) {
39
41
  validateListColumnRendering(ctx, screenId, "projectionList", normalizeListColumn(col));
40
42
  }
43
+ validateListRowGuidance(featureName, screenId, "projectionList", screen);
41
44
  validateListTableOptions(`[Feature ${featureName}] Screen "${screenId}" (projectionList)`, screen.table, screen.columns, true);
45
+ validateListToolbarOptions(`[Feature ${featureName}] Screen "${screenId}" (projectionList)`, screen);
42
46
  // Screen filter: field existence can't be checked without an entity (columns
43
47
  // aren't a complete field inventory of the underlying query), so only the
44
48
  // structure is pinned: "in" requires an array.
@@ -69,6 +69,31 @@ export declare const SCREEN_KIND_RULES: {
69
69
  readonly summary: "createScreen resolves to a registered screen in the same feature.";
70
70
  readonly fix: "Point createScreen at a screen of this feature.";
71
71
  };
72
+ readonly createPlacementWithoutCreate: {
73
+ readonly id: "entity-list/create-placement-without-create";
74
+ readonly summary: 'createPlacement "toolbar" moves the create button, so the list has one (no allowCreate: false).';
75
+ readonly fix: "Remove createPlacement or drop allowCreate: false.";
76
+ };
77
+ readonly toolbarSortWithoutSortOptions: {
78
+ readonly id: "entity-list/toolbar-sort-without-sort-options";
79
+ readonly summary: "toolbarSort draws the sortOptions as a select in the filter row, so it needs sortOptions.";
80
+ readonly fix: "Declare sortOptions or remove toolbarSort.";
81
+ };
82
+ readonly narrowFacetsInvalid: {
83
+ readonly id: "list/narrow-facets-invalid";
84
+ readonly summary: 'narrowFacets is "pills".';
85
+ readonly fix: 'Use "pills", or remove narrowFacets.';
86
+ };
87
+ readonly toolbarActionsPlacementInvalid: {
88
+ readonly id: "list/toolbar-actions-placement-invalid";
89
+ readonly summary: 'toolbarActionsPlacement is "header" or "toolbar".';
90
+ readonly fix: 'Use "header" or "toolbar", or remove toolbarActionsPlacement.';
91
+ };
92
+ readonly toolbarActionsPlacementWithoutActions: {
93
+ readonly id: "list/toolbar-actions-placement-without-actions";
94
+ readonly summary: 'toolbarActionsPlacement "toolbar" moves the toolbarActions, so the list declares some.';
95
+ readonly fix: "Declare toolbarActions or remove toolbarActionsPlacement.";
96
+ };
72
97
  readonly configEditFieldsEmpty: {
73
98
  readonly id: "config-edit/fields-empty";
74
99
  readonly summary: "A configEdit screen declares at least one field.";
@@ -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