@cosmicdrift/kumiko-samples 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 (457) hide show
  1. package/package.json +1 -1
  2. package/packages/bundled-features/package.json +16 -1
  3. package/packages/bundled-features/src/admin-shell/changes.json +6 -0
  4. package/packages/bundled-features/src/admin-shell/feature.ts +8 -7
  5. package/packages/bundled-features/src/agent-tools/agent-doc-lint.ts +5 -1
  6. package/packages/bundled-features/src/agent-tools/agent-manifest.ts +36 -27
  7. package/packages/bundled-features/src/agent-tools/api-docs/collect-events.ts +8 -1
  8. package/packages/bundled-features/src/agent-tools/api-docs/collect.ts +3 -2
  9. package/packages/bundled-features/src/agent-tools/api-docs/generate.ts +6 -0
  10. package/packages/bundled-features/src/agent-tools/api-docs/index.ts +1 -0
  11. package/packages/bundled-features/src/agent-tools/api-docs/problems.ts +38 -1
  12. package/packages/bundled-features/src/agent-tools/api-docs/render-openapi.ts +1 -0
  13. package/packages/bundled-features/src/agent-tools/api-docs/resolve-config.ts +17 -0
  14. package/packages/bundled-features/src/agent-tools/api-docs/scope-slug-collisions.ts +17 -0
  15. package/packages/bundled-features/src/agent-tools/api-docs/translation-gaps.ts +42 -0
  16. package/packages/bundled-features/src/agent-tools/api-docs/webhook-example-problems.ts +30 -0
  17. package/packages/bundled-features/src/agent-tools/changes.json +12 -0
  18. package/packages/bundled-features/src/agent-tools/index.ts +1 -0
  19. package/packages/bundled-features/src/agent-tools/labels.ts +19 -6
  20. package/packages/bundled-features/src/agent-tools/tool-catalog.ts +18 -7
  21. package/packages/bundled-features/src/agent-tools/tool-dispatch.ts +14 -1
  22. package/packages/bundled-features/src/agent-tools/types.ts +4 -0
  23. package/packages/bundled-features/src/audit/event-classification.ts +6 -0
  24. package/packages/bundled-features/src/audit/web/i18n.ts +1 -0
  25. package/packages/bundled-features/src/auth-email-password/changes.json +18 -0
  26. package/packages/bundled-features/src/auth-email-password/errors.ts +0 -13
  27. package/packages/bundled-features/src/auth-email-password/handlers/invite-signup-complete.write.ts +147 -121
  28. package/packages/bundled-features/src/auth-email-password/handlers/login-options.query.ts +1 -1
  29. package/packages/bundled-features/src/auth-email-password/handlers/request-account-unlock.write.ts +1 -1
  30. package/packages/bundled-features/src/auth-email-password/handlers/request-email-verification.write.ts +0 -1
  31. package/packages/bundled-features/src/auth-email-password/handlers/request-password-reset.write.ts +0 -1
  32. package/packages/bundled-features/src/auth-email-password/handlers/self-registration-status.query.ts +1 -1
  33. package/packages/bundled-features/src/auth-email-password/reset-token.ts +0 -2
  34. package/packages/bundled-features/src/auth-email-password/seeding.ts +39 -7
  35. package/packages/bundled-features/src/auth-email-password/unlock-token.ts +0 -2
  36. package/packages/bundled-features/src/auth-email-password/verification-token.ts +0 -2
  37. package/packages/bundled-features/src/auth-email-password/web/auth-form-primitives.tsx +2 -2
  38. package/packages/bundled-features/src/auth-email-password/web/auth-gate.tsx +2 -2
  39. package/packages/bundled-features/src/auth-email-password/web/auth-redirect.ts +5 -0
  40. package/packages/bundled-features/src/auth-email-password/web/forgot-password-screen.tsx +1 -6
  41. package/packages/bundled-features/src/auth-email-password/web/invite-accept-screen.tsx +1 -1
  42. package/packages/bundled-features/src/auth-email-password/web/return-path.ts +2 -1
  43. package/packages/bundled-features/src/auth-email-password/web/session.tsx +10 -12
  44. package/packages/bundled-features/src/auth-email-password/web/signup-screen.tsx +1 -6
  45. package/packages/bundled-features/src/auth-email-password/web/static-account.ts +6 -1
  46. package/packages/bundled-features/src/auth-email-password/web/tenant-switcher.tsx +1 -1
  47. package/packages/bundled-features/src/auth-email-password/web/token-confirm-screen.tsx +4 -5
  48. package/packages/bundled-features/src/auth-email-password/web/user-menu.tsx +1 -1
  49. package/packages/bundled-features/src/auth-mfa/web/mfa-code-or-recovery-field.tsx +17 -1
  50. package/packages/bundled-features/src/auth-mfa/web/mfa-disable-dialog.tsx +1 -1
  51. package/packages/bundled-features/src/auth-mfa/web/mfa-regenerate-recovery-dialog.tsx +1 -1
  52. package/packages/bundled-features/src/auth-mfa/web/mfa-setup-preauth-screen.tsx +1 -1
  53. package/packages/bundled-features/src/auth-mfa/web/mfa-verify-screen.tsx +16 -47
  54. package/packages/bundled-features/src/auth-mfa-user-data/index.ts +5 -6
  55. package/packages/bundled-features/src/billing-foundation/aggregate-id.ts +0 -4
  56. package/packages/bundled-features/src/billing-foundation/changes.json +37 -0
  57. package/packages/bundled-features/src/billing-foundation/checkout-core.ts +8 -1
  58. package/packages/bundled-features/src/billing-foundation/checkout-ledger.ts +59 -0
  59. package/packages/bundled-features/src/billing-foundation/consumer-protection/consent-gate.ts +2 -1
  60. package/packages/bundled-features/src/billing-foundation/consumer-protection/consent-text.ts +49 -2
  61. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-open-cancels.ts +5 -0
  62. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-provider-timeout.ts +23 -0
  63. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-record.ts +12 -7
  64. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-revoke.ts +1 -1
  65. package/packages/bundled-features/src/billing-foundation/events.ts +49 -10
  66. package/packages/bundled-features/src/billing-foundation/feature.ts +15 -1
  67. package/packages/bundled-features/src/billing-foundation/handlers/billing-plans.query.ts +47 -14
  68. package/packages/bundled-features/src/billing-foundation/handlers/create-checkout-session.write.ts +7 -1
  69. package/packages/bundled-features/src/billing-foundation/handlers/process-event.write.ts +124 -10
  70. package/packages/bundled-features/src/billing-foundation/handlers/process-payment-event.write.ts +33 -9
  71. package/packages/bundled-features/src/billing-foundation/handlers/record-checkout-opened.write.ts +25 -0
  72. package/packages/bundled-features/src/billing-foundation/handlers/start-plan-checkout.write.ts +7 -1
  73. package/packages/bundled-features/src/billing-foundation/handlers/switch-plan.write.ts +16 -4
  74. package/packages/bundled-features/src/billing-foundation/i18n.ts +3 -0
  75. package/packages/bundled-features/src/billing-foundation/pending-plan-switch.ts +80 -0
  76. package/packages/bundled-features/src/billing-foundation/scrub-raw-payload-headers.ts +50 -0
  77. package/packages/bundled-features/src/billing-foundation/types.ts +47 -30
  78. package/packages/bundled-features/src/billing-foundation/validate-options.ts +18 -0
  79. package/packages/bundled-features/src/billing-foundation/web/billing-plans-panel.tsx +10 -5
  80. package/packages/bundled-features/src/billing-foundation/web/cancel-contract-dialog.tsx +1 -1
  81. package/packages/bundled-features/src/billing-foundation/web/checkout-consent-dialog.tsx +1 -1
  82. package/packages/bundled-features/src/billing-foundation/web/constants.ts +5 -2
  83. package/packages/bundled-features/src/billing-foundation/web/plan-switch-confirm-dialog.tsx +1 -1
  84. package/packages/bundled-features/src/billing-foundation/webhook-handler.ts +65 -17
  85. package/packages/bundled-features/src/cap-counter/aggregate-id.ts +0 -2
  86. package/packages/bundled-features/src/cap-counter/changes.json +6 -0
  87. package/packages/bundled-features/src/cap-counter/stock-cap-guard.ts +19 -4
  88. package/packages/bundled-features/src/cap-overview/changes.json +6 -0
  89. package/packages/bundled-features/src/cap-overview/handlers/tenant-caps-list.query.ts +22 -6
  90. package/packages/bundled-features/src/cap-overview/i18n.ts +1 -0
  91. package/packages/bundled-features/src/cap-overview/index.ts +1 -0
  92. package/packages/bundled-features/src/cap-overview/types.ts +11 -1
  93. package/packages/bundled-features/src/cap-overview/web/cap-cards-panel.tsx +6 -2
  94. package/packages/bundled-features/src/cap-overview/web/cap-usage-bar.tsx +10 -1
  95. package/packages/bundled-features/src/cap-overview/web/usage-math.ts +5 -0
  96. package/packages/bundled-features/src/channel-in-app/changes.json +6 -0
  97. package/packages/bundled-features/src/channel-in-app/handlers/read-state-by-keys.query.ts +2 -2
  98. package/packages/bundled-features/src/channel-whatsapp/aggregate-id.ts +29 -0
  99. package/packages/bundled-features/src/channel-whatsapp/changes.json +8 -0
  100. package/packages/bundled-features/src/channel-whatsapp/constants.ts +46 -0
  101. package/packages/bundled-features/src/channel-whatsapp/events.ts +93 -0
  102. package/packages/bundled-features/src/channel-whatsapp/feature.ts +72 -0
  103. package/packages/bundled-features/src/channel-whatsapp/graph-client.ts +398 -0
  104. package/packages/bundled-features/src/channel-whatsapp/in-memory-meta.ts +300 -0
  105. package/packages/bundled-features/src/channel-whatsapp/inbound-handlers.ts +189 -0
  106. package/packages/bundled-features/src/channel-whatsapp/index.ts +66 -0
  107. package/packages/bundled-features/src/channel-whatsapp/meta-signature.ts +26 -0
  108. package/packages/bundled-features/src/channel-whatsapp/options.ts +149 -0
  109. package/packages/bundled-features/src/channel-whatsapp/pii.ts +109 -0
  110. package/packages/bundled-features/src/channel-whatsapp/webhook-normalize.ts +226 -0
  111. package/packages/bundled-features/src/channel-whatsapp/webhook-routes.ts +185 -0
  112. package/packages/bundled-features/src/compliance-profiles/handlers/sub-processors.query.ts +1 -1
  113. package/packages/bundled-features/src/config/changes.json +12 -0
  114. package/packages/bundled-features/src/config/handlers/set.write.ts +7 -0
  115. package/packages/bundled-features/src/config/handlers/values.query.ts +8 -1
  116. package/packages/bundled-features/src/config/index.ts +1 -0
  117. package/packages/bundled-features/src/config/read-redaction.ts +6 -3
  118. package/packages/bundled-features/src/config/table.ts +1 -0
  119. package/packages/bundled-features/src/config/write-helpers.ts +3 -2
  120. package/packages/bundled-features/src/crypto-shredding/changes.json +18 -0
  121. package/packages/bundled-features/src/crypto-shredding/constants.ts +2 -0
  122. package/packages/bundled-features/src/crypto-shredding/handlers/forget-subject.write.ts +38 -18
  123. package/packages/bundled-features/src/crypto-shredding/index.ts +4 -0
  124. package/packages/bundled-features/src/crypto-shredding/subject-forget-after-delete-hook.ts +49 -0
  125. package/packages/bundled-features/src/custom-fields/aggregate-id.ts +0 -1
  126. package/packages/bundled-features/src/custom-fields/entity.ts +1 -0
  127. package/packages/bundled-features/src/custom-fields/wire-for-entity.ts +0 -1
  128. package/packages/bundled-features/src/data-retention/changes.json +12 -0
  129. package/packages/bundled-features/src/data-retention/erase-notes-of-deleted-row.ts +23 -0
  130. package/packages/bundled-features/src/data-retention/feature.ts +1 -5
  131. package/packages/bundled-features/src/data-retention/run-retention-cleanup.ts +38 -18
  132. package/packages/bundled-features/src/data-retention/tenant-destruction-hold.ts +9 -0
  133. package/packages/bundled-features/src/delivery/attempt-log-factory.ts +11 -0
  134. package/packages/bundled-features/src/delivery/attempt-log.ts +3 -3
  135. package/packages/bundled-features/src/delivery/changes.json +6 -0
  136. package/packages/bundled-features/src/delivery/channel-context.ts +6 -3
  137. package/packages/bundled-features/src/delivery/db/queries/preferences.ts +0 -1
  138. package/packages/bundled-features/src/delivery/delivery-service.ts +3 -0
  139. package/packages/bundled-features/src/delivery/feature.ts +4 -13
  140. package/packages/bundled-features/src/delivery/handlers/opted-in-user-ids.query.ts +45 -0
  141. package/packages/bundled-features/src/delivery/handlers/preferences.query.ts +2 -20
  142. package/packages/bundled-features/src/delivery/handlers/resubscribe-user.write.ts +2 -25
  143. package/packages/bundled-features/src/delivery/handlers/unsubscribe-page-chrome.query.ts +2 -0
  144. package/packages/bundled-features/src/delivery/handlers/unsubscribe-user.write.ts +2 -27
  145. package/packages/bundled-features/src/delivery/index.ts +3 -1
  146. package/packages/bundled-features/src/delivery/options.ts +11 -0
  147. package/packages/bundled-features/src/delivery/preference-rows.ts +33 -0
  148. package/packages/bundled-features/src/delivery/set-preference-enabled.ts +40 -0
  149. package/packages/bundled-features/src/delivery/testing.ts +3 -1
  150. package/packages/bundled-features/src/delivery/types.ts +1 -0
  151. package/packages/bundled-features/src/delivery/unsubscribe-page.ts +7 -1
  152. package/packages/bundled-features/src/delivery/upsert-preference.ts +0 -1
  153. package/packages/bundled-features/src/delivery/web/public-names.ts +1 -0
  154. package/packages/bundled-features/src/derivatives-sharp/render.ts +9 -9
  155. package/packages/bundled-features/src/document-ingest-foundation/aggregate-id.ts +0 -1
  156. package/packages/bundled-features/src/document-ingest-foundation/append-missing-extract-event.ts +37 -25
  157. package/packages/bundled-features/src/document-ingest-foundation/report-ingest-progress.ts +32 -14
  158. package/packages/bundled-features/src/documents/aggregate-id.ts +0 -2
  159. package/packages/bundled-features/src/documents/changes.json +18 -0
  160. package/packages/bundled-features/src/documents/constants.ts +10 -2
  161. package/packages/bundled-features/src/documents/ensure-link.ts +3 -4
  162. package/packages/bundled-features/src/documents/feature.ts +28 -6
  163. package/packages/bundled-features/src/documents/handlers/import.write.ts +2 -2
  164. package/packages/bundled-features/src/documents/queries/expiry-overview.query.ts +2 -1
  165. package/packages/bundled-features/src/documents/queries/for-record.query.ts +3 -4
  166. package/packages/bundled-features/src/documents/queries/list-page.ts +11 -3
  167. package/packages/bundled-features/src/documents/queries/overview.query.ts +2 -2
  168. package/packages/bundled-features/src/documents/screens.ts +8 -3
  169. package/packages/bundled-features/src/documents/tab.ts +1 -1
  170. package/packages/bundled-features/src/feature-toggles/toggle-sync-signal.ts +6 -3
  171. package/packages/bundled-features/src/file-derivatives/handlers/public-variant-by-file-ref.query.ts +1 -1
  172. package/packages/bundled-features/src/file-derivatives/handlers/public-variant.query.ts +1 -1
  173. package/packages/bundled-features/src/file-foundation/probe.ts +9 -3
  174. package/packages/bundled-features/src/file-foundation/read-file-ref-content.ts +24 -11
  175. package/packages/bundled-features/src/file-provider-inmemory/feature.ts +1 -1
  176. package/packages/bundled-features/src/file-provider-s3/changes.json +14 -0
  177. package/packages/bundled-features/src/file-provider-s3/env-feature.ts +1 -1
  178. package/packages/bundled-features/src/file-provider-s3/env-named-feature.ts +1 -1
  179. package/packages/bundled-features/src/file-provider-s3/env-schema.ts +24 -7
  180. package/packages/bundled-features/src/file-provider-s3/feature.ts +1 -1
  181. package/packages/bundled-features/src/file-provider-s3/index.ts +7 -1
  182. package/packages/bundled-features/src/file-provider-s3/lib/env-helper.ts +21 -13
  183. package/packages/bundled-features/src/file-provider-s3/lib/s3-provider.ts +8 -1
  184. package/packages/bundled-features/src/files/changes.json +7 -0
  185. package/packages/bundled-features/src/folders/aggregate-id.ts +0 -1
  186. package/packages/bundled-features/src/folders/web/folder-manager.tsx +6 -6
  187. package/packages/bundled-features/src/folders-user-data/index.ts +12 -14
  188. package/packages/bundled-features/src/helpdesk/changes.json +50 -0
  189. package/packages/bundled-features/src/helpdesk/entity.ts +4 -1
  190. package/packages/bundled-features/src/helpdesk/feature.ts +41 -0
  191. package/packages/bundled-features/src/helpdesk/handlers/access.ts +0 -10
  192. package/packages/bundled-features/src/helpdesk/handlers/attempts.ts +7 -14
  193. package/packages/bundled-features/src/helpdesk/handlers/challenge.query.ts +1 -2
  194. package/packages/bundled-features/src/helpdesk/handlers/reply.write.ts +2 -9
  195. package/packages/bundled-features/src/helpdesk/handlers/report.write.ts +2 -9
  196. package/packages/bundled-features/src/helpdesk/handlers/submit.write.ts +3 -11
  197. package/packages/bundled-features/src/helpdesk/index.ts +1 -0
  198. package/packages/bundled-features/src/helpdesk/legacy-contact-config.ts +61 -0
  199. package/packages/bundled-features/src/helpdesk/legacy-contact-erasure.ts +45 -0
  200. package/packages/bundled-features/src/helpdesk/legacy-contact-retention.ts +65 -0
  201. package/packages/bundled-features/src/helpdesk/legacy-contact-streams.ts +185 -0
  202. package/packages/bundled-features/src/helpdesk/legacy-contact-user-data.ts +84 -0
  203. package/packages/bundled-features/src/helpdesk/lib.ts +47 -34
  204. package/packages/bundled-features/src/helpdesk/user-data-hooks.ts +89 -48
  205. package/packages/bundled-features/src/helpdesk/web/constants.ts +0 -1
  206. package/packages/bundled-features/src/inbound-mail-foundation/account-health.ts +1 -1
  207. package/packages/bundled-features/src/inbound-mail-foundation/account-poll.ts +5 -1
  208. package/packages/bundled-features/src/inbound-mail-foundation/aggregate-id.ts +0 -2
  209. package/packages/bundled-features/src/inbound-mail-foundation/changes.json +48 -0
  210. package/packages/bundled-features/src/inbound-mail-foundation/constants.ts +6 -0
  211. package/packages/bundled-features/src/inbound-mail-foundation/content-refetch.ts +15 -1
  212. package/packages/bundled-features/src/inbound-mail-foundation/entities.ts +64 -15
  213. package/packages/bundled-features/src/inbound-mail-foundation/events.ts +15 -16
  214. package/packages/bundled-features/src/inbound-mail-foundation/feature.ts +3 -1
  215. package/packages/bundled-features/src/inbound-mail-foundation/handlers/account-address.ts +16 -2
  216. package/packages/bundled-features/src/inbound-mail-foundation/handlers/attach-message-content.write.ts +10 -3
  217. package/packages/bundled-features/src/inbound-mail-foundation/handlers/connect-account.write.ts +21 -8
  218. package/packages/bundled-features/src/inbound-mail-foundation/handlers/forget-message.write.ts +73 -0
  219. package/packages/bundled-features/src/inbound-mail-foundation/i18n.ts +3 -0
  220. package/packages/bundled-features/src/inbound-mail-foundation/index.ts +1 -0
  221. package/packages/bundled-features/src/inbound-mail-foundation/oauth-access-token.ts +1 -1
  222. package/packages/bundled-features/src/inbound-mail-foundation/outbound-mail.ts +2 -0
  223. package/packages/bundled-features/src/inbound-mail-foundation/personal-address.ts +20 -0
  224. package/packages/bundled-features/src/inbound-mail-foundation/purge-messages.ts +54 -0
  225. package/packages/bundled-features/src/inbound-mail-foundation/quarantine.ts +15 -5
  226. package/packages/bundled-features/src/inbound-mail-foundation/retention-job.ts +1 -5
  227. package/packages/bundled-features/src/inbound-mail-foundation/retention-sweep.ts +21 -34
  228. package/packages/bundled-features/src/inbound-mail-foundation/send-from-account.ts +9 -1
  229. package/packages/bundled-features/src/inbound-mail-foundation/supervisor-ingest.ts +7 -1
  230. package/packages/bundled-features/src/inbound-mail-foundation/sync-account-now.ts +1 -1
  231. package/packages/bundled-features/src/inbound-mail-foundation/tenant-destroy-hook.ts +14 -17
  232. package/packages/bundled-features/src/inbound-mail-foundation/watch-supervisor.ts +1 -1
  233. package/packages/bundled-features/src/inbound-provider-imap/byte-budget.ts +80 -0
  234. package/packages/bundled-features/src/inbound-provider-imap/changes.json +13 -0
  235. package/packages/bundled-features/src/inbound-provider-imap/connect-mailbox.ts +8 -4
  236. package/packages/bundled-features/src/inbound-provider-imap/connect-my-mailbox.ts +23 -6
  237. package/packages/bundled-features/src/inbound-provider-imap/connect-target-rate-limit.ts +46 -0
  238. package/packages/bundled-features/src/inbound-provider-imap/download-batch.ts +47 -10
  239. package/packages/bundled-features/src/inbound-provider-imap/feature.ts +7 -4
  240. package/packages/bundled-features/src/inbound-provider-imap/fetch-content.ts +43 -29
  241. package/packages/bundled-features/src/inbound-provider-imap/i18n.ts +2 -2
  242. package/packages/bundled-features/src/inbound-provider-imap/parse-message.ts +14 -0
  243. package/packages/bundled-features/src/inbound-provider-imap/reconnect-mailbox.ts +5 -4
  244. package/packages/bundled-features/src/inbound-provider-imap/send-mail.ts +39 -7
  245. package/packages/bundled-features/src/inbound-provider-imap/smtp-client.ts +19 -4
  246. package/packages/bundled-features/src/inbound-provider-imap/watch-mailbox.ts +8 -23
  247. package/packages/bundled-features/src/inbound-provider-inmemory/feature.ts +1 -1
  248. package/packages/bundled-features/src/jobs/events.ts +10 -0
  249. package/packages/bundled-features/src/jobs/feature.ts +2 -0
  250. package/packages/bundled-features/src/jobs/handlers/consumer.write.ts +41 -16
  251. package/packages/bundled-features/src/jobs/web/constants.ts +4 -0
  252. package/packages/bundled-features/src/mail-foundation/changes.json +6 -0
  253. package/packages/bundled-features/src/mail-transport-inmemory/feature.ts +1 -1
  254. package/packages/bundled-features/src/mail-transport-smtp/feature.ts +3 -2
  255. package/packages/bundled-features/src/managed-pages/changes.json +12 -0
  256. package/packages/bundled-features/src/managed-pages/handlers/branding.query.ts +1 -1
  257. package/packages/bundled-features/src/managed-pages/handlers/by-slug.query.ts +1 -1
  258. package/packages/bundled-features/src/managed-pages/handlers/by-tenant-published.query.ts +1 -1
  259. package/packages/bundled-features/src/managed-pages/render-page-body.ts +18 -10
  260. package/packages/bundled-features/src/managed-pages/screens/page-screens.ts +18 -38
  261. package/packages/bundled-features/src/managed-pages/table.ts +1 -0
  262. package/packages/bundled-features/src/managed-pages/web/client-plugin.tsx +8 -6
  263. package/packages/bundled-features/src/managed-pages/web/constants.ts +8 -1
  264. package/packages/bundled-features/src/managed-pages/web/i18n.ts +11 -3
  265. package/packages/bundled-features/src/managed-pages/web/markdown-to-document.ts +1 -1
  266. package/packages/bundled-features/src/managed-pages/web/page-edit-draft.ts +108 -0
  267. package/packages/bundled-features/src/managed-pages/web/page-edit-screen.tsx +198 -0
  268. package/packages/bundled-features/src/managed-pages/web/page-settings-rail.tsx +117 -0
  269. package/packages/bundled-features/src/notes-history-user-data/index.ts +8 -14
  270. package/packages/bundled-features/src/personal-access-tokens/boot-rules.ts +5 -0
  271. package/packages/bundled-features/src/personal-access-tokens/handlers/create.write.ts +0 -1
  272. package/packages/bundled-features/src/personal-access-tokens/scope-events-check.ts +31 -5
  273. package/packages/bundled-features/src/presence/changes.json +6 -0
  274. package/packages/bundled-features/src/presence/handlers/list.query.ts +28 -11
  275. package/packages/bundled-features/src/presence/room.ts +21 -7
  276. package/packages/bundled-features/src/presence/store.ts +79 -21
  277. package/packages/bundled-features/src/readiness/changes.json +25 -0
  278. package/packages/bundled-features/src/readiness/handlers/latest-summary.query.ts +11 -6
  279. package/packages/bundled-features/src/readiness/handlers/run-probes.write.ts +35 -5
  280. package/packages/bundled-features/src/readiness/handlers/run-tone.ts +3 -2
  281. package/packages/bundled-features/src/readiness/handlers/status.query.ts +15 -1
  282. package/packages/bundled-features/src/readiness/probe-context.ts +11 -10
  283. package/packages/bundled-features/src/readiness/screens.ts +4 -4
  284. package/packages/bundled-features/src/readiness/visible-results.ts +5 -3
  285. package/packages/bundled-features/src/renderer-foundation/api.ts +6 -13
  286. package/packages/bundled-features/src/renderer-foundation/types.ts +2 -2
  287. package/packages/bundled-features/src/secrets/changes.json +7 -0
  288. package/packages/bundled-features/src/secrets/db/queries/read.ts +18 -4
  289. package/packages/bundled-features/src/secrets/handlers/list.query.ts +8 -2
  290. package/packages/bundled-features/src/secrets/secret-scope.ts +2 -3
  291. package/packages/bundled-features/src/secrets/secrets-context.ts +6 -4
  292. package/packages/bundled-features/src/secrets/write-gate.ts +4 -2
  293. package/packages/bundled-features/src/seo/handlers/seo-config.query.ts +1 -1
  294. package/packages/bundled-features/src/shared/acknowledged-system-db.ts +20 -0
  295. package/packages/bundled-features/src/shared/assert-billing-live.ts +9 -2
  296. package/packages/bundled-features/src/shared/changes.json +6 -0
  297. package/packages/bundled-features/src/shared/index.ts +6 -1
  298. package/packages/bundled-features/src/shared/parent-visibility.ts +25 -1
  299. package/packages/bundled-features/src/shared/password-hashing.ts +0 -1
  300. package/packages/bundled-features/src/shared/price-env-shape.ts +1 -4
  301. package/packages/bundled-features/src/shared/register-user-data-hooks.ts +29 -0
  302. package/packages/bundled-features/src/shared/require-bootstrap-extension.ts +26 -0
  303. package/packages/bundled-features/src/shared/send-best-effort.ts +19 -0
  304. package/packages/bundled-features/src/shared/stream-tenant-backfill.ts +22 -1
  305. package/packages/bundled-features/src/shared/stream-tenant-derived-state.ts +31 -1
  306. package/packages/bundled-features/src/step-dispatcher/changes.json +12 -0
  307. package/packages/bundled-features/src/step-dispatcher/constants.ts +13 -0
  308. package/packages/bundled-features/src/step-dispatcher/deliver-dispatch-request.ts +47 -2
  309. package/packages/bundled-features/src/step-dispatcher/feature.ts +28 -1
  310. package/packages/bundled-features/src/step-dispatcher/mail-runner.ts +0 -1
  311. package/packages/bundled-features/src/step-dispatcher/sweep-abandoned.ts +57 -0
  312. package/packages/bundled-features/src/subscription-mollie/changes.json +7 -0
  313. package/packages/bundled-features/src/subscription-mollie/plugin-methods.ts +5 -3
  314. package/packages/bundled-features/src/subscription-mollie/verify-webhook.ts +5 -5
  315. package/packages/bundled-features/src/subscription-paddle/backfill-checkout-ledger.ts +159 -0
  316. package/packages/bundled-features/src/subscription-paddle/changes.json +13 -0
  317. package/packages/bundled-features/src/subscription-paddle/checkout-config.query.ts +1 -1
  318. package/packages/bundled-features/src/subscription-paddle/checkout-methods.ts +2 -8
  319. package/packages/bundled-features/src/subscription-paddle/constants.ts +1 -2
  320. package/packages/bundled-features/src/subscription-paddle/feature.ts +26 -24
  321. package/packages/bundled-features/src/subscription-paddle/ledger-backfill-marker.ts +70 -0
  322. package/packages/bundled-features/src/subscription-paddle/plan-switch-methods.ts +2 -8
  323. package/packages/bundled-features/src/subscription-paddle/redeliver-legacy-checkout.ts +36 -0
  324. package/packages/bundled-features/src/subscription-paddle/runtime.ts +13 -24
  325. package/packages/bundled-features/src/subscription-paddle/subscription-state.ts +1 -0
  326. package/packages/bundled-features/src/subscription-paddle/webhook-events.ts +68 -21
  327. package/packages/bundled-features/src/subscription-stripe/changes.json +7 -0
  328. package/packages/bundled-features/src/subscription-stripe/feature.ts +5 -0
  329. package/packages/bundled-features/src/subscription-stripe/plugin-methods.ts +6 -6
  330. package/packages/bundled-features/src/subscription-stripe/runtime.ts +8 -7
  331. package/packages/bundled-features/src/subscription-stripe/verify-webhook.ts +24 -6
  332. package/packages/bundled-features/src/tags/aggregate-id.ts +0 -1
  333. package/packages/bundled-features/src/tags/web/tag-chip.tsx +4 -5
  334. package/packages/bundled-features/src/tags/web/tag-manager.tsx +2 -1
  335. package/packages/bundled-features/src/template-resolver/api.ts +6 -13
  336. package/packages/bundled-features/src/template-resolver/changes.json +36 -0
  337. package/packages/bundled-features/src/template-resolver/document-sanitizer.ts +25 -0
  338. package/packages/bundled-features/src/template-resolver/feature.ts +2 -0
  339. package/packages/bundled-features/src/template-resolver/handlers/body-preview.query.ts +41 -0
  340. package/packages/bundled-features/src/template-resolver/handlers/by-slug.query.ts +1 -1
  341. package/packages/bundled-features/src/template-resolver/handlers/by-tenant.query.ts +1 -1
  342. package/packages/bundled-features/src/template-resolver/handlers/collection-shared.ts +5 -11
  343. package/packages/bundled-features/src/template-resolver/handlers/overview.query.ts +3 -2
  344. package/packages/bundled-features/src/template-resolver/handlers/send-test.write.ts +37 -8
  345. package/packages/bundled-features/src/template-resolver/linked-resources.ts +2 -5
  346. package/packages/bundled-features/src/template-resolver/seeding.ts +77 -0
  347. package/packages/bundled-features/src/template-resolver/table.ts +1 -0
  348. package/packages/bundled-features/src/template-resolver/template-draft.ts +2 -1
  349. package/packages/bundled-features/src/template-resolver/template-preview.ts +14 -3
  350. package/packages/bundled-features/src/template-resolver/testing.ts +0 -2
  351. package/packages/bundled-features/src/template-resolver/web/client-plugin.tsx +3 -0
  352. package/packages/bundled-features/src/template-resolver/web/collection-entry-create-form.tsx +33 -33
  353. package/packages/bundled-features/src/template-resolver/web/constants.ts +7 -0
  354. package/packages/bundled-features/src/template-resolver/web/content-tree-provider.ts +0 -1
  355. package/packages/bundled-features/src/template-resolver/web/content-workbench.tsx +142 -0
  356. package/packages/bundled-features/src/template-resolver/web/document-insert-model.ts +3 -8
  357. package/packages/bundled-features/src/template-resolver/web/document-link-policy.ts +58 -0
  358. package/packages/bundled-features/src/template-resolver/web/document-schema.ts +11 -57
  359. package/packages/bundled-features/src/template-resolver/web/document-tiptap-bubble.tsx +2 -4
  360. package/packages/bundled-features/src/template-resolver/web/document-tiptap-context.ts +4 -5
  361. package/packages/bundled-features/src/template-resolver/web/document-tiptap-editor.tsx +2 -2
  362. package/packages/bundled-features/src/template-resolver/web/document-tiptap-helpers.ts +6 -3
  363. package/packages/bundled-features/src/template-resolver/web/document-tiptap-toolbar-groups.tsx +2 -3
  364. package/packages/bundled-features/src/template-resolver/web/editor-handle.ts +1 -0
  365. package/packages/bundled-features/src/template-resolver/web/fill-document-variables.ts +24 -0
  366. package/packages/bundled-features/src/template-resolver/web/i18n.ts +14 -0
  367. package/packages/bundled-features/src/template-resolver/web/index.ts +3 -0
  368. package/packages/bundled-features/src/template-resolver/web/preview-targets.ts +25 -0
  369. package/packages/bundled-features/src/template-resolver/web/qualified-names.ts +1 -0
  370. package/packages/bundled-features/src/template-resolver/web/snippet-preview-renderer.tsx +24 -0
  371. package/packages/bundled-features/src/template-resolver/web/string-values.ts +7 -0
  372. package/packages/bundled-features/src/template-resolver/web/text-block-editor.tsx +38 -50
  373. package/packages/bundled-features/src/template-resolver/web/use-collection-entry-create.ts +7 -0
  374. package/packages/bundled-features/src/template-resolver/web/use-content-write.ts +1 -3
  375. package/packages/bundled-features/src/template-resolver/web/use-document-tiptap-model.ts +1 -2
  376. package/packages/bundled-features/src/template-resolver/web/use-text-block-editor.ts +28 -7
  377. package/packages/bundled-features/src/template-resolver/web/web-preview-renderer.tsx +126 -0
  378. package/packages/bundled-features/src/template-resolver-user-data/index.ts +11 -10
  379. package/packages/bundled-features/src/tenant/changes.json +6 -0
  380. package/packages/bundled-features/src/tenant/handlers/create.write.ts +7 -8
  381. package/packages/bundled-features/src/tenant/handlers/list.query.ts +7 -9
  382. package/packages/bundled-features/src/tenant/handlers/member-directory.query.ts +10 -4
  383. package/packages/bundled-features/src/tenant/handlers/toggle-enabled.write.ts +1 -1
  384. package/packages/bundled-features/src/tenant/invited-membership.ts +10 -1
  385. package/packages/bundled-features/src/tenant/seeding.ts +4 -2
  386. package/packages/bundled-features/src/tenant/stream-tenant-backfill.ts +5 -1
  387. package/packages/bundled-features/src/tenant/testing.ts +1 -1
  388. package/packages/bundled-features/src/tenant-inactivity/check-inactive-tenants.ts +4 -3
  389. package/packages/bundled-features/src/tenant-inactivity/constants.ts +1 -2
  390. package/packages/bundled-features/src/tenant-inactivity/handlers/keep-account.write.ts +1 -2
  391. package/packages/bundled-features/src/tenant-inactivity/state-store.ts +10 -1
  392. package/packages/bundled-features/src/tenant-lifecycle/changes.json +18 -0
  393. package/packages/bundled-features/src/tenant-lifecycle/constants.ts +4 -0
  394. package/packages/bundled-features/src/tenant-lifecycle/run-tenant-destroy.ts +43 -6
  395. package/packages/bundled-features/src/tenant-lifecycle/stages.ts +15 -2
  396. package/packages/bundled-features/src/tier-engine/aggregate-id.ts +0 -1
  397. package/packages/bundled-features/src/tier-engine/changes.json +6 -0
  398. package/packages/bundled-features/src/tier-engine/feature.ts +8 -2
  399. package/packages/bundled-features/src/user/changes.json +6 -0
  400. package/packages/bundled-features/src/user/db/queries/stream-tenant-backfill.ts +2 -1
  401. package/packages/bundled-features/src/user/handlers/me.query.ts +3 -1
  402. package/packages/bundled-features/src/user/index.ts +1 -0
  403. package/packages/bundled-features/src/user/resolve-verified-user-email.ts +17 -0
  404. package/packages/bundled-features/src/user-data-rights/db/queries/export-jobs.ts +0 -1
  405. package/packages/bundled-features/src/user-data-rights/handlers/confirm-deletion-by-token.write.ts +1 -1
  406. package/packages/bundled-features/src/user-data-rights/handlers/download-by-token.query.ts +1 -1
  407. package/packages/bundled-features/src/user-data-rights/handlers/request-deletion-by-email.write.ts +1 -1
  408. package/packages/bundled-features/src/user-data-rights/run-export-jobs.ts +0 -2
  409. package/packages/bundled-features/src/user-data-rights/run-forget-cleanup.ts +3 -3
  410. package/packages/bundled-features/src/user-data-rights/schema/download-attempt.ts +3 -2
  411. package/packages/bundled-features/src/user-data-rights/web/confirm-deletion-screen.tsx +1 -1
  412. package/packages/bundled-features/src/user-data-rights/web/privacy-center-screen.tsx +1 -1
  413. package/packages/bundled-features/src/user-data-rights/web/request-deletion-screen.tsx +1 -1
  414. package/packages/bundled-features/src/user-data-rights-defaults/hooks/api-token.userdata-hook.ts +5 -5
  415. package/packages/bundled-features/src/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.ts +17 -0
  416. package/packages/bundled-features/src/user-data-rights-defaults/hooks/in-app-message.userdata-hook.ts +5 -5
  417. package/packages/bundled-features/src/user-data-rights-defaults/hooks/job-run.userdata-hook.ts +2 -1
  418. package/packages/bundled-features/src/user-data-rights-defaults/hooks/user-session.userdata-hook.ts +5 -5
  419. package/packages/bundled-features/src/user-profile/handlers/change-email.write.ts +0 -1
  420. package/packages/bundled-features/src/waitlist/changes.json +6 -0
  421. package/packages/bundled-features/src/waitlist/handlers/submit.write.ts +4 -28
  422. package/packages/bundled-features/src/waitlist/lib.ts +2 -7
  423. package/packages/bundled-features/src/waitlist/user-data-hooks.ts +6 -19
  424. package/packages/bundled-features/src/workflow-runner/aggregate-id.ts +0 -1
  425. package/packages/bundled-features/src/workflow-runner/event-trigger.ts +6 -2
  426. package/packages/bundled-features/src/workflow-runner/feature.ts +1 -5
  427. package/packages/bundled-features/src/workflow-runner/handlers/resume-run.write.ts +5 -4
  428. package/packages/bundled-features/src/workflow-runner/runner.ts +2 -0
  429. package/samples/apps/showcase/src/features/demos/web/pages/dialog.tsx +0 -1
  430. package/samples/apps/showcase/src/features/demos/web/pages/layout.tsx +1 -1
  431. package/samples/apps/showcase/src/features/demos/web/pages/sidebar-panel.tsx +0 -1
  432. package/samples/apps/styleguide/src/features/gallery/web/Gallery.tsx +1 -4
  433. package/samples/apps/ui-walkthrough/src/features/subscription-plans/feature.ts +6 -2
  434. package/samples/apps/use-all-bundled/e2e-billing-gallery/gallery-features.ts +12 -14
  435. package/samples/apps/use-all-bundled/feature-manifest.json +60 -29
  436. package/samples/apps/use-all-bundled/playwright.billing-docs.config.ts +1 -1
  437. package/samples/apps/use-all-bundled/playwright.config.ts +1 -0
  438. package/samples/apps/use-all-bundled/src/app/seed.ts +1 -1
  439. package/samples/apps/use-all-bundled/src/run-config.ts +2 -1
  440. package/samples/recipes/auth-mfa/src/web/confirmation-code-step.tsx +32 -10
  441. package/samples/recipes/chat-channels/README.md +2 -0
  442. package/samples/recipes/currencies-global/src/entities/currency.ts +1 -0
  443. package/samples/recipes/managed-pages/README.md +5 -1
  444. package/samples/recipes/managed-pages/package.json +3 -2
  445. package/samples/recipes/managed-pages/src/web/branded-preview.tsx +21 -0
  446. package/samples/recipes/managed-pages/tsconfig.json +8 -0
  447. package/samples/recipes/pwa-shell/README.md +52 -0
  448. package/samples/recipes/pwa-shell/bin/server.ts +12 -0
  449. package/samples/recipes/pwa-shell/package.json +13 -0
  450. package/samples/recipes/pwa-shell/src/app.ts +34 -0
  451. package/samples/recipes/rate-limiting/README.md +3 -3
  452. package/samples/recipes/record-detail-layout/README.md +33 -0
  453. package/samples/recipes/record-detail-layout/src/feature.ts +525 -44
  454. package/samples/recipes/record-detail-layout/src/order-board.ts +521 -0
  455. package/packages/bundled-features/src/managed-pages/web/page-body-section.tsx +0 -72
  456. package/packages/bundled-features/src/subscription-paddle/tenant-binding.ts +0 -34
  457. package/packages/bundled-features/src/template-resolver/web/content-field.tsx +0 -61
