@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
@@ -8,7 +8,7 @@ import { scrubLogValue } from "../logging/scrub.js";
8
8
  import { wrapToKumiko } from "../pipeline/dispatcher-utils.js";
9
9
  import { isPlainObject } from "../utils/is-plain-object.js";
10
10
  import { stringifyJson } from "../utils/safe-json.js";
11
- import { Routes } from "./api-constants.js";
11
+ import { APP_NOW_HEADER_NAME, Routes } from "./api-constants.js";
12
12
  import { getAuthTokenExpiry, getUser } from "./auth-middleware.js";
13
13
  import { patAllows } from "./pat-scope.js";
14
14
  import { requestContext } from "./request-context.js";
@@ -28,6 +28,14 @@ const CLIENT_CLOSED_REQUEST_STATUS = 499;
28
28
  export function createApiRoutes(dispatcher, options = {}) {
29
29
  const heartbeatMs = options.sseHeartbeatMs ?? SSE_HEARTBEAT_INTERVAL_MS;
30
30
  const api = new Hono();
31
+ // Stamped after the handler ran, so the client's skew estimate is not behind by the handler's
32
+ // runtime. Whole milliseconds in ISO form: Temporal's toString() can run to nanoseconds, which
33
+ // Date.parse on Hermes/JSC does not define.
34
+ api.use("*", async (c, next) => {
35
+ await next();
36
+ const nowMs = options.clock?.now().epochMilliseconds ?? Date.now();
37
+ c.header(APP_NOW_HEADER_NAME, new Date(nowMs).toISOString());
38
+ });
31
39
  api.post(Routes.write, async (c) => {
32
40
  const user = getUser(c);
33
41
  const body = await readDispatchBody(c);
@@ -153,6 +153,9 @@ function buildMultiStreamProjectionConsumer(msp, deps) {
153
153
  // Carry the MSP's declared cursor-seed through to the consumer. Default
154
154
  // (beginning) is applied inside insertConsumerIfAbsent.
155
155
  ...(msp.startFrom && { startFrom: msp.startFrom }),
156
+ ...(msp.irreversibleWithoutEntryHandler && {
157
+ irreversibleWithoutEntryHandler: msp.irreversibleWithoutEntryHandler,
158
+ }),
156
159
  handler: async (event, ctx) => {
157
160
  const applyFn = msp.apply[event.type];
158
161
  // skip: this MSP doesn't care about this event type — fast path,
@@ -7,7 +7,8 @@ import { getUser } from "./auth-middleware.js";
7
7
  import { clientIpSourceFromHonoContext } from "./client-ip.js";
8
8
  import { ExtraRouteEntries, ExtraRouteRejection, } from "./extra-route.js";
9
9
  import { bodyLimitForRoutePath, DEFAULT_MAX_REQUEST_BYTES } from "./route-registrars.js";
10
- import { isMissingOrAnonymousUser, makeSystemQuery, mountHonoRoute, unauthenticatedResponse, } from "./server-routes.js";
10
+ import { makeSystemQuery, mountHonoRoute } from "./server-feature-http-routes.js";
11
+ import { isMissingOrAnonymousUser, unauthenticatedResponse } from "./server-routes.js";
11
12
  import { tenantScopedSecrets } from "./tenant-scoped-secrets.js";
12
13
  // Only entry:"signature" bypasses jwtGuard (verify() authenticates
13
14
  // itself); entry:"anonymous" still needs the anonymousAccess fallthrough
@@ -0,0 +1,9 @@
1
+ import type { HttpRouteMethod } from "@cosmicdrift/kumiko-types/http-route";
2
+ import type { Hono, MiddlewareHandler } from "hono";
3
+ import type { TenantId } from "../engine/types/index.ts";
4
+ import type { Dispatcher } from "../pipeline/dispatcher.ts";
5
+ import { type ClientIpResolver } from "./client-ip.ts";
6
+ import type { ServerWiring } from "./server-wiring.ts";
7
+ export declare function mountFeatureHttpRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "dispatcher" | "clientIpResolver" | "rateLimitResolver" | "observability">, sessionOnlyHttpRouteGuards: readonly MiddlewareHandler[]): void;
8
+ export declare function mountHonoRoute(app: Hono, method: HttpRouteMethod, path: string, handler: (c: import("hono").Context<any, any>) => Response | Promise<Response>, middlewares?: readonly MiddlewareHandler[]): void;
9
+ export declare function makeSystemQuery(c: import("hono").Context<any, any>, dispatcher: Dispatcher, clientIpResolver?: ClientIpResolver): (type: string, payload: unknown, tenantId: TenantId) => Promise<unknown>;
@@ -0,0 +1,109 @@
1
+ import { createAnonymousUser } from "../engine/system-user.js";
2
+ import { httpRouteRateLimit } from "../rate-limit/index.js";
3
+ import { assertUnreachable } from "../utils/index.js";
4
+ import { clientIpSourceFromHonoContext } from "./client-ip.js";
5
+ import { requestContext } from "./request-context.js";
6
+ import { buildRequestContextData } from "./request-id-middleware.js";
7
+ export function mountFeatureHttpRoutes(app, wiring, sessionOnlyHttpRouteGuards) {
8
+ // Feature-declared HTTP routes (r.httpRoute). Mount after /api/* so /api/* always
9
+ // takes precedence; feature routes must be outside that prefix (the boot validator
10
+ // enforces this). deps.app is the outer app, so the handler can call /api/query
11
+ // internally through app.fetch(...) and use the same auth path as a real HTTP call.
12
+ // deps.systemQuery deliberately bypasses that path for routes that must enforce a
13
+ // FIXED tenant (for example, legal-pages always uses SYSTEM_TENANT_ID), rather than
14
+ // spoofing it through the X-Tenant header. That header looks like a normal client
15
+ // header to anonymousAccess resolution, so resolverTrust: "authoritative" configs
16
+ // correctly reject it as a tenant override.
17
+ for (const feature of wiring.options.registry.features.values()) {
18
+ for (const route of Object.values(feature.httpRoutes)) {
19
+ mountFeatureHttpRoute(app, route, wiring, sessionOnlyHttpRouteGuards);
20
+ }
21
+ }
22
+ }
23
+ function mountFeatureHttpRoute(app, route, wiring, sessionOnlyHttpRouteGuards) {
24
+ const { dispatcher, clientIpResolver, rateLimitResolver, observability } = wiring;
25
+ const honoHandler = async (c) => route.handler(c, {
26
+ app,
27
+ // createAnonymousUser, NOT createSystemUser: systemQuery's
28
+ // synthesized user must clear the SAME access gate a real
29
+ // anonymous visitor would, no more — regardless of the route's
30
+ // own `anonymous` mode. The system role would ALSO satisfy that
31
+ // gate here, but it can read fields gated to "system" that
32
+ // "anonymous" can't (filterReadFields is a plain role-in-map
33
+ // check) — a systemQuery caller reading a system-gated field
34
+ // would leak it into the response. The forced tenant already
35
+ // comes from bypassing the HTTP layer entirely; no elevated
36
+ // role is needed or wanted on top of that.
37
+ systemQuery: makeSystemQuery(c, dispatcher, clientIpResolver),
38
+ clientIp: clientIpResolver.resolve(clientIpSourceFromHonoContext(c)),
39
+ });
40
+ // Without a resolver (no Redis in the context — dev/test stacks) the
41
+ // declared limit is skipped rather than failing the boot of every app
42
+ // that mounts a bundled feature whose routes carry a default limit.
43
+ const routeLimit = route.rateLimit && rateLimitResolver
44
+ ? [
45
+ httpRouteRateLimit({
46
+ resolver: rateLimitResolver,
47
+ rateLimit: route.rateLimit,
48
+ routeKey: `${route.method} ${route.path}`,
49
+ clientIpResolver,
50
+ meter: observability.meter,
51
+ }),
52
+ ]
53
+ : [];
54
+ mountHonoRoute(app, route.method, route.path, honoHandler, [
55
+ ...routeLimit,
56
+ ...(route.anonymous ? [] : sessionOnlyHttpRouteGuards),
57
+ ]);
58
+ }
59
+ // Method-switch shared by r.httpRoute and extraRoutes — one place to keep
60
+ // the two mounting paths from drifting on which Hono methods get a
61
+ // convenience-call vs. app.on().
62
+ export function mountHonoRoute(app, method, path,
63
+ // biome-ignore lint/suspicious/noExplicitAny: Hono context generics are invisible at the framework boundary
64
+ handler, middlewares = []) {
65
+ // Guards go into the route's own handler chain, never a method-gated
66
+ // app.use: Hono serves HEAD through the GET route with c.req.method still
67
+ // "HEAD", so a `method === c.req.method` gate would skip them for HEAD.
68
+ if (middlewares.length > 0) {
69
+ // [path]: only Hono's array-path overload accepts a variable-length handler spread.
70
+ app.on(method, [path], ...middlewares, handler);
71
+ // skip: guarded route already mounted with its guard chain
72
+ return;
73
+ }
74
+ switch (method) {
75
+ case "GET":
76
+ app.get(path, handler);
77
+ break;
78
+ case "POST":
79
+ app.post(path, handler);
80
+ break;
81
+ case "PUT":
82
+ app.put(path, handler);
83
+ break;
84
+ case "PATCH":
85
+ app.patch(path, handler);
86
+ break;
87
+ case "DELETE":
88
+ app.delete(path, handler);
89
+ break;
90
+ case "OPTIONS":
91
+ case "HEAD":
92
+ // Hono's on() for the methods without a convenience method.
93
+ app.on(method, path, handler);
94
+ break;
95
+ default:
96
+ assertUnreachable(method, "http method");
97
+ }
98
+ }
99
+ // Shared systemQuery builder for r.httpRoute and extraRoutes (anonymous +
100
+ // signature entries). requestContext.run must wrap the dispatcher call —
101
+ // both route kinds run outside the requestIdMiddleware chain that normally
102
+ // populates it, and `rateLimit: {per: "ip", ...}` on a handler invoked
103
+ // through systemQuery is otherwise silent dead-code (enforceRateLimit reads
104
+ // requestContext.get()?.ip, undefined without this wrap).
105
+ export function makeSystemQuery(
106
+ // biome-ignore lint/suspicious/noExplicitAny: Hono context generics are invisible at the framework boundary
107
+ c, dispatcher, clientIpResolver) {
108
+ return (type, payload, tenantId) => requestContext.run(requestContext.get() ?? buildRequestContextData(c, clientIpResolver), () => dispatcher.query(type, payload, createAnonymousUser(tenantId)));
109
+ }
@@ -1,15 +1,15 @@
1
1
  import { runInSystemRowLevelSecurityScope } from "../db/row-level-security-scope.js";
2
2
  import { resolveTenantLifecyclePlugin } from "../pipeline/active-membership.js";
3
3
  import { authEndpointRateLimit, globalIpRateLimit } from "../rate-limit/index.js";
4
- import { authMiddleware, getUser } from "./auth-middleware.js";
4
+ import { authMiddleware } from "./auth-middleware.js";
5
5
  import { assertSessionCallbacksPaired } from "./auth-routes.js";
6
6
  import { csrfMiddleware } from "./csrf-middleware.js";
7
7
  import { observabilityMiddleware } from "./observability-middleware.js";
8
8
  import { assertOriginGuardConfig, normalizeOrigin, resolveOriginGuard, } from "./origin-middleware.js";
9
- import { PAT_RATE_LIMITED_CODE } from "./pat-auth-reject.js";
10
9
  import { patRouteGuard } from "./pat-route-guard.js";
11
10
  import { piiCiphertextResponseGuard } from "./pii-leak-guard.js";
12
11
  import { requestIdMiddleware } from "./request-id-middleware.js";
12
+ import { buildPatRateLimitGuard } from "./server-pat-rate-limit-guard.js";
13
13
  import { resolveSessionCookies, sessionCookiesMiddleware, } from "./session-cookies.js";
14
14
  export function installSessionCookies(app, auth) {
15
15
  // Resolved once; auth routes, auth/csrf middleware and the tenant-cookie
@@ -183,23 +183,6 @@ function buildSessionOnlyGuard(options, jwt, tenantLifecycleResolver) {
183
183
  ...(tenantLifecycleResolver ? { resolveTenantLifecycleStatus: tenantLifecycleResolver } : {}),
184
184
  });
185
185
  }
186
- // Must run after the auth guard so getUser(c) carries the PAT.
187
- function buildPatRateLimitGuard(patRateLimiter) {
188
- return async (c, next) => {
189
- const pat = getUser(c)?.pat;
190
- if (pat && !(await patRateLimiter.check(pat.tokenId))) {
191
- return c.json({
192
- error: {
193
- code: PAT_RATE_LIMITED_CODE,
194
- httpStatus: 429,
195
- message: "personal access token rate limit exceeded",
196
- i18nKey: "auth.errors.patRateLimited",
197
- },
198
- }, 429);
199
- }
200
- return next();
201
- };
202
- }
203
186
  function deriveTenantLifecycleResolver(registry, db) {
204
187
  const plugin = resolveTenantLifecyclePlugin(registry, "buildServer");
205
188
  if (!plugin)
@@ -0,0 +1,3 @@
1
+ import type { MiddlewareHandler } from "hono";
2
+ import type { LoginRateLimiter } from "./auth-routes.ts";
3
+ export declare function buildPatRateLimitGuard(patRateLimiter: LoginRateLimiter): MiddlewareHandler;
@@ -0,0 +1,19 @@
1
+ import { getUser } from "./auth-middleware.js";
2
+ import { PAT_RATE_LIMITED_CODE } from "./pat-auth-reject.js";
3
+ // Must run after the auth guard so getUser(c) carries the PAT.
4
+ export function buildPatRateLimitGuard(patRateLimiter) {
5
+ return async (c, next) => {
6
+ const pat = getUser(c)?.pat;
7
+ if (pat && !(await patRateLimiter.check(pat.tokenId))) {
8
+ return c.json({
9
+ error: {
10
+ code: PAT_RATE_LIMITED_CODE,
11
+ httpStatus: 429,
12
+ message: "personal access token rate limit exceeded",
13
+ i18nKey: "auth.errors.patRateLimited",
14
+ },
15
+ }, 429);
16
+ }
17
+ return next();
18
+ };
19
+ }
@@ -0,0 +1,10 @@
1
+ import type { AppContext } from "../engine/types/index.ts";
2
+ import { createPayloadDigest } from "../rate-limit/index.ts";
3
+ import type { ServerOptions } from "./server.ts";
4
+ import type { BootLogger } from "./server-boot-checks.ts";
5
+ export type ServerRateLimit = {
6
+ readonly resolver: AppContext["rateLimit"];
7
+ readonly middlewareRequested: boolean;
8
+ readonly payloadDigest: ReturnType<typeof createPayloadDigest>;
9
+ };
10
+ export declare function resolveServerRateLimit(options: Pick<ServerOptions, "registry" | "context" | "rateLimit" | "jwtSecret">, tracedRedis: AppContext["redis"], bootLog: BootLogger): ServerRateLimit;
@@ -0,0 +1,37 @@
1
+ import { createPayloadDigest, createRateLimitResolver } from "../rate-limit/index.js";
2
+ import { assertNoPayloadRateLimitsWithoutResolver, warnUnlimitedSystemScopeFeatures, } from "./server-boot-checks.js";
3
+ export function resolveServerRateLimit(options, tracedRedis, bootLog) {
4
+ // Auto-wire the rate-limit resolver, but ONLY when at least one
5
+ // handler actually declared a rateLimit option. Apps that don't use
6
+ // L3 pay zero cost: no resolver instance, no Lua-script registration
7
+ // on Redis, no AppContext field. Apps that wire L1/L2 middleware can
8
+ // pass `context.rateLimit` explicitly — that takes precedence over
9
+ // the auto-wire (e.g. middleware-only setup without any L3 handler).
10
+ // Auto-build the resolver when L3 handlers declared rateLimit OR when
11
+ // the caller asked for L1/L2 middleware. Either path needs a resolver;
12
+ // both share the same instance to avoid duplicate Lua-script registration.
13
+ const wantsL3 = options.registry.hasRateLimitedHandler();
14
+ const wantsL1L2 = options.rateLimit?.global !== undefined || options.rateLimit?.auth !== undefined;
15
+ const wantsHttpRouteLimit = [...options.registry.features.values()].some((feature) => Object.values(feature.httpRoutes).some((route) => route.rateLimit !== undefined));
16
+ const wantsResolver = wantsL3 || wantsL1L2 || wantsHttpRouteLimit;
17
+ // Master for the payload-bucket HMAC: the current signing secret (the
18
+ // keyring's signKid for rotation setups). buildServer always has one, so
19
+ // the digest is available whenever a handler declares additionalRateLimits.
20
+ const payloadDigest = createPayloadDigest(payloadDigestMasterSecret(options.jwtSecret));
21
+ const rateLimitResolver = options.context.rateLimit ??
22
+ (tracedRedis && wantsResolver ? createRateLimitResolver({ redis: tracedRedis }) : undefined);
23
+ if (!rateLimitResolver) {
24
+ assertNoPayloadRateLimitsWithoutResolver(options.registry);
25
+ warnUnlimitedSystemScopeFeatures(options.registry, bootLog);
26
+ }
27
+ return { resolver: rateLimitResolver, middlewareRequested: wantsL1L2, payloadDigest };
28
+ }
29
+ function payloadDigestMasterSecret(jwtSecret) {
30
+ if (typeof jwtSecret === "string")
31
+ return jwtSecret;
32
+ const signingSecret = jwtSecret.keys[jwtSecret.signKid];
33
+ if (signingSecret === undefined) {
34
+ throw new Error(`[kumiko] jwtSecret.signKid "${jwtSecret.signKid}" not found in jwtSecret.keys`);
35
+ }
36
+ return signingSecret;
37
+ }
@@ -1,20 +1,12 @@
1
- import type { HttpRouteMethod } from "@cosmicdrift/kumiko-types/http-route";
2
- import type { Hono, MiddlewareHandler } from "hono";
3
- import type { SessionUser, TenantId } from "../engine/types/index.ts";
4
- import type { Dispatcher } from "../pipeline/dispatcher.ts";
5
- import { type ClientIpResolver } from "./client-ip.ts";
6
- import type { ServerOptions } from "./server.ts";
1
+ import type { Hono } from "hono";
2
+ import type { SessionUser } from "../engine/types/index.ts";
7
3
  import type { ServerWiring } from "./server-wiring.ts";
8
4
  import type { ResolvedSessionCookies } from "./session-cookies.ts";
9
5
  export declare function mountOperationalRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "baseDb" | "eventConsumers" | "observability" | "bootLog">): void;
10
6
  export declare function mountAuthRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "dispatcher" | "jwt" | "clientIpResolver">, sessionCookies: ResolvedSessionCookies): void;
11
7
  export declare function mountClientErrorRoute(app: Hono, wiring: Pick<ServerWiring, "rateLimitResolver" | "tracedRedis" | "clientIpResolver" | "observability" | "jwt">): void;
12
- export declare function mountDispatcherRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "dispatcher" | "sseBroker">): void;
13
- export declare function mountSchemaRoute(app: Hono, options: Pick<ServerOptions, "registry" | "dispatcherOptions" | "context">): void;
14
- export declare function mountFileRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "dispatcher" | "fileProviderResolver" | "rateLimitResolver" | "tracedRedis">): void;
15
- export declare function mountFeatureHttpRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "dispatcher" | "clientIpResolver" | "rateLimitResolver" | "observability">, sessionOnlyHttpRouteGuards: readonly MiddlewareHandler[]): void;
8
+ export declare function mountDispatcherRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "dispatcher" | "sseBroker" | "rateLimitResolver" | "tracedRedis">): void;
9
+ export declare function mountFileRoutes(app: Hono, wiring: Pick<ServerWiring, "options" | "dispatcher" | "fileProviderResolver" | "rateLimitResolver" | "tracedRedis" | "clientIpResolver">): void;
16
10
  export declare function installNoRouteMatchMarker(app: Hono): void;
