@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
@@ -1,3 +1,4 @@
1
+ import { BUN_SQL_CONNECTION_ERROR_CODES } from "../db/bun-sql-connection-codes.js";
1
2
  import { extractPgError } from "../db/pg-error.js";
2
3
  import { recordConsumerPassFailure, selectSnapshotXmax, selectSnapshotXmin, } from "../db/queries/event-consumer.js";
3
4
  import { assertNoActiveRowLevelSecurityScope, runInSystemRowLevelSecurityScope, } from "../db/row-level-security-scope.js";
@@ -9,7 +10,7 @@ import { emitEventConsumerPassOutcome, emitEventConsumerPassSkipped, emitEventCo
9
10
  import { SHARED_INSTANCE_SENTINEL } from "./event-consumer-state.js";
10
11
  import { acquireConsumerState, consumerInstanceId, deliverConsumerTurn, emitLagFromTx, fetchPendingEvents, markProcessing, pendingFetchLimit, persistConsumerOutcome, preRegisterConsumers, selectIdleConsumerKeys, } from "./event-dispatcher-delivery.js";
11
12
  import { mergeContiguousGapRanges, partitionBurntGaps, splitRangeExcludingIds, toIdRanges, } from "./pending-gap-ranges.js";
12
- const DEFAULT_BATCH_SIZE = 200;
13
+ export const DEFAULT_BATCH_SIZE = 200;
13
14
  const DEFAULT_POLL_MS = 100;
14
15
  const DEFAULT_MAX_ATTEMPTS = 10;
15
16
  const DEFAULT_REARM_COOLDOWN_MS = 5 * 60_000;
@@ -17,12 +18,10 @@ const DEFAULT_MAX_REARM_COUNT = 3;
17
18
  const PENDING_GAPS_WARN_THRESHOLD = 1000;
18
19
  const DEFAULT_MAX_PENDING_GAP_RANGES = 2 * PENDING_GAPS_WARN_THRESHOLD;
19
20
  // Only these say the database socket itself is gone; timeouts, schema or pool errors do not
20
- // imply the dedicated LISTEN connection dropped.
21
+ // imply the dedicated LISTEN connection dropped. Raw socket codes (ECONNRESET, ...) are not
22
+ // counted: the driver reports a lost connection as ERR_POSTGRES_CONNECTION_*.
21
23
  const CONNECTION_LOSS_CODES = new Set([
22
- "ERR_POSTGRES_CONNECTION_CLOSED",
23
- "ERR_POSTGRES_CONNECTION_REFUSED",
24
- "ERR_POSTGRES_CONNECTION_TIMEOUT",
25
- "ERR_POSTGRES_CONNECTION_FAILED",
24
+ ...BUN_SQL_CONNECTION_ERROR_CODES,
26
25
  "57P01",
27
26
  ]);
28
27
  function isConnectionLossError(e) {
@@ -150,7 +149,7 @@ export function createEventDispatcher(options) {
150
149
  async function runConsumerTurn(consumer, effective, idleKeys) {
151
150
  const key = `${consumer.name}:${consumerInstanceId(consumer, options.instanceId)}`;
152
151
  const existing = inFlightTurns.get(key);
153
- if (existing)
152
+ if (existing !== undefined)
154
153
  return existing;
155
154
  // Feature-gate, backoff-gate and idle-gate are resolved synchronously,
156
155
  // before any promise is registered — a gated consumer must resolve
@@ -1,7 +1,8 @@
1
1
  import type { MemberReader } from "@cosmicdrift/kumiko-types/handlers";
2
- import type { HandlerAuth } from "../engine/types/index.ts";
2
+ import type { HandlerAuth, SessionUser } from "../engine/types/index.ts";
3
3
  import type { HandlerContextScope } from "./handler-context-scope.ts";
4
- export declare function buildAuthFacet(scope: HandlerContextScope): {
4
+ export type ResolveAuthClaimsFn = (ctx: HandlerContextScope["ctx"], user: SessionUser) => Promise<Record<string, unknown>>;
5
+ export declare function buildAuthFacet(scope: HandlerContextScope, resolveAuthClaimsFn: ResolveAuthClaimsFn): {
5
6
  readonly auth: HandlerAuth;
6
7
  readonly queryAsMember: MemberReader;
7
8
  readonly hasFeature: (featureName: string) => Promise<boolean>;
@@ -1,8 +1,7 @@
1
1
  import { INTERACTIVE_SIGN_IN_POLICY, resolveActiveMembershipFn } from "./active-membership.js";
2
- import { resolveAuthClaimsFn } from "./dispatch-shared.js";
3
2
  import { createMemberReaderFn } from "./member-reader.js";
4
3
  import { createGatedMemberReader, systemIdentitySwitchDenied } from "./system-identity-switch.js";
5
- export function buildAuthFacet(scope) {
4
+ export function buildAuthFacet(scope, resolveAuthClaimsFn) {
6
5
  const { ctx, type, user, tx, hasIdentitySwitchGrant, identitySwitchAudit } = scope;
7
6
  const { effectiveFeatures } = ctx;
8
7
  // Lazy — creates the reader (which fails closed on SYSTEM_TENANT_ID) only
@@ -17,7 +16,7 @@ export function buildAuthFacet(scope) {
17
16
  // handler surface just forwards the call so both entry points (login
18
17
  // handler via ctx.auth.resolveClaims, switch-tenant route via
19
18
  // dispatcher.resolveAuthClaims) cannot drift.
20
- resolveClaims: (claimsUser) => resolveAuthClaimsFn(ctx, claimsUser), // @wrapper-known semantic-alias
19
+ resolveClaims: (claimsUser) => resolveAuthClaimsFn(ctx, claimsUser),
21
20
  // Thin pass-through, same reasoning as resolveClaims above — one
22
21
  // resolve impl lives on the dispatcher so callers can't drift apart.
23
22
  // Internally queries memberships as SYSTEM, so it needs the same grant
@@ -25,7 +24,7 @@ export function buildAuthFacet(scope) {
25
24
  resolveActiveMembership: (userId, tenantId) => {
26
25
  if (!hasIdentitySwitchGrant)
27
26
  throw systemIdentitySwitchDenied(`handler "${type}"`);
28
- return resolveActiveMembershipFn(ctx, userId, tenantId, INTERACTIVE_SIGN_IN_POLICY); // @wrapper-known semantic-alias
27
+ return resolveActiveMembershipFn(ctx, userId, tenantId, INTERACTIVE_SIGN_IN_POLICY);
29
28
  },
30
29
  };
31
30
  return {
@@ -1,16 +1,19 @@
1
1
  import { crossTenantReadsGrantFor, escapeHatchFor } from "@cosmicdrift/kumiko-types/handlers";
2
2
  import { isAgentToolCallScope } from "../api/request-context-scopes.js";
3
3
  import { createHandlerCrossTenantReads } from "../db/cross-tenant-reads.js";
4
- import { createTenantDb, createUncheckedSystemDb } from "../db/tenant-db.js";
4
+ import { createSystemDbView, createTenantDb, createUncheckedSystemDb, } from "../db/tenant-db.js";
5
5
  import { createDerivativesContext } from "../derivatives/derivatives-context.js";
6
6
  import { mayOverrideTenant } from "../engine/cross-tenant.js";
7
7
  import { AccessDeniedError, FrameworkReasons } from "../errors/index.js";
8
8
  import { createTenantFileContext } from "../files/file-handle.js";
9
9
  import { attachOutsideTransaction } from "./attach-outside-transaction.js";
10
- import { createSystemScopedDbGuard, isMemberResolutionPrincipal, resolveAppPoolDb, } from "./dispatch-shared.js";
10
+ import { createSystemScopedDbGuard, isMemberResolutionPrincipal, resolveAppPoolDb, } from "./dispatch-context-helpers.js";
11
11
  import { buildPersonalDataGate } from "./write-origin.js";
12
12
  export function buildTenantScopedDb(scope, source, signal, foreignTenantId, denyWrites = false) {
13
13
  const { user, context, registry, origin, isSystem, writeEscapeHatch, handlerEscapeHatch } = scope;
14
+ // An agent tool call feeds the LLM context with the user's session: raw SQL and global writes
15
+ // would bypass the tenant and read filtering the tool result relies on.
16
+ const grantsEscapeHatches = foreignTenantId === undefined && !isAgentToolCallScope();
14
17
  const options = {
15
18
  db: source,
16
19
  tenantId: foreignTenantId ?? user.tenantId,
@@ -18,7 +21,7 @@ export function buildTenantScopedDb(scope, source, signal, foreignTenantId, deny
18
21
  meter: context.meter,
19
22
  signal,
20
23
  grants: {
21
- ...(foreignTenantId === undefined && {
24
+ ...(grantsEscapeHatches && {
22
25
  globalWrites: escapeHatchFor(writeEscapeHatch, "globalWrites"),
23
26
  unsafeRaw: escapeHatchFor(handlerEscapeHatch, "unsafeRaw"),
24
27
  }),
@@ -80,8 +83,12 @@ export function buildHandlerDbFacet(scope) {
80
83
  const rawDbOutsideTransaction = outsideTxSource
81
84
  ? buildTenantScopedDb(scope, outsideTxSource, undefined)
82
85
  : undefined;
86
+ // A resolved member gets the view: its unsafeRaw follows db's memberReadOnly denial and it has no
87
+ // outside-transaction source, whereas the unchecked variant would hand out a raw runner.
83
88
  const systemDb = isSystem && db
84
- ? createUncheckedSystemDb(db, rawDbOutsideTransaction, scope.reportEscapeHatch)
89
+ ? isMemberResolutionPrincipal(scope.user)
90
+ ? createSystemDbView(db, undefined, scope.reportEscapeHatch)
91
+ : createUncheckedSystemDb(db, rawDbOutsideTransaction, scope.reportEscapeHatch)
85
92
  : undefined;
86
93
  const crossTenantReads = buildHandlerCrossTenantReads(scope);
87
94
  // Same fail-closed treatment as `exposedDb` — a system handler reaching
@@ -81,13 +81,13 @@ export function buildDispatchFacet(scope, sinks, readers) {
81
81
  : unwrapSingle(await runBatch(ctx, [{ type: targetType, payload }], asUser, undefined, origin));
82
82
  const identitySwitch = createGatedIdentitySwitch(`handler "${type}"`, user, hasIdentitySwitchGrant, {
83
83
  // Inherits the caller's origin, so switching to SYSTEM cannot shed an anonymous root.
84
- queryAs: (asUser, targetType, payload) => executeQuery(ctx, targetType, payload, asUser, origin, tx, sinks.notifyCommitSink), // @wrapper-known semantic-alias
84
+ queryAs: (asUser, targetType, payload) => executeQuery(ctx, targetType, payload, asUser, origin, tx, sinks.notifyCommitSink),
85
85
  writeAs: writeAsUser,
86
86
  }, identitySwitchAudit);
87
87
  return {
88
88
  dispatch: {
89
89
  ...readers,
90
- query: (targetType, payload) => executeQuery(ctx, targetType, payload, user, origin, tx, sinks.notifyCommitSink), // @wrapper-known semantic-alias
90
+ query: (targetType, payload) => executeQuery(ctx, targetType, payload, user, origin, tx, sinks.notifyCommitSink),
91
91
  queryAs: identitySwitch.queryAs,
92
92
  write: (targetType, payload) => writeAsUser(user, targetType, payload),
93
93
  writeAs: identitySwitch.writeAs,
@@ -1,9 +1,9 @@
1
1
  import type { AppendEventArgs } from "@cosmicdrift/kumiko-types/handlers";
2
- import type { HandlerEvents } from "../engine/types/index.ts";
2
+ import type { DbRunner } from "../db/connection.ts";
3
+ import type { HandlerContext, HandlerEvents, Registry, TenantId } from "../engine/types/index.ts";
3
4
  import { IdempotentAppendConflictError as EventStoreIdempotentAppendConflictError, VersionConflictError as EventStoreVersionConflictError } from "../event-store/errors.ts";
4
5
  import { type StoredEvent } from "../event-store/event-store.ts";
5
6
  import type { HandlerContextScope } from "./handler-context-scope.ts";
6
- import { type ProjectionReader } from "./system-identity-switch.ts";
7
7
  declare function buildTryAppendEvent(scope: HandlerContextScope): (args: AppendEventArgs) => Promise<{
8
8
  ok: true;
9
9
  event: StoredEvent;
@@ -17,11 +17,16 @@ declare function buildTryAppendEvent(scope: HandlerContextScope): (args: AppendE
17
17
  ok: false;
18
18
  conflict: EventStoreIdempotentAppendConflictError;
19
19
  }>;
20
+ /** Shared by handler and job `ctx.events.load`: tenant-scoped read through the upcaster chain. */
21
+ export declare function loadUpcastedAggregate(source: {
22
+ readonly db: DbRunner;
23
+ readonly registry: Registry;
24
+ readonly tenantId: TenantId;
25
+ }, aggregateId: string, loadOptions?: Parameters<HandlerContext["events"]["load"]>[1]): Promise<readonly StoredEvent[]>;
20
26
  type EventsFacet = Omit<HandlerEvents, "tryAppend"> & {
21
27
  readonly tryAppend: ReturnType<typeof buildTryAppendEvent>;
22
28
  };
23
29
  export declare function buildEventStoreFacet(scope: HandlerContextScope): {
24
30
  readonly events: EventsFacet;
25
- readonly queryProjection: ProjectionReader;
26
31
  };
27
32
  export {};
@@ -1,30 +1,14 @@
1
- import { runInSavepoint, selectMany } from "../db/query.js";
2
- import { runInSystemRowLevelSecurityScope } from "../db/row-level-security-scope.js";
3
- import { hasTenantColumn } from "../db/tenant-db.js";
1
+ import { runInSavepoint } from "../db/query.js";
4
2
  import { InternalError, VersionConflictError } from "../errors/index.js";
5
3
  import { memberResolutionReadOnlyDenied } from "../errors/member-resolution.js";
6
4
  import { archiveStream as archiveStreamHelper, isStreamArchived, restoreStream as restoreStreamHelper, } from "../event-store/archive.js";
7
5
  import { IdempotentAppendConflictError as EventStoreIdempotentAppendConflictError, VersionConflictError as EventStoreVersionConflictError, } from "../event-store/errors.js";
8
6
  import { loadAggregate, loadAggregateAsOf, loadAggregateForWriting, } from "../event-store/event-store.js";
9
7
  import { effectiveSnapshotGeneration, loadAggregateWithSnapshot, saveSnapshot, } from "../event-store/snapshot.js";
10
- import { upcastStoredEvent, upcastStoredEvents } from "../event-store/upcaster.js";
8
+ import { makeUpcastCtx, upcastStoredEvent, upcastStoredEvents } from "../event-store/upcaster.js";
11
9
  import { appendDomainEventCore } from "./append-event-core.js";
12
- import { isMemberResolutionPrincipal, resolveDbSource, } from "./dispatch-shared.js";
13
- import { createGatedProjectionReader } from "./system-identity-switch.js";
10
+ import { isMemberResolutionPrincipal, requireDbSource } from "./dispatch-context-helpers.js";
14
11
  import { asTypedAppendEventFn } from "./typed-append-event.js";
15
- function requireDbSource(ctx, tx, surfaceCall) {
16
- const dbSource = resolveDbSource(ctx, tx);
17
- if (!dbSource) {
18
- throw new InternalError({
19
- message: `${surfaceCall} requires a database connection — none is configured.`,
20
- });
21
- }
22
- return dbSource;
23
- }
24
- // ctx.events.append — append a domain event onto a specific aggregate stream
25
- // in the current tx, then fire matching inline projections. Core logic
26
- // lives in appendDomainEventCore; this wrapper just locates dbSource +
27
- // stringifies the SessionUser id for the shared helper.
28
12
  async function appendDomainEvent(ctx, args, user, tx, callerFeature) {
29
13
  // Sink behind every append surface, so a resolved member stays read-only even via fetchForWriting handles.
30
14
  if (isMemberResolutionPrincipal(user))
@@ -124,19 +108,23 @@ function buildFetchForWriting(scope) {
124
108
  };
125
109
  };
126
110
  }
111
+ /** Shared by handler and job `ctx.events.load`: tenant-scoped read through the upcaster chain. */
112
+ export async function loadUpcastedAggregate(source, aggregateId, loadOptions) {
113
+ const { db, registry, tenantId } = source;
114
+ const includeArchived = loadOptions?.includeArchived === true;
115
+ const events = loadOptions?.asOf
116
+ ? await loadAggregateAsOf(db, aggregateId, tenantId, loadOptions.asOf, { includeArchived })
117
+ : await loadAggregate(db, aggregateId, tenantId, {
118
+ includeArchived,
119
+ ...(loadOptions?.atVersion !== undefined && { atVersion: loadOptions.atVersion }),
120
+ });
121
+ return upcastStoredEvents(events, registry.getEventUpcasters(), makeUpcastCtx(db, tenantId));
122
+ }
127
123
  function buildLoadAggregate(scope) {
128
124
  const { ctx, user, tx, registry } = scope;
129
- return async (aggregateId, loadOptions) => {
130
- const dbSource = requireDbSource(ctx, tx, `ctx.events.load("${aggregateId}")`);
131
- const events = loadOptions?.asOf
132
- ? await loadAggregateAsOf(dbSource, aggregateId, user.tenantId, loadOptions.asOf)
133
- : await loadAggregate(dbSource, aggregateId, user.tenantId, {
134
- ...(loadOptions?.atVersion !== undefined && { atVersion: loadOptions.atVersion }),
135
- });
136
- return upcastStoredEvents(events, registry.getEventUpcasters(), {
137
- db: dbSource,
138
- tenantId: user.tenantId,
139
- });
125
+ return (aggregateId, loadOptions) => {
126
+ const db = requireDbSource(ctx, tx, `ctx.events.load("${aggregateId}")`);
127
+ return loadUpcastedAggregate({ db, registry, tenantId: user.tenantId }, aggregateId, loadOptions);
140
128
  };
141
129
  }
142
130
  function buildSnapshotAggregate(scope) {
@@ -167,43 +155,10 @@ function buildLoadAggregateWithSnapshot(scope) {
167
155
  return loadAggregateWithSnapshot(dbSource, aggregateId, user.tenantId, reducer, initial, {
168
156
  ...loadOptions,
169
157
  entityEventVersionOf: (aggregateType) => registry.getEntity(aggregateType)?.eventVersion,
170
- upcastEvent: (event) => upcastStoredEvent(event, upcasters, upcastCtx), // @wrapper-known semantic-alias
158
+ upcastEvent: (event) => upcastStoredEvent(event, upcasters, upcastCtx),
171
159
  });
172
160
  };
173
161
  }
174
- // queryProjection works against both single-stream and multi-stream
175
- // projections. MSPs without a table cannot be queried — those are
176
- // side-effect-only consumers (no state to read back).
177
- function buildHandlerProjectionReader(scope) {
178
- const { ctx, type, user, tx, registry, hasIdentitySwitchGrant, identitySwitchAudit } = scope;
179
- const findProjectionTable = (qualifiedName) => registry.getAllProjections().get(qualifiedName)?.table ??
180
- registry.getAllMultiStreamProjections().get(qualifiedName)?.table;
181
- const ungatedQueryProjection = async (qualifiedName, queryOptions) => {
182
- const projTable = findProjectionTable(qualifiedName);
183
- if (!projTable) {
184
- const singleNames = [...registry.getAllProjections().keys()];
185
- const mspNames = [...registry.getAllMultiStreamProjections().keys()].filter((n) => registry.getAllMultiStreamProjections().get(n)?.table);
186
- const all = [...singleNames, ...mspNames];
187
- throw new InternalError({
188
- message: `ctx.dispatch.queryProjection("${qualifiedName}") — projection not registered, or it is a ` +
189
- `table-less MSP (side-effect-only). Known queryable projections: ${all.join(", ") || "(none)"}`,
190
- });
191
- }
192
- const dbSource = requireDbSource(ctx, tx, `ctx.dispatch.queryProjection("${qualifiedName}")`);
193
- const allTenants = queryOptions?.unsafeAllTenants === true;
194
- const where = hasTenantColumn(projTable) && !allTenants ? { tenantId: user.tenantId } : undefined;
195
- const read = () => selectMany(dbSource, projTable, where);
196
- const rows = await (allTenants
197
- ? runInSystemRowLevelSecurityScope("handler projection read with allTenants spans every tenant", read)
198
- : read());
199
- return rows; // @cast-boundary engine-payload
200
- };
201
- return createGatedProjectionReader(`handler "${type}"`, hasIdentitySwitchGrant, ungatedQueryProjection, identitySwitchAudit, (qualifiedName) => {
202
- const projTable = findProjectionTable(qualifiedName);
203
- // Unknown projection: keep the grant check first, the ungated reader reports the real error.
204
- return projTable === undefined || hasTenantColumn(projTable);
205
- });
206
- }
207
162
  export function buildEventStoreFacet(scope) {
208
163
  const { ctx, type, user, tx, registry } = scope;
209
164
  const events = {
@@ -240,5 +195,5 @@ export function buildEventStoreFacet(scope) {
240
195
  snapshot: buildSnapshotAggregate(scope),
241
196
  loadWithSnapshot: buildLoadAggregateWithSnapshot(scope),
242
197
  };
243
- return { events, queryProjection: buildHandlerProjectionReader(scope) };
198
+ return { events };
244
199
  }
@@ -24,6 +24,7 @@ function allowlistedReadOnlyProxy(target, allowedMethods) {
24
24
  });
25
25
  }
26
26
  const MEMBER_READ_SEARCH_METHODS = new Set(["search"]);
27
+ const MEMBER_READ_SECRETS_METHODS = new Set(["get", "has"]);
27
28
  const MEMBER_READ_ENTITY_CACHE_METHODS = new Set(["get", "mget"]);
28
29
  const MEMBER_READ_REDIS_METHODS = new Set([
29
30
  "get",
@@ -48,10 +49,12 @@ const MEMBER_READ_REDIS_METHODS = new Set([
48
49
  "zrange",
49
50
  ]);
50
51
  function readOnlyServices(services) {
51
- const { searchAdapter, redis, entityCache, jobRunner } = services;
52
+ const { searchAdapter, redis, entityCache, jobRunner, secrets } = services;
52
53
  // A read as a member gets no file storage, no notify factory and no job runner; the read-only
53
54
  // proxies keep the rest. The resolver and factories would reopen what files/notify close.
54
- const { files: _files, derivatives: _derivatives, _fileProviderResolver: _resolver, ...kept } = withoutNotifyFactories(services);
55
+ // kms, masterKeyProvider and the audit sink write through their own connections, which the
56
+ // READ ONLY transaction does not cover.
57
+ const { files: _files, derivatives: _derivatives, _fileProviderResolver: _resolver, kms: _kms, masterKeyProvider: _masterKeyProvider, _escapeHatchAuditSink: _auditSink, secrets: _secrets, ...kept } = withoutNotifyFactories(services);
55
58
  const runner = jobRunner && denyingJobRunnerProxy();
56
59
  return {
57
60
  ...kept,
@@ -59,6 +62,9 @@ function readOnlyServices(services) {
59
62
  ...(searchAdapter && {
60
63
  searchAdapter: allowlistedReadOnlyProxy(searchAdapter, MEMBER_READ_SEARCH_METHODS),
61
64
  }),
65
+ ...(secrets && {
66
+ secrets: allowlistedReadOnlyProxy(secrets, MEMBER_READ_SECRETS_METHODS),
67
+ }),
62
68
  ...(redis && { redis: allowlistedReadOnlyProxy(redis, MEMBER_READ_REDIS_METHODS) }),
63
69
  ...(entityCache && {
64
70
  entityCache: allowlistedReadOnlyProxy(entityCache, MEMBER_READ_ENTITY_CACHE_METHODS),
@@ -67,13 +73,15 @@ function readOnlyServices(services) {
67
73
  }
68
74
  // Every write/side-effect surface throws, so "no writeAsMember" holds even
69
75
  // if a handler tries ctx.dispatch.write directly on a resolved member principal.
70
- // Deliberately open: `db` (guarded by the READ ONLY transaction + memberReadOnly grant),
71
- // and read-only methods of searchAdapter / redis / entityCache (allowlisted).
76
+ // Deliberately open: `db` and, for r.systemScope() handlers, `systemDb` (both ride the READ ONLY
77
+ // transaction; the systemDb is a view whose unsafeRaw follows db's memberReadOnly denial and that has
78
+ // no outside-transaction source), plus read-only methods of searchAdapter / redis / entityCache.
72
79
  export function applyMemberResolutionReadOnly(handlerContext) {
73
- // `db` stays open — executeQuery runs the whole handler in a Postgres READ ONLY
74
- // transaction, and its `memberReadOnly` grant denies every raw-runner handout.
80
+ // executeQuery runs the whole handler in a Postgres READ ONLY transaction, and `db`'s
81
+ // `memberReadOnly` grant denies every raw-runner handout. crossTenantReads and the
82
+ // outside-transaction door would escape that transaction, so they are dropped.
75
83
  dropOutsideTransaction(handlerContext);
76
- const { systemDb: _systemDb, crossTenantReads: _crossTenantReads, ...kept } = handlerContext;
84
+ const { crossTenantReads: _crossTenantReads, ...kept } = handlerContext;
77
85
  return {
78
86
  ...kept,
79
87
  dispatch: {
@@ -95,7 +103,7 @@ export function applyMemberResolutionReadOnly(handlerContext) {
95
103
  snapshot: denyMemberResolutionWrite,
96
104
  },
97
105
  auth: { ...handlerContext.auth, resolveActiveMembership: denyMemberResolutionWrite },
98
- // A read as a member gets no system-scope DB, preSave pipeline or file storage.
106
+ // A read as a member gets no preSave pipeline or file storage.
99
107
  lifecycle: {
100
108
  afterCommit: throwMemberResolutionDenied,
101
109
  afterRollback: throwMemberResolutionDenied,
@@ -9,5 +9,6 @@ export declare function buildNotifyFacet(scope: HandlerContextScope, sinks: Comm
9
9
  factoryServices: {
10
10
  _notifyInTransactionFactory?: ((notifyUser: SessionUser, notifyTenantId: TenantId) => NotifyFn) | undefined;
11
11
  _notifyAfterCommitFactory?: ((notifyUser: SessionUser, notifyTenantId: TenantId) => NotifyFn) | undefined;
12
+ _logOwnDeliveryAttempt?: import("@cosmicdrift/kumiko-types/handlers").DeliveryAttemptLogFn | undefined;
12
13
  };
13
14
  };
@@ -43,6 +43,7 @@ export function buildNotifyFacet(scope, sinks, outsideTxSource) {
43
43
  ? (notifyUser, notifyTenantId) => notifyFactory(notifyUser, notifyTenantId, notifyJobDispatcher, undefined, context._fileProviderResolver)
44
44
  : undefined;
45
45
  const notify = buildNotify(scope, sinks, notifyAfterCommitFactory, notifyInTransactionFactory);
46
+ const logOwnDeliveryAttempt = context._deliveryAttemptLogFactory?.(scope.user, scope.user.tenantId, outsideTxSource);
46
47
  return {
47
48
  notify,
48
49
  factoryServices: {
@@ -50,6 +51,7 @@ export function buildNotifyFacet(scope, sinks, outsideTxSource) {
50
51
  _notifyInTransactionFactory: notifyInTransactionFactory,
51
52
  }),
52
53
  ...(notifyAfterCommitFactory && { _notifyAfterCommitFactory: notifyAfterCommitFactory }),
54
+ ...(logOwnDeliveryAttempt && { _logOwnDeliveryAttempt: logOwnDeliveryAttempt }),
53
55
  },
54
56
  };
55
57
  }
@@ -84,9 +84,10 @@ export function denyTransactionBoundSurfaces(handlerContext) {
84
84
  },
85
85
  };
86
86
  }
87
- // A notify factory builds a working notify, so a phase that denies ctx.notify must drop them too.
87
+ // A notify factory builds a working notify, so a phase that denies ctx.notify must drop them too,
88
+ // along with the delivery attempt log that belongs to a delivery.
88
89
  export function withoutNotifyFactories(services) {
89
- const { _notifyFactory: _factory, _notifyInTransactionFactory: _inTransaction, _notifyAfterCommitFactory: _afterCommit, ...rest } = services;
90
+ const { _notifyFactory: _factory, _notifyInTransactionFactory: _inTransaction, _notifyAfterCommitFactory: _afterCommit, _deliveryAttemptLogFactory: _attemptLogFactory, _logOwnDeliveryAttempt: _ownAttemptLog, ...rest } = services;
90
91
  return rest;
91
92
  }
92
93
  // The beforeTransaction phase has no write need at all, so it also loses the outside-transaction
@@ -0,0 +1,3 @@
1
+ import type { HandlerContextScope } from "./handler-context-scope.ts";
2
+ import { type ProjectionReader } from "./system-identity-switch.ts";
3
+ export declare function buildHandlerProjectionReader(scope: HandlerContextScope): ProjectionReader;
@@ -0,0 +1,39 @@
1
+ import { selectMany } from "../db/query.js";
2
+ import { runInSystemRowLevelSecurityScope } from "../db/row-level-security-scope.js";
3
+ import { hasTenantColumn } from "../db/tenant-db.js";
4
+ import { InternalError } from "../errors/index.js";
5
+ import { requireDbSource } from "./dispatch-context-helpers.js";
6
+ import { createGatedProjectionReader } from "./system-identity-switch.js";
7
+ // queryProjection works against both single-stream and multi-stream
8
+ // projections. MSPs without a table cannot be queried — those are
9
+ // side-effect-only consumers (no state to read back).
10
+ export function buildHandlerProjectionReader(scope) {
11
+ const { ctx, type, user, tx, registry, hasIdentitySwitchGrant, identitySwitchAudit } = scope;
12
+ const findProjectionTable = (qualifiedName) => registry.getAllProjections().get(qualifiedName)?.table ??
13
+ registry.getAllMultiStreamProjections().get(qualifiedName)?.table;
14
+ const ungatedQueryProjection = async (qualifiedName, queryOptions) => {
15
+ const projTable = findProjectionTable(qualifiedName);
16
+ if (!projTable) {
17
+ const singleNames = [...registry.getAllProjections().keys()];
18
+ const mspNames = [...registry.getAllMultiStreamProjections().keys()].filter((n) => registry.getAllMultiStreamProjections().get(n)?.table);
19
+ const all = [...singleNames, ...mspNames];
20
+ throw new InternalError({
21
+ message: `ctx.dispatch.queryProjection("${qualifiedName}") — projection not registered, or it is a ` +
22
+ `table-less MSP (side-effect-only). Known queryable projections: ${all.join(", ") || "(none)"}`,
23
+ });
24
+ }
25
+ const dbSource = requireDbSource(ctx, tx, `ctx.dispatch.queryProjection("${qualifiedName}")`);
26
+ const allTenants = queryOptions?.unsafeAllTenants === true;
27
+ const where = hasTenantColumn(projTable) && !allTenants ? { tenantId: user.tenantId } : undefined;
28
+ const read = () => selectMany(dbSource, projTable, where);
29
+ const rows = await (allTenants
30
+ ? runInSystemRowLevelSecurityScope("handler projection read with allTenants spans every tenant", read)
31
+ : read());
32
+ return rows; // @cast-boundary engine-payload
33
+ };
34
+ return createGatedProjectionReader(`handler "${type}"`, hasIdentitySwitchGrant, ungatedQueryProjection, identitySwitchAudit, (qualifiedName) => {
35
+ const projTable = findProjectionTable(qualifiedName);
36
+ // Unknown projection: keep the grant check first, the ungated reader reports the real error.
37
+ return projTable === undefined || hasTenantColumn(projTable);
38
+ });
39
+ }
@@ -3,7 +3,7 @@ import type { RequestContextData } from "../api/request-context-internals.ts";
3
3
  import type { DbConnection, DbTx } from "../db/connection.ts";
4
4
  import type { AppContext, HandlerContext, HandlerLifecycle, Registry, SessionUser } from "../engine/types/index.ts";
5
5
  import type { ContextServiceOverrides } from "./context-services.ts";
6
- import { type DispatchContext, type HandlerTransactionScope } from "./dispatch-shared.ts";
6
+ import type { DispatchContext, HandlerTransactionScope } from "./dispatch-shared.ts";
7
7
  import type { WriteOrigin } from "./write-origin.ts";
8
8
  export type HandlerContextScope = {
9
9
  readonly ctx: DispatchContext;
@@ -1,13 +1,25 @@
1
1
  import { escapeHatchFor, } from "@cosmicdrift/kumiko-types/handlers";
2
2
  import { requestContext } from "../api/request-context.js";
3
+ import { isAgentToolCallScope } from "../api/request-context-scopes.js";
4
+ import { AccessDeniedError } from "../errors/index.js";
5
+ import { AgentReasons } from "../errors/reasons.js";
3
6
  import { createFallbackLogger } from "../logging/utils.js";
4
7
  import { createEscapeHatchReporter } from "../observability/escape-hatch-report.js";
5
- import { resolveDbSource, } from "./dispatch-shared.js";
8
+ import { resolveDbSource } from "./dispatch-context-helpers.js";
9
+ import { isEffectivelySystemScoped } from "./effective-system-scope.js";
6
10
  import { createUserLiveSignals } from "./user-live-signals.js";
7
11
  export function resolveHandlerContextScope(input) {
8
12
  const { ctx, type, user, origin, tx, transactionScope } = input;
9
13
  const { registry, appContext: context } = ctx;
10
- const isSystem = registry.isHandlerSystemScoped(type);
14
+ const isSystem = isEffectivelySystemScoped(registry, type);
15
+ // A system-scope handler reads and writes across tenants; an agent tool call carries the user's
16
+ // session into the LLM context, so it must never reach one.
17
+ if (isSystem && isAgentToolCallScope()) {
18
+ throw new AccessDeniedError({
19
+ message: `"${type}" is a system-scope handler and cannot run inside an agent tool call`,
20
+ details: { reason: AgentReasons.toolNotAllowed, handler: type },
21
+ });
22
+ }
11
23
  // The outer dispatcher receives a DbConnection from the server/stack;
12
24
  // AppContext's `db` union also allows TenantDb (for downstream hook calls),
13
25
  // but at this point we're the root of the pipeline — cast is safe.
@@ -13,7 +13,7 @@ export { ConsumerStatuses, createEventConsumerStateTable, eventConsumerStateTabl
13
13
  export type { EventDedup } from "./event-dedup.ts";
14
14
  export { createEventDedup } from "./event-dedup.ts";
15
15
  export type { ConsumerProgress, ConsumerRecoveryState, EventDispatcher, } from "./event-dispatcher.ts";
16
- export { ConsumerTransitionError, disableConsumer, enableConsumer, getAllConsumerProgress, getConsumerState, listConsumersWithState, restartConsumer, skipPoisonEvent, } from "./event-dispatcher.ts";
16
+ export { ConsumerTransitionError, DEFAULT_BATCH_SIZE as DEFAULT_EVENT_DISPATCHER_BATCH_SIZE, disableConsumer, enableConsumer, getAllConsumerProgress, getConsumerState, listConsumersWithState, restartConsumer, skipPoisonEvent, } from "./event-dispatcher.ts";
17
17
  export type { PruneEventsOptions } from "./event-retention.ts";
18
18
  export { ConsumerLagError, pruneEvents } from "./event-retention.ts";
19
19
  export type { IdempotencyGuard } from "./idempotency.ts";
@@ -9,7 +9,7 @@ export { createDistributedLock } from "./distributed-lock.js";
9
9
  export { createEntityCache } from "./entity-cache.js";
10
10
  export { ConsumerStatuses, createEventConsumerStateTable, eventConsumerStateTable, SHARED_INSTANCE_SENTINEL, } from "./event-consumer-state.js";
11
11
  export { createEventDedup } from "./event-dedup.js";
12
- export { ConsumerTransitionError, disableConsumer, enableConsumer, getAllConsumerProgress, getConsumerState, listConsumersWithState, restartConsumer, skipPoisonEvent, } from "./event-dispatcher.js";
12
+ export { ConsumerTransitionError, DEFAULT_BATCH_SIZE as DEFAULT_EVENT_DISPATCHER_BATCH_SIZE, disableConsumer, enableConsumer, getAllConsumerProgress, getConsumerState, listConsumersWithState, restartConsumer, skipPoisonEvent, } from "./event-dispatcher.js";
13
13
  export { ConsumerLagError, pruneEvents } from "./event-retention.js";
14
14
  export { createIdempotencyGuard } from "./idempotency.js";
15
15
  export { assertIrreversibleOperationAllowed } from "./irreversible-operation-gate.js";
@@ -22,6 +22,7 @@ export type LifecycleHooks = {
22
22
  runPostDelete(handlerName: string, payload: DeleteContext, context: HandlerContext, phase?: HookPhase): Promise<void>;
23
23
  runPostSaveBatch(results: readonly SaveContext[], context: HandlerContext): Promise<void>;
24
24
  runPostDeleteBatch(payloads: readonly DeleteContext[], context: HandlerContext): Promise<void>;
25
+ hasBatchHooks(): boolean;
25
26
  };
26
27
  export type LifecycleOptions = {
27
28
  eventDedup?: EventDedup;
@@ -149,8 +149,8 @@ export function createLifecycleHooks(registry, systemHooks = {}, options = {}) {
149
149
  payload: result,
150
150
  context,
151
151
  entityName: result.entityName,
152
- getHandlerHooks: (n) => registry.getPostSaveHooks(n, phase, eff), // @wrapper-known semantic-alias
153
- getEntityHooks: (n) => registry.getEntityPostSaveHooks(n, phase, eff), // @wrapper-known semantic-alias
152
+ getHandlerHooks: (n) => registry.getPostSaveHooks(n, phase, eff),
153
+ getEntityHooks: (n) => registry.getEntityPostSaveHooks(n, phase, eff),
154
154
  systemHookDefs: systemHooks.postSave,
155
155
  phaseLabel: `postSave:${phase}`,
156
156
  hookPhase: phase,
@@ -184,13 +184,16 @@ export function createLifecycleHooks(registry, systemHooks = {}, options = {}) {
184
184
  payload,
185
185
  context,
186
186
  entityName: payload.entityName,
187
- getHandlerHooks: (n) => registry.getPostDeleteHooks(n, phase, eff), // @wrapper-known semantic-alias
188
- getEntityHooks: (n) => registry.getEntityPostDeleteHooks(n, phase, eff), // @wrapper-known semantic-alias
187
+ getHandlerHooks: (n) => registry.getPostDeleteHooks(n, phase, eff),
188
+ getEntityHooks: (n) => registry.getEntityPostDeleteHooks(n, phase, eff),
189
189
  systemHookDefs: systemHooks.postDelete,
190
190
  phaseLabel: `postDelete:${phase}`,
191
191
  hookPhase: phase,
192
192
  });
193
193
  },
194
+ hasBatchHooks() {
195
+ return ((systemHooks.postSaveBatch?.length ?? 0) + (systemHooks.postDeleteBatch?.length ?? 0) > 0);
196
+ },
194
197
  async runPostSaveBatch(results, context) {
195
198
  await runBatchHooks({
196
199
  hooks: systemHooks.postSaveBatch,
@@ -1,5 +1,6 @@
1
1
  // ctx.dispatch.queryAsMember — reads a query handler as a stored tenant member. The
2
2
  // resolved SessionUser never leaves this module.
3
+ import { runInSystemRowLevelSecurityScope } from "../db/row-level-security-scope.js";
3
4
  import { buildSessionRoles } from "../engine/membership-roles.js";
4
5
  import { SYSTEM_TENANT_ID } from "../engine/types/index.js";
5
6
  import { AccessDeniedError, FrameworkReasons, InternalError } from "../errors/index.js";
@@ -37,7 +38,8 @@ async function resolveMember(ctx, tenantId, userId) {
37
38
  }
38
39
  // resolveDbSource(ctx, undefined) never returns a tx, only AppContext.db.
39
40
  const db = dbSource; // @cast-boundary db-operator
40
- const profile = await principalPlugin.resolveProfile(userId, { db });
41
+ // The user row lives on the system tenant, which a tenant scope no longer reads.
42
+ const profile = await runInSystemRowLevelSecurityScope("member resolution reads the stored user profile, a system tenant row", () => principalPlugin.resolveProfile(userId, { db }));
41
43
  if (!profile)
42
44
  throw memberResolutionDenied();
43
45
  // buildSessionRoles runs stripForbiddenMembershipRoles on the membership half (rebuild-resurrected roles).
@@ -71,7 +73,7 @@ export function createMemberReaderFn(ctx, tenantId, tx) {
71
73
  const cache = new Map();
72
74
  function resolve(userId) {
73
75
  const cached = cache.get(userId);
74
- if (cached)
76
+ if (cached !== undefined)
75
77
  return cached;
76
78
  const pending = resolveMember(ctx, tenantId, userId);
77
79
  cache.set(userId, pending);
@@ -64,7 +64,7 @@ async function replayMultiStreamProjectionIntoShadow(mspName, deps) {
64
64
  await createRebuildDeadLetterTable(db);
65
65
  const replayedIds = [];
66
66
  await db.begin(async (tx) => {
67
- await assertRebuildableRowLevelSecurity(tx, meta.tableName);
67
+ await assertRebuildableRowLevelSecurity(tx, meta);
68
68
  await resetConsumerForMspRebuild(tx, mspName, SHARED_INSTANCE_SENTINEL);
69
69
  await selectConsumerForUpdate(tx, mspName, SHARED_INSTANCE_SENTINEL);
70
70
  const { horizon, gaps: seededGaps } = await selectEventIdHorizonWithMissingRanges(tx);
@@ -0,0 +1,5 @@
1
+ import type { WriteResult } from "@cosmicdrift/kumiko-types/handlers";
2
+ import type { DbTx } from "../db/connection.ts";
3
+ import type { SessionUser } from "../engine/types/index.ts";
4
+ import type { DispatchContext } from "./dispatch-shared.ts";
5
+ export declare function rejectUnverifiedParent(ctx: DispatchContext, type: string, parentRow: Record<string, unknown>, parentId: string, user: SessionUser, tx: DbTx | undefined): Promise<WriteResult | undefined>;