@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
@@ -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.
@@ -5,15 +5,21 @@ export type CardRoleColumn = {
5
5
  readonly type?: string;
6
6
  readonly renderer?: unknown;
7
7
  readonly hideOnNarrow?: boolean;
8
+ readonly narrowInline?: boolean;
8
9
  readonly fileDisplay?: {
9
10
  readonly kind: string;
10
11
  };
12
+ /** A "to do" hint column: never the default card title. */
13
+ readonly hint?: unknown;
11
14
  };
12
15
  export type CardColumnRoles<C extends CardRoleColumn> = {
13
16
  readonly image: C | undefined;
17
+ /** The "to do" sentence shown above the title. */
18
+ readonly lead: C | undefined;
14
19
  readonly title: C | undefined;
15
20
  readonly status: C | undefined;
16
21
  readonly meta: readonly C[];
17
22
  };
18
23
  export declare function cardFileDisplayKind(type: string | undefined, renderer: unknown): "image" | "file" | undefined;
19
24
  export declare function cardColumnRoles<C extends CardRoleColumn>(columns: readonly C[]): CardColumnRoles<C>;
25
+ export declare function cardMetaLines<C extends CardRoleColumn>(meta: readonly C[]): readonly (readonly C[])[];
@@ -22,8 +22,26 @@ 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 };
32
+ }
33
+ // A run of consecutive `narrowInline` columns shares one line; every other column has its own.
34
+ export function cardMetaLines(meta) {
35
+ const lines = [];
36
+ let previousWasInline = false;
37
+ for (const col of meta) {
38
+ const inline = col.narrowInline === true;
39
+ const last = lines[lines.length - 1];
40
+ if (inline && previousWasInline && last !== undefined)
41
+ last.push(col);
42
+ else
43
+ lines.push([col]);
44
+ previousWasInline = inline;
45
+ }
46
+ return lines;
29
47
  }
@@ -6,19 +6,19 @@ 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, ListToolbarActionsPlacement, 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";
18
18
  export type { WorkspaceDefinition } from "../engine/types/workspace.ts";
19
19
  export { ACTION_FORM_ENTITY, handlerFieldLabelKey, handlerTitleKey, PROJECTION_DETAIL_ENTITY, WRITE_FORM_SECTION_ENTITY, } from "../i18n/required-surface-keys.ts";
20
20
  export type { AppSchema, FeatureSchema, QualifiedContentCollection, WorkspaceSchema, } from "./app-schema.ts";
21
- export { CARD_META_MAX, cardColumnRoles } from "./card-column-roles.ts";
21
+ export { CARD_META_MAX, cardColumnRoles, cardMetaLines } from "./card-column-roles.ts";
22
22
  export { type Formality, formalLocaleTag } from "./formality.ts";
23
23
  export { LIST_ROW_META_COLUMNS, LIST_ROW_META_REFERENCES, REFERENCE_LOOKUP_SOURCES, SYSTEM_REFERENCE_LABELS, UNRESOLVED_REFERENCE_LABEL_KEYS, } from "./list-row-meta.ts";
24
24
  export { resolveTranslationValue, type TranslationValue, translationValueOtherText, } from "./plural.ts";
@@ -24,11 +24,11 @@ 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";
31
- export { CARD_META_MAX, cardColumnRoles } from "./card-column-roles.js";
31
+ export { CARD_META_MAX, cardColumnRoles, cardMetaLines } from "./card-column-roles.js";
32
32
  export { formalLocaleTag } from "./formality.js";
33
33
  export { LIST_ROW_META_COLUMNS, LIST_ROW_META_REFERENCES, REFERENCE_LOOKUP_SOURCES, SYSTEM_REFERENCE_LABELS, UNRESOLVED_REFERENCE_LABEL_KEYS, } from "./list-row-meta.js";
34
34
  export { resolveTranslationValue, translationValueOtherText, } from "./plural.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.1",
3
+ "version": "0.415.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.1",
207
+ "@cosmicdrift/kumiko-types": "0.415.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.1",
229
+ "@cosmicdrift/kumiko-testing": "0.415.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,11 @@
1
+ language js
2
+
3
+ or {
4
+ `new Date($...)` as $hit,
5
+ `$target.toISOString($...)` as $hit,
6
+ `$target.getTime($...)` as $hit,
7
+ `$target?.toISOString($...)` as $hit,
8
+ `$target?.getTime($...)` as $hit
9
+ } where {
10
+ 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")
11
+ }
@@ -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; in web code any other exception needs a biome-ignore with a specific reason, in server code only an entry in the reviewed security-plugin-suppression baseline.", 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
+ }
@@ -0,0 +1,34 @@
1
+ language js
2
+
3
+ or {
4
+ `$callee.skip($title, $...)` where {
5
+ $callee <: or {
6
+ `test`,
7
+ `it`,
8
+ `describe`
9
+ },
10
+ $title <: or {
11
+ JsStringLiteralExpression(),
12
+ JsTemplateExpression()
13
+ },
14
+ register_diagnostic(span=$callee, message="Unconditionally skipped test. Fix or delete it; an environment gate belongs in skipIf(condition) with the reason in the title.", severity="error")
15
+ },
16
+ `$callee($title, $fn, { $..., retry: $count, $... })` where {
17
+ $callee <: or {
18
+ `test`,
19
+ `it`,
20
+ `describe`
21
+ },
22
+ $count <: not `0`,
23
+ register_diagnostic(span=$count, message="A retry count hides a flaky test. Find the shared state or missing wait behind the flake instead.", severity="error")
24
+ },
25
+ `$callee($title, { $..., retry: $count, $... }, $fn)` where {
26
+ $callee <: or {
27
+ `test`,
28
+ `it`,
29
+ `describe`
30
+ },
31
+ $count <: not `0`,
32
+ register_diagnostic(span=$count, message="A retry count hides a flaky test. Find the shared state or missing wait behind the flake instead.", severity="error")
33
+ }
34
+ }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ or {
4
+ `require($source)`,
5
+ `import($source)`
6
+ } as $call where {
7
+ $source <: includes "temporal-polyfill",
8
+ $source <: r"^[\"'`]temporal-polyfill(?:/[^\"'`]*)?[\"'`]$",
9
+ register_diagnostic(span=$call, message="temporal-polyfill loaded by require()/import(): import { Temporal } from \"@cosmicdrift/kumiko-types/temporal\" instead — it prefers the native global, so framework and consumer share one set of Temporal classes.", severity="error")
10
+ }