17
- export declare function mountHonoRoute(app: Hono, method: HttpRouteMethod, path: string, handler: (c: import("hono").Context<any, any>) => Response | Promise<Response>, middlewares?: readonly MiddlewareHandler[]): void;
18
- export declare function makeSystemQuery(c: import("hono").Context<any, any>, dispatcher: Dispatcher, clientIpResolver?: ClientIpResolver): (type: string, payload: unknown, tenantId: TenantId) => Promise<unknown>;
19
11
  export declare function isMissingOrAnonymousUser(user: SessionUser | undefined): boolean;
20
12
  export declare function unauthenticatedResponse(c: import("hono").Context): Response;
@@ -1,25 +1,16 @@
1
1
  import { createProjectingTenantDb } from "../db/tenant-db.js";
2
- import { buildAppSchema } from "../engine/build-app-schema.js";
3
- import { projectAppSchemaForRoles } from "../engine/project-app-schema-for-roles.js";
4
- import { resolveDisabledFeatureNames, stripDisabledFeaturesFromAppSchema, } from "../engine/strip-disabled-features-from-app-schema.js";
5
- import { stripUnreadableRelatedLists } from "../engine/strip-unreadable-related-lists.js";
6
- import { createAnonymousUser, isAnonymousSessionUser } from "../engine/system-user.js";
2
+ import { isAnonymousSessionUser } from "../engine/system-user.js";
7
3
  import { createFileRoutes, readFilesRouteOptions } from "../files/file-routes.js";
