@cosmicdrift/kumiko-samples 0.367.0 → 0.369.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 (406) 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-email/changes.json +7 -0
  39. package/packages/bundled-features/src/channel-email/email-channel.ts +39 -8
  40. package/packages/bundled-features/src/channel-email/feature.ts +1 -1
  41. package/packages/bundled-features/src/channel-email/index.ts +5 -1
  42. package/packages/bundled-features/src/channel-in-app/handlers/inbox.query.ts +1 -1
  43. package/packages/bundled-features/src/channel-in-app/handlers/mark-all-read.write.ts +1 -1
  44. package/packages/bundled-features/src/channel-in-app/handlers/mark-read.write.ts +1 -1
  45. package/packages/bundled-features/src/channel-in-app/handlers/unread-count.query.ts +1 -1
  46. package/packages/bundled-features/src/channel-in-app/tables.ts +1 -1
  47. package/packages/bundled-features/src/compliance-profiles/handlers/for-tenant.query.ts +1 -1
  48. package/packages/bundled-features/src/compliance-profiles/handlers/needs-profile.query.ts +1 -1
  49. package/packages/bundled-features/src/compliance-profiles/handlers/set-profile.write.ts +1 -2
  50. package/packages/bundled-features/src/compliance-profiles/resolve-for-tenant.ts +1 -1
  51. package/packages/bundled-features/src/compliance-profiles/seeding.ts +8 -4
  52. package/packages/bundled-features/src/compliance-profiles-ops/index.ts +26 -17
  53. package/packages/bundled-features/src/config/db/queries/resolver.ts +1 -1
  54. package/packages/bundled-features/src/config/handlers/reencrypt.job.ts +2 -2
  55. package/packages/bundled-features/src/config/resolver.ts +1 -1
  56. package/packages/bundled-features/src/config/web/i18n.ts +1 -2
  57. package/packages/bundled-features/src/config/write-helpers.ts +1 -1
  58. package/packages/bundled-features/src/crypto-shredding/changes.json +6 -0
  59. package/packages/bundled-features/src/crypto-shredding/handlers/forget-subject.write.ts +9 -7
  60. package/packages/bundled-features/src/custom-fields/db/queries/field-access.ts +1 -1
  61. package/packages/bundled-features/src/custom-fields/db/queries/projection.ts +1 -1
  62. package/packages/bundled-features/src/custom-fields/db/queries/quota.ts +1 -1
  63. package/packages/bundled-features/src/custom-fields/db/queries/retention.ts +6 -2
  64. package/packages/bundled-features/src/custom-fields/db/queries/user-data-rights.ts +1 -1
  65. package/packages/bundled-features/src/custom-fields/feature.ts +11 -14
  66. package/packages/bundled-features/src/custom-fields/handlers/clear-custom-field.write.ts +2 -2
  67. package/packages/bundled-features/src/custom-fields/handlers/delete-system-field.write.ts +2 -2
  68. package/packages/bundled-features/src/custom-fields/handlers/delete-tenant-field.write.ts +2 -2
  69. package/packages/bundled-features/src/custom-fields/handlers/set-custom-field.write.ts +2 -2
  70. package/packages/bundled-features/src/custom-fields/wire-for-entity.ts +4 -4
  71. package/packages/bundled-features/src/data-retention/resolve-for-tenant.ts +1 -1
  72. package/packages/bundled-features/src/data-retention/run-retention-cleanup.ts +16 -10
  73. package/packages/bundled-features/src/delivery/address-opt-out.ts +5 -2
  74. package/packages/bundled-features/src/delivery/attempt-log-retention.ts +1 -1
  75. package/packages/bundled-features/src/delivery/changes.json +6 -0
  76. package/packages/bundled-features/src/delivery/channel-context.ts +1 -1
  77. package/packages/bundled-features/src/delivery/db/queries/address-opt-outs.ts +1 -1
  78. package/packages/bundled-features/src/delivery/db/queries/preferences.ts +1 -1
  79. package/packages/bundled-features/src/delivery/delivery-service.ts +16 -6
  80. package/packages/bundled-features/src/delivery/feature.ts +2 -2
  81. package/packages/bundled-features/src/delivery/handlers/log.query.ts +3 -2
  82. package/packages/bundled-features/src/delivery/handlers/preferences.query.ts +1 -1
  83. package/packages/bundled-features/src/delivery/index.ts +8 -1
  84. package/packages/bundled-features/src/delivery/unsubscribe.ts +66 -37
  85. package/packages/bundled-features/src/delivery/upsert-preference.ts +5 -2
  86. package/packages/bundled-features/src/derivatives-sharp/feature.ts +21 -12
  87. package/packages/bundled-features/src/derivatives-sharp/index.ts +1 -1
  88. package/packages/bundled-features/src/document-ingest-foundation/feature.ts +112 -103
  89. package/packages/bundled-features/src/document-ingest-foundation/forget-extract-with-file-ref.ts +3 -3
  90. package/packages/bundled-features/src/document-ingest-foundation/index.ts +4 -1
  91. package/packages/bundled-features/src/feature-toggles/global-feature-state-table.ts +1 -1
  92. package/packages/bundled-features/src/feature-toggles/handlers/set.write.ts +3 -5
  93. package/packages/bundled-features/src/feature-toggles/toggle-runtime.ts +1 -1
  94. package/packages/bundled-features/src/file-derivatives/feature.ts +134 -129
  95. package/packages/bundled-features/src/file-derivatives/handlers/public-variant-by-file-ref.query.ts +1 -1
  96. package/packages/bundled-features/src/file-derivatives/handlers/public-variant.query.ts +1 -1
  97. package/packages/bundled-features/src/file-foundation/feature.ts +38 -29
  98. package/packages/bundled-features/src/file-foundation/index.ts +1 -0
  99. package/packages/bundled-features/src/file-foundation/read-file-ref-content.ts +1 -1
  100. package/packages/bundled-features/src/file-provider-inmemory/feature.ts +32 -21
  101. package/packages/bundled-features/src/file-provider-inmemory/index.ts +6 -1
  102. package/packages/bundled-features/src/file-provider-s3/changes.json +10 -1
  103. package/packages/bundled-features/src/file-provider-s3/env-feature.ts +62 -0
  104. package/packages/bundled-features/src/file-provider-s3/feature.ts +107 -73
  105. package/packages/bundled-features/src/file-provider-s3/index.ts +6 -1
  106. package/packages/bundled-features/src/file-provider-s3/lib/index.ts +3 -0
  107. package/packages/bundled-features/src/{files-provider-s3 → file-provider-s3/lib}/s3-provider.ts +19 -19
  108. package/packages/bundled-features/src/file-provider-s3-env/index.ts +7 -2
  109. package/packages/bundled-features/src/files-provider-s3/index.ts +11 -3
  110. package/packages/bundled-features/src/files-tenant-data/handlers/sweep-orphaned-derivatives.job.ts +1 -1
  111. package/packages/bundled-features/src/files-tenant-data/hooks.ts +1 -2
  112. package/packages/bundled-features/src/folders/feature.ts +8 -3
  113. package/packages/bundled-features/src/folders-user-data/index.ts +27 -18
  114. package/packages/bundled-features/src/form-draft/db/queries/cleanup.ts +1 -1
  115. package/packages/bundled-features/src/form-draft/db/queries/draft-count.ts +1 -1
  116. package/packages/bundled-features/src/form-draft/db/queries/owned-file-refs.ts +3 -2
  117. package/packages/bundled-features/src/form-draft/feature.ts +6 -1
  118. package/packages/bundled-features/src/form-draft/handlers/cleanup.job.ts +2 -2
  119. package/packages/bundled-features/src/form-draft/index.ts +1 -1
  120. package/packages/bundled-features/src/form-draft/lookup.ts +1 -1
  121. package/packages/bundled-features/src/form-draft-user-data/index.ts +19 -10
  122. package/packages/bundled-features/src/inbound-mail-foundation/feature.ts +165 -154
  123. package/packages/bundled-features/src/inbound-mail-foundation/handlers/ingest-message.write.ts +1 -2
  124. package/packages/bundled-features/src/inbound-mail-foundation/index.ts +1 -1
  125. package/packages/bundled-features/src/inbound-mail-foundation/oauth-access-token.ts +5 -2
  126. package/packages/bundled-features/src/inbound-mail-foundation/projection.ts +3 -2
  127. package/packages/bundled-features/src/inbound-mail-foundation/watch-supervisor.ts +1 -1
  128. package/packages/bundled-features/src/inbound-provider-imap/feature.ts +22 -13
  129. package/packages/bundled-features/src/inbound-provider-imap/index.ts +6 -1
  130. package/packages/bundled-features/src/inbound-provider-inmemory/feature.ts +20 -12
  131. package/packages/bundled-features/src/inbound-provider-inmemory/index.ts +1 -0
  132. package/packages/bundled-features/src/jobs/db/queries/retention.ts +1 -1
  133. package/packages/bundled-features/src/jobs/db/queries/stale-run-sweep.ts +1 -1
  134. package/packages/bundled-features/src/jobs/handlers/detail.query.ts +1 -1
  135. package/packages/bundled-features/src/jobs/handlers/list.query.ts +7 -2
  136. package/packages/bundled-features/src/jobs/handlers/retry.write.ts +1 -1
  137. package/packages/bundled-features/src/jobs/handlers/tenant-failures.query.ts +1 -1
  138. package/packages/bundled-features/src/jobs/handlers/tenant-runs.query.ts +1 -1
  139. package/packages/bundled-features/src/jobs/job-run-logger.ts +11 -10
  140. package/packages/bundled-features/src/jobs/tenant-job-failure-table.ts +1 -1
  141. package/packages/bundled-features/src/jobs/tenant-job-run-table.ts +1 -1
  142. package/packages/bundled-features/src/ledger/feature.ts +6 -3
  143. package/packages/bundled-features/src/mail-foundation/feature.ts +66 -46
  144. package/packages/bundled-features/src/mail-foundation/i18n.ts +8 -0
  145. package/packages/bundled-features/src/mail-foundation/index.ts +1 -0
  146. package/packages/bundled-features/src/mail-transport-inmemory/feature.ts +31 -17
  147. package/packages/bundled-features/src/mail-transport-inmemory/index.ts +6 -1
  148. package/packages/bundled-features/src/mail-transport-smtp/changes.json +7 -0
  149. package/packages/bundled-features/src/mail-transport-smtp/config-keys.ts +67 -0
  150. package/packages/bundled-features/src/mail-transport-smtp/feature.ts +67 -82
  151. package/packages/bundled-features/src/mail-transport-smtp/i18n.ts +28 -0
  152. package/packages/bundled-features/src/mail-transport-smtp/index.ts +1 -0
  153. package/packages/bundled-features/src/managed-pages/handlers/by-slug.query.ts +1 -1
  154. package/packages/bundled-features/src/managed-pages/handlers/by-tenant-published.query.ts +1 -2
  155. package/packages/bundled-features/src/managed-pages/handlers/set.write.ts +1 -2
  156. package/packages/bundled-features/src/managed-pages/seeding.ts +8 -4
  157. package/packages/bundled-features/src/metrics/compute.ts +1 -1
  158. package/packages/bundled-features/src/metrics/filters.ts +1 -1
  159. package/packages/bundled-features/src/metrics/validate.ts +1 -1
  160. package/packages/bundled-features/src/notes-history/feature.ts +6 -3
  161. package/packages/bundled-features/src/notes-history/handlers/add-note.write.ts +1 -1
  162. package/packages/bundled-features/src/notes-history-user-data/hooks.ts +1 -1
  163. package/packages/bundled-features/src/notes-history-user-data/index.ts +27 -18
  164. package/packages/bundled-features/src/personal-access-tokens/changes.json +6 -0
  165. package/packages/bundled-features/src/personal-access-tokens/feature.ts +17 -2
  166. package/packages/bundled-features/src/personal-access-tokens/handlers/create.write.ts +1 -1
  167. package/packages/bundled-features/src/personal-access-tokens/handlers/list.query.ts +2 -2
  168. package/packages/bundled-features/src/personal-access-tokens/handlers/revoke.write.ts +1 -1
  169. package/packages/bundled-features/src/personal-access-tokens/resolver.ts +1 -1
  170. package/packages/bundled-features/src/personal-access-tokens/revoke-for-user.ts +2 -2
  171. package/packages/bundled-features/src/personal-access-tokens/roles.ts +8 -6
  172. package/packages/bundled-features/src/personal-access-tokens/screens.ts +2 -0
  173. package/packages/bundled-features/src/readiness/feature.ts +25 -16
  174. package/packages/bundled-features/src/readiness/index.ts +1 -1
  175. package/packages/bundled-features/src/secrets/changes.json +6 -0
  176. package/packages/bundled-features/src/secrets/db/queries/read.ts +1 -1
  177. package/packages/bundled-features/src/secrets/feature.ts +26 -6
  178. package/packages/bundled-features/src/secrets/handlers/delete.write.ts +5 -2
  179. package/packages/bundled-features/src/secrets/handlers/rotate.job.ts +2 -2
  180. package/packages/bundled-features/src/secrets/handlers/set.write.ts +5 -2
  181. package/packages/bundled-features/src/secrets/secrets-context.ts +4 -3
  182. package/packages/bundled-features/src/sessions/db/queries/cleanup.ts +1 -1
  183. package/packages/bundled-features/src/sessions/handlers/detail.query.ts +1 -1
  184. package/packages/bundled-features/src/sessions/handlers/list.query.ts +2 -2
  185. package/packages/bundled-features/src/sessions/handlers/mine.query.ts +1 -1
  186. package/packages/bundled-features/src/sessions/handlers/revoke-all-for-user.write.ts +1 -1
  187. package/packages/bundled-features/src/sessions/handlers/revoke-all-others.write.ts +1 -1
  188. package/packages/bundled-features/src/sessions/handlers/revoke.write.ts +1 -1
  189. package/packages/bundled-features/src/sessions/session-callbacks.ts +14 -7
  190. package/packages/bundled-features/src/sessions/testing.ts +1 -1
  191. package/packages/bundled-features/src/tags/feature.ts +6 -3
  192. package/packages/bundled-features/src/template-resolver/api.ts +1 -1
  193. package/packages/bundled-features/src/template-resolver/constants.ts +0 -1
  194. package/packages/bundled-features/src/template-resolver/handlers/bundle-import.ts +1 -1
  195. package/packages/bundled-features/src/template-resolver/handlers/by-slug.query.ts +1 -1
  196. package/packages/bundled-features/src/template-resolver/handlers/by-tenant.query.ts +1 -2
  197. package/packages/bundled-features/src/template-resolver/handlers/collection-item.query.ts +1 -1
  198. package/packages/bundled-features/src/template-resolver/handlers/collection-list.query.ts +1 -2
  199. package/packages/bundled-features/src/template-resolver/handlers/collection-set.write.ts +1 -1
  200. package/packages/bundled-features/src/template-resolver/handlers/copy-locale.write.ts +1 -1
  201. package/packages/bundled-features/src/template-resolver/handlers/diff-to-system.query.ts +1 -1
  202. package/packages/bundled-features/src/template-resolver/handlers/export-bundle.query.ts +1 -1
  203. package/packages/bundled-features/src/template-resolver/handlers/find-by-id.query.ts +1 -1
  204. package/packages/bundled-features/src/template-resolver/handlers/layout-source.query.ts +1 -1
  205. package/packages/bundled-features/src/template-resolver/handlers/list.query.ts +1 -1
  206. package/packages/bundled-features/src/template-resolver/handlers/overview.query.ts +1 -1
  207. package/packages/bundled-features/src/template-resolver/handlers/reset-to-system.write.ts +1 -1
  208. package/packages/bundled-features/src/template-resolver/handlers/resource-remove.write.ts +1 -1
  209. package/packages/bundled-features/src/template-resolver/handlers/send-test.write.ts +4 -2
  210. package/packages/bundled-features/src/template-resolver/handlers/set.write.ts +1 -1
  211. package/packages/bundled-features/src/template-resolver/handlers/template-write.ts +1 -1
  212. package/packages/bundled-features/src/template-resolver/handlers/tenant-overrides.query.ts +1 -1
  213. package/packages/bundled-features/src/template-resolver/handlers/toggle-status.write.ts +1 -1
  214. package/packages/bundled-features/src/template-resolver/handlers/usage.query.ts +1 -1
  215. package/packages/bundled-features/src/template-resolver/handlers/validate.query.ts +1 -1
  216. package/packages/bundled-features/src/template-resolver/seeding.ts +3 -3
  217. package/packages/bundled-features/src/template-resolver/store-template-resource.ts +1 -1
  218. package/packages/bundled-features/src/template-resolver/template-preview.ts +1 -1
  219. package/packages/bundled-features/src/template-resolver/template-resources.ts +1 -1
  220. package/packages/bundled-features/src/template-resolver/testing.ts +1 -1
  221. package/packages/bundled-features/src/template-resolver-user-data/index.ts +23 -14
  222. package/packages/bundled-features/src/tenant/handlers/active-tenant-ids.query.ts +1 -1
  223. package/packages/bundled-features/src/tenant/handlers/add-member.write.ts +1 -2
  224. package/packages/bundled-features/src/tenant/handlers/cancel-invitation.write.ts +1 -1
  225. package/packages/bundled-features/src/tenant/handlers/invitations.query.ts +1 -1
  226. package/packages/bundled-features/src/tenant/handlers/me.query.ts +1 -1
  227. package/packages/bundled-features/src/tenant/handlers/member-directory.query.ts +1 -1
  228. package/packages/bundled-features/src/tenant/handlers/members.query.ts +1 -1
  229. package/packages/bundled-features/src/tenant/handlers/memberships.query.ts +1 -1
  230. package/packages/bundled-features/src/tenant/handlers/remove-member.write.ts +2 -1
  231. package/packages/bundled-features/src/tenant/handlers/resolve-user-ids.query.ts +1 -1
  232. package/packages/bundled-features/src/tenant/handlers/team-list.query.ts +1 -1
  233. package/packages/bundled-features/src/tenant/handlers/tenant-directory.query.ts +1 -1
  234. package/packages/bundled-features/src/tenant/handlers/update-member-roles.write.ts +1 -2
  235. package/packages/bundled-features/src/tenant/invited-membership.ts +2 -2
  236. package/packages/bundled-features/src/tenant/last-tenant-admin.ts +1 -2
  237. package/packages/bundled-features/src/tenant/seeding.ts +12 -12
  238. package/packages/bundled-features/src/tenant-lifecycle/handlers/cancel-destruction.write.ts +1 -2
  239. package/packages/bundled-features/src/tenant-lifecycle/handlers/request-destruction.write.ts +1 -2
  240. package/packages/bundled-features/src/tenant-lifecycle/lib/revoke-tenant-sessions.ts +1 -1
  241. package/packages/bundled-features/src/tenant-lifecycle/lifecycle-gate.ts +1 -1
  242. package/packages/bundled-features/src/tenant-lifecycle/run-tenant-destroy.ts +3 -3
  243. package/packages/bundled-features/src/tenant-lifecycle/stages.ts +10 -5
  244. package/packages/bundled-features/src/tenant-lifecycle/testing.ts +3 -3
  245. package/packages/bundled-features/src/tenant-settings/feature.ts +34 -29
  246. package/packages/bundled-features/src/tier-engine/feature.ts +426 -428
  247. package/packages/bundled-features/src/tier-engine/handlers/get-tenant-tier.query.ts +2 -3
  248. package/packages/bundled-features/src/tier-engine/handlers/set-tenant-tier.write.ts +5 -2
  249. package/packages/bundled-features/src/user/changes.json +6 -0
  250. package/packages/bundled-features/src/user/db/queries/stream-tenant-backfill.ts +1 -1
  251. package/packages/bundled-features/src/user/handlers/create.write.ts +1 -2
  252. package/packages/bundled-features/src/user/handlers/find-for-auth.query.ts +1 -1
  253. package/packages/bundled-features/src/user/handlers/list.query.ts +1 -1
  254. package/packages/bundled-features/src/user/handlers/update-roles.ts +2 -1
  255. package/packages/bundled-features/src/user/index.ts +5 -1
  256. package/packages/bundled-features/src/user/invited-global-roles.ts +2 -2
  257. package/packages/bundled-features/src/user/principal-status.ts +13 -3
  258. package/packages/bundled-features/src/user/resolve-display-names.ts +1 -1
  259. package/packages/bundled-features/src/user/seeding.ts +5 -5
  260. package/packages/bundled-features/src/user-data-rights/audit-download.ts +2 -2
  261. package/packages/bundled-features/src/user-data-rights/changes.json +6 -0
  262. package/packages/bundled-features/src/user-data-rights/db/queries/export-jobs.ts +1 -1
  263. package/packages/bundled-features/src/user-data-rights/db/queries/forget-cleanup.ts +1 -1
  264. package/packages/bundled-features/src/user-data-rights/feature.ts +7 -4
  265. package/packages/bundled-features/src/user-data-rights/handlers/download-by-job.query.ts +1 -1
  266. package/packages/bundled-features/src/user-data-rights/handlers/download-by-token.query.ts +1 -1
  267. package/packages/bundled-features/src/user-data-rights/handlers/export-status.query.ts +1 -1
  268. package/packages/bundled-features/src/user-data-rights/handlers/list-download-attempts.query.ts +1 -1
  269. package/packages/bundled-features/src/user-data-rights/handlers/my-audit-log.query.ts +1 -1
  270. package/packages/bundled-features/src/user-data-rights/handlers/request-export.write.ts +1 -2
  271. package/packages/bundled-features/src/user-data-rights/handlers/run-forget-cleanup.write.ts +3 -3
  272. package/packages/bundled-features/src/user-data-rights/lib/default-mailers.ts +40 -3
  273. package/packages/bundled-features/src/user-data-rights/lib/deny-if-target-outside-admin-tenant.ts +1 -1
  274. package/packages/bundled-features/src/user-data-rights/lib/update-user-lifecycle.ts +7 -2
  275. package/packages/bundled-features/src/user-data-rights/run-export-jobs.ts +7 -3
  276. package/packages/bundled-features/src/user-data-rights/run-forget-cleanup.ts +11 -5
  277. package/packages/bundled-features/src/user-data-rights/run-user-export.ts +10 -5
  278. package/packages/bundled-features/src/waitlist/handlers/invite.write.ts +1 -2
  279. package/packages/bundled-features/src/waitlist/handlers/reject.write.ts +1 -1
  280. package/packages/bundled-features/src/waitlist/lib.ts +5 -2
  281. package/packages/bundled-features/src/workflow-runner/event-subscriber.ts +1 -1
  282. package/packages/bundled-features/src/workflow-runner/feature.ts +58 -47
  283. package/packages/bundled-features/src/workflow-runner/handlers/resume-run.write.ts +1 -1
  284. package/packages/bundled-features/src/workflow-runner/index.ts +1 -1
  285. package/packages/bundled-features/src/workflow-runner/pending-projection.ts +1 -1
  286. package/samples/apps/admin-console/src/run-config.ts +2 -2
  287. package/samples/apps/cap-billing-demo/package.json +3 -0
  288. package/samples/apps/cap-billing-demo/src/feature.ts +2 -2
  289. package/samples/apps/cap-billing-demo/src/run-config.ts +8 -8
  290. package/samples/apps/marketing-demo/src/app/seed.ts +1 -1
  291. package/samples/apps/marketing-demo/src/db/queries/seed-counts.ts +1 -1
  292. package/samples/apps/showcase/package.json +3 -0
  293. package/samples/apps/showcase/src/app/seed-items.ts +1 -1
  294. package/samples/apps/styleguide/src/app/seed.ts +2 -2
  295. package/samples/apps/styleguide/src/features/ai-settings/seed.ts +2 -2
  296. package/samples/apps/ui-walkthrough/scripts/emit-e2e-data.ts +1 -1
  297. package/samples/apps/ui-walkthrough/src/app/auth-constants.ts +1 -1
  298. package/samples/apps/ui-walkthrough/src/app/seed-rental.ts +2 -2
  299. package/samples/apps/ui-walkthrough/src/app/seed-vehicles.ts +1 -1
  300. package/samples/apps/ui-walkthrough/src/app/seed.ts +1 -1
  301. package/samples/apps/ui-walkthrough/src/db/queries/row-counts.ts +1 -1
  302. package/samples/apps/ui-walkthrough/src/db/queries/task-counts.ts +1 -1
  303. package/samples/apps/use-all-bundled/feature-manifest.json +16 -16
  304. package/samples/apps/use-all-bundled/package.json +3 -0
  305. package/samples/apps/use-all-bundled/scripts/check-coverage.ts +2 -2
  306. package/samples/apps/use-all-bundled/src/app/auth-constants.ts +1 -1
  307. package/samples/apps/use-all-bundled/src/app/cap-overview-caps.ts +2 -2
  308. package/samples/apps/use-all-bundled/src/app/dev-app-options.ts +1 -1
  309. package/samples/apps/use-all-bundled/src/app/seed-documents.ts +1 -1
  310. package/samples/apps/use-all-bundled/src/app/seed.ts +11 -5
  311. package/samples/apps/use-all-bundled/src/run-config.ts +55 -56
  312. package/samples/apps/user-data-rights-demo/README.md +2 -2
  313. package/samples/apps/user-data-rights-demo/package.json +3 -0
  314. package/samples/apps/user-data-rights-demo/src/run-config.ts +7 -7
  315. package/samples/apps/workspaces/package.json +3 -0
  316. package/samples/recipes/access-control/package.json +3 -0
  317. package/samples/recipes/anonymous-access/package.json +3 -0
  318. package/samples/recipes/anonymous-access-multitenant/package.json +3 -0
  319. package/samples/recipes/apex-landing/package.json +1 -0
  320. package/samples/recipes/apex-surface-auth/package.json +3 -0
  321. package/samples/recipes/apex-surface-auth/src/feature.ts +2 -2
  322. package/samples/recipes/api-worker-split/package.json +3 -0
  323. package/samples/recipes/api-worker-split/src/feature.ts +1 -2
  324. package/samples/recipes/auth-claims/package.json +3 -0
  325. package/samples/recipes/auth-foundation-providers/src/feature.ts +1 -1
  326. package/samples/recipes/auth-mfa/package.json +3 -0
  327. package/samples/recipes/basic-entity/package.json +3 -0
  328. package/samples/recipes/chat-channels/package.json +3 -0
  329. package/samples/recipes/compliance-profiles-demo/package.json +3 -0
  330. package/samples/recipes/cross-feature-events/package.json +3 -1
  331. package/samples/recipes/cross-feature-events/src/feature.ts +1 -1
  332. package/samples/recipes/crypto-shredding-hr/package.json +3 -0
  333. package/samples/recipes/currencies-global/package.json +3 -0
  334. package/samples/recipes/currencies-per-tenant/package.json +3 -0
  335. package/samples/recipes/custom-fields-basic/package.json +3 -0
  336. package/samples/recipes/custom-handlers/package.json +3 -0
  337. package/samples/recipes/dashboard-stats/package.json +3 -0
  338. package/samples/recipes/delivery-notifications/package.json +3 -0
  339. package/samples/recipes/e2e-generator/package.json +3 -0
  340. package/samples/recipes/embedded/package.json +3 -0
  341. package/samples/recipes/embedded-entity-form/package.json +1 -0
  342. package/samples/recipes/encrypted-tenant-config/README.md +1 -1
  343. package/samples/recipes/encrypted-tenant-config/package.json +3 -0
  344. package/samples/recipes/error-contract/package.json +3 -0
  345. package/samples/recipes/event-sourcing/package.json +3 -1
  346. package/samples/recipes/event-sourcing/src/feature.ts +16 -20
  347. package/samples/recipes/event-sourcing/tsconfig.json +2 -6
  348. package/samples/recipes/feature-toggles/package.json +3 -0
  349. package/samples/recipes/field-access/package.json +3 -0
  350. package/samples/recipes/files-post-processing/package.json +1 -0
  351. package/samples/recipes/golden-path/README.md +30 -0
  352. package/samples/recipes/golden-path/package.json +11 -0
  353. package/samples/recipes/golden-path/src/feature.ts +70 -0
  354. package/samples/recipes/idempotency/package.json +3 -0
  355. package/samples/recipes/inbound-mail-triage/package.json +3 -0
  356. package/samples/recipes/lane-routing/package.json +3 -0
  357. package/samples/recipes/ledger-banking/package.json +3 -0
  358. package/samples/recipes/ledger-invoicing/package.json +3 -0
  359. package/samples/recipes/legal-pages/package.json +3 -0
  360. package/samples/recipes/lifecycle-hooks/package.json +3 -0
  361. package/samples/recipes/managed-config/package.json +3 -0
  362. package/samples/recipes/managed-pages/package.json +3 -0
  363. package/samples/recipes/notes-history-basic/package.json +3 -0
  364. package/samples/recipes/ownership/package.json +3 -0
  365. package/samples/recipes/pdf-audit-export/package.json +1 -0
  366. package/samples/recipes/pipeline-basics/package.json +3 -0
  367. package/samples/recipes/public-share-token/package.json +3 -0
  368. package/samples/recipes/public-share-token/src/feature.ts +1 -1
  369. package/samples/recipes/rate-limiting/package.json +3 -0
  370. package/samples/recipes/realtime-sse/package.json +3 -0
  371. package/samples/recipes/record-detail-layout/package.json +1 -0
  372. package/samples/recipes/reference-data/package.json +3 -0
  373. package/samples/recipes/relations/package.json +3 -0
  374. package/samples/recipes/screens-nav/package.json +3 -0
  375. package/samples/recipes/search/package.json +3 -0
  376. package/samples/recipes/secrets-demo/package.json +3 -0
  377. package/samples/recipes/security-baseline/src/feature.ts +2 -2
  378. package/samples/recipes/session-revocation/README.md +1 -1
  379. package/samples/recipes/session-revocation/package.json +3 -0
  380. package/samples/recipes/session-revocation/src/feature.ts +1 -1
  381. package/samples/recipes/state-machine/package.json +3 -1
  382. package/samples/recipes/state-machine/src/entities/invoice.ts +2 -2
  383. package/samples/recipes/state-machine/src/events.ts +19 -0
  384. package/samples/recipes/state-machine/src/feature.ts +25 -30
  385. package/samples/recipes/state-machine/src/handlers/_helpers.ts +13 -14
  386. package/samples/recipes/state-machine/src/handlers/create.ts +1 -1
  387. package/samples/recipes/state-machine/src/handlers/transitions.ts +129 -122
  388. package/samples/recipes/state-machine/src/reducer.ts +1 -1
  389. package/samples/recipes/state-machine/tsconfig.json +2 -6
  390. package/samples/recipes/tags-basic/package.json +3 -0
  391. package/samples/recipes/tenant-isolation/package.json +3 -0
  392. package/samples/recipes/tenant-settings/package.json +3 -0
  393. package/samples/recipes/tier-admin/package.json +3 -0
  394. package/samples/recipes/timezones/package.json +3 -0
  395. package/samples/recipes/tsconfig.base.json +1 -1
  396. package/samples/recipes/user-data-rights/package.json +3 -0
  397. package/samples/recipes/user-data-rights/src/feature.ts +6 -2
  398. package/samples/recipes/user-profile/package.json +3 -0
  399. package/samples/recipes/user-profile/src/feature.ts +2 -2
  400. package/samples/recipes/webhook-step/package.json +3 -0
  401. package/samples/recipes/wizard-form/package.json +1 -0
  402. package/samples/recipes/workflow-engine/package.json +3 -0
  403. package/samples/recipes/workflow-engine/src/db/queries/suspended-runs.ts +5 -2
  404. package/samples/recipes/writeform-section/package.json +1 -0
  405. package/packages/bundled-features/src/file-provider-s3-env/feature.ts +0 -58
  406. /package/packages/bundled-features/src/{files-provider-s3 → file-provider-s3/lib}/env-helper.ts +0 -0
