@cosmicdrift/kumiko-framework 0.413.0 → 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 (467) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +64 -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/helpdesk.md +15 -8
  18. package/agents/examples/managed-pages.md +90 -1
  19. package/agents/examples/pwa-shell.md +210 -0
  20. package/agents/examples/rate-limiting.md +3 -3
  21. package/agents/examples/record-detail-layout.md +1537 -67
  22. package/agents/examples/workflow-engine.md +16 -12
  23. package/agents/examples.md +1 -0
  24. package/agents/features-index.md +4 -2
  25. package/agents/features.md +22 -7
  26. package/agents/widgets.md +19 -1
  27. package/dist/api/api-constants.d.ts +1 -0
  28. package/dist/api/api-constants.js +4 -0
  29. package/dist/api/auth-middleware.js +4 -3
  30. package/dist/api/auth-routes-shared.js +2 -1
  31. package/dist/api/entity-read-access.d.ts +1 -0
  32. package/dist/api/entity-read-access.js +18 -0
  33. package/dist/api/export/export-route.d.ts +6 -1
  34. package/dist/api/export/export-route.js +27 -1
  35. package/dist/api/export/export-rows.js +19 -3
  36. package/dist/api/routes.d.ts +2 -0
  37. package/dist/api/routes.js +9 -1
  38. package/dist/api/server-extra-routes.js +2 -1
  39. package/dist/api/server-feature-http-routes.d.ts +9 -0
  40. package/dist/api/server-feature-http-routes.js +109 -0
  41. package/dist/api/server-middleware.js +2 -19
  42. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  43. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  44. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  45. package/dist/api/server-rate-limit-wiring.js +37 -0
  46. package/dist/api/server-routes.d.ts +4 -12
  47. package/dist/api/server-routes.js +12 -171
  48. package/dist/api/server-schema-route.d.ts +3 -0
  49. package/dist/api/server-schema-route.js +58 -0
  50. package/dist/api/server-wiring.js +2 -37
  51. package/dist/api/server.js +3 -1
  52. package/dist/compliance/override-schema.js +5 -5
  53. package/dist/compliance/sub-processors.js +10 -1
  54. package/dist/crypto/index.d.ts +1 -1
  55. package/dist/crypto/index.js +1 -1
  56. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  57. package/dist/crypto/pii-field-encryption.js +16 -1
  58. package/dist/db/apply-entity-event.js +4 -0
  59. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  60. package/dist/db/bun-sql-connection-codes.js +7 -0
  61. package/dist/db/collect-table-metas.js +4 -1
  62. package/dist/db/config-seed.js +1 -1
  63. package/dist/db/derived-field-sql.js +15 -13
  64. package/dist/db/derived-related-sql.d.ts +2 -2
  65. package/dist/db/derived-related-sql.js +4 -2
  66. package/dist/db/dialect.d.ts +3 -0
  67. package/dist/db/dialect.js +1 -3
  68. package/dist/db/driver-row-coercion.js +2 -2
  69. package/dist/db/driver-value-preparation.js +1 -1
  70. package/dist/db/eagerload.js +15 -12
  71. package/dist/db/entity-table-meta.d.ts +2 -0
  72. package/dist/db/entity-table-meta.js +7 -0
  73. package/dist/db/event-store-executor-context.js +13 -8
  74. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  75. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  76. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  77. package/dist/db/event-store-executor-read-filter.js +28 -11
  78. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  79. package/dist/db/event-store-executor-read-search.js +6 -6
  80. package/dist/db/event-store-executor-read-sort.js +3 -3
  81. package/dist/db/event-store-executor-read-where.js +14 -5
  82. package/dist/db/event-store-executor-read.js +7 -7
  83. package/dist/db/event-store-executor-write.js +50 -95
  84. package/dist/db/executor-managed-tables.js +4 -1
  85. package/dist/db/index.d.ts +4 -2
  86. package/dist/db/index.js +4 -2
  87. package/dist/db/known-table-names.d.ts +1 -0
  88. package/dist/db/known-table-names.js +7 -5
  89. package/dist/db/list-aggregate-labels.d.ts +1 -0
  90. package/dist/db/list-aggregate-labels.js +9 -1
  91. package/dist/db/migrate-generator.js +23 -4
  92. package/dist/db/migrate-rls-diff.d.ts +1 -0
  93. package/dist/db/migrate-rls-diff.js +15 -1
  94. package/dist/db/migrate-runner.js +2 -2
  95. package/dist/db/money.d.ts +1 -1
  96. package/dist/db/money.js +1 -4
  97. package/dist/db/parent-ref-clause.d.ts +6 -2
  98. package/dist/db/parent-ref-clause.js +76 -23
  99. package/dist/db/parent-ref-global-hosts.d.ts +20 -0
  100. package/dist/db/parent-ref-global-hosts.js +47 -0
  101. package/dist/db/production-schema-command-hint.d.ts +1 -0
  102. package/dist/db/production-schema-command-hint.js +3 -0
  103. package/dist/db/queries/backfill-pii.js +55 -29
  104. package/dist/db/queries/ddl.js +13 -2
  105. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  106. package/dist/db/queries/event-store-open-streams.js +33 -0
  107. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  108. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  109. package/dist/db/queries/event-store.js +0 -1
  110. package/dist/db/queries/raw-sql.js +0 -1
  111. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  112. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  113. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  114. package/dist/db/queries/rls-boot-catalog.js +13 -8
  115. package/dist/db/queries/rls-shape.d.ts +2 -1
  116. package/dist/db/queries/rls-shape.js +10 -0
  117. package/dist/db/queries/session-advisory-lock.js +2 -1
  118. package/dist/db/queries/test-stack.js +7 -7
  119. package/dist/db/query.js +16 -11
  120. package/dist/db/rebuild-marker.js +11 -2
  121. package/dist/db/render-rls-ddl.d.ts +2 -0
  122. package/dist/db/render-rls-ddl.js +16 -11
  123. package/dist/db/replay-migration-sql.js +1 -1
  124. package/dist/db/row-level-security-boot-check.js +18 -5
  125. package/dist/db/row-level-security-connection.js +25 -12
  126. package/dist/db/row-level-security-scope.d.ts +2 -1
  127. package/dist/db/row-level-security-scope.js +9 -5
  128. package/dist/db/sql-identifier.d.ts +1 -0
  129. package/dist/db/sql-identifier.js +3 -0
  130. package/dist/db/system-tenant-read-db.d.ts +5 -0
  131. package/dist/db/system-tenant-read-db.js +28 -0
  132. package/dist/db/table-builder.d.ts +3 -1
  133. package/dist/db/table-builder.js +18 -8
  134. package/dist/db/table-info.d.ts +1 -2
  135. package/dist/db/table-introspection.d.ts +3 -0
  136. package/dist/db/table-introspection.js +6 -0
  137. package/dist/db/table-push.d.ts +1 -0
  138. package/dist/db/table-push.js +7 -1
  139. package/dist/db/tenant-db-runner.d.ts +3 -0
  140. package/dist/db/tenant-db-runner.js +19 -1
  141. package/dist/db/transaction-serialization.d.ts +1 -0
  142. package/dist/db/transaction-serialization.js +20 -3
  143. package/dist/db/where-clause.js +11 -2
  144. package/dist/db/write-ownership-failures.d.ts +25 -0
  145. package/dist/db/write-ownership-failures.js +82 -0
  146. package/dist/engine/boot-validator/boot-check.js +7 -1
  147. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  148. package/dist/engine/boot-validator/boot-phases.js +3 -2
  149. package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
  150. package/dist/engine/boot-validator/boot-rules.js +4 -0
  151. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  152. package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
  153. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  154. package/dist/engine/boot-validator/config-deps.js +0 -28
  155. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  156. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  157. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  158. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  159. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  160. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  161. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  162. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  163. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  164. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  165. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  166. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  167. package/dist/engine/boot-validator/entity-list-screens.js +33 -6
  168. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  169. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  170. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  171. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  172. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  173. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  174. package/dist/engine/boot-validator/list-row-guidance.js +129 -0
  175. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  176. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  177. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  178. package/dist/engine/boot-validator/list-sort-summary.js +149 -0
  179. package/dist/engine/boot-validator/list-table-options.js +15 -1
  180. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  181. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  182. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  183. package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
  184. package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
  185. package/dist/engine/boot-validator/named-filter-rules.js +32 -2
  186. package/dist/engine/boot-validator/ownership.js +10 -1
  187. package/dist/engine/boot-validator/parent-ref.js +87 -50
  188. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  189. package/dist/engine/boot-validator/projection-list-screens.js +31 -1
  190. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  191. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  192. package/dist/engine/boot-validator/query-output-guidance.js +39 -0
  193. package/dist/engine/boot-validator/query-refs.js +24 -1
  194. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  195. package/dist/engine/boot-validator/row-decoration.js +16 -0
  196. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  197. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  198. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  199. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  200. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  201. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  202. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  203. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  204. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  205. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  206. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  207. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  208. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  209. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  210. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  211. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  212. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  213. package/dist/engine/boot-validator/screens-lists.js +19 -3
  214. package/dist/engine/boot-validator/screens.js +1 -1
  215. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  216. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  217. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  218. package/dist/engine/boot-validator/zod-shape.js +19 -1
  219. package/dist/engine/build-app-schema.js +4 -0
  220. package/dist/engine/config-helpers.d.ts +1 -2
  221. package/dist/engine/config-helpers.js +6 -7
  222. package/dist/engine/define-feature.js +1 -0
  223. package/dist/engine/define-handler.d.ts +1 -0
  224. package/dist/engine/define-handler.js +4 -2
  225. package/dist/engine/definition-violations.js +2 -2
  226. package/dist/engine/entity-handlers.js +3 -8
  227. package/dist/engine/entity-list-runtime-options.js +9 -8
  228. package/dist/engine/factories.d.ts +2 -0
  229. package/dist/engine/feature-config-events-jobs.js +1 -0
  230. package/dist/engine/feature-entity-handlers.js +5 -2
  231. package/dist/engine/field-access.d.ts +1 -1
  232. package/dist/engine/field-access.js +7 -10
  233. package/dist/engine/find-entity.js +3 -3
  234. package/dist/engine/form-derivations.js +3 -3
  235. package/dist/engine/index.d.ts +3 -3
  236. package/dist/engine/index.js +2 -2
  237. package/dist/engine/named-filter-roles.d.ts +3 -0
  238. package/dist/engine/named-filter-roles.js +23 -0
  239. package/dist/engine/pipeline.js +0 -1
  240. package/dist/engine/project-app-schema-for-roles.js +17 -2
  241. package/dist/engine/qualified-name.js +0 -1
  242. package/dist/engine/registry-facade.js +1 -2
  243. package/dist/engine/registry-state.d.ts +1 -1
  244. package/dist/engine/registry-state.js +5 -2
  245. package/dist/engine/registry-validate.d.ts +1 -0
  246. package/dist/engine/registry-validate.js +9 -1
  247. package/dist/engine/registry.js +2 -1
  248. package/dist/engine/resolve-named-list-filters.js +5 -2
  249. package/dist/engine/schema-builder.js +6 -10
  250. package/dist/engine/screen-helpers.d.ts +12 -0
  251. package/dist/engine/screen-helpers.js +17 -1
  252. package/dist/engine/soft-delete-cleanup.js +5 -8
  253. package/dist/engine/state-machine.js +0 -1
  254. package/dist/engine/steps/_database-clock.d.ts +2 -0
  255. package/dist/engine/steps/_database-clock.js +6 -0
  256. package/dist/engine/steps/compute.js +1 -1
  257. package/dist/engine/steps/retry.js +5 -1
  258. package/dist/engine/steps/return.js +0 -1
  259. package/dist/engine/steps/wait-for-event.js +2 -1
  260. package/dist/engine/steps/wait.js +2 -1
  261. package/dist/engine/system-user.d.ts +2 -2
  262. package/dist/engine/system-user.js +2 -2
  263. package/dist/engine/types/handlers.d.ts +1 -1
  264. package/dist/engine/types/handlers.js +1 -1
  265. package/dist/engine/types/screen.d.ts +1 -1
  266. package/dist/engine/types/screen.js +1 -1
  267. package/dist/engine/webhook-contracts.d.ts +2 -3
  268. package/dist/engine/webhook-contracts.js +2 -25
  269. package/dist/engine/webhook-events.js +48 -29
  270. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  271. package/dist/engine/webhook-payload-strictness.js +53 -0
  272. package/dist/env/_zod-introspect.d.ts +1 -0
  273. package/dist/env/dry-run.d.ts +1 -1
  274. package/dist/env/dry-run.js +1 -1
  275. package/dist/env/field-meta.d.ts +4 -0
  276. package/dist/env/field-meta.js +67 -0
  277. package/dist/env/field-rules.d.ts +9 -0
  278. package/dist/env/field-rules.js +46 -0
  279. package/dist/env/index.d.ts +3 -3
  280. package/dist/env/index.js +16 -71
  281. package/dist/env/internals.d.ts +3 -0
  282. package/dist/env/internals.js +1 -2
  283. package/dist/env/required-env.d.ts +3 -1
  284. package/dist/env/required-env.js +5 -2
  285. package/dist/errors/serialize.js +2 -2
  286. package/dist/errors/write-error-info.js +0 -2
  287. package/dist/es-ops/operations-schema.js +18 -7
  288. package/dist/event-store/admin-api.js +3 -3
  289. package/dist/event-store/event-store.js +0 -3
  290. package/dist/event-store/index.d.ts +1 -0
  291. package/dist/event-store/index.js +1 -0
  292. package/dist/event-store/transfer.js +1 -1
  293. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  294. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  295. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  296. package/dist/files/bind-pending-file-refs.js +54 -27
  297. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  298. package/dist/files/create-file-ref.d.ts +4 -1
  299. package/dist/files/create-file-ref.js +14 -3
  300. package/dist/files/default-file-guard.js +4 -1
  301. package/dist/files/feature.js +1 -0
  302. package/dist/files/file-claim.d.ts +6 -0
  303. package/dist/files/file-claim.js +17 -0
  304. package/dist/files/file-field-slots.d.ts +2 -0
  305. package/dist/files/file-field-slots.js +28 -0
  306. package/dist/files/file-ref-entity.d.ts +3 -0
  307. package/dist/files/file-ref-entity.js +2 -0
  308. package/dist/files/file-ref-table.d.ts +3 -0
  309. package/dist/files/file-routes.d.ts +4 -1
  310. package/dist/files/file-routes.js +80 -16
  311. package/dist/files/in-memory-provider.d.ts +1 -1
  312. package/dist/files/in-memory-provider.js +2 -1
  313. package/dist/files/index.d.ts +1 -1
  314. package/dist/files/index.js +1 -1
  315. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  316. package/dist/files/invalid-file-ref-error.js +15 -0
  317. package/dist/files/local-provider.js +9 -2
  318. package/dist/files/provider-resolver.js +1 -1
  319. package/dist/files/rebind-file-ref.d.ts +3 -2
  320. package/dist/files/rebind-file-ref.js +24 -18
  321. package/dist/files/resolve-file-handles.d.ts +13 -0
  322. package/dist/files/resolve-file-handles.js +57 -0
  323. package/dist/files/storage-tracking.d.ts +1 -1
  324. package/dist/files/storage-tracking.js +5 -2
  325. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  326. package/dist/files/types.d.ts +4 -0
  327. package/dist/files/types.js +10 -0
  328. package/dist/files/upload-field-resolution.d.ts +1 -0
  329. package/dist/files/upload-field-resolution.js +16 -2
  330. package/dist/files/upload-ledger.js +1 -1
  331. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  332. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  333. package/dist/i18n/required-surface-keys.js +19 -4
  334. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  335. package/dist/internal/boot-rule-table-expectations.js +29 -0
  336. package/dist/internal/row-level-security.d.ts +1 -0
  337. package/dist/internal/row-level-security.js +1 -0
  338. package/dist/internal/testing.d.ts +1 -0
  339. package/dist/internal/testing.js +1 -0
  340. package/dist/jobs/index.d.ts +1 -0
  341. package/dist/jobs/index.js +1 -0
  342. package/dist/jobs/job-load-events.d.ts +10 -0
  343. package/dist/jobs/job-load-events.js +12 -0
  344. package/dist/jobs/job-runner-context.js +6 -158
  345. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  346. package/dist/jobs/job-runner-dispatch.js +57 -0
  347. package/dist/jobs/job-runner-event-triggers.js +18 -9
  348. package/dist/jobs/job-runner-execution.js +2 -2
  349. package/dist/jobs/job-runner-facets.d.ts +48 -0
  350. package/dist/jobs/job-runner-facets.js +156 -0
  351. package/dist/jobs/job-runner-gates.js +24 -12
  352. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  353. package/dist/jobs/job-runner-helpers.js +18 -3
  354. package/dist/jobs/job-runner-scope.d.ts +1 -0
  355. package/dist/jobs/job-runner-scope.js +2 -0
  356. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  357. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  358. package/dist/jobs/job-runner.js +31 -70
  359. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  360. package/dist/jobs/obliterate-job-queues.js +23 -0
  361. package/dist/lifecycle/lifecycle.js +1 -1
  362. package/dist/migrations/event-header-scrub.d.ts +11 -0
  363. package/dist/migrations/event-header-scrub.js +33 -0
  364. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  365. package/dist/migrations/event-payload-scrub.js +36 -4
  366. package/dist/migrations/index.d.ts +1 -0
  367. package/dist/migrations/index.js +2 -0
  368. package/dist/migrations/kumiko-drift.d.ts +5 -2
  369. package/dist/migrations/kumiko-drift.js +51 -14
  370. package/dist/migrations/pending-rebuilds.js +4 -5
  371. package/dist/observability/sensitive-filter.js +0 -12
  372. package/dist/pipeline/aggregate-type-removal.js +17 -4
  373. package/dist/pipeline/context-services.d.ts +2 -0
  374. package/dist/pipeline/context-services.js +5 -2
  375. package/dist/pipeline/dispatch-batch.js +4 -3
  376. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  377. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  378. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  379. package/dist/pipeline/dispatch-nested-write.js +119 -0
  380. package/dist/pipeline/dispatch-query.js +10 -3
  381. package/dist/pipeline/dispatch-scope.js +4 -3
  382. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  383. package/dist/pipeline/dispatch-shared.js +6 -38
  384. package/dist/pipeline/dispatch-write.d.ts +0 -1
  385. package/dist/pipeline/dispatch-write.js +3 -302
  386. package/dist/pipeline/dispatcher-utils.js +6 -0
  387. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  388. package/dist/pipeline/effective-system-scope.js +22 -0
  389. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  390. package/dist/pipeline/event-dispatcher-delivery.js +17 -9
  391. package/dist/pipeline/event-dispatcher.d.ts +4 -1
  392. package/dist/pipeline/event-dispatcher.js +6 -7
  393. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  394. package/dist/pipeline/handler-context-auth.js +3 -4
  395. package/dist/pipeline/handler-context-db.js +11 -4
  396. package/dist/pipeline/handler-context-dispatch.js +2 -2
  397. package/dist/pipeline/handler-context-events.d.ts +8 -3
  398. package/dist/pipeline/handler-context-events.js +20 -65
  399. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  400. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  401. package/dist/pipeline/handler-context-notify.js +2 -0
  402. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  403. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  404. package/dist/pipeline/handler-context-projection.js +39 -0
  405. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  406. package/dist/pipeline/handler-context-scope.js +14 -2
  407. package/dist/pipeline/index.d.ts +1 -1
  408. package/dist/pipeline/index.js +1 -1
  409. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  410. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  411. package/dist/pipeline/member-reader.js +4 -2
  412. package/dist/pipeline/msp-rebuild.js +1 -1
  413. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  414. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  415. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  416. package/dist/pipeline/projection-rebuild.js +16 -7
  417. package/dist/pipeline/projection-state.js +4 -6
  418. package/dist/pipeline/system-hooks.js +36 -6
  419. package/dist/pipeline/write-result-masking.js +31 -3
  420. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  421. package/dist/pipeline/write-transition-guard.js +95 -0
  422. package/dist/schema-cli/shared.d.ts +2 -0
  423. package/dist/schema-cli/shared.js +4 -2
  424. package/dist/schema-cli/validate-command.js +43 -28
  425. package/dist/search/meilisearch-adapter.js +14 -9
  426. package/dist/search/reindex-entity.d.ts +2 -0
  427. package/dist/search/reindex-entity.js +32 -4
  428. package/dist/search/reindex-tenants-search.js +20 -4
  429. package/dist/time/tz-context.js +1 -1
  430. package/dist/ui-types/card-column-roles.d.ts +4 -0
  431. package/dist/ui-types/card-column-roles.js +6 -3
  432. package/dist/ui-types/index.d.ts +2 -2
  433. package/dist/ui-types/index.js +1 -1
  434. package/dist/utils/ids.js +0 -1
  435. package/dist/utils/index.d.ts +1 -0
  436. package/dist/utils/index.js +1 -0
  437. package/dist/utils/return-path-limit.d.ts +1 -0
  438. package/dist/utils/return-path-limit.js +1 -0
  439. package/package.json +5 -3
  440. package/presets/biome-app.json +39 -21
  441. package/presets/biome-plugins/admin-api.grit +10 -0
  442. package/presets/biome-plugins/error-reasons.grit +53 -0
  443. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  444. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  445. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  446. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  447. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  448. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  449. package/presets/biome-plugins/no-date-api.grit +9 -0
  450. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  451. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  452. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  453. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  454. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  455. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  456. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  457. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  458. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  459. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  460. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  461. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  462. package/presets/biome-plugins/test-title.grit +20 -0
  463. package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
  464. package/presets/biome-rules.json +465 -0
  465. package/src/changes.json +309 -0
  466. package/dist/engine/minor-units.d.ts +0 -2
  467. package/dist/engine/minor-units.js +0 -8