@@ -5,6 +5,7 @@
5
5
  // webhook signature in verify() IS the auth, so no c.get("user") here.
6
6
 
7
7
  import { ExtraRouteRejection, signatureRoute } from "@cosmicdrift/kumiko-framework/api";
8
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
8
9
  import type { Context } from "hono";
9
10
  import type { PaymentEvent, SubscriptionEvent, SubscriptionProviderPlugin } from "./types.ts";
10
11
  import {
@@ -31,6 +32,7 @@ export type SubscriptionWebhookRouteOptions = {
31
32
  ) => Promise<import("@cosmicdrift/kumiko-framework/engine").WriteResult>;
32
33
  };
33
34
 
35
+ const IGNORED_CHECKOUT_NOT_IN_LEDGER = "checkout_not_in_ledger";
34
36
  const DEFAULT_WEBHOOK_PATH = "/api/subscription/webhook/:providerName";
35
37
 
36
38
  function resolveProvider(
@@ -106,20 +108,13 @@ export function createSubscriptionWebhookRoute(options: SubscriptionWebhookRoute
106
108
  providerCustomerId: parsed.providerCustomerId,
107
109
  priceId: parsed.priceId,
108
110
  ...(parsed.quantity !== undefined && { quantity: parsed.quantity }),
109
- ...(parsed.consentId !== undefined && { consentId: parsed.consentId }),
110
- ...(parsed.providerCheckoutId !== undefined && {
111
- providerCheckoutId: parsed.providerCheckoutId,
112
- }),
111
+ providerCheckoutId: parsed.providerCheckoutId,
113
112
  },
114
113
  });