8
4
  import { createRecordReadCheck } from "../files/record-read-check.js";
9
5
  import { createRecordWriteCheck } from "../files/record-write-check.js";
10
- import { createRateLimitResolver, httpRouteRateLimit } from "../rate-limit/index.js";
11
- import { assertUnreachable } from "../utils/index.js";
6
+ import { createRateLimitResolver } from "../rate-limit/index.js";
12
7
  import { collectAnonymousLiveEntities } from "./anonymous-live-entities.js";
13
- import { NO_ROUTE_MATCH_HEADER_NAME, Routes } from "./api-constants.js";
14
- import { getUser, identifyOptionalSession } from "./auth-middleware.js";
8
+ import { NO_ROUTE_MATCH_HEADER_NAME } from "./api-constants.js";
9
+ import { identifyOptionalSession } from "./auth-middleware.js";
15
10
  import { createAuthRoutes } from "./auth-routes.js";
16
11
  import { createClientErrorRoute } from "./client-error-route.js";
17
- import { clientIpSourceFromHonoContext } from "./client-ip.js";
18
12
  import { collectEntityReadAccess, collectEntityRowReadMaps } from "./entity-read-access.js";
19
13
  import { createExportRoutes } from "./export/export-route.js";
20
- import { computeStrongEtag, etagMatches } from "./http-cache.js";
21
- import { requestContext } from "./request-context.js";
22
- import { buildRequestContextData } from "./request-id-middleware.js";
23
14
  import { registerHealthRoutes, registerMetricsRoute } from "./route-registrars.js";
