@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
@@ -0,0 +1,272 @@
1
+ import { BlockedHostError, egress } from "@cosmicdrift/kumiko-framework/http";
2
+ import { SYSTEM_USER_ID } from "@cosmicdrift/kumiko-types/identifiers";
3
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
4
+ import { checkChatWebhookTarget } from "../delivery/index.js";
5
+ import { WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS, WHATSAPP_BUTTON_TITLE_MAX_CHARS, WHATSAPP_MAX_REPLY_BUTTONS, WHATSAPP_SECRET_KEYS, WHATSAPP_TEXT_MAX_CHARS, } from "./constants.js";
6
+ import { resolveWhatsappOptions, } from "./options.js";
7
+ const PHONE_NUMBER_ID_PATTERN = /^\d{1,32}$/;
8
+ const RECIPIENT_PATTERN = /^\+?\d{5,20}$/;
9
+ const MEDIA_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
10
+ const TEMPLATE_NAME_PATTERN = /^[a-z0-9_]{1,512}$/;
11
+ const LANGUAGE_CODE_PATTERN = /^[a-z]{2,3}(_[A-Za-z]{2,4})?$/;
12
+ const SECRET_AUDIT_HANDLER = "channel-whatsapp:graph-client";
13
+ // Only an absent or empty secret is missing_credentials; a failing secret store is a transient fault.
14
+ async function readAccessToken(ctx) {
15
+ try {
16
+ const revealed = await ctx.secrets?.get(ctx.tenantId, WHATSAPP_SECRET_KEYS.accessToken, {
17
+ userId: SYSTEM_USER_ID,
18
+ handlerName: SECRET_AUDIT_HANDLER,
19
+ });
20
+ const token = revealed?.reveal();
21
+ return token === undefined || token === ""
22
+ ? { ok: false, code: "missing_credentials" }
23
+ : { ok: true, token };
24
+ }
25
+ catch {
26
+ return { ok: false, code: "unreachable" };
27
+ }
28
+ }
29
+ // The link is fetched by Meta, not by us, so no allowlist applies; it must still be a plain URL.
30
+ function isPublicMediaLink(link, requireHttps) {
31
+ try {
32
+ const parsed = new URL(link);
33
+ const protocolAllowed = parsed.protocol === "https:" || (!requireHttps && parsed.protocol === "http:");
34
+ return protocolAllowed && parsed.username === "" && parsed.password === "";
35
+ }
36
+ catch {
37
+ return false;
38
+ }
39
+ }
40
+ function isTimeout(err) {
41
+ return err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError");
42
+ }
43
+ function classifyTransportError(err) {
44
+ if (err instanceof BlockedHostError)
45
+ return { code: "host_not_allowed" };
46
+ return { code: isTimeout(err) ? "timeout" : "unreachable" };
47
+ }
48
+ export function createWhatsappClient(options = {}) {
49
+ return buildWhatsappClient(resolveWhatsappOptions(options));
50
+ }
51
+ export function buildWhatsappClient(resolved) {
52
+ const target = {
53
+ allowedHosts: resolved.allowedHosts,
54
+ requireHttps: resolved.requireHttps,
55
+ };
56
+ // The host and https check runs before any transport, so a swapped transport cannot
57
+ // route the bearer token to a host outside the allowlist.
58
+ async function callGraph(url, token, init) {
59
+ const checked = checkChatWebhookTarget(target, url);
60
+ if (!checked)
61
+ return { ok: false, code: "host_not_allowed" };
62
+ try {
63
+ const send = resolved.transport ??
64
+ egress(resolved.requireHttps
65
+ ? { kind: "external" }
66
+ : { kind: "internal", allowOrigins: [checked.origin] });
67
+ const response = await send(checked.toString(), {
68
+ method: init.method,
69
+ redirect: "manual",
70
+ headers: {
71
+ authorization: `Bearer ${token}`,
72
+ ...(init.body !== undefined && { "content-type": "application/json" }),
73
+ },
74
+ ...(init.body !== undefined && { body: JSON.stringify(init.body) }),
75
+ signal: AbortSignal.timeout(resolved.timeoutMs),
76
+ });
77
+ return { ok: true, response };
78
+ }
79
+ catch (err) {
80
+ return { ok: false, ...classifyTransportError(err) };
81
+ }
82
+ }
83
+ async function readMediaAnnouncement(response) {
84
+ try {
85
+ const body = await response.json();
86
+ const url = propertyOf(body, "url");
87
+ const mimeType = propertyOf(body, "mime_type");
88
+ if (typeof url !== "string")
89
+ return { ok: false, code: "invalid_response" };
90
+ return { ok: true, url, mimeType: typeof mimeType === "string" ? mimeType : undefined };
91
+ }
92
+ catch {
93
+ return { ok: false, code: "invalid_response" };
94
+ }
95
+ }
96
+ async function readBoundedBytes(response, maxBytes) {
97
+ const announcedLength = Number(response.headers.get("content-length"));
98
+ if (announcedLength > maxBytes)
99
+ return { ok: false, code: "too_large" };
100
+ try {
101
+ if (!response.body) {
102
+ const bytes = new Uint8Array(await response.arrayBuffer());
103
+ return bytes.byteLength > maxBytes ? { ok: false, code: "too_large" } : { ok: true, bytes };
104
+ }
105
+ const reader = response.body.getReader();
106
+ const chunks = [];
107
+ let total = 0;
108
+ for (;;) {
109
+ const { done, value } = await reader.read();
110
+ if (done)
111
+ break;
112
+ total += value.byteLength;
113
+ if (total > maxBytes) {
114
+ await reader.cancel();
115
+ return { ok: false, code: "too_large" };
116
+ }
117
+ chunks.push(value);
118
+ }
119
+ const bytes = new Uint8Array(total);
120
+ let offset = 0;
121
+ for (const chunk of chunks) {
122
+ bytes.set(chunk, offset);
123
+ offset += chunk.byteLength;
124
+ }
125
+ return { ok: true, bytes };
126
+ }
127
+ catch (err) {
128
+ return { ok: false, ...classifyTransportError(err) };
129
+ }
130
+ }
131
+ async function rejection(response) {
132
+ let metaCode = null;
133
+ try {
134
+ const code = propertyOf(propertyOf(await response.json(), "error"), "code");
135
+ metaCode = typeof code === "number" ? code : null;
136
+ }
137
+ catch {
138
+ metaCode = null;
139
+ }
140
+ return { code: "rejected", httpStatus: response.status, metaCode };
141
+ }
142
+ async function postMessage(ctx, base, content) {
143
+ if (!PHONE_NUMBER_ID_PATTERN.test(base.phoneNumberId)) {
144
+ return { ok: false, code: "invalid_phone_number_id" };
145
+ }
146
+ if (!RECIPIENT_PATTERN.test(base.to))
147
+ return { ok: false, code: "invalid_recipient" };
148
+ const credentials = await readAccessToken(ctx);
149
+ if (!credentials.ok)
150
+ return credentials;
151
+ const outcome = await callGraph(`${resolved.apiBaseUrl}/${resolved.apiVersion}/${base.phoneNumberId}/messages`, credentials.token, {
152
+ method: "POST",
153
+ body: {
154
+ messaging_product: "whatsapp",
155
+ recipient_type: "individual",
156
+ to: base.to.replace(/^\+/, ""),
157
+ ...(base.replyToWamid !== undefined && { context: { message_id: base.replyToWamid } }),
158
+ ...content,
159
+ },
160
+ });
161
+ if (!outcome.ok)
162
+ return outcome;
163
+ if (!outcome.response.ok)
164
+ return { ok: false, ...(await rejection(outcome.response)) };
165
+ try {
166
+ const messages = propertyOf(await outcome.response.json(), "messages");
167
+ const wamid = Array.isArray(messages) ? propertyOf(messages[0], "id") : undefined;
168
+ return typeof wamid === "string" && wamid !== ""
169
+ ? { ok: true, wamid }
170
+ : { ok: false, code: "invalid_response" };
171
+ }
172
+ catch {
173
+ return { ok: false, code: "invalid_response" };
174
+ }
175
+ }
176
+ async function fetchMedia(ctx, mediaId) {
177
+ if (!MEDIA_ID_PATTERN.test(mediaId))
178
+ return { ok: false, code: "invalid_media_id" };
179
+ const credentials = await readAccessToken(ctx);
180
+ if (!credentials.ok)
181
+ return credentials;
182
+ const { token } = credentials;
183
+ const meta = await callGraph(`${resolved.apiBaseUrl}/${resolved.apiVersion}/${mediaId}`, token, { method: "GET" });
184
+ if (!meta.ok)
185
+ return meta;
186
+ if (!meta.response.ok)
187
+ return { ok: false, ...(await rejection(meta.response)) };
188
+ const announced = await readMediaAnnouncement(meta.response);
189
+ if (!announced.ok)
190
+ return announced;
191
+ // The URL comes from the Graph answer and receives the bearer token: callGraph checks
192
+ // it against the same allowlist and https rule before anything is sent.
193
+ const download = await callGraph(announced.url, token, { method: "GET" });
194
+ if (!download.ok)
195
+ return download;
196
+ const { response } = download;
197
+ if (response.status >= 300 && response.status < 400) {
198
+ return { ok: false, code: "redirect_blocked" };
199
+ }
200
+ if (!response.ok)
201
+ return { ok: false, ...(await rejection(response)) };
202
+ const body = await readBoundedBytes(response, resolved.mediaMaxBytes);
203
+ if (!body.ok)
204
+ return body;
205
+ const mimeType = announced.mimeType ?? response.headers.get("content-type") ?? "application/octet-stream";
206
+ return { ok: true, bytes: body.bytes, mimeType };
207
+ }
208
+ return {
209
+ sendText: (ctx, input) => {
210
+ if (input.text === "" || input.text.length > WHATSAPP_TEXT_MAX_CHARS) {
211
+ return Promise.resolve({ ok: false, code: "invalid_message" });
212
+ }
213
+ return postMessage(ctx, input, {
214
+ type: "text",
215
+ text: { body: input.text, preview_url: false },
216
+ });
217
+ },
218
+ sendTemplate: (ctx, input) => {
219
+ if (!TEMPLATE_NAME_PATTERN.test(input.templateName) ||
220
+ !LANGUAGE_CODE_PATTERN.test(input.languageCode)) {
221
+ return Promise.resolve({ ok: false, code: "invalid_message" });
222
+ }
223
+ const parameters = (input.bodyParameters ?? []).map((text) => ({ type: "text", text }));
224
+ return postMessage(ctx, input, {
225
+ type: "template",
226
+ template: {
227
+ name: input.templateName,
228
+ language: { code: input.languageCode },
229
+ ...(parameters.length > 0 && { components: [{ type: "body", parameters }] }),
230
+ },
231
+ });
232
+ },
233
+ sendButtons: (ctx, input) => {
234
+ const invalid = input.text === "" ||
235
+ input.text.length > WHATSAPP_TEXT_MAX_CHARS ||
236
+ input.buttons.length === 0 ||
237
+ input.buttons.length > WHATSAPP_MAX_REPLY_BUTTONS ||
238
+ input.buttons.some(({ payload, title }) => payload === "" ||
239
+ payload.length > WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS ||
240
+ title === "" ||
241
+ title.length > WHATSAPP_BUTTON_TITLE_MAX_CHARS);
242
+ if (invalid)
243
+ return Promise.resolve({ ok: false, code: "invalid_message" });
244
+ return postMessage(ctx, input, {
245
+ type: "interactive",
246
+ interactive: {
247
+ type: "button",
248
+ body: { text: input.text },
249
+ action: {
250
+ buttons: input.buttons.map(({ payload, title }) => ({
251
+ type: "reply",
252
+ reply: { id: payload, title },
253
+ })),
254
+ },
255
+ },
256
+ });
257
+ },
258
+ sendMedia: (ctx, input) => {
259
+ if (!isPublicMediaLink(input.link, resolved.requireHttps)) {
260
+ return Promise.resolve({ ok: false, code: "invalid_message" });
261
+ }
262
+ return postMessage(ctx, input, {
263
+ type: input.kind,
264
+ [input.kind]: {
265
+ link: input.link,
266
+ ...(input.caption !== undefined && { caption: input.caption }),
267
+ },
268
+ });
269
+ },
270
+ fetchMedia,
271
+ };
272
+ }
@@ -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>;