@cosmicdrift/kumiko-bundled-features 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 (613) 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/signup-token-store.d.ts +2 -2
  40. package/dist/auth-email-password/signup-token-store.js +2 -4
  41. package/dist/auth-email-password/unlock-token.js +0 -2
  42. package/dist/auth-email-password/verification-token.js +0 -2
  43. package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
  44. package/dist/auth-email-password/web/auth-gate.js +2 -2
  45. package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
  46. package/dist/auth-email-password/web/auth-redirect.js +4 -0
  47. package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
  48. package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
  49. package/dist/auth-email-password/web/return-path.d.ts +2 -1
  50. package/dist/auth-email-password/web/return-path.js +2 -1
  51. package/dist/auth-email-password/web/session.js +13 -13
  52. package/dist/auth-email-password/web/signup-screen.js +1 -5
  53. package/dist/auth-email-password/web/static-account.js +6 -2
  54. package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
  55. package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
  56. package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
  57. package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
  58. package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
  59. package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
  60. package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
  61. package/dist/auth-mfa-user-data/index.js +5 -6
  62. package/dist/billing-foundation/aggregate-id.js +0 -4
  63. package/dist/billing-foundation/checkout-core.d.ts +2 -0
  64. package/dist/billing-foundation/checkout-core.js +17 -1
  65. package/dist/billing-foundation/checkout-ledger.d.ts +22 -0
  66. package/dist/billing-foundation/checkout-ledger.js +38 -0
  67. package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
  68. package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
  69. package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
  70. package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
  71. package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
  72. package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
  73. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
  74. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
  75. package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
  76. package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
  77. package/dist/billing-foundation/events.d.ts +23 -0
  78. package/dist/billing-foundation/events.js +39 -10
  79. package/dist/billing-foundation/feature.js +12 -1
  80. package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
  81. package/dist/billing-foundation/handlers/create-checkout-session.write.js +3 -2
  82. package/dist/billing-foundation/handlers/process-event.write.d.ts +4 -2
  83. package/dist/billing-foundation/handlers/process-event.write.js +132 -25
  84. package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
  85. package/dist/billing-foundation/handlers/process-payment-event.write.js +31 -11
  86. package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
  87. package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
  88. package/dist/billing-foundation/handlers/start-plan-checkout.write.js +3 -2
  89. package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
  90. package/dist/billing-foundation/i18n.js +3 -0
  91. package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
  92. package/dist/billing-foundation/pending-plan-switch.js +57 -0
  93. package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
  94. package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
  95. package/dist/billing-foundation/types.d.ts +40 -24
  96. package/dist/billing-foundation/validate-options.js +14 -0
  97. package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
  98. package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
  99. package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
  100. package/dist/billing-foundation/web/constants.d.ts +3 -0
  101. package/dist/billing-foundation/web/constants.js +5 -2
  102. package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
  103. package/dist/billing-foundation/webhook-handler.js +53 -11
  104. package/dist/cap-counter/aggregate-id.js +0 -2
  105. package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
  106. package/dist/cap-counter/stock-cap-guard.js +18 -4
  107. package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
  108. package/dist/cap-overview/i18n.js +1 -0
  109. package/dist/cap-overview/index.d.ts +1 -1
  110. package/dist/cap-overview/types.d.ts +4 -0
  111. package/dist/cap-overview/web/cap-cards-panel.js +6 -2
  112. package/dist/cap-overview/web/cap-usage-bar.js +6 -1
  113. package/dist/cap-overview/web/usage-math.d.ts +1 -0
  114. package/dist/cap-overview/web/usage-math.js +4 -0
  115. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
  116. package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
  117. package/dist/channel-whatsapp/aggregate-id.js +18 -0
  118. package/dist/channel-whatsapp/constants.d.ts +25 -0
  119. package/dist/channel-whatsapp/constants.js +36 -0
  120. package/dist/channel-whatsapp/events.d.ts +90 -0
  121. package/dist/channel-whatsapp/events.js +71 -0
  122. package/dist/channel-whatsapp/feature.d.ts +3 -0
  123. package/dist/channel-whatsapp/feature.js +56 -0
  124. package/dist/channel-whatsapp/graph-client.d.ts +85 -0
  125. package/dist/channel-whatsapp/graph-client.js +272 -0
  126. package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
  127. package/dist/channel-whatsapp/in-memory-meta.js +181 -0
  128. package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
  129. package/dist/channel-whatsapp/inbound-handlers.js +148 -0
  130. package/dist/channel-whatsapp/index.d.ts +10 -0
  131. package/dist/channel-whatsapp/index.js +10 -0
  132. package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
  133. package/dist/channel-whatsapp/meta-signature.js +19 -0
  134. package/dist/channel-whatsapp/options.d.ts +32 -0
  135. package/dist/channel-whatsapp/options.js +83 -0
  136. package/dist/channel-whatsapp/pii.d.ts +32 -0
  137. package/dist/channel-whatsapp/pii.js +61 -0
  138. package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
  139. package/dist/channel-whatsapp/webhook-normalize.js +200 -0
  140. package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
  141. package/dist/channel-whatsapp/webhook-routes.js +118 -0
  142. package/dist/compliance-profiles/handlers/set-profile.write.js +2 -0
  143. package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
  144. package/dist/config/handlers/set.write.js +7 -0
  145. package/dist/config/handlers/values.query.js +8 -1
  146. package/dist/config/index.d.ts +1 -1
  147. package/dist/config/index.js +1 -1
  148. package/dist/config/read-redaction.d.ts +1 -0
  149. package/dist/config/read-redaction.js +5 -2
  150. package/dist/config/table.js +1 -0
  151. package/dist/config/write-helpers.js +3 -2
  152. package/dist/crypto-shredding/constants.d.ts +1 -0
  153. package/dist/crypto-shredding/constants.js +1 -0
  154. package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
  155. package/dist/crypto-shredding/index.d.ts +1 -0
  156. package/dist/crypto-shredding/index.js +1 -0
  157. package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
  158. package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
  159. package/dist/custom-fields/aggregate-id.js +0 -1
  160. package/dist/custom-fields/entity.js +1 -0
  161. package/dist/custom-fields/wire-for-entity.js +0 -1
  162. package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
  163. package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
  164. package/dist/data-retention/feature.js +2 -5
  165. package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
  166. package/dist/data-retention/run-retention-cleanup.js +39 -19
  167. package/dist/data-retention/tenant-destruction-hold.js +7 -0
  168. package/dist/delivery/attempt-log-factory.d.ts +3 -0
  169. package/dist/delivery/attempt-log-factory.js +5 -0
  170. package/dist/delivery/attempt-log.d.ts +2 -2
  171. package/dist/delivery/channel-context.d.ts +1 -1
  172. package/dist/delivery/channel-context.js +5 -2
  173. package/dist/delivery/db/queries/preferences.js +0 -1
  174. package/dist/delivery/delivery-service.js +3 -0
  175. package/dist/delivery/feature.d.ts +1 -4
  176. package/dist/delivery/feature.js +3 -1
  177. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
  178. package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
  179. package/dist/delivery/handlers/opted-in-user-ids.query.js +50 -0
  180. package/dist/delivery/handlers/preferences.query.js +2 -20
  181. package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
  182. package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
  183. package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
  184. package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
  185. package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
  186. package/dist/delivery/index.d.ts +3 -1
  187. package/dist/delivery/index.js +1 -0
  188. package/dist/delivery/options.d.ts +4 -0
  189. package/dist/delivery/options.js +1 -0
  190. package/dist/delivery/preference-rows.d.ts +9 -0
  191. package/dist/delivery/preference-rows.js +22 -0
  192. package/dist/delivery/set-preference-enabled.d.ts +17 -0
  193. package/dist/delivery/set-preference-enabled.js +26 -0
  194. package/dist/delivery/tables.d.ts +2 -2
  195. package/dist/delivery/testing.d.ts +1 -1
  196. package/dist/delivery/testing.js +3 -1
  197. package/dist/delivery/types.d.ts +1 -0
  198. package/dist/delivery/unsubscribe-page.js +5 -1
  199. package/dist/delivery/upsert-preference.js +0 -1
  200. package/dist/delivery/web/public-names.d.ts +1 -0
  201. package/dist/delivery/web/public-names.js +1 -0
  202. package/dist/derivatives-sharp/render.js +9 -9
  203. package/dist/document-ingest-foundation/aggregate-id.js +0 -1
  204. package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
  205. package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
  206. package/dist/document-ingest-foundation/feature.js +1 -0
  207. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
  208. package/dist/document-ingest-foundation/report-ingest-progress.js +32 -13
  209. package/dist/documents/aggregate-id.js +0 -2
  210. package/dist/documents/constants.d.ts +6 -0
  211. package/dist/documents/constants.js +8 -2
  212. package/dist/documents/ensure-link.d.ts +5 -8
  213. package/dist/documents/ensure-link.js +4 -2
  214. package/dist/documents/feature.d.ts +3 -1
  215. package/dist/documents/feature.js +29 -5
  216. package/dist/documents/handlers/import.write.js +2 -2
  217. package/dist/documents/queries/expiry-overview.query.js +2 -1
  218. package/dist/documents/queries/for-record.query.js +3 -4
  219. package/dist/documents/queries/list-page.js +11 -3
  220. package/dist/documents/queries/overview.query.js +2 -2
  221. package/dist/documents/screens.js +3 -3
  222. package/dist/documents/tab.js +1 -1
  223. package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
  224. package/dist/feature-toggles/toggle-sync-signal.js +3 -2
  225. package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
  226. package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
  227. package/dist/file-foundation/probe.js +9 -3
  228. package/dist/file-foundation/read-file-ref-content.js +23 -11
  229. package/dist/file-provider-inmemory/feature.js +1 -1
  230. package/dist/file-provider-s3/env-feature.js +1 -1
  231. package/dist/file-provider-s3/env-named-feature.js +1 -1
  232. package/dist/file-provider-s3/env-schema.d.ts +10 -1
  233. package/dist/file-provider-s3/env-schema.js +20 -7
  234. package/dist/file-provider-s3/feature.js +1 -1
  235. package/dist/file-provider-s3/index.d.ts +1 -1
  236. package/dist/file-provider-s3/index.js +1 -1
  237. package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
  238. package/dist/file-provider-s3/lib/env-helper.js +13 -12
  239. package/dist/file-provider-s3/lib/s3-provider.js +10 -2
  240. package/dist/folders/aggregate-id.js +0 -1
  241. package/dist/folders/web/folder-manager.js +1 -1
  242. package/dist/folders-user-data/index.js +12 -14
  243. package/dist/form-draft/feature.js +1 -0
  244. package/dist/helpdesk/entity.js +4 -1
  245. package/dist/helpdesk/feature.js +37 -0
  246. package/dist/helpdesk/handlers/access.d.ts +0 -1
  247. package/dist/helpdesk/handlers/access.js +0 -3
  248. package/dist/helpdesk/handlers/attempts.js +7 -13
  249. package/dist/helpdesk/handlers/challenge.query.js +1 -2
  250. package/dist/helpdesk/handlers/reply.write.js +7 -8
  251. package/dist/helpdesk/handlers/report.write.js +4 -7
  252. package/dist/helpdesk/handlers/submit.write.js +5 -9
  253. package/dist/helpdesk/index.d.ts +1 -1
  254. package/dist/helpdesk/index.js +1 -1
  255. package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
  256. package/dist/helpdesk/legacy-contact-config.js +57 -0
  257. package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
  258. package/dist/helpdesk/legacy-contact-erasure.js +19 -0
  259. package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
  260. package/dist/helpdesk/legacy-contact-retention.js +53 -0
  261. package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
  262. package/dist/helpdesk/legacy-contact-streams.js +124 -0
  263. package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
  264. package/dist/helpdesk/legacy-contact-user-data.js +62 -0
  265. package/dist/helpdesk/lib.d.ts +8 -2
  266. package/dist/helpdesk/lib.js +32 -32
  267. package/dist/helpdesk/user-data-hooks.d.ts +10 -1
  268. package/dist/helpdesk/user-data-hooks.js +47 -36
  269. package/dist/helpdesk/web/constants.d.ts +0 -1
  270. package/dist/helpdesk/web/constants.js +0 -1
  271. package/dist/inbound-mail-foundation/account-health.js +1 -1
  272. package/dist/inbound-mail-foundation/account-poll.js +3 -1
  273. package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
  274. package/dist/inbound-mail-foundation/constants.d.ts +6 -0
  275. package/dist/inbound-mail-foundation/constants.js +6 -0
  276. package/dist/inbound-mail-foundation/content-refetch.d.ts +4 -0
  277. package/dist/inbound-mail-foundation/content-refetch.js +13 -3
  278. package/dist/inbound-mail-foundation/entities.js +58 -15
  279. package/dist/inbound-mail-foundation/events.js +16 -16
  280. package/dist/inbound-mail-foundation/feature.js +3 -1
  281. package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
  282. package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
  283. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
  284. package/dist/inbound-mail-foundation/handlers/connect-account.write.js +14 -8
  285. package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
  286. package/dist/inbound-mail-foundation/handlers/forget-message.write.js +58 -0
  287. package/dist/inbound-mail-foundation/handlers/ingest-message-schema.js +12 -5
  288. package/dist/inbound-mail-foundation/i18n.js +3 -0
  289. package/dist/inbound-mail-foundation/index.d.ts +1 -0
  290. package/dist/inbound-mail-foundation/index.js +1 -0
  291. package/dist/inbound-mail-foundation/normalize-inbound-message.d.ts +6 -0
  292. package/dist/inbound-mail-foundation/normalize-inbound-message.js +21 -8
  293. package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
  294. package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
  295. package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
  296. package/dist/inbound-mail-foundation/personal-address.js +16 -0
  297. package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
  298. package/dist/inbound-mail-foundation/purge-messages.js +33 -0
  299. package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
  300. package/dist/inbound-mail-foundation/quarantine.js +9 -5
  301. package/dist/inbound-mail-foundation/retention-job.js +1 -5
  302. package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
  303. package/dist/inbound-mail-foundation/sanitize-inbound-html.d.ts +0 -1
  304. package/dist/inbound-mail-foundation/sanitize-inbound-html.js +2 -4
  305. package/dist/inbound-mail-foundation/send-from-account.js +9 -1
  306. package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
  307. package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
  308. package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
  309. package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
  310. package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
  311. package/dist/inbound-provider-imap/byte-budget.js +53 -0
  312. package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
  313. package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
  314. package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
  315. package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
  316. package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
  317. package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
  318. package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
  319. package/dist/inbound-provider-imap/download-batch.js +21 -6
  320. package/dist/inbound-provider-imap/feature.js +7 -4
  321. package/dist/inbound-provider-imap/fetch-content.js +35 -30
  322. package/dist/inbound-provider-imap/i18n.js +2 -2
  323. package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
  324. package/dist/inbound-provider-imap/parse-message.js +8 -0
  325. package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
  326. package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
  327. package/dist/inbound-provider-imap/send-mail.js +32 -6
  328. package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
  329. package/dist/inbound-provider-imap/smtp-client.js +15 -3
  330. package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
  331. package/dist/inbound-provider-inmemory/feature.js +1 -1
  332. package/dist/jobs/events.d.ts +13 -0
  333. package/dist/jobs/events.js +8 -0
  334. package/dist/jobs/feature.js +2 -0
  335. package/dist/jobs/handlers/consumer.write.js +31 -20
  336. package/dist/jobs/web/constants.d.ts +3 -0
  337. package/dist/jobs/web/constants.js +3 -0
  338. package/dist/mail-transport-inmemory/feature.js +1 -1
  339. package/dist/mail-transport-smtp/feature.js +3 -2
  340. package/dist/managed-pages/handlers/branding.query.js +1 -1
  341. package/dist/managed-pages/handlers/by-slug.query.js +1 -1
  342. package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
  343. package/dist/managed-pages/render-page-body.d.ts +2 -0
  344. package/dist/managed-pages/render-page-body.js +12 -8
  345. package/dist/managed-pages/screens/page-screens.d.ts +3 -2
  346. package/dist/managed-pages/screens/page-screens.js +14 -33
  347. package/dist/managed-pages/table.js +1 -0
  348. package/dist/managed-pages/web/client-plugin.js +8 -6
  349. package/dist/managed-pages/web/constants.d.ts +5 -1
  350. package/dist/managed-pages/web/constants.js +6 -1
  351. package/dist/managed-pages/web/i18n.js +11 -3
  352. package/dist/managed-pages/web/markdown-to-document.js +1 -1
  353. package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
  354. package/dist/managed-pages/web/page-edit-draft.js +76 -0
  355. package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
  356. package/dist/managed-pages/web/page-edit-screen.js +113 -0
  357. package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
  358. package/dist/managed-pages/web/page-settings-rail.js +14 -0
  359. package/dist/notes-history-user-data/index.js +8 -14
  360. package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
  361. package/dist/personal-access-tokens/boot-rules.js +5 -0
  362. package/dist/personal-access-tokens/handlers/create.write.js +0 -1
  363. package/dist/personal-access-tokens/scope-events-check.js +26 -6
  364. package/dist/presence/handlers/list.query.js +18 -8
  365. package/dist/presence/room.d.ts +2 -0
  366. package/dist/presence/room.js +8 -5
  367. package/dist/presence/store.d.ts +2 -0
  368. package/dist/presence/store.js +62 -26
  369. package/dist/readiness/handlers/latest-summary.query.js +10 -6
  370. package/dist/readiness/handlers/run-probes.write.js +24 -4
  371. package/dist/readiness/handlers/run-tone.js +3 -2
  372. package/dist/readiness/handlers/status.query.js +11 -3
  373. package/dist/readiness/probe-context.js +7 -10
  374. package/dist/readiness/screens.js +4 -4
  375. package/dist/readiness/visible-results.d.ts +1 -1
  376. package/dist/readiness/visible-results.js +5 -2
  377. package/dist/renderer-foundation/api.js +6 -12
  378. package/dist/renderer-foundation/types.d.ts +2 -2
  379. package/dist/secrets/db/queries/read.d.ts +2 -1
  380. package/dist/secrets/db/queries/read.js +10 -1
  381. package/dist/secrets/handlers/list.query.js +4 -2
  382. package/dist/secrets/secret-scope.d.ts +0 -1
  383. package/dist/secrets/secret-scope.js +2 -2
  384. package/dist/secrets/secrets-context.js +4 -4
  385. package/dist/secrets/table.d.ts +1 -1
  386. package/dist/secrets/write-gate.js +4 -2
  387. package/dist/seo/handlers/seo-config.query.js +1 -1
  388. package/dist/shared/acknowledged-system-db.d.ts +5 -0
  389. package/dist/shared/acknowledged-system-db.js +9 -0
  390. package/dist/shared/assert-billing-live.d.ts +1 -0
  391. package/dist/shared/assert-billing-live.js +5 -2
  392. package/dist/shared/hmac-signature.js +4 -2
  393. package/dist/shared/index.d.ts +7 -2
  394. package/dist/shared/index.js +7 -2
  395. package/dist/shared/normalize-email.d.ts +1 -0
  396. package/dist/shared/normalize-email.js +3 -0
  397. package/dist/shared/parent-visibility.d.ts +1 -0
  398. package/dist/shared/parent-visibility.js +16 -1
  399. package/dist/shared/password-hashing.js +0 -1
  400. package/dist/shared/price-env-shape.js +1 -1
  401. package/dist/shared/register-user-data-hooks.d.ts +11 -0
  402. package/dist/shared/register-user-data-hooks.js +11 -0
  403. package/dist/shared/require-bootstrap-extension.d.ts +9 -0
  404. package/dist/shared/require-bootstrap-extension.js +16 -0
  405. package/dist/shared/send-best-effort.d.ts +3 -0
  406. package/dist/shared/send-best-effort.js +19 -0
  407. package/dist/shared/stream-tenant-backfill.d.ts +1 -0
  408. package/dist/shared/stream-tenant-backfill.js +17 -1
  409. package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
  410. package/dist/shared/stream-tenant-derived-state.js +19 -2
  411. package/dist/step-dispatcher/constants.d.ts +4 -0
  412. package/dist/step-dispatcher/constants.js +11 -0
  413. package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
  414. package/dist/step-dispatcher/deliver-dispatch-request.js +41 -3
  415. package/dist/step-dispatcher/feature.js +31 -2
  416. package/dist/step-dispatcher/mail-runner.js +0 -1
  417. package/dist/step-dispatcher/sweep-abandoned.d.ts +11 -0
  418. package/dist/step-dispatcher/sweep-abandoned.js +46 -0
  419. package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
  420. package/dist/subscription-mollie/plugin-methods.js +1 -2
  421. package/dist/subscription-mollie/verify-webhook.js +5 -5
  422. package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
  423. package/dist/subscription-paddle/backfill-checkout-ledger.js +112 -0
  424. package/dist/subscription-paddle/checkout-config.query.js +1 -1
  425. package/dist/subscription-paddle/checkout-methods.js +2 -8
  426. package/dist/subscription-paddle/constants.d.ts +0 -1
  427. package/dist/subscription-paddle/constants.js +1 -2
  428. package/dist/subscription-paddle/feature.d.ts +0 -4
  429. package/dist/subscription-paddle/feature.js +21 -20
  430. package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
  431. package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
  432. package/dist/subscription-paddle/plan-switch-methods.js +2 -8
  433. package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
  434. package/dist/subscription-paddle/redeliver-legacy-checkout.js +43 -0
  435. package/dist/subscription-paddle/runtime.d.ts +3 -5
  436. package/dist/subscription-paddle/runtime.js +4 -7
  437. package/dist/subscription-paddle/subscription-state.d.ts +1 -0
  438. package/dist/subscription-paddle/subscription-state.js +1 -0
  439. package/dist/subscription-paddle/webhook-events.d.ts +4 -0
  440. package/dist/subscription-paddle/webhook-events.js +40 -22
  441. package/dist/subscription-stripe/feature.d.ts +4 -0
  442. package/dist/subscription-stripe/feature.js +1 -0
  443. package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
  444. package/dist/subscription-stripe/plugin-methods.js +2 -5
  445. package/dist/subscription-stripe/runtime.d.ts +2 -1
  446. package/dist/subscription-stripe/runtime.js +5 -7
  447. package/dist/subscription-stripe/verify-webhook.js +31 -6
  448. package/dist/tags/aggregate-id.js +0 -1
  449. package/dist/tags/web/tag-chip.js +0 -1
  450. package/dist/tags/web/tag-manager.js +3 -1
  451. package/dist/template-resolver/api.js +6 -12
  452. package/dist/template-resolver/document-sanitizer.d.ts +1 -1
  453. package/dist/template-resolver/document-sanitizer.js +18 -0
  454. package/dist/template-resolver/feature.d.ts +1 -0
  455. package/dist/template-resolver/feature.js +2 -0
  456. package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
  457. package/dist/template-resolver/handlers/body-preview.query.js +41 -0
  458. package/dist/template-resolver/handlers/by-slug.query.js +1 -1
  459. package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
  460. package/dist/template-resolver/handlers/collection-shared.js +5 -8
  461. package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
  462. package/dist/template-resolver/handlers/overview.query.js +2 -1
  463. package/dist/template-resolver/handlers/send-test.write.js +27 -8
  464. package/dist/template-resolver/linked-resources.js +2 -6
  465. package/dist/template-resolver/seeding.js +92 -1
  466. package/dist/template-resolver/table.js +1 -0
  467. package/dist/template-resolver/template-draft.js +2 -1
  468. package/dist/template-resolver/template-preview.js +12 -3
  469. package/dist/template-resolver/testing.js +0 -2
  470. package/dist/template-resolver/web/client-plugin.js +3 -0
  471. package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
  472. package/dist/template-resolver/web/constants.d.ts +2 -0
  473. package/dist/template-resolver/web/constants.js +2 -0
  474. package/dist/template-resolver/web/content-tree-provider.js +0 -1
  475. package/dist/template-resolver/web/content-workbench.d.ts +22 -0
  476. package/dist/template-resolver/web/content-workbench.js +32 -0
  477. package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
  478. package/dist/template-resolver/web/document-insert-model.js +1 -2
  479. package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
  480. package/dist/template-resolver/web/document-link-policy.js +53 -0
  481. package/dist/template-resolver/web/document-schema.d.ts +2 -4
  482. package/dist/template-resolver/web/document-schema.js +2 -53
  483. package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
  484. package/dist/template-resolver/web/document-tiptap-context.js +2 -2
  485. package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
  486. package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
  487. package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
  488. package/dist/template-resolver/web/editor-handle.js +1 -0
  489. package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
  490. package/dist/template-resolver/web/fill-document-variables.js +22 -0
  491. package/dist/template-resolver/web/i18n.js +10 -0
  492. package/dist/template-resolver/web/index.d.ts +3 -0
  493. package/dist/template-resolver/web/index.js +2 -0
  494. package/dist/template-resolver/web/preview-targets.d.ts +5 -0
  495. package/dist/template-resolver/web/preview-targets.js +21 -0
  496. package/dist/template-resolver/web/qualified-names.d.ts +1 -0
  497. package/dist/template-resolver/web/qualified-names.js +1 -0
  498. package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
  499. package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
  500. package/dist/template-resolver/web/string-values.d.ts +1 -0
  501. package/dist/template-resolver/web/string-values.js +8 -0
  502. package/dist/template-resolver/web/text-block-editor.js +18 -11
  503. package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
  504. package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
  505. package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
  506. package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
  507. package/dist/template-resolver/web/use-text-block-editor.js +26 -5
  508. package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
  509. package/dist/template-resolver/web/web-preview-renderer.js +45 -0
  510. package/dist/template-resolver-user-data/index.js +11 -10
  511. package/dist/tenant/handlers/create.write.js +3 -7
  512. package/dist/tenant/handlers/list.query.js +3 -8
  513. package/dist/tenant/handlers/member-directory.query.js +10 -5
  514. package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
  515. package/dist/tenant/invited-membership.js +9 -1
  516. package/dist/tenant/seeding.d.ts +3 -0
  517. package/dist/tenant/seeding.js +3 -1
  518. package/dist/tenant/stream-tenant-backfill.js +5 -1
  519. package/dist/tenant/testing.js +1 -1
  520. package/dist/tenant-inactivity/check-inactive-tenants.js +29 -18
  521. package/dist/tenant-inactivity/constants.js +1 -2
  522. package/dist/tenant-inactivity/handlers/keep-account.write.js +8 -2
  523. package/dist/tenant-inactivity/state-store.d.ts +3 -1
  524. package/dist/tenant-inactivity/state-store.js +16 -1
  525. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  526. package/dist/tenant-lifecycle/constants.js +3 -0
  527. package/dist/tenant-lifecycle/feature.js +1 -0
  528. package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
  529. package/dist/tenant-lifecycle/stages.js +14 -2
  530. package/dist/tier-engine/aggregate-id.js +0 -1
  531. package/dist/tier-engine/feature.js +9 -2
  532. package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
  533. package/dist/user/handlers/me.query.js +4 -1
  534. package/dist/user/index.d.ts +1 -0
  535. package/dist/user/index.js +1 -0
  536. package/dist/user/resolve-verified-user-email.d.ts +2 -0
  537. package/dist/user/resolve-verified-user-email.js +14 -0
  538. package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
  539. package/dist/user-data-rights/feature.js +1 -0
  540. package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
  541. package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
  542. package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
  543. package/dist/user-data-rights/run-export-jobs.js +0 -2
  544. package/dist/user-data-rights/run-forget-cleanup.js +2 -2
  545. package/dist/user-data-rights/schema/download-attempt.js +3 -2
  546. package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
  547. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  548. package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
  549. package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
  550. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
  551. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
  552. package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
  553. package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
  554. package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
  555. package/dist/user-profile/handlers/change-email.write.js +0 -1
  556. package/dist/waitlist/handlers/reject.write.js +2 -1
  557. package/dist/waitlist/handlers/submit.write.js +6 -19
  558. package/dist/waitlist/import.js +2 -1
  559. package/dist/waitlist/lib.d.ts +0 -1
  560. package/dist/waitlist/lib.js +2 -10
  561. package/dist/waitlist/link-on-signup.js +2 -2
  562. package/dist/waitlist/user-data-hooks.js +6 -20
  563. package/dist/workflow-runner/aggregate-id.js +0 -1
  564. package/dist/workflow-runner/event-trigger.js +6 -2
  565. package/dist/workflow-runner/feature.js +1 -5
  566. package/dist/workflow-runner/handlers/resume-run.write.js +6 -4
  567. package/dist/workflow-runner/runner.d.ts +1 -0
  568. package/package.json +35 -11
  569. package/src/admin-shell/changes.json +6 -0
  570. package/src/agent-tools/changes.json +12 -0
  571. package/src/auth-email-password/changes.json +18 -0
  572. package/src/auth-mfa/changes.json +6 -0
  573. package/src/billing-foundation/changes.json +61 -0
  574. package/src/cap-counter/changes.json +6 -0
  575. package/src/cap-overview/changes.json +6 -0
  576. package/src/channel-in-app/changes.json +6 -0
  577. package/src/channel-whatsapp/changes.json +32 -0
  578. package/src/compliance-profiles/changes.json +5 -0
  579. package/src/config/changes.json +12 -0
  580. package/src/crypto-shredding/changes.json +18 -0
  581. package/src/data-retention/changes.json +12 -0
  582. package/src/delivery/changes.json +12 -0
  583. package/src/document-ingest-foundation/changes.json +6 -0
  584. package/src/documents/changes.json +24 -0
  585. package/src/file-provider-s3/changes.json +14 -0
  586. package/src/files/changes.json +7 -0
  587. package/src/helpdesk/changes.json +56 -0
  588. package/src/inbound-mail-foundation/changes.json +54 -0
  589. package/src/inbound-provider-imap/changes.json +13 -0
  590. package/src/mail-foundation/changes.json +6 -0
  591. package/src/managed-pages/changes.json +12 -0
  592. package/src/presence/changes.json +6 -0
  593. package/src/readiness/changes.json +25 -0
  594. package/src/secrets/changes.json +7 -0
  595. package/src/shared/changes.json +12 -0
  596. package/src/step-dispatcher/changes.json +18 -0
  597. package/src/subscription-mollie/changes.json +7 -0
  598. package/src/subscription-paddle/changes.json +19 -0
  599. package/src/subscription-stripe/changes.json +13 -0
  600. package/src/template-resolver/changes.json +48 -0
  601. package/src/tenant/changes.json +6 -0
  602. package/src/tenant-inactivity/changes.json +6 -0
  603. package/src/tenant-lifecycle/changes.json +24 -0
  604. package/src/tier-engine/changes.json +6 -0
  605. package/src/user/changes.json +6 -0
  606. package/src/waitlist/changes.json +6 -0
  607. package/src/workflow-runner/changes.json +6 -0
  608. package/dist/managed-pages/web/page-body-section.d.ts +0 -3
  609. package/dist/managed-pages/web/page-body-section.js +0 -40
  610. package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
  611. package/dist/subscription-paddle/tenant-binding.js +0 -26
  612. package/dist/template-resolver/web/content-field.d.ts +0 -9
  613. package/dist/template-resolver/web/content-field.js +0 -14
