@cosmicdrift/kumiko-framework 0.413.1 → 0.415.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (479) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +69 -13
  4. package/agents/api/framework-errors.md +1 -1
  5. package/agents/api/framework-event-store.md +14 -0
  6. package/agents/api/framework-ui-types.md +158 -21
  7. package/agents/api/renderer-web.md +112 -11
  8. package/agents/api/testing-helpers.md +3 -2
  9. package/agents/api/testing-stack.md +3 -0
  10. package/agents/api/types.md +248 -24
  11. package/agents/api.md +7 -7
  12. package/agents/boot-rules.md +66 -10
  13. package/agents/examples/api-docs.md +2 -6
  14. package/agents/examples/auth-mfa.md +57 -10
  15. package/agents/examples/chat-channels.md +2 -0
  16. package/agents/examples/crypto-shredding-hr.md +63 -1
  17. package/agents/examples/currencies-global.md +1 -0
  18. package/agents/examples/env-composition.md +7 -11
  19. package/agents/examples/managed-pages.md +90 -1
  20. package/agents/examples/pwa-shell.md +210 -0
  21. package/agents/examples/rate-limiting.md +3 -3
  22. package/agents/examples/record-detail-layout.md +1643 -67
  23. package/agents/examples/workflow-engine.md +16 -12
  24. package/agents/examples.md +1 -0
  25. package/agents/features-index.md +4 -2
  26. package/agents/features.md +22 -7
  27. package/agents/widgets.md +26 -1
  28. package/dist/api/api-constants.d.ts +1 -0
  29. package/dist/api/api-constants.js +4 -0
  30. package/dist/api/auth-middleware.js +4 -3
  31. package/dist/api/auth-routes-shared.js +2 -1
  32. package/dist/api/entity-read-access.d.ts +1 -0
  33. package/dist/api/entity-read-access.js +18 -0
  34. package/dist/api/export/export-route.d.ts +6 -1
  35. package/dist/api/export/export-route.js +27 -1
  36. package/dist/api/export/export-rows.js +19 -3
  37. package/dist/api/request-context-internals.d.ts +2 -0
  38. package/dist/api/request-context-scopes.js +9 -2
  39. package/dist/api/request-context.js +1 -1
  40. package/dist/api/routes.d.ts +2 -0
  41. package/dist/api/routes.js +9 -1
  42. package/dist/api/server-event-dispatcher.js +3 -0
  43. package/dist/api/server-extra-routes.js +2 -1
  44. package/dist/api/server-feature-http-routes.d.ts +9 -0
  45. package/dist/api/server-feature-http-routes.js +109 -0
  46. package/dist/api/server-middleware.js +2 -19
  47. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  48. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  49. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  50. package/dist/api/server-rate-limit-wiring.js +37 -0
  51. package/dist/api/server-routes.d.ts +4 -12
  52. package/dist/api/server-routes.js +12 -171
  53. package/dist/api/server-schema-route.d.ts +3 -0
  54. package/dist/api/server-schema-route.js +58 -0
  55. package/dist/api/server-wiring.js +2 -37
  56. package/dist/api/server.js +3 -1
  57. package/dist/compliance/override-schema.js +5 -5
  58. package/dist/compliance/sub-processors.js +10 -1
  59. package/dist/crypto/index.d.ts +1 -1
  60. package/dist/crypto/index.js +1 -1
  61. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  62. package/dist/crypto/pii-field-encryption.js +16 -1
  63. package/dist/db/apply-entity-event.js +4 -0
  64. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  65. package/dist/db/bun-sql-connection-codes.js +7 -0
  66. package/dist/db/collect-table-metas.js +4 -1
  67. package/dist/db/config-seed.js +1 -1
  68. package/dist/db/derived-field-sql.js +15 -13
  69. package/dist/db/derived-related-sql.d.ts +2 -2
  70. package/dist/db/derived-related-sql.js +4 -2
  71. package/dist/db/dialect.d.ts +3 -0
  72. package/dist/db/dialect.js +1 -3
  73. package/dist/db/driver-row-coercion.js +2 -2
  74. package/dist/db/driver-value-preparation.js +1 -1
  75. package/dist/db/eagerload.js +15 -12
  76. package/dist/db/entity-table-meta.d.ts +2 -0
  77. package/dist/db/entity-table-meta.js +7 -0
  78. package/dist/db/event-store-executor-context.js +13 -8
  79. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  80. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  81. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  82. package/dist/db/event-store-executor-read-filter.js +28 -11
  83. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  84. package/dist/db/event-store-executor-read-search.js +6 -6
  85. package/dist/db/event-store-executor-read-sort.js +3 -3
  86. package/dist/db/event-store-executor-read-where.js +14 -5
  87. package/dist/db/event-store-executor-read.js +7 -7
  88. package/dist/db/event-store-executor-write.js +50 -95
  89. package/dist/db/executor-managed-tables.js +4 -1
  90. package/dist/db/index.d.ts +4 -2
  91. package/dist/db/index.js +4 -2
  92. package/dist/db/known-table-names.d.ts +1 -0
  93. package/dist/db/known-table-names.js +7 -5
  94. package/dist/db/list-aggregate-labels.d.ts +1 -0
  95. package/dist/db/list-aggregate-labels.js +9 -1
  96. package/dist/db/migrate-generator.js +23 -4
  97. package/dist/db/migrate-rls-diff.d.ts +1 -0
  98. package/dist/db/migrate-rls-diff.js +15 -1
  99. package/dist/db/migrate-runner.js +2 -2
  100. package/dist/db/money.d.ts +1 -1
  101. package/dist/db/money.js +1 -4
  102. package/dist/db/parent-ref-clause.d.ts +6 -2
  103. package/dist/db/parent-ref-clause.js +105 -24
  104. package/dist/db/parent-ref-global-hosts.d.ts +23 -0
  105. package/dist/db/parent-ref-global-hosts.js +85 -0
  106. package/dist/db/production-schema-command-hint.d.ts +1 -0
  107. package/dist/db/production-schema-command-hint.js +3 -0
  108. package/dist/db/queries/backfill-pii.js +55 -29
  109. package/dist/db/queries/ddl.js +13 -2
  110. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  111. package/dist/db/queries/event-store-open-streams.js +33 -0
  112. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  113. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  114. package/dist/db/queries/event-store.js +0 -1
  115. package/dist/db/queries/raw-sql.js +0 -1
  116. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  117. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  118. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  119. package/dist/db/queries/rls-boot-catalog.js +13 -9
  120. package/dist/db/queries/rls-shape.d.ts +3 -1
  121. package/dist/db/queries/rls-shape.js +31 -6
  122. package/dist/db/queries/session-advisory-lock.js +2 -1
  123. package/dist/db/queries/test-stack.js +7 -7
  124. package/dist/db/query.js +16 -11
  125. package/dist/db/rebuild-marker.js +11 -2
  126. package/dist/db/render-rls-ddl.d.ts +2 -0
  127. package/dist/db/render-rls-ddl.js +16 -11
  128. package/dist/db/replay-migration-sql.js +1 -1
  129. package/dist/db/row-level-security-boot-check.js +18 -5
  130. package/dist/db/row-level-security-connection.js +25 -12
  131. package/dist/db/row-level-security-scope.d.ts +2 -1
  132. package/dist/db/row-level-security-scope.js +9 -5
  133. package/dist/db/sql-identifier.d.ts +1 -0
  134. package/dist/db/sql-identifier.js +3 -0
  135. package/dist/db/system-tenant-read-db.d.ts +5 -0
  136. package/dist/db/system-tenant-read-db.js +28 -0
  137. package/dist/db/table-builder.d.ts +3 -1
  138. package/dist/db/table-builder.js +18 -8
  139. package/dist/db/table-info.d.ts +1 -2
  140. package/dist/db/table-introspection.d.ts +3 -0
  141. package/dist/db/table-introspection.js +6 -0
  142. package/dist/db/table-push.d.ts +1 -0
  143. package/dist/db/table-push.js +7 -1
  144. package/dist/db/tenant-db-runner.d.ts +3 -0
  145. package/dist/db/tenant-db-runner.js +19 -1
  146. package/dist/db/transaction-serialization.d.ts +1 -0
  147. package/dist/db/transaction-serialization.js +20 -3
  148. package/dist/db/where-clause.js +11 -2
  149. package/dist/db/write-ownership-failures.d.ts +25 -0
  150. package/dist/db/write-ownership-failures.js +82 -0
  151. package/dist/engine/boot-validator/boot-check.js +7 -1
  152. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  153. package/dist/engine/boot-validator/boot-phases.js +3 -2
  154. package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
  155. package/dist/engine/boot-validator/boot-rules.js +4 -0
  156. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  157. package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
  158. package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
  159. package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
  160. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  161. package/dist/engine/boot-validator/config-deps.js +0 -28
  162. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  163. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  164. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  165. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  166. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  167. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  168. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  169. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  170. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  171. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  172. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  173. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  174. package/dist/engine/boot-validator/entity-list-screens.js +35 -13
  175. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  176. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  177. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  178. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  179. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  180. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  181. package/dist/engine/boot-validator/list-row-guidance.js +143 -0
  182. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  183. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  184. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  185. package/dist/engine/boot-validator/list-sort-summary.js +160 -0
  186. package/dist/engine/boot-validator/list-table-options.js +15 -1
  187. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  188. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  189. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  190. package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
  191. package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
  192. package/dist/engine/boot-validator/named-filter-rules.js +42 -2
  193. package/dist/engine/boot-validator/ownership.js +10 -1
  194. package/dist/engine/boot-validator/parent-ref.js +87 -50
  195. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  196. package/dist/engine/boot-validator/projection-list-screens.js +32 -1
  197. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  198. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  199. package/dist/engine/boot-validator/query-output-guidance.js +40 -0
  200. package/dist/engine/boot-validator/query-refs.js +34 -1
  201. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  202. package/dist/engine/boot-validator/row-decoration.js +16 -0
  203. package/dist/engine/boot-validator/screens-actions.js +1 -1
  204. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  205. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  206. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  207. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  208. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  209. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  210. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  211. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  212. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  213. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  214. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  215. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  216. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  217. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  218. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  219. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  220. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  221. package/dist/engine/boot-validator/screens-lists.js +19 -3
  222. package/dist/engine/boot-validator/screens.js +1 -1
  223. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  224. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  225. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  226. package/dist/engine/boot-validator/zod-shape.js +19 -1
  227. package/dist/engine/build-app-schema.js +4 -0
  228. package/dist/engine/config-helpers.d.ts +1 -2
  229. package/dist/engine/config-helpers.js +6 -7
  230. package/dist/engine/define-feature.js +1 -0
  231. package/dist/engine/define-handler.d.ts +1 -0
  232. package/dist/engine/define-handler.js +4 -2
  233. package/dist/engine/definition-violations.js +2 -2
  234. package/dist/engine/entity-handlers.js +3 -8
  235. package/dist/engine/entity-list-runtime-options.js +9 -8
  236. package/dist/engine/factories.d.ts +2 -0
  237. package/dist/engine/feature-config-events-jobs.js +1 -0
  238. package/dist/engine/feature-entity-handlers.js +5 -2
  239. package/dist/engine/field-access.d.ts +1 -1
  240. package/dist/engine/field-access.js +7 -10
  241. package/dist/engine/find-entity.js +3 -3
  242. package/dist/engine/form-derivations.js +3 -3
  243. package/dist/engine/index.d.ts +3 -3
  244. package/dist/engine/index.js +2 -2
  245. package/dist/engine/named-filter-roles.d.ts +3 -0
  246. package/dist/engine/named-filter-roles.js +15 -0
  247. package/dist/engine/pipeline.js +0 -1
  248. package/dist/engine/project-app-schema-for-roles.js +17 -2
  249. package/dist/engine/qualified-name.js +0 -1
  250. package/dist/engine/registry-facade.js +1 -2
  251. package/dist/engine/registry-state.d.ts +1 -1
  252. package/dist/engine/registry-state.js +5 -2
  253. package/dist/engine/registry-validate.js +2 -1
  254. package/dist/engine/resolve-named-list-filters.js +5 -2
  255. package/dist/engine/schema-builder.js +9 -11
  256. package/dist/engine/screen-helpers.d.ts +12 -0
  257. package/dist/engine/screen-helpers.js +17 -1
  258. package/dist/engine/soft-delete-cleanup.js +3 -5
  259. package/dist/engine/state-machine.js +0 -1
  260. package/dist/engine/steps/_database-clock.d.ts +2 -0
  261. package/dist/engine/steps/_database-clock.js +6 -0
  262. package/dist/engine/steps/compute.js +1 -1
  263. package/dist/engine/steps/retry.js +5 -1
  264. package/dist/engine/steps/return.js +0 -1
  265. package/dist/engine/steps/wait-for-event.js +2 -1
  266. package/dist/engine/steps/wait.js +2 -1
  267. package/dist/engine/system-user.d.ts +2 -2
  268. package/dist/engine/system-user.js +2 -2
  269. package/dist/engine/types/handlers.d.ts +1 -1
  270. package/dist/engine/types/handlers.js +1 -1
  271. package/dist/engine/types/screen.d.ts +1 -1
  272. package/dist/engine/types/screen.js +1 -1
  273. package/dist/engine/webhook-contracts.d.ts +2 -3
  274. package/dist/engine/webhook-contracts.js +2 -25
  275. package/dist/engine/webhook-events.js +48 -29
  276. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  277. package/dist/engine/webhook-payload-strictness.js +53 -0
  278. package/dist/env/_zod-introspect.d.ts +1 -0
  279. package/dist/env/dry-run.d.ts +1 -1
  280. package/dist/env/dry-run.js +1 -1
  281. package/dist/env/field-meta.d.ts +4 -0
  282. package/dist/env/field-meta.js +67 -0
  283. package/dist/env/field-rules.d.ts +9 -0
  284. package/dist/env/field-rules.js +46 -0
  285. package/dist/env/index.d.ts +3 -3
  286. package/dist/env/index.js +16 -71
  287. package/dist/env/internals.d.ts +3 -0
  288. package/dist/env/internals.js +1 -2
  289. package/dist/env/required-env.d.ts +3 -1
  290. package/dist/env/required-env.js +5 -2
  291. package/dist/errors/reasons.d.ts +1 -0
  292. package/dist/errors/reasons.js +4 -0
  293. package/dist/errors/serialize.js +2 -2
  294. package/dist/errors/write-error-info.js +0 -2
  295. package/dist/es-ops/operations-schema.js +18 -7
  296. package/dist/event-store/admin-api.js +3 -3
  297. package/dist/event-store/event-store.js +0 -3
  298. package/dist/event-store/index.d.ts +1 -0
  299. package/dist/event-store/index.js +1 -0
  300. package/dist/event-store/transfer.js +1 -1
  301. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  302. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  303. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  304. package/dist/files/bind-pending-file-refs.js +54 -27
  305. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  306. package/dist/files/create-file-ref.d.ts +4 -1
  307. package/dist/files/create-file-ref.js +14 -3
  308. package/dist/files/default-file-guard.js +4 -1
  309. package/dist/files/file-claim.d.ts +6 -0
  310. package/dist/files/file-claim.js +17 -0
  311. package/dist/files/file-field-slots.d.ts +2 -0
  312. package/dist/files/file-field-slots.js +28 -0
  313. package/dist/files/file-ref-entity.d.ts +3 -0
  314. package/dist/files/file-ref-entity.js +2 -0
  315. package/dist/files/file-ref-table.d.ts +3 -0
  316. package/dist/files/file-routes.d.ts +4 -1
  317. package/dist/files/file-routes.js +80 -16
  318. package/dist/files/in-memory-provider.d.ts +1 -1
  319. package/dist/files/in-memory-provider.js +2 -1
  320. package/dist/files/index.d.ts +1 -1
  321. package/dist/files/index.js +1 -1
  322. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  323. package/dist/files/invalid-file-ref-error.js +15 -0
  324. package/dist/files/local-provider.js +9 -2
  325. package/dist/files/provider-resolver.js +1 -1
  326. package/dist/files/rebind-file-ref.d.ts +3 -2
  327. package/dist/files/rebind-file-ref.js +24 -18
  328. package/dist/files/resolve-file-handles.d.ts +13 -0
  329. package/dist/files/resolve-file-handles.js +57 -0
  330. package/dist/files/storage-tracking.d.ts +1 -1
  331. package/dist/files/storage-tracking.js +5 -2
  332. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  333. package/dist/files/types.d.ts +4 -0
  334. package/dist/files/types.js +10 -0
  335. package/dist/files/upload-field-resolution.d.ts +1 -0
  336. package/dist/files/upload-field-resolution.js +16 -2
  337. package/dist/files/upload-ledger.js +1 -1
  338. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  339. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  340. package/dist/i18n/required-surface-keys.js +21 -5
  341. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  342. package/dist/internal/boot-rule-table-expectations.js +29 -0
  343. package/dist/internal/row-level-security.d.ts +1 -0
  344. package/dist/internal/row-level-security.js +1 -0
  345. package/dist/internal/testing.d.ts +1 -0
  346. package/dist/internal/testing.js +1 -0
  347. package/dist/jobs/index.d.ts +1 -0
  348. package/dist/jobs/index.js +1 -0
  349. package/dist/jobs/job-load-events.d.ts +10 -0
  350. package/dist/jobs/job-load-events.js +12 -0
  351. package/dist/jobs/job-runner-context.js +6 -158
  352. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  353. package/dist/jobs/job-runner-dispatch.js +57 -0
  354. package/dist/jobs/job-runner-event-triggers.js +18 -9
  355. package/dist/jobs/job-runner-execution.js +5 -2
  356. package/dist/jobs/job-runner-facets.d.ts +48 -0
  357. package/dist/jobs/job-runner-facets.js +156 -0
  358. package/dist/jobs/job-runner-gates.js +19 -11
  359. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  360. package/dist/jobs/job-runner-helpers.js +18 -3
  361. package/dist/jobs/job-runner-scope.d.ts +1 -0
  362. package/dist/jobs/job-runner-scope.js +2 -0
  363. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  364. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  365. package/dist/jobs/job-runner-types.d.ts +1 -0
  366. package/dist/jobs/job-runner.js +39 -70
  367. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  368. package/dist/jobs/obliterate-job-queues.js +23 -0
  369. package/dist/lifecycle/lifecycle.js +1 -1
  370. package/dist/migrations/event-header-scrub.d.ts +11 -0
  371. package/dist/migrations/event-header-scrub.js +33 -0
  372. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  373. package/dist/migrations/event-payload-scrub.js +36 -4
  374. package/dist/migrations/index.d.ts +1 -0
  375. package/dist/migrations/index.js +2 -0
  376. package/dist/migrations/kumiko-drift.d.ts +5 -2
  377. package/dist/migrations/kumiko-drift.js +51 -14
  378. package/dist/migrations/pending-rebuilds.js +4 -5
  379. package/dist/observability/sensitive-filter.js +0 -12
  380. package/dist/pipeline/aggregate-type-removal.js +17 -4
  381. package/dist/pipeline/context-services.d.ts +2 -0
  382. package/dist/pipeline/context-services.js +5 -2
  383. package/dist/pipeline/dispatch-batch.js +4 -3
  384. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  385. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  386. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  387. package/dist/pipeline/dispatch-nested-write.js +119 -0
  388. package/dist/pipeline/dispatch-query.js +10 -3
  389. package/dist/pipeline/dispatch-scope.js +4 -3
  390. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  391. package/dist/pipeline/dispatch-shared.js +6 -38
  392. package/dist/pipeline/dispatch-write.d.ts +0 -1
  393. package/dist/pipeline/dispatch-write.js +3 -302
  394. package/dist/pipeline/dispatcher-utils.js +6 -0
  395. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  396. package/dist/pipeline/effective-system-scope.js +22 -0
  397. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  398. package/dist/pipeline/event-dispatcher-delivery.js +20 -9
  399. package/dist/pipeline/event-dispatcher.d.ts +6 -1
  400. package/dist/pipeline/event-dispatcher.js +6 -7
  401. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  402. package/dist/pipeline/handler-context-auth.js +3 -4
  403. package/dist/pipeline/handler-context-db.js +11 -4
  404. package/dist/pipeline/handler-context-dispatch.js +2 -2
  405. package/dist/pipeline/handler-context-events.d.ts +8 -3
  406. package/dist/pipeline/handler-context-events.js +20 -65
  407. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  408. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  409. package/dist/pipeline/handler-context-notify.js +2 -0
  410. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  411. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  412. package/dist/pipeline/handler-context-projection.js +39 -0
  413. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  414. package/dist/pipeline/handler-context-scope.js +14 -2
  415. package/dist/pipeline/index.d.ts +1 -1
  416. package/dist/pipeline/index.js +1 -1
  417. package/dist/pipeline/irreversible-operation-gate.js +36 -10
  418. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  419. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  420. package/dist/pipeline/member-reader.js +4 -2
  421. package/dist/pipeline/msp-rebuild.js +1 -1
  422. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  423. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  424. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  425. package/dist/pipeline/projection-rebuild.js +16 -7
  426. package/dist/pipeline/projection-state.js +4 -6
  427. package/dist/pipeline/system-hooks.js +36 -6
  428. package/dist/pipeline/write-result-masking.js +31 -3
  429. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  430. package/dist/pipeline/write-transition-guard.js +95 -0
  431. package/dist/schema-cli/shared.d.ts +2 -0
  432. package/dist/schema-cli/shared.js +4 -2
  433. package/dist/schema-cli/validate-command.js +43 -28
  434. package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
  435. package/dist/search/meilisearch-adapter-internals.js +5 -0
  436. package/dist/search/meilisearch-adapter.d.ts +1 -0
  437. package/dist/search/meilisearch-adapter.js +17 -11
  438. package/dist/search/reindex-entity.d.ts +2 -0
  439. package/dist/search/reindex-entity.js +32 -4
  440. package/dist/search/reindex-tenants-search.js +20 -4
  441. package/dist/time/tz-context.js +1 -1
  442. package/dist/ui-types/card-column-roles.d.ts +6 -0
  443. package/dist/ui-types/card-column-roles.js +21 -3
  444. package/dist/ui-types/index.d.ts +3 -3
  445. package/dist/ui-types/index.js +2 -2
  446. package/dist/utils/ids.js +0 -1
  447. package/dist/utils/index.d.ts +1 -0
  448. package/dist/utils/index.js +1 -0
  449. package/dist/utils/return-path-limit.d.ts +1 -0
  450. package/dist/utils/return-path-limit.js +1 -0
  451. package/package.json +5 -3
  452. package/presets/biome-app.json +39 -21
  453. package/presets/biome-plugins/admin-api.grit +10 -0
  454. package/presets/biome-plugins/error-reasons.grit +53 -0
  455. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  456. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  457. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  458. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  459. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  460. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  461. package/presets/biome-plugins/no-date-api.grit +11 -0
  462. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  463. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  464. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  465. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  466. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  467. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  468. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  469. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  470. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  471. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  472. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  473. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  474. package/presets/biome-plugins/test-title.grit +20 -0
  475. package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
  476. package/presets/biome-rules.json +467 -0
  477. package/src/changes.json +366 -0
  478. package/dist/engine/minor-units.d.ts +0 -2
  479. package/dist/engine/minor-units.js +0 -8
