@cosmicdrift/kumiko-bundled-features 0.413.1 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (588) hide show
  1. package/dist/admin-shell/feature.js +2 -2
  2. package/dist/agent-tools/agent-doc-lint.js +2 -1
  3. package/dist/agent-tools/agent-manifest.js +33 -25
  4. package/dist/agent-tools/api-docs/collect-events.js +4 -1
  5. package/dist/agent-tools/api-docs/collect.js +3 -3
  6. package/dist/agent-tools/api-docs/generate.js +4 -1
  7. package/dist/agent-tools/api-docs/index.d.ts +1 -0
  8. package/dist/agent-tools/api-docs/index.js +1 -0
  9. package/dist/agent-tools/api-docs/problems.d.ts +21 -0
  10. package/dist/agent-tools/api-docs/problems.js +11 -1
  11. package/dist/agent-tools/api-docs/render-openapi.js +2 -0
  12. package/dist/agent-tools/api-docs/resolve-config.d.ts +9 -0
  13. package/dist/agent-tools/api-docs/resolve-config.js +11 -0
  14. package/dist/agent-tools/api-docs/scope-slug-collisions.d.ts +4 -0
  15. package/dist/agent-tools/api-docs/scope-slug-collisions.js +10 -0
  16. package/dist/agent-tools/api-docs/translation-gaps.d.ts +4 -0
  17. package/dist/agent-tools/api-docs/translation-gaps.js +29 -0
  18. package/dist/agent-tools/api-docs/webhook-example-problems.d.ts +6 -0
  19. package/dist/agent-tools/api-docs/webhook-example-problems.js +25 -0
  20. package/dist/agent-tools/index.d.ts +1 -1
  21. package/dist/agent-tools/index.js +1 -1
  22. package/dist/agent-tools/labels.d.ts +3 -2
  23. package/dist/agent-tools/labels.js +21 -4
  24. package/dist/agent-tools/tool-catalog.d.ts +5 -5
  25. package/dist/agent-tools/tool-catalog.js +12 -10
  26. package/dist/agent-tools/tool-dispatch.js +11 -1
  27. package/dist/agent-tools/types.d.ts +4 -0
  28. package/dist/audit/event-classification.js +6 -0
  29. package/dist/audit/web/i18n.js +1 -0
  30. package/dist/auth-email-password/errors.js +0 -13
  31. package/dist/auth-email-password/handlers/invite-signup-complete.write.js +101 -84
  32. package/dist/auth-email-password/handlers/login-options.query.js +1 -1
  33. package/dist/auth-email-password/handlers/request-account-unlock.write.js +1 -1
  34. package/dist/auth-email-password/handlers/request-email-verification.write.js +0 -1
  35. package/dist/auth-email-password/handlers/request-password-reset.write.js +0 -1
  36. package/dist/auth-email-password/handlers/self-registration-status.query.js +1 -1
  37. package/dist/auth-email-password/reset-token.js +0 -2
  38. package/dist/auth-email-password/seeding.js +34 -8
  39. package/dist/auth-email-password/unlock-token.js +0 -2
  40. package/dist/auth-email-password/verification-token.js +0 -2
  41. package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
  42. package/dist/auth-email-password/web/auth-gate.js +2 -2
  43. package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
  44. package/dist/auth-email-password/web/auth-redirect.js +4 -0
  45. package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
  46. package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
  47. package/dist/auth-email-password/web/return-path.d.ts +2 -1
  48. package/dist/auth-email-password/web/return-path.js +2 -1
  49. package/dist/auth-email-password/web/session.js +11 -12
  50. package/dist/auth-email-password/web/signup-screen.js +1 -5
  51. package/dist/auth-email-password/web/static-account.js +6 -2
  52. package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
  53. package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
  54. package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
  55. package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
  56. package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
  57. package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
  58. package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
  59. package/dist/auth-mfa-user-data/index.js +5 -6
  60. package/dist/billing-foundation/aggregate-id.js +0 -4
  61. package/dist/billing-foundation/checkout-core.js +8 -1
  62. package/dist/billing-foundation/checkout-ledger.d.ts +15 -0
  63. package/dist/billing-foundation/checkout-ledger.js +32 -0
  64. package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
  65. package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
  66. package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
  67. package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
  68. package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
  69. package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
  70. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
  71. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
  72. package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
  73. package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
  74. package/dist/billing-foundation/events.d.ts +22 -0
  75. package/dist/billing-foundation/events.js +38 -10
  76. package/dist/billing-foundation/feature.js +12 -1
  77. package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
  78. package/dist/billing-foundation/handlers/create-checkout-session.write.js +1 -1
  79. package/dist/billing-foundation/handlers/process-event.write.d.ts +2 -2
  80. package/dist/billing-foundation/handlers/process-event.write.js +94 -12
  81. package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
  82. package/dist/billing-foundation/handlers/process-payment-event.write.js +29 -9
  83. package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
  84. package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
  85. package/dist/billing-foundation/handlers/start-plan-checkout.write.js +1 -1
  86. package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
  87. package/dist/billing-foundation/i18n.js +3 -0
  88. package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
  89. package/dist/billing-foundation/pending-plan-switch.js +57 -0
  90. package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
  91. package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
  92. package/dist/billing-foundation/types.d.ts +40 -24
  93. package/dist/billing-foundation/validate-options.js +14 -0
  94. package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
  95. package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
  96. package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
  97. package/dist/billing-foundation/web/constants.d.ts +3 -0
  98. package/dist/billing-foundation/web/constants.js +5 -2
  99. package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
  100. package/dist/billing-foundation/webhook-handler.js +53 -11
  101. package/dist/cap-counter/aggregate-id.js +0 -2
  102. package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
  103. package/dist/cap-counter/stock-cap-guard.js +18 -4
  104. package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
  105. package/dist/cap-overview/i18n.js +1 -0
  106. package/dist/cap-overview/index.d.ts +1 -1
  107. package/dist/cap-overview/types.d.ts +4 -0
  108. package/dist/cap-overview/web/cap-cards-panel.js +6 -2
  109. package/dist/cap-overview/web/cap-usage-bar.js +6 -1
  110. package/dist/cap-overview/web/usage-math.d.ts +1 -0
  111. package/dist/cap-overview/web/usage-math.js +4 -0
  112. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
  113. package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
  114. package/dist/channel-whatsapp/aggregate-id.js +18 -0
  115. package/dist/channel-whatsapp/constants.d.ts +25 -0
  116. package/dist/channel-whatsapp/constants.js +36 -0
  117. package/dist/channel-whatsapp/events.d.ts +87 -0
  118. package/dist/channel-whatsapp/events.js +70 -0
  119. package/dist/channel-whatsapp/feature.d.ts +3 -0
  120. package/dist/channel-whatsapp/feature.js +56 -0
  121. package/dist/channel-whatsapp/graph-client.d.ts +85 -0
  122. package/dist/channel-whatsapp/graph-client.js +272 -0
  123. package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
  124. package/dist/channel-whatsapp/in-memory-meta.js +181 -0
  125. package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
  126. package/dist/channel-whatsapp/inbound-handlers.js +127 -0
  127. package/dist/channel-whatsapp/index.d.ts +10 -0
  128. package/dist/channel-whatsapp/index.js +10 -0
  129. package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
  130. package/dist/channel-whatsapp/meta-signature.js +19 -0
  131. package/dist/channel-whatsapp/options.d.ts +32 -0
  132. package/dist/channel-whatsapp/options.js +83 -0
  133. package/dist/channel-whatsapp/pii.d.ts +32 -0
  134. package/dist/channel-whatsapp/pii.js +61 -0
  135. package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
  136. package/dist/channel-whatsapp/webhook-normalize.js +185 -0
  137. package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
  138. package/dist/channel-whatsapp/webhook-routes.js +118 -0
  139. package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
  140. package/dist/config/handlers/set.write.js +7 -0
  141. package/dist/config/handlers/values.query.js +8 -1
  142. package/dist/config/index.d.ts +1 -1
  143. package/dist/config/index.js +1 -1
  144. package/dist/config/read-redaction.d.ts +1 -0
  145. package/dist/config/read-redaction.js +5 -2
  146. package/dist/config/table.js +1 -0
  147. package/dist/config/write-helpers.js +3 -2
  148. package/dist/crypto-shredding/constants.d.ts +1 -0
  149. package/dist/crypto-shredding/constants.js +1 -0
  150. package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
  151. package/dist/crypto-shredding/index.d.ts +1 -0
  152. package/dist/crypto-shredding/index.js +1 -0
  153. package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
  154. package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
  155. package/dist/custom-fields/aggregate-id.js +0 -1
  156. package/dist/custom-fields/entity.js +1 -0
  157. package/dist/custom-fields/wire-for-entity.js +0 -1
  158. package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
  159. package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
  160. package/dist/data-retention/feature.js +1 -5
  161. package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
  162. package/dist/data-retention/run-retention-cleanup.js +39 -19
  163. package/dist/data-retention/tenant-destruction-hold.js +7 -0
  164. package/dist/delivery/attempt-log-factory.d.ts +3 -0
  165. package/dist/delivery/attempt-log-factory.js +5 -0
  166. package/dist/delivery/attempt-log.d.ts +2 -2
  167. package/dist/delivery/channel-context.d.ts +1 -1
  168. package/dist/delivery/channel-context.js +5 -2
  169. package/dist/delivery/db/queries/preferences.js +0 -1
  170. package/dist/delivery/delivery-service.js +3 -0
  171. package/dist/delivery/feature.d.ts +1 -4
  172. package/dist/delivery/feature.js +3 -1
  173. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
  174. package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
  175. package/dist/delivery/handlers/opted-in-user-ids.query.js +41 -0
  176. package/dist/delivery/handlers/preferences.query.js +2 -20
  177. package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
  178. package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
  179. package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
  180. package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
  181. package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
  182. package/dist/delivery/index.d.ts +3 -1
  183. package/dist/delivery/index.js +1 -0
  184. package/dist/delivery/options.d.ts +4 -0
  185. package/dist/delivery/options.js +1 -0
  186. package/dist/delivery/preference-rows.d.ts +9 -0
  187. package/dist/delivery/preference-rows.js +22 -0
  188. package/dist/delivery/set-preference-enabled.d.ts +17 -0
  189. package/dist/delivery/set-preference-enabled.js +26 -0
  190. package/dist/delivery/tables.d.ts +2 -2
  191. package/dist/delivery/testing.d.ts +1 -1
  192. package/dist/delivery/testing.js +3 -1
  193. package/dist/delivery/types.d.ts +1 -0
  194. package/dist/delivery/unsubscribe-page.js +5 -1
  195. package/dist/delivery/upsert-preference.js +0 -1
  196. package/dist/delivery/web/public-names.d.ts +1 -0
  197. package/dist/delivery/web/public-names.js +1 -0
  198. package/dist/derivatives-sharp/render.js +9 -9
  199. package/dist/document-ingest-foundation/aggregate-id.js +0 -1
  200. package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
  201. package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
  202. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
  203. package/dist/document-ingest-foundation/report-ingest-progress.js +29 -13
  204. package/dist/documents/aggregate-id.js +0 -2
  205. package/dist/documents/constants.d.ts +6 -0
  206. package/dist/documents/constants.js +8 -2
  207. package/dist/documents/ensure-link.d.ts +5 -8
  208. package/dist/documents/ensure-link.js +4 -2
  209. package/dist/documents/feature.d.ts +3 -1
  210. package/dist/documents/feature.js +24 -5
  211. package/dist/documents/handlers/import.write.js +2 -2
  212. package/dist/documents/queries/expiry-overview.query.js +2 -1
  213. package/dist/documents/queries/for-record.query.js +3 -4
  214. package/dist/documents/queries/list-page.js +11 -3
  215. package/dist/documents/queries/overview.query.js +2 -2
  216. package/dist/documents/screens.js +3 -3
  217. package/dist/documents/tab.js +1 -1
  218. package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
  219. package/dist/feature-toggles/toggle-sync-signal.js +3 -2
  220. package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
  221. package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
  222. package/dist/file-foundation/probe.js +9 -3
  223. package/dist/file-foundation/read-file-ref-content.js +23 -11
  224. package/dist/file-provider-inmemory/feature.js +1 -1
  225. package/dist/file-provider-s3/env-feature.js +1 -1
  226. package/dist/file-provider-s3/env-named-feature.js +1 -1
  227. package/dist/file-provider-s3/env-schema.d.ts +10 -1
  228. package/dist/file-provider-s3/env-schema.js +20 -7
  229. package/dist/file-provider-s3/feature.js +1 -1
  230. package/dist/file-provider-s3/index.d.ts +1 -1
  231. package/dist/file-provider-s3/index.js +1 -1
  232. package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
  233. package/dist/file-provider-s3/lib/env-helper.js +13 -12
  234. package/dist/file-provider-s3/lib/s3-provider.js +10 -2
  235. package/dist/folders/aggregate-id.js +0 -1
  236. package/dist/folders/web/folder-manager.js +1 -1
  237. package/dist/folders-user-data/index.js +12 -14
  238. package/dist/helpdesk/entity.js +4 -1
  239. package/dist/helpdesk/feature.js +36 -0
  240. package/dist/helpdesk/handlers/access.d.ts +0 -1
  241. package/dist/helpdesk/handlers/access.js +0 -3
  242. package/dist/helpdesk/handlers/attempts.js +7 -13
  243. package/dist/helpdesk/handlers/challenge.query.js +1 -2
  244. package/dist/helpdesk/handlers/reply.write.js +4 -5
  245. package/dist/helpdesk/handlers/report.write.js +3 -7
  246. package/dist/helpdesk/handlers/submit.write.js +4 -9
  247. package/dist/helpdesk/index.d.ts +1 -1
  248. package/dist/helpdesk/index.js +1 -1
  249. package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
  250. package/dist/helpdesk/legacy-contact-config.js +57 -0
  251. package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
  252. package/dist/helpdesk/legacy-contact-erasure.js +19 -0
  253. package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
  254. package/dist/helpdesk/legacy-contact-retention.js +53 -0
  255. package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
  256. package/dist/helpdesk/legacy-contact-streams.js +121 -0
  257. package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
  258. package/dist/helpdesk/legacy-contact-user-data.js +62 -0
  259. package/dist/helpdesk/lib.d.ts +7 -1
  260. package/dist/helpdesk/lib.js +29 -29
  261. package/dist/helpdesk/user-data-hooks.d.ts +10 -1
  262. package/dist/helpdesk/user-data-hooks.js +47 -36
  263. package/dist/helpdesk/web/constants.d.ts +0 -1
  264. package/dist/helpdesk/web/constants.js +0 -1
  265. package/dist/inbound-mail-foundation/account-health.js +1 -1
  266. package/dist/inbound-mail-foundation/account-poll.js +1 -1
  267. package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
  268. package/dist/inbound-mail-foundation/constants.d.ts +6 -0
  269. package/dist/inbound-mail-foundation/constants.js +6 -0
  270. package/dist/inbound-mail-foundation/content-refetch.d.ts +1 -0
  271. package/dist/inbound-mail-foundation/content-refetch.js +15 -1
  272. package/dist/inbound-mail-foundation/entities.js +57 -15
  273. package/dist/inbound-mail-foundation/events.js +15 -16
  274. package/dist/inbound-mail-foundation/feature.js +3 -1
  275. package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
  276. package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
  277. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
  278. package/dist/inbound-mail-foundation/handlers/connect-account.write.js +12 -7
  279. package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
  280. package/dist/inbound-mail-foundation/handlers/forget-message.write.js +54 -0
  281. package/dist/inbound-mail-foundation/i18n.js +3 -0
  282. package/dist/inbound-mail-foundation/index.d.ts +1 -0
  283. package/dist/inbound-mail-foundation/index.js +1 -0
  284. package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
  285. package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
  286. package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
  287. package/dist/inbound-mail-foundation/personal-address.js +16 -0
  288. package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
  289. package/dist/inbound-mail-foundation/purge-messages.js +33 -0
  290. package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
  291. package/dist/inbound-mail-foundation/quarantine.js +9 -5
  292. package/dist/inbound-mail-foundation/retention-job.js +1 -5
  293. package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
  294. package/dist/inbound-mail-foundation/send-from-account.js +9 -1
  295. package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
  296. package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
  297. package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
  298. package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
  299. package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
  300. package/dist/inbound-provider-imap/byte-budget.js +53 -0
  301. package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
  302. package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
  303. package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
  304. package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
  305. package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
  306. package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
  307. package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
  308. package/dist/inbound-provider-imap/download-batch.js +21 -6
  309. package/dist/inbound-provider-imap/feature.js +7 -4
  310. package/dist/inbound-provider-imap/fetch-content.js +35 -30
  311. package/dist/inbound-provider-imap/i18n.js +2 -2
  312. package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
  313. package/dist/inbound-provider-imap/parse-message.js +8 -0
  314. package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
  315. package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
  316. package/dist/inbound-provider-imap/send-mail.js +32 -6
  317. package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
  318. package/dist/inbound-provider-imap/smtp-client.js +15 -3
  319. package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
  320. package/dist/inbound-provider-inmemory/feature.js +1 -1
  321. package/dist/jobs/events.d.ts +13 -0
  322. package/dist/jobs/events.js +8 -0
  323. package/dist/jobs/feature.js +2 -0
  324. package/dist/jobs/handlers/consumer.write.js +31 -20
  325. package/dist/jobs/web/constants.d.ts +3 -0
  326. package/dist/jobs/web/constants.js +3 -0
  327. package/dist/mail-transport-inmemory/feature.js +1 -1
  328. package/dist/mail-transport-smtp/feature.js +3 -2
  329. package/dist/managed-pages/handlers/branding.query.js +1 -1
  330. package/dist/managed-pages/handlers/by-slug.query.js +1 -1
  331. package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
  332. package/dist/managed-pages/render-page-body.d.ts +2 -0
  333. package/dist/managed-pages/render-page-body.js +12 -8
  334. package/dist/managed-pages/screens/page-screens.d.ts +3 -2
  335. package/dist/managed-pages/screens/page-screens.js +14 -33
  336. package/dist/managed-pages/table.js +1 -0
  337. package/dist/managed-pages/web/client-plugin.js +8 -6
  338. package/dist/managed-pages/web/constants.d.ts +5 -1
  339. package/dist/managed-pages/web/constants.js +6 -1
  340. package/dist/managed-pages/web/i18n.js +11 -3
  341. package/dist/managed-pages/web/markdown-to-document.js +1 -1
  342. package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
  343. package/dist/managed-pages/web/page-edit-draft.js +76 -0
  344. package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
  345. package/dist/managed-pages/web/page-edit-screen.js +106 -0
  346. package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
  347. package/dist/managed-pages/web/page-settings-rail.js +14 -0
  348. package/dist/notes-history-user-data/index.js +8 -14
  349. package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
  350. package/dist/personal-access-tokens/boot-rules.js +5 -0
  351. package/dist/personal-access-tokens/handlers/create.write.js +0 -1
  352. package/dist/personal-access-tokens/scope-events-check.js +26 -6
  353. package/dist/presence/handlers/list.query.js +18 -8
  354. package/dist/presence/room.d.ts +2 -0
  355. package/dist/presence/room.js +8 -5
  356. package/dist/presence/store.d.ts +2 -0
  357. package/dist/presence/store.js +62 -26
  358. package/dist/readiness/handlers/latest-summary.query.js +10 -6
  359. package/dist/readiness/handlers/run-probes.write.js +24 -4
  360. package/dist/readiness/handlers/run-tone.js +3 -2
  361. package/dist/readiness/handlers/status.query.js +11 -3
  362. package/dist/readiness/probe-context.js +7 -10
  363. package/dist/readiness/screens.js +4 -4
  364. package/dist/readiness/visible-results.d.ts +1 -1
  365. package/dist/readiness/visible-results.js +5 -2
  366. package/dist/renderer-foundation/api.js +6 -12
  367. package/dist/renderer-foundation/types.d.ts +2 -2
  368. package/dist/secrets/db/queries/read.d.ts +2 -1
  369. package/dist/secrets/db/queries/read.js +10 -1
  370. package/dist/secrets/handlers/list.query.js +4 -2
  371. package/dist/secrets/secret-scope.d.ts +0 -1
  372. package/dist/secrets/secret-scope.js +2 -2
  373. package/dist/secrets/secrets-context.js +4 -4
  374. package/dist/secrets/table.d.ts +1 -1
  375. package/dist/secrets/write-gate.js +4 -2
  376. package/dist/seo/handlers/seo-config.query.js +1 -1
  377. package/dist/shared/acknowledged-system-db.d.ts +5 -0
  378. package/dist/shared/acknowledged-system-db.js +9 -0
  379. package/dist/shared/assert-billing-live.d.ts +1 -0
  380. package/dist/shared/assert-billing-live.js +5 -2
  381. package/dist/shared/index.d.ts +6 -2
  382. package/dist/shared/index.js +6 -2
  383. package/dist/shared/parent-visibility.d.ts +1 -0
  384. package/dist/shared/parent-visibility.js +16 -1
  385. package/dist/shared/password-hashing.js +0 -1
  386. package/dist/shared/price-env-shape.js +1 -1
  387. package/dist/shared/register-user-data-hooks.d.ts +11 -0
  388. package/dist/shared/register-user-data-hooks.js +11 -0
  389. package/dist/shared/require-bootstrap-extension.d.ts +9 -0
  390. package/dist/shared/require-bootstrap-extension.js +16 -0
  391. package/dist/shared/send-best-effort.d.ts +2 -0
  392. package/dist/shared/send-best-effort.js +14 -0
  393. package/dist/shared/stream-tenant-backfill.d.ts +1 -0
  394. package/dist/shared/stream-tenant-backfill.js +17 -1
  395. package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
  396. package/dist/shared/stream-tenant-derived-state.js +19 -2
  397. package/dist/step-dispatcher/constants.d.ts +4 -0
  398. package/dist/step-dispatcher/constants.js +11 -0
  399. package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
  400. package/dist/step-dispatcher/deliver-dispatch-request.js +38 -2
  401. package/dist/step-dispatcher/feature.js +20 -2
  402. package/dist/step-dispatcher/mail-runner.js +0 -1
  403. package/dist/step-dispatcher/sweep-abandoned.d.ts +10 -0
  404. package/dist/step-dispatcher/sweep-abandoned.js +43 -0
  405. package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
  406. package/dist/subscription-mollie/plugin-methods.js +1 -2
  407. package/dist/subscription-mollie/verify-webhook.js +5 -5
  408. package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
  409. package/dist/subscription-paddle/backfill-checkout-ledger.js +110 -0
  410. package/dist/subscription-paddle/checkout-config.query.js +1 -1
  411. package/dist/subscription-paddle/checkout-methods.js +2 -8
  412. package/dist/subscription-paddle/constants.d.ts +0 -1
  413. package/dist/subscription-paddle/constants.js +1 -2
  414. package/dist/subscription-paddle/feature.d.ts +0 -4
  415. package/dist/subscription-paddle/feature.js +21 -20
  416. package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
  417. package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
  418. package/dist/subscription-paddle/plan-switch-methods.js +2 -8
  419. package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
  420. package/dist/subscription-paddle/redeliver-legacy-checkout.js +26 -0
  421. package/dist/subscription-paddle/runtime.d.ts +3 -5
  422. package/dist/subscription-paddle/runtime.js +4 -7
  423. package/dist/subscription-paddle/subscription-state.d.ts +1 -0
  424. package/dist/subscription-paddle/subscription-state.js +1 -0
  425. package/dist/subscription-paddle/webhook-events.d.ts +4 -0
  426. package/dist/subscription-paddle/webhook-events.js +40 -22
  427. package/dist/subscription-stripe/feature.d.ts +4 -0
  428. package/dist/subscription-stripe/feature.js +1 -0
  429. package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
  430. package/dist/subscription-stripe/plugin-methods.js +2 -5
  431. package/dist/subscription-stripe/runtime.d.ts +2 -1
  432. package/dist/subscription-stripe/runtime.js +5 -7
  433. package/dist/subscription-stripe/verify-webhook.js +21 -6
  434. package/dist/tags/aggregate-id.js +0 -1
  435. package/dist/tags/web/tag-chip.js +0 -1
  436. package/dist/tags/web/tag-manager.js +3 -1
  437. package/dist/template-resolver/api.js +6 -12
  438. package/dist/template-resolver/document-sanitizer.d.ts +1 -1
  439. package/dist/template-resolver/document-sanitizer.js +18 -0
  440. package/dist/template-resolver/feature.d.ts +1 -0
  441. package/dist/template-resolver/feature.js +2 -0
  442. package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
  443. package/dist/template-resolver/handlers/body-preview.query.js +41 -0
  444. package/dist/template-resolver/handlers/by-slug.query.js +1 -1
  445. package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
  446. package/dist/template-resolver/handlers/collection-shared.js +5 -8
  447. package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
  448. package/dist/template-resolver/handlers/overview.query.js +2 -1
  449. package/dist/template-resolver/handlers/send-test.write.js +27 -8
  450. package/dist/template-resolver/linked-resources.js +2 -6
  451. package/dist/template-resolver/seeding.js +67 -1
  452. package/dist/template-resolver/table.js +1 -0
  453. package/dist/template-resolver/template-draft.js +2 -1
  454. package/dist/template-resolver/template-preview.js +12 -3
  455. package/dist/template-resolver/testing.js +0 -2
  456. package/dist/template-resolver/web/client-plugin.js +3 -0
  457. package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
  458. package/dist/template-resolver/web/constants.d.ts +2 -0
  459. package/dist/template-resolver/web/constants.js +2 -0
  460. package/dist/template-resolver/web/content-tree-provider.js +0 -1
  461. package/dist/template-resolver/web/content-workbench.d.ts +22 -0
  462. package/dist/template-resolver/web/content-workbench.js +32 -0
  463. package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
  464. package/dist/template-resolver/web/document-insert-model.js +1 -2
  465. package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
  466. package/dist/template-resolver/web/document-link-policy.js +53 -0
  467. package/dist/template-resolver/web/document-schema.d.ts +2 -4
  468. package/dist/template-resolver/web/document-schema.js +2 -53
  469. package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
  470. package/dist/template-resolver/web/document-tiptap-context.js +2 -2
  471. package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
  472. package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
  473. package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
  474. package/dist/template-resolver/web/editor-handle.js +1 -0
  475. package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
  476. package/dist/template-resolver/web/fill-document-variables.js +22 -0
  477. package/dist/template-resolver/web/i18n.js +10 -0
  478. package/dist/template-resolver/web/index.d.ts +3 -0
  479. package/dist/template-resolver/web/index.js +2 -0
  480. package/dist/template-resolver/web/preview-targets.d.ts +5 -0
  481. package/dist/template-resolver/web/preview-targets.js +21 -0
  482. package/dist/template-resolver/web/qualified-names.d.ts +1 -0
  483. package/dist/template-resolver/web/qualified-names.js +1 -0
  484. package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
  485. package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
  486. package/dist/template-resolver/web/string-values.d.ts +1 -0
  487. package/dist/template-resolver/web/string-values.js +8 -0
  488. package/dist/template-resolver/web/text-block-editor.js +18 -11
  489. package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
  490. package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
  491. package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
  492. package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
  493. package/dist/template-resolver/web/use-text-block-editor.js +26 -5
  494. package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
  495. package/dist/template-resolver/web/web-preview-renderer.js +41 -0
  496. package/dist/template-resolver-user-data/index.js +11 -10
  497. package/dist/tenant/handlers/create.write.js +3 -7
  498. package/dist/tenant/handlers/list.query.js +3 -8
  499. package/dist/tenant/handlers/member-directory.query.js +10 -5
  500. package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
  501. package/dist/tenant/invited-membership.js +9 -1
  502. package/dist/tenant/seeding.d.ts +3 -0
  503. package/dist/tenant/seeding.js +3 -1
  504. package/dist/tenant/stream-tenant-backfill.js +5 -1
  505. package/dist/tenant/testing.js +1 -1
  506. package/dist/tenant-inactivity/check-inactive-tenants.js +5 -5
  507. package/dist/tenant-inactivity/constants.js +1 -2
  508. package/dist/tenant-inactivity/handlers/keep-account.write.js +1 -2
  509. package/dist/tenant-inactivity/state-store.d.ts +1 -0
  510. package/dist/tenant-inactivity/state-store.js +9 -1
  511. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  512. package/dist/tenant-lifecycle/constants.js +3 -0
  513. package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
  514. package/dist/tenant-lifecycle/stages.js +14 -2
  515. package/dist/tier-engine/aggregate-id.js +0 -1
  516. package/dist/tier-engine/feature.js +9 -2
  517. package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
  518. package/dist/user/handlers/me.query.js +4 -1
  519. package/dist/user/index.d.ts +1 -0
  520. package/dist/user/index.js +1 -0
  521. package/dist/user/resolve-verified-user-email.d.ts +2 -0
  522. package/dist/user/resolve-verified-user-email.js +14 -0
  523. package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
  524. package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
  525. package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
  526. package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
  527. package/dist/user-data-rights/run-export-jobs.js +0 -2
  528. package/dist/user-data-rights/run-forget-cleanup.js +2 -2
  529. package/dist/user-data-rights/schema/download-attempt.js +3 -2
  530. package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
  531. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  532. package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
  533. package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
  534. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
  535. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
  536. package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
  537. package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
  538. package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
  539. package/dist/user-profile/handlers/change-email.write.js +0 -1
  540. package/dist/waitlist/handlers/submit.write.js +5 -18
  541. package/dist/waitlist/lib.js +2 -7
  542. package/dist/waitlist/user-data-hooks.js +6 -20
  543. package/dist/workflow-runner/aggregate-id.js +0 -1
  544. package/dist/workflow-runner/event-trigger.js +6 -2
  545. package/dist/workflow-runner/feature.js +1 -5
  546. package/dist/workflow-runner/handlers/resume-run.write.js +4 -3
  547. package/dist/workflow-runner/runner.d.ts +1 -0
  548. package/package.json +35 -11
  549. package/src/admin-shell/changes.json +6 -0
  550. package/src/agent-tools/changes.json +12 -0
  551. package/src/auth-email-password/changes.json +18 -0
  552. package/src/billing-foundation/changes.json +37 -0
  553. package/src/cap-counter/changes.json +6 -0
  554. package/src/cap-overview/changes.json +6 -0
  555. package/src/channel-in-app/changes.json +6 -0
  556. package/src/channel-whatsapp/changes.json +8 -0
  557. package/src/config/changes.json +12 -0
  558. package/src/crypto-shredding/changes.json +18 -0
  559. package/src/data-retention/changes.json +12 -0
  560. package/src/delivery/changes.json +6 -0
  561. package/src/documents/changes.json +18 -0
  562. package/src/file-provider-s3/changes.json +14 -0
  563. package/src/files/changes.json +7 -0
  564. package/src/helpdesk/changes.json +50 -0
  565. package/src/inbound-mail-foundation/changes.json +48 -0
  566. package/src/inbound-provider-imap/changes.json +13 -0
  567. package/src/mail-foundation/changes.json +6 -0
  568. package/src/managed-pages/changes.json +12 -0
  569. package/src/presence/changes.json +6 -0
  570. package/src/readiness/changes.json +25 -0
  571. package/src/secrets/changes.json +7 -0
  572. package/src/shared/changes.json +6 -0
  573. package/src/step-dispatcher/changes.json +12 -0
  574. package/src/subscription-mollie/changes.json +7 -0
  575. package/src/subscription-paddle/changes.json +13 -0
  576. package/src/subscription-stripe/changes.json +7 -0
  577. package/src/template-resolver/changes.json +36 -0
  578. package/src/tenant/changes.json +6 -0
  579. package/src/tenant-lifecycle/changes.json +18 -0
  580. package/src/tier-engine/changes.json +6 -0
  581. package/src/user/changes.json +6 -0
  582. package/src/waitlist/changes.json +6 -0
  583. package/dist/managed-pages/web/page-body-section.d.ts +0 -3
  584. package/dist/managed-pages/web/page-body-section.js +0 -40
  585. package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
  586. package/dist/subscription-paddle/tenant-binding.js +0 -26
  587. package/dist/template-resolver/web/content-field.d.ts +0 -9
  588. package/dist/template-resolver/web/content-field.js +0 -14
