@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
@@ -100,29 +100,6 @@ export function validateConfigKeyRequired(feature) {
100
100
  }
101
101
  }
102
102
  }
103
- // --- Config key allowPerRequest compatibility ---
104
- export function validateConfigKeyAllowPerRequest(feature) {
105
- for (const [keyName, keyDef] of Object.entries(feature.configKeys)) {
106
- if (!keyDef.allowPerRequest)
107
- continue;
108
- // text is hard-locked against per-request — the helper refuses
109
- // anyway, but declaring allowPerRequest on a text key is a
110
- // misconfiguration that should fail loudly at boot.
111
- if (keyDef.type === "text") {
112
- throw bootRuleError(CONFIG_KEY_RULES.perRequestText, {
113
- message: `[Feature ${feature.name}] Config key "${keyName}" has allowPerRequest=true but type="text" — text keys are permanently ineligible for per-request overrides (XSS/injection risk). Remove allowPerRequest or change the key type.`,
114
- });
115
- }
116
- // encrypted + per-request would expose a cipher-text interpretation
117
- // to query-strings. The secret-value shouldn't be transported this
118
- // way — reject as a paradigm-mismatch.
119
- if (isEncryptedAtRest(keyDef)) {
120
- throw bootRuleError(CONFIG_KEY_RULES.perRequestEncrypted, {
121
- message: `[Feature ${feature.name}] Config key "${keyName}" has allowPerRequest=true but encrypted/backing="secrets" — secret values may not be set via query-params`,
122
- });
123
- }
124
- }
125
- }
126
103
  // --- Config key optionsQuery compatibility ---
127
104
  export function validateConfigKeyOptionsQuery(feature) {
128
105
  for (const [keyName, keyDef] of Object.entries(feature.configKeys)) {
@@ -155,11 +132,6 @@ export function validateConfigKeyOptionsQuery(feature) {
155
132
  message: `${prefix} declares both options and optionsQuery — pick one`,
156
133
  });
157
134
  }
158
- if (keyDef.allowPerRequest) {
159
- throw bootRuleError(CONFIG_KEY_RULES.optionsQueryPerRequest, {
160
- message: `${prefix} has optionsQuery AND allowPerRequest=true — a per-request value would bypass the option set unchecked`,
161
- });
162
- }
163
135
  validateOptionsQueryKeyRefs(feature, keyName, keyDef);
164
136
  }
165
137
  }
@@ -34,16 +34,6 @@ export declare const CONFIG_KEY_RULES: {
34
34
  readonly summary: "A required config key has no non-empty default, otherwise it can never be unset and readiness never flags it.";
35
35
  readonly fix: 'Use default "" or drop required.';
36
36
  };