24
15
  import { createApiRoutes } from "./routes.js";
25
16
  import { assertSinglePrincipalStatusProvider } from "./server-boot-checks.js";
@@ -65,70 +56,23 @@ export function mountClientErrorRoute(app, wiring) {
65
56
  }));
66
57
  }
67
58
  export function mountDispatcherRoutes(app, wiring) {
68
- const { options, dispatcher, sseBroker } = wiring;
59
+ const { options, dispatcher, sseBroker, rateLimitResolver, tracedRedis } = wiring;
60
+ const exportRateLimitResolver = rateLimitResolver ??
61
+ (tracedRedis ? createRateLimitResolver({ redis: tracedRedis }) : undefined);
69
62
  app.route("/api", createApiRoutes(dispatcher, {
70
63
  ...(options.sseHeartbeatMs !== undefined ? { sseHeartbeatMs: options.sseHeartbeatMs } : {}),
64
+ ...(options.context.clock !== undefined ? { clock: options.context.clock } : {}),
71
65
  }));
72
- app.route("/api", createExportRoutes(dispatcher, options.registry));
66
+ app.route("/api", createExportRoutes(dispatcher, options.registry, exportRateLimitResolver));
73
67
  app.route("/api", createSseRoute(sseBroker, {
74
68
  anonymousLiveEntities: collectAnonymousLiveEntities(options.registry),
75
69
  entityReadAccess: collectEntityReadAccess(options.registry),
76
70
  entityRowReadMaps: collectEntityRowReadMaps(options.registry),
77
71
  }));
78
72
  }
