@cosmicdrift/kumiko-bundled-features 0.413.1 → 0.415.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 (613) 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/signup-token-store.d.ts +2 -2
  40. package/dist/auth-email-password/signup-token-store.js +2 -4
  41. package/dist/auth-email-password/unlock-token.js +0 -2
  42. package/dist/auth-email-password/verification-token.js +0 -2
  43. package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
  44. package/dist/auth-email-password/web/auth-gate.js +2 -2
  45. package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
  46. package/dist/auth-email-password/web/auth-redirect.js +4 -0
  47. package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
  48. package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
  49. package/dist/auth-email-password/web/return-path.d.ts +2 -1
  50. package/dist/auth-email-password/web/return-path.js +2 -1
  51. package/dist/auth-email-password/web/session.js +13 -13
  52. package/dist/auth-email-password/web/signup-screen.js +1 -5
  53. package/dist/auth-email-password/web/static-account.js +6 -2
  54. package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
  55. package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
  56. package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
  57. package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
  58. package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
  59. package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
  60. package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
  61. package/dist/auth-mfa-user-data/index.js +5 -6
  62. package/dist/billing-foundation/aggregate-id.js +0 -4
  63. package/dist/billing-foundation/checkout-core.d.ts +2 -0
  64. package/dist/billing-foundation/checkout-core.js +17 -1
  65. package/dist/billing-foundation/checkout-ledger.d.ts +22 -0
  66. package/dist/billing-foundation/checkout-ledger.js +38 -0
  67. package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
  68. package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
  69. package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
  70. package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
  71. package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
  72. package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
  73. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
  74. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
  75. package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
  76. package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
  77. package/dist/billing-foundation/events.d.ts +23 -0
  78. package/dist/billing-foundation/events.js +39 -10
  79. package/dist/billing-foundation/feature.js +12 -1
  80. package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
  81. package/dist/billing-foundation/handlers/create-checkout-session.write.js +3 -2
  82. package/dist/billing-foundation/handlers/process-event.write.d.ts +4 -2
  83. package/dist/billing-foundation/handlers/process-event.write.js +132 -25
  84. package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
  85. package/dist/billing-foundation/handlers/process-payment-event.write.js +31 -11
  86. package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
  87. package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
  88. package/dist/billing-foundation/handlers/start-plan-checkout.write.js +3 -2
  89. package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
  90. package/dist/billing-foundation/i18n.js +3 -0
  91. package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
  92. package/dist/billing-foundation/pending-plan-switch.js +57 -0
  93. package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
  94. package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
  95. package/dist/billing-foundation/types.d.ts +40 -24
  96. package/dist/billing-foundation/validate-options.js +14 -0
  97. package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
  98. package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
  99. package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
  100. package/dist/billing-foundation/web/constants.d.ts +3 -0
  101. package/dist/billing-foundation/web/constants.js +5 -2
  102. package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
  103. package/dist/billing-foundation/webhook-handler.js +53 -11
  104. package/dist/cap-counter/aggregate-id.js +0 -2
  105. package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
  106. package/dist/cap-counter/stock-cap-guard.js +18 -4
  107. package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
  108. package/dist/cap-overview/i18n.js +1 -0
  109. package/dist/cap-overview/index.d.ts +1 -1
  110. package/dist/cap-overview/types.d.ts +4 -0
  111. package/dist/cap-overview/web/cap-cards-panel.js +6 -2
  112. package/dist/cap-overview/web/cap-usage-bar.js +6 -1
  113. package/dist/cap-overview/web/usage-math.d.ts +1 -0
  114. package/dist/cap-overview/web/usage-math.js +4 -0
  115. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
  116. package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
  117. package/dist/channel-whatsapp/aggregate-id.js +18 -0
  118. package/dist/channel-whatsapp/constants.d.ts +25 -0
  119. package/dist/channel-whatsapp/constants.js +36 -0
  120. package/dist/channel-whatsapp/events.d.ts +90 -0
  121. package/dist/channel-whatsapp/events.js +71 -0
  122. package/dist/channel-whatsapp/feature.d.ts +3 -0
  123. package/dist/channel-whatsapp/feature.js +56 -0
  124. package/dist/channel-whatsapp/graph-client.d.ts +85 -0
  125. package/dist/channel-whatsapp/graph-client.js +272 -0
  126. package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
  127. package/dist/channel-whatsapp/in-memory-meta.js +181 -0
  128. package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
  129. package/dist/channel-whatsapp/inbound-handlers.js +148 -0
  130. package/dist/channel-whatsapp/index.d.ts +10 -0
  131. package/dist/channel-whatsapp/index.js +10 -0
  132. package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
  133. package/dist/channel-whatsapp/meta-signature.js +19 -0
  134. package/dist/channel-whatsapp/options.d.ts +32 -0
  135. package/dist/channel-whatsapp/options.js +83 -0
  136. package/dist/channel-whatsapp/pii.d.ts +32 -0
  137. package/dist/channel-whatsapp/pii.js +61 -0
  138. package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
  139. package/dist/channel-whatsapp/webhook-normalize.js +200 -0
  140. package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
  141. package/dist/channel-whatsapp/webhook-routes.js +118 -0
  142. package/dist/compliance-profiles/handlers/set-profile.write.js +2 -0
  143. package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
  144. package/dist/config/handlers/set.write.js +7 -0
  145. package/dist/config/handlers/values.query.js +8 -1
  146. package/dist/config/index.d.ts +1 -1
  147. package/dist/config/index.js +1 -1
  148. package/dist/config/read-redaction.d.ts +1 -0
  149. package/dist/config/read-redaction.js +5 -2
  150. package/dist/config/table.js +1 -0
  151. package/dist/config/write-helpers.js +3 -2
  152. package/dist/crypto-shredding/constants.d.ts +1 -0
  153. package/dist/crypto-shredding/constants.js +1 -0
  154. package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
  155. package/dist/crypto-shredding/index.d.ts +1 -0
  156. package/dist/crypto-shredding/index.js +1 -0
  157. package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
  158. package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
  159. package/dist/custom-fields/aggregate-id.js +0 -1
  160. package/dist/custom-fields/entity.js +1 -0
  161. package/dist/custom-fields/wire-for-entity.js +0 -1
  162. package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
  163. package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
  164. package/dist/data-retention/feature.js +2 -5
  165. package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
  166. package/dist/data-retention/run-retention-cleanup.js +39 -19
  167. package/dist/data-retention/tenant-destruction-hold.js +7 -0
  168. package/dist/delivery/attempt-log-factory.d.ts +3 -0
  169. package/dist/delivery/attempt-log-factory.js +5 -0
  170. package/dist/delivery/attempt-log.d.ts +2 -2
  171. package/dist/delivery/channel-context.d.ts +1 -1
  172. package/dist/delivery/channel-context.js +5 -2
  173. package/dist/delivery/db/queries/preferences.js +0 -1
  174. package/dist/delivery/delivery-service.js +3 -0
  175. package/dist/delivery/feature.d.ts +1 -4
  176. package/dist/delivery/feature.js +3 -1
  177. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
  178. package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
  179. package/dist/delivery/handlers/opted-in-user-ids.query.js +50 -0
  180. package/dist/delivery/handlers/preferences.query.js +2 -20
  181. package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
  182. package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
  183. package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
  184. package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
  185. package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
  186. package/dist/delivery/index.d.ts +3 -1
  187. package/dist/delivery/index.js +1 -0
  188. package/dist/delivery/options.d.ts +4 -0
  189. package/dist/delivery/options.js +1 -0
  190. package/dist/delivery/preference-rows.d.ts +9 -0
  191. package/dist/delivery/preference-rows.js +22 -0
  192. package/dist/delivery/set-preference-enabled.d.ts +17 -0
  193. package/dist/delivery/set-preference-enabled.js +26 -0
  194. package/dist/delivery/tables.d.ts +2 -2
  195. package/dist/delivery/testing.d.ts +1 -1
  196. package/dist/delivery/testing.js +3 -1
  197. package/dist/delivery/types.d.ts +1 -0
  198. package/dist/delivery/unsubscribe-page.js +5 -1
  199. package/dist/delivery/upsert-preference.js +0 -1
  200. package/dist/delivery/web/public-names.d.ts +1 -0
  201. package/dist/delivery/web/public-names.js +1 -0
  202. package/dist/derivatives-sharp/render.js +9 -9
  203. package/dist/document-ingest-foundation/aggregate-id.js +0 -1
  204. package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
  205. package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
  206. package/dist/document-ingest-foundation/feature.js +1 -0
  207. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
  208. package/dist/document-ingest-foundation/report-ingest-progress.js +32 -13
  209. package/dist/documents/aggregate-id.js +0 -2
  210. package/dist/documents/constants.d.ts +6 -0
  211. package/dist/documents/constants.js +8 -2
  212. package/dist/documents/ensure-link.d.ts +5 -8
  213. package/dist/documents/ensure-link.js +4 -2
  214. package/dist/documents/feature.d.ts +3 -1
  215. package/dist/documents/feature.js +29 -5
  216. package/dist/documents/handlers/import.write.js +2 -2
  217. package/dist/documents/queries/expiry-overview.query.js +2 -1
  218. package/dist/documents/queries/for-record.query.js +3 -4
  219. package/dist/documents/queries/list-page.js +11 -3
  220. package/dist/documents/queries/overview.query.js +2 -2
  221. package/dist/documents/screens.js +3 -3
  222. package/dist/documents/tab.js +1 -1
  223. package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
  224. package/dist/feature-toggles/toggle-sync-signal.js +3 -2
  225. package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
  226. package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
  227. package/dist/file-foundation/probe.js +9 -3
  228. package/dist/file-foundation/read-file-ref-content.js +23 -11
  229. package/dist/file-provider-inmemory/feature.js +1 -1
  230. package/dist/file-provider-s3/env-feature.js +1 -1
  231. package/dist/file-provider-s3/env-named-feature.js +1 -1
  232. package/dist/file-provider-s3/env-schema.d.ts +10 -1
  233. package/dist/file-provider-s3/env-schema.js +20 -7
  234. package/dist/file-provider-s3/feature.js +1 -1
  235. package/dist/file-provider-s3/index.d.ts +1 -1
  236. package/dist/file-provider-s3/index.js +1 -1
  237. package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
  238. package/dist/file-provider-s3/lib/env-helper.js +13 -12
  239. package/dist/file-provider-s3/lib/s3-provider.js +10 -2
  240. package/dist/folders/aggregate-id.js +0 -1
  241. package/dist/folders/web/folder-manager.js +1 -1
  242. package/dist/folders-user-data/index.js +12 -14
  243. package/dist/form-draft/feature.js +1 -0
  244. package/dist/helpdesk/entity.js +4 -1
  245. package/dist/helpdesk/feature.js +37 -0
  246. package/dist/helpdesk/handlers/access.d.ts +0 -1
  247. package/dist/helpdesk/handlers/access.js +0 -3
  248. package/dist/helpdesk/handlers/attempts.js +7 -13
  249. package/dist/helpdesk/handlers/challenge.query.js +1 -2
  250. package/dist/helpdesk/handlers/reply.write.js +7 -8
  251. package/dist/helpdesk/handlers/report.write.js +4 -7
  252. package/dist/helpdesk/handlers/submit.write.js +5 -9
  253. package/dist/helpdesk/index.d.ts +1 -1
  254. package/dist/helpdesk/index.js +1 -1
  255. package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
  256. package/dist/helpdesk/legacy-contact-config.js +57 -0
  257. package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
  258. package/dist/helpdesk/legacy-contact-erasure.js +19 -0
  259. package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
  260. package/dist/helpdesk/legacy-contact-retention.js +53 -0
  261. package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
  262. package/dist/helpdesk/legacy-contact-streams.js +124 -0
  263. package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
  264. package/dist/helpdesk/legacy-contact-user-data.js +62 -0
  265. package/dist/helpdesk/lib.d.ts +8 -2
  266. package/dist/helpdesk/lib.js +32 -32
  267. package/dist/helpdesk/user-data-hooks.d.ts +10 -1
  268. package/dist/helpdesk/user-data-hooks.js +47 -36
  269. package/dist/helpdesk/web/constants.d.ts +0 -1
  270. package/dist/helpdesk/web/constants.js +0 -1
  271. package/dist/inbound-mail-foundation/account-health.js +1 -1
  272. package/dist/inbound-mail-foundation/account-poll.js +3 -1
  273. package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
  274. package/dist/inbound-mail-foundation/constants.d.ts +6 -0
  275. package/dist/inbound-mail-foundation/constants.js +6 -0
  276. package/dist/inbound-mail-foundation/content-refetch.d.ts +4 -0
  277. package/dist/inbound-mail-foundation/content-refetch.js +13 -3
  278. package/dist/inbound-mail-foundation/entities.js +58 -15
  279. package/dist/inbound-mail-foundation/events.js +16 -16
  280. package/dist/inbound-mail-foundation/feature.js +3 -1
  281. package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
  282. package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
  283. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
  284. package/dist/inbound-mail-foundation/handlers/connect-account.write.js +14 -8
  285. package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
  286. package/dist/inbound-mail-foundation/handlers/forget-message.write.js +58 -0
  287. package/dist/inbound-mail-foundation/handlers/ingest-message-schema.js +12 -5
  288. package/dist/inbound-mail-foundation/i18n.js +3 -0
  289. package/dist/inbound-mail-foundation/index.d.ts +1 -0
  290. package/dist/inbound-mail-foundation/index.js +1 -0
  291. package/dist/inbound-mail-foundation/normalize-inbound-message.d.ts +6 -0
  292. package/dist/inbound-mail-foundation/normalize-inbound-message.js +21 -8
  293. package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
  294. package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
  295. package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
  296. package/dist/inbound-mail-foundation/personal-address.js +16 -0
  297. package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
  298. package/dist/inbound-mail-foundation/purge-messages.js +33 -0
  299. package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
  300. package/dist/inbound-mail-foundation/quarantine.js +9 -5
  301. package/dist/inbound-mail-foundation/retention-job.js +1 -5
  302. package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
  303. package/dist/inbound-mail-foundation/sanitize-inbound-html.d.ts +0 -1
  304. package/dist/inbound-mail-foundation/sanitize-inbound-html.js +2 -4
  305. package/dist/inbound-mail-foundation/send-from-account.js +9 -1
  306. package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
  307. package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
  308. package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
  309. package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
  310. package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
  311. package/dist/inbound-provider-imap/byte-budget.js +53 -0
  312. package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
  313. package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
  314. package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
  315. package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
  316. package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
  317. package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
  318. package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
  319. package/dist/inbound-provider-imap/download-batch.js +21 -6
  320. package/dist/inbound-provider-imap/feature.js +7 -4
  321. package/dist/inbound-provider-imap/fetch-content.js +35 -30
  322. package/dist/inbound-provider-imap/i18n.js +2 -2
  323. package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
  324. package/dist/inbound-provider-imap/parse-message.js +8 -0
  325. package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
  326. package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
  327. package/dist/inbound-provider-imap/send-mail.js +32 -6
  328. package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
  329. package/dist/inbound-provider-imap/smtp-client.js +15 -3
  330. package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
  331. package/dist/inbound-provider-inmemory/feature.js +1 -1
  332. package/dist/jobs/events.d.ts +13 -0
  333. package/dist/jobs/events.js +8 -0
  334. package/dist/jobs/feature.js +2 -0
  335. package/dist/jobs/handlers/consumer.write.js +31 -20
  336. package/dist/jobs/web/constants.d.ts +3 -0
  337. package/dist/jobs/web/constants.js +3 -0
  338. package/dist/mail-transport-inmemory/feature.js +1 -1
  339. package/dist/mail-transport-smtp/feature.js +3 -2
  340. package/dist/managed-pages/handlers/branding.query.js +1 -1
  341. package/dist/managed-pages/handlers/by-slug.query.js +1 -1
  342. package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
  343. package/dist/managed-pages/render-page-body.d.ts +2 -0
  344. package/dist/managed-pages/render-page-body.js +12 -8
  345. package/dist/managed-pages/screens/page-screens.d.ts +3 -2
  346. package/dist/managed-pages/screens/page-screens.js +14 -33
  347. package/dist/managed-pages/table.js +1 -0
  348. package/dist/managed-pages/web/client-plugin.js +8 -6
  349. package/dist/managed-pages/web/constants.d.ts +5 -1
  350. package/dist/managed-pages/web/constants.js +6 -1
  351. package/dist/managed-pages/web/i18n.js +11 -3
  352. package/dist/managed-pages/web/markdown-to-document.js +1 -1
  353. package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
  354. package/dist/managed-pages/web/page-edit-draft.js +76 -0
  355. package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
  356. package/dist/managed-pages/web/page-edit-screen.js +113 -0
  357. package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
  358. package/dist/managed-pages/web/page-settings-rail.js +14 -0
  359. package/dist/notes-history-user-data/index.js +8 -14
  360. package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
  361. package/dist/personal-access-tokens/boot-rules.js +5 -0
  362. package/dist/personal-access-tokens/handlers/create.write.js +0 -1
  363. package/dist/personal-access-tokens/scope-events-check.js +26 -6
  364. package/dist/presence/handlers/list.query.js +18 -8
  365. package/dist/presence/room.d.ts +2 -0
  366. package/dist/presence/room.js +8 -5
  367. package/dist/presence/store.d.ts +2 -0
  368. package/dist/presence/store.js +62 -26
  369. package/dist/readiness/handlers/latest-summary.query.js +10 -6
  370. package/dist/readiness/handlers/run-probes.write.js +24 -4
  371. package/dist/readiness/handlers/run-tone.js +3 -2
  372. package/dist/readiness/handlers/status.query.js +11 -3
  373. package/dist/readiness/probe-context.js +7 -10
  374. package/dist/readiness/screens.js +4 -4
  375. package/dist/readiness/visible-results.d.ts +1 -1
  376. package/dist/readiness/visible-results.js +5 -2
  377. package/dist/renderer-foundation/api.js +6 -12
  378. package/dist/renderer-foundation/types.d.ts +2 -2
  379. package/dist/secrets/db/queries/read.d.ts +2 -1
  380. package/dist/secrets/db/queries/read.js +10 -1
  381. package/dist/secrets/handlers/list.query.js +4 -2
  382. package/dist/secrets/secret-scope.d.ts +0 -1
  383. package/dist/secrets/secret-scope.js +2 -2
  384. package/dist/secrets/secrets-context.js +4 -4
  385. package/dist/secrets/table.d.ts +1 -1
  386. package/dist/secrets/write-gate.js +4 -2
  387. package/dist/seo/handlers/seo-config.query.js +1 -1
  388. package/dist/shared/acknowledged-system-db.d.ts +5 -0
  389. package/dist/shared/acknowledged-system-db.js +9 -0
  390. package/dist/shared/assert-billing-live.d.ts +1 -0
  391. package/dist/shared/assert-billing-live.js +5 -2
  392. package/dist/shared/hmac-signature.js +4 -2
  393. package/dist/shared/index.d.ts +7 -2
  394. package/dist/shared/index.js +7 -2
  395. package/dist/shared/normalize-email.d.ts +1 -0
  396. package/dist/shared/normalize-email.js +3 -0
  397. package/dist/shared/parent-visibility.d.ts +1 -0
  398. package/dist/shared/parent-visibility.js +16 -1
  399. package/dist/shared/password-hashing.js +0 -1
  400. package/dist/shared/price-env-shape.js +1 -1
  401. package/dist/shared/register-user-data-hooks.d.ts +11 -0
  402. package/dist/shared/register-user-data-hooks.js +11 -0
  403. package/dist/shared/require-bootstrap-extension.d.ts +9 -0
  404. package/dist/shared/require-bootstrap-extension.js +16 -0
  405. package/dist/shared/send-best-effort.d.ts +3 -0
  406. package/dist/shared/send-best-effort.js +19 -0
  407. package/dist/shared/stream-tenant-backfill.d.ts +1 -0
  408. package/dist/shared/stream-tenant-backfill.js +17 -1
  409. package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
  410. package/dist/shared/stream-tenant-derived-state.js +19 -2
  411. package/dist/step-dispatcher/constants.d.ts +4 -0
  412. package/dist/step-dispatcher/constants.js +11 -0
  413. package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
  414. package/dist/step-dispatcher/deliver-dispatch-request.js +41 -3
  415. package/dist/step-dispatcher/feature.js +31 -2
  416. package/dist/step-dispatcher/mail-runner.js +0 -1
  417. package/dist/step-dispatcher/sweep-abandoned.d.ts +11 -0
  418. package/dist/step-dispatcher/sweep-abandoned.js +46 -0
  419. package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
  420. package/dist/subscription-mollie/plugin-methods.js +1 -2
  421. package/dist/subscription-mollie/verify-webhook.js +5 -5
  422. package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
  423. package/dist/subscription-paddle/backfill-checkout-ledger.js +112 -0
  424. package/dist/subscription-paddle/checkout-config.query.js +1 -1
  425. package/dist/subscription-paddle/checkout-methods.js +2 -8
  426. package/dist/subscription-paddle/constants.d.ts +0 -1
  427. package/dist/subscription-paddle/constants.js +1 -2
  428. package/dist/subscription-paddle/feature.d.ts +0 -4
  429. package/dist/subscription-paddle/feature.js +21 -20
  430. package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
  431. package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
  432. package/dist/subscription-paddle/plan-switch-methods.js +2 -8
  433. package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
  434. package/dist/subscription-paddle/redeliver-legacy-checkout.js +43 -0
  435. package/dist/subscription-paddle/runtime.d.ts +3 -5
  436. package/dist/subscription-paddle/runtime.js +4 -7
  437. package/dist/subscription-paddle/subscription-state.d.ts +1 -0
  438. package/dist/subscription-paddle/subscription-state.js +1 -0
  439. package/dist/subscription-paddle/webhook-events.d.ts +4 -0
  440. package/dist/subscription-paddle/webhook-events.js +40 -22
  441. package/dist/subscription-stripe/feature.d.ts +4 -0
  442. package/dist/subscription-stripe/feature.js +1 -0
  443. package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
  444. package/dist/subscription-stripe/plugin-methods.js +2 -5
  445. package/dist/subscription-stripe/runtime.d.ts +2 -1
  446. package/dist/subscription-stripe/runtime.js +5 -7
  447. package/dist/subscription-stripe/verify-webhook.js +31 -6
  448. package/dist/tags/aggregate-id.js +0 -1
  449. package/dist/tags/web/tag-chip.js +0 -1
  450. package/dist/tags/web/tag-manager.js +3 -1
  451. package/dist/template-resolver/api.js +6 -12
  452. package/dist/template-resolver/document-sanitizer.d.ts +1 -1
  453. package/dist/template-resolver/document-sanitizer.js +18 -0
  454. package/dist/template-resolver/feature.d.ts +1 -0
  455. package/dist/template-resolver/feature.js +2 -0
  456. package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
  457. package/dist/template-resolver/handlers/body-preview.query.js +41 -0
  458. package/dist/template-resolver/handlers/by-slug.query.js +1 -1
  459. package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
  460. package/dist/template-resolver/handlers/collection-shared.js +5 -8
  461. package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
  462. package/dist/template-resolver/handlers/overview.query.js +2 -1
  463. package/dist/template-resolver/handlers/send-test.write.js +27 -8
  464. package/dist/template-resolver/linked-resources.js +2 -6
  465. package/dist/template-resolver/seeding.js +92 -1
  466. package/dist/template-resolver/table.js +1 -0
  467. package/dist/template-resolver/template-draft.js +2 -1
  468. package/dist/template-resolver/template-preview.js +12 -3
  469. package/dist/template-resolver/testing.js +0 -2
  470. package/dist/template-resolver/web/client-plugin.js +3 -0
  471. package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
  472. package/dist/template-resolver/web/constants.d.ts +2 -0
  473. package/dist/template-resolver/web/constants.js +2 -0
  474. package/dist/template-resolver/web/content-tree-provider.js +0 -1
  475. package/dist/template-resolver/web/content-workbench.d.ts +22 -0
  476. package/dist/template-resolver/web/content-workbench.js +32 -0
  477. package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
  478. package/dist/template-resolver/web/document-insert-model.js +1 -2
  479. package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
  480. package/dist/template-resolver/web/document-link-policy.js +53 -0
  481. package/dist/template-resolver/web/document-schema.d.ts +2 -4
  482. package/dist/template-resolver/web/document-schema.js +2 -53
  483. package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
  484. package/dist/template-resolver/web/document-tiptap-context.js +2 -2
  485. package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
  486. package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
  487. package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
  488. package/dist/template-resolver/web/editor-handle.js +1 -0
  489. package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
  490. package/dist/template-resolver/web/fill-document-variables.js +22 -0
  491. package/dist/template-resolver/web/i18n.js +10 -0
  492. package/dist/template-resolver/web/index.d.ts +3 -0
  493. package/dist/template-resolver/web/index.js +2 -0
  494. package/dist/template-resolver/web/preview-targets.d.ts +5 -0
  495. package/dist/template-resolver/web/preview-targets.js +21 -0
  496. package/dist/template-resolver/web/qualified-names.d.ts +1 -0
  497. package/dist/template-resolver/web/qualified-names.js +1 -0
  498. package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
  499. package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
  500. package/dist/template-resolver/web/string-values.d.ts +1 -0
  501. package/dist/template-resolver/web/string-values.js +8 -0
  502. package/dist/template-resolver/web/text-block-editor.js +18 -11
  503. package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
  504. package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
  505. package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
  506. package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
  507. package/dist/template-resolver/web/use-text-block-editor.js +26 -5
  508. package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
  509. package/dist/template-resolver/web/web-preview-renderer.js +45 -0
  510. package/dist/template-resolver-user-data/index.js +11 -10
  511. package/dist/tenant/handlers/create.write.js +3 -7
  512. package/dist/tenant/handlers/list.query.js +3 -8
  513. package/dist/tenant/handlers/member-directory.query.js +10 -5
  514. package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
  515. package/dist/tenant/invited-membership.js +9 -1
  516. package/dist/tenant/seeding.d.ts +3 -0
  517. package/dist/tenant/seeding.js +3 -1
  518. package/dist/tenant/stream-tenant-backfill.js +5 -1
  519. package/dist/tenant/testing.js +1 -1
  520. package/dist/tenant-inactivity/check-inactive-tenants.js +29 -18
  521. package/dist/tenant-inactivity/constants.js +1 -2
  522. package/dist/tenant-inactivity/handlers/keep-account.write.js +8 -2
  523. package/dist/tenant-inactivity/state-store.d.ts +3 -1
  524. package/dist/tenant-inactivity/state-store.js +16 -1
  525. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  526. package/dist/tenant-lifecycle/constants.js +3 -0
  527. package/dist/tenant-lifecycle/feature.js +1 -0
  528. package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
  529. package/dist/tenant-lifecycle/stages.js +14 -2
  530. package/dist/tier-engine/aggregate-id.js +0 -1
  531. package/dist/tier-engine/feature.js +9 -2
  532. package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
  533. package/dist/user/handlers/me.query.js +4 -1
  534. package/dist/user/index.d.ts +1 -0
  535. package/dist/user/index.js +1 -0
  536. package/dist/user/resolve-verified-user-email.d.ts +2 -0
  537. package/dist/user/resolve-verified-user-email.js +14 -0
  538. package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
  539. package/dist/user-data-rights/feature.js +1 -0
  540. package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
  541. package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
  542. package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
  543. package/dist/user-data-rights/run-export-jobs.js +0 -2
  544. package/dist/user-data-rights/run-forget-cleanup.js +2 -2
  545. package/dist/user-data-rights/schema/download-attempt.js +3 -2
  546. package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
  547. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  548. package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
  549. package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
  550. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
  551. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
  552. package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
  553. package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
  554. package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
  555. package/dist/user-profile/handlers/change-email.write.js +0 -1
  556. package/dist/waitlist/handlers/reject.write.js +2 -1
  557. package/dist/waitlist/handlers/submit.write.js +6 -19
  558. package/dist/waitlist/import.js +2 -1
  559. package/dist/waitlist/lib.d.ts +0 -1
  560. package/dist/waitlist/lib.js +2 -10
  561. package/dist/waitlist/link-on-signup.js +2 -2
  562. package/dist/waitlist/user-data-hooks.js +6 -20
  563. package/dist/workflow-runner/aggregate-id.js +0 -1
  564. package/dist/workflow-runner/event-trigger.js +6 -2
  565. package/dist/workflow-runner/feature.js +1 -5
  566. package/dist/workflow-runner/handlers/resume-run.write.js +6 -4
  567. package/dist/workflow-runner/runner.d.ts +1 -0
  568. package/package.json +35 -11
  569. package/src/admin-shell/changes.json +6 -0
  570. package/src/agent-tools/changes.json +12 -0
  571. package/src/auth-email-password/changes.json +18 -0
  572. package/src/auth-mfa/changes.json +6 -0
  573. package/src/billing-foundation/changes.json +61 -0
  574. package/src/cap-counter/changes.json +6 -0
  575. package/src/cap-overview/changes.json +6 -0
  576. package/src/channel-in-app/changes.json +6 -0
  577. package/src/channel-whatsapp/changes.json +32 -0
  578. package/src/compliance-profiles/changes.json +5 -0
  579. package/src/config/changes.json +12 -0
  580. package/src/crypto-shredding/changes.json +18 -0
  581. package/src/data-retention/changes.json +12 -0
  582. package/src/delivery/changes.json +12 -0
  583. package/src/document-ingest-foundation/changes.json +6 -0
  584. package/src/documents/changes.json +24 -0
  585. package/src/file-provider-s3/changes.json +14 -0
  586. package/src/files/changes.json +7 -0
  587. package/src/helpdesk/changes.json +56 -0
  588. package/src/inbound-mail-foundation/changes.json +54 -0
  589. package/src/inbound-provider-imap/changes.json +13 -0
  590. package/src/mail-foundation/changes.json +6 -0
  591. package/src/managed-pages/changes.json +12 -0
  592. package/src/presence/changes.json +6 -0
  593. package/src/readiness/changes.json +25 -0
  594. package/src/secrets/changes.json +7 -0
  595. package/src/shared/changes.json +12 -0
  596. package/src/step-dispatcher/changes.json +18 -0
  597. package/src/subscription-mollie/changes.json +7 -0
  598. package/src/subscription-paddle/changes.json +19 -0
  599. package/src/subscription-stripe/changes.json +13 -0
  600. package/src/template-resolver/changes.json +48 -0
  601. package/src/tenant/changes.json +6 -0
  602. package/src/tenant-inactivity/changes.json +6 -0
  603. package/src/tenant-lifecycle/changes.json +24 -0
  604. package/src/tier-engine/changes.json +6 -0
  605. package/src/user/changes.json +6 -0
  606. package/src/waitlist/changes.json +6 -0
  607. package/src/workflow-runner/changes.json +6 -0
  608. package/dist/managed-pages/web/page-body-section.d.ts +0 -3
  609. package/dist/managed-pages/web/page-body-section.js +0 -40
  610. package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
  611. package/dist/subscription-paddle/tenant-binding.js +0 -26
  612. package/dist/template-resolver/web/content-field.d.ts +0 -9
  613. package/dist/template-resolver/web/content-field.js +0 -14
