@cosmicdrift/kumiko-bundled-features 0.413.0 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (588) hide show
  1. package/dist/admin-shell/feature.js +2 -2
  2. package/dist/agent-tools/agent-doc-lint.js +2 -1
  3. package/dist/agent-tools/agent-manifest.js +33 -25
  4. package/dist/agent-tools/api-docs/collect-events.js +4 -1
  5. package/dist/agent-tools/api-docs/collect.js +3 -3
  6. package/dist/agent-tools/api-docs/generate.js +4 -1
  7. package/dist/agent-tools/api-docs/index.d.ts +1 -0
  8. package/dist/agent-tools/api-docs/index.js +1 -0
  9. package/dist/agent-tools/api-docs/problems.d.ts +21 -0
  10. package/dist/agent-tools/api-docs/problems.js +11 -1
  11. package/dist/agent-tools/api-docs/render-openapi.js +2 -0
  12. package/dist/agent-tools/api-docs/resolve-config.d.ts +9 -0
  13. package/dist/agent-tools/api-docs/resolve-config.js +11 -0
  14. package/dist/agent-tools/api-docs/scope-slug-collisions.d.ts +4 -0
  15. package/dist/agent-tools/api-docs/scope-slug-collisions.js +10 -0
  16. package/dist/agent-tools/api-docs/translation-gaps.d.ts +4 -0
  17. package/dist/agent-tools/api-docs/translation-gaps.js +29 -0
  18. package/dist/agent-tools/api-docs/webhook-example-problems.d.ts +6 -0
  19. package/dist/agent-tools/api-docs/webhook-example-problems.js +25 -0
  20. package/dist/agent-tools/index.d.ts +1 -1
  21. package/dist/agent-tools/index.js +1 -1
  22. package/dist/agent-tools/labels.d.ts +3 -2
  23. package/dist/agent-tools/labels.js +21 -4
  24. package/dist/agent-tools/tool-catalog.d.ts +5 -5
  25. package/dist/agent-tools/tool-catalog.js +12 -10
  26. package/dist/agent-tools/tool-dispatch.js +11 -1
  27. package/dist/agent-tools/types.d.ts +4 -0
  28. package/dist/audit/event-classification.js +6 -0
  29. package/dist/audit/web/i18n.js +1 -0
  30. package/dist/auth-email-password/errors.js +0 -13
  31. package/dist/auth-email-password/handlers/invite-signup-complete.write.js +101 -84
  32. package/dist/auth-email-password/handlers/login-options.query.js +1 -1
  33. package/dist/auth-email-password/handlers/request-account-unlock.write.js +1 -1
  34. package/dist/auth-email-password/handlers/request-email-verification.write.js +0 -1
  35. package/dist/auth-email-password/handlers/request-password-reset.write.js +0 -1
  36. package/dist/auth-email-password/handlers/self-registration-status.query.js +1 -1
  37. package/dist/auth-email-password/reset-token.js +0 -2
  38. package/dist/auth-email-password/seeding.js +34 -8
  39. package/dist/auth-email-password/unlock-token.js +0 -2
  40. package/dist/auth-email-password/verification-token.js +0 -2
  41. package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
  42. package/dist/auth-email-password/web/auth-gate.js +2 -2
  43. package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
  44. package/dist/auth-email-password/web/auth-redirect.js +4 -0
  45. package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
  46. package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
  47. package/dist/auth-email-password/web/return-path.d.ts +2 -1
  48. package/dist/auth-email-password/web/return-path.js +2 -1
  49. package/dist/auth-email-password/web/session.js +11 -12
  50. package/dist/auth-email-password/web/signup-screen.js +1 -5
  51. package/dist/auth-email-password/web/static-account.js +6 -2
  52. package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
  53. package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
  54. package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
  55. package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
  56. package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
  57. package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
  58. package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
  59. package/dist/auth-mfa-user-data/index.js +5 -6
  60. package/dist/billing-foundation/aggregate-id.js +0 -4
  61. package/dist/billing-foundation/checkout-core.js +8 -1
  62. package/dist/billing-foundation/checkout-ledger.d.ts +15 -0
  63. package/dist/billing-foundation/checkout-ledger.js +32 -0
  64. package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
  65. package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
  66. package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
  67. package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
  68. package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
  69. package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
  70. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
  71. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
  72. package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
  73. package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
  74. package/dist/billing-foundation/events.d.ts +22 -0
  75. package/dist/billing-foundation/events.js +38 -10
  76. package/dist/billing-foundation/feature.js +12 -1
  77. package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
  78. package/dist/billing-foundation/handlers/create-checkout-session.write.js +1 -1
  79. package/dist/billing-foundation/handlers/process-event.write.d.ts +2 -2
  80. package/dist/billing-foundation/handlers/process-event.write.js +94 -12
  81. package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
  82. package/dist/billing-foundation/handlers/process-payment-event.write.js +29 -9
  83. package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
  84. package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
  85. package/dist/billing-foundation/handlers/start-plan-checkout.write.js +1 -1
  86. package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
  87. package/dist/billing-foundation/i18n.js +3 -0
  88. package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
  89. package/dist/billing-foundation/pending-plan-switch.js +57 -0
  90. package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
  91. package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
  92. package/dist/billing-foundation/types.d.ts +40 -24
  93. package/dist/billing-foundation/validate-options.js +14 -0
  94. package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
  95. package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
  96. package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
  97. package/dist/billing-foundation/web/constants.d.ts +3 -0
  98. package/dist/billing-foundation/web/constants.js +5 -2
  99. package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
  100. package/dist/billing-foundation/webhook-handler.js +53 -11
  101. package/dist/cap-counter/aggregate-id.js +0 -2
  102. package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
  103. package/dist/cap-counter/stock-cap-guard.js +18 -4
  104. package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
  105. package/dist/cap-overview/i18n.js +1 -0
  106. package/dist/cap-overview/index.d.ts +1 -1
  107. package/dist/cap-overview/types.d.ts +4 -0
  108. package/dist/cap-overview/web/cap-cards-panel.js +6 -2
  109. package/dist/cap-overview/web/cap-usage-bar.js +6 -1
  110. package/dist/cap-overview/web/usage-math.d.ts +1 -0
  111. package/dist/cap-overview/web/usage-math.js +4 -0
  112. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
  113. package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
  114. package/dist/channel-whatsapp/aggregate-id.js +18 -0
  115. package/dist/channel-whatsapp/constants.d.ts +25 -0
  116. package/dist/channel-whatsapp/constants.js +36 -0
  117. package/dist/channel-whatsapp/events.d.ts +87 -0
  118. package/dist/channel-whatsapp/events.js +70 -0
  119. package/dist/channel-whatsapp/feature.d.ts +3 -0
  120. package/dist/channel-whatsapp/feature.js +56 -0
  121. package/dist/channel-whatsapp/graph-client.d.ts +85 -0
  122. package/dist/channel-whatsapp/graph-client.js +272 -0
  123. package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
  124. package/dist/channel-whatsapp/in-memory-meta.js +181 -0
  125. package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
  126. package/dist/channel-whatsapp/inbound-handlers.js +127 -0
  127. package/dist/channel-whatsapp/index.d.ts +10 -0
  128. package/dist/channel-whatsapp/index.js +10 -0
  129. package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
  130. package/dist/channel-whatsapp/meta-signature.js +19 -0
  131. package/dist/channel-whatsapp/options.d.ts +32 -0
  132. package/dist/channel-whatsapp/options.js +83 -0
  133. package/dist/channel-whatsapp/pii.d.ts +32 -0
  134. package/dist/channel-whatsapp/pii.js +61 -0
  135. package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
  136. package/dist/channel-whatsapp/webhook-normalize.js +185 -0
  137. package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
  138. package/dist/channel-whatsapp/webhook-routes.js +118 -0
  139. package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
  140. package/dist/config/handlers/set.write.js +7 -0
  141. package/dist/config/handlers/values.query.js +8 -1
  142. package/dist/config/index.d.ts +1 -1
  143. package/dist/config/index.js +1 -1
  144. package/dist/config/read-redaction.d.ts +1 -0
  145. package/dist/config/read-redaction.js +5 -2
  146. package/dist/config/table.js +1 -0
  147. package/dist/config/write-helpers.js +3 -2
  148. package/dist/crypto-shredding/constants.d.ts +1 -0
  149. package/dist/crypto-shredding/constants.js +1 -0
  150. package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
  151. package/dist/crypto-shredding/index.d.ts +1 -0
  152. package/dist/crypto-shredding/index.js +1 -0
  153. package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
  154. package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
  155. package/dist/custom-fields/aggregate-id.js +0 -1
  156. package/dist/custom-fields/entity.js +1 -0
  157. package/dist/custom-fields/wire-for-entity.js +0 -1
  158. package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
  159. package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
  160. package/dist/data-retention/feature.js +4 -7
  161. package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
  162. package/dist/data-retention/run-retention-cleanup.js +39 -19
  163. package/dist/data-retention/tenant-destruction-hold.js +7 -0
  164. package/dist/delivery/attempt-log-factory.d.ts +3 -0
  165. package/dist/delivery/attempt-log-factory.js +5 -0
  166. package/dist/delivery/attempt-log.d.ts +2 -2
  167. package/dist/delivery/channel-context.d.ts +1 -1
  168. package/dist/delivery/channel-context.js +5 -2
  169. package/dist/delivery/db/queries/preferences.js +0 -1
  170. package/dist/delivery/delivery-service.js +3 -0
  171. package/dist/delivery/feature.d.ts +1 -4
  172. package/dist/delivery/feature.js +3 -1
  173. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
  174. package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
  175. package/dist/delivery/handlers/opted-in-user-ids.query.js +41 -0
  176. package/dist/delivery/handlers/preferences.query.js +2 -20
  177. package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
  178. package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
  179. package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
  180. package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
  181. package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
  182. package/dist/delivery/index.d.ts +3 -1
  183. package/dist/delivery/index.js +1 -0
  184. package/dist/delivery/options.d.ts +4 -0
  185. package/dist/delivery/options.js +1 -0
  186. package/dist/delivery/preference-rows.d.ts +9 -0
  187. package/dist/delivery/preference-rows.js +22 -0
  188. package/dist/delivery/set-preference-enabled.d.ts +17 -0
  189. package/dist/delivery/set-preference-enabled.js +26 -0
  190. package/dist/delivery/tables.d.ts +2 -2
  191. package/dist/delivery/testing.d.ts +1 -1
  192. package/dist/delivery/testing.js +3 -1
  193. package/dist/delivery/types.d.ts +1 -0
  194. package/dist/delivery/unsubscribe-page.js +5 -1
  195. package/dist/delivery/upsert-preference.js +0 -1
  196. package/dist/delivery/web/public-names.d.ts +1 -0
  197. package/dist/delivery/web/public-names.js +1 -0
  198. package/dist/derivatives-sharp/render.js +9 -9
  199. package/dist/document-ingest-foundation/aggregate-id.js +0 -1
  200. package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
  201. package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
  202. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
  203. package/dist/document-ingest-foundation/report-ingest-progress.js +29 -13
  204. package/dist/documents/aggregate-id.js +0 -2
  205. package/dist/documents/constants.d.ts +6 -0
  206. package/dist/documents/constants.js +8 -2
  207. package/dist/documents/ensure-link.d.ts +5 -8
  208. package/dist/documents/ensure-link.js +4 -2
  209. package/dist/documents/feature.d.ts +3 -1
  210. package/dist/documents/feature.js +24 -5
  211. package/dist/documents/handlers/import.write.js +2 -2
  212. package/dist/documents/queries/expiry-overview.query.js +2 -1
  213. package/dist/documents/queries/for-record.query.js +3 -4
  214. package/dist/documents/queries/list-page.js +11 -3
  215. package/dist/documents/queries/overview.query.js +2 -2
  216. package/dist/documents/screens.js +3 -3
  217. package/dist/documents/tab.js +1 -1
  218. package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
  219. package/dist/feature-toggles/toggle-sync-signal.js +3 -2
  220. package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
  221. package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
  222. package/dist/file-foundation/probe.js +9 -3
  223. package/dist/file-foundation/read-file-ref-content.js +23 -11
  224. package/dist/file-provider-inmemory/feature.js +1 -1
  225. package/dist/file-provider-s3/env-feature.js +1 -1
  226. package/dist/file-provider-s3/env-named-feature.js +1 -1
  227. package/dist/file-provider-s3/env-schema.d.ts +10 -1
  228. package/dist/file-provider-s3/env-schema.js +20 -7
  229. package/dist/file-provider-s3/feature.js +1 -1
  230. package/dist/file-provider-s3/index.d.ts +1 -1
  231. package/dist/file-provider-s3/index.js +1 -1
  232. package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
  233. package/dist/file-provider-s3/lib/env-helper.js +13 -12
  234. package/dist/file-provider-s3/lib/s3-provider.js +10 -2
  235. package/dist/folders/aggregate-id.js +0 -1
  236. package/dist/folders/web/folder-manager.js +1 -1
  237. package/dist/folders-user-data/index.js +12 -14
  238. package/dist/helpdesk/entity.js +4 -1
  239. package/dist/helpdesk/feature.js +36 -0
  240. package/dist/helpdesk/handlers/access.d.ts +0 -1
  241. package/dist/helpdesk/handlers/access.js +0 -3
  242. package/dist/helpdesk/handlers/attempts.js +7 -13
  243. package/dist/helpdesk/handlers/challenge.query.js +1 -2
  244. package/dist/helpdesk/handlers/reply.write.js +4 -5
  245. package/dist/helpdesk/handlers/report.write.js +3 -7
  246. package/dist/helpdesk/handlers/submit.write.js +4 -9
  247. package/dist/helpdesk/index.d.ts +1 -1
  248. package/dist/helpdesk/index.js +1 -1
  249. package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
  250. package/dist/helpdesk/legacy-contact-config.js +57 -0
  251. package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
  252. package/dist/helpdesk/legacy-contact-erasure.js +19 -0
  253. package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
  254. package/dist/helpdesk/legacy-contact-retention.js +53 -0
  255. package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
  256. package/dist/helpdesk/legacy-contact-streams.js +121 -0
  257. package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
  258. package/dist/helpdesk/legacy-contact-user-data.js +62 -0
  259. package/dist/helpdesk/lib.d.ts +7 -1
  260. package/dist/helpdesk/lib.js +29 -29
  261. package/dist/helpdesk/user-data-hooks.d.ts +10 -1
  262. package/dist/helpdesk/user-data-hooks.js +47 -36
  263. package/dist/helpdesk/web/constants.d.ts +0 -1
  264. package/dist/helpdesk/web/constants.js +0 -1
  265. package/dist/inbound-mail-foundation/account-health.js +1 -1
  266. package/dist/inbound-mail-foundation/account-poll.js +1 -1
  267. package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
  268. package/dist/inbound-mail-foundation/constants.d.ts +6 -0
  269. package/dist/inbound-mail-foundation/constants.js +6 -0
  270. package/dist/inbound-mail-foundation/content-refetch.d.ts +1 -0
  271. package/dist/inbound-mail-foundation/content-refetch.js +15 -1
  272. package/dist/inbound-mail-foundation/entities.js +57 -15
  273. package/dist/inbound-mail-foundation/events.js +15 -16
  274. package/dist/inbound-mail-foundation/feature.js +3 -1
  275. package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
  276. package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
  277. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
  278. package/dist/inbound-mail-foundation/handlers/connect-account.write.js +12 -7
  279. package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
  280. package/dist/inbound-mail-foundation/handlers/forget-message.write.js +54 -0
  281. package/dist/inbound-mail-foundation/i18n.js +3 -0
  282. package/dist/inbound-mail-foundation/index.d.ts +1 -0
  283. package/dist/inbound-mail-foundation/index.js +1 -0
  284. package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
  285. package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
  286. package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
  287. package/dist/inbound-mail-foundation/personal-address.js +16 -0
  288. package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
  289. package/dist/inbound-mail-foundation/purge-messages.js +33 -0
  290. package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
  291. package/dist/inbound-mail-foundation/quarantine.js +9 -5
  292. package/dist/inbound-mail-foundation/retention-job.js +1 -5
  293. package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
  294. package/dist/inbound-mail-foundation/send-from-account.js +9 -1
  295. package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
  296. package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
  297. package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
  298. package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
  299. package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
  300. package/dist/inbound-provider-imap/byte-budget.js +53 -0
  301. package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
  302. package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
  303. package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
  304. package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
  305. package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
  306. package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
  307. package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
  308. package/dist/inbound-provider-imap/download-batch.js +21 -6
  309. package/dist/inbound-provider-imap/feature.js +7 -4
  310. package/dist/inbound-provider-imap/fetch-content.js +35 -30
  311. package/dist/inbound-provider-imap/i18n.js +2 -2
  312. package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
  313. package/dist/inbound-provider-imap/parse-message.js +8 -0
  314. package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
  315. package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
  316. package/dist/inbound-provider-imap/send-mail.js +32 -6
  317. package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
  318. package/dist/inbound-provider-imap/smtp-client.js +15 -3
  319. package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
  320. package/dist/inbound-provider-inmemory/feature.js +1 -1
  321. package/dist/jobs/events.d.ts +13 -0
  322. package/dist/jobs/events.js +8 -0
  323. package/dist/jobs/feature.js +2 -0
  324. package/dist/jobs/handlers/consumer.write.js +31 -20
  325. package/dist/jobs/web/constants.d.ts +3 -0
  326. package/dist/jobs/web/constants.js +3 -0
  327. package/dist/mail-transport-inmemory/feature.js +1 -1
  328. package/dist/mail-transport-smtp/feature.js +3 -2
  329. package/dist/managed-pages/handlers/branding.query.js +1 -1
  330. package/dist/managed-pages/handlers/by-slug.query.js +1 -1
  331. package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
  332. package/dist/managed-pages/render-page-body.d.ts +2 -0
  333. package/dist/managed-pages/render-page-body.js +12 -8
  334. package/dist/managed-pages/screens/page-screens.d.ts +3 -2
  335. package/dist/managed-pages/screens/page-screens.js +14 -33
  336. package/dist/managed-pages/table.js +1 -0
  337. package/dist/managed-pages/web/client-plugin.js +8 -6
  338. package/dist/managed-pages/web/constants.d.ts +5 -1
  339. package/dist/managed-pages/web/constants.js +6 -1
  340. package/dist/managed-pages/web/i18n.js +11 -3
  341. package/dist/managed-pages/web/markdown-to-document.js +1 -1
  342. package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
  343. package/dist/managed-pages/web/page-edit-draft.js +76 -0
  344. package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
  345. package/dist/managed-pages/web/page-edit-screen.js +106 -0
  346. package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
  347. package/dist/managed-pages/web/page-settings-rail.js +14 -0
  348. package/dist/notes-history-user-data/index.js +8 -14
  349. package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
  350. package/dist/personal-access-tokens/boot-rules.js +5 -0
  351. package/dist/personal-access-tokens/handlers/create.write.js +0 -1
  352. package/dist/personal-access-tokens/scope-events-check.js +26 -6
  353. package/dist/presence/handlers/list.query.js +18 -8
  354. package/dist/presence/room.d.ts +2 -0
  355. package/dist/presence/room.js +8 -5
  356. package/dist/presence/store.d.ts +2 -0
  357. package/dist/presence/store.js +62 -26
  358. package/dist/readiness/handlers/latest-summary.query.js +10 -6
  359. package/dist/readiness/handlers/run-probes.write.js +24 -4
  360. package/dist/readiness/handlers/run-tone.js +3 -2
  361. package/dist/readiness/handlers/status.query.js +11 -3
  362. package/dist/readiness/probe-context.js +7 -10
  363. package/dist/readiness/screens.js +4 -4
  364. package/dist/readiness/visible-results.d.ts +1 -1
  365. package/dist/readiness/visible-results.js +5 -2
  366. package/dist/renderer-foundation/api.js +6 -12
  367. package/dist/renderer-foundation/types.d.ts +2 -2
  368. package/dist/secrets/db/queries/read.d.ts +2 -1
  369. package/dist/secrets/db/queries/read.js +10 -1
  370. package/dist/secrets/handlers/list.query.js +4 -2
  371. package/dist/secrets/secret-scope.d.ts +0 -1
  372. package/dist/secrets/secret-scope.js +2 -2
  373. package/dist/secrets/secrets-context.js +4 -4
  374. package/dist/secrets/table.d.ts +1 -1
  375. package/dist/secrets/write-gate.js +4 -2
  376. package/dist/seo/handlers/seo-config.query.js +1 -1
  377. package/dist/shared/acknowledged-system-db.d.ts +5 -0
  378. package/dist/shared/acknowledged-system-db.js +9 -0
  379. package/dist/shared/assert-billing-live.d.ts +1 -0
  380. package/dist/shared/assert-billing-live.js +5 -2
  381. package/dist/shared/index.d.ts +6 -2
  382. package/dist/shared/index.js +6 -2
  383. package/dist/shared/parent-visibility.d.ts +1 -0
  384. package/dist/shared/parent-visibility.js +16 -1
  385. package/dist/shared/password-hashing.js +0 -1
  386. package/dist/shared/price-env-shape.js +1 -1
  387. package/dist/shared/register-user-data-hooks.d.ts +11 -0
  388. package/dist/shared/register-user-data-hooks.js +11 -0
  389. package/dist/shared/require-bootstrap-extension.d.ts +9 -0
  390. package/dist/shared/require-bootstrap-extension.js +16 -0
  391. package/dist/shared/send-best-effort.d.ts +2 -0
  392. package/dist/shared/send-best-effort.js +14 -0
  393. package/dist/shared/stream-tenant-backfill.d.ts +1 -0
  394. package/dist/shared/stream-tenant-backfill.js +17 -1
  395. package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
  396. package/dist/shared/stream-tenant-derived-state.js +19 -2
  397. package/dist/step-dispatcher/constants.d.ts +4 -0
  398. package/dist/step-dispatcher/constants.js +11 -0
  399. package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
  400. package/dist/step-dispatcher/deliver-dispatch-request.js +38 -2
  401. package/dist/step-dispatcher/feature.js +20 -2
  402. package/dist/step-dispatcher/mail-runner.js +0 -1
  403. package/dist/step-dispatcher/sweep-abandoned.d.ts +10 -0
  404. package/dist/step-dispatcher/sweep-abandoned.js +43 -0
  405. package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
  406. package/dist/subscription-mollie/plugin-methods.js +1 -2
  407. package/dist/subscription-mollie/verify-webhook.js +5 -5
  408. package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
  409. package/dist/subscription-paddle/backfill-checkout-ledger.js +110 -0
  410. package/dist/subscription-paddle/checkout-config.query.js +1 -1
  411. package/dist/subscription-paddle/checkout-methods.js +2 -8
  412. package/dist/subscription-paddle/constants.d.ts +0 -1
  413. package/dist/subscription-paddle/constants.js +1 -2
  414. package/dist/subscription-paddle/feature.d.ts +0 -4
  415. package/dist/subscription-paddle/feature.js +21 -20
  416. package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
  417. package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
  418. package/dist/subscription-paddle/plan-switch-methods.js +2 -8
  419. package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
  420. package/dist/subscription-paddle/redeliver-legacy-checkout.js +26 -0
  421. package/dist/subscription-paddle/runtime.d.ts +3 -5
  422. package/dist/subscription-paddle/runtime.js +4 -7
  423. package/dist/subscription-paddle/subscription-state.d.ts +1 -0
  424. package/dist/subscription-paddle/subscription-state.js +1 -0
  425. package/dist/subscription-paddle/webhook-events.d.ts +4 -0
  426. package/dist/subscription-paddle/webhook-events.js +40 -22
  427. package/dist/subscription-stripe/feature.d.ts +4 -0
  428. package/dist/subscription-stripe/feature.js +1 -0
  429. package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
  430. package/dist/subscription-stripe/plugin-methods.js +2 -5
  431. package/dist/subscription-stripe/runtime.d.ts +2 -1
  432. package/dist/subscription-stripe/runtime.js +5 -7
  433. package/dist/subscription-stripe/verify-webhook.js +21 -6
  434. package/dist/tags/aggregate-id.js +0 -1
  435. package/dist/tags/web/tag-chip.js +0 -1
  436. package/dist/tags/web/tag-manager.js +3 -1
  437. package/dist/template-resolver/api.js +6 -12
  438. package/dist/template-resolver/document-sanitizer.d.ts +1 -1
  439. package/dist/template-resolver/document-sanitizer.js +18 -0
  440. package/dist/template-resolver/feature.d.ts +1 -0
  441. package/dist/template-resolver/feature.js +2 -0
  442. package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
  443. package/dist/template-resolver/handlers/body-preview.query.js +41 -0
  444. package/dist/template-resolver/handlers/by-slug.query.js +1 -1
  445. package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
  446. package/dist/template-resolver/handlers/collection-shared.js +5 -8
  447. package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
  448. package/dist/template-resolver/handlers/overview.query.js +2 -1
  449. package/dist/template-resolver/handlers/send-test.write.js +27 -8
  450. package/dist/template-resolver/linked-resources.js +2 -6
  451. package/dist/template-resolver/seeding.js +67 -1
  452. package/dist/template-resolver/table.js +1 -0
  453. package/dist/template-resolver/template-draft.js +2 -1
  454. package/dist/template-resolver/template-preview.js +12 -3
  455. package/dist/template-resolver/testing.js +0 -2
  456. package/dist/template-resolver/web/client-plugin.js +3 -0
  457. package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
  458. package/dist/template-resolver/web/constants.d.ts +2 -0
  459. package/dist/template-resolver/web/constants.js +2 -0
  460. package/dist/template-resolver/web/content-tree-provider.js +0 -1
  461. package/dist/template-resolver/web/content-workbench.d.ts +22 -0
  462. package/dist/template-resolver/web/content-workbench.js +32 -0
  463. package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
  464. package/dist/template-resolver/web/document-insert-model.js +1 -2
  465. package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
  466. package/dist/template-resolver/web/document-link-policy.js +53 -0
  467. package/dist/template-resolver/web/document-schema.d.ts +2 -4
  468. package/dist/template-resolver/web/document-schema.js +2 -53
  469. package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
  470. package/dist/template-resolver/web/document-tiptap-context.js +2 -2
  471. package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
  472. package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
  473. package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
  474. package/dist/template-resolver/web/editor-handle.js +1 -0
  475. package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
  476. package/dist/template-resolver/web/fill-document-variables.js +22 -0
  477. package/dist/template-resolver/web/i18n.js +10 -0
  478. package/dist/template-resolver/web/index.d.ts +3 -0
  479. package/dist/template-resolver/web/index.js +2 -0
  480. package/dist/template-resolver/web/preview-targets.d.ts +5 -0
  481. package/dist/template-resolver/web/preview-targets.js +21 -0
  482. package/dist/template-resolver/web/qualified-names.d.ts +1 -0
  483. package/dist/template-resolver/web/qualified-names.js +1 -0
  484. package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
  485. package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
  486. package/dist/template-resolver/web/string-values.d.ts +1 -0
  487. package/dist/template-resolver/web/string-values.js +8 -0
  488. package/dist/template-resolver/web/text-block-editor.js +18 -11
  489. package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
  490. package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
  491. package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
  492. package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
  493. package/dist/template-resolver/web/use-text-block-editor.js +26 -5
  494. package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
  495. package/dist/template-resolver/web/web-preview-renderer.js +41 -0
  496. package/dist/template-resolver-user-data/index.js +11 -10
  497. package/dist/tenant/handlers/create.write.js +3 -7
  498. package/dist/tenant/handlers/list.query.js +3 -8
  499. package/dist/tenant/handlers/member-directory.query.js +10 -5
  500. package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
  501. package/dist/tenant/invited-membership.js +9 -1
  502. package/dist/tenant/seeding.d.ts +3 -0
  503. package/dist/tenant/seeding.js +3 -1
  504. package/dist/tenant/stream-tenant-backfill.js +5 -1
  505. package/dist/tenant/testing.js +1 -1
  506. package/dist/tenant-inactivity/check-inactive-tenants.js +5 -5
  507. package/dist/tenant-inactivity/constants.js +1 -2
  508. package/dist/tenant-inactivity/handlers/keep-account.write.js +1 -2
  509. package/dist/tenant-inactivity/state-store.d.ts +1 -0
  510. package/dist/tenant-inactivity/state-store.js +9 -1
  511. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  512. package/dist/tenant-lifecycle/constants.js +3 -0
  513. package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
  514. package/dist/tenant-lifecycle/stages.js +14 -2
  515. package/dist/tier-engine/aggregate-id.js +0 -1
  516. package/dist/tier-engine/feature.js +9 -2
  517. package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
  518. package/dist/user/handlers/me.query.js +4 -1
  519. package/dist/user/index.d.ts +1 -0
  520. package/dist/user/index.js +1 -0
  521. package/dist/user/resolve-verified-user-email.d.ts +2 -0
  522. package/dist/user/resolve-verified-user-email.js +14 -0
  523. package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
  524. package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
  525. package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
  526. package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
  527. package/dist/user-data-rights/run-export-jobs.js +0 -2
  528. package/dist/user-data-rights/run-forget-cleanup.js +2 -2
  529. package/dist/user-data-rights/schema/download-attempt.js +3 -2
  530. package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
  531. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  532. package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
  533. package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
  534. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
  535. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
  536. package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
  537. package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
  538. package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
  539. package/dist/user-profile/handlers/change-email.write.js +0 -1
  540. package/dist/waitlist/handlers/submit.write.js +5 -18
  541. package/dist/waitlist/lib.js +2 -7
  542. package/dist/waitlist/user-data-hooks.js +6 -20
  543. package/dist/workflow-runner/aggregate-id.js +0 -1
  544. package/dist/workflow-runner/event-trigger.js +6 -2
  545. package/dist/workflow-runner/feature.js +1 -5
  546. package/dist/workflow-runner/handlers/resume-run.write.js +4 -3
  547. package/dist/workflow-runner/runner.d.ts +1 -0
  548. package/package.json +35 -11
  549. package/src/admin-shell/changes.json +6 -0
  550. package/src/agent-tools/changes.json +12 -0
  551. package/src/auth-email-password/changes.json +18 -0
  552. package/src/billing-foundation/changes.json +37 -0
  553. package/src/cap-counter/changes.json +6 -0
  554. package/src/cap-overview/changes.json +6 -0
  555. package/src/channel-in-app/changes.json +6 -0
  556. package/src/channel-whatsapp/changes.json +8 -0
  557. package/src/config/changes.json +12 -0
  558. package/src/crypto-shredding/changes.json +18 -0
  559. package/src/data-retention/changes.json +18 -0
  560. package/src/delivery/changes.json +6 -0
  561. package/src/documents/changes.json +18 -0
  562. package/src/file-provider-s3/changes.json +14 -0
  563. package/src/files/changes.json +7 -0
  564. package/src/helpdesk/changes.json +62 -0
  565. package/src/inbound-mail-foundation/changes.json +48 -0
  566. package/src/inbound-provider-imap/changes.json +13 -0
  567. package/src/mail-foundation/changes.json +6 -0
  568. package/src/managed-pages/changes.json +12 -0
  569. package/src/presence/changes.json +6 -0
  570. package/src/readiness/changes.json +25 -0
  571. package/src/secrets/changes.json +7 -0
  572. package/src/shared/changes.json +6 -0
  573. package/src/step-dispatcher/changes.json +12 -0
  574. package/src/subscription-mollie/changes.json +7 -0
  575. package/src/subscription-paddle/changes.json +13 -0
  576. package/src/subscription-stripe/changes.json +7 -0
  577. package/src/template-resolver/changes.json +36 -0
  578. package/src/tenant/changes.json +6 -0
  579. package/src/tenant-lifecycle/changes.json +18 -0
  580. package/src/tier-engine/changes.json +6 -0
  581. package/src/user/changes.json +6 -0
  582. package/src/waitlist/changes.json +6 -0
  583. package/dist/managed-pages/web/page-body-section.d.ts +0 -3
  584. package/dist/managed-pages/web/page-body-section.js +0 -40
  585. package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
  586. package/dist/subscription-paddle/tenant-binding.js +0 -26
  587. package/dist/template-resolver/web/content-field.d.ts +0 -9
  588. package/dist/template-resolver/web/content-field.js +0 -14
