@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
@@ -1,4 +1,5 @@
1
- import { defineQueryHandler } from "@cosmicdrift/kumiko-framework/engine";
1
+ import { defineQueryHandler, SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { systemTenantReadDb } from "@cosmicdrift/kumiko-framework/internal/row-level-security";
2
3
  import * as z from "zod";
3
4
  import { resolveSecretTarget, secretScopeSchema } from "../secret-scope.js";
4
5
  import { tenantSecretsTable } from "../table.js";
@@ -16,7 +17,8 @@ export function createListHandler(access = DEFAULT_SECRETS_ACCESS) {
16
17
  const target = resolveSecretTarget(event.user, event.payload.scope);
17
18
  if (!target.ok)
18
19
  throw target.error;
19
- const rows = await ctx.db.selectMany(tenantSecretsTable, { tenantId: target.tenantId }, {
20
+ const readDb = target.tenantId === SYSTEM_TENANT_ID ? systemTenantReadDb(ctx.db) : ctx.db;
21
+ const rows = await readDb.selectMany(tenantSecretsTable, { tenantId: target.tenantId }, {
20
22
  orderBy: { col: "key", direction: "asc" },
21
23
  });
22
24
  return rows.map((r) => ({
@@ -1,7 +1,6 @@
1
1
  import { type SessionUser, type TenantId } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import { AccessDeniedError } from "@cosmicdrift/kumiko-framework/errors";
3
3
  import * as z from "zod";
4
- export declare const SYSTEM_ADMIN_ROLE = "SystemAdmin";
5
4
  export declare const secretScopeSchema: z.ZodOptional<z.ZodEnum<{
6
5
  system: "system";
7
6
  tenant: "tenant";
@@ -1,14 +1,14 @@
1
+ import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
1
2
  import { SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
2
3
  import { AccessDeniedError } from "@cosmicdrift/kumiko-framework/errors";
3
4
  import * as z from "zod";
4
- export const SYSTEM_ADMIN_ROLE = "SystemAdmin";
5
5
  // "system" targets the platform-wide secrets under SYSTEM_TENANT_ID (settings a SystemAdmin
6
6
  // edits for the whole app). The target is never taken from the payload, only chosen here.
7
7
  export const secretScopeSchema = z.enum(["tenant", "system"]).optional();
8
8
  export function resolveSecretTarget(user, scope) {
9
9
  if (scope !== "system")
10
10
  return { ok: true, tenantId: user.tenantId };
11
- if (!user.roles.includes(SYSTEM_ADMIN_ROLE)) {
11
+ if (!user.roles.includes(ROLES.SystemAdmin)) {
12
12
  return {
13
13
  ok: false,
14
14
  error: new AccessDeniedError({ message: "system-scope secrets need the SystemAdmin role" }),
@@ -17,7 +17,7 @@ import { append } from "@cosmicdrift/kumiko-framework/event-store";
17
17
  import { createDekCache, createSecret, decodeStoredEnvelope, decryptValue, encodeStoredEnvelope, encryptValue, withDekCache, } from "@cosmicdrift/kumiko-framework/secrets";
18
18
  import { generateId } from "@cosmicdrift/kumiko-framework/utils";
19
19
  import * as z from "zod";
20
- import { selectTenantSecretEnvelope } from "./db/queries/read.js";
20
+ import { readingSecretsOf, selectTenantSecretEnvelope } from "./db/queries/read.js";
21
21
  import { tenantSecretEntity, tenantSecretsTable, } from "./table.js";
22
22
  import { invalidSecretValueError, isSecretValueValid, } from "./write-gate.js";
23
23
  // Synthetic actor identity for set/delete — the executor wants a full
@@ -52,7 +52,7 @@ export function createSecretsContext(opts) {
52
52
  function buildSecretsContext(opts, provider, db, runnerIsTransaction) {
53
53
  const { masterKeyProvider } = opts;
54
54
  async function lookup(tenantId, key) {
55
- return fetchOne(db, tenantSecretsTable, { tenantId, key });
55
+ return readingSecretsOf(tenantId, () => fetchOne(db, tenantSecretsTable, { tenantId, key }));
56
56
  }
57
57
  return {
58
58
  withRunner(runner) {
@@ -143,7 +143,7 @@ function buildSecretsContext(opts, provider, db, runnerIsTransaction) {
143
143
  db,
144
144
  tenantId,
145
145
  mode: "system",
146
- reason: "secrets API writes for a caller-named tenant, outside a request scope",
146
+ reason: "secrets API writes the row of a caller-named tenant",
147
147
  });
148
148
  const existing = await lookup(tenantId, key);
149
149
  const commonFields = {
@@ -202,7 +202,7 @@ function buildSecretsContext(opts, provider, db, runnerIsTransaction) {
202
202
  db,
203
203
  tenantId,
204
204
  mode: "system",
205
- reason: "secrets API writes for a caller-named tenant, outside a request scope",
205
+ reason: "secrets API writes the row of a caller-named tenant",
206
206
  });
207
207
  const result = await executor.delete({ id: existing.id }, actor, tdb);
208
208
  return result.isSuccess;
@@ -28,4 +28,4 @@ export declare const tenantSecretEntity: import("@cosmicdrift/kumiko-types/field
28
28
  required: true;
29
29
  };
30
30
  }, "tenant">;
31
- export declare const tenantSecretsTable: import("@cosmicdrift/kumiko-types/executor-brand").WritableSchemaTable;
31
+ export declare const tenantSecretsTable: import("@cosmicdrift/kumiko-types/schema-table-types").SchemaTable;
@@ -1,3 +1,4 @@
1
+ import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
1
2
  import { AccessDeniedError, isKumikoError, NotFoundError, ValidationError, writeFailure, } from "@cosmicdrift/kumiko-framework/errors";
2
3
  import { INVALID_SECRET_VALUE_CODE, SECRETS_ERROR_KEYS } from "./web/constants.js";
3
4
  function unknownKeyFailure(key) {
@@ -22,13 +23,14 @@ function namespaceAcceptsKey(namespace, key) {
22
23
  // further for a key or a whole namespace. Delete passes allowUndeclared: it
23
24
  // creates nothing, and legacy rows under since-undeclared keys must stay removable,
24
25
  // unless the key sits under a mounted feature's prefix: those rows belong to the
25
- // feature and must not be removable by a tenant admin outside its writeRoles.
26
+ // feature, so only a SystemAdmin may remove them (e.g. after the feature dropped the key).
26
27
  export function checkSecretKeyWrite(registry, userRoles, key, options = {}) {
27
28
  const keyDef = registry.getSecretKey(key);
28
29
  const namespace = keyDef ? undefined : registry.findSecretNamespace(key);
29
30
  if (!keyDef &&
30
31
  !(namespace && namespaceAcceptsKey(namespace, key)) &&
31
- (options.allowUndeclared !== true || isUnderMountedFeaturePrefix(registry, key))) {
32
+ (options.allowUndeclared !== true ||
33
+ (isUnderMountedFeaturePrefix(registry, key) && !userRoles.includes(ROLES.SystemAdmin)))) {
32
34
  return unknownKeyFailure(key);
33
35
  }
34
36
  const writeRoles = keyDef?.writeRoles ?? namespace?.writeRoles;
@@ -16,7 +16,7 @@ import { SEO_CONFIG_QN } from "../constants.js";
16
16
  export const seoConfigQuery = defineQueryHandler({
17
17
  name: "config",
18
18
  schema: z.object({}),
19
- access: { roles: ["anonymous", "User", "TenantAdmin", "SystemAdmin"], anySignedIn: true },
19
+ access: { roles: ["anonymous"], anySignedIn: true },
20
20
  rateLimit: { per: "ip+handler", limit: 60, windowSeconds: 60 },
21
21
  description: "Reads the tenant's SEO metadata settings — organization name and logo URL, Twitter site handle, LLMs summary and default OG image — as plain strings; use it to inspect what the sitemap, llms.txt and page meta tags will publish.",
22
22
  handler: async (_query, ctx) => {
@@ -0,0 +1,5 @@
1
+ import type { TenantDb } from "@cosmicdrift/kumiko-framework/db";
2
+ import type { AppContext } from "@cosmicdrift/kumiko-framework/engine";
3
+ type CrossTenantReason = Parameters<NonNullable<AppContext["systemDb"]>["acknowledgeCrossTenant"]>[0];
4
+ export declare function acknowledgedSystemDb(ctx: Pick<AppContext, "systemDb">, featureName: string, crossTenantReason: CrossTenantReason): TenantDb;
5
+ export {};
@@ -0,0 +1,9 @@
1
+ import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
2
+ export function acknowledgedSystemDb(ctx, featureName, crossTenantReason) {
3
+ if (!ctx.systemDb) {
4
+ throw new InternalError({
5
+ message: `${featureName} requires ctx.systemDb — is r.systemScope() set on the feature?`,
6
+ });
7
+ }
8
+ return ctx.systemDb.acknowledgeCrossTenant(crossTenantReason);
9
+ }
@@ -1,2 +1,3 @@
1
1
  import type { ConfigKeyHandle, HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
2
+ export declare function isBillingLive(ctx: HandlerContext, billingLiveHandle: ConfigKeyHandle<"boolean">): Promise<boolean>;
2
3
  export declare function assertBillingLive(ctx: HandlerContext, billingLiveHandle: ConfigKeyHandle<"boolean">, featureName: string, handlerName: string): Promise<void>;
@@ -1,7 +1,10 @@
1
1
  import { FeatureDisabledError } from "@cosmicdrift/kumiko-framework/errors";
2
- export async function assertBillingLive(ctx, billingLiveHandle, featureName, handlerName) {
2
+ export async function isBillingLive(ctx, billingLiveHandle) {
3
3
  const live = ctx.config ? await ctx.config(billingLiveHandle) : undefined;
4
- if (live !== true) {
4
+ return live === true;
5
+ }
6
+ export async function assertBillingLive(ctx, billingLiveHandle, featureName, handlerName) {
7
+ if (!(await isBillingLive(ctx, billingLiveHandle))) {
5
8
  throw new FeatureDisabledError(featureName, handlerName);
6
9
  }
7
10
  }
@@ -1,4 +1,5 @@
1
- export { assertBillingLive } from "./assert-billing-live.ts";
1
+ export { acknowledgedSystemDb } from "./acknowledged-system-db.ts";
2
+ export { assertBillingLive, isBillingLive } from "./assert-billing-live.ts";
2
3
  export { collectErasureFailure, throwIfErasureFailed } from "./assert-erased.ts";
3
4
  export { assertNoWhereRuleInOwnershipWrite } from "./assert-no-where-rule-in-ownership-write.ts";
4
5
  export { attachmentFileNameSchema, sanitizePdfAttachmentFileName, } from "./attachment-file-name.ts";
@@ -18,7 +19,7 @@ export { createLockoutCounter, type LockoutCounterState } from "./lockout-counte
18
19
  export { createMailLocaleTemplates } from "./mail-locale-templates.ts";
19
20
  export { mailHeading, mailParagraph, mailParagraphWithLink, mailRepeatedRows, } from "./mail-template-body.ts";
20
21
  export { mapWithConcurrency } from "./map-with-concurrency.ts";
21
- export { denyUnlessJoinRowParentVisible, hostRowIsGone, joinRowParentIsVisible, parentRowIsVisible, } from "./parent-visibility.ts";
22
+ export { denyUnlessJoinRowParentVisible, hostRowIsGone, joinRowParentIsVisible, parentRowIsVisible, visibleParentRowIds, } from "./parent-visibility.ts";
22
23
  export { hashPassword, verifyDummyPassword, verifyPassword } from "./password-hashing.ts";
23
24
  export { type PriceEnvProvider, type PriceEnvShape, priceEnvSchema, priceEnvShape, } from "./price-env-shape.ts";
24
25
  export { type DeleteFileBytes, FileSweepError, type MissingStoragePolicy, purgeFilesReachingSubject, } from "./purge-files-reaching-subject.ts";
@@ -27,11 +28,14 @@ export { rateLimitedTextResponse } from "./rate-limited-text-response.ts";
27
28
  export { readFeatureExportFn } from "./read-feature-export-fn.ts";
28
29
  export { redactBotTokens, redactEmailAddresses, redactErrorText, redactUrls, } from "./redact.ts";
29
30
  export { REDACTED_PII_PLACEHOLDER, redactPiiCiphertext } from "./redact-pii-ciphertext.ts";
31
+ export { registerUserDataHooks } from "./register-user-data-hooks.ts";
32
+ export { requireBootstrapExtension } from "./require-bootstrap-extension.ts";
30
33
  export { requireForTenant } from "./require-for-tenant.ts";
31
34
  export { resolveFeatureAccess } from "./resolve-feature-access.ts";
32
35
  export { extensionForResourceContentType, isResourceImageContentType, isResourceImageFormat, RESOURCE_IMAGE_FORMATS, type ResourceImageContentType, type ResourceImageFormat, } from "./resource-image-formats.ts";
33
36
  export { type RowBoundGrantResult, redeemRowBoundGrant, signRowBoundGrant, } from "./row-bound-grant.ts";
34
37
  export { runInSubTransaction } from "./run-in-sub-transaction.ts";
38
+ export { sendBestEffort } from "./send-best-effort.ts";
35
39
  export { registrationLocaleFromRequest, sessionLocaleField } from "./session-locale-field.ts";
36
40
  export { sessionTimezoneField } from "./session-timezone-field.ts";
37
41
  export { assertNotSvg, MAX_INPUT_PIXELS, SHARP_INPUT_OPTIONS } from "./sharp-input-limits.ts";
@@ -1,4 +1,5 @@
1
- export { assertBillingLive } from "./assert-billing-live.js";
1
+ export { acknowledgedSystemDb } from "./acknowledged-system-db.js";
2
+ export { assertBillingLive, isBillingLive } from "./assert-billing-live.js";
2
3
  export { collectErasureFailure, throwIfErasureFailed } from "./assert-erased.js";
3
4
  export { assertNoWhereRuleInOwnershipWrite } from "./assert-no-where-rule-in-ownership-write.js";
4
5
  export { attachmentFileNameSchema, sanitizePdfAttachmentFileName, } from "./attachment-file-name.js";
@@ -18,7 +19,7 @@ export { createLockoutCounter } from "./lockout-counter.js";
18
19
  export { createMailLocaleTemplates } from "./mail-locale-templates.js";
19
20
  export { mailHeading, mailParagraph, mailParagraphWithLink, mailRepeatedRows, } from "./mail-template-body.js";
20
21
  export { mapWithConcurrency } from "./map-with-concurrency.js";
21
- export { denyUnlessJoinRowParentVisible, hostRowIsGone, joinRowParentIsVisible, parentRowIsVisible, } from "./parent-visibility.js";
22
+ export { denyUnlessJoinRowParentVisible, hostRowIsGone, joinRowParentIsVisible, parentRowIsVisible, visibleParentRowIds, } from "./parent-visibility.js";
22
23
  export { hashPassword, verifyDummyPassword, verifyPassword } from "./password-hashing.js";
23
24
  export { priceEnvSchema, priceEnvShape, } from "./price-env-shape.js";
24
25
  export { FileSweepError, purgeFilesReachingSubject, } from "./purge-files-reaching-subject.js";
@@ -27,11 +28,14 @@ export { rateLimitedTextResponse } from "./rate-limited-text-response.js";
27
28
  export { readFeatureExportFn } from "./read-feature-export-fn.js";
28
29
  export { redactBotTokens, redactEmailAddresses, redactErrorText, redactUrls, } from "./redact.js";
29
30
  export { REDACTED_PII_PLACEHOLDER, redactPiiCiphertext } from "./redact-pii-ciphertext.js";
31
+ export { registerUserDataHooks } from "./register-user-data-hooks.js";
32
+ export { requireBootstrapExtension } from "./require-bootstrap-extension.js";
30
33
  export { requireForTenant } from "./require-for-tenant.js";
31
34
  export { resolveFeatureAccess } from "./resolve-feature-access.js";
32
35
  export { extensionForResourceContentType, isResourceImageContentType, isResourceImageFormat, RESOURCE_IMAGE_FORMATS, } from "./resource-image-formats.js";
33
36
  export { redeemRowBoundGrant, signRowBoundGrant, } from "./row-bound-grant.js";
34
37
  export { runInSubTransaction } from "./run-in-sub-transaction.js";
38
+ export { sendBestEffort } from "./send-best-effort.js";
35
39
  export { registrationLocaleFromRequest, sessionLocaleField } from "./session-locale-field.js";
36
40
  export { sessionTimezoneField } from "./session-timezone-field.js";
37
41
  export { assertNotSvg, MAX_INPUT_PIXELS, SHARP_INPUT_OPTIONS } from "./sharp-input-limits.js";
@@ -2,6 +2,7 @@ import { type TenantDb } from "@cosmicdrift/kumiko-framework/db";
2
2
  import { type Registry, type SessionUser } from "@cosmicdrift/kumiko-framework/engine";
3
3
  import { type WriteFailure } from "@cosmicdrift/kumiko-framework/errors";
4
4
  export declare function parentRowIsVisible(registry: Registry, entityType: string, entityId: string, user: SessionUser, db: TenantDb): Promise<boolean>;
5
+ export declare function visibleParentRowIds(registry: Registry, entityType: string, entityIds: readonly string[], user: SessionUser, db: TenantDb): Promise<ReadonlySet<string>>;
5
6
  export declare function hostRowIsGone(registry: Registry, entityType: string, entityId: string, db: TenantDb): Promise<boolean>;
6
7
  export declare function joinRowParentIsVisible(registry: Registry, joinEntityName: string, payload: Readonly<Record<string, unknown>>, user: SessionUser, db: TenantDb): Promise<boolean>;
7
8
  export declare function denyUnlessJoinRowParentVisible(registry: Registry, joinEntityName: string, payload: {
@@ -33,12 +33,27 @@ export async function parentRowIsVisible(registry, entityType, entityId, user, d
33
33
  // the executor.
34
34
  if (!idShapeMatchesEntity(entity, entityId))
35
35
  return false;
36
+ return (await executorFor(entityType, entity).detail({ id: entityId }, user, db)) !== null;
37
+ }
38
+ function executorFor(entityType, entity) {
36
39
  let executor = executorsByEntity.get(entity);
37
40
  if (!executor) {
38
41
  executor = createEntityExecutor(entityType, entity).executor;
39
42
  executorsByEntity.set(entity, executor);
40
43
  }
41
- return (await executor.detail({ id: entityId }, user, db)) !== null;
44
+ return executor;
45
+ }
46
+ // Batch form of parentRowIsVisible: one list query for all ids instead of one detail lookup each.
47
+ // Same gates and the same default-deny; the caller keeps ids it was given that are not returned out.
48
+ export async function visibleParentRowIds(registry, entityType, entityIds, user, db) {
49
+ const entity = registry.getEntity(entityType);
50
+ if (!entity || entity.parentRef !== undefined)
51
+ return new Set();
52
+ const wellFormed = entityIds.filter((entityId) => idShapeMatchesEntity(entity, entityId));
53
+ if (wellFormed.length === 0)
54
+ return new Set();
55
+ const page = await executorFor(entityType, entity).list({ filters: [{ field: "id", op: "in", value: wellFormed }], limit: wellFormed.length }, user, db);
56
+ return new Set(page.rows.map((row) => String(row["id"])));
42
57
  }
43
58
  const hostTablesByEntity = new WeakMap();
44
59
  // True when the host row can never be read again by anyone: its entityType no
@@ -15,7 +15,6 @@ const HASH_OPTIONS = {
15
15
  timeCost: 2,
16
16
  parallelism: 1,
17
17
  };
18
- // @wrapper-known semantic-alias
19
18
  export async function hashPassword(password) {
20
19
  return argonHash(password, HASH_OPTIONS);
21
20
  }
@@ -5,7 +5,7 @@ export function priceEnvShape(provider, prices) {
5
5
  `${envPrefix}_PRICE_${price}`,
6
6
  z
7
7
  .string()
8
- .regex(new RegExp(`^${priceIdPrefix}`), `${envPrefix}_PRICE_${price} must start with '${priceIdPrefix}'`)
8
+ .startsWith(priceIdPrefix, `${envPrefix}_PRICE_${price} must start with '${priceIdPrefix}'`)
9
9
  .optional()
10
10
  .describe(`${label} price id (\`${priceIdPrefix}...\`) of the ${price} plan.`),
11
11
  ]));
@@ -0,0 +1,11 @@
1
+ import { type FeatureRegistrar, type UserDataDeleteHook, type UserDataExportHook } from "@cosmicdrift/kumiko-framework/engine";
2
+ type UserDataEntityHooks = {
3
+ readonly entity: string;
4
+ readonly export: UserDataExportHook;
5
+ readonly delete: UserDataDeleteHook;
6
+ };
7
+ export declare function registerUserDataHooks(r: FeatureRegistrar, config: {
8
+ readonly sourceFeature: string;
9
+ readonly entities: readonly UserDataEntityHooks[];
10
+ }): void;
11
+ export {};
@@ -0,0 +1,11 @@
1
+ import { EXT_USER_DATA, } from "@cosmicdrift/kumiko-framework/engine";
2
+ // The source feature is optionalRequires, not requires: a source mounted toggleable(default=false)
3
+ // would otherwise trip the "effectively disabled" boot warning although its entities exist and the
4
+ // hooks work. defineFeature itself stays literal in each feature so the AST doc generator sees it.
5
+ export function registerUserDataHooks(r, config) {
6
+ r.requires({ features: ["user-data-rights"] });
7
+ r.optionalRequires(config.sourceFeature);
8
+ config.entities.forEach(({ entity, export: exportHook, delete: deleteHook }) => {
9
+ r.useExtension(EXT_USER_DATA, entity, { export: exportHook, delete: deleteHook });
10
+ });
11
+ }
@@ -0,0 +1,9 @@
1
+ export declare function requireBootstrapExtension<TApi>(ctx: {
2
+ readonly services: {
3
+ readonly extensions: Readonly<Record<string, unknown>>;
4
+ };
5
+ }, callerName: string, extension: {
6
+ readonly key: string;
7
+ readonly bootstrapExample: string;
8
+ readonly readme: string;
9
+ }): TApi;
@@ -0,0 +1,16 @@
1
+ import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
2
+ // Handlers that need a feature API wired through the app bootstrap's `extraContext` read it from
3
+ // `services.extensions`; the missing case is a bootstrap mistake and gets one consistent message.
4
+ export function requireBootstrapExtension(ctx, callerName, extension) {
5
+ // @cast-boundary engine-bridge — the extension arrives per extraContext from the app bootstrap
6
+ // and lands in services.extensions; the framework does not know its type.
7
+ const api = ctx.services.extensions[extension.key];
8
+ if (!api) {
9
+ throw new InternalError({
10
+ message: `[${callerName}] ctx.${extension.key} missing — App-Bootstrap muss ` +
11
+ `extraContext: { ${extension.bootstrapExample} } setzen ` +
12
+ `(siehe ${extension.readme}).`,
13
+ });
14
+ }
15
+ return api;
16
+ }
@@ -0,0 +1,2 @@
1
+ import type { HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
2
+ export declare function sendBestEffort(ctx: Pick<HandlerContext, "notify" | "obs">, logMessage: string, send: (notify: NonNullable<HandlerContext["notify"]>) => Promise<unknown>): Promise<void>;
@@ -0,0 +1,14 @@
1
+ import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
2
+ export async function sendBestEffort(ctx, logMessage, send) {
3
+ try {
4
+ if (!ctx.notify) {
5
+ throw new InternalError({ message: "ctx.notify unavailable — mount the delivery feature" });
6
+ }
7
+ await send(ctx.notify);
8
+ }
9
+ catch (err) {
10
+ ctx.obs.log?.warn(logMessage, {
11
+ error: err instanceof Error ? err.message : String(err),
12
+ });
13
+ }
14
+ }
@@ -22,6 +22,7 @@ export type StreamBackfillOptions = {
22
22
  readonly aggregateType: string;
23
23
  readonly target: StreamTenantTarget;
24
24
  readonly beforeMove?: (candidate: StreamBackfillCandidate) => Promise<void>;
25
+ readonly onMoveFailed?: (candidate: StreamBackfillCandidate) => Promise<void>;
25
26
  readonly scanTenantIds?: readonly string[];
26
27
  readonly onFirstCandidate?: () => Promise<"proceed" | "skip">;
27
28
  };
@@ -33,6 +33,7 @@ export async function backfillAggregateStreamTenants(db, options) {
33
33
  let eventsMigrated = 0;
34
34
  const failed = [];
35
35
  for (const row of rows) {
36
+ let beforeMoveStarted;
36
37
  try {
37
38
  if (!row.target_tenant_id) {
38
39
  throw new Error(`earliest event of the aggregate carries no payload.tenantId`);
@@ -42,19 +43,34 @@ export async function backfillAggregateStreamTenants(db, options) {
42
43
  targetTenantId: row.target_tenant_id,
43
44
  sourceTenantIds: row.source_tenant_ids,
44
45
  };
46
+ beforeMoveStarted = candidate;
45
47
  await options.beforeMove?.(candidate);
46
48
  eventsMigrated += await migrateAggregate(db, options.aggregateType, candidate);
47
49
  aggregatesMigrated++;
48
50
  }
49
51
  catch (e) {
52
+ const moveError = e instanceof Error ? e.message : String(e);
50
53
  failed.push({
51
54
  aggregateId: row.aggregate_id,
52
- error: e instanceof Error ? e.message : String(e),
55
+ error: await withRestoreOutcome(options, beforeMoveStarted, moveError),
53
56
  });
54
57
  }
55
58
  }
56
59
  return { aggregatesMigrated, eventsMigrated, failed };
57
60
  }
61
+ // The move rolled back, so the aggregate stays where it was and must keep its pre-move derived state.
62
+ async function withRestoreOutcome(options, candidate, moveError) {
63
+ if (candidate === undefined || options.onMoveFailed === undefined)
64
+ return moveError;
65
+ try {
66
+ await options.onMoveFailed(candidate);
67
+ return moveError;
68
+ }
69
+ catch (restoreError) {
70
+ const detail = restoreError instanceof Error ? restoreError.message : String(restoreError);
71
+ return `${moveError}; restoring the pre-move derived state failed: ${detail}`;
72
+ }
73
+ }
58
74
  async function readCandidateRows(db, options) {
59
75
  const targetSql = options.target.kind === "system"
60
76
  ? `$2::text`
@@ -6,8 +6,12 @@ export type StreamBackfillStepFailure = StreamBackfillFailure & {
6
6
  readonly step: string;
7
7
  };
8
8
  export type DerivedStateMode = "if-moved" | "always";
9
- export declare function createSearchBucketCleanup(searchAdapter: SearchAdapter | undefined, entityType: string): {
9
+ export declare function createSearchBucketCleanup(searchAdapter: SearchAdapter | undefined, entityType: string, rowSource: {
10
+ readonly db: DbConnection;
11
+ readonly registry: Registry;
12
+ }): {
10
13
  readonly beforeMove: (candidate: StreamBackfillCandidate) => Promise<void>;
14
+ readonly onMoveFailed: (candidate: StreamBackfillCandidate) => Promise<void>;
11
15
  readonly cleanedAggregates: () => number;
12
16
  };
13
17
  export type DerivedStateResult = {
@@ -1,13 +1,30 @@
1
1
  // Derived state of a stream-tenant backfill: search docs in the buckets the streams
2
2
  // left, projection rows and the index on SYSTEM_TENANT_ID. The stream move itself lives
3
3
  // in stream-tenant-backfill.ts; this part is repeatable and safe to run without moves.
4
- import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
4
+ import { parseTenantId, SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
5
5
  import { rebuildProjection } from "@cosmicdrift/kumiko-framework/pipeline";
6
6
  import { isEntitySearchable, reindexEntity, } from "@cosmicdrift/kumiko-framework/search";
7
- export function createSearchBucketCleanup(searchAdapter, entityType) {
7
+ export function createSearchBucketCleanup(searchAdapter, entityType, rowSource) {
8
8
  let cleaned = 0;
9
9
  return {
10
10
  cleanedAggregates: () => cleaned,
11
+ // The rolled-back move leaves the row in its old bucket, so reindexing that row brings the doc
12
+ // back; the rest of the bucket was not touched by this candidate.
13
+ onMoveFailed: async (candidate) => {
14
+ // skip: no adapter means no search docs were removed
15
+ if (!searchAdapter || !isEntitySearchable(rowSource.registry, entityType))
16
+ return;
17
+ const oldBuckets = candidate.sourceTenantIds.filter((id) => id !== candidate.targetTenantId);
18
+ for (const bucket of oldBuckets) {
19
+ const bucketTenantId = parseTenantId(bucket);
20
+ if (bucketTenantId === null)
21
+ throw new Error(`source bucket ${bucket} is not a tenant id`);
22
+ const reindex = await reindexEntity(rowSource.db, rowSource.registry, searchAdapter, entityType, bucketTenantId, { onlyEntityId: candidate.aggregateId });
23
+ if (reindex.failures.length > 0) {
24
+ throw new Error(`reindex of ${candidate.aggregateId} in bucket ${bucket} failed for ${reindex.failures.length} rows: ${reindex.failures[0]?.reason}`);
25
+ }
26
+ }
27
+ },
11
28
  beforeMove: async (candidate) => {
12
29
  // skip: no adapter means no search docs to clean
13
30
  if (!searchAdapter)
@@ -1,10 +1,14 @@
1
1
  export declare const STEP_DISPATCHER_FEATURE = "step-dispatcher";
2
2
  export declare const StepDispatcherJobNames: {
3
3
  readonly deliver: "deliver";
4
+ readonly sweepAbandoned: "sweep-abandoned";
4
5
  };
5
6
  export declare const StepDispatcherJobs: {
6
7
  readonly deliver: string;
8
+ readonly sweepAbandoned: string;
7
9
  };
8
10
  export declare function deliverJobId(aggregateId: string): string;
9
11
  export declare const DELIVER_MAX_PER_TENANT = 2;
10
12
  export declare const DELIVER_RETRIES = 3;
13
+ export declare const ABANDON_DISPATCH_AFTER_HOURS = 24;
14
+ export declare const SWEEP_ABANDONED_BATCH_SIZE = 500;
@@ -2,9 +2,11 @@ import { QnTypes, qn } from "@cosmicdrift/kumiko-framework/engine";
2
2
  export const STEP_DISPATCHER_FEATURE = "step-dispatcher";
3
3
  export const StepDispatcherJobNames = {
4
4
  deliver: "deliver",
5
+ sweepAbandoned: "sweep-abandoned",
5
6
  };
6
7
  export const StepDispatcherJobs = {
7
8
  deliver: qn(STEP_DISPATCHER_FEATURE, QnTypes.job, StepDispatcherJobNames.deliver),
9
+ sweepAbandoned: qn(STEP_DISPATCHER_FEATURE, QnTypes.job, StepDispatcherJobNames.sweepAbandoned),
8
10
  };
9
11
  // Stable per dispatch stream: BullMQ ignores a second add() with the same id,
10
12
  // so an MSP redelivery cannot enqueue a second delivery.
@@ -15,3 +17,12 @@ export function deliverJobId(aggregateId) {
15
17
  // cannot occupy every worker slot.
16
18
  export const DELIVER_MAX_PER_TENANT = 2;
17
19
  export const DELIVER_RETRIES = 3;
20
+ // A deliver job spends at most DELIVER_RETRIES exponential retries (1 s base: 1 + 2 + 4 s) plus
21
+ // 100 per-tenant defers (maxDefers default, each capped at 30 s + 1 s jitter, about 52 min), so a
22
+ // live job is done long before this. Only a stalled or lost job leaves a request older than it
23
+ // without an outcome; 24 h also covers a worker lane that was down for a night.
24
+ export const ABANDON_DISPATCH_AFTER_HOURS = 24;
25
+ // Page size of the daily sweep. The open-stream query filters kumiko_events by aggregate type and
26
+ // event type without a matching index (the only index starts with tenant_id), so it is a seq
27
+ // scan: the cron runs once a day, not hourly.
28
+ export const SWEEP_ABANDONED_BATCH_SIZE = 500;
@@ -12,3 +12,4 @@ export type DeliverDispatchRequestArgs = {
12
12
  readonly applyContextFor: (userId: string) => MultiStreamApplyContext;
13
13
  };
14
14
  export declare function deliverDispatchRequest(args: DeliverDispatchRequestArgs): Promise<void>;
15
+ export declare function closeAbandonedDispatch(ctx: MultiStreamApplyContext, aggregateId: string): Promise<"closed" | "already-closed">;
@@ -3,6 +3,7 @@ import { configuredPiiSubjectKms } from "@cosmicdrift/kumiko-framework/crypto";
3
3
  import { STEP_DISPATCH_AGGREGATE_TYPE, STEP_DISPATCH_FAILED_TYPE, STEP_DISPATCH_REQUESTED_TYPE, STEP_DISPATCHED_TYPE, } from "@cosmicdrift/kumiko-framework/engine";
4
4
  import { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
5
5
  import { SYSTEM_USER_ID } from "@cosmicdrift/kumiko-types/identifiers";
6
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
6
7
  import { redactEmailAddresses } from "../shared/index.js";
7
8
  import { buildDispatchSpec, dispatchRequestedPayloadSchema, rawStepKindOf, readPayloadFields, } from "./dispatch-payload.js";
8
9
  import { performMailDispatch } from "./mail-runner.js";
@@ -22,6 +23,7 @@ const DELIVERY_RETRY_ERROR = "step delivery failed, retrying";
22
23
  const DISPATCH_THREW_ERROR = "delivery attempt threw unexpectedly";
23
24
  const FINAL_ATTEMPT_ABORTED_ERROR = "delivery aborted on the final attempt";
24
25
  const FINAL_ATTEMPT_UNRECORDED_ERROR = "step delivery failed and its outcome could not be recorded";
26
+ const DISPATCH_ABANDONED_ERROR = "dispatch abandoned without a recorded outcome";
25
27
  export function isDispatchOutcome(e) {
26
28
  return e.type === STEP_DISPATCHED_TYPE || e.type === STEP_DISPATCH_FAILED_TYPE;
27
29
  }
@@ -42,6 +44,18 @@ function mailResultAsDelivery(result) {
42
44
  result.smtpCode <= SMTP_PERMANENT_REJECTION_MAX;
43
45
  return { ok: false, error: result.error, retryable: !isPermanent };
44
46
  }
47
+ // Socket errors raised before any byte reached the provider: nothing can have been accepted.
48
+ const PRE_ACCEPT_NETWORK_ERROR_CODES = new Set([
49
+ "ECONNREFUSED",
50
+ "ENOTFOUND",
51
+ "EAI_AGAIN",
52
+ "EHOSTUNREACH",
53
+ "ENETUNREACH",
54
+ ]);
55
+ function isThrownBeforeProviderAccepted(err) {
56
+ const code = propertyOf(err, "code");
57
+ return typeof code === "string" && PRE_ACCEPT_NETWORK_ERROR_CODES.has(code);
58
+ }
45
59
  // Outcome events are plaintext and generic; the request payload's per-dispatch
46
60
  // key is erased right after, so the PII dies with the dispatch instead of
47
61
  // living in the event log. The outcome is appended before the erase on
@@ -91,6 +105,19 @@ function createOutcomeRecorder(ctx, aggregateId, attempt) {
91
105
  recordFailure: (stepKind, error) => record(STEP_DISPATCH_FAILED_TYPE, { stepKind, error, attempt }),
92
106
  };
93
107
  }
108
+ // For a deliver job that ended terminally without an outcome (BullMQ stall, lost job): the
109
+ // request is closed as failed and its key erased. A stream that already has an outcome only
110
+ // repeats the erase.
111
+ export async function closeAbandonedDispatch(ctx, aggregateId) {
112
+ const stream = await ctx.loadAggregate(aggregateId);
113
+ if (stream.some(isDispatchOutcome)) {
114
+ await eraseDispatchKey(aggregateId);
115
+ return "already-closed";
116
+ }
117
+ const requested = stream.find((e) => e.type === STEP_DISPATCH_REQUESTED_TYPE);
118
+ await createOutcomeRecorder(ctx, aggregateId, 0).recordFailure(rawStepKindOf(requested?.payload), DISPATCH_ABANDONED_ERROR);
119
+ return "closed";
120
+ }
94
121
  async function deliverRequested(args, requested, ctx, recorder) {
95
122
  const { aggregateId, tenantId, attempt, finalAttempt } = args;
96
123
  const { record, recordFailure } = recorder;
@@ -145,11 +172,12 @@ async function sendDispatch(dispatchSpec, target) {
145
172
  errorName: err instanceof Error ? err.name : "unknown",
146
173
  });
147
174
  // A mail adapter has no idempotency key: a throw after the provider accepted the message
148
- // would send it again, so only the webhook (which carries one) is retried.
175
+ // would send it again, so only the webhook (which carries one) and mail that failed before
176
+ // the connection was established are retried.
149
177
  return {
150
178
  ok: false,
151
179
  error: DISPATCH_THREW_ERROR,
152
- retryable: dispatchSpec.stepKind === "webhook.send",
180
+ retryable: dispatchSpec.stepKind === "webhook.send" || isThrownBeforeProviderAccepted(err),
153
181
  };
154
182
  }
155
183
  }
@@ -171,6 +199,14 @@ async function abortOnFinalAttempt(err, ctx, recorder, aggregateId, requestedPay
171
199
  }
172
200
  }
173
201
  catch {
202
+ // No outcome and no further retry: the request payload must not stay decryptable. A later
203
+ // redelivery then ends as "payload erased" instead of sending again.
204
+ await eraseDispatchKey(aggregateId).catch((eraseErr) => {
205
+ log.warn("dispatch key erase failed after an unrecorded final attempt", {
206
+ aggregateId,
207
+ errorName: eraseErr instanceof Error ? eraseErr.name : "unknown",
208
+ });
209
+ });
174
210
  throw new Error(FINAL_ATTEMPT_UNRECORDED_ERROR);
175
211
  }
176
212
  }