@cosmicdrift/kumiko-bundled-features 0.413.0 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (588) hide show
  1. package/dist/admin-shell/feature.js +2 -2
  2. package/dist/agent-tools/agent-doc-lint.js +2 -1
  3. package/dist/agent-tools/agent-manifest.js +33 -25
  4. package/dist/agent-tools/api-docs/collect-events.js +4 -1
  5. package/dist/agent-tools/api-docs/collect.js +3 -3
  6. package/dist/agent-tools/api-docs/generate.js +4 -1
  7. package/dist/agent-tools/api-docs/index.d.ts +1 -0
  8. package/dist/agent-tools/api-docs/index.js +1 -0
  9. package/dist/agent-tools/api-docs/problems.d.ts +21 -0
  10. package/dist/agent-tools/api-docs/problems.js +11 -1
  11. package/dist/agent-tools/api-docs/render-openapi.js +2 -0
  12. package/dist/agent-tools/api-docs/resolve-config.d.ts +9 -0
  13. package/dist/agent-tools/api-docs/resolve-config.js +11 -0
  14. package/dist/agent-tools/api-docs/scope-slug-collisions.d.ts +4 -0
  15. package/dist/agent-tools/api-docs/scope-slug-collisions.js +10 -0
  16. package/dist/agent-tools/api-docs/translation-gaps.d.ts +4 -0
  17. package/dist/agent-tools/api-docs/translation-gaps.js +29 -0
  18. package/dist/agent-tools/api-docs/webhook-example-problems.d.ts +6 -0
  19. package/dist/agent-tools/api-docs/webhook-example-problems.js +25 -0
  20. package/dist/agent-tools/index.d.ts +1 -1
  21. package/dist/agent-tools/index.js +1 -1
  22. package/dist/agent-tools/labels.d.ts +3 -2
  23. package/dist/agent-tools/labels.js +21 -4
  24. package/dist/agent-tools/tool-catalog.d.ts +5 -5
  25. package/dist/agent-tools/tool-catalog.js +12 -10
  26. package/dist/agent-tools/tool-dispatch.js +11 -1
  27. package/dist/agent-tools/types.d.ts +4 -0
  28. package/dist/audit/event-classification.js +6 -0
  29. package/dist/audit/web/i18n.js +1 -0
  30. package/dist/auth-email-password/errors.js +0 -13
  31. package/dist/auth-email-password/handlers/invite-signup-complete.write.js +101 -84
  32. package/dist/auth-email-password/handlers/login-options.query.js +1 -1
  33. package/dist/auth-email-password/handlers/request-account-unlock.write.js +1 -1
  34. package/dist/auth-email-password/handlers/request-email-verification.write.js +0 -1
  35. package/dist/auth-email-password/handlers/request-password-reset.write.js +0 -1
  36. package/dist/auth-email-password/handlers/self-registration-status.query.js +1 -1
  37. package/dist/auth-email-password/reset-token.js +0 -2
  38. package/dist/auth-email-password/seeding.js +34 -8
  39. package/dist/auth-email-password/unlock-token.js +0 -2
  40. package/dist/auth-email-password/verification-token.js +0 -2
  41. package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
  42. package/dist/auth-email-password/web/auth-gate.js +2 -2
  43. package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
  44. package/dist/auth-email-password/web/auth-redirect.js +4 -0
  45. package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
  46. package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
  47. package/dist/auth-email-password/web/return-path.d.ts +2 -1
  48. package/dist/auth-email-password/web/return-path.js +2 -1
  49. package/dist/auth-email-password/web/session.js +11 -12
  50. package/dist/auth-email-password/web/signup-screen.js +1 -5
  51. package/dist/auth-email-password/web/static-account.js +6 -2
  52. package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
  53. package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
  54. package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
  55. package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
  56. package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
  57. package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
  58. package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
  59. package/dist/auth-mfa-user-data/index.js +5 -6
  60. package/dist/billing-foundation/aggregate-id.js +0 -4
  61. package/dist/billing-foundation/checkout-core.js +8 -1
  62. package/dist/billing-foundation/checkout-ledger.d.ts +15 -0
  63. package/dist/billing-foundation/checkout-ledger.js +32 -0
  64. package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
  65. package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
  66. package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
  67. package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
  68. package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
  69. package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
  70. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
  71. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
  72. package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
  73. package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
  74. package/dist/billing-foundation/events.d.ts +22 -0
  75. package/dist/billing-foundation/events.js +38 -10
  76. package/dist/billing-foundation/feature.js +12 -1
  77. package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
  78. package/dist/billing-foundation/handlers/create-checkout-session.write.js +1 -1
  79. package/dist/billing-foundation/handlers/process-event.write.d.ts +2 -2
  80. package/dist/billing-foundation/handlers/process-event.write.js +94 -12
  81. package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
  82. package/dist/billing-foundation/handlers/process-payment-event.write.js +29 -9
  83. package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
  84. package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
  85. package/dist/billing-foundation/handlers/start-plan-checkout.write.js +1 -1
  86. package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
  87. package/dist/billing-foundation/i18n.js +3 -0
  88. package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
  89. package/dist/billing-foundation/pending-plan-switch.js +57 -0
  90. package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
  91. package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
  92. package/dist/billing-foundation/types.d.ts +40 -24
  93. package/dist/billing-foundation/validate-options.js +14 -0
  94. package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
  95. package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
  96. package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
  97. package/dist/billing-foundation/web/constants.d.ts +3 -0
  98. package/dist/billing-foundation/web/constants.js +5 -2
  99. package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
  100. package/dist/billing-foundation/webhook-handler.js +53 -11
  101. package/dist/cap-counter/aggregate-id.js +0 -2
  102. package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
  103. package/dist/cap-counter/stock-cap-guard.js +18 -4
  104. package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
  105. package/dist/cap-overview/i18n.js +1 -0
  106. package/dist/cap-overview/index.d.ts +1 -1
  107. package/dist/cap-overview/types.d.ts +4 -0
  108. package/dist/cap-overview/web/cap-cards-panel.js +6 -2
  109. package/dist/cap-overview/web/cap-usage-bar.js +6 -1
  110. package/dist/cap-overview/web/usage-math.d.ts +1 -0
  111. package/dist/cap-overview/web/usage-math.js +4 -0
  112. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
  113. package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
  114. package/dist/channel-whatsapp/aggregate-id.js +18 -0
  115. package/dist/channel-whatsapp/constants.d.ts +25 -0
  116. package/dist/channel-whatsapp/constants.js +36 -0
  117. package/dist/channel-whatsapp/events.d.ts +87 -0
  118. package/dist/channel-whatsapp/events.js +70 -0
  119. package/dist/channel-whatsapp/feature.d.ts +3 -0
  120. package/dist/channel-whatsapp/feature.js +56 -0
  121. package/dist/channel-whatsapp/graph-client.d.ts +85 -0
  122. package/dist/channel-whatsapp/graph-client.js +272 -0
  123. package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
  124. package/dist/channel-whatsapp/in-memory-meta.js +181 -0
  125. package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
  126. package/dist/channel-whatsapp/inbound-handlers.js +127 -0
  127. package/dist/channel-whatsapp/index.d.ts +10 -0
  128. package/dist/channel-whatsapp/index.js +10 -0
  129. package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
  130. package/dist/channel-whatsapp/meta-signature.js +19 -0
  131. package/dist/channel-whatsapp/options.d.ts +32 -0
  132. package/dist/channel-whatsapp/options.js +83 -0
  133. package/dist/channel-whatsapp/pii.d.ts +32 -0
  134. package/dist/channel-whatsapp/pii.js +61 -0
  135. package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
  136. package/dist/channel-whatsapp/webhook-normalize.js +185 -0
  137. package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
  138. package/dist/channel-whatsapp/webhook-routes.js +118 -0
  139. package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
  140. package/dist/config/handlers/set.write.js +7 -0
  141. package/dist/config/handlers/values.query.js +8 -1
  142. package/dist/config/index.d.ts +1 -1
  143. package/dist/config/index.js +1 -1
  144. package/dist/config/read-redaction.d.ts +1 -0
  145. package/dist/config/read-redaction.js +5 -2
  146. package/dist/config/table.js +1 -0
  147. package/dist/config/write-helpers.js +3 -2
  148. package/dist/crypto-shredding/constants.d.ts +1 -0
  149. package/dist/crypto-shredding/constants.js +1 -0
  150. package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
  151. package/dist/crypto-shredding/index.d.ts +1 -0
  152. package/dist/crypto-shredding/index.js +1 -0
  153. package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
  154. package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
  155. package/dist/custom-fields/aggregate-id.js +0 -1
  156. package/dist/custom-fields/entity.js +1 -0
  157. package/dist/custom-fields/wire-for-entity.js +0 -1
  158. package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
  159. package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
  160. package/dist/data-retention/feature.js +4 -7
  161. package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
  162. package/dist/data-retention/run-retention-cleanup.js +39 -19
  163. package/dist/data-retention/tenant-destruction-hold.js +7 -0
  164. package/dist/delivery/attempt-log-factory.d.ts +3 -0
  165. package/dist/delivery/attempt-log-factory.js +5 -0
  166. package/dist/delivery/attempt-log.d.ts +2 -2
  167. package/dist/delivery/channel-context.d.ts +1 -1
  168. package/dist/delivery/channel-context.js +5 -2
  169. package/dist/delivery/db/queries/preferences.js +0 -1
  170. package/dist/delivery/delivery-service.js +3 -0
  171. package/dist/delivery/feature.d.ts +1 -4
  172. package/dist/delivery/feature.js +3 -1
  173. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
  174. package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
  175. package/dist/delivery/handlers/opted-in-user-ids.query.js +41 -0
  176. package/dist/delivery/handlers/preferences.query.js +2 -20
  177. package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
  178. package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
  179. package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
  180. package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
  181. package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
  182. package/dist/delivery/index.d.ts +3 -1
  183. package/dist/delivery/index.js +1 -0
  184. package/dist/delivery/options.d.ts +4 -0
  185. package/dist/delivery/options.js +1 -0
  186. package/dist/delivery/preference-rows.d.ts +9 -0
  187. package/dist/delivery/preference-rows.js +22 -0
  188. package/dist/delivery/set-preference-enabled.d.ts +17 -0
  189. package/dist/delivery/set-preference-enabled.js +26 -0
  190. package/dist/delivery/tables.d.ts +2 -2
  191. package/dist/delivery/testing.d.ts +1 -1
  192. package/dist/delivery/testing.js +3 -1
  193. package/dist/delivery/types.d.ts +1 -0
  194. package/dist/delivery/unsubscribe-page.js +5 -1
  195. package/dist/delivery/upsert-preference.js +0 -1
  196. package/dist/delivery/web/public-names.d.ts +1 -0
  197. package/dist/delivery/web/public-names.js +1 -0
  198. package/dist/derivatives-sharp/render.js +9 -9
  199. package/dist/document-ingest-foundation/aggregate-id.js +0 -1
  200. package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
  201. package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
  202. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
  203. package/dist/document-ingest-foundation/report-ingest-progress.js +29 -13
  204. package/dist/documents/aggregate-id.js +0 -2
  205. package/dist/documents/constants.d.ts +6 -0
  206. package/dist/documents/constants.js +8 -2
  207. package/dist/documents/ensure-link.d.ts +5 -8
  208. package/dist/documents/ensure-link.js +4 -2
  209. package/dist/documents/feature.d.ts +3 -1
  210. package/dist/documents/feature.js +24 -5
  211. package/dist/documents/handlers/import.write.js +2 -2
  212. package/dist/documents/queries/expiry-overview.query.js +2 -1
  213. package/dist/documents/queries/for-record.query.js +3 -4
  214. package/dist/documents/queries/list-page.js +11 -3
  215. package/dist/documents/queries/overview.query.js +2 -2
  216. package/dist/documents/screens.js +3 -3
  217. package/dist/documents/tab.js +1 -1
  218. package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
  219. package/dist/feature-toggles/toggle-sync-signal.js +3 -2
  220. package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
  221. package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
  222. package/dist/file-foundation/probe.js +9 -3
  223. package/dist/file-foundation/read-file-ref-content.js +23 -11
  224. package/dist/file-provider-inmemory/feature.js +1 -1
  225. package/dist/file-provider-s3/env-feature.js +1 -1
  226. package/dist/file-provider-s3/env-named-feature.js +1 -1
  227. package/dist/file-provider-s3/env-schema.d.ts +10 -1
  228. package/dist/file-provider-s3/env-schema.js +20 -7
  229. package/dist/file-provider-s3/feature.js +1 -1
  230. package/dist/file-provider-s3/index.d.ts +1 -1
  231. package/dist/file-provider-s3/index.js +1 -1
  232. package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
  233. package/dist/file-provider-s3/lib/env-helper.js +13 -12
  234. package/dist/file-provider-s3/lib/s3-provider.js +10 -2
  235. package/dist/folders/aggregate-id.js +0 -1
  236. package/dist/folders/web/folder-manager.js +1 -1
  237. package/dist/folders-user-data/index.js +12 -14
  238. package/dist/helpdesk/entity.js +4 -1
  239. package/dist/helpdesk/feature.js +36 -0
  240. package/dist/helpdesk/handlers/access.d.ts +0 -1
  241. package/dist/helpdesk/handlers/access.js +0 -3
  242. package/dist/helpdesk/handlers/attempts.js +7 -13
  243. package/dist/helpdesk/handlers/challenge.query.js +1 -2
  244. package/dist/helpdesk/handlers/reply.write.js +4 -5
  245. package/dist/helpdesk/handlers/report.write.js +3 -7
  246. package/dist/helpdesk/handlers/submit.write.js +4 -9
  247. package/dist/helpdesk/index.d.ts +1 -1
  248. package/dist/helpdesk/index.js +1 -1
  249. package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
  250. package/dist/helpdesk/legacy-contact-config.js +57 -0
  251. package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
  252. package/dist/helpdesk/legacy-contact-erasure.js +19 -0
  253. package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
  254. package/dist/helpdesk/legacy-contact-retention.js +53 -0
  255. package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
  256. package/dist/helpdesk/legacy-contact-streams.js +121 -0
  257. package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
  258. package/dist/helpdesk/legacy-contact-user-data.js +62 -0
  259. package/dist/helpdesk/lib.d.ts +7 -1
  260. package/dist/helpdesk/lib.js +29 -29
  261. package/dist/helpdesk/user-data-hooks.d.ts +10 -1
  262. package/dist/helpdesk/user-data-hooks.js +47 -36
  263. package/dist/helpdesk/web/constants.d.ts +0 -1
  264. package/dist/helpdesk/web/constants.js +0 -1
  265. package/dist/inbound-mail-foundation/account-health.js +1 -1
  266. package/dist/inbound-mail-foundation/account-poll.js +1 -1
  267. package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
  268. package/dist/inbound-mail-foundation/constants.d.ts +6 -0
  269. package/dist/inbound-mail-foundation/constants.js +6 -0
  270. package/dist/inbound-mail-foundation/content-refetch.d.ts +1 -0
  271. package/dist/inbound-mail-foundation/content-refetch.js +15 -1
  272. package/dist/inbound-mail-foundation/entities.js +57 -15
  273. package/dist/inbound-mail-foundation/events.js +15 -16
  274. package/dist/inbound-mail-foundation/feature.js +3 -1
  275. package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
  276. package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
  277. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
  278. package/dist/inbound-mail-foundation/handlers/connect-account.write.js +12 -7
  279. package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
  280. package/dist/inbound-mail-foundation/handlers/forget-message.write.js +54 -0
  281. package/dist/inbound-mail-foundation/i18n.js +3 -0
  282. package/dist/inbound-mail-foundation/index.d.ts +1 -0
  283. package/dist/inbound-mail-foundation/index.js +1 -0
  284. package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
  285. package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
  286. package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
  287. package/dist/inbound-mail-foundation/personal-address.js +16 -0
  288. package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
  289. package/dist/inbound-mail-foundation/purge-messages.js +33 -0
  290. package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
  291. package/dist/inbound-mail-foundation/quarantine.js +9 -5
  292. package/dist/inbound-mail-foundation/retention-job.js +1 -5
  293. package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
  294. package/dist/inbound-mail-foundation/send-from-account.js +9 -1
  295. package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
  296. package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
  297. package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
  298. package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
  299. package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
  300. package/dist/inbound-provider-imap/byte-budget.js +53 -0
  301. package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
  302. package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
  303. package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
  304. package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
  305. package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
  306. package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
  307. package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
  308. package/dist/inbound-provider-imap/download-batch.js +21 -6
  309. package/dist/inbound-provider-imap/feature.js +7 -4
  310. package/dist/inbound-provider-imap/fetch-content.js +35 -30
  311. package/dist/inbound-provider-imap/i18n.js +2 -2
  312. package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
  313. package/dist/inbound-provider-imap/parse-message.js +8 -0
  314. package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
  315. package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
  316. package/dist/inbound-provider-imap/send-mail.js +32 -6
  317. package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
  318. package/dist/inbound-provider-imap/smtp-client.js +15 -3
  319. package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
  320. package/dist/inbound-provider-inmemory/feature.js +1 -1
  321. package/dist/jobs/events.d.ts +13 -0
  322. package/dist/jobs/events.js +8 -0
  323. package/dist/jobs/feature.js +2 -0
  324. package/dist/jobs/handlers/consumer.write.js +31 -20
  325. package/dist/jobs/web/constants.d.ts +3 -0
  326. package/dist/jobs/web/constants.js +3 -0
  327. package/dist/mail-transport-inmemory/feature.js +1 -1
  328. package/dist/mail-transport-smtp/feature.js +3 -2
  329. package/dist/managed-pages/handlers/branding.query.js +1 -1
  330. package/dist/managed-pages/handlers/by-slug.query.js +1 -1
  331. package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
  332. package/dist/managed-pages/render-page-body.d.ts +2 -0
  333. package/dist/managed-pages/render-page-body.js +12 -8
  334. package/dist/managed-pages/screens/page-screens.d.ts +3 -2
  335. package/dist/managed-pages/screens/page-screens.js +14 -33
  336. package/dist/managed-pages/table.js +1 -0
  337. package/dist/managed-pages/web/client-plugin.js +8 -6
  338. package/dist/managed-pages/web/constants.d.ts +5 -1
  339. package/dist/managed-pages/web/constants.js +6 -1
  340. package/dist/managed-pages/web/i18n.js +11 -3
  341. package/dist/managed-pages/web/markdown-to-document.js +1 -1
  342. package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
  343. package/dist/managed-pages/web/page-edit-draft.js +76 -0
  344. package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
  345. package/dist/managed-pages/web/page-edit-screen.js +106 -0
  346. package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
  347. package/dist/managed-pages/web/page-settings-rail.js +14 -0
  348. package/dist/notes-history-user-data/index.js +8 -14
  349. package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
  350. package/dist/personal-access-tokens/boot-rules.js +5 -0
  351. package/dist/personal-access-tokens/handlers/create.write.js +0 -1
  352. package/dist/personal-access-tokens/scope-events-check.js +26 -6
  353. package/dist/presence/handlers/list.query.js +18 -8
  354. package/dist/presence/room.d.ts +2 -0
  355. package/dist/presence/room.js +8 -5
  356. package/dist/presence/store.d.ts +2 -0
  357. package/dist/presence/store.js +62 -26
  358. package/dist/readiness/handlers/latest-summary.query.js +10 -6
  359. package/dist/readiness/handlers/run-probes.write.js +24 -4
  360. package/dist/readiness/handlers/run-tone.js +3 -2
  361. package/dist/readiness/handlers/status.query.js +11 -3
  362. package/dist/readiness/probe-context.js +7 -10
  363. package/dist/readiness/screens.js +4 -4
  364. package/dist/readiness/visible-results.d.ts +1 -1
  365. package/dist/readiness/visible-results.js +5 -2
  366. package/dist/renderer-foundation/api.js +6 -12
  367. package/dist/renderer-foundation/types.d.ts +2 -2
  368. package/dist/secrets/db/queries/read.d.ts +2 -1
  369. package/dist/secrets/db/queries/read.js +10 -1
  370. package/dist/secrets/handlers/list.query.js +4 -2
  371. package/dist/secrets/secret-scope.d.ts +0 -1
  372. package/dist/secrets/secret-scope.js +2 -2
  373. package/dist/secrets/secrets-context.js +4 -4
  374. package/dist/secrets/table.d.ts +1 -1
  375. package/dist/secrets/write-gate.js +4 -2
  376. package/dist/seo/handlers/seo-config.query.js +1 -1
  377. package/dist/shared/acknowledged-system-db.d.ts +5 -0
  378. package/dist/shared/acknowledged-system-db.js +9 -0
  379. package/dist/shared/assert-billing-live.d.ts +1 -0
  380. package/dist/shared/assert-billing-live.js +5 -2
  381. package/dist/shared/index.d.ts +6 -2
  382. package/dist/shared/index.js +6 -2
  383. package/dist/shared/parent-visibility.d.ts +1 -0
  384. package/dist/shared/parent-visibility.js +16 -1
  385. package/dist/shared/password-hashing.js +0 -1
  386. package/dist/shared/price-env-shape.js +1 -1
  387. package/dist/shared/register-user-data-hooks.d.ts +11 -0
  388. package/dist/shared/register-user-data-hooks.js +11 -0
  389. package/dist/shared/require-bootstrap-extension.d.ts +9 -0
  390. package/dist/shared/require-bootstrap-extension.js +16 -0
  391. package/dist/shared/send-best-effort.d.ts +2 -0
  392. package/dist/shared/send-best-effort.js +14 -0
  393. package/dist/shared/stream-tenant-backfill.d.ts +1 -0
  394. package/dist/shared/stream-tenant-backfill.js +17 -1
  395. package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
  396. package/dist/shared/stream-tenant-derived-state.js +19 -2
  397. package/dist/step-dispatcher/constants.d.ts +4 -0
  398. package/dist/step-dispatcher/constants.js +11 -0
  399. package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
  400. package/dist/step-dispatcher/deliver-dispatch-request.js +38 -2
  401. package/dist/step-dispatcher/feature.js +20 -2
  402. package/dist/step-dispatcher/mail-runner.js +0 -1
  403. package/dist/step-dispatcher/sweep-abandoned.d.ts +10 -0
  404. package/dist/step-dispatcher/sweep-abandoned.js +43 -0
  405. package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
  406. package/dist/subscription-mollie/plugin-methods.js +1 -2
  407. package/dist/subscription-mollie/verify-webhook.js +5 -5
  408. package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
  409. package/dist/subscription-paddle/backfill-checkout-ledger.js +110 -0
  410. package/dist/subscription-paddle/checkout-config.query.js +1 -1
  411. package/dist/subscription-paddle/checkout-methods.js +2 -8
  412. package/dist/subscription-paddle/constants.d.ts +0 -1
  413. package/dist/subscription-paddle/constants.js +1 -2
  414. package/dist/subscription-paddle/feature.d.ts +0 -4
  415. package/dist/subscription-paddle/feature.js +21 -20
  416. package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
  417. package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
  418. package/dist/subscription-paddle/plan-switch-methods.js +2 -8
  419. package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
  420. package/dist/subscription-paddle/redeliver-legacy-checkout.js +26 -0
  421. package/dist/subscription-paddle/runtime.d.ts +3 -5
  422. package/dist/subscription-paddle/runtime.js +4 -7
  423. package/dist/subscription-paddle/subscription-state.d.ts +1 -0
  424. package/dist/subscription-paddle/subscription-state.js +1 -0
  425. package/dist/subscription-paddle/webhook-events.d.ts +4 -0
  426. package/dist/subscription-paddle/webhook-events.js +40 -22
  427. package/dist/subscription-stripe/feature.d.ts +4 -0
  428. package/dist/subscription-stripe/feature.js +1 -0
  429. package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
  430. package/dist/subscription-stripe/plugin-methods.js +2 -5
  431. package/dist/subscription-stripe/runtime.d.ts +2 -1
  432. package/dist/subscription-stripe/runtime.js +5 -7
  433. package/dist/subscription-stripe/verify-webhook.js +21 -6
  434. package/dist/tags/aggregate-id.js +0 -1
  435. package/dist/tags/web/tag-chip.js +0 -1
  436. package/dist/tags/web/tag-manager.js +3 -1
  437. package/dist/template-resolver/api.js +6 -12
  438. package/dist/template-resolver/document-sanitizer.d.ts +1 -1
  439. package/dist/template-resolver/document-sanitizer.js +18 -0
  440. package/dist/template-resolver/feature.d.ts +1 -0
  441. package/dist/template-resolver/feature.js +2 -0
  442. package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
  443. package/dist/template-resolver/handlers/body-preview.query.js +41 -0
  444. package/dist/template-resolver/handlers/by-slug.query.js +1 -1
  445. package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
  446. package/dist/template-resolver/handlers/collection-shared.js +5 -8
  447. package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
  448. package/dist/template-resolver/handlers/overview.query.js +2 -1
  449. package/dist/template-resolver/handlers/send-test.write.js +27 -8
  450. package/dist/template-resolver/linked-resources.js +2 -6
  451. package/dist/template-resolver/seeding.js +67 -1
  452. package/dist/template-resolver/table.js +1 -0
  453. package/dist/template-resolver/template-draft.js +2 -1
  454. package/dist/template-resolver/template-preview.js +12 -3
  455. package/dist/template-resolver/testing.js +0 -2
  456. package/dist/template-resolver/web/client-plugin.js +3 -0
  457. package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
  458. package/dist/template-resolver/web/constants.d.ts +2 -0
  459. package/dist/template-resolver/web/constants.js +2 -0
  460. package/dist/template-resolver/web/content-tree-provider.js +0 -1
  461. package/dist/template-resolver/web/content-workbench.d.ts +22 -0
  462. package/dist/template-resolver/web/content-workbench.js +32 -0
  463. package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
  464. package/dist/template-resolver/web/document-insert-model.js +1 -2
  465. package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
  466. package/dist/template-resolver/web/document-link-policy.js +53 -0
  467. package/dist/template-resolver/web/document-schema.d.ts +2 -4
  468. package/dist/template-resolver/web/document-schema.js +2 -53
  469. package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
  470. package/dist/template-resolver/web/document-tiptap-context.js +2 -2
  471. package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
  472. package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
  473. package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
  474. package/dist/template-resolver/web/editor-handle.js +1 -0
  475. package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
  476. package/dist/template-resolver/web/fill-document-variables.js +22 -0
  477. package/dist/template-resolver/web/i18n.js +10 -0
  478. package/dist/template-resolver/web/index.d.ts +3 -0
  479. package/dist/template-resolver/web/index.js +2 -0
  480. package/dist/template-resolver/web/preview-targets.d.ts +5 -0
  481. package/dist/template-resolver/web/preview-targets.js +21 -0
  482. package/dist/template-resolver/web/qualified-names.d.ts +1 -0
  483. package/dist/template-resolver/web/qualified-names.js +1 -0
  484. package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
  485. package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
  486. package/dist/template-resolver/web/string-values.d.ts +1 -0
  487. package/dist/template-resolver/web/string-values.js +8 -0
  488. package/dist/template-resolver/web/text-block-editor.js +18 -11
  489. package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
  490. package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
  491. package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
  492. package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
  493. package/dist/template-resolver/web/use-text-block-editor.js +26 -5
  494. package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
  495. package/dist/template-resolver/web/web-preview-renderer.js +41 -0
  496. package/dist/template-resolver-user-data/index.js +11 -10
  497. package/dist/tenant/handlers/create.write.js +3 -7
  498. package/dist/tenant/handlers/list.query.js +3 -8
  499. package/dist/tenant/handlers/member-directory.query.js +10 -5
  500. package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
  501. package/dist/tenant/invited-membership.js +9 -1
  502. package/dist/tenant/seeding.d.ts +3 -0
  503. package/dist/tenant/seeding.js +3 -1
  504. package/dist/tenant/stream-tenant-backfill.js +5 -1
  505. package/dist/tenant/testing.js +1 -1
  506. package/dist/tenant-inactivity/check-inactive-tenants.js +5 -5
  507. package/dist/tenant-inactivity/constants.js +1 -2
  508. package/dist/tenant-inactivity/handlers/keep-account.write.js +1 -2
  509. package/dist/tenant-inactivity/state-store.d.ts +1 -0
  510. package/dist/tenant-inactivity/state-store.js +9 -1
  511. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  512. package/dist/tenant-lifecycle/constants.js +3 -0
  513. package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
  514. package/dist/tenant-lifecycle/stages.js +14 -2
  515. package/dist/tier-engine/aggregate-id.js +0 -1
  516. package/dist/tier-engine/feature.js +9 -2
  517. package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
  518. package/dist/user/handlers/me.query.js +4 -1
  519. package/dist/user/index.d.ts +1 -0
  520. package/dist/user/index.js +1 -0
  521. package/dist/user/resolve-verified-user-email.d.ts +2 -0
  522. package/dist/user/resolve-verified-user-email.js +14 -0
  523. package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
  524. package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
  525. package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
  526. package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
  527. package/dist/user-data-rights/run-export-jobs.js +0 -2
  528. package/dist/user-data-rights/run-forget-cleanup.js +2 -2
  529. package/dist/user-data-rights/schema/download-attempt.js +3 -2
  530. package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
  531. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  532. package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
  533. package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
  534. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
  535. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
  536. package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
  537. package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
  538. package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
  539. package/dist/user-profile/handlers/change-email.write.js +0 -1
  540. package/dist/waitlist/handlers/submit.write.js +5 -18
  541. package/dist/waitlist/lib.js +2 -7
  542. package/dist/waitlist/user-data-hooks.js +6 -20
  543. package/dist/workflow-runner/aggregate-id.js +0 -1
  544. package/dist/workflow-runner/event-trigger.js +6 -2
  545. package/dist/workflow-runner/feature.js +1 -5
  546. package/dist/workflow-runner/handlers/resume-run.write.js +4 -3
  547. package/dist/workflow-runner/runner.d.ts +1 -0
  548. package/package.json +35 -11
  549. package/src/admin-shell/changes.json +6 -0
  550. package/src/agent-tools/changes.json +12 -0
  551. package/src/auth-email-password/changes.json +18 -0
  552. package/src/billing-foundation/changes.json +37 -0
  553. package/src/cap-counter/changes.json +6 -0
  554. package/src/cap-overview/changes.json +6 -0
  555. package/src/channel-in-app/changes.json +6 -0
  556. package/src/channel-whatsapp/changes.json +8 -0
  557. package/src/config/changes.json +12 -0
  558. package/src/crypto-shredding/changes.json +18 -0
  559. package/src/data-retention/changes.json +18 -0
  560. package/src/delivery/changes.json +6 -0
  561. package/src/documents/changes.json +18 -0
  562. package/src/file-provider-s3/changes.json +14 -0
  563. package/src/files/changes.json +7 -0
  564. package/src/helpdesk/changes.json +62 -0
  565. package/src/inbound-mail-foundation/changes.json +48 -0
  566. package/src/inbound-provider-imap/changes.json +13 -0
  567. package/src/mail-foundation/changes.json +6 -0
  568. package/src/managed-pages/changes.json +12 -0
  569. package/src/presence/changes.json +6 -0
  570. package/src/readiness/changes.json +25 -0
  571. package/src/secrets/changes.json +7 -0
  572. package/src/shared/changes.json +6 -0
  573. package/src/step-dispatcher/changes.json +12 -0
  574. package/src/subscription-mollie/changes.json +7 -0
  575. package/src/subscription-paddle/changes.json +13 -0
  576. package/src/subscription-stripe/changes.json +7 -0
  577. package/src/template-resolver/changes.json +36 -0
  578. package/src/tenant/changes.json +6 -0
  579. package/src/tenant-lifecycle/changes.json +18 -0
  580. package/src/tier-engine/changes.json +6 -0
  581. package/src/user/changes.json +6 -0
  582. package/src/waitlist/changes.json +6 -0
  583. package/dist/managed-pages/web/page-body-section.d.ts +0 -3
  584. package/dist/managed-pages/web/page-body-section.js +0 -40
  585. package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
  586. package/dist/subscription-paddle/tenant-binding.js +0 -26
  587. package/dist/template-resolver/web/content-field.d.ts +0 -9
  588. package/dist/template-resolver/web/content-field.js +0 -14
