@cosmicdrift/kumiko-bundled-features 0.413.0 → 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 +4 -7
  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 +18 -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 +62 -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
@@ -7,8 +7,8 @@ export type AddressMatch = {
7
7
  readonly status: string;
8
8
  };
9
9
  export declare function normalizeMailAddress(address: string): string;
10
- export declare function findMailboxByAddress(ctx: Pick<HandlerContext, "db">, tenantId: string, address: string): Promise<AddressMatch | undefined>;
11
- export type ConnectConflict = "already_connected" | "address_disconnected" | "reopen_in_place";
10
+ export declare function findMailboxByAddress(ctx: Pick<HandlerContext, "db">, tenantId: string, address: string, wantedOwnerUserId: string | null): Promise<AddressMatch | undefined>;
11
+ export type ConnectConflict = "already_connected" | "address_disconnected" | "reopen_in_place" | "replace_disconnected_personal";
12
12
  export declare function connectConflictOf(existing: AddressMatch, wanted: {
13
13
  readonly authMethod: string;
14
14
  readonly provider: string;
@@ -11,7 +11,9 @@ function textOf(value) {
11
11
  return typeof value === "string" ? value : "";
12
12
  }
13
13
  // A live mailbox wins over a disconnected one: connecting next to a live mailbox is always a duplicate.
14
- export async function findMailboxByAddress(ctx, tenantId, address) {
14
+ // Among equals the mailbox of the wanted owner kind (shared or personal) wins, then the smallest id,
15
+ // so the outcome does not depend on projection row order.
16
+ export async function findMailboxByAddress(ctx, tenantId, address, wantedOwnerUserId) {
15
17
  const wanted = normalizeMailAddress(address);
16
18
  const rows = await ctx.db.selectMany(mailAccountsProjectionTable, { tenantId });
17
19
  const piiKms = configuredPiiSubjectKms();
@@ -32,7 +34,9 @@ export async function findMailboxByAddress(ctx, tenantId, address) {
32
34
  status: textOf(row["status"]),
33
35
  });
34
36
  }
35
- return matches.find((m) => m.status !== InboundMailAccountStatuses.disconnected) ?? matches[0];
37
+ const rank = (m) => (m.status === InboundMailAccountStatuses.disconnected ? 2 : 0) +
38
+ ((m.ownerUserId === null) === (wantedOwnerUserId === null) ? 0 : 1);
39
+ return [...matches].sort((a, b) => rank(a) - rank(b) || a.id.localeCompare(b.id))[0];
36
40
  }
37
41
  // A disconnected or sign-in-failed OAuth mailbox of the same provider and owner is reopened (the
38
42
  // callback writes the new token into the same slot); everything else must not silently create a second stream for one address.
@@ -42,6 +46,10 @@ export function connectConflictOf(existing, wanted) {
42
46
  const signInFailed = existing.status === InboundMailAccountStatuses.authError;
43
47
  if (!disconnected && !signInFailed)
44
48
  return "already_connected";
49
+ // A member's disconnected personal mailbox must not lock the address for the team's shared one.
50
+ if (disconnected && wanted.ownerUserId === null && existing.ownerUserId !== null) {
51
+ return "replace_disconnected_personal";
52
+ }
45
53
  const bothOauth = wanted.authMethod === InboundMailAuthMethods.oauth &&
46
54
  existing.authMethod === InboundMailAuthMethods.oauth &&
47
55
  existing.provider === wanted.provider;
@@ -28,10 +28,12 @@ function hasContentAlready(events) {
28
28
  });
29
29
  }
30
30
  const receivedOwnerSchema = z.object({ ownerUserId: z.string().nullable() });
