@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
@@ -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;
@@ -0,0 +1,36 @@
1
+ export const CHANNEL_WHATSAPP_FEATURE = "channel-whatsapp";
2
+ export const WHATSAPP_SECRET_KEYS = {
3
+ accessToken: `${CHANNEL_WHATSAPP_FEATURE}:secret:access-token`,
4
+ appSecret: `${CHANNEL_WHATSAPP_FEATURE}:secret:app-secret`,
5
+ verifyToken: `${CHANNEL_WHATSAPP_FEATURE}:secret:verify-token`,
6
+ };
7
+ export const WhatsappHandlers = {
8
+ receiveMessage: `${CHANNEL_WHATSAPP_FEATURE}:write:receive-message`,
9
+ recordStatus: `${CHANNEL_WHATSAPP_FEATURE}:write:record-status`,
10
+ };
11
+ export const WHATSAPP_DEFAULT_API_BASE_URL = "https://graph.facebook.com";
12
+ export const WHATSAPP_DEFAULT_API_VERSION = "v21.0";
13
+ // Meta serves media downloads from lookaside.fbsbx.com, not from the Graph host.
14
+ export const WHATSAPP_DEFAULT_ALLOWED_HOSTS = [
15
+ "graph.facebook.com",
16
+ "lookaside.fbsbx.com",
17
+ ];
18
+ export const WHATSAPP_DEFAULT_TIMEOUT_MS = 10_000;
19
+ export const WHATSAPP_DEFAULT_MEDIA_MAX_BYTES = 25 * 1024 * 1024;
20
+ export const WHATSAPP_DEFAULT_WEBHOOK_PATH = "/api/channel-whatsapp/webhook/:tenantId";
21
+ // Graph error code for a free-form message outside the 24h customer-service window.
22
+ export const WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE = 131047;
23
+ export const WHATSAPP_MESSAGE_TYPES = [
24
+ "text",
25
+ "audio",
26
+ "image",
27
+ "interactive_button",
28
+ "other",
29
+ ];
30
+ export const WHATSAPP_STATUS_KINDS = ["sent", "delivered", "read", "failed", "other"];
31
+ // Meta's documented body limits; the normalizer clips to them so an oversized value
32
+ // never turns into a permanently failing dispatch.
33
+ export const WHATSAPP_TEXT_MAX_CHARS = 4096;
34
+ export const WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS = 256;
35
+ export const WHATSAPP_BUTTON_TITLE_MAX_CHARS = 20;
36
+ export const WHATSAPP_MAX_REPLY_BUTTONS = 3;
@@ -0,0 +1,90 @@
1
+ import * as z from "zod";
2
+ export declare const WHATSAPP_MESSAGE_AGGREGATE_TYPE: "whatsapp-message";
3
+ export declare const WHATSAPP_STATUS_AGGREGATE_TYPE: "whatsapp-status";
4
+ export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT: "message-received";
5
+ export declare const WHATSAPP_STATUS_UPDATED_EVENT_SHORT: "status-updated";
6
+ export declare const WHATSAPP_THROTTLED_EVENT_SHORT: "throttled";
7
+ export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_QN: "channel-whatsapp:event:message-received";
8
+ export declare const WHATSAPP_STATUS_UPDATED_EVENT_QN: "channel-whatsapp:event:status-updated";
9
+ export declare const WHATSAPP_THROTTLED_EVENT_QN: "channel-whatsapp:event:throttled";
10
+ export declare const WAMID_MAX_CHARS = 256;
11
+ export declare const PHONE_NUMBER_ID_MAX_CHARS = 64;
12
+ export declare const MIME_TYPE_MAX_CHARS = 255;
13
+ export declare const RAW_STATUS_MAX_CHARS = 64;
14
+ export declare const receiveMessageInputSchema: z.ZodObject<{
15
+ phoneNumberId: z.ZodString;
16
+ wamid: z.ZodString;
17
+ from: z.ZodString;
18
+ timestampIso: z.ZodString;
19
+ messageType: z.ZodEnum<{
20
+ audio: "audio";
21
+ image: "image";
22
+ interactive_button: "interactive_button";
23
+ other: "other";
24
+ text: "text";
25
+ }>;
26
+ text: z.ZodNullable<z.ZodString>;
27
+ buttonPayload: z.ZodNullable<z.ZodString>;
28
+ contextWamid: z.ZodNullable<z.ZodString>;
29
+ mediaId: z.ZodNullable<z.ZodString>;
30
+ mimeType: z.ZodNullable<z.ZodString>;
31
+ }, z.core.$strip>;
32
+ export type ReceiveMessageInput = z.infer<typeof receiveMessageInputSchema>;
33
+ export declare const recordStatusInputSchema: z.ZodObject<{
34
+ phoneNumberId: z.ZodString;
35
+ wamid: z.ZodString;
36
+ status: z.ZodEnum<{
37
+ delivered: "delivered";
38
+ failed: "failed";
39
+ other: "other";
40
+ read: "read";
41
+ sent: "sent";
42
+ }>;
43
+ rawStatus: z.ZodNullable<z.ZodString>;
44
+ timestampIso: z.ZodString;
45
+ recipient: z.ZodString;
46
+ errorCode: z.ZodNullable<z.ZodNumber>;
47
+ }, z.core.$strip>;
48
+ export type RecordStatusInput = z.infer<typeof recordStatusInputSchema>;
49
+ export declare const messageReceivedPayloadSchema: z.ZodObject<{
50
+ phoneNumberId: z.ZodString;
51
+ wamid: z.ZodString;
52
+ from: z.ZodString;
53
+ timestampIso: z.ZodString;
54
+ messageType: z.ZodEnum<{
55
+ audio: "audio";
56
+ image: "image";
57
+ interactive_button: "interactive_button";
58
+ other: "other";
59
+ text: "text";
60
+ }>;
61
+ text: z.ZodNullable<z.ZodString>;
62
+ buttonPayload: z.ZodNullable<z.ZodString>;
63
+ contextWamid: z.ZodNullable<z.ZodString>;
64
+ mediaId: z.ZodNullable<z.ZodString>;
65
+ mimeType: z.ZodNullable<z.ZodString>;
66
+ }, z.core.$strip>;
67
+ export type MessageReceivedPayload = z.infer<typeof messageReceivedPayloadSchema>;
68
+ export declare const statusUpdatedPayloadSchema: z.ZodObject<{
69
+ phoneNumberId: z.ZodString;
70
+ wamid: z.ZodString;
71
+ status: z.ZodEnum<{
72
+ delivered: "delivered";
73
+ failed: "failed";
74
+ other: "other";
75
+ read: "read";
76
+ sent: "sent";
77
+ }>;
78
+ timestampIso: z.ZodString;
79
+ recipient: z.ZodString;
80
+ errorCode: z.ZodNullable<z.ZodNumber>;
81
+ }, z.core.$strip>;
82
+ export type StatusUpdatedPayload = z.infer<typeof statusUpdatedPayloadSchema>;
83
+ export declare const throttledPayloadSchema: z.ZodObject<{
84
+ phoneNumberId: z.ZodString;
85
+ wamid: z.ZodString;
86
+ from: z.ZodString;
87
+ timestampIso: z.ZodString;
88
+ retryAfterSeconds: z.ZodNumber;
89
+ }, z.core.$strip>;
90
+ export type ThrottledPayload = z.infer<typeof throttledPayloadSchema>;
@@ -0,0 +1,71 @@
1
+ import { piiCiphertextMaxLengthFor } from "@cosmicdrift/kumiko-framework/crypto";
2
+ import * as z from "zod";
3
+ import { CHANNEL_WHATSAPP_FEATURE, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS, WHATSAPP_MESSAGE_TYPES, WHATSAPP_STATUS_KINDS, WHATSAPP_TEXT_MAX_CHARS, } from "./constants.js";
4
+ export const WHATSAPP_MESSAGE_AGGREGATE_TYPE = "whatsapp-message";
5
+ export const WHATSAPP_STATUS_AGGREGATE_TYPE = "whatsapp-status";
6
+ export const WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT = "message-received";
7
+ export const WHATSAPP_STATUS_UPDATED_EVENT_SHORT = "status-updated";
8
+ export const WHATSAPP_THROTTLED_EVENT_SHORT = "throttled";
9
+ export const WHATSAPP_MESSAGE_RECEIVED_EVENT_QN = `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT}`;
10
+ export const WHATSAPP_STATUS_UPDATED_EVENT_QN = `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_STATUS_UPDATED_EVENT_SHORT}`;
11
+ export const WHATSAPP_THROTTLED_EVENT_QN = `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_THROTTLED_EVENT_SHORT}`;
12
+ const E164_MAX_CHARS = 32;
13
+ export const WAMID_MAX_CHARS = 256;
14
+ export const PHONE_NUMBER_ID_MAX_CHARS = 64;
15
+ export const MIME_TYPE_MAX_CHARS = 255;
16
+ export const RAW_STATUS_MAX_CHARS = 64;
17
+ // What the webhook route hands to the write handlers: normalized, still plaintext.
18
+ export const receiveMessageInputSchema = z.object({
19
+ phoneNumberId: z.string().min(1).max(PHONE_NUMBER_ID_MAX_CHARS),
20
+ wamid: z.string().min(1).max(WAMID_MAX_CHARS),
21
+ from: z.string().min(1).max(E164_MAX_CHARS),
22
+ timestampIso: z.string().min(1),
23
+ messageType: z.enum(WHATSAPP_MESSAGE_TYPES),
24
+ text: z.string().max(WHATSAPP_TEXT_MAX_CHARS).nullable(),
25
+ buttonPayload: z.string().max(WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS).nullable(),
26
+ contextWamid: z.string().max(WAMID_MAX_CHARS).nullable(),
27
+ mediaId: z.string().max(WAMID_MAX_CHARS).nullable(),
28
+ mimeType: z.string().max(MIME_TYPE_MAX_CHARS).nullable(),
29
+ });
30
+ export const recordStatusInputSchema = z.object({
31
+ phoneNumberId: z.string().min(1).max(PHONE_NUMBER_ID_MAX_CHARS),
32
+ wamid: z.string().min(1).max(WAMID_MAX_CHARS),
33
+ status: z.enum(WHATSAPP_STATUS_KINDS),
34
+ // Meta's own status word; only keys the stream of an unrecognised status, never stored in the event.
35
+ rawStatus: z.string().max(RAW_STATUS_MAX_CHARS).nullable(),
36
+ timestampIso: z.string().min(1),
37
+ recipient: z.string().min(1).max(E164_MAX_CHARS),
38
+ errorCode: z.number().int().nullable(),
39
+ });
40
+ // Event payloads: sender and recipient numbers, message text and button payloads are
41
+ // PII and stored as tenant-key ciphertext (see pii.ts).
42
+ export const messageReceivedPayloadSchema = z.object({
43
+ phoneNumberId: receiveMessageInputSchema.shape.phoneNumberId,
44
+ wamid: receiveMessageInputSchema.shape.wamid,
45
+ from: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
46
+ timestampIso: z.string().min(1),
47
+ messageType: receiveMessageInputSchema.shape.messageType,
48
+ text: z.string().max(piiCiphertextMaxLengthFor(WHATSAPP_TEXT_MAX_CHARS)).nullable(),
49
+ buttonPayload: z
50
+ .string()
51
+ .max(piiCiphertextMaxLengthFor(WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS))
52
+ .nullable(),
53
+ contextWamid: receiveMessageInputSchema.shape.contextWamid,
54
+ mediaId: receiveMessageInputSchema.shape.mediaId,
55
+ mimeType: receiveMessageInputSchema.shape.mimeType,
56
+ });
57
+ export const statusUpdatedPayloadSchema = z.object({
58
+ phoneNumberId: recordStatusInputSchema.shape.phoneNumberId,
59
+ wamid: recordStatusInputSchema.shape.wamid,
60
+ status: recordStatusInputSchema.shape.status,
61
+ timestampIso: z.string().min(1),
62
+ recipient: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
63
+ errorCode: recordStatusInputSchema.shape.errorCode,
64
+ });
65
+ export const throttledPayloadSchema = z.object({
66
+ phoneNumberId: receiveMessageInputSchema.shape.phoneNumberId,
67
+ wamid: receiveMessageInputSchema.shape.wamid,
68
+ from: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
69
+ timestampIso: z.string().min(1),
70
+ retryAfterSeconds: z.number().int().min(0),
71
+ });
@@ -0,0 +1,3 @@
1
+ import { type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { type ChannelWhatsappOptions } from "./options.ts";
3
+ export declare function createChannelWhatsappFeature(options?: ChannelWhatsappOptions): FeatureDefinition;
@@ -0,0 +1,56 @@
1
+ import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
2
+ import * as z from "zod";
3
+ import { CHANNEL_WHATSAPP_FEATURE } from "./constants.js";
4
+ import { messageReceivedPayloadSchema, statusUpdatedPayloadSchema, throttledPayloadSchema, WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT, WHATSAPP_STATUS_UPDATED_EVENT_SHORT, WHATSAPP_THROTTLED_EVENT_SHORT, } from "./events.js";
5
+ import { createReceiveMessageHandler, createRecordStatusHandler } from "./inbound-handlers.js";
6
+ import { resolveWhatsappOptions } from "./options.js";
7
+ const MAX_SECRET_CHARS = 512;
8
+ const secretValueSchema = z.string().min(1).max(MAX_SECRET_CHARS);
9
+ export function createChannelWhatsappFeature(options = {}) {
10
+ const resolved = resolveWhatsappOptions(options);
11
+ return defineFeature(CHANNEL_WHATSAPP_FEATURE, (r) => {
12
+ r.describe("WhatsApp Business (Meta Cloud API) as a two-way channel, not a delivery channel. Inbound: mount `createWhatsappWebhookRoutes()` via `extraRoutes` (default path `/api/channel-whatsapp/webhook/:tenantId`, the tenant id is part of the URL because the secrets are tenant-scoped); GET answers Meta's `hub.challenge` handshake, POST checks `X-Hub-Signature-256` over the raw body and normalizes each message and status. Events: `channel-whatsapp:event:message-received` (sender, wamid, type text|audio|image|interactive_button|other, text, button payload, `contextWamid`, media id and mime type, `phoneNumberId`), `status-updated` (sent|delivered|read|failed|other) and `throttled` (sender over the per-number limit). Sender number, text, button payload and status recipient are PII, stored as tenant-key ciphertext; read them with `readWhatsappMessagePii`. A redelivered wamid is stored once and answered 200; a failed dispatch answers 500 so Meta redelivers. Outbound: `createWhatsappClient(opts)` gives `sendText`, `sendTemplate`, `sendButtons`, `sendMedia` (each takes the sending `phoneNumberId` and answers `{ ok: true, wamid }` or a typed failure) and `fetchMedia` (media id to bytes and mime type; the URL from the Graph answer is checked against `allowedHosts` before the token is sent). Tenant secrets `channel-whatsapp:secret:access-token`, `app-secret` and `verify-token`. App options of `createChannelWhatsappFeature(opts)`: `apiBaseUrl`, `apiVersion` (default v21.0), `allowedHosts` (default graph.facebook.com and lookaside.fbsbx.com), `requireHttps` (default true; boot fails on a mismatch), `timeoutMs`, `mediaMaxBytes`, `transport` (in-memory Meta for tests), `senderRateLimits` (default 30 per hour and 200 per day per sender and tenant) and `rateLimit` (flood guard of the inbound handlers; cannot be disabled while a sender limit is set). Requires `secrets`. A worker-run job triggered by `message-received` attaches the business process.");
13
+ r.uiHints({
14
+ displayLabel: "WhatsApp Channel",
15
+ category: "notifications",
16
+ recommended: false,
17
+ });
18
+ r.requires({ features: ["secrets"] });
19
+ r.secret("accessToken", {
20
+ label: { en: "WhatsApp access token" },
21
+ hint: {
22
+ en: "System-user access token of the Meta app. Used to send messages and to download media.",
23
+ },
24
+ redact: () => "••••••••",
25
+ scope: "tenant",
26
+ valueSchema: secretValueSchema,
27
+ });
28
+ r.secret("appSecret", {
29
+ label: { en: "WhatsApp app secret" },
30
+ hint: { en: "App secret of the Meta app. Verifies the signature of every incoming webhook." },
31
+ redact: () => "••••••••",
32
+ scope: "tenant",
33
+ valueSchema: secretValueSchema,
34
+ });
35
+ r.secret("verifyToken", {
36
+ label: { en: "WhatsApp verify token" },
37
+ hint: {
38
+ en: "Any string you also enter in the Meta webhook settings; answers Meta's subscription handshake.",
39
+ },
40
+ redact: () => "••••••••",
41
+ scope: "tenant",
42
+ valueSchema: secretValueSchema,
43
+ });
44
+ r.defineEvent(WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT, messageReceivedPayloadSchema, {
45
+ piiFields: "none",
46
+ });
47
+ r.defineEvent(WHATSAPP_STATUS_UPDATED_EVENT_SHORT, statusUpdatedPayloadSchema, {
48
+ piiFields: "none",
49
+ });
50
+ r.defineEvent(WHATSAPP_THROTTLED_EVENT_SHORT, throttledPayloadSchema, {
51
+ piiFields: "none",
52
+ });
53
+ r.writeHandler(createReceiveMessageHandler(resolved));
54
+ r.writeHandler(createRecordStatusHandler(resolved));
55
+ });
56
+ }
@@ -0,0 +1,85 @@
1
+ import type { SecretsContext } from "@cosmicdrift/kumiko-framework/secrets";
2
+ import type { TenantId } from "@cosmicdrift/kumiko-types/identifiers";
3
+ import { type ChannelWhatsappOptions, type ResolvedWhatsappOptions } from "./options.ts";
4
+ export type WhatsappSendFailure = {
5
+ readonly code: "missing_credentials";
6
+ } | {
7
+ readonly code: "invalid_phone_number_id";
8
+ } | {
9
+ readonly code: "invalid_recipient";
10
+ } | {
11
+ readonly code: "invalid_message";
12
+ } | {
13
+ readonly code: "host_not_allowed";
14
+ } | {
15
+ readonly code: "timeout";
16
+ } | {
17
+ readonly code: "unreachable";
18
+ } | {
19
+ readonly code: "invalid_response";
20
+ } | {
21
+ readonly code: "rejected";
22
+ readonly httpStatus: number;
23
+ readonly metaCode: number | null;
24
+ };
25
+ export type WhatsappSendResult = {
26
+ readonly ok: true;
27
+ readonly wamid: string;
28
+ } | ({
29
+ readonly ok: false;
30
+ } & WhatsappSendFailure);
31
+ export type WhatsappMediaFailure = WhatsappSendFailure | {
32
+ readonly code: "invalid_media_id";
33
+ } | {
34
+ readonly code: "redirect_blocked";
35
+ } | {
36
+ readonly code: "too_large";
37
+ };
38
+ export type WhatsappMediaResult = {
39
+ readonly ok: true;
40
+ readonly bytes: Uint8Array;
41
+ readonly mimeType: string;
42
+ } | ({
43
+ readonly ok: false;
44
+ } & WhatsappMediaFailure);
45
+ /** What a send needs from the caller: the tenant and `ctx.services.secrets` of the handler or job. */
46
+ export type WhatsappCallContext = {
47
+ readonly tenantId: TenantId;
48
+ readonly secrets: SecretsContext | undefined;
49
+ };
50
+ type SendBase = {
51
+ readonly phoneNumberId: string;
52
+ readonly to: string;
53
+ readonly replyToWamid?: string;
54
+ };
55
+ export type WhatsappTextInput = SendBase & {
56
+ readonly text: string;
57
+ };
58
+ export type WhatsappTemplateInput = SendBase & {
59
+ readonly templateName: string;
60
+ readonly languageCode: string;
61
+ readonly bodyParameters?: readonly string[];
62
+ };
63
+ export type WhatsappReplyButton = {
64
+ readonly payload: string;
65
+ readonly title: string;
66
+ };
67
+ export type WhatsappButtonsInput = SendBase & {
68
+ readonly text: string;
69
+ readonly buttons: readonly WhatsappReplyButton[];
70
+ };
71
+ export type WhatsappMediaInput = SendBase & {
72
+ readonly kind: "image";
73
+ readonly link: string;
74
+ readonly caption?: string;
75
+ };
76
+ export type WhatsappClient = {
77
+ sendText(ctx: WhatsappCallContext, input: WhatsappTextInput): Promise<WhatsappSendResult>;
78
+ sendTemplate(ctx: WhatsappCallContext, input: WhatsappTemplateInput): Promise<WhatsappSendResult>;
79
+ sendButtons(ctx: WhatsappCallContext, input: WhatsappButtonsInput): Promise<WhatsappSendResult>;
80
+ sendMedia(ctx: WhatsappCallContext, input: WhatsappMediaInput): Promise<WhatsappSendResult>;
81
+ fetchMedia(ctx: WhatsappCallContext, mediaId: string): Promise<WhatsappMediaResult>;
82
+ };
83
+ export declare function createWhatsappClient(options?: ChannelWhatsappOptions): WhatsappClient;
84
+ export declare function buildWhatsappClient(resolved: ResolvedWhatsappOptions): WhatsappClient;
85
+ export {};