37
- readonly perRequestText: {
38
- readonly id: "config-key/per-request-text";
39
- readonly summary: 'A config key of type "text" does not set allowPerRequest (XSS/injection risk).';
40
- readonly fix: "Remove allowPerRequest or change the key type.";
41
- };
42
- readonly perRequestEncrypted: {
43
- readonly id: "config-key/per-request-encrypted";
44
- readonly summary: 'A config key with encrypted/backing="secrets" does not set allowPerRequest.';
45
- readonly fix: "Remove allowPerRequest or the secrets storage from the key.";
46
- };
47
37
  readonly conditionalOptions: {
48
38
  readonly id: "config-key/conditional-options";
49
39
  readonly summary: "A config key does not declare conditionalOptions, which only entity select fields support.";
@@ -69,11 +59,6 @@ export declare const CONFIG_KEY_RULES: {
69
59
  readonly summary: "A config key declares either static options or optionsQuery, not both.";
70
60
  readonly fix: "Remove options or optionsQuery.";
71
61
  };
72
- readonly optionsQueryPerRequest: {
73
- readonly id: "config-key/options-query-per-request";
74
- readonly summary: "A config key with optionsQuery does not set allowPerRequest, which would bypass the option set unchecked.";
75
- readonly fix: "Remove allowPerRequest or optionsQuery.";
76
- };
77
62
  readonly optionsQueryPayloadSelfReference: {
78
63
  readonly id: "config-key/options-query-payload-self-reference";
79
64
  readonly summary: "A config key's optionsQueryPayload does not reference the key itself.";
@@ -34,16 +34,6 @@ export const CONFIG_KEY_RULES = {
34
34
  summary: "A required config key has no non-empty default, otherwise it can never be unset and readiness never flags it.",
35
35
  fix: 'Use default "" or drop required.',
36
36
  },
37
- perRequestText: {
38
- id: "config-key/per-request-text",
39
- summary: 'A config key of type "text" does not set allowPerRequest (XSS/injection risk).',
40
- fix: "Remove allowPerRequest or change the key type.",
41
- },
42
- perRequestEncrypted: {
43
- id: "config-key/per-request-encrypted",
44
- summary: 'A config key with encrypted/backing="secrets" does not set allowPerRequest.',
45
- fix: "Remove allowPerRequest or the secrets storage from the key.",
46
- },
47
37
  conditionalOptions: {
48
38
  id: "config-key/conditional-options",
49
39
  summary: "A config key does not declare conditionalOptions, which only entity select fields support.",
@@ -69,11 +59,6 @@ export const CONFIG_KEY_RULES = {
69
59
  summary: "A config key declares either static options or optionsQuery, not both.",
70
60
  fix: "Remove options or optionsQuery.",
71
61
  },
72
- optionsQueryPerRequest: {
73
- id: "config-key/options-query-per-request",
74
- summary: "A config key with optionsQuery does not set allowPerRequest, which would bypass the option set unchecked.",
75
- fix: "Remove allowPerRequest or optionsQuery.",
76
- },
77
62
  optionsQueryPayloadSelfReference: {
78
63
  id: "config-key/options-query-payload-self-reference",
79
64
  summary: "A config key's optionsQueryPayload does not reference the key itself.",
@@ -0,0 +1,22 @@
1
+ import type { EntityListScreenDefinition, ProjectionListScreenDefinition } from "@cosmicdrift/kumiko-types/screen";
2
+ import type { FeatureDefinition } from "../types/index.ts";
3
+ export type ListTarget = {
4
+ readonly feature: FeatureDefinition;
5
+ readonly screen: EntityListScreenDefinition | ProjectionListScreenDefinition;
6
+ };
7
+ export type DashboardScreenTarget = {
8
+ readonly kind: "list";
9
+ readonly target: ListTarget;
10
+ } | {
11
+ readonly kind: "custom";
12
+ readonly screenId: string;
13
+ } | {
14
+ readonly kind: "other";
15
+ readonly qn: string;
16
+ readonly screenId: string;
17
+ } | {
18
+ readonly kind: "unresolved";
19
+ readonly qn: string;
20
+ };
21
+ export declare function resolveDashboardScreenTarget(featureName: string, screenRef: string, featureMap: ReadonlyMap<string, FeatureDefinition>): DashboardScreenTarget;
22
+ export declare function declaredNamedFilterIds(target: ListTarget): ReadonlySet<string>;
@@ -0,0 +1,20 @@
1
+ import { resolveScreenTargetQn } from "./screens-actions.js";
2
+ // One resolver for every dashboard link-like option (stat navigate, list footerLink, stat-group
3
+ // link), so they agree on what a screen reference points at.
4
+ export function resolveDashboardScreenTarget(featureName, screenRef, featureMap) {
5
+ const qn = resolveScreenTargetQn(featureName, screenRef);
6
+ const [targetFeatureName = "", , targetShortId = ""] = qn.split(":");
7
+ const feature = featureMap.get(targetFeatureName);
8
+ const screen = feature?.screens[targetShortId];
9
+ if (feature === undefined || screen === undefined)
10
+ return { kind: "unresolved", qn };
11
+ if (screen.type === "custom")
12
+ return { kind: "custom", screenId: screen.id };
13
+ if (screen.type !== "entityList" && screen.type !== "projectionList") {
14
+ return { kind: "other", qn, screenId: screen.id };
15
+ }
16
+ return { kind: "list", target: { feature, screen } };
17
+ }
18
+ export function declaredNamedFilterIds(target) {
19
+ return new Set((target.screen.namedFilters ?? []).map((ref) => ref.id));
20
+ }
@@ -1,2 +1,3 @@
1
1
  import type { FeatureDefinition } from "../types/index.ts";
2
+ export declare function validateNavigateParams(where: string, params: Readonly<Record<string, unknown>> | undefined): void;
2
3
  export declare function validateDashboardStatNavigate(features: readonly FeatureDefinition[]): void;
@@ -1,8 +1,9 @@
1
1
  import { isDeepStrictEqual } from "node:util";
2
2
  import { toKebab } from "../qualified-name.js";
3
3
  import { bootRuleError } from "./boot-rule.js";
4
+ import { declaredNamedFilterIds, resolveDashboardScreenTarget, } from "./dashboard-screen-target.js";
4
5
  import { NAMED_FILTER_RULES } from "./named-filter-rules.js";
5
- import { resolveScreenTargetQn } from "./screens-actions.js";
6
+ import { DASHBOARD_RULES } from "./screens-dashboard-rules.js";
6
7
  function entityListQueryName(feature, screen) {
7
8
  return `${toKebab(feature.name)}:query:${toKebab(screen.entity)}:list`;
8
9
  }
@@ -11,31 +12,38 @@ function listQueryOf(target) {
11
12
  ? entityListQueryName(target.feature, target.screen)
12
13
  : target.screen.query;
13
14
  }
14
- function declaredNamedFilterIds(target) {
15
- return new Set((target.screen.namedFilters ?? []).map((ref) => ref.id));
16
- }
17
- function resolveListTarget(featureName, screenRef, featureMap) {
18
- const qn = resolveScreenTargetQn(featureName, screenRef);
19
- const [targetFeatureName = "", , targetShortId = ""] = qn.split(":");
20
- const feature = featureMap.get(targetFeatureName);
21
- const screen = feature?.screens[targetShortId];
22
- if (feature === undefined || screen === undefined)
23
- return { qn };
24
- if (screen.type !== "entityList" && screen.type !== "projectionList")
25
- return { qn };
26
- return { feature, screen };
15
+ // `where` names the option holding the params ("... stat "x" navigate", "... footerLink").
16
+ export function validateNavigateParams(where, params) {
17
+ for (const [key, value] of Object.entries(params ?? {})) {
18
+ if (key === "" || typeof value !== "string") {
19
+ throw bootRuleError(DASHBOARD_RULES.statNavigateParamsInvalid, {
20
+ message: `${where} params entry ${JSON.stringify(key)} must have a non-empty key and a string value (got ${JSON.stringify(value)}).`,
21
+ });
22
+ }
23
+ }
27
24
  }
28
25
  function validateStatNavigate(context, featureName, stat, featureMap) {
29
26
  const navigate = stat.navigate;
30
27
  // skip: stat has no navigate target to validate
31
28
  if (navigate === undefined)
32
29
  return;
33
- const target = resolveListTarget(featureName, navigate.screen, featureMap);
34
- if ("qn" in target) {
30
+ validateNavigateParams(`${context} navigate`, navigate.params);
31
+ const resolved = resolveDashboardScreenTarget(featureName, navigate.screen, featureMap);
32
+ if (resolved.kind === "unresolved" || resolved.kind === "other") {
35
33
  throw bootRuleError(NAMED_FILTER_RULES.statNavigateTarget, {
36
- message: `${context} navigate.screen "${navigate.screen}" does not resolve to a registered entityList or projectionList screen (checked "${target.qn}").`,
34
+ message: `${context} navigate.screen "${navigate.screen}" does not resolve to a registered entityList, projectionList or custom screen (checked "${resolved.qn}").`,
37
35
  });
38
36
  }
37
+ if (resolved.kind === "custom") {
38
+ // A custom screen has no list query to count with, so the tile keeps its own query.
39
+ if (navigate.namedFilter !== undefined) {
40
+ throw bootRuleError(DASHBOARD_RULES.statNavigateCustomWithFilter, {
41
+ message: `${context} navigate.screen "${resolved.screenId}" is a custom screen, which has no namedFilters. Remove navigate.namedFilter.`,
42
+ });
43
+ }
44
+ return;
45
+ }
46
+ const target = resolved.target;
39
47
  if (navigate.namedFilter !== undefined &&
40
48
  !declaredNamedFilterIds(target).has(navigate.namedFilter)) {
41
49
  throw bootRuleError(NAMED_FILTER_RULES.statNavigateFilterDeclared, {
@@ -14,6 +14,11 @@ export declare const DEFINITION_WEBHOOK_EVENT_RULES: {
14
14
  readonly summary: "Webhook event payloads are Zod object schemas.";
15
15
  readonly fix: "Pass z.object({ ... }) as payload.";
16
16
  };
17
+ readonly payloadOpenShape: {
18
+ readonly id: "webhook-event/payload-open-shape";
19
+ readonly summary: "Webhook event payload objects are closed; undeclared keys must be stripped.";
20
+ readonly fix: "Replace looseObject/passthrough/catchall with z.object({ ... }) and declare every field.";
21
+ };
17
22
  readonly versionInvalid: {
18
23
  readonly id: "webhook-event/version-invalid";
19
24
  readonly summary: "Webhook event version is a positive integer.";
@@ -14,6 +14,11 @@ export const DEFINITION_WEBHOOK_EVENT_RULES = {
14
14
  summary: "Webhook event payloads are Zod object schemas.",
15
15
  fix: "Pass z.object({ ... }) as payload.",
16
16
  },
17
+ payloadOpenShape: {
18
+ id: "webhook-event/payload-open-shape",
19
+ summary: "Webhook event payload objects are closed; undeclared keys must be stripped.",
20
+ fix: "Replace looseObject/passthrough/catchall with z.object({ ... }) and declare every field.",
21
+ },
17
22
  versionInvalid: {
18
23
  id: "webhook-event/version-invalid",
19
24
  summary: "Webhook event version is a positive integer.",
@@ -14,7 +14,6 @@ const VALUE_TYPE_OF_FIELD_TYPE = {
14
14
  tz: "text",
15
15
  reference: "text",
16
16
  number: "number",
17
- bigInt: "number",
18
17
  decimal: "decimal",
19
18
  boolean: "boolean",
20
19
  date: "date",
@@ -34,7 +33,7 @@ function requireUsableField(site, entity, field, role) {
34
33
  }
35
34
  if (valueTypeOfField(entity, field) === undefined) {
36
35
  throw bootRuleError(DERIVED_SQL_FIELD_RULES.unsupportedFieldType, {
37
- message: `${site.where}: ${role} "${field}" has type "${entity.fields[field]?.type}", which a SQL derived field cannot read (compound types are not supported; money only as the measure of a related first).`,
36
+ message: `${site.where}: ${role} "${field}" has type "${entity.fields[field]?.type}", which a SQL derived field cannot read (compound types and bigInt are not supported, as a bigInt loses precision above 2^53 as a number; money only as the measure of a related first).`,
38
37
  });
39
38
  }
40
39
  if (holdsCiphertextOrSecret(entity, field)) {
@@ -24,6 +24,11 @@ export declare const ENTITY_DECLARATION_RULES: {
24
24
  readonly summary: "Query handlers on an entity with parentRef carry the entity-convention brand, so the parent-ref read-gate applies.";
25
25
  readonly fix: "Register the handler via defineEntityListHandler/defineEntityDetailHandler, or pass parentVisibility to the executor.";
26
26
  };
27
+ readonly parentRefHandWrittenWrite: {
28
+ readonly id: "parent-ref/hand-written-write-handler";
29
+ readonly summary: "Update/delete/restore handlers on an entity with parentRef carry the entity-convention brand, so the parent visibility gate applies.";
30
+ readonly fix: "Register the handler via defineEntityWriteHandler, or pass parentVisibility: parentVisibilityFor(ctx, event.user) to the executor.";
31
+ };
27
32
  readonly readGateWithParentRef: {
28
33
  readonly id: "read-gate/with-parent-ref";
29
34
  readonly summary: "An entity with readGate does not also declare parentRef.";
@@ -24,6 +24,11 @@ export const ENTITY_DECLARATION_RULES = {
24
24
  summary: "Query handlers on an entity with parentRef carry the entity-convention brand, so the parent-ref read-gate applies.",
25
25
  fix: "Register the handler via defineEntityListHandler/defineEntityDetailHandler, or pass parentVisibility to the executor.",
26
26
  },
27
+ parentRefHandWrittenWrite: {
28
+ id: "parent-ref/hand-written-write-handler",
29
+ summary: "Update/delete/restore handlers on an entity with parentRef carry the entity-convention brand, so the parent visibility gate applies.",
30
+ fix: "Register the handler via defineEntityWriteHandler, or pass parentVisibility: parentVisibilityFor(ctx, event.user) to the executor.",
31
+ },
27
32
  readGateWithParentRef: {
28
33
  id: "read-gate/with-parent-ref",
29
34
  summary: "An entity with readGate does not also declare parentRef.",
@@ -2,4 +2,5 @@ import type { FeatureDefinition } from "../types/index.ts";
2
2
  /** Operator lists default searchable; low-cardinality audit trails stay opt-out. */
3
3
  export declare const SEARCHABLE_FALSE_WHITELIST: Set<string>;
4
4
  export declare const LIST_ROW_META_COLUMN_NAMES: Set<string>;
5
+ export declare function hasFilterableFields(feature: FeatureDefinition, entityName: string): boolean;
5
6
  export declare function validateEntityListScreens(features: readonly FeatureDefinition[]): void;
@@ -1,9 +1,12 @@
1
+ import { entityHasFilterableFields, } from "@cosmicdrift/kumiko-types/screen";
1
2
  import { LIST_ROW_META_COLUMNS } from "../../ui-types/list-row-meta.js";
2
3
  import { normalizeListColumn } from "../screen-helpers.js";
3
4
  import { collectBootRuleViolations } from "./boot-report.js";
4
5
  import { bootRuleError } from "./boot-rule.js";
5
6
  import { isSortableSqlDerivedField } from "./derived-sql-fields.js";
6
7
  import { ENTITY_LIST_RULES } from "./entity-list-screens-rules.js";
8
+ import { LIST_SORT_SUMMARY_RULES } from "./list-sort-summary-rules.js";
9
+ import { NAMED_FILTER_RULES } from "./named-filter-rules.js";
7
10
  /** Operator lists default searchable; low-cardinality audit trails stay opt-out. */
8
11
  export const SEARCHABLE_FALSE_WHITELIST = new Set(["download-attempt-list", "cap-list"]);
9
12
  // Same set computeListViewModel (headless) can actually render — NOT
@@ -12,14 +15,8 @@ export const SEARCHABLE_FALSE_WHITELIST = new Set(["download-attempt-list", "cap
12
15
  // softDelete column pass the boot gate and then throw at render-time
13
16
  // because the renderer's LIST_ROW_META_COLUMNS doesn't know them.
14
17
  export const LIST_ROW_META_COLUMN_NAMES = new Set(Object.keys(LIST_ROW_META_COLUMNS));
15
- function hasFilterableFields(feature, entityName) {
16
- const entities = feature.entities;
17
- if (!entities)
18
- return false;
19
- const entity = entities[entityName];
20
- if (!entity)
21
- return false;
22
- return Object.values(entity.fields).some((raw) => "filterable" in raw && raw.filterable === true);
18
+ export function hasFilterableFields(feature, entityName) {
19
+ return entityHasFilterableFields(feature.entities?.[entityName]);
23
20
  }
24
21
  function hasEntityEditDetail(feature, entityName) {
25
22
  return Object.values(feature.screens).some((s) => s.type === "entityEdit" && s.entity === entityName);
@@ -47,12 +44,35 @@ function checkDefaultSortColumn(feature, screen) {
47
44
  // skip: a missing defaultSort is reported by checkDefaultSortRequired
48
45
  if (screen.defaultSort === undefined)
49
46
  return;
47
+ checkSortSpecColumn(feature, screen, "defaultSort", screen.defaultSort.field, {
48
+ notListed: ENTITY_LIST_RULES.defaultSortNotListed,
49
+ notSortable: ENTITY_LIST_RULES.defaultSortNotSortable,
50
+ });
51
+ }
52
+ function checkNamedFilterSortColumns(feature, screen) {
53
+ for (const ref of screen.namedFilters ?? []) {
54
+ if (ref.sort === undefined)
55
+ continue;
56
+ checkSortSpecColumn(feature, screen, `namedFilters "${ref.id}" sort`, ref.sort.field, {
57
+ notListed: NAMED_FILTER_RULES.filterSortNotListed,
58
+ notSortable: NAMED_FILTER_RULES.filterSortNotSortable,
59
+ });
60
+ }
61
+ }
62
+ function checkSortOptionColumns(feature, screen) {
63
+ for (const option of screen.sortOptions ?? []) {
64
+ checkSortSpecColumn(feature, screen, `sortOptions "${option.label}"`, option.field, {
65
+ notListed: LIST_SORT_SUMMARY_RULES.sortOptionNotSortable,
66
+ notSortable: LIST_SORT_SUMMARY_RULES.sortOptionNotSortable,
67
+ });
68
+ }
69
+ }
70
+ function checkSortSpecColumn(feature, screen, label, sortField, rules) {
50
71
  const prefix = screenPrefix(feature, screen);
51
- const sortField = screen.defaultSort.field;
52
72
  const col = screen.columns.find((c) => normalizeListColumn(c).field === sortField);
53
73
  if (col === undefined) {
54
- throw bootRuleError(ENTITY_LIST_RULES.defaultSortNotListed, {
55
- message: `${prefix}: defaultSort.field "${sortField}" is not a listed column. Pick a field from columns or add it there.`,
74
+ throw bootRuleError(rules.notListed, {
75
+ message: `${prefix}: ${label}.field "${sortField}" is not a listed column. Pick a field from columns or add it there.`,
56
76
  });
57
77
  }
58
78
  const entityDef = feature.entities?.[screen.entity];
@@ -60,8 +80,8 @@ function checkDefaultSortColumn(feature, screen) {
60
80
  const isSortable = (entityDef !== undefined && isSortableSqlDerivedField(entityDef, sortField)) ||
61
81
  (fieldDef !== undefined && "sortable" in fieldDef && fieldDef.sortable === true);
62
82
  if (!isSortable) {
63
- throw bootRuleError(ENTITY_LIST_RULES.defaultSortNotSortable, {
64
- message: `${prefix}: defaultSort column "${sortField}" must be sortable`,
83
+ throw bootRuleError(rules.notSortable, {
84
+ message: `${prefix}: ${label} column "${sortField}" must be sortable`,
65
85
  });
66
86
  }
67
87
  }
@@ -110,6 +130,8 @@ const ENTITY_LIST_CHECKS = [
110
130
  checkSearchable,
111
131
  checkDefaultSortRequired,
112
132
  checkDefaultSortColumn,
133
+ checkNamedFilterSortColumns,
134
+ checkSortOptionColumns,
113
135
  checkDetailNavigate,
114
136
  checkColumns,
115
137
  checkNamedFilters,
@@ -49,6 +49,11 @@ export declare const ENTITY_STRUCTURE_RULES: {
49
49
  readonly summary: "An encrypted text field is not sortable.";
50
50
  readonly fix: "Drop sortable: true or remove the encryption.";
51
51
  };
52
+ readonly sortNullsNeedsSortable: {
53
+ readonly id: "entity/sort-nulls-needs-sortable";
54
+ readonly summary: "A field with sortNulls is sortable.";
55
+ readonly fix: "Add sortable: true or drop sortNulls.";
56
+ };
52
57
  readonly encryptedFilterable: {
53
58
  readonly id: "entity/encrypted-filterable";
54
59
  readonly summary: "An encrypted text field is not filterable.";
@@ -49,6 +49,11 @@ export const ENTITY_STRUCTURE_RULES = {
49
49
  summary: "An encrypted text field is not sortable.",
50
50
  fix: "Drop sortable: true or remove the encryption.",
51
51
  },
52
+ sortNullsNeedsSortable: {
53
+ id: "entity/sort-nulls-needs-sortable",
54
+ summary: "A field with sortNulls is sortable.",
55
+ fix: "Add sortable: true or drop sortNulls.",
56
+ },
52
57
  encryptedFilterable: {
53
58
  id: "entity/encrypted-filterable",
54
59
  summary: "An encrypted text field is not filterable.",
@@ -1,16 +1,20 @@
1
+ import { LIST_COLUMN_MAX_WIDTH_PX } from "@cosmicdrift/kumiko-types/screen";
1
2
  import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
2
3
  import { normalizeListColumn } from "../screen-helpers.js";
3
4
  import { LIST_COLUMN_PINS } from "../types/screen.js";
4
5
  import { bootRuleError } from "./boot-rule.js";
5
6
  import { LIST_TABLE_RULES } from "./list-table-rules.js";
6
- function isPositiveFiniteNumber(value) {
7
- return typeof value === "number" && Number.isFinite(value) && value > 0;
7
+ function isPixelWidth(value) {
8
+ return (typeof value === "number" &&
9
+ Number.isFinite(value) &&
10
+ value > 0 &&
11
+ value <= LIST_COLUMN_MAX_WIDTH_PX);
8
12
  }
9
13
  function validatePixelWidth(where, field, key, value) {
10
- if (!isPositiveFiniteNumber(value)) {
14
+ if (!isPixelWidth(value)) {
11
15
  throw bootRuleError(LIST_TABLE_RULES.columnWidthInvalid, {
12
16
  message: `${where} column "${field}" has ${key} ${JSON.stringify(value)} — ` +
13
- `must be a finite number of pixels greater than 0.`,
17
+ `must be a finite number of pixels greater than 0 and at most ${LIST_COLUMN_MAX_WIDTH_PX}.`,
14
18
  });
15
19
  }
16
20
  }
@@ -36,10 +40,10 @@ export function validateColumnLayout(where, flags, columns) {
36
40
  if (value === undefined)
37
41
  continue;
38
42
  validatePixelWidth(where, col.field, key, value);
39
- if (!flags.resizing) {
43
+ if (!flags.resizing && col.hint === undefined) {
40
44
  throw bootRuleError(LIST_TABLE_RULES.columnWidthWithoutResizing, {
41
45
  message: `${where} column "${col.field}" sets ${key} but table.resizing is not enabled, ` +
42
- `so it would have no effect. Set table: { resizing: true } or remove "${key}".`,
46
+ `so it would have no effect (only a hint column sizes itself). Set table: { resizing: true } or remove "${key}".`,
43
47
  });
44
48
  }
45
49
  }
@@ -0,0 +1,67 @@
1
+ export declare const LIST_ROW_GUIDANCE_RULES: {
2
+ readonly hintColumnRenderer: {
3
+ readonly id: "list/hint-column-renderer";
4
+ readonly summary: "A hint column owns its cell rendering and sets no renderer.";
5
+ readonly fix: "Remove renderer or hint from the column.";
6
+ };
7
+ readonly hintColumnDisplay: {
8
+ readonly id: "list/hint-column-display";
9
+ readonly summary: "A hint column owns its cell rendering and sets no display.";
10
+ readonly fix: "Remove display or hint from the column.";
11
+ };
12
+ readonly hintColumnLink: {
13
+ readonly id: "list/hint-column-link";
14
+ readonly summary: "A hint column owns its cell rendering and sets no linkScreenField, linkParamsField, refEntity, badgeToneField or badgeDot.";
15
+ readonly fix: "Remove the link or badge option, or move the hint to its own column.";
16
+ };
17
+ readonly hintColumnEmptyPlaceholder: {
18
+ readonly id: "list/hint-column-empty-placeholder";
19
+ readonly summary: "A hint column shows hint.emptyLabel for an empty value and sets no emptyPlaceholder.";
20
+ readonly fix: "Remove emptyPlaceholder, or name the empty sentence with hint.emptyLabel.";
21
+ };
22
+ readonly buttonColumnWithoutLink: {
23
+ readonly id: "list/button-column-without-link";
24
+ readonly summary: 'A column with display "button" has a link (linkScreenField or refEntity) to draw as the button.';
25
+ readonly fix: 'Set linkScreenField or refEntity on the column, or remove display: "button".';
26
+ };
27
+ readonly buttonColumnInListTable: {
28
+ readonly id: "list/button-column-in-list-table";
29
+ readonly summary: 'display "button" is drawn only in dashboard list panels; entityList and projectionList tables (RenderList) keep a row button as a rowAction.';
30
+ readonly fix: 'Declare the button as a rowAction with display: "button" or remove display: "button" from the column.';
31
+ };
32
+ readonly narrowOnlyConflict: {
33
+ readonly id: "list/narrow-only-conflict";
34
+ readonly summary: "A showOnNarrowOnly column sets none of hideOnNarrow: true, hidden: true or pinned.";
35
+ readonly fix: "Remove the conflicting option or showOnNarrowOnly.";
36
+ };
37
+ readonly narrowDetailFieldWithoutDetailField: {
38
+ readonly id: "list/narrow-detail-field-without-detail-field";
39
+ readonly summary: "hint.narrowDetailField replaces hint.detailField below sm, so it needs detailField.";
40
+ readonly fix: "Set hint.detailField or remove narrowDetailField.";
41
+ };
42
+ readonly reasonOptionWithoutReasonField: {
43
+ readonly id: "list/reason-option-without-reason-field";
44
+ readonly summary: "hint.reasonOpenField and hint.reasonTitleField shape the reason text, so they need reasonField.";
45
+ readonly fix: "Set hint.reasonField or remove reasonOpenField and reasonTitleField.";
46
+ };
47
+ readonly linkParamsWithoutScreenField: {
48
+ readonly id: "list/link-params-without-screen-field";
49
+ readonly summary: "linkParamsField only parametrizes the linkScreenField target.";
50
+ readonly fix: "Set linkScreenField on the column or remove linkParamsField.";
51
+ };
52
+ readonly guidanceFieldEmpty: {
53
+ readonly id: "list/guidance-field-empty";
54
+ readonly summary: "rowToneField, linkParamsField and the hint field names are non-empty strings.";
55
+ readonly fix: "Name a row field or remove the option.";
56
+ };
57
+ readonly rowDecorationQueryEmpty: {
58
+ readonly id: "list/row-decoration-query-empty";
59
+ readonly summary: "rowDecoration.query is a non-empty query QN.";
60
+ readonly fix: "Name the decoration query or remove rowDecoration.";
61
+ };
62
+ readonly rowDecorationIdsMissing: {
63
+ readonly id: "list/row-decoration-ids-missing";
64
+ readonly summary: "The rowDecoration query's input schema declares `ids`, the row ids the list sends with every call.";
65
+ readonly fix: "Add `ids: z.array(z.string())` to the decoration query's schema; `.max(...)` must cover at least the list page size; the list asks in batches of the first page size.";
66
+ };
67
+ };
@@ -0,0 +1,67 @@
1
+ export const LIST_ROW_GUIDANCE_RULES = {
2
+ hintColumnRenderer: {
3
+ id: "list/hint-column-renderer",
4
+ summary: "A hint column owns its cell rendering and sets no renderer.",
5
+ fix: "Remove renderer or hint from the column.",
6
+ },
7
+ hintColumnDisplay: {
8
+ id: "list/hint-column-display",
9
+ summary: "A hint column owns its cell rendering and sets no display.",
10
+ fix: "Remove display or hint from the column.",
11
+ },
12
+ hintColumnLink: {
13
+ id: "list/hint-column-link",
14
+ summary: "A hint column owns its cell rendering and sets no linkScreenField, linkParamsField, refEntity, badgeToneField or badgeDot.",
15
+ fix: "Remove the link or badge option, or move the hint to its own column.",
16
+ },
17
+ hintColumnEmptyPlaceholder: {
18
+ id: "list/hint-column-empty-placeholder",
19
+ summary: "A hint column shows hint.emptyLabel for an empty value and sets no emptyPlaceholder.",
20
+ fix: "Remove emptyPlaceholder, or name the empty sentence with hint.emptyLabel.",
21
+ },
22
+ buttonColumnWithoutLink: {
23
+ id: "list/button-column-without-link",
24
+ summary: 'A column with display "button" has a link (linkScreenField or refEntity) to draw as the button.',
25
+ fix: 'Set linkScreenField or refEntity on the column, or remove display: "button".',
26
+ },
27
+ buttonColumnInListTable: {
28
+ id: "list/button-column-in-list-table",
29
+ summary: 'display "button" is drawn only in dashboard list panels; entityList and projectionList tables (RenderList) keep a row button as a rowAction.',
30
+ fix: 'Declare the button as a rowAction with display: "button" or remove display: "button" from the column.',
31
+ },
32
+ narrowOnlyConflict: {
33
+ id: "list/narrow-only-conflict",
34
+ summary: "A showOnNarrowOnly column sets none of hideOnNarrow: true, hidden: true or pinned.",
35
+ fix: "Remove the conflicting option or showOnNarrowOnly.",
36
+ },
37
+ narrowDetailFieldWithoutDetailField: {
38
+ id: "list/narrow-detail-field-without-detail-field",
39
+ summary: "hint.narrowDetailField replaces hint.detailField below sm, so it needs detailField.",
40
+ fix: "Set hint.detailField or remove narrowDetailField.",
41
+ },
42
+ reasonOptionWithoutReasonField: {
43
+ id: "list/reason-option-without-reason-field",
44
+ summary: "hint.reasonOpenField and hint.reasonTitleField shape the reason text, so they need reasonField.",
45
+ fix: "Set hint.reasonField or remove reasonOpenField and reasonTitleField.",
46
+ },
47
+ linkParamsWithoutScreenField: {
48
+ id: "list/link-params-without-screen-field",
49
+ summary: "linkParamsField only parametrizes the linkScreenField target.",
50
+ fix: "Set linkScreenField on the column or remove linkParamsField.",
51
+ },
52
+ guidanceFieldEmpty: {
53
+ id: "list/guidance-field-empty",
54
+ summary: "rowToneField, linkParamsField and the hint field names are non-empty strings.",
55
+ fix: "Name a row field or remove the option.",
56
+ },
57
+ rowDecorationQueryEmpty: {
58
+ id: "list/row-decoration-query-empty",
59
+ summary: "rowDecoration.query is a non-empty query QN.",
60
+ fix: "Name the decoration query or remove rowDecoration.",
61
+ },
62
+ rowDecorationIdsMissing: {
63
+ id: "list/row-decoration-ids-missing",
64
+ summary: "The rowDecoration query's input schema declares `ids`, the row ids the list sends with every call.",
65
+ fix: "Add `ids: z.array(z.string())` to the decoration query's schema; `.max(...)` must cover at least the list page size; the list asks in batches of the first page size.",
66
+ },
67
+ };
@@ -0,0 +1,20 @@
1
+ import type { NamedFilterFacetOptions, NamedListFilterRef } from "@cosmicdrift/kumiko-types/named-list-filters";
2
+ import type { ListColumnSpec } from "../types/screen.ts";
3
+ import { type RowDecorationFields } from "./row-decoration.ts";
4
+ type RowGuidanceScreen = {
5
+ readonly columns: readonly ListColumnSpec[];
6
+ readonly namedFilters?: readonly NamedListFilterRef[];
7
+ readonly namedFilterFacet?: NamedFilterFacetOptions;
8
+ readonly rowToneField?: string;
9
+ readonly rowDecoration?: {
10
+ readonly query: string;
11
+ };
12
+ };
13
+ export type EntityRowFields = {
14
+ readonly entityName: string;
15
+ readonly fieldNames: ReadonlySet<string>;
16
+ readonly rowDecorationFields?: RowDecorationFields | undefined;
17
+ };
18
+ type GuidanceListKind = "entityList" | "projectionList" | "dashboard" | "relatedList";
19
+ export declare function validateListRowGuidance(featureName: string, screenId: string, kind: GuidanceListKind, screen: RowGuidanceScreen, entityFields?: EntityRowFields, partLabel?: string): void;
20
+ export {};