@cosmicdrift/kumiko-framework 0.413.0 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (467) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +64 -13
  4. package/agents/api/framework-event-store.md +14 -0
  5. package/agents/api/framework-ui-types.md +149 -21
  6. package/agents/api/renderer-web.md +93 -9
  7. package/agents/api/testing-helpers.md +3 -2
  8. package/agents/api/testing-stack.md +3 -0
  9. package/agents/api/types.md +205 -14
  10. package/agents/api.md +7 -7
  11. package/agents/boot-rules.md +63 -9
  12. package/agents/examples/api-docs.md +2 -6
  13. package/agents/examples/auth-mfa.md +57 -10
  14. package/agents/examples/chat-channels.md +2 -0
  15. package/agents/examples/currencies-global.md +1 -0
  16. package/agents/examples/env-composition.md +7 -11
  17. package/agents/examples/helpdesk.md +15 -8
  18. package/agents/examples/managed-pages.md +90 -1
  19. package/agents/examples/pwa-shell.md +210 -0
  20. package/agents/examples/rate-limiting.md +3 -3
  21. package/agents/examples/record-detail-layout.md +1537 -67
  22. package/agents/examples/workflow-engine.md +16 -12
  23. package/agents/examples.md +1 -0
  24. package/agents/features-index.md +4 -2
  25. package/agents/features.md +22 -7
  26. package/agents/widgets.md +19 -1
  27. package/dist/api/api-constants.d.ts +1 -0
  28. package/dist/api/api-constants.js +4 -0
  29. package/dist/api/auth-middleware.js +4 -3
  30. package/dist/api/auth-routes-shared.js +2 -1
  31. package/dist/api/entity-read-access.d.ts +1 -0
  32. package/dist/api/entity-read-access.js +18 -0
  33. package/dist/api/export/export-route.d.ts +6 -1
  34. package/dist/api/export/export-route.js +27 -1
  35. package/dist/api/export/export-rows.js +19 -3
  36. package/dist/api/routes.d.ts +2 -0
  37. package/dist/api/routes.js +9 -1
  38. package/dist/api/server-extra-routes.js +2 -1
  39. package/dist/api/server-feature-http-routes.d.ts +9 -0
  40. package/dist/api/server-feature-http-routes.js +109 -0
  41. package/dist/api/server-middleware.js +2 -19
  42. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  43. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  44. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  45. package/dist/api/server-rate-limit-wiring.js +37 -0
  46. package/dist/api/server-routes.d.ts +4 -12
  47. package/dist/api/server-routes.js +12 -171
  48. package/dist/api/server-schema-route.d.ts +3 -0
  49. package/dist/api/server-schema-route.js +58 -0
  50. package/dist/api/server-wiring.js +2 -37
  51. package/dist/api/server.js +3 -1
  52. package/dist/compliance/override-schema.js +5 -5
  53. package/dist/compliance/sub-processors.js +10 -1
  54. package/dist/crypto/index.d.ts +1 -1
  55. package/dist/crypto/index.js +1 -1
  56. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  57. package/dist/crypto/pii-field-encryption.js +16 -1
  58. package/dist/db/apply-entity-event.js +4 -0
  59. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  60. package/dist/db/bun-sql-connection-codes.js +7 -0
  61. package/dist/db/collect-table-metas.js +4 -1
  62. package/dist/db/config-seed.js +1 -1
  63. package/dist/db/derived-field-sql.js +15 -13
  64. package/dist/db/derived-related-sql.d.ts +2 -2
  65. package/dist/db/derived-related-sql.js +4 -2
  66. package/dist/db/dialect.d.ts +3 -0
  67. package/dist/db/dialect.js +1 -3
  68. package/dist/db/driver-row-coercion.js +2 -2
  69. package/dist/db/driver-value-preparation.js +1 -1
  70. package/dist/db/eagerload.js +15 -12
  71. package/dist/db/entity-table-meta.d.ts +2 -0
  72. package/dist/db/entity-table-meta.js +7 -0
  73. package/dist/db/event-store-executor-context.js +13 -8
  74. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  75. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  76. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  77. package/dist/db/event-store-executor-read-filter.js +28 -11
  78. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  79. package/dist/db/event-store-executor-read-search.js +6 -6
  80. package/dist/db/event-store-executor-read-sort.js +3 -3
  81. package/dist/db/event-store-executor-read-where.js +14 -5
  82. package/dist/db/event-store-executor-read.js +7 -7
  83. package/dist/db/event-store-executor-write.js +50 -95
  84. package/dist/db/executor-managed-tables.js +4 -1
  85. package/dist/db/index.d.ts +4 -2
  86. package/dist/db/index.js +4 -2
  87. package/dist/db/known-table-names.d.ts +1 -0
  88. package/dist/db/known-table-names.js +7 -5
  89. package/dist/db/list-aggregate-labels.d.ts +1 -0
  90. package/dist/db/list-aggregate-labels.js +9 -1
  91. package/dist/db/migrate-generator.js +23 -4
  92. package/dist/db/migrate-rls-diff.d.ts +1 -0
  93. package/dist/db/migrate-rls-diff.js +15 -1
  94. package/dist/db/migrate-runner.js +2 -2
  95. package/dist/db/money.d.ts +1 -1
  96. package/dist/db/money.js +1 -4
  97. package/dist/db/parent-ref-clause.d.ts +6 -2
  98. package/dist/db/parent-ref-clause.js +76 -23
  99. package/dist/db/parent-ref-global-hosts.d.ts +20 -0
  100. package/dist/db/parent-ref-global-hosts.js +47 -0
  101. package/dist/db/production-schema-command-hint.d.ts +1 -0
  102. package/dist/db/production-schema-command-hint.js +3 -0
  103. package/dist/db/queries/backfill-pii.js +55 -29
  104. package/dist/db/queries/ddl.js +13 -2
  105. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  106. package/dist/db/queries/event-store-open-streams.js +33 -0
  107. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  108. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  109. package/dist/db/queries/event-store.js +0 -1
  110. package/dist/db/queries/raw-sql.js +0 -1
  111. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  112. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  113. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  114. package/dist/db/queries/rls-boot-catalog.js +13 -8
  115. package/dist/db/queries/rls-shape.d.ts +2 -1
  116. package/dist/db/queries/rls-shape.js +10 -0
  117. package/dist/db/queries/session-advisory-lock.js +2 -1
  118. package/dist/db/queries/test-stack.js +7 -7
  119. package/dist/db/query.js +16 -11
  120. package/dist/db/rebuild-marker.js +11 -2
  121. package/dist/db/render-rls-ddl.d.ts +2 -0
  122. package/dist/db/render-rls-ddl.js +16 -11
  123. package/dist/db/replay-migration-sql.js +1 -1
  124. package/dist/db/row-level-security-boot-check.js +18 -5
  125. package/dist/db/row-level-security-connection.js +25 -12
  126. package/dist/db/row-level-security-scope.d.ts +2 -1
  127. package/dist/db/row-level-security-scope.js +9 -5
  128. package/dist/db/sql-identifier.d.ts +1 -0
  129. package/dist/db/sql-identifier.js +3 -0
  130. package/dist/db/system-tenant-read-db.d.ts +5 -0
  131. package/dist/db/system-tenant-read-db.js +28 -0
  132. package/dist/db/table-builder.d.ts +3 -1
  133. package/dist/db/table-builder.js +18 -8
  134. package/dist/db/table-info.d.ts +1 -2
  135. package/dist/db/table-introspection.d.ts +3 -0
  136. package/dist/db/table-introspection.js +6 -0
  137. package/dist/db/table-push.d.ts +1 -0
  138. package/dist/db/table-push.js +7 -1
  139. package/dist/db/tenant-db-runner.d.ts +3 -0
  140. package/dist/db/tenant-db-runner.js +19 -1
  141. package/dist/db/transaction-serialization.d.ts +1 -0
  142. package/dist/db/transaction-serialization.js +20 -3
  143. package/dist/db/where-clause.js +11 -2
  144. package/dist/db/write-ownership-failures.d.ts +25 -0
  145. package/dist/db/write-ownership-failures.js +82 -0
  146. package/dist/engine/boot-validator/boot-check.js +7 -1
  147. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  148. package/dist/engine/boot-validator/boot-phases.js +3 -2
  149. package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
  150. package/dist/engine/boot-validator/boot-rules.js +4 -0
  151. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  152. package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
  153. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  154. package/dist/engine/boot-validator/config-deps.js +0 -28
  155. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  156. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  157. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  158. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  159. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  160. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  161. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  162. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  163. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  164. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  165. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  166. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  167. package/dist/engine/boot-validator/entity-list-screens.js +33 -6
  168. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  169. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  170. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  171. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  172. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  173. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  174. package/dist/engine/boot-validator/list-row-guidance.js +129 -0
  175. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  176. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  177. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  178. package/dist/engine/boot-validator/list-sort-summary.js +149 -0
  179. package/dist/engine/boot-validator/list-table-options.js +15 -1
  180. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  181. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  182. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  183. package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
  184. package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
  185. package/dist/engine/boot-validator/named-filter-rules.js +32 -2
  186. package/dist/engine/boot-validator/ownership.js +10 -1
  187. package/dist/engine/boot-validator/parent-ref.js +87 -50
  188. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  189. package/dist/engine/boot-validator/projection-list-screens.js +31 -1
  190. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  191. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  192. package/dist/engine/boot-validator/query-output-guidance.js +39 -0
  193. package/dist/engine/boot-validator/query-refs.js +24 -1
  194. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  195. package/dist/engine/boot-validator/row-decoration.js +16 -0
  196. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  197. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  198. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  199. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  200. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  201. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  202. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  203. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  204. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  205. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  206. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  207. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  208. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  209. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  210. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  211. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  212. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  213. package/dist/engine/boot-validator/screens-lists.js +19 -3
  214. package/dist/engine/boot-validator/screens.js +1 -1
  215. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  216. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  217. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  218. package/dist/engine/boot-validator/zod-shape.js +19 -1
  219. package/dist/engine/build-app-schema.js +4 -0
  220. package/dist/engine/config-helpers.d.ts +1 -2
  221. package/dist/engine/config-helpers.js +6 -7
  222. package/dist/engine/define-feature.js +1 -0
  223. package/dist/engine/define-handler.d.ts +1 -0
  224. package/dist/engine/define-handler.js +4 -2
  225. package/dist/engine/definition-violations.js +2 -2
  226. package/dist/engine/entity-handlers.js +3 -8
  227. package/dist/engine/entity-list-runtime-options.js +9 -8
  228. package/dist/engine/factories.d.ts +2 -0
  229. package/dist/engine/feature-config-events-jobs.js +1 -0
  230. package/dist/engine/feature-entity-handlers.js +5 -2
  231. package/dist/engine/field-access.d.ts +1 -1
  232. package/dist/engine/field-access.js +7 -10
  233. package/dist/engine/find-entity.js +3 -3
  234. package/dist/engine/form-derivations.js +3 -3
  235. package/dist/engine/index.d.ts +3 -3
  236. package/dist/engine/index.js +2 -2
  237. package/dist/engine/named-filter-roles.d.ts +3 -0
  238. package/dist/engine/named-filter-roles.js +23 -0
  239. package/dist/engine/pipeline.js +0 -1
  240. package/dist/engine/project-app-schema-for-roles.js +17 -2
  241. package/dist/engine/qualified-name.js +0 -1
  242. package/dist/engine/registry-facade.js +1 -2
  243. package/dist/engine/registry-state.d.ts +1 -1
  244. package/dist/engine/registry-state.js +5 -2
  245. package/dist/engine/registry-validate.d.ts +1 -0
  246. package/dist/engine/registry-validate.js +9 -1
  247. package/dist/engine/registry.js +2 -1
  248. package/dist/engine/resolve-named-list-filters.js +5 -2
  249. package/dist/engine/schema-builder.js +6 -10
  250. package/dist/engine/screen-helpers.d.ts +12 -0
  251. package/dist/engine/screen-helpers.js +17 -1
  252. package/dist/engine/soft-delete-cleanup.js +5 -8
  253. package/dist/engine/state-machine.js +0 -1
  254. package/dist/engine/steps/_database-clock.d.ts +2 -0
  255. package/dist/engine/steps/_database-clock.js +6 -0
  256. package/dist/engine/steps/compute.js +1 -1
  257. package/dist/engine/steps/retry.js +5 -1
  258. package/dist/engine/steps/return.js +0 -1
  259. package/dist/engine/steps/wait-for-event.js +2 -1
  260. package/dist/engine/steps/wait.js +2 -1
  261. package/dist/engine/system-user.d.ts +2 -2
  262. package/dist/engine/system-user.js +2 -2
  263. package/dist/engine/types/handlers.d.ts +1 -1
  264. package/dist/engine/types/handlers.js +1 -1
  265. package/dist/engine/types/screen.d.ts +1 -1
  266. package/dist/engine/types/screen.js +1 -1
  267. package/dist/engine/webhook-contracts.d.ts +2 -3
  268. package/dist/engine/webhook-contracts.js +2 -25
  269. package/dist/engine/webhook-events.js +48 -29
  270. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  271. package/dist/engine/webhook-payload-strictness.js +53 -0
  272. package/dist/env/_zod-introspect.d.ts +1 -0
  273. package/dist/env/dry-run.d.ts +1 -1
  274. package/dist/env/dry-run.js +1 -1
  275. package/dist/env/field-meta.d.ts +4 -0
  276. package/dist/env/field-meta.js +67 -0
  277. package/dist/env/field-rules.d.ts +9 -0
  278. package/dist/env/field-rules.js +46 -0
  279. package/dist/env/index.d.ts +3 -3
  280. package/dist/env/index.js +16 -71
  281. package/dist/env/internals.d.ts +3 -0
  282. package/dist/env/internals.js +1 -2
  283. package/dist/env/required-env.d.ts +3 -1
  284. package/dist/env/required-env.js +5 -2
  285. package/dist/errors/serialize.js +2 -2
  286. package/dist/errors/write-error-info.js +0 -2
  287. package/dist/es-ops/operations-schema.js +18 -7
  288. package/dist/event-store/admin-api.js +3 -3
  289. package/dist/event-store/event-store.js +0 -3
  290. package/dist/event-store/index.d.ts +1 -0
  291. package/dist/event-store/index.js +1 -0
  292. package/dist/event-store/transfer.js +1 -1
  293. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  294. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  295. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  296. package/dist/files/bind-pending-file-refs.js +54 -27
  297. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  298. package/dist/files/create-file-ref.d.ts +4 -1
  299. package/dist/files/create-file-ref.js +14 -3
  300. package/dist/files/default-file-guard.js +4 -1
  301. package/dist/files/feature.js +1 -0
  302. package/dist/files/file-claim.d.ts +6 -0
  303. package/dist/files/file-claim.js +17 -0
  304. package/dist/files/file-field-slots.d.ts +2 -0
  305. package/dist/files/file-field-slots.js +28 -0
  306. package/dist/files/file-ref-entity.d.ts +3 -0
  307. package/dist/files/file-ref-entity.js +2 -0
  308. package/dist/files/file-ref-table.d.ts +3 -0
  309. package/dist/files/file-routes.d.ts +4 -1
  310. package/dist/files/file-routes.js +80 -16
  311. package/dist/files/in-memory-provider.d.ts +1 -1
  312. package/dist/files/in-memory-provider.js +2 -1
  313. package/dist/files/index.d.ts +1 -1
  314. package/dist/files/index.js +1 -1
  315. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  316. package/dist/files/invalid-file-ref-error.js +15 -0
  317. package/dist/files/local-provider.js +9 -2
  318. package/dist/files/provider-resolver.js +1 -1
  319. package/dist/files/rebind-file-ref.d.ts +3 -2
  320. package/dist/files/rebind-file-ref.js +24 -18
  321. package/dist/files/resolve-file-handles.d.ts +13 -0
  322. package/dist/files/resolve-file-handles.js +57 -0
  323. package/dist/files/storage-tracking.d.ts +1 -1
  324. package/dist/files/storage-tracking.js +5 -2
  325. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  326. package/dist/files/types.d.ts +4 -0
  327. package/dist/files/types.js +10 -0
  328. package/dist/files/upload-field-resolution.d.ts +1 -0
  329. package/dist/files/upload-field-resolution.js +16 -2
  330. package/dist/files/upload-ledger.js +1 -1
  331. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  332. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  333. package/dist/i18n/required-surface-keys.js +19 -4
  334. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  335. package/dist/internal/boot-rule-table-expectations.js +29 -0
  336. package/dist/internal/row-level-security.d.ts +1 -0
  337. package/dist/internal/row-level-security.js +1 -0
  338. package/dist/internal/testing.d.ts +1 -0
  339. package/dist/internal/testing.js +1 -0
  340. package/dist/jobs/index.d.ts +1 -0
  341. package/dist/jobs/index.js +1 -0
  342. package/dist/jobs/job-load-events.d.ts +10 -0
  343. package/dist/jobs/job-load-events.js +12 -0
  344. package/dist/jobs/job-runner-context.js +6 -158
  345. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  346. package/dist/jobs/job-runner-dispatch.js +57 -0
  347. package/dist/jobs/job-runner-event-triggers.js +18 -9
  348. package/dist/jobs/job-runner-execution.js +2 -2
  349. package/dist/jobs/job-runner-facets.d.ts +48 -0
  350. package/dist/jobs/job-runner-facets.js +156 -0
  351. package/dist/jobs/job-runner-gates.js +24 -12
  352. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  353. package/dist/jobs/job-runner-helpers.js +18 -3
  354. package/dist/jobs/job-runner-scope.d.ts +1 -0
  355. package/dist/jobs/job-runner-scope.js +2 -0
  356. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  357. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  358. package/dist/jobs/job-runner.js +31 -70
  359. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  360. package/dist/jobs/obliterate-job-queues.js +23 -0
  361. package/dist/lifecycle/lifecycle.js +1 -1
  362. package/dist/migrations/event-header-scrub.d.ts +11 -0
  363. package/dist/migrations/event-header-scrub.js +33 -0
  364. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  365. package/dist/migrations/event-payload-scrub.js +36 -4
  366. package/dist/migrations/index.d.ts +1 -0
  367. package/dist/migrations/index.js +2 -0
  368. package/dist/migrations/kumiko-drift.d.ts +5 -2
  369. package/dist/migrations/kumiko-drift.js +51 -14
  370. package/dist/migrations/pending-rebuilds.js +4 -5
  371. package/dist/observability/sensitive-filter.js +0 -12
  372. package/dist/pipeline/aggregate-type-removal.js +17 -4
  373. package/dist/pipeline/context-services.d.ts +2 -0
  374. package/dist/pipeline/context-services.js +5 -2
  375. package/dist/pipeline/dispatch-batch.js +4 -3
  376. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  377. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  378. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  379. package/dist/pipeline/dispatch-nested-write.js +119 -0
  380. package/dist/pipeline/dispatch-query.js +10 -3
  381. package/dist/pipeline/dispatch-scope.js +4 -3
  382. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  383. package/dist/pipeline/dispatch-shared.js +6 -38
  384. package/dist/pipeline/dispatch-write.d.ts +0 -1
  385. package/dist/pipeline/dispatch-write.js +3 -302
  386. package/dist/pipeline/dispatcher-utils.js +6 -0
  387. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  388. package/dist/pipeline/effective-system-scope.js +22 -0
  389. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  390. package/dist/pipeline/event-dispatcher-delivery.js +17 -9
  391. package/dist/pipeline/event-dispatcher.d.ts +4 -1
  392. package/dist/pipeline/event-dispatcher.js +6 -7
  393. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  394. package/dist/pipeline/handler-context-auth.js +3 -4
  395. package/dist/pipeline/handler-context-db.js +11 -4
  396. package/dist/pipeline/handler-context-dispatch.js +2 -2
  397. package/dist/pipeline/handler-context-events.d.ts +8 -3
  398. package/dist/pipeline/handler-context-events.js +20 -65
  399. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  400. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  401. package/dist/pipeline/handler-context-notify.js +2 -0
  402. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  403. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  404. package/dist/pipeline/handler-context-projection.js +39 -0
  405. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  406. package/dist/pipeline/handler-context-scope.js +14 -2
  407. package/dist/pipeline/index.d.ts +1 -1
  408. package/dist/pipeline/index.js +1 -1
  409. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  410. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  411. package/dist/pipeline/member-reader.js +4 -2
  412. package/dist/pipeline/msp-rebuild.js +1 -1
  413. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  414. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  415. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  416. package/dist/pipeline/projection-rebuild.js +16 -7
  417. package/dist/pipeline/projection-state.js +4 -6
  418. package/dist/pipeline/system-hooks.js +36 -6
  419. package/dist/pipeline/write-result-masking.js +31 -3
  420. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  421. package/dist/pipeline/write-transition-guard.js +95 -0
  422. package/dist/schema-cli/shared.d.ts +2 -0
  423. package/dist/schema-cli/shared.js +4 -2
  424. package/dist/schema-cli/validate-command.js +43 -28
  425. package/dist/search/meilisearch-adapter.js +14 -9
  426. package/dist/search/reindex-entity.d.ts +2 -0
  427. package/dist/search/reindex-entity.js +32 -4
  428. package/dist/search/reindex-tenants-search.js +20 -4
  429. package/dist/time/tz-context.js +1 -1
  430. package/dist/ui-types/card-column-roles.d.ts +4 -0
  431. package/dist/ui-types/card-column-roles.js +6 -3
  432. package/dist/ui-types/index.d.ts +2 -2
  433. package/dist/ui-types/index.js +1 -1
  434. package/dist/utils/ids.js +0 -1
  435. package/dist/utils/index.d.ts +1 -0
  436. package/dist/utils/index.js +1 -0
  437. package/dist/utils/return-path-limit.d.ts +1 -0
  438. package/dist/utils/return-path-limit.js +1 -0
  439. package/package.json +5 -3
  440. package/presets/biome-app.json +39 -21
  441. package/presets/biome-plugins/admin-api.grit +10 -0
  442. package/presets/biome-plugins/error-reasons.grit +53 -0
  443. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  444. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  445. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  446. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  447. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  448. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  449. package/presets/biome-plugins/no-date-api.grit +9 -0
  450. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  451. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  452. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  453. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  454. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  455. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  456. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  457. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  458. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  459. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  460. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  461. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  462. package/presets/biome-plugins/test-title.grit +20 -0
  463. package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
  464. package/presets/biome-rules.json +465 -0
  465. package/src/changes.json +309 -0
  466. package/dist/engine/minor-units.d.ts +0 -2
  467. package/dist/engine/minor-units.js +0 -8
