@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
@@ -0,0 +1,226 @@
1
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
2
+ import * as z from "zod";
3
+ import {
4
+ WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS,
5
+ WHATSAPP_STATUS_KINDS,
6
+ WHATSAPP_TEXT_MAX_CHARS,
7
+ type WhatsappStatusKind,
8
+ } from "./constants.ts";
9
+ import {
10
+ RAW_STATUS_MAX_CHARS,
11
+ type ReceiveMessageInput,
12
+ type RecordStatusInput,
13
+ } from "./events.ts";
14
+
15
+ // Meta adds fields and message types without notice. Every nested object is `.catch(undefined)`,
16
+ // so one unexpected shape costs that detail and not the whole message.
17
+ const mediaSchema = z.object({ id: z.string().optional(), mime_type: z.string().optional() });
18
+ const messageSchema = z.object({
19
+ id: z.string().min(1),
20
+ from: z.string(),
21
+ timestamp: z.string().optional(),
22
+ type: z.string().optional(),
23
+ text: z.object({ body: z.string() }).optional().catch(undefined),
24
+ audio: mediaSchema.optional().catch(undefined),
25
+ image: mediaSchema.optional().catch(undefined),
26
+ interactive: z
27
+ .object({
28
+ button_reply: z
29
+ .object({ id: z.string(), title: z.string().optional() })
30
+ .optional()
31
+ .catch(undefined),
32
+ })
33
+ .optional()
34
+ .catch(undefined),
35
+ button: z
36
+ .object({ payload: z.string().optional(), text: z.string().optional() })
37
+ .optional()
38
+ .catch(undefined),
39
+ context: z.object({ id: z.string().optional() }).optional().catch(undefined),
40
+ });
41
+ type MetaMessage = z.infer<typeof messageSchema>;
42
+
43
+ const statusSchema = z.object({
44
+ id: z.string().min(1),
45
+ status: z.string().optional(),
46
+ timestamp: z.string().optional(),
47
+ recipient_id: z.string().optional(),
48
+ errors: z
49
+ .array(z.object({ code: z.number().optional() }))
50
+ .optional()
51
+ .catch(undefined),
52
+ });
53
+ type MetaStatus = z.infer<typeof statusSchema>;
54
+
55
+ const changeValueSchema = z.object({
56
+ metadata: z.object({ phone_number_id: z.string().optional() }).optional().catch(undefined),
57
+ messages: z.array(z.unknown()).optional().catch(undefined),
58
+ statuses: z.array(z.unknown()).optional().catch(undefined),
59
+ });
60
+
61
+ const webhookSchema = z.object({
62
+ entry: z
63
+ .array(
64
+ z.object({
65
+ changes: z
66
+ .array(z.object({ value: changeValueSchema.optional().catch(undefined) }))
67
+ .optional()
68
+ .catch(undefined),
69
+ }),
70
+ )
71
+ .optional()
72
+ .catch(undefined),
73
+ });
74
+
75
+ export type NormalizedWebhook = {
76
+ readonly messages: readonly ReceiveMessageInput[];
77
+ readonly statuses: readonly RecordStatusInput[];
78
+ // Entries that carried no usable id, sender or phone number id; nothing a redelivery could fix.
79
+ readonly skipped: number;
80
+ };
81
+
82
+ const DIGITS_PATTERN = /^\d{5,20}$/;
83
+
84
+ function toE164(raw: string): string | null {
85
+ const digits = raw.replace(/^\+/, "");
86
+ return DIGITS_PATTERN.test(digits) ? `+${digits}` : null;
87
+ }
88
+
89
+ function toIso(unixSeconds: string | undefined, fallbackIso: string): string {
90
+ const seconds = Number(unixSeconds);
91
+ return unixSeconds !== undefined && Number.isFinite(seconds) && seconds > 0
92
+ ? Temporal.Instant.fromEpochMilliseconds(Math.floor(seconds) * 1000).toString()
93
+ : fallbackIso;
94
+ }
95
+
96
+ function clip(value: string, maxChars: number): string {
97
+ return value.length > maxChars ? value.slice(0, maxChars) : value;
98
+ }
99
+
100
+ type MessageContent = Pick<
101
+ ReceiveMessageInput,
102
+ "messageType" | "text" | "buttonPayload" | "mediaId" | "mimeType"
103
+ >;
104
+
105
+ const NO_CONTENT = { text: null, buttonPayload: null, mediaId: null, mimeType: null };
106
+
107
+ function optionalClip(value: string | undefined, maxChars: number): string | null {
108
+ return value === undefined ? null : clip(value, maxChars);
109
+ }
110
+
111
+ function buttonContentOf(message: MetaMessage): MessageContent | null {
112
+ const reply = message.interactive?.button_reply;
113
+ if (message.type === "interactive" && reply) {
114
+ return {
115
+ ...NO_CONTENT,
116
+ messageType: "interactive_button",
117
+ text: optionalClip(reply.title, WHATSAPP_TEXT_MAX_CHARS),
118
+ buttonPayload: clip(reply.id, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS),
119
+ };
120
+ }
121
+ // Quick-reply buttons of a template arrive as type "button".
122
+ if (message.type === "button" && message.button?.payload !== undefined) {
123
+ return {
124
+ ...NO_CONTENT,
125
+ messageType: "interactive_button",
126
+ text: optionalClip(message.button.text, WHATSAPP_TEXT_MAX_CHARS),
127
+ buttonPayload: clip(message.button.payload, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS),
128
+ };
129
+ }
130
+ return null;
131
+ }
132
+
133
+ function mediaContentOf(message: MetaMessage): MessageContent | null {
134
+ if (message.type !== "audio" && message.type !== "image") return null;
135
+ const media = message.type === "audio" ? message.audio : message.image;
136
+ if (!media) return null;
137
+ return {
138
+ ...NO_CONTENT,
139
+ messageType: message.type,
140
+ mediaId: media.id ?? null,
141
+ mimeType: media.mime_type ?? null,
142
+ };
143
+ }
144
+
145
+ function contentOf(message: MetaMessage): MessageContent {
146
+ if (message.type === "text" && message.text) {
147
+ return {
148
+ ...NO_CONTENT,
149
+ messageType: "text",
150
+ text: clip(message.text.body, WHATSAPP_TEXT_MAX_CHARS),
151
+ };
152
+ }
153
+ return (
154
+ buttonContentOf(message) ?? mediaContentOf(message) ?? { ...NO_CONTENT, messageType: "other" }
155
+ );
156
+ }
157
+
158
+ function normalizeMessage(
159
+ raw: unknown,
160
+ phoneNumberId: string,
161
+ nowIso: string,
162
+ ): ReceiveMessageInput | null {
163
+ const parsed = messageSchema.safeParse(raw);
164
+ if (!parsed.success) return null;
165
+ const message = parsed.data;
166
+ const from = toE164(message.from);
167
+ if (from === null) return null;
168
+ return {
169
+ phoneNumberId,
170
+ wamid: message.id,
171
+ from,
172
+ timestampIso: toIso(message.timestamp, nowIso),
173
+ contextWamid: message.context?.id ?? null,
174
+ ...contentOf(message),
175
+ };
176
+ }
177
+
178
+ function statusKindOf(raw: string | undefined): WhatsappStatusKind {
179
+ return WHATSAPP_STATUS_KINDS.find((kind) => kind === raw) ?? "other";
180
+ }
181
+
182
+ function normalizeStatus(
183
+ raw: unknown,
184
+ phoneNumberId: string,
185
+ nowIso: string,
186
+ ): RecordStatusInput | null {
187
+ const parsed = statusSchema.safeParse(raw);
188
+ if (!parsed.success) return null;
189
+ const status: MetaStatus = parsed.data;
190
+ const recipient = toE164(status.recipient_id ?? "");
191
+ if (recipient === null) return null;
192
+ return {
193
+ phoneNumberId,
194
+ wamid: status.id,
195
+ status: statusKindOf(status.status),
196
+ rawStatus: status.status === undefined ? null : clip(status.status, RAW_STATUS_MAX_CHARS),
197
+ timestampIso: toIso(status.timestamp, nowIso),
198
+ recipient,
199
+ errorCode: status.errors?.[0]?.code ?? null,
200
+ };
201
+ }
202
+
203
+ export function normalizeWhatsappWebhook(body: unknown, nowIso: string): NormalizedWebhook {
204
+ const parsed = webhookSchema.safeParse(body);
205
+ const messages: ReceiveMessageInput[] = [];
206
+ const statuses: RecordStatusInput[] = [];
207
+ let skipped = 0;
208
+ if (!parsed.success) return { messages, statuses, skipped };
209
+ for (const entry of parsed.data.entry ?? []) {
210
+ for (const change of entry.changes ?? []) {
211
+ const value = change.value;
212
+ const phoneNumberId = value?.metadata?.phone_number_id;
213
+ for (const raw of value?.messages ?? []) {
214
+ const normalized = phoneNumberId ? normalizeMessage(raw, phoneNumberId, nowIso) : null;
215
+ if (normalized) messages.push(normalized);
216
+ else skipped += 1;
217
+ }
218
+ for (const raw of value?.statuses ?? []) {
219
+ const normalized = phoneNumberId ? normalizeStatus(raw, phoneNumberId, nowIso) : null;
220
+ if (normalized) statuses.push(normalized);
221
+ else skipped += 1;
222
+ }
223
+ }
224
+ }
225
+ return { messages, statuses, skipped };
226
+ }
@@ -0,0 +1,185 @@
1
+ import {
2
+ type ExtraRouteDefinition,
3
+ ExtraRouteRejection,
4
+ type SignatureExtraRouteDeps,
5
+ signatureRoute,
6
+ } from "@cosmicdrift/kumiko-framework/api";
7
+ import type { TenantId } from "@cosmicdrift/kumiko-types/identifiers";
8
+ import { parseTenantId, SYSTEM_USER_ID } from "@cosmicdrift/kumiko-types/identifiers";
9
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
10
+ import type { Context } from "hono";
11
+ import {
12
+ CHANNEL_WHATSAPP_FEATURE,
13
+ WHATSAPP_DEFAULT_WEBHOOK_PATH,
14
+ WHATSAPP_SECRET_KEYS,
15
+ WhatsappHandlers,
16
+ } from "./constants.ts";
17
+ import { isValidMetaSignature, secretsMatch } from "./meta-signature.ts";
18
+ import { normalizeWhatsappWebhook } from "./webhook-normalize.ts";
19
+
20
+ export type WhatsappWebhookRouteOptions = {
21
+ /** Route path; MUST carry `:tenantId`. The secrets are tenant-scoped, so the tenant is part of the URL. */
22
+ readonly path?: string;
23
+ };
24
+
25
+ type Verified =
26
+ | { readonly kind: "challenge"; readonly challenge: string }
27
+ | { readonly kind: "webhook"; readonly tenantId: TenantId; readonly body: unknown };
28
+
29
+ const MAX_CHALLENGE_CHARS = 512;
30
+ const AUDIT_HANDLER = `${CHANNEL_WHATSAPP_FEATURE}:webhook`;
31
+
32
+ // Every authentication failure is a plain throw: the framework answers all of them with the
33
+ // same 401 body, so a caller cannot tell a bad tenant id, an unknown tenant, a missing secret
34
+ // and a wrong signature apart.
35
+ class WebhookAuthError extends Error {}
36
+
37
+ async function readTenantSecret(
38
+ deps: Pick<SignatureExtraRouteDeps, "secrets">,
39
+ tenantIdParam: string | undefined,
40
+ key: string,
41
+ ): Promise<{ readonly tenantId: TenantId; readonly secret: string }> {
42
+ const tenantId = parseTenantId(tenantIdParam);
43
+ if (tenantId === null) throw new WebhookAuthError("invalid tenant id");
44
+ const revealed = await deps.secrets?.get(tenantId, key, {
45
+ userId: SYSTEM_USER_ID,
46
+ handlerName: AUDIT_HANDLER,
47
+ });
48
+ const secret = revealed?.reveal();
49
+ if (secret === undefined || secret === "") throw new WebhookAuthError("no secret");
50
+ return { tenantId, secret };
51
+ }
52
+
53
+ async function verifyChallenge(
54
+ deps: Pick<SignatureExtraRouteDeps, "secrets">,
55
+ params: Readonly<Record<string, string>>,
56
+ query: Readonly<Record<string, string>>,
57
+ ): Promise<Verified> {
58
+ const { secret } = await readTenantSecret(
59
+ deps,
60
+ params["tenantId"],
61
+ WHATSAPP_SECRET_KEYS.verifyToken,
62
+ );
63
+ const challenge = query["hub.challenge"];
64
+ const token = query["hub.verify_token"];
65
+ if (
66
+ query["hub.mode"] !== "subscribe" ||
67
+ token === undefined ||
68
+ !secretsMatch(token, secret) ||
69
+ challenge === undefined ||
70
+ challenge === "" ||
71
+ challenge.length > MAX_CHALLENGE_CHARS
72
+ ) {
73
+ throw new WebhookAuthError("verification failed");
74
+ }
75
+ return { kind: "challenge", challenge };
76
+ }
77
+
78
+ async function verifySignedWebhook(
79
+ deps: Pick<SignatureExtraRouteDeps, "secrets">,
80
+ request: {
81
+ readonly rawBody: string;
82
+ readonly headers: Readonly<Record<string, string>>;
83
+ readonly params: Readonly<Record<string, string>>;
84
+ },
85
+ ): Promise<Verified> {
86
+ const { tenantId, secret } = await readTenantSecret(
87
+ deps,
88
+ request.params["tenantId"],
89
+ WHATSAPP_SECRET_KEYS.appSecret,
90
+ );
91
+ if (!isValidMetaSignature(secret, request.rawBody, request.headers["x-hub-signature-256"])) {
92
+ throw new WebhookAuthError("bad signature");
93
+ }
94
+ try {
95
+ return { kind: "webhook", tenantId, body: JSON.parse(request.rawBody) };
96
+ } catch {
97
+ throw new ExtraRouteRejection(400, {
98
+ error: { code: "whatsapp_webhook_invalid_json", message: "body is not JSON" },
99
+ });
100
+ }
101
+ }
102
+
103
+ type DispatchCounts = { stored: number; duplicate: number; throttled: number; failed: number };
104
+
105
+ function outcomeOf(data: unknown): keyof Omit<DispatchCounts, "failed"> {
106
+ const outcome =
107
+ data !== null && typeof data === "object" && "outcome" in data ? data.outcome : undefined;
108
+ return outcome === "duplicate" || outcome === "throttled" ? outcome : "stored";
109
+ }
110
+
111
+ async function processWebhook(
112
+ c: Context,
113
+ verified: Extract<Verified, { kind: "webhook" }>,
114
+ deps: SignatureExtraRouteDeps,
115
+ ): Promise<Response> {
116
+ const { messages, statuses, skipped } = normalizeWhatsappWebhook(
117
+ verified.body,
118
+ Temporal.Now.instant().toString(),
119
+ );
120
+ const counts: DispatchCounts = { stored: 0, duplicate: 0, throttled: 0, failed: 0 };
121
+ const dispatches = [
122
+ ...messages.map((payload) => ({ handlerQn: WhatsappHandlers.receiveMessage, payload })),
123
+ ...statuses.map((payload) => ({ handlerQn: WhatsappHandlers.recordStatus, payload })),
124
+ ];
125
+ // Every item is tried even after a failure: the dedupe makes the redelivery of the
126
+ // already stored ones harmless, and the failed ones get their retry from Meta.
127
+ for (const { handlerQn, payload } of dispatches) {
128
+ const dispatched = await deps.dispatchSystemWrite({
129
+ handlerQn,
130
+ payload,
131
+ tenantId: verified.tenantId,
132
+ });
133
+ if (dispatched.isSuccess) counts[outcomeOf(dispatched.data)] += 1;
134
+ else counts.failed += 1;
135
+ }
136
+ if (counts.failed > 0) {
137
+ return c.json(
138
+ {
139
+ error: {
140
+ code: "whatsapp_webhook_processing_failed",
141
+ message: "Internal error processing the webhook",
142
+ },
143
+ },
144
+ 500,
145
+ );
146
+ }
147
+ return c.json({ ...counts, skipped }, 200);
148
+ }
149
+
150
+ /**
151
+ * The two routes Meta needs: GET answers the subscription handshake (`hub.challenge`), POST takes
152
+ * the signed notifications. Mount via `extraRoutes: createWhatsappWebhookRoutes()`.
153
+ */
154
+ export function createWhatsappWebhookRoutes(
155
+ options: WhatsappWebhookRouteOptions = {},
156
+ ): readonly ExtraRouteDefinition[] {
157
+ const path = options.path ?? WHATSAPP_DEFAULT_WEBHOOK_PATH;
158
+ if (!path.includes(":tenantId")) {
159
+ throw new Error(
160
+ `${CHANNEL_WHATSAPP_FEATURE}: the webhook path must carry a :tenantId segment (the secrets are tenant-scoped)`,
161
+ );
162
+ }
163
+ return [
164
+ signatureRoute<Verified>({
165
+ method: "GET",
166
+ path,
167
+ entry: "signature",
168
+ verify: ({ params, query }, deps) => verifyChallenge(deps, params, query),
169
+ handler: (c, verified) =>
170
+ verified.kind === "challenge"
171
+ ? c.text(verified.challenge, 200)
172
+ : c.json({ error: { code: "whatsapp_webhook_unexpected" } }, 400),
173
+ }),
174
+ signatureRoute<Verified>({
175
+ method: "POST",
176
+ path,
177
+ entry: "signature",
178
+ verify: (request, deps) => verifySignedWebhook(deps, request),
179
+ handler: (c, verified, deps) =>
180
+ verified.kind === "webhook"
181
+ ? processWebhook(c, verified, deps)
182
+ : c.json({ error: { code: "whatsapp_webhook_unexpected" } }, 400),
183
+ }),
184
+ ];
185
+ }
@@ -23,7 +23,7 @@ export const subProcessorsQuery = defineQueryHandler({
23
23
  name: "sub-processors",
24
24
  schema: z.object({}),
25
25
  access: {
26
- roles: ["anonymous", "Member", "User", "TenantAdmin", "SystemAdmin"],
26
+ roles: ["anonymous"],
27
27
  anySignedIn: true,
28
28
  },
29
29
  rateLimit: { per: "ip+handler", limit: 30, windowSeconds: 60 },
@@ -1,4 +1,16 @@
1
1
  [
2
+ {
3
+ "version": "0.414.0",
4
+ "type": "fix",
5
+ "title": "Config values read keeps the declared scope",
6
+ "detail": "config values returns the declared scope on a widened system read."
7
+ },
8
+ {
9
+ "version": "0.414.0",
10
+ "type": "fix",
11
+ "title": "Encrypted keys closed to config validators",
12
+ "detail": "ConfigValidateContext.readCascade refuses encrypted, secrets-backed and piiEncrypted keys with an internal error so a validator cannot echo their plaintext."
13
+ },
2
14
  {
3
15
  "version": "0.389.0",
4
16
  "type": "improvement",
@@ -121,6 +121,13 @@ export const setWrite = defineWriteHandler({
121
121
  message: `[config:write:set] readCascade: unknown config key "${qualifiedKey}"`,
122
122
  });
123
123
  }
124
+ // Validators are free to echo values into error details; plaintext of a stored
125
+ // secret or PII key must never reach the writing admin that way.
126
+ if (isEncryptedAtRest(cascadeKeyDef) || cascadeKeyDef.piiEncrypted) {
127
+ throw new InternalError({
128
+ message: `[config:write:set] readCascade: key "${qualifiedKey}" is encrypted and cannot be read by a validator`,
129
+ });
130
+ }
124
131
  return requireConfigResolver(ctx, "config:write:set").getCascade(
125
132
  qualifiedKey,
126
133
  cascadeKeyDef,
@@ -40,6 +40,7 @@ export const valuesQuery = defineQueryHandler({
40
40
 
41
41
  const allKeys = registry.getAllConfigKeys();
42
42
  const keyDefs = new Map<string, ConfigKeyDefinition>();
43
+ const declaredScopes = new Map<string, ConfigScope>();
43
44
  const filteredKeys: string[] = [];
44
45
  const requestedKeys =
45
46
  query.payload.keys === undefined ? undefined : new Set(query.payload.keys);
@@ -47,6 +48,7 @@ export const valuesQuery = defineQueryHandler({
47
48
  if (requestedKeys !== undefined && !requestedKeys.has(qualifiedKey)) continue;
48
49
  if (!hasConfigAccess(keyDef.access.read, query.user.roles)) continue;
49
50
  keyDefs.set(qualifiedKey, keyDefAtScope(keyDef, query.payload.scope, query.user.roles));
51
+ declaredScopes.set(qualifiedKey, keyDef.scope);
50
52
  filteredKeys.push(qualifiedKey);
51
53
  }
52
54
 
@@ -91,7 +93,12 @@ export const valuesQuery = defineQueryHandler({
91
93
  value = cascade.value;
92
94
  }
93
95
 
94
- result[qualifiedKey] = { value, scope: keyDef.scope, source: cascade.source };
96
+ // The response scope is the key's declared one: a widened read scope must not turn into a write target.
97
+ result[qualifiedKey] = {
98
+ value,
99
+ scope: declaredScopes.get(qualifiedKey) ?? keyDef.scope,
100
+ source: cascade.source,
101
+ };
95
102
  }
96
103
 
97
104
  return result;
@@ -9,6 +9,7 @@ export {
9
9
  createConfigAccessor,
10
10
  createConfigAccessorFactory,
11
11
  createConfigFeature,
12
+ requireConfigResolver,
12
13
  } from "./feature.ts";
13
14
  export type { ReadinessMissingKey, RequiredKeyGate } from "./handlers/readiness.query.ts";
14
15
  export {
@@ -1,3 +1,4 @@
1
+ import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
1
2
  import type {
2
3
  ConfigCascade,
3
4
  ConfigCascadeLevel,
@@ -5,8 +6,6 @@ import type {
5
6
  ConfigValueSource,
6
7
  } from "@cosmicdrift/kumiko-framework/engine";
7
8
 
8
- const SYSTEM_ADMIN_ROLE = "SystemAdmin";
9
-
10
9
  // The viewer's own cascade rungs. Every other rung (system-row, app-override,
11
10
  // computed, default) carries a platform-inherited value — for an
12
11
  // inheritedToTenant:false key those must stay hidden from a tenant-side viewer.
@@ -26,8 +25,12 @@ const OWN_SOURCES: ReadonlySet<ConfigValueSource> = new Set(["user-row", "tenant
26
25
  // for the functional readiness rollup. See readiness.query.ts.
27
26
  export const MASKED = "••••••";
28
27
 
28
+ export function isSystemAdmin(roles: readonly string[]): boolean {
29
+ return roles.includes(ROLES.SystemAdmin);
30
+ }
31
+
29
32
  export function mayViewInheritedValue(roles: readonly string[]): boolean {
30
- return roles.includes(SYSTEM_ADMIN_ROLE);
33
+ return isSystemAdmin(roles);
31
34
  }
32
35
 
33
36
  export function shouldRedactInherited(
@@ -18,6 +18,7 @@ import { createEntity, createTextField } from "@cosmicdrift/kumiko-framework/eng
18
18
  // provides handlers (`reset.write.ts` etc.) with a typed Drizzle table ref.
19
19
  export const configValueEntity = createEntity({
20
20
  table: "read_config_values",
21
+ systemRowsReadable: true,
21
22
  fields: {
22
23
  key: createTextField({ required: true, personal: false, reason: "system_metadata" }),
23
24
  // value is JSON-encoded primitive (or encrypted blob). Nullable so a
@@ -30,6 +30,7 @@ import {
30
30
  } from "@cosmicdrift/kumiko-framework/errors";
31
31
  import type { EnvelopeCipher } from "@cosmicdrift/kumiko-framework/secrets";
32
32
  import { assertUnreachable } from "@cosmicdrift/kumiko-framework/utils";
33
+ import { isSystemAdmin } from "./read-redaction.ts";
33
34
  import { decryptStoredValue } from "./resolver.ts";
34
35
  import { configValuesTable } from "./table.ts";
35
36
  import { ConfigErrors } from "./web/constants.ts";
@@ -182,7 +183,7 @@ export function checkScopeWriteAccess(
182
183
  ): KumikoError | null {
183
184
  if (scope !== ConfigScopes.system) return null;
184
185
  if (userRoles.includes(SYSTEM_ROLE)) return null;
185
- if (userRoles.includes("SystemAdmin")) return null;
186
+ if (isSystemAdmin(userRoles)) return null;
186
187
  return new AccessDeniedError({
187
188
  message: "system-scope config write requires SystemAdmin",
188
189
  i18nKey: "config.errors.systemScopeWriteDenied",
@@ -219,7 +220,7 @@ export function keyDefAtScope(
219
220
  ): ConfigKeyDefinition {
220
221
  if (
221
222
  readScope === undefined ||
222
- !roles.includes("SystemAdmin") ||
223
+ !isSystemAdmin(roles) ||
223
224
  SCOPE_LEVEL[readScope] >= SCOPE_LEVEL[keyDef.scope]
224
225
  ) {
225
226
  return keyDef;
@@ -1,4 +1,22 @@
1
1
  [
2
+ {
3
+ "version": "0.414.0",
4
+ "type": "fix",
5
+ "title": "A failed forget in the after-delete hook keeps its error code and message",
6
+ "detail": "The hook threw forgotten.error, a plain WriteErrorInfo object, so the HTTP layer reported internal_error with the message \"[object Object]\" and no cause, even for a real KMS outage. It now throws reraiseAsKumikoError(forgotten.error). The helpdesk legacy-contact-config job had the same pattern and is fixed the same way."
7
+ },
8
+ {
9
+ "version": "0.414.0",
10
+ "type": "improvement",
11
+ "title": "subjectForgetAfterDeleteHook erases a deleted row's subjects only after the delete is accepted",
12
+ "detail": "`subjectForgetAfterDeleteHook({ target, subjectsOf, reason })` returns a `postDelete` hook (in the delete's transaction) that runs `crypto-shredding:write:forget-subject` as the system identity for the subjects of the row just deleted, in the tenant of the deleted row's event. Because preDelete hooks run after the delete handler returns and a key erase cannot be rolled back, forgetting inside the delete handler erased the key even when a preDelete hook then rejected the delete; the hook runs after all of them, and a failed forget throws and rolls the delete back. Register it with `r.hook(subjectForgetAfterDeleteHook({ target: { allOf: entity }, ... }))`; it declares the narrow `systemIdentity` grant itself. `forget-subject` is an irreversible operation, so the consumer's delete handler (the entry handler) must resolve to agent risk `high`, otherwise the hook fails."
13
+ },
14
+ {
15
+ "version": "0.414.0",
16
+ "type": "fix",
17
+ "title": "forget-subject called from another write handler no longer blocks on the caller's stream",
18
+ "detail": "The audit event and the user login-door close of `forget-subject` were written on the outside-transaction connection with the subject id as aggregate id. When the caller's transaction had already written an event for that id (a delete of the very row), the outside append waited for the uncommitted version and the request hung. Called from another write handler, `forget-subject` still commits the login-door close and the audit event on the outside-transaction connection (the key erase cannot be undone, so they must not roll back with the caller), but the audit event goes onto a fresh aggregate id instead of the subject's id; direct calls (HTTP, agents) are unchanged."
19
+ },
2
20
  {
3
21
  "version": "0.389.0",
4
22
  "type": "improvement",
@@ -1,5 +1,7 @@
1
1
  export const CRYPTO_SHREDDING_FEATURE_NAME = "crypto-shredding";
2
2
 
3
+ export const FORGET_SUBJECT_QUALIFIED_NAME = `${CRYPTO_SHREDDING_FEATURE_NAME}:write:forget-subject`;
4
+
3
5
  export const SUBJECT_FORGOTTEN_EVENT_NAME = "crypto-shredding:event:subject-forgotten";
4
6
  export const SUBJECT_FORGET_DENIED_EVENT_NAME = "crypto-shredding:event:forget-denied";
5
7