@@ -3,7 +3,7 @@
3
3
  // when `createBillingFoundationFeature` gets a `catalog`.
4
4
  import * as z from "zod";
5
5
  import { filterOfferedProviders, listCatalogProviders, } from "../checkout-core.js";
6
- import { CONSENT_TEXTS, consentTextVersion, documentsAcknowledgementTextFor, legalLinksPerLocale, } from "../consumer-protection/consent-text.js";
6
+ import { CONSENT_TEXTS, consentTextVersion, documentsAcknowledgementTextFor, hasProviderRefundLink, legalLinksFor, } from "../consumer-protection/consent-text.js";
7
7
  import { buildProviderPlanViews, loadBillingPlansBase, toBillingPlansResult, } from "../plan-catalog.js";
8
8
  const billingPlansSchema = z.object({}).strict();
9
9
  export function createBillingPlansQuery(options, catalog) {
@@ -20,13 +20,7 @@ export function createBillingPlansQuery(options, catalog) {
20
20
  return result;
21
21
  return {
22
22
  ...result,
23
- consumerProtection: {
24
- consentTexts: {
25
- de: consentTextView(consumerProtection, "de"),
26
- en: consentTextView(consumerProtection, "en"),
27
- },
28
- legalLinks: legalLinksPerLocale(consumerProtection.legalLinks),
29
- },
23
+ consumerProtection: consumerProtectionView(consumerProtection, base.blockingSubscription ? base.subscriptionView?.providerName : undefined),
30
24
  };
31
25
  },
32
26
  };