@@ -21,6 +21,8 @@ opt-in, tier-gated **custom CSS** — the framework generalization of the
21
21
  branding applied as scoped `:root` vars, custom CSS allowlist-sanitized and
22
22
  contained in a `<style data-tenant-css>` block
23
23
  - 6 integration tests proving end-to-end behavior
24
+ - A custom preview renderer for the admin editor: `src/web/branded-preview.tsx` registers its own
25
+ `contentPreviews.web` next to `managedPagesClient()`, tested in `branded-preview.test.tsx`
24
26
 
25
27
  ## Layout
26
28
 
@@ -30,8 +32,10 @@ samples/recipes/managed-pages/
30
32
  ├── README.md # this file
31
33
  └── src/
32
34
  ├── feature.ts # the composed features re-exported for tests
35
+ ├── web/branded-preview.tsx # custom `contentPreviews` renderer (client feature)
33
36
  └── __tests__/
34
- └── feature.integration.test.ts # 6 tests: render + branding + CSS
37
+ ├── feature.integration.test.ts # 6 tests: render + branding + CSS
38
+ └── branded-preview.test.tsx # custom preview renderer in the editor workbench
35
39
  ```
36
40
 
37
41
  ## Run tests
@@ -168,6 +172,65 @@ tier-gated.
168
172
 
169
173
  ## Source files
170
174
 
175
+ ### src/__tests__/branded-preview.test.tsx
176
+
177
+ ```tsx
178
+ import { afterEach, describe, expect, test } from "bun:test";
179
+ import { managedPagesClient } from "@cosmicdrift/kumiko-bundled-features/managed-pages/web";
180
+ import {
181
+ ContentPreviewsProvider,
182
+ PreviewPane,
183
+ PrimitivesProvider,
184
+ } from "@cosmicdrift/kumiko-renderer";
185
+ import { defaultPrimitives } from "@cosmicdrift/kumiko-renderer/web";
186
+ import { cleanup, render, screen } from "@testing-library/react";
187
+ import { brandedPreviewClient } from "../web/branded-preview.tsx";
188
+
189
+ afterEach(cleanup);
190
+
191
+ describe("custom preview renderer", () => {
192
+ test("the app's renderer replaces the managed-pages web preview for the same target", () => {
193
+ expect(managedPagesClient().contentPreviews?.web).toBeDefined();
194
+ expect(brandedPreviewClient().contentPreviews?.web).not.toBe(
195
+ managedPagesClient().contentPreviews?.web,
196
+ );
197
+ });
198
+
199
+ test("the workbench shows the draft body in the app's own frame", () => {
200
+ render(
201
+ <ContentPreviewsProvider value={brandedPreviewClient().contentPreviews ?? {}}>
202
+ <PreviewPane
203
+ target="web"
204
+ content="Opening hours: 8 to 18"
205
+ editFormat="plain"
206
+ variables={{}}
207
+ subject={{ kind: "body" }}
208
+ />
209
+ </ContentPreviewsProvider>,
210
+ );
211
+ expect(screen.getByTestId("branded-preview-body").textContent).toBe("Opening hours: 8 to 18");
212
+ });
213
+
214
+ test("a target the app registered no renderer for still previews as text", () => {
215
+ render(
216
+ <PrimitivesProvider value={defaultPrimitives}>
217
+ <ContentPreviewsProvider value={brandedPreviewClient().contentPreviews ?? {}}>
218
+ <PreviewPane
219
+ target="mail"
220
+ content="Mail words"
221
+ editFormat="plain"
222
+ variables={{}}
223
+ subject={{ kind: "body" }}
224
+ />
225
+ </ContentPreviewsProvider>
226
+ </PrimitivesProvider>,
227
+ );
228
+ expect(screen.queryByTestId("branded-preview")).toBeNull();
229
+ expect(screen.getByDisplayValue("Mail words")).toBeDefined();
230
+ });
231
+ });
232
+ ```
233
+
171
234
  ### src/__tests__/feature.integration.test.ts
172
235
 
173
236
  ```ts
