@cosmicdrift/kumiko-samples 0.367.0 → 0.368.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 (385) hide show
  1. package/package.json +1 -1
  2. package/packages/bundled-features/package.json +16 -2
  3. package/packages/bundled-features/src/audit/handlers/details.query.ts +1 -1
  4. package/packages/bundled-features/src/audit/handlers/list.query.ts +1 -1
  5. package/packages/bundled-features/src/audit/run-escape-hatch-retention.ts +5 -5
  6. package/packages/bundled-features/src/auth-email-password/bootstrap.ts +1 -1
  7. package/packages/bundled-features/src/auth-email-password/handlers/invite-accept-with-login.write.ts +10 -3
  8. package/packages/bundled-features/src/auth-email-password/handlers/invite-accept.write.ts +10 -3
  9. package/packages/bundled-features/src/auth-email-password/handlers/invite-info.query.ts +1 -1
  10. package/packages/bundled-features/src/auth-email-password/handlers/invite-signup-complete.write.ts +6 -2
  11. package/packages/bundled-features/src/auth-email-password/handlers/signup-confirm.write.ts +1 -1
  12. package/packages/bundled-features/src/auth-email-password/seeding.ts +2 -2
  13. package/packages/bundled-features/src/auth-foundation/feature.ts +43 -34
  14. package/packages/bundled-features/src/auth-foundation/index.ts +1 -0
  15. package/packages/bundled-features/src/auth-mfa/db/queries.ts +5 -2
  16. package/packages/bundled-features/src/auth-mfa/handlers/enable-confirm-preauth.write.ts +1 -1
  17. package/packages/bundled-features/src/auth-mfa/handlers/enable-start-preauth.write.ts +1 -1
  18. package/packages/bundled-features/src/auth-mfa/handlers/reencrypt.job.ts +2 -2
  19. package/packages/bundled-features/src/auth-mfa/handlers/status.query.ts +1 -1
  20. package/packages/bundled-features/src/auth-mfa/handlers/verify.write.ts +1 -1
  21. package/packages/bundled-features/src/auth-mfa/mfa-code-verifier.ts +1 -1
  22. package/packages/bundled-features/src/auth-mfa/mfa-status-checker.ts +1 -1
  23. package/packages/bundled-features/src/auth-mfa-user-data/index.ts +19 -10
  24. package/packages/bundled-features/src/billing-foundation/billing-info-query.ts +1 -1
  25. package/packages/bundled-features/src/billing-foundation/feature.ts +138 -135
  26. package/packages/bundled-features/src/billing-foundation/handlers/create-portal-session.write.ts +1 -1
  27. package/packages/bundled-features/src/billing-foundation/projection.ts +3 -2
  28. package/packages/bundled-features/src/cap-counter/calendar-cap-usage-reservation.ts +52 -1
  29. package/packages/bundled-features/src/cap-counter/cap-reservation.ts +203 -15
  30. package/packages/bundled-features/src/cap-counter/changes.json +13 -0
  31. package/packages/bundled-features/src/cap-counter/feature.ts +84 -73
  32. package/packages/bundled-features/src/cap-counter/handlers/increment-rolling.write.ts +3 -4
  33. package/packages/bundled-features/src/cap-counter/index.ts +9 -1
  34. package/packages/bundled-features/src/cap-counter/tables.ts +10 -3
  35. package/packages/bundled-features/src/cap-overview/handlers/caps-usage.query.ts +1 -2
  36. package/packages/bundled-features/src/cap-overview/handlers/tenant-caps-list.query.ts +6 -2
  37. package/packages/bundled-features/src/cap-overview/handlers/tenant-options.query.ts +1 -1
  38. package/packages/bundled-features/src/channel-in-app/handlers/inbox.query.ts +1 -1
  39. package/packages/bundled-features/src/channel-in-app/handlers/mark-all-read.write.ts +1 -1
  40. package/packages/bundled-features/src/channel-in-app/handlers/mark-read.write.ts +1 -1
  41. package/packages/bundled-features/src/channel-in-app/handlers/unread-count.query.ts +1 -1
  42. package/packages/bundled-features/src/channel-in-app/tables.ts +1 -1
  43. package/packages/bundled-features/src/compliance-profiles/handlers/for-tenant.query.ts +1 -1
  44. package/packages/bundled-features/src/compliance-profiles/handlers/needs-profile.query.ts +1 -1
  45. package/packages/bundled-features/src/compliance-profiles/handlers/set-profile.write.ts +1 -2
  46. package/packages/bundled-features/src/compliance-profiles/resolve-for-tenant.ts +1 -1
  47. package/packages/bundled-features/src/compliance-profiles/seeding.ts +8 -4
  48. package/packages/bundled-features/src/compliance-profiles-ops/index.ts +26 -17
  49. package/packages/bundled-features/src/config/db/queries/resolver.ts +1 -1
  50. package/packages/bundled-features/src/config/handlers/reencrypt.job.ts +2 -2
  51. package/packages/bundled-features/src/config/resolver.ts +1 -1
  52. package/packages/bundled-features/src/config/write-helpers.ts +1 -1
  53. package/packages/bundled-features/src/crypto-shredding/changes.json +6 -0
  54. package/packages/bundled-features/src/crypto-shredding/handlers/forget-subject.write.ts +9 -7
  55. package/packages/bundled-features/src/custom-fields/db/queries/field-access.ts +1 -1
  56. package/packages/bundled-features/src/custom-fields/db/queries/projection.ts +1 -1
  57. package/packages/bundled-features/src/custom-fields/db/queries/quota.ts +1 -1
  58. package/packages/bundled-features/src/custom-fields/db/queries/retention.ts +6 -2
  59. package/packages/bundled-features/src/custom-fields/db/queries/user-data-rights.ts +1 -1
  60. package/packages/bundled-features/src/custom-fields/feature.ts +11 -14
  61. package/packages/bundled-features/src/custom-fields/handlers/clear-custom-field.write.ts +2 -2
  62. package/packages/bundled-features/src/custom-fields/handlers/delete-system-field.write.ts +2 -2
  63. package/packages/bundled-features/src/custom-fields/handlers/delete-tenant-field.write.ts +2 -2
  64. package/packages/bundled-features/src/custom-fields/handlers/set-custom-field.write.ts +2 -2
  65. package/packages/bundled-features/src/custom-fields/wire-for-entity.ts +4 -4
  66. package/packages/bundled-features/src/data-retention/resolve-for-tenant.ts +1 -1
  67. package/packages/bundled-features/src/data-retention/run-retention-cleanup.ts +16 -10
  68. package/packages/bundled-features/src/delivery/address-opt-out.ts +5 -2
  69. package/packages/bundled-features/src/delivery/attempt-log-retention.ts +1 -1
  70. package/packages/bundled-features/src/delivery/channel-context.ts +1 -1
  71. package/packages/bundled-features/src/delivery/db/queries/address-opt-outs.ts +1 -1
  72. package/packages/bundled-features/src/delivery/db/queries/preferences.ts +1 -1
  73. package/packages/bundled-features/src/delivery/delivery-service.ts +16 -6
  74. package/packages/bundled-features/src/delivery/feature.ts +1 -1
  75. package/packages/bundled-features/src/delivery/handlers/log.query.ts +3 -2
  76. package/packages/bundled-features/src/delivery/handlers/preferences.query.ts +1 -1
  77. package/packages/bundled-features/src/delivery/upsert-preference.ts +5 -2
  78. package/packages/bundled-features/src/derivatives-sharp/feature.ts +21 -12
  79. package/packages/bundled-features/src/derivatives-sharp/index.ts +1 -1
  80. package/packages/bundled-features/src/document-ingest-foundation/feature.ts +112 -103
  81. package/packages/bundled-features/src/document-ingest-foundation/forget-extract-with-file-ref.ts +3 -3
  82. package/packages/bundled-features/src/document-ingest-foundation/index.ts +4 -1
  83. package/packages/bundled-features/src/feature-toggles/global-feature-state-table.ts +1 -1
  84. package/packages/bundled-features/src/feature-toggles/handlers/set.write.ts +3 -5
  85. package/packages/bundled-features/src/feature-toggles/toggle-runtime.ts +1 -1
  86. package/packages/bundled-features/src/file-derivatives/feature.ts +134 -129
  87. package/packages/bundled-features/src/file-derivatives/handlers/public-variant-by-file-ref.query.ts +1 -1
  88. package/packages/bundled-features/src/file-derivatives/handlers/public-variant.query.ts +1 -1
  89. package/packages/bundled-features/src/file-foundation/feature.ts +38 -29
  90. package/packages/bundled-features/src/file-foundation/index.ts +1 -0
  91. package/packages/bundled-features/src/file-foundation/read-file-ref-content.ts +1 -1
  92. package/packages/bundled-features/src/file-provider-inmemory/feature.ts +32 -21
  93. package/packages/bundled-features/src/file-provider-inmemory/index.ts +6 -1
  94. package/packages/bundled-features/src/file-provider-s3/changes.json +10 -1
  95. package/packages/bundled-features/src/file-provider-s3/env-feature.ts +62 -0
  96. package/packages/bundled-features/src/file-provider-s3/feature.ts +107 -73
  97. package/packages/bundled-features/src/file-provider-s3/index.ts +6 -1
  98. package/packages/bundled-features/src/file-provider-s3/lib/index.ts +3 -0
  99. package/packages/bundled-features/src/{files-provider-s3 → file-provider-s3/lib}/s3-provider.ts +19 -19
  100. package/packages/bundled-features/src/file-provider-s3-env/index.ts +7 -2
  101. package/packages/bundled-features/src/files-provider-s3/index.ts +11 -3
  102. package/packages/bundled-features/src/files-tenant-data/handlers/sweep-orphaned-derivatives.job.ts +1 -1
  103. package/packages/bundled-features/src/files-tenant-data/hooks.ts +1 -2
  104. package/packages/bundled-features/src/folders/feature.ts +8 -3
  105. package/packages/bundled-features/src/folders-user-data/index.ts +27 -18
  106. package/packages/bundled-features/src/form-draft/db/queries/cleanup.ts +1 -1
  107. package/packages/bundled-features/src/form-draft/db/queries/draft-count.ts +1 -1
  108. package/packages/bundled-features/src/form-draft/db/queries/owned-file-refs.ts +3 -2
  109. package/packages/bundled-features/src/form-draft/feature.ts +6 -1
  110. package/packages/bundled-features/src/form-draft/handlers/cleanup.job.ts +2 -2
  111. package/packages/bundled-features/src/form-draft/index.ts +1 -1
  112. package/packages/bundled-features/src/form-draft/lookup.ts +1 -1
  113. package/packages/bundled-features/src/form-draft-user-data/index.ts +19 -10
  114. package/packages/bundled-features/src/inbound-mail-foundation/feature.ts +165 -154
  115. package/packages/bundled-features/src/inbound-mail-foundation/handlers/ingest-message.write.ts +1 -2
  116. package/packages/bundled-features/src/inbound-mail-foundation/index.ts +1 -1
  117. package/packages/bundled-features/src/inbound-mail-foundation/oauth-access-token.ts +5 -2
  118. package/packages/bundled-features/src/inbound-mail-foundation/projection.ts +3 -2
  119. package/packages/bundled-features/src/inbound-mail-foundation/watch-supervisor.ts +1 -1
  120. package/packages/bundled-features/src/inbound-provider-imap/feature.ts +22 -13
  121. package/packages/bundled-features/src/inbound-provider-imap/index.ts +6 -1
  122. package/packages/bundled-features/src/inbound-provider-inmemory/feature.ts +20 -12
  123. package/packages/bundled-features/src/inbound-provider-inmemory/index.ts +1 -0
  124. package/packages/bundled-features/src/jobs/db/queries/retention.ts +1 -1
  125. package/packages/bundled-features/src/jobs/db/queries/stale-run-sweep.ts +1 -1
  126. package/packages/bundled-features/src/jobs/handlers/detail.query.ts +1 -1
  127. package/packages/bundled-features/src/jobs/handlers/list.query.ts +7 -2
  128. package/packages/bundled-features/src/jobs/handlers/retry.write.ts +1 -1
  129. package/packages/bundled-features/src/jobs/handlers/tenant-failures.query.ts +1 -1
  130. package/packages/bundled-features/src/jobs/handlers/tenant-runs.query.ts +1 -1
  131. package/packages/bundled-features/src/jobs/job-run-logger.ts +11 -10
  132. package/packages/bundled-features/src/jobs/tenant-job-failure-table.ts +1 -1
  133. package/packages/bundled-features/src/jobs/tenant-job-run-table.ts +1 -1
  134. package/packages/bundled-features/src/ledger/feature.ts +6 -3
  135. package/packages/bundled-features/src/mail-foundation/feature.ts +57 -46
  136. package/packages/bundled-features/src/mail-foundation/index.ts +1 -0
  137. package/packages/bundled-features/src/mail-transport-inmemory/feature.ts +25 -17
  138. package/packages/bundled-features/src/mail-transport-inmemory/index.ts +6 -1
  139. package/packages/bundled-features/src/mail-transport-smtp/feature.ts +91 -79
  140. package/packages/bundled-features/src/mail-transport-smtp/index.ts +1 -0
  141. package/packages/bundled-features/src/managed-pages/handlers/by-slug.query.ts +1 -1
  142. package/packages/bundled-features/src/managed-pages/handlers/by-tenant-published.query.ts +1 -2
  143. package/packages/bundled-features/src/managed-pages/handlers/set.write.ts +1 -2
  144. package/packages/bundled-features/src/managed-pages/seeding.ts +8 -4
  145. package/packages/bundled-features/src/metrics/compute.ts +1 -1
  146. package/packages/bundled-features/src/metrics/filters.ts +1 -1
  147. package/packages/bundled-features/src/metrics/validate.ts +1 -1
  148. package/packages/bundled-features/src/notes-history/feature.ts +6 -3
  149. package/packages/bundled-features/src/notes-history/handlers/add-note.write.ts +1 -1
  150. package/packages/bundled-features/src/notes-history-user-data/hooks.ts +1 -1
  151. package/packages/bundled-features/src/notes-history-user-data/index.ts +27 -18
  152. package/packages/bundled-features/src/personal-access-tokens/changes.json +6 -0
  153. package/packages/bundled-features/src/personal-access-tokens/feature.ts +17 -2
  154. package/packages/bundled-features/src/personal-access-tokens/handlers/create.write.ts +1 -1
  155. package/packages/bundled-features/src/personal-access-tokens/handlers/list.query.ts +2 -2
  156. package/packages/bundled-features/src/personal-access-tokens/handlers/revoke.write.ts +1 -1
  157. package/packages/bundled-features/src/personal-access-tokens/resolver.ts +1 -1
  158. package/packages/bundled-features/src/personal-access-tokens/revoke-for-user.ts +2 -2
  159. package/packages/bundled-features/src/personal-access-tokens/roles.ts +8 -6
  160. package/packages/bundled-features/src/personal-access-tokens/screens.ts +2 -0
  161. package/packages/bundled-features/src/readiness/feature.ts +25 -16
  162. package/packages/bundled-features/src/readiness/index.ts +1 -1
  163. package/packages/bundled-features/src/secrets/db/queries/read.ts +1 -1
  164. package/packages/bundled-features/src/secrets/feature.ts +8 -3
  165. package/packages/bundled-features/src/secrets/handlers/rotate.job.ts +2 -2
  166. package/packages/bundled-features/src/secrets/secrets-context.ts +4 -3
  167. package/packages/bundled-features/src/sessions/db/queries/cleanup.ts +1 -1
  168. package/packages/bundled-features/src/sessions/handlers/detail.query.ts +1 -1
  169. package/packages/bundled-features/src/sessions/handlers/list.query.ts +2 -2
  170. package/packages/bundled-features/src/sessions/handlers/mine.query.ts +1 -1
  171. package/packages/bundled-features/src/sessions/handlers/revoke-all-for-user.write.ts +1 -1
  172. package/packages/bundled-features/src/sessions/handlers/revoke-all-others.write.ts +1 -1
  173. package/packages/bundled-features/src/sessions/handlers/revoke.write.ts +1 -1
  174. package/packages/bundled-features/src/sessions/session-callbacks.ts +14 -7
  175. package/packages/bundled-features/src/sessions/testing.ts +1 -1
  176. package/packages/bundled-features/src/tags/feature.ts +6 -3
  177. package/packages/bundled-features/src/template-resolver/api.ts +1 -1
  178. package/packages/bundled-features/src/template-resolver/handlers/bundle-import.ts +1 -1
  179. package/packages/bundled-features/src/template-resolver/handlers/by-slug.query.ts +1 -1
  180. package/packages/bundled-features/src/template-resolver/handlers/by-tenant.query.ts +1 -2
  181. package/packages/bundled-features/src/template-resolver/handlers/collection-item.query.ts +1 -1
  182. package/packages/bundled-features/src/template-resolver/handlers/collection-list.query.ts +1 -2
  183. package/packages/bundled-features/src/template-resolver/handlers/collection-set.write.ts +1 -1
  184. package/packages/bundled-features/src/template-resolver/handlers/copy-locale.write.ts +1 -1
  185. package/packages/bundled-features/src/template-resolver/handlers/diff-to-system.query.ts +1 -1
  186. package/packages/bundled-features/src/template-resolver/handlers/export-bundle.query.ts +1 -1
  187. package/packages/bundled-features/src/template-resolver/handlers/find-by-id.query.ts +1 -1
  188. package/packages/bundled-features/src/template-resolver/handlers/layout-source.query.ts +1 -1
  189. package/packages/bundled-features/src/template-resolver/handlers/list.query.ts +1 -1
  190. package/packages/bundled-features/src/template-resolver/handlers/overview.query.ts +1 -1
  191. package/packages/bundled-features/src/template-resolver/handlers/reset-to-system.write.ts +1 -1
  192. package/packages/bundled-features/src/template-resolver/handlers/resource-remove.write.ts +1 -1
  193. package/packages/bundled-features/src/template-resolver/handlers/set.write.ts +1 -1
  194. package/packages/bundled-features/src/template-resolver/handlers/template-write.ts +1 -1
  195. package/packages/bundled-features/src/template-resolver/handlers/tenant-overrides.query.ts +1 -1
  196. package/packages/bundled-features/src/template-resolver/handlers/toggle-status.write.ts +1 -1
  197. package/packages/bundled-features/src/template-resolver/handlers/usage.query.ts +1 -1
  198. package/packages/bundled-features/src/template-resolver/handlers/validate.query.ts +1 -1
  199. package/packages/bundled-features/src/template-resolver/seeding.ts +3 -3
  200. package/packages/bundled-features/src/template-resolver/store-template-resource.ts +1 -1
  201. package/packages/bundled-features/src/template-resolver/template-preview.ts +1 -1
  202. package/packages/bundled-features/src/template-resolver/template-resources.ts +1 -1
  203. package/packages/bundled-features/src/template-resolver/testing.ts +1 -1
  204. package/packages/bundled-features/src/template-resolver-user-data/index.ts +23 -14
  205. package/packages/bundled-features/src/tenant/handlers/active-tenant-ids.query.ts +1 -1
  206. package/packages/bundled-features/src/tenant/handlers/add-member.write.ts +1 -2
  207. package/packages/bundled-features/src/tenant/handlers/cancel-invitation.write.ts +1 -1
  208. package/packages/bundled-features/src/tenant/handlers/invitations.query.ts +1 -1
  209. package/packages/bundled-features/src/tenant/handlers/me.query.ts +1 -1
  210. package/packages/bundled-features/src/tenant/handlers/member-directory.query.ts +1 -1
  211. package/packages/bundled-features/src/tenant/handlers/members.query.ts +1 -1
  212. package/packages/bundled-features/src/tenant/handlers/memberships.query.ts +1 -1
  213. package/packages/bundled-features/src/tenant/handlers/remove-member.write.ts +2 -1
  214. package/packages/bundled-features/src/tenant/handlers/resolve-user-ids.query.ts +1 -1
  215. package/packages/bundled-features/src/tenant/handlers/team-list.query.ts +1 -1
  216. package/packages/bundled-features/src/tenant/handlers/tenant-directory.query.ts +1 -1
  217. package/packages/bundled-features/src/tenant/handlers/update-member-roles.write.ts +1 -2
  218. package/packages/bundled-features/src/tenant/invited-membership.ts +2 -2
  219. package/packages/bundled-features/src/tenant/last-tenant-admin.ts +1 -2
  220. package/packages/bundled-features/src/tenant/seeding.ts +12 -12
  221. package/packages/bundled-features/src/tenant-lifecycle/handlers/cancel-destruction.write.ts +1 -2
  222. package/packages/bundled-features/src/tenant-lifecycle/handlers/request-destruction.write.ts +1 -2
  223. package/packages/bundled-features/src/tenant-lifecycle/lib/revoke-tenant-sessions.ts +1 -1
  224. package/packages/bundled-features/src/tenant-lifecycle/lifecycle-gate.ts +1 -1
  225. package/packages/bundled-features/src/tenant-lifecycle/run-tenant-destroy.ts +3 -3
  226. package/packages/bundled-features/src/tenant-lifecycle/stages.ts +10 -5
  227. package/packages/bundled-features/src/tenant-lifecycle/testing.ts +3 -3
  228. package/packages/bundled-features/src/tenant-settings/feature.ts +34 -29
  229. package/packages/bundled-features/src/tier-engine/feature.ts +426 -428
  230. package/packages/bundled-features/src/tier-engine/handlers/get-tenant-tier.query.ts +2 -3
  231. package/packages/bundled-features/src/tier-engine/handlers/set-tenant-tier.write.ts +5 -2
  232. package/packages/bundled-features/src/user/changes.json +6 -0
  233. package/packages/bundled-features/src/user/db/queries/stream-tenant-backfill.ts +1 -1
  234. package/packages/bundled-features/src/user/handlers/create.write.ts +1 -2
  235. package/packages/bundled-features/src/user/handlers/find-for-auth.query.ts +1 -1
  236. package/packages/bundled-features/src/user/handlers/list.query.ts +1 -1
  237. package/packages/bundled-features/src/user/handlers/update-roles.ts +2 -1
  238. package/packages/bundled-features/src/user/index.ts +5 -1
  239. package/packages/bundled-features/src/user/invited-global-roles.ts +2 -2
  240. package/packages/bundled-features/src/user/principal-status.ts +13 -3
  241. package/packages/bundled-features/src/user/resolve-display-names.ts +1 -1
  242. package/packages/bundled-features/src/user/seeding.ts +5 -5
  243. package/packages/bundled-features/src/user-data-rights/audit-download.ts +2 -2
  244. package/packages/bundled-features/src/user-data-rights/db/queries/export-jobs.ts +1 -1
  245. package/packages/bundled-features/src/user-data-rights/db/queries/forget-cleanup.ts +1 -1
  246. package/packages/bundled-features/src/user-data-rights/handlers/download-by-job.query.ts +1 -1
  247. package/packages/bundled-features/src/user-data-rights/handlers/download-by-token.query.ts +1 -1
  248. package/packages/bundled-features/src/user-data-rights/handlers/export-status.query.ts +1 -1
  249. package/packages/bundled-features/src/user-data-rights/handlers/list-download-attempts.query.ts +1 -1
  250. package/packages/bundled-features/src/user-data-rights/handlers/my-audit-log.query.ts +1 -1
  251. package/packages/bundled-features/src/user-data-rights/handlers/request-export.write.ts +1 -2
  252. package/packages/bundled-features/src/user-data-rights/handlers/run-forget-cleanup.write.ts +3 -3
  253. package/packages/bundled-features/src/user-data-rights/lib/deny-if-target-outside-admin-tenant.ts +1 -1
  254. package/packages/bundled-features/src/user-data-rights/lib/update-user-lifecycle.ts +7 -2
  255. package/packages/bundled-features/src/user-data-rights/run-export-jobs.ts +7 -3
  256. package/packages/bundled-features/src/user-data-rights/run-forget-cleanup.ts +11 -5
  257. package/packages/bundled-features/src/user-data-rights/run-user-export.ts +10 -5
  258. package/packages/bundled-features/src/waitlist/handlers/invite.write.ts +1 -2
  259. package/packages/bundled-features/src/waitlist/handlers/reject.write.ts +1 -1
  260. package/packages/bundled-features/src/waitlist/lib.ts +5 -2
  261. package/packages/bundled-features/src/workflow-runner/event-subscriber.ts +1 -1
  262. package/packages/bundled-features/src/workflow-runner/feature.ts +58 -47
  263. package/packages/bundled-features/src/workflow-runner/handlers/resume-run.write.ts +1 -1
  264. package/packages/bundled-features/src/workflow-runner/index.ts +1 -1
  265. package/packages/bundled-features/src/workflow-runner/pending-projection.ts +1 -1
  266. package/samples/apps/admin-console/src/run-config.ts +2 -2
  267. package/samples/apps/cap-billing-demo/package.json +3 -0
  268. package/samples/apps/cap-billing-demo/src/feature.ts +2 -2
  269. package/samples/apps/cap-billing-demo/src/run-config.ts +8 -8
  270. package/samples/apps/marketing-demo/src/app/seed.ts +1 -1
  271. package/samples/apps/marketing-demo/src/db/queries/seed-counts.ts +1 -1
  272. package/samples/apps/showcase/package.json +3 -0
  273. package/samples/apps/showcase/src/app/seed-items.ts +1 -1
  274. package/samples/apps/styleguide/src/app/seed.ts +2 -2
  275. package/samples/apps/styleguide/src/features/ai-settings/seed.ts +2 -2
  276. package/samples/apps/ui-walkthrough/scripts/emit-e2e-data.ts +1 -1
  277. package/samples/apps/ui-walkthrough/src/app/auth-constants.ts +1 -1
  278. package/samples/apps/ui-walkthrough/src/app/seed-rental.ts +2 -2
  279. package/samples/apps/ui-walkthrough/src/app/seed-vehicles.ts +1 -1
  280. package/samples/apps/ui-walkthrough/src/app/seed.ts +1 -1
  281. package/samples/apps/ui-walkthrough/src/db/queries/row-counts.ts +1 -1
  282. package/samples/apps/ui-walkthrough/src/db/queries/task-counts.ts +1 -1
  283. package/samples/apps/use-all-bundled/package.json +3 -0
  284. package/samples/apps/use-all-bundled/scripts/check-coverage.ts +2 -2
  285. package/samples/apps/use-all-bundled/src/app/auth-constants.ts +1 -1
  286. package/samples/apps/use-all-bundled/src/app/cap-overview-caps.ts +2 -2
  287. package/samples/apps/use-all-bundled/src/app/dev-app-options.ts +1 -1
  288. package/samples/apps/use-all-bundled/src/app/seed-documents.ts +1 -1
  289. package/samples/apps/use-all-bundled/src/app/seed.ts +11 -5
  290. package/samples/apps/use-all-bundled/src/run-config.ts +55 -56
  291. package/samples/apps/user-data-rights-demo/README.md +2 -2
  292. package/samples/apps/user-data-rights-demo/package.json +3 -0
  293. package/samples/apps/user-data-rights-demo/src/run-config.ts +7 -7
  294. package/samples/apps/workspaces/package.json +3 -0
  295. package/samples/recipes/access-control/package.json +3 -0
  296. package/samples/recipes/anonymous-access/package.json +3 -0
  297. package/samples/recipes/anonymous-access-multitenant/package.json +3 -0
  298. package/samples/recipes/apex-landing/package.json +1 -0
  299. package/samples/recipes/apex-surface-auth/package.json +3 -0
  300. package/samples/recipes/apex-surface-auth/src/feature.ts +2 -2
  301. package/samples/recipes/api-worker-split/package.json +3 -0
  302. package/samples/recipes/api-worker-split/src/feature.ts +1 -2
  303. package/samples/recipes/auth-claims/package.json +3 -0
  304. package/samples/recipes/auth-foundation-providers/src/feature.ts +1 -1
  305. package/samples/recipes/auth-mfa/package.json +3 -0
  306. package/samples/recipes/basic-entity/package.json +3 -0
  307. package/samples/recipes/chat-channels/package.json +3 -0
  308. package/samples/recipes/compliance-profiles-demo/package.json +3 -0
  309. package/samples/recipes/cross-feature-events/package.json +3 -1
  310. package/samples/recipes/cross-feature-events/src/feature.ts +1 -1
  311. package/samples/recipes/crypto-shredding-hr/package.json +3 -0
  312. package/samples/recipes/currencies-global/package.json +3 -0
  313. package/samples/recipes/currencies-per-tenant/package.json +3 -0
  314. package/samples/recipes/custom-fields-basic/package.json +3 -0
  315. package/samples/recipes/custom-handlers/package.json +3 -0
  316. package/samples/recipes/dashboard-stats/package.json +3 -0
  317. package/samples/recipes/delivery-notifications/package.json +3 -0
  318. package/samples/recipes/e2e-generator/package.json +3 -0
  319. package/samples/recipes/embedded/package.json +3 -0
  320. package/samples/recipes/embedded-entity-form/package.json +1 -0
  321. package/samples/recipes/encrypted-tenant-config/README.md +1 -1
  322. package/samples/recipes/encrypted-tenant-config/package.json +3 -0
  323. package/samples/recipes/error-contract/package.json +3 -0
  324. package/samples/recipes/event-sourcing/package.json +3 -1
  325. package/samples/recipes/event-sourcing/src/feature.ts +16 -20
  326. package/samples/recipes/event-sourcing/tsconfig.json +2 -6
  327. package/samples/recipes/feature-toggles/package.json +3 -0
  328. package/samples/recipes/field-access/package.json +3 -0
  329. package/samples/recipes/files-post-processing/package.json +1 -0
  330. package/samples/recipes/golden-path/README.md +30 -0
  331. package/samples/recipes/golden-path/package.json +11 -0
  332. package/samples/recipes/golden-path/src/feature.ts +70 -0
  333. package/samples/recipes/idempotency/package.json +3 -0
  334. package/samples/recipes/inbound-mail-triage/package.json +3 -0
  335. package/samples/recipes/lane-routing/package.json +3 -0
  336. package/samples/recipes/ledger-banking/package.json +3 -0
  337. package/samples/recipes/ledger-invoicing/package.json +3 -0
  338. package/samples/recipes/legal-pages/package.json +3 -0
  339. package/samples/recipes/lifecycle-hooks/package.json +3 -0
  340. package/samples/recipes/managed-config/package.json +3 -0
  341. package/samples/recipes/managed-pages/package.json +3 -0
  342. package/samples/recipes/notes-history-basic/package.json +3 -0
  343. package/samples/recipes/ownership/package.json +3 -0
  344. package/samples/recipes/pdf-audit-export/package.json +1 -0
  345. package/samples/recipes/pipeline-basics/package.json +3 -0
  346. package/samples/recipes/public-share-token/package.json +3 -0
  347. package/samples/recipes/public-share-token/src/feature.ts +1 -1
  348. package/samples/recipes/rate-limiting/package.json +3 -0
  349. package/samples/recipes/realtime-sse/package.json +3 -0
  350. package/samples/recipes/record-detail-layout/package.json +1 -0
  351. package/samples/recipes/reference-data/package.json +3 -0
  352. package/samples/recipes/relations/package.json +3 -0
  353. package/samples/recipes/screens-nav/package.json +3 -0
  354. package/samples/recipes/search/package.json +3 -0
  355. package/samples/recipes/secrets-demo/package.json +3 -0
  356. package/samples/recipes/security-baseline/src/feature.ts +2 -2
  357. package/samples/recipes/session-revocation/README.md +1 -1
  358. package/samples/recipes/session-revocation/package.json +3 -0
  359. package/samples/recipes/session-revocation/src/feature.ts +1 -1
  360. package/samples/recipes/state-machine/package.json +3 -1
  361. package/samples/recipes/state-machine/src/entities/invoice.ts +2 -2
  362. package/samples/recipes/state-machine/src/events.ts +19 -0
  363. package/samples/recipes/state-machine/src/feature.ts +25 -30
  364. package/samples/recipes/state-machine/src/handlers/_helpers.ts +13 -14
  365. package/samples/recipes/state-machine/src/handlers/create.ts +1 -1
  366. package/samples/recipes/state-machine/src/handlers/transitions.ts +129 -122
  367. package/samples/recipes/state-machine/src/reducer.ts +1 -1
  368. package/samples/recipes/state-machine/tsconfig.json +2 -6
  369. package/samples/recipes/tags-basic/package.json +3 -0
  370. package/samples/recipes/tenant-isolation/package.json +3 -0
  371. package/samples/recipes/tenant-settings/package.json +3 -0
  372. package/samples/recipes/tier-admin/package.json +3 -0
  373. package/samples/recipes/timezones/package.json +3 -0
  374. package/samples/recipes/tsconfig.base.json +1 -1
  375. package/samples/recipes/user-data-rights/package.json +3 -0
  376. package/samples/recipes/user-data-rights/src/feature.ts +6 -2
  377. package/samples/recipes/user-profile/package.json +3 -0
  378. package/samples/recipes/user-profile/src/feature.ts +2 -2
  379. package/samples/recipes/webhook-step/package.json +3 -0
  380. package/samples/recipes/wizard-form/package.json +1 -0
  381. package/samples/recipes/workflow-engine/package.json +3 -0
  382. package/samples/recipes/workflow-engine/src/db/queries/suspended-runs.ts +5 -2
  383. package/samples/recipes/writeform-section/package.json +1 -0
  384. package/packages/bundled-features/src/file-provider-s3-env/feature.ts +0 -58
  385. /package/packages/bundled-features/src/{files-provider-s3 → file-provider-s3/lib}/env-helper.ts +0 -0
