@cosmicdrift/kumiko-samples 0.413.1 → 0.415.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (479) hide show
  1. package/package.json +1 -1
  2. package/packages/bundled-features/package.json +16 -1
  3. package/packages/bundled-features/src/admin-shell/changes.json +6 -0
  4. package/packages/bundled-features/src/admin-shell/feature.ts +8 -7
  5. package/packages/bundled-features/src/agent-tools/agent-doc-lint.ts +5 -1
  6. package/packages/bundled-features/src/agent-tools/agent-manifest.ts +36 -27
  7. package/packages/bundled-features/src/agent-tools/api-docs/collect-events.ts +8 -1
  8. package/packages/bundled-features/src/agent-tools/api-docs/collect.ts +3 -2
  9. package/packages/bundled-features/src/agent-tools/api-docs/generate.ts +6 -0
  10. package/packages/bundled-features/src/agent-tools/api-docs/index.ts +1 -0
  11. package/packages/bundled-features/src/agent-tools/api-docs/problems.ts +38 -1
  12. package/packages/bundled-features/src/agent-tools/api-docs/render-openapi.ts +1 -0
  13. package/packages/bundled-features/src/agent-tools/api-docs/resolve-config.ts +17 -0
  14. package/packages/bundled-features/src/agent-tools/api-docs/scope-slug-collisions.ts +17 -0
  15. package/packages/bundled-features/src/agent-tools/api-docs/translation-gaps.ts +42 -0
  16. package/packages/bundled-features/src/agent-tools/api-docs/webhook-example-problems.ts +30 -0
  17. package/packages/bundled-features/src/agent-tools/changes.json +12 -0
  18. package/packages/bundled-features/src/agent-tools/index.ts +1 -0
  19. package/packages/bundled-features/src/agent-tools/labels.ts +19 -6
  20. package/packages/bundled-features/src/agent-tools/tool-catalog.ts +18 -7
  21. package/packages/bundled-features/src/agent-tools/tool-dispatch.ts +14 -1
  22. package/packages/bundled-features/src/agent-tools/types.ts +4 -0
  23. package/packages/bundled-features/src/audit/event-classification.ts +6 -0
  24. package/packages/bundled-features/src/audit/web/i18n.ts +1 -0
  25. package/packages/bundled-features/src/auth-email-password/changes.json +18 -0
  26. package/packages/bundled-features/src/auth-email-password/errors.ts +0 -13
  27. package/packages/bundled-features/src/auth-email-password/handlers/invite-signup-complete.write.ts +147 -121
  28. package/packages/bundled-features/src/auth-email-password/handlers/login-options.query.ts +1 -1
  29. package/packages/bundled-features/src/auth-email-password/handlers/request-account-unlock.write.ts +1 -1
  30. package/packages/bundled-features/src/auth-email-password/handlers/request-email-verification.write.ts +0 -1
  31. package/packages/bundled-features/src/auth-email-password/handlers/request-password-reset.write.ts +0 -1
  32. package/packages/bundled-features/src/auth-email-password/handlers/self-registration-status.query.ts +1 -1
  33. package/packages/bundled-features/src/auth-email-password/reset-token.ts +0 -2
  34. package/packages/bundled-features/src/auth-email-password/seeding.ts +39 -7
  35. package/packages/bundled-features/src/auth-email-password/signup-token-store.ts +2 -3
  36. package/packages/bundled-features/src/auth-email-password/unlock-token.ts +0 -2
  37. package/packages/bundled-features/src/auth-email-password/verification-token.ts +0 -2
  38. package/packages/bundled-features/src/auth-email-password/web/auth-form-primitives.tsx +2 -2
  39. package/packages/bundled-features/src/auth-email-password/web/auth-gate.tsx +2 -2
  40. package/packages/bundled-features/src/auth-email-password/web/auth-redirect.ts +5 -0
  41. package/packages/bundled-features/src/auth-email-password/web/forgot-password-screen.tsx +1 -6
  42. package/packages/bundled-features/src/auth-email-password/web/invite-accept-screen.tsx +1 -1
  43. package/packages/bundled-features/src/auth-email-password/web/return-path.ts +2 -1
  44. package/packages/bundled-features/src/auth-email-password/web/session.tsx +12 -13
  45. package/packages/bundled-features/src/auth-email-password/web/signup-screen.tsx +1 -6
  46. package/packages/bundled-features/src/auth-email-password/web/static-account.ts +6 -1
  47. package/packages/bundled-features/src/auth-email-password/web/tenant-switcher.tsx +1 -1
  48. package/packages/bundled-features/src/auth-email-password/web/token-confirm-screen.tsx +4 -5
  49. package/packages/bundled-features/src/auth-email-password/web/user-menu.tsx +1 -1
  50. package/packages/bundled-features/src/auth-mfa/changes.json +6 -0
  51. package/packages/bundled-features/src/auth-mfa/web/mfa-code-or-recovery-field.tsx +17 -1
  52. package/packages/bundled-features/src/auth-mfa/web/mfa-disable-dialog.tsx +1 -1
  53. package/packages/bundled-features/src/auth-mfa/web/mfa-regenerate-recovery-dialog.tsx +1 -1
  54. package/packages/bundled-features/src/auth-mfa/web/mfa-setup-preauth-screen.tsx +1 -1
  55. package/packages/bundled-features/src/auth-mfa/web/mfa-verify-screen.tsx +16 -47
  56. package/packages/bundled-features/src/auth-mfa-user-data/index.ts +5 -6
  57. package/packages/bundled-features/src/billing-foundation/aggregate-id.ts +0 -4
  58. package/packages/bundled-features/src/billing-foundation/changes.json +61 -0
  59. package/packages/bundled-features/src/billing-foundation/checkout-core.ts +19 -1
  60. package/packages/bundled-features/src/billing-foundation/checkout-ledger.ts +67 -0
  61. package/packages/bundled-features/src/billing-foundation/consumer-protection/consent-gate.ts +2 -1
  62. package/packages/bundled-features/src/billing-foundation/consumer-protection/consent-text.ts +49 -2
  63. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-open-cancels.ts +5 -0
  64. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-provider-timeout.ts +23 -0
  65. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-record.ts +12 -7
  66. package/packages/bundled-features/src/billing-foundation/consumer-protection/termination-revoke.ts +1 -1
  67. package/packages/bundled-features/src/billing-foundation/events.ts +51 -10
  68. package/packages/bundled-features/src/billing-foundation/feature.ts +15 -1
  69. package/packages/bundled-features/src/billing-foundation/handlers/billing-plans.query.ts +47 -14
  70. package/packages/bundled-features/src/billing-foundation/handlers/create-checkout-session.write.ts +9 -1
  71. package/packages/bundled-features/src/billing-foundation/handlers/process-event.write.ts +183 -17
  72. package/packages/bundled-features/src/billing-foundation/handlers/process-payment-event.write.ts +35 -10
  73. package/packages/bundled-features/src/billing-foundation/handlers/record-checkout-opened.write.ts +25 -0
  74. package/packages/bundled-features/src/billing-foundation/handlers/start-plan-checkout.write.ts +9 -1
  75. package/packages/bundled-features/src/billing-foundation/handlers/switch-plan.write.ts +16 -4
  76. package/packages/bundled-features/src/billing-foundation/i18n.ts +3 -0
  77. package/packages/bundled-features/src/billing-foundation/pending-plan-switch.ts +80 -0
  78. package/packages/bundled-features/src/billing-foundation/scrub-raw-payload-headers.ts +50 -0
  79. package/packages/bundled-features/src/billing-foundation/types.ts +47 -30
  80. package/packages/bundled-features/src/billing-foundation/validate-options.ts +18 -0
  81. package/packages/bundled-features/src/billing-foundation/web/billing-plans-panel.tsx +10 -5
  82. package/packages/bundled-features/src/billing-foundation/web/cancel-contract-dialog.tsx +1 -1
  83. package/packages/bundled-features/src/billing-foundation/web/checkout-consent-dialog.tsx +1 -1
  84. package/packages/bundled-features/src/billing-foundation/web/constants.ts +5 -2
  85. package/packages/bundled-features/src/billing-foundation/web/plan-switch-confirm-dialog.tsx +1 -1
  86. package/packages/bundled-features/src/billing-foundation/webhook-handler.ts +65 -17
  87. package/packages/bundled-features/src/cap-counter/aggregate-id.ts +0 -2
  88. package/packages/bundled-features/src/cap-counter/changes.json +6 -0
  89. package/packages/bundled-features/src/cap-counter/stock-cap-guard.ts +19 -4
  90. package/packages/bundled-features/src/cap-overview/changes.json +6 -0
  91. package/packages/bundled-features/src/cap-overview/handlers/tenant-caps-list.query.ts +22 -6
  92. package/packages/bundled-features/src/cap-overview/i18n.ts +1 -0
  93. package/packages/bundled-features/src/cap-overview/index.ts +1 -0
  94. package/packages/bundled-features/src/cap-overview/types.ts +11 -1
  95. package/packages/bundled-features/src/cap-overview/web/cap-cards-panel.tsx +6 -2
  96. package/packages/bundled-features/src/cap-overview/web/cap-usage-bar.tsx +10 -1
  97. package/packages/bundled-features/src/cap-overview/web/usage-math.ts +5 -0
  98. package/packages/bundled-features/src/channel-in-app/changes.json +6 -0
  99. package/packages/bundled-features/src/channel-in-app/handlers/read-state-by-keys.query.ts +2 -2
  100. package/packages/bundled-features/src/channel-whatsapp/aggregate-id.ts +29 -0
  101. package/packages/bundled-features/src/channel-whatsapp/changes.json +32 -0
  102. package/packages/bundled-features/src/channel-whatsapp/constants.ts +46 -0
  103. package/packages/bundled-features/src/channel-whatsapp/events.ts +94 -0
  104. package/packages/bundled-features/src/channel-whatsapp/feature.ts +72 -0
  105. package/packages/bundled-features/src/channel-whatsapp/graph-client.ts +398 -0
  106. package/packages/bundled-features/src/channel-whatsapp/in-memory-meta.ts +300 -0
  107. package/packages/bundled-features/src/channel-whatsapp/inbound-handlers.ts +210 -0
  108. package/packages/bundled-features/src/channel-whatsapp/index.ts +66 -0
  109. package/packages/bundled-features/src/channel-whatsapp/meta-signature.ts +26 -0
  110. package/packages/bundled-features/src/channel-whatsapp/options.ts +149 -0
  111. package/packages/bundled-features/src/channel-whatsapp/pii.ts +109 -0
  112. package/packages/bundled-features/src/channel-whatsapp/webhook-normalize.ts +247 -0
  113. package/packages/bundled-features/src/channel-whatsapp/webhook-routes.ts +185 -0
  114. package/packages/bundled-features/src/compliance-profiles/changes.json +5 -0
  115. package/packages/bundled-features/src/compliance-profiles/handlers/set-profile.write.ts +2 -0
  116. package/packages/bundled-features/src/compliance-profiles/handlers/sub-processors.query.ts +1 -1
  117. package/packages/bundled-features/src/config/changes.json +12 -0
  118. package/packages/bundled-features/src/config/handlers/set.write.ts +7 -0
  119. package/packages/bundled-features/src/config/handlers/values.query.ts +8 -1
  120. package/packages/bundled-features/src/config/index.ts +1 -0
  121. package/packages/bundled-features/src/config/read-redaction.ts +6 -3
  122. package/packages/bundled-features/src/config/table.ts +1 -0
  123. package/packages/bundled-features/src/config/write-helpers.ts +3 -2
  124. package/packages/bundled-features/src/crypto-shredding/changes.json +18 -0
  125. package/packages/bundled-features/src/crypto-shredding/constants.ts +2 -0
  126. package/packages/bundled-features/src/crypto-shredding/handlers/forget-subject.write.ts +38 -18
  127. package/packages/bundled-features/src/crypto-shredding/index.ts +4 -0
  128. package/packages/bundled-features/src/crypto-shredding/subject-forget-after-delete-hook.ts +49 -0
  129. package/packages/bundled-features/src/custom-fields/aggregate-id.ts +0 -1
  130. package/packages/bundled-features/src/custom-fields/entity.ts +1 -0
  131. package/packages/bundled-features/src/custom-fields/wire-for-entity.ts +0 -1
  132. package/packages/bundled-features/src/data-retention/changes.json +12 -0
  133. package/packages/bundled-features/src/data-retention/erase-notes-of-deleted-row.ts +23 -0
  134. package/packages/bundled-features/src/data-retention/feature.ts +2 -5
  135. package/packages/bundled-features/src/data-retention/run-retention-cleanup.ts +38 -18
  136. package/packages/bundled-features/src/data-retention/tenant-destruction-hold.ts +9 -0
  137. package/packages/bundled-features/src/delivery/attempt-log-factory.ts +11 -0
  138. package/packages/bundled-features/src/delivery/attempt-log.ts +3 -3
  139. package/packages/bundled-features/src/delivery/changes.json +12 -0
  140. package/packages/bundled-features/src/delivery/channel-context.ts +6 -3
  141. package/packages/bundled-features/src/delivery/db/queries/preferences.ts +0 -1
  142. package/packages/bundled-features/src/delivery/delivery-service.ts +3 -0
  143. package/packages/bundled-features/src/delivery/feature.ts +4 -13
  144. package/packages/bundled-features/src/delivery/handlers/opted-in-user-ids.query.ts +54 -0
  145. package/packages/bundled-features/src/delivery/handlers/preferences.query.ts +2 -20
  146. package/packages/bundled-features/src/delivery/handlers/resubscribe-user.write.ts +2 -25
  147. package/packages/bundled-features/src/delivery/handlers/unsubscribe-page-chrome.query.ts +2 -0
  148. package/packages/bundled-features/src/delivery/handlers/unsubscribe-user.write.ts +2 -27
  149. package/packages/bundled-features/src/delivery/index.ts +3 -1
  150. package/packages/bundled-features/src/delivery/options.ts +11 -0
  151. package/packages/bundled-features/src/delivery/preference-rows.ts +33 -0
  152. package/packages/bundled-features/src/delivery/set-preference-enabled.ts +40 -0
  153. package/packages/bundled-features/src/delivery/testing.ts +3 -1
  154. package/packages/bundled-features/src/delivery/types.ts +1 -0
  155. package/packages/bundled-features/src/delivery/unsubscribe-page.ts +7 -1
  156. package/packages/bundled-features/src/delivery/upsert-preference.ts +0 -1
  157. package/packages/bundled-features/src/delivery/web/public-names.ts +1 -0
  158. package/packages/bundled-features/src/derivatives-sharp/render.ts +9 -9
  159. package/packages/bundled-features/src/document-ingest-foundation/aggregate-id.ts +0 -1
  160. package/packages/bundled-features/src/document-ingest-foundation/append-missing-extract-event.ts +37 -25
  161. package/packages/bundled-features/src/document-ingest-foundation/changes.json +6 -0
  162. package/packages/bundled-features/src/document-ingest-foundation/feature.ts +1 -0
  163. package/packages/bundled-features/src/document-ingest-foundation/report-ingest-progress.ts +34 -14
  164. package/packages/bundled-features/src/documents/aggregate-id.ts +0 -2
  165. package/packages/bundled-features/src/documents/changes.json +24 -0
  166. package/packages/bundled-features/src/documents/constants.ts +10 -2
  167. package/packages/bundled-features/src/documents/ensure-link.ts +3 -4
  168. package/packages/bundled-features/src/documents/feature.ts +33 -6
  169. package/packages/bundled-features/src/documents/handlers/import.write.ts +2 -2
  170. package/packages/bundled-features/src/documents/queries/expiry-overview.query.ts +2 -1
  171. package/packages/bundled-features/src/documents/queries/for-record.query.ts +3 -4
  172. package/packages/bundled-features/src/documents/queries/list-page.ts +11 -3
  173. package/packages/bundled-features/src/documents/queries/overview.query.ts +2 -2
  174. package/packages/bundled-features/src/documents/screens.ts +8 -3
  175. package/packages/bundled-features/src/documents/tab.ts +1 -1
  176. package/packages/bundled-features/src/feature-toggles/toggle-sync-signal.ts +6 -3
  177. package/packages/bundled-features/src/file-derivatives/handlers/public-variant-by-file-ref.query.ts +1 -1
  178. package/packages/bundled-features/src/file-derivatives/handlers/public-variant.query.ts +1 -1
  179. package/packages/bundled-features/src/file-foundation/probe.ts +9 -3
  180. package/packages/bundled-features/src/file-foundation/read-file-ref-content.ts +24 -11
  181. package/packages/bundled-features/src/file-provider-inmemory/feature.ts +1 -1
  182. package/packages/bundled-features/src/file-provider-s3/changes.json +14 -0
  183. package/packages/bundled-features/src/file-provider-s3/env-feature.ts +1 -1
  184. package/packages/bundled-features/src/file-provider-s3/env-named-feature.ts +1 -1
  185. package/packages/bundled-features/src/file-provider-s3/env-schema.ts +24 -7
  186. package/packages/bundled-features/src/file-provider-s3/feature.ts +1 -1
  187. package/packages/bundled-features/src/file-provider-s3/index.ts +7 -1
  188. package/packages/bundled-features/src/file-provider-s3/lib/env-helper.ts +21 -13
  189. package/packages/bundled-features/src/file-provider-s3/lib/s3-provider.ts +8 -1
  190. package/packages/bundled-features/src/files/changes.json +7 -0
  191. package/packages/bundled-features/src/folders/aggregate-id.ts +0 -1
  192. package/packages/bundled-features/src/folders/web/folder-manager.tsx +6 -6
  193. package/packages/bundled-features/src/folders-user-data/index.ts +12 -14
  194. package/packages/bundled-features/src/form-draft/feature.ts +1 -0
  195. package/packages/bundled-features/src/helpdesk/changes.json +56 -0
  196. package/packages/bundled-features/src/helpdesk/entity.ts +4 -1
  197. package/packages/bundled-features/src/helpdesk/feature.ts +42 -0
  198. package/packages/bundled-features/src/helpdesk/handlers/access.ts +0 -10
  199. package/packages/bundled-features/src/helpdesk/handlers/attempts.ts +7 -14
  200. package/packages/bundled-features/src/helpdesk/handlers/challenge.query.ts +1 -2
  201. package/packages/bundled-features/src/helpdesk/handlers/reply.write.ts +5 -12
  202. package/packages/bundled-features/src/helpdesk/handlers/report.write.ts +4 -10
  203. package/packages/bundled-features/src/helpdesk/handlers/submit.write.ts +5 -12
  204. package/packages/bundled-features/src/helpdesk/index.ts +1 -0
  205. package/packages/bundled-features/src/helpdesk/legacy-contact-config.ts +61 -0
  206. package/packages/bundled-features/src/helpdesk/legacy-contact-erasure.ts +45 -0
  207. package/packages/bundled-features/src/helpdesk/legacy-contact-retention.ts +65 -0
  208. package/packages/bundled-features/src/helpdesk/legacy-contact-streams.ts +187 -0
  209. package/packages/bundled-features/src/helpdesk/legacy-contact-user-data.ts +84 -0
  210. package/packages/bundled-features/src/helpdesk/lib.ts +55 -37
  211. package/packages/bundled-features/src/helpdesk/user-data-hooks.ts +89 -48
  212. package/packages/bundled-features/src/helpdesk/web/constants.ts +0 -1
  213. package/packages/bundled-features/src/inbound-mail-foundation/account-health.ts +1 -1
  214. package/packages/bundled-features/src/inbound-mail-foundation/account-poll.ts +9 -2
  215. package/packages/bundled-features/src/inbound-mail-foundation/aggregate-id.ts +0 -2
  216. package/packages/bundled-features/src/inbound-mail-foundation/changes.json +54 -0
  217. package/packages/bundled-features/src/inbound-mail-foundation/constants.ts +6 -0
  218. package/packages/bundled-features/src/inbound-mail-foundation/content-refetch.ts +23 -2
  219. package/packages/bundled-features/src/inbound-mail-foundation/entities.ts +73 -15
  220. package/packages/bundled-features/src/inbound-mail-foundation/events.ts +24 -16
  221. package/packages/bundled-features/src/inbound-mail-foundation/feature.ts +3 -1
  222. package/packages/bundled-features/src/inbound-mail-foundation/handlers/account-address.ts +16 -2
  223. package/packages/bundled-features/src/inbound-mail-foundation/handlers/attach-message-content.write.ts +10 -3
  224. package/packages/bundled-features/src/inbound-mail-foundation/handlers/connect-account.write.ts +23 -9
  225. package/packages/bundled-features/src/inbound-mail-foundation/handlers/forget-message.write.ts +79 -0
  226. package/packages/bundled-features/src/inbound-mail-foundation/handlers/ingest-message-schema.ts +18 -5
  227. package/packages/bundled-features/src/inbound-mail-foundation/i18n.ts +3 -0
  228. package/packages/bundled-features/src/inbound-mail-foundation/index.ts +1 -0
  229. package/packages/bundled-features/src/inbound-mail-foundation/normalize-inbound-message.ts +22 -8
  230. package/packages/bundled-features/src/inbound-mail-foundation/oauth-access-token.ts +1 -1
  231. package/packages/bundled-features/src/inbound-mail-foundation/outbound-mail.ts +2 -0
  232. package/packages/bundled-features/src/inbound-mail-foundation/personal-address.ts +20 -0
  233. package/packages/bundled-features/src/inbound-mail-foundation/purge-messages.ts +54 -0
  234. package/packages/bundled-features/src/inbound-mail-foundation/quarantine.ts +15 -5
  235. package/packages/bundled-features/src/inbound-mail-foundation/retention-job.ts +1 -5
  236. package/packages/bundled-features/src/inbound-mail-foundation/retention-sweep.ts +21 -34
  237. package/packages/bundled-features/src/inbound-mail-foundation/sanitize-inbound-html.ts +2 -5
  238. package/packages/bundled-features/src/inbound-mail-foundation/send-from-account.ts +9 -1
  239. package/packages/bundled-features/src/inbound-mail-foundation/supervisor-ingest.ts +7 -1
  240. package/packages/bundled-features/src/inbound-mail-foundation/sync-account-now.ts +1 -1
  241. package/packages/bundled-features/src/inbound-mail-foundation/tenant-destroy-hook.ts +14 -17
  242. package/packages/bundled-features/src/inbound-mail-foundation/watch-supervisor.ts +1 -1
  243. package/packages/bundled-features/src/inbound-provider-imap/byte-budget.ts +80 -0
  244. package/packages/bundled-features/src/inbound-provider-imap/changes.json +13 -0
  245. package/packages/bundled-features/src/inbound-provider-imap/connect-mailbox.ts +8 -4
  246. package/packages/bundled-features/src/inbound-provider-imap/connect-my-mailbox.ts +23 -6
  247. package/packages/bundled-features/src/inbound-provider-imap/connect-target-rate-limit.ts +46 -0
  248. package/packages/bundled-features/src/inbound-provider-imap/download-batch.ts +47 -10
  249. package/packages/bundled-features/src/inbound-provider-imap/feature.ts +7 -4
  250. package/packages/bundled-features/src/inbound-provider-imap/fetch-content.ts +43 -29
  251. package/packages/bundled-features/src/inbound-provider-imap/i18n.ts +2 -2
  252. package/packages/bundled-features/src/inbound-provider-imap/parse-message.ts +14 -0
  253. package/packages/bundled-features/src/inbound-provider-imap/reconnect-mailbox.ts +5 -4
  254. package/packages/bundled-features/src/inbound-provider-imap/send-mail.ts +39 -7
  255. package/packages/bundled-features/src/inbound-provider-imap/smtp-client.ts +19 -4
  256. package/packages/bundled-features/src/inbound-provider-imap/watch-mailbox.ts +8 -23
  257. package/packages/bundled-features/src/inbound-provider-inmemory/feature.ts +1 -1
  258. package/packages/bundled-features/src/jobs/events.ts +10 -0
  259. package/packages/bundled-features/src/jobs/feature.ts +2 -0
  260. package/packages/bundled-features/src/jobs/handlers/consumer.write.ts +41 -16
  261. package/packages/bundled-features/src/jobs/web/constants.ts +4 -0
  262. package/packages/bundled-features/src/mail-foundation/changes.json +6 -0
  263. package/packages/bundled-features/src/mail-transport-inmemory/feature.ts +1 -1
  264. package/packages/bundled-features/src/mail-transport-smtp/feature.ts +3 -2
  265. package/packages/bundled-features/src/managed-pages/changes.json +12 -0
  266. package/packages/bundled-features/src/managed-pages/handlers/branding.query.ts +1 -1
  267. package/packages/bundled-features/src/managed-pages/handlers/by-slug.query.ts +1 -1
  268. package/packages/bundled-features/src/managed-pages/handlers/by-tenant-published.query.ts +1 -1
  269. package/packages/bundled-features/src/managed-pages/render-page-body.ts +18 -10
  270. package/packages/bundled-features/src/managed-pages/screens/page-screens.ts +18 -38
  271. package/packages/bundled-features/src/managed-pages/table.ts +1 -0
  272. package/packages/bundled-features/src/managed-pages/web/client-plugin.tsx +8 -6
  273. package/packages/bundled-features/src/managed-pages/web/constants.ts +8 -1
  274. package/packages/bundled-features/src/managed-pages/web/i18n.ts +11 -3
  275. package/packages/bundled-features/src/managed-pages/web/markdown-to-document.ts +1 -1
  276. package/packages/bundled-features/src/managed-pages/web/page-edit-draft.ts +108 -0
  277. package/packages/bundled-features/src/managed-pages/web/page-edit-screen.tsx +204 -0
  278. package/packages/bundled-features/src/managed-pages/web/page-settings-rail.tsx +117 -0
  279. package/packages/bundled-features/src/notes-history-user-data/index.ts +8 -14
  280. package/packages/bundled-features/src/personal-access-tokens/boot-rules.ts +5 -0
  281. package/packages/bundled-features/src/personal-access-tokens/handlers/create.write.ts +0 -1
  282. package/packages/bundled-features/src/personal-access-tokens/scope-events-check.ts +31 -5
  283. package/packages/bundled-features/src/presence/changes.json +6 -0
  284. package/packages/bundled-features/src/presence/handlers/list.query.ts +28 -11
  285. package/packages/bundled-features/src/presence/room.ts +21 -7
  286. package/packages/bundled-features/src/presence/store.ts +79 -21
  287. package/packages/bundled-features/src/readiness/changes.json +25 -0
  288. package/packages/bundled-features/src/readiness/handlers/latest-summary.query.ts +11 -6
  289. package/packages/bundled-features/src/readiness/handlers/run-probes.write.ts +35 -5
  290. package/packages/bundled-features/src/readiness/handlers/run-tone.ts +3 -2
  291. package/packages/bundled-features/src/readiness/handlers/status.query.ts +15 -1
  292. package/packages/bundled-features/src/readiness/probe-context.ts +11 -10
  293. package/packages/bundled-features/src/readiness/screens.ts +4 -4
  294. package/packages/bundled-features/src/readiness/visible-results.ts +5 -3
  295. package/packages/bundled-features/src/renderer-foundation/api.ts +6 -13
  296. package/packages/bundled-features/src/renderer-foundation/types.ts +2 -2
  297. package/packages/bundled-features/src/secrets/changes.json +7 -0
  298. package/packages/bundled-features/src/secrets/db/queries/read.ts +18 -4
  299. package/packages/bundled-features/src/secrets/handlers/list.query.ts +8 -2
  300. package/packages/bundled-features/src/secrets/secret-scope.ts +2 -3
  301. package/packages/bundled-features/src/secrets/secrets-context.ts +6 -4
  302. package/packages/bundled-features/src/secrets/write-gate.ts +4 -2
  303. package/packages/bundled-features/src/seo/handlers/seo-config.query.ts +1 -1
  304. package/packages/bundled-features/src/shared/acknowledged-system-db.ts +20 -0
  305. package/packages/bundled-features/src/shared/assert-billing-live.ts +9 -2
  306. package/packages/bundled-features/src/shared/changes.json +12 -0
  307. package/packages/bundled-features/src/shared/hmac-signature.ts +4 -2
  308. package/packages/bundled-features/src/shared/index.ts +7 -1
  309. package/packages/bundled-features/src/shared/normalize-email.ts +3 -0
  310. package/packages/bundled-features/src/shared/parent-visibility.ts +25 -1
  311. package/packages/bundled-features/src/shared/password-hashing.ts +0 -1
  312. package/packages/bundled-features/src/shared/price-env-shape.ts +1 -4
  313. package/packages/bundled-features/src/shared/register-user-data-hooks.ts +29 -0
  314. package/packages/bundled-features/src/shared/require-bootstrap-extension.ts +26 -0
  315. package/packages/bundled-features/src/shared/send-best-effort.ts +29 -0
  316. package/packages/bundled-features/src/shared/stream-tenant-backfill.ts +22 -1
  317. package/packages/bundled-features/src/shared/stream-tenant-derived-state.ts +31 -1
  318. package/packages/bundled-features/src/step-dispatcher/changes.json +18 -0
  319. package/packages/bundled-features/src/step-dispatcher/constants.ts +13 -0
  320. package/packages/bundled-features/src/step-dispatcher/deliver-dispatch-request.ts +50 -2
  321. package/packages/bundled-features/src/step-dispatcher/feature.ts +42 -1
  322. package/packages/bundled-features/src/step-dispatcher/mail-runner.ts +0 -1
  323. package/packages/bundled-features/src/step-dispatcher/sweep-abandoned.ts +61 -0
  324. package/packages/bundled-features/src/subscription-mollie/changes.json +7 -0
  325. package/packages/bundled-features/src/subscription-mollie/plugin-methods.ts +5 -3
  326. package/packages/bundled-features/src/subscription-mollie/verify-webhook.ts +5 -5
  327. package/packages/bundled-features/src/subscription-paddle/backfill-checkout-ledger.ts +161 -0
  328. package/packages/bundled-features/src/subscription-paddle/changes.json +19 -0
  329. package/packages/bundled-features/src/subscription-paddle/checkout-config.query.ts +1 -1
  330. package/packages/bundled-features/src/subscription-paddle/checkout-methods.ts +2 -8
  331. package/packages/bundled-features/src/subscription-paddle/constants.ts +1 -2
  332. package/packages/bundled-features/src/subscription-paddle/feature.ts +26 -24
  333. package/packages/bundled-features/src/subscription-paddle/ledger-backfill-marker.ts +70 -0
  334. package/packages/bundled-features/src/subscription-paddle/plan-switch-methods.ts +2 -8
  335. package/packages/bundled-features/src/subscription-paddle/redeliver-legacy-checkout.ts +57 -0
  336. package/packages/bundled-features/src/subscription-paddle/runtime.ts +13 -24
  337. package/packages/bundled-features/src/subscription-paddle/subscription-state.ts +1 -0
  338. package/packages/bundled-features/src/subscription-paddle/webhook-events.ts +68 -21
  339. package/packages/bundled-features/src/subscription-stripe/changes.json +13 -0
  340. package/packages/bundled-features/src/subscription-stripe/feature.ts +5 -0
  341. package/packages/bundled-features/src/subscription-stripe/plugin-methods.ts +6 -6
  342. package/packages/bundled-features/src/subscription-stripe/runtime.ts +8 -7
  343. package/packages/bundled-features/src/subscription-stripe/verify-webhook.ts +38 -6
  344. package/packages/bundled-features/src/tags/aggregate-id.ts +0 -1
  345. package/packages/bundled-features/src/tags/web/tag-chip.tsx +4 -5
  346. package/packages/bundled-features/src/tags/web/tag-manager.tsx +2 -1
  347. package/packages/bundled-features/src/template-resolver/api.ts +6 -13
  348. package/packages/bundled-features/src/template-resolver/changes.json +48 -0
  349. package/packages/bundled-features/src/template-resolver/document-sanitizer.ts +25 -0
  350. package/packages/bundled-features/src/template-resolver/feature.ts +2 -0
  351. package/packages/bundled-features/src/template-resolver/handlers/body-preview.query.ts +41 -0
  352. package/packages/bundled-features/src/template-resolver/handlers/by-slug.query.ts +1 -1
  353. package/packages/bundled-features/src/template-resolver/handlers/by-tenant.query.ts +1 -1
  354. package/packages/bundled-features/src/template-resolver/handlers/collection-shared.ts +5 -11
  355. package/packages/bundled-features/src/template-resolver/handlers/overview.query.ts +3 -2
  356. package/packages/bundled-features/src/template-resolver/handlers/send-test.write.ts +37 -8
  357. package/packages/bundled-features/src/template-resolver/linked-resources.ts +2 -5
  358. package/packages/bundled-features/src/template-resolver/seeding.ts +107 -0
  359. package/packages/bundled-features/src/template-resolver/table.ts +1 -0
  360. package/packages/bundled-features/src/template-resolver/template-draft.ts +2 -1
  361. package/packages/bundled-features/src/template-resolver/template-preview.ts +14 -3
  362. package/packages/bundled-features/src/template-resolver/testing.ts +0 -2
  363. package/packages/bundled-features/src/template-resolver/web/client-plugin.tsx +3 -0
  364. package/packages/bundled-features/src/template-resolver/web/collection-entry-create-form.tsx +33 -33
  365. package/packages/bundled-features/src/template-resolver/web/constants.ts +7 -0
  366. package/packages/bundled-features/src/template-resolver/web/content-tree-provider.ts +0 -1
  367. package/packages/bundled-features/src/template-resolver/web/content-workbench.tsx +142 -0
  368. package/packages/bundled-features/src/template-resolver/web/document-insert-model.ts +3 -8
  369. package/packages/bundled-features/src/template-resolver/web/document-link-policy.ts +58 -0
  370. package/packages/bundled-features/src/template-resolver/web/document-schema.ts +11 -57
  371. package/packages/bundled-features/src/template-resolver/web/document-tiptap-bubble.tsx +2 -4
  372. package/packages/bundled-features/src/template-resolver/web/document-tiptap-context.ts +4 -5
  373. package/packages/bundled-features/src/template-resolver/web/document-tiptap-editor.tsx +2 -2
  374. package/packages/bundled-features/src/template-resolver/web/document-tiptap-helpers.ts +6 -3
  375. package/packages/bundled-features/src/template-resolver/web/document-tiptap-toolbar-groups.tsx +2 -3
  376. package/packages/bundled-features/src/template-resolver/web/editor-handle.ts +1 -0
  377. package/packages/bundled-features/src/template-resolver/web/fill-document-variables.ts +24 -0
  378. package/packages/bundled-features/src/template-resolver/web/i18n.ts +14 -0
  379. package/packages/bundled-features/src/template-resolver/web/index.ts +3 -0
  380. package/packages/bundled-features/src/template-resolver/web/preview-targets.ts +25 -0
  381. package/packages/bundled-features/src/template-resolver/web/qualified-names.ts +1 -0
  382. package/packages/bundled-features/src/template-resolver/web/snippet-preview-renderer.tsx +24 -0
  383. package/packages/bundled-features/src/template-resolver/web/string-values.ts +7 -0
  384. package/packages/bundled-features/src/template-resolver/web/text-block-editor.tsx +38 -50
  385. package/packages/bundled-features/src/template-resolver/web/use-collection-entry-create.ts +7 -0
  386. package/packages/bundled-features/src/template-resolver/web/use-content-write.ts +1 -3
  387. package/packages/bundled-features/src/template-resolver/web/use-document-tiptap-model.ts +1 -2
  388. package/packages/bundled-features/src/template-resolver/web/use-text-block-editor.ts +28 -7
  389. package/packages/bundled-features/src/template-resolver/web/web-preview-renderer.tsx +132 -0
  390. package/packages/bundled-features/src/template-resolver-user-data/index.ts +11 -10
  391. package/packages/bundled-features/src/tenant/changes.json +6 -0
  392. package/packages/bundled-features/src/tenant/handlers/create.write.ts +7 -8
  393. package/packages/bundled-features/src/tenant/handlers/list.query.ts +7 -9
  394. package/packages/bundled-features/src/tenant/handlers/member-directory.query.ts +10 -4
  395. package/packages/bundled-features/src/tenant/handlers/toggle-enabled.write.ts +1 -1
  396. package/packages/bundled-features/src/tenant/invited-membership.ts +10 -1
  397. package/packages/bundled-features/src/tenant/seeding.ts +4 -2
  398. package/packages/bundled-features/src/tenant/stream-tenant-backfill.ts +5 -1
  399. package/packages/bundled-features/src/tenant/testing.ts +1 -1
  400. package/packages/bundled-features/src/tenant-inactivity/changes.json +6 -0
  401. package/packages/bundled-features/src/tenant-inactivity/check-inactive-tenants.ts +36 -17
  402. package/packages/bundled-features/src/tenant-inactivity/constants.ts +1 -2
  403. package/packages/bundled-features/src/tenant-inactivity/handlers/keep-account.write.ts +7 -2
  404. package/packages/bundled-features/src/tenant-inactivity/state-store.ts +22 -2
  405. package/packages/bundled-features/src/tenant-lifecycle/changes.json +24 -0
  406. package/packages/bundled-features/src/tenant-lifecycle/constants.ts +4 -0
  407. package/packages/bundled-features/src/tenant-lifecycle/feature.ts +1 -0
  408. package/packages/bundled-features/src/tenant-lifecycle/run-tenant-destroy.ts +43 -6
  409. package/packages/bundled-features/src/tenant-lifecycle/stages.ts +15 -2
  410. package/packages/bundled-features/src/tier-engine/aggregate-id.ts +0 -1
  411. package/packages/bundled-features/src/tier-engine/changes.json +6 -0
  412. package/packages/bundled-features/src/tier-engine/feature.ts +8 -2
  413. package/packages/bundled-features/src/user/changes.json +6 -0
  414. package/packages/bundled-features/src/user/db/queries/stream-tenant-backfill.ts +2 -1
  415. package/packages/bundled-features/src/user/handlers/me.query.ts +3 -1
  416. package/packages/bundled-features/src/user/index.ts +1 -0
  417. package/packages/bundled-features/src/user/resolve-verified-user-email.ts +17 -0
  418. package/packages/bundled-features/src/user-data-rights/db/queries/export-jobs.ts +0 -1
  419. package/packages/bundled-features/src/user-data-rights/feature.ts +1 -0
  420. package/packages/bundled-features/src/user-data-rights/handlers/confirm-deletion-by-token.write.ts +1 -1
  421. package/packages/bundled-features/src/user-data-rights/handlers/download-by-token.query.ts +1 -1
  422. package/packages/bundled-features/src/user-data-rights/handlers/request-deletion-by-email.write.ts +1 -1
  423. package/packages/bundled-features/src/user-data-rights/run-export-jobs.ts +0 -2
  424. package/packages/bundled-features/src/user-data-rights/run-forget-cleanup.ts +3 -3
  425. package/packages/bundled-features/src/user-data-rights/schema/download-attempt.ts +3 -2
  426. package/packages/bundled-features/src/user-data-rights/web/confirm-deletion-screen.tsx +1 -1
  427. package/packages/bundled-features/src/user-data-rights/web/privacy-center-screen.tsx +1 -1
  428. package/packages/bundled-features/src/user-data-rights/web/request-deletion-screen.tsx +1 -1
  429. package/packages/bundled-features/src/user-data-rights-defaults/hooks/api-token.userdata-hook.ts +5 -5
  430. package/packages/bundled-features/src/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.ts +17 -0
  431. package/packages/bundled-features/src/user-data-rights-defaults/hooks/in-app-message.userdata-hook.ts +5 -5
  432. package/packages/bundled-features/src/user-data-rights-defaults/hooks/job-run.userdata-hook.ts +2 -1
  433. package/packages/bundled-features/src/user-data-rights-defaults/hooks/user-session.userdata-hook.ts +5 -5
  434. package/packages/bundled-features/src/user-profile/handlers/change-email.write.ts +0 -1
  435. package/packages/bundled-features/src/waitlist/changes.json +6 -0
  436. package/packages/bundled-features/src/waitlist/handlers/reject.write.ts +1 -1
  437. package/packages/bundled-features/src/waitlist/handlers/submit.write.ts +5 -29
  438. package/packages/bundled-features/src/waitlist/import.ts +2 -1
  439. package/packages/bundled-features/src/waitlist/lib.ts +2 -11
  440. package/packages/bundled-features/src/waitlist/link-on-signup.ts +2 -2
  441. package/packages/bundled-features/src/waitlist/user-data-hooks.ts +6 -19
  442. package/packages/bundled-features/src/workflow-runner/aggregate-id.ts +0 -1
  443. package/packages/bundled-features/src/workflow-runner/changes.json +6 -0
  444. package/packages/bundled-features/src/workflow-runner/event-trigger.ts +6 -2
  445. package/packages/bundled-features/src/workflow-runner/feature.ts +1 -5
  446. package/packages/bundled-features/src/workflow-runner/handlers/resume-run.write.ts +7 -4
  447. package/packages/bundled-features/src/workflow-runner/runner.ts +2 -0
  448. package/samples/apps/admin-console/src/app/shell.tsx +1 -0
  449. package/samples/apps/showcase/src/features/demos/web/pages/dialog.tsx +0 -1
  450. package/samples/apps/showcase/src/features/demos/web/pages/layout.tsx +1 -1
  451. package/samples/apps/showcase/src/features/demos/web/pages/sidebar-panel.tsx +0 -1
  452. package/samples/apps/styleguide/src/features/gallery/web/Gallery.tsx +1 -4
  453. package/samples/apps/ui-walkthrough/src/features/subscription-plans/feature.ts +6 -2
  454. package/samples/apps/use-all-bundled/e2e-billing-gallery/gallery-features.ts +12 -14
  455. package/samples/apps/use-all-bundled/feature-manifest.json +60 -29
  456. package/samples/apps/use-all-bundled/playwright.billing-docs.config.ts +1 -1
  457. package/samples/apps/use-all-bundled/playwright.config.ts +1 -0
  458. package/samples/apps/use-all-bundled/src/app/seed.ts +1 -1
  459. package/samples/apps/use-all-bundled/src/run-config.ts +2 -1
  460. package/samples/recipes/auth-mfa/src/web/confirmation-code-step.tsx +32 -10
  461. package/samples/recipes/chat-channels/README.md +2 -0
  462. package/samples/recipes/crypto-shredding-hr/README.md +11 -0
  463. package/samples/recipes/crypto-shredding-hr/src/feature.ts +27 -0
  464. package/samples/recipes/currencies-global/src/entities/currency.ts +1 -0
  465. package/samples/recipes/managed-pages/README.md +5 -1
  466. package/samples/recipes/managed-pages/package.json +3 -2
  467. package/samples/recipes/managed-pages/src/web/branded-preview.tsx +21 -0
  468. package/samples/recipes/managed-pages/tsconfig.json +8 -0
  469. package/samples/recipes/pwa-shell/README.md +52 -0
  470. package/samples/recipes/pwa-shell/bin/server.ts +12 -0
  471. package/samples/recipes/pwa-shell/package.json +13 -0
  472. package/samples/recipes/pwa-shell/src/app.ts +34 -0
  473. package/samples/recipes/rate-limiting/README.md +3 -3
  474. package/samples/recipes/record-detail-layout/README.md +33 -0
  475. package/samples/recipes/record-detail-layout/src/feature.ts +556 -44
  476. package/samples/recipes/record-detail-layout/src/order-board.ts +529 -0
  477. package/packages/bundled-features/src/managed-pages/web/page-body-section.tsx +0 -72
  478. package/packages/bundled-features/src/subscription-paddle/tenant-binding.ts +0 -34
  479. package/packages/bundled-features/src/template-resolver/web/content-field.tsx +0 -61