31
- function ownerUserIdOfStream(events) {
31
+ // `null` inside the result means a shared mailbox; an unreadable stream has no result at all, so a
32
+ // personal mail can never fall through to the shared routing.
33
+ function ownerOfStream(events) {
32
34
  const received = events.find((e) => e.type === INBOUND_MESSAGE_RECEIVED_EVENT_QN);
33
35
  const parsed = receivedOwnerSchema.safeParse(received?.payload);
34
- return parsed.success ? parsed.data.ownerUserId : null;
36
+ return parsed.success ? { ownerUserId: parsed.data.ownerUserId } : undefined;
35
37
  }
36
38
  // Read before the transaction, so it can only skip work: a row that already shows attached content
37
39
  // spares parallel refetches the upload. The event check under the message lock stays authoritative.
@@ -108,12 +110,15 @@ export const attachMessageContentHandler = defineWriteHandler({
108
110
  if (hasContentAlready(events)) {
109
111
  return { isSuccess: true, data: { duplicate: true } };
110
112
  }
113
+ const owner = ownerOfStream(events);
114
+ if (owner === undefined)
115
+ return failNotFound("inbound-message-received-event", messageAggId);
111
116
  const content = payload.outcome !== "fetched"
112
117
  ? undefined
113
118
  : prepared
114
119
  ? await finalizePreparedContent(ctx, prepared)
115
120
  : await storeInboundMessageContent(ctx, contentInputOf(payload, messageAggId));
116
- const eventPayload = await contentEventPayloadOf(payload, content, tenantId, messageAggId, ownerUserIdOfStream(events));
121
+ const eventPayload = await contentEventPayloadOf(payload, content, tenantId, messageAggId, owner.ownerUserId);
117
122
  const appended = await ctx.events.tryAppend({
118
123
  aggregateId: messageAggId,
119
124
  aggregateType: INBOUND_MESSAGE_AGGREGATE_TYPE,
@@ -12,7 +12,7 @@
12
12
  // stays fast and offline-capable (the test result arrives asynchronously
13
13
  // as a status transition).
14
14
  // - No second account for one address: a live or disconnected address is
15
- // refused (409 reasons in InboundMailConnectErrors); only a disconnected or
15
+ // refused (a disconnected personal mailbox gives way to a shared one) (409 reasons in InboundMailConnectErrors); only a disconnected or
16
16
  // sign-in-failed OAuth mailbox is reopened in place, keeping its account id and cursor.
17
17
  // The reopen returns the existing id and changes nothing yet; the callback re-arms it.
18
18
  import { configuredPiiSubjectKms, encryptPiiFieldValues, } from "@cosmicdrift/kumiko-framework/crypto";
@@ -22,7 +22,9 @@ import { InboundMailAccountStatuses, InboundMailAuthMethods, InboundMailConnectE
22
22
  import { MAIL_ACCOUNT_PII_FIELDS, mailAccountEntity } from "../entities.js";
23
23
  import { MAIL_ACCOUNT_AGGREGATE_TYPE, MAIL_ACCOUNT_CONNECTED_EVENT_QN, } from "../events.js";
24
24
  import { accessRolesOf } from "../mail-roles.js";
25
- import { connectConflictOf, findMailboxByAddress } from "./account-address.js";
25
+ import { connectConflictOf, findMailboxByAddress, normalizeMailAddress, } from "./account-address.js";
26
+ // 'inma': serializes the duplicate-address check and the append per tenant and address (the lock key is tenant-scoped).
27
+ const CONNECT_ADDRESS_LOCK_NAMESPACE = 0x696e6d61;
26
28
  export const connectAccountSchema = z
27
29
  .object({
28
30
  /** Provider key registered with the extension ("imap",
@@ -70,7 +72,8 @@ export function createConnectAccountHandler({ adminRoles }) {
70
72
  : payload.scope === "user"
71
73
  ? event.user.id
72
74
  : null;
73
- const existing = await findMailboxByAddress(ctx, tenantId, payload.address);
75
+ await ctx.db.advisoryXactLock(CONNECT_ADDRESS_LOCK_NAMESPACE, normalizeMailAddress(payload.address));
76
+ const existing = await findMailboxByAddress(ctx, tenantId, payload.address, ownerUserId);
74
77
  if (existing) {
75
78
  const matched = connectConflictOf(existing, {
76
79
  authMethod: payload.authMethod,
@@ -90,10 +93,12 @@ export function createConnectAccountHandler({ adminRoles }) {
90
93
  data: { accountId: existing.id, reconnected: true },
91
94
  };
92
95
  }
93
- const { reason, i18nKey } = conflict === "address_disconnected"
94
- ? InboundMailConnectErrors.addressDisconnected
95
- : InboundMailConnectErrors.addressAlreadyConnected;
96
- return writeFailure(new UnprocessableError(reason, { i18nKey }));
96
+ if (conflict !== "replace_disconnected_personal") {
97
+ const { reason, i18nKey } = conflict === "address_disconnected"
98
+ ? InboundMailConnectErrors.addressDisconnected
99
+ : InboundMailConnectErrors.addressAlreadyConnected;
100
+ return writeFailure(new UnprocessableError(reason, { i18nKey }));
101
+ }
97
102
  }
98
103
  // PII-encrypt the address before the append. This is the only write path to
99
104
  // the stream, so it covers both the event log and the projection.
@@ -0,0 +1,7 @@
1
+ import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
2
+ import * as z from "zod";
3
+ import type { InboundMailRoles } from "../mail-roles.ts";
4
+ export declare const forgetMessageSchema: z.ZodObject<{
5
+ messageId: z.ZodUUID;
6
+ }, z.core.$strip>;
7
+ export declare function createForgetMessageHandler({ memberRoles, adminRoles, }: InboundMailRoles): WriteHandlerDef;
@@ -0,0 +1,54 @@
1
+ import { AccessDeniedError, failNotFound, writeFailure, } from "@cosmicdrift/kumiko-framework/errors";
2
+ import { deleteFileRefsBoundToRecord } from "@cosmicdrift/kumiko-framework/files";
3
+ import * as z from "zod";
4
+ import { INBOUND_MESSAGE_AGGREGATE_TYPE } from "../events.js";
5
+ import { inboundMessagesProjectionTable } from "../projection.js";
6
+ import { purgeInboundMessages } from "../purge-messages.js";
7
+ import { isVisibleToCaller, mayReactivateMailbox } from "./scope-visibility.js";
8
+ export const forgetMessageSchema = z.object({ messageId: z.uuid() });
9
+ const FORGET_REASON = "forgotten_by_user";
10
+ export function createForgetMessageHandler({ memberRoles, adminRoles, }) {
11
+ return {
12
+ name: "forget-message",
13
+ schema: forgetMessageSchema,
14
+ access: { roles: [...memberRoles] },
15
+ agent: { risk: "high" },
16
+ description: "Permanently removes one imported mail: the read row, the stored original and its attachment files; the mail cannot be restored and a later sync does not import it again. The owner of a personal mailbox or, for a shared one, an admin may call it; a mail of someone else's personal mailbox is reported as not found.",
17
+ handler: async (event, ctx) => {
18
+ const { messageId } = forgetMessageSchema.parse(event.payload);
19
+ const [row] = await ctx.db.selectMany(inboundMessagesProjectionTable, { id: messageId });
20
+ if (!row || !isVisibleToCaller(row, event.user)) {
21
+ return failNotFound("inbound-message", messageId);
22
+ }
23
+ if (!mayReactivateMailbox(row.ownerUserId, event.user, adminRoles)) {
24
+ return writeFailure(new AccessDeniedError({ details: { reason: "not_mailbox_owner" } }));
25
+ }
26
+ const { files } = ctx.services;
27
+ const purged = await purgeInboundMessages({
28
+ db: ctx.db,
29
+ tenantId: event.user.tenantId,
30
+ rows: [row],
31
+ archive: (id) => ctx.events.archive(id, {
32
+ aggregateType: INBOUND_MESSAGE_AGGREGATE_TYPE,
33
+ reason: FORGET_REASON,
34
+ }),
35
+ deleteBodyObject: files
36
+ ? (bodyRef) => files.refFromFileRef({ storageKey: bodyRef }).delete()
37
+ : undefined,
38
+ deleteAttachments: async (id) => {
39
+ await deleteFileRefsBoundToRecord({
40
+ db: ctx.db,
41
+ user: event.user,
42
+ entityType: INBOUND_MESSAGE_AGGREGATE_TYPE,
43
+ entityId: id,
44
+ });
45
+ },
46
+ });
47
+ // Rolls the archive back: a half-deleted mail must stay retryable.
48
+ if (purged.failedIds.length > 0) {
49
+ throw new Error(`forget-message: the stored files of ${messageId} could not be deleted`);
50
+ }
51
+ return { isSuccess: true, data: { forgotten: true } };
52
+ },
53
+ };
54
+ }
@@ -44,6 +44,9 @@ export const INBOUND_MAIL_FOUNDATION_I18N = {
44
44
  [InboundMailConnectErrors.addressDisconnected.i18nKey]: {
45
45
  en: "This mailbox was disconnected before. Use Reactivate in the mailbox list to keep its history.",
46
46
  },
47
+ [InboundMailConnectErrors.personalAddressNotOwn.i18nKey]: {
48
+ en: "A personal mailbox can only be connected with the email address of your own account. An admin connects other addresses as a shared mailbox.",
49
+ },
47
50
  "inboundMail.accounts.acknowledgeQuarantine": { en: "Confirm quarantine" },
48
51
  [`${MAIL_ACCOUNT_STATUS_OPTION_KEY_PREFIX}${InboundMailAccountStatuses.active}`]: {
49
52
  en: "Active",
@@ -16,6 +16,7 @@ export { createOAuthAccessTokenManager, inboundRefreshTokenSecretOptions, type O
16
16
  export { type OAuthStatePayload, signOAuthState, type VerifyOAuthStateResult, verifyOAuthState, } from "./oauth-state.ts";
17
17
  export { readableFileName } from "./outbound-attachments.ts";
18
18
  export { isMailSendNotConfiguredError, isMailSendRejectedError, MailSendNotConfiguredError, MailSendRejectedError, OUTBOUND_ATTACHMENTS_MAX_BYTES, type OutboundAttachment, type OutboundMailMessage, type OutboundMailSent, outboundMailMessageSchema, type ProviderSentMail, } from "./outbound-mail.ts";
19
+ export { isOwnLoginAddress } from "./personal-address.ts";
19
20
  export { inboundMessagesProjectionTable, mailAccountsProjectionTable, mailThreadsProjectionTable, } from "./projection.ts";
20
21
  export { InboundAuthError, InboundCredentialNotStoredError, InboundCursorInvalidError, InboundRateLimitError, InboundTransientError, isInboundAuthError, isInboundCredentialNotStoredError, isInboundCursorInvalidError, isInboundRateLimitError, isInboundTransientError, } from "./provider-errors.ts";
21
22
  export { resolveInboundProviderForAccount, resolveInboundProviderForKey, } from "./provider-factory.ts";
@@ -16,6 +16,7 @@ export { createOAuthAccessTokenManager, inboundRefreshTokenSecretOptions, usesFo
16
16
  export { signOAuthState, verifyOAuthState, } from "./oauth-state.js";
17
17
  export { readableFileName } from "./outbound-attachments.js";
18
18
  export { isMailSendNotConfiguredError, isMailSendRejectedError, MailSendNotConfiguredError, MailSendRejectedError, OUTBOUND_ATTACHMENTS_MAX_BYTES, outboundMailMessageSchema, } from "./outbound-mail.js";
19
+ export { isOwnLoginAddress } from "./personal-address.js";
19
20
  export { inboundMessagesProjectionTable, mailAccountsProjectionTable, mailThreadsProjectionTable, } from "./projection.js";
20
21
  export { InboundAuthError, InboundCredentialNotStoredError, InboundCursorInvalidError, InboundRateLimitError, InboundTransientError, isInboundAuthError, isInboundCredentialNotStoredError, isInboundCursorInvalidError, isInboundRateLimitError, isInboundTransientError, } from "./provider-errors.js";
21
22
  export { resolveInboundProviderForAccount, resolveInboundProviderForKey, } from "./provider-factory.js";
@@ -103,7 +103,7 @@ export function createOAuthAccessTokenManager(deps) {
103
103
  if (hit !== undefined)
104
104
  return hit;
105
105
  const running = inFlight.get(account.id);
106
- if (running)
106
+ if (running !== undefined)
107
107
  return running;
108
108
  const started = refresh(account, plugin)
109
109
  .catch((err) => {
@@ -22,6 +22,8 @@ export type OutboundAttachment = {
22
22
  export type ProviderSentMail = {
23
23
  /** Message-ID header of the sent mail, without angle brackets. */
24
24
  readonly messageIdHeader: string;
25
+ /** Recipients the outgoing server refused while accepting the others; absent when all were accepted. */
26
+ readonly rejectedRecipients?: readonly string[];
25
27
  };
26
28
  export type OutboundMailSent = ProviderSentMail & {
27
29
  /** The file references that went out as attachments, for the caller's own record of the mail. */
@@ -0,0 +1 @@
1
+ export declare function isOwnLoginAddress(userRow: unknown, address: string): Promise<boolean>;
@@ -0,0 +1,16 @@
1
+ import * as z from "zod";
2
+ import { decryptStoredUserEmail } from "../shared/index.js";
3
+ const userRowSchema = z.object({
4
+ email: z.string().optional(),
5
+ isDeleted: z.boolean().nullish(),
6
+ });
7
+ // A personal mailbox may only carry the caller's own login address: the login check of a password
8
+ // IMAP server (or the OAuth consent) does not bind the address, so a free choice would let a member
9
+ // claim info@firma.de. `userRow` is the user:find-for-auth row of the session user, never payload data.
10
+ export async function isOwnLoginAddress(userRow, address) {
11
+ const row = userRowSchema.safeParse(userRow);
12
+ if (!row.success || !row.data.email || row.data.isDeleted === true)
13
+ return false;
14
+ const own = await decryptStoredUserEmail(row.data.email, "inbound-mail-foundation:personal-address");
15
+ return own !== null && own.trim().toLowerCase() === address.trim().toLowerCase();
16
+ }
@@ -0,0 +1,20 @@
1
+ import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { deleteRowsWithoutReplayableStream } from "@cosmicdrift/kumiko-framework/event-store";
3
+ export type PurgeableMessageRow = {
4
+ readonly id: string;
5
+ readonly bodyRef: string | null;
6
+ };
7
+ export interface PurgeInboundMessagesArgs {
8
+ readonly db: Parameters<typeof deleteRowsWithoutReplayableStream>[0];
9
+ readonly tenantId: TenantId;
10
+ readonly rows: readonly PurgeableMessageRow[];
11
+ readonly archive: (messageId: string) => Promise<void>;
12
+ readonly deleteBodyObject?: ((bodyRef: string) => Promise<void>) | undefined;
13
+ readonly deleteAttachments?: ((messageId: string) => Promise<void>) | undefined;
14
+ }
15
+ export interface PurgeInboundMessagesResult {
16
+ readonly purgedIds: readonly string[];
17
+ readonly failedIds: readonly string[];
18
+ readonly bodyObjectsDeleted: number;
19
+ }
20
+ export declare function purgeInboundMessages(args: PurgeInboundMessagesArgs): Promise<PurgeInboundMessagesResult>;
@@ -0,0 +1,33 @@
1
+ import { deleteRowsWithoutReplayableStream } from "@cosmicdrift/kumiko-framework/event-store";
2
+ import { inboundMessagesProjectionTable } from "./projection.js";
3
+ // Archive first, delete the row last and strictly by the archived ids: a crash in between leaves an
4
+ // archived stream the next run finishes, and a row is never deleted while its stream could replay.
5
+ // A row whose body or attachment delete fails stays, otherwise the only reference to the object is lost.
6
+ export async function purgeInboundMessages(args) {
7
+ const purgedCandidates = [];
8
+ const failedIds = [];
9
+ let bodyObjectsDeleted = 0;
10
+ for (const row of args.rows) {
11
+ await args.archive(row.id);
12
+ try {
13
+ if (row.bodyRef && args.deleteBodyObject) {
14
+ await args.deleteBodyObject(row.bodyRef);
15
+ bodyObjectsDeleted++;
16
+ }
17
+ await args.deleteAttachments?.(row.id);
18
+ }
19
+ catch {
20
+ failedIds.push(row.id);
21
+ continue;
22
+ }
23
+ purgedCandidates.push(row.id);
24
+ }
25
+ const purgedIds = purgedCandidates.length === 0
26
+ ? []
27
+ : await deleteRowsWithoutReplayableStream(args.db, {
28
+ table: inboundMessagesProjectionTable,
29
+ ids: purgedCandidates,
30
+ tenantId: args.tenantId,
31
+ });
32
+ return { purgedIds, failedIds, bodyObjectsDeleted };
33
+ }
@@ -8,6 +8,7 @@ type QuarantineTarget = {
8
8
  };
9
9
  /** Returns true when a new row was written, false when the message was already quarantined. */
10
10
  export declare function quarantineMessage(db: DbConnection, target: QuarantineTarget, reasonCode: QuarantineReasonCode): Promise<boolean>;
11
- export declare function quarantinedMessageIds(db: DbConnection, accountId: string, providerMessageIds: readonly string[]): Promise<ReadonlySet<string>>;
12
- export declare function hasOpenQuarantine(db: DbConnection, accountId: string): Promise<boolean>;
11
+ type QuarantineAccount = Pick<QuarantineTarget, "tenantId" | "accountId">;
12
+ export declare function quarantinedMessageIds(db: DbConnection, { tenantId, accountId }: QuarantineAccount, providerMessageIds: readonly string[]): Promise<ReadonlySet<string>>;
13
+ export declare function hasOpenQuarantine(db: DbConnection, { tenantId, accountId }: QuarantineAccount): Promise<boolean>;
13
14
  export {};
@@ -8,13 +8,16 @@ const LOOKUP_CHUNK_SIZE = 1000;
8
8
  export const QUARANTINE_ACKNOWLEDGED_RETENTION_DAYS = 90;
9
9
  /** Returns true when a new row was written, false when the message was already quarantined. */
10
10
  export async function quarantineMessage(db, target, reasonCode) {
11
- const key = { accountId: target.accountId, providerMessageId: target.providerMessageId };
11
+ const key = {
12
+ tenantId: target.tenantId,
13
+ accountId: target.accountId,
14
+ providerMessageId: target.providerMessageId,
15
+ };
12
16
  if (await fetchOne(db, quarantineTable, key))
13
17
  return false;
14
18
  try {
15
19
  await insertOne(db, quarantineTable, {
16
20
  id: crypto.randomUUID(),
17
- tenantId: target.tenantId,
18
21
  ...key,
19
22
  reasonCode,
20
23
  quarantinedAt: Temporal.Now.instant().toString(),
@@ -28,10 +31,11 @@ export async function quarantineMessage(db, target, reasonCode) {
28
31
  throw err;
29
32
  }
30
33
  }
31
- export async function quarantinedMessageIds(db, accountId, providerMessageIds) {
34
+ export async function quarantinedMessageIds(db, { tenantId, accountId }, providerMessageIds) {
32
35
  const ids = new Set();
33
36
  for (let start = 0; start < providerMessageIds.length; start += LOOKUP_CHUNK_SIZE) {
34
37
  const rows = await selectMany(db, quarantineTable, {
38
+ tenantId,
35
39
  accountId,
36
40
  providerMessageId: { in: providerMessageIds.slice(start, start + LOOKUP_CHUNK_SIZE) },
37
41
  }, { fields: ["providerMessageId"] });
@@ -40,7 +44,7 @@ export async function quarantinedMessageIds(db, accountId, providerMessageIds) {
40
44
  }
41
45
  return ids;
42
46
  }
43
- export async function hasOpenQuarantine(db, accountId) {
44
- const rows = await selectMany(db, quarantineTable, { accountId, acknowledgedAt: null }, { fields: ["id"], limit: 1 });
47
+ export async function hasOpenQuarantine(db, { tenantId, accountId }) {
48
+ const rows = await selectMany(db, quarantineTable, { tenantId, accountId, acknowledgedAt: null }, { fields: ["id"], limit: 1 });
45
49
  return rows.length > 0;
46
50
  }
@@ -18,11 +18,7 @@ export function registerInboundMailRetentionJob(r) {
18
18
  if (!ctx.registry) {
19
19
  throw new Error("inbound-mail-retention: ctx.registry required (JobContext incomplete)");
20
20
  }
21
- const tenantId = ctx.systemUser?.tenantId ?? ctx._tenantId;
22
- if (tenantId === undefined) {
23
- // skip: cron fired without a perTenant fan-out tenant — nothing scoped
24
- return;
25
- }
21
+ const tenantId = ctx.systemUser.tenantId;
26
22
  const T = (await import("@cosmicdrift/kumiko-framework/time")).getTemporal();
27
23
  const retentionDb = ctx.db.unsafeRaw(); // @cast-boundary db-operator — jobs never run inside a DbTx
28
24
  // Original (.eml/.html) objects live in file-foundation; the provider is lazy and
@@ -38,11 +38,12 @@
38
38
  // The read Row and body file are gone after the sweep; the event log is
39
39
  // append-only by design.
40
40
  import { deleteMany, selectMany } from "@cosmicdrift/kumiko-framework/db";
41
- import { archiveStream, deleteRowsWithoutReplayableStream, } from "@cosmicdrift/kumiko-framework/event-store";
41
+ import { archiveStream } from "@cosmicdrift/kumiko-framework/event-store";
42
42
  import { seenMessageTable } from "./entities.js";
43
43
  import { INBOUND_MESSAGE_AGGREGATE_TYPE } from "./events.js";
44
44
  import { ingestFailureTable } from "./ingest-failures.js";
45
45
  import { inboundMessagesProjectionTable } from "./projection.js";
46
+ import { purgeInboundMessages } from "./purge-messages.js";
46
47
  import { QUARANTINE_ACKNOWLEDGED_RETENTION_DAYS } from "./quarantine.js";
47
48
  import { quarantineTable } from "./quarantine-entities.js";
48
49
  export const MESSAGE_RETENTION_DAYS = 365;
@@ -91,37 +92,25 @@ async function purgeExpiredMessages(args, cutoff) {
91
92
  const rows = (await selectMany(args.db, inboundMessagesProjectionTable, { receivedAt: { lt: cutoff }, tenantId: args.tenantId }, { limit: BATCH_LIMIT })).filter((row) => !failedIds.has(row.id));
92
93
  if (rows.length === 0)
93
94
  break;
94
- const ids = [];
95
- for (const row of rows) {
96
- await archiveStream(args.db, {
95
+ const purged = await purgeInboundMessages({
96
+ db: args.db,
97
+ tenantId: args.tenantId,
98
+ rows,
99
+ archive: (messageId) => archiveStream(args.db, {
97
100
  tenantId: args.tenantId,
98
- aggregateId: row.id,
101
+ aggregateId: messageId,
99
102
  aggregateType: INBOUND_MESSAGE_AGGREGATE_TYPE,
100
103
  archivedBy: ARCHIVED_BY,
101
104
  reason: REASON,
102
- });
103
- try {
104
- if (row.bodyRef && args.deleteBodyObject) {
105
- await args.deleteBodyObject(row.bodyRef);
106
- bodyObjectsDeleted++;
107
- }
108
- await args.deleteAttachments?.(row.id);
109
- }
110
- catch {
111
- bodyObjectErrors++;
112
- failedIds.add(row.id);
113
- continue;
114
- }
115
- ids.push(row.id);
116
- }
117
- if (ids.length > 0) {
118
- const deleted = await deleteRowsWithoutReplayableStream(args.db, {
119
- table: inboundMessagesProjectionTable,
120
- ids,
121
- tenantId: args.tenantId,
122
- });
123
- messagesPurged += deleted.length;
124
- }
105
+ }),
106
+ deleteBodyObject: args.deleteBodyObject,
107
+ deleteAttachments: args.deleteAttachments,
108
+ });
109
+ messagesPurged += purged.purgedIds.length;
110
+ bodyObjectsDeleted += purged.bodyObjectsDeleted;
111
+ bodyObjectErrors += purged.failedIds.length;
112
+ for (const id of purged.failedIds)
113
+ failedIds.add(id);
125
114
  if (rows.length < BATCH_LIMIT)
126
115
  break;
127
116
  }
@@ -61,6 +61,10 @@ function sendFailureOf(err) {
61
61
  function isSendableBy(row, user) {
62
62
  return row.status !== InboundMailAccountStatuses.disconnected && isVisibleToCaller(row, user);
63
63
  }
64
+ // Sends immediately and cannot be rolled back. Call it from a handler's `beforeTransaction`
65
+ // (its ctx fits here): in the handler body the request transaction would stay open for the whole
66
+ // SMTP/IMAP round trip, and a later rollback would not recall the mail. Pass the result on as the
67
+ // hook's data; a client retry after a failed handler still sends a second copy.
64
68
  export async function sendMailFromAccount(ctx, input) {
65
69
  const message = outboundMailMessageSchema.safeParse(input.message);
66
70
  if (!message.success)
@@ -88,7 +92,11 @@ export async function sendMailFromAccount(ctx, input) {
88
92
  const sent = await plugin.send(providerCtx, account, message.data, resolved.attachments);
89
93
  return {
90
94
  isSuccess: true,
91
- data: { messageIdHeader: sent.messageIdHeader, attachmentFileIds: resolved.fileIds },
95
+ data: {
96
+ messageIdHeader: sent.messageIdHeader,
97
+ attachmentFileIds: resolved.fileIds,
98
+ ...(sent.rejectedRecipients && { rejectedRecipients: sent.rejectedRecipients }),
99
+ },
92
100
  };
93
101
  }
94
102
  catch (err) {
@@ -85,7 +85,8 @@ export function createMessageIngester(deps) {
85
85
  async function attempt(account, raw, cursorSnapshot) {
86
86
  try {
87
87
  const msg = normalizeRawInboundMessage(raw);
88
- const bodyRef = await storeBodyOf(account, raw);
88
+ // Normalization drops an oversized original; the hook must not store what ingest then discards.
89
+ const bodyRef = await storeBodyOf(account, msg.rawMime === null ? { ...raw, rawMime: null } : raw);
89
90
  const result = await deps.dispatchWrite({
90
91
  handlerQn: InboundMailFoundationHandlers.ingestMessage,
91
92
  tenantId: account.tenantId,
@@ -160,6 +161,8 @@ export function createMessageIngester(deps) {
160
161
  let storageHealthy = options.proof?.storageHealthy ?? false;
161
162
  const failures = [];
162
163
  for (const msg of msgs) {
164
+ // An abandoned sync (deadline) must stop storing mail while the next sync of the account runs.
165
+ options.signal?.throwIfAborted();
163
166
  const result = await attempt(account, msg, cursorSnapshot);
164
167
  if (result.kind === "permanent") {
165
168
  const headerOnly = headerOnlyOf(msg);
@@ -4,7 +4,7 @@
4
4
  /** Runs `run` unless a sync for the account is already in flight; then returns that one instead. */
5
5
  export function runExclusivePerAccount(inFlight, accountId, run) {
6
6
  const running = inFlight.get(accountId);
7
- if (running)
7
+ if (running !== undefined)
8
8
  return running;
9
9
  const started = run().finally(() => {
10
10
  inFlight.delete(accountId);
@@ -22,11 +22,8 @@ import { inboundMessagesProjectionTable, mailAccountsProjectionTable, mailThread
22
22
  import { quarantineTable } from "./quarantine-entities.js";
23
23
  // archiveStream sits outside TenantDb's own methods — needs the escape hatch.
24
24
  export const INBOUND_MAIL_TENANT_DESTROY_ARCHIVE_REASON = "tenant-destroy archives each inbound-mail entity's event-streams before the projection rows are deleted";
25
- function archiveAndDeleteRows(ctx, table, aggregateType) {
26
- return archiveAndDeleteTenantRows(ctx, table, aggregateType, INBOUND_MAIL_TENANT_DESTROY_ARCHIVE_REASON);
27
- }
28
25
  export async function mailAccountTenantDestroyHook(ctx) {
29
- const accountIds = await archiveAndDeleteRows(ctx, mailAccountsProjectionTable, MAIL_ACCOUNT_AGGREGATE_TYPE);
26
+ const accountIds = await archiveAndDeleteTenantRows(ctx, mailAccountsProjectionTable, MAIL_ACCOUNT_AGGREGATE_TYPE, INBOUND_MAIL_TENANT_DESTROY_ARCHIVE_REASON);
30
27
  for (const accountId of accountIds) {
31
28
  await ctx.db.deleteMany(syncCursorTable, { accountId });
32
29
  await ctx.db.deleteMany(seenMessageTable, { accountId });
@@ -35,8 +32,8 @@ export async function mailAccountTenantDestroyHook(ctx) {
35
32
  }
36
33
  }
37
34
  export async function inboundMessageTenantDestroyHook(ctx) {
38
- await archiveAndDeleteRows(ctx, inboundMessagesProjectionTable, INBOUND_MESSAGE_AGGREGATE_TYPE);
35
+ await archiveAndDeleteTenantRows(ctx, inboundMessagesProjectionTable, INBOUND_MESSAGE_AGGREGATE_TYPE, INBOUND_MAIL_TENANT_DESTROY_ARCHIVE_REASON);
39
36
  }
40
37
  export async function mailThreadTenantDestroyHook(ctx) {
41
- await archiveAndDeleteRows(ctx, mailThreadsProjectionTable, MAIL_THREAD_AGGREGATE_TYPE);
38
+ await archiveAndDeleteTenantRows(ctx, mailThreadsProjectionTable, MAIL_THREAD_AGGREGATE_TYPE, INBOUND_MAIL_TENANT_DESTROY_ARCHIVE_REASON);
42
39
  }
@@ -421,7 +421,7 @@ export function createInboundMailSupervisor(deps) {
421
421
  clearTimeout(pollTimer);
422
422
  pollTimer = null;
423
423
  }
424
- if (pollInFlight)
424
+ if (pollInFlight !== null)
425
425
  await pollInFlight;
426
426
  await Promise.allSettled([...inFlightSyncs.values(), watchCatchUp.settled()]);
427
427
  for (const accountId of [...watchers.keys()]) {
@@ -0,0 +1,14 @@
1
+ import { type RejectedInboundMessage } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
2
+ import type { ImapFlow } from "imapflow";
3
+ /** Raw sources held in memory at once per download: a mailbox full of large mails must not grow the heap with the batch count. */
4
+ export declare const IMAP_BATCH_MAX_BYTES: number;
5
+ export type ByteBudgetPlan = {
6
+ /** Fits the budget: download the source. */
7
+ readonly download: readonly number[];
8
+ /** Above the per-mail limit: never downloaded, reported with its envelope only. */
9
+ readonly tooLarge: readonly RejectedInboundMessage[];
10
+ /** Left for a later round once the budget is used up. */
11
+ readonly deferred: readonly number[];
12
+ };
13
+ /** Reads sizes and envelopes (no sources) and cuts the uids at the byte budget, in uid order. */
14
+ export declare function planWithinByteBudget(client: ImapFlow, uids: readonly number[], uidValidity: string): Promise<ByteBudgetPlan>;
@@ -0,0 +1,53 @@
1
+ import { INBOUND_MAIL_ATTACHMENTS_MAX_BYTES, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
2
+ import { coerceDate, rejectedWithoutSource } from "./parse-message.js";
3
+ /** Raw sources held in memory at once per download: a mailbox full of large mails must not grow the heap with the batch count. */
4
+ export const IMAP_BATCH_MAX_BYTES = 100 * 1024 * 1024;
5
+ /** Reads sizes and envelopes (no sources) and cuts the uids at the byte budget, in uid order. */
6
+ export async function planWithinByteBudget(client, uids, uidValidity) {
7
+ const sizeAndEnvelope = new Map();
8
+ if (uids.length > 0) {
9
+ for await (const msg of client.fetch(uids.join(","), { uid: true, size: true, internalDate: true, envelope: true }, { uid: true })) {
10
+ sizeAndEnvelope.set(msg.uid, {
11
+ size: msg.size,
12
+ internalDate: coerceDate(msg.internalDate ?? undefined),
13
+ envelope: msg.envelope,
14
+ });
15
+ }
16
+ }
17
+ const download = [];
18
+ const tooLarge = [];
19
+ const deferred = [];
20
+ let downloadBytes = 0;
21
+ for (const uid of uids) {
22
+ const info = sizeAndEnvelope.get(uid);
23
+ // A mail the server did not list is gone; the later fetch simply does not return it.
24
+ if (info === undefined) {
25
+ if (deferred.length === 0)
26
+ download.push(uid);
27
+ else
28
+ deferred.push(uid);
29
+ continue;
30
+ }
31
+ // Unknown size counts as the largest accepted mail, so the budget cannot be skipped.
32
+ const size = info.size ?? INBOUND_MAIL_ATTACHMENTS_MAX_BYTES;
33
+ if (deferred.length > 0) {
34
+ deferred.push(uid);
35
+ }
36
+ else if (size > INBOUND_MAIL_ATTACHMENTS_MAX_BYTES) {
37
+ tooLarge.push(rejectedWithoutSource({
38
+ uid,
39
+ uidValidity,
40
+ internalDate: info.internalDate,
41
+ envelope: info.envelope,
42
+ }));
43
+ }
44
+ else if (download.length > 0 && downloadBytes + size > IMAP_BATCH_MAX_BYTES) {
45
+ deferred.push(uid);
46
+ }
47
+ else {
48
+ download.push(uid);
49
+ downloadBytes += size;
50
+ }
51
+ }
52
+ return { download, tooLarge, deferred };
53
+ }
@@ -1,5 +1,5 @@
1
1
  import { type InboundMailRoles } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
2
- import { type BeforeTransactionResult, type HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { type BeforeTransactionContext, type BeforeTransactionResult, type HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
3
3
  import type { WriteResult } from "@cosmicdrift/kumiko-types/handlers";
4
4
  import * as z from "zod";
5
5
  import { type ImapCredentialDocument } from "./credential-document.ts";
@@ -18,9 +18,7 @@ type ConnectMailboxLoginFields = Pick<z.infer<typeof connectMailboxSchema>, "hos
18
18
  export declare const CREDENTIAL_PREVIEW = "IMAP login";
19
19
  export declare function deriveSmtpHost(imapHost: string): string;
20
20
  export declare function credentialDocumentOf(payload: ConnectMailboxLoginFields): ImapCredentialDocument;
21
- export declare function checkMailboxLogin(doc: ImapCredentialDocument, log: {
22
- warn(message: string, data?: Record<string, unknown>): void;
23
- }): Promise<BeforeTransactionResult<null>>;
21
+ export declare function checkMailboxLogin(doc: ImapCredentialDocument, ctx: Pick<BeforeTransactionContext, "services" | "rateLimitDigest" | "obs">): Promise<BeforeTransactionResult<null>>;
24
22
  export declare const SECRET_TRANSACTION_REASON = "the credential secret is written on the request transaction so a failed account connect rolls it back too";
25
23
  type ConnectedMailbox = {
26
24
  readonly displayName: string;