115
- return respondFromDispatch(
116
- c,
117
- dispatched.isSuccess && options.afterDispatch
118
- ? await options.afterDispatch(dispatched, tenantId, deps, parsed)
119
- : dispatched,
114
+ return answerWebhook(c, { dispatched, parsed, deps, options }, [
120
115
  "subscription_payment_webhook_processing_failed",
121
116
  "Internal error processing payment event",
122
- );
117
+ ]);
123
118
  }
124
119
  const dispatched = await deps.dispatchSystemWrite({
125
120
  handlerQn: SubscriptionFoundationHandlers.processEvent,
@@ -137,21 +132,73 @@ export function createSubscriptionWebhookRoute(options: SubscriptionWebhookRoute
137
132
  ...(parsed.providerEventAt !== undefined && {
138
133
  providerEventAtIso: parsed.providerEventAt,
139
134
  }),
140
- ...(parsed.consentId !== undefined && { consentId: parsed.consentId }),
135
+ ...(parsed.providerCheckoutId !== undefined && {
136
+ providerCheckoutId: parsed.providerCheckoutId,
137
+ }),
141
138
  },
142
139
  });
143
- return respondFromDispatch(
144
- c,
145
- dispatched.isSuccess && options.afterDispatch
146
- ? await options.afterDispatch(dispatched, tenantId, deps, parsed)
147
- : dispatched,
140
+ return answerWebhook(c, { dispatched, parsed, deps, options }, [
148
141
  "subscription_webhook_processing_failed",
149
142
  "Internal error processing subscription event",
150
- );
143
+ ]);
151
144
  },