@@ -15,7 +15,7 @@ export function createFileProviderS3NamedEnvFeature(options) {
15
15
  r.requires({ features: ["file-foundation"] });
16
16
  r.envSchema(envSchema);
17
17
  const plugin = {
18
- build: async (_ctx, _tenantId) => createS3ProviderFromEnv(options.envPrefix), // @wrapper-known semantic-alias
18
+ build: async (_ctx, _tenantId) => createS3ProviderFromEnv(options.envPrefix),
19
19
  };
20
20
  r.useExtension("fileProvider", options.name, plugin);
21
21
  }, { dedupeOptions: { name: options.name, envPrefix: options.envPrefix } });
@@ -1,5 +1,14 @@
1
1
  import * as z from "zod";
2
- /** S3-compatible endpoint URL: https, or http on a loopback host; any http host outside `NODE_ENV=production`. */
2
+ /** The bucket holds tenant files, so in production a remote endpoint must be
3
+ * https. Outside production plain http stays allowed, also for compose-network
4
+ * hostnames (minio, rustfs) that are not loopback. `isProduction` comes from the
5
+ * env being booted: a field schema cannot see sibling vars, so the endpoint
6
+ * variables carry it as an env rule and the env readers apply it again. */
7
+ export declare function isAcceptableS3Endpoint(value: string, isProduction: boolean): boolean;
8
+ /** Env rule for the endpoint variables: the production flag comes from the env being booted. */
9
+ export declare function s3EndpointEnvRule(value: string, env: Readonly<Record<string, string | undefined>>): string | undefined;
10
+ /** S3-compatible endpoint URL (http or https). Carries the production https rule as an env rule,
11
+ * so any env schema that reuses it (also wrapped in `.optional()`) enforces it without app code. */
3
12
  export declare const s3EndpointSchema: z.ZodURL;
