@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
@@ -2,7 +2,7 @@ import { KUMIKO_META_SYMBOL } from "@cosmicdrift/kumiko-types/schema-table-types
2
2
  import { toSnakeCase } from "../utils/case.js";
3
3
  import { buildEntityIndexes } from "./entity-table-indexes.js";
4
4
  import { markExecutorManagedTable } from "./executor-managed-tables.js";
5
- import { columnHandleName } from "./table-introspection.js";
5
+ import { asEntityTableMeta, columnHandleName } from "./table-introspection.js";
6
6
  export { toSnakeCase } from "../utils/case.js";
7
7
  import { bigint, boolean, decimalColumn, doublePrecision, instant, integer, jsonb, moneyAmount, table as pgTable, plainDate, serial, sql, text, uuid, } from "./dialect.js";
8
8
  export { SOFT_DELETE_LIVE_ROW_PREDICATE } from "./entity-table-indexes.js";
@@ -117,7 +117,7 @@ const COLUMN_EMITTERS = {
117
117
  function emitFieldColumns(type, name, field, entity) {
118
118
  // A type from untyped input must not reach an Object.prototype member.
119
119
  if (!Object.hasOwn(COLUMN_EMITTERS, type)) {
120
- throw new Error(`[Kumiko] unhandled field type: ${String(field)}`);
120
+ throw new Error(`[Kumiko] unhandled field type: ${String(type)}`);
121
121
  }
122
122
  const emit = COLUMN_EMITTERS[type];
123
123
  return emit(name, toSnakeCase(name), field, entity);
@@ -198,6 +198,10 @@ const ROW_META_WITH_SOFT_DELETE = new Set(Object.keys(buildBaseColumns(true)));
198
198
  export function rowMetaFieldNames(softDelete) {
199
199
  return softDelete ? ROW_META_WITH_SOFT_DELETE : ROW_META_BASE;
200
200
  }
201
+ function writeTableMeta(table, meta) {
202
+ // The meta slot is symbol-keyed and set by table(); it is absent from the static table type.
203
+ table[KUMIKO_META_SYMBOL] = meta;
204
+ }
201
205
  // pgTable's own meta stamp sees neither entity.tenancy nor that this table is an executor-managed projection;
202
206
  // patch both so db.global()'s runtime guards match the type brands.
203
207
  function stampEntityTableMeta(table, entity) {
@@ -205,11 +209,12 @@ function stampEntityTableMeta(table, entity) {
205
209
  // skip: no meta stamp present — nothing to patch
206
210
  if (!meta)
207
211
  return;
208
- table[KUMIKO_META_SYMBOL] = {
212
+ writeTableMeta(table, {
209
213
  ...meta,
210
214
  source: "managed",
211
215
  ...(entity.tenancy === "global" && { tenancy: "global" }),
212
- };
216
+ ...(entity.systemRowsReadable === true && { systemRowsReadable: true }),
217
+ });
213
218
  }
214
219
  /**
215
220
  * Stamps `tenancy: "global"` onto a `table()`/SchemaTable's meta in place.
@@ -225,13 +230,18 @@ export function declareGlobalTenancy(table) {
225
230
  'declared tenancy: "global" — a global table\'s rows carry the system tenant, not a ' +
226
231
  "per-row tenant identity.");
227
232
  }
228
- table[KUMIKO_META_SYMBOL] = {
229
- ...meta,
230
- tenancy: "global",
231
- };
233
+ writeTableMeta(table, { ...meta, tenancy: "global" });
232
234
  // @cast-boundary phantom-brand — TenancyBrand<"global"> is a phantom marker with no runtime representation.
233
235
  return table;
234
236
  }
237
+ /** Stamps `systemRowsReadable` onto an entity table's meta in place (no-op if already set). */
238
+ export function declareSystemRowsReadable(table) {
239
+ const meta = KUMIKO_META_SYMBOL in table ? asEntityTableMeta(table) : undefined;
240
+ // skip: no meta stamp, or already readable — nothing to patch
241
+ if (!meta || meta.systemRowsReadable === true)
242
+ return;
243
+ writeTableMeta(table, { ...meta, systemRowsReadable: true });
244
+ }
235
245
  // The featureName prefix is inserted between read_ and the base name so all
236
246
  // read models consistently start with `read_`, whether or not featureName is set:
237
247
  // featureName="shop", base="read_orders" → "read_shop_orders"
@@ -1,4 +1,3 @@
1
- import type { TableLike } from "./query.ts";
2
1
  export type TableInfo = {
3
2
  readonly name: string;
4
3
  readonly columnOf: (field: string) => string;
@@ -7,4 +6,4 @@ export type TableInfo = {
7
6
  readonly fieldOf: (column: string) => string;
8
7
  readonly hasColumn: (fieldOrColumn: string) => boolean;
9
8
  };
10
- export declare function extractTableInfo(table: TableLike): TableInfo;
9
+ export declare function extractTableInfo(table: unknown): TableInfo;
@@ -1,6 +1,9 @@
1
1
  import type { EntityTableMeta } from "@cosmicdrift/kumiko-types/entity-table-meta-types";
2
2
  import type { Writable } from "@cosmicdrift/kumiko-types/executor-brand";
3
+ import { type SchemaTable } from "@cosmicdrift/kumiko-types/schema-table-types";
3
4
  export declare function isEntityTableMeta(value: unknown): value is EntityTableMeta;
5
+ /** True for tables built by table(): all three identity slots are present and well-formed. */
6
+ export declare function isSchemaTable(value: unknown): value is SchemaTable;
4
7
  export declare function asEntityTableMeta(table: unknown): EntityTableMeta | undefined;
5
8
  export declare function requireEntityTableMeta(table: unknown, tableName: string): EntityTableMeta;
6
9
  /** Physical table name from the unshadowable name symbol; undefined when absent. */
@@ -17,6 +17,12 @@ export function isEntityTableMeta(value) {
17
17
  "source" in value &&
18
18
  (value.source === "managed" || value.source === "unmanaged"));
19
19
  }
20
+ /** True for tables built by table(): all three identity slots are present and well-formed. */
21
+ export function isSchemaTable(value) {
22
+ return (schemaTableName(value) !== undefined &&
23
+ tableColumnsOf(value) !== undefined &&
24
+ asEntityTableMeta(value) !== undefined);
25
+ }
20
26
  export function asEntityTableMeta(table) {
21
27
  if (typeof table !== "object" || table === null)
22
28
  return undefined;
@@ -31,3 +31,4 @@ export declare function ensureTableRowLevelSecurity(db: DbConnection, table: unk
31
31
  export declare function unsafePushTables(db: DbConnection, tables: Record<string, unknown>, prevTables?: Record<string, unknown>, options?: {
32
32
  readonly rowLevelSecurity?: RowLevelSecurityMode;
33
33
  }): Promise<void>;
34
+ export declare function pushTableIfMissing(db: DbConnection, fullyQualifiedName: string, tables: Record<string, unknown>): Promise<void>;
@@ -93,7 +93,13 @@ export async function unsafePushTables(db, tables, prevTables, options = {}) {
93
93
  await applyTableRowLevelSecurity(db, meta);
94
94
  }
95
95
  }
96
- // @wrapper-known semantic-alias
96
+ // Idempotent bootstrap for a framework meta-table that several boot paths create.
97
+ export async function pushTableIfMissing(db, fullyQualifiedName, tables) {
98
+ // skip: table already exists — bootstrap runs from multiple paths
99
+ if (await tableExists(db, fullyQualifiedName))
100
+ return;
101
+ await unsafePushTables(db, tables);
102
+ }
97
103
  function renderColumnType(col) {
98
104
  return pgTypeToSqlType(col.pgType);
99
105
  }
@@ -7,7 +7,10 @@ export declare function isBoundTenantDb(value: unknown): value is TenantDb;
7
7
  export declare function isDbRunner(value: unknown): value is DbRunner;
8
8
  export declare function bindTenantDbRunner(tenantDb: TenantDb, runner: DbRunner, modeOptions: TenantDbModeOptions, tenantId: TenantId): void;
9
9
  export declare function tenantDbRunner(tenantDb: TenantDb): DbRunner;
10
+ export declare function isGlobalTenancyTable(table: unknown): boolean;
11
+ export declare function tenantDbRunnerForTable(tenantDb: TenantDb, table: unknown): DbRunner;
10
12
  export declare function denyTenantDbWrites(tenantDb: TenantDb, reason: string): void;
11
13
  export declare function tenantDbWritesDeniedReason(tenantDb: TenantDb): string | undefined;
12
14
  export declare function tenantDbWritesDeniedError(operation: string, reason: string): InternalError;
13
15
  export declare function tenantDbWriteRunner(tenantDb: TenantDb, operation: string): DbRunner;
16
+ export declare function tenantDbWriteRunnerForTable(tenantDb: TenantDb, operation: string, table: unknown): DbRunner;
@@ -1,6 +1,7 @@
1
1
  import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
2
2
  import { InternalError } from "../errors/index.js";
3
- import { tenantDbRowLevelSecurityScope, withRowLevelSecurityScope, } from "./row-level-security-scope.js";
3
+ import { systemScopedRunner, tenantDbRowLevelSecurityScope, withRowLevelSecurityScope, } from "./row-level-security-scope.js";
4
+ import { asEntityTableMeta } from "./table-introspection.js";
4
5
  const tenantDbRunners = new WeakMap();
5
6
  export function isBoundTenantDb(value) {
6
7
  return typeof value === "object" && value !== null && tenantDbRunners.has(value);
@@ -23,6 +24,17 @@ export function tenantDbRunner(tenantDb) {
23
24
  }
24
25
  return runner;
25
26
  }
27
+ export function isGlobalTenancyTable(table) {
28
+ return asEntityTableMeta(table)?.tenancy === "global";
29
+ }
30
+ // Raw statements against one entity table: a global table holds system tenant rows, so its reads run
31
+ // in the system scope like the TenantDb's own statements on it (tenantDbRowLevelSecurityScope).
32
+ export function tenantDbRunnerForTable(tenantDb, table) {
33
+ const runner = tenantDbRunner(tenantDb);
34
+ return isGlobalTenancyTable(table)
35
+ ? systemScopedRunner(runner, "global table rows carry the system tenant")
36
+ : runner;
37
+ }
26
38
  const writesDeniedReasons = new WeakMap();
27
39
  export function denyTenantDbWrites(tenantDb, reason) {
28
40
  writesDeniedReasons.set(tenantDb, reason);
@@ -43,3 +55,9 @@ export function tenantDbWriteRunner(tenantDb, operation) {
43
55
  throw tenantDbWritesDeniedError(operation, reason);
44
56
  return tenantDbRunner(tenantDb);
45
57
  }
58
+ export function tenantDbWriteRunnerForTable(tenantDb, operation, table) {
59
+ const reason = writesDeniedReasons.get(tenantDb);
60
+ if (reason !== undefined)
61
+ throw tenantDbWritesDeniedError(operation, reason);
62
+ return tenantDbRunnerForTable(tenantDb, table);
63
+ }
@@ -3,4 +3,5 @@ export declare function registerRunnerProxyTarget(proxy: HandleKey, target: Hand
3
3
  export declare function openSerializedSavepoint<T>(transactionHandle: HandleKey & {
4
4
  savepoint: <R>(fn: (sp: unknown) => Promise<R>) => Promise<R>;
5
5
  }, fn: (sp: unknown) => Promise<T>): Promise<T>;
6
+ export declare function runStatementBehindPendingUnits<T>(handle: HandleKey, statement: () => T): Promise<Awaited<T>>;
6
7
  export {};
@@ -24,29 +24,35 @@ function transactionKeyOf(handle) {
24
24
  }
25
25
  function chainFor(transactionKey) {
26
26
  const nested = nestedChainsInScope.getStore()?.get(transactionKey);
27
- if (nested)
27
+ // Background tasks started inside a unit outlive it and inherit its scope; once the unit has
28
+ // finished their work must queue on the root chain again.
29
+ if (nested?.active)
28
30
  return nested;
29
31
  const root = rootChains.get(transactionKey);
30
32
  if (root)
31
33
  return root;
32
- const created = { tail: Promise.resolve() };
34
+ const created = { tail: Promise.resolve(), active: true, pending: 0 };
33
35
  rootChains.set(transactionKey, created);
34
36
  return created;
35
37
  }
36
38
  async function runOnChain(transactionKey, work) {
37
39
  const chain = chainFor(transactionKey);
38
40
  const previous = chain.tail;
41
+ chain.pending++;
39
42
  let release = () => { };
40
43
  chain.tail = new Promise((resolve) => {
41
44
  release = resolve;
42
45
  });
43
46
  await previous;
47
+ const nestedChain = { tail: Promise.resolve(), active: true, pending: 0 };
44
48
  try {
45
49
  const scope = new Map(nestedChainsInScope.getStore());
46
- scope.set(transactionKey, { tail: Promise.resolve() });
50
+ scope.set(transactionKey, nestedChain);
47
51
  return await nestedChainsInScope.run(scope, work);
48
52
  }
49
53
  finally {
54
+ nestedChain.active = false;
55
+ chain.pending--;
50
56
  release();
51
57
  }
52
58
  }
@@ -58,3 +64,14 @@ export function openSerializedSavepoint(transactionHandle, fn) {
58
64
  return fn(sp);
59
65
  }));
60
66
  }
67
+ // Runs a statement on a transaction handle. With no unit queued on the current chain (the nested
68
+ // chain inside a running unit, else the root) it goes straight to the driver; otherwise it queues
69
+ // behind the pending units of that chain.
70
+ export async function runStatementBehindPendingUnits(handle, statement) {
71
+ const transactionKey = transactionKeyOf(handle);
72
+ const nested = nestedChainsInScope.getStore()?.get(transactionKey);
73
+ const chain = nested?.active ? nested : rootChains.get(transactionKey);
74
+ if ((chain?.pending ?? 0) === 0)
75
+ return await statement();
76
+ return runOnChain(transactionKey, async () => await statement());
77
+ }
@@ -138,8 +138,10 @@ function emitNotEqual(target, operator) {
138
138
  }
139
139
  function emitIn(target, operator) {
140
140
  const operand = operator.in;
141
- if (!Array.isArray(operand))
141
+ if (operand === undefined)
142
142
  return undefined;
143
+ if (!Array.isArray(operand))
144
+ throw new Error(`where: in on column "${target.column}" needs an array`);
143
145
  if (target.pgType === "jsonb")
144
146
  return jsonbContainsAny(target, operand);
145
147
  if (operand.length === 0)
@@ -148,8 +150,11 @@ function emitIn(target, operator) {
148
150
  }
149
151
  function emitNotIn(target, operator) {
150
152
  const operand = operator.notIn;
151
- if (!Array.isArray(operand))
153
+ if (operand === undefined)
152
154
  return undefined;
155
+ if (!Array.isArray(operand)) {
156
+ throw new Error(`where: notIn on column "${target.column}" needs an array`);
157
+ }
153
158
  if (target.pgType === "jsonb") {
154
159
  throw new Error(`where: notIn is not supported on jsonb column "${target.column}"`);
155
160
  }
@@ -177,6 +182,10 @@ function operatorConditions(target, operator) {
177
182
  if (condition !== undefined)
178
183
  conditions.push(condition);
179
184
  }
185
+ // An empty result would drop the WHERE and turn deleteMany/selectMany into whole-table operations.
186
+ if (conditions.length === 0) {
187
+ throw new Error(`where: operator on column "${target.column}" has no defined operand`);
188
+ }
180
189
  return conditions;
181
190
  }
182
191
  // Blind-index OR rewrite: if the column has a bidx
@@ -0,0 +1,25 @@
1
+ import type { EntityDefinition } from "@cosmicdrift/kumiko-types/fields";
2
+ import type { EntityId } from "@cosmicdrift/kumiko-types/identifiers";
3
+ import type { SessionUser, TenantId } from "../engine/types/index.ts";
4
+ import type { WriteFailure } from "../errors/index.ts";
5
+ import type { DbRow } from "./connection.ts";
6
+ export declare function createOwnershipFailure(options: {
7
+ readonly entity: EntityDefinition;
8
+ readonly entityName: string;
9
+ readonly user: SessionUser;
10
+ readonly streamTenantId: TenantId | undefined;
11
+ readonly payloadWithoutId: Record<string, unknown>;
12
+ readonly data: DbRow;
13
+ readonly applyDefaults: (payload: Record<string, unknown>) => Record<string, unknown>;
14
+ }): WriteFailure | undefined;
15
+ export declare function updateOwnershipFailure(options: {
16
+ readonly entity: EntityDefinition;
17
+ readonly entityName: string;
18
+ readonly user: SessionUser;
19
+ readonly streamTenantId: TenantId | undefined;
20
+ readonly id: EntityId;
21
+ readonly submittedChanges: Record<string, unknown>;
22
+ readonly previous: DbRow;
23
+ readonly changes: DbRow;
24
+ readonly mergedNew: Record<string, unknown>;
25
+ }): WriteFailure | undefined;
@@ -0,0 +1,82 @@
1
+ import { checkWriteFieldOwnership } from "../engine/field-access.js";
2
+ import { userCanCreateFieldRow, userCanWriteFieldRow } from "../engine/ownership.js";
3
+ import { ownershipSubject } from "./event-store-executor-context.js";
4
+ import { ownershipDeniedFailure } from "./event-store-executor-write-steps.js";
5
+ export function createOwnershipFailure(options) {
6
+ const { entity, entityName, user, streamTenantId, payloadWithoutId, data, applyDefaults } = options;
7
+ // H.2 — entity-level write-ownership on create. No oldRow exists, so
8
+ // only the new row is checked. No Straddle concern for creates.
9
+ if (!userCanCreateFieldRow(ownershipSubject(user, streamTenantId), entity.access?.write, data)) {
10
+ return ownershipDeniedFailure({
11
+ scope: "entity",
12
+ entityName,
13
+ action: "create",
14
+ userId: user.id,
15
+ });
16
+ }
17
+ // Field-level write-ownership on create — mirror of entity-level but
18
+ // per declared field. Role-level was already checked by the
19
+ // dispatcher; here we enforce ownership-rules against the new row.
20
+ //
21
+ // Which fields get checked is scoped to the pre-hook payload
22
+ // — a hook-derived field the user never submitted must not be
23
+ // field-ownership-checked against the user. The rule for a checked
24
+ // field is still evaluated against the full post-hook row (`data`) —
25
+ // an ownership rule can reference a column only a hook populates.
26
+ const fieldDeniedCreate = checkWriteFieldOwnership(entity, applyDefaults(payloadWithoutId), ownershipSubject(user, streamTenantId), undefined, data);
27
+ if (fieldDeniedCreate) {
28
+ return ownershipDeniedFailure({
29
+ scope: "field",
30
+ entityName,
31
+ action: "create",
32
+ field: fieldDeniedCreate,
33
+ userId: user.id,
34
+ });
35
+ }
36
+ return undefined;
37
+ }
38
+ export function updateOwnershipFailure(options) {
39
+ const { entity, entityName, user, streamTenantId, id, submittedChanges, previous, changes, mergedNew, } = options;
40
+ // H.2 — entity-level write-ownership on update. Load old row (already
41
+ // done above), build post-change row via shallow merge. Straddle-safe
42
+ // multi-role check: at least one role must accept BOTH old and new —
43
+ // prevents the attack where role A passes old, role B passes new and
44
+ // aggregation would wrongly allow a row-grab.
45
+ if (!userCanWriteFieldRow(ownershipSubject(user, streamTenantId), entity.access?.write, previous, mergedNew)) {
46
+ return ownershipDeniedFailure({
47
+ scope: "entity",
48
+ entityName,
49
+ action: "update",
50
+ userId: user.id,
51
+ entityId: id,
52
+ });
53
+ }
54
+ // Field-level write-ownership on update — this is the path the
55
+ // dispatcher could not evaluate (no oldRow). Now that we have
56
+ // `previous`, we can run the ownership rules per field against both
57
+ // sides and reject individual fields the user isn't entitled to
58
+ // touch on this specific row.
59
+ //
60
+ // Which fields get checked is scoped to `payload.changes` (the user's
61
+ // actual submission), NOT `changes` (post-preSave-hook data)
62
+ // — a hook-derived field the user never submitted (e.g. a system hook
63
+ // setting `assignedTo`) has no business being field-ownership-checked
64
+ // against the *user*, and doing so rejects writes the user is fully
65
+ // entitled to make. The dispatcher's role-gate (checkWriteFieldAccess)
66
+ // already runs on this same pre-hook payload for consistency. The rule
67
+ // for a checked field is still evaluated against the full post-hook
68
+ // row (`changes` merged onto `previous`) — an ownership rule can
69
+ // reference a column only a hook populates.
70
+ const fieldDeniedUpdate = checkWriteFieldOwnership(entity, submittedChanges, ownershipSubject(user, streamTenantId), previous, changes);
71
+ if (fieldDeniedUpdate) {
72
+ return ownershipDeniedFailure({
73
+ scope: "field",
74
+ entityName,
75
+ action: "update",
76
+ field: fieldDeniedUpdate,
77
+ userId: user.id,
78
+ entityId: id,
79
+ });
80
+ }
81
+ return undefined;
82
+ }
@@ -1,5 +1,6 @@
1
1
  import { BOOT_CHECK_RULES } from "./boot-check-rules.js";
2
- import { BootRuleFailures, BootRuleViolation, bootRuleError } from "./boot-rule.js";
2
+ import { isRuntimeCrash } from "./boot-report.js";
3
+ import { BootRuleFailures, BootRuleViolation, BootValidationError, bootRuleError, } from "./boot-rule.js";
3
4
  // r.bootCheck(fn) lets a feature declare its own mount-invariant instead of
4
5
  // relying on framework-internal knowledge (the gdpr-storage.ts guards are
5
6
  // the framework-owned version of this same idea). Each registered fn gets
@@ -7,6 +8,9 @@ import { BootRuleFailures, BootRuleViolation, bootRuleError } from "./boot-rule.
7
8
  // message with the owning feature's name so the error text points back at
8
9
  // the feature that declared the check.
9
10
  function prefixFailure(failure, prefix) {
11
+ // Already-structured violations of a nested report keep their own rule ids.
12
+ if (failure instanceof BootValidationError)
13
+ return failure;
10
14
  const rule = failure instanceof BootRuleViolation ? failure.rule : BOOT_CHECK_RULES.failed;
11
15
  return new BootRuleViolation(rule, prefix + failure.message);
12
16
  }
@@ -17,6 +21,8 @@ export function runFeatureBootCheck(feature, check, features) {
17
21
  check(ctx);
18
22
  }
19
23
  catch (err) {
24
+ if (isRuntimeCrash(err) || err instanceof BootValidationError)
25
+ throw err;
20
26
  if (err instanceof BootRuleViolation)
21
27
  throw prefixFailure(err, prefix);
22
28
  if (err instanceof BootRuleFailures) {
@@ -8,11 +8,11 @@ import { bootRuleError } from "./boot-rule.js";
8
8
  import { validateCardMetaOverflow } from "./card-meta-overflow.js";
9
9
  import { validateConfigReads } from "./config-deps.js";
10
10
  import { validateDashboardStatNavigate } from "./dashboard-stat-navigate.js";
11
- import { validateExtensionPreSaveWiring } from "./entity-handler.js";
12
11
  import { validateEntityListScreens } from "./entity-list-screens.js";
13
12
  import { validateGdprStoragePersistence } from "./gdpr-storage.js";
14
13
  import { validateGlobalTenancyEntities } from "./global-tenancy.js";
15
14
  import { validateFieldValueTranslations, validateI18nSurfaceKeys, validateRequiredLocales, validateTranslationLocaleConsistency, } from "./i18n-keys.js";
15
+ import { validateListSortAndSummary } from "./list-sort-summary.js";
16
16
  import { validateNavCycles } from "./nav.js";
17
17
  import { validateProjectionListScreens, validateRelatedListSectionQueries, } from "./projection-list-screens.js";
18
18
  import { validateQueryOutputColumns } from "./query-output-columns.js";
@@ -48,6 +48,10 @@ const APP_CHECKS_AFTER_I18N = [
48
48
  check: "validateProjectionListScreens",
49
49
  run: (c) => validateProjectionListScreens(c.features),
50
50
  },
51
+ {
52
+ check: "validateListSortAndSummary",
53
+ run: (c) => validateListSortAndSummary(c.features),
54
+ },
51
55
  {
52
56
  check: "validateDashboardStatNavigate",
53
57
  run: (c) => validateDashboardStatNavigate(c.features),
@@ -56,10 +60,6 @@ const APP_CHECKS_AFTER_I18N = [
56
60
  check: "validateRelatedListSectionQueries",
57
61
  run: (c) => validateRelatedListSectionQueries(c.features),
58
62
  },
59
- {
60
- check: "validateExtensionPreSaveWiring",
61
- run: (c) => validateExtensionPreSaveWiring(c.features),
62
- },
63
63
  {
64
64
  check: "validateGdprStoragePersistence",
65
65
  run: (c) => validateGdprStoragePersistence(c.features),
@@ -2,7 +2,7 @@ import { validateAccessDeclarations } from "./access-declarations.js";
2
2
  import { validateActionWiring, validateFieldWiring } from "./action-wiring.js";
3
3
  import { validateApiExposureMatching, validateExtensionUsages } from "./api-ext.js";
4
4
  import { collectExposedApis } from "./boot-context.js";
5
- import { validateCircularDeps, validateConfigKeyAllowPerRequest, validateConfigKeyBacking, validateConfigKeyBounds, validateConfigKeyComputed, validateConfigKeyOptionsQuery, validateConfigKeyPiiEncrypted, validateConfigKeyRequired, } from "./config-deps.js";
5
+ import { validateCircularDeps, validateConfigKeyBacking, validateConfigKeyBounds, validateConfigKeyComputed, validateConfigKeyOptionsQuery, validateConfigKeyPiiEncrypted, validateConfigKeyRequired, } from "./config-deps.js";
6
6
  import { validateSqlDerivedFields } from "./derived-sql-fields.js";
7
7
  import { collectDetailForScreens } from "./detail-screens.js";
8
8
  import { validateDerivedFieldCollisions, validateEmbeddedFields, validateEncryptedFields, validateEntityIndexes, validateExtendSchemaCollisions, validateFileFields, validateHandlerAccess, validateLocatedTimestamps, validateLockedWhen, validateMultiStreamProjections, validateReferenceFields, validateSearchableFieldReadAccess, validateTransitions, } from "./entity-handler.js";
@@ -18,6 +18,7 @@ import { validateQueryRefs } from "./query-refs.js";
18
18
  import { validateReadGates } from "./read-gate.js";
19
19
  import { validateRecordOwnedSubjects } from "./record-owned.js";
20
20
  import { validateScreenShortIdCollisions, validateScreens } from "./screens.js";
21
+ import { validateSortNulls } from "./sort-nulls.js";
21
22
  import { validateTransferGraph } from "./transfer-graph.js";
22
23
  import { validateWorkspaces } from "./workspaces.js";
23
24
  function runFeatureChecks(report, checks, feature, ctx) {
@@ -85,6 +86,7 @@ const FEATURE_CHECKS = [
85
86
  check: "validateHandlerFieldReferences",
86
87
  run: (f, c) => validateHandlerFieldReferences(f, c.featureMap),
87
88
  },
89
+ { check: "validateSortNulls", run: (f) => validateSortNulls(f) },
88
90
  { check: "validateTransitions", run: (f) => validateTransitions(f) },
89
91
  { check: "validateLockedWhen", run: (f) => validateLockedWhen(f) },
90
92
  { check: "validateFieldConditions", run: (f) => validateFieldConditions(f) },
@@ -97,7 +99,6 @@ const FEATURE_CHECKS = [
97
99
  { check: "validateConfigKeyBounds", run: (f) => validateConfigKeyBounds(f) },
98
100
  { check: "validateConfigKeyRequired", run: (f) => validateConfigKeyRequired(f) },
99
101
  { check: "validateConfigKeyComputed", run: (f) => validateConfigKeyComputed(f) },
100
- { check: "validateConfigKeyAllowPerRequest", run: (f) => validateConfigKeyAllowPerRequest(f) },
101
102
  { check: "validateConfigKeyBacking", run: (f) => validateConfigKeyBacking(f) },
102
103
  { check: "validateConfigKeyOptionsQuery", run: (f) => validateConfigKeyOptionsQuery(f) },
103
104
  { check: "validateConfigKeyPiiEncrypted", run: (f) => validateConfigKeyPiiEncrypted(f) },