@cosmicdrift/kumiko-framework 0.413.0 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (467) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +64 -13
  4. package/agents/api/framework-event-store.md +14 -0
  5. package/agents/api/framework-ui-types.md +149 -21
  6. package/agents/api/renderer-web.md +93 -9
  7. package/agents/api/testing-helpers.md +3 -2
  8. package/agents/api/testing-stack.md +3 -0
  9. package/agents/api/types.md +205 -14
  10. package/agents/api.md +7 -7
  11. package/agents/boot-rules.md +63 -9
  12. package/agents/examples/api-docs.md +2 -6
  13. package/agents/examples/auth-mfa.md +57 -10
  14. package/agents/examples/chat-channels.md +2 -0
  15. package/agents/examples/currencies-global.md +1 -0
  16. package/agents/examples/env-composition.md +7 -11
  17. package/agents/examples/helpdesk.md +15 -8
  18. package/agents/examples/managed-pages.md +90 -1
  19. package/agents/examples/pwa-shell.md +210 -0
  20. package/agents/examples/rate-limiting.md +3 -3
  21. package/agents/examples/record-detail-layout.md +1537 -67
  22. package/agents/examples/workflow-engine.md +16 -12
  23. package/agents/examples.md +1 -0
  24. package/agents/features-index.md +4 -2
  25. package/agents/features.md +22 -7
  26. package/agents/widgets.md +19 -1
  27. package/dist/api/api-constants.d.ts +1 -0
  28. package/dist/api/api-constants.js +4 -0
  29. package/dist/api/auth-middleware.js +4 -3
  30. package/dist/api/auth-routes-shared.js +2 -1
  31. package/dist/api/entity-read-access.d.ts +1 -0
  32. package/dist/api/entity-read-access.js +18 -0
  33. package/dist/api/export/export-route.d.ts +6 -1
  34. package/dist/api/export/export-route.js +27 -1
  35. package/dist/api/export/export-rows.js +19 -3
  36. package/dist/api/routes.d.ts +2 -0
  37. package/dist/api/routes.js +9 -1
  38. package/dist/api/server-extra-routes.js +2 -1
  39. package/dist/api/server-feature-http-routes.d.ts +9 -0
  40. package/dist/api/server-feature-http-routes.js +109 -0
  41. package/dist/api/server-middleware.js +2 -19
  42. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  43. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  44. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  45. package/dist/api/server-rate-limit-wiring.js +37 -0
  46. package/dist/api/server-routes.d.ts +4 -12
  47. package/dist/api/server-routes.js +12 -171
  48. package/dist/api/server-schema-route.d.ts +3 -0
  49. package/dist/api/server-schema-route.js +58 -0
  50. package/dist/api/server-wiring.js +2 -37
  51. package/dist/api/server.js +3 -1
  52. package/dist/compliance/override-schema.js +5 -5
  53. package/dist/compliance/sub-processors.js +10 -1
  54. package/dist/crypto/index.d.ts +1 -1
  55. package/dist/crypto/index.js +1 -1
  56. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  57. package/dist/crypto/pii-field-encryption.js +16 -1
  58. package/dist/db/apply-entity-event.js +4 -0
  59. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  60. package/dist/db/bun-sql-connection-codes.js +7 -0
  61. package/dist/db/collect-table-metas.js +4 -1
  62. package/dist/db/config-seed.js +1 -1
  63. package/dist/db/derived-field-sql.js +15 -13
  64. package/dist/db/derived-related-sql.d.ts +2 -2
  65. package/dist/db/derived-related-sql.js +4 -2
  66. package/dist/db/dialect.d.ts +3 -0
  67. package/dist/db/dialect.js +1 -3
  68. package/dist/db/driver-row-coercion.js +2 -2
  69. package/dist/db/driver-value-preparation.js +1 -1
  70. package/dist/db/eagerload.js +15 -12
  71. package/dist/db/entity-table-meta.d.ts +2 -0
  72. package/dist/db/entity-table-meta.js +7 -0
  73. package/dist/db/event-store-executor-context.js +13 -8
  74. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  75. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  76. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  77. package/dist/db/event-store-executor-read-filter.js +28 -11
  78. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  79. package/dist/db/event-store-executor-read-search.js +6 -6
  80. package/dist/db/event-store-executor-read-sort.js +3 -3
  81. package/dist/db/event-store-executor-read-where.js +14 -5
  82. package/dist/db/event-store-executor-read.js +7 -7
  83. package/dist/db/event-store-executor-write.js +50 -95
  84. package/dist/db/executor-managed-tables.js +4 -1
  85. package/dist/db/index.d.ts +4 -2
  86. package/dist/db/index.js +4 -2
  87. package/dist/db/known-table-names.d.ts +1 -0
  88. package/dist/db/known-table-names.js +7 -5
  89. package/dist/db/list-aggregate-labels.d.ts +1 -0
  90. package/dist/db/list-aggregate-labels.js +9 -1
  91. package/dist/db/migrate-generator.js +23 -4
  92. package/dist/db/migrate-rls-diff.d.ts +1 -0
  93. package/dist/db/migrate-rls-diff.js +15 -1
  94. package/dist/db/migrate-runner.js +2 -2
  95. package/dist/db/money.d.ts +1 -1
  96. package/dist/db/money.js +1 -4
  97. package/dist/db/parent-ref-clause.d.ts +6 -2
  98. package/dist/db/parent-ref-clause.js +76 -23
  99. package/dist/db/parent-ref-global-hosts.d.ts +20 -0
  100. package/dist/db/parent-ref-global-hosts.js +47 -0
  101. package/dist/db/production-schema-command-hint.d.ts +1 -0
  102. package/dist/db/production-schema-command-hint.js +3 -0
  103. package/dist/db/queries/backfill-pii.js +55 -29
  104. package/dist/db/queries/ddl.js +13 -2
  105. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  106. package/dist/db/queries/event-store-open-streams.js +33 -0
  107. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  108. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  109. package/dist/db/queries/event-store.js +0 -1
  110. package/dist/db/queries/raw-sql.js +0 -1
  111. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  112. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  113. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  114. package/dist/db/queries/rls-boot-catalog.js +13 -8
  115. package/dist/db/queries/rls-shape.d.ts +2 -1
  116. package/dist/db/queries/rls-shape.js +10 -0
  117. package/dist/db/queries/session-advisory-lock.js +2 -1
  118. package/dist/db/queries/test-stack.js +7 -7
  119. package/dist/db/query.js +16 -11
  120. package/dist/db/rebuild-marker.js +11 -2
  121. package/dist/db/render-rls-ddl.d.ts +2 -0
  122. package/dist/db/render-rls-ddl.js +16 -11
  123. package/dist/db/replay-migration-sql.js +1 -1
  124. package/dist/db/row-level-security-boot-check.js +18 -5
  125. package/dist/db/row-level-security-connection.js +25 -12
  126. package/dist/db/row-level-security-scope.d.ts +2 -1
  127. package/dist/db/row-level-security-scope.js +9 -5
  128. package/dist/db/sql-identifier.d.ts +1 -0
  129. package/dist/db/sql-identifier.js +3 -0
  130. package/dist/db/system-tenant-read-db.d.ts +5 -0
  131. package/dist/db/system-tenant-read-db.js +28 -0
  132. package/dist/db/table-builder.d.ts +3 -1
  133. package/dist/db/table-builder.js +18 -8
  134. package/dist/db/table-info.d.ts +1 -2
  135. package/dist/db/table-introspection.d.ts +3 -0
  136. package/dist/db/table-introspection.js +6 -0
  137. package/dist/db/table-push.d.ts +1 -0
  138. package/dist/db/table-push.js +7 -1
  139. package/dist/db/tenant-db-runner.d.ts +3 -0
  140. package/dist/db/tenant-db-runner.js +19 -1
  141. package/dist/db/transaction-serialization.d.ts +1 -0
  142. package/dist/db/transaction-serialization.js +20 -3
  143. package/dist/db/where-clause.js +11 -2
  144. package/dist/db/write-ownership-failures.d.ts +25 -0
  145. package/dist/db/write-ownership-failures.js +82 -0
  146. package/dist/engine/boot-validator/boot-check.js +7 -1
  147. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  148. package/dist/engine/boot-validator/boot-phases.js +3 -2
  149. package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
  150. package/dist/engine/boot-validator/boot-rules.js +4 -0
  151. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  152. package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
  153. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  154. package/dist/engine/boot-validator/config-deps.js +0 -28
  155. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  156. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  157. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  158. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  159. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  160. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  161. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  162. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  163. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  164. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  165. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  166. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  167. package/dist/engine/boot-validator/entity-list-screens.js +33 -6
  168. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  169. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  170. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  171. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  172. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  173. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  174. package/dist/engine/boot-validator/list-row-guidance.js +129 -0
  175. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  176. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  177. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  178. package/dist/engine/boot-validator/list-sort-summary.js +149 -0
  179. package/dist/engine/boot-validator/list-table-options.js +15 -1
  180. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  181. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  182. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  183. package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
  184. package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
  185. package/dist/engine/boot-validator/named-filter-rules.js +32 -2
  186. package/dist/engine/boot-validator/ownership.js +10 -1
  187. package/dist/engine/boot-validator/parent-ref.js +87 -50
  188. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  189. package/dist/engine/boot-validator/projection-list-screens.js +31 -1
  190. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  191. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  192. package/dist/engine/boot-validator/query-output-guidance.js +39 -0
  193. package/dist/engine/boot-validator/query-refs.js +24 -1
  194. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  195. package/dist/engine/boot-validator/row-decoration.js +16 -0
  196. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  197. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  198. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  199. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  200. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  201. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  202. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  203. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  204. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  205. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  206. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  207. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  208. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  209. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  210. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  211. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  212. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  213. package/dist/engine/boot-validator/screens-lists.js +19 -3
  214. package/dist/engine/boot-validator/screens.js +1 -1
  215. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  216. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  217. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  218. package/dist/engine/boot-validator/zod-shape.js +19 -1
  219. package/dist/engine/build-app-schema.js +4 -0
  220. package/dist/engine/config-helpers.d.ts +1 -2
  221. package/dist/engine/config-helpers.js +6 -7
  222. package/dist/engine/define-feature.js +1 -0
  223. package/dist/engine/define-handler.d.ts +1 -0
  224. package/dist/engine/define-handler.js +4 -2
  225. package/dist/engine/definition-violations.js +2 -2
  226. package/dist/engine/entity-handlers.js +3 -8
  227. package/dist/engine/entity-list-runtime-options.js +9 -8
  228. package/dist/engine/factories.d.ts +2 -0
  229. package/dist/engine/feature-config-events-jobs.js +1 -0
  230. package/dist/engine/feature-entity-handlers.js +5 -2
  231. package/dist/engine/field-access.d.ts +1 -1
  232. package/dist/engine/field-access.js +7 -10
  233. package/dist/engine/find-entity.js +3 -3
  234. package/dist/engine/form-derivations.js +3 -3
  235. package/dist/engine/index.d.ts +3 -3
  236. package/dist/engine/index.js +2 -2
  237. package/dist/engine/named-filter-roles.d.ts +3 -0
  238. package/dist/engine/named-filter-roles.js +23 -0
  239. package/dist/engine/pipeline.js +0 -1
  240. package/dist/engine/project-app-schema-for-roles.js +17 -2
  241. package/dist/engine/qualified-name.js +0 -1
  242. package/dist/engine/registry-facade.js +1 -2
  243. package/dist/engine/registry-state.d.ts +1 -1
  244. package/dist/engine/registry-state.js +5 -2
  245. package/dist/engine/registry-validate.d.ts +1 -0
  246. package/dist/engine/registry-validate.js +9 -1
  247. package/dist/engine/registry.js +2 -1
  248. package/dist/engine/resolve-named-list-filters.js +5 -2
  249. package/dist/engine/schema-builder.js +6 -10
  250. package/dist/engine/screen-helpers.d.ts +12 -0
  251. package/dist/engine/screen-helpers.js +17 -1
  252. package/dist/engine/soft-delete-cleanup.js +5 -8
  253. package/dist/engine/state-machine.js +0 -1
  254. package/dist/engine/steps/_database-clock.d.ts +2 -0
  255. package/dist/engine/steps/_database-clock.js +6 -0
  256. package/dist/engine/steps/compute.js +1 -1
  257. package/dist/engine/steps/retry.js +5 -1
  258. package/dist/engine/steps/return.js +0 -1
  259. package/dist/engine/steps/wait-for-event.js +2 -1
  260. package/dist/engine/steps/wait.js +2 -1
  261. package/dist/engine/system-user.d.ts +2 -2
  262. package/dist/engine/system-user.js +2 -2
  263. package/dist/engine/types/handlers.d.ts +1 -1
  264. package/dist/engine/types/handlers.js +1 -1
  265. package/dist/engine/types/screen.d.ts +1 -1
  266. package/dist/engine/types/screen.js +1 -1
  267. package/dist/engine/webhook-contracts.d.ts +2 -3
  268. package/dist/engine/webhook-contracts.js +2 -25
  269. package/dist/engine/webhook-events.js +48 -29
  270. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  271. package/dist/engine/webhook-payload-strictness.js +53 -0
  272. package/dist/env/_zod-introspect.d.ts +1 -0
  273. package/dist/env/dry-run.d.ts +1 -1
  274. package/dist/env/dry-run.js +1 -1
  275. package/dist/env/field-meta.d.ts +4 -0
  276. package/dist/env/field-meta.js +67 -0
  277. package/dist/env/field-rules.d.ts +9 -0
  278. package/dist/env/field-rules.js +46 -0
  279. package/dist/env/index.d.ts +3 -3
  280. package/dist/env/index.js +16 -71
  281. package/dist/env/internals.d.ts +3 -0
  282. package/dist/env/internals.js +1 -2
  283. package/dist/env/required-env.d.ts +3 -1
  284. package/dist/env/required-env.js +5 -2
  285. package/dist/errors/serialize.js +2 -2
  286. package/dist/errors/write-error-info.js +0 -2
  287. package/dist/es-ops/operations-schema.js +18 -7
  288. package/dist/event-store/admin-api.js +3 -3
  289. package/dist/event-store/event-store.js +0 -3
  290. package/dist/event-store/index.d.ts +1 -0
  291. package/dist/event-store/index.js +1 -0
  292. package/dist/event-store/transfer.js +1 -1
  293. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  294. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  295. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  296. package/dist/files/bind-pending-file-refs.js +54 -27
  297. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  298. package/dist/files/create-file-ref.d.ts +4 -1
  299. package/dist/files/create-file-ref.js +14 -3
  300. package/dist/files/default-file-guard.js +4 -1
  301. package/dist/files/feature.js +1 -0
  302. package/dist/files/file-claim.d.ts +6 -0
  303. package/dist/files/file-claim.js +17 -0
  304. package/dist/files/file-field-slots.d.ts +2 -0
  305. package/dist/files/file-field-slots.js +28 -0
  306. package/dist/files/file-ref-entity.d.ts +3 -0
  307. package/dist/files/file-ref-entity.js +2 -0
  308. package/dist/files/file-ref-table.d.ts +3 -0
  309. package/dist/files/file-routes.d.ts +4 -1
  310. package/dist/files/file-routes.js +80 -16
  311. package/dist/files/in-memory-provider.d.ts +1 -1
  312. package/dist/files/in-memory-provider.js +2 -1
  313. package/dist/files/index.d.ts +1 -1
  314. package/dist/files/index.js +1 -1
  315. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  316. package/dist/files/invalid-file-ref-error.js +15 -0
  317. package/dist/files/local-provider.js +9 -2
  318. package/dist/files/provider-resolver.js +1 -1
  319. package/dist/files/rebind-file-ref.d.ts +3 -2
  320. package/dist/files/rebind-file-ref.js +24 -18
  321. package/dist/files/resolve-file-handles.d.ts +13 -0
  322. package/dist/files/resolve-file-handles.js +57 -0
  323. package/dist/files/storage-tracking.d.ts +1 -1
  324. package/dist/files/storage-tracking.js +5 -2
  325. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  326. package/dist/files/types.d.ts +4 -0
  327. package/dist/files/types.js +10 -0
  328. package/dist/files/upload-field-resolution.d.ts +1 -0
  329. package/dist/files/upload-field-resolution.js +16 -2
  330. package/dist/files/upload-ledger.js +1 -1
  331. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  332. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  333. package/dist/i18n/required-surface-keys.js +19 -4
  334. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  335. package/dist/internal/boot-rule-table-expectations.js +29 -0
  336. package/dist/internal/row-level-security.d.ts +1 -0
  337. package/dist/internal/row-level-security.js +1 -0
  338. package/dist/internal/testing.d.ts +1 -0
  339. package/dist/internal/testing.js +1 -0
  340. package/dist/jobs/index.d.ts +1 -0
  341. package/dist/jobs/index.js +1 -0
  342. package/dist/jobs/job-load-events.d.ts +10 -0
  343. package/dist/jobs/job-load-events.js +12 -0
  344. package/dist/jobs/job-runner-context.js +6 -158
  345. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  346. package/dist/jobs/job-runner-dispatch.js +57 -0
  347. package/dist/jobs/job-runner-event-triggers.js +18 -9
  348. package/dist/jobs/job-runner-execution.js +2 -2
  349. package/dist/jobs/job-runner-facets.d.ts +48 -0
  350. package/dist/jobs/job-runner-facets.js +156 -0
  351. package/dist/jobs/job-runner-gates.js +24 -12
  352. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  353. package/dist/jobs/job-runner-helpers.js +18 -3
  354. package/dist/jobs/job-runner-scope.d.ts +1 -0
  355. package/dist/jobs/job-runner-scope.js +2 -0
  356. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  357. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  358. package/dist/jobs/job-runner.js +31 -70
  359. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  360. package/dist/jobs/obliterate-job-queues.js +23 -0
  361. package/dist/lifecycle/lifecycle.js +1 -1
  362. package/dist/migrations/event-header-scrub.d.ts +11 -0
  363. package/dist/migrations/event-header-scrub.js +33 -0
  364. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  365. package/dist/migrations/event-payload-scrub.js +36 -4
  366. package/dist/migrations/index.d.ts +1 -0
  367. package/dist/migrations/index.js +2 -0
  368. package/dist/migrations/kumiko-drift.d.ts +5 -2
  369. package/dist/migrations/kumiko-drift.js +51 -14
  370. package/dist/migrations/pending-rebuilds.js +4 -5
  371. package/dist/observability/sensitive-filter.js +0 -12
  372. package/dist/pipeline/aggregate-type-removal.js +17 -4
  373. package/dist/pipeline/context-services.d.ts +2 -0
  374. package/dist/pipeline/context-services.js +5 -2
  375. package/dist/pipeline/dispatch-batch.js +4 -3
  376. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  377. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  378. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  379. package/dist/pipeline/dispatch-nested-write.js +119 -0
  380. package/dist/pipeline/dispatch-query.js +10 -3
  381. package/dist/pipeline/dispatch-scope.js +4 -3
  382. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  383. package/dist/pipeline/dispatch-shared.js +6 -38
  384. package/dist/pipeline/dispatch-write.d.ts +0 -1
  385. package/dist/pipeline/dispatch-write.js +3 -302
  386. package/dist/pipeline/dispatcher-utils.js +6 -0
  387. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  388. package/dist/pipeline/effective-system-scope.js +22 -0
  389. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  390. package/dist/pipeline/event-dispatcher-delivery.js +17 -9
  391. package/dist/pipeline/event-dispatcher.d.ts +4 -1
  392. package/dist/pipeline/event-dispatcher.js +6 -7
  393. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  394. package/dist/pipeline/handler-context-auth.js +3 -4
  395. package/dist/pipeline/handler-context-db.js +11 -4
  396. package/dist/pipeline/handler-context-dispatch.js +2 -2
  397. package/dist/pipeline/handler-context-events.d.ts +8 -3
  398. package/dist/pipeline/handler-context-events.js +20 -65
  399. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  400. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  401. package/dist/pipeline/handler-context-notify.js +2 -0
  402. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  403. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  404. package/dist/pipeline/handler-context-projection.js +39 -0
  405. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  406. package/dist/pipeline/handler-context-scope.js +14 -2
  407. package/dist/pipeline/index.d.ts +1 -1
  408. package/dist/pipeline/index.js +1 -1
  409. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  410. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  411. package/dist/pipeline/member-reader.js +4 -2
  412. package/dist/pipeline/msp-rebuild.js +1 -1
  413. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  414. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  415. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  416. package/dist/pipeline/projection-rebuild.js +16 -7
  417. package/dist/pipeline/projection-state.js +4 -6
  418. package/dist/pipeline/system-hooks.js +36 -6
  419. package/dist/pipeline/write-result-masking.js +31 -3
  420. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  421. package/dist/pipeline/write-transition-guard.js +95 -0
  422. package/dist/schema-cli/shared.d.ts +2 -0
  423. package/dist/schema-cli/shared.js +4 -2
  424. package/dist/schema-cli/validate-command.js +43 -28
  425. package/dist/search/meilisearch-adapter.js +14 -9
  426. package/dist/search/reindex-entity.d.ts +2 -0
  427. package/dist/search/reindex-entity.js +32 -4
  428. package/dist/search/reindex-tenants-search.js +20 -4
  429. package/dist/time/tz-context.js +1 -1
  430. package/dist/ui-types/card-column-roles.d.ts +4 -0
  431. package/dist/ui-types/card-column-roles.js +6 -3
  432. package/dist/ui-types/index.d.ts +2 -2
  433. package/dist/ui-types/index.js +1 -1
  434. package/dist/utils/ids.js +0 -1
  435. package/dist/utils/index.d.ts +1 -0
  436. package/dist/utils/index.js +1 -0
  437. package/dist/utils/return-path-limit.d.ts +1 -0
  438. package/dist/utils/return-path-limit.js +1 -0
  439. package/package.json +5 -3
  440. package/presets/biome-app.json +39 -21
  441. package/presets/biome-plugins/admin-api.grit +10 -0
  442. package/presets/biome-plugins/error-reasons.grit +53 -0
  443. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  444. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  445. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  446. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  447. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  448. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  449. package/presets/biome-plugins/no-date-api.grit +9 -0
  450. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  451. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  452. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  453. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  454. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  455. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  456. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  457. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  458. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  459. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  460. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  461. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  462. package/presets/biome-plugins/test-title.grit +20 -0
  463. package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
  464. package/presets/biome-rules.json +465 -0
  465. package/src/changes.json +309 -0
  466. package/dist/engine/minor-units.d.ts +0 -2
  467. package/dist/engine/minor-units.js +0 -8