@@ -4,7 +4,7 @@
4
4
  // Only registered when `createBillingFoundationFeature` gets a `catalog`.
5
5
  import { FeatureDisabledError, UnprocessableError } from "@cosmicdrift/kumiko-framework/errors";
6
6
  import * as z from "zod";
7
- import { assertBillingEnabled, assertNoActiveSubscription, isNonEmptyStringArray, joinBaseUrl, listOfferedCatalogProviders, openCheckout, } from "../checkout-core.js";
7
+ import { assertBillingEnabled, assertNoActiveSubscription, CHECKOUT_START_RATE_LIMIT, isNonEmptyStringArray, joinBaseUrl, listOfferedCatalogProviders, openCheckout, } from "../checkout-core.js";
8
8
  import { consentCheckoutFields, consentPayloadSchema, prepareConsent, recordConsent, } from "../consumer-protection/consent-gate.js";
9
9
  import { purchaseRolesOf, resolvePlanPrices } from "../plan-catalog.js";
10
10
  import { BILLING_FOUNDATION_FEATURE } from "../web/constants.js";
@@ -48,6 +48,7 @@ export function createStartPlanCheckoutHandler(options, catalog) {
48
48
  description: "Starts a hosted checkout for a plan tier when the tenant has no active subscription; the server picks price and redirect URLs. Name the provider with providerName when the catalog offers several.",
49
49
  schema,
50
50
  access: { roles: purchaseRolesOf(catalog) },
51
+ rateLimit: CHECKOUT_START_RATE_LIMIT,
51
52
  handler: async (event, ctx) => {
52
53
  // @cast-boundary engine-payload — dispatcher-zod-validated payload
53
54
  const payload = event.payload;
@@ -63,7 +64,7 @@ export function createStartPlanCheckoutHandler(options, catalog) {
63
64
  });
64
65
  }