@@ -1,6 +1,6 @@
1
1
  import { InternalError } from "../errors/index.js";
2
2
  import { applyRowLevelSecurityScope, buildRowLevelSecurityScopeQuery, } from "./queries/rls-scope.js";
3
- import { activeRowLevelSecurityScope, innerOfScopedRunner, rowLevelSecurityScopeKey, runInCapturedRowLevelSecurityScope, } from "./row-level-security-scope.js";
3
+ import { activeRowLevelSecurityScope, innerOfScopedRunner, isOutsideRowLevelSecurityScope, rowLevelSecurityScopeKey, runInCapturedRowLevelSecurityScope, } from "./row-level-security-scope.js";
4
4
  import { registerRunnerProxyTarget } from "./transaction-serialization.js";
5
5
  const enforcedHandles = new WeakSet();
6
6
  // Differs from every scope key, so the next statement always re-applies its scope.
@@ -58,8 +58,16 @@ function withCapturedCallback(args, wrap) {
58
58
  function alignedStatement(target, state, run) {
59
59
  const desired = activeRowLevelSecurityScope();
60
60
  return enqueue(state, async () => {
61
- await alignScope(target, state, desired);
62
- return run();
61
+ // The scope and the statement go out back to back; a failing set_config aborts the transaction,
62
+ // so the statement fails behind it.
63
+ const scoped = startAlignScope(target, state, desired);
64
+ const statement = startQuery(run);
65
+ const [scopeResult, statementResult] = await Promise.allSettled([scoped, statement]);
66
+ if (scopeResult.status === "rejected")
67
+ throw scopeResult.reason;
68
+ if (statementResult.status === "rejected")
69
+ throw statementResult.reason;
70
+ return statementResult.value;
63
71
  });
64
72
  }
65
73
  function transactionHandleProxy(handle, state) {
@@ -104,17 +112,20 @@ function transactionHandleProxy(handle, state) {
104
112
  registerRunnerProxyTarget(proxy, handle);
105
113
  return proxy;
106
114
  }
107
- async function alignScope(handle, state, desired) {
115
+ function startAlignScope(handle, state, desired) {
108
116
  const key = rowLevelSecurityScopeKey(desired);
109
117
  // skip: scope already applied on this connection
110
118
  if (key === state.applied)
111
- return;
119
+ return Promise.resolve();
112
120
  state.applied = UNKNOWN_SCOPE_KEY;
113
- await applyRowLevelSecurityScope(handle, desired);
114
- state.applied = key;
121
+ return startQuery(() => buildRowLevelSecurityScopeQuery(handle, desired)).then(() => {
122
+ state.applied = key;
123
+ });
115
124
  }
116
125
  function newTransactionState() {
117
- return { applied: rowLevelSecurityScopeKey(undefined), tail: Promise.resolve() };
126
+ // Not "none": a pooled connection may carry a session-level scope GUC set by raw SQL, so even a
127
+ // scope-free transaction has to reset both settings itself.
128
+ return { applied: UNKNOWN_SCOPE_KEY, tail: Promise.resolve() };
118
129
  }
119
130
  const templateOf = (strings) => strings;
120
131
  // Tagged-template statements pipeline behind each other; unsafe() without parameters is sent as a
@@ -171,13 +182,15 @@ async function pipelinedScopedTransaction(pool, scope, run) {
171
182
  callMethod(conn, "release", []);
172
183
  }
173
184
  }
174
- // A pool statement under a scope runs as its own short transaction; without a scope it passes
175
- // through and the policies see no tenant (fail closed), so DDL like CONCURRENTLY keeps working.
185
+ // Every pool statement runs as its own short transaction that sets both scope settings, to '' when
186
+ // no scope is active: a pooled connection may carry a session-level scope set by raw SQL, which a
187
+ // pass-through would let every scope-free statement inherit. Only outsideRowLevelSecurityScope
188
+ // (CONCURRENTLY and other non-transactional DDL) sends a statement straight to the connection.
176
189
  export function enforceRowLevelSecurity(pool) {
177
190
  const inScopedTransaction = (run) => pipelinedScopedTransaction(pool, activeRowLevelSecurityScope(), run);
178
191
  const proxy = new Proxy(pool, {
179
192
  apply(target, _thisArg, args) {
180
- if (!isTaggedTemplateCall(args) || activeRowLevelSecurityScope() === undefined) {
193
+ if (!isTaggedTemplateCall(args) || isOutsideRowLevelSecurityScope()) {
181
194
  return applyOnTarget(target, args);
182
195
  }
183
196
  return inScopedTransaction((conn) => applyOnTarget(conn, args));
@@ -188,7 +201,7 @@ export function enforceRowLevelSecurity(pool) {
188
201
  return value;
189
202
  if (prop === "unsafe" || prop === "file") {
190
203
  return (...args) => {
191
- if (activeRowLevelSecurityScope() === undefined)
204
+ if (isOutsideRowLevelSecurityScope())
192
205
  return callMethod(target, prop, args);
193
206
  if (prop === "file") {
194
207
  // Bun sends file() only after its async file read, i.e. after the pipelined COMMIT.
@@ -7,13 +7,14 @@ export type RowLevelSecurityScope = {
7
7
  readonly kind: "system";
8
8
  readonly reason: string;
9
9
  };
10
- export declare const SYSTEM_ROW_LEVEL_SECURITY_SCOPE: RowLevelSecurityScope;
10
+ export declare function systemRowLevelSecurityScope(reason: string): RowLevelSecurityScope;
11
11
  export declare function tenantRowLevelSecurityScope(tenantId: TenantId): RowLevelSecurityScope;
12
12
  export declare function activeRowLevelSecurityScope(): RowLevelSecurityScope | undefined;
13
13
  export declare function runInRowLevelSecurityScope<T>(scope: RowLevelSecurityScope, fn: () => T): T;
14
14
  export declare function runInSystemRowLevelSecurityScope<T>(reason: string, fn: () => T): T;
15
15
  export declare function runInCapturedRowLevelSecurityScope<T>(captured: RowLevelSecurityScope | undefined, fn: () => T): T;
16
16
  export declare function outsideRowLevelSecurityScope<T>(fn: () => T): T;
17
+ export declare function isOutsideRowLevelSecurityScope(): boolean;
17
18
  export declare function rowLevelSecurityScopeKey(scope: RowLevelSecurityScope | undefined): string;
18
19
  export type TenantDbModeOptions = {
19
20
  readonly mode: "tenant";
@@ -2,7 +2,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
2
2
  import { InternalError } from "../errors/index.js";
3
3
  import { asEntityTableMeta } from "./table-introspection.js";
4
4
  import { registerRunnerProxyTarget } from "./transaction-serialization.js";
5
- function systemRowLevelSecurityScope(reason) {
5
+ export function systemRowLevelSecurityScope(reason) {
6
6
  if (reason.trim() === "") {
7
7
  throw new InternalError({
8
8
  message: "A system row-level-security scope requires a non-empty reason.",
@@ -10,7 +10,6 @@ function systemRowLevelSecurityScope(reason) {
10
10
  }
11
11
  return { kind: "system", reason };
12
12
  }
13
- export const SYSTEM_ROW_LEVEL_SECURITY_SCOPE = systemRowLevelSecurityScope("framework-internal cross-tenant access");
14
13
  function describeRowLevelSecurityScope(scope) {
15
14
  return scope.kind === "system"
16
15
  ? `system (reason: ${scope.reason})`
@@ -33,9 +32,14 @@ export function runInSystemRowLevelSecurityScope(reason, fn) {
33
32
  export function runInCapturedRowLevelSecurityScope(captured, fn) {
34
33
  return captured === undefined ? storage.exit(fn) : storage.run(captured, fn);
35
34
  }
36
- // DDL such as CREATE INDEX CONCURRENTLY cannot run in the per-statement transaction an enforced pool opens under a scope.
35
+ const outsideScopeStorage = new AsyncLocalStorage();
36
+ // Use for non-transactional DDL (CREATE INDEX CONCURRENTLY) and session-level statements on an RLS-enforced
37
+ // pool: it opens a per-statement transaction for every statement, and only this opt-out bypasses it.
37
38
  export function outsideRowLevelSecurityScope(fn) {
38
- return storage.exit(fn);
39
+ return storage.exit(() => outsideScopeStorage.run(true, fn));
40
+ }
41
+ export function isOutsideRowLevelSecurityScope() {
42
+ return outsideScopeStorage.getStore() === true;
39
43
  }
40
44
  export function rowLevelSecurityScopeKey(scope) {
41
45
  if (scope === undefined)
@@ -52,7 +56,7 @@ export function tenantDbRowLevelSecurityScope(options, tenantId, table) {
52
56
  if (options.mode === "system")
53
57
  return systemRowLevelSecurityScope(options.reason);
54
58
  if (asEntityTableMeta(table)?.tenancy === "global")
55
- return SYSTEM_ROW_LEVEL_SECURITY_SCOPE;
59
+ return systemRowLevelSecurityScope("global-tenancy table access");
56
60
  return tenantRowLevelSecurityScope(tenantId);
57
61
  }
58
62
  // A server or loop that inherits an ambient scope would run every later request fail-open.
@@ -1 +1,2 @@
1
1
  export declare function quoteIdent(name: string): string;
2
+ export declare function quoteLiteral(value: string): string;
@@ -1,3 +1,6 @@
1
1
  export function quoteIdent(name) {
2
2
  return `"${name.replace(/"/g, '""')}"`;
3
3
  }
4
+ export function quoteLiteral(value) {
5
+ return `'${value.replace(/'/g, "''")}'`;
6
+ }
@@ -0,0 +1,5 @@
1
+ import type { TenantDb } from "@cosmicdrift/kumiko-types/tenant-db-types";
2
+ import type { DbRunner } from "./connection.ts";
3
+ export declare function systemTenantReadDb(db: TenantDb | DbRunner): TenantDb;
4
+ export declare function systemTenantReadRunner(db: TenantDb | DbRunner): DbRunner;
5
+ export declare function systemTenantWriteRunner(db: TenantDb | DbRunner, reason: string): DbRunner;
@@ -0,0 +1,28 @@
1
+ import { assertReason } from "../engine/escape-hatch-reason.js";
2
+ import { SYSTEM_TENANT_ID } from "../engine/types/identifiers.js";
3
+ import { createTenantDb } from "./tenant-db.js";
4
+ import { isBoundTenantDb, tenantDbRunner } from "./tenant-db-runner.js";
5
+ // Tenant mode on the system tenant: RLS isolation passes exactly the system tenant's rows, never
6
+ // another tenant's, which a `kumiko.scope = 'system'` bypass would also expose.
7
+ export function systemTenantReadDb(db) {
8
+ return createTenantDb({
9
+ db: isBoundTenantDb(db) ? tenantDbRunner(db) : db,
10
+ tenantId: SYSTEM_TENANT_ID,
11
+ mode: "tenant",
12
+ grants: { writesDeniedReason: "on a handle that reads the system tenant's rows only" },
13
+ });
14
+ }
15
+ // Raw runner for event-store reads that take a DbRunner (event streaming, archive checks).
16
+ export function systemTenantReadRunner(db) {
17
+ return tenantDbRunner(systemTenantReadDb(db));
18
+ }
19
+ // Raw runner for event-store writes that take a DbRunner (stream archival, note erasure); RLS
20
+ // isolation limits its writes to system-tenant rows.
21
+ export function systemTenantWriteRunner(db, reason) {
22
+ assertReason("systemTenantWriteRunner", reason);
23
+ return tenantDbRunner(createTenantDb({
24
+ db: isBoundTenantDb(db) ? tenantDbRunner(db) : db,
25
+ tenantId: SYSTEM_TENANT_ID,
26
+ mode: "tenant",
27
+ }));
28
+ }
@@ -7,7 +7,7 @@ import type { MoneyRead } from "./money.ts";
7
7
  export { toSnakeCase } from "../utils/case.ts";
8
8
  import { type ColumnBuilder, type ColumnHandle, type SchemaTable, type TableColumns } from "./dialect.ts";
9
9
  export { SOFT_DELETE_LIVE_ROW_PREDICATE } from "./entity-table-indexes.ts";
10
- export declare function physicalColumnName(table: unknown, field: string): string;
10
+ export declare function physicalColumnName(table: SchemaTable, field: string): string;
11
11
  export type AnyPgColumn = ColumnHandle;
12
12
  export declare const READ_MODEL_PREFIX = "read_";
13
13
  export declare function toTableName(entityName: string): string;
@@ -227,4 +227,6 @@ export type BuildEntityTableOptions = {
227
227
  * Throws if the table has a `tenant_id` column or no EntityTableMeta to stamp.
228
228
  */
229
229
  export declare function declareGlobalTenancy<T extends SchemaTable>(table: T): T & TenancyBrand<"global">;
230
+ /** Stamps `systemRowsReadable` onto an entity table's meta in place (no-op if already set). */
231
+ export declare function declareSystemRowsReadable(table: object): void;
230
232
  export declare function buildEntityTable<E extends EntityDefinition>(entityName: string, entity: E, options?: BuildEntityTableOptions): EntityTable<E>;
@@ -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) {