@@ -45,25 +39,41 @@ async function resolveProviderPlans(ctx, options, catalog, base) {
45
39
  const firstViews = await buildProviderPlanViews(ctx, first?.plugin ?? null, catalog, base);
46
40
  const result = toBillingPlansResult(catalog, base, firstViews);
47
41
  const providerTexts = options.consumerProtection?.providerTexts;
48
- const hasNote = first !== null && providerTexts?.[first.name]?.checkoutNote !== undefined;
49
- if (offered.length <= 1 && !(offered.length === 1 && hasNote))
42
+ const hasProviderSpecifics = first !== null &&
43
+ (providerTexts?.[first.name]?.checkoutNote !== undefined ||
44
+ (options.consumerProtection !== undefined &&
45
+ hasProviderRefundLink(options.consumerProtection, first.name)));
46
+ if (offered.length <= 1 && !(offered.length === 1 && hasProviderSpecifics))
50
47
  return result;
51
- const providers = await Promise.all(offered.map((provider, index) => providerView(ctx, catalog, base, provider, providerTexts, index === 0 ? firstViews : null)));
48
+ const providers = await Promise.all(offered.map((provider, index) => providerView(ctx, catalog, base, provider, options.consumerProtection, index === 0 ? firstViews : null)));
52
49
  return { ...result, providers };
53
50
  }