65
66
  const consent = consumerProtection
66
- ? await prepareConsent(ctx, consumerProtection, payload.consent, "subscription")
67
+ ? await prepareConsent(ctx, consumerProtection, payload.consent, "subscription", providerName)
67
68
  : undefined;
68
69
  const baseUrl = options.baseUrl ?? "";
69
70
  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
+ }
@@ -1,4 +1,5 @@
1
1
  /// <reference types="temporal-polyfill/global" preserve="true" />
2
+ import type { SignatureExtraRouteDeps } from "@cosmicdrift/kumiko-framework/api";
2
3
  import type { TenantDb } from "@cosmicdrift/kumiko-framework/db";
3
4
  import type { HandlerContext, TenantId } from "@cosmicdrift/kumiko-framework/engine";
4
5
  import type { SecretsContext } from "@cosmicdrift/kumiko-framework/secrets";
@@ -23,9 +24,11 @@ export type SubscriptionEvent = {
23
24
  /** Platform tenant ID (provider-customer metadata or lookup via
24
25
  * providerCustomerId). The plugin performs the resolution. */
25
26
  readonly tenantId: string;
26
- /** Consent id echoed back from checkout metadata; omitted when absent or
27
- * malformed. */
28
- readonly consentId?: string;
27
+ /** Checkout that created this subscription (Paddle transaction id, Stripe
28
+ * session id, Mollie first-payment id). `created` events are only accepted
29
+ * when the checkout is in the server's checkout ledger; later events of the
30
+ * same subscription do not need it. */
31
+ readonly providerCheckoutId?: string;
29
32
  /** Provider-owned customer ID for later lookup when events lack
30
33
  * metadata. */
31
34
  readonly providerCustomerId: string;
@@ -63,12 +66,10 @@ export type PaymentEvent = {
63
66
  * create time) — never from a freely-choosable payload field, or an
64
67
  * attacker could attribute payments to someone else's tenant. */
65
68
  readonly tenantId: string;
66
- /** Consent id echoed back from checkout metadata; omitted when absent or
67
- * malformed. */
68
- readonly consentId?: string;
69
- /** Provider's checkout/payment object id (Stripe checkout session id) —
70
- * lets consumers key their own grants without the raw provider payload. */
71
- readonly providerCheckoutId?: string;
69
+ /** Provider's checkout/payment object id (Stripe checkout session id,
70
+ * Paddle transaction id). Must name a checkout the server opened itself,
71
+ * otherwise the payment is ignored. */
72
+ readonly providerCheckoutId: string;
72
73
  /** Provider's own customer-id. */
73
74
  readonly providerCustomerId: string;
74
75
  /** Provider's own price/plan-ID of the purchased item. */
@@ -139,15 +140,13 @@ export type SubscriptionProviderPlugin = {
139
140
  * credit top-ups). Optional with default `"subscription"` — existing
140
141
  * callers are unaffected. */
141
142
  readonly mode?: "subscription" | "payment";
142
- /** Id of the consumer-protection consent recorded for this checkout.
143
- * Travels as provider metadata and comes back on the webhook event. */
144
- readonly consentId?: string;
145
143
  /** App locale (BCP-47-ish, e.g. "de", "de-DE") for the hosted page. */
146
144
  readonly locale?: string;
147
145
  /** Text shown next to the submit button on the hosted page. */
148
146
  readonly submitMessage?: string;
149
147
  }) => Promise<{
150
148
  readonly url: string;
149
+ readonly providerCheckoutId: string;
151
150
  }>;