79
- export function mountSchemaRoute(app, options) {
80
- // GET /api/schema — the only way a client obtains the AppSchema. Behind
81
- // jwtGuard (NON_PUBLIC_API_PATHS), so anonymousAccess's synthesised user
82
- // also gets rejected below — the schema never reaches an unauthenticated
83
- // caller. The FULL schema is built lazily once — the registry is
84
- // immutable for this server's lifetime, so it's the same on every
85
- // request — then projected per caller-role-set (a role only
86
- // sees the screens/navs/workspaces/content-collections it may reach,
87
- // not the whole app's schema) and cached per role key. Tenant is
88
- // deliberately NOT part of the key: the projection depends only on
89
- // roles, and per-tenant caching would grow unboundedly across tenants
90
- // that share the same role set. What IS part of the key: the sorted set of
91
- // features the caller's tenant has switched off (r.toggleable) — few
92
- // distinct sets, so the cache stays small. The resolver is read per request
93
- // because run{Dev,Prod}App fill it in after the server is built.
94
- let fullSchema;
95
- const projectedSchemaCache = new Map();
96
- app.get(`/api${Routes.schema}`, async (c) => {
97
- const user = getUser(c);
98
- if (isMissingOrAnonymousUser(user)) {
99
- return unauthenticatedResponse(c);
100
- }
101
- const effectiveFeatures = options.dispatcherOptions?.effectiveFeatures;
102
- const disabledFeatureNames = effectiveFeatures === undefined
103
- ? []
104
- : await resolveDisabledFeatureNames(options.registry, effectiveFeatures, user.tenantId);
105
- const roleKey = JSON.stringify([[...new Set(user?.roles ?? [])].sort(), disabledFeatureNames]);
106
- let cached = projectedSchemaCache.get(roleKey);
107
- if (cached === undefined) {
108
- if (fullSchema === undefined) {
109
- fullSchema = buildAppSchema(options.registry, {
110
- searchAdapterMissing: !options.context.searchAdapter,
111
- });
112
- }
113
- const roles = user?.roles ?? [];
114
- const projected = stripUnreadableRelatedLists(projectAppSchemaForRoles(stripDisabledFeaturesFromAppSchema(fullSchema, options.registry, disabledFeatureNames), roles), roles, (queryQn) => options.registry.getQueryHandler(queryQn)?.access);
115
- const json = JSON.stringify(projected);
116
- cached = { json, etag: computeStrongEtag(json) };
117
- projectedSchemaCache.set(roleKey, cached);
118
- }
119
- const cacheHeaders = { "Cache-Control": "private, no-cache", ETag: cached.etag };
120
- if (etagMatches(c.req.header("If-None-Match") ?? null, cached.etag)) {
121
- return c.body(null, 304, cacheHeaders);
122
- }
123
- return c.body(cached.json, 200, {
124
- "Content-Type": "application/json; charset=utf-8",
125
- ...cacheHeaders,
126
- });
127
- });
128
- }
129
73
  export function mountFileRoutes(app, wiring) {
130
74
  const { options, dispatcher, fileProviderResolver, rateLimitResolver, tracedRedis } = wiring;
131
- const metaBatchRateLimitResolver = rateLimitResolver ??
75
+ const fileRateLimitResolver = rateLimitResolver ??
132
76
  (tracedRedis ? createRateLimitResolver({ redis: tracedRedis }) : undefined);
133
77
  // Mount upload/download routes whenever a file provider is resolvable (a
134
78
  // file-provider plugin is mounted, or a resolver was injected). They resolve
@@ -146,7 +90,8 @@ export function mountFileRoutes(app, wiring) {
146
90
  db: fileDb,
147
91
  registry: options.registry,
148
92
  resolveProvider: fileProviderResolver,
149
- ...(metaBatchRateLimitResolver ? { metaBatchRateLimitResolver } : {}),
93
+ ...(fileRateLimitResolver ? { rateLimitResolver: fileRateLimitResolver } : {}),
94
+ clientIpResolver: wiring.clientIpResolver,
150
95
  canReadRecord,
151
96
  canWriteRecord: createRecordWriteCheck({
152
97
  registry: options.registry,
@@ -162,59 +107,6 @@ export function mountFileRoutes(app, wiring) {
162
107
  }));
163
108
  }
164
109
  }
