@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
@@ -0,0 +1,57 @@
1
+ import { parseFileHandle } from "@cosmicdrift/kumiko-types/identifiers";
2
+ import { writeFailure } from "../errors/index.js";
3
+ import { fileClaimMatches } from "./file-claim.js";
4
+ import { holdsFileRefs, mapFileRefSlots } from "./file-field-slots.js";
5
+ import { invalidFileRefError } from "./invalid-file-ref-error.js";
6
+ function handlesNamedBy(fields, values) {
7
+ const found = [];
8
+ for (const [fieldName, fieldDef] of Object.entries(fields)) {
9
+ if (!holdsFileRefs(fieldDef) || !(fieldName in values))
10
+ continue;
11
+ mapFileRefSlots(fieldDef, values[fieldName], (entry) => {
12
+ const handle = parseFileHandle(entry);
13
+ if (handle !== null)
14
+ found.push({ fieldName, ...handle });
15
+ return entry;
16
+ });
17
+ }
18
+ return found;
19
+ }
20
+ // Swaps every file handle a write names for the bare fileRef id after checking its claim, so
21
+ // neither the claim nor the handle reaches a hook, the event or the table. A handle only proves
22
+ // ownership of a pending upload; a pending row with a wrong claim, a missing row or one of
23
+ // another tenant, or an upload made for another field fails like an unknown id. A bound row passes through as its bare id.
24
+ export async function resolveFileHandles({ fields }, entityName, values, db, user) {
25
+ const handles = handlesNamedBy(fields, values);
26
+ // skip: without handles there is nothing to resolve and no row to read
27
+ if (handles.length === 0)
28
+ return { values, claimedFileRefIds: [] };
29
+ // Loaded on demand: file_refs is built from an entity definition that needs the engine, which
30
+ // imports the executor this module is part of.
31
+ const { loadFileRefRows } = await import("./load-save-file-refs.js");
32
+ const rows = await loadFileRefRows(db, [...new Set(handles.map((h) => h.id))], user.tenantId);
33
+ const claimedFileRefIds = new Set();
34
+ for (const handle of handles) {
35
+ const row = rows.get(handle.id);
36
+ if (row === undefined)
37
+ return { failure: writeFailure(invalidFileRefError(handle.fieldName)) };
38
+ // A bound row needs no claim: the handle is just resubmitted next to its record, and
39
+ // assertFileRefsBelongToTenant judges it like a bare id (same record passes, another fails).
40
+ if (row["entityId"] !== null && row["entityId"] !== undefined)
41
+ continue;
42
+ // The claim is bound to the field the upload came in through: a handle issued for one field
43
+ // must not carry the file into another entity or field.
44
+ const isIssuedForThisField = row["entityType"] === entityName && row["fieldName"] === handle.fieldName;
45
+ if (!isIssuedForThisField || !fileClaimMatches(row["claimHash"], handle.claim)) {
46
+ return { failure: writeFailure(invalidFileRefError(handle.fieldName)) };
47
+ }
48
+ claimedFileRefIds.add(handle.id);
49
+ }
50
+ const resolved = { ...values };
51
+ for (const [fieldName, fieldDef] of Object.entries(fields)) {
52
+ if (!holdsFileRefs(fieldDef) || !(fieldName in values))
53
+ continue;
54
+ resolved[fieldName] = mapFileRefSlots(fieldDef, values[fieldName], (entry) => parseFileHandle(entry)?.id ?? entry);
55
+ }
56
+ return { values: resolved, claimedFileRefIds: [...claimedFileRefIds] };
57
+ }
@@ -7,7 +7,7 @@ export declare function fileRefStorageDelta(event: {
7
7
  readonly bytes: number;
8
8
  readonly files: number;
9
9
  } | null;
10
- export declare const tenantStorageUsageTable: import("@cosmicdrift/kumiko-types/executor-brand").WritableSchemaTable;
10
+ export declare const tenantStorageUsageTable: import("@cosmicdrift/kumiko-types/schema-table-types").SchemaTable;
11
11
  export declare const filesStorageTrackingFeature: import("@cosmicdrift/kumiko-types/feature").FeatureDefinition & {
12
12
  readonly exports: void;
13
13
  };
@@ -15,6 +15,7 @@ import { entityEventName } from "../db/index.js";
15
15
  import { toPostgresArrayLiteral } from "../db/queries/postgres-array-literal.js";
16
16
  import { executeRawQueryRead } from "../db/queries/raw-sql.js";
17
17
  import { incrementCounter } from "../db/query.js";
18
+ import { withExecutorManagedWrites } from "../db/tenant-db.js";
18
19
  import { defineFeature, qn, toKebab } from "../engine/index.js";
19
20
  import { selectConsumerCursorForUpdate } from "../pipeline/event-dispatcher-delivery.js";
20
21
  import { SHARED_INSTANCE_SENTINEL } from "../pipeline/index.js";
@@ -169,14 +170,16 @@ export async function transferTenantStorageUsage(args) {
169
170
  // skip: the moved fileRefs carry no applied storage share
170
171
  if (bytes === 0 && files === 0)
171
172
  return;
173
+ // read_* tables take writes only through an executor-managed runner, like the MSP apply above.
174
+ const managed = withExecutorManagedWrites(db);
172
175
  // Source: insert-values stay 0/0 (same guard as the DELETED handler above)
173
176
  // — the row this subtracts from is expected to already exist (the MSP
174
177
  // already applied the create against it), and if it somehow doesn't, this
175
178
  // must not conjure a negative balance out of thin air.
176
- await incrementCounter(db, tenantStorageUsageTable, { tenantId: sourceTenantId, totalBytes: 0, fileCount: 0 }, { totalBytes: -bytes, fileCount: -files }, { set: { lastUpdatedAt: sql `now()` } });
179
+ await incrementCounter(managed, tenantStorageUsageTable, { tenantId: sourceTenantId, totalBytes: 0, fileCount: 0 }, { totalBytes: -bytes, fileCount: -files }, { set: { lastUpdatedAt: sql `now()` } });
177
180
  // Destination: insert-values ARE the transferred amount (same as CREATED/
178
181
  // RESTORED above) — a tenant claiming its first-ever fileRef must start
179
182
  // its counter row at the transferred total, not at 0 with an increment
180
183
  // that only fires once a row already exists.
181
- await incrementCounter(db, tenantStorageUsageTable, { tenantId: destinationTenantId, totalBytes: bytes, fileCount: files }, { totalBytes: bytes, fileCount: files }, { set: { lastUpdatedAt: sql `now()` } });
184
+ await incrementCounter(managed, tenantStorageUsageTable, { tenantId: destinationTenantId, totalBytes: bytes, fileCount: files }, { totalBytes: bytes, fileCount: files }, { set: { lastUpdatedAt: sql `now()` } });
182
185
  }
@@ -3,10 +3,11 @@ import { createSystemUser, SYSTEM_USER_ID } from "../engine/system-user.js";
3
3
  import { getFileRefExecutor } from "./create-file-ref.js";
4
4
  import { fileRefsTable } from "./file-ref-table.js";
5
5
  export const STALE_PENDING_FILE_REF_SWEEP_BATCH = 500;
6
- // A pending upload names its target field (entityType set) but no record yet. Uploads without a
7
- // target field (inbox, dropzone) and files the system generated are kept on purpose.
6
+ // A pending upload names its target field (entityType set, filtered in SQL) but no record yet.
7
+ // Uploads without a target field (inbox, dropzone) and files the system generated are kept on
8
+ // purpose. The system filter stays in memory: SQL `<>` would also drop rows with a NULL inserter.
8
9
  function isStalePendingUpload(row) {
9
- return row.entityType !== null && row.insertedById !== SYSTEM_USER_ID;
10
+ return row.insertedById !== SYSTEM_USER_ID;
10
11
  }
11
12
  // Soft-deletes pending uploads whose record never came, through the fileRef executor, so the
12
13
  // soft-delete cleanup later removes their bytes like those of any deleted file.
@@ -21,6 +22,7 @@ export async function sweepStalePendingFileRefs(args) {
21
22
  for (;;) {
22
23
  const rows = await selectMany(db, fileRefsTable, {
23
24
  entityId: null,
25
+ entityType: { ne: null },
24
26
  isDeleted: false,
25
27
  insertedAt: { lt: cutoff },
26
28
  ...(cursor !== undefined && { id: { gt: cursor } }),
@@ -35,7 +37,11 @@ export async function sweepStalePendingFileRefs(args) {
35
37
  return swept;
36
38
  cursor = lastRow.id;
37
39
  for (const row of rows.filter(isStalePendingUpload)) {
38
- const removed = await executor.delete({ id: row.id }, user, db);
40
+ // A form save may bind the upload after the page was read; the delete then fails instead of
41
+ // soft-deleting a file a record now references.
42
+ const removed = await executor.delete({ id: row.id }, user, db, {
43
+ expect: { entityId: null, isDeleted: false },
44
+ });
39
45
  if (removed.isSuccess) {
40
46
  swept++;
41
47
  continue;
@@ -6,6 +6,10 @@ export type FileMetadata = {
6
6
  readonly size: number;
7
7
  };
8
8
  export type { FileStorageProvider, SignedUrlOptions, WriteStreamOptions, } from "@cosmicdrift/kumiko-types/file-storage-provider-types";
9
+ export declare class FileObjectMissingError extends Error {
10
+ readonly storageKey: string;
11
+ constructor(storageKey: string, message?: string);
12
+ }
9
13
  export type FileValidationOptions = {
10
14
  /** "10mb"-style string or a byte count. */
11
15
  readonly maxSize?: string | number | undefined;
@@ -2,6 +2,16 @@ import { readZipEntryNames } from "./zip-entry-names.js";
2
2
  // Lives here (not in file-ref-entity.ts) so engine code can name the entity without importing
3
3
  // a module that calls createEntity at load time.
4
4
  export const FILE_REF_ENTITY_NAME = "fileRef";
5
+ // Providers throw this when read() finds no object for a key, so callers can tell a permanently
6
+ // missing object from transient storage errors.
7
+ export class FileObjectMissingError extends Error {
8
+ storageKey;
9
+ constructor(storageKey, message = `file object not found: ${storageKey}`) {
10
+ super(message);
11
+ this.storageKey = storageKey;
12
+ this.name = "FileObjectMissingError";
13
+ }
14
+ }
5
15
  export function parseMaxSize(maxSize) {
6
16
  const match = maxSize.match(/^(\d+)(kb|mb|gb)$/i);
7
17
  if (!match)
@@ -24,4 +24,5 @@ type UploadFieldResolution = AttachedFieldResolution | {
24
24
  export declare function resolveUploadField(registry: Registry | undefined, input: UploadTarget, attachTargets: AttachTargets | undefined): UploadFieldResolution;
25
25
  export declare function registryHasAnonymousUploadField(registry: Registry | undefined): boolean;
26
26
  export declare function isAnonymousPendingUploadAllowed(registry: Registry | undefined, target: UploadTarget): boolean;
27
+ export declare function resolveMaxAnonymousUploadBytes(registry: Registry | undefined, defaultMaxSize: string): number;
27
28
  export {};
@@ -1,6 +1,7 @@
1
1
  import { isFileField } from "../engine/field-helpers.js";
2
2
  import { isActionFormScreenQn, resolveActionFormFileField } from "./action-form-upload.js";
3
3
  import { resolveFileSubField } from "./file-field-slots.js";
4
+ import { parseMaxSize } from "./types.js";
4
5
  function findAttachEntity(registry, entityType, attachTargets) {
5
6
  return (registry?.getEntity(entityType) ??
6
7
  (attachTargets === "entities-and-read-models"
@@ -84,8 +85,8 @@ export function registryHasAnonymousUploadField(registry) {
84
85
  anonymousUploadRegistries.set(registry, found);
85
86
  return found;
86
87
  }
87
- // Anonymous visitors share one user id and cannot bind, so only an opted-in field's
88
- // pending upload (no record, no action form) is allowed.
88
+ // Anonymous uploads stay pending (no record, no action form) and only into an opted-in field;
89
+ // the upload response hands the visitor the claim handle that later binds the file.
89
90
  export function isAnonymousPendingUploadAllowed(registry, target) {
90
91
  if (target.entityId !== undefined || target.actionForm !== undefined)
91
92
  return false;
@@ -94,3 +95,16 @@ export function isAnonymousPendingUploadAllowed(registry, target) {
94
95
  isFileField(resolution.fieldDef) &&
95
96
  resolution.fieldDef.anonymousUpload === true);
96
97
  }
98
+ // The anonymous body cap: the largest opted-in field, not the registry-wide largest, so a
99
+ // visitor cannot make the server buffer a body only an authenticated field would accept.
100
+ export function resolveMaxAnonymousUploadBytes(registry, defaultMaxSize) {
101
+ let maxBytes = 0;
102
+ for (const entity of registry?.getAllEntities().values() ?? []) {
103
+ for (const fieldDef of Object.values(entity.fields)) {
104
+ if (isFileField(fieldDef) && fieldDef.anonymousUpload === true) {
105
+ maxBytes = Math.max(maxBytes, parseMaxSize(fieldDef.maxSize ?? defaultMaxSize));
106
+ }
107
+ }
108
+ }
109
+ return maxBytes;
110
+ }
@@ -43,7 +43,7 @@ export function createFileUploadLedger(db, tenantId, now = () => Temporal.Now.in
43
43
  };
44
44
  }
45
45
  export function withUploadLedger(resolver, db, now) {
46
- return Object.assign(resolver, {
46
+ return Object.assign((tenantId) => resolver(tenantId), {
47
47
  uploadLedgerFor: (tenantId) => createFileUploadLedger(db, tenantId, now),
48
48
  });
49
49
  }
@@ -0,0 +1,3 @@
1
+ import type { ProjectionDetailScreenDefinition, RowAction } from "../engine/types/screen.ts";
2
+ /** i18n references of the banner/steps blocks; `pushKey` filters out literal texts. */
3
+ export declare function pushDetailGuidanceKeys(detail: ProjectionDetailScreenDefinition, pushKey: (value: string | undefined) => void, pushRowActionKeys: (action: RowAction) => void): void;
@@ -0,0 +1,9 @@
1
+ /** i18n references of the banner/steps blocks; `pushKey` filters out literal texts. */
2
+ export function pushDetailGuidanceKeys(detail, pushKey, pushRowActionKeys) {
3
+ pushKey(detail.steps?.title);
4
+ pushKey(detail.steps?.emptyLabel);
5
+ for (const action of detail.banner?.actions ?? [])
6
+ pushRowActionKeys(action);
7
+ for (const action of detail.steps?.actions ?? [])
8
+ pushRowActionKeys(action);
9
+ }
@@ -1,5 +1,6 @@
1
1
  import { isExplicitDotFormKey } from "../engine/i18n-key.js";
2
2
  import { isExtensionEditSection, isWriteFormEditSection, normalizeListColumn, sectionFieldSpecs, } from "../engine/screen-helpers.js";
3
+ import { pushDetailGuidanceKeys } from "./required-surface-guidance-keys.js";
3
4
  /** Pseudo-entity for actionForm field labels (renderer action-form-shim). */
4
5
  export const ACTION_FORM_ENTITY = "__action-form__";
5
6
  /** Pseudo-entity for configEdit field labels (renderer config-edit-shim). */
@@ -131,8 +132,13 @@ function pushDashboardPanelKeys(out, panel) {
131
132
  if (panel.kind === "custom")
132
133
  return;
133
134
  pushKey(out, panel.label);
134
- if (panel.kind === "chart" || panel.kind === "stat-group")
135
+ if (panel.kind === "chart" || panel.kind === "stat-group" || panel.kind === "list") {
135
136
  pushKey(out, panel.subtitle);
137
+ }
138
+ if (panel.kind === "list")
139
+ pushKey(out, panel.footerLink?.label);
140
+ if (panel.kind === "stat-group")
141
+ pushKey(out, panel.link?.label);
136
142
  if (panel.kind === "text")
137
143
  pushDashboardTextBlockKeys(out, panel);
138
144
  if (panel.kind === "chart") {
@@ -158,20 +164,24 @@ function pushDashboardChildLabelKeys(out, panel) {
158
164
  const normalized = normalizeListColumn(col);
159
165
  if (normalized.label !== undefined)
160
166
  pushKey(out, normalized.label);
167
+ pushKey(out, normalized.hint?.emptyLabel);
161
168
  }
162
169
  }
163
170
  }
171
+ function pushDashboardTextKey(out, text) {
172
+ pushKey(out, typeof text === "string" ? text : text.i18nKey);
173
+ }
164
174
  function pushDashboardTextBlockKeys(out, panel) {
165
- for (const block of panel.blocks) {
175
+ for (const block of [...(panel.blocks ?? []), ...(panel.narrowBlocks ?? [])]) {
166
176
  // skip: code is shown verbatim, not translated
167
177
  if (block.kind === "code")
168
178
  continue;
169
179
  if (block.kind === "list") {
170
180
  for (const item of block.items)
171
- pushKey(out, item);
181
+ pushDashboardTextKey(out, item);
172
182
  }
173
183
  else {
174
- pushKey(out, block.text);
184
+ pushDashboardTextKey(out, block.text);
175
185
  }
176
186
  }
177
187
  }
@@ -249,6 +259,10 @@ function pushFieldLabelOrOverrideKey(ctx, labelEntity, fieldName, fieldLabels, t
249
259
  ctx.out.add(fieldLabelKey(ctx.featureName, labelEntity, fieldName));
250
260
  }
251
261
  function pushListChromeKeys(out, list) {
262
+ for (const col of list.columns)
263
+ pushKey(out, normalizeListColumn(col).hint?.emptyLabel);
264
+ for (const option of list.sortOptions ?? [])
265
+ pushKey(out, option.label);
252
266
  pushKey(out, list.createLabel);
253
267
  pushKey(out, list.searchPlaceholder);
254
268
  pushKey(out, list.description);
@@ -388,6 +402,7 @@ function pushWriteFormSectionKeys(ctx, section) {
388
402
  function collectProjectionDetailKeys(ctx, detail) {
389
403
  for (const metric of detail.metrics ?? [])
390
404
  pushKey(ctx.out, metric.label);
405
+ pushDetailGuidanceKeys(detail, (value) => pushKey(ctx.out, value), (action) => pushRowActionKeys(ctx.out, action));
391
406
  for (const section of detail.layout.sections) {
392
407
  if (isExtensionEditSection(section)) {
393
408
  pushKey(ctx.out, section.title);
@@ -526,7 +541,8 @@ export function buildEffectiveTranslationKeys(features) {
526
541
  function hasLocaleValue(value) {
527
542
  if (value === undefined)
528
543
  return false;
529
- return typeof value === "string" ? value !== "" : true;
544
+ const forms = typeof value === "string" ? [value] : Object.values(value);
545
+ return forms.every((form) => form.trim() !== "");
530
546
  }
531
547
  /**
532
548
  * Per feature, every translation key must carry every locale that any key of the
@@ -0,0 +1,2 @@
1
+ import { type BootRuleTable } from "../engine/boot-validator/boot-rule.ts";
2
+ export declare function bootRuleTableViolations(table: BootRuleTable): string[];
@@ -0,0 +1,29 @@
1
+ // @runtime test
2
+ import { bootRuleDocLink } from "../engine/boot-validator/boot-rule.js";
3
+ const RULE_ID_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*\/[a-z0-9]+(-[a-z0-9]+)*$/;
4
+ function findDuplicates(values) {
5
+ return values.filter((value, index) => values.indexOf(value) !== index);
6
+ }
7
+ export function bootRuleTableViolations(table) {
8
+ const rules = Object.values(table);
9
+ const ids = rules.map((rule) => rule.id);
10
+ const violations = [];
11
+ for (const id of findDuplicates(ids))
12
+ violations.push(`duplicate id: ${id}`);
13
+ for (const id of ids) {
14
+ if (!RULE_ID_PATTERN.test(id))
15
+ violations.push(`id is not <area>/<kebab>: ${id}`);
16
+ if (id.startsWith("unclassified/"))
17
+ violations.push(`id is unclassified: ${id}`);
18
+ }
19
+ for (const anchor of findDuplicates(ids.flatMap((id) => bootRuleDocLink(id) ?? []))) {
20
+ violations.push(`duplicate doc anchor: ${anchor}`);
21
+ }
22
+ for (const rule of rules) {
23
+ if (rule.summary.trim() === "")
24
+ violations.push(`empty summary: ${rule.id}`);
25
+ if (rule.fix.trim() === "")
26
+ violations.push(`empty fix: ${rule.id}`);
27
+ }
28
+ return violations;
29
+ }
@@ -2,3 +2,4 @@ export { tenantScopedSecrets } from "../api/tenant-scoped-secrets.ts";
2
2
  export { isRowLevelSecurityViolation } from "../db/pg-error.ts";
3
3
  export { DEFAULT_ROW_LEVEL_SECURITY_MODE } from "../db/render-rls-ddl.ts";
4
4
  export { appHookScopedRunner, runInRowLevelSecurityScope, runInSystemRowLevelSecurityScope, systemScopedRunner, tenantRowLevelSecurityScope, } from "../db/row-level-security-scope.ts";
5
+ export { systemTenantReadDb, systemTenantReadRunner, systemTenantWriteRunner, } from "../db/system-tenant-read-db.ts";
@@ -2,3 +2,4 @@ export { tenantScopedSecrets } from "../api/tenant-scoped-secrets.js";
2
2
  export { isRowLevelSecurityViolation } from "../db/pg-error.js";
3
3
  export { DEFAULT_ROW_LEVEL_SECURITY_MODE } from "../db/render-rls-ddl.js";
4
4
  export { appHookScopedRunner, runInRowLevelSecurityScope, runInSystemRowLevelSecurityScope, systemScopedRunner, tenantRowLevelSecurityScope, } from "../db/row-level-security-scope.js";
5
+ export { systemTenantReadDb, systemTenantReadRunner, systemTenantWriteRunner, } from "../db/system-tenant-read-db.js";
@@ -7,6 +7,7 @@ export { resetEventPiiCatalogForTests } from "../crypto/event-pii.ts";
7
7
  export { resetPiiSubjectKmsForTests } from "../crypto/pii-field-encryption.ts";
8
8
  export { resetEntityFieldEncryptionCacheForTests } from "../db/entity-field-encryption.ts";
9
9
  export { type ExecutorManagedEntitySource, executorManagedEntitySourceOf, } from "../db/executor-managed-tables.ts";
10
+ export { bootRuleTableViolations } from "./boot-rule-table-expectations.ts";
10
11
  export declare function withExecutorManagedWritesForTests(db: TenantDb): ExecutorManagedTenantDb;
11
12
  export declare function withExecutorManagedWritesForTests(db: DbRunner): ExecutorManagedRunner;
12
13
  export declare function withExecutorManagedWritesForTests(db: AnyDb): ExecutorManagedTenantDb | ExecutorManagedRunner;
@@ -5,6 +5,7 @@ export { resetEventPiiCatalogForTests } from "../crypto/event-pii.js";
5
5
  export { resetPiiSubjectKmsForTests } from "../crypto/pii-field-encryption.js";
6
6
  export { resetEntityFieldEncryptionCacheForTests } from "../db/entity-field-encryption.js";
7
7
  export { executorManagedEntitySourceOf, } from "../db/executor-managed-tables.js";
8
+ export { bootRuleTableViolations } from "./boot-rule-table-expectations.js";
8
9
  export function withExecutorManagedWritesForTests(db) {
9
10
  if (isBoundTenantDb(db)) {
10
11
  const options = { db: withExecutorManagedWrites(tenantDbRunner(db)), tenantId: db.tenantId };
@@ -1,3 +1,4 @@
1
1
  export type { JobDroppedMeta, JobLogEntry, JobMeta, JobOutcomeMeta, JobQueuedMeta, JobRunner, JobRunnerOptions, } from "./job-runner.ts";
2
2
  export { createJobRunner, serializeJobSubject } from "./job-runner.ts";
3
3
  export { DEFAULT_MAINTENANCE_WINDOW, MAINTENANCE_WINDOW_ENV, type MaintenanceWindow, maintenanceWindowFromEnv, } from "./maintenance-window.ts";
4
+ export { type ObliterateJobQueuesOptions, obliterateJobQueues } from "./obliterate-job-queues.ts";
@@ -1,2 +1,3 @@
1
1
  export { createJobRunner, serializeJobSubject } from "./job-runner.js";
2
2
  export { DEFAULT_MAINTENANCE_WINDOW, MAINTENANCE_WINDOW_ENV, maintenanceWindowFromEnv, } from "./maintenance-window.js";
3
+ export { obliterateJobQueues } from "./obliterate-job-queues.js";
@@ -0,0 +1,10 @@
1
+ import type { TenantDb } from "../db/tenant-db.ts";
2
+ import type { HandlerEvents, Registry } from "../engine/types/index.ts";
3
+ type JobLoadEventsInput = {
4
+ readonly registry: Registry;
5
+ readonly jobDb: TenantDb | undefined;
6
+ readonly tenantId: string;
7
+ readonly jobName: string;
8
+ };
9
+ export declare function createJobLoadEvents(input: JobLoadEventsInput): HandlerEvents["load"];
10
+ export {};
@@ -0,0 +1,12 @@
1
+ import { tenantDbRunner } from "../db/tenant-db-runner.js";
2
+ import { InternalError } from "../errors/index.js";
3
+ import { loadUpcastedAggregate } from "../pipeline/handler-context-events.js";
4
+ export function createJobLoadEvents(input) {
5
+ const { registry, jobDb, tenantId, jobName } = input;
6
+ return async (aggregateId, options) => {
7
+ if (jobDb === undefined) {
8
+ throw new InternalError({ message: `Job ${jobName}: ctx.events.load needs a tenant db` });
9
+ }
10
+ return loadUpcastedAggregate({ db: tenantDbRunner(jobDb), registry, tenantId }, aggregateId, options);
11
+ };
12
+ }
@@ -1,20 +1,12 @@
1
1
  /// <reference types="temporal-polyfill/global" preserve="true" />
2
- import { crossTenantReadsGrantFor, escapeHatchFor } from "@cosmicdrift/kumiko-types/handlers";
3
- import { createCrossTenantReads } from "../db/cross-tenant-reads.js";
4
- import { createTenantDb, createUncheckedSystemDb } from "../db/tenant-db.js";
5
- import { createDerivativesContext } from "../derivatives/derivatives-context.js";
6
2
  import { createSystemUser } from "../engine/system-user.js";
7
- import { InternalError } from "../errors/index.js";
8
- import { createTenantFileContext } from "../files/file-handle.js";
9
- import { createEscapeHatchReporter } from "../observability/escape-hatch-report.js";
10
3
  import { createMetricsForFactory } from "../observability/index.js";
11
- import { configAccessorFactoryOf } from "../pipeline/config-accessor-factory.js";
12
4
  import { buildContextServices } from "../pipeline/context-services.js";
13
- import { createGatedIdentitySwitch } from "../pipeline/system-identity-switch.js";
14
- import { buildPersonalDataGate, parseWriteOrigin } from "../pipeline/write-origin.js";
15
- import { isScheduledTrigger } from "./cron-repeat-options.js";
5
+ import { parseWriteOrigin } from "../pipeline/write-origin.js";
16
6
  import { createJobAppendEvent } from "./job-append-event.js";
17
- import { attemptNumberOf, createJobLogger, handlerPayloadOf, hasDeferBudgetLeft, isFinalAttempt, isJobTriggerEvent, jobSubjectKey, missingDbProxy, tenantIdOfJobData, } from "./job-runner-helpers.js";
7
+ import { createJobLoadEvents } from "./job-load-events.js";
8
+ import { buildJobDbFacets, buildJobDispatchFacets, buildJobServiceFacets, createJobDefer, createJobEscapeHatchReporter, } from "./job-runner-facets.js";
9
+ import { attemptNumberOf, createJobLogger, handlerPayloadOf, hasDeferBudgetLeft, isFinalAttempt, isJobTriggerEvent, isQueuedRun, jobSubjectKey, missingDbProxy, tenantIdOfJobData, } from "./job-runner-helpers.js";
18
10
  // Tenant-visible failure record (JobDefinition.tenantVisibleFailure). The
19
11
  // subject is read from the handler payload, so it is resolved where the
20
12
  // payload is built, not in the callbacks.
@@ -54,149 +46,6 @@ function parseJobWriteOrigin(rawData, jobName) {
54
46
  return { writeOrigin: undefined, writeOriginInvalid: true };
55
47
  return { writeOrigin: { ...parsed, viaJob: jobName }, writeOriginInvalid: false };
56
48
  }
57
- function createJobEscapeHatchReporter(scope, input, systemUser) {
58
- const { jobName, jobDef, tenantId, triggeredById } = input;
59
- // One reporter for ctx.systemDb and ctx.db.unsafeRaw() so both dedupe in the same window.
60
- const isSystemCronRun = triggeredById === null &&
61
- jobDef.escapeHatch !== undefined &&
62
- isScheduledTrigger(jobDef.trigger);
63
- return createEscapeHatchReporter({
64
- handler: jobName,
65
- tenantId,
66
- actor: systemUser.id,
67
- sink: scope.context._escapeHatchAuditSink,
68
- log: scope.errorLogger,
69
- window: scope.escapeHatchReportWindow,
70
- ...(triggeredById !== null && { caller: triggeredById }),
71
- ...(isSystemCronRun && { processDedup: scope.systemCronEscapeHatchDedup }),
72
- ...(scope.context.meter && { meter: scope.context.meter }),
73
- });
74
- }
75
- function buildJobDbFacets(scope, facetInput) {
76
- const { context, registry } = scope;
77
- const { input, isSystemJob, reportEscapeHatch } = facetInput;
78
- const { jobDef, tenantId, writeOrigin } = input;
79
- const personalDataGate = writeOrigin ? buildPersonalDataGate(registry, writeOrigin) : undefined;
80
- const configDb = context.db; // @cast-boundary db-operator
81
- // Shared by the config accessor and ctx.services.derivatives below — both need the
82
- // same tenant-scoped db, and building it twice would let the two calls
83
- // drift apart. Always "system" mode regardless of the job's own
84
- // systemScope() status (pre-existing, not something this change alters)
85
- // — isSystemJob below is what actually keeps ctx.systemDb off a
86
- // non-system job; it is the only thing standing between this db and an
87
- // unchecked cross-tenant escape hatch for such a job. Gated like jobDb so
88
- // ctx.systemDb, built from it, is gated too.
89
- const tenantScopedDb = configDb
90
- ? createTenantDb({
91
- db: configDb,
92
- tenantId,
93
- mode: "system",
94
- reason: "job context db for cross-tenant jobs, ctx.systemDb exposure is gated by isSystemJob",
95
- grants: {
96
- projectionRegistry: registry,
97
- ...(personalDataGate && { personalDataGate }),
98
- },
99
- })
100
- : undefined;
101
- const systemDb = isSystemJob && tenantScopedDb
102
- ? createUncheckedSystemDb(tenantScopedDb, undefined, reportEscapeHatch)
103
- : undefined;
104
- const jobDb = configDb
105
- ? createTenantDb({
106
- db: configDb,
107
- tenantId,
108
- mode: "tenant",
109
- tracer: context.tracer,
110
- meter: context.meter,
111
- grants: {
112
- unsafeRaw: escapeHatchFor(jobDef.escapeHatch, "unsafeRaw"),
113
- globalWrites: escapeHatchFor(jobDef.escapeHatch, "globalWrites"),
114
- report: reportEscapeHatch,
115
- projectionRegistry: registry,
116
- ...(personalDataGate && { personalDataGate }),
117
- },
118
- })
119
- : undefined;
120
- const crossTenantReadsReason = crossTenantReadsGrantFor(jobDef.escapeHatch)?.reason;
121
- const crossTenantReads = tenantScopedDb && crossTenantReadsReason !== undefined
122
- ? createCrossTenantReads(tenantScopedDb, crossTenantReadsReason, reportEscapeHatch)
123
- : undefined;
124
- return { tenantScopedDb, jobDb, systemDb, crossTenantReads };
125
- }
126
- function buildJobServiceFacets(scope, facetInput, tenantScopedDb) {
127
- const { context, registry } = scope;
128
- const { input, systemUser } = facetInput;
129
- const { tenantId } = input;
130
- // Mirror dispatch-shared.ts buildHandlerContext: ctx.services.files must resolve
131
- // through the same _fileProviderResolver for jobs as for write-handlers,
132
- // otherwise event-triggered jobs silently get an unresolved ctx.services.files.
133
- const fileResolver = context._fileProviderResolver;
134
- const files = fileResolver ? createTenantFileContext(fileResolver, tenantId) : context.files;
135
- // Same buildHandlerContext parity as ctx.services.files above: ctx.notify/ctx.config
136
- // must resolve for jobs the same way they do for write-handlers, or an
137
- // app-author job calling ctx.notify(...)/ctx.config(...) hits a TypeError
138
- // at runtime the write-handler path never would.
139
- const notify = context._notifyFactory?.(systemUser, tenantId, scope.getSelfRunner(), undefined, context._fileProviderResolver);
140
- const configFactory = configAccessorFactoryOf(context);
141
- const config = configFactory && tenantScopedDb
142
- ? configFactory({
143
- user: { id: systemUser.id, tenantId },
144
- db: tenantScopedDb,
145
- secrets: context.secrets,
146
- })
147
- : undefined;
148
- // Mirror dispatch-shared.ts: ctx.services.derivatives needs files+db, same
149
- // tenant-scoped db the config accessor above uses.
150
- const derivatives = files && tenantScopedDb
151
- ? createDerivativesContext({ files, registry, db: tenantScopedDb, tenantId })
152
- : context.derivatives;
153
- return { files, notify, config, derivatives };
154
- }
155
- function requireDispatchRef(scope, method) {
156
- const ref = scope.getDispatchWriteRef();
157
- if (!ref) {
158
- throw new Error(`JobContext.${method} called before dispatcher attached — call attachDispatcher() first`);
159
- }
160
- return ref;
161
- }
162
- function buildJobDispatchFacets(scope, facetInput) {
163
- const { input, systemUser, isSystemJob, reportEscapeHatch } = facetInput;
164
- const { jobName, jobDef, tenantId, writeOrigin } = input;
165
- // Per-job-run reader, created lazily on queryAsMember's first call and
166
- // cached for the rest of this run.
167
- let memberReader;
168
- const identitySwitchHatch = escapeHatchFor(jobDef.escapeHatch, "systemIdentity");
169
- const identitySwitchGrantReason = identitySwitchHatch?.reason ??
170
- (isSystemJob ? `r.systemScope() feature of job "${jobName}"` : undefined);
171
- const gatedIdentitySwitch = createGatedIdentitySwitch(`job "${jobName}"`, systemUser, isSystemJob || identitySwitchHatch !== undefined, {
172
- queryAs: (user, qn, payload) => requireDispatchRef(scope, "queryAs").queryAs(user, qn, payload, writeOrigin),
173
- writeAs: async (user, qn, payload) => requireDispatchRef(scope, "writeAs").write(user, qn, payload, writeOrigin),
174
- }, { reason: identitySwitchGrantReason, report: reportEscapeHatch });
175
- return {
176
- write: (qn, payload) => requireDispatchRef(scope, "write").write(systemUser, qn, payload, writeOrigin),
177
- writeAs: gatedIdentitySwitch.writeAs,
178
- queryAs: gatedIdentitySwitch.queryAs,
179
- queryAsMember: (userId, qn, payload) => {
180
- const ref = requireDispatchRef(scope, "queryAsMember");
181
- // Lazy per-run reader, mirroring the handler-context reader.
182
- memberReader ??= ref.createMemberReader(tenantId);
183
- return memberReader(userId, qn, payload);
184
- },
185
- };
186
- }
187
- function createJobDefer(jobName, bullJob, token) {
188
- return (delayMs) => {
189
- if (!Number.isInteger(delayMs) || delayMs <= 0) {
190
- throw new RangeError(`Job "${jobName}": ctx.defer needs a positive integer delay in ms (got ${delayMs})`);
191
- }
192
- if (token === undefined || !bullJob.moveToDelayed) {
193
- throw new InternalError({
194
- message: `Job "${jobName}": ctx.defer needs a queued run; it is not available inline (boot gate).`,
195
- });
196
- }
197
- return { kind: "job-deferral", delayMs };
198
- };
199
- }
200
49
  function buildJobServices(scope, parts) {
201
50
  const { files, derivatives, selfRunner } = parts;
202
51
  return buildContextServices(scope.context, {
@@ -240,9 +89,7 @@ function buildJobContext(scope, input) {
240
89
  const jobLogger = createJobLogger(input.logs);
241
90
  const jobContext = {
242
91
  defer: createJobDefer(jobName, bullJob, token),
243
- canDefer: token !== undefined &&
244
- bullJob.moveToDelayed !== undefined &&
245
- hasDeferBudgetLeft(rawData, input.jobDef.maxDefers),
92
+ canDefer: isQueuedRun(bullJob, token) && hasDeferBudgetLeft(rawData, input.jobDef.maxDefers),
246
93
  db: jobDb ?? missingDbProxy(jobName),
247
94
  events: {
248
95
  append: createJobAppendEvent({
@@ -252,6 +99,7 @@ function buildJobContext(scope, input) {
252
99
  systemUser,
253
100
  jobName,
254
101
  }),
102
+ load: createJobLoadEvents({ registry: scope.registry, jobDb, tenantId, jobName }),
255
103
  },
256
104
  services: buildJobServices(scope, { files, derivatives, selfRunner }),
257
105
  lifecycle: scope.context.signal ? { signal: scope.context.signal } : {},
@@ -0,0 +1,7 @@
1
+ import type { JobDefinition } from "@cosmicdrift/kumiko-types/config";
2
+ import type { Tracer } from "@cosmicdrift/kumiko-types/observability";
3
+ import type { Queue } from "bullmq";
4
+ import { type JobRunnerScope } from "./job-runner-scope.ts";
5
+ import type { JobMeta } from "./job-runner-types.ts";
6
+ export declare function applyConcurrencyMode(scope: JobRunnerScope, targetQueue: Queue, jobName: string, jobDef: JobDefinition, bullOpts: Record<string, unknown>): Promise<"skipped" | undefined>;
7
+ export declare function buildEnqueueInputs(tracer: Tracer, jobDef: JobDefinition, payload: Record<string, unknown> | undefined, meta: JobMeta | undefined, bullOpts: Record<string, unknown>): Record<string, unknown>;