@@ -0,0 +1,42 @@
1
+ export const LIST_SORT_SUMMARY_RULES = {
2
+ sortOptionNotSortable: {
3
+ id: "list/sort-option-not-sortable",
4
+ summary: "Every sortOptions field is a listed, sortable column (entityList); a projectionList's query takes sort and sortDirection and, when sort is an enum, lists every option field.",
5
+ fix: "Mark the field sortable and list it as a column, or give the projectionList's query sort and sortDirection parameters that accept the option fields.",
6
+ },
7
+ sortOptionsInvalid: {
8
+ id: "list/sort-options-invalid",
9
+ summary: "sortOptions is not empty and lists each field and dir once.",
10
+ fix: "Remove sortOptions, or list each field and dir pair once.",
11
+ },
12
+ sortOptionsDefaultNotListed: {
13
+ id: "list/sort-options-default-not-listed",
14
+ summary: "A defaultSort is one of the sortOptions, so the select opens on an entry.",
15
+ fix: "Add the defaultSort field and dir to sortOptions or change defaultSort.",
16
+ },
17
+ summaryRowShape: {
18
+ id: "list/summary-row-shape",
19
+ summary: "table.summaryRow is an object with a query string and optional params object.",
20
+ fix: 'Write table.summaryRow as { query: "feature:query:order:summary" }.',
21
+ },
22
+ summaryRowQueryUnknown: {
23
+ id: "list/summary-row-query-unknown",
24
+ summary: "table.summaryRow.query names a registered query handler.",
25
+ fix: "Use the qualified name of a query handler (feature:query:name) or remove summaryRow.",
26
+ },
27
+ summaryRowQueryAcceptsListKeys: {
28
+ id: "list/summary-row-query-accepts-list-keys",
29
+ summary: "The summaryRow query's Zod schema accepts every list key the screen sends (search, namedFilter, filters).",
30
+ fix: "Add the missing keys to the query schema (or reuse the list query's filter shape) and apply them, or drop the feature on the screen.",
31
+ },
32
+ summaryRowWithTotals: {
33
+ id: "list/summary-row-with-totals",
34
+ summary: "A table sets summaryRow or totals, not both; two footers under one table read as two answers.",
35
+ fix: "Drop totals and put the figures into the summary query, or drop summaryRow.",
36
+ },
37
+ summaryRowOnRelatedList: {
38
+ id: "list/summary-row-on-related-list",
39
+ summary: "A relatedList section or expandableRow sets no table.summaryRow; only entityList and projectionList screens have a list payload to carry it.",
40
+ fix: "Remove summaryRow from the relatedList, or put the summary on the list screen itself.",
41
+ },
42
+ };
@@ -0,0 +1,5 @@
1
+ import type { FeatureDefinition } from "../types/index.ts";
2
+ export declare function validateSummaryRowShape(where: string, summaryRow: unknown): void;
3
+ /** `where` is the full message prefix, as for validateListTableOptions. */
4
+ export declare function rejectSummaryRowOnRelatedList(where: string, table: unknown): void;
5
+ export declare function validateListSortAndSummary(features: readonly FeatureDefinition[]): void;
@@ -0,0 +1,149 @@
1
+ import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
2
+ import { LIST_TABLE_SUMMARY_ROW_KEYS } from "../types/screen.js";
3
+ import { bootRuleError } from "./boot-rule.js";
4
+ import { hasFilterableFields } from "./entity-list-screens.js";
5
+ import { LIST_SORT_SUMMARY_RULES } from "./list-sort-summary-rules.js";
6
+ import { rejectUnknownKeys } from "./list-table-reject-unknown-keys.js";
7
+ import { buildQueryHandlerMap, schemaAccepts } from "./projection-list-screens.js";
8
+ import { getZodObjectShape, getZodStringLiterals } from "./zod-shape.js";
9
+ export function validateSummaryRowShape(where, summaryRow) {
10
+ if (!isPlainObject(summaryRow)) {
11
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowShape, {
12
+ message: `${where} table.summaryRow must be an object like { query: "feature:query:order:summary" }.`,
13
+ });
14
+ }
15
+ rejectUnknownKeys(where, "table.summaryRow", summaryRow, LIST_TABLE_SUMMARY_ROW_KEYS);
16
+ if (typeof summaryRow["query"] !== "string" || summaryRow["query"] === "") {
17
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowShape, {
18
+ message: `${where} table.summaryRow.query must be a qualified query name.`,
19
+ });
20
+ }
21
+ if (summaryRow["params"] !== undefined && !isPlainObject(summaryRow["params"])) {
22
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowShape, {
23
+ message: `${where} table.summaryRow.params must be an object.`,
24
+ });
25
+ }
26
+ }
27
+ /** `where` is the full message prefix, as for validateListTableOptions. */
28
+ export function rejectSummaryRowOnRelatedList(where, table) {
29
+ if (isPlainObject(table) && table["summaryRow"] !== undefined) {
30
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowOnRelatedList, {
31
+ message: `${where} sets table.summaryRow, but a relatedList has no list payload to carry it. Remove it or summarise on the list screen.`,
32
+ });
33
+ }
34
+ }
35
+ function entityListKeysSent(feature, screen) {
36
+ const entity = feature.entities?.[screen.entity];
37
+ const searchable = screen.searchable ??
38
+ Object.values(entity?.fields ?? {}).some((f) => "searchable" in f && f.searchable === true);
39
+ const hasRangeFacet = Object.values(screen.facets ?? {}).some((facet) => facet !== false && facet.display === "range");
40
+ const filters = hasFilterableFields(feature, screen.entity) ||
41
+ screen.defaultFilters !== undefined ||
42
+ hasRangeFacet;
43
+ return [...(searchable ? ["search"] : []), ...(filters ? ["filters"] : [])];
44
+ }
45
+ function projectionListKeysSent(screen, queryHandlers) {
46
+ const listSchema = queryHandlers.get(screen.query)?.schema;
47
+ const searchable = screen.searchable !== false && schemaAccepts(listSchema, "search");
48
+ return [...(searchable ? ["search"] : []), ...(screen.facets !== undefined ? ["filters"] : [])];
49
+ }
50
+ // The keys the list sends for what the screen declares (mirrors the renderer); the summary query
51
+ // gets the same ones so its numbers follow the narrowing the user sees.
52
+ function listKeysSentBy(feature, screen, queryHandlers) {
53
+ const own = [
54
+ ...(screen.namedFilters !== undefined ? ["namedFilter"] : []),
55
+ ...(screen.filter !== undefined ? ["filter"] : []),
56
+ ];
57
+ const derived = screen.type === "entityList"
58
+ ? entityListKeysSent(feature, screen)
59
+ : projectionListKeysSent(screen, queryHandlers);
60
+ return [...derived, ...own];
61
+ }
62
+ function validateSummaryRowQuery(prefix, feature, screen, summaryRow, queryHandlers) {
63
+ const handler = queryHandlers.get(summaryRow.query);
64
+ if (handler === undefined) {
65
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowQueryUnknown, {
66
+ message: `${prefix}: table.summaryRow.query "${summaryRow.query}" is not a registered query handler.`,
67
+ });
68
+ }
69
+ const shape = getZodObjectShape(handler.schema);
70
+ const missing = listKeysSentBy(feature, screen, queryHandlers).filter((key) => shape === undefined || !(key in shape));
71
+ if (missing.length === 0)
72
+ return;
73
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowQueryAcceptsListKeys, {
74
+ message: `${prefix}: table.summaryRow.query "${summaryRow.query}" must accept ${missing.map((key) => `"${key}"`).join(", ")} ` +
75
+ `in its Zod schema because the list sends them - add them to the schema or drop them from the screen.`,
76
+ });
77
+ }
78
+ // The query is the only thing that can order a projection; without sort and sortDirection in its schema
79
+ // every pick from the select would 422.
80
+ function validateProjectionSortOptions(prefix, screen, queryHandlers) {
81
+ const options = screen.sortOptions ?? [];
82
+ // skip: no sortOptions declared
83
+ if (options.length === 0)
84
+ return;
85
+ const shape = getZodObjectShape(queryHandlers.get(screen.query)?.schema);
86
+ if (shape === undefined || !("sort" in shape) || !("sortDirection" in shape)) {
87
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionNotSortable, {
88
+ message: `${prefix}: sortOptions need query "${screen.query}" to accept "sort" and "sortDirection" ` +
89
+ `in its Zod schema - add them and order by them, or remove sortOptions.`,
90
+ });
91
+ }
92
+ // A closed enum of sortable fields is the one case where the schema can be checked per option.
93
+ const accepted = getZodStringLiterals(shape["sort"]);
94
+ // skip: "sort" is an open string, nothing to compare the options against
95
+ if (accepted === undefined)
96
+ return;
97
+ const rejected = options.find((option) => !accepted.includes(option.field));
98
+ if (rejected !== undefined) {
99
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionNotSortable, {
100
+ message: `${prefix}: sortOptions field "${rejected.field}" is not one of the values query "${screen.query}" ` +
101
+ `accepts for "sort" (${accepted.join(", ")}) - every pick would fail with a 422.`,
102
+ });
103
+ }
104
+ }
105
+ function validateSortOptionsList(prefix, screen) {
106
+ const options = screen.sortOptions;
107
+ // skip: no sortOptions declared
108
+ if (options === undefined)
109
+ return;
110
+ if (options.length === 0) {
111
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionsInvalid, {
112
+ message: `${prefix}: sortOptions is empty - list at least one option or remove sortOptions.`,
113
+ });
114
+ }
115
+ const seen = new Set();
116
+ for (const option of options) {
117
+ const key = `${option.field}\u0000${option.dir}`;
118
+ if (seen.has(key)) {
119
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionsInvalid, {
120
+ message: `${prefix}: sortOptions lists field "${option.field}" with dir "${option.dir}" twice.`,
121
+ });
122
+ }
123
+ seen.add(key);
124
+ }
125
+ const defaultSort = screen.defaultSort;
126
+ if (defaultSort !== undefined &&
127
+ !options.some((o) => o.field === defaultSort.field && o.dir === defaultSort.dir)) {
128
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionsDefaultNotListed, {
129
+ message: `${prefix}: defaultSort { field: "${defaultSort.field}", dir: "${defaultSort.dir}" } is not one of the sortOptions, so the select would open on no entry. Add it to sortOptions.`,
130
+ });
131
+ }
132
+ }
133
+ export function validateListSortAndSummary(features) {
134
+ const queryHandlers = buildQueryHandlerMap(features);
135
+ for (const feature of features) {
136
+ for (const screen of Object.values(feature.screens)) {
137
+ if (screen.type !== "entityList" && screen.type !== "projectionList")
138
+ continue;
139
+ const prefix = `[${screen.type}] Feature "${feature.name}" screen "${screen.id}"`;
140
+ validateSortOptionsList(prefix, screen);
141
+ if (screen.type === "projectionList") {
142
+ validateProjectionSortOptions(prefix, screen, queryHandlers);
143
+ }
144
+ if (screen.table?.summaryRow !== undefined) {
145
+ validateSummaryRowQuery(prefix, feature, screen, screen.table.summaryRow, queryHandlers);
146
+ }
147
+ }
148
+ }
149
+ }
@@ -1,8 +1,10 @@
1
1
  import { isOneOf, isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
2
2
  import { normalizeListColumn } from "../screen-helpers.js";
3
- import { LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_OPTION_KEYS, } from "../types/screen.js";
3
+ import { LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_OPTION_KEYS, } from "../types/screen.js";
4
4
  import { bootRuleError } from "./boot-rule.js";
5
5
  import { validateColumnLayout } from "./list-column-layout.js";
6
+ import { validateSummaryRowShape } from "./list-sort-summary.js";
7
+ import { LIST_SORT_SUMMARY_RULES } from "./list-sort-summary-rules.js";
6
8
  import { validateListTableAggregateShape } from "./list-table-aggregate-options.js";
7
9
  import { validateExportOptions } from "./list-table-export-options.js";
8
10
  import { rejectUnknownKeys } from "./list-table-reject-unknown-keys.js";
@@ -88,11 +90,23 @@ export function validateListTableOptions(where, table, columns, exportAllowed =
88
90
  });