@@ -0,0 +1,80 @@
1
+ import {
2
+ INBOUND_MAIL_ATTACHMENTS_MAX_BYTES,
3
+ type RejectedInboundMessage,
4
+ } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
5
+ import type { ImapFlow } from "imapflow";
6
+ import { coerceDate, rejectedWithoutSource } from "./parse-message.ts";
7
+
8
+ /** Raw sources held in memory at once per download: a mailbox full of large mails must not grow the heap with the batch count. */
9
+ export const IMAP_BATCH_MAX_BYTES = 100 * 1024 * 1024;
10
+
11
+ export type ByteBudgetPlan = {
12
+ /** Fits the budget: download the source. */
13
+ readonly download: readonly number[];
14
+ /** Above the per-mail limit: never downloaded, reported with its envelope only. */
15
+ readonly tooLarge: readonly RejectedInboundMessage[];
16
+ /** Left for a later round once the budget is used up. */
17
+ readonly deferred: readonly number[];
18
+ };
19
+
20
+ /** Reads sizes and envelopes (no sources) and cuts the uids at the byte budget, in uid order. */
21
+ export async function planWithinByteBudget(
22
+ client: ImapFlow,
23
+ uids: readonly number[],
24
+ uidValidity: string,
25
+ ): Promise<ByteBudgetPlan> {
26
+ const sizeAndEnvelope = new Map<
27
+ number,
28
+ {
29
+ readonly size: number | undefined;
30
+ readonly internalDate: Date | undefined;
31
+ readonly envelope: Parameters<typeof rejectedWithoutSource>[0]["envelope"];
32
+ }
33
+ >();
34
+ if (uids.length > 0) {
35
+ for await (const msg of client.fetch(
36
+ uids.join(","),
37
+ { uid: true, size: true, internalDate: true, envelope: true },
38
+ { uid: true },
39
+ )) {
40
+ sizeAndEnvelope.set(msg.uid, {
41
+ size: msg.size,
42
+ internalDate: coerceDate(msg.internalDate ?? undefined),
43
+ envelope: msg.envelope,
44
+ });
45
+ }
46
+ }
47
+ const download: number[] = [];
48
+ const tooLarge: RejectedInboundMessage[] = [];
49
+ const deferred: number[] = [];
50
+ let downloadBytes = 0;
51
+ for (const uid of uids) {
52
+ const info = sizeAndEnvelope.get(uid);
53
+ // A mail the server did not list is gone; the later fetch simply does not return it.
54
+ if (info === undefined) {
55
+ if (deferred.length === 0) download.push(uid);
56
+ else deferred.push(uid);
57
+ continue;
58
+ }
59
+ // Unknown size counts as the largest accepted mail, so the budget cannot be skipped.
60
+ const size = info.size ?? INBOUND_MAIL_ATTACHMENTS_MAX_BYTES;
61
+ if (deferred.length > 0) {
62
+ deferred.push(uid);
63
+ } else if (size > INBOUND_MAIL_ATTACHMENTS_MAX_BYTES) {
64
+ tooLarge.push(
65
+ rejectedWithoutSource({
66
+ uid,
67
+ uidValidity,
68
+ internalDate: info.internalDate,
69
+ envelope: info.envelope,
70
+ }),
71
+ );
72
+ } else if (download.length > 0 && downloadBytes + size > IMAP_BATCH_MAX_BYTES) {
73
+ deferred.push(uid);
74
+ } else {
75
+ download.push(uid);
76
+ downloadBytes += size;
77
+ }
78
+ }
79
+ return { download, tooLarge, deferred };
80
+ }
@@ -1,4 +1,17 @@
1
1
  [
2
+ {
3
+ "version": "0.414.0",
4
+ "type": "fix",
5
+ "title": "IMAP connect limited per target host, send failures classified correctly, watch and poll share one fetch path",
6
+ "detail": "The connect, connect-my and reconnect checks now also count per target host and per host plus user across all tenants (200 and 20 per 10 minutes), so many tenants cannot probe one foreign mail server. Sending reports \"not set up\" when the credential document is missing or unreadable, and for a failed certificate check or a blocked host, instead of a rejected password or a retryable outage. Poll, watch and content refetch fetch and parse mails through one function. The TLS failure text no longer mentions a TLS setting the form does not have, and the SMTP port hint states that 465 means SSL/TLS and every other port STARTTLS. attach-message-content fails instead of treating a stream without a readable received event as a shared mailbox."
7
+ },
8
+ {
9
+ "version": "0.414.0",
10
+ "type": "breaking",
11
+ "title": "A personal password mailbox only connects the caller's own account address",
12
+ "detail": "`connect-my-mailbox` reads the email of the session user server-side and compares it case-insensitively with the submitted address before any login attempt. A different address is refused with `personal_address_not_own` (i18n `inboundMail.accounts.errors.personalAddressNotOwn`); nothing is created and the mail server is not contacted. The OAuth path needs no extra rule, its callback already binds the mailbox to the provider-authenticated account. The IMAP feature now reads the user through the user feature, which a stack must mount.",
13
+ "migration": "Members who connected a personal mailbox with an address other than their account email must have an admin connect it as a shared mailbox instead. Stacks that mount `inbound-provider-imap` need the user feature."
14
+ },
2
15
  {
3
16
  "version": "0.411.0",
4
17
  "type": "fix",
@@ -16,6 +16,7 @@ import {
16
16
  import { requireSecretsContext } from "@cosmicdrift/kumiko-bundled-features/secrets";
17
17
  import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
18
18
  import {
19
+ type BeforeTransactionContext,
19
20
  type BeforeTransactionResult,
20
21
  createSystemUser,
21
22
  defineWriteHandler,
@@ -24,6 +25,7 @@ import {
24
25
  import { UnprocessableError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
25
26
  import type { WriteResult } from "@cosmicdrift/kumiko-types/handlers";
26
27
  import * as z from "zod";
28
+ import { enforceConnectTargetLimit } from "./connect-target-rate-limit.ts";
27
29
  import { IMAP_CONNECT_ERRORS, IMAP_PROVIDER_KEY, SMTP_CONNECT_ERRORS } from "./constants.ts";
28
30
  import {
29
31
  type ImapCredentialDocument,
@@ -117,8 +119,11 @@ async function checkSmtpLogin(doc: ImapCredentialDocument): Promise<ConnectFailu
117
119
  // Checks the IMAP login, then the SMTP login of the outgoing server; shared by connect and reconnect.
118
120
  export async function checkMailboxLogin(
119
121
  doc: ImapCredentialDocument,
120
- log: { warn(message: string, data?: Record<string, unknown>): void },
122
+ ctx: Pick<BeforeTransactionContext, "services" | "rateLimitDigest" | "obs">,
121
123
  ): Promise<BeforeTransactionResult<null>> {
124
+ const { log } = ctx.obs;
125
+ const limited = await enforceConnectTargetLimit(ctx, doc);
126
+ if (!limited.isSuccess) return limited;
122
127
  try {
123
128
  await connectOnce(doc, true);
124
129
  } catch (err) {
@@ -158,7 +163,7 @@ export async function connectPasswordMailbox(
158
163
  ): Promise<WriteResult<{ accountId: string }>> {
159
164
  const { displayName, address, credentialDocument } = mailbox;
160
165
  const ownerUserId = scope === "user" ? event.user.id : null;
161
- const existing = await findMailboxByAddress(ctx, event.user.tenantId, address);
166
+ const existing = await findMailboxByAddress(ctx, event.user.tenantId, address, ownerUserId);
162
167
  const reopened = existing !== undefined && isReopenableByThisForm(existing, ownerUserId);
163
168
  let accountId: string;
164
169
  if (reopened) {
@@ -222,8 +227,7 @@ export const createConnectMailboxHandler = ({ adminRoles }: InboundMailRoles) =>
222
227
  // used to scan ports or to guess passwords at someone else's mail server.
223
228
  rateLimit: { per: "tenant+handler", limit: 10, windowSeconds: 600 },
224
229
  escapeHatch: { grants: ["unsafeRaw"], reason: SECRET_TRANSACTION_REASON },
225
- beforeTransaction: (event, ctx) =>
226
- checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log),
230
+ beforeTransaction: (event, ctx) => checkMailboxLogin(credentialDocumentOf(event.payload), ctx),
227
231
  handler: async (event, ctx) => {
228
232
  const { displayName, address, trustedAuthservId } = event.payload;
229
233
  const connected = await connectPasswordMailbox(
@@ -2,8 +2,14 @@
2
2
  // Same login check and secret write as connect-mailbox; the sender-check policy is tenant-wide and
3
3
  // stays with the admin form.
4
4
 
5
- import type { InboundMailRoles } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
6
- import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
5
+ import {
6
+ InboundMailConnectErrors,
7
+ type InboundMailRoles,
8
+ isOwnLoginAddress,
9
+ } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
10
+ import { UserQueries } from "@cosmicdrift/kumiko-bundled-features/user";
11
+ import { createSystemUser, defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
12
+ import { UnprocessableError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
7
13
  import {
8
14
  checkMailboxLogin,
9
15
  connectMailboxSchema,
@@ -14,13 +20,13 @@ import {
14
20
 
15
21
  const connectMyMailboxSchema = connectMailboxSchema.omit({ trustedAuthservId: true });
16
22
 
17
- const MY_MAILBOX_ESCAPE_REASON = `${SECRET_TRANSACTION_REASON}; the account is created with writeAs(system) on connect-account, which is admin-only, and the owner comes from the caller's session`;
23
+ const MY_MAILBOX_ESCAPE_REASON = `${SECRET_TRANSACTION_REASON}; the account is created with writeAs(system) on connect-account, which is admin-only, and the owner comes from the caller's session; beforeTransaction reads the caller's own login address with a system queryAs(user findForAuth)`;
18
24
 
19
25
  export const createConnectMyMailboxHandler = ({ memberRoles }: InboundMailRoles) =>
20
26
  defineWriteHandler({
21
27
  name: "connect-my-mailbox",
22
28
  description:
23
- "Connects a personal IMAP mailbox of the caller with a password over implicit TLS: checks the IMAP login and the SMTP login of the outgoing server first, then creates the mail account owned by the caller and stores both servers, user and password as its credential secret in one step. A disconnected personal mailbox of the caller with the same address is reactivated under its old account id.",
29
+ "Connects a personal IMAP mailbox of the caller with a password over implicit TLS; the address must be the email address of the caller's own account (compared case-insensitively), other addresses are connected by an admin as a shared mailbox. Checks the IMAP login and the SMTP login of the outgoing server first, then creates the mail account owned by the caller and stores both servers, user and password as its credential secret in one step. A disconnected personal mailbox of the caller with the same address is reactivated under its old account id.",
24
30
  // The payload carries the plaintext password: as a tool call it would reach the model provider.
25
31
  agent: { expose: false },
26
32
  schema: connectMyMailboxSchema,
@@ -30,8 +36,19 @@ export const createConnectMyMailboxHandler = ({ memberRoles }: InboundMailRoles)
30
36
  // connect-account is admin-only; the personal mailbox is created through the system identity. The owner
31
37
  // is always event.user.id from the session, never a payload field.
32
38
  escapeHatch: { grants: ["unsafeRaw", "systemIdentity"], reason: MY_MAILBOX_ESCAPE_REASON },
33
- beforeTransaction: (event, ctx) =>
34
- checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log),
39
+ // Before the login check, so a foreign address never makes us contact the payload's host.
40
+ beforeTransaction: async (event, ctx) => {
41
+ const ownUser = await ctx.dispatch.queryAs(
42
+ createSystemUser(event.user.tenantId),
43
+ UserQueries.findForAuth,
44
+ { id: event.user.id },
45
+ );
46
+ if (!(await isOwnLoginAddress(ownUser, event.payload.address))) {
47
+ const { reason, i18nKey } = InboundMailConnectErrors.personalAddressNotOwn;
48
+ return writeFailure(new UnprocessableError(reason, { i18nKey }));
49
+ }
50
+ return checkMailboxLogin(credentialDocumentOf(event.payload), ctx);
51
+ },
35
52
  handler: async (event, ctx) => {
36
53
  const { displayName, address } = event.payload;
37
54
  return connectPasswordMailbox(
@@ -0,0 +1,46 @@
1
+ // The handlers' own `rateLimit` counts per tenant, so many tenants could probe one foreign mail
2
+ // host (login oracle, port scan). These buckets are keyed by the target and count across tenants.
3
+ // Trade-off: tokens are booked before the login attempt and the limiter has no refund, so a
4
+ // tenant admin can exhaust a foreign host+user bucket; the oracle protection is the weightier risk.
5
+
6
+ import { InternalError, isKumikoError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
7
+ import type {
8
+ BeforeTransactionContext,
9
+ BeforeTransactionResult,
10
+ } from "@cosmicdrift/kumiko-types/handlers";
11
+ import type { ImapCredentialDocument } from "./credential-document.ts";
12
+
13
+ const TARGET_WINDOW_SECONDS = 600;
14
+ const PER_HOST_LIMIT = 200;
15
+ const PER_HOST_AND_USER_LIMIT = 20;
16
+
17
+ export async function enforceConnectTargetLimit(
18
+ ctx: Pick<BeforeTransactionContext, "services" | "rateLimitDigest">,
19
+ doc: ImapCredentialDocument,
20
+ ): Promise<BeforeTransactionResult<null>> {
21
+ const { rateLimit } = ctx.services;
22
+ const digest = ctx.rateLimitDigest;
23
+ if (!rateLimit || !digest) {
24
+ throw new InternalError({
25
+ message: "inbound-provider-imap connect checks need a rate limiter and a digest key",
26
+ });
27
+ }
28
+ // Trailing dot is the same DNS name; without stripping it `imap.x.com.` would get its own buckets.
29
+ const host = doc.host.toLowerCase().replace(/\.+$/, "");
30
+ try {
31
+ await rateLimit.enforceAll([
32
+ {
33
+ bucket: `imap-connect-host:${digest(host)}`,
34
+ config: { limit: PER_HOST_LIMIT, windowSeconds: TARGET_WINDOW_SECONDS },
35
+ },
36
+ {
37
+ bucket: `imap-connect-host-user:${digest(`${host}\n${doc.user.toLowerCase()}`)}`,
38
+ config: { limit: PER_HOST_AND_USER_LIMIT, windowSeconds: TARGET_WINDOW_SECONDS },
39
+ },
40
+ ]);
41
+ } catch (error) {
42
+ if (isKumikoError(error)) return writeFailure(error);
43
+ throw error;
44
+ }
45
+ return { isSuccess: true, data: null };
46
+ }
@@ -3,26 +3,34 @@ import type {
3
3
  RejectedInboundMessage,
4
4
  } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
5
5
  import type { ImapFlow } from "imapflow";
6
+ import { planWithinByteBudget } from "./byte-budget.ts";
6
7
  import { coerceDate, parseOrReject } from "./parse-message.ts";
7
8
 
8
- export async function downloadBatch(
9
+ export type FetchedAndParsed = {
10
+ readonly messages: RawInboundMessage[];
11
+ readonly rejected: RejectedInboundMessage[];
12
+ /** uids the server returned with a source, parsed or rejected. */
13
+ readonly seenUids: readonly number[];
14
+ };
15
+
16
+ /** The one place that fetches sources from a uid range and parses them, shared by poll, watch and content refetch. */
17
+ export async function fetchAndParse(
9
18
  client: ImapFlow,
10
- batch: readonly number[],
19
+ uidRange: string,
11
20
  uidValidity: string,
12
21
  trustedAuthservId: string | null,
13
- ): Promise<{
14
- readonly messages: RawInboundMessage[];
15
- readonly rejected: RejectedInboundMessage[];
16
- }> {
22
+ minUid = 0,
23
+ ): Promise<FetchedAndParsed> {
17
24
  const messages: RawInboundMessage[] = [];
18
25
  const rejected: RejectedInboundMessage[] = [];
19
- if (batch.length === 0) return { messages, rejected };
26
+ const seenUids: number[] = [];
20
27
  for await (const msg of client.fetch(
21
- batch.join(","),
28
+ uidRange,
22
29
  { uid: true, internalDate: true, source: true, envelope: true },
23
30
  { uid: true },
24
31
  )) {
25
- if (!msg.source) continue;
32
+ // `N:*` always returns the last message even when it is below N.
33
+ if (msg.uid < minUid || !msg.source) continue;
26
34
  const parsed = await parseOrReject({
27
35
  source: msg.source,
28
36
  uid: msg.uid,
@@ -33,6 +41,35 @@ export async function downloadBatch(
33
41
  });
34
42
  if ("message" in parsed) messages.push(parsed.message);
35
43
  else rejected.push(parsed.rejected);
44
+ seenUids.push(msg.uid);
45
+ }
46
+ return { messages, rejected, seenUids };
47
+ }
48
+
49
+ export async function downloadBatch(
50
+ client: ImapFlow,
51
+ batch: readonly number[],
52
+ uidValidity: string,
53
+ trustedAuthservId: string | null,
54
+ ): Promise<{
55
+ readonly messages: RawInboundMessage[];
56
+ readonly rejected: RejectedInboundMessage[];
57
+ /** uids cut by the byte budget; they are fetched in a later round. */
58
+ readonly deferred: readonly number[];
59
+ }> {
60
+ const plan = await planWithinByteBudget(client, batch, uidValidity);
61
+ if (plan.download.length === 0) {
62
+ return { messages: [], rejected: [...plan.tooLarge], deferred: plan.deferred };
36
63
  }
37
- return { messages, rejected };
64
+ const fetched = await fetchAndParse(
65
+ client,
66
+ plan.download.join(","),
67
+ uidValidity,
68
+ trustedAuthservId,
69
+ );
70
+ return {
71
+ messages: fetched.messages,
72
+ rejected: [...plan.tooLarge, ...fetched.rejected],
73
+ deferred: plan.deferred,
74
+ };
38
75
  }
@@ -125,15 +125,17 @@ async function fetchMessages(
125
125
  ? await unknownUidsOf(uids, serverUidValidity, opts.filterUnknownMessageIds)
126
126
  : uids;
127
127
  const batch = unknown.slice(0, opts.maxMessages);
128
- const hasMore = unknown.length > batch.length;
129
- const { messages, rejected } = await downloadBatch(
128
+ const { messages, rejected, deferred } = await downloadBatch(
130
129
  client,
131
130
  batch,
132
131
  serverUidValidity,
133
132
  account.trustedAuthservId ?? null,
134
133
  );
134
+ const deferredUids = new Set(deferred);
135
+ const handled = batch.filter((uid) => !deferredUids.has(uid));
136
+ const hasMore = unknown.length > handled.length;
135
137
  // From the UIDs, not from what was downloaded: a known or skipped mail must not hold the cursor back.
136
- const lastUid = Math.max(parsedCursor?.lastUid ?? 0, ...(hasMore ? batch : uids));
138
+ const lastUid = Math.max(parsedCursor?.lastUid ?? 0, ...(hasMore ? handled : uids));
137
139
 
138
140
  return {
139
141
  messages,
@@ -174,7 +176,7 @@ export function createInboundProviderImapFeature(options: InboundMailRoleOptions
174
176
  FEATURE_NAME,
175
177
  (r) => {
176
178
  r.describe(
177
- 'Registers the `"imap"` provider for `inbound-mail-foundation` using imapflow — password/app-password auth covers classic IMAP hosts without any OAuth (plus an XOAUTH2 fallback consuming an access token from the secret slot). Incremental sync via a UIDVALIDITY:lastUid cursor (UIDVALIDITY change triggers a cursor-invalid full resync), initial backfill bounded by the foundation backfill window, and live push via IMAP IDLE for the watch supervisor. Tenant admins connect a shared mailbox through the "Connect mailbox" form on the mail accounts list and members a personal one through the same form on "My mail accounts" (`connect-mailbox` and `connect-my-mailbox` check the IMAP login and the SMTP login of the outgoing server first, then creates the account and its credential secret in one transaction; `reconnect-mailbox` does the same check for an existing mailbox with a sign-in error and overwrites its credential secret); programmatic setups store the per-account connection JSON (host/port/secure/user/password, plus smtpHost/smtpPort for sending) in the account credential secret slot before the first sync. Implements the provider `send`: `sendMailFromAccount` sends over the SMTP server of the mailbox itself (implicit TLS, same login) with the mailbox address as From and stores a copy in its sent folder.',
179
+ 'Registers the `"imap"` provider for `inbound-mail-foundation` using imapflow — password/app-password auth covers classic IMAP hosts without any OAuth (plus an XOAUTH2 fallback consuming an access token from the secret slot). Incremental sync via a UIDVALIDITY:lastUid cursor (UIDVALIDITY change triggers a cursor-invalid full resync), initial backfill bounded by the foundation backfill window, and live push via IMAP IDLE for the watch supervisor. Tenant admins connect a shared mailbox through the "Connect mailbox" form on the mail accounts list and members a personal one through the same form on "My mail accounts" (`connect-mailbox` and `connect-my-mailbox` check the IMAP login and the SMTP login of the outgoing server first, then creates the account and its credential secret in one transaction; `reconnect-mailbox` does the same check for an existing mailbox with a sign-in error and overwrites its credential secret); programmatic setups store the per-account connection JSON (host/port/secure/user/password, plus smtpHost/smtpPort for sending) in the account credential secret slot before the first sync. Implements the provider `send`: `sendMailFromAccount` sends over the SMTP server of the mailbox itself (TLS enforced: implicit on port 465, STARTTLS with requireTLS on every other port, port from the credential document, connect form default 587; same login) with the mailbox address as From and stores a copy in its sent folder.',
178
180
  );
179
181
  r.uiHints({
180
182
  displayLabel: "Inbound Mail · IMAP",
@@ -183,6 +185,7 @@ export function createInboundProviderImapFeature(options: InboundMailRoleOptions
183
185
  });
184
186
  r.requires({ features: ["inbound-mail-foundation"] });
185
187
  r.requires({ features: ["secrets"] });
188
+ r.requires({ features: ["user"] });
186
189
  r.envSchema(mailAllowedPrivateHostsEnvSchema);
187
190
  r.useExtension(INBOUND_MAIL_PROVIDER_EXTENSION, IMAP_PROVIDER_KEY, imapInboundMailPlugin);
188
191
  r.bootCheck(({ features }) => assertRolesMatchFoundation(FEATURE_NAME, roles, features));
@@ -10,7 +10,10 @@ import type {
10
10
  RejectedInboundMessage,
11
11
  } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
12
12
  import { InboundTransientError } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
13
+ import type { ImapFlow } from "imapflow";
14
+ import { planWithinByteBudget } from "./byte-budget.ts";
13
15
  import { readCredentialDocument } from "./credential-document.ts";
16
+ import { fetchAndParse } from "./download-batch.ts";
14
17
  import {
15
18
  closeOnAbort,
16
19
  createImapClient,
@@ -18,7 +21,6 @@ import {
18
21
  imapMailHostGuard,
19
22
  mapImapError,
20
23
  } from "./imap-client.ts";
21
- import { coerceDate, parseOrReject } from "./parse-message.ts";
22
24
 
23
25
  function uidOf(providerMessageId: string, serverUidValidity: string): number | null {
24
26
  const separator = providerMessageId.lastIndexOf(":");
@@ -27,6 +29,41 @@ function uidOf(providerMessageId: string, serverUidValidity: string): number | n
27
29
  return Number.isInteger(uid) && uid > 0 ? uid : null;
28
30
  }
29
31
 
32
+ function splitByServerUidValidity(
33
+ providerMessageIds: readonly string[],
34
+ serverUidValidity: string,
35
+ ): { readonly idByUid: Map<number, string>; readonly missing: string[] } {
36
+ const idByUid = new Map<number, string>();
37
+ const missing: string[] = [];
38
+ for (const id of providerMessageIds) {
39
+ const uid = uidOf(id, serverUidValidity);
40
+ if (uid === null) missing.push(id);
41
+ else idByUid.set(uid, id);
42
+ }
43
+ return { idByUid, missing };
44
+ }
45
+
46
+ async function downloadWithinBudget(
47
+ client: ImapFlow,
48
+ idByUid: Map<number, string>,
49
+ serverUidValidity: string,
50
+ ): Promise<{
51
+ readonly messages: RawInboundMessage[];
52
+ readonly rejected: RejectedInboundMessage[];
53
+ }> {
54
+ const plan = await planWithinByteBudget(client, [...idByUid.keys()], serverUidValidity);
55
+ for (const rejectedMail of plan.tooLarge) {
56
+ const tooLargeUid = uidOf(rejectedMail.providerMessageId, serverUidValidity);
57
+ if (tooLargeUid !== null) idByUid.delete(tooLargeUid);
58
+ }
59
+ // Cut by the byte budget, not gone: they stay candidates and come in a later round.
60
+ for (const uid of plan.deferred) idByUid.delete(uid);
61
+ if (plan.download.length === 0) return { messages: [], rejected: [...plan.tooLarge] };
62
+ const fetched = await fetchAndParse(client, plan.download.join(","), serverUidValidity, null);
63
+ for (const uid of fetched.seenUids) idByUid.delete(uid);
64
+ return { messages: fetched.messages, rejected: [...plan.tooLarge, ...fetched.rejected] };
65
+ }
66
+
30
67
  export async function fetchMessageContent(
31
68
  ctx: InboundMailContext,
32
69
  account: MailAccountRecord,
@@ -43,34 +80,11 @@ export async function fetchMessageContent(
43
80
  const mailbox = client.mailbox;
44
81
  if (typeof mailbox === "boolean") throw new InboundTransientError("mailbox not open");
45
82
  const serverUidValidity = String(mailbox.uidValidity);
46
- const idByUid = new Map<number, string>();
47
- const missing: string[] = [];
48
- for (const id of providerMessageIds) {
49
- const uid = uidOf(id, serverUidValidity);
50
- if (uid === null) missing.push(id);
51
- else idByUid.set(uid, id);
52
- }
53
- const messages: RawInboundMessage[] = [];
54
- const rejected: RejectedInboundMessage[] = [];
55
- if (idByUid.size > 0) {
56
- for await (const msg of client.fetch(
57
- [...idByUid.keys()].join(","),
58
- { uid: true, internalDate: true, source: true, envelope: true },
59
- { uid: true },
60
- )) {
61
- if (!msg.source) continue;
62
- const parsed = await parseOrReject({
63
- source: msg.source,
64
- uid: msg.uid,
65
- uidValidity: serverUidValidity,
66
- internalDate: coerceDate(msg.internalDate ?? undefined),
67
- envelope: msg.envelope,
68
- });
69
- idByUid.delete(msg.uid);
70
- if ("message" in parsed) messages.push(parsed.message);
71
- else rejected.push(parsed.rejected);
72
- }
73
- }
83
+ const { idByUid, missing } = splitByServerUidValidity(providerMessageIds, serverUidValidity);
84
+ const { messages, rejected } =
85
+ idByUid.size > 0
86
+ ? await downloadWithinBudget(client, idByUid, serverUidValidity)
87
+ : { messages: [], rejected: [] };
74
88
  // What the server did not return is gone (expunged since the import).
75
89
  missing.push(...idByUid.values());
76
90
  return { messages, missing, rejected };
@@ -33,7 +33,7 @@ export const INBOUND_PROVIDER_IMAP_I18N: Readonly<Record<string, { readonly en:
33
33
  "inboundMail.imap.connect.server": { en: "Server sign-in" },
34
34
  "inboundMail.imap.connect.outgoing": { en: "Sending" },
35
35
  "inboundMail.imap.connect.outgoingHint": {
36
- en: "Replies go out from this address over your own mail server, with the same user name and password. Leave the field empty if the server is called like the IMAP server, with smtp. instead of imap. Usually 587, even when your provider lists 465/SSL.",
36
+ en: "Replies go out from this address over your own mail server, with the same user name and password. Leave the field empty if the server is called like the IMAP server, with smtp. instead of imap. Usually 587, even when your provider lists 465/SSL. Port 465 means SSL/TLS, every other port means STARTTLS.",
37
37
  },
38
38
  [formFieldKey("trustedAuthservId")]: { en: "Mail server ID" },
39
39
  "inboundMail.imap.connect.senderCheck": { en: "Sender check" },
@@ -55,7 +55,7 @@ export const INBOUND_PROVIDER_IMAP_I18N: Readonly<Record<string, { readonly en:
55
55
  en: "The IMAP server rejected the sign-in. Check the user name and password.",
56
56
  },
57
57
  [IMAP_CONNECT_ERRORS.tlsFailed.i18nKey]: {
58
- en: "The encrypted connection failed. Check the port and the TLS setting.",
58
+ en: "The encrypted connection failed. Check that the port is the IMAPS port (usually 993).",
59
59
  },
60
60
  [IMAP_CONNECT_ERRORS.connectFailed.i18nKey]: {
61
61
  en: "No connection to the IMAP server. Check the server name and port.",
@@ -120,6 +120,20 @@ function headersOfEnvelope(
120
120
  };
121
121
  }
122
122
 
123
+ /** A mail that was not downloaded (too large): quarantined by its envelope, with no original to retry from. */
124
+ export function rejectedWithoutSource(args: {
125
+ readonly uid: number;
126
+ readonly uidValidity: string;
127
+ readonly internalDate: Date | undefined;
128
+ readonly envelope?: MessageEnvelopeObject | undefined;
129
+ }): RejectedInboundMessage {
130
+ return {
131
+ providerMessageId: buildProviderMessageId(args.uidValidity, args.uid),
132
+ reason: "unparseable",
133
+ ...(args.envelope && { headers: headersOfEnvelope(args.envelope, args.internalDate) }),
134
+ };
135
+ }
136
+
123
137
  export type ParsedOrRejected =
124
138
  | { readonly message: RawInboundMessage }
125
139
  | { readonly rejected: RejectedInboundMessage };
@@ -60,7 +60,7 @@ export const createReconnectMailboxHandler = ({ memberRoles, adminRoles }: Inbou
60
60
  if (!mayReactivateMailbox(lookup.row.ownerUserId, ctx.user, adminRoles)) {
61
61
  return failNotFound("mail-account", event.payload.accountId);
62
62
  }
63
- return checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log);
63
+ return checkMailboxLogin(credentialDocumentOf(event.payload), ctx);
64
64
  },
65
65
  handler: async (event, ctx) => {
66
66
  const { accountId } = event.payload;
@@ -86,14 +86,15 @@ export const createReconnectMailboxHandler = ({ memberRoles, adminRoles }: Inbou
86
86
  },
87
87
  );
88
88
  if (!reactivated.isSuccess) return reactivated;
89
- // The sender-check policy is tenant-wide: only admins set it, the owner's form does not carry it.
90
- if (isMailAdmin(event.user, adminRoles)) {
89
+ // The sender-check policy is tenant-wide: only admins set it, and only when the form carries
90
+ // the field. The owner's form omits it, and an admin using that form must not clear the policy.
91
+ if (isMailAdmin(event.user, adminRoles) && event.payload.trustedAuthservId !== undefined) {
91
92
  // The admin form shows the stored id, so an empty field means the admin cleared it.
92
93
  const trusted = await ctx.dispatch.write(
93
94
  InboundMailFoundationHandlers.setTrustedAuthservId,
94
95
  {
95
96
  accountId,
96
- trustedAuthservId: event.payload.trustedAuthservId ?? null,
97
+ trustedAuthservId: event.payload.trustedAuthservId,
97
98
  },
98
99
  );
99
100
  if (!trusted.isSuccess) return trusted;
@@ -6,6 +6,7 @@ import {
6
6
  InboundAuthError,
7
7
  type InboundMailContext,
8
8
  InboundTransientError,
9
+ isInboundAuthError,
9
10
  type MailAccountRecord,
10
11
  MailSendNotConfiguredError,
11
12
  MailSendRejectedError,
@@ -15,11 +16,18 @@ import {
15
16
  } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
16
17
  import MailComposer from "nodemailer/lib/mail-composer";
17
18
  import { FEATURE_NAME } from "./constants.ts";
18
- import { readCredentialDocument } from "./credential-document.ts";
19
+ import { type ImapCredentialDocument, readCredentialDocument } from "./credential-document.ts";
19
20
  import { appendToSentFolder } from "./sent-folder.ts";
20
21
  import { SmtpFailureError, sendRawViaSmtp } from "./smtp-client.ts";
21
22
 
22
- function toFoundationSendError(err: SmtpFailureError): Error {
23
+ // A host the guard blocks stays blocked and a failed certificate check stays failed: retrying
24
+ // cannot help, the tenant has to connect the mailbox again.
25
+ function isPermanentSmtpFailure(err: SmtpFailureError): boolean {
26
+ return err.failure === "tlsFailed" || (err.failure === "hostUnreachable" && err.blocked);
27
+ }
28
+
29
+ export function toFoundationSendError(err: SmtpFailureError): Error {
30
+ if (isPermanentSmtpFailure(err)) return new MailSendNotConfiguredError(err.message);
23
31
  switch (err.failure) {
24
32
  case "loginRejected":
25
33
  return new InboundAuthError(err.message);
@@ -34,13 +42,31 @@ function stripAngles(id: string): string {
34
42
  return id.replace(/^<|>$/g, "");
35
43
  }
36
44
 
45
+ // A missing or unreadable credential document means no login was attempted: the mailbox has to be
46
+ // connected again, which is not a rejected password.
47
+ async function readSendCredentialDocument(
48
+ ctx: InboundMailContext,
49
+ account: MailAccountRecord,
50
+ ): Promise<ImapCredentialDocument> {
51
+ try {
52
+ return await readCredentialDocument(ctx, account);
53
+ } catch (err) {
54
+ if (isInboundAuthError(err)) {
55
+ throw new MailSendNotConfiguredError(
56
+ `${FEATURE_NAME}: account ${account.id} has no usable credential document`,
57
+ );
58
+ }
59
+ throw err;
60
+ }
61
+ }
62
+
37
63
  export async function sendFromImapAccount(
38
64
  ctx: InboundMailContext,
39
65
  account: MailAccountRecord,
40
66
  message: OutboundMailMessage,
41
67
  attachments: readonly OutboundAttachment[],
42
68
  ): Promise<ProviderSentMail> {
43
- const doc = await readCredentialDocument(ctx, account);
69
+ const doc = await readSendCredentialDocument(ctx, account);
44
70
  if (!doc.smtpHost || !doc.password) {
45
71
  throw new MailSendNotConfiguredError(
46
72
  `${FEATURE_NAME}: account ${account.id} has no outgoing server stored`,
@@ -67,16 +93,22 @@ export async function sendFromImapAccount(
67
93
  }).compile();
68
94
  const raw = await mime.build();
69
95
 
96
+ let rejectedRecipients: readonly string[];
70
97
  try {
71
- await sendRawViaSmtp(
98
+ ({ rejectedRecipients } = await sendRawViaSmtp(
72
99
  { host: doc.smtpHost, port: doc.smtpPort, user: doc.user, password: doc.password },
73
100
  { from: account.address, to: [...message.to, ...(message.cc ?? [])] },
74
101
  raw,
75
- );
102
+ ));
76
103
  } catch (err) {
77
104
  throw err instanceof SmtpFailureError ? toFoundationSendError(err) : err;
78
105
  }
79
106
 
80
- await appendToSentFolder(doc, raw, account.id);
81
- return { messageIdHeader: stripAngles(mime.messageId()) };
107
+ // Detached: the copy is best effort and must not keep the caller (maybe inside a request
108
+ // transaction) waiting for another server round trip; appendToSentFolder never rejects.
109
+ void appendToSentFolder(doc, raw, account.id);
110
+ return {
111
+ messageIdHeader: stripAngles(mime.messageId()),
112
+ ...(rejectedRecipients.length > 0 && { rejectedRecipients }),
113
+ };
82
114
  }