152
151
  /**
153
152
  * **Post-tenant-resolution** — called from a write handler with a
@@ -248,7 +247,6 @@ export type SubscriptionProviderPlugin = {
248
247
  readonly providerSubscriptionId: string;
249
248
  readonly targetPriceId: string;
250
249
  readonly tenantId: string;
251
- readonly consentId?: string;
252
250
  }) => Promise<void>;
253
251
  /**
254
252
  * Fetches the live provider-side state of one subscription, for the
@@ -261,6 +259,17 @@ export type SubscriptionProviderPlugin = {
261
259
  * app's config (e.g. Stripe's price-to-tier — same silent-drop the
262
260
  * webhook path already applies to an unmapped price).
263
261
  */
262
+ /**
263
+ * Asked when billing-foundation ignored a verified event because its checkout is not in
264
+ * the ledger. Answering true makes the webhook route reply with a retryable 503 instead
265
+ * of 200, for providers that can still ledger the checkout shortly after (migration
266
+ * sweeps). Absent = never redeliver.
267
+ */
268
+ readonly shouldRedeliverIgnoredEvent?: (args: {
269
+ readonly event: SubscriptionEvent | PaymentEvent;
270
+ readonly reason: string;
271
+ readonly deps: SignatureExtraRouteDeps;
272
+ }) => Promise<boolean>;
264
273
  readonly retrieveSubscription?: (ctx: HandlerContext, providerSubscriptionId: string) => Promise<ProviderSubscriptionSnapshot | null>;