165
- export function mountFeatureHttpRoutes(app, wiring, sessionOnlyHttpRouteGuards) {
166
- // Feature-declared HTTP routes (r.httpRoute). Mount after /api/* so /api/* always
167
- // takes precedence; feature routes must be outside that prefix (the boot validator
168
- // enforces this). deps.app is the outer app, so the handler can call /api/query
169
- // internally through app.fetch(...) and use the same auth path as a real HTTP call.
170
- // deps.systemQuery deliberately bypasses that path for routes that must enforce a
171
- // FIXED tenant (for example, legal-pages always uses SYSTEM_TENANT_ID), rather than
172
- // spoofing it through the X-Tenant header. That header looks like a normal client
173
- // header to anonymousAccess resolution, so resolverTrust: "authoritative" configs
174
- // correctly reject it as a tenant override.
175
- for (const feature of wiring.options.registry.features.values()) {
176
- for (const route of Object.values(feature.httpRoutes)) {
177
- mountFeatureHttpRoute(app, route, wiring, sessionOnlyHttpRouteGuards);
178
- }
179
- }
180
- }
181
- function mountFeatureHttpRoute(app, route, wiring, sessionOnlyHttpRouteGuards) {
182
- const { dispatcher, clientIpResolver, rateLimitResolver, observability } = wiring;
183
- // @wrapper-known semantic-alias
184
- const honoHandler = async (c) => route.handler(c, {
185
- app,
186
- // createAnonymousUser, NOT createSystemUser: systemQuery's
187
- // synthesized user must clear the SAME access gate a real
188
- // anonymous visitor would, no more — regardless of the route's
189
- // own `anonymous` mode. The system role would ALSO satisfy that
190
- // gate here, but it can read fields gated to "system" that
191
- // "anonymous" can't (filterReadFields is a plain role-in-map
192
- // check) — a systemQuery caller reading a system-gated field
193
- // would leak it into the response. The forced tenant already
194
- // comes from bypassing the HTTP layer entirely; no elevated
195
- // role is needed or wanted on top of that.
196
- systemQuery: makeSystemQuery(c, dispatcher, clientIpResolver),
197
- clientIp: clientIpResolver.resolve(clientIpSourceFromHonoContext(c)),
198
- });
199
- // Without a resolver (no Redis in the context — dev/test stacks) the
200
- // declared limit is skipped rather than failing the boot of every app
201
- // that mounts a bundled feature whose routes carry a default limit.
202
- const routeLimit = route.rateLimit && rateLimitResolver
203
- ? [
204
- httpRouteRateLimit({
205
- resolver: rateLimitResolver,
206
- rateLimit: route.rateLimit,
207
- routeKey: `${route.method} ${route.path}`,
208
- clientIpResolver,
209
- meter: observability.meter,
210
- }),
211
- ]
212
- : [];
213
- mountHonoRoute(app, route.method, route.path, honoHandler, [
214
- ...routeLimit,
215
- ...(route.anonymous ? [] : sessionOnlyHttpRouteGuards),
216
- ]);
217
- }
218
110
  export function installNoRouteMatchMarker(app) {
219
111
  // Marks "no route matched this path" so tryHonoFirst (server-runtime)
220
112
  // can tell it apart from a matched route's OWN deliberate 404 (e.g.
@@ -232,57 +124,6 @@ export function installNoRouteMatchMarker(app) {
232
124
  // app.fetch() passthrough strip it before a response reaches a client.
233
125
  app.notFound((c) => c.text("Not Found", 404, { [NO_ROUTE_MATCH_HEADER_NAME]: "1" }));
234
126
  }
235
- // Method-switch shared by r.httpRoute and extraRoutes — one place to keep
236
- // the two mounting paths from drifting on which Hono methods get a
237
- // convenience-call vs. app.on().
238
- export function mountHonoRoute(app, method, path,
239
- // biome-ignore lint/suspicious/noExplicitAny: Hono context generics are invisible at the framework boundary
240
- handler, middlewares = []) {
241
- // Guards go into the route's own handler chain, never a method-gated
242
- // app.use: Hono serves HEAD through the GET route with c.req.method still
243
- // "HEAD", so a `method === c.req.method` gate would skip them for HEAD.
244
- if (middlewares.length > 0) {
245
- // [path]: only Hono's array-path overload accepts a variable-length handler spread.
246
- app.on(method, [path], ...middlewares, handler);
247
- // skip: guarded route already mounted with its guard chain
248
- return;
249
- }
250
- switch (method) {
251
- case "GET":
252
- app.get(path, handler);
253
- break;
254
- case "POST":
255
- app.post(path, handler);
256
- break;
257
- case "PUT":
258
- app.put(path, handler);
259
- break;
260
- case "PATCH":
261
- app.patch(path, handler);
262
- break;
263
- case "DELETE":
264
- app.delete(path, handler);
265
- break;
266
- case "OPTIONS":
267
- case "HEAD":
268
- // Hono's on() for the methods without a convenience method.
269
- app.on(method, path, handler);
270
- break;
271
- default:
272
- assertUnreachable(method, "http method");
273
- }
274
- }
275
- // Shared systemQuery builder for r.httpRoute and extraRoutes (anonymous +
276
- // signature entries). requestContext.run must wrap the dispatcher call —
277
- // both route kinds run outside the requestIdMiddleware chain that normally
278
- // populates it, and `rateLimit: {per: "ip", ...}` on a handler invoked
279
- // through systemQuery is otherwise silent dead-code (enforceRateLimit reads
280
- // requestContext.get()?.ip, undefined without this wrap).
281
- export function makeSystemQuery(
282
- // biome-ignore lint/suspicious/noExplicitAny: Hono context generics are invisible at the framework boundary
283
- c, dispatcher, clientIpResolver) {
284
- return (type, payload, tenantId) => requestContext.run(requestContext.get() ?? buildRequestContextData(c, clientIpResolver), () => dispatcher.query(type, payload, createAnonymousUser(tenantId)));
285
- }
286
127
  // Shared by entry:"user" extra routes and GET /api/schema — both require a
287
128
  // real, signed-in principal and reject the synthesised anonymousAccess user
288
129
  // (SessionUser.roles includes ANONYMOUS_ROLE) the same way.
@@ -0,0 +1,3 @@
1
+ import type { Hono } from "hono";
2
+ import type { ServerOptions } from "./server.ts";
3
+ export declare function mountSchemaRoute(app: Hono, options: Pick<ServerOptions, "registry" | "dispatcherOptions" | "context">): void;
@@ -0,0 +1,58 @@
1
+ import { buildAppSchema } from "../engine/build-app-schema.js";
2
+ import { projectAppSchemaForRoles } from "../engine/project-app-schema-for-roles.js";
3
+ import { resolveDisabledFeatureNames, stripDisabledFeaturesFromAppSchema, } from "../engine/strip-disabled-features-from-app-schema.js";
4
+ import { stripUnreadableRelatedLists } from "../engine/strip-unreadable-related-lists.js";
5
+ import { Routes } from "./api-constants.js";
6
+ import { getUser } from "./auth-middleware.js";
7
+ import { computeStrongEtag, etagMatches } from "./http-cache.js";
8
+ import { isMissingOrAnonymousUser, unauthenticatedResponse } from "./server-routes.js";
9
+ export function mountSchemaRoute(app, options) {
10
+ // GET /api/schema — the only way a client obtains the AppSchema. Behind
11
+ // jwtGuard (NON_PUBLIC_API_PATHS), so anonymousAccess's synthesised user
12
+ // also gets rejected below — the schema never reaches an unauthenticated
13
+ // caller. The FULL schema is built lazily once — the registry is
14
+ // immutable for this server's lifetime, so it's the same on every
15
+ // request — then projected per caller-role-set (a role only
16
+ // sees the screens/navs/workspaces/content-collections it may reach,
17
+ // not the whole app's schema) and cached per role key. Tenant is
18
+ // deliberately NOT part of the key: the projection depends only on
19
+ // roles, and per-tenant caching would grow unboundedly across tenants
20
+ // that share the same role set. What IS part of the key: the sorted set of
21
+ // features the caller's tenant has switched off (r.toggleable) — few
22
+ // distinct sets, so the cache stays small. The resolver is read per request
23
+ // because run{Dev,Prod}App fill it in after the server is built.
24
+ let fullSchema;
25
+ const projectedSchemaCache = new Map();
26
+ app.get(`/api${Routes.schema}`, async (c) => {
27
+ const user = getUser(c);
28
+ if (isMissingOrAnonymousUser(user)) {
29
+ return unauthenticatedResponse(c);
30
+ }
31
+ const effectiveFeatures = options.dispatcherOptions?.effectiveFeatures;
32
+ const disabledFeatureNames = effectiveFeatures === undefined
33
+ ? []
34
+ : await resolveDisabledFeatureNames(options.registry, effectiveFeatures, user.tenantId);
35
+ const roleKey = JSON.stringify([[...new Set(user?.roles ?? [])].sort(), disabledFeatureNames]);
36
+ let cached = projectedSchemaCache.get(roleKey);
37
+ if (cached === undefined) {
38
+ if (fullSchema === undefined) {
39
+ fullSchema = buildAppSchema(options.registry, {
40
+ searchAdapterMissing: !options.context.searchAdapter,
41
+ });
42
+ }
43
+ const roles = user?.roles ?? [];
44
+ const projected = stripUnreadableRelatedLists(projectAppSchemaForRoles(stripDisabledFeaturesFromAppSchema(fullSchema, options.registry, disabledFeatureNames), roles), roles, (queryQn) => options.registry.getQueryHandler(queryQn)?.access);
45
+ const json = JSON.stringify(projected);
46
+ cached = { json, etag: computeStrongEtag(json) };
47
+ projectedSchemaCache.set(roleKey, cached);
48
+ }
49
+ const cacheHeaders = { "Cache-Control": "private, no-cache", ETag: cached.etag };
50
+ if (etagMatches(c.req.header("If-None-Match") ?? null, cached.etag)) {
51
+ return c.body(null, 304, cacheHeaders);
52
+ }
53
+ return c.body(cached.json, 200, {
54
+ "Content-Type": "application/json; charset=utf-8",
55
+ ...cacheHeaders,
56
+ });
57
+ });
58
+ }