@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
@@ -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
  }
@@ -3,8 +3,10 @@ export function signHmacSha256Base64Url(input, secret) {
3
3
  return createHmac("sha256", secret).update(input).digest("base64url");
4
4
  }
5
5
  export function hmacSignatureMatches(expectedBase64Url, providedBase64Url) {
6
- const expectedBuf = Buffer.from(expectedBase64Url, "base64url");
7
- const providedBuf = Buffer.from(providedBase64Url, "base64url");
6
+ // The text is compared, not the decoded bytes: decoding ignores the unused trailing bits of the
7
+ // last character, so one signature would have several accepted spellings.
8
+ const expectedBuf = Buffer.from(expectedBase64Url);
9
+ const providedBuf = Buffer.from(providedBase64Url);
8
10
  // timingSafeEqual throws on a length mismatch, and the throw itself is a timing signal.
9
11
  return expectedBuf.length === providedBuf.length && timingSafeEqual(expectedBuf, providedBuf);
10
12
  }
@@ -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,8 @@ 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 { normalizeEmail } from "./normalize-email.ts";
23
+ export { denyUnlessJoinRowParentVisible, hostRowIsGone, joinRowParentIsVisible, parentRowIsVisible, visibleParentRowIds, } from "./parent-visibility.ts";
22
24
  export { hashPassword, verifyDummyPassword, verifyPassword } from "./password-hashing.ts";
23
25
  export { type PriceEnvProvider, type PriceEnvShape, priceEnvSchema, priceEnvShape, } from "./price-env-shape.ts";
24
26
  export { type DeleteFileBytes, FileSweepError, type MissingStoragePolicy, purgeFilesReachingSubject, } from "./purge-files-reaching-subject.ts";
@@ -27,11 +29,14 @@ export { rateLimitedTextResponse } from "./rate-limited-text-response.ts";
27
29
  export { readFeatureExportFn } from "./read-feature-export-fn.ts";
28
30
  export { redactBotTokens, redactEmailAddresses, redactErrorText, redactUrls, } from "./redact.ts";
29
31
  export { REDACTED_PII_PLACEHOLDER, redactPiiCiphertext } from "./redact-pii-ciphertext.ts";
32
+ export { registerUserDataHooks } from "./register-user-data-hooks.ts";
33
+ export { requireBootstrapExtension } from "./require-bootstrap-extension.ts";
30
34
  export { requireForTenant } from "./require-for-tenant.ts";
31
35
  export { resolveFeatureAccess } from "./resolve-feature-access.ts";
32
36
  export { extensionForResourceContentType, isResourceImageContentType, isResourceImageFormat, RESOURCE_IMAGE_FORMATS, type ResourceImageContentType, type ResourceImageFormat, } from "./resource-image-formats.ts";
33
37
  export { type RowBoundGrantResult, redeemRowBoundGrant, signRowBoundGrant, } from "./row-bound-grant.ts";
34
38
  export { runInSubTransaction } from "./run-in-sub-transaction.ts";
39
+ export { runBestEffort, sendBestEffort } from "./send-best-effort.ts";
35
40
  export { registrationLocaleFromRequest, sessionLocaleField } from "./session-locale-field.ts";
36
41
  export { sessionTimezoneField } from "./session-timezone-field.ts";
37
42
  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,8 @@ 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 { normalizeEmail } from "./normalize-email.js";
23
+ export { denyUnlessJoinRowParentVisible, hostRowIsGone, joinRowParentIsVisible, parentRowIsVisible, visibleParentRowIds, } from "./parent-visibility.js";
22
24
  export { hashPassword, verifyDummyPassword, verifyPassword } from "./password-hashing.js";
23
25
  export { priceEnvSchema, priceEnvShape, } from "./price-env-shape.js";
24
26
  export { FileSweepError, purgeFilesReachingSubject, } from "./purge-files-reaching-subject.js";
@@ -27,11 +29,14 @@ export { rateLimitedTextResponse } from "./rate-limited-text-response.js";
27
29
  export { readFeatureExportFn } from "./read-feature-export-fn.js";
28
30
  export { redactBotTokens, redactEmailAddresses, redactErrorText, redactUrls, } from "./redact.js";
29
31
  export { REDACTED_PII_PLACEHOLDER, redactPiiCiphertext } from "./redact-pii-ciphertext.js";
32
+ export { registerUserDataHooks } from "./register-user-data-hooks.js";
33
+ export { requireBootstrapExtension } from "./require-bootstrap-extension.js";
30
34
  export { requireForTenant } from "./require-for-tenant.js";
31
35
  export { resolveFeatureAccess } from "./resolve-feature-access.js";
32
36
  export { extensionForResourceContentType, isResourceImageContentType, isResourceImageFormat, RESOURCE_IMAGE_FORMATS, } from "./resource-image-formats.js";
33
37
  export { redeemRowBoundGrant, signRowBoundGrant, } from "./row-bound-grant.js";
34
38
  export { runInSubTransaction } from "./run-in-sub-transaction.js";
39
+ export { runBestEffort, sendBestEffort } from "./send-best-effort.js";
35
40
  export { registrationLocaleFromRequest, sessionLocaleField } from "./session-locale-field.js";
36
41
  export { sessionTimezoneField } from "./session-timezone-field.js";
37
42
  export { assertNotSvg, MAX_INPUT_PIXELS, SHARP_INPUT_OPTIONS } from "./sharp-input-limits.js";
@@ -0,0 +1 @@
1
+ export declare function normalizeEmail(email: string): string;
@@ -0,0 +1,3 @@
1
+ export function normalizeEmail(email) {
2
+ return email.toLowerCase();
3
+ }
@@ -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,3 @@
1
+ import type { HandlerContext } from "@cosmicdrift/kumiko-framework/engine";
2
+ export declare function runBestEffort(ctx: Pick<HandlerContext, "obs">, logMessage: string, run: () => Promise<unknown>): Promise<void>;
3
+ export declare function sendBestEffort(ctx: Pick<HandlerContext, "notify" | "obs">, logMessage: string, send: (notify: NonNullable<HandlerContext["notify"]>) => Promise<unknown>): Promise<void>;
@@ -0,0 +1,19 @@
1
+ import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
2
+ export async function runBestEffort(ctx, logMessage, run) {
3
+ try {
4
+ await run();
5
+ }
6
+ catch (err) {
7
+ ctx.obs.log?.warn(logMessage, {
8
+ error: err instanceof Error ? err.message : String(err),
9
+ });
10
+ }
11
+ }
12
+ export async function sendBestEffort(ctx, logMessage, send) {
13
+ await runBestEffort(ctx, logMessage, async () => {
14
+ if (!ctx.notify) {
15
+ throw new InternalError({ message: "ctx.notify unavailable — mount the delivery feature" });
16
+ }
17
+ await send(ctx.notify);
18
+ });
19
+ }
@@ -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">;