152
145
  });
153
146
  }
154
147
 
148
+ type WebhookOutcome = {
149
+ readonly dispatched: import("@cosmicdrift/kumiko-framework/engine").WriteResult;
150
+ readonly parsed: SubscriptionEvent | PaymentEvent;
151
+ readonly deps: import("@cosmicdrift/kumiko-framework/api").SignatureExtraRouteDeps;
152
+ readonly options: SubscriptionWebhookRouteOptions;
153
+ };
154
+
155
+ /** Redelivery (503) when the event may still become admissible, otherwise the afterDispatch
156
+ * side-effect for a processed event and the shared 200/500 mapping. */
157
+ async function answerWebhook(
158
+ c: Context,
159
+ { dispatched, parsed, deps, options }: WebhookOutcome,
160
+ [errorCode, errorMessage]: readonly [string, string],
161
+ ): Promise<Response> {
162
+ const redeliver = await redeliveryReason(dispatched, parsed, deps);
163
+ if (redeliver !== undefined) return retryLater(c, redeliver);
164
+ const settled =
165
+ dispatched.isSuccess && !wasIgnored(dispatched) && options.afterDispatch
166
+ ? await options.afterDispatch(dispatched, parsed.tenantId, deps, parsed)
167
+ : dispatched;
168
+ return respondFromDispatch(c, settled, errorCode, errorMessage);
169
+ }
170
+
171
+ /** Why the provider should send this ignored event again, or undefined when 200 is right: the
172
+ * handler asked for it (the event beat its subscription's `created`), or the provider plugin
173
+ * expects to ledger the checkout shortly (migration sweep). */
174
+ async function redeliveryReason(
175
+ dispatched: import("@cosmicdrift/kumiko-framework/engine").WriteResult,
176
+ event: SubscriptionEvent | PaymentEvent,
177
+ deps: import("@cosmicdrift/kumiko-framework/api").SignatureExtraRouteDeps,
178
+ ): Promise<string | undefined> {
179
+ if (!dispatched.isSuccess || !wasIgnored(dispatched)) return undefined;
180
+ const reason = propertyOf(dispatched.data, "reason");
181
+ if (typeof reason !== "string") return undefined;
182
+ if (propertyOf(dispatched.data, "retry") === true) return reason;
183
+ if (reason !== IGNORED_CHECKOUT_NOT_IN_LEDGER) return undefined;
184
+ const plugin = resolveProvider(deps.registry, event.providerName);
185
+ const redeliver = await plugin?.shouldRedeliverIgnoredEvent?.({ event, reason, deps });
186
+ return redeliver === true ? reason : undefined;
187
+ }
188
+
189
+ function retryLater(c: Context, reason: string): Response {
190
+ c.header("Retry-After", "60");
191
+ return c.json({ error: { code: "subscription_event_redeliver", reason } }, 503);
192
+ }
193
+
194
+ /** The handler refused the event (not in the checkout ledger, foreign subscription):
195
+ * nothing was stored, so no side-effect (credits, tier sync) may follow. */
196
+ function wasIgnored(
197
+ dispatched: import("@cosmicdrift/kumiko-framework/engine").WriteResult,
198
+ ): boolean {
199
+ return dispatched.isSuccess && propertyOf(dispatched.data, "ignored") === true;
200
+ }
201
+
155
202
  /** Shared 500/200-mapping for both dispatch branches above. Internal error →
156
203
  * provider should retry, hence 500 instead of 401/404 (transient, not a config-bug). */
