@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
@@ -8,6 +8,7 @@ import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
8
8
  import { createSystemUser, defineWriteHandler, } from "@cosmicdrift/kumiko-framework/engine";
9
9
  import { UnprocessableError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
10
10
  import * as z from "zod";
11
+ import { enforceConnectTargetLimit } from "./connect-target-rate-limit.js";
11
12
  import { IMAP_CONNECT_ERRORS, IMAP_PROVIDER_KEY, SMTP_CONNECT_ERRORS } from "./constants.js";
12
13
  import { imapCredentialDocumentSchema, smtpHostSchema, } from "./credential-document.js";
13
14
  import { connectOnce, IMAP_HOST_UNREACHABLE_MESSAGE } from "./imap-client.js";
@@ -81,7 +82,11 @@ async function checkSmtpLogin(doc) {
81
82
  }
82
83
  }
83
84
  // Checks the IMAP login, then the SMTP login of the outgoing server; shared by connect and reconnect.
84
- export async function checkMailboxLogin(doc, log) {
85
+ export async function checkMailboxLogin(doc, ctx) {
86
+ const { log } = ctx.obs;
87
+ const limited = await enforceConnectTargetLimit(ctx, doc);
88
+ if (!limited.isSuccess)
89
+ return limited;
85
90
  try {
86
91
  await connectOnce(doc, true);
87
92
  }
@@ -105,7 +110,7 @@ export const SECRET_TRANSACTION_REASON = "the credential secret is written on th
105
110
  export async function connectPasswordMailbox(handlerName, event, ctx, mailbox, scope) {
106
111
  const { displayName, address, credentialDocument } = mailbox;
107
112
  const ownerUserId = scope === "user" ? event.user.id : null;
108
- const existing = await findMailboxByAddress(ctx, event.user.tenantId, address);
113
+ const existing = await findMailboxByAddress(ctx, event.user.tenantId, address, ownerUserId);
109
114
  const reopened = existing !== undefined && isReopenableByThisForm(existing, ownerUserId);
110
115
  let accountId;
111
116
  if (reopened) {
@@ -155,7 +160,7 @@ export const createConnectMailboxHandler = ({ adminRoles }) => defineWriteHandle
155
160
  // used to scan ports or to guess passwords at someone else's mail server.
156
161
  rateLimit: { per: "tenant+handler", limit: 10, windowSeconds: 600 },
157
162
  escapeHatch: { grants: ["unsafeRaw"], reason: SECRET_TRANSACTION_REASON },
158
- beforeTransaction: (event, ctx) => checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log),
163
+ beforeTransaction: (event, ctx) => checkMailboxLogin(credentialDocumentOf(event.payload), ctx),
159
164
  handler: async (event, ctx) => {
160
165
  const { displayName, address, trustedAuthservId } = event.payload;
161
166
  const connected = await connectPasswordMailbox("connect-mailbox", event, ctx, { displayName, address, credentialDocument: credentialDocumentOf(event.payload) }, "shared");
@@ -1,4 +1,4 @@
1
- import type { InboundMailRoles } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
1
+ import { type InboundMailRoles } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
2
2
  export declare const createConnectMyMailboxHandler: ({ memberRoles }: InboundMailRoles) => import("@cosmicdrift/kumiko-types/define-handler").WriteHandlerDefinition<"connect-my-mailbox", import("zod").ZodObject<{
3
3
  host: import("zod").ZodString;
4
4
  port: import("zod").ZodDefault<import("zod").ZodNumber>;
@@ -1,13 +1,16 @@
1
1
  // connect-my-mailbox: a member connects a personal password IMAP mailbox (owner = the caller).
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
- import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
4
+ import { InboundMailConnectErrors, isOwnLoginAddress, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
5
+ import { UserQueries } from "@cosmicdrift/kumiko-bundled-features/user";
6
+ import { createSystemUser, defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
7
+ import { UnprocessableError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
5
8
  import { checkMailboxLogin, connectMailboxSchema, connectPasswordMailbox, credentialDocumentOf, SECRET_TRANSACTION_REASON, } from "./connect-mailbox.js";
6
9
  const connectMyMailboxSchema = connectMailboxSchema.omit({ trustedAuthservId: true });
7
- 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`;
10
+ 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)`;
8
11
  export const createConnectMyMailboxHandler = ({ memberRoles }) => defineWriteHandler({
9
12
  name: "connect-my-mailbox",
10
- description: "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.",
13
+ description: "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.",
11
14
  // The payload carries the plaintext password: as a tool call it would reach the model provider.
12
15
  agent: { expose: false },
13
16
  schema: connectMyMailboxSchema,
@@ -17,7 +20,15 @@ export const createConnectMyMailboxHandler = ({ memberRoles }) => defineWriteHan
17
20
  // connect-account is admin-only; the personal mailbox is created through the system identity. The owner
18
21
  // is always event.user.id from the session, never a payload field.
19
22
  escapeHatch: { grants: ["unsafeRaw", "systemIdentity"], reason: MY_MAILBOX_ESCAPE_REASON },
20
- beforeTransaction: (event, ctx) => checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log),
23
+ // Before the login check, so a foreign address never makes us contact the payload's host.
24
+ beforeTransaction: async (event, ctx) => {
25
+ const ownUser = await ctx.dispatch.queryAs(createSystemUser(event.user.tenantId), UserQueries.findForAuth, { id: event.user.id });
26
+ if (!(await isOwnLoginAddress(ownUser, event.payload.address))) {
27
+ const { reason, i18nKey } = InboundMailConnectErrors.personalAddressNotOwn;
28
+ return writeFailure(new UnprocessableError(reason, { i18nKey }));
29
+ }
30
+ return checkMailboxLogin(credentialDocumentOf(event.payload), ctx);
31
+ },
21
32
  handler: async (event, ctx) => {
22
33
  const { displayName, address } = event.payload;
23
34
  return connectPasswordMailbox("connect-my-mailbox", event, ctx, { displayName, address, credentialDocument: credentialDocumentOf(event.payload) }, "user");
@@ -0,0 +1,3 @@
1
+ import type { BeforeTransactionContext, BeforeTransactionResult } from "@cosmicdrift/kumiko-types/handlers";
2
+ import type { ImapCredentialDocument } from "./credential-document.ts";
3
+ export declare function enforceConnectTargetLimit(ctx: Pick<BeforeTransactionContext, "services" | "rateLimitDigest">, doc: ImapCredentialDocument): Promise<BeforeTransactionResult<null>>;
@@ -0,0 +1,37 @@
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
+ import { InternalError, isKumikoError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
6
+ const TARGET_WINDOW_SECONDS = 600;
7
+ const PER_HOST_LIMIT = 200;
8
+ const PER_HOST_AND_USER_LIMIT = 20;
9
+ export async function enforceConnectTargetLimit(ctx, doc) {
10
+ const { rateLimit } = ctx.services;
11
+ const digest = ctx.rateLimitDigest;
12
+ if (!rateLimit || !digest) {
13
+ throw new InternalError({
14
+ message: "inbound-provider-imap connect checks need a rate limiter and a digest key",
15
+ });
16
+ }
17
+ // Trailing dot is the same DNS name; without stripping it `imap.x.com.` would get its own buckets.
18
+ const host = doc.host.toLowerCase().replace(/\.+$/, "");
19
+ try {
20
+ await rateLimit.enforceAll([
21
+ {
22
+ bucket: `imap-connect-host:${digest(host)}`,
23
+ config: { limit: PER_HOST_LIMIT, windowSeconds: TARGET_WINDOW_SECONDS },
24
+ },
25
+ {
26
+ bucket: `imap-connect-host-user:${digest(`${host}\n${doc.user.toLowerCase()}`)}`,
27
+ config: { limit: PER_HOST_AND_USER_LIMIT, windowSeconds: TARGET_WINDOW_SECONDS },
28
+ },
29
+ ]);
30
+ }
31
+ catch (error) {
32
+ if (isKumikoError(error))
33
+ return writeFailure(error);
34
+ throw error;
35
+ }
36
+ return { isSuccess: true, data: null };
37
+ }
@@ -1,6 +1,16 @@
1
1
  import type { RawInboundMessage, RejectedInboundMessage } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
2
2
  import type { ImapFlow } from "imapflow";
3
+ export type FetchedAndParsed = {
4
+ readonly messages: RawInboundMessage[];
5
+ readonly rejected: RejectedInboundMessage[];
6
+ /** uids the server returned with a source, parsed or rejected. */
7
+ readonly seenUids: readonly number[];
8
+ };
9
+ /** The one place that fetches sources from a uid range and parses them, shared by poll, watch and content refetch. */
10
+ export declare function fetchAndParse(client: ImapFlow, uidRange: string, uidValidity: string, trustedAuthservId: string | null, minUid?: number): Promise<FetchedAndParsed>;
3
11
  export declare function downloadBatch(client: ImapFlow, batch: readonly number[], uidValidity: string, trustedAuthservId: string | null): Promise<{
4
12
  readonly messages: RawInboundMessage[];
5
13
  readonly rejected: RejectedInboundMessage[];
14
+ /** uids cut by the byte budget; they are fetched in a later round. */
15
+ readonly deferred: readonly number[];
6
16
  }>;
@@ -1,11 +1,13 @@
1
+ import { planWithinByteBudget } from "./byte-budget.js";
1
2
  import { coerceDate, parseOrReject } from "./parse-message.js";
2
- export async function downloadBatch(client, batch, uidValidity, trustedAuthservId) {
3
+ /** The one place that fetches sources from a uid range and parses them, shared by poll, watch and content refetch. */
4
+ export async function fetchAndParse(client, uidRange, uidValidity, trustedAuthservId, minUid = 0) {
3
5
  const messages = [];
4
6
  const rejected = [];
5
- if (batch.length === 0)
6
- return { messages, rejected };
7
- for await (const msg of client.fetch(batch.join(","), { uid: true, internalDate: true, source: true, envelope: true }, { uid: true })) {
8
- if (!msg.source)
7
+ const seenUids = [];
8
+ for await (const msg of client.fetch(uidRange, { uid: true, internalDate: true, source: true, envelope: true }, { uid: true })) {
9
+ // `N:*` always returns the last message even when it is below N.
10
+ if (msg.uid < minUid || !msg.source)
9
11
  continue;
10
12
  const parsed = await parseOrReject({
11
13
  source: msg.source,
@@ -19,6 +21,19 @@ export async function downloadBatch(client, batch, uidValidity, trustedAuthservI
19
21
  messages.push(parsed.message);
20
22
  else
21
23
  rejected.push(parsed.rejected);
24
+ seenUids.push(msg.uid);
25
+ }
26
+ return { messages, rejected, seenUids };
27
+ }
28
+ export async function downloadBatch(client, batch, uidValidity, trustedAuthservId) {
29
+ const plan = await planWithinByteBudget(client, batch, uidValidity);
30
+ if (plan.download.length === 0) {
31
+ return { messages: [], rejected: [...plan.tooLarge], deferred: plan.deferred };
22
32
  }
23
- return { messages, rejected };
33
+ const fetched = await fetchAndParse(client, plan.download.join(","), uidValidity, trustedAuthservId);
34
+ return {
35
+ messages: fetched.messages,
36
+ rejected: [...plan.tooLarge, ...fetched.rejected],
37
+ deferred: plan.deferred,
38
+ };
24
39
  }
@@ -82,10 +82,12 @@ async function fetchMessages(ctx, account, cursor, opts) {
82
82
  ? await unknownUidsOf(uids, serverUidValidity, opts.filterUnknownMessageIds)
83
83
  : uids;
84
84
  const batch = unknown.slice(0, opts.maxMessages);
85
- const hasMore = unknown.length > batch.length;
86
- const { messages, rejected } = await downloadBatch(client, batch, serverUidValidity, account.trustedAuthservId ?? null);
85
+ const { messages, rejected, deferred } = await downloadBatch(client, batch, serverUidValidity, account.trustedAuthservId ?? null);
86
+ const deferredUids = new Set(deferred);
87
+ const handled = batch.filter((uid) => !deferredUids.has(uid));
88
+ const hasMore = unknown.length > handled.length;
87
89
  // From the UIDs, not from what was downloaded: a known or skipped mail must not hold the cursor back.
88
- const lastUid = Math.max(parsedCursor?.lastUid ?? 0, ...(hasMore ? batch : uids));
90
+ const lastUid = Math.max(parsedCursor?.lastUid ?? 0, ...(hasMore ? handled : uids));
89
91
  return {
90
92
  messages,
91
93
  ...(rejected.length > 0 && { rejected }),
@@ -121,7 +123,7 @@ export const imapInboundMailPlugin = {
121
123
  export function createInboundProviderImapFeature(options = {}) {
122
124
  const roles = resolveInboundMailRoles(options);
123
125
  return defineFeature(FEATURE_NAME, (r) => {
124
- r.describe('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.');
126
+ r.describe('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.');
125
127
  r.uiHints({
126
128
  displayLabel: "Inbound Mail · IMAP",
127
129
  category: "notifications",
@@ -129,6 +131,7 @@ export function createInboundProviderImapFeature(options = {}) {
129
131
  });
130
132
  r.requires({ features: ["inbound-mail-foundation"] });
131
133
  r.requires({ features: ["secrets"] });
134
+ r.requires({ features: ["user"] });
132
135
  r.envSchema(mailAllowedPrivateHostsEnvSchema);
133
136
  r.useExtension(INBOUND_MAIL_PROVIDER_EXTENSION, IMAP_PROVIDER_KEY, imapInboundMailPlugin);
134
137
  r.bootCheck(({ features }) => assertRolesMatchFoundation(FEATURE_NAME, roles, features));
@@ -2,9 +2,10 @@
2
2
  // id is "<uidValidity>:<uid>"; ids from another UIDVALIDITY or gone from the server are "missing"
3
3
  // (nothing to reload, ever), mails the parser cannot read are "rejected".
4
4
  import { InboundTransientError } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
5
+ import { planWithinByteBudget } from "./byte-budget.js";
5
6
  import { readCredentialDocument } from "./credential-document.js";
7
+ import { fetchAndParse } from "./download-batch.js";
6
8
  import { closeOnAbort, createImapClient, IMAP_MAILBOX, imapMailHostGuard, mapImapError, } from "./imap-client.js";
7
- import { coerceDate, parseOrReject } from "./parse-message.js";
8
9
  function uidOf(providerMessageId, serverUidValidity) {
9
10
  const separator = providerMessageId.lastIndexOf(":");
10
11
  if (separator < 0 || providerMessageId.slice(0, separator) !== serverUidValidity)
@@ -12,6 +13,35 @@ function uidOf(providerMessageId, serverUidValidity) {
12
13
  const uid = Number(providerMessageId.slice(separator + 1));
13
14
  return Number.isInteger(uid) && uid > 0 ? uid : null;
14
15
  }
16
+ function splitByServerUidValidity(providerMessageIds, serverUidValidity) {
17
+ const idByUid = new Map();
18
+ const missing = [];
19
+ for (const id of providerMessageIds) {
20
+ const uid = uidOf(id, serverUidValidity);
21
+ if (uid === null)
22
+ missing.push(id);
23
+ else
24
+ idByUid.set(uid, id);
25
+ }
26
+ return { idByUid, missing };
27
+ }
28
+ async function downloadWithinBudget(client, idByUid, serverUidValidity) {
29
+ const plan = await planWithinByteBudget(client, [...idByUid.keys()], serverUidValidity);
30
+ for (const rejectedMail of plan.tooLarge) {
31
+ const tooLargeUid = uidOf(rejectedMail.providerMessageId, serverUidValidity);
32
+ if (tooLargeUid !== null)
33
+ idByUid.delete(tooLargeUid);
34
+ }
35
+ // Cut by the byte budget, not gone: they stay candidates and come in a later round.
36
+ for (const uid of plan.deferred)
37
+ idByUid.delete(uid);
38
+ if (plan.download.length === 0)
39
+ return { messages: [], rejected: [...plan.tooLarge] };
40
+ const fetched = await fetchAndParse(client, plan.download.join(","), serverUidValidity, null);
41
+ for (const uid of fetched.seenUids)
42
+ idByUid.delete(uid);
43
+ return { messages: fetched.messages, rejected: [...plan.tooLarge, ...fetched.rejected] };
44
+ }
15
45
  export async function fetchMessageContent(ctx, account, providerMessageIds, opts) {
16
46
  const doc = await readCredentialDocument(ctx, account);
17
47
  const client = await createImapClient(doc, imapMailHostGuard());
@@ -24,35 +54,10 @@ export async function fetchMessageContent(ctx, account, providerMessageIds, opts
24
54
  if (typeof mailbox === "boolean")
25
55
  throw new InboundTransientError("mailbox not open");
26
56
  const serverUidValidity = String(mailbox.uidValidity);
27
- const idByUid = new Map();
28
- const missing = [];
29
- for (const id of providerMessageIds) {
30
- const uid = uidOf(id, serverUidValidity);
31
- if (uid === null)
32
- missing.push(id);
33
- else
34
- idByUid.set(uid, id);
35
- }
36
- const messages = [];
37
- const rejected = [];
38
- if (idByUid.size > 0) {
39
- for await (const msg of client.fetch([...idByUid.keys()].join(","), { uid: true, internalDate: true, source: true, envelope: true }, { uid: true })) {
40
- if (!msg.source)
41
- continue;
42
- const parsed = await parseOrReject({
43
- source: msg.source,
44
- uid: msg.uid,
45
- uidValidity: serverUidValidity,
46
- internalDate: coerceDate(msg.internalDate ?? undefined),
47
- envelope: msg.envelope,
48
- });
49
- idByUid.delete(msg.uid);
50
- if ("message" in parsed)
51
- messages.push(parsed.message);
52
- else
53
- rejected.push(parsed.rejected);
54
- }
55
- }
57
+ const { idByUid, missing } = splitByServerUidValidity(providerMessageIds, serverUidValidity);
58
+ const { messages, rejected } = idByUid.size > 0
59
+ ? await downloadWithinBudget(client, idByUid, serverUidValidity)
60
+ : { messages: [], rejected: [] };
56
61
  // What the server did not return is gone (expunged since the import).
57
62
  missing.push(...idByUid.values());
58
63
  return { messages, missing, rejected };
@@ -20,7 +20,7 @@ export const INBOUND_PROVIDER_IMAP_I18N = {
20
20
  "inboundMail.imap.connect.server": { en: "Server sign-in" },
21
21
  "inboundMail.imap.connect.outgoing": { en: "Sending" },
22
22
  "inboundMail.imap.connect.outgoingHint": {
23
- 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.",
23
+ 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.",
24
24
  },
25
25
  [formFieldKey("trustedAuthservId")]: { en: "Mail server ID" },
26
26
  "inboundMail.imap.connect.senderCheck": { en: "Sender check" },
@@ -42,7 +42,7 @@ export const INBOUND_PROVIDER_IMAP_I18N = {
42
42
  en: "The IMAP server rejected the sign-in. Check the user name and password.",
43
43
  },
44
44
  [IMAP_CONNECT_ERRORS.tlsFailed.i18nKey]: {
45
- en: "The encrypted connection failed. Check the port and the TLS setting.",
45
+ en: "The encrypted connection failed. Check that the port is the IMAPS port (usually 993).",
46
46
  },
47
47
  [IMAP_CONNECT_ERRORS.connectFailed.i18nKey]: {
48
48
  en: "No connection to the IMAP server. Check the server name and port.",
@@ -25,6 +25,13 @@ export declare function toRawInboundMessage(args: {
25
25
  /** authserv-id of the mailbox's own server; without it senderAuthentication is null. */
26
26
  readonly trustedAuthservId?: string | null;
27
27
  }): Promise<RawInboundMessage>;
28
+ /** A mail that was not downloaded (too large): quarantined by its envelope, with no original to retry from. */
29
+ export declare function rejectedWithoutSource(args: {
30
+ readonly uid: number;
31
+ readonly uidValidity: string;
32
+ readonly internalDate: Date | undefined;
33
+ readonly envelope?: MessageEnvelopeObject | undefined;
34
+ }): RejectedInboundMessage;
28
35
  export type ParsedOrRejected = {
29
36
  readonly message: RawInboundMessage;
30
37
  } | {
@@ -89,6 +89,14 @@ function headersOfEnvelope(envelope, internalDate) {
89
89
  receivedAtIso: receivedAt ? legacyDateToInstant(receivedAt).toString() : "",
90
90
  };
91
91
  }
92
+ /** A mail that was not downloaded (too large): quarantined by its envelope, with no original to retry from. */
93
+ export function rejectedWithoutSource(args) {
94
+ return {
95
+ providerMessageId: buildProviderMessageId(args.uidValidity, args.uid),
96
+ reason: "unparseable",
97
+ ...(args.envelope && { headers: headersOfEnvelope(args.envelope, args.internalDate) }),
98
+ };
99
+ }
92
100
  /** A mail the MIME parser cannot handle must not stop the mailbox: it is reported as rejected so the
93
101
  * foundation quarantines it and the cursor moves on. */
94
102
  export async function parseOrReject(args) {
@@ -40,7 +40,7 @@ export const createReconnectMailboxHandler = ({ memberRoles, adminRoles }) => de
40
40
  if (!mayReactivateMailbox(lookup.row.ownerUserId, ctx.user, adminRoles)) {
41
41
  return failNotFound("mail-account", event.payload.accountId);
42
42
  }
43
- return checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log);
43
+ return checkMailboxLogin(credentialDocumentOf(event.payload), ctx);
44
44
  },
45
45
  handler: async (event, ctx) => {
46
46
  const { accountId } = event.payload;
@@ -56,12 +56,13 @@ export const createReconnectMailboxHandler = ({ memberRoles, adminRoles }) => de
56
56
  });
57
57
  if (!reactivated.isSuccess)
58
58
  return reactivated;
59
- // The sender-check policy is tenant-wide: only admins set it, the owner's form does not carry it.
60
- if (isMailAdmin(event.user, adminRoles)) {
59
+ // The sender-check policy is tenant-wide: only admins set it, and only when the form carries
60
+ // the field. The owner's form omits it, and an admin using that form must not clear the policy.
61
+ if (isMailAdmin(event.user, adminRoles) && event.payload.trustedAuthservId !== undefined) {
61
62
  // The admin form shows the stored id, so an empty field means the admin cleared it.
62
63
  const trusted = await ctx.dispatch.write(InboundMailFoundationHandlers.setTrustedAuthservId, {
63
64
  accountId,
64
- trustedAuthservId: event.payload.trustedAuthservId ?? null,
65
+ trustedAuthservId: event.payload.trustedAuthservId,
65
66
  });
66
67
  if (!trusted.isSuccess)
67
68
  return trusted;
@@ -1,2 +1,4 @@
1
1
  import { type InboundMailContext, type MailAccountRecord, type OutboundAttachment, type OutboundMailMessage, type ProviderSentMail } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
2
+ import { SmtpFailureError } from "./smtp-client.ts";
3
+ export declare function toFoundationSendError(err: SmtpFailureError): Error;
2
4
  export declare function sendFromImapAccount(ctx: InboundMailContext, account: MailAccountRecord, message: OutboundMailMessage, attachments: readonly OutboundAttachment[]): Promise<ProviderSentMail>;
@@ -1,13 +1,20 @@
1
1
  // send for the imap provider: SMTP with the mailbox's own login, From = the mailbox address.
2
2
  // The MIME is built once, so the copy in the sent folder is byte for byte what went out.
3
3
  import { sanitizeMailDisplayName } from "@cosmicdrift/kumiko-bundled-features/foundation-shared";
4
- import { InboundAuthError, InboundTransientError, MailSendNotConfiguredError, MailSendRejectedError, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
4
+ import { InboundAuthError, InboundTransientError, isInboundAuthError, MailSendNotConfiguredError, MailSendRejectedError, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
5
5
  import MailComposer from "nodemailer/lib/mail-composer";
6
6
  import { FEATURE_NAME } from "./constants.js";
7
7
  import { readCredentialDocument } from "./credential-document.js";
8
8
  import { appendToSentFolder } from "./sent-folder.js";
9
9
  import { SmtpFailureError, sendRawViaSmtp } from "./smtp-client.js";
10
- function toFoundationSendError(err) {
10
+ // A host the guard blocks stays blocked and a failed certificate check stays failed: retrying
11
+ // cannot help, the tenant has to connect the mailbox again.
12
+ function isPermanentSmtpFailure(err) {
13
+ return err.failure === "tlsFailed" || (err.failure === "hostUnreachable" && err.blocked);
14
+ }
15
+ export function toFoundationSendError(err) {
16
+ if (isPermanentSmtpFailure(err))
17
+ return new MailSendNotConfiguredError(err.message);
11
18
  switch (err.failure) {
12
19
  case "loginRejected":
13
20
  return new InboundAuthError(err.message);
@@ -20,8 +27,21 @@ function toFoundationSendError(err) {
20
27
  function stripAngles(id) {
21
28
  return id.replace(/^<|>$/g, "");
22
29
  }
30
+ // A missing or unreadable credential document means no login was attempted: the mailbox has to be
31
+ // connected again, which is not a rejected password.
32
+ async function readSendCredentialDocument(ctx, account) {
33
+ try {
34
+ return await readCredentialDocument(ctx, account);
35
+ }
36
+ catch (err) {
37
+ if (isInboundAuthError(err)) {
38
+ throw new MailSendNotConfiguredError(`${FEATURE_NAME}: account ${account.id} has no usable credential document`);
39
+ }
40
+ throw err;
41
+ }
42
+ }
23
43
  export async function sendFromImapAccount(ctx, account, message, attachments) {
24
- const doc = await readCredentialDocument(ctx, account);
44
+ const doc = await readSendCredentialDocument(ctx, account);
25
45
  if (!doc.smtpHost || !doc.password) {
26
46
  throw new MailSendNotConfiguredError(`${FEATURE_NAME}: account ${account.id} has no outgoing server stored`);
27
47
  }
@@ -44,12 +64,18 @@ export async function sendFromImapAccount(ctx, account, message, attachments) {
44
64
  }),
45
65
  }).compile();
46
66
  const raw = await mime.build();
67
+ let rejectedRecipients;
47
68
  try {
48
- await sendRawViaSmtp({ host: doc.smtpHost, port: doc.smtpPort, user: doc.user, password: doc.password }, { from: account.address, to: [...message.to, ...(message.cc ?? [])] }, raw);
69
+ ({ rejectedRecipients } = await sendRawViaSmtp({ host: doc.smtpHost, port: doc.smtpPort, user: doc.user, password: doc.password }, { from: account.address, to: [...message.to, ...(message.cc ?? [])] }, raw));
49
70
  }
50
71
  catch (err) {
51
72
  throw err instanceof SmtpFailureError ? toFoundationSendError(err) : err;
52
73
  }
53
- await appendToSentFolder(doc, raw, account.id);
54
- return { messageIdHeader: stripAngles(mime.messageId()) };
74
+ // Detached: the copy is best effort and must not keep the caller (maybe inside a request
75
+ // transaction) waiting for another server round trip; appendToSentFolder never rejects.
76
+ void appendToSentFolder(doc, raw, account.id);
77
+ return {
78
+ messageIdHeader: stripAngles(mime.messageId()),
79
+ ...(rejectedRecipients.length > 0 && { rejectedRecipients }),
80
+ };
55
81
  }
@@ -9,7 +9,9 @@ export type SmtpLogin = {
9
9
  export type SmtpFailure = "hostUnreachable" | "loginRejected" | "tlsFailed" | "connectFailed" | "rejected";
10
10
  export declare class SmtpFailureError extends Error {
11
11
  readonly failure: SmtpFailure;
12
- constructor(failure: SmtpFailure, detail: string);
12
+ /** The host guard refused the target; as opposed to a name that did not resolve. */
13
+ readonly blocked: boolean;
14
+ constructor(failure: SmtpFailure, detail: string, blocked?: boolean);
13
15
  }
14
16
  export declare function classifySmtpError(err: unknown): SmtpFailure;
15
17
  export declare function smtpTransportOptions(login: SmtpLogin, target: MailConnectTarget): {
@@ -31,7 +33,12 @@ export declare function smtpTransportOptions(login: SmtpLogin, target: MailConne
31
33
  readonly debug: false;
32
34
  };
33
35
  export declare function verifySmtpLogin(login: SmtpLogin): Promise<void>;
36
+ export declare function rejectedRecipientsOf(rejected: ReadonlyArray<string | {
37
+ readonly address: string;
38
+ }> | undefined): string[];
34
39
  export declare function sendRawViaSmtp(login: SmtpLogin, envelope: {
35
40
  readonly from: string;
36
41
  readonly to: readonly string[];
37
- }, raw: Buffer): Promise<void>;
42
+ }, raw: Buffer): Promise<{
43
+ readonly rejectedRecipients: readonly string[];
44
+ }>;
@@ -15,10 +15,13 @@ const SOCKET_TIMEOUT_MS = 30_000;
15
15
  // response, which stay in the server log.
16
16
  export class SmtpFailureError extends Error {
17
17
  failure;
18
- constructor(failure, detail) {
18
+ /** The host guard refused the target; as opposed to a name that did not resolve. */
19
+ blocked;
20
+ constructor(failure, detail, blocked = false) {
19
21
  super(`SMTP ${failure}: ${detail}`);
20
22
  this.name = "SmtpFailureError";
21
23
  this.failure = failure;
24
+ this.blocked = blocked;
22
25
  }
23
26
  }
24
27
  const LOGIN_CODES = ["EAUTH", "ENOAUTH"];
@@ -71,7 +74,7 @@ async function openSmtpTransport(login) {
71
74
  host: login.host,
72
75
  reason,
73
76
  });
74
- throw new SmtpFailureError("hostUnreachable", blocked ? "blocked" : "unresolved");
77
+ throw new SmtpFailureError("hostUnreachable", blocked ? "blocked" : "unresolved", blocked);
75
78
  }
76
79
  return createTransport(smtpTransportOptions(login, target));
77
80
  }
@@ -95,10 +98,19 @@ export async function verifySmtpLogin(login) {
95
98
  transport.close();
96
99
  }
97
100
  }
101
+ // nodemailer throws only when every recipient is refused; a partial refusal resolves and lists
102
+ // the refused addresses here (as strings or address objects).
103
+ export function rejectedRecipientsOf(rejected) {
104
+ return (rejected ?? []).map((entry) => (typeof entry === "string" ? entry : entry.address));
105
+ }
98
106
  export async function sendRawViaSmtp(login, envelope, raw) {
99
107
  const transport = await openSmtpTransport(login);
100
108
  try {
101
- await transport.sendMail({ envelope: { from: envelope.from, to: [...envelope.to] }, raw });
109
+ const info = await transport.sendMail({
110
+ envelope: { from: envelope.from, to: [...envelope.to] },
111
+ raw,
112
+ });
113
+ return { rejectedRecipients: rejectedRecipientsOf(info.rejected) };
102
114
  }
103
115
  catch (err) {
104
116
  throw smtpFailureOf(err, login.host);
@@ -1,6 +1,6 @@
1
1
  import { readCredentialDocument } from "./credential-document.js";
2
+ import { fetchAndParse } from "./download-batch.js";
2
3
  import { createImapClient, IMAP_MAILBOX, imapMailHostGuard, mapImapError } from "./imap-client.js";
3
- import { coerceDate, parseOrReject } from "./parse-message.js";
4
4
  // IMAP IDLE (imapflow idles automatically while the mailbox is open
5
5
  // and emits 'exists' for new messages).
6
6
  export async function watchMailbox(ctx, account, handlers) {
@@ -15,29 +15,8 @@ export async function watchMailbox(ctx, account, handlers) {
15
15
  // "new".
16
16
  let nextUid = Number(mailbox.uidNext ?? 1);
17
17
  const drainNew = async () => {
18
- const messages = [];
19
- const rejected = [];
20
- let maxSeen = nextUid - 1;
21
- for await (const msg of client.fetch(`${nextUid}:*`, { uid: true, internalDate: true, source: true, envelope: true }, { uid: true })) {
22
- // `N:*` gotcha (see fetch): filter out the previous last message.
23
- if (msg.uid < nextUid || !msg.source)
24
- continue;
25
- const parsed = await parseOrReject({
26
- source: msg.source,
27
- envelope: msg.envelope,
28
- uid: msg.uid,
29
- uidValidity,
30
- internalDate: coerceDate(msg.internalDate ?? undefined),
31
- trustedAuthservId: account.trustedAuthservId ?? null,
32
- });
33
- if ("message" in parsed)
34
- messages.push(parsed.message);
35
- else
36
- rejected.push(parsed.rejected);
37
- if (msg.uid > maxSeen)
38
- maxSeen = msg.uid;
39
- }
40
- nextUid = maxSeen + 1;
18
+ const { messages, rejected, seenUids } = await fetchAndParse(client, `${nextUid}:*`, uidValidity, account.trustedAuthservId ?? null, nextUid);
19
+ nextUid = seenUids.reduce((highest, uid) => Math.max(highest, uid), nextUid - 1) + 1;
41
20
  if (messages.length > 0 || rejected.length > 0)
42
21
  await handlers.onMessages(messages, rejected);
43
22
  };
@@ -135,7 +135,7 @@ export const inMemoryInboundMailPlugin = {
135
135
  fetch: async (ctx, account, cursor, opts) => {
136
136
  const state = stateFor(account.id);
137
137
  state.lastFetchSignal = opts.signal;
138
- if (state.hangingFetch)
138
+ if (state.hangingFetch !== null)
139
139
  await state.hangingFetch;
140
140
  if (state.nextFetchError) {
141
141
  const err = state.nextFetchError;
@@ -44,3 +44,16 @@ export declare const runFailedSchema: z.ZodObject<{
44
44
  timestamp: z.ZodString;
45
45
  }, z.core.$strip>>;
46
46
  }, z.core.$strip>;
47
+ export declare const CONSUMER_STATE_ACTIONS: readonly ["restarted", "skipped", "disabled", "enabled"];
48
+ export declare const consumerStateChangedSchema: z.ZodObject<{
49
+ action: z.ZodEnum<{
50
+ disabled: "disabled";
51
+ enabled: "enabled";
52
+ restarted: "restarted";
53
+ skipped: "skipped";
54
+ }>;
55
+ name: z.ZodString;
56
+ instanceId: z.ZodString;
57
+ skippedEventId: z.ZodNullable<z.ZodString>;
58
+ actor: z.ZodString;
59
+ }, z.core.$strip>;
@@ -29,3 +29,11 @@ export const runFailedSchema = z.object({
29
29
  error: z.string(),
30
30
  logs: z.array(jobLogEntrySchema),
31
31
  });
32
+ export const CONSUMER_STATE_ACTIONS = ["restarted", "skipped", "disabled", "enabled"];
33
+ export const consumerStateChangedSchema = z.object({
34
+ action: z.enum(CONSUMER_STATE_ACTIONS),
35
+ name: z.string(),
36
+ instanceId: z.string(),
37
+ skippedEventId: z.string().nullable(),
38
+ actor: z.string(),
39
+ });
@@ -1,5 +1,6 @@
1
1
  import { bootRuleError, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import { JOBS_BOOT_RULES } from "./boot-rules.js";
3
+ import { consumerStateChangedSchema } from "./events.js";
3
4
  import { catalogQuery } from "./handlers/catalog.query.js";
4
5
  import { consumerDisableWrite, consumerEnableWrite, consumerRestartWrite, consumerSkipWrite, } from "./handlers/consumer.write.js";
5
6
  import { consumerDetailQuery, consumersQuery } from "./handlers/consumers.query.js";
@@ -36,6 +37,7 @@ export function createJobsFeature(options = {}) {
36
37
  recommended: false,
37
38
  });
38
39
  r.systemScope();
40
+ r.defineEvent("consumer-state-changed", consumerStateChangedSchema, { piiFields: "none" });
39
41
  r.storeTable(jobRunsTableMeta, {
40
42
  reason: "direct_write.job_runs",
41
43
  // payload/error carry personal:{of:"triggeredById"} (job-run-table.ts): encrypted under the