@@ -12,5 +12,8 @@
12
12
  "@cosmicdrift/kumiko-framework": "workspace:*",
13
13
  "zod": "^4.4.3",
14
14
  "@cosmicdrift/kumiko-locale-de": "workspace:*"
15
+ },
16
+ "devDependencies": {
17
+ "@cosmicdrift/kumiko-testing": "workspace:*"
15
18
  }
16
19
  }
@@ -17,15 +17,15 @@
17
17
  // echten Deploy auf den persistenten Provider wechseln; die
18
18
  // deployment-spezifischen Produktionsschritte stehen in der privaten
19
19
  // Operations-Dokumentation:
20
- // import { fileProviderS3EnvFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3-env";
21
- // fileProviderInMemoryFeature -> fileProviderS3EnvFeature
20
+ // import { createFileProviderS3Feature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3";
21
+ // createFileProviderInMemoryFeature() -> createFileProviderS3Feature({ fromEnv: true })
22
22
  // + S3_BUCKET/S3_REGION/S3_ACCESS_KEY/S3_SECRET_KEY env vars
23
23
  // + appOverride "file-foundation:config:provider" = "s3-env"
24
24
 
25
25
  import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
26
26
  import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
27
- import { fileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
28
- import { fileProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-inmemory";
27
+ import { createFileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
28
+ import { createFileProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-inmemory";
29
29
  import { createFilesFeature } from "@cosmicdrift/kumiko-bundled-features/files";
30
30
  import { createUserDataRightsFeature } from "@cosmicdrift/kumiko-bundled-features/user-data-rights";
31
31
  import { createUserDataRightsDefaultsFeature } from "@cosmicdrift/kumiko-bundled-features/user-data-rights-defaults";
@@ -36,9 +36,9 @@ export const APP_FEATURES = [
36
36
  localeDe(),
37
37
  createDataRetentionFeature(),
38
38
  createComplianceProfilesFeature(),
39
- fileFoundationFeature,
40
- // Demo: in-memory (no creds). Prod: fileProviderS3EnvFeature — see header.
41
- fileProviderInMemoryFeature,
39
+ createFileFoundationFeature(),
40
+ // Demo: in-memory (no creds). Prod: createFileProviderS3Feature({ fromEnv: true }) — see header.
41
+ createFileProviderInMemoryFeature(),
42
42
  createFilesFeature(),
43
43
  createUserDataRightsFeature(),
44
44
  createUserDataRightsDefaultsFeature(),
@@ -16,5 +16,8 @@
16
16
  "react": "^19.2.6",
17
17
  "react-dom": "^19.2.6",
18
18
  "@cosmicdrift/kumiko-locale-de": "workspace:*"
19
+ },
20
+ "devDependencies": {
21
+ "@cosmicdrift/kumiko-testing": "workspace:*"
19
22
  }
20
23
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -11,6 +11,7 @@
11
11
  "@cosmicdrift/kumiko-headless": "workspace:*"
12
12
  },
13
13
  "devDependencies": {
14
+ "@cosmicdrift/kumiko-testing": "workspace:*",
14
15
  "@playwright/test": "^1.62.1"
15
16
  }
16
17
  }
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -63,7 +63,7 @@
63
63
  // anonymousAccess: { defaultTenantId: APEX_TENANT_ID } })
64
64
 
65
65
  import { createAuthEmailPasswordFeature } from "@cosmicdrift/kumiko-bundled-features/auth-email-password";
66
- import { authFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
66
+ import { createAuthFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
67
67
  import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
68
68
  import { createConfigFeature } from "@cosmicdrift/kumiko-bundled-features/config";
69
69
  import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
@@ -101,7 +101,7 @@ export function composeApexAccountApp(opts: ApexAccountAppOptions): FeatureDefin
101
101
  createAuthEmailPasswordFeature(),
102
102
  createDataRetentionFeature(),
103
103
  createComplianceProfilesFeature(),
104
- authFoundationFeature,
104
+ createAuthFoundationFeature(),
105
105
  createPersonalAccessTokensFeature({ scopes: {} }),
106
106
  createSessionsFeature(),
107
107
  createUserDataRightsFeature({
@@ -12,5 +12,8 @@
12
12
  "@cosmicdrift/kumiko-dev-server": "workspace:*",
13
13
  "@cosmicdrift/kumiko-framework": "workspace:*",
14
14
  "@cosmicdrift/kumiko-server-runtime": "workspace:*"
15
+ },
16
+ "devDependencies": {
17
+ "@cosmicdrift/kumiko-testing": "workspace:*"
15
18
  }
16
19
  }
@@ -12,8 +12,7 @@
12
12
  // dispatcher — JobContext has no write/query (fw#1717), so the app
13
13
  // wires a write-bridge at boot (see setOrderFulfillWrite below).
14
14
 
15
- import { insertOne } from "@cosmicdrift/kumiko-framework/bun-db";
16
- import { table, text, uuid } from "@cosmicdrift/kumiko-framework/db";
15
+ import { insertOne, table, text, uuid } from "@cosmicdrift/kumiko-framework/db";
17
16
  import {
18
17
  createEntity,
19
18
  createNumberField,
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -9,7 +9,7 @@
9
9
  // What to copy:
10
10
  //
11
11
  // composeFeatures([
12
- // authFoundationFeature,
12
+ // createAuthFoundationFeature(),
13
13
  // createSubdomainTenantRoutingFeature({ lookupBySubdomain, existsById }),
14
14
  // …appFeatures,
15
15
  // ], { includeBundled: true })
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -3,7 +3,9 @@
3
3
  "description": "Feature appends a typed domain event via ctx.appendEvent; a r.multiStreamProjection reacts asynchronously.",
4
4
  "private": true,
5
5
  "dependencies": {
6
- "@app/define": "file:./.kumiko",
7
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
10
  }
9
11
  }
@@ -35,7 +35,7 @@ import {
35
35
  defineFeature,
36
36
  emitEvent,
37
37
  typedPayload,
38
- } from "@app/define";
38
+ } from "@cosmicdrift/kumiko-framework/engine";
39
39
  import { z } from "zod";
40
40
 
41
41
  // --- Entity ---
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -6,5 +6,8 @@
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*",
8
8
  "@cosmicdrift/kumiko-renderer-mail-html": "workspace:*"
9
+ },
10
+ "devDependencies": {
11
+ "@cosmicdrift/kumiko-testing": "workspace:*"
9
12
  }
10
13
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -9,6 +9,7 @@
9
9
  "react": "^19.2.6"
10
10
  },
11
11
  "devDependencies": {
12
+ "@cosmicdrift/kumiko-testing": "workspace:*",
12
13
  "@types/react": "^19.2.14"
13
14
  }
14
15
  }