@@ -0,0 +1,61 @@
1
+ import { configuredPiiSubjectKms, decryptPiiValueForSubject, encryptPiiValueForSubject, } from "@cosmicdrift/kumiko-framework/crypto";
2
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
3
+ // The sender has no user account, so the tenant key is the subject (as for inbound mail):
4
+ // destroying the tenant shreds the key and every stored number, text and payload with it.
5
+ // The field name is part of the ciphertext's AAD and must match between encrypt and decrypt.
6
+ export const WhatsappPiiFields = {
7
+ receivedFrom: "channel-whatsapp.message-received.from",
8
+ receivedText: "channel-whatsapp.message-received.text",
9
+ receivedButtonPayload: "channel-whatsapp.message-received.buttonPayload",
10
+ statusRecipient: "channel-whatsapp.status-updated.recipient",
11
+ throttledFrom: "channel-whatsapp.throttled.from",
12
+ };
13
+ /** Without a configured PII KMS the value passes through, like every other event-sourced inbound path. */
14
+ export async function encryptWhatsappPii(tenantId, field, value, requestId) {
15
+ const kms = configuredPiiSubjectKms();
16
+ if (!kms)
17
+ return value;
18
+ return encryptPiiValueForSubject(kms, { kind: "tenant", tenantId }, value, { requestId, tenantId }, field);
19
+ }
20
+ export async function decryptWhatsappPii(tenantId, field, value) {
21
+ const kms = configuredPiiSubjectKms();
22
+ if (!kms)
23
+ return value;
24
+ return decryptPiiValueForSubject(kms, value, { requestId: `channel-whatsapp:decrypt:${field}`, tenantId }, field);
25
+ }
26
+ /** Plaintext recipient of a `status-updated` event payload. */
27
+ export async function readWhatsappStatusPii(tenantId, payload) {
28
+ const recipient = propertyOf(payload, "recipient");
29
+ if (typeof recipient !== "string")
30
+ throw new Error("channel-whatsapp: payload has no recipient");
31
+ return {
32
+ recipient: await decryptWhatsappPii(tenantId, WhatsappPiiFields.statusRecipient, recipient),
33
+ };
34
+ }
35
+ /** Plaintext sender of a `throttled` event payload. */
36
+ export async function readWhatsappThrottledPii(tenantId, payload) {
37
+ const from = propertyOf(payload, "from");
38
+ if (typeof from !== "string")
39
+ throw new Error("channel-whatsapp: payload has no sender");
40
+ return { from: await decryptWhatsappPii(tenantId, WhatsappPiiFields.throttledFrom, from) };
41
+ }
42
+ /**
43
+ * Plaintext of the PII fields of a `message-received` event payload, for the consumer.
44
+ * A tenant that was destroyed yields the erased sentinel instead of the value.
45
+ */
46
+ export async function readWhatsappMessagePii(tenantId, payload) {
47
+ const from = propertyOf(payload, "from");
48
+ const text = propertyOf(payload, "text");
49
+ const buttonPayload = propertyOf(payload, "buttonPayload");
50
+ if (typeof from !== "string")
51
+ throw new Error("channel-whatsapp: payload has no sender");
52
+ return {
53
+ from: await decryptWhatsappPii(tenantId, WhatsappPiiFields.receivedFrom, from),
54
+ text: typeof text === "string"
55
+ ? await decryptWhatsappPii(tenantId, WhatsappPiiFields.receivedText, text)
56
+ : null,
57
+ buttonPayload: typeof buttonPayload === "string"
58
+ ? await decryptWhatsappPii(tenantId, WhatsappPiiFields.receivedButtonPayload, buttonPayload)
59
+ : null,
60
+ };
61
+ }
@@ -0,0 +1,7 @@
1
+ import { type ReceiveMessageInput, type RecordStatusInput } from "./events.ts";
2
+ export type NormalizedWebhook = {
3
+ readonly messages: readonly ReceiveMessageInput[];
4
+ readonly statuses: readonly RecordStatusInput[];
5
+ readonly skipped: number;
6
+ };
7
+ export declare function normalizeWhatsappWebhook(body: unknown, nowIso: string): NormalizedWebhook;
@@ -0,0 +1,185 @@
1
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
2
+ import * as z from "zod";
3
+ import { WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS, WHATSAPP_STATUS_KINDS, WHATSAPP_TEXT_MAX_CHARS, } from "./constants.js";
4
+ import { RAW_STATUS_MAX_CHARS, } from "./events.js";
5
+ // Meta adds fields and message types without notice. Every nested object is `.catch(undefined)`,
6
+ // so one unexpected shape costs that detail and not the whole message.
7
+ const mediaSchema = z.object({ id: z.string().optional(), mime_type: z.string().optional() });
8
+ const messageSchema = z.object({
9
+ id: z.string().min(1),
10
+ from: z.string(),
11
+ timestamp: z.string().optional(),
12
+ type: z.string().optional(),
13
+ text: z.object({ body: z.string() }).optional().catch(undefined),
14
+ audio: mediaSchema.optional().catch(undefined),
15
+ image: mediaSchema.optional().catch(undefined),
16
+ interactive: z
17
+ .object({
18
+ button_reply: z
19
+ .object({ id: z.string(), title: z.string().optional() })
20
+ .optional()
21
+ .catch(undefined),
22
+ })
23
+ .optional()
24
+ .catch(undefined),
25
+ button: z
26
+ .object({ payload: z.string().optional(), text: z.string().optional() })
27
+ .optional()
28
+ .catch(undefined),
29
+ context: z.object({ id: z.string().optional() }).optional().catch(undefined),
30
+ });
31
+ const statusSchema = z.object({
32
+ id: z.string().min(1),
33
+ status: z.string().optional(),
34
+ timestamp: z.string().optional(),
35
+ recipient_id: z.string().optional(),
36
+ errors: z
37
+ .array(z.object({ code: z.number().optional() }))
38
+ .optional()
39
+ .catch(undefined),
40
+ });
41
+ const changeValueSchema = z.object({
42
+ metadata: z.object({ phone_number_id: z.string().optional() }).optional().catch(undefined),
43
+ messages: z.array(z.unknown()).optional().catch(undefined),
44
+ statuses: z.array(z.unknown()).optional().catch(undefined),
45
+ });
46
+ const webhookSchema = z.object({
47
+ entry: z
48
+ .array(z.object({
49
+ changes: z
50
+ .array(z.object({ value: changeValueSchema.optional().catch(undefined) }))
51
+ .optional()
52
+ .catch(undefined),
53
+ }))
54
+ .optional()
55
+ .catch(undefined),
56
+ });
57
+ const DIGITS_PATTERN = /^\d{5,20}$/;
58
+ function toE164(raw) {
59
+ const digits = raw.replace(/^\+/, "");
60
+ return DIGITS_PATTERN.test(digits) ? `+${digits}` : null;
61
+ }
62
+ function toIso(unixSeconds, fallbackIso) {
63
+ const seconds = Number(unixSeconds);
64
+ return unixSeconds !== undefined && Number.isFinite(seconds) && seconds > 0
65
+ ? Temporal.Instant.fromEpochMilliseconds(Math.floor(seconds) * 1000).toString()
66
+ : fallbackIso;
67
+ }
68
+ function clip(value, maxChars) {
69
+ return value.length > maxChars ? value.slice(0, maxChars) : value;
70
+ }
71
+ const NO_CONTENT = { text: null, buttonPayload: null, mediaId: null, mimeType: null };
72
+ function optionalClip(value, maxChars) {
73
+ return value === undefined ? null : clip(value, maxChars);
74
+ }
75
+ function buttonContentOf(message) {
76
+ const reply = message.interactive?.button_reply;
77
+ if (message.type === "interactive" && reply) {
78
+ return {
79
+ ...NO_CONTENT,
80
+ messageType: "interactive_button",
81
+ text: optionalClip(reply.title, WHATSAPP_TEXT_MAX_CHARS),
82
+ buttonPayload: clip(reply.id, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS),
83
+ };
84
+ }
85
+ // Quick-reply buttons of a template arrive as type "button".
86
+ if (message.type === "button" && message.button?.payload !== undefined) {
87
+ return {
88
+ ...NO_CONTENT,
89
+ messageType: "interactive_button",
90
+ text: optionalClip(message.button.text, WHATSAPP_TEXT_MAX_CHARS),
91
+ buttonPayload: clip(message.button.payload, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS),
92
+ };
93
+ }
94
+ return null;
95
+ }
96
+ function mediaContentOf(message) {
97
+ if (message.type !== "audio" && message.type !== "image")
98
+ return null;
99
+ const media = message.type === "audio" ? message.audio : message.image;
100
+ if (!media)
101
+ return null;
102
+ return {
103
+ ...NO_CONTENT,
104
+ messageType: message.type,
105
+ mediaId: media.id ?? null,
106
+ mimeType: media.mime_type ?? null,
107
+ };
108
+ }
109
+ function contentOf(message) {
110
+ if (message.type === "text" && message.text) {
111
+ return {
112
+ ...NO_CONTENT,
113
+ messageType: "text",
114
+ text: clip(message.text.body, WHATSAPP_TEXT_MAX_CHARS),
115
+ };
116
+ }
117
+ return (buttonContentOf(message) ?? mediaContentOf(message) ?? { ...NO_CONTENT, messageType: "other" });
118
+ }
119
+ function normalizeMessage(raw, phoneNumberId, nowIso) {
120
+ const parsed = messageSchema.safeParse(raw);
121
+ if (!parsed.success)
122
+ return null;
123
+ const message = parsed.data;
124
+ const from = toE164(message.from);
125
+ if (from === null)
126
+ return null;
127
+ return {
128
+ phoneNumberId,
129
+ wamid: message.id,
130
+ from,
131
+ timestampIso: toIso(message.timestamp, nowIso),
132
+ contextWamid: message.context?.id ?? null,
133
+ ...contentOf(message),
134
+ };
135
+ }
136
+ function statusKindOf(raw) {
137
+ return WHATSAPP_STATUS_KINDS.find((kind) => kind === raw) ?? "other";
138
+ }
139
+ function normalizeStatus(raw, phoneNumberId, nowIso) {
140
+ const parsed = statusSchema.safeParse(raw);
141
+ if (!parsed.success)
142
+ return null;
143
+ const status = parsed.data;
144
+ const recipient = toE164(status.recipient_id ?? "");
145
+ if (recipient === null)
146
+ return null;
147
+ return {
148
+ phoneNumberId,
149
+ wamid: status.id,
150
+ status: statusKindOf(status.status),
151
+ rawStatus: status.status === undefined ? null : clip(status.status, RAW_STATUS_MAX_CHARS),
152
+ timestampIso: toIso(status.timestamp, nowIso),
153
+ recipient,
154
+ errorCode: status.errors?.[0]?.code ?? null,
155
+ };
156
+ }
157
+ export function normalizeWhatsappWebhook(body, nowIso) {
158
+ const parsed = webhookSchema.safeParse(body);
159
+ const messages = [];
160
+ const statuses = [];
161
+ let skipped = 0;
162
+ if (!parsed.success)
163
+ return { messages, statuses, skipped };
164
+ for (const entry of parsed.data.entry ?? []) {
165
+ for (const change of entry.changes ?? []) {
166
+ const value = change.value;
167
+ const phoneNumberId = value?.metadata?.phone_number_id;
168
+ for (const raw of value?.messages ?? []) {
169
+ const normalized = phoneNumberId ? normalizeMessage(raw, phoneNumberId, nowIso) : null;
170
+ if (normalized)
171
+ messages.push(normalized);
172
+ else
173
+ skipped += 1;
174
+ }
175
+ for (const raw of value?.statuses ?? []) {
176
+ const normalized = phoneNumberId ? normalizeStatus(raw, phoneNumberId, nowIso) : null;
177
+ if (normalized)
178
+ statuses.push(normalized);
179
+ else
180
+ skipped += 1;
181
+ }
182
+ }
183
+ }
184
+ return { messages, statuses, skipped };
185
+ }
@@ -0,0 +1,10 @@
1
+ import { type ExtraRouteDefinition } from "@cosmicdrift/kumiko-framework/api";
2
+ export type WhatsappWebhookRouteOptions = {
3
+ /** Route path; MUST carry `:tenantId`. The secrets are tenant-scoped, so the tenant is part of the URL. */
4
+ readonly path?: string;
5
+ };
6
+ /**
7
+ * The two routes Meta needs: GET answers the subscription handshake (`hub.challenge`), POST takes
8
+ * the signed notifications. Mount via `extraRoutes: createWhatsappWebhookRoutes()`.
9
+ */
10
+ export declare function createWhatsappWebhookRoutes(options?: WhatsappWebhookRouteOptions): readonly ExtraRouteDefinition[];
@@ -0,0 +1,118 @@
1
+ import { ExtraRouteRejection, signatureRoute, } from "@cosmicdrift/kumiko-framework/api";
2
+ import { parseTenantId, SYSTEM_USER_ID } from "@cosmicdrift/kumiko-types/identifiers";
3
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
4
+ import { CHANNEL_WHATSAPP_FEATURE, WHATSAPP_DEFAULT_WEBHOOK_PATH, WHATSAPP_SECRET_KEYS, WhatsappHandlers, } from "./constants.js";
5
+ import { isValidMetaSignature, secretsMatch } from "./meta-signature.js";
6
+ import { normalizeWhatsappWebhook } from "./webhook-normalize.js";
7
+ const MAX_CHALLENGE_CHARS = 512;
8
+ const AUDIT_HANDLER = `${CHANNEL_WHATSAPP_FEATURE}:webhook`;
9
+ // Every authentication failure is a plain throw: the framework answers all of them with the
10
+ // same 401 body, so a caller cannot tell a bad tenant id, an unknown tenant, a missing secret
11
+ // and a wrong signature apart.
12
+ class WebhookAuthError extends Error {
13
+ }
14
+ async function readTenantSecret(deps, tenantIdParam, key) {
15
+ const tenantId = parseTenantId(tenantIdParam);
16
+ if (tenantId === null)
17
+ throw new WebhookAuthError("invalid tenant id");
18
+ const revealed = await deps.secrets?.get(tenantId, key, {
19
+ userId: SYSTEM_USER_ID,
20
+ handlerName: AUDIT_HANDLER,
21
+ });
22
+ const secret = revealed?.reveal();
23
+ if (secret === undefined || secret === "")
24
+ throw new WebhookAuthError("no secret");
25
+ return { tenantId, secret };
26
+ }
27
+ async function verifyChallenge(deps, params, query) {
28
+ const { secret } = await readTenantSecret(deps, params["tenantId"], WHATSAPP_SECRET_KEYS.verifyToken);
29
+ const challenge = query["hub.challenge"];
30
+ const token = query["hub.verify_token"];
31
+ if (query["hub.mode"] !== "subscribe" ||
32
+ token === undefined ||
33
+ !secretsMatch(token, secret) ||
34
+ challenge === undefined ||
35
+ challenge === "" ||
36
+ challenge.length > MAX_CHALLENGE_CHARS) {
37
+ throw new WebhookAuthError("verification failed");
38
+ }
39
+ return { kind: "challenge", challenge };
40
+ }
41
+ async function verifySignedWebhook(deps, request) {
42
+ const { tenantId, secret } = await readTenantSecret(deps, request.params["tenantId"], WHATSAPP_SECRET_KEYS.appSecret);
43
+ if (!isValidMetaSignature(secret, request.rawBody, request.headers["x-hub-signature-256"])) {
44
+ throw new WebhookAuthError("bad signature");
45
+ }
46
+ try {
47
+ return { kind: "webhook", tenantId, body: JSON.parse(request.rawBody) };
48
+ }
49
+ catch {
50
+ throw new ExtraRouteRejection(400, {
51
+ error: { code: "whatsapp_webhook_invalid_json", message: "body is not JSON" },
52
+ });
53
+ }
54
+ }
55
+ function outcomeOf(data) {
56
+ const outcome = data !== null && typeof data === "object" && "outcome" in data ? data.outcome : undefined;
57
+ return outcome === "duplicate" || outcome === "throttled" ? outcome : "stored";
58
+ }
59
+ async function processWebhook(c, verified, deps) {
60
+ const { messages, statuses, skipped } = normalizeWhatsappWebhook(verified.body, Temporal.Now.instant().toString());
61
+ const counts = { stored: 0, duplicate: 0, throttled: 0, failed: 0 };
62
+ const dispatches = [
63
+ ...messages.map((payload) => ({ handlerQn: WhatsappHandlers.receiveMessage, payload })),
64
+ ...statuses.map((payload) => ({ handlerQn: WhatsappHandlers.recordStatus, payload })),
65
+ ];
66
+ // Every item is tried even after a failure: the dedupe makes the redelivery of the
67
+ // already stored ones harmless, and the failed ones get their retry from Meta.
68
+ for (const { handlerQn, payload } of dispatches) {
69
+ const dispatched = await deps.dispatchSystemWrite({
70
+ handlerQn,
71
+ payload,
72
+ tenantId: verified.tenantId,
73
+ });
74
+ if (dispatched.isSuccess)
75
+ counts[outcomeOf(dispatched.data)] += 1;
76
+ else
77
+ counts.failed += 1;
78
+ }
79
+ if (counts.failed > 0) {
80
+ return c.json({
81
+ error: {
82
+ code: "whatsapp_webhook_processing_failed",
83
+ message: "Internal error processing the webhook",
84
+ },
85
+ }, 500);
86
+ }
87
+ return c.json({ ...counts, skipped }, 200);
88
+ }
89
+ /**
90
+ * The two routes Meta needs: GET answers the subscription handshake (`hub.challenge`), POST takes
91
+ * the signed notifications. Mount via `extraRoutes: createWhatsappWebhookRoutes()`.
92
+ */
93
+ export function createWhatsappWebhookRoutes(options = {}) {
94
+ const path = options.path ?? WHATSAPP_DEFAULT_WEBHOOK_PATH;
95
+ if (!path.includes(":tenantId")) {
96
+ throw new Error(`${CHANNEL_WHATSAPP_FEATURE}: the webhook path must carry a :tenantId segment (the secrets are tenant-scoped)`);
97
+ }
98
+ return [
99
+ signatureRoute({
100
+ method: "GET",
101
+ path,
102
+ entry: "signature",
103
+ verify: ({ params, query }, deps) => verifyChallenge(deps, params, query),
104
+ handler: (c, verified) => verified.kind === "challenge"
105
+ ? c.text(verified.challenge, 200)
106
+ : c.json({ error: { code: "whatsapp_webhook_unexpected" } }, 400),
107
+ }),
108
+ signatureRoute({
109
+ method: "POST",
110
+ path,
111
+ entry: "signature",
112
+ verify: (request, deps) => verifySignedWebhook(deps, request),
113
+ handler: (c, verified, deps) => verified.kind === "webhook"
114
+ ? processWebhook(c, verified, deps)
115
+ : c.json({ error: { code: "whatsapp_webhook_unexpected" } }, 400),
116
+ }),
117
+ ];
118
+ }
@@ -17,7 +17,7 @@ export const subProcessorsQuery = defineQueryHandler({
17
17
  name: "sub-processors",
18
18
  schema: z.object({}),
19
19
  access: {
20
- roles: ["anonymous", "Member", "User", "TenantAdmin", "SystemAdmin"],
20
+ roles: ["anonymous"],
21
21
  anySignedIn: true,
22
22
  },
23
23
  rateLimit: { per: "ip+handler", limit: 30, windowSeconds: 60 },
@@ -84,6 +84,13 @@ export const setWrite = defineWriteHandler({
84
84
  message: `[config:write:set] readCascade: unknown config key "${qualifiedKey}"`,
85
85
  });
86
86
  }
87
+ // Validators are free to echo values into error details; plaintext of a stored
88
+ // secret or PII key must never reach the writing admin that way.
89
+ if (isEncryptedAtRest(cascadeKeyDef) || cascadeKeyDef.piiEncrypted) {
90
+ throw new InternalError({
91
+ message: `[config:write:set] readCascade: key "${qualifiedKey}" is encrypted and cannot be read by a validator`,
92
+ });
93
+ }
87
94
  return requireConfigResolver(ctx, "config:write:set").getCascade(qualifiedKey, cascadeKeyDef, tenantId, event.user.id, validateDb, ctx.services.secrets);
88
95
  },