@@ -21,20 +21,17 @@
21
21
  // handlers/create.ts — invoice:create (uses executor)
22
22
  // handlers/transitions.ts — the six state-change handlers
23
23
 
24
- import { defineFeature, setFields } from "@app/define";
25
- import { z } from "zod";
24
+ import { defineFeature, setFields, typedPayload } from "@cosmicdrift/kumiko-framework/engine";
26
25
  import { invoiceEntity, invoiceTable } from "./entities/invoice";
27
- import { eventName, INVOICE_EVENTS } from "./events";
28
- import { invoiceCreate } from "./handlers/create";
29
26
  import {
30
- invoiceCancel,
31
- invoiceForceStatus,
32
- invoiceMarkPaid,
33
- invoiceReopen,
34
- invoiceSend,
35
- invoiceUpdateStatus,
36
- } from "./handlers/transitions";
37
- import type { InvoiceStatus } from "./reducer";
27
+ emptyEventPayload,
28
+ eventName,
29
+ INVOICE_EVENTS,
30
+ type InvoiceEvents,
31
+ statusForcedPayload,
32
+ } from "./events";
33
+ import { invoiceCreate } from "./handlers/create";
34
+ import { createInvoiceTransitionHandlers } from "./handlers/transitions";
38
35
 
39
36
  export { invoiceEntity } from "./entities/invoice";