@@ -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,7 +4,9 @@
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";
7
8
  import { BILLING_FOUNDATION_FEATURE, BillingEventKinds, SUBSCRIPTION_PROVIDER_EXTENSION, SubscriptionFoundationHandlers, } from "./web/constants.js";
9
+ const IGNORED_CHECKOUT_NOT_IN_LEDGER = "checkout_not_in_ledger";
8
10
  const DEFAULT_WEBHOOK_PATH = "/api/subscription/webhook/:providerName";
9
11
  function resolveProvider(registry, providerName) {
10
12
  return registry
@@ -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 !== IGNORED_CHECKOUT_NOT_IN_LEDGER)
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 = {}) {
@@ -32,11 +32,25 @@ function tenantCapKey(tenantId, capId) {
32
32
  // One config accessor per tenant: limits may read tenant-scoped config keys, so
33
33
  // a limit shared across tenants of the same tier would show the wrong value.
34
34
  async function resolveLimitsByTenantAndCap(caps, tenants, configFor, db) {
35
- const entries = await Promise.all(tenants.flatMap(({ tenantId, tier }) => {
36
- const context = { config: configFor?.(tenantId), tenantId, db };
37
- return caps.map(async (cap) => [tenantCapKey(tenantId, cap.id), await cap.limit(tier, context)]);
35
+ const limitTenants = tenants.map(({ tenantId, tier }) => ({
36
+ config: configFor?.(tenantId),
37
+ tenantId,
38
+ tier,
38
39
  }));
39
- return new Map(entries);
40
+ const entries = await Promise.all(caps.map(async (cap) => {
41
+ if (cap.limitBatch) {
42
+ const batch = await cap.limitBatch(limitTenants, db);
43
+ return limitTenants.map(({ tenantId }) => [tenantCapKey(tenantId, cap.id), batch.get(tenantId) ?? null]);
44
+ }
45
+ return Promise.all(limitTenants.map(async ({ tier, ...tenantContext }) => {
46
+ const context = { ...tenantContext, db };
47
+ return [
48
+ tenantCapKey(tenantContext.tenantId, cap.id),
49
+ await cap.limit(tier, context),
50
+ ];
51
+ }));
52
+ }));
53
+ return new Map(entries.flat());
40
54
  }
41
55
  // tier is a plain string with no defined ordering — lt/gt have no meaning
42
56
  // on it and are rejected rather than silently treated as "no filter".
@@ -15,6 +15,7 @@ export const CAP_OVERVIEW_I18N = {
15
15
  "cap-overview.cards.viewAll": { en: "View all usage" },
16
16
  "cap-overview.notMeasured": { en: "Not measured yet" },
17
17
  "cap-overview.notIncluded": { en: "Not included" },
18
+ "cap-overview.notIncludedButUsed": { en: "{used} · not included" },
18
19
  "cap-overview.unlimited": { en: "{used} · unlimited" },
19
20
  "cap-overview.errors.progressPrimitiveMissing": {
20
21
  en: "Usage bar unavailable — Progress primitive is not registered.",
@@ -1,6 +1,6 @@
1
1
  export { DEFAULT_CAP_USAGE_ROLES } from "./access.ts";
2
2
  export { type CreateCapOverviewOptions, createCapOverviewFeature } from "./feature.ts";
3
3
  export { createMyCapsScreen, createTenantCapListScreen, platformTenantCapsScreen, } from "./screens.ts";
4
- export type { CapSpec, CapSpecLimitContext, CapUsage, CapUsageTone, CapUsageWithMeta, } from "./types.ts";
4
+ export type { CapSpec, CapSpecLimitContext, CapSpecLimitTenant, CapUsage, CapUsageTone, CapUsageWithMeta, } from "./types.ts";
5
5
  export { CAP_CARDS_PANEL_COMPONENT, CAP_OVERVIEW_FEATURE, CAP_USAGE_CELL_COMPONENT, CapOverviewQueries, capFieldName, MY_CAPS_SCREEN_ID, PLATFORM_TENANT_CAPS_SCREEN_ID, TENANT_CAP_LIST_SCREEN_ID, } from "./web/constants.ts";
6
6
  export { computeFraction, computeTone } from "./web/usage-math.ts";
@@ -7,10 +7,14 @@ export type CapSpecLimitContext = CapLimitContext & {
7
7
  readonly tenantId: TenantId;
8
8
  readonly db: TenantDb;
9
9
  };
10
+ export type CapSpecLimitTenant = Omit<CapSpecLimitContext, "db"> & {
11
+ readonly tier: string;
12
+ };
10
13
  export type CapSpec = {
11
14
  readonly id: string;
12
15
  readonly label: string;
13
16
  readonly limit: (tier: string, context: CapSpecLimitContext) => number | null | Promise<number | null>;
17
+ readonly limitBatch?: (tenants: readonly CapSpecLimitTenant[], db: TenantDb) => Promise<ReadonlyMap<TenantId, number | null>>;
14
18
  readonly usage: (db: TenantDb, tenantId: TenantId) => Promise<number | null>;
15
19
  readonly usageBatch?: (db: TenantDb, tenantIds: readonly TenantId[]) => Promise<Map<TenantId, number | null>>;
16
20
  readonly unit?: CapUnit;
@@ -6,7 +6,7 @@ import { Database, FileText, Gauge, Hash, Mail, Users } from "lucide-react";
6
6
  import { formatCapAmount, formatCapUsedOfLimit } from "./cap-amount-format.js";
7
7
  import { CapUsageBar } from "./cap-usage-bar.js";
8
8
  import { CapOverviewQueries, MY_CAPS_SCREEN_ID } from "./constants.js";
9
- import { isCapNotIncluded } from "./usage-math.js";
9
+ import { isCapNotIncluded, isCapUsedWithoutAllowance } from "./usage-math.js";
10
10
  // caps:usage's wire tone stays "default"/"warn"/"danger" (matches the
11
11
  // server-side thresholds literally); mapped here to the renderer's actual
12
12
  // StatusTone vocabulary instead of inventing new CSS ("danger" has no
@@ -67,7 +67,11 @@ function CapUsageStat({ cap, footer, }) {
67
67
  const notIncluded = isCapNotIncluded(cap.limit);
68
68
  const body = !notIncluded && (!isMeasured(cap) || cap.limit !== null) ? (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(CapUsageSummaryRow, { cap: cap }), _jsx(CapUsageBar, { usage: cap, showLabel: false }), footer] })) : (footer);
69
69
  return (_jsx(StatCard, { icon: Icon !== undefined ? _jsx(Icon, { className: "size-4" }) : undefined, label: t(cap.label), value: notIncluded
70
- ? t("cap-overview.notIncluded")
70
+ ? isCapUsedWithoutAllowance(cap.limit, cap.used)
71
+ ? t("cap-overview.notIncludedButUsed", {
72
+ used: formatCapAmount(cap.used ?? 0, cap.unit, locale),
73
+ })
74
+ : t("cap-overview.notIncluded")
71
75
  : !isMeasured(cap)
72
76
  ? EMPTY_VALUE_PLACEHOLDER
73
77
  : cap.limit === null
@@ -1,12 +1,17 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useLocale, usePrimitives, useTranslation } from "@cosmicdrift/kumiko-renderer";
3
3
  import { formatCapAmount, formatCapUsedOfLimit } from "./cap-amount-format.js";
4
- import { computeTone, isCapNotIncluded } from "./usage-math.js";
4
+ import { computeTone, isCapNotIncluded, isCapUsedWithoutAllowance } from "./usage-math.js";
5
5
  export function CapUsageBar({ usage, showLabel = true, }) {
6
6
  const { Progress, Text, Banner } = usePrimitives();
7
7
  const t = useTranslation();
8
8
  const locale = useLocale().locale();
9
9
  if (isCapNotIncluded(usage.limit)) {
10
+ if (isCapUsedWithoutAllowance(usage.limit, usage.used)) {
11
+ return (_jsx(Text, { variant: "small", testId: "cap-usage-not-included-used", children: t("cap-overview.notIncludedButUsed", {
12
+ used: formatCapAmount(usage.used ?? 0, usage.unit, locale),
13
+ }) }));
14
+ }
10
15
  return (_jsx(Text, { variant: "small", testId: "cap-usage-not-included", children: t("cap-overview.notIncluded") }));
11
16
  }
12
17
  if (usage.used === null) {
@@ -1,5 +1,6 @@
1
1
  import type { CapUsageTone } from "../types.ts";
2
2
  export declare function isCapNotIncluded(limit: number | null): boolean;
3
+ export declare function isCapUsedWithoutAllowance(limit: number | null, used: number | null): boolean;
3
4
  export declare function computeFraction(used: number, limit: number | null): number;
4
5
  export declare function computeUnclampedFraction(used: number, limit: number | null): number;
5
6
  export declare function computeTone(fraction: number): CapUsageTone;
@@ -5,6 +5,10 @@ const DANGER_THRESHOLD = 1;
5
5
  export function isCapNotIncluded(limit) {
6
6
  return limit !== null && limit <= 0;
7
7
  }
8
+ // Leftover data after a downgrade: the tier grants nothing, yet usage is above zero.
9
+ export function isCapUsedWithoutAllowance(limit, used) {
10
+ return isCapNotIncluded(limit) && used !== null && used > 0;
11
+ }
8
12
  function rawFraction(used, limit) {
9
13
  if (limit === null)
10
14
  return 0;
@@ -6,8 +6,8 @@ const MAX_KEYS = 50;
6
6
  export const readStateByKeysQuery = defineQueryHandler({
7
7
  name: "readStateByKeys",
8
8
  schema: z.object({ keys: z.array(z.string().min(1).max(256)).min(1).max(MAX_KEYS) }).strict(),
9
- access: { roles: access.systemAdmin },
10
- description: "Returns when the in-app message sent under each given notify() idempotency key was read (null while unread), within the caller's tenant and without any message content; a SystemAdmin queries the recipient's tenant by acting as a system user of it. Use it to show whether a recipient has seen a notification a feature sent under a known key.",
9
+ access: { roles: access.privileged },
10
+ description: "Returns when the in-app message sent under each given notify() idempotency key was read (null while unread), within the caller's tenant and without any message content; a job's system user reads its own tenant directly, a SystemAdmin queries the recipient's tenant by acting as a system user of it. Use it to show whether a recipient has seen a notification a feature sent under a known key.",
11
11
  handler: async (query, ctx) => {
12
12
  const rows = await selectMany(ctx.db, inAppMessagesTable, { idempotencyKey: { in: query.payload.keys } }, { orderBy: [{ col: "createdAt", direction: "asc" }] });
13
13
  const states = new Map();
@@ -0,0 +1,8 @@
1
+ import type { WhatsappStatusKind } from "./constants.ts";
2
+ /** One stream per (tenant, wamid): a redelivered message lands on the stream that already exists. */
3
+ export declare function whatsappMessageAggregateId(tenantId: string, wamid: string): string;
4
+ /**
5
+ * One stream per (tenant, wamid, status): Meta reports each status of a sent message once.
6
+ * An unrecognised status is keyed by Meta's own word so different new statuses do not collide.
7
+ */
8
+ export declare function whatsappStatusAggregateId(tenantId: string, wamid: string, status: WhatsappStatusKind, rawStatus?: string | null): string;
@@ -0,0 +1,18 @@
1
+ import { v5 as uuidv5 } from "uuid";
2
+ const UNRECOGNISED_STATUS = "other";
3
+ // Fixed namespaces, generated once and immutable: changing one re-keys every existing
4
+ // stream and breaks the dedupe of redelivered webhooks.
5
+ const MESSAGE_NAMESPACE = "3e6a1b94-7d2c-4f58-a0c3-91e4b5d27f08";
6
+ const STATUS_NAMESPACE = "8b0f4d27-61a9-4c3e-b7d5-2a9e0c14f6b3";
7
+ /** One stream per (tenant, wamid): a redelivered message lands on the stream that already exists. */
8
+ export function whatsappMessageAggregateId(tenantId, wamid) {
9
+ return uuidv5(`${tenantId}:${wamid}`, MESSAGE_NAMESPACE);
10
+ }
11
+ /**
12
+ * One stream per (tenant, wamid, status): Meta reports each status of a sent message once.
13
+ * An unrecognised status is keyed by Meta's own word so different new statuses do not collide.
14
+ */
15
+ export function whatsappStatusAggregateId(tenantId, wamid, status, rawStatus = null) {
16
+ const key = status === UNRECOGNISED_STATUS && rawStatus !== null && rawStatus !== "" ? rawStatus : status;
17
+ return uuidv5(`${tenantId}:${wamid}:${key}`, STATUS_NAMESPACE);
18
+ }
@@ -0,0 +1,25 @@
1
+ export declare const CHANNEL_WHATSAPP_FEATURE = "channel-whatsapp";
2
+ export declare const WHATSAPP_SECRET_KEYS: {
3
+ readonly accessToken: "channel-whatsapp:secret:access-token";
4
+ readonly appSecret: "channel-whatsapp:secret:app-secret";
5
+ readonly verifyToken: "channel-whatsapp:secret:verify-token";
6
+ };
7
+ export declare const WhatsappHandlers: {
8
+ readonly receiveMessage: "channel-whatsapp:write:receive-message";
9
+ readonly recordStatus: "channel-whatsapp:write:record-status";
10
+ };
11
+ export declare const WHATSAPP_DEFAULT_API_BASE_URL = "https://graph.facebook.com";
12
+ export declare const WHATSAPP_DEFAULT_API_VERSION = "v21.0";
13
+ export declare const WHATSAPP_DEFAULT_ALLOWED_HOSTS: readonly string[];
14
+ export declare const WHATSAPP_DEFAULT_TIMEOUT_MS = 10000;
15
+ export declare const WHATSAPP_DEFAULT_MEDIA_MAX_BYTES: number;
16
+ export declare const WHATSAPP_DEFAULT_WEBHOOK_PATH = "/api/channel-whatsapp/webhook/:tenantId";
17
+ export declare const WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE = 131047;
18
+ export declare const WHATSAPP_MESSAGE_TYPES: readonly ["text", "audio", "image", "interactive_button", "other"];
19
+ export type WhatsappMessageType = (typeof WHATSAPP_MESSAGE_TYPES)[number];
20
+ export declare const WHATSAPP_STATUS_KINDS: readonly ["sent", "delivered", "read", "failed", "other"];
21
+ export type WhatsappStatusKind = (typeof WHATSAPP_STATUS_KINDS)[number];
22
+ export declare const WHATSAPP_TEXT_MAX_CHARS = 4096;
23
+ export declare const WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS = 256;
24
+ export declare const WHATSAPP_BUTTON_TITLE_MAX_CHARS = 20;
25
+ export declare const WHATSAPP_MAX_REPLY_BUTTONS = 3;