54
- async function providerView(ctx, catalog, base, provider, providerTexts, known) {
51
+ async function providerView(ctx, catalog, base, provider, consumerProtection, known) {
55
52
  const views = known ?? (await buildProviderPlanViews(ctx, provider.plugin, catalog, base));
56
- const note = providerTexts?.[provider.name]?.checkoutNote;
53
+ const note = consumerProtection?.providerTexts?.[provider.name]?.checkoutNote;
54
+ const ownConsumerProtection = consumerProtection !== undefined && hasProviderRefundLink(consumerProtection, provider.name)
55
+ ? consumerProtectionView(consumerProtection, provider.name)
56
+ : undefined;
57
57
  return {
58
58
  name: provider.name,
59
59
  displayName: provider.plugin.displayName ?? provider.name,
60
60
  ...(note !== undefined && { note }),
61
+ ...(ownConsumerProtection !== undefined && { consumerProtection: ownConsumerProtection }),
61
62
  plans: views.plans,
62
63
  };
63
64
  }
64
- function consentTextView(consumerProtection, locale) {
65
+ function consumerProtectionView(consumerProtection, providerName) {
66
+ return {
67
+ consentTexts: {
68
+ de: consentTextView(consumerProtection, "de", providerName),
69
+ en: consentTextView(consumerProtection, "en", providerName),
70
+ },
71
+ legalLinks: legalLinksFor(consumerProtection, providerName),
72
+ };
73
+ }
74
+ function consentTextView(consumerProtection, locale, providerName) {
65
75
  const { earlyPerformance, withdrawalLoss } = CONSENT_TEXTS[locale];
66
- const documentsAcknowledgement = documentsAcknowledgementTextFor(consumerProtection, locale);
76
+ const documentsAcknowledgement = documentsAcknowledgementTextFor(consumerProtection, locale, providerName);
67
77
  return {
68
78
  earlyPerformance,
69
79
  withdrawalLoss,
@@ -88,7 +88,7 @@ export function createCheckoutSessionHandler(options) {
88
88
  ? await consumerProtection.oneOffItemLabel?.(ctx, payload.priceId)
89
89
  : undefined;
90
90
  assertValidOrderItem(orderItem, payload.priceId);
91
- const consent = await prepareConsent(ctx, consumerProtection, payload.consent, mode);
91
+ const consent = await prepareConsent(ctx, consumerProtection, payload.consent, mode, payload.providerName);
92
92
  const result = await startProviderCheckout(ctx, plugin, {
93
93
  ...checkoutInput,
94
94
  ...consentCheckoutFields(consent),
@@ -24,7 +24,7 @@ export declare const processEventSchema: z.ZodObject<{
24
24
  currentPeriodEndIso: z.ZodString;
25
25
  cancelAtIso: z.ZodOptional<z.ZodNullable<z.ZodString>>;
26
26
  providerEventAtIso: z.ZodOptional<z.ZodISODateTime>;
27
- consentId: z.ZodOptional<z.ZodString>;
27
+ providerCheckoutId: z.ZodOptional<z.ZodString>;
28
28
  }, z.core.$strip>;
29
29
  export type ProcessEventPayload = z.infer<typeof processEventSchema>;
30
30
  export declare function isLateStateEvent(storedEvents: readonly {
@@ -34,7 +34,7 @@ export declare function isLateStateEvent(storedEvents: readonly {
34
34
  };
35
35
  }[], payload: ProcessEventPayload): boolean;
36
36
  export declare function clampProviderEventAt(payload: ProcessEventPayload, now: Temporal.Instant): ProcessEventPayload;
37
- export declare function appendSubscriptionEvent(ctx: HandlerContext, tenantId: string, rawPayload: ProcessEventPayload, now?: Temporal.Instant): Promise<{
37
+ export declare function appendSubscriptionEvent(ctx: HandlerContext, tenantId: string, rawPayload: ProcessEventPayload, now?: Temporal.Instant, consentId?: string): Promise<{
38
38
  readonly duplicate: boolean;
39
39
  readonly stale?: true;
40
40
  readonly subscriptionAggregateId: string;
@@ -7,17 +7,22 @@
7
7
  // already-seen `metadata.providerEventId`. A provider replay
8
8
  // (Stripe retry storm) has the same event ID → duplicate=true,
9
9
  // with no second append.
10
- // 2. Type mapping: SubscriptionEvent.type (= normalized by the plugin)
10
+ // 2. Admission (handler only, not the shared append): `created` needs a
11
+ // checkout from the server's ledger; every other type needs the tenant's
12
+ // current subscription or a ledgered checkout. Else the event is ignored.
13
+ // 3. Type mapping: SubscriptionEvent.type (= normalized by the plugin)
11
14
  // → one of the 5 ES event types.
12
- // 3. ctx.events.unsafeAppend — the inline projection materializes the
15
+ // 4. ctx.events.unsafeAppend — the inline projection materializes the
13
16
  // `read_subscriptions` row in the same TX.
14
17
  import { configuredPiiSubjectKms, encryptPiiFieldValues, } from "@cosmicdrift/kumiko-framework/crypto";
15
18
  import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
16
19
  import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
17
20
  import * as z from "zod";
18
21
  import { subscriptionAggregateId } from "../aggregate-id.js";
22
+ import { findProviderPlugin } from "../checkout-core.js";
23
+ import { findCheckoutOpened } from "../checkout-ledger.js";
19
24
  import { SUBSCRIPTION_PII_FIELDS, subscriptionEntity } from "../entities.js";
20
- import { INVOICE_PAID_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_QN, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_QN, } from "../events.js";
25
+ import { CHECKOUT_CONSENT_RECORDED_EVENT_QN, checkoutConsentRecordedPayloadSchema, INVOICE_PAID_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_QN, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_QN, } from "../events.js";
21
26
  import { getSubscriptionForTenant } from "../get-subscription-for-tenant.js";
22
27
  import { hasSeenProviderEvent } from "../provider-event-seen.js";
23
28
  import { BILLING_SUBSCRIPTION_LOCK_NAMESPACE, isSubscriptionBlockingCheckout, isSwitchableSubscriptionStatus, SubscriptionEventTypes, SubscriptionStatuses, } from "../web/constants.js";
@@ -51,7 +56,7 @@ export const processEventSchema = z.object({
51
56
  currentPeriodEndIso: z.string().min(1),
52
57
  cancelAtIso: z.string().min(1).nullable().optional(),
53
58
  providerEventAtIso: z.iso.datetime().optional(),
54
- consentId: z.string().min(1).max(100).optional(),
59
+ providerCheckoutId: z.string().min(1).max(200).optional(),
55
60
  });
56
61
  // Map normalized SubscriptionEventType → fully-qualified ES event-name.
57
62
  const NORMALIZED_TO_ES_EVENT = {
@@ -61,6 +66,11 @@ const NORMALIZED_TO_ES_EVENT = {
61
66
  [SubscriptionEventTypes.invoicePaid]: INVOICE_PAID_EVENT_QN,
62
67
  [SubscriptionEventTypes.invoicePaymentFailed]: INVOICE_PAYMENT_FAILED_EVENT_QN,
63
68
  };
69
+ const STATE_EVENT_QNS = new Set([
70
+ SUBSCRIPTION_CREATED_EVENT_QN,
71
+ SUBSCRIPTION_UPDATED_EVENT_QN,
72
+ SUBSCRIPTION_CANCELED_EVENT_QN,
73
+ ]);
64
74
  const STATE_EVENT_TYPES = new Set([
65
75
  SubscriptionEventTypes.created,
66
76
  SubscriptionEventTypes.updated,
@@ -109,7 +119,7 @@ export function clampProviderEventAt(payload, now) {
109
119
  ? { ...payload, providerEventAtIso: ceiling.toString() }
110
120
  : payload;
111
121
  }
112
- export async function appendSubscriptionEvent(ctx, tenantId, rawPayload, now = Temporal.Now.instant()) {
122
+ export async function appendSubscriptionEvent(ctx, tenantId, rawPayload, now = Temporal.Now.instant(), consentId) {
113
123
  const aggId = subscriptionAggregateId(tenantId);
114
124
  const payload = clampProviderEventAt(rawPayload, now);
115
125
  // Serialises the read (idempotency + late check) with the append: the append re-reads the
@@ -183,7 +193,7 @@ export async function appendSubscriptionEvent(ctx, tenantId, rawPayload, now = T
183
193
  tier: payload.tier,
184
194
  currentPeriodEndIso: payload.currentPeriodEndIso,
185
195
  ...(payload.cancelAtIso !== undefined && { cancelAtIso: payload.cancelAtIso }),
186
- ...(payload.consentId !== undefined && { consentId: payload.consentId }),
196
+ ...(consentId !== undefined && { consentId }),
187
197
  ...(payload.providerEventAtIso !== undefined && {
188
198
  providerEventAtIso: payload.providerEventAtIso,
189
199
  }),
@@ -225,6 +235,68 @@ function isStaleSubscriptionEvent(current, payload, now) {
225
235
  isSwitchableSubscriptionStatus(payload.status);
226
236
  return !supersedesCurrent;
227
237
  }
238
+ function isBoundToLedgerEntry(ctx, entry, payload) {
239
+ const plugin = findProviderPlugin(ctx, payload.providerName)?.plugin;
240
+ return plugin?.priceToTier?.[entry.priceId] === payload.tier;
241
+ }
242
+ // A plan switch has no checkout of its own: its consent is the newest one recorded for the target
243
+ // tier since the last stored state event, as long as no stored subscription event carries it yet.
244
+ function pendingSwitchConsentId(storedEvents, payload) {
245
+ let lastStateIndex = -1;
246
+ const carried = new Set();
247
+ storedEvents.forEach((stored, index) => {
248
+ // skip: only subscription state events can carry a consent
249
+ if (!STATE_EVENT_QNS.has(stored.type))
250
+ return;
251
+ lastStateIndex = index;
252
+ const consentId = propertyOf(stored.payload, "consentId");
253
+ if (typeof consentId === "string")
254
+ carried.add(consentId);
255
+ });
256
+ for (let index = storedEvents.length - 1; index > lastStateIndex; index--) {
257
+ const stored = storedEvents[index];
258
+ if (stored?.type !== CHECKOUT_CONSENT_RECORDED_EVENT_QN)
259
+ continue;
260
+ const parsed = checkoutConsentRecordedPayloadSchema.safeParse(stored.payload);
261
+ if (!parsed.success)
262
+ continue;
263
+ const consent = parsed.data;
264
+ if (consent.mode === "subscription" &&
265
+ consent.tier === payload.tier &&
266
+ (consent.providerName === undefined || consent.providerName === payload.providerName) &&
267
+ !carried.has(consent.consentId)) {
268
+ return consent.consentId;
269
+ }
270
+ }
271
+ return undefined;
272
+ }
273
+ function admitProviderEvent(ctx, storedEvents, current, payload) {
274
+ const entry = payload.providerCheckoutId === undefined
275
+ ? undefined
276
+ : findCheckoutOpened(storedEvents, {
277
+ providerName: payload.providerName,
278
+ providerCheckoutId: payload.providerCheckoutId,
279
+ mode: "subscription",
280
+ });
281
+ if (entry !== undefined && isBoundToLedgerEntry(ctx, entry, payload)) {
282
+ return { admitted: true, ...(entry.consentId !== undefined && { consentId: entry.consentId }) };
283
+ }
284
+ if (payload.type === SubscriptionEventTypes.created) {
285
+ return { admitted: false, reason: "checkout_not_in_ledger" };
286
+ }
287
+ // The provider does not guarantee order: an update that beats the `created` of its
288
+ // subscription must be redelivered, not dropped.
289
+ if (current === null)
290
+ return { admitted: false, reason: "subscription_not_yet_created", retry: true };
291
+ const isCurrentSubscription = current.providerName === payload.providerName &&
292
+ current.providerSubscriptionId === payload.providerSubscriptionId;
293
+ if (!isCurrentSubscription)
294
+ return { admitted: false, reason: "foreign_subscription" };
295
+ const switchConsentId = payload.type === SubscriptionEventTypes.updated && current.tier !== payload.tier
296
+ ? pendingSwitchConsentId(storedEvents, payload)
297
+ : undefined;
298
+ return { admitted: true, ...(switchConsentId !== undefined && { consentId: switchConsentId }) };
299
+ }
228
300
  export function createProcessEventHandler(now) {
229
301
  return {
230
302
  name: "process-event",
@@ -234,19 +306,29 @@ export function createProcessEventHandler(now) {
234
306
  handler: async (event, ctx) => {
235
307
  // @cast-boundary engine-payload — dispatcher-zod-validated payload
236
308
  const payload = event.payload;
309
+ const aggId = subscriptionAggregateId(event.user.tenantId);
237
310
  const current = await getSubscriptionForTenant(ctx, event.user.tenantId);
238
- if (isStaleSubscriptionEvent(current, payload, now())) {
239
- ctx.obs.log?.warn(`[billing-foundation:process-event] dropped stale ${payload.type} ${payload.providerEventId}: tenant already tracks another subscription`);
311
+ const admission = admitProviderEvent(ctx, await ctx.events.load(aggId), current, payload);
312
+ if (!admission.admitted) {
313
+ ctx.obs.log?.warn(`[billing-foundation:process-event] ignored ${payload.type} ${payload.providerEventId} (${admission.reason}): provider ${payload.providerName}`);
240
314
  return {
241
315
  isSuccess: true,
242
316
  data: {
243
- duplicate: false,
244
- stale: true,
245
- subscriptionAggregateId: subscriptionAggregateId(event.user.tenantId),
317
+ ignored: true,
318
+ reason: admission.reason,
319
+ ...(admission.retry === true && { retry: true }),
320
+ subscriptionAggregateId: aggId,
246
321
  },
247
322
  };
248
323
  }
249
- const result = await appendSubscriptionEvent(ctx, event.user.tenantId, payload, now());
324
+ if (isStaleSubscriptionEvent(current, payload, now())) {
325
+ ctx.obs.log?.warn(`[billing-foundation:process-event] dropped stale ${payload.type} ${payload.providerEventId}: tenant already tracks another subscription`);
326
+ return {
327
+ isSuccess: true,
328
+ data: { duplicate: false, stale: true, subscriptionAggregateId: aggId },
329
+ };
330
+ }
331
+ const result = await appendSubscriptionEvent(ctx, event.user.tenantId, payload, now(), admission.consentId);
250
332
  return { isSuccess: true, data: result };
251
333
  },
252
334
  };
@@ -3,10 +3,9 @@ import * as z from "zod";
3
3
  export declare const processPaymentEventSchema: z.ZodObject<{
4
4
  providerEventId: z.ZodString;
5
5
  providerName: z.ZodString;
6
- providerCheckoutId: z.ZodOptional<z.ZodString>;
6
+ providerCheckoutId: z.ZodString;
7
7
  providerCustomerId: z.ZodString;
8
8
  priceId: z.ZodString;
9
9
  quantity: z.ZodOptional<z.ZodNumber>;
10
- consentId: z.ZodOptional<z.ZodString>;
11
10
  }, z.core.$strip>;
12
11
  export declare const processPaymentEventHandler: WriteHandlerDef;
@@ -6,23 +6,25 @@
6
6
  // 1. Idempotency-check: loads the payment-stream and scans for an
7
7
  // already-seen `metadata.providerEventId`. A provider-replay with
8
8
  // the same event-id → duplicate=true, no second append.
9
- // 2. ctx.events.unsafeAppend — inline-projection materializes a new
9
+ // 2. Ledger check: the payment must name a checkout the server opened itself
10
+ // (same provider, same price); anything else is ignored.
11
+ // 3. ctx.events.unsafeAppend — inline-projection materializes a new
10
12
  // `read_payments`-row (INSERT-once, not UPSERT — every payment is
11
13
  // its own fact, not a state-update).
12
14
  import { configuredPiiSubjectKms, encryptPiiFieldValues, } from "@cosmicdrift/kumiko-framework/crypto";
13
15
  import * as z from "zod";
14
16
  import { paymentAggregateId } from "../aggregate-id.js";
17
+ import { findCheckoutOpened } from "../checkout-ledger.js";
15
18
  import { PAYMENT_PII_FIELDS, paymentEntity } from "../entities.js";
16
19
  import { PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, } from "../events.js";
17
20
  import { hasSeenProviderEvent } from "../provider-event-seen.js";
18
21
  export const processPaymentEventSchema = z.object({
19
22
  providerEventId: z.string().min(1).max(200),
20
23
  providerName: z.string().min(1).max(50),
21
- providerCheckoutId: z.string().min(1).max(200).optional(),
24
+ providerCheckoutId: z.string().min(1).max(200),
22
25
  providerCustomerId: z.string().min(1).max(200),
23
26
  priceId: z.string().min(1).max(200),
24
27
  quantity: z.number().int().positive().optional(),
25
- consentId: z.string().min(1).max(100).optional(),
26
28
  });
27
29
  // SystemAdmin-only: this handler is called exclusively by the programmatic
28
30
  // webhook-handler (with an internal SystemUser), never directly by the
@@ -51,7 +53,27 @@ export const processPaymentEventHandler = {
51
53
  };
52
54
  }
53
55
  // ---------------------------------------------------------------
54
- // 2. Encrypt the provider-subject PII field before it touches storage
56
+ // 2. Ledger: only checkouts this server opened may produce a payment.
57
+ // ---------------------------------------------------------------
58
+ const entry = findCheckoutOpened(existingEvents, {
59
+ providerName: payload.providerName,
60
+ providerCheckoutId: payload.providerCheckoutId,
61
+ mode: "payment",
62
+ });
63
+ const rejection = entry === undefined
64
+ ? "checkout_not_in_ledger"
65
+ : entry.priceId !== payload.priceId
66
+ ? "price_mismatch"
67
+ : undefined;
68
+ if (rejection !== undefined) {
69
+ ctx.obs.log?.warn(`[billing-foundation:process-payment-event] ignored ${payload.providerEventId} (${rejection}): checkout ${payload.providerCheckoutId} of provider ${payload.providerName}`);
70
+ return {
71
+ isSuccess: true,
72
+ data: { ignored: true, reason: rejection, paymentAggregateId: aggId },
73
+ };
74
+ }
75
+ // ---------------------------------------------------------------
76
+ // 3. Encrypt the provider-subject PII field before it touches storage
55
77
  // — same rationale as process-event.write.ts's step 3.
56
78
  // ---------------------------------------------------------------
57
79
  const piiKms = configuredPiiSubjectKms();
@@ -62,7 +84,7 @@ export const processPaymentEventHandler = {
62
84
  }, { tenantId, entityName: PAYMENT_AGGREGATE_TYPE })
63
85
  : { providerCustomerId: payload.providerCustomerId };
64
86
  // ---------------------------------------------------------------
65
- // 3. Append event on the payment-stream. Inline-projection
87
+ // 4. Append event on the payment-stream. Inline-projection
66
88
  // materializes a new read_payments-row in the same TX.
67
89
  // ---------------------------------------------------------------
68
90
  const eventPayload = {
@@ -70,14 +92,12 @@ export const processPaymentEventHandler = {
70
92
  providerCustomerId: encryptedFields.providerCustomerId,
71
93
  priceId: payload.priceId,
72
94
  ...(payload.quantity !== undefined && { quantity: payload.quantity }),
73
- ...(payload.consentId !== undefined && { consentId: payload.consentId }),
95
+ ...(entry?.consentId !== undefined && { consentId: entry.consentId }),
74
96
  };
75
97
  const headers = {
76
98
  providerEventId: payload.providerEventId,
77
99
  providerName: payload.providerName,
78
- ...(payload.providerCheckoutId !== undefined && {
79
- providerCheckoutId: payload.providerCheckoutId,
80
- }),
100
+ providerCheckoutId: payload.providerCheckoutId,
81
101
  };
82
102
  await ctx.events.unsafeAppend({
83
103
  aggregateId: aggId,
@@ -0,0 +1,2 @@
1
+ import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
2
+ export declare const recordCheckoutOpenedHandler: WriteHandlerDef;
@@ -0,0 +1,22 @@
1
+ // record-checkout-opened — ledgers a checkout that was opened before the
2
+ // ledger existed (provider migration jobs). Idempotent: an existing entry is
3
+ // left alone.
4
+ import { appendCheckoutOpened, findCheckoutOpened, ledgerAggregateId } from "../checkout-ledger.js";
5
+ import { checkoutOpenedPayloadSchema } from "../events.js";
6
+ export const recordCheckoutOpenedHandler = {
7
+ name: "record-checkout-opened",
8
+ agent: { expose: false },
9
+ schema: checkoutOpenedPayloadSchema,
10
+ access: { roles: ["SystemAdmin"] },
11
+ handler: async (event, ctx) => {
12
+ // @cast-boundary engine-payload — dispatcher-zod-validated payload
13
+ const entry = event.payload;
14
+ const tenantId = event.user.tenantId;
15
+ const existing = await ctx.events.load(ledgerAggregateId(tenantId, entry.mode));
16
+ if (findCheckoutOpened(existing, entry) !== undefined) {
17
+ return { isSuccess: true, data: { recorded: false } };
18
+ }
19
+ await appendCheckoutOpened(ctx, tenantId, entry);
20
+ return { isSuccess: true, data: { recorded: true } };
21
+ },
22
+ };
@@ -63,7 +63,7 @@ export function createStartPlanCheckoutHandler(options, catalog) {
63
63
  });
64
64
  }
65
65
  const consent = consumerProtection
66
- ? await prepareConsent(ctx, consumerProtection, payload.consent, "subscription")
66
+ ? await prepareConsent(ctx, consumerProtection, payload.consent, "subscription", providerName)
67
67
  : undefined;
68
68
  const baseUrl = options.baseUrl ?? "";
69
69
  const result = await openCheckout(ctx, {
@@ -7,6 +7,7 @@ import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
7
7
  import * as z from "zod";
8
8
  import { assertRedirectOrigins, isNonEmptyStringArray, joinBaseUrl } from "../checkout-core.js";
9
9
  import { consentPayloadSchema, prepareConsent, recordConsent, } from "../consumer-protection/consent-gate.js";
10
+ import { assertNoPendingPlanSwitch, recordPlanSwitchRequested } from "../pending-plan-switch.js";
10
11
  import { purchaseRolesOf } from "../plan-catalog.js";
11
12
  import { preparePlanSwitch } from "../plan-switch.js";
12
13
  export function createSwitchPlanHandler(options, catalog) {
@@ -45,8 +46,8 @@ export function createSwitchPlanHandler(options, catalog) {
45
46
  },
46
47
  };
47
48
  }
48
- // Consent is recorded before the provider call: the apply carries the consentId
49
- // as provider metadata, and a failing apply rolls the whole handler back.
49
+ // Consent and the pending marker are recorded before the provider call, and a failing apply rolls
50
+ // the whole handler back. The webhook later picks the consent up again through pendingSwitchConsentId.
50
51
  async function applyInApp(prepared, payload, ctx, options) {
51
52
  const { plugin, name: providerName } = prepared.provider;
52
53
  if (!plugin.applyPlanSwitch) {
@@ -54,8 +55,9 @@ async function applyInApp(prepared, payload, ctx, options) {
54
55
  message: `billing-foundation: provider "${providerName}" has neither createPlanSwitchSession nor applyPlanSwitch`,
55
56
  });
56
57
  }
58
+ await assertNoPendingPlanSwitch(ctx, options.now());
57
59
  const consent = options.consumerProtection
58
- ? await prepareConsent(ctx, options.consumerProtection, payload.consent, "subscription")
60
+ ? await prepareConsent(ctx, options.consumerProtection, payload.consent, "subscription", providerName)
59
61
  : undefined;
60
62
  if (consent) {
61
63
  await recordConsent(ctx, consent, {
@@ -65,11 +67,15 @@ async function applyInApp(prepared, payload, ctx, options) {
65
67
  providerName,
66
68
  });
67
69
  }
70
+ await recordPlanSwitchRequested(ctx, {
71
+ tier: payload.tier,
72
+ priceId: prepared.target.priceId,
73
+ now: options.now(),
74
+ });
68
75
  await plugin.applyPlanSwitch(ctx, {
69
76
  providerSubscriptionId: prepared.subscription.providerSubscriptionId,
70
77
  targetPriceId: prepared.target.priceId,
71
78
  tenantId: ctx.user.tenantId,
72
- ...(consent && { consentId: consent.consentId }),
73
79
  });
74
80
  return { isSuccess: true, data: { applied: true } };
75
81
  }
@@ -133,6 +133,9 @@ export const BILLING_FOUNDATION_I18N = {
133
133
  en: "This subscription is scheduled to end. Reactivate it before switching plans.",
134
134
  },
135
135
  "billing-foundation.errors.alreadyOnPlan": { en: "This tenant is already on that plan." },
136
+ "billing-foundation.errors.planSwitchPending": {
137
+ en: "A plan switch is already being processed. Wait a moment for it to complete.",
138
+ },
136
139
  "billing-foundation.errors.planSwitchNotSupported": {
137
140
  en: "This provider does not support switching plans.",
138
141
  },
@@ -0,0 +1,12 @@
1
+ import type { HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { type PlanSwitchRequestedPayload } from "./events.ts";
3
+ export declare function pendingPlanSwitchOf(storedEvents: readonly {
4
+ readonly type: string;
5
+ readonly payload: unknown;
6
+ }[], now: Temporal.Instant): PlanSwitchRequestedPayload | undefined;
7
+ export declare function assertNoPendingPlanSwitch(ctx: HandlerContext, now: Temporal.Instant): Promise<void>;
8
+ export declare function recordPlanSwitchRequested(ctx: HandlerContext, request: {
9
+ readonly tier: string;
10
+ readonly priceId: string;
11
+ readonly now: Temporal.Instant;
12
+ }): Promise<void>;
@@ -0,0 +1,57 @@
1
+ // An in-app plan switch changes the tier only when the provider's webhook arrives. Until then a
2
+ // second submit (double click, retry after a timeout) would pass the pre-checks and switch again.
3
+ import { ConflictError } from "@cosmicdrift/kumiko-framework/errors";
4
+ import { subscriptionAggregateId } from "./aggregate-id.js";
5
+ import { PLAN_SWITCH_REQUESTED_EVENT_QN, planSwitchRequestedPayloadSchema, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_QN, } from "./events.js";
6
+ // A webhook that never arrives must not block switching forever.
7
+ const PENDING_PLAN_SWITCH_WINDOW_SECONDS = 30 * 60;
8
+ // 'bfps': serializes the pending check and the append per tenant.
9
+ const PLAN_SWITCH_LOCK_NAMESPACE = 0x62667073;
10
+ const STATE_EVENT_QNS = new Set([
11
+ SUBSCRIPTION_CREATED_EVENT_QN,
12
+ SUBSCRIPTION_UPDATED_EVENT_QN,
13
+ SUBSCRIPTION_CANCELED_EVENT_QN,
14
+ ]);
15
+ export function pendingPlanSwitchOf(storedEvents, now) {
16
+ for (let index = storedEvents.length - 1; index >= 0; index--) {
17
+ const stored = storedEvents[index];
18
+ if (stored === undefined)
19
+ continue;
20
+ if (STATE_EVENT_QNS.has(stored.type))
21
+ return undefined;
22
+ if (stored.type !== PLAN_SWITCH_REQUESTED_EVENT_QN)
23
+ continue;
24
+ const parsed = planSwitchRequestedPayloadSchema.safeParse(stored.payload);
25
+ if (!parsed.success)
26
+ continue;
27
+ const ageSeconds = now
28
+ .since(Temporal.Instant.from(parsed.data.requestedAtIso))
29
+ .total("seconds");
30
+ return ageSeconds < PENDING_PLAN_SWITCH_WINDOW_SECONDS ? parsed.data : undefined;
31
+ }
32
+ return undefined;
33
+ }
34
+ export async function assertNoPendingPlanSwitch(ctx, now) {
35
+ const tenantId = ctx.user.tenantId;
36
+ await ctx.db.advisoryXactLock(PLAN_SWITCH_LOCK_NAMESPACE, tenantId);
37
+ const pending = pendingPlanSwitchOf(await ctx.events.load(subscriptionAggregateId(tenantId)), now);
38
+ if (pending !== undefined) {
39
+ throw new ConflictError({
40
+ i18nKey: "billing-foundation.errors.planSwitchPending",
41
+ message: `a switch to plan "${pending.tier}" is still waiting for the provider's confirmation`,
42
+ });
43
+ }
44
+ }
45
+ export async function recordPlanSwitchRequested(ctx, request) {
46
+ const payload = {
47
+ tier: request.tier,
48
+ priceId: request.priceId,
49
+ requestedAtIso: request.now.toString(),
50
+ };
51
+ await ctx.events.unsafeAppend({
52
+ aggregateId: subscriptionAggregateId(ctx.user.tenantId),
53
+ aggregateType: SUBSCRIPTION_AGGREGATE_TYPE,
54
+ type: PLAN_SWITCH_REQUESTED_EVENT_QN,
55
+ payload,
56
+ });
57
+ }
@@ -0,0 +1,4 @@
1
+ import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
2
+ import type { FeatureRegistrar } from "@cosmicdrift/kumiko-framework/engine";
3
+ export declare function scrubLegacyRawPayloadHeaders(db: DbRunner): Promise<number>;
4
+ export declare function registerScrubRawPayloadHeadersJob(r: FeatureRegistrar): void;
@@ -0,0 +1,33 @@
1
+ import { scrubEventHeaderKeys } from "@cosmicdrift/kumiko-framework/migrations";
2
+ import { INVOICE_PAID_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_QN, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_QN, } from "./events.js";
3
+ const SCRUB_RAW_PAYLOAD_HEADERS_ESCAPE_HATCH_REASON = "removes the legacy rawPayload header from billing events of every tenant";
4
+ const RAW_PAYLOAD_HEADER = "rawPayload";
5
+ const SCRUB_REASON = "billing events written before the provider payload was dropped carry it as a plaintext header, which crypto-shredding cannot reach";
6
+ // Safe to repeat: only events that still carry the header are touched.
7
+ export async function scrubLegacyRawPayloadHeaders(db) {
8
+ const { removedKeys } = await scrubEventHeaderKeys(db, {
9
+ eventTypes: [
10
+ SUBSCRIPTION_CREATED_EVENT_QN,
11
+ SUBSCRIPTION_UPDATED_EVENT_QN,
12
+ SUBSCRIPTION_CANCELED_EVENT_QN,
13
+ INVOICE_PAID_EVENT_QN,
14
+ INVOICE_PAYMENT_FAILED_EVENT_QN,
15
+ ],
16
+ keys: [RAW_PAYLOAD_HEADER],
17
+ reason: SCRUB_REASON,
18
+ });
19
+ return removedKeys;
20
+ }
21
+ // Boot-time one-off (runOnBoot is marker-deduped per Redis dataset) and idempotent by itself.
22
+ export function registerScrubRawPayloadHeadersJob(r) {
23
+ r.job({
24
+ name: "scrub-raw-payload-headers",
25
+ trigger: { manual: true },
26
+ runOnBoot: true,
27
+ escapeHatch: { reason: SCRUB_RAW_PAYLOAD_HEADERS_ESCAPE_HATCH_REASON },
28
+ handler: async (_payload, ctx) => {
29
+ const removedKeys = await scrubLegacyRawPayloadHeaders(ctx.db.unsafeRaw());
30
+ ctx.obs.log.info(`[billing-foundation:scrub-raw-payload-headers] removed ${removedKeys} legacy rawPayload headers`);
31
+ },
32
+ });
33
+ }