265
274
  };
266
275
  export type PlanSwitchPreview = {
@@ -364,10 +373,14 @@ export type ConsumerProtectionOptions = {
364
373
  /** Per-provider texts keyed by provider name, e.g. for a merchant-of-record
365
374
  * provider that issues the invoice and VAT itself. `vatNote` here replaces
366
375
  * the global one in that provider's confirmation mail; `checkoutNote` is
367
- * shown under the provider choice. de and en are required for each text. */
376
+ * shown under the provider choice. de and en are required for each text.
377
+ * `refundLink` replaces `legalLinks.refund` for that provider (one link for
378
+ * every locale, or one per consent locale); a provider without it falls back
379
+ * to `legalLinks.refund`. */
368
380
  readonly providerTexts?: Readonly<Record<string, {
369
381
  readonly vatNote?: Readonly<Record<string, string>>;
370
382
  readonly checkoutNote?: Readonly<Record<string, string>>;
383
+ readonly refundLink?: string | Readonly<Record<ConsentLocale, string>>;
371
384
  }>>;
372
385
  readonly operatorEmail: string;
373
386
  /** Where the public § 312k declaration is reachable. `"tenant-host"`
@@ -440,10 +453,22 @@ export type BillingPlanView = {
440
453
  readonly isCurrent: boolean;
441
454
  readonly action: BillingPlanAction;
442
455
  };
456
+ export type BillingConsumerProtectionView = {
457
+ readonly consentTexts: Readonly<Record<"de" | "en", {
458
+ readonly earlyPerformance: string;
459
+ readonly withdrawalLoss: string;
460
+ /** Present only when `documentsAcknowledgement` is on. */
461
+ readonly documentsAcknowledgement?: string;
462
+ readonly consentTextVersion: string;
463
+ }>>;
464
+ readonly legalLinks: Readonly<Record<ConsentLocale, LegalLinkSet>>;
465
+ };
443
466
  export type BillingProviderView = {
444
467
  readonly name: string;
445
468
  readonly displayName: string;
446
469
  readonly note?: Readonly<Record<string, string>>;
470
+ /** Only set when the provider has its own `providerTexts.refundLink`; replaces the top-level `consumerProtection` while this provider is selected. */
471
+ readonly consumerProtection?: BillingConsumerProtectionView;
447
472
  readonly plans: readonly BillingPlanView[];
448
473
  };