89
91
  }
90
92
  }
93
+ if (table["frame"] !== undefined && !isOneOf(LIST_TABLE_FRAMES, table["frame"])) {
94
+ throw bootRuleError(LIST_TABLE_RULES.frameInvalid, {
95
+ message: `${where} table.frame is ${JSON.stringify(table["frame"])} — must be one of ${LIST_TABLE_FRAMES.map((f) => `"${f}"`).join(", ")}.`,
96
+ });
97
+ }
91
98
  if (table["density"] !== undefined)
92
99
  validateDensity(where, table["density"]);
93
100
  if (table["export"] !== undefined)
94
101
  validateExportOptions(where, table["export"], exportAllowed);
95
102
  validateListTableAggregateShape(where, table, columns);
103
+ if (table["summaryRow"] !== undefined)
104
+ validateSummaryRowShape(where, table["summaryRow"]);
105
+ if (table["summaryRow"] !== undefined && table["totals"] !== undefined) {
106
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowWithTotals, {
107
+ message: `${where} sets table.summaryRow and table.totals; a table has one footer. Keep one of them.`,
108
+ });
109
+ }
96
110
  validateHiddenColumns(where, table["columnPicker"] === true, columns);
97
111
  validateColumnLayout(where, { pinning: table["pinning"] === true, resizing: table["resizing"] === true }, columns);
