@cosmicdrift/kumiko-framework 0.413.1 → 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 (463) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +63 -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/managed-pages.md +90 -1
  18. package/agents/examples/pwa-shell.md +210 -0
  19. package/agents/examples/rate-limiting.md +3 -3
  20. package/agents/examples/record-detail-layout.md +1537 -67
  21. package/agents/examples/workflow-engine.md +16 -12
  22. package/agents/examples.md +1 -0
  23. package/agents/features-index.md +4 -2
  24. package/agents/features.md +22 -7
  25. package/agents/widgets.md +19 -1
  26. package/dist/api/api-constants.d.ts +1 -0
  27. package/dist/api/api-constants.js +4 -0
  28. package/dist/api/auth-middleware.js +4 -3
  29. package/dist/api/auth-routes-shared.js +2 -1
  30. package/dist/api/entity-read-access.d.ts +1 -0
  31. package/dist/api/entity-read-access.js +18 -0
  32. package/dist/api/export/export-route.d.ts +6 -1
  33. package/dist/api/export/export-route.js +27 -1
  34. package/dist/api/export/export-rows.js +19 -3
  35. package/dist/api/routes.d.ts +2 -0
  36. package/dist/api/routes.js +9 -1
  37. package/dist/api/server-extra-routes.js +2 -1
  38. package/dist/api/server-feature-http-routes.d.ts +9 -0
  39. package/dist/api/server-feature-http-routes.js +109 -0
  40. package/dist/api/server-middleware.js +2 -19
  41. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  42. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  43. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  44. package/dist/api/server-rate-limit-wiring.js +37 -0
  45. package/dist/api/server-routes.d.ts +4 -12
  46. package/dist/api/server-routes.js +12 -171
  47. package/dist/api/server-schema-route.d.ts +3 -0
  48. package/dist/api/server-schema-route.js +58 -0
  49. package/dist/api/server-wiring.js +2 -37
  50. package/dist/api/server.js +3 -1
  51. package/dist/compliance/override-schema.js +5 -5
  52. package/dist/compliance/sub-processors.js +10 -1
  53. package/dist/crypto/index.d.ts +1 -1
  54. package/dist/crypto/index.js +1 -1
  55. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  56. package/dist/crypto/pii-field-encryption.js +16 -1
  57. package/dist/db/apply-entity-event.js +4 -0
  58. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  59. package/dist/db/bun-sql-connection-codes.js +7 -0
  60. package/dist/db/collect-table-metas.js +4 -1
  61. package/dist/db/config-seed.js +1 -1
  62. package/dist/db/derived-field-sql.js +15 -13
  63. package/dist/db/derived-related-sql.d.ts +2 -2
  64. package/dist/db/derived-related-sql.js +4 -2
  65. package/dist/db/dialect.d.ts +3 -0
  66. package/dist/db/dialect.js +1 -3
  67. package/dist/db/driver-row-coercion.js +2 -2
  68. package/dist/db/driver-value-preparation.js +1 -1
  69. package/dist/db/eagerload.js +15 -12
  70. package/dist/db/entity-table-meta.d.ts +2 -0
  71. package/dist/db/entity-table-meta.js +7 -0
  72. package/dist/db/event-store-executor-context.js +13 -8
  73. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  74. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  75. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  76. package/dist/db/event-store-executor-read-filter.js +28 -11
  77. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  78. package/dist/db/event-store-executor-read-search.js +6 -6
  79. package/dist/db/event-store-executor-read-sort.js +3 -3
  80. package/dist/db/event-store-executor-read-where.js +14 -5
  81. package/dist/db/event-store-executor-read.js +7 -7
  82. package/dist/db/event-store-executor-write.js +50 -95
  83. package/dist/db/executor-managed-tables.js +4 -1
  84. package/dist/db/index.d.ts +4 -2
  85. package/dist/db/index.js +4 -2
  86. package/dist/db/known-table-names.d.ts +1 -0
  87. package/dist/db/known-table-names.js +7 -5
  88. package/dist/db/list-aggregate-labels.d.ts +1 -0
  89. package/dist/db/list-aggregate-labels.js +9 -1
  90. package/dist/db/migrate-generator.js +23 -4
  91. package/dist/db/migrate-rls-diff.d.ts +1 -0
  92. package/dist/db/migrate-rls-diff.js +15 -1
  93. package/dist/db/migrate-runner.js +2 -2
  94. package/dist/db/money.d.ts +1 -1
  95. package/dist/db/money.js +1 -4
  96. package/dist/db/parent-ref-clause.d.ts +6 -2
  97. package/dist/db/parent-ref-clause.js +76 -23
  98. package/dist/db/parent-ref-global-hosts.d.ts +20 -0
  99. package/dist/db/parent-ref-global-hosts.js +47 -0
  100. package/dist/db/production-schema-command-hint.d.ts +1 -0
  101. package/dist/db/production-schema-command-hint.js +3 -0
  102. package/dist/db/queries/backfill-pii.js +55 -29
  103. package/dist/db/queries/ddl.js +13 -2
  104. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  105. package/dist/db/queries/event-store-open-streams.js +33 -0
  106. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  107. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  108. package/dist/db/queries/event-store.js +0 -1
  109. package/dist/db/queries/raw-sql.js +0 -1
  110. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  111. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  112. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  113. package/dist/db/queries/rls-boot-catalog.js +13 -8
  114. package/dist/db/queries/rls-shape.d.ts +2 -1
  115. package/dist/db/queries/rls-shape.js +10 -0
  116. package/dist/db/queries/session-advisory-lock.js +2 -1
  117. package/dist/db/queries/test-stack.js +7 -7
  118. package/dist/db/query.js +16 -11
  119. package/dist/db/rebuild-marker.js +11 -2
  120. package/dist/db/render-rls-ddl.d.ts +2 -0
  121. package/dist/db/render-rls-ddl.js +16 -11
  122. package/dist/db/replay-migration-sql.js +1 -1
  123. package/dist/db/row-level-security-boot-check.js +18 -5
  124. package/dist/db/row-level-security-connection.js +25 -12
  125. package/dist/db/row-level-security-scope.d.ts +2 -1
  126. package/dist/db/row-level-security-scope.js +9 -5
  127. package/dist/db/sql-identifier.d.ts +1 -0
  128. package/dist/db/sql-identifier.js +3 -0
  129. package/dist/db/system-tenant-read-db.d.ts +5 -0
  130. package/dist/db/system-tenant-read-db.js +28 -0
  131. package/dist/db/table-builder.d.ts +3 -1
  132. package/dist/db/table-builder.js +18 -8
  133. package/dist/db/table-info.d.ts +1 -2
  134. package/dist/db/table-introspection.d.ts +3 -0
  135. package/dist/db/table-introspection.js +6 -0
  136. package/dist/db/table-push.d.ts +1 -0
  137. package/dist/db/table-push.js +7 -1
  138. package/dist/db/tenant-db-runner.d.ts +3 -0
  139. package/dist/db/tenant-db-runner.js +19 -1
  140. package/dist/db/transaction-serialization.d.ts +1 -0
  141. package/dist/db/transaction-serialization.js +20 -3
  142. package/dist/db/where-clause.js +11 -2
  143. package/dist/db/write-ownership-failures.d.ts +25 -0
  144. package/dist/db/write-ownership-failures.js +82 -0
  145. package/dist/engine/boot-validator/boot-check.js +7 -1
  146. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  147. package/dist/engine/boot-validator/boot-phases.js +3 -2
  148. package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
  149. package/dist/engine/boot-validator/boot-rules.js +4 -0
  150. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  151. package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
  152. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  153. package/dist/engine/boot-validator/config-deps.js +0 -28
  154. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  155. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  156. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  157. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  158. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  159. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  160. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  161. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  162. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  163. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  164. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  165. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  166. package/dist/engine/boot-validator/entity-list-screens.js +33 -6
  167. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  168. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  169. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  170. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  171. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  172. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  173. package/dist/engine/boot-validator/list-row-guidance.js +129 -0
  174. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  175. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  176. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  177. package/dist/engine/boot-validator/list-sort-summary.js +149 -0
  178. package/dist/engine/boot-validator/list-table-options.js +15 -1
  179. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  180. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  181. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  182. package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
  183. package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
  184. package/dist/engine/boot-validator/named-filter-rules.js +32 -2
  185. package/dist/engine/boot-validator/ownership.js +10 -1
  186. package/dist/engine/boot-validator/parent-ref.js +87 -50
  187. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  188. package/dist/engine/boot-validator/projection-list-screens.js +31 -1
  189. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  190. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  191. package/dist/engine/boot-validator/query-output-guidance.js +39 -0
  192. package/dist/engine/boot-validator/query-refs.js +24 -1
  193. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  194. package/dist/engine/boot-validator/row-decoration.js +16 -0
  195. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  196. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  197. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  198. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  199. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  200. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  201. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  202. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  203. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  204. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  205. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  206. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  207. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  208. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  209. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  210. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  211. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  212. package/dist/engine/boot-validator/screens-lists.js +19 -3
  213. package/dist/engine/boot-validator/screens.js +1 -1
  214. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  215. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  216. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  217. package/dist/engine/boot-validator/zod-shape.js +19 -1
  218. package/dist/engine/build-app-schema.js +4 -0
  219. package/dist/engine/config-helpers.d.ts +1 -2
  220. package/dist/engine/config-helpers.js +6 -7
  221. package/dist/engine/define-feature.js +1 -0
  222. package/dist/engine/define-handler.d.ts +1 -0
  223. package/dist/engine/define-handler.js +4 -2
  224. package/dist/engine/definition-violations.js +2 -2
  225. package/dist/engine/entity-handlers.js +3 -8
  226. package/dist/engine/entity-list-runtime-options.js +9 -8
  227. package/dist/engine/factories.d.ts +2 -0
  228. package/dist/engine/feature-config-events-jobs.js +1 -0
  229. package/dist/engine/feature-entity-handlers.js +5 -2
  230. package/dist/engine/field-access.d.ts +1 -1
  231. package/dist/engine/field-access.js +7 -10
  232. package/dist/engine/find-entity.js +3 -3
  233. package/dist/engine/form-derivations.js +3 -3
  234. package/dist/engine/index.d.ts +3 -3
  235. package/dist/engine/index.js +2 -2
  236. package/dist/engine/named-filter-roles.d.ts +3 -0
  237. package/dist/engine/named-filter-roles.js +23 -0
  238. package/dist/engine/pipeline.js +0 -1
  239. package/dist/engine/project-app-schema-for-roles.js +17 -2
  240. package/dist/engine/qualified-name.js +0 -1
  241. package/dist/engine/registry-facade.js +1 -2
  242. package/dist/engine/registry-state.d.ts +1 -1
  243. package/dist/engine/registry-state.js +5 -2
  244. package/dist/engine/registry-validate.js +2 -1
  245. package/dist/engine/resolve-named-list-filters.js +5 -2
  246. package/dist/engine/schema-builder.js +6 -10
  247. package/dist/engine/screen-helpers.d.ts +12 -0
  248. package/dist/engine/screen-helpers.js +17 -1
  249. package/dist/engine/soft-delete-cleanup.js +1 -5
  250. package/dist/engine/state-machine.js +0 -1
  251. package/dist/engine/steps/_database-clock.d.ts +2 -0
  252. package/dist/engine/steps/_database-clock.js +6 -0
  253. package/dist/engine/steps/compute.js +1 -1
  254. package/dist/engine/steps/retry.js +5 -1
  255. package/dist/engine/steps/return.js +0 -1
  256. package/dist/engine/steps/wait-for-event.js +2 -1
  257. package/dist/engine/steps/wait.js +2 -1
  258. package/dist/engine/system-user.d.ts +2 -2
  259. package/dist/engine/system-user.js +2 -2
  260. package/dist/engine/types/handlers.d.ts +1 -1
  261. package/dist/engine/types/handlers.js +1 -1
  262. package/dist/engine/types/screen.d.ts +1 -1
  263. package/dist/engine/types/screen.js +1 -1
  264. package/dist/engine/webhook-contracts.d.ts +2 -3
  265. package/dist/engine/webhook-contracts.js +2 -25
  266. package/dist/engine/webhook-events.js +48 -29
  267. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  268. package/dist/engine/webhook-payload-strictness.js +53 -0
  269. package/dist/env/_zod-introspect.d.ts +1 -0
  270. package/dist/env/dry-run.d.ts +1 -1
  271. package/dist/env/dry-run.js +1 -1
  272. package/dist/env/field-meta.d.ts +4 -0
  273. package/dist/env/field-meta.js +67 -0
  274. package/dist/env/field-rules.d.ts +9 -0
  275. package/dist/env/field-rules.js +46 -0
  276. package/dist/env/index.d.ts +3 -3
  277. package/dist/env/index.js +16 -71
  278. package/dist/env/internals.d.ts +3 -0
  279. package/dist/env/internals.js +1 -2
  280. package/dist/env/required-env.d.ts +3 -1
  281. package/dist/env/required-env.js +5 -2
  282. package/dist/errors/serialize.js +2 -2
  283. package/dist/errors/write-error-info.js +0 -2
  284. package/dist/es-ops/operations-schema.js +18 -7
  285. package/dist/event-store/admin-api.js +3 -3
  286. package/dist/event-store/event-store.js +0 -3
  287. package/dist/event-store/index.d.ts +1 -0
  288. package/dist/event-store/index.js +1 -0
  289. package/dist/event-store/transfer.js +1 -1
  290. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  291. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  292. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  293. package/dist/files/bind-pending-file-refs.js +54 -27
  294. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  295. package/dist/files/create-file-ref.d.ts +4 -1
  296. package/dist/files/create-file-ref.js +14 -3
  297. package/dist/files/default-file-guard.js +4 -1
  298. package/dist/files/file-claim.d.ts +6 -0
  299. package/dist/files/file-claim.js +17 -0
  300. package/dist/files/file-field-slots.d.ts +2 -0
  301. package/dist/files/file-field-slots.js +28 -0
  302. package/dist/files/file-ref-entity.d.ts +3 -0
  303. package/dist/files/file-ref-entity.js +2 -0
  304. package/dist/files/file-ref-table.d.ts +3 -0
  305. package/dist/files/file-routes.d.ts +4 -1
  306. package/dist/files/file-routes.js +80 -16
  307. package/dist/files/in-memory-provider.d.ts +1 -1
  308. package/dist/files/in-memory-provider.js +2 -1
  309. package/dist/files/index.d.ts +1 -1
  310. package/dist/files/index.js +1 -1
  311. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  312. package/dist/files/invalid-file-ref-error.js +15 -0
  313. package/dist/files/local-provider.js +9 -2
  314. package/dist/files/provider-resolver.js +1 -1
  315. package/dist/files/rebind-file-ref.d.ts +3 -2
  316. package/dist/files/rebind-file-ref.js +24 -18
  317. package/dist/files/resolve-file-handles.d.ts +13 -0
  318. package/dist/files/resolve-file-handles.js +57 -0
  319. package/dist/files/storage-tracking.d.ts +1 -1
  320. package/dist/files/storage-tracking.js +5 -2
  321. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  322. package/dist/files/types.d.ts +4 -0
  323. package/dist/files/types.js +10 -0
  324. package/dist/files/upload-field-resolution.d.ts +1 -0
  325. package/dist/files/upload-field-resolution.js +16 -2
  326. package/dist/files/upload-ledger.js +1 -1
  327. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  328. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  329. package/dist/i18n/required-surface-keys.js +19 -4
  330. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  331. package/dist/internal/boot-rule-table-expectations.js +29 -0
  332. package/dist/internal/row-level-security.d.ts +1 -0
  333. package/dist/internal/row-level-security.js +1 -0
  334. package/dist/internal/testing.d.ts +1 -0
  335. package/dist/internal/testing.js +1 -0
  336. package/dist/jobs/index.d.ts +1 -0
  337. package/dist/jobs/index.js +1 -0
  338. package/dist/jobs/job-load-events.d.ts +10 -0
  339. package/dist/jobs/job-load-events.js +12 -0
  340. package/dist/jobs/job-runner-context.js +6 -158
  341. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  342. package/dist/jobs/job-runner-dispatch.js +57 -0
  343. package/dist/jobs/job-runner-event-triggers.js +18 -9
  344. package/dist/jobs/job-runner-execution.js +2 -2
  345. package/dist/jobs/job-runner-facets.d.ts +48 -0
  346. package/dist/jobs/job-runner-facets.js +156 -0
  347. package/dist/jobs/job-runner-gates.js +19 -11
  348. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  349. package/dist/jobs/job-runner-helpers.js +18 -3
  350. package/dist/jobs/job-runner-scope.d.ts +1 -0
  351. package/dist/jobs/job-runner-scope.js +2 -0
  352. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  353. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  354. package/dist/jobs/job-runner.js +31 -70
  355. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  356. package/dist/jobs/obliterate-job-queues.js +23 -0
  357. package/dist/lifecycle/lifecycle.js +1 -1
  358. package/dist/migrations/event-header-scrub.d.ts +11 -0
  359. package/dist/migrations/event-header-scrub.js +33 -0
  360. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  361. package/dist/migrations/event-payload-scrub.js +36 -4
  362. package/dist/migrations/index.d.ts +1 -0
  363. package/dist/migrations/index.js +2 -0
  364. package/dist/migrations/kumiko-drift.d.ts +5 -2
  365. package/dist/migrations/kumiko-drift.js +51 -14
  366. package/dist/migrations/pending-rebuilds.js +4 -5
  367. package/dist/observability/sensitive-filter.js +0 -12
  368. package/dist/pipeline/aggregate-type-removal.js +17 -4
  369. package/dist/pipeline/context-services.d.ts +2 -0
  370. package/dist/pipeline/context-services.js +5 -2
  371. package/dist/pipeline/dispatch-batch.js +4 -3
  372. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  373. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  374. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  375. package/dist/pipeline/dispatch-nested-write.js +119 -0
  376. package/dist/pipeline/dispatch-query.js +10 -3
  377. package/dist/pipeline/dispatch-scope.js +4 -3
  378. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  379. package/dist/pipeline/dispatch-shared.js +6 -38
  380. package/dist/pipeline/dispatch-write.d.ts +0 -1
  381. package/dist/pipeline/dispatch-write.js +3 -302
  382. package/dist/pipeline/dispatcher-utils.js +6 -0
  383. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  384. package/dist/pipeline/effective-system-scope.js +22 -0
  385. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  386. package/dist/pipeline/event-dispatcher-delivery.js +17 -9
  387. package/dist/pipeline/event-dispatcher.d.ts +4 -1
  388. package/dist/pipeline/event-dispatcher.js +6 -7
  389. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  390. package/dist/pipeline/handler-context-auth.js +3 -4
  391. package/dist/pipeline/handler-context-db.js +11 -4
  392. package/dist/pipeline/handler-context-dispatch.js +2 -2
  393. package/dist/pipeline/handler-context-events.d.ts +8 -3
  394. package/dist/pipeline/handler-context-events.js +20 -65
  395. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  396. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  397. package/dist/pipeline/handler-context-notify.js +2 -0
  398. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  399. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  400. package/dist/pipeline/handler-context-projection.js +39 -0
  401. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  402. package/dist/pipeline/handler-context-scope.js +14 -2
  403. package/dist/pipeline/index.d.ts +1 -1
  404. package/dist/pipeline/index.js +1 -1
  405. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  406. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  407. package/dist/pipeline/member-reader.js +4 -2
  408. package/dist/pipeline/msp-rebuild.js +1 -1
  409. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  410. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  411. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  412. package/dist/pipeline/projection-rebuild.js +16 -7
  413. package/dist/pipeline/projection-state.js +4 -6
  414. package/dist/pipeline/system-hooks.js +36 -6
  415. package/dist/pipeline/write-result-masking.js +31 -3
  416. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  417. package/dist/pipeline/write-transition-guard.js +95 -0
  418. package/dist/schema-cli/shared.d.ts +2 -0
  419. package/dist/schema-cli/shared.js +4 -2
  420. package/dist/schema-cli/validate-command.js +43 -28
  421. package/dist/search/meilisearch-adapter.js +14 -9
  422. package/dist/search/reindex-entity.d.ts +2 -0
  423. package/dist/search/reindex-entity.js +32 -4
  424. package/dist/search/reindex-tenants-search.js +20 -4
  425. package/dist/time/tz-context.js +1 -1
  426. package/dist/ui-types/card-column-roles.d.ts +4 -0
  427. package/dist/ui-types/card-column-roles.js +6 -3
  428. package/dist/ui-types/index.d.ts +2 -2
  429. package/dist/ui-types/index.js +1 -1
  430. package/dist/utils/ids.js +0 -1
  431. package/dist/utils/index.d.ts +1 -0
  432. package/dist/utils/index.js +1 -0
  433. package/dist/utils/return-path-limit.d.ts +1 -0
  434. package/dist/utils/return-path-limit.js +1 -0
  435. package/package.json +5 -3
  436. package/presets/biome-app.json +39 -21
  437. package/presets/biome-plugins/admin-api.grit +10 -0
  438. package/presets/biome-plugins/error-reasons.grit +53 -0
  439. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  440. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  441. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  442. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  443. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  444. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  445. package/presets/biome-plugins/no-date-api.grit +9 -0
  446. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  447. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  448. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  449. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  450. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  451. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  452. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  453. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  454. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  455. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  456. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  457. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  458. package/presets/biome-plugins/test-title.grit +20 -0
  459. package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
  460. package/presets/biome-rules.json +465 -0
  461. package/src/changes.json +309 -0
  462. package/dist/engine/minor-units.d.ts +0 -2
  463. package/dist/engine/minor-units.js +0 -8