89
96
  });
@@ -28,6 +28,7 @@ export const valuesQuery = defineQueryHandler({
28
28
  const resolver = requireConfigResolver(ctx, "config:query:values");
29
29
  const allKeys = registry.getAllConfigKeys();
30
30
  const keyDefs = new Map();
31
+ const declaredScopes = new Map();
31
32
  const filteredKeys = [];
32
33
  const requestedKeys = query.payload.keys === undefined ? undefined : new Set(query.payload.keys);
33
34
  for (const [qualifiedKey, keyDef] of allKeys) {
@@ -36,6 +37,7 @@ export const valuesQuery = defineQueryHandler({
36
37
  if (!hasConfigAccess(keyDef.access.read, query.user.roles))
37
38
  continue;
38
39
  keyDefs.set(qualifiedKey, keyDefAtScope(keyDef, query.payload.scope, query.user.roles));
40
+ declaredScopes.set(qualifiedKey, keyDef.scope);
39
41
  filteredKeys.push(qualifiedKey);
40
42
  }
41
43
  // Resolve through the full cascade (rows → app-override → computed →
@@ -62,7 +64,12 @@ export const valuesQuery = defineQueryHandler({
62
64
  else {
63
65
  value = cascade.value;
64
66
  }
65
- result[qualifiedKey] = { value, scope: keyDef.scope, source: cascade.source };
67
+ // The response scope is the key's declared one: a widened read scope must not turn into a write target.
68
+ result[qualifiedKey] = {
69
+ value,
70
+ scope: declaredScopes.get(qualifiedKey) ?? keyDef.scope,
71
+ source: cascade.source,
72
+ };
66
73
  }
67
74
  return result;
68
75
  },
@@ -2,7 +2,7 @@ import type { DbConnection } from "@cosmicdrift/kumiko-framework/db";
2
2
  import type { Registry } from "@cosmicdrift/kumiko-framework/engine";
3
3
  import type { EnvelopeCipher } from "@cosmicdrift/kumiko-framework/secrets";
4
4
  export type { ConfigContext } from "./feature.ts";
5
- export { createConfigAccessor, createConfigAccessorFactory, createConfigFeature, } from "./feature.ts";
5
+ export { createConfigAccessor, createConfigAccessorFactory, createConfigFeature, requireConfigResolver, } from "./feature.ts";
6
6
  export type { ReadinessMissingKey, RequiredKeyGate } from "./handlers/readiness.query.ts";
7
7
  export { buildProviderSelectionGate, collectMissingRequiredConfig, } from "./handlers/readiness.query.ts";
8
8
  export type { AppConfigOverrides, ConfigResolver } from "./resolver.ts";
@@ -1,6 +1,6 @@
1
1
  import { seedConfigValues } from "@cosmicdrift/kumiko-framework/db";
2
2
  import { configValueEntity, configValuesTable } from "./table.js";
3
- export { createConfigAccessor, createConfigAccessorFactory, createConfigFeature, } from "./feature.js";
3
+ export { createConfigAccessor, createConfigAccessorFactory, createConfigFeature, requireConfigResolver, } from "./feature.js";
4
4
  export { buildProviderSelectionGate, collectMissingRequiredConfig, } from "./handlers/readiness.query.js";
5
5
  export { buildEnvConfigOverrides, createConfigResolver, validateAppOverrides } from "./resolver.js";
6
6
  export { configValueEntity, configValuesTable } from "./table.js";
@@ -1,5 +1,6 @@
1
1
  import type { ConfigCascade, ConfigKeyDefinition } from "@cosmicdrift/kumiko-framework/engine";
2
2
  export declare const MASKED = "\u2022\u2022\u2022\u2022\u2022\u2022";
3
+ export declare function isSystemAdmin(roles: readonly string[]): boolean;
3
4
  export declare function mayViewInheritedValue(roles: readonly string[]): boolean;
4
5
  export declare function shouldRedactInherited(keyDef: Pick<ConfigKeyDefinition, "inheritedToTenant">, roles: readonly string[]): boolean;
5
6
  export declare function redactInheritedCascade(cascade: ConfigCascade): ConfigCascade;
@@ -1,4 +1,4 @@
1
- const SYSTEM_ADMIN_ROLE = "SystemAdmin";
1
+ import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
2
2
  // The viewer's own cascade rungs. Every other rung (system-row, app-override,
3
3
  // computed, default) carries a platform-inherited value — for an
4
4
  // inheritedToTenant:false key those must stay hidden from a tenant-side viewer.
@@ -16,8 +16,11 @@ const OWN_SOURCES = new Set(["user-row", "tenant-row"]);
16
16
  // functioning config. So "nor that it is set" holds for the value queries, not
17
17
  // for the functional readiness rollup. See readiness.query.ts.
18
18
  export const MASKED = "••••••";
19
+ export function isSystemAdmin(roles) {
20
+ return roles.includes(ROLES.SystemAdmin);
21
+ }
19
22
  export function mayViewInheritedValue(roles) {
20
- return roles.includes(SYSTEM_ADMIN_ROLE);
23
+ return isSystemAdmin(roles);
21
24
  }
22
25
  export function shouldRedactInherited(keyDef, roles) {
23
26
  return keyDef.inheritedToTenant === false && !mayViewInheritedValue(roles);
@@ -17,6 +17,7 @@ import { createEntity, createTextField } from "@cosmicdrift/kumiko-framework/eng
17
17
  // provides handlers (`reset.write.ts` etc.) with a typed Drizzle table ref.
18
18
  export const configValueEntity = createEntity({
19
19
  table: "read_config_values",
20
+ systemRowsReadable: true,
20
21
  fields: {
21
22
  key: createTextField({ required: true, personal: false, reason: "system_metadata" }),
22
23
  // value is JSON-encoded primitive (or encrypted blob). Nullable so a
@@ -5,6 +5,7 @@ import { fetchOne } from "@cosmicdrift/kumiko-framework/db";
5
5
  import { ConfigScopes, extensionSelectorTargets, isEncryptedAtRest, SYSTEM_ROLE, SYSTEM_TENANT_ID, selectablePluginIds, } from "@cosmicdrift/kumiko-framework/engine";
6
6
  import { AccessDeniedError, InternalError, NotFoundError, UnprocessableError, ValidationError, writeFailure, } from "@cosmicdrift/kumiko-framework/errors";
7
7
  import { assertUnreachable } from "@cosmicdrift/kumiko-framework/utils";
8
+ import { isSystemAdmin } from "./read-redaction.js";
8
9
  import { decryptStoredValue } from "./resolver.js";
9
10
  import { configValuesTable } from "./table.js";
10
11
  import { ConfigErrors } from "./web/constants.js";
@@ -102,7 +103,7 @@ export function checkScopeWriteAccess(scope, userRoles) {
102
103
  return null;
103
104
  if (userRoles.includes(SYSTEM_ROLE))
104
105
  return null;
105
- if (userRoles.includes("SystemAdmin"))
106
+ if (isSystemAdmin(userRoles))
106
107
  return null;
107
108
  return new AccessDeniedError({
108
109
  message: "system-scope config write requires SystemAdmin",
@@ -128,7 +129,7 @@ const SCOPE_LEVEL = {
128
129
  // Only a SystemAdmin may widen the read to the platform level; everyone else keeps the normal cascade.
129
130
  export function keyDefAtScope(keyDef, readScope, roles) {
130
131
  if (readScope === undefined ||
131
- !roles.includes("SystemAdmin") ||
132
+ !isSystemAdmin(roles) ||
132
133
  SCOPE_LEVEL[readScope] >= SCOPE_LEVEL[keyDef.scope]) {
133
134
  return keyDef;
134
135
  }
@@ -1,4 +1,5 @@
1
1
  export declare const CRYPTO_SHREDDING_FEATURE_NAME = "crypto-shredding";
2
+ export declare const FORGET_SUBJECT_QUALIFIED_NAME = "crypto-shredding:write:forget-subject";
2
3
  export declare const SUBJECT_FORGOTTEN_EVENT_NAME = "crypto-shredding:event:subject-forgotten";
3
4
  export declare const SUBJECT_FORGET_DENIED_EVENT_NAME = "crypto-shredding:event:forget-denied";
4
5
  export declare const CRYPTO_SHREDDING_AGGREGATE_TYPE = "crypto-shredding-subject";
@@ -1,4 +1,5 @@
1
1
  export const CRYPTO_SHREDDING_FEATURE_NAME = "crypto-shredding";
2
+ export const FORGET_SUBJECT_QUALIFIED_NAME = `${CRYPTO_SHREDDING_FEATURE_NAME}:write:forget-subject`;
2
3
  export const SUBJECT_FORGOTTEN_EVENT_NAME = "crypto-shredding:event:subject-forgotten";
3
4
  export const SUBJECT_FORGET_DENIED_EVENT_NAME = "crypto-shredding:event:forget-denied";
4
5
  export const CRYPTO_SHREDDING_AGGREGATE_TYPE = "crypto-shredding-subject";
@@ -9,12 +9,13 @@ import { purgeSearchDocumentsForSubject } from "@cosmicdrift/kumiko-framework/se
9
9
  import { generateId } from "@cosmicdrift/kumiko-framework/utils";
10
10
  import * as z from "zod";
11
11
  import { resolveRetentionPolicyForTenant } from "../../data-retention/index.js";
12
+ import { NOTES_HISTORY_FEATURE_NAME } from "../../notes-history/index.js";
12
13
  import { eraseNoteBodiesReachingSubject } from "../../notes-history-user-data/index.js";
13
14
  import { revokeAllPatTokensForUser } from "../../personal-access-tokens/index.js";
14
15
  import { purgeFilesReachingSubject } from "../../shared/index.js";
15
16
  import { USER_STATUS, userTable } from "../../user/index.js";
16
17
  import { denyIfTargetOutsideAdminTenant, isSystemAdminActor, updateUserLifecycle, } from "../../user-data-rights/index.js";
17
- import { CRYPTO_SHREDDING_AGGREGATE_TYPE, CRYPTO_SHREDDING_FEATURE_NAME, RECORD_ENTITY_NOT_REGISTERED, SUBJECT_FORGET_DENIED_EVENT_NAME, SUBJECT_FORGOTTEN_EVENT_NAME, TARGET_RECORD_NOT_ADMIN_TENANT, TARGET_RECORD_RETENTION_BLOCK_DELETE, TARGET_TENANT_NOT_ADMIN_TENANT, } from "../constants.js";
18
+ import { CRYPTO_SHREDDING_AGGREGATE_TYPE, CRYPTO_SHREDDING_FEATURE_NAME, FORGET_SUBJECT_QUALIFIED_NAME, RECORD_ENTITY_NOT_REGISTERED, SUBJECT_FORGET_DENIED_EVENT_NAME, SUBJECT_FORGOTTEN_EVENT_NAME, TARGET_RECORD_NOT_ADMIN_TENANT, TARGET_RECORD_RETENTION_BLOCK_DELETE, TARGET_TENANT_NOT_ADMIN_TENANT, } from "../constants.js";
18
19
  import { resolveFileBytesDeleter } from "../resolve-file-bytes-deleter.js";
19
20
  export { subjectIdSchema };
20
21
  export const forgetSubjectSchema = z.object({
@@ -37,6 +38,28 @@ export const subjectForgetDeniedSchema = z.object({
37
38
  actorTenantId: z.string().min(1),
38
39
  denial: z.string().min(1),
39
40
  });
41
+ function subjectOfInput(raw) {
42
+ switch (raw.kind) {
43
+ case "user":
44
+ return { kind: "user", userId: raw.userId };
45
+ case "tenant":
46
+ return { kind: "tenant", tenantId: raw.tenantId };
47
+ case "record":
48
+ return { kind: "record", entity: raw.entity, id: raw.id };
49
+ default: {
50
+ const unreachable = raw;
51
+ return unreachable;
52
+ }
53
+ }
54
+ }
55
+ // Called from another write handler (subjectForgetAfterDeleteHook), the caller's tx holds
56
+ // the uncommitted delete event on the subject's own stream; appending there from outside
57
+ // that tx would wait on it forever, so the event goes onto a fresh stream.
58
+ function forgottenEventAggregateId(raw) {
59
+ const entryHandlerQn = requestContext.get()?.entryHandler?.qn;
60
+ const nestedInCallerTransaction = entryHandlerQn !== undefined && entryHandlerQn !== FORGET_SUBJECT_QUALIFIED_NAME;
61
+ return nestedInCallerTransaction ? generateId() : subjectAggregateId(raw);
62
+ }
40
63
  // Exhaustive switch so a 4th subject kind fails to compile instead of
41
64
  // silently aggregating under the wrong id.
42
65
  function subjectAggregateId(raw) {
@@ -235,7 +258,7 @@ async function sweepDerivedSubjectData(ctx, subject, subjectKey, crossTenantRunn
235
258
  await purgeSearchDocumentsForSubject(crossTenantSubjectRunner, ctx.registry.features, ctx.services.searchAdapter, subjectKey, subject);
236
259
  }
237
260
  // Note bodies are keyed per note, so the subject's own key never reaches them.
238
- if (ctx.registry.features.has("notes-history")) {
261
+ if (ctx.registry.features.has(NOTES_HISTORY_FEATURE_NAME)) {
239
262
  await eraseNoteBodiesReachingSubject({
240
263
  db: crossTenantSubjectRunner,
241
264
  subject,
@@ -353,11 +376,7 @@ export const forgetSubjectWrite = defineWriteHandler({
353
376
  }));
354
377
  }
355
378
  const raw = event.payload.subject;
356
- const subject = raw.kind === "user"
357
- ? { kind: "user", userId: raw.userId }
358
- : raw.kind === "tenant"
359
- ? { kind: "tenant", tenantId: raw.tenantId }
360
- : { kind: "record", entity: raw.entity, id: raw.id };
379
+ const subject = subjectOfInput(raw);
361
380
  const subjectKey = subjectIdToKey(subject);
362
381
  const tenantScopeDenial = await resolveTenantScopeDenial(ctx.db.unsafeRaw(), ctx.registry.features, event.user, raw);
363
382
  if (tenantScopeDenial) {
@@ -397,19 +416,21 @@ export const forgetSubjectWrite = defineWriteHandler({
397
416
  // crash recovery is safe. User-feature guard: without the user feature
398
417
  // read_users doesn't exist (crypto-only stack). Tenant subjects have no
399
418
  // credentials.
400
- // Runs before the sweep and in its own transaction: a failing sweep rolls the
401
- // handler transaction back, and the handler tx holds no lock on this user's
402
- // read_users row yet (only read gates ran), so there is no lock conflict.
419
+ // Door close and audit event commit on the outside-transaction db, before the sweep:
420
+ // the key erase above is irreversible, so neither may roll back with the handler tx
421
+ // (sweep failure, a later subject, a later hook, a failed commit). The handler tx holds
422
+ // no lock on this user's read_users row yet (only read gates ran).
423
+ const outsideRunner = ctx.db.outsideTransaction?.unsafeRaw();
403
424
  if (raw.kind === "user" && ctx.registry.features.has("user")) {
404
- await closeUserLoginDoor(ctx, raw.userId, ctx.db.outsideTransaction?.unsafeRaw(), ctx.db.unsafeRaw());
425
+ await closeUserLoginDoor(ctx, raw.userId, outsideRunner, ctx.db.unsafeRaw());
405
426
  }
406
427
  const cleanupError = await sweepDerivedSubjectData(ctx, subject, subjectKey, ctx.db.unsafeRaw(), { requestId, erasedBy: event.user.id }, raw);
407
- await appendSubjectForgotten(ctx, event, subjectAggregateId(raw), {
428
+ await appendSubjectForgotten(ctx, event, forgottenEventAggregateId(raw), {
408
429
  subjectKey,
409
430
  reason: event.payload.reason,
410
431
  forgottenBy: event.user.id,
411
432
  ...(cleanupError !== undefined && { cleanupError }),
412
- }, ctx.db.outsideTransaction?.unsafeRaw());
433
+ }, outsideRunner);
413
434
  if (cleanupError !== undefined) {
414
435
  throw new InternalError({
415
436
  message: `[crypto-shredding] forget-subject erased the key but a derived-data sweep failed (${cleanupError}); retry to finish the cleanup.`,
@@ -2,3 +2,4 @@ export { CRYPTO_SHREDDING_AGGREGATE_TYPE, CRYPTO_SHREDDING_FEATURE_NAME, SUBJECT
2
2
  export { kmsEnvSchema } from "./env/index.ts";
3
3
  export { createCryptoShreddingFeature } from "./feature.ts";
4
4
  export { forgetSubjectSchema, subjectForgetDeniedSchema, subjectForgottenSchema, subjectIdSchema, } from "./handlers/forget-subject.write.ts";
5
+ export { type SubjectForgetAfterDeleteOptions, subjectForgetAfterDeleteHook, } from "./subject-forget-after-delete-hook.ts";
@@ -2,3 +2,4 @@ export { CRYPTO_SHREDDING_AGGREGATE_TYPE, CRYPTO_SHREDDING_FEATURE_NAME, SUBJECT
2
2
  export { kmsEnvSchema } from "./env/index.js";
3
3
  export { createCryptoShreddingFeature } from "./feature.js";
4
4
  export { forgetSubjectSchema, subjectForgetDeniedSchema, subjectForgottenSchema, subjectIdSchema, } from "./handlers/forget-subject.write.js";
5
+ export { subjectForgetAfterDeleteHook, } from "./subject-forget-after-delete-hook.js";