98
112
  }
@@ -14,6 +14,11 @@ export declare const LIST_TABLE_RULES: {
14
14
  readonly summary: "The boolean table switches (rememberState, columnPicker, pinning, ...) are booleans.";
15
15
  readonly fix: "Set the table option to true or false.";
16
16
  };
17
+ readonly frameInvalid: {
18
+ readonly id: "list-table/frame-invalid";
19
+ readonly summary: "table.frame is one of the known frames.";
20
+ readonly fix: 'Use "card" or remove table.frame.';
21
+ };
17
22
  readonly densityNotObject: {
18
23
  readonly id: "list-table/density-not-object";
19
24
  readonly summary: "table.density is an object.";
@@ -86,12 +91,12 @@ export declare const LIST_TABLE_RULES: {
86
91
  };
87
92
  readonly columnWidthInvalid: {
88
93
  readonly id: "list-table/column-width-invalid";
89
- readonly summary: "A column's width and minWidth are finite pixel counts greater than 0.";
90
- readonly fix: "Set a positive finite number or remove the option.";
94
+ readonly summary: "A column's width and minWidth are finite pixel counts greater than 0 and at most 2000.";
95
+ readonly fix: "Set a positive finite number up to 2000 or remove the option.";
91
96
  };
92
97
  readonly columnWidthWithoutResizing: {
93
98
  readonly id: "list-table/column-width-without-resizing";
94
- readonly summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect.";
99
+ readonly summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect; a hint column is exempt.";
95
100
  readonly fix: "Set table: { resizing: true } or remove width and minWidth from the column.";
96
101
  };
97
102
  readonly columnMinWidthExceedsWidth: {
@@ -116,8 +121,8 @@ export declare const LIST_TABLE_RULES: {
116
121
  };
117
122
  readonly bundledListsScreenOnlyKey: {
118
123
  readonly id: "bundled-lists/screen-only-table-key";
119
- readonly summary: "bundledLists.table leaves out grouping and totals, which depend on one list's fields.";
120
- readonly fix: "Set grouping and totals in the table block of the individual screen.";
124
+ readonly summary: "bundledLists.table leaves out grouping, totals and summaryRow, which depend on one list's fields or query.";
125
+ readonly fix: "Set grouping, totals and summaryRow in the table block of the individual screen.";
121
126
  };
122
127
  readonly bundledListsPinFirstColumnNotBoolean: {
123
128
  readonly id: "bundled-lists/pin-first-column-not-boolean";
@@ -14,6 +14,11 @@ export const LIST_TABLE_RULES = {
14
14
  summary: "The boolean table switches (rememberState, columnPicker, pinning, ...) are booleans.",
15
15
  fix: "Set the table option to true or false.",
16
16
  },
17
+ frameInvalid: {
18
+ id: "list-table/frame-invalid",
19
+ summary: "table.frame is one of the known frames.",
20
+ fix: 'Use "card" or remove table.frame.',
21
+ },
17
22
  densityNotObject: {
18
23
  id: "list-table/density-not-object",
19
24
  summary: "table.density is an object.",
@@ -86,12 +91,12 @@ export const LIST_TABLE_RULES = {
86
91
  },
87
92
  columnWidthInvalid: {
88
93
  id: "list-table/column-width-invalid",
89
- summary: "A column's width and minWidth are finite pixel counts greater than 0.",
90
- fix: "Set a positive finite number or remove the option.",
94
+ summary: "A column's width and minWidth are finite pixel counts greater than 0 and at most 2000.",
95
+ fix: "Set a positive finite number up to 2000 or remove the option.",
91
96
  },
92
97
  columnWidthWithoutResizing: {
93
98
  id: "list-table/column-width-without-resizing",
94
- summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect.",
99
+ summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect; a hint column is exempt.",
95
100
  fix: "Set table: { resizing: true } or remove width and minWidth from the column.",
96
101
  },
97
102
  columnMinWidthExceedsWidth: {
@@ -116,8 +121,8 @@ export const LIST_TABLE_RULES = {
116
121
  },
117
122
  bundledListsScreenOnlyKey: {
118
123
  id: "bundled-lists/screen-only-table-key",
119
- summary: "bundledLists.table leaves out grouping and totals, which depend on one list's fields.",
120
- fix: "Set grouping and totals in the table block of the individual screen.",
124
+ summary: "bundledLists.table leaves out grouping, totals and summaryRow, which depend on one list's fields or query.",
125
+ fix: "Set grouping, totals and summaryRow in the table block of the individual screen.",
121
126
  },
122
127
  bundledListsPinFirstColumnNotBoolean: {
123
128
  id: "bundled-lists/pin-first-column-not-boolean",
@@ -0,0 +1,10 @@
1
+ type ListToolbarOptionScreen = {
2
+ readonly toolbarSort?: true;
3
+ readonly narrowFacets?: unknown;
4
+ readonly sortOptions?: readonly unknown[];
5
+ readonly toolbarActionsPlacement?: unknown;
6
+ readonly toolbarActions?: readonly unknown[];
7
+ };
8
+ /** Toolbar options shared by entityList and projectionList. */
9
+ export declare function validateListToolbarOptions(where: string, screen: ListToolbarOptionScreen): void;
10
+ export {};
@@ -0,0 +1,31 @@
1
+ import { LIST_NARROW_FACETS } from "@cosmicdrift/kumiko-types/screen";
2
+ import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
3
+ import { bootRuleError } from "./boot-rule.js";
4
+ import { SCREEN_KIND_RULES } from "./screens-kind-rules.js";
5
+ const TOOLBAR_ACTIONS_PLACEMENTS = ["header", "toolbar"];
6
+ /** Toolbar options shared by entityList and projectionList. */
7
+ export function validateListToolbarOptions(where, screen) {
8
+ if (screen.toolbarSort === true && (screen.sortOptions ?? []).length === 0) {
9
+ throw bootRuleError(SCREEN_KIND_RULES.toolbarSortWithoutSortOptions, {
10
+ message: `${where} sets toolbarSort without sortOptions — the select lists the sortOptions. Declare sortOptions or remove toolbarSort.`,
11
+ });
12
+ }
13
+ if (screen.narrowFacets !== undefined && !isOneOf(LIST_NARROW_FACETS, screen.narrowFacets)) {
14
+ throw bootRuleError(SCREEN_KIND_RULES.narrowFacetsInvalid, {
15
+ message: `${where} sets narrowFacets ${JSON.stringify(screen.narrowFacets)} — must be "pills".`,
16
+ });
17
+ }
18
+ const placement = screen.toolbarActionsPlacement;
19
+ if (placement === undefined)
20
+ return;
21
+ if (!isOneOf(TOOLBAR_ACTIONS_PLACEMENTS, placement)) {
22
+ throw bootRuleError(SCREEN_KIND_RULES.toolbarActionsPlacementInvalid, {
23
+ message: `${where} sets toolbarActionsPlacement ${JSON.stringify(placement)} — must be "header" or "toolbar".`,
24
+ });
25
+ }
26
+ if (placement === "toolbar" && (screen.toolbarActions ?? []).length === 0) {
27
+ throw bootRuleError(SCREEN_KIND_RULES.toolbarActionsPlacementWithoutActions, {
28
+ message: `${where} sets toolbarActionsPlacement "toolbar" without toolbarActions — there is nothing to place. Declare toolbarActions or remove toolbarActionsPlacement.`,
29
+ });
30
+ }
31
+ }
@@ -4,10 +4,40 @@ export declare const NAMED_FILTER_RULES: {
4
4
  readonly summary: "A projectionList with namedFilters binds a query whose schema has a namedFilter key.";
5
5
  readonly fix: "Add namedFilter: z.string().optional() to the query schema, resolve it with resolveNamedListFilters and pass the conditions into executor.list filters, the only path that applies field-read and PII guards.";
6
6
  };
7
+ readonly projectionQueryAcceptsCount: {
8
+ readonly id: "named-filter/projection-query-accepts-count";
9
+ readonly summary: "A projectionList with namedFilterFacet.showCounts binds a query whose schema has limit and totalCount keys.";
10
+ readonly fix: "Add limit and totalCount: z.boolean().optional() to the query schema and return the total, or drop showCounts.";
11
+ };
12
+ readonly projectionQueryAcceptsSort: {
13
+ readonly id: "named-filter/projection-query-accepts-sort";
14
+ readonly summary: "A projectionList whose namedFilter sets a sort binds a query whose schema has sort and sortDirection keys.";
15
+ readonly fix: "Add sort: z.enum([...sortable fields]) and sortDirection to the query schema and order by them, or remove sort from the named filter.";
16
+ };
17
+ readonly filterSortNotListed: {
18
+ readonly id: "list/named-filter-sort-not-listed";
19
+ readonly summary: "A named filter's sort.field is one of the listed columns.";
20
+ readonly fix: "Pick a field from columns or add it there.";
21
+ };
22
+ readonly filterSortNotSortable: {
23
+ readonly id: "list/named-filter-sort-not-sortable";
24
+ readonly summary: "A named filter's sort column is sortable.";
25
+ readonly fix: "Mark the field sortable or pick another sort field.";
26
+ };
27
+ readonly facetWithoutFilters: {
28
+ readonly id: "list/named-filter-facet-without-filters";
29
+ readonly summary: "namedFilterFacet only presents the screen's namedFilters.";
30
+ readonly fix: "Declare namedFilters on the screen or remove namedFilterFacet.";
31
+ };
32
+ readonly emptyStateTitleEmpty: {
33
+ readonly id: "list/named-filter-empty-state-title-empty";
34
+ readonly summary: "A named filter's emptyState.title is a non-empty i18n key.";
35
+ readonly fix: "Name the title key or remove emptyState from the filter.";
36
+ };
7
37
  readonly statNavigateTarget: {
8
38
  readonly id: "named-filter/stat-navigate-target";
9
- readonly summary: "A stat navigate.screen resolves to an entityList or projectionList screen.";
10
- readonly fix: "Point navigate.screen at a registered list screen.";
39
+ readonly summary: "A stat navigate.screen resolves to an entityList, projectionList or custom screen.";
40
+ readonly fix: "Point navigate.screen at a registered list or custom screen.";
11
41
  };
12
42
  readonly statNavigateFilterDeclared: {
13
43
  readonly id: "named-filter/stat-navigate-filter-declared";
@@ -4,10 +4,40 @@ export const NAMED_FILTER_RULES = {
4
4
  summary: "A projectionList with namedFilters binds a query whose schema has a namedFilter key.",
5
5
  fix: "Add namedFilter: z.string().optional() to the query schema, resolve it with resolveNamedListFilters and pass the conditions into executor.list filters, the only path that applies field-read and PII guards.",
6
6
  },
7
+ projectionQueryAcceptsCount: {
8
+ id: "named-filter/projection-query-accepts-count",
9
+ summary: "A projectionList with namedFilterFacet.showCounts binds a query whose schema has limit and totalCount keys.",
10
+ fix: "Add limit and totalCount: z.boolean().optional() to the query schema and return the total, or drop showCounts.",
11
+ },
12
+ projectionQueryAcceptsSort: {
13
+ id: "named-filter/projection-query-accepts-sort",
14
+ summary: "A projectionList whose namedFilter sets a sort binds a query whose schema has sort and sortDirection keys.",
15
+ fix: "Add sort: z.enum([...sortable fields]) and sortDirection to the query schema and order by them, or remove sort from the named filter.",
16
+ },
17
+ filterSortNotListed: {
18
+ id: "list/named-filter-sort-not-listed",
19
+ summary: "A named filter's sort.field is one of the listed columns.",
20
+ fix: "Pick a field from columns or add it there.",
21
+ },
22
+ filterSortNotSortable: {
23
+ id: "list/named-filter-sort-not-sortable",
24
+ summary: "A named filter's sort column is sortable.",
25
+ fix: "Mark the field sortable or pick another sort field.",
26
+ },
27
+ facetWithoutFilters: {
28
+ id: "list/named-filter-facet-without-filters",
29
+ summary: "namedFilterFacet only presents the screen's namedFilters.",
30
+ fix: "Declare namedFilters on the screen or remove namedFilterFacet.",
31
+ },
32
+ emptyStateTitleEmpty: {
33
+ id: "list/named-filter-empty-state-title-empty",
34
+ summary: "A named filter's emptyState.title is a non-empty i18n key.",
35
+ fix: "Name the title key or remove emptyState from the filter.",
36
+ },
7
37
  statNavigateTarget: {
8
38
  id: "named-filter/stat-navigate-target",
9
- summary: "A stat navigate.screen resolves to an entityList or projectionList screen.",
10
- fix: "Point navigate.screen at a registered list screen.",
39
+ summary: "A stat navigate.screen resolves to an entityList, projectionList or custom screen.",
40
+ fix: "Point navigate.screen at a registered list or custom screen.",
11
41
  },
12
42
  statNavigateFilterDeclared: {
13
43
  id: "named-filter/stat-navigate-filter-declared",
@@ -61,7 +61,16 @@ export function validateOwnershipBoot(features) {
61
61
  // undefined corpus = "this caller cannot answer that question", not "skip the
62
62
  // check" — see validateOwnershipBoot. validateBoot passes the real corpora.
63
63
  export function validateOwnershipRules(feature, allClaimKeys, knownRoles) {
64
- for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
64
+ // A read model's access.read is the file-owner gate (readGate.fileOwner), so it gets the same
65
+ // role/column/where-lint pass as a registered entity.
66
+ const readModelEntities = Object.values(feature.projections ?? {}).flatMap((projection) => !projection.isImplicit &&
67
+ projection.entity !== undefined &&
68
+ typeof projection.source === "string" &&
69
+ feature.entities?.[projection.source] === undefined
70
+ ? [[projection.source, projection.entity]]
71
+ : []);
72
+ const entries = [...Object.entries(feature.entities ?? {}), ...readModelEntities];
73
+ for (const [entityName, entity] of entries) {
65
74
  const columnNames = new Set(Object.keys(entity.fields));
66
75
  // Framework-managed columns that rules are allowed to reference too.
67
76
  // These are the base columns buildEntityTable adds unconditionally.
@@ -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 { findEntity } from "../find-entity.js";
3
3
  import { bootRuleError } from "./boot-rule.js";
4
4
  import { ENTITY_DECLARATION_RULES } from "./entity-declaration-rules.js";
@@ -19,60 +19,97 @@ function findQueryHandler(featureMap, handlerName) {
19
19
  }
20
20
  return undefined;
21
21
  }
22
- export function validateParentRefs(feature, featureMap) {
23
- for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
24
- const parentRef = entity.parentRef;
25
- if (parentRef === undefined)
26
- continue;
27
- if (entity.fields[parentRef.entityTypeField] === undefined) {
28
- throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefTypeFieldUnknown, {
29
- message: `[Kumiko ParentRef] entity "${entityName}".parentRef.entityTypeField references ` +
30
- `"${parentRef.entityTypeField}" — which is not a declared field on "${entityName}" ` +
31
- `(feature: "${feature.name}"). Fix: point entityTypeField at a real field on the entity.`,
22
+ function findWriteHandler(featureMap, handlerName) {
23
+ for (const f of featureMap.values()) {
24
+ const handler = f.writeHandlers[handlerName];
25
+ if (handler)
26
+ return handler;
27
+ }
28
+ return undefined;
29
+ }
30
+ function assertParentRefFields(feature, entityName, entity, parentRef) {
31
+ if (entity.fields[parentRef.entityTypeField] === undefined) {
32
+ throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefTypeFieldUnknown, {
33
+ message: `[Kumiko ParentRef] entity "${entityName}".parentRef.entityTypeField references ` +
34
+ `"${parentRef.entityTypeField}" — which is not a declared field on "${entityName}" ` +
35
+ `(feature: "${feature.name}"). Fix: point entityTypeField at a real field on the entity.`,
36
+ });
37
+ }
38
+ if (entity.fields[parentRef.entityIdField] === undefined) {
39
+ throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefIdFieldUnknown, {
40
+ message: `[Kumiko ParentRef] entity "${entityName}".parentRef.entityIdField references ` +
41
+ `"${parentRef.entityIdField}" — which is not a declared field on "${entityName}" ` +
42
+ `(feature: "${feature.name}"). Fix: point entityIdField at a real field on the entity.`,
43
+ });
44
+ }
45
+ }
46
+ function assertAllowedTypeHosts(feature, featureMap, entityName, parentRef) {
47
+ for (const hostName of parentRef.allowedTypes ?? []) {
48
+ const host = findEntity(featureMap, hostName);
49
+ if (host === undefined) {
50
+ throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefAllowedTypeUnregistered, {
51
+ message: `[Kumiko ParentRef] entity "${entityName}".parentRef.allowedTypes names "${hostName}" ` +
52
+ `— no entity with that name is registered in this feature set (feature: ` +
53
+ `"${feature.name}"). Fix: remove "${hostName}" from allowedTypes, or register it.`,
32
54
  });
33
55
  }
34
- if (entity.fields[parentRef.entityIdField] === undefined) {
35
- throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefIdFieldUnknown, {
36
- message: `[Kumiko ParentRef] entity "${entityName}".parentRef.entityIdField references ` +
37
- `"${parentRef.entityIdField}" — which is not a declared field on "${entityName}" ` +
38
- `(feature: "${feature.name}"). Fix: point entityIdField at a real field on the entity.`,
56
+ if (host.parentRef !== undefined) {
57
+ throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefAllowedTypeHasParentRef, {
58
+ message: `[Kumiko ParentRef] entity "${entityName}".parentRef.allowedTypes names "${hostName}" ` +
59
+ `— which itself declares a parentRef (feature: "${feature.name}"). A join-row ` +
60
+ `entity can't act as a host for another join-row entity (no recursive gating). ` +
61
+ `Fix: remove "${hostName}" from allowedTypes, or drop its own parentRef.`,
39
62
  });
40
63
  }
41
- for (const hostName of parentRef.allowedTypes ?? []) {
42
- const host = findEntity(featureMap, hostName);
43
- if (host === undefined) {
44
- throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefAllowedTypeUnregistered, {
45
- message: `[Kumiko ParentRef] entity "${entityName}".parentRef.allowedTypes names "${hostName}" ` +
46
- `— no entity with that name is registered in this feature set (feature: ` +
47
- `"${feature.name}"). Fix: remove "${hostName}" from allowedTypes, or register it.`,
48
- });
49
- }
50
- if (host.parentRef !== undefined) {
51
- throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefAllowedTypeHasParentRef, {
52
- message: `[Kumiko ParentRef] entity "${entityName}".parentRef.allowedTypes names "${hostName}" ` +
53
- `— which itself declares a parentRef (feature: "${feature.name}"). A join-row ` +
54
- `entity can't act as a host for another join-row entity (no recursive gating). ` +
55
- `Fix: remove "${hostName}" from allowedTypes, or drop its own parentRef.`,
56
- });
57
- }
64
+ }
65
+ }
66
+ function assertConventionQueryHandlers(feature, featureMap, entityName) {
67
+ for (const verb of ["list", "detail"]) {
68
+ const handlerName = `${entityName}:${verb}`;
69
+ const handler = findQueryHandler(featureMap, handlerName);
70
+ // skip: no handler registered for this verb — nothing to brand-check
71
+ if (handler === undefined)
72
+ continue;
73
+ if (handler[ENTITY_CONVENTION_QUERY_BRAND] !== true) {
74
+ throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefHandWrittenQuery, {
75
+ message: `[Kumiko ParentRef] query handler "${handlerName}" does not carry ` +
76
+ `ENTITY_CONVENTION_QUERY_BRAND, but entity "${entityName}" declares a parentRef ` +
77
+ `(feature: "${feature.name}"). A hand-written handler bypasses the parent-ref ` +
78
+ `read-gate unless it explicitly wires parentVisibility. Fix: register "${handlerName}" ` +
79
+ `via defineEntityListHandler/defineEntityDetailHandler (or defineEntityQueryHandler), ` +
80
+ `or pass { parentVisibility: { entities: ctx.registry.getAllEntities() } } to ` +
81
+ `executor.${verb} yourself.`,
82
+ });
58
83
  }
59
- for (const verb of ["list", "detail"]) {
60
- const handlerName = `${entityName}:${verb}`;
61
- const handler = findQueryHandler(featureMap, handlerName);
62
- // skip: no handler registered for this verb — nothing to brand-check
63
- if (handler === undefined)
64
- continue;
65
- if (handler[ENTITY_CONVENTION_QUERY_BRAND] !== true) {
66
- throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefHandWrittenQuery, {
67
- message: `[Kumiko ParentRef] query handler "${handlerName}" does not carry ` +
68
- `ENTITY_CONVENTION_QUERY_BRAND, but entity "${entityName}" declares a parentRef ` +
69
- `(feature: "${feature.name}"). A hand-written handler bypasses the parent-ref ` +
70
- `read-gate unless it explicitly wires parentVisibility. Fix: register "${handlerName}" ` +
71
- `via defineEntityListHandler/defineEntityDetailHandler (or defineEntityQueryHandler), ` +
72
- `or pass { parentVisibility: { entities: ctx.registry.getAllEntities() } } to ` +
73
- `executor.${verb} yourself.`,
74
- });
75
- }
84
+ }
85
+ }
86
+ function assertConventionWriteHandlers(feature, featureMap, entityName) {
87
+ for (const verb of ["update", "delete", "restore"]) {
88
+ const handlerName = `${entityName}:${verb}`;
89
+ const handler = findWriteHandler(featureMap, handlerName);
90
+ // skip: no handler registered for this verb — nothing to brand-check
91
+ if (handler === undefined)
92
+ continue;
93
+ if (handler[ENTITY_CONVENTION_WRITE_BRAND] !== true) {
94
+ throw bootRuleError(ENTITY_DECLARATION_RULES.parentRefHandWrittenWrite, {
95
+ message: `[Kumiko ParentRef] write handler "${handlerName}" does not carry ` +
96
+ `ENTITY_CONVENTION_WRITE_BRAND, but entity "${entityName}" declares a parentRef ` +
97
+ `(feature: "${feature.name}"). A hand-written handler bypasses the parent visibility ` +
98
+ `gate unless it explicitly wires parentVisibility. Fix: register "${handlerName}" ` +
99
+ `via defineEntityWriteHandler, or pass parentVisibility: ` +
100
+ `parentVisibilityFor(ctx, event.user) to executor.${verb} yourself.`,
101
+ });
76
102
  }
77
103
  }
78
104
  }
105
+ export function validateParentRefs(feature, featureMap) {
106
+ for (const [entityName, entity] of Object.entries(feature.entities ?? {})) {
107
+ const parentRef = entity.parentRef;
108
+ if (parentRef === undefined)
109
+ continue;
110
+ assertParentRefFields(feature, entityName, entity, parentRef);
111
+ assertAllowedTypeHosts(feature, featureMap, entityName, parentRef);
112
+ assertConventionQueryHandlers(feature, featureMap, entityName);
113
+ assertConventionWriteHandlers(feature, featureMap, entityName);
114
+ }
115
+ }
@@ -1,5 +1,6 @@
1
1
  import type { QueryHandlerDef } from "@cosmicdrift/kumiko-types/handlers";
2
2
  import type { FeatureDefinition } from "../types/index.ts";
3
3
  export declare function buildQueryHandlerMap(features: readonly FeatureDefinition[]): ReadonlyMap<string, QueryHandlerDef>;
4
+ export declare function schemaAccepts(schema: QueryHandlerDef["schema"] | undefined, key: string): boolean;
4
5
  export declare function validateProjectionListScreens(features: readonly FeatureDefinition[]): void;
5
6
  export declare function validateRelatedListSectionQueries(features: readonly FeatureDefinition[]): void;