449
474
  export declare function canSwitchPlansInApp(plugin: SubscriptionProviderPlugin): boolean;
@@ -477,16 +502,7 @@ export type BillingPlansResult = {
477
502
  /** Present only when `catalog.priceNoteKey` is configured. */
478
503
  readonly priceNoteKey?: string;
479
504
  /** Present only when `consumerProtection` is configured. */
480
- readonly consumerProtection?: {
481
- readonly consentTexts: Readonly<Record<"de" | "en", {
482
- readonly earlyPerformance: string;
483
- readonly withdrawalLoss: string;
484
- /** Present only when `documentsAcknowledgement` is on. */
485
- readonly documentsAcknowledgement?: string;
486
- readonly consentTextVersion: string;
487
- }>>;
488
- readonly legalLinks: Readonly<Record<ConsentLocale, LegalLinkSet>>;
489
- };
505
+ readonly consumerProtection?: BillingConsumerProtectionView;
490
506
  };
491
507
  declare module "@cosmicdrift/kumiko-framework/engine" {
492
508
  interface KumikoExtensionOptionsMap {
@@ -22,8 +22,22 @@ function isRootRelativeOrHttpsUrl(link) {
22
22
  return false;
23
23
  }
24
24
  }
25
+ function validateProviderRefundLink(providerName, refundLink) {
26
+ const links = typeof refundLink === "string"
27
+ ? [["refundLink", refundLink]]
28
+ : CONSENT_LOCALES.map((locale) => [`refundLink.${locale}`, refundLink[locale]]);
29
+ for (const [path, link] of links) {
30
+ if (typeof link !== "string" || !isRootRelativeOrHttpsUrl(link)) {
31
+ throw bootRuleError(BILLING_FOUNDATION_BOOT_RULES.consumerProtectionInvalid, {
32
+ message: `createBillingFoundationFeature: consumerProtection.providerTexts.${providerName}.${path} "${link}" must be a root-relative path ("/..." not "//") or an absolute https URL.`,
33
+ });
34
+ }
35
+ }
36
+ }
25
37
  function validateProviderTexts(cp) {
26
38
  for (const [providerName, texts] of Object.entries(cp.providerTexts ?? {})) {
39
+ if (texts.refundLink !== undefined)
40
+ validateProviderRefundLink(providerName, texts.refundLink);
27
41
  for (const [textName, text] of [
28
42
  ["vatNote", texts.vatNote],
29
43
  ["checkoutNote", texts.checkoutNote],
@@ -31,7 +31,9 @@ function manageOrReactivateAction(canManage, subscription, t, onManage, redirect
31
31
  label: t(subscription?.cancelAt != null
32
32
  ? "billing-foundation.plans.reactivate"
33
33
  : "billing-foundation.plans.manage"),
34
- onClick: onManage,
34
+ onClick: () => {
35
+ void onManage();
36
+ },
35
37
  disabled: redirecting,
36
38
  };
37
39
  }
@@ -55,7 +57,9 @@ function planCta(plan, result, t, onAction, redirecting) {
55
57
  }
56
58
  return {
57
59
  label,
58
- onClick: () => onAction(plan.tier, kind),
60
+ onClick: () => {
61
+ void onAction(plan.tier, kind);
62
+ },
59
63
  disabled: redirecting,
60
64
  };
61
65
  }
@@ -187,6 +191,7 @@ export function BillingPlansPanel(_props) {
187
191
  const consentPlan = consentTier !== null ? dialogPlans.find((plan) => plan.tier === consentTier) : undefined;
188
192
  const switchPlan = switchTier !== null ? shownPlans.find((plan) => plan.tier === switchTier) : undefined;
189
193
  const consumerProtection = result.consumerProtection;
194
+ const checkoutConsumerProtection = activeProvider?.consumerProtection ?? consumerProtection;
190
195
  const noteLocale = resolveConsentLocale(locale);
191
196
  const noteOf = (provider) => provider.note?.[noteLocale] ?? provider.note?.["en"];
192
197
  const singleProviderNote = providers !== undefined && providers.length === 1 && providers[0] !== undefined
@@ -229,7 +234,7 @@ export function BillingPlansPanel(_props) {
229
234
  amount: formatMoney(consentPlan.price.unitAmount, consentPlan.price.currency, locale),
230
235
  renewalKey: renewalKey(consentPlan.price),
231
236
  count: new Intl.NumberFormat(locale).format(consentPlan.price.intervalCount ?? 1),
232
- }, consumerProtection: consumerProtection, providerChoice: providerChoiceFor(consentPlan.tier), note: singleProviderNote, onOrder: (consent) => orderWithConsent(consentPlan.tier, consent), onConsentTextOutdated: () => void query.refetch() })), switchPlan !== undefined && (_jsx(PlanSwitchConfirmDialog, { open: true, onOpenChange: (open) => {
237
+ }, consumerProtection: checkoutConsumerProtection, providerChoice: providerChoiceFor(consentPlan.tier), note: singleProviderNote, onOrder: (consent) => orderWithConsent(consentPlan.tier, consent), onConsentTextOutdated: () => void query.refetch() })), switchPlan !== undefined && (_jsx(PlanSwitchConfirmDialog, { open: true, onOpenChange: (open) => {
233
238
  if (!open)
234
239
  setSwitchTier(null);
235
240
  }, tier: switchPlan.tier, fromPlanName: t(result.currentTier.labelKey), toPlanName: t(switchPlan.labelKey), consumerProtection: consumerProtection, onApplied: () => {
@@ -9,7 +9,7 @@ const DECLARATION_TYPES = [
9
9
  "withdrawal",
10
10
  ];
11
11
  const TERMINATION_KINDS = ["ordinary", "extraordinary"];
12
- // kumiko-lint-ignore no-custom-primitives Uses usePrimitives().Modal internally, name is a billing domain action, not a primitive reimplementation
12
+ // biome-ignore lint/plugin: Uses usePrimitives().Modal internally, name is a billing domain action, not a primitive reimplementation
13
13
  export function CancelContractDialog({ open, onOpenChange, onTerminated, }) {
14
14
  const t = useTranslation();
15
15
  const locale = useLocale().locale();
@@ -5,7 +5,7 @@ import { useState } from "react";
5
5
  import { ConsentCheckboxes, ConsentLinks, useConsentFieldState } from "./consent-fields.js";
6
6
  import { resolveConsentLocale } from "./consumer-protection/consent-locale.js";
7
7
  export const CONSENT_TEXT_OUTDATED_CODE = "consent_text_outdated";
8
- // kumiko-lint-ignore no-custom-primitives Uses usePrimitives().Modal internally, name is a billing domain action, not a primitive reimplementation
8
+ // biome-ignore lint/plugin: Uses usePrimitives().Modal internally, name is a billing domain action, not a primitive reimplementation
9
9
  export function CheckoutConsentDialog({ open, onOpenChange, planName, price, consumerProtection, providerChoice, note, onOrder, onConsentTextOutdated, }) {
10
10
  const t = useTranslation();
11
11
  const uiLocale = useLocale().locale();
@@ -53,6 +53,9 @@ export declare const SubscriptionFoundationHandlers: {
53
53
  /** Tenant-Admin terminates or withdraws from the contract of their own
54
54
  * tenant (consumerProtection only). */
55
55
  readonly terminateContract: "billing-foundation:write:terminate-contract";
56
+ /** System-only: puts a checkout the server opened earlier into the checkout
57
+ * ledger (idempotent). Used by provider migration jobs. */
58
+ readonly recordCheckoutOpened: "billing-foundation:write:record-checkout-opened";
56
59
  /** Tenant-Admin/purchase-role picks a plan tier from the catalog with no
57
60
  * existing non-terminal subscription — starts a hosted checkout for the
58
61
  * matching price. Only registered when `createBillingFoundationFeature`
@@ -58,6 +58,9 @@ export const SubscriptionFoundationHandlers = {
58
58
  /** Tenant-Admin terminates or withdraws from the contract of their own
59
59
  * tenant (consumerProtection only). */
60
60
  terminateContract: "billing-foundation:write:terminate-contract",
61
+ /** System-only: puts a checkout the server opened earlier into the checkout
62
+ * ledger (idempotent). Used by provider migration jobs. */
63
+ recordCheckoutOpened: "billing-foundation:write:record-checkout-opened",
61
64
  /** Tenant-Admin/purchase-role picks a plan tier from the catalog with no
62
65
  * existing non-terminal subscription — starts a hosted checkout for the
63
66
  * matching price. Only registered when `createBillingFoundationFeature`
@@ -126,8 +129,8 @@ export const SubscriptionCancelTimings = {
126
129
  periodEnd: "period-end",
127
130
  immediately: "immediately",
128
131
  };
129
- // consentId is echoed back by the provider (checkout metadata), so it is
130
- // untrusted input: bounded length, id-ish charset only.
132
+ // Only the legacy-checkout migration reads a consentId back from provider
133
+ // metadata; that value is untrusted: bounded length, id-ish charset only.
131
134
  const CONSENT_ID_PATTERN = /^[A-Za-z0-9_-]{1,100}$/;
132
135
  export function parseProviderConsentId(raw) {
133
136
  return typeof raw === "string" && CONSENT_ID_PATTERN.test(raw) ? raw : undefined;
@@ -8,7 +8,7 @@ import { SubscriptionFoundationHandlers, SubscriptionFoundationQueries } from ".
8
8
  import { resolveConsentLocale } from "./consumer-protection/consent-locale.js";
9
9
  import { intervalKey } from "./plan-price.js";
10
10
  import { recurringAmountsOf } from "./plan-switch-recurring.js";
11
- // kumiko-lint-ignore no-custom-primitives Uses usePrimitives().Modal internally, name is a billing domain action, not a primitive reimplementation
11
+ // biome-ignore lint/plugin: Uses usePrimitives().Modal internally, name is a billing domain action, not a primitive reimplementation
12
12
  export function PlanSwitchConfirmDialog({ open, onOpenChange, tier, fromPlanName, toPlanName, consumerProtection, onApplied, onConsentTextOutdated, }) {
13
13
  const t = useTranslation();
14
14
  const locale = useLocale().locale();
@@ -4,6 +4,8 @@
4
4
  // signature check needs the exact bytes. No JWT/cookie auth: the provider's
5
5
  // webhook signature in verify() IS the auth, so no c.get("user") here.
6
6
  import { ExtraRouteRejection, signatureRoute } from "@cosmicdrift/kumiko-framework/api";
7
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
8
+ import { IgnoredEventReasons } from "./checkout-ledger.js";
7
9
  import { BILLING_FOUNDATION_FEATURE, BillingEventKinds, SUBSCRIPTION_PROVIDER_EXTENSION, SubscriptionFoundationHandlers, } from "./web/constants.js";
8
10
  const DEFAULT_WEBHOOK_PATH = "/api/subscription/webhook/:providerName";
9
11
  function resolveProvider(registry, providerName) {
@@ -62,15 +64,13 @@ export function createSubscriptionWebhookRoute(options = {}) {
62
64
  providerCustomerId: parsed.providerCustomerId,
63
65
  priceId: parsed.priceId,
64
66
  ...(parsed.quantity !== undefined && { quantity: parsed.quantity }),
65
- ...(parsed.consentId !== undefined && { consentId: parsed.consentId }),
66
- ...(parsed.providerCheckoutId !== undefined && {
67
- providerCheckoutId: parsed.providerCheckoutId,
68
- }),
67
+ providerCheckoutId: parsed.providerCheckoutId,
69
68
  },
70
69
  });
71
- return respondFromDispatch(c, dispatched.isSuccess && options.afterDispatch
72
- ? await options.afterDispatch(dispatched, tenantId, deps, parsed)
73
- : dispatched, "subscription_payment_webhook_processing_failed", "Internal error processing payment event");
70
+ return answerWebhook(c, { dispatched, parsed, deps, options }, [
71
+ "subscription_payment_webhook_processing_failed",
72
+ "Internal error processing payment event",
73
+ ]);
74
74
  }
75
75
  const dispatched = await deps.dispatchSystemWrite({
76
76
  handlerQn: SubscriptionFoundationHandlers.processEvent,
@@ -88,20 +88,62 @@ export function createSubscriptionWebhookRoute(options = {}) {
88
88
  ...(parsed.providerEventAt !== undefined && {
89
89
  providerEventAtIso: parsed.providerEventAt,
90
90
  }),
91
- ...(parsed.consentId !== undefined && { consentId: parsed.consentId }),
91
+ ...(parsed.providerCheckoutId !== undefined && {
92
+ providerCheckoutId: parsed.providerCheckoutId,
93
+ }),
92
94
  },
93
95
  });
94
- return respondFromDispatch(c, dispatched.isSuccess && options.afterDispatch
95
- ? await options.afterDispatch(dispatched, tenantId, deps, parsed)
96
- : dispatched, "subscription_webhook_processing_failed", "Internal error processing subscription event");
96
+ return answerWebhook(c, { dispatched, parsed, deps, options }, [
97
+ "subscription_webhook_processing_failed",
98
+ "Internal error processing subscription event",
99
+ ]);
97
100
  },
98
101
  });
99
102
  }
103
+ /** Redelivery (503) when the event may still become admissible, otherwise the afterDispatch
104
+ * side-effect for a processed event and the shared 200/500 mapping. */
105
+ async function answerWebhook(c, { dispatched, parsed, deps, options }, [errorCode, errorMessage]) {
106
+ const redeliver = await redeliveryReason(dispatched, parsed, deps);
107
+ if (redeliver !== undefined)
108
+ return retryLater(c, redeliver);
109
+ const settled = dispatched.isSuccess && !wasIgnored(dispatched) && options.afterDispatch
110
+ ? await options.afterDispatch(dispatched, parsed.tenantId, deps, parsed)
111
+ : dispatched;
112
+ return respondFromDispatch(c, settled, errorCode, errorMessage);
113
+ }
114
+ /** Why the provider should send this ignored event again, or undefined when 200 is right: the
115
+ * handler asked for it (the event beat its subscription's `created`), or the provider plugin
116
+ * expects to ledger the checkout shortly (migration sweep). */
117
+ async function redeliveryReason(dispatched, event, deps) {
118
+ if (!dispatched.isSuccess || !wasIgnored(dispatched))
119
+ return undefined;
120
+ const reason = propertyOf(dispatched.data, "reason");
121
+ if (typeof reason !== "string")
122
+ return undefined;
123
+ if (propertyOf(dispatched.data, "retry") === true)
124
+ return reason;
125
+ if (reason !== IgnoredEventReasons.checkoutNotInLedger)
126
+ return undefined;
127
+ const plugin = resolveProvider(deps.registry, event.providerName);
128
+ const redeliver = await plugin?.shouldRedeliverIgnoredEvent?.({ event, reason, deps });
129
+ return redeliver === true ? reason : undefined;
130
+ }
131
+ function retryLater(c, reason) {
132
+ c.header("Retry-After", "60");
133
+ return c.json({ error: { code: "subscription_event_redeliver", reason } }, 503);
134
+ }
135
+ /** The handler refused the event (not in the checkout ledger, foreign subscription):
136
+ * nothing was stored, so no side-effect (credits, tier sync) may follow. */
137
+ function wasIgnored(dispatched) {
138
+ return dispatched.isSuccess && propertyOf(dispatched.data, "ignored") === true;
139
+ }
100
140
  /** Shared 500/200-mapping for both dispatch branches above. Internal error →
101
141
  * provider should retry, hence 500 instead of 401/404 (transient, not a config-bug). */
102
142
  function respondFromDispatch(c, dispatched, errorCode, errorMessage) {
103
143
  if (!dispatched.isSuccess) {
104
144
  return c.json({ error: { code: errorCode, message: errorMessage, details: dispatched.error } }, 500);
105
145
  }
146
+ if (wasIgnored(dispatched))
147
+ return c.json({ ignored: true }, 200);
106
148
  return c.json({ processed: true, ...(dispatched.data ?? {}) }, 200); // @cast-boundary engine-bridge
107
149
  }
@@ -15,7 +15,6 @@ const CAP_COUNTER_ROLLING_NAMESPACE = "8b2ad0c6-1f3e-4f7c-9b8a-3c4d5e6f7a8b";
15
15
  * Parallel bookings for the same triple share one stream; the event store's
16
16
  * optimistic lock serializes them and bookCapUsage retries the loser.
17
17
  */
18
- // @wrapper-known uuid-domain
19
18
  export function capCounterAggregateId(tenantId, capName, periodStartIso) {
20
19
  return uuidv5(`${tenantId}|${capName}|${periodStartIso}`, CAP_COUNTER_NAMESPACE);
21
20
  }
@@ -34,7 +33,6 @@ export function capCounterAggregateId(tenantId, capName, periodStartIso) {
34
33
  * this with tenantId + capName and appends increment events to the stream.
35
34
  * Race-free because the event store appends with an auto-incrementing version.
36
35
  */
37
- // @wrapper-known uuid-domain
38
36
  export function rollingCapAggregateId(tenantId, capName) {
39
37
  return uuidv5(`${tenantId}|${capName}`, CAP_COUNTER_ROLLING_NAMESPACE);
40
38
  }
@@ -15,6 +15,7 @@ export type StockCapSpec<TCaps> = {
15
15
  readonly i18nKey: string;
16
16
  readonly field: string;
17
17
  };
18
+ export declare function countedSetKey(spec: Pick<StockCapSpec<unknown>, "table" | "where">): string;
18
19
  export type StockCapGuard<TCaps> = {
19
20
  readonly checkStockCap: (db: TenantDb, spec: StockCapSpec<TCaps>, context?: CapLimitContext) => Promise<WriteFailure | null>;
20
21
  readonly withStockCap: (handler: WriteHandlerDef, spec: StockCapSpec<TCaps>) => WriteHandlerDef;
@@ -9,10 +9,24 @@ import { enforceStockCap } from "./enforce-cap.js";
9
9
  const STOCK_CAP_LOCK_NAMESPACE = 0x73636170;
10
10
  // Lock on the counted set, not on `code`: two handlers capping the same rows under
11
11
  // different codes must still serialize against each other.
12
- // guard:dup-ok lock key of one counted set; only the sorted-entries shape matches other key builders
13
- function countedSetKey(spec) {
14
- const where = Object.entries(spec.where ?? {}).sort(([a], [b]) => a.localeCompare(b));
15
- return `${spec.table.tableName}:${JSON.stringify(where)}`;
12
+ export function countedSetKey(spec) {
13
+ return `${spec.table.tableName}:${canonicalWhereJson(spec.where ?? {})}`;
14
+ }
15
+ // Sorted keys at every depth; toJSON values (Temporal, Date) serialize as their string form
16
+ // instead of being walked as empty objects.
17
+ function canonicalWhereJson(value) {
18
+ if (Array.isArray(value))
19
+ return `[${value.map(canonicalWhereJson).join(",")}]`;
20
+ if (value === null || typeof value !== "object" || hasToJson(value)) {
21
+ return JSON.stringify(value) ?? "null";
22
+ }
23
+ const entries = Object.entries(value)
24
+ .filter(([, nested]) => nested !== undefined)
25
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
26
+ return `{${entries.map(([key, nested]) => `${JSON.stringify(key)}:${canonicalWhereJson(nested)}`).join(",")}}`;
27
+ }
28
+ function hasToJson(value) {
29
+ return "toJSON" in value && typeof value.toJSON === "function";
16
30
  }
17
31
  export function createStockCapGuard(resolveTierCaps) {
18
32
  async function checkStockCap(db, spec, context = {}) {