40
37
 
@@ -45,18 +42,15 @@ export const stateMachineFeature = defineFeature("billing", (r) => {
45
42
  // and the projection stay in sync. The auto "invoice.created" event from
46
43
  // the executor's create-path covers the initial insert, so we only declare
47
44
  // the state-change events here.
48
- r.defineEvent(INVOICE_EVENTS.sent, z.object({}), { piiFields: "none" });
49
- r.defineEvent(INVOICE_EVENTS.markedPaid, z.object({}), { piiFields: "none" });
50
- r.defineEvent(INVOICE_EVENTS.cancelled, z.object({}), { piiFields: "none" });
51
- r.defineEvent(INVOICE_EVENTS.reopened, z.object({}), { piiFields: "none" });
52
- r.defineEvent(
53
- INVOICE_EVENTS.statusForced,
54
- z.object({
55
- newStatus: z.enum(["draft", "sent", "paid", "cancelled"]),
56
- fromStatus: z.enum(["draft", "sent", "paid", "cancelled"]),
45
+ const events: InvoiceEvents = {
46
+ sent: r.defineEvent(INVOICE_EVENTS.sent, emptyEventPayload, { piiFields: "none" }),
47
+ markedPaid: r.defineEvent(INVOICE_EVENTS.markedPaid, emptyEventPayload, { piiFields: "none" }),
48
+ cancelled: r.defineEvent(INVOICE_EVENTS.cancelled, emptyEventPayload, { piiFields: "none" }),
49
+ reopened: r.defineEvent(INVOICE_EVENTS.reopened, emptyEventPayload, { piiFields: "none" }),
50
+ statusForced: r.defineEvent(INVOICE_EVENTS.statusForced, statusForcedPayload, {
51
+ piiFields: "none",
57
52
  }),
58
- { piiFields: "none" },
59
- );
53
+ };
60
54
 
61
55
  // The aggregate table (sample_sm_invoices) is INSERTed by the executor on
62
56
  // invoice:create. State-change events update the same row via this inline
@@ -74,16 +68,17 @@ export const stateMachineFeature = defineFeature("billing", (r) => {
74
68
  [eventName(INVOICE_EVENTS.cancelled)]: setFields(invoiceTable, { status: "cancelled" }),
75
69
  [eventName(INVOICE_EVENTS.reopened)]: setFields(invoiceTable, { status: "draft" }),
76
70
  [eventName(INVOICE_EVENTS.statusForced)]: setFields(invoiceTable, (e) => ({
77
- status: (e.payload as { newStatus: InvoiceStatus }).newStatus,
71
+ status: typedPayload(e, events.statusForced).newStatus,
78
72
  })),
79
73
  },
80
74
  });
81
75
 
76
+ const transitions = createInvoiceTransitionHandlers(events);
82
77
  r.writeHandler(invoiceCreate);
83
- r.writeHandler(invoiceSend);
84
- r.writeHandler(invoiceMarkPaid);
85
- r.writeHandler(invoiceCancel);
86
- r.writeHandler(invoiceReopen);
87
- r.writeHandler(invoiceUpdateStatus);
88
- r.writeHandler(invoiceForceStatus);
78
+ r.writeHandler(transitions.invoiceSend);
79
+ r.writeHandler(transitions.invoiceMarkPaid);
80
+ r.writeHandler(transitions.invoiceCancel);
81
+ r.writeHandler(transitions.invoiceReopen);
82
+ r.writeHandler(transitions.invoiceUpdateStatus);
83
+ r.writeHandler(transitions.invoiceForceStatus);
89
84
  });
@@ -2,25 +2,25 @@
2
2
  // optionally guardTransition, append the domain event, return a WriteResult
3
3
  // that reflects the post-write status.
4
4
 
5
- import type { AccessRule, KumikoEventTypeMap } from "@app/define";
6
- import { defineWriteHandler, guardTransition } from "@app/define";
5
+ import {
6
+ type AccessRule,
7
+ defineWriteHandler,
8
+ type EventDef,
9
+ emitEvent,
10
+ guardTransition,
11
+ } from "@cosmicdrift/kumiko-framework/engine";
7
12
  import { failNotFound } from "@cosmicdrift/kumiko-framework/errors";
8
13
  import { z } from "zod";
9
14
  import { INVOICE_TRANSITIONS } from "../entities/invoice";
10
- import { ENTITY_NAME } from "../events";
15
+ import { ENTITY_NAME, type emptyEventPayload } from "../events";
11
16
  import { type InvoiceStatus, loadInvoiceState } from "../reducer";
12
17
 
13
- // Narrow TEvent to event-types whose payload is `{}` — this helper
14
- // always emits an empty payload. Anyone trying to use it with a non-
15
- // empty-payload event-type gets caught at the call-site, not at runtime.
16
- type EmptyPayloadEvent = {
17
- [K in keyof KumikoEventTypeMap]: KumikoEventTypeMap[K] extends Record<string, never> ? K : never;
18
- }[keyof KumikoEventTypeMap];
19
-
20
- export function transitionHandler<const TEvent extends EmptyPayloadEvent>(opts: {
18
+ // The event carries an empty payload — this helper always emits `{}`, so an EventDef with a
19
+ // non-empty payload is a compile error at the call site.
20
+ export function transitionHandler(opts: {
21
21
  name: string;
22
22
  toStatus: InvoiceStatus;
23
- eventType: TEvent;
23
+ event: EventDef<z.infer<typeof emptyEventPayload>>;
24
24
  access: AccessRule;
25
25
  skipGuard?: boolean;
26
26
  }) {
@@ -41,10 +41,9 @@ export function transitionHandler<const TEvent extends EmptyPayloadEvent>(opts:
41
41
  guardTransition(INVOICE_TRANSITIONS, state.status as InvoiceStatus, opts.toStatus);
42
42
  }
43
43
 
44
- await ctx.appendEvent({
44
+ await emitEvent(ctx, opts.event, {
45
45
  aggregateId: event.payload.id,
46
46
  aggregateType: ENTITY_NAME,
47
- type: opts.eventType,
48
47
  payload: {},
49
48
  });
50
49
 
@@ -6,8 +6,8 @@
6
6
  // keeps amount + amountCurrency flat, while the entity stores them as a
7
7
  // money pair.
8
8
 
9
- import { defineWriteHandler } from "@app/define";
10
9
  import { createEventStoreExecutor } from "@cosmicdrift/kumiko-framework/db";
10
+ import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
11
11
  import { z } from "zod";
12
12
  import { invoiceEntity, invoiceTable } from "../entities/invoice";
13
13
 
@@ -3,135 +3,142 @@
3
3
  // little extra logic (amount-check, verb routing, dedicated forced-event)
4
4
  // and stay inline so the variation is visible at the call site.
5
5
 
6
- import { defineWriteHandler, guardTransition } from "@app/define";
6
+ import {
7
+ defineWriteHandler,
8
+ emitEvent,
9
+ guardTransition,
10
+ } from "@cosmicdrift/kumiko-framework/engine";
7
11
  import { failNotFound, failUnprocessable } from "@cosmicdrift/kumiko-framework/errors";
8
12
  import { z } from "zod";
9
13
  import { INVOICE_STATES, INVOICE_TRANSITIONS } from "../entities/invoice";
10
- import { ENTITY_NAME, eventName, INVOICE_EVENTS } from "../events";
14
+ import { ENTITY_NAME, type InvoiceEvents } from "../events";
11
15
  import { type InvoiceStatus, loadInvoiceState } from "../reducer";
12
16
  import { successResult, transitionHandler } from "./_helpers";
13
17
 
14
18
  const adminOnly = { roles: ["Admin"] } as const;
15
19
 
16
- // --- Standard transitions (same shape, different target status) ---
17
-
18
- export const invoiceSend = transitionHandler({
19
- name: "invoice:send",
20
- toStatus: "sent",
21
- eventType: eventName(INVOICE_EVENTS.sent),
22
- access: adminOnly,
23
- });
24
-
25
- export const invoiceCancel = transitionHandler({
26
- name: "invoice:cancel",
27
- toStatus: "cancelled",
28
- eventType: eventName(INVOICE_EVENTS.cancelled),
29
- access: adminOnly,
30
- });
31
-
32
- export const invoiceReopen = transitionHandler({
33
- name: "invoice:reopen",
34
- toStatus: "draft",
35
- eventType: eventName(INVOICE_EVENTS.reopened),
36
- access: adminOnly,
37
- });
38
-
39
- // --- markPaid: same shape + business rule (amount must be > 0).
40
- // The amount is reduced from the event stream, so the check stays
41
- // consistent with everything else (no out-of-band DB query).
42
-
43
- export const invoiceMarkPaid = defineWriteHandler({
44
- name: "invoice:mark-paid",
45
- schema: z.object({ id: z.uuid() }),
46
- access: { roles: ["Accounting"] },
47
- handler: async (event, ctx) => {
48
- const state = await loadInvoiceState(ctx, event.payload.id);
49
- if (!state) return failNotFound(ENTITY_NAME, event.payload.id);
50
-
51
- guardTransition(INVOICE_TRANSITIONS, state.status as InvoiceStatus, "paid");
52
-
53
- if (state.amount === 0) {
54
- return failUnprocessable("cannot_pay_zero_amount");
55
- }
56
-
57
- await ctx.appendEvent({
58
- aggregateId: event.payload.id,
59
- aggregateType: ENTITY_NAME,
60
- type: eventName(INVOICE_EVENTS.markedPaid),
61
- payload: {},
62
- });
63
-
64
- return successResult(event.payload.id, "paid", state.status);
65
- },
66
- });
67
-
68
- // --- updateStatus: relies on the pipeline's auto transition guard.
69
- // Routes the requested status to the matching domain event so the audit
70
- // log still reads as a workflow step ("invoice-sent"), not a generic
71
- // "status set to ...".
72
-
73
- // `as const satisfies` keeps the literal-strings alive (so each value is
74
- // `"billing:event:invoice-..."` literally typed, not just `string`) AND
75
- // type-checks the shape against `Record<InvoiceStatus, string>` —
76
- // missing-status entries fail at compile-time. Strict-mode for
77
- // ctx.appendEvent kicks in because `VERB_TO_EVENT[target]` resolves to
78
- // a union of literal event-names, all of which are augmented keys.
79
- const VERB_TO_EVENT = {
80
- draft: eventName(INVOICE_EVENTS.reopened),
81
- sent: eventName(INVOICE_EVENTS.sent),
82
- paid: eventName(INVOICE_EVENTS.markedPaid),
83
- cancelled: eventName(INVOICE_EVENTS.cancelled),
84
- } as const satisfies Record<InvoiceStatus, string>;
85
-
86
- export const invoiceUpdateStatus = defineWriteHandler({
87
- name: "invoice:update-status",
88
- schema: z.object({
89
- id: z.uuid(),
90
- changes: z.object({
20
+ export function createInvoiceTransitionHandlers(events: InvoiceEvents) {
21
+ // --- Standard transitions (same shape, different target status) ---
22
+
23
+ const invoiceSend = transitionHandler({
24
+ name: "invoice:send",
25
+ toStatus: "sent",
26
+ event: events.sent,
27
+ access: adminOnly,
28
+ });
29
+
30
+ const invoiceCancel = transitionHandler({
31
+ name: "invoice:cancel",
32
+ toStatus: "cancelled",
33
+ event: events.cancelled,
34
+ access: adminOnly,
35
+ });
36
+
37
+ const invoiceReopen = transitionHandler({
38
+ name: "invoice:reopen",
39
+ toStatus: "draft",
40
+ event: events.reopened,
41
+ access: adminOnly,
42
+ });
43
+
44
+ // --- markPaid: same shape + business rule (amount must be > 0).
45
+ // The amount is reduced from the event stream, so the check stays
46
+ // consistent with everything else (no out-of-band DB query).
47
+
48
+ const invoiceMarkPaid = defineWriteHandler({
49
+ name: "invoice:mark-paid",
50
+ schema: z.object({ id: z.uuid() }),
51
+ access: { roles: ["Accounting"] },
52
+ handler: async (event, ctx) => {
53
+ const state = await loadInvoiceState(ctx, event.payload.id);
54
+ if (!state) return failNotFound(ENTITY_NAME, event.payload.id);
55
+
56
+ guardTransition(INVOICE_TRANSITIONS, state.status as InvoiceStatus, "paid");
57
+
58
+ if (state.amount === 0) {
59
+ return failUnprocessable("cannot_pay_zero_amount");
60
+ }
61
+
62
+ await emitEvent(ctx, events.markedPaid, {
63
+ aggregateId: event.payload.id,
64
+ aggregateType: ENTITY_NAME,
65
+ payload: {},
66
+ });
67
+
68
+ return successResult(event.payload.id, "paid", state.status);
69
+ },
70
+ });
71
+
72
+ // --- updateStatus: relies on the pipeline's auto transition guard.
73
+ // Routes the requested status to the matching domain event so the audit
74
+ // log still reads as a workflow step ("invoice-sent"), not a generic
75
+ // "status set to ...".
76
+
77
+ // `satisfies Record<InvoiceStatus, ...>` makes a missing status a compile error.
78
+ const verbToEvent = {
79
+ draft: events.reopened,
80
+ sent: events.sent,
81
+ paid: events.markedPaid,
82
+ cancelled: events.cancelled,
83
+ } satisfies Record<InvoiceStatus, InvoiceEvents["sent"]>;
84
+
85
+ const invoiceUpdateStatus = defineWriteHandler({
86
+ name: "invoice:update-status",
87
+ schema: z.object({
88
+ id: z.uuid(),
89
+ changes: z.object({
90
+ status: z.enum(INVOICE_STATES),
91
+ }),
92
+ }),
93
+ access: adminOnly,
94
+ // No skipTransitionGuard — pipeline auto-guards.
95
+ handler: async (event, ctx) => {
96
+ const state = await loadInvoiceState(ctx, event.payload.id);
97
+ if (!state) return failNotFound(ENTITY_NAME, event.payload.id);
98
+
99
+ const target = event.payload.changes.status;
100
+ await emitEvent(ctx, verbToEvent[target], {
101
+ aggregateId: event.payload.id,
102
+ aggregateType: ENTITY_NAME,
103
+ payload: {},
104
+ });
105
+
106
+ return successResult(event.payload.id, target, state.status);
107
+ },
108
+ });
109
+
110
+ // --- forceStatus: skips the guard and emits a dedicated "forced" event so
111
+ // admin overrides stay visually distinct from normal workflow events in
112
+ // the audit log.
113
+
114
+ const invoiceForceStatus = defineWriteHandler({
115
+ name: "invoice:force-status",
116
+ schema: z.object({
117
+ id: z.uuid(),
91
118
  status: z.enum(INVOICE_STATES),
92
119
  }),
93
- }),
94
- access: adminOnly,
95
- // No skipTransitionGuard — pipeline auto-guards.
96
- handler: async (event, ctx) => {
97
- const state = await loadInvoiceState(ctx, event.payload.id);
98
- if (!state) return failNotFound(ENTITY_NAME, event.payload.id);
99
-
100
- const target = event.payload.changes.status;
101
- await ctx.appendEvent({
102
- aggregateId: event.payload.id,
103
- aggregateType: ENTITY_NAME,
104
- type: VERB_TO_EVENT[target],
105
- payload: {},
106
- });
107
-
108
- return successResult(event.payload.id, target, state.status);
109
- },
110
- });
111
-
112
- // --- forceStatus: skips the guard and emits a dedicated "forced" event so
113
- // admin overrides stay visually distinct from normal workflow events in
114
- // the audit log.
115
-
116
- export const invoiceForceStatus = defineWriteHandler({
117
- name: "invoice:force-status",
118
- schema: z.object({
119
- id: z.uuid(),
120
- status: z.enum(INVOICE_STATES),
121
- }),
122
- access: adminOnly,
123
- unsafeSkipTransitionGuard: true,
124
- handler: async (event, ctx) => {
125
- const state = await loadInvoiceState(ctx, event.payload.id);
126
- if (!state) return failNotFound(ENTITY_NAME, event.payload.id);
127
-
128
- await ctx.appendEvent({
129
- aggregateId: event.payload.id,
130
- aggregateType: ENTITY_NAME,
131
- type: eventName(INVOICE_EVENTS.statusForced),
132
- payload: { newStatus: event.payload.status, fromStatus: state.status as InvoiceStatus },
133
- });
134
-
135
- return successResult(event.payload.id, event.payload.status, state.status);
136
- },
137
- });
120
+ access: adminOnly,
121
+ unsafeSkipTransitionGuard: true,
122
+ handler: async (event, ctx) => {
123
+ const state = await loadInvoiceState(ctx, event.payload.id);
124
+ if (!state) return failNotFound(ENTITY_NAME, event.payload.id);
125
+
126
+ await emitEvent(ctx, events.statusForced, {
127
+ aggregateId: event.payload.id,
128
+ aggregateType: ENTITY_NAME,
129
+ payload: { newStatus: event.payload.status, fromStatus: state.status as InvoiceStatus },
130
+ });
131
+
132
+ return successResult(event.payload.id, event.payload.status, state.status);
133
+ },
134
+ });
135
+
136
+ return {
137
+ invoiceSend,
138
+ invoiceCancel,
139
+ invoiceReopen,
140
+ invoiceMarkPaid,
141
+ invoiceUpdateStatus,
142
+ invoiceForceStatus,
143
+ };
144
+ }
@@ -7,7 +7,7 @@
7
7
  // and update the relevant `case` in `reduceInvoice` — that's the whole
8
8
  // contract.
9
9
 
10
- import type { HandlerContext } from "@app/define";
10
+ import type { HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
11
11
  import { eventName, INVOICE_CREATED_EVENT, INVOICE_EVENTS } from "./events";
12
12
 
13
13
  export type InvoiceStatus = "draft" | "sent" | "paid" | "cancelled";
@@ -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
  }
@@ -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
  }
@@ -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
  }
@@ -1,5 +1,5 @@
1
1
  {
2
- "_comment": "Single source of truth \u2014 check-app-tsc reads this template and overlays the @app/define branch for codegen recipes. Paths are relative to samples/recipes/<name>/.",
2
+ "_comment": "Single source of truth \u2014 check-app-tsc reads this template. Paths are relative to samples/recipes/<name>/.",
3
3
  "extends": "../../../tsconfig.json",
4
4
  "compilerOptions": {
5
5
  "paths": {
@@ -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
  }
@@ -16,8 +16,12 @@
16
16
  // - HTTP-Endpoints fuer create/list
17
17
  // - Compliance-Profile-Wiring + Cron-Scheduling
18
18
 
19
- import { deleteMany, selectMany, updateMany } from "@cosmicdrift/kumiko-framework/bun-db";
20
- import { deriveEntityTableMeta } from "@cosmicdrift/kumiko-framework/db";
19
+ import {
20
+ deleteMany,
21
+ deriveEntityTableMeta,
22
+ selectMany,
23
+ updateMany,
24
+ } from "@cosmicdrift/kumiko-framework/db";
21
25
  import {
22
26
  createEntity,
23
27
  createTextField,
@@ -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
  }
@@ -14,7 +14,7 @@
14
14
  // })
15
15
 
16
16
  import { createAuthEmailPasswordFeature } from "@cosmicdrift/kumiko-bundled-features/auth-email-password";
17
- import { authFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
17
+ import { createAuthFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
18
18
  import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
19
19
  import { createConfigFeature } from "@cosmicdrift/kumiko-bundled-features/config";
20
20
  import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
@@ -59,7 +59,7 @@ export function composeAccountApp(): FeatureDefinition[] {
59
59
  createAuthEmailPasswordFeature(),
60
60
  createDataRetentionFeature(),
61
61
  createComplianceProfilesFeature(),
62
- authFoundationFeature,
62
+ createAuthFoundationFeature(),
63
63
  createPersonalAccessTokensFeature({ scopes: {} }),
64
64
  createSessionsFeature(),
65
65
  createFilesFeature(),
@@ -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
  }
@@ -15,6 +15,7 @@
15
15
  },
16
16
  "devDependencies": {
17
17
  "@cosmicdrift/kumiko-server-runtime": "workspace:*",
18
+ "@cosmicdrift/kumiko-testing": "workspace:*",
18
19
  "@playwright/test": "^1.62.1",
19
20
  "@tailwindcss/cli": "^4.3.0",
20
21
  "@types/react": "^19.2.14",
@@ -5,5 +5,8 @@
5
5
  "scripts": {
6
6
  "test": "bun test",
7
7
  "test:run": "bun test"
8
+ },
9
+ "devDependencies": {
10
+ "@cosmicdrift/kumiko-testing": "workspace:*"
8
11
  }
9
12
  }
@@ -1,5 +1,8 @@
1
- import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
2
- import { type DbRunner, toPostgresArrayLiteral } from "@cosmicdrift/kumiko-framework/db";
1
+ import {
2
+ asRawClient,
3
+ type DbRunner,
4
+ toPostgresArrayLiteral,
5
+ } from "@cosmicdrift/kumiko-framework/db";
3
6
 
4
7
  export async function selectExpiredSuspensionEvents(
5
8
  db: DbRunner,
@@ -15,6 +15,7 @@
15
15
  },
16
16
  "devDependencies": {
17
17
  "@cosmicdrift/kumiko-server-runtime": "workspace:*",
18
+ "@cosmicdrift/kumiko-testing": "workspace:*",
18
19
  "@playwright/test": "^1.62.1",
19
20
  "@tailwindcss/cli": "^4.3.0",
20
21
  "@types/react": "^19.2.14",