4
13
  /** Builds the env block `createS3ProviderFromEnv(prefix)` reads, e.g.
5
14
  * `createS3EnvSchema({ prefix: "RELEASES_S3_" })` for a second bucket.
@@ -1,20 +1,33 @@
1
1
  import * as z from "zod";
2
2
  const LOOPBACK_HOSTNAMES = new Set(["localhost", "127.0.0.1", "[::1]"]);
3
- // The bucket holds tenant files, so in production a remote endpoint must be
4
- // https. Outside production plain http stays allowed, also for compose-network
5
- // hostnames (minio, rustfs) that are not loopback.
6
- function isAcceptableEndpoint(value) {
3
+ /** The bucket holds tenant files, so in production a remote endpoint must be
4
+ * https. Outside production plain http stays allowed, also for compose-network
5
+ * hostnames (minio, rustfs) that are not loopback. `isProduction` comes from the
6
+ * env being booted: a field schema cannot see sibling vars, so the endpoint
7
+ * variables carry it as an env rule and the env readers apply it again. */
8
+ export function isAcceptableS3Endpoint(value, isProduction) {
7
9
  if (!URL.canParse(value))
8
10
  return false;
9
11
  const url = new URL(value);
10
12
  if (url.protocol === "https:")
11
13
  return true;
12
- return process.env["NODE_ENV"] !== "production" || LOOPBACK_HOSTNAMES.has(url.hostname);
14
+ return !isProduction || LOOPBACK_HOSTNAMES.has(url.hostname);
13
15
  }