@@ -63,7 +63,7 @@ custom boots pass their own cipher:
63
63
 
64
64
  ```ts illustration
65
65
  import { createConfigResolver } from "@cosmicdrift/kumiko-bundled-features/config";
66
- import { createTestEnvelopeCipher } from "@cosmicdrift/kumiko-framework/testing";
66
+ import { createTestEnvelopeCipher } from "@cosmicdrift/kumiko-testing/helpers";
67
67
 
68
68
  const cipher = createTestEnvelopeCipher();
69
69
  const configResolver = createConfigResolver({ cipher });
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -3,7 +3,9 @@
3
3
  "description": "Production-pattern ES sample: r.defineEvent (versioned + migrations) + ctx.appendEvent + r.projection + r.multiStreamProjection + ctx.loadAggregate (asOf) + ctx.archiveStream + ctx.queryProjection.",
4
4
  "private": true,
5
5
  "dependencies": {
6
- "@app/define": "file:./.kumiko",
7
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
10
  }
9
11
  }
@@ -5,8 +5,8 @@
5
5
  //
6
6
  // - r.defineEvent with { version, migrations } — evolving event shapes +
7
7
  // upcast older payloads on read (declarative + sync/async transforms)
8
- // - ctx.appendEvent — write domain events onto the aggregate stream
9
- // - ctx.appendEvent with headers — Marten free key/value metadata
8
+ // - emitEvent — write domain events onto the aggregate stream, payload typed by the EventDef
9
+ // - emitEvent with headers — Marten free key/value metadata
10
10
  // - r.projection — single-stream read model (inline in the write TX)
11
11
  // - r.multiStreamProjection — cross-aggregate async read model
12
12
  // - ctx.loadAggregate with { asOf } — point-in-time aggregate state
@@ -19,26 +19,25 @@
19
19
  // - getAllProjectionProgress — projection lag for ops dashboards
20
20
 
21
21
  import {
22
- createEntity,
23
- createTextField,
24
- defineFeature,
25
- defineProjectionQueryHandler,
26
- typedPayload,
27
- } from "@app/define";
28
- import {
22
+ buildEntityTable,
23
+ createEventStoreExecutor,
29
24
  fetchOne,
30
25
  incrementCounter,
31
26
  insertOne,
32
- updateMany,
33
- } from "@cosmicdrift/kumiko-framework/bun-db";
34
- import {
35
- buildEntityTable,
36
- createEventStoreExecutor,
37
27
  integer,
38
28
  table,
39
29
  text,
30
+ updateMany,
40
31
  uuid,
41
32
  } from "@cosmicdrift/kumiko-framework/db";
33
+ import {
34
+ createEntity,
35
+ createTextField,
36
+ defineFeature,
37
+ defineProjectionQueryHandler,
38
+ emitEvent,
39
+ typedPayload,
40
+ } from "@cosmicdrift/kumiko-framework/engine";
42
41
  import { z } from "zod";
43
42
 
44
43
  // --- Reducer: shared by live + snapshot-aware query handlers ---
@@ -286,10 +285,9 @@ export const invoiceFeature = defineFeature("showcase", (r) => {
286
285
  const headers: Record<string, string> = {};
287
286
  if (event.payload.geoRegion) headers["geoRegion"] = event.payload.geoRegion;
288
287
  if (event.payload.abTestBucket) headers["abTestBucket"] = event.payload.abTestBucket;
289
- await ctx.appendEvent({
288
+ await emitEvent(ctx, approved, {
290
289
  aggregateId: event.payload.id,
291
290
  aggregateType: "showcase-invoice",
292
- type: approved.name,
293
291
  payload: { amountCents: event.payload.amountCents, approvedBy: event.payload.approvedBy },
294
292
  ...(Object.keys(headers).length > 0 ? { headers } : {}),
295
293
  });
@@ -306,10 +304,9 @@ export const invoiceFeature = defineFeature("showcase", (r) => {
306
304
  approverId: event.payload.approverId,
307
305
  });
308
306
  const approverDisplayName: string = row?.displayName ?? `unknown:${event.payload.approverId}`;
309
- await ctx.appendEvent({
307
+ await emitEvent(ctx, acknowledged, {
310
308
  aggregateId: event.payload.id,
311
309
  aggregateType: "showcase-invoice",
312
- type: acknowledged.name,
313
310
  payload: { approverId: event.payload.approverId, approverDisplayName },
314
311
  });
315
312
  return { isSuccess: true as const, data: { id: event.payload.id } };
@@ -321,10 +318,9 @@ export const invoiceFeature = defineFeature("showcase", (r) => {
321
318
  name: "invoice:pay",
322
319
  schema: z.object({ id: z.uuid(), amountCents: z.number().int() }),
323
320
  handler: async (event, ctx) => {
324
- await ctx.appendEvent({
321
+ await emitEvent(ctx, paid, {
325
322
  aggregateId: event.payload.id,
326
323
  aggregateType: "showcase-invoice",
327
- type: paid.name,
328
324
  payload: { amountCents: event.payload.amountCents },
329
325
  });
330
326
  return { isSuccess: true as const, data: { id: event.payload.id } };
@@ -11,16 +11,12 @@
11
11
  "@cosmicdrift/kumiko-dev-server": [
12
12
  "../../../packages/dev-server/src/index.ts"
13
13
  ],
14
- "@cosmicdrift/kumiko-dev-server/*": [
15
- "../../../packages/dev-server/src/*"
16
- ],
17
- "@app/define": ["./.kumiko/define.ts"],
18
- "@app/*": ["./.kumiko/*"]
14
+ "@cosmicdrift/kumiko-dev-server/*": ["../../../packages/dev-server/src/*"]
19
15
  },
20
16
  "noEmit": true,
21
17
  "rootDir": "../../..",
22
18
  "lib": ["ESNext", "DOM", "DOM.Iterable"],
23
19
  "types": ["bun-types"]
24
20
  },
25
- "include": ["./src", "./.kumiko"]
21
+ "include": ["./src"]
26
22
  }
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -7,6 +7,7 @@
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
8
  },
9
9
  "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*",
10
11
  "sharp": "^0.35.5"
11
12
  }
12
13
  }
@@ -0,0 +1,30 @@
1
+ # Golden path
2
+
3
+ The smallest complete Kumiko feature: one entity, one write handler that emits
4
+ an event, one projection, one screen, and an integration test that writes
5
+ through HTTP and reads the result back. Every other recipe is a variation on
6
+ this shape. The walkthrough is in [`docs/golden-path.md`](../../../docs/golden-path.md).
7
+
8
+ ## What it shows
9
+
10
+ - **Entity** — `ticketEntity` declares `title` and `isClosed`. `r.crud` registers
11
+ `ticket:create`, `ticket:list` and `ticket:detail` for it; update and delete
12
+ are switched off with `verbs`.
13
+ - **Write handler** — `ticket:close` checks that the ticket exists and emits the
14
+ `ticket-closed` event. It never touches the table.
15
+ - **Event** — `r.defineEvent` declares `ticket-closed` with a Zod payload;
16
+ `emitEvent` appends it to the ticket's stream in the handler's transaction.
17
+ - **Projection** — `ticket-status` folds `ticket-closed` into the ticket row
18
+ (`isClosed: true`), in the same transaction as the write.
19
+ - **Screen** — `ticket-list` is a declarative `entityList`; the renderer builds
20
+ the UI from it.
21
+ - **Test** — `setupTestStack` boots the real server and database;
22
+ `stack.http.writeOk` and `queryOk` go over HTTP. Each test runs in its own
23
+ tenant.
24
+
25
+ ## Files
26
+
27
+ ```
28
+ src/feature.ts entity, event, handler, projection, screen
29
+ src/__tests__/feature.integration.test.ts write → read back, access, not found
30
+ ```
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "@cosmicdrift/kumiko-sample-golden-path",
3
+ "description": "The smallest complete feature: entity, write handler, event, projection, screen and an integration test.",
4
+ "private": true,
5
+ "dependencies": {
6
+ "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
10
+ }
11
+ }
@@ -0,0 +1,70 @@
1
+ import {
2
+ createBooleanField,
3
+ createEntity,
4
+ createEntityExecutor,
5
+ createTextField,
6
+ defineFeature,
7
+ emitEvent,
8
+ setFields,
9
+ } from "@cosmicdrift/kumiko-framework/engine";
10
+ import { failNotFound } from "@cosmicdrift/kumiko-framework/errors";
11
+ import { z } from "zod";
12
+
13
+ export const ticketEntity = createEntity({
14
+ table: "read_golden_path_tickets",
15
+ fields: {
16
+ title: createTextField({ personal: false, reason: "is_business_data", required: true }),
17
+ isClosed: createBooleanField({ default: false }),
18
+ },
19
+ });
20
+
21
+ export const helpdeskFeature = defineFeature("helpdesk", (r) => {
22
+ const { table: ticketTable, executor: ticketExecutor } = createEntityExecutor(
23
+ "ticket",
24
+ ticketEntity,
25
+ );
26
+
27
+ r.crud("ticket", ticketEntity, {
28
+ write: { access: { roles: ["Admin", "User"] } },
29
+ read: { access: { roles: ["Admin", "User"] } },
30
+ verbs: { update: false, delete: false },
31
+ });
32
+
33
+ const ticketClosed = r.defineEvent("ticket-closed", z.object({ resolution: z.string().min(1) }), {
34
+ piiFields: "none",
35
+ });
36
+
37
+ r.writeHandler({
38
+ name: "ticket:close",
39
+ schema: z.object({ id: z.uuid(), resolution: z.string().min(1) }),
40
+ access: { roles: ["Admin"] },
41
+ handler: async (event, ctx) => {
42
+ const ticket = await ticketExecutor.detail({ id: event.payload.id }, event.user, ctx.db);
43
+ if (!ticket) {
44
+ return failNotFound("ticket", event.payload.id);
45
+ }
46
+ await emitEvent(ctx, ticketClosed, {
47
+ aggregateId: event.payload.id,
48
+ aggregateType: "ticket",
49
+ payload: { resolution: event.payload.resolution },
50
+ });
51
+ return { isSuccess: true as const, data: { id: event.payload.id } };
52
+ },
53
+ });
54
+
55
+ r.projection({
56
+ name: "ticket-status",
57
+ source: "ticket",
58
+ table: ticketTable,
59
+ apply: {
60
+ [ticketClosed.name]: setFields(ticketTable, { isClosed: true }),
61
+ },
62
+ });
63
+
64
+ r.screen({
65
+ id: "ticket-list",
66
+ type: "entityList",
67
+ entity: "ticket",
68
+ columns: ["title", "isClosed"],
69
+ });
70
+ });
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }
@@ -5,5 +5,8 @@
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
7
  "@cosmicdrift/kumiko-framework": "workspace:*"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -4,5 +4,8 @@
4
4
  "private": true,
5
5
  "dependencies": {
6
6
  "@cosmicdrift/kumiko-framework": "workspace:*"
7
+ },
8
+ "devDependencies": {
9
+ "@cosmicdrift/kumiko-testing": "workspace:*"
7
10
  }
8
11
  }