@cosmicdrift/kumiko-bundled-features 0.413.1 → 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 +1 -5
  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 +12 -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 +50 -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
@@ -0,0 +1,83 @@
1
+ import type { WhatsappTransport } from "./options.ts";
2
+ export type InMemoryMetaRequest = {
3
+ readonly method: string;
4
+ readonly url: string;
5
+ readonly authorization: string | null;
6
+ };
7
+ export type InMemoryMetaSentMessage = {
8
+ readonly wamid: string;
9
+ readonly phoneNumberId: string;
10
+ readonly authorization: string | null;
11
+ readonly body: Readonly<Record<string, unknown>>;
12
+ };
13
+ export type InMemoryMetaRejection = {
14
+ readonly httpStatus: number;
15
+ readonly metaCode: number;
16
+ };
17
+ export type InMemoryMeta = {
18
+ readonly transport: WhatsappTransport;
19
+ readonly requests: InMemoryMetaRequest[];
20
+ readonly sent: InMemoryMetaSentMessage[];
21
+ seedMedia(mediaId: string, media: {
22
+ bytes: Uint8Array<ArrayBuffer>;
23
+ mimeType: string;
24
+ host?: string;
25
+ }): void;
26
+ rejectNextSend(rejection: InMemoryMetaRejection): void;
27
+ reset(): void;
28
+ };
29
+ export declare function createInMemoryMeta(): InMemoryMeta;
30
+ export type MetaWebhookMessage = Readonly<Record<string, unknown>>;
31
+ export declare function metaTextMessage(input: {
32
+ readonly from: string;
33
+ readonly wamid: string;
34
+ readonly text: string;
35
+ readonly timestamp?: string;
36
+ readonly contextWamid?: string;
37
+ }): MetaWebhookMessage;
38
+ export declare function metaButtonReplyMessage(input: {
39
+ readonly from: string;
40
+ readonly wamid: string;
41
+ readonly payload: string;
42
+ readonly title: string;
43
+ readonly contextWamid: string;
44
+ readonly timestamp?: string;
45
+ }): MetaWebhookMessage;
46
+ export declare function metaMediaMessage(input: {
47
+ readonly from: string;
48
+ readonly wamid: string;
49
+ readonly kind: "audio" | "image";
50
+ readonly mediaId: string;
51
+ readonly mimeType: string;
52
+ readonly timestamp?: string;
53
+ }): MetaWebhookMessage;
54
+ export declare function metaStatus(input: {
55
+ readonly wamid: string;
56
+ readonly status: string;
57
+ readonly recipient: string;
58
+ readonly timestamp?: string;
59
+ readonly errorCode?: number;
60
+ }): Readonly<Record<string, unknown>>;
61
+ export declare function metaWebhookPayload(input: {
62
+ readonly phoneNumberId: string;
63
+ readonly messages?: readonly MetaWebhookMessage[];
64
+ readonly statuses?: readonly Readonly<Record<string, unknown>>[];
65
+ }): Readonly<Record<string, unknown>>;
66
+ export type WebhookTarget = {
67
+ request(input: string, init?: RequestInit): Response | Promise<Response>;
68
+ };
69
+ /** Posts a payload to the mounted webhook route, signed with the app secret as Meta signs it. */
70
+ export declare function deliverMetaWebhook(app: WebhookTarget, input: {
71
+ readonly tenantId: string;
72
+ readonly appSecret: string;
73
+ readonly payload: unknown;
74
+ readonly path?: string;
75
+ readonly signatureHeader?: string | null;
76
+ }): Promise<Response>;
77
+ /** Meta's subscription handshake against the mounted webhook route. */
78
+ export declare function requestMetaVerification(app: WebhookTarget, input: {
79
+ readonly tenantId: string;
80
+ readonly verifyToken: string;
81
+ readonly challenge: string;
82
+ readonly path?: string;
83
+ }): Promise<Response>;
@@ -0,0 +1,181 @@
1
+ // In-memory stand-in for Meta, for tests and local runs: serves the Graph endpoints the client
2
+ // calls, records every request and builds webhooks in Meta's wire format. No network involved.
3
+ import { parseJsonOrThrow } from "@cosmicdrift/kumiko-framework/utils";
4
+ import { WHATSAPP_DEFAULT_WEBHOOK_PATH } from "./constants.js";
5
+ import { signMetaBody } from "./meta-signature.js";
6
+ const MESSAGES_PATH = /^\/v\d+\.\d+\/(\d+)\/messages$/;
7
+ const MEDIA_META_PATH = /^\/v\d+\.\d+\/([A-Za-z0-9_-]+)$/;
8
+ const MEDIA_BLOB_PATH = /^\/media\/([A-Za-z0-9_-]+)$/;
9
+ const DEFAULT_MEDIA_HOST = "lookaside.fbsbx.com";
10
+ function json(body, status = 200) {
11
+ return new Response(JSON.stringify(body), {
12
+ status,
13
+ headers: { "content-type": "application/json" },
14
+ });
15
+ }
16
+ function graphError(status, code) {
17
+ return json({ error: { message: "in-memory meta error", type: "OAuthException", code } }, status);
18
+ }
19
+ export function createInMemoryMeta() {
20
+ const requests = [];
21
+ const sent = [];
22
+ const media = new Map();
23
+ let nextRejection;
24
+ let counter = 0;
25
+ function answerSend(phoneNumberId, authorization, rawBody) {
26
+ if (nextRejection) {
27
+ const { httpStatus, metaCode } = nextRejection;
28
+ nextRejection = undefined;
29
+ return graphError(httpStatus, metaCode);
30
+ }
31
+ counter += 1;
32
+ const wamid = `wamid.INMEMORY${counter}`;
33
+ const body = parseJsonOrThrow(rawBody, "in-memory meta request body");
34
+ sent.push({ wamid, phoneNumberId, authorization, body });
35
+ return json({
36
+ messaging_product: "whatsapp",
37
+ contacts: [{ input: String(body["to"]), wa_id: String(body["to"]) }],
38
+ messages: [{ id: wamid }],
39
+ });
40
+ }
41
+ function answerMediaBlob(mediaId, hostname) {
42
+ const seeded = media.get(mediaId);
43
+ if (!seeded || seeded.host !== hostname)
44
+ return graphError(404, 100);
45
+ return new Response(seeded.bytes, { headers: { "content-type": seeded.mimeType } });
46
+ }
47
+ function answerMediaMetadata(mediaId) {
48
+ const seeded = media.get(mediaId);
49
+ if (!seeded)
50
+ return graphError(404, 100);
51
+ return json({
52
+ id: mediaId,
53
+ url: `https://${seeded.host}/media/${mediaId}`,
54
+ mime_type: seeded.mimeType,
55
+ file_size: seeded.bytes.byteLength,
56
+ });
57
+ }
58
+ const transport = async (rawUrl, init) => {
59
+ const url = new URL(rawUrl);
60
+ const authorization = new Headers(init.headers).get("authorization");
61
+ requests.push({ method: init.method ?? "GET", url: rawUrl, authorization });
62
+ const sendMatch = MESSAGES_PATH.exec(url.pathname);
63
+ if (init.method === "POST" && sendMatch) {
64
+ return answerSend(sendMatch[1] ?? "", authorization, String(init.body));
65
+ }
66
+ const blobMatch = MEDIA_BLOB_PATH.exec(url.pathname);
67
+ if (init.method === "GET" && blobMatch)
68
+ return answerMediaBlob(blobMatch[1] ?? "", url.hostname);
69
+ const metaMatch = MEDIA_META_PATH.exec(url.pathname);
70
+ if (init.method === "GET" && metaMatch)
71
+ return answerMediaMetadata(metaMatch[1] ?? "");
72
+ return graphError(404, 100);
73
+ };
74
+ return {
75
+ transport,
76
+ requests,
77
+ sent,
78
+ seedMedia(mediaId, seeded) {
79
+ media.set(mediaId, { host: DEFAULT_MEDIA_HOST, ...seeded });
80
+ },
81
+ rejectNextSend(rejection) {
82
+ nextRejection = rejection;
83
+ },
84
+ reset() {
85
+ requests.length = 0;
86
+ sent.length = 0;
87
+ media.clear();
88
+ nextRejection = undefined;
89
+ counter = 0;
90
+ },
91
+ };
92
+ }
93
+ export function metaTextMessage(input) {
94
+ return {
95
+ from: input.from,
96
+ id: input.wamid,
97
+ timestamp: input.timestamp ?? "1762300800",
98
+ type: "text",
99
+ text: { body: input.text },
100
+ ...(input.contextWamid !== undefined && {
101
+ context: { from: "491700000000", id: input.contextWamid },
102
+ }),
103
+ };
104
+ }
105
+ export function metaButtonReplyMessage(input) {
106
+ return {
107
+ from: input.from,
108
+ id: input.wamid,
109
+ timestamp: input.timestamp ?? "1762300800",
110
+ type: "interactive",
111
+ context: { from: "491700000000", id: input.contextWamid },
112
+ interactive: { type: "button_reply", button_reply: { id: input.payload, title: input.title } },
113
+ };
114
+ }
115
+ export function metaMediaMessage(input) {
116
+ return {
117
+ from: input.from,
118
+ id: input.wamid,
119
+ timestamp: input.timestamp ?? "1762300800",
120
+ type: input.kind,
121
+ [input.kind]: { id: input.mediaId, mime_type: input.mimeType },
122
+ };
123
+ }
124
+ export function metaStatus(input) {
125
+ return {
126
+ id: input.wamid,
127
+ status: input.status,
128
+ timestamp: input.timestamp ?? "1762300800",
129
+ recipient_id: input.recipient,
130
+ ...(input.errorCode !== undefined && { errors: [{ code: input.errorCode, title: "failed" }] }),
131
+ };
132
+ }
133
+ export function metaWebhookPayload(input) {
134
+ return {
135
+ object: "whatsapp_business_account",
136
+ entry: [
137
+ {
138
+ id: "100000000000001",
139
+ changes: [
140
+ {
141
+ field: "messages",
142
+ value: {
143
+ messaging_product: "whatsapp",
144
+ metadata: {
145
+ display_phone_number: "491700000000",
146
+ phone_number_id: input.phoneNumberId,
147
+ },
148
+ ...(input.messages && { messages: input.messages }),
149
+ ...(input.statuses && { statuses: input.statuses }),
150
+ },
151
+ },
152
+ ],
153
+ },
154
+ ],
155
+ };
156
+ }
157
+ /** Posts a payload to the mounted webhook route, signed with the app secret as Meta signs it. */
158
+ export function deliverMetaWebhook(app, input) {
159
+ const rawBody = JSON.stringify(input.payload);
160
+ const signature = input.signatureHeader === undefined
161
+ ? signMetaBody(input.appSecret, rawBody)
162
+ : input.signatureHeader;
163
+ return Promise.resolve(app.request((input.path ?? WHATSAPP_DEFAULT_WEBHOOK_PATH).replace(":tenantId", input.tenantId), {
164
+ method: "POST",
165
+ body: rawBody,
166
+ headers: {
167
+ "content-type": "application/json",
168
+ ...(signature !== null && { "x-hub-signature-256": signature }),
169
+ },
170
+ }));
171
+ }
172
+ /** Meta's subscription handshake against the mounted webhook route. */
173
+ export function requestMetaVerification(app, input) {
174
+ const query = new URLSearchParams({
175
+ "hub.mode": "subscribe",
176
+ "hub.verify_token": input.verifyToken,
177
+ "hub.challenge": input.challenge,
178
+ });
179
+ const path = (input.path ?? WHATSAPP_DEFAULT_WEBHOOK_PATH).replace(":tenantId", input.tenantId);
180
+ return Promise.resolve(app.request(`${path}?${query.toString()}`));
181
+ }
@@ -0,0 +1,39 @@
1
+ import type { ResolvedWhatsappOptions } from "./options.ts";
2
+ export type InboundOutcome = "stored" | "duplicate" | "throttled";
3
+ export declare function createReceiveMessageHandler(options: ResolvedWhatsappOptions): import("@cosmicdrift/kumiko-types/define-handler").WriteHandlerDefinition<"receive-message", import("zod").ZodObject<{
4
+ phoneNumberId: import("zod").ZodString;
5
+ wamid: import("zod").ZodString;
6
+ from: import("zod").ZodString;
7
+ timestampIso: import("zod").ZodString;
8
+ messageType: import("zod").ZodEnum<{
9
+ audio: "audio";
10
+ image: "image";
11
+ interactive_button: "interactive_button";
12
+ other: "other";
13
+ text: "text";
14
+ }>;
15
+ text: import("zod").ZodNullable<import("zod").ZodString>;
16
+ buttonPayload: import("zod").ZodNullable<import("zod").ZodString>;
17
+ contextWamid: import("zod").ZodNullable<import("zod").ZodString>;
18
+ mediaId: import("zod").ZodNullable<import("zod").ZodString>;
19
+ mimeType: import("zod").ZodNullable<import("zod").ZodString>;
20
+ }, import("zod/v4/core").$strip>, {
21
+ readonly outcome: InboundOutcome;
22
+ }, import("@cosmicdrift/kumiko-types/event-type-map").KumikoEventTypeMap, undefined, undefined>;
23
+ export declare function createRecordStatusHandler(options: ResolvedWhatsappOptions): import("@cosmicdrift/kumiko-types/define-handler").WriteHandlerDefinition<"record-status", import("zod").ZodObject<{
24
+ phoneNumberId: import("zod").ZodString;
25
+ wamid: import("zod").ZodString;
26
+ status: import("zod").ZodEnum<{
27
+ delivered: "delivered";
28
+ failed: "failed";
29
+ other: "other";
30
+ read: "read";
31
+ sent: "sent";
32
+ }>;
33
+ rawStatus: import("zod").ZodNullable<import("zod").ZodString>;
34
+ timestampIso: import("zod").ZodString;
35
+ recipient: import("zod").ZodString;
36
+ errorCode: import("zod").ZodNullable<import("zod").ZodNumber>;
37
+ }, import("zod/v4/core").$strip>, {
38
+ readonly outcome: InboundOutcome;
39
+ }, import("@cosmicdrift/kumiko-types/event-type-map").KumikoEventTypeMap, undefined, undefined>;
@@ -0,0 +1,127 @@
1
+ import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { InternalError, RateLimitError } from "@cosmicdrift/kumiko-framework/errors";
3
+ import { whatsappMessageAggregateId, whatsappStatusAggregateId } from "./aggregate-id.js";
4
+ import { receiveMessageInputSchema, recordStatusInputSchema, WHATSAPP_MESSAGE_AGGREGATE_TYPE, WHATSAPP_MESSAGE_RECEIVED_EVENT_QN, WHATSAPP_STATUS_AGGREGATE_TYPE, WHATSAPP_STATUS_UPDATED_EVENT_QN, WHATSAPP_THROTTLED_EVENT_QN, } from "./events.js";
5
+ import { encryptWhatsappPii, WhatsappPiiFields } from "./pii.js";
6
+ const OUTCOME_STORED = { isSuccess: true, data: { outcome: "stored" } };
7
+ const OUTCOME_DUPLICATE = { isSuccess: true, data: { outcome: "duplicate" } };
8
+ const OUTCOME_THROTTLED = { isSuccess: true, data: { outcome: "throttled" } };
9
+ // Counts one message against every per-sender window. Only a RateLimitError means "throttled";
10
+ // anything else (Redis down, bad config) propagates so the webhook answers 5xx and Meta redelivers.
11
+ async function chargeSender(ctx, options, tenantId, from) {
12
+ if (options.senderRateLimits.length === 0)
13
+ return null;
14
+ const { rateLimit } = ctx.services;
15
+ const digest = ctx.rateLimitDigest;
16
+ if (!rateLimit || !digest) {
17
+ throw new InternalError({
18
+ message: "channel-whatsapp: the per-sender limit needs a rate limiter and a digest key",
19
+ });
20
+ }
21
+ const senderKey = `whatsapp-inbound:${tenantId}:${digest(from)}`;
22
+ try {
23
+ await rateLimit.enforceAll(options.senderRateLimits.map(({ limit, windowSeconds }) => ({
24
+ bucket: `${senderKey}:${windowSeconds}s`,
25
+ config: { limit, windowSeconds },
26
+ })));
27
+ return null;
28
+ }
29
+ catch (error) {
30
+ if (error instanceof RateLimitError)
31
+ return error;
32
+ throw error;
33
+ }
34
+ }
35
+ export function createReceiveMessageHandler(options) {
36
+ return defineWriteHandler({
37
+ name: "receive-message",
38
+ schema: receiveMessageInputSchema,
39
+ access: { roles: ["SystemAdmin"] },
40
+ rateLimit: options.rateLimit,
41
+ agent: { expose: false },
42
+ description: "Stores one inbound WhatsApp message verified by the webhook route as a message-received event; a redelivered wamid is a duplicate, a sender over its limit becomes a throttled event.",
43
+ handler: async (event, ctx) => {
44
+ const input = event.payload;
45
+ const tenantId = event.user.tenantId;
46
+ const aggregateId = whatsappMessageAggregateId(tenantId, input.wamid);
47
+ // Dedupe before the limit: Meta's redeliveries must not use up the sender's budget.
48
+ if ((await ctx.events.load(aggregateId)).length > 0)
49
+ return OUTCOME_DUPLICATE;
50
+ const throttle = await chargeSender(ctx, options, tenantId, input.from);
51
+ const requestId = `channel-whatsapp:receive-message:${aggregateId}`;
52
+ const from = await encryptWhatsappPii(tenantId, throttle ? WhatsappPiiFields.throttledFrom : WhatsappPiiFields.receivedFrom, input.from, requestId);
53
+ if (throttle) {
54
+ const payload = {
55
+ phoneNumberId: input.phoneNumberId,
56
+ wamid: input.wamid,
57
+ from,
58
+ timestampIso: input.timestampIso,
59
+ retryAfterSeconds: throttle.details.retryAfterSeconds,
60
+ };
61
+ const appended = await ctx.events.tryAppend({
62
+ aggregateId,
63
+ aggregateType: WHATSAPP_MESSAGE_AGGREGATE_TYPE,
64
+ type: WHATSAPP_THROTTLED_EVENT_QN,
65
+ payload,
66
+ });
67
+ return appended.ok ? OUTCOME_THROTTLED : OUTCOME_DUPLICATE;
68
+ }
69
+ const payload = {
70
+ phoneNumberId: input.phoneNumberId,
71
+ wamid: input.wamid,
72
+ from,
73
+ timestampIso: input.timestampIso,
74
+ messageType: input.messageType,
75
+ text: input.text === null
76
+ ? null
77
+ : await encryptWhatsappPii(tenantId, WhatsappPiiFields.receivedText, input.text, requestId),
78
+ buttonPayload: input.buttonPayload === null
79
+ ? null
80
+ : await encryptWhatsappPii(tenantId, WhatsappPiiFields.receivedButtonPayload, input.buttonPayload, requestId),
81
+ contextWamid: input.contextWamid,
82
+ mediaId: input.mediaId,
83
+ mimeType: input.mimeType,
84
+ };
85
+ // A concurrent delivery of the same wamid that won the race counts as a duplicate.
86
+ const appended = await ctx.events.tryAppend({
87
+ aggregateId,
88
+ aggregateType: WHATSAPP_MESSAGE_AGGREGATE_TYPE,
89
+ type: WHATSAPP_MESSAGE_RECEIVED_EVENT_QN,
90
+ payload,
91
+ });
92
+ return appended.ok ? OUTCOME_STORED : OUTCOME_DUPLICATE;
93
+ },
94
+ });
95
+ }
96
+ export function createRecordStatusHandler(options) {
97
+ return defineWriteHandler({
98
+ name: "record-status",
99
+ schema: recordStatusInputSchema,
100
+ access: { roles: ["SystemAdmin"] },
101
+ rateLimit: options.rateLimit,
102
+ agent: { expose: false },
103
+ description: "Stores one delivery status (sent, delivered, read, failed) of an outbound WhatsApp message as a status-updated event; a repeated status of the same wamid is a duplicate.",
104
+ handler: async (event, ctx) => {
105
+ const input = event.payload;
106
+ const tenantId = event.user.tenantId;
107
+ const aggregateId = whatsappStatusAggregateId(tenantId, input.wamid, input.status, input.rawStatus);
108
+ if ((await ctx.events.load(aggregateId)).length > 0)
109
+ return OUTCOME_DUPLICATE;
110
+ const payload = {
111
+ phoneNumberId: input.phoneNumberId,
112
+ wamid: input.wamid,
113
+ status: input.status,
114
+ timestampIso: input.timestampIso,
115
+ recipient: await encryptWhatsappPii(tenantId, WhatsappPiiFields.statusRecipient, input.recipient, `channel-whatsapp:record-status:${aggregateId}`),
116
+ errorCode: input.errorCode,
117
+ };
118
+ const appended = await ctx.events.tryAppend({
119
+ aggregateId,
120
+ aggregateType: WHATSAPP_STATUS_AGGREGATE_TYPE,
121
+ type: WHATSAPP_STATUS_UPDATED_EVENT_QN,
122
+ payload,
123
+ });
124
+ return appended.ok ? OUTCOME_STORED : OUTCOME_DUPLICATE;
125
+ },
126
+ });
127
+ }
@@ -0,0 +1,10 @@
1
+ export { whatsappMessageAggregateId, whatsappStatusAggregateId } from "./aggregate-id.ts";
2
+ export { CHANNEL_WHATSAPP_FEATURE, WHATSAPP_DEFAULT_ALLOWED_HOSTS, WHATSAPP_DEFAULT_API_BASE_URL, WHATSAPP_DEFAULT_WEBHOOK_PATH, WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE, WHATSAPP_SECRET_KEYS, type WhatsappMessageType, type WhatsappStatusKind, } from "./constants.ts";
3
+ export { type MessageReceivedPayload, type StatusUpdatedPayload, type ThrottledPayload, WHATSAPP_MESSAGE_RECEIVED_EVENT_QN, WHATSAPP_STATUS_UPDATED_EVENT_QN, WHATSAPP_THROTTLED_EVENT_QN, } from "./events.ts";
4
+ export { createChannelWhatsappFeature } from "./feature.ts";
5
+ export { buildWhatsappClient, createWhatsappClient, type WhatsappButtonsInput, type WhatsappCallContext, type WhatsappClient, type WhatsappMediaFailure, type WhatsappMediaInput, type WhatsappMediaResult, type WhatsappReplyButton, type WhatsappSendFailure, type WhatsappSendResult, type WhatsappTemplateInput, type WhatsappTextInput, } from "./graph-client.ts";
6
+ export { createInMemoryMeta, deliverMetaWebhook, type InMemoryMeta, type InMemoryMetaRejection, type InMemoryMetaRequest, type InMemoryMetaSentMessage, metaButtonReplyMessage, metaMediaMessage, metaStatus, metaTextMessage, metaWebhookPayload, requestMetaVerification, } from "./in-memory-meta.ts";
7
+ export { signMetaBody } from "./meta-signature.ts";
8
+ export { type ChannelWhatsappOptions, DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT, DEFAULT_WHATSAPP_SENDER_RATE_LIMITS, type WhatsappSenderRateLimit, type WhatsappTransport, } from "./options.ts";
9
+ export { type DecryptedWhatsappMessage, type DecryptedWhatsappStatus, type DecryptedWhatsappThrottled, readWhatsappMessagePii, readWhatsappStatusPii, readWhatsappThrottledPii, } from "./pii.ts";
10
+ export { createWhatsappWebhookRoutes, type WhatsappWebhookRouteOptions } from "./webhook-routes.ts";
@@ -0,0 +1,10 @@
1
+ export { whatsappMessageAggregateId, whatsappStatusAggregateId } from "./aggregate-id.js";
2
+ export { CHANNEL_WHATSAPP_FEATURE, WHATSAPP_DEFAULT_ALLOWED_HOSTS, WHATSAPP_DEFAULT_API_BASE_URL, WHATSAPP_DEFAULT_WEBHOOK_PATH, WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE, WHATSAPP_SECRET_KEYS, } from "./constants.js";
3
+ export { WHATSAPP_MESSAGE_RECEIVED_EVENT_QN, WHATSAPP_STATUS_UPDATED_EVENT_QN, WHATSAPP_THROTTLED_EVENT_QN, } from "./events.js";
4
+ export { createChannelWhatsappFeature } from "./feature.js";
5
+ export { buildWhatsappClient, createWhatsappClient, } from "./graph-client.js";
6
+ export { createInMemoryMeta, deliverMetaWebhook, metaButtonReplyMessage, metaMediaMessage, metaStatus, metaTextMessage, metaWebhookPayload, requestMetaVerification, } from "./in-memory-meta.js";
7
+ export { signMetaBody } from "./meta-signature.js";
8
+ export { DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT, DEFAULT_WHATSAPP_SENDER_RATE_LIMITS, } from "./options.js";
9
+ export { readWhatsappMessagePii, readWhatsappStatusPii, readWhatsappThrottledPii, } from "./pii.js";
10
+ export { createWhatsappWebhookRoutes } from "./webhook-routes.js";
@@ -0,0 +1,5 @@
1
+ /** Meta's `X-Hub-Signature-256` value for a raw body: `sha256=<hex HMAC with the app secret>`. */
2
+ export declare function signMetaBody(appSecret: string, rawBody: string): string;
3
+ export declare function isValidMetaSignature(appSecret: string, rawBody: string, header: string | undefined): boolean;
4
+ /** Hashing first gives both sides one length, so the comparison leaks nothing about the secret's length. */
5
+ export declare function secretsMatch(candidate: string, secret: string): boolean;
@@ -0,0 +1,19 @@
1
+ import { createHash, createHmac, timingSafeEqual } from "node:crypto";
2
+ const SIGNATURE_HEADER_PATTERN = /^sha256=([0-9a-f]{64})$/i;
3
+ /** Meta's `X-Hub-Signature-256` value for a raw body: `sha256=<hex HMAC with the app secret>`. */
4
+ export function signMetaBody(appSecret, rawBody) {
5
+ return `sha256=${createHmac("sha256", appSecret).update(rawBody, "utf8").digest("hex")}`;
6
+ }
7
+ export function isValidMetaSignature(appSecret, rawBody, header) {
8
+ const match = header === undefined ? null : SIGNATURE_HEADER_PATTERN.exec(header.trim());
9
+ if (match === null)
10
+ return false;
11
+ const received = Buffer.from((match[1] ?? "").toLowerCase(), "hex");
12
+ const expected = createHmac("sha256", appSecret).update(rawBody, "utf8").digest();
13
+ return received.length === expected.length && timingSafeEqual(received, expected);
14
+ }
15
+ /** Hashing first gives both sides one length, so the comparison leaks nothing about the secret's length. */
16
+ export function secretsMatch(candidate, secret) {
17
+ const digestOf = (value) => createHash("sha256").update(value, "utf8").digest();
18
+ return timingSafeEqual(digestOf(candidate), digestOf(secret));
19
+ }
@@ -0,0 +1,32 @@
1
+ import { type RateLimitDeclaration } from "@cosmicdrift/kumiko-types/handlers";
2
+ export type WhatsappTransport = (url: string, init: RequestInit) => Promise<Response>;
3
+ /** Limit on messages per sender number, counted inside the inbound write handler. */
4
+ export type WhatsappSenderRateLimit = {
5
+ readonly limit: number;
6
+ readonly windowSeconds: number;
7
+ };
8
+ export type ChannelWhatsappOptions = {
9
+ readonly apiBaseUrl?: string;
10
+ readonly apiVersion?: string;
11
+ readonly allowedHosts?: readonly string[];
12
+ readonly requireHttps?: boolean;
13
+ readonly timeoutMs?: number;
14
+ readonly mediaMaxBytes?: number;
15
+ readonly transport?: WhatsappTransport;
16
+ readonly senderRateLimits?: readonly WhatsappSenderRateLimit[];
17
+ readonly rateLimit?: RateLimitDeclaration;
18
+ };
19
+ export type ResolvedWhatsappOptions = {
20
+ readonly apiBaseUrl: string;
21
+ readonly apiVersion: string;
22
+ readonly allowedHosts: readonly string[];
23
+ readonly requireHttps: boolean;
24
+ readonly timeoutMs: number;
25
+ readonly mediaMaxBytes: number;
26
+ readonly transport: WhatsappTransport | undefined;
27
+ readonly senderRateLimits: readonly WhatsappSenderRateLimit[];
28
+ readonly rateLimit: RateLimitDeclaration;
29
+ };
30
+ export declare const DEFAULT_WHATSAPP_SENDER_RATE_LIMITS: readonly WhatsappSenderRateLimit[];
31
+ export declare const DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT: RateLimitDeclaration;
32
+ export declare function resolveWhatsappOptions(options: ChannelWhatsappOptions): ResolvedWhatsappOptions;
@@ -0,0 +1,83 @@
1
+ import { isRateLimitDisabled } from "@cosmicdrift/kumiko-types/handlers";
2
+ import { checkChatWebhookTarget } from "../delivery/index.js";
3
+ import { WHATSAPP_DEFAULT_ALLOWED_HOSTS, WHATSAPP_DEFAULT_API_BASE_URL, WHATSAPP_DEFAULT_API_VERSION, WHATSAPP_DEFAULT_MEDIA_MAX_BYTES, WHATSAPP_DEFAULT_TIMEOUT_MS, } from "./constants.js";
4
+ export const DEFAULT_WHATSAPP_SENDER_RATE_LIMITS = [
5
+ { limit: 30, windowSeconds: 60 * 60 },
6
+ { limit: 200, windowSeconds: 24 * 60 * 60 },
7
+ ];
8
+ export const DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT = {
9
+ per: "tenant+handler",
10
+ limit: 12_000,
11
+ windowSeconds: 60,
12
+ };
13
+ const API_VERSION_PATTERN = /^v\d+\.\d+$/;
14
+ function isPositiveInteger(value) {
15
+ return Number.isInteger(value) && value > 0;
16
+ }
17
+ // Fail at boot: a misconfigured base URL must not surface as per-send failures.
18
+ function assertApiBaseUrl(apiBaseUrl, allowedHosts, requireHttps) {
19
+ let parsedBase;
20
+ try {
21
+ parsedBase = new URL(apiBaseUrl);
22
+ }
23
+ catch {
24
+ throw new Error("channel-whatsapp: apiBaseUrl is not a valid URL");
25
+ }
26
+ // The same check the sends run at runtime, so boot and runtime cannot disagree.
27
+ if (checkChatWebhookTarget({ allowedHosts, requireHttps }, apiBaseUrl) !== undefined)
28
+ return;
29
+ if (requireHttps && parsedBase.protocol !== "https:") {
30
+ throw new Error("channel-whatsapp: apiBaseUrl must use https (set requireHttps: false to opt out)");
31
+ }
32
+ if (requireHttps && parsedBase.port !== "") {
33
+ throw new Error("channel-whatsapp: apiBaseUrl must not carry a port while requireHttps is set");
34
+ }
35
+ if (parsedBase.username !== "" || parsedBase.password !== "") {
36
+ throw new Error("channel-whatsapp: apiBaseUrl must not carry credentials");
37
+ }
38
+ throw new Error(`channel-whatsapp: apiBaseUrl host "${parsedBase.hostname}" is not in allowedHosts`);
39
+ }
40
+ function assertRateLimits(senderRateLimits, rateLimit) {
41
+ for (const { limit, windowSeconds } of senderRateLimits) {
42
+ if (!isPositiveInteger(limit) || !isPositiveInteger(windowSeconds)) {
43
+ throw new Error("channel-whatsapp: senderRateLimits entries need a positive integer limit and windowSeconds");
44
+ }
45
+ }
46
+ // A disabled flood guard would leave the handler without a declared limit and the
47
+ // per-sender counting without the resolver the declaration makes the engine build.
48
+ if (isRateLimitDisabled(rateLimit) && senderRateLimits.length > 0) {
49
+ throw new Error("channel-whatsapp: rateLimit cannot be disabled while senderRateLimits is set (pass senderRateLimits: [] to switch both off)");
50
+ }
51
+ }
52
+ export function resolveWhatsappOptions(options) {
53
+ const apiBaseUrl = (options.apiBaseUrl ?? WHATSAPP_DEFAULT_API_BASE_URL).replace(/\/+$/, "");
54
+ const apiVersion = options.apiVersion ?? WHATSAPP_DEFAULT_API_VERSION;
55
+ const allowedHosts = options.allowedHosts ?? WHATSAPP_DEFAULT_ALLOWED_HOSTS;
56
+ const requireHttps = options.requireHttps ?? true;
57
+ const senderRateLimits = options.senderRateLimits ?? DEFAULT_WHATSAPP_SENDER_RATE_LIMITS;
58
+ const rateLimit = options.rateLimit ?? DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT;
59
+ assertApiBaseUrl(apiBaseUrl, allowedHosts, requireHttps);
60
+ if (!API_VERSION_PATTERN.test(apiVersion)) {
61
+ throw new Error('channel-whatsapp: apiVersion must look like "v21.0"');
62
+ }
63
+ assertRateLimits(senderRateLimits, rateLimit);
64
+ const timeoutMs = options.timeoutMs ?? WHATSAPP_DEFAULT_TIMEOUT_MS;
65
+ const mediaMaxBytes = options.mediaMaxBytes ?? WHATSAPP_DEFAULT_MEDIA_MAX_BYTES;
66
+ if (!isPositiveInteger(timeoutMs)) {
67
+ throw new Error("channel-whatsapp: timeoutMs must be a positive integer");
68
+ }
69
+ if (!isPositiveInteger(mediaMaxBytes)) {
70
+ throw new Error("channel-whatsapp: mediaMaxBytes must be a positive integer");
71
+ }
72
+ return {
73
+ apiBaseUrl,
74
+ apiVersion,
75
+ allowedHosts,
76
+ requireHttps,
77
+ timeoutMs,
78
+ mediaMaxBytes,
79
+ transport: options.transport,
80
+ senderRateLimits,
81
+ rateLimit,
82
+ };
83
+ }
@@ -0,0 +1,32 @@
1
+ import type { TenantId } from "@cosmicdrift/kumiko-types/identifiers";
2
+ export declare const WhatsappPiiFields: {
3
+ readonly receivedFrom: "channel-whatsapp.message-received.from";
4
+ readonly receivedText: "channel-whatsapp.message-received.text";
5
+ readonly receivedButtonPayload: "channel-whatsapp.message-received.buttonPayload";
6
+ readonly statusRecipient: "channel-whatsapp.status-updated.recipient";
7
+ readonly throttledFrom: "channel-whatsapp.throttled.from";
8
+ };
9
+ export type WhatsappPiiField = (typeof WhatsappPiiFields)[keyof typeof WhatsappPiiFields];
10
+ /** Without a configured PII KMS the value passes through, like every other event-sourced inbound path. */
11
+ export declare function encryptWhatsappPii(tenantId: TenantId, field: WhatsappPiiField, value: string, requestId: string): Promise<string>;
12
+ export declare function decryptWhatsappPii(tenantId: TenantId, field: WhatsappPiiField, value: string): Promise<string>;
13
+ export type DecryptedWhatsappMessage = {
14
+ readonly from: string;
15
+ readonly text: string | null;
16
+ readonly buttonPayload: string | null;
17
+ };
18
+ export type DecryptedWhatsappStatus = {
19
+ readonly recipient: string;
20
+ };
21
+ export type DecryptedWhatsappThrottled = {
22
+ readonly from: string;
23
+ };
24
+ /** Plaintext recipient of a `status-updated` event payload. */
25
+ export declare function readWhatsappStatusPii(tenantId: TenantId, payload: unknown): Promise<DecryptedWhatsappStatus>;
26
+ /** Plaintext sender of a `throttled` event payload. */
27
+ export declare function readWhatsappThrottledPii(tenantId: TenantId, payload: unknown): Promise<DecryptedWhatsappThrottled>;
28
+ /**
29
+ * Plaintext of the PII fields of a `message-received` event payload, for the consumer.
30
+ * A tenant that was destroyed yields the erased sentinel instead of the value.
31
+ */
32
+ export declare function readWhatsappMessagePii(tenantId: TenantId, payload: unknown): Promise<DecryptedWhatsappMessage>;