@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
@@ -3,7 +3,7 @@
3
3
  // subscription-paddle — Paddle Billing (merchant of record) plugin for the
4
4
  // billing-foundation plugin API. Credentials, the billing-live master switch and
5
5
  // the API environment (sandbox | live) are config keys resolved at call time, like
6
- // subscription-stripe. The `apiKey` / `webhookSecret` / `tenantBindingKey` /
6
+ // subscription-stripe. The `apiKey` / `webhookSecret` /
7
7
  // `clientToken` options are env→config bridge fallbacks.
8
8
  import { validateOneOffPriceIds, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
9
9
  import { access, createSystemConfig, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
@@ -12,12 +12,15 @@ import { egress } from "@cosmicdrift/kumiko-framework/http";
12
12
  import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
13
13
  import * as z from "zod";
14
14
  import { priceEnvSchema } from "../shared/index.js";
15
+ import { runBackfillCheckoutLedger } from "./backfill-checkout-ledger.js";
15
16
  import { makeCheckoutConfigQuery } from "./checkout-config.query.js";
16
17
  import { createPaddleCancelSubscription, createPaddleCheckoutSession, createPaddlePortalSession, createPaddleResumeSubscription, } from "./checkout-methods.js";
17
18
  import { servePaddleCheckoutPage } from "./checkout-page.js";
18
- import { PADDLE_API_KEY_CONFIG, PADDLE_BILLING_LIVE_CONFIG, PADDLE_CLIENT_TOKEN_CONFIG, PADDLE_ENVIRONMENT_CONFIG, PADDLE_PROVIDER_NAME, PADDLE_TENANT_BINDING_KEY_CONFIG, PADDLE_WEBHOOK_SECRET_CONFIG, PaddleEnvironments, SUBSCRIPTION_PADDLE_FEATURE, } from "./constants.js";
19
+ import { PADDLE_API_KEY_CONFIG, PADDLE_BILLING_LIVE_CONFIG, PADDLE_CLIENT_TOKEN_CONFIG, PADDLE_ENVIRONMENT_CONFIG, PADDLE_PROVIDER_NAME, PADDLE_WEBHOOK_SECRET_CONFIG, PaddleEnvironments, SUBSCRIPTION_PADDLE_FEATURE, } from "./constants.js";
20
+ import { LEDGER_BACKFILL_EVENT_SHORT, ledgerBackfillMarkerHandler, ledgerBackfillPayloadSchema, } from "./ledger-backfill-marker.js";
19
21
  import { createPaddleApplyPlanSwitch, createPaddlePreviewPlanSwitch, createPaddleRetrieveSubscription, } from "./plan-switch-methods.js";
20
22
  import { createPaddlePriceCache, createPaddleRetrievePrices } from "./price-methods.js";
23
+ import { shouldRedeliverLegacyCheckout } from "./redeliver-legacy-checkout.js";
21
24
  import { createPaddleRuntimes } from "./runtime.js";
22
25
  import { verifyAndParsePaddleWebhook } from "./webhook-events.js";
23
26
  /** Bridge contract: all fields are optional fallbacks for the config store. */
@@ -34,12 +37,6 @@ export const subscriptionPaddleEnvSchema = z.object({
34
37
  .describe("Paddle notification secret (`pdl_ntfset_...`). Bridge-fallback — prefer the secret.")
35
38
  .meta({ kumiko: { pulumi: { secret: true } } })
36
39
  .optional(),
37
- PADDLE_TENANT_BINDING_KEY: z
38
- .string()
39
- .min(1)
40
- .describe("Server-only HMAC key binding a Paddle checkout to its tenant. Bridge-fallback — prefer the secret.")
41
- .meta({ kumiko: { pulumi: { secret: true } } })
42
- .optional(),
43
40
  PADDLE_CLIENT_TOKEN: z
44
41
  .string()
45
42
  .regex(/^(test|live)_/, "PADDLE_CLIENT_TOKEN must start with 'test_' or 'live_'")
@@ -63,7 +60,7 @@ export function createSubscriptionPaddleFeature(options = {}) {
63
60
  validateOneOffPriceIds("subscription-paddle", options.oneOffPriceIds ?? []);
64
61
  const now = options.now ?? (() => Temporal.Now.instant().epochMilliseconds);
65
62
  const feature = defineFeature(SUBSCRIPTION_PADDLE_FEATURE, (r) => {
66
- r.describe('Paddle Billing provider plugin for `billing-foundation`. Paddle acts as merchant of record: it sells to the customer and issues invoice and VAT, so the consumer-protection texts for this provider come from `consumerProtection.providerTexts`. Reads its API key, webhook secret and tenant binding key from system config keys with `backing:"secrets"` (envelope-encrypted in the secrets store under the system tenant), the public Paddle.js `client-token`, a `billingLive` master switch and an `environment` key (sandbox | live). `environment` is its own key because Paddle serves sandbox and live from different API hosts and a live key must never hit the sandbox host or the other way round; `billingLive` only decides whether checkouts are offered at all. All of them are runtime config, so keys rotate and prod goes live without a redeploy, and the `mask` on each derives the sysadmin settings screen and nav. Mount via `createSubscriptionPaddleFeature({ priceToTier })`; the optional `apiKey`/`webhookSecret`/`tenantBindingKey`/`clientToken` options are env to config bridge fallbacks (`PADDLE_API_KEY`, `PADDLE_WEBHOOK_SECRET`, `PADDLE_TENANT_BINDING_KEY`, `PADDLE_CLIENT_TOKEN`). The plugin always mounts; `createCheckoutSession` throws `feature_disabled` unless `billingLive` is true, and billing counts as enabled only with API key and binding key present. Webhooks arrive at `/webhooks/subscription/paddle` when mounted through the server-runtime `billing.paddle` boot option, or at `/api/subscription/webhook/paddle` when `createSubscriptionWebhookRoute` is mounted by hand and are verified with the `Paddle-Signature` header (HMAC-SHA256 over `ts:rawBody` keyed with the raw secret, any `h1` may match, 5 minute tolerance). Paddle.js can open checkouts with arbitrary `customData` from the browser, so `custom_data.tenantId` is only trusted together with `tenantBinding`, an HMAC of the tenant id under the binding key; events without a valid binding, for prices outside `priceToTier` or without a tenant are dropped. Rotating the binding key makes the webhooks of existing subscriptions fail that check until they are re-bound. Paddle has no hosted checkout page, so the feature serves the Default Payment Link itself at `/billing/paddle-checkout` (the Default Payment Link in the Paddle dashboard must point to `<APP_BASE_URL>/billing/paddle-checkout`; it is the only source, because checkouts are created without a `checkout.url`). Create subscription prices in the Paddle catalog with quantity minimum and maximum 1; for one-off packs set the quantity limits on purpose, because the payment event carries `quantity` and the app has to multiply its credits by it: an anonymous page with its own CSP that loads Paddle.js from cdn.paddle.com, the one external script this framework allows, and opens the overlay for the transaction. Implements checkout, customer portal, cancel and resume, `retrievePrices` (batched, 10-minute TTL cache), `retrieveSubscription` for the sync job, and an in-app plan switch: `previewPlanSwitch` shows the proration before the customer confirms, `applyPlanSwitch` changes the plan without a hosted page and waits for the `subscription.updated` webhook to move the tier.');
63
+ r.describe('Paddle Billing provider plugin for `billing-foundation`. Paddle acts as merchant of record: it sells to the customer and issues invoice and VAT, so the consumer-protection texts for this provider come from `consumerProtection.providerTexts`. Reads its API key and webhook secret from system config keys with `backing:"secrets"` (envelope-encrypted in the secrets store under the system tenant), the public Paddle.js `client-token`, a `billingLive` master switch and an `environment` key (sandbox | live). `environment` is its own key because Paddle serves sandbox and live from different API hosts and a live key must never hit the sandbox host or the other way round; `billingLive` only decides whether checkouts are offered at all. All of them are runtime config, so keys rotate and prod goes live without a redeploy, and the `mask` on each derives the sysadmin settings screen and nav. Mount via `createSubscriptionPaddleFeature({ priceToTier })`; the optional `apiKey`/`webhookSecret`/`clientToken` options are env to config bridge fallbacks (`PADDLE_API_KEY`, `PADDLE_WEBHOOK_SECRET`, `PADDLE_CLIENT_TOKEN`). The plugin always mounts; `createCheckoutSession` throws `feature_disabled` unless `billingLive` is true, and billing counts as enabled only with the API key present. Webhooks arrive at `/webhooks/subscription/paddle` when mounted through the server-runtime `billing.paddle` boot option, or at `/api/subscription/webhook/paddle` when `createSubscriptionWebhookRoute` is mounted by hand and are verified with the `Paddle-Signature` header (HMAC-SHA256 over `ts:rawBody` keyed with the raw secret, any `h1` may match, 5 minute tolerance). Paddle.js can open checkouts with arbitrary `customData` from the browser, so `custom_data.tenantId` only locates the tenant stream: billing-foundation keeps a checkout ledger and accepts a webhook only for a transaction the server opened itself (a `subscription.created` must name it in `transaction_id`), so events for prices outside `priceToTier`, without a tenant or for foreign transactions are dropped. The `backfill-checkout-ledger` job ledgers Paddle checkouts that were open when the ledger was introduced, then goes quiet. Paddle has no hosted checkout page, so the feature serves the Default Payment Link itself at `/billing/paddle-checkout` (the Default Payment Link in the Paddle dashboard must point to `<APP_BASE_URL>/billing/paddle-checkout`; it is the only source, because checkouts are created without a `checkout.url`). Create subscription prices in the Paddle catalog with quantity minimum and maximum 1; for one-off packs set the quantity limits on purpose, because the payment event carries `quantity` and the app has to multiply its credits by it: an anonymous page with its own CSP that loads Paddle.js from cdn.paddle.com, the one external script this framework allows, and opens the overlay for the transaction. Implements checkout, customer portal, cancel and resume, `retrievePrices` (batched, 10-minute TTL cache), `retrieveSubscription` for the sync job, and an in-app plan switch: `previewPlanSwitch` shows the proration before the customer confirms, `applyPlanSwitch` changes the plan without a hosted page and waits for the `subscription.updated` webhook to move the tier.');
67
64
  r.uiHints({
68
65
  displayLabel: "Billing · Paddle",
69
66
  category: "billing",
@@ -87,12 +84,6 @@ export function createSubscriptionPaddleFeature(options = {}) {
87
84
  read: access.admin,
88
85
  mask: { title: "subscription-paddle.webhook-secret", icon: "shield", order: 2 },
89
86
  }),
90
- [PADDLE_TENANT_BINDING_KEY_CONFIG]: createSystemConfig("text", {
91
- backing: "secrets",
92
- write: access.systemAdmin,
93
- read: access.admin,
94
- mask: { title: "subscription-paddle.tenant-binding-key", icon: "lock", order: 3 },
95
- }),
96
87
  [PADDLE_CLIENT_TOKEN_CONFIG]: createSystemConfig("text", {
97
88
  write: access.systemAdmin,
98
89
  read: access.admin,
@@ -117,7 +108,6 @@ export function createSubscriptionPaddleFeature(options = {}) {
117
108
  keys: {
118
109
  "subscription-paddle.api-key": { en: "Paddle API key" },
119
110
  "subscription-paddle.webhook-secret": { en: "Paddle webhook secret" },
120
- "subscription-paddle.tenant-binding-key": { en: "Paddle tenant binding key" },
121
111
  "subscription-paddle.client-token": { en: "Paddle client-side token" },
122
112
  "subscription-paddle.environment": { en: "Paddle environment" },
123
113
  "subscription-paddle.billing-live": { en: "Live billing" },
@@ -129,7 +119,6 @@ export function createSubscriptionPaddleFeature(options = {}) {
129
119
  const runtimes = createPaddleRuntimes({
130
120
  apiKeyHandle: configKeys[PADDLE_API_KEY_CONFIG],
131
121
  webhookSecretHandle: configKeys[PADDLE_WEBHOOK_SECRET_CONFIG],
132
- tenantBindingKeyHandle: configKeys[PADDLE_TENANT_BINDING_KEY_CONFIG],
133
122
  clientTokenHandle: configKeys[PADDLE_CLIENT_TOKEN_CONFIG],
134
123
  billingLiveHandle: configKeys[PADDLE_BILLING_LIVE_CONFIG],
135
124
  environmentHandle: configKeys[PADDLE_ENVIRONMENT_CONFIG],
@@ -137,13 +126,23 @@ export function createSubscriptionPaddleFeature(options = {}) {
137
126
  fallback: {
138
127
  ...(options.apiKey !== undefined && { apiKey: options.apiKey }),
139
128
  ...(options.webhookSecret !== undefined && { webhookSecret: options.webhookSecret }),
140
- ...(options.tenantBindingKey !== undefined && {
141
- tenantBindingKey: options.tenantBindingKey,
142
- }),
143
129
  ...(options.clientToken !== undefined && { clientToken: options.clientToken }),
144
130
  },
145
131
  });
146
132
  r.queryHandler(makeCheckoutConfigQuery(runtimes.readCheckoutConfig));
133
+ r.defineEvent(LEDGER_BACKFILL_EVENT_SHORT, ledgerBackfillPayloadSchema, { piiFields: "none" });
134
+ r.writeHandler(ledgerBackfillMarkerHandler);
135
+ r.job({
136
+ name: "backfill-checkout-ledger",
137
+ trigger: { cron: "*/5 * * * *" },
138
+ concurrency: "skip",
139
+ // writeAs: ledgers each checkout in the stream of the tenant that opened it.
140
+ escapeHatch: {
141
+ reason: "ledgers open legacy Paddle checkouts in each tenant's stream via writeAs",
142
+ grants: ["systemIdentity"],
143
+ },
144
+ handler: (_payload, ctx) => runBackfillCheckoutLedger(ctx, { runtime: runtimes.ctx, priceToTier }),
145
+ });
147
146
  r.httpRoute({
148
147
  method: "GET",
149
148
  // Literal for the feature-AST extractor; must equal PADDLE_CHECKOUT_PATH (integration test).
@@ -156,8 +155,10 @@ export function createSubscriptionPaddleFeature(options = {}) {
156
155
  displayName: "Paddle",
157
156
  verifyAndParseWebhook: verifyAndParsePaddleWebhook(runtimes.webhook, {
158
157
  priceToTier,
158
+ oneOffPriceIds: options.oneOffPriceIds ?? [],
159
159
  ...(options.nowSeconds && { nowSeconds: options.nowSeconds }),
160
160
  }),
161
+ shouldRedeliverIgnoredEvent: ({ event, reason, deps }) => shouldRedeliverLegacyCheckout({ event, reason, deps }),
161
162
  createCheckoutSession: createPaddleCheckoutSession(runtimes.ctx),
162
163
  createPortalSession: createPaddlePortalSession(runtimes.ctx),
163
164
  cancelSubscription: createPaddleCancelSubscription(runtimes.ctx),
@@ -0,0 +1,17 @@
1
+ import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
2
+ import * as z from "zod";
3
+ export declare const LEDGER_BACKFILL_EVENT_SHORT: "ledger-backfill-sweep-completed";
4
+ export declare const LEDGER_BACKFILL_EVENT_QN: "subscription-paddle:event:ledger-backfill-sweep-completed";
5
+ export declare const LEDGER_BACKFILL_AGGREGATE_TYPE: "paddle-ledger-backfill";
6
+ export declare const LEDGER_BACKFILL_AGGREGATE_ID: string;
7
+ export declare const ledgerBackfillPayloadSchema: z.ZodObject<{
8
+ completedAt: z.ZodString;
9
+ }, z.core.$strip>;
10
+ export declare const ledgerBackfillMarkerPayloadSchema: z.ZodObject<{
11
+ markCompleted: z.ZodBoolean;
12
+ }, z.core.$strip>;
13
+ export type LedgerBackfillMarkerResult = {
14
+ readonly completedAt: string | null;
15
+ };
16
+ export declare const LEDGER_BACKFILL_MARKER_HANDLER_QN: "subscription-paddle:write:ledger-backfill-marker";
17
+ export declare const ledgerBackfillMarkerHandler: WriteHandlerDef;
@@ -0,0 +1,53 @@
1
+ // Marker for the one-time checkout-ledger backfill: the first completed sweep is
2
+ // recorded as an event on a fixed system-tenant stream, so every worker and every
3
+ // restart agrees on when the takeover window began.
4
+ import { v5 as uuidv5 } from "uuid";
5
+ import * as z from "zod";
6
+ import { SUBSCRIPTION_PADDLE_FEATURE } from "./constants.js";
7
+ export const LEDGER_BACKFILL_EVENT_SHORT = "ledger-backfill-sweep-completed";
8
+ export const LEDGER_BACKFILL_EVENT_QN = `${SUBSCRIPTION_PADDLE_FEATURE}:event:${LEDGER_BACKFILL_EVENT_SHORT}`;
9
+ export const LEDGER_BACKFILL_AGGREGATE_TYPE = "paddle-ledger-backfill";
10
+ // Set in stone: changing it would orphan the marker and restart the takeover window.
11
+ const LEDGER_BACKFILL_NAMESPACE = "b4c1e7a2-5d38-4f6b-9a0e-2c7d8e1f3a59";
12
+ export const LEDGER_BACKFILL_AGGREGATE_ID = uuidv5("paddle-ledger-backfill", LEDGER_BACKFILL_NAMESPACE);
13
+ export const ledgerBackfillPayloadSchema = z.object({ completedAt: z.string().min(1) });
14
+ export const ledgerBackfillMarkerPayloadSchema = z.object({ markCompleted: z.boolean() });
15
+ export const LEDGER_BACKFILL_MARKER_HANDLER_QN = `${SUBSCRIPTION_PADDLE_FEATURE}:write:ledger-backfill-marker`;
16
+ // Reads the marker; with markCompleted it also writes it when absent. One handler
17
+ // for both, so the job never reads an event stream itself.
18
+ export const ledgerBackfillMarkerHandler = {
19
+ name: "ledger-backfill-marker",
20
+ agent: { expose: false },
21
+ schema: ledgerBackfillMarkerPayloadSchema,
22
+ access: { roles: ["system"] },
23
+ handler: async (event, ctx) => {
24
+ // @cast-boundary engine-payload — dispatcher-zod-validated payload
25
+ const { markCompleted } = event.payload;
26
+ const stored = await ctx.events.load(LEDGER_BACKFILL_AGGREGATE_ID);
27
+ const marker = stored.find((entry) => entry.type === LEDGER_BACKFILL_EVENT_QN);
28
+ if (marker) {
29
+ const parsed = ledgerBackfillPayloadSchema.parse(marker.payload);
30
+ return {
31
+ isSuccess: true,
32
+ data: { completedAt: parsed.completedAt },
33
+ };
34
+ }
35
+ if (!markCompleted) {
36
+ return {
37
+ isSuccess: true,
38
+ data: { completedAt: null },
39
+ };
40
+ }
41
+ const completedAt = ctx.tz.now().toString();
42
+ await ctx.events.unsafeAppend({
43
+ aggregateId: LEDGER_BACKFILL_AGGREGATE_ID,
44
+ aggregateType: LEDGER_BACKFILL_AGGREGATE_TYPE,
45
+ type: LEDGER_BACKFILL_EVENT_QN,
46
+ payload: { completedAt },
47
+ });
48
+ return {
49
+ isSuccess: true,
50
+ data: { completedAt },
51
+ };
52
+ },
53
+ };
@@ -5,7 +5,6 @@ import { paddleSubscriptionPath } from "./checkout-methods.js";
5
5
  import { PaddleHttpError } from "./client.js";
6
6
  import { paddleAmountSchema } from "./price-methods.js";
7
7
  import { mapPaddleSubscriptionState, paddleSubscriptionSchema } from "./subscription-state.js";
8
- import { signTenantBinding } from "./tenant-binding.js";
9
8
  const NOT_FOUND = 404;
10
9
  function parseAmount(amount) {
11
10
  return Number.parseInt(amount, 10);
@@ -67,21 +66,16 @@ export function createPaddlePreviewPlanSwitch(runtime, now) {
67
66
  }
68
67
  // The switch itself arrives later as a subscription.updated webhook;
69
68
  // prevent_change keeps the old plan if the immediate charge fails. PATCH
70
- // replaces custom_data as a whole, so the tenant binding is sent again.
69
+ // replaces custom_data as a whole, so the tenant id (the webhook's stream locator) is sent again.
71
70
  export function createPaddleApplyPlanSwitch(runtime) {
72
71
  return async (ctx, options) => {
73
- const bindingKey = await runtime.tenantBindingKey(ctx);
74
72
  await runtime.call(ctx, {
75
73
  method: "PATCH",
76
74
  path: paddleSubscriptionPath(options.providerSubscriptionId),
77
75
  body: {
78
76
  ...changePlanBody(options.targetPriceId),
79
77
  on_payment_failure: "prevent_change",
80
- custom_data: {
81
- tenantId: options.tenantId,
82
- tenantBinding: signTenantBinding(bindingKey, options.tenantId),
83
- ...(options.consentId && { consentId: options.consentId }),
84
- },
78
+ custom_data: { tenantId: options.tenantId },
85
79
  },
86
80
  });
87
81
  };
@@ -0,0 +1,11 @@
1
+ import type { SignatureExtraRouteDeps } from "@cosmicdrift/kumiko-framework/api";
2
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
3
+ import { hasLegacyTenantBinding } from "./webhook-events.ts";
4
+ type IgnoredEvent = Parameters<typeof hasLegacyTenantBinding>[0];
5
+ export declare function shouldRedeliverLegacyCheckout(args: {
6
+ readonly event: IgnoredEvent;
7
+ readonly reason: string;
8
+ readonly deps: SignatureExtraRouteDeps;
9
+ readonly now?: () => Temporal.Instant;
10
+ }): Promise<boolean>;
11
+ export {};
@@ -0,0 +1,43 @@
1
+ // While the takeover window of the checkout-ledger backfill is open, a Paddle event of a legacy
2
+ // checkout (custom_data still has the tenantBinding) that billing-foundation ignored as
3
+ // "not in the ledger" may only be waiting for the next sweep. Answering it with a retryable
4
+ // 5xx makes Paddle deliver it again once the sweep has ledgered the checkout.
5
+ import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
6
+ import { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
7
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
8
+ import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
9
+ import { isTakeoverWindowOver } from "./backfill-checkout-ledger.js";
10
+ import { LEDGER_BACKFILL_MARKER_HANDLER_QN, } from "./ledger-backfill-marker.js";
11
+ import { hasLegacyTenantBinding } from "./webhook-events.js";
12
+ const log = createFallbackLogger("subscription-paddle");
13
+ // A retry cannot fix these: the marker handler is missing, disabled or not permitted.
14
+ const MARKER_CONFIGURATION_ERROR_CODES = [
15
+ "access_denied",
16
+ "not_found",
17
+ "feature_disabled",
18
+ ];
19
+ export async function shouldRedeliverLegacyCheckout(args) {
20
+ if (!hasLegacyTenantBinding(args.event))
21
+ return false;
22
+ const marker = await args.deps.dispatchWriteAs({
23
+ handlerQn: LEDGER_BACKFILL_MARKER_HANDLER_QN,
24
+ tenantId: SYSTEM_TENANT_ID,
25
+ roles: [],
26
+ payload: { markCompleted: false },
27
+ });
28
+ if (!marker.isSuccess) {
29
+ // tenantBinding is client-settable, so a permanent failure must not turn into endless 503s.
30
+ if (isOneOf(MARKER_CONFIGURATION_ERROR_CODES, marker.error.code)) {
31
+ log.warn("ledger backfill marker not readable, not redelivering", {
32
+ errorCode: marker.error.code,
33
+ });
34
+ return false;
35
+ }
36
+ // Transient or internal: Paddle redelivers only a bounded number of times, so retrying is safe.
37
+ return true;
38
+ }
39
+ const { completedAt } = marker.data; // @cast-boundary engine-payload
40
+ if (completedAt === null)
41
+ return true;
42
+ return !isTakeoverWindowOver(completedAt, (args.now ?? Temporal.Now.instant)());
43
+ }
@@ -7,28 +7,26 @@ export type PaddlePluginMethod<TName extends keyof SubscriptionProviderPlugin> =
7
7
  export type PaddleFallbacks = {
8
8
  readonly apiKey?: string;
9
9
  readonly webhookSecret?: string;
10
- readonly tenantBindingKey?: string;
11
10
  readonly clientToken?: string;
12
11
  };
13
12
  export type PaddleRuntimeDeps = {
14
13
  readonly apiKeyHandle: ConfigKeyHandle<"text">;
15
14
  readonly webhookSecretHandle: ConfigKeyHandle<"text">;
16
- readonly tenantBindingKeyHandle: ConfigKeyHandle<"text">;
17
15
  readonly clientTokenHandle: ConfigKeyHandle<"text">;
18
16
  readonly billingLiveHandle: ConfigKeyHandle<"boolean">;
19
17
  readonly environmentHandle: ConfigKeyHandle<"select">;
20
18
  readonly send: PaddleSend;
21
19
  readonly fallback: PaddleFallbacks;
22
20
  };
21
+ export type PaddleCallSource = Pick<HandlerContext, "config" | "services" | "user">;
23
22
  export type PaddleCtxRuntime = {
24
- readonly call: (ctx: HandlerContext, request: PaddleRequest) => Promise<unknown>;
23
+ readonly call: (ctx: PaddleCallSource, request: PaddleRequest) => Promise<unknown>;
24
+ readonly hasApiKey: (ctx: PaddleCallSource) => Promise<boolean>;
25
25
  readonly assertBillingLive: (ctx: HandlerContext, handlerName?: string) => Promise<void>;
26
26
  readonly isBillingEnabled: (ctx: HandlerContext) => Promise<boolean>;
27
- readonly tenantBindingKey: (ctx: HandlerContext) => Promise<string>;
28
27
  };
29
28
  export type PaddleWebhookRuntime = {
30
29
  readonly resolveWebhookSecret: (systemSecrets?: SecretsContext) => Promise<string>;
31
- readonly resolveTenantBindingKey: (systemSecrets?: SecretsContext) => Promise<string>;
32
30
  };
33
31
  export type PaddleCheckoutConfig = {
34
32
  readonly clientToken: string | null;
@@ -10,7 +10,7 @@ import { parseStoredSecret, } from "@cosmicdrift/kumiko-bundled-features/billing
10
10
  import { requireSecretsContext } from "@cosmicdrift/kumiko-bundled-features/secrets";
11
11
  import { SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
12
12
  import { UnconfiguredError } from "@cosmicdrift/kumiko-framework/errors";
13
- import { assertBillingLive } from "../shared/index.js";
13
+ import { assertBillingLive, isBillingLive } from "../shared/index.js";
14
14
  import { createPaddleHttp } from "./client.js";
15
15
  import { PADDLE_BASE_URLS, PaddleEnvironments, SUBSCRIPTION_PADDLE_FEATURE, } from "./constants.js";
16
16
  function hintFor(shortName) {
@@ -68,19 +68,16 @@ export function createPaddleRuntimes(deps) {
68
68
  baseUrl: await baseUrlFor(ctx),
69
69
  apiKey: await ctxSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey, "api-key"),
70
70
  }, request),
71
+ hasApiKey: (ctx) => hasSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey),
71
72
  assertBillingLive: (ctx, handlerName = "create-checkout-session") => assertBillingLive(ctx, deps.billingLiveHandle, SUBSCRIPTION_PADDLE_FEATURE, handlerName),
72
73
  isBillingEnabled: async (ctx) => {
73
- const live = ctx.config ? await ctx.config(deps.billingLiveHandle) : undefined;
74
- if (live !== true)
74
+ if (!(await isBillingLive(ctx, deps.billingLiveHandle)))
75
75
  return false;
76
- return ((await hasSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey)) &&
77
- (await hasSecret(ctx, deps.tenantBindingKeyHandle, deps.fallback.tenantBindingKey)));
76
+ return hasSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey);
78
77
  },
79
- tenantBindingKey: (ctx) => ctxSecret(ctx, deps.tenantBindingKeyHandle, deps.fallback.tenantBindingKey, "tenant-binding-key"),
80
78
  },
81
79
  webhook: {
82
80
  resolveWebhookSecret: (systemSecrets) => webhookSecret(systemSecrets, deps.webhookSecretHandle, deps.fallback.webhookSecret),
83
- resolveTenantBindingKey: (systemSecrets) => webhookSecret(systemSecrets, deps.tenantBindingKeyHandle, deps.fallback.tenantBindingKey),
84
81
  },
85
82
  readCheckoutConfig: async (ctx) => {
86
83
  const stored = ctx.config ? await ctx.config(deps.clientTokenHandle) : undefined;
@@ -5,6 +5,7 @@ export declare const paddleSubscriptionSchema: z.ZodObject<{
5
5
  id: z.ZodString;
6
6
  status: z.ZodString;
7
7
  customer_id: z.ZodString;
8
+ transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
8
9
  items: z.ZodArray<z.ZodObject<{
9
10
  price: z.ZodObject<{
10
11
  id: z.ZodString;
@@ -16,6 +16,7 @@ export const paddleSubscriptionSchema = z.object({
16
16
  id: z.string().min(1),
17
17
  status: z.string(),
18
18
  customer_id: z.string().min(1),
19
+ transaction_id: z.string().min(1).nullish(),
19
20
  items: z.array(z.object({
20
21
  price: z.object({ id: z.string().min(1) }),
21
22
  quantity: z.number().int().positive().optional(),
@@ -3,7 +3,11 @@ import type { SecretsContext } from "@cosmicdrift/kumiko-framework/secrets";
3
3
  import type { PaddleWebhookRuntime } from "./runtime.ts";
4
4
  export type PaddleWebhookOptions = {
5
5
  readonly priceToTier: Readonly<Record<string, string>>;
6
+ /** Prices a one-off payment may credit; Paddle.js lets a browser open checkouts with any customData. */
7
+ readonly oneOffPriceIds: readonly string[];
6
8
  /** Test seam: Unix seconds. Defaults to the wall clock. */
7
9
  readonly nowSeconds?: () => number;
8
10
  };
11
+ export declare function tenantIdOf(customData: Readonly<Record<string, unknown>> | null | undefined): string | undefined;
12
+ export declare function hasLegacyTenantBinding(event: SubscriptionEvent | PaymentEvent): boolean;
9
13
  export declare function verifyAndParsePaddleWebhook(runtime: PaddleWebhookRuntime, options: PaddleWebhookOptions): (rawBody: string, headers: Record<string, string>, systemSecrets?: SecretsContext) => Promise<SubscriptionEvent | PaymentEvent | null>;
@@ -1,14 +1,15 @@
1
1
  // Paddle webhook: signature check, then mapping of Paddle's event envelope onto
2
- // the foundation's normalized events. Events without a valid tenant binding are
3
- // dropped (200 ignored): see tenant-binding.ts.
2
+ // the foundation's normalized events. `custom_data.tenantId` only locates the
3
+ // tenant's stream; Paddle.js can open checkouts with any customData, so
4
+ // billing-foundation accepts an event only for a checkout in its own ledger.
4
5
  import { BillingEventKinds, SubscriptionEventTypes, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
5
6
  import { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
6
7
  import { parseJsonOrThrow } from "@cosmicdrift/kumiko-framework/utils";
7
8
  import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
9
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
8
10
  import * as z from "zod";
9
11
  import { PADDLE_PROVIDER_NAME } from "./constants.js";
10
12
  import { mapPaddleSubscriptionState, paddleCustomDataSchema, paddleSubscriptionSchema, } from "./subscription-state.js";
11
- import { boundTenantOf } from "./tenant-binding.js";
12
13
  import { verifyPaddleSignature } from "./verify-webhook.js";
13
14
  const PADDLE_SUBSCRIPTION_EVENT_TYPES = {
14
15
  "subscription.created": SubscriptionEventTypes.created,
@@ -40,7 +41,11 @@ const paddleTransactionSchema = z.object({
40
41
  function currentUnixSeconds() {
41
42
  return Math.floor(Temporal.Now.instant().epochMilliseconds / 1000);
42
43
  }
43
- function parsePaymentEvent(providerEventId, data, bindingKey) {
44
+ export function tenantIdOf(customData) {
45
+ const tenantId = customData?.["tenantId"];
46
+ return typeof tenantId === "string" && tenantId.length > 0 ? tenantId : undefined;
47
+ }
48
+ function parsePaymentEvent(providerEventId, data, oneOffPriceIds) {
44
49
  const parsed = paddleTransactionSchema.safeParse(data);
45
50
  if (!parsed.success)
46
51
  return null;
@@ -50,15 +55,18 @@ function parsePaymentEvent(providerEventId, data, bindingKey) {
50
55
  return null;
51
56
  const priceId = transaction.items[0]?.price.id;
52
57
  const quantity = transaction.items[0]?.quantity ?? 1;
53
- const bound = boundTenantOf(transaction.custom_data, bindingKey);
54
- if (!bound || !priceId || !transaction.customer_id)
58
+ const tenantId = tenantIdOf(transaction.custom_data);
59
+ if (!tenantId || !priceId || !transaction.customer_id)
60
+ return null;
61
+ if (!oneOffPriceIds.includes(priceId)) {
62
+ createFallbackLogger("subscription-paddle").warn("paddle one-off transaction dropped: price is not an allowed one-off price", { providerEventId, priceId });
55
63
  return null;
64
+ }
56
65
  return {
57
66
  kind: BillingEventKinds.payment,
58
67
  providerEventId,
59
68
  providerName: PADDLE_PROVIDER_NAME,
60
- tenantId: bound.tenantId,
61
- ...(bound.consentId !== undefined && { consentId: bound.consentId }),
69
+ tenantId,
62
70
  providerCheckoutId: transaction.id,
63
71
  providerCustomerId: transaction.customer_id,
64
72
  priceId,
@@ -74,51 +82,61 @@ function warnOnUnexpectedQuantity(providerEventId, items) {
74
82
  }
75
83
  }
76
84
  }
77
- function parseSubscriptionEvent(providerEventId, type, providerEventAt, data, options) {
85
+ function parseSubscriptionEvent(providerEventId, type, providerEventAt, data, priceToTier) {
78
86
  const parsed = paddleSubscriptionSchema.safeParse(data);
79
87
  if (!parsed.success)
80
88
  return null;
81
89
  const sub = parsed.data;
82
- const bound = boundTenantOf(sub.custom_data, options.bindingKey);
83
- const state = mapPaddleSubscriptionState(sub, options.priceToTier);
84
- if (!bound || !state)
90
+ const tenantId = tenantIdOf(sub.custom_data);
91
+ const state = mapPaddleSubscriptionState(sub, priceToTier);
92
+ if (!tenantId || !state)
85
93
  return null;
86
94
  warnOnUnexpectedQuantity(providerEventId, sub.items);
87
95
  return {
88
96
  providerEventId,
89
97
  providerName: PADDLE_PROVIDER_NAME,
90
98
  type,
91
- tenantId: bound.tenantId,
92
- ...(bound.consentId !== undefined && { consentId: bound.consentId }),
99
+ tenantId,
100
+ ...(sub.transaction_id && { providerCheckoutId: sub.transaction_id }),
93
101
  providerCustomerId: sub.customer_id,
94
102
  providerSubscriptionId: sub.id,
95
103
  providerEventAt,
96
104
  ...state,
97
105
  };
98
106
  }
107
+ // Events whose custom_data still carries the pre-ledger tenantBinding: they belong to a checkout
108
+ // the backfill sweep may not have ledgered yet. Kept beside the event, not on it, because
109
+ // billing-foundation must not know about the legacy binding.
110
+ const legacyBindingEvents = new WeakSet();
111
+ export function hasLegacyTenantBinding(event) {
112
+ return legacyBindingEvents.has(event);
113
+ }
114
+ function markLegacyBinding(event, data) {
115
+ if (event !== null &&
116
+ typeof propertyOf(propertyOf(data, "custom_data"), "tenantBinding") === "string") {
117
+ legacyBindingEvents.add(event);
118
+ }
119
+ return event;
120
+ }
99
121
  export function verifyAndParsePaddleWebhook(runtime, options) {
100
122
  const nowSeconds = options.nowSeconds ?? currentUnixSeconds;
101
123
  return async (rawBody, headers, systemSecrets) => {
102
124
  const secret = await runtime.resolveWebhookSecret(systemSecrets);
103
125
  verifyPaddleSignature(rawBody, headers, secret, nowSeconds());
104
- // After verification only: an unauthenticated request must not trigger a second secret read.
105
- const bindingKey = await runtime.resolveTenantBindingKey(systemSecrets);
106
126
  // Past verification the body is trusted to be Paddle's; a malformed shape is
107
127
  // schema drift, so it is dropped (200 ignored) instead of answered with a 401.
108
128
  const envelope = envelopeSchema.safeParse(parseJsonOrThrow(rawBody, "subscription-paddle webhook body"));
109
129
  if (!envelope.success)
110
130
  return null;
111
131
  const { event_id: providerEventId, event_type: type, occurred_at, data } = envelope.data;
112
- if (type === TRANSACTION_COMPLETED)
113
- return parsePaymentEvent(providerEventId, data, bindingKey);
132
+ if (type === TRANSACTION_COMPLETED) {
133
+ return markLegacyBinding(parsePaymentEvent(providerEventId, data, options.oneOffPriceIds), data);
134
+ }
114
135
  if (!Object.hasOwn(PADDLE_SUBSCRIPTION_EVENT_TYPES, type))
115
136
  return null;
116
137
  const normalizedType = PADDLE_SUBSCRIPTION_EVENT_TYPES[type];
117
138
  if (!normalizedType)
118
139
  return null;
119
- return parseSubscriptionEvent(providerEventId, normalizedType, occurred_at, data, {
120
- priceToTier: options.priceToTier,
121
- bindingKey,
122
- });
140
+ return markLegacyBinding(parseSubscriptionEvent(providerEventId, normalizedType, occurred_at, data, options.priceToTier), data);
123
141
  };
124
142
  }
@@ -1,5 +1,6 @@
1
1
  import { type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import { type FeatureWithEnvSchema } from "@cosmicdrift/kumiko-framework/env";
3
+ import type Stripe from "stripe";
3
4
  import * as z from "zod";
4
5
  /**
5
6
  * Env-vars contract for the `subscription-stripe` feature — now a **bridge
@@ -51,6 +52,9 @@ export type SubscriptionStripeOptions = {
51
52
  * explicit allowlist every one-off checkout is closed, the same
52
53
  * fail-closed default `priceToTier` has for mode:"subscription". */
53
54
  readonly oneOffPriceIds?: readonly string[];
55
+ /** Stripe SDK client config (host, protocol, retries) — lets tests point the
56
+ * client at a local fixture API. */
57
+ readonly clientConfig?: Stripe.StripeConfig;
54
58
  };
55
59
  /**
56
60
  * Factory for the subscription-stripe feature. Always mounts (no
@@ -151,6 +151,7 @@ export function createSubscriptionStripeFeature(options = {}) {
151
151
  ...(options.apiKey !== undefined && { apiKey: options.apiKey }),
152
152
  ...(options.webhookSecret !== undefined && { webhookSecret: options.webhookSecret }),
153
153
  },
154
+ ...(options.clientConfig !== undefined && { clientConfig: options.clientConfig }),
154
155
  });
155
156
  const priceCache = createStripePriceCache();
156
157
  const portalConfigurationCache = new Map();
@@ -11,6 +11,7 @@ export type StripeCheckoutSessionRuntimeOptions = {
11
11
  export declare function mapAppLocaleToStripeLocale(locale: string): Stripe.Checkout.SessionCreateParams.Locale;
12
12
  export declare function createStripeCheckoutSession(runtime: StripeCtxRuntime, { paymentInvoiceCreation }?: StripeCheckoutSessionRuntimeOptions): (ctx: HandlerContext, options: StripeCheckoutOptions) => Promise<{
13
13
  url: string;
14
+ providerCheckoutId: string;
14
15
  }>;
15
16
  export type StripePortalOptions = Parameters<NonNullable<SubscriptionProviderPlugin["createPortalSession"]>>[1];
16
17
  export declare function createStripePortalSession(runtime: StripeCtxRuntime): (ctx: HandlerContext, options: StripePortalOptions) => Promise<{
@@ -87,10 +87,7 @@ export function createStripeCheckoutSession(runtime, { paymentInvoiceCreation =
87
87
  await runtime.assertBillingLive(ctx);
88
88
  const stripe = await runtime.clientForCtx(ctx);
89
89
  const mode = options.mode ?? "subscription";
90
- const metadata = {
91
- tenantId: options.tenantId,
92
- ...(options.consentId && { consentId: options.consentId }),
93
- };
90
+ const metadata = { tenantId: options.tenantId };
94
91
  const sessionParams = (providerCustomerId) => ({
95
92
  mode,
96
93
  line_items: [{ price: options.priceId, quantity: 1 }],
@@ -139,7 +136,7 @@ export function createStripeCheckoutSession(runtime, { paymentInvoiceCreation =
139
136
  // guards against future API drift.
140
137
  throw new Error("subscription-stripe: checkout.sessions.create returned no url");
141
138
  }
142
- return { url: session.url };
139
+ return { url: session.url, providerCheckoutId: session.id };
143
140
  };
144
141
  }
145
142
  export function createStripePortalSession(runtime) {
@@ -4,7 +4,7 @@ import Stripe from "stripe";
4
4
  /** Memoize Stripe clients by api-key string — a fresh client is built only
5
5
  * when the key actually changes (rotation), so steady-state calls reuse one
6
6
  * connection-pooled instance per key. */
7
- export declare function createStripeClientCache(): (apiKey: string) => Stripe;
7
+ export declare function createStripeClientCache(clientConfig?: Stripe.StripeConfig): (apiKey: string) => Stripe;
8
8
  export type StripeRuntimeDeps = {
9
9
  readonly apiKeyHandle: ConfigKeyHandle<"text">;
10
10
  readonly webhookSecretHandle: ConfigKeyHandle<"text">;
@@ -13,6 +13,7 @@ export type StripeRuntimeDeps = {
13
13
  readonly apiKey?: string;
14
14
  readonly webhookSecret?: string;
15
15
  };
16
+ readonly clientConfig?: Stripe.StripeConfig;
16
17
  };
17
18
  /** Post-tenant runtime: used by checkout/portal/cancel which carry a full
18
19
  * HandlerContext (audited secret reads, config-gate). */
@@ -29,13 +29,13 @@ import { requireSecretsContext } from "@cosmicdrift/kumiko-bundled-features/secr
29
29
  import { SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
30
30
  import { UnconfiguredError } from "@cosmicdrift/kumiko-framework/errors";
31
31
  import Stripe from "stripe";
32
- import { assertBillingLive } from "../shared/index.js";
32
+ import { assertBillingLive, isBillingLive } from "../shared/index.js";
33
33
  import { SUBSCRIPTION_STRIPE_FEATURE } from "./constants.js";
34
34
  const API_KEY_HINT = "Set the Stripe API key via config:write:set on `subscription-stripe:config:api-key` (or seed it from STRIPE_API_KEY during the env bridge).";
35
35
  /** Memoize Stripe clients by api-key string — a fresh client is built only
36
36
  * when the key actually changes (rotation), so steady-state calls reuse one
37
37
  * connection-pooled instance per key. */
38
- export function createStripeClientCache() {
38
+ export function createStripeClientCache(clientConfig) {
39
39
  const cache = new Map();
40
40
  return (apiKey) => {
41
41
  const cached = cache.get(apiKey);
@@ -43,13 +43,13 @@ export function createStripeClientCache() {
43
43
  return cached;
44
44
  // No apiVersion pin — a string literal breaks consumers' typecheck on newer
45
45
  // stripe SDKs; the SDK's own default keeps wire-version and types aligned.
46
- const client = new Stripe(apiKey);
46
+ const client = new Stripe(apiKey, clientConfig);
47
47
  cache.set(apiKey, client);
48
48
  return client;
49
49
  };
50
50
  }
51
51
  export function createStripeRuntimes(deps) {
52
- const clientFor = createStripeClientCache();
52
+ const clientFor = createStripeClientCache(deps.clientConfig);
53
53
  async function ctxApiKey(ctx) {
54
54
  let key;
55
55
  if (ctx.services.secrets) {
@@ -81,12 +81,10 @@ export function createStripeRuntimes(deps) {
81
81
  }
82
82
  return {
83
83
  ctx: {
84
- // @wrapper-known semantic-alias
85
84
  clientForCtx: async (ctx) => clientFor(await ctxApiKey(ctx)),
86
85
  assertBillingLive: (ctx, handlerName = "create-checkout-session") => assertBillingLive(ctx, deps.billingLiveHandle, SUBSCRIPTION_STRIPE_FEATURE, handlerName),
87
86
  isBillingEnabled: async (ctx) => {
88
- const live = ctx.config ? await ctx.config(deps.billingLiveHandle) : undefined;
89
- if (live !== true)
87
+ if (!(await isBillingLive(ctx, deps.billingLiveHandle)))
90
88
  return false;
91
89
  const hasFallbackKey = deps.fallback.apiKey !== undefined && deps.fallback.apiKey.length > 0;
92
90
  if (hasFallbackKey)