157
204
  function respondFromDispatch(
@@ -166,5 +213,6 @@ function respondFromDispatch(
166
213
  500,
167
214
  );
168
215
  }
216
+ if (wasIgnored(dispatched)) return c.json({ ignored: true }, 200);
169
217
  return c.json({ processed: true, ...((dispatched.data as object) ?? {}) }, 200); // @cast-boundary engine-bridge
170
218
  }
@@ -18,7 +18,6 @@ const CAP_COUNTER_ROLLING_NAMESPACE = "8b2ad0c6-1f3e-4f7c-9b8a-3c4d5e6f7a8b";
18
18
  * Parallel bookings for the same triple share one stream; the event store's
19
19
  * optimistic lock serializes them and bookCapUsage retries the loser.
20
20
  */
21
- // @wrapper-known uuid-domain
22
21
  export function capCounterAggregateId(
23
22
  tenantId: string,
24
23
  capName: string,
@@ -42,7 +41,6 @@ export function capCounterAggregateId(
42
41
  * this with tenantId + capName and appends increment events to the stream.
43
42
  * Race-free because the event store appends with an auto-incrementing version.
44
43
  */
45
- // @wrapper-known uuid-domain
46
44
  export function rollingCapAggregateId(tenantId: string, capName: string): string {
47
45
  return uuidv5(`${tenantId}|${capName}`, CAP_COUNTER_ROLLING_NAMESPACE);
48
46
  }
@@ -1,4 +1,10 @@
1
1
  [
2
+ {
3
+ "version": "0.414.0",
4
+ "type": "fix",
5
+ "title": "Canonical stock-cap lock keys",
6
+ "detail": "The stock-cap lock key sorts where-keys at every depth and serializes Temporal and Date values by their string form, so handlers counting the same rows share one lock."
7
+ },
2
8
  {
3
9
  "version": "0.389.0",
4
10
  "type": "fix",
@@ -42,10 +42,25 @@ export type StockCapSpec<TCaps> = {
42
42
 
43
43
  // Lock on the counted set, not on `code`: two handlers capping the same rows under
44
44
  // different codes must still serialize against each other.
45
- // guard:dup-ok lock key of one counted set; only the sorted-entries shape matches other key builders
46
- function countedSetKey(spec: Pick<StockCapSpec<unknown>, "table" | "where">): string {
47
- const where = Object.entries(spec.where ?? {}).sort(([a], [b]) => a.localeCompare(b));
48
- return `${spec.table.tableName}:${JSON.stringify(where)}`;
45
+ export function countedSetKey(spec: Pick<StockCapSpec<unknown>, "table" | "where">): string {
46
+ return `${spec.table.tableName}:${canonicalWhereJson(spec.where ?? {})}`;
47
+ }
48
+
49
+ // Sorted keys at every depth; toJSON values (Temporal, Date) serialize as their string form
50
+ // instead of being walked as empty objects.
51
+ function canonicalWhereJson(value: unknown): string {
52
+ if (Array.isArray(value)) return `[${value.map(canonicalWhereJson).join(",")}]`;
53
+ if (value === null || typeof value !== "object" || hasToJson(value)) {
54
+ return JSON.stringify(value) ?? "null";
55
+ }
56
+ const entries = Object.entries(value)
57
+ .filter(([, nested]) => nested !== undefined)
58
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
59
+ return `{${entries.map(([key, nested]) => `${JSON.stringify(key)}:${canonicalWhereJson(nested)}`).join(",")}}`;
60
+ }
61
+
62
+ function hasToJson(value: object): boolean {
63
+ return "toJSON" in value && typeof value.toJSON === "function";
49
64
  }
50
65
 
51
66
  export type StockCapGuard<TCaps> = {
@@ -1,4 +1,10 @@
1
1
  [
2
+ {
3
+ "version": "0.414.0",
4
+ "type": "fix",
5
+ "title": "Visible overage on not-included caps, batched limits",
6
+ "detail": "A cap with limit 0 and usage above zero shows the used amount with cap-overview.notIncludedButUsed instead of only \"Not included\" (bar, cap cards, tenant list). CapSpec gets an optional limitBatch that tenant-caps:list prefers over one limit() call per tenant and cap, and the limit comment no longer claims it is resolved once per tier."
7
+ },
2
8
  {
3
9
  "version": "0.397.0",
4
10
  "type": "improvement",
@@ -11,7 +11,7 @@ import * as z from "zod";
11
11
  import { subscriptionsProjectionTable } from "../../billing-foundation/index.ts";
12
12
  import { decryptTenantNames, tenantTable } from "../../tenant/index.ts";
13
13
  import { tierAssignmentEntity } from "../../tier-engine/index.ts";
14
- import type { CapSpec, CapSpecLimitContext, CapUsage } from "../types.ts";
14
+ import type { CapSpec, CapSpecLimitContext, CapSpecLimitTenant, CapUsage } from "../types.ts";
15
15
  import { capFieldName } from "../web/constants.ts";
16
16
  import { computeFraction } from "../web/usage-math.ts";
17
17
 
@@ -84,15 +84,31 @@ async function resolveLimitsByTenantAndCap(
84
84
  configFor: ((tenantId: TenantId) => ConfigAccessor) | undefined,
85
85
  db: CapSpecLimitContext["db"],
86
86
  ): Promise<ReadonlyMap<string, number | null>> {
87
+ const limitTenants: readonly CapSpecLimitTenant[] = tenants.map(({ tenantId, tier }) => ({
88
+ config: configFor?.(tenantId),
89
+ tenantId,
90
+ tier,
91
+ }));
87
92
  const entries = await Promise.all(
88
- tenants.flatMap(({ tenantId, tier }) => {
89
- const context: CapSpecLimitContext = { config: configFor?.(tenantId), tenantId, db };
90
- return caps.map(
91
- async (cap) => [tenantCapKey(tenantId, cap.id), await cap.limit(tier, context)] as const,
93
+ caps.map(async (cap) => {
94
+ if (cap.limitBatch) {
95
+ const batch = await cap.limitBatch(limitTenants, db);
96
+ return limitTenants.map(
97
+ ({ tenantId }) => [tenantCapKey(tenantId, cap.id), batch.get(tenantId) ?? null] as const,
98
+ );
99
+ }
100
+ return Promise.all(
101
+ limitTenants.map(async ({ tier, ...tenantContext }) => {
102
+ const context: CapSpecLimitContext = { ...tenantContext, db };
103
+ return [
104
+ tenantCapKey(tenantContext.tenantId, cap.id),
105
+ await cap.limit(tier, context),
106
+ ] as const;
107
+ }),
92
108
  );
93
109
  }),
94
110
  );
95
- return new Map(entries);
111
+ return new Map(entries.flat());
96
112
  }
97
113
 
98
114
  // tier is a plain string with no defined ordering — lt/gt have no meaning
@@ -17,6 +17,7 @@ export const CAP_OVERVIEW_I18N: Readonly<Record<string, LocalizedString>> = {
17
17
  "cap-overview.cards.viewAll": { en: "View all usage" },
18
18
  "cap-overview.notMeasured": { en: "Not measured yet" },
19
19
  "cap-overview.notIncluded": { en: "Not included" },
20
+ "cap-overview.notIncludedButUsed": { en: "{used} · not included" },
20
21
  "cap-overview.unlimited": { en: "{used} · unlimited" },
21
22
  "cap-overview.errors.progressPrimitiveMissing": {
22
23
  en: "Usage bar unavailable — Progress primitive is not registered.",
@@ -10,6 +10,7 @@ export {
10
10
  export type {
11
11
  CapSpec,
12
12
  CapSpecLimitContext,
13
+ CapSpecLimitTenant,
13
14
  CapUsage,
14
15
  CapUsageTone,
15
16
  CapUsageWithMeta,
@@ -17,6 +17,8 @@ export type CapSpecLimitContext = CapLimitContext & {
17
17
  readonly db: TenantDb;
18
18
  };
19
19
 
20
+ export type CapSpecLimitTenant = Omit<CapSpecLimitContext, "db"> & { readonly tier: string };
21
+
20
22
  // Consumer-owned cap definition. `usage`/`usageBatch` receive the SAME
21
23
  // unfiltered system-mode TenantDb the handler itself reads through — the
22
24
  // callback is responsible for scoping its own app-owned tables by tenantId,
@@ -27,11 +29,19 @@ export type CapSpec = {
27
29
  readonly label: string;
28
30
  // `null` = unlimited (a pure usage meter: counted but never capped).
29
31
  // `<= 0` = not part of this tier — existing, unchanged meaning (usage-math.ts).
30
- // Resolved once per (cap, tier) per request, so a config read here is cheap.
32
+ // Resolved per (cap, tenant), so a list of N tenants calls it N times; a limit that reads
33
+ // app rows from `context.db` should also provide `limitBatch` for the list.
31
34
  readonly limit: (
32
35
  tier: string,
33
36
  context: CapSpecLimitContext,
34
37
  ) => number | null | Promise<number | null>;
38
+ // Batched `limit` for the tenant-caps:list screen: called once per cap with the page's
39
+ // tenants. Optional: falls back to per-tenant `limit()`. A tenant absent from the returned
40
+ // map counts as unlimited (`null`).
41
+ readonly limitBatch?: (
42
+ tenants: readonly CapSpecLimitTenant[],
43
+ db: TenantDb,
44
+ ) => Promise<ReadonlyMap<TenantId, number | null>>;
35
45
  // `null` means "no measurement exists yet for this cap" (not "0 used") —
36
46
  // callers that haven't wired up instrumentation return null instead of a
37
47
  // number they don't actually have.
@@ -19,7 +19,7 @@ import type { CapIconKey, CapUnit, CapUsageTone, CapUsageWithMeta } from "../typ
19
19
  import { formatCapAmount, formatCapUsedOfLimit } from "./cap-amount-format.ts";
20
20
  import { CapUsageBar } from "./cap-usage-bar.tsx";
21
21
  import { CapOverviewQueries, MY_CAPS_SCREEN_ID } from "./constants.ts";
22
- import { isCapNotIncluded } from "./usage-math.ts";
22
+ import { isCapNotIncluded, isCapUsedWithoutAllowance } from "./usage-math.ts";
23
23
 
24
24
  type CapsUsageResponse = { readonly rows: readonly CapUsageWithMeta[] };
25
25
 
@@ -133,7 +133,11 @@ function CapUsageStat({
133
133
  label={t(cap.label)}
134
134
  value={
135
135
  notIncluded
136
- ? t("cap-overview.notIncluded")
136
+ ? isCapUsedWithoutAllowance(cap.limit, cap.used)
137
+ ? t("cap-overview.notIncludedButUsed", {
138
+ used: formatCapAmount(cap.used ?? 0, cap.unit, locale),
139
+ })
140
+ : t("cap-overview.notIncluded")
137
141
  : !isMeasured(cap)
138
142
  ? EMPTY_VALUE_PLACEHOLDER
139
143
  : cap.limit === null
@@ -2,7 +2,7 @@ import { useLocale, usePrimitives, useTranslation } from "@cosmicdrift/kumiko-re
2
2
  import type { ReactNode } from "react";
3
3
  import type { CapUsage } from "../types.ts";
4
4
  import { formatCapAmount, formatCapUsedOfLimit } from "./cap-amount-format.ts";
5
- import { computeTone, isCapNotIncluded } from "./usage-math.ts";
5
+ import { computeTone, isCapNotIncluded, isCapUsedWithoutAllowance } from "./usage-math.ts";
6
6
 
7
7
  export function CapUsageBar({
8
8
  usage,
@@ -18,6 +18,15 @@ export function CapUsageBar({
18
18
  const locale = useLocale().locale();
19
19
 
20
20
  if (isCapNotIncluded(usage.limit)) {
21
+ if (isCapUsedWithoutAllowance(usage.limit, usage.used)) {
22
+ return (
23
+ <Text variant="small" testId="cap-usage-not-included-used">
24
+ {t("cap-overview.notIncludedButUsed", {
25
+ used: formatCapAmount(usage.used ?? 0, usage.unit, locale),
26
+ })}
27
+ </Text>
28
+ );
29
+ }
21
30
  return (
22
31
  <Text variant="small" testId="cap-usage-not-included">
23
32
  {t("cap-overview.notIncluded")}
@@ -12,6 +12,11 @@ export function isCapNotIncluded(limit: number | null): boolean {
12
12
  return limit !== null && limit <= 0;
13
13
  }
14
14
 
15
+ // Leftover data after a downgrade: the tier grants nothing, yet usage is above zero.
16
+ export function isCapUsedWithoutAllowance(limit: number | null, used: number | null): boolean {
17
+ return isCapNotIncluded(limit) && used !== null && used > 0;
18
+ }
19
+
15
20
  function rawFraction(used: number, limit: number | null): number {
16
21
  if (limit === null) return 0;
17
22
  if (isCapNotIncluded(limit)) return 0;
@@ -1,4 +1,10 @@
1
1
  [
2
+ {
3
+ "version": "0.414.0",
4
+ "type": "improvement",
5
+ "title": "readStateByKeys is readable by a job's system user",
6
+ "detail": "`channel-in-app:query:readStateByKeys` now accepts the `system` role besides SystemAdmin, so a job running as the system user of a tenant reads the read state of its own tenant's messages directly. It still sees only keys of the caller's tenant."
7
+ },
2
8
  {
3
9
  "version": "0.409.0",
4
10
  "type": "improvement",
@@ -14,9 +14,9 @@ type MessageRow = {
14
14
  export const readStateByKeysQuery = defineQueryHandler({
15
15
  name: "readStateByKeys",
16
16
  schema: z.object({ keys: z.array(z.string().min(1).max(256)).min(1).max(MAX_KEYS) }).strict(),
17
- access: { roles: access.systemAdmin },
17
+ access: { roles: access.privileged },
18
18
  description:
19
- "Returns when the in-app message sent under each given notify() idempotency key was read (null while unread), within the caller's tenant and without any message content; a SystemAdmin queries the recipient's tenant by acting as a system user of it. Use it to show whether a recipient has seen a notification a feature sent under a known key.",
19
+ "Returns when the in-app message sent under each given notify() idempotency key was read (null while unread), within the caller's tenant and without any message content; a job's system user reads its own tenant directly, a SystemAdmin queries the recipient's tenant by acting as a system user of it. Use it to show whether a recipient has seen a notification a feature sent under a known key.",
20
20
  handler: async (query, ctx) => {
21
21
  const rows = await selectMany<MessageRow>(
22
22
  ctx.db,
@@ -0,0 +1,29 @@
1
+ import { v5 as uuidv5 } from "uuid";
2
+ import type { WhatsappStatusKind } from "./constants.ts";
3
+
4
+ const UNRECOGNISED_STATUS: WhatsappStatusKind = "other";
5
+
6
+ // Fixed namespaces, generated once and immutable: changing one re-keys every existing
7
+ // stream and breaks the dedupe of redelivered webhooks.
8
+ const MESSAGE_NAMESPACE = "3e6a1b94-7d2c-4f58-a0c3-91e4b5d27f08";
9
+ const STATUS_NAMESPACE = "8b0f4d27-61a9-4c3e-b7d5-2a9e0c14f6b3";
10
+
11
+ /** One stream per (tenant, wamid): a redelivered message lands on the stream that already exists. */
12
+ export function whatsappMessageAggregateId(tenantId: string, wamid: string): string {
13
+ return uuidv5(`${tenantId}:${wamid}`, MESSAGE_NAMESPACE);
14
+ }
15
+
16
+ /**
17
+ * One stream per (tenant, wamid, status): Meta reports each status of a sent message once.
18
+ * An unrecognised status is keyed by Meta's own word so different new statuses do not collide.
19
+ */
20
+ export function whatsappStatusAggregateId(
21
+ tenantId: string,
22
+ wamid: string,
23
+ status: WhatsappStatusKind,
24
+ rawStatus: string | null = null,
25
+ ): string {
26
+ const key =
27
+ status === UNRECOGNISED_STATUS && rawStatus !== null && rawStatus !== "" ? rawStatus : status;
28
+ return uuidv5(`${tenantId}:${wamid}:${key}`, STATUS_NAMESPACE);
29
+ }
@@ -0,0 +1,8 @@
1
+ [
2
+ {
3
+ "version": "0.414.0",
4
+ "type": "improvement",
5
+ "title": "WhatsApp Business channel with signed webhook, send API and media loading",
6
+ "detail": "`createChannelWhatsappFeature(opts)` plus `createWhatsappWebhookRoutes()` take Meta's signed webhooks per tenant (`/api/channel-whatsapp/webhook/:tenantId`, verify handshake and HMAC-SHA256 signature, identical 401 on every auth failure) and store `message-received`, `status-updated` and `throttled` events; sender, text and button payload are tenant-key ciphertext and a redelivered wamid is stored once. A per-sender limit runs inside the inbound handler. `createWhatsappClient(opts)` sends text, templates, buttons and images and loads media, with the Graph URL checked against `allowedHosts` before the token goes out. `createInMemoryMeta()` is the test stand-in. Guide: `docs/guides/whatsapp-channel.md`."
7
+ }
8
+ ]
@@ -0,0 +1,46 @@
1
+ export const CHANNEL_WHATSAPP_FEATURE = "channel-whatsapp";
2
+
3
+ export const WHATSAPP_SECRET_KEYS = {
4
+ accessToken: `${CHANNEL_WHATSAPP_FEATURE}:secret:access-token`,
5
+ appSecret: `${CHANNEL_WHATSAPP_FEATURE}:secret:app-secret`,
6
+ verifyToken: `${CHANNEL_WHATSAPP_FEATURE}:secret:verify-token`,
7
+ } as const;
8
+
9
+ export const WhatsappHandlers = {
10
+ receiveMessage: `${CHANNEL_WHATSAPP_FEATURE}:write:receive-message`,
11
+ recordStatus: `${CHANNEL_WHATSAPP_FEATURE}:write:record-status`,
12
+ } as const;
13
+
14
+ export const WHATSAPP_DEFAULT_API_BASE_URL = "https://graph.facebook.com";
15
+ export const WHATSAPP_DEFAULT_API_VERSION = "v21.0";
16
+ // Meta serves media downloads from lookaside.fbsbx.com, not from the Graph host.
17
+ export const WHATSAPP_DEFAULT_ALLOWED_HOSTS: readonly string[] = [
18
+ "graph.facebook.com",
19
+ "lookaside.fbsbx.com",
20
+ ];
21
+ export const WHATSAPP_DEFAULT_TIMEOUT_MS = 10_000;
22
+ export const WHATSAPP_DEFAULT_MEDIA_MAX_BYTES = 25 * 1024 * 1024;
23
+
24
+ export const WHATSAPP_DEFAULT_WEBHOOK_PATH = "/api/channel-whatsapp/webhook/:tenantId";
25
+
26
+ // Graph error code for a free-form message outside the 24h customer-service window.
27
+ export const WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE = 131047;
28
+
29
+ export const WHATSAPP_MESSAGE_TYPES = [
30
+ "text",
31
+ "audio",
32
+ "image",
33
+ "interactive_button",
34
+ "other",
35
+ ] as const;
36
+ export type WhatsappMessageType = (typeof WHATSAPP_MESSAGE_TYPES)[number];
37
+
38
+ export const WHATSAPP_STATUS_KINDS = ["sent", "delivered", "read", "failed", "other"] as const;
39
+ export type WhatsappStatusKind = (typeof WHATSAPP_STATUS_KINDS)[number];
40
+
41
+ // Meta's documented body limits; the normalizer clips to them so an oversized value
42
+ // never turns into a permanently failing dispatch.
43
+ export const WHATSAPP_TEXT_MAX_CHARS = 4096;
44
+ export const WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS = 256;
45
+ export const WHATSAPP_BUTTON_TITLE_MAX_CHARS = 20;
46
+ export const WHATSAPP_MAX_REPLY_BUTTONS = 3;
@@ -0,0 +1,93 @@
1
+ import { piiCiphertextMaxLengthFor } from "@cosmicdrift/kumiko-framework/crypto";
2
+ import * as z from "zod";
3
+ import {
4
+ CHANNEL_WHATSAPP_FEATURE,
5
+ WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS,
6
+ WHATSAPP_MESSAGE_TYPES,
7
+ WHATSAPP_STATUS_KINDS,
8
+ WHATSAPP_TEXT_MAX_CHARS,
9
+ } from "./constants.ts";
10
+
11
+ export const WHATSAPP_MESSAGE_AGGREGATE_TYPE = "whatsapp-message" as const;
12
+ export const WHATSAPP_STATUS_AGGREGATE_TYPE = "whatsapp-status" as const;
13
+
14
+ export const WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT = "message-received" as const;
15
+ export const WHATSAPP_STATUS_UPDATED_EVENT_SHORT = "status-updated" as const;
16
+ export const WHATSAPP_THROTTLED_EVENT_SHORT = "throttled" as const;
17
+
18
+ export const WHATSAPP_MESSAGE_RECEIVED_EVENT_QN =
19
+ `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT}` as const;
20
+ export const WHATSAPP_STATUS_UPDATED_EVENT_QN =
21
+ `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_STATUS_UPDATED_EVENT_SHORT}` as const;
22
+ export const WHATSAPP_THROTTLED_EVENT_QN =
23
+ `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_THROTTLED_EVENT_SHORT}` as const;
24
+
25
+ const E164_MAX_CHARS = 32;
26
+ const WAMID_MAX_CHARS = 256;
27
+ const PHONE_NUMBER_ID_MAX_CHARS = 64;
28
+ export const RAW_STATUS_MAX_CHARS = 64;
29
+
30
+ // What the webhook route hands to the write handlers: normalized, still plaintext.
31
+ export const receiveMessageInputSchema = z.object({
32
+ phoneNumberId: z.string().min(1).max(PHONE_NUMBER_ID_MAX_CHARS),
33
+ wamid: z.string().min(1).max(WAMID_MAX_CHARS),
34
+ from: z.string().min(1).max(E164_MAX_CHARS),
35
+ timestampIso: z.string().min(1),
36
+ messageType: z.enum(WHATSAPP_MESSAGE_TYPES),
37
+ text: z.string().max(WHATSAPP_TEXT_MAX_CHARS).nullable(),
38
+ buttonPayload: z.string().max(WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS).nullable(),
39
+ contextWamid: z.string().max(WAMID_MAX_CHARS).nullable(),
40
+ mediaId: z.string().max(WAMID_MAX_CHARS).nullable(),
41
+ mimeType: z.string().max(255).nullable(),
42
+ });
43
+ export type ReceiveMessageInput = z.infer<typeof receiveMessageInputSchema>;
44
+
45
+ export const recordStatusInputSchema = z.object({
46
+ phoneNumberId: z.string().min(1).max(PHONE_NUMBER_ID_MAX_CHARS),
47
+ wamid: z.string().min(1).max(WAMID_MAX_CHARS),
48
+ status: z.enum(WHATSAPP_STATUS_KINDS),
49
+ // Meta's own status word; only keys the stream of an unrecognised status, never stored in the event.
50
+ rawStatus: z.string().max(RAW_STATUS_MAX_CHARS).nullable(),
51
+ timestampIso: z.string().min(1),
52
+ recipient: z.string().min(1).max(E164_MAX_CHARS),
53
+ errorCode: z.number().int().nullable(),
54
+ });
55
+ export type RecordStatusInput = z.infer<typeof recordStatusInputSchema>;
56
+
57
+ // Event payloads: sender and recipient numbers, message text and button payloads are
58
+ // PII and stored as tenant-key ciphertext (see pii.ts).
59
+ export const messageReceivedPayloadSchema = z.object({
60
+ phoneNumberId: receiveMessageInputSchema.shape.phoneNumberId,
61
+ wamid: receiveMessageInputSchema.shape.wamid,
62
+ from: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
63
+ timestampIso: z.string().min(1),
64
+ messageType: receiveMessageInputSchema.shape.messageType,
65
+ text: z.string().max(piiCiphertextMaxLengthFor(WHATSAPP_TEXT_MAX_CHARS)).nullable(),
66
+ buttonPayload: z
67
+ .string()
68
+ .max(piiCiphertextMaxLengthFor(WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS))
69
+ .nullable(),
70
+ contextWamid: receiveMessageInputSchema.shape.contextWamid,
71
+ mediaId: receiveMessageInputSchema.shape.mediaId,
72
+ mimeType: receiveMessageInputSchema.shape.mimeType,
73
+ });
74
+ export type MessageReceivedPayload = z.infer<typeof messageReceivedPayloadSchema>;
75
+
76
+ export const statusUpdatedPayloadSchema = z.object({
77
+ phoneNumberId: recordStatusInputSchema.shape.phoneNumberId,
78
+ wamid: recordStatusInputSchema.shape.wamid,
79
+ status: recordStatusInputSchema.shape.status,
80
+ timestampIso: z.string().min(1),
81
+ recipient: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
82
+ errorCode: recordStatusInputSchema.shape.errorCode,
83
+ });
84
+ export type StatusUpdatedPayload = z.infer<typeof statusUpdatedPayloadSchema>;
85
+
86
+ export const throttledPayloadSchema = z.object({
87
+ phoneNumberId: receiveMessageInputSchema.shape.phoneNumberId,
88
+ wamid: receiveMessageInputSchema.shape.wamid,
89
+ from: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
90
+ timestampIso: z.string().min(1),
91
+ retryAfterSeconds: z.number().int().min(0),
92
+ });
93
+ export type ThrottledPayload = z.infer<typeof throttledPayloadSchema>;
@@ -0,0 +1,72 @@
1
+ import { defineFeature, type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
2
+ import * as z from "zod";
3
+ import { CHANNEL_WHATSAPP_FEATURE } from "./constants.ts";
4
+ import {
5
+ messageReceivedPayloadSchema,
6
+ statusUpdatedPayloadSchema,
7
+ throttledPayloadSchema,
8
+ WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT,
9
+ WHATSAPP_STATUS_UPDATED_EVENT_SHORT,
10
+ WHATSAPP_THROTTLED_EVENT_SHORT,
11
+ } from "./events.ts";
12
+ import { createReceiveMessageHandler, createRecordStatusHandler } from "./inbound-handlers.ts";
13
+ import { type ChannelWhatsappOptions, resolveWhatsappOptions } from "./options.ts";
14
+
15
+ const MAX_SECRET_CHARS = 512;
16
+ const secretValueSchema = z.string().min(1).max(MAX_SECRET_CHARS);
17
+
18
+ export function createChannelWhatsappFeature(
19
+ options: ChannelWhatsappOptions = {},
20
+ ): FeatureDefinition {
21
+ const resolved = resolveWhatsappOptions(options);
22
+ return defineFeature(CHANNEL_WHATSAPP_FEATURE, (r) => {
23
+ r.describe(
24
+ "WhatsApp Business (Meta Cloud API) as a two-way channel, not a delivery channel. Inbound: mount `createWhatsappWebhookRoutes()` via `extraRoutes` (default path `/api/channel-whatsapp/webhook/:tenantId`, the tenant id is part of the URL because the secrets are tenant-scoped); GET answers Meta's `hub.challenge` handshake, POST checks `X-Hub-Signature-256` over the raw body and normalizes each message and status. Events: `channel-whatsapp:event:message-received` (sender, wamid, type text|audio|image|interactive_button|other, text, button payload, `contextWamid`, media id and mime type, `phoneNumberId`), `status-updated` (sent|delivered|read|failed|other) and `throttled` (sender over the per-number limit). Sender number, text, button payload and status recipient are PII, stored as tenant-key ciphertext; read them with `readWhatsappMessagePii`. A redelivered wamid is stored once and answered 200; a failed dispatch answers 500 so Meta redelivers. Outbound: `createWhatsappClient(opts)` gives `sendText`, `sendTemplate`, `sendButtons`, `sendMedia` (each takes the sending `phoneNumberId` and answers `{ ok: true, wamid }` or a typed failure) and `fetchMedia` (media id to bytes and mime type; the URL from the Graph answer is checked against `allowedHosts` before the token is sent). Tenant secrets `channel-whatsapp:secret:access-token`, `app-secret` and `verify-token`. App options of `createChannelWhatsappFeature(opts)`: `apiBaseUrl`, `apiVersion` (default v21.0), `allowedHosts` (default graph.facebook.com and lookaside.fbsbx.com), `requireHttps` (default true; boot fails on a mismatch), `timeoutMs`, `mediaMaxBytes`, `transport` (in-memory Meta for tests), `senderRateLimits` (default 30 per hour and 200 per day per sender and tenant) and `rateLimit` (flood guard of the inbound handlers; cannot be disabled while a sender limit is set). Requires `secrets`. A worker-run job triggered by `message-received` attaches the business process.",
25
+ );
26
+ r.uiHints({
27
+ displayLabel: "WhatsApp Channel",
28
+ category: "notifications",
29
+ recommended: false,
30
+ });
31
+ r.requires({ features: ["secrets"] });
32
+
33
+ r.secret("accessToken", {
34
+ label: { en: "WhatsApp access token" },
35
+ hint: {
36
+ en: "System-user access token of the Meta app. Used to send messages and to download media.",
37
+ },
38
+ redact: () => "••••••••",
39
+ scope: "tenant",
40
+ valueSchema: secretValueSchema,
41
+ });
42
+ r.secret("appSecret", {
43
+ label: { en: "WhatsApp app secret" },
44
+ hint: { en: "App secret of the Meta app. Verifies the signature of every incoming webhook." },
45
+ redact: () => "••••••••",
46
+ scope: "tenant",
47
+ valueSchema: secretValueSchema,
48
+ });
49
+ r.secret("verifyToken", {
50
+ label: { en: "WhatsApp verify token" },
51
+ hint: {
52
+ en: "Any string you also enter in the Meta webhook settings; answers Meta's subscription handshake.",
53
+ },
54
+ redact: () => "••••••••",
55
+ scope: "tenant",
56
+ valueSchema: secretValueSchema,
57
+ });
58
+
59
+ r.defineEvent(WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT, messageReceivedPayloadSchema, {
60
+ piiFields: "none",
61
+ });
62
+ r.defineEvent(WHATSAPP_STATUS_UPDATED_EVENT_SHORT, statusUpdatedPayloadSchema, {
63
+ piiFields: "none",
64
+ });
65
+ r.defineEvent(WHATSAPP_THROTTLED_EVENT_SHORT, throttledPayloadSchema, {
66
+ piiFields: "none",
67
+ });
68
+
69
+ r.writeHandler(createReceiveMessageHandler(resolved));
70
+ r.writeHandler(createRecordStatusHandler(resolved));
71
+ });
72
+ }