@@ -117,8 +117,20 @@ function searchOperationKey(op) {
117
117
  // delete-then-restore ⇒ index wins.
118
118
  async function resolveSearchOperationsByTenant(events, ctx, registry) {
119
119
  const byKey = new Map();
120
+ const unresolved = new Map();
120
121
  for (const event of events) {
121
- const op = await resolveSearchOperation(event, ctx, registry);
122
+ let op;
123
+ try {
124
+ op = await resolveSearchOperation(event, ctx, registry);
125
+ }
126
+ catch (error) {
127
+ const previous = unresolved.get(event.tenantId);
128
+ unresolved.set(event.tenantId, {
129
+ eventIds: [...(previous?.eventIds ?? []), event.id],
130
+ error: previous?.error ?? error,
131
+ });
132
+ continue;
133
+ }
122
134
  if (!op)
123
135
  continue;
124
136
  const key = searchOperationKey(op);
@@ -140,7 +152,7 @@ async function resolveSearchOperationsByTenant(events, ctx, registry) {
140
152
  else
141
153
  bucket.toRemove.push({ entityType: op.entityType, entityId: op.entityId });
142
154
  }
143
- return perTenant;
155
+ return { perTenant, unresolved };
144
156
  }
145
157
  // Flushes one tenant's collapsed ops — indexBatch/removeBatch when the
146
158
  // adapter implements them, otherwise falls back to looping the single-doc
@@ -239,14 +251,32 @@ export function createSearchEventConsumer(searchAdapter, registry, options = {})
239
251
  // One tenant's failing index must not stall the others: its failing ops are held for a later
240
252
  // turn, and while it backs off all of its ops wait, so per-entity order survives.
241
253
  batchHandler: async (events, ctx, turn) => {
242
- const perTenant = await resolveSearchOperationsByTenant(events, ctx, registry);
243
- for (const [tenantId, bucket] of perTenant) {
254
+ const { perTenant, unresolved } = await resolveSearchOperationsByTenant(events, ctx, registry);
255
+ const tenantIds = new Set([...perTenant.keys(), ...unresolved.keys()]);
256
+ for (const tenantId of tenantIds) {
257
+ const bucket = perTenant.get(tenantId);
258
+ const unresolvedOps = unresolved.get(tenantId);
244
259
  const retry = tenantRetries.get(tenantId);
245
260
  if (retry && retry.retryAtMs > now()) {
246
- turn.holdForRetry(bucket.sourcedOps.map((s) => s.sourceEventId), retry.reason);
261
+ turn.holdForRetry([
262
+ ...(bucket?.sourcedOps.map((s) => s.sourceEventId) ?? []),
263
+ ...(unresolvedOps?.eventIds ?? []),
264
+ ], retry.reason, { stillBackingOff: true });
247
265
  continue;
248
266
  }
249
- const held = await flushTenantHoldingFailedOperations(searchAdapter, tenantId, bucket);
267
+ // An unresolved event may carry an earlier op for an entity a later resolved op targets
268
+ // (update fails, delete resolves); writing the later op now would let the retry resurrect it.
269
+ const held = unresolvedOps
270
+ ? {
271
+ eventIds: [
272
+ ...unresolvedOps.eventIds,
273
+ ...(bucket?.sourcedOps.map((s) => s.sourceEventId) ?? []),
274
+ ],
275
+ error: unresolvedOps.error,
276
+ }
277
+ : bucket
278
+ ? await flushTenantHoldingFailedOperations(searchAdapter, tenantId, bucket)
279
+ : null;
250
280
  if (held) {
251
281
  turn.holdForRetry(held.eventIds, recordTenantFailure(tenantId, held));
252
282
  continue;
@@ -1,11 +1,39 @@
1
+ import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
1
2
  import { maskWriteOnlyFields } from "../engine/field-access.js";
2
3
  import { isLifecycleResult } from "./dispatcher-utils.js";
4
+ const MAX_NESTED_EVENT_STRIP_DEPTH = 8;
5
+ // A handler may nest an executor result in its own data (`{ created: inner.data }`); the
6
+ // echoed event inside it carries plaintext PII and must not reach the response either.
7
+ // Returns the input unchanged when nothing was stripped.
8
+ function stripNestedEchoedEvents(value, depth = 0) {
9
+ if (depth > MAX_NESTED_EVENT_STRIP_DEPTH)
10
+ return value;
11
+ if (Array.isArray(value)) {
12
+ const items = value.map((item) => stripNestedEchoedEvents(item, depth + 1));
13
+ return items.some((item, index) => item !== value[index]) ? items : value;
14
+ }
15
+ if (!isPlainObject(value))
16
+ return value;
17
+ const isNestedLifecycle = isLifecycleResult(value) && "event" in value;
18
+ let changed = isNestedLifecycle;
19
+ const entries = Object.entries(value).flatMap(([key, child]) => {
20
+ if (isNestedLifecycle && key === "event")
21
+ return [];
22
+ const stripped = stripNestedEchoedEvents(child, depth + 1);
23
+ if (stripped !== child)
24
+ changed = true;
25
+ return [[key, stripped]];
26
+ });
27
+ return changed ? Object.fromEntries(entries) : value;
28
+ }
3
29
  // The echoed event carries plaintext entity data; only hooks and projections may read it.
4
30
  function maskLifecycleOrRow(entity, data) {
5
- if (typeof data !== "object" || data === null || Array.isArray(data))
6
- return data;
31
+ if (typeof data !== "object" || data === null || Array.isArray(data)) {
32
+ return stripNestedEchoedEvents(data);
33
+ }
7
34
  if (!isLifecycleResult(data)) {
8
- return entity ? maskWriteOnlyFields(entity, data) : data; // @cast-boundary engine-payload
35
+ const row = stripNestedEchoedEvents(data);
36
+ return entity && isPlainObject(row) ? maskWriteOnlyFields(entity, row) : row;
9
37
  }
10
38
  const { event: _event, ...lifecycle } = data;
11
39
  if (!entity)
@@ -0,0 +1,7 @@
1
+ import type { WriteHandlerDef } from "@cosmicdrift/kumiko-types/handlers";
2
+ import type { DbTx } from "../db/connection.ts";
3
+ import type { HandlerContext } from "../engine/types/index.ts";
4
+ import type { DispatchContext } from "./dispatch-shared.ts";
5
+ export declare function resolveTransitionGuardDb(handlerContext: HandlerContext, type: string): import("@cosmicdrift/kumiko-types/tenant-db-types").TenantDb;
6
+ export type TransitionGuardDb = ReturnType<typeof resolveTransitionGuardDb>;
7
+ export declare function guardAutoTransitions(ctx: DispatchContext, handler: WriteHandlerDef, type: string, parsedPayload: unknown, transitionGuardDb: TransitionGuardDb, tx: DbTx | undefined): Promise<void>;
@@ -0,0 +1,95 @@
1
+ import { selectRowForUpdateById } from "../db/queries/entity-read.js";
2
+ import { asEntityTableMeta, selectMany } from "../db/query.js";
3
+ import { toSnakeCase } from "../db/table-builder.js";
4
+ import { tenantDbRunner } from "../db/tenant-db-runner.js";
5
+ import { defineTransitions, guardTransition } from "../engine/state-machine.js";
6
+ import { getTable } from "./dispatch-context-helpers.js";
7
+ function getTransitions(ctx, args) {
8
+ const { transitionCache } = ctx;
9
+ // Scope by entity — `fieldName` alone collides across entities (e.g. both
10
+ // `invoice.status` and `driverOrder.status` exist with different maps),
11
+ // which would apply the wrong transition rules to whichever entity arrives
12
+ // second.
13
+ const key = `${args.entityName}:${args.fieldName}`;
14
+ const cached = transitionCache.get(key);
15
+ if (cached)
16
+ return cached;
17
+ const transitions = defineTransitions(args.map);
18
+ transitionCache.set(key, transitions);
19
+ return transitions;
20
+ }
21
+ // Reads via the guard's own db handle — for r.systemScope() handlers
22
+ // handlerContext.db is fail-closed, so this reaches for
23
+ // systemDb.acknowledgeCrossTenant like any other framework-internal
24
+ // mechanism that touches a system-scoped handler's data.
25
+ export function resolveTransitionGuardDb(handlerContext, type) {
26
+ return handlerContext.systemDb
27
+ ? handlerContext.systemDb.acknowledgeCrossTenant(`auto transition guard for r.systemScope() write handler (${type})`)
28
+ : handlerContext.db;
29
+ }
30
+ // Auto transition guard: if entity has transitions and handler doesn't skip it.
31
+ export async function guardAutoTransitions(ctx, handler, type, parsedPayload, transitionGuardDb, tx) {
32
+ const entityName = ctx.registry.getHandlerEntity(type);
33
+ // skip: handler has no entity or opted out of the transition guard
34
+ if (!entityName || handler.unsafeSkipTransitionGuard)
35
+ return;
36
+ const entity = ctx.registry.getEntity(entityName);
37
+ // skip: entity declares no transitions, or there is no db to read the current value from
38
+ if (!entity?.transitions || !transitionGuardDb)
39
+ return;
40
+ const parsedData = parsedPayload; // @cast-boundary engine-payload
41
+ const changes = parsedData["changes"] ?? parsedData; // @cast-boundary engine-payload
42
+ const id = parsedData["id"] ?? undefined; // @cast-boundary engine-payload
43
+ for (const [fieldName, transitionMap] of Object.entries(entity.transitions)) {
44
+ await guardFieldTransition(ctx, {
45
+ entityName,
46
+ entity,
47
+ fieldName,
48
+ transitionMap,
49
+ changes,
50
+ id,
51
+ transitionGuardDb,
52
+ tx,
53
+ });
54
+ }
55
+ }
56
+ async function guardFieldTransition(ctx, args) {
57
+ const { entityName, entity, fieldName, transitionMap, changes, id, transitionGuardDb, tx } = args;
58
+ const newValue = changes[fieldName]; // @cast-boundary engine-bridge
59
+ // skip: field is not part of this write
60
+ if (!newValue || !id)
61
+ return;
62
+ const table = getTable(ctx, entityName);
63
+ // skip: entity has no table to read the current value from
64
+ if (!table)
65
+ return;
66
+ // SELECT FOR UPDATE inside the surrounding transaction — locks the
67
+ // row so a concurrent handler can't mutate `status` between our
68
+ // guard check and the handler's UPDATE. Without this lock the guard
69
+ // can false-pass; optimistic locking would catch it later, but with
70
+ // a less specific error. Falls back to a plain SELECT if no tx is
71
+ // active (tests without a DB connection).
72
+ const tableName = asEntityTableMeta(table)?.tableName ?? "";
73
+ const rows = tx
74
+ ? await selectRowForUpdateById(tenantDbRunner(transitionGuardDb), tableName, id)
75
+ : await selectMany(transitionGuardDb, table, { id });
76
+ const row = rows[0];
77
+ // skip: no stored row to transition from
78
+ if (!row)
79
+ return;
80
+ // Skip guard for soft-deleted rows — they shouldn't be transitioning
81
+ // at all; a handler that wants to move a deleted row should use
82
+ // unsafeSkipTransitionGuard or restore first.
83
+ const rowAsRow = row; // @cast-boundary engine-payload
84
+ const isDeleted = rowAsRow["isDeleted"] ?? rowAsRow["is_deleted"];
85
+ // skip: soft-deleted row
86
+ if (entity.softDelete && isDeleted === true) {
87
+ return;
88
+ }
89
+ const currentValue = row[fieldName] ??
90
+ row[toSnakeCase(fieldName)]; // @cast-boundary engine-bridge
91
+ // skip: an unchanged value is no transition (an edit form resends the current status)
92
+ if (currentValue === newValue)
93
+ return;
94
+ guardTransition(getTransitions(ctx, { entityName, fieldName, map: transitionMap }), currentValue, newValue);
95
+ }
@@ -49,6 +49,8 @@ export type CollectedSchemaLoad = {
49
49
  } | {
50
50
  readonly kind: "violations";
51
51
  readonly violations: readonly BootViolation[];
52
+ /** A runtime crash stopped the import, so later features were never evaluated. */
53
+ readonly importAborted?: true;
52
54
  } | {
53
55
  readonly kind: "failed";
54
56
  };
@@ -97,9 +97,11 @@ export async function loadSchemaModCollectingDefinitionViolations(ctx) {
97
97
  }
98
98
  const { thrown } = outcome;
99
99
  if (isRuntimeCrash(thrown)) {
100
+ out.err(violations.length > 0
101
+ ? ` schema.ts import stopped early: ${describeThrown(thrown)}; further violations may be missing.`
102
+ : ` ${describeThrown(thrown)}`);
100
103
  if (violations.length > 0)
101
- return { kind: "violations", violations };
102
- out.err(` ${describeThrown(thrown)}`);
104
+ return { kind: "violations", violations, importAborted: true };
103
105
  return { kind: "failed" };
104
106
  }
105
107
  if (thrown instanceof Error) {
@@ -33,7 +33,7 @@ function checkSchemaDrift(ctx, schemaMod, prevSnapshot) {
33
33
  out.err(" ✗ schema drift: entity definitions are ahead of kumiko/migrations.");
34
34
  out.err(` pending — new: ${drift.diff.newTables.length}, changed: ${drift.diff.changedTables.length}, dropped: ${drift.diff.droppedTables.length}, row level security: ${drift.rowLevelSecurityChanges.length}`);
35
35
  out.err(` tables: ${pendingTables.join(", ")}`);
36
- out.err(" Fix: `kumiko-schema generate <name>`, then commit the migration.");
36
+ out.err(" Fix: `bun kumiko-schema generate <name>`, then commit the migration.");
37
37
  return false;
38
38
  }
39
39
  function unclassifiedViolation(check, e) {
@@ -82,7 +82,13 @@ function checkBootValidity(out, schemaMod) {
82
82
  }
83
83
  function declaredTablesOf(schemaMod) {
84
84
  const names = new Set(schemaMod.entityMetas.map((meta) => meta.tableName));
85
- return { has: (tableName) => names.has(tableName) || isLiveFrameworkTable(tableName) };
85
+ const systemReadable = new Set(schemaMod.entityMetas
86
+ .filter((meta) => meta.systemRowsReadable === true)
87
+ .map((meta) => meta.tableName));
88
+ return {
89
+ has: (tableName) => names.has(tableName) || isLiveFrameworkTable(tableName),
90
+ readsSystemRows: (tableName) => systemReadable.has(tableName),
91
+ };
86
92
  }
87
93
  // 4. Live row-level security table state — the table half of the boot check. Only with a DATABASE_URL;
88
94
  // without one the command stays database-free. Scoped to the tables kumiko/schema.ts declares plus the
@@ -125,7 +131,7 @@ function reportMigrationContentMismatches(out, mismatches) {
125
131
  out.err(" Fix (unexpected-table): build a meta via `defineUnmanagedTable()` " +
126
132
  "from `@cosmicdrift/kumiko-framework/db`, then `r.storeTable(meta, { reason: ... })` " +
127
133
  "inside a feature — this adds it to ENTITY_METAS immediately; the .snapshot.json " +
128
- "only picks it up on the NEXT `kumiko-schema generate` run, which you still need " +
134
+ "only picks it up on the NEXT `bun kumiko-schema generate` run, which you still need " +
129
135
  "to run and commit. `table()` returns a query handle, not a storeTable()-compatible " +
130
136
  "meta — don't pass its result to storeTable(). See the bundled `jobs` feature's " +
131
137
  "job-run-log store table for the pattern.");
@@ -162,27 +168,28 @@ function checkMigrationContentDrift(ctx, prevSnapshot) {
162
168
  return false;
163
169
  }
164
170
  }
165
- // Static, DB-free boot-blocking checks for CI — catches "this won't boot"
166
- // before deploy. Three layers, no database:
167
- // 1. schema drift: would `generate` write a migration? (= an entity was
168
- // added/changed but never generated → missing table → prod 500)
169
- // 2. boot validity: validateBoot over the composed FEATURES (QN/screen/
170
- // nav/role refs). Runs only if kumiko/schema.ts exports FEATURES;
171
- // honours its optional VALIDATE_BOOT_OPTIONS export. `--json` prints
172
- // this result as one JSON document on stdout.
173
- // 3. migration-content drift: replay every committed *.sql file and
174
- // diff the result against .snapshot.json — catches a migration
175
- // file whose SQL body doesn't match what its own snapshot entry
176
- // claims (e.g. an accidental copy-paste from an earlier file).
177
- // Layer 1 alone misses this: it only compares ENTITY_METAS to the
178
- // snapshot, never the snapshot to the SQL that's supposed to have
179
- // produced it.
180
- // 4. live row-level security (only with DATABASE_URL): the boot's
181
- // table-state check against the real database (not the role: that is a boot-time property).
182
- // The DB-level gate (assertKumikoSchemaCurrent) stays at boot/deploy.
183
- function printBootJson(ctx, boot) {
171
+ // `ok` mirrors the exit code; `boot` stays the violation list for machine consumers.
172
+ function printValidateJson(ctx, boot, extras = {}) {
184
173
  const { ok, skipped, violations } = boot;
185
- ctx.out.log(JSON.stringify({ boot: { ok, ...(skipped ? { skipped } : {}), violations } }));
174
+ const { importAborted, checks } = extras;
175
+ const allOk = ok &&
176
+ (checks === undefined || (checks.schemaDrift && checks.migrations && checks.rowLevelSecurity));
177
+ ctx.out.log(JSON.stringify({
178
+ ok: allOk,
179
+ boot: {
180
+ ok,
181
+ ...(skipped ? { skipped } : {}),
182
+ ...(importAborted ? { importAborted } : {}),
183
+ violations,
184
+ },
185
+ ...(checks === undefined
186
+ ? {}
187
+ : {
188
+ schemaDrift: { ok: checks.schemaDrift },
189
+ migrations: { ok: checks.migrations },
190
+ rowLevelSecurity: { ok: checks.rowLevelSecurity },
191
+ }),
192
+ }));
186
193
  }
187
194
  export async function runValidateCommand(ctx) {
188
195
  const jsonMode = ctx.argv.includes("--json");
@@ -192,14 +199,15 @@ export async function runValidateCommand(ctx) {
192
199
  const loaded = await loadSchemaModCollectingDefinitionViolations(humanCtx);
193
200
  if (loaded.kind === "violations") {
194
201
  reportBootViolations(out, loaded.violations);
195
- if (jsonMode)
196
- printBootJson(ctx, { ok: false, violations: loaded.violations });
202
+ if (jsonMode) {
203
+ printValidateJson(ctx, { ok: false, violations: loaded.violations }, { ...(loaded.importAborted ? { importAborted: loaded.importAborted } : {}) });
204
+ }
197
205
  return 1;
198
206
  }
199
207
  if (loaded.kind === "failed") {
200
208
  if (jsonMode) {
201
209
  const message = "kumiko/schema.ts could not be loaded";
202
- printBootJson(ctx, {
210
+ printValidateJson(ctx, {
203
211
  ok: false,
204
212
  violations: [{ ruleId: "unclassified/loadSchemaMod", check: "loadSchemaMod", message }],
205
213
  });
@@ -212,7 +220,14 @@ export async function runValidateCommand(ctx) {
212
220
  const boot = checkBootValidity(out, schemaMod);
213
221
  const migrationsOk = checkMigrationContentDrift(humanCtx, prevSnapshot);
214
222
  const rowLevelSecurityOk = await checkLiveRowLevelSecurity(out, schemaMod);
215
- if (jsonMode)
216
- printBootJson(ctx, boot);
223
+ if (jsonMode) {
224
+ printValidateJson(ctx, boot, {
225
+ checks: {
226
+ schemaDrift: schemaOk,
227
+ migrations: migrationsOk,
228
+ rowLevelSecurity: rowLevelSecurityOk,
229
+ },
230
+ });
231
+ }
217
232
  return schemaOk && boot.ok && migrationsOk && rowLevelSecurityOk ? 0 : 1;
218
233
  }
@@ -41,6 +41,9 @@ const DEFAULT_FILTERABLE_ATTRIBUTES = [
41
41
  "_chunk",
42
42
  ];
43
43
  const DEFAULT_SORTABLE_ATTRIBUTES = ["_weight"];
44
+ // Meilisearch has no free-form index metadata, so an explicit configure() leaves this foreign
45
+ // filterable attribute behind; a later lazy default then sees a foreign attribute and keeps it.
46
+ const EXPLICIT_CONFIG_MARKER = "_explicitConfig";
44
47
  // Filters per deleteDocuments call: one task per call, and the filter string stays short.
45
48
  const DELETE_FILTER_BATCH = 100;
46
49
  function defaultSearchableAttributes(config) {
@@ -51,9 +54,8 @@ function isSubsetOf(stored, wanted) {
51
54
  return stored.every((attribute) => typeof attribute === "string" && wanted.includes(attribute));
52
55
  }
53
56
  // A stored list that lies inside the current default and misses attributes is an
54
- // older default that gained fields since; anything with a foreign attribute is
55
- // an explicit configure() and stays untouched. Known limit: an explicit configure() that
56
- // narrowed to a strict subset of the default is indistinguishable and gets widened again.
57
+ // older default that gained fields since; anything with a foreign attribute (including the
58
+ // explicit-config marker) is an explicit configure() and stays untouched.
57
59
  function isOutdatedDefault(stored, wanted, distinctMissing) {
58
60
  const pairs = [
59
61
  [stored.searchable, wanted.searchable],
@@ -137,10 +139,12 @@ export function createMeilisearchAdapter(options) {
137
139
  function isOwnTenantIndex(uid) {
138
140
  return uid.startsWith(prefix) && /^t[0-9A-Za-z-]+$/.test(uid.slice(prefix.length));
139
141
  }
140
- async function applyConfig(tenantId, config) {
142
+ async function applyConfig(tenantId, config, explicit) {
141
143
  const index = client.index(meilisearchTenantIndex(prefix, tenantId));
142
144
  await awaitSucceededTask(index.updateSearchableAttributes([...defaultSearchableAttributes(config)]));
143
- await awaitSucceededTask(index.updateFilterableAttributes([...DEFAULT_FILTERABLE_ATTRIBUTES]));
145
+ await awaitSucceededTask(index.updateFilterableAttributes(explicit
146
+ ? [...DEFAULT_FILTERABLE_ATTRIBUTES, EXPLICIT_CONFIG_MARKER]
147
+ : [...DEFAULT_FILTERABLE_ATTRIBUTES]));
144
148
  await awaitSucceededTask(index.updateSortableAttributes([...DEFAULT_SORTABLE_ATTRIBUTES]));
145
149
  await awaitSucceededTask(index.updateDistinctAttribute(DISTINCT_ATTRIBUTE));
146
150
  }
@@ -188,7 +192,8 @@ export function createMeilisearchAdapter(options) {
188
192
  // The configured-tenants map is process memory only: after a restart a stored explicit
189
193
  // configure() must not be overwritten by the registry default, so the default is applied only
190
194
  // to an index that is missing, carries Meilisearch's factory settings, or holds an older
191
- // default that is a strict subset of the current one (fields were added by a deploy).
195
+ // default that is a strict subset of the current one (fields were added by a deploy); an
196
+ // explicit configure() is told apart by EXPLICIT_CONFIG_MARKER.
192
197
  // A kept index still gets the default filterable attributes merged in: remove, purge and the
193
198
  // stale-piece delete filter on them, and an index without them rejects every delete.
194
199
  async function configActionFor(tenantId, config) {
@@ -223,7 +228,7 @@ export function createMeilisearchAdapter(options) {
223
228
  if (!defaultConfig)
224
229
  return;
225
230
  const existing = configuredTenants.get(tenantId);
226
- if (existing) {
231
+ if (existing !== undefined) {
227
232
  await existing;
228
233
  // skip: configured (or in flight) already for this tenant.
229
234
  return;
@@ -232,7 +237,7 @@ export function createMeilisearchAdapter(options) {
232
237
  await trackConfigure(tenantId, async () => {
233
238
  const action = await configActionFor(tenantId, config);
234
239
  if (action.kind === "apply-default")
235
- await applyConfig(tenantId, config);
240
+ await applyConfig(tenantId, config, false);
236
241
  if (action.kind === "add-filterable") {
237
242
  await awaitSucceededTask(client
238
243
  .index(meilisearchTenantIndex(prefix, tenantId))
@@ -269,7 +274,7 @@ export function createMeilisearchAdapter(options) {
269
274
  defaultConfig = config;
270
275
  },
271
276
  async configure(tenantId, config) {
272
- await trackConfigure(tenantId, () => applyConfig(tenantId, config));
277
+ await trackConfigure(tenantId, () => applyConfig(tenantId, config, true));
273
278
  },
274
279
  async index(tenantId, doc) {
275
280
  await ensureConfigured(tenantId);
@@ -14,6 +14,8 @@ export type ReindexEntityResult = {
14
14
  export type ReindexEntityOptions = {
15
15
  readonly batchSize?: number;
16
16
  readonly dryRun?: boolean;
17
+ readonly onlyEntityId?: string;
17
18
  readonly afterBatchRead?: () => Promise<void>;
19
+ readonly signal?: AbortSignal;
18
20
  };
19
21
  export declare function reindexEntity(db: DbRunner, registry: Registry, searchAdapter: SearchAdapter, entityName: string, tenantId: TenantId, options?: ReindexEntityOptions): Promise<ReindexEntityResult>;
@@ -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
  }