@@ -66,6 +66,17 @@ async function buildBatchDocs(batch, rows, failures) {
66
66
  }
67
67
  return docs;
68
68
  }
69
+ // A crypto-shred changes no read-table column, so an unchanged version proves nothing about erasure.
70
+ async function rowHasErasedSubjectField(batch, row) {
71
+ try {
72
+ const state = await decryptSearchableSubjectFields(batch.entityName, rowToState(row, batch.fieldNames), batch.registry);
73
+ return hasErasedSearchableSubjectField(batch.entityName, state, batch.registry);
74
+ }
75
+ catch {
76
+ // skip: a row that cannot be decrypted was already reported by buildBatchDocs
77
+ return false;
78
+ }
79
+ }
69
80
  async function writeBatchDocs(searchAdapter, tenantId, docs, failures) {
70
81
  if (searchAdapter.indexBatch) {
71
82
  try {
@@ -108,8 +119,14 @@ async function reconcileWrittenBatch(batch, searchAdapter, tenantId, readRows, w
108
119
  const rewritten = await buildBatchDocs(batch, changed, failures);
109
120
  const rewrittenIds = new Set(rewritten.map((w) => w.entityId));
110
121
  const changedIds = new Set(changed.map((row) => String(row["id"])));
122
+ const erasedIds = new Set();
123
+ for (const row of live) {
124
+ const id = String(row["id"]);
125
+ if (!changedIds.has(id) && (await rowHasErasedSubjectField(batch, row)))
126
+ erasedIds.add(id);
127
+ }
111
128
  const toRemove = ids
112
- .filter((id) => !liveIds.has(id) || (changedIds.has(id) && !rewrittenIds.has(id)))
129
+ .filter((id) => !liveIds.has(id) || erasedIds.has(id) || (changedIds.has(id) && !rewrittenIds.has(id)))
113
130
  .map((entityId) => ({ entityType: batch.entityName, entityId }));
114
131
  if (toRemove.length > 0) {
115
132
  if (searchAdapter.removeBatch)
@@ -160,12 +177,22 @@ export async function reindexEntity(db, registry, searchAdapter, entityName, ten
160
177
  // entries, and the real schema problem is buried in "x failed").
161
178
  let uncheckedSchema = true;
162
179
  for (;;) {
180
+ options.signal?.throwIfAborted();
163
181
  // Keyset, not OFFSET: rows deleted or changed while the loop runs must not shift the window.
164
- const afterLastId = lastId === undefined ? "" : `AND ${quoteIdent("id")} > $3`;
182
+ const params = [tenantId, batchSize];
183
+ const extraFilters = [];
184
+ if (lastId !== undefined) {
185
+ params.push(lastId);
186
+ extraFilters.push(`AND ${quoteIdent("id")} > $${params.length}`);
187
+ }
188
+ if (options.onlyEntityId !== undefined) {
189
+ params.push(options.onlyEntityId);
190
+ extraFilters.push(`AND ${quoteIdent("id")} = $${params.length}`);
191
+ }
165
192
  const rows = await readBatchWithoutStatementTimeout(db, `SELECT * FROM ${quoteIdent(tableName)}
166
- WHERE ${quoteIdent("tenant_id")} = $1 ${deletedFilter} ${afterLastId}
193
+ WHERE ${quoteIdent("tenant_id")} = $1 ${deletedFilter} ${extraFilters.join(" ")}
167
194
  ORDER BY ${quoteIdent("id")} ASC
168
- LIMIT $2`, lastId === undefined ? [tenantId, batchSize] : [tenantId, batchSize, lastId]);
195
+ LIMIT $2`, params);
169
196
  const [firstRow] = rows;
170
197
  if (firstRow === undefined)
171
198
  break;
@@ -181,6 +208,7 @@ export async function reindexEntity(db, registry, searchAdapter, entityName, ten
181
208
  const docs = await buildBatchDocs(batch, rows, result.failures);
182
209
  result.scannedRows += rows.length;
183
210
  await options.afterBatchRead?.();
211
+ options.signal?.throwIfAborted();
184
212
  if (options.dryRun) {
185
213
  result.wouldIndexRows += docs.length;
186
214
  }
@@ -28,13 +28,21 @@ async function configureTolerant(tenantIds, registry, searchAdapter, timeoutMs,
28
28
  }
29
29
  return { configured, failedConfigures };
30
30
  }
31
+ // System-stream documents land in the system tenant's index, which needs the same configuration.
32
+ function withSystemTenantForSystemStreams(registry, tenantIds) {
33
+ if (tenantIds.includes(SYSTEM_TENANT_ID))
34
+ return tenantIds;
35
+ const hasSystemStreamSearchable = [...registry.getAllEntities()].some(([entityName, entity]) => entity.systemStream === true && isEntitySearchable(registry, entityName));
36
+ return hasSystemStreamSearchable ? [...tenantIds, SYSTEM_TENANT_ID] : tenantIds;
37
+ }
31
38
  export async function reindexTenantsSearch(db, registry, searchAdapter, options) {
32
39
  const warn = options.warn ?? ((message) => defaultLog.warn(message));
33
40
  const reindexTimeoutMs = options.timeoutMs ?? DEFAULT_REINDEX_TIMEOUT_MS;
34
41
  const dryRun = options.dryRun === true;
42
+ const configureTargets = withSystemTenantForSystemStreams(registry, options.tenantIds);
35
43
  const { configured, failedConfigures } = dryRun
36
- ? { configured: [...options.tenantIds], failedConfigures: 0 }
37
- : await configureTolerant(options.tenantIds, registry, searchAdapter, options.configureTimeoutMs ?? DEFAULT_CONFIGURE_TIMEOUT_MS, warn);
44
+ ? { configured: [...configureTargets], failedConfigures: 0 }
45
+ : await configureTolerant(configureTargets, registry, searchAdapter, options.configureTimeoutMs ?? DEFAULT_CONFIGURE_TIMEOUT_MS, warn);
38
46
  let entities = 0;
39
47
  let indexedRows = 0;
40
48
  let failedRows = 0;
@@ -43,9 +51,17 @@ export async function reindexTenantsSearch(db, registry, searchAdapter, options)
43
51
  if (!isEntitySearchable(registry, entityName))
44
52
  continue;
45
53
  entities += 1;
46
- const targetTenantIds = entity.systemStream === true ? [SYSTEM_TENANT_ID] : configured;
54
+ const targetTenantIds = entity.systemStream === true
55
+ ? configured.filter((tenantId) => tenantId === SYSTEM_TENANT_ID)
56
+ : configured.filter((tenantId) => options.tenantIds.includes(tenantId));
47
57
  for (const tenantId of targetTenantIds) {
48
- const outcome = await runWithTimeout(() => reindexEntity(db, registry, searchAdapter, entityName, tenantId, dryRun ? { dryRun } : {}), reindexTimeoutMs);
58
+ const abortOnTimeout = new AbortController();
59
+ const outcome = await runWithTimeout(() => reindexEntity(db, registry, searchAdapter, entityName, tenantId, {
60
+ signal: abortOnTimeout.signal,
61
+ ...(dryRun && { dryRun }),
62
+ }), reindexTimeoutMs);
63
+ if (!outcome.ok)
64
+ abortOnTimeout.abort();
49
65
  if (!outcome.ok) {
50
66
  failedReindexes += 1;
51
67
  warn(`[search] reindex "${entityName}" tenant=${tenantId} failed: ${messageOf(outcome.error)}`);
@@ -19,7 +19,7 @@
19
19
  // live in @cosmicdrift/kumiko-types/tz-context — only the factories are here.
20
20
  import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
21
21
  const SYSTEM_CLOCK = {
22
- now: () => Temporal.Now.instant(), // @wrapper-known semantic-alias
22
+ now: () => Temporal.Now.instant(),
23
23
  };
24
24
  /**
25
25
  * Factory: creates a TzContext for the current request.
@@ -8,9 +8,13 @@ export type CardRoleColumn = {
8
8
  readonly fileDisplay?: {
9
9
  readonly kind: string;
10
10
  };
11
+ /** A "to do" hint column: never the default card title. */
12
+ readonly hint?: unknown;
11
13
  };
12
14
  export type CardColumnRoles<C extends CardRoleColumn> = {
13
15
  readonly image: C | undefined;
16
+ /** The "to do" sentence shown above the title. */
17
+ readonly lead: C | undefined;
14
18
  readonly title: C | undefined;
15
19
  readonly status: C | undefined;
16
20
  readonly meta: readonly C[];
@@ -22,8 +22,11 @@ export function cardColumnRoles(columns) {
22
22
  const image = columns.find((col) => isImage(col) && col.hideOnNarrow !== true);
23
23
  // A narrow-hidden image must not turn into the title just because it is not the preview.
24
24
  const textColumns = columns.filter((col) => col !== image && !(isImage(col) && col.hideOnNarrow === true));
25
- const title = textColumns.find((col) => col.highlighted === true) ?? textColumns[0];
25
+ const title = textColumns.find((col) => col.highlighted === true) ??
26
+ textColumns.find((col) => col.hint === undefined) ??
27
+ textColumns[0];
26
28
  const status = textColumns.find((col) => col !== title && col.type === "select" && col.renderer === undefined);
27
- const meta = textColumns.filter((col) => col !== title && col !== status && col.hideOnNarrow !== true);
28
- return { image, title, status, meta };
29
+ const lead = textColumns.find((col) => col !== title && col !== status && col.hint !== undefined && col.hideOnNarrow !== true);
30
+ const meta = textColumns.filter((col) => col !== title && col !== status && col !== lead && col.hideOnNarrow !== true);
31
+ return { image, lead, title, status, meta };
29
32
  }
@@ -6,12 +6,12 @@ export type { FormDerivationScreen } from "../engine/form-derivations.ts";
6
6
  export { applyFormDerivations, isFormDerivationInputMode, isUnusedFallbackOperand, } from "../engine/form-derivations.ts";
7
7
  export type { ParsedRefTarget } from "../engine/parse-ref-target.ts";
8
8
  export { parseRefTarget } from "../engine/parse-ref-target.ts";
9
- export { ACTION_FORM_PSEUDO_ENTITY, availableSelectOptions, evalFieldCondition, findUnavailableSelectOptions, isExtensionEditSection, isFieldsEditSection, isFormatSpec, isRecordLocked, isUnchangedValue, isWriteFormEditSection, normalizeEditField, normalizeListColumn, resolveNavParentScreen, sectionFieldSpecs, } from "../engine/screen-helpers.ts";
9
+ export { ACTION_FORM_PSEUDO_ENTITY, availableSelectOptions, evalFieldCondition, findUnavailableSelectOptions, isExtensionEditSection, isFieldsEditSection, isFormatSpec, isRecordLocked, isUnchangedValue, isWriteFormEditSection, normalizeEditField, normalizeListColumn, pickEmptyStateText, resolveNavParentScreen, sectionFieldSpecs, } from "../engine/screen-helpers.ts";
10
10
  export type { EmbeddedDerivedCellDef, EntityDefinition, FieldDefinition, OptionsQueryPayload, SelectOptionTone, TextFieldDef, } from "../engine/types/fields.ts";
11
11
  export type { AccessRule } from "../engine/types/handlers.ts";
12
12
  export { isOpenToAllGranted, isUiAccessGranted } from "../engine/types/handlers.ts";
13
13
  export type { IconKey, NavDefinition, NavIconKey } from "../engine/types/nav.ts";
14
- export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, ActionFormScreenDefinition, ActionFormSuccessFact, ActionFormSuccessItems, ActionFormSuccessLink, ConfigEditAction, ConfigEditScreenDefinition, CustomScreenDefinition, DashboardChartMarkerKind, DashboardChartPanel, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRefresh, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, EditExtensionSection, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditScreenDefinition, EntityListFacetConfig, EntityListScreenDefinition, FieldAffix, FieldCondition, FieldFillAction, FieldIconKey, FieldRenderer, FormWidth, ListBulkAction, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListSortSpec, ListTableOptions, MetricNavigate, PlatformComponent, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSubtitlePart, RelatedListEmptyStateSpec, RelatedListEmptyStateVariant, RelatedListRowTone, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFallback, ScreenFallbackByReason, ScreenFallbackReason, ScreenSlots, ScreenVisibility, SecretMintConfirmStep, SecretMintScreenDefinition, SecretsEditScreenDefinition, ToolbarAction, } from "../engine/types/screen.ts";
14
+ export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, ActionFormScreenDefinition, ActionFormSuccessFact, ActionFormSuccessItems, ActionFormSuccessLink, ConfigEditAction, ConfigEditScreenDefinition, CustomScreenDefinition, DashboardChartMarkerKind, DashboardChartPanel, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListFooterLink, DashboardListNarrow, DashboardListPanel, DashboardListRowToneMarker, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelNarrow, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRefresh, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupLayout, DashboardStatGroupLink, DashboardStatGroupNarrow, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, EditExtensionSection, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditScreenDefinition, EntityListFacetConfig, EntityListScreenDefinition, FieldAffix, FieldCondition, FieldFillAction, FieldIconKey, FieldRenderer, FormWidth, ListBulkAction, ListColumnHint, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListRowDecoration, ListSortOption, ListSortSpec, ListTableOptions, ListTableSummaryRow, MetricNavigate, PlatformComponent, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordBannerSpec, RecordBreadcrumbItem, RecordBreadcrumbSpec, RecordHeaderSubtitlePart, RecordNotice, RecordProgress, RecordProgressSpec, RecordProgressStep, RecordStep, RecordStepsSpec, RecordSummarySpec, RelatedListEmptyStateSpec, RelatedListEmptyStateVariant, RelatedListRowTone, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFallback, ScreenFallbackByReason, ScreenFallbackReason, ScreenSlots, ScreenVisibility, SecretMintConfirmStep, SecretMintScreenDefinition, SecretsEditScreenDefinition, ToolbarAction, } from "../engine/types/screen.ts";
15
15
  export { MAX_BULK_SELECTION } from "../engine/types/screen.ts";
16
16
  export type { TargetRef } from "../engine/types/target-ref.ts";
17
17
  export type { TreeAction } from "../engine/types/tree-node.ts";
@@ -24,7 +24,7 @@ export { computeDerivedCellValue, roundDerivedCellValue, withDerivedCells, } fro
24
24
  export { findMissingConditionalRequirements, isFieldRequired, isFieldVisible, isMissingRequiredValue, } from "../engine/field-state.js";
25
25
  export { applyFormDerivations, isFormDerivationInputMode, isUnusedFallbackOperand, } from "../engine/form-derivations.js";
26
26
  export { parseRefTarget } from "../engine/parse-ref-target.js";
27
- export { ACTION_FORM_PSEUDO_ENTITY, availableSelectOptions, evalFieldCondition, findUnavailableSelectOptions, isExtensionEditSection, isFieldsEditSection, isFormatSpec, isRecordLocked, isUnchangedValue, isWriteFormEditSection, normalizeEditField, normalizeListColumn, resolveNavParentScreen, sectionFieldSpecs, } from "../engine/screen-helpers.js";
27
+ export { ACTION_FORM_PSEUDO_ENTITY, availableSelectOptions, evalFieldCondition, findUnavailableSelectOptions, isExtensionEditSection, isFieldsEditSection, isFormatSpec, isRecordLocked, isUnchangedValue, isWriteFormEditSection, normalizeEditField, normalizeListColumn, pickEmptyStateText, resolveNavParentScreen, sectionFieldSpecs, } from "../engine/screen-helpers.js";
28
28
  export { isOpenToAllGranted, isUiAccessGranted } from "../engine/types/handlers.js";
29
29
  export { MAX_BULK_SELECTION } from "../engine/types/screen.js";
30
30
  export { ACTION_FORM_ENTITY, handlerFieldLabelKey, handlerTitleKey, PROJECTION_DETAIL_ENTITY, WRITE_FORM_SECTION_ENTITY, } from "../i18n/required-surface-keys.js";
package/dist/utils/ids.js CHANGED
@@ -10,7 +10,6 @@ import { v5, v7 } from "uuid";
10
10
  // Do NOT use this for security tokens (CSRF, session, API keys). The
11
11
  // timestamp prefix leaks creation time and shrinks unpredictable
12
12
  // entropy from 122 to 74 bits — use `generateToken` from api/tokens.ts.
13
- // @wrapper-known semantic-alias
14
13
  export function generateId() {
15
14
  return v7();
16
15
  }
@@ -5,5 +5,6 @@ export { generateDeterministicId, generateId } from "./ids.ts";
5
5
  export { isPlainObject } from "./is-plain-object.ts";
6
6
  export { createLruCache, type LruCache, type LruCacheOptions } from "./lru-cache.ts";
7
7
  export { parseStringArrayJson } from "./parse-string-array-json.ts";
8
+ export { MAX_RETURN_PATH_LENGTH } from "./return-path-limit.ts";
8
9
  export { parseJsonOrThrow, parseJsonSafe } from "./safe-json.ts";
9
10
  export { parseRoles } from "./serialization.ts";
@@ -5,5 +5,6 @@ export { generateDeterministicId, generateId } from "./ids.js";
5
5
  export { isPlainObject } from "./is-plain-object.js";
6
6
  export { createLruCache } from "./lru-cache.js";
7
7
  export { parseStringArrayJson } from "./parse-string-array-json.js";
8
+ export { MAX_RETURN_PATH_LENGTH } from "./return-path-limit.js";
8
9
  export { parseJsonOrThrow, parseJsonSafe } from "./safe-json.js";
9
10
  export { parseRoles } from "./serialization.js";
@@ -0,0 +1 @@
1
+ export declare const MAX_RETURN_PATH_LENGTH = 2048;
@@ -0,0 +1 @@
1
+ export const MAX_RETURN_PATH_LENGTH = 2048;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cosmicdrift/kumiko-framework",
3
- "version": "0.413.0",
3
+ "version": "0.414.0",
4
4
  "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
5
5
  "license": "MIT",
6
6
  "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -39,6 +39,7 @@
39
39
  "default": "./dist/config/index.js"
40
40
  },
41
41
  "./biome": "./presets/biome-app.json",
42
+ "./biome-rules": "./presets/biome-rules.json",
42
43
  "./tsconfig.app.json": "./presets/tsconfig.app.json",
43
44
  "./es-ops": {
44
45
  "types": "./dist/es-ops/index.d.ts",
@@ -203,7 +204,7 @@
203
204
  "./package.json": "./package.json"
204
205
  },
205
206
  "dependencies": {
206
- "@cosmicdrift/kumiko-types": "0.413.0",
207
+ "@cosmicdrift/kumiko-types": "0.414.0",
207
208
  "bullmq": "^5.81.5",
208
209
  "hono": "^4.13.14",
209
210
  "i18next": "^26.5.12",
@@ -225,7 +226,7 @@
225
226
  }
226
227
  },
227
228
  "devDependencies": {
228
- "@cosmicdrift/kumiko-testing": "0.413.0",
229
+ "@cosmicdrift/kumiko-testing": "0.414.0",
229
230
  "bun-types": "^1.4.4",
230
231
  "fflate": "^0.8.3",
231
232
  "meilisearch": "^0.62.0",
@@ -244,6 +245,7 @@
244
245
  "default": "./dist/config/index.js"
245
246
  },
246
247
  "./biome": "./presets/biome-app.json",
248
+ "./biome-rules": "./presets/biome-rules.json",
247
249
  "./tsconfig.app.json": "./presets/tsconfig.app.json",
248
250
  "./es-ops": {
249
251
  "types": "./dist/es-ops/index.d.ts",
@@ -1,5 +1,6 @@
1
1
  {
2
2
  "$schema": "https://biomejs.dev/schemas/2.6.4/schema.json",
3
+ "extends": ["./biome-rules.json"],
3
4
  "vcs": {
4
5
  "enabled": true,
5
6
  "clientKind": "git",
@@ -31,7 +32,10 @@
31
32
  "lineEnding": "lf"
32
33
  },
33
34
  "css": {
34
- "parser": { "cssModules": false, "tailwindDirectives": true }
35
+ "parser": {
36
+ "cssModules": false,
37
+ "tailwindDirectives": true
38
+ }
35
39
  },
36
40
  "javascript": {
37
41
  "formatter": {
@@ -42,23 +46,10 @@
42
46
  "arrowParentheses": "always"
43
47
  }
44
48
  },
45
- "json": { "formatter": { "indentWidth": 2, "lineWidth": 80 } },
46
- "linter": {
47
- "enabled": true,
48
- "rules": {
49
- "preset": "recommended",
50
- "correctness": {
51
- "noUnusedVariables": "error",
52
- "noUnusedImports": "error"
53
- },
54
- "suspicious": {
55
- "noExplicitAny": "error",
56
- "noDebugger": "error",
57
- "noConsole": "warn"
58
- },
59
- "complexity": { "useLiteralKeys": "off" },
60
- "style": { "useConst": "error" },
61
- "nursery": { "noFloatingPromises": "error" }
49
+ "json": {
50
+ "formatter": {
51
+ "indentWidth": 2,
52
+ "lineWidth": 80
62
53
  }
63
54
  },
64
55
  "overrides": [
@@ -66,7 +57,9 @@
66
57
  "includes": ["bin/**", "scripts/**", "**/bin/**", "**/scripts/**"],
67
58
  "linter": {
68
59
  "rules": {
69
- "suspicious": { "noConsole": "off" }
60
+ "suspicious": {
61
+ "noConsole": "off"
62
+ }
70
63
  }
71
64
  }
72
65
  },
@@ -79,8 +72,33 @@
79
72
  ],
80
73
  "linter": {
81
74
  "rules": {
82
- "suspicious": { "noConsole": "off" },
83
- "style": { "noNonNullAssertion": "off" }
75
+ "suspicious": {
76
+ "noConsole": "off"
77
+ },
78
+ "style": {
79
+ "noNonNullAssertion": "off"
80
+ }
81
+ }
82
+ }
83
+ },
84
+ {
85
+ "includes": [
86
+ "**/bin/**/*.ts",
87
+ "**/src/**/*.ts",
88
+ "!**/bin/env.ts",
89
+ "!**/bin/server.ts",
90
+ "!**/bin/kumiko.ts",
91
+ "!**/__tests__/**",
92
+ "!**/*.test.ts",
93
+ "!**/*.integration.ts",
94
+ "!**/*.d.ts",
95
+ "!**/node_modules/**"
96
+ ],
97
+ "linter": {
98
+ "rules": {
99
+ "style": {
100
+ "noProcessEnv": "error"
101
+ }
84
102
  }
85
103
  }
86
104
  }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ or {
4
+ `$target.appendRaw($...)`,
5
+ `$target.appendRawBatch($...)`,
6
+ `appendRaw($...)`,
7
+ `appendRawBatch($...)`
8
+ } as $call where {
9
+ register_diagnostic(span=$call, message="Admin API (appendRaw/appendRawBatch) bypasses the pipeline and is only allowed in samples/*/migration/, scripts/migrations/ and the event-store admin-api itself. For domain events use ctx.events.append or a write handler.", severity="error")
10
+ }
@@ -0,0 +1,53 @@
1
+ language js
2
+
3
+ or {
4
+ `$callee($reason, $...)` where {
5
+ $callee <: or {
6
+ `UnprocessableError`,
7
+ `failUnprocessable`,
8
+ `$_.failUnprocessable`
9
+ },
10
+ $reason <: or {
11
+ JsStringLiteralExpression(),
12
+ JsTemplateExpression()
13
+ },
14
+ $reason <: r"^[\"'`][^$]*[\"'`]$",
15
+ not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
16
+ register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
17
+ },
18
+ `new UnprocessableError($reason, $...)` where {
19
+ $reason <: or {
20
+ JsStringLiteralExpression(),
21
+ JsTemplateExpression()
22
+ },
23
+ $reason <: r"^[\"'`][^$]*[\"'`]$",
24
+ not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
25
+ register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
26
+ },
27
+ JsPropertyObjectMember(name=`reason`, value=$reason) as $member where {
28
+ $reason <: or {
29
+ JsStringLiteralExpression(),
30
+ JsTemplateExpression()
31
+ },
32
+ $reason <: r"^[\"'`][^$]*[\"'`]$",
33
+ not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
34
+ not $member <: within JsPropertyObjectMember(name=or {
35
+ `openToAll`,
36
+ `escapeHatch`,
37
+ `unsafeAllTenants`,
38
+ `systemIdentity`,
39
+ `globalWrites`,
40
+ `unsafeRaw`,
41
+ `crossTenantReads`
42
+ }),
43
+ not $member <: within `$callee($...)` where {
44
+ $callee <: or {
45
+ `declareEscapeHatch`,
46
+ `withUnsafeRawGrant`,
47
+ `createTenantDb`,
48
+ `subjectForgetAfterDeleteHook`
49
+ }
50
+ },
51
+ register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
52
+ }
53
+ }
@@ -0,0 +1,18 @@
1
+ language js
2
+
3
+ or {
4
+ JsStringLiteralExpression(),
5
+ JsTemplateExpression()
6
+ } as $literal where {
7
+ $literal <: includes or {
8
+ "kumiko_events",
9
+ "read_tenant_memberships",
10
+ "KUMIKO_EVENTS",
11
+ "READ_TENANT_MEMBERSHIPS"
12
+ },
13
+ or {
14
+ $literal <: r"(?is).*(?:(?-u:\b)(?:INSERT[ \t\n\r]+INTO|UPDATE)[ \t\n\r]+.{0,2}kumiko_events(?-u:\b)).*",
15
+ $literal <: r"(?is).*(?:(?-u:\b)CREATE[ \t\n\r]+TABLE(?-u:\b)[^;]*?(?-u:\b)read_tenant_memberships(?-u:\b)).*"
16
+ },
17
+ register_diagnostic(span=$literal, message="Raw INSERT/UPDATE on kumiko_events or hand-written read_tenant_memberships DDL in a test. Seed events with append() (runSeedWritesAt for backdating) and membership rows with unsafeCreateEntityTable(db, tenantMembershipEntity) plus seedRow.", severity="error")
18
+ }
@@ -0,0 +1,22 @@
1
+ language js
2
+
3
+ or {
4
+ JsStringLiteralExpression(),
5
+ JsTemplateExpression()
6
+ } as $literal where {
7
+ $literal <: includes or {
8
+ "kumiko_events",
9
+ "kumiko_snapshots",
10
+ "kumiko_archived_streams",
11
+ "read_tenant_memberships",
12
+ "KUMIKO_EVENTS",
13
+ "KUMIKO_SNAPSHOTS",
14
+ "KUMIKO_ARCHIVED_STREAMS",
15
+ "READ_TENANT_MEMBERSHIPS"
16
+ },
17
+ or {
18
+ $literal <: r"(?is).*(?:(?-u:\b)(?:UPDATE|DELETE[ \t\n\r]+FROM|INSERT[ \t\n\r]+INTO)(?-u:\b).*?[\"'`]?(?:kumiko_events|kumiko_snapshots|kumiko_archived_streams)).*",
19
+ $literal <: r"(?is).*(?:(?-u:\b)CREATE[ \t\n\r]+TABLE(?-u:\b)[^;]*?(?-u:\b)read_tenant_memberships(?-u:\b)).*"
20
+ },
21
+ register_diagnostic(span=$literal, message="Raw SQL write on an event-store table (kumiko_events, kumiko_snapshots, kumiko_archived_streams) or hand-written read_tenant_memberships DDL. Only packages/framework/src/event-store/** may write these tables; use transferAggregateStreams for a tenant move or add an event-store primitive. In tests seed with append() (runSeedWritesAt for backdating) and unsafeCreateEntityTable(db, tenantMembershipEntity).", severity="error")
22
+ }
@@ -0,0 +1,15 @@
1
+ language js
2
+
3
+ JsPropertyObjectMember(value=$text) as $member where {
4
+ $text <: includes or {
5
+ "enant",
6
+ "ENANT",
7
+ "rganisation",
8
+ "RGANISATION"
9
+ },
10
+ $text <: or {
11
+ r"(?i)(?s).*(?:(?-u:\b)Tenants?(?-u:\b)).*",
12
+ r"(?i)(?s).*(?:(?-u:\b)organisation(?:en|s)?).*"
13
+ },
14
+ register_diagnostic(span=$member, message="German locale terminology: use Mandant instead of Tenant/Organisation (fw#2200). Role names like TenantAdmin are fine.", severity="error")
15
+ }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ JsPropertyObjectMember(value=$text) as $member where {
4
+ $text <: includes or {
5
+ "enant",
6
+ "ENANT"
7
+ },
8
+ $text <: r"(?i)(?s).*(?:(?-u:\b)tenants?(?-u:\b)).*",
9
+ register_diagnostic(span=$member, message="Locale terminology: use Organización (es), organisation (fr) or organizzazione (it) instead of the tenant loanword (fw#2200). Role names like TenantAdmin are fine.", severity="error")
10
+ }
@@ -0,0 +1,5 @@
1
+ language js
2
+
3
+ `createTestDispatcher($...)` as $call where {
4
+ register_diagnostic(span=$call, message="Integration tests run through the real stack: use setupTestStack from @cosmicdrift/kumiko-testing/stack and stack.http.writeOk/queryOk, never createTestDispatcher.", severity="error")
5
+ }
@@ -0,0 +1,7 @@
1
+ language js
2
+
3
+ TsReferenceType() as $reference where {
4
+ $reference <: includes "CSSProperties",
5
+ $reference <: r"^(?:React\.)?CSSProperties\b.*",
6
+ register_diagnostic(span=$reference, message="CSSProperties style objects bypass theme tokens and dark mode. Use widgets and theme tokens.", severity="error")
7
+ }
@@ -0,0 +1,9 @@
1
+ language js
2
+
3
+ or {
4
+ `new Date($...)` as $hit,
5
+ `$target.toISOString($...)` as $hit,
6
+ `$target.getTime($...)` as $hit
7
+ } where {
8
+ register_diagnostic(span=$hit, message="JS Date API in production code: use Temporal.Now.instant(), Temporal.Instant.from(...), .toString() or .epochMilliseconds (ctx.tz for wall-clock + IANA zone). Date.now() and Date.parse() stay allowed. See docs/plans/architecture/timezones.md.", severity="error")
9
+ }
@@ -0,0 +1,16 @@
1
+ language js
2
+
3
+ or {
4
+ `fetch($url, $...)`,
5
+ `globalThis.fetch($url, $...)`,
6
+ `window.fetch($url, $...)`
7
+ } as $call where {
8
+ not {
9
+ $url <: or {
10
+ JsStringLiteralExpression(),
11
+ JsTemplateExpression()
12
+ },
13
+ $url <: r"(?s)^[\"'`]/[^/$\\].*"
14
+ },
15
+ register_diagnostic(span=$call, message="Raw fetch() skips the SSRF policy in server code: use egress(policy)(...) from @cosmicdrift/kumiko-framework/http. In web screens use useQuery/useMutation or an API client (*.ts). A same-origin path literal (\"/api/...\") is allowed; any other exception needs a biome-ignore with a specific reason.", severity="error")
16
+ }
@@ -0,0 +1,16 @@
1
+ language js
2
+
3
+ or {
4
+ `import $_ from $source`,
5
+ `import $source`,
6
+ `export { $_ } from $source`,
7
+ `export { $_, $... } from $source`,
8
+ `export * as $_ from $source`,
9
+ `import $_ = require($source)`,
10
+ `export * from $source`,
11
+ `require($source)`,
12
+ `import($source)`
13
+ } as $hit where {
14
+ $source <: r"^[\"'`](?:node:)?fs(?:/promises)?[\"'`]$",
15
+ register_diagnostic(span=$hit, message="Direct fs import: request-derived paths passed straight to fs caused path-traversal bugs. Use FileStorageProvider (resolveContainedPath) or readBundledAsset; build/CLI/script tooling belongs under scripts/, bin/, tools/ or e2e/.", severity="error")
16
+ }
@@ -0,0 +1,9 @@
1
+ language css
2
+
3
+ CssString() as $literal where {
4
+ $literal <: includes or {
5
+ "fonts.googleapis.com",
6
+ "fonts.gstatic.com"
7
+ },
8
+ register_diagnostic(span=$literal, message="No external font CDNs (fonts.googleapis.com, fonts.gstatic.com): self-host fonts so no visitor data leaves for a third party.", severity="error")
9
+ }
@@ -0,0 +1,12 @@
1
+ language js
2
+
3
+ or {
4
+ JsStringLiteralExpression(),
5
+ JsTemplateExpression()
6
+ } as $literal where {
7
+ $literal <: includes or {
8
+ "fonts.googleapis.com",
9
+ "fonts.gstatic.com"
10
+ },
11
+ register_diagnostic(span=$literal, message="No external font CDNs (fonts.googleapis.com, fonts.gstatic.com): self-host fonts so no visitor data leaves for a third party.", severity="error")
12
+ }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ or {
4
+ `useEffect($...)`,
5
+ `useLayoutEffect($...)`,
6
+ `$namespace.useEffect($...)`,
7
+ `$namespace.useLayoutEffect($...)`
8
+ } as $hit where {
9
+ register_diagnostic(span=$hit, message="Raw useEffect/useLayoutEffect in web screens is the source of endless-rerender bugs and bypasses the framework hooks. Use useQuery (live: true for SSE), useMutation, useDisclosure or useReportStepComplete; a real DOM-integration case needs a biome-ignore with a reason.", severity="error")
10
+ }
@@ -0,0 +1,11 @@
1
+ language js
2
+
3
+ or {
4
+ `import $_ from "./index"`,
5
+ `import $_ from "./index.ts"`,
6
+ `import $_ from "."`,
7
+ `import $_ from "./"`
8
+ } as $import where {
9
+ not $import <: r"(?s)^import[ \t\n\r]+type[ \t\n\r].*",
10
+ register_diagnostic(span=$import, message="Import siblings directly (./Component), not through the folder's own barrel: barrel-importing from inside the same folder creates require cycles.", severity="error")
11
+ }
@@ -0,0 +1,7 @@
1
+ language js
2
+
3
+ JsxAttribute(name=`className`, initializer=$classes) where {
4
+ $classes <: includes "mx-auto",
5
+ $classes <: r"(?s).*(?:(?:^|[ \t\n\r\"'`:])mx-auto[ \t\n\r\"'`}](?:.*[ \t\n\r\"'`:])?max-w-|(?:^|[ \t\n\r\"'`:])max-w-.*[ \t\n\r\"'`:]mx-auto(?:$|[ \t\n\r\"'`}])).*",
6
+ register_diagnostic(span=$classes, message="Screen container classes (mx-auto + max-w-*) belong in <PageSection maxWidth> (3xl/4xl/full), not in screen code.", severity="error")
7
+ }