14
- /** S3-compatible endpoint URL: https, or http on a loopback host; any http host outside `NODE_ENV=production`. */
16
+ const ENDPOINT_RULE_MESSAGE = "must use https unless the host is loopback (NODE_ENV=production)";
17
+ /** Env rule for the endpoint variables: the production flag comes from the env being booted. */
18
+ export function s3EndpointEnvRule(value, env) {
19
+ // A blank endpoint means "unset" (the field schema maps it to undefined), so there is nothing to check.
20
+ if (value === "")
21
+ return undefined;
22
+ return isAcceptableS3Endpoint(value, env["NODE_ENV"] === "production")
23
+ ? undefined
24
+ : ENDPOINT_RULE_MESSAGE;
25
+ }
26
+ /** S3-compatible endpoint URL (http or https). Carries the production https rule as an env rule,
27
+ * so any env schema that reuses it (also wrapped in `.optional()`) enforces it without app code. */
15
28
  export const s3EndpointSchema = z
16
29
  .url({ protocol: /^https?$/ })
17
- .refine(isAcceptableEndpoint, "must use https unless the host is loopback");
30
+ .meta({ kumiko: { envRule: s3EndpointEnvRule } });
18
31
  function buildS3Shape(prefix) {
19
32
  return {
20
33
  [`${prefix}BUCKET`]: z.string().min(1).optional().describe("S3 bucket."),
@@ -86,7 +86,7 @@ function createTenantConfigFileProviderS3Feature() {
86
86
  // Plugin registration. The entityName "s3" is what tenants set in
87
87
  // file-foundation's `provider` config key.
88
88
  const plugin = {
89
- build: async (ctx, tenantId) => buildS3Provider(ctx, tenantId), // @wrapper-known semantic-alias
89
+ build: async (ctx, tenantId) => buildS3Provider(ctx, tenantId),
90
90
  };
91
91
  r.useExtension("fileProvider", "s3", plugin);
92
92
  return { configKeys, secretAccessKey };
@@ -1,3 +1,3 @@
1
1
  export { createFileProviderS3NamedEnvFeature, type NamedS3EnvProviderOptions, } from "./env-named-feature.ts";
2
- export { createS3EnvSchema, s3EndpointSchema, s3EnvSchema } from "./env-schema.ts";
2
+ export { createS3EnvSchema, isAcceptableS3Endpoint, s3EndpointEnvRule, s3EndpointSchema, s3EnvSchema, } from "./env-schema.ts";
3
3
  export { createFileProviderS3Feature, type FileProviderS3FeatureOptions, S3_SECRET_ACCESS_KEY, } from "./feature.ts";
@@ -1,4 +1,4 @@
1
1
  // Public API of the file-provider-s3 bundled-feature.
2
2
  export { createFileProviderS3NamedEnvFeature, } from "./env-named-feature.js";
3
- export { createS3EnvSchema, s3EndpointSchema, s3EnvSchema } from "./env-schema.js";
3
+ export { createS3EnvSchema, isAcceptableS3Endpoint, s3EndpointEnvRule, s3EndpointSchema, s3EnvSchema, } from "./env-schema.js";
4
4
  export { createFileProviderS3Feature, S3_SECRET_ACCESS_KEY, } from "./feature.js";
@@ -1,4 +1,5 @@
1
+ import { type EnvSource } from "@cosmicdrift/kumiko-framework/env";
1
2
  import type { FileStorageProvider } from "@cosmicdrift/kumiko-framework/files";
2
3
  import { type S3ProviderConfig } from "./s3-provider.ts";
3
- export declare function createS3ProviderFromEnv(prefix?: string): FileStorageProvider;
4
- export declare function parseS3EnvConfig(prefix: string): S3ProviderConfig;
4
+ export declare function createS3ProviderFromEnv(prefix?: string, env?: EnvSource): FileStorageProvider;
5
+ export declare function parseS3EnvConfig(prefix: string, env?: EnvSource): S3ProviderConfig;
@@ -1,3 +1,5 @@
1
+ import { requiredEnvFor } from "@cosmicdrift/kumiko-framework/env";
2
+ import { isAcceptableS3Endpoint } from "../env-schema.js";
1
3
  import { createS3Provider } from "./s3-provider.js";
2
4
  // Reads S3 connection details from process.env with a configurable prefix so
3
5
  // multi-tenant deploys can wire more than one bucket (S3_* for user-uploads,
@@ -8,19 +10,25 @@ import { createS3Provider } from "./s3-provider.js";
8
10
  // <prefix>SECRET_KEY. Optional: <prefix>ENDPOINT (for R2/Minio),
9
11
  // <prefix>FORCE_PATH_STYLE (explicit override — auto-detected when ENDPOINT
10
12
  // is set).
11
- export function createS3ProviderFromEnv(prefix = "S3_") {
12
- return createS3Provider(parseS3EnvConfig(prefix));
13
+ export function createS3ProviderFromEnv(prefix = "S3_", env = process.env) {
14
+ return createS3Provider(parseS3EnvConfig(prefix, env));
13
15
  }
14
16
  // Separated from createS3ProviderFromEnv so the env → config translation is
15
17
  // unit-testable without spinning up an S3Client. The returned config is a
16
18
  // plain object — pass it to createS3Provider to get a working provider.
17
- export function parseS3EnvConfig(prefix) {
19
+ export function parseS3EnvConfig(prefix, env = process.env) {
20
+ const requireEnv = requiredEnvFor("S3 file provider", env);
18
21
  const bucket = requireEnv(`${prefix}BUCKET`);
19
22
  const region = requireEnv(`${prefix}REGION`);
20
23
  const accessKeyId = requireEnv(`${prefix}ACCESS_KEY`);
21
24
  const secretAccessKey = requireEnv(`${prefix}SECRET_KEY`);
22
- const endpoint = process.env[`${prefix}ENDPOINT`];
23
- const forcePathStyleRaw = process.env[`${prefix}FORCE_PATH_STYLE`];
25
+ const endpoint = env[`${prefix}ENDPOINT`];
26
+ const forcePathStyleRaw = env[`${prefix}FORCE_PATH_STYLE`];
27
+ if (endpoint !== undefined &&
28
+ endpoint !== "" &&
29
+ !isAcceptableS3Endpoint(endpoint, env["NODE_ENV"] === "production")) {
30
+ throw new Error(`[S3 file provider] ${prefix}ENDPOINT must use https unless the host is loopback (NODE_ENV=production)`);
31
+ }
24
32
  return {
25
33
  bucket,
26
34
  region,
@@ -35,10 +43,3 @@ export function parseS3EnvConfig(prefix) {
35
43
  }),
36
44
  };
37
45
  }
38
- function requireEnv(name) {
39
- const value = process.env[name];
40
- if (value === undefined || value === "") {
41
- throw new Error(`missing_env: ${name} is required to construct the S3 file provider`);
42
- }
43
- return value;
44
- }
@@ -1,4 +1,5 @@
1
- import { assertSafeStorageKey, } from "@cosmicdrift/kumiko-framework/files";
1
+ import { assertSafeStorageKey, FileObjectMissingError, } from "@cosmicdrift/kumiko-framework/files";
2
+ import { errorCodeOf } from "@cosmicdrift/kumiko-types/type-guards";
2
3
  // =============================================================================
3
4
  // Required operator setup (multipart-upload cleanup)
4
5
  // =============================================================================
@@ -102,7 +103,14 @@ export function createS3Provider(config) {
102
103
  },
103
104
  async read(key) {
104
105
  assertSafeStorageKey(key);
105
- return new Uint8Array(await client.file(key).arrayBuffer());
106
+ try {
107
+ return new Uint8Array(await client.file(key).arrayBuffer());
108
+ }
109
+ catch (e) {
110
+ if (errorCodeOf(e) === "NoSuchKey")
111
+ throw new FileObjectMissingError(key);
112
+ throw e;
113
+ }
106
114
  },
107
115
  readStream(key) {
108
116
  assertSafeStorageKey(key);
@@ -11,7 +11,6 @@ const FOLDER_ASSIGNMENT_NAMESPACE = "b2e1f4a7-3c9d-4e8b-a1f6-5d2c8b3e7a9f";
11
11
  * creating a second row. This is the single-membership counterpart to tags'
12
12
  * many-to-many aggregate-id (which includes the tagId).
13
13
  */
14
- // @wrapper-known uuid-domain
15
14
  export function folderAssignmentAggregateId(tenantId, entityType, entityId) {
16
15
  return uuidv5(`${tenantId}|${entityType}|${entityId}`, FOLDER_ASSIGNMENT_NAMESPACE);
17
16
  }
@@ -64,7 +64,7 @@ export function FolderManager({ renderMeta, filing, }) {
64
64
  const [dragOverKey, setDragOverKey] = useState(null);
65
65
  const [pendingDelete, setPendingDelete] = useState(null);
66
66
  // Persist expand/collapse so a reload (F5) doesn't re-expand everything.
67
- // kumiko-lint-ignore no-raw-hooks DOM integration: writes to window.localStorage, no framework query/mutation equivalent
67
+ // biome-ignore lint/plugin: DOM integration: writes to window.localStorage, no framework query/mutation equivalent
68
68
  useEffect(() => {
69
69
  if (typeof window === "undefined")
70
70
  return;
@@ -3,24 +3,22 @@
3
3
  // user-data-rights when an app needs folders in its GDPR export/forget pipeline.
4
4
  // Kept separate from the folders feature (which only requires "tenant") so
5
5
  // folders stays usable without the user-data-rights stack. Mirrors credit-user-data.
6
- import { defineFeature, EXT_USER_DATA } from "@cosmicdrift/kumiko-framework/engine";
6
+ import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
7
+ import { registerUserDataHooks } from "../shared/index.js";
7
8
  import { folderAssignmentDeleteHook, folderAssignmentExportHook, folderDeleteHook, folderExportHook, } from "./hooks.js";
8
9
  export function createFoldersUserDataFeature() {
9
10
  return defineFeature("folders-user-data", (r) => {
10
11
  r.describe("GDPR (Art. 20 export / Art. 17 erasure) coverage for the `folders` feature's `folder` + `folder-assignment` entities. Mounts the EXT_USER_DATA export + delete hooks so a tenant's folder tree and its entity-to-folder assignments are included in the user-data export bundle and erased on a tenant-scoped forget (single-user tenants only; multi-user + anonymize are no-ops since folder rows carry no per-user PII). Kept separate from `folders` so folder consumers without the user-data-rights pipeline don't pull a hard dependency — requires `user-data-rights`, optionalRequires `folders`.");
11
- // user-data-rights is the hard dependency (EXT_USER_DATA host). `folders` is
12
- // OPTIONAL: if it's mounted toggleable(default=false) (e.g. per-tenant via
13
- // tier), a hard r.requires would throw an "effectively disabled" boot
14
- // warning even though the folder entities exist and the hooks work fine.
15
- r.requires({ features: ["user-data-rights"] });
16
- r.optionalRequires("folders");
17
- r.useExtension(EXT_USER_DATA, "folder", {
18
- export: folderExportHook,
19
- delete: folderDeleteHook,
20
- });
21
- r.useExtension(EXT_USER_DATA, "folder-assignment", {
22
- export: folderAssignmentExportHook,
23
- delete: folderAssignmentDeleteHook,
12
+ registerUserDataHooks(r, {
13
+ sourceFeature: "folders",
14
+ entities: [
15
+ { entity: "folder", export: folderExportHook, delete: folderDeleteHook },
16
+ {
17
+ entity: "folder-assignment",
18
+ export: folderAssignmentExportHook,
19
+ delete: folderAssignmentDeleteHook,
20
+ },
21
+ ],
24
22
  });
25
23
  }, { dedupeOptions: {} });
26
24
  }
@@ -35,6 +35,7 @@ function registerFormDraft(r) {
35
35
  r.job({
36
36
  name: "cleanup",
37
37
  trigger: { maintenance: true },
38
+ irreversibleWithoutEntryHandler: "high-risk-or-cron-pipeline",
38
39
  concurrency: "skip",
39
40
  escapeHatch: { reason: CLEANUP_ESCAPE_HATCH_REASON },
40
41
  handler: (payload, ctx) => cleanupDraftsJob(payload, ctx, ctx.db.unsafeRaw()),
@@ -104,12 +104,14 @@ export function createHelpdeskRequestEntity(retentionKeepFor = DEFAULT_RETENTION
104
104
  closedAt: createTimestampField(),
105
105
  replyCount: createNumberField({ default: 0 }),
106
106
  },
107
+ // All rows live in the system tenant, so the tenant_id index alone selects nothing.
108
+ indexes: [{ columns: ["tenantId", "status"] }, { columns: ["tenantId", "reporterUserId"] }],
107
109
  });
108
110
  }
109
111
  export function createHelpdeskReplyEntity(retentionKeepFor = DEFAULT_RETENTION_KEEP_FOR) {
110
112
  return createEntity({
111
113
  table: "read_helpdesk_replies",
112
- description: "A SystemAdmin's answer to a contact request, with the channels it went out on; the message is the reporter's personal data because it quotes and addresses them.",
114
+ description: "A SystemAdmin's answer to a helpdesk request, with the channels it went out on; the message is the reporter's personal data because it quotes and addresses them.",
113
115
  systemStream: true,
114
116
  tenancy: "global",
115
117
  retention: { keepFor: retentionKeepFor, strategy: "hardDelete", reference: "sentAt" },
@@ -141,6 +143,7 @@ export function createHelpdeskReplyEntity(retentionKeepFor = DEFAULT_RETENTION_K
141
143
  reason: "is_submission_timestamp",
142
144
  }),
143
145
  },
146
+ indexes: [{ columns: ["tenantId", "requestId"] }],
144
147
  });
145
148
  }
146
149
  export const helpdeskRequestEntity = createHelpdeskRequestEntity();
@@ -16,6 +16,9 @@ import { createSendReplyMailHandler } from "./handlers/send-reply-mail.write.js"
16
16
  import { createSendTestHandler } from "./handlers/send-test.write.js";
17
17
  import { createSubmitHandler } from "./handlers/submit.write.js";
18
18
  import { createHelpdeskI18n } from "./i18n.js";
19
+ import { carryOverLegacyContactConfig } from "./legacy-contact-config.js";
20
+ import { runLegacyContactRetention } from "./legacy-contact-retention.js";
21
+ import { LEGACY_CONTACT_REQUEST_ENTITY, legacyContactDeleteHook, legacyContactExportHook, } from "./legacy-contact-user-data.js";
19
22
  import { TELEGRAM_FEATURE } from "./lib.js";
20
23
  import { HELPDESK_ACKNOWLEDGEMENT_VARIABLES, HELPDESK_CONFIRMATION_VARIABLES, HELPDESK_NEW_REQUEST_VARIABLES, HELPDESK_REPLY_VARIABLES, HELPDESK_TEST_VARIABLES, helpdeskAcknowledgementTemplate, helpdeskConfirmationTemplate, helpdeskNewRequestTemplate, helpdeskReplyTemplate, helpdeskTestTemplate, inAppTemplate, telegramTemplate, } from "./mail.js";
21
24
  import { DEFAULT_RETENTION_KEEP_FOR, resolveHelpdeskSettings, } from "./options.js";
@@ -68,28 +71,35 @@ export function createHelpdeskFeature(opts) {
68
71
  },
69
72
  });
70
73
  }
74
+ // renamedFrom: preferences and opt-outs stored under the former contact feature keep applying.
71
75
  r.notification("new-request", {
76
+ renamedFrom: ["contact:notify:new-request"],
72
77
  variables: HELPDESK_NEW_REQUEST_VARIABLES,
73
78
  localizedTemplate: helpdeskNewRequestTemplate,
74
79
  ...(telegram && { templates: { telegram: telegramTemplate } }),
75
80
  });
76
81
  r.notification("confirmation", {
82
+ renamedFrom: ["contact:notify:confirmation"],
77
83
  variables: HELPDESK_CONFIRMATION_VARIABLES,
78
84
  localizedTemplate: helpdeskConfirmationTemplate,
79
85
  });
80
86
  r.notification("acknowledgement", {
87
+ renamedFrom: ["contact:notify:acknowledgement"],
81
88
  variables: HELPDESK_ACKNOWLEDGEMENT_VARIABLES,
82
89
  localizedTemplate: helpdeskAcknowledgementTemplate,
83
90
  });
84
91
  r.notification("reply", {
92
+ renamedFrom: ["contact:notify:reply"],
85
93
  variables: HELPDESK_REPLY_VARIABLES,
86
94
  localizedTemplate: helpdeskReplyTemplate,
87
95
  });
88
96
  r.notification("reply-in-app", {
97
+ renamedFrom: ["contact:notify:reply-in-app"],
89
98
  templates: { inApp: inAppTemplate },
90
99
  });
91
100
  if (telegram) {
92
101
  r.notification("test", {
102
+ renamedFrom: ["contact:notify:test"],
93
103
  variables: HELPDESK_TEST_VARIABLES,
94
104
  localizedTemplate: helpdeskTestTemplate,
95
105
  templates: { telegram: telegramTemplate },
@@ -129,6 +139,33 @@ export function createHelpdeskFeature(opts) {
129
139
  export: helpdeskExportHook,
130
140
  delete: helpdeskDeleteHook,
131
141
  });
142
+ // Requests stored before the rename to helpdesk sit inert under the former aggregate and tables.
143
+ r.useExtension(EXT_USER_DATA, LEGACY_CONTACT_REQUEST_ENTITY, {
144
+ export: legacyContactExportHook,
145
+ delete: legacyContactDeleteHook,
146
+ });
147
+ r.job({
148
+ // A literal, not LEGACY_CONTACT_CONFIG_JOB: the feature-AST extractor only reads string literals.
149
+ name: "legacy-contact-config",
150
+ trigger: { manual: true },
151
+ runOnBoot: true,
152
+ concurrency: "skip",
153
+ escapeHatch: {
154
+ reason: "the job has no tenant scope and reads the system-tenant config rows stored under the former contact keys through crossTenantReads, then writes them to the helpdesk keys via config:write:set as SystemAdmin",
155
+ grants: ["crossTenantReads", "systemIdentity"],
156
+ },
157
+ handler: async (_payload, ctx) => {
158
+ const carriedOver = await carryOverLegacyContactConfig(ctx);
159
+ ctx.obs.log.info("helpdesk: carried over former contact config", { carriedOver });
160
+ },
161
+ });
162
+ r.job({
163
+ name: "legacy-contact-retention",
164
+ trigger: { maintenance: true },
165
+ irreversibleWithoutEntryHandler: "high-risk-or-cron-pipeline",
166
+ concurrency: "skip",
167
+ handler: async (_payload, ctx) => runLegacyContactRetention(keepFor, ctx),
168
+ });
132
169
  // Replies are exported nested under their request and erased with it (helpdeskDeleteHook).
133
170
  r.useExtension(EXT_USER_DATA, "helpdesk-reply", {
134
171
  export: async () => null,
@@ -1,4 +1,3 @@
1
- export declare const SUBMIT_ROLES: readonly string[];
2
1
  export declare const REPORT_ACCESS: {
3
2
  readonly openToAll: {
4
3
  readonly reason: "every signed-in user may report a problem; name, email and tenant come from the session and the request is bound to the caller's own userId";
@@ -1,6 +1,3 @@
1
- import { access } from "@cosmicdrift/kumiko-framework/engine";
2
- // The website client sends without a session (credentials: "omit"), so it arrives as anonymous; other callers that carry a session pass through anySignedIn on the handlers.
3
- export const SUBMIT_ROLES = access.roles(...access.anonymous, ...access.authenticated, "Member", "TenantAdmin");
4
1
  export const REPORT_ACCESS = {
5
2
  openToAll: {
6
3
  reason: "every signed-in user may report a problem; name, email and tenant come from the session and the request is bound to the caller's own userId",
@@ -1,9 +1,10 @@
1
+ import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
1
2
  import { createSystemUser, } from "@cosmicdrift/kumiko-framework/engine";
3
+ import { chunk } from "@cosmicdrift/kumiko-framework/utils";
2
4
  import { IN_APP_NOTIFICATION_QUERIES } from "@cosmicdrift/kumiko-types/in-app-notification-types";
3
5
  import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
4
6
  import * as z from "zod";
5
7
  import { DeliveryQueries } from "../../delivery/index.js";
6
- import { SYSTEM_ADMIN_ROLE } from "../lib.js";
7
8
  // Both queries accept at most this many keys per call.
8
9
  const MAX_KEYS_PER_QUERY = 50;
9
10
  const instant = z.custom((value) => value instanceof Temporal.Instant);
@@ -18,18 +19,11 @@ const attemptsResultSchema = z.object({ rows: z.array(attemptSchema) });
18
19
  const readStateResultSchema = z.object({
19
20
  rows: z.array(z.object({ key: z.string(), readAt: instant.nullable() })),
20
21
  });
21
- function chunked(keys) {
22
- const chunks = [];
23
- for (let start = 0; start < keys.length; start += MAX_KEYS_PER_QUERY) {
24
- chunks.push(keys.slice(start, start + MAX_KEYS_PER_QUERY));
25
- }
26
- return chunks;
27
- }
28
22
  export async function loadAttemptsByKey(ctx, user, keys) {
29
23
  const rows = [];
30
- for (const chunk of chunked(keys)) {
24
+ for (const keyChunk of chunk(keys, MAX_KEYS_PER_QUERY)) {
31
25
  const result = await ctx.dispatch.queryAs(user, DeliveryQueries.attemptsByKeys, {
32
- keys: chunk,
26
+ keys: keyChunk,
33
27
  });
34
28
  rows.push(...attemptsResultSchema.parse(result).rows);
35
29
  }
@@ -42,10 +36,10 @@ export async function loadReadAtByKey(ctx, reporterTenantId, keys) {
42
36
  if (ctx.registry.getQueryHandler(IN_APP_NOTIFICATION_QUERIES.readStateByKeys) === undefined) {
43
37
  return readAtByKey;
44
38
  }
45
- const user = createSystemUser(reporterTenantId, [SYSTEM_ADMIN_ROLE]);
46
- for (const chunk of chunked(keys)) {
39
+ const user = createSystemUser(reporterTenantId, [ROLES.SystemAdmin]);
40
+ for (const keyChunk of chunk(keys, MAX_KEYS_PER_QUERY)) {
47
41
  const result = await ctx.dispatch.queryAs(user, IN_APP_NOTIFICATION_QUERIES.readStateByKeys, {
48
- keys: chunk,
42
+ keys: keyChunk,
49
43
  });
50
44
  for (const row of readStateResultSchema.parse(result).rows)
51
45
  readAtByKey.set(row.key, row.readAt);
@@ -4,12 +4,11 @@ import { issueChallenge } from "../challenge.js";
4
4
  import { CHALLENGE_RATE_LIMIT } from "../options.js";
5
5
  import { HelpdeskEmptySchema } from "../payloads.js";
6
6
  import { HELPDESK_WEBSITE_KINDS } from "../web/constants.js";
7
- import { SUBMIT_ROLES } from "./access.js";
8
7
  export function createChallengeQuery(settings) {
9
8
  return defineQueryHandler({
10
9
  name: "challenge",
11
10
  schema: HelpdeskEmptySchema,
12
- access: { roles: SUBMIT_ROLES, personalData: "public-intake", anySignedIn: true },
11
+ access: { roles: ["anonymous"], personalData: "public-intake", anySignedIn: true },
13
12
  rateLimit: CHALLENGE_RATE_LIMIT,
14
13
  agent: { expose: false },
15
14
  description: "Public contact form bootstrap: issues a single-use proof-of-work challenge and reports which fields the form shows (phone mode, request kinds).",
@@ -1,10 +1,10 @@
1
1
  import { createSystemUser, defineWriteHandler, } from "@cosmicdrift/kumiko-framework/engine";
2
- import { NotFoundError, UnprocessableError, writeFailure, } from "@cosmicdrift/kumiko-framework/errors";
2
+ import { NotFoundError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
3
3
  import { generateId } from "@cosmicdrift/kumiko-framework/utils";
4
4
  import { parseTenantId } from "@cosmicdrift/kumiko-types/identifiers";
5
- import { adminAccess, helpdeskDb, loadUserLabel, pickReplyChannels, platformActor, replyExecutor, requestExecutor, sendBestEffort, } from "../lib.js";
5
+ import { adminAccess, helpdeskDb, loadUserLabel, pickReplyChannels, platformActor, replyExecutor, requestExecutor, runBestEffort, } from "../lib.js";
6
6
  import { HelpdeskReplySchema } from "../payloads.js";
7
- import { HELPDESK_REPLY_CHANNELS, HELPDESK_REPLY_ENTITY, HELPDESK_REQUEST_ENTITY, HELPDESK_STATUS, HelpdeskErrors, HelpdeskHandlers, HelpdeskScreens, } from "../web/constants.js";
7
+ import { HELPDESK_REPLY_CHANNELS, HELPDESK_REPLY_ENTITY, HELPDESK_REQUEST_ENTITY, HELPDESK_STATUS, HelpdeskHandlers, HelpdeskScreens, } from "../web/constants.js";
8
8
  import { takeOverUploads } from "./take-over-uploads.js";
9
9
  async function noteReporterInApp(ctx, args) {
10
10
  const { request } = args;
@@ -12,7 +12,7 @@ async function noteReporterInApp(ctx, args) {
12
12
  // skip: the in-app note needs a signed-in reporter whose tenant id is still valid
13
13
  if (!request.reporterUserId || tenantId === null)
14
14
  return;
15
- await sendBestEffort(ctx, "reply in-app note", async () => {
15
+ await runBestEffort(ctx, "reply in-app note", async () => {
16
16
  const noted = await ctx.dispatch.writeAs(createSystemUser(tenantId), HelpdeskHandlers.notifyReporterInApp, {
17
17
  replyId: args.replyId,
18
18
  requestId: request.id,
@@ -83,9 +83,8 @@ export function createReplyHandler() {
83
83
  entityId: replyId,
84
84
  fileIds: event.payload.fileIds ?? [],
85
85
  });
86
- if (!uploaded.isSuccess) {
87
- return writeFailure(new UnprocessableError(HelpdeskErrors.attachmentNotFound));
88
- }
86
+ if (!uploaded.isSuccess)
87
+ return uploaded;
89
88
  const fileIds = uploaded.data;
90
89
  const author = await loadUserLabel(db, event.user.id);
91
90
  const authorName = author?.name ?? event.user.id;
@@ -102,7 +101,7 @@ export function createReplyHandler() {
102
101
  });
103
102
  if (failed !== null)
104
103
  return failed;
105
- await sendBestEffort(ctx, "reply mail", async () => {
104
+ await runBestEffort(ctx, "reply mail", async () => {
106
105
  const sent = await ctx.dispatch.writeAs(platformActor(), HelpdeskHandlers.sendReplyMail, {
107
106
  replyId,
108
107
  });
@@ -2,12 +2,13 @@ import { requestContext } from "@cosmicdrift/kumiko-framework/api";
2
2
  import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
3
3
  import { UnprocessableError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
4
4
  import { generateId } from "@cosmicdrift/kumiko-framework/utils";
5
- import { helpdeskDb, loadTenantName, loadTenantPlan, loadUserLabel, normalizeEmail, phoneProblem, platformActor, requestExecutor, sendBestEffort, } from "../lib.js";
5
+ import { normalizeEmail } from "../../shared/index.js";
6
+ import { forwardHelpdeskRequest, helpdeskDb, loadTenantName, loadTenantPlan, loadUserLabel, phoneProblem, platformActor, requestExecutor, runBestEffort, sendBestEffort, } from "../lib.js";
6
7
  import { helpdeskConfirmationVariables, resolveHelpdeskMailLocale } from "../mail.js";
7
8
  import { REPORT_RATE_LIMIT } from "../options.js";
8
9
  import { HelpdeskReportSchema } from "../payloads.js";
9
10
  import { summarizeUserAgent } from "../user-agent.js";
10
- import { HELPDESK_NOTIFICATION_TYPES, HELPDESK_REQUEST_ENTITY, HELPDESK_SOURCE, HELPDESK_STATUS, HELPDESK_UPLOAD_FIELD, HelpdeskErrors, HelpdeskHandlers, HelpdeskScreens, helpdeskIdempotencyKeys, } from "../web/constants.js";
11
+ import { HELPDESK_NOTIFICATION_TYPES, HELPDESK_REQUEST_ENTITY, HELPDESK_SOURCE, HELPDESK_STATUS, HELPDESK_UPLOAD_FIELD, HelpdeskErrors, HelpdeskScreens, helpdeskIdempotencyKeys, } from "../web/constants.js";
11
12
  import { REPORT_ACCESS } from "./access.js";
12
13
  import { takeOverUploads } from "./take-over-uploads.js";
13
14
  export function createReportHandler(opts, settings) {
@@ -67,11 +68,7 @@ export function createReportHandler(opts, settings) {
67
68
  }, platformActor(), db);
68
69
  if (!created.isSuccess)
69
70
  return created;
70
- await sendBestEffort(ctx, "forward request", async () => {
71
- const forwarded = await ctx.dispatch.writeAs(platformActor(), HelpdeskHandlers.forwardRequest, { requestId });
72
- if (!forwarded.isSuccess)
73
- throw new Error(forwarded.error.message);
74
- });
71
+ await runBestEffort(ctx, "forward request", () => forwardHelpdeskRequest(ctx, requestId));
75
72
  await sendBestEffort(ctx, "confirmation mail", (notify) => notify(HELPDESK_NOTIFICATION_TYPES.confirmation, {
76
73
  route: { email },
77
74
  recipientId: requestId,
@@ -3,16 +3,16 @@ import { defineWriteHandler, } from "@cosmicdrift/kumiko-framework/engine";
3
3
  import { InternalError, isKumikoError, UnprocessableError, writeFailure, } from "@cosmicdrift/kumiko-framework/errors";
4
4
  import { normalizePayloadBucketValue } from "@cosmicdrift/kumiko-framework/pipeline";
5
5
  import { generateId } from "@cosmicdrift/kumiko-framework/utils";
6
+ import { normalizeEmail } from "../../shared/index.js";
6
7
  import { consumeChallenge } from "../challenge.js";
7
- import { helpdeskDb, normalizeEmail, phoneProblem, platformActor, requestExecutor, sendBestEffort, } from "../lib.js";
8
+ import { forwardHelpdeskRequest, helpdeskDb, phoneProblem, platformActor, requestExecutor, runBestEffort, sendBestEffort, } from "../lib.js";
8
9
  import { helpdeskAcknowledgementVariables, resolveHelpdeskMailLocale } from "../mail.js";
9
10
  import { DEFAULT_SUBMIT_EMAIL_RATE_LIMITS, DEFAULT_SUBMIT_RATE_LIMIT, } from "../options.js";
10
11
  import { HelpdeskSubmitSchema } from "../payloads.js";
11
12
  import { verifyProofOfWork } from "../pow.js";
12
13
  import { deriveSubjectFromMessage } from "../subject.js";
13
14
  import { summarizeUserAgent } from "../user-agent.js";
14
- import { HELPDESK_NOTIFICATION_TYPES, HELPDESK_SOURCE, HELPDESK_STATUS, HelpdeskHandlers, helpdeskIdempotencyKeys, } from "../web/constants.js";
15
- import { SUBMIT_ROLES } from "./access.js";
15
+ import { HELPDESK_NOTIFICATION_TYPES, HELPDESK_SOURCE, HELPDESK_STATUS, helpdeskIdempotencyKeys, } from "../web/constants.js";
16
16
  // Identical body for stored and silently dropped submits, so a bot learns nothing from it.
17
17
  const SUBMITTED = {
18
18
  isSuccess: true,
@@ -75,7 +75,7 @@ export function createSubmitHandler(opts, settings) {
75
75
  return defineWriteHandler({
76
76
  name: "submit",
77
77
  schema: HelpdeskSubmitSchema,
78
- access: { roles: SUBMIT_ROLES, personalData: "public-intake", anySignedIn: true },
78
+ access: { roles: ["anonymous"], personalData: "public-intake", anySignedIn: true },
79
79
  rateLimit: opts.rateLimit ?? DEFAULT_SUBMIT_RATE_LIMIT,
80
80
  agent: { expose: false },
81
81
  description: "Public contact form: stores a question, contact request or problem report from a website visitor after a single-use proof-of-work challenge, forwards it to the SystemAdmins (mail, optional Telegram) and mails the sender a copy. Spam (honeypot, unknown or reused challenge, too fast, wrong proof of work) gets the same success body but nothing is stored or sent.",
@@ -115,11 +115,7 @@ export function createSubmitHandler(opts, settings) {
115
115
  }, platformActor(), helpdeskDb(ctx));
116
116
  if (!created.isSuccess)
117
117
  return created;
118
- await sendBestEffort(ctx, "forward request", async () => {
119
- const forwarded = await ctx.dispatch.writeAs(platformActor(), HelpdeskHandlers.forwardRequest, { requestId });
120
- if (!forwarded.isSuccess)
121
- throw new Error(forwarded.error.message);
122
- });
118
+ await runBestEffort(ctx, "forward request", () => forwardHelpdeskRequest(ctx, requestId));
123
119
  await sendBestEffort(ctx, "confirmation mail", (notify) => notify(HELPDESK_NOTIFICATION_TYPES.acknowledgement, {
124
120
  route: { email },
125
121
  recipientId: requestId,
@@ -2,4 +2,4 @@ export { helpdeskReplyEntity, helpdeskReplyTable, helpdeskRequestEntity, helpdes
2
2
  export { createHelpdeskFeature } from "./feature.ts";
3
3
  export type { HelpdeskOptions } from "./options.ts";
4
4
  export { helpdeskOpenRequestsPanels } from "./panels.ts";
5
- export { HELPDESK_ADMIN_KINDS, HELPDESK_CLIENT_PATH, HELPDESK_DELIVERY_CHANNEL, HELPDESK_DELIVERY_STATUS, HELPDESK_FEATURE, HELPDESK_FIELD_LIMITS, HELPDESK_KIND, HELPDESK_NOTIFICATION_TYPES, HELPDESK_ORIGIN, HELPDESK_REPLY_CHANNELS, HELPDESK_SOURCE, HELPDESK_STATUS, HELPDESK_WEBSITE_KINDS, HelpdeskConfigKeys, HelpdeskErrors, HelpdeskHandlers, HelpdeskQueries, HelpdeskScreens, } from "./web/constants.ts";
5
+ export { HELPDESK_ADMIN_KINDS, HELPDESK_CLIENT_PATH, HELPDESK_DELIVERY_CHANNEL, HELPDESK_DELIVERY_STATUS, HELPDESK_FEATURE, HELPDESK_FIELD_LIMITS, HELPDESK_KIND, HELPDESK_NOTIFICATION_TYPES, HELPDESK_ORIGIN, HELPDESK_REPLY_CHANNELS, HELPDESK_REQUEST_ENTITY, HELPDESK_SOURCE, HELPDESK_STATUS, HELPDESK_WEBSITE_KINDS, HelpdeskConfigKeys, HelpdeskErrors, HelpdeskHandlers, HelpdeskQueries, HelpdeskScreens, } from "./web/constants.ts";
@@ -1,4 +1,4 @@
1
1
  export { helpdeskReplyEntity, helpdeskReplyTable, helpdeskRequestEntity, helpdeskRequestTable, } from "./entity.js";
2
2
  export { createHelpdeskFeature } from "./feature.js";
3
3
  export { helpdeskOpenRequestsPanels } from "./panels.js";
4
- export { HELPDESK_ADMIN_KINDS, HELPDESK_CLIENT_PATH, HELPDESK_DELIVERY_CHANNEL, HELPDESK_DELIVERY_STATUS, HELPDESK_FEATURE, HELPDESK_FIELD_LIMITS, HELPDESK_KIND, HELPDESK_NOTIFICATION_TYPES, HELPDESK_ORIGIN, HELPDESK_REPLY_CHANNELS, HELPDESK_SOURCE, HELPDESK_STATUS, HELPDESK_WEBSITE_KINDS, HelpdeskConfigKeys, HelpdeskErrors, HelpdeskHandlers, HelpdeskQueries, HelpdeskScreens, } from "./web/constants.js";
4
+ export { HELPDESK_ADMIN_KINDS, HELPDESK_CLIENT_PATH, HELPDESK_DELIVERY_CHANNEL, HELPDESK_DELIVERY_STATUS, HELPDESK_FEATURE, HELPDESK_FIELD_LIMITS, HELPDESK_KIND, HELPDESK_NOTIFICATION_TYPES, HELPDESK_ORIGIN, HELPDESK_REPLY_CHANNELS, HELPDESK_REQUEST_ENTITY, HELPDESK_SOURCE, HELPDESK_STATUS, HELPDESK_WEBSITE_KINDS, HelpdeskConfigKeys, HelpdeskErrors, HelpdeskHandlers, HelpdeskQueries, HelpdeskScreens, } from "./web/constants.js";
@@ -0,0 +1,3 @@
1
+ import { type JobContext } from "@cosmicdrift/kumiko-framework/engine";
2
+ export declare const LEGACY_CONTACT_CONFIG_JOB = "legacy-contact-config";
3
+ export declare function carryOverLegacyContactConfig(ctx: JobContext): Promise<number>;
@@ -0,0 +1,57 @@
1
+ import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
2
+ import { ConfigScopes, createSystemUser, SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
3
+ import { InternalError, reraiseAsKumikoError } from "@cosmicdrift/kumiko-framework/errors";
4
+ import { parseJsonSafe } from "@cosmicdrift/kumiko-framework/utils";
5
+ import * as z from "zod";
6
+ import { ConfigHandlers, configValuesTable } from "../config/index.js";
7
+ import { HELPDESK_FEATURE } from "./web/constants.js";
8
+ export const LEGACY_CONTACT_CONFIG_JOB = "legacy-contact-config";
9
+ // The two keys of the former contact feature; the config values stay under them after the rename.
10
+ const CARRIED_OVER_KEYS = [
11
+ { legacy: "contact:config:reply-to", current: `${HELPDESK_FEATURE}:config:reply-to` },
12
+ { legacy: "contact:config:telegram-chat", current: `${HELPDESK_FEATURE}:config:telegram-chat` },
13
+ ];
14
+ const storedValueSchema = z.union([z.string(), z.number(), z.boolean()]);
15
+ // Both keys are system-scope, so the former feature only ever stored system rows.
16
+ // Writes through config:write:set, so the helpdesk key's own validation applies.
17
+ export async function carryOverLegacyContactConfig(ctx) {
18
+ const reads = ctx.crossTenantReads;
19
+ if (!reads) {
20
+ throw new InternalError({
21
+ message: "[helpdesk] legacy-contact-config needs the crossTenantReads grant",
22
+ });
23
+ }
24
+ const systemAdmin = createSystemUser(SYSTEM_TENANT_ID, [ROLES.SystemAdmin]);
25
+ let carriedOver = 0;
26
+ for (const { legacy, current } of CARRIED_OVER_KEYS) {
27
+ // skip: telegramChat is only registered with option telegram, then there is nothing to carry into
28
+ if (!ctx.registry.getConfigKey(current))
29
+ continue;
30
+ const alreadySet = await reads.selectMany(configValuesTable, {
31
+ key: current,
32
+ tenantId: SYSTEM_TENANT_ID,
33
+ });
34
+ if (alreadySet.some((row) => row["userId"] == null))
35
+ continue;
36
+ const former = await reads.selectMany(configValuesTable, {
37
+ key: legacy,
38
+ tenantId: SYSTEM_TENANT_ID,
39
+ });
40
+ const row = former.find((candidate) => candidate["userId"] == null);
41
+ const stored = typeof row?.["value"] === "string" ? row["value"] : undefined;
42
+ if (stored === undefined)
43
+ continue;
44
+ const value = storedValueSchema.safeParse(parseJsonSafe(stored, undefined));
45
+ if (!value.success)
46
+ continue;
47
+ const written = await ctx.dispatch.writeAs(systemAdmin, ConfigHandlers.set, {
48
+ key: current,
49
+ value: value.data,
50
+ scope: ConfigScopes.system,
51
+ });
52
+ if (!written.isSuccess)
53
+ throw reraiseAsKumikoError(written.error);
54
+ carriedOver++;
55
+ }
56
+ return carriedOver;
57
+ }