@@ -352,3 +415,29 @@ export const managedPagesFeature = createManagedPagesFeature({
352
415
  // safety boundary regardless).
353
416
  export const managedPagesCssFeature = createManagedPagesCssFeature();
354
417
  ```
418
+
419
+ ### src/web/branded-preview.tsx
420
+
421
+ ```tsx
422
+ import type { PreviewRenderer, PreviewRendererProps } from "@cosmicdrift/kumiko-renderer";
423
+ import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
424
+ import type { ReactNode } from "react";
425
+
426
+ // A custom renderer for one preview target. The editor workbench hands it the draft content, the
427
+ // example variables and what is being edited; it decides how that looks. This one shows the body
428
+ // inside the shop's own page chrome instead of the framework's plain web frame.
429
+ const BrandedWebPreview: PreviewRenderer = ({ content }: PreviewRendererProps): ReactNode => (
430
+ <article data-testid="branded-preview" className="mx-auto max-w-[680px] border p-8">
431
+ <header className="mb-4 font-semibold tracking-wide">Acme Hardware</header>
432
+ <div data-testid="branded-preview-body" className="whitespace-pre-wrap">
433
+ {content}
434
+ </div>
435
+ </article>
436
+ );
437
+
438
+ // Registered next to managedPagesClient(): the later client feature wins the "web" target, and
439
+ // createKumikoApp logs the replacement once at boot.
440
+ export function brandedPreviewClient(): ClientFeatureDefinition {
441
+ return { name: "acme-branded-preview", contentPreviews: { web: BrandedWebPreview } };
442
+ }
443
+ ```
@@ -0,0 +1,210 @@
1
+ <!-- Generated by `bun run gen:agent-docs` from samples/recipes/pwa-shell. Do not edit. -->
2
+
3
+ # pwa-shell
4
+
5
+ pwa option on runProdApp and the dev server: web manifest, generated service worker with an offline app shell and a one-time install hint.
6
+
7
+ ## README
8
+
9
+ # PWA shell
10
+
11
+ Make the web app installable and keep its shell available offline with one `pwa`
12
+ option. Pass the same object to `runProdApp` and to the dev server (`runDevApp` or
13
+ `createKumikoServer`); without it nothing changes and no service worker is registered.
14
+
15
+ ## What it shows
16
+
17
+ - **Manifest**: `GET /manifest.webmanifest` is built from `name`, `shortName`,
18
+ `themeColor`, `backgroundColor` and `icons` (`display: standalone`, scope `/`).
19
+ `/manifest.json` stays the hashed-asset map that `kumiko build` writes.
20
+ - **Head tags**: every HTML shell gets the manifest link, `theme-color`, the Apple
21
+ home-screen tags, an `apple-touch-icon` (largest icon that is not maskable) and
22
+ `<meta name="kumiko-pwa-sw">`. The web client registers the worker only when that
23
+ meta is present.
24
+ - **Service worker**: `GET /sw.js` is generated by the server, no build step and no
25
+ external library. It precaches `/`, the manifest, the icons and the hashed bundles,
26
+ serves `/assets/*` cache-first, goes to the network first for navigations and falls
27
+ back to the cached shell only when offline. `/api/`, `/sse/`, `/auth/`, SSE streams,
28
+ non-GET and cross-origin requests never touch the cache. A new build gets a new
29
+ cache name and the old cache is dropped on activate.
30
+ - **Install hint**: a one-time banner. iOS explains Share and "Add to Home Screen",
31
+ other browsers get an Install button behind `beforeinstallprompt`. "Not now" is
32
+ remembered in `localStorage`; standalone launches never show it.
33
+
34
+ - **Base path**: an app mounted below the origin root (for example `veridom.de/a`) sets
35
+ `basePath: "/a/"`. Only the shell, manifest and worker live under it: the manifest and
36
+ worker are served at `/a/manifest.webmanifest` and `/a/sw.js`, `start_url`, `scope`, the
37
+ shell precache and the offline fallback use `/a/`, and the client registers the worker with
38
+ the scope of its directory. A worker can only control its own directory, so it must live
39
+ under the base path. `/assets/*` and the API paths (`/api`, `/sse`, `/auth`) stay at the
40
+ origin root, so the ingress must route them to the app as well (for example `/a`, `/api`
41
+ and `/assets` on veridom.de). Each base path gets its own cache name prefix, so apps on one
42
+ origin do not delete each other's precache. The boot rejects a base path that does not
43
+ start and end with `/`, has an empty, `.` or `..` segment, or contains `?` or `#`.
44
+
45
+ Icons must be same-origin paths (`/icons/...`) served from `public/` in dev and
46
+ `dist/` in production; the boot rejects anything else. The default CSP
47
+ (`default-src 'self'`) already allows the manifest and the worker.
48
+
49
+ ## Flow
50
+
51
+ 1. `src/app.ts` defines the feature and the `pwa` option.
52
+ 2. `bin/server.ts` passes both to `runProdApp` with `staticDir: "dist"`.
53
+ 3. The test boots the dev server with the same option and checks the shell tags,
54
+ the manifest and the generated worker over HTTP.
55
+
56
+ ## Run
57
+
58
+ ```bash
59
+ bun kumiko test all samples/recipes/pwa-shell/
60
+ ```
61
+
62
+ ## Source files
63
+
64
+ ### bin/server.ts
65
+
66
+ ```ts
67
+ import { composeEnvSchema } from "@cosmicdrift/kumiko-framework/env";
68
+ import { runProdApp } from "@cosmicdrift/kumiko-server-runtime";
69
+ import { notesFeature, pwa } from "../src/app";
70
+
71
+ const features = [notesFeature];
72
+
73
+ await runProdApp({
74
+ features,
75
+ envSchema: composeEnvSchema({ features }),
76
+ staticDir: "dist",
77
+ pwa,
78
+ });
79
+ ```
80
+
81
+ ### src/__tests__/pwa-shell.integration.test.ts
82
+
83
+ ```ts
84
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
85
+ import { createKumikoServer, type KumikoServerHandle } from "@cosmicdrift/kumiko-dev-server";
86
+ import { notesFeature, pwa, pwaUnderBasePath } from "../app";
87
+
88
+ let handle: KumikoServerHandle;
89
+
90
+ beforeAll(async () => {
91
+ handle = await createKumikoServer({
92
+ features: [notesFeature],
93
+ port: 0,
94
+ installSignalHandlers: false,
95
+ pwa,
96
+ });
97
+ });
98
+
99
+ afterAll(async () => {
100
+ await handle.stop();
101
+ });
102
+
103
+ const get = (path: string) => handle.fetch(new Request(`http://localhost${path}`));
104
+
105
+ describe("pwa-shell recipe", () => {
106
+ test("every app route serves the shell with manifest, theme color and worker meta", async () => {
107
+ const html = await (await get("/notes/42")).text();
108
+ expect(html).toContain('<link rel="manifest" href="/manifest.webmanifest" />');
109
+ expect(html).toContain('<meta name="theme-color" content="#14532d" />');
110
+ expect(html).toContain('<link rel="apple-touch-icon" href="/icons/icon-512.png" />');
111
+ expect(html).toContain('<meta name="kumiko-pwa-sw" content="/sw.js" />');
112
+ });
113
+
114
+ test("the manifest is built from the option", async () => {
115
+ const res = await get("/manifest.webmanifest");
116
+ expect(res.headers.get("content-type")).toBe("application/manifest+json");
117
+ expect(await res.json()).toMatchObject({
118
+ name: "Field Notes",
119
+ short_name: "Notes",
120
+ display: "standalone",
121
+ start_url: "/",
122
+ });
123
+ });
124
+
125
+ test("the worker is generated by the server and keeps /api out of its cache", async () => {
126
+ const res = await get("/sw.js");
127
+ expect(res.headers.get("cache-control")).toBe("no-cache");
128
+ const script = await res.text();
129
+ expect(script).toContain("kumiko-pwa-");
130
+ expect(script).toContain('"/api/"');
131
+ });
132
+ });
133
+
134
+ describe("pwa-shell recipe under a base path", () => {
135
+ let underBasePath: KumikoServerHandle;
136
+
137
+ beforeAll(async () => {
138
+ underBasePath = await createKumikoServer({
139
+ features: [notesFeature],
140
+ port: 0,
141
+ installSignalHandlers: false,
142
+ pwa: pwaUnderBasePath,
143
+ });
144
+ });
145
+
146
+ afterAll(async () => {
147
+ await underBasePath.stop();
148
+ });
149
+
150
+ const getUnder = (path: string) => underBasePath.fetch(new Request(`http://localhost${path}`));
151
+
152
+ test("manifest and worker are answered under /a/ only", async () => {
153
+ expect(await (await getUnder("/a/manifest.webmanifest")).json()).toMatchObject({
154
+ start_url: "/a/",
155
+ scope: "/a/",
156
+ });
157
+ const worker = await getUnder("/a/sw.js");
158
+ expect(worker.headers.get("content-type")).toBe("text/javascript; charset=utf-8");
159
+ expect(await worker.text()).toContain('"/a/"');
160
+ expect((await getUnder("/sw.js")).headers.get("content-type")).not.toBe(
161
+ "text/javascript; charset=utf-8",
162
+ );
163
+ });
164
+
165
+ test("the shell points at the prefixed manifest and worker", async () => {
166
+ const html = await (await getUnder("/a/notes/42")).text();
167
+ expect(html).toContain('<link rel="manifest" href="/a/manifest.webmanifest" />');
168
+ expect(html).toContain('<meta name="kumiko-pwa-sw" content="/a/sw.js" />');
169
+ });
170
+ });
171
+ ```
172
+
173
+ ### src/app.ts
174
+
175
+ ```ts
176
+ import { createEntity, createTextField, defineFeature } from "@cosmicdrift/kumiko-framework/engine";
177
+ import type { PwaOptions } from "@cosmicdrift/kumiko-server-runtime/pwa";
178
+
179
+ const noteEntity = createEntity({
180
+ fields: {
181
+ title: createTextField({ personal: false, reason: "is_business_data", required: true }),
182
+ },
183
+ table: "pwa_shell_note",
184
+ });
185
+
186
+ export const notesFeature = defineFeature("pwa-notes", (r) => {
187
+ r.entity({ name: "note", ...noteEntity });
188
+ });
189
+
190
+ // Icons live in public/ (dist/ after kumiko build); the boot rejects any src that is not a
191
+ // same-origin path.
192
+ export const pwa: PwaOptions = {
193
+ name: "Field Notes",
194
+ shortName: "Notes",
195
+ themeColor: "#14532d",
196
+ backgroundColor: "#ffffff",
197
+ icons: [
198
+ { src: "/icons/icon-192.png", sizes: "192x192", type: "image/png" },
199
+ { src: "/icons/icon-512.png", sizes: "512x512", type: "image/png" },
200
+ {
201
+ src: "/icons/icon-maskable-512.png",
202
+ sizes: "512x512",
203
+ type: "image/png",
204
+ purpose: "maskable",
205
+ },
206
+ ],
207
+ };
208
+
209
+ export const pwaUnderBasePath: PwaOptions = { ...pwa, basePath: "/a/" };
210
+ ```
@@ -49,9 +49,9 @@ r.writeHandler({
49
49
  });
50
50
  ```
51
51
 
52
- The cost is computed from the validated payload and booked on every declared bucket, so an
53
- invalid payload costs nothing and a rejected request consumes nothing. Results below 1 count
54
- as 1. Because it books after the parse, boot rejects `rateLimitCost` on anonymous or ip-limited
52
+ The cost is computed from the validated payload and booked on every declared bucket, so a
53
+ schema-invalid payload costs nothing, while a payload rejected afterwards by a validation hook or
54
+ field roles still consumes its cost. Results below 1 count as 1. Because it books after the parse, boot rejects `rateLimitCost` on anonymous or ip-limited
55
55
  handlers.
56
56
 
57
57
  ## Per-payload limits