@cosmicdrift/kumiko-bundled-features 0.405.0 → 0.409.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 (337) hide show
  1. package/dist/account-security/feature.js +9 -1
  2. package/dist/admin-shell/feature.d.ts +3 -0
  3. package/dist/admin-shell/feature.js +1 -1
  4. package/dist/agent-tools/agent-manifest.js +1 -0
  5. package/dist/agent-tools/tool-catalog.js +1 -0
  6. package/dist/agent-tools/types.d.ts +4 -1
  7. package/dist/audit/event-classification.js +1 -0
  8. package/dist/auth-email-password/bootstrap.js +1 -0
  9. package/dist/auth-email-password/errors.js +16 -41
  10. package/dist/auth-email-password/web/auth-client.d.ts +8 -32
  11. package/dist/auth-email-password/web/auth-client.js +18 -52
  12. package/dist/auth-email-password/web/auth-redirect.js +2 -2
  13. package/dist/auth-email-password/web/confirm-account-unlock-screen.d.ts +2 -2
  14. package/dist/auth-email-password/web/confirm-account-unlock-screen.js +14 -35
  15. package/dist/auth-email-password/web/index.d.ts +1 -0
  16. package/dist/auth-email-password/web/index.js +1 -0
  17. package/dist/auth-email-password/web/read-path-param.d.ts +1 -0
  18. package/dist/auth-email-password/web/read-path-param.js +4 -0
  19. package/dist/auth-email-password/web/return-path.js +2 -2
  20. package/dist/auth-email-password/web/token-confirm-screen.d.ts +20 -0
  21. package/dist/auth-email-password/web/token-confirm-screen.js +38 -0
  22. package/dist/auth-email-password/web/verify-email-screen.d.ts +2 -2
  23. package/dist/auth-email-password/web/verify-email-screen.js +14 -37
  24. package/dist/auth-foundation/boot-checks.js +24 -12
  25. package/dist/auth-foundation/boot-rules.d.ts +27 -0
  26. package/dist/auth-foundation/boot-rules.js +27 -0
  27. package/dist/auth-mfa/errors.d.ts +1 -1
  28. package/dist/auth-mfa/errors.js +11 -24
  29. package/dist/auth-mfa/feature-exports.js +6 -45
  30. package/dist/auth-mfa/feature.js +7 -18
  31. package/dist/auth-mfa/web/mfa-client.js +11 -25
  32. package/dist/billing-foundation/consumer-protection/termination-notify.js +1 -0
  33. package/dist/billing-foundation/web/plan-price.js +7 -8
  34. package/dist/cap-counter/stock-cap-guard.js +1 -0
  35. package/dist/channel-in-app/constants.d.ts +1 -0
  36. package/dist/channel-in-app/feature.js +2 -0
  37. package/dist/channel-in-app/handlers/read-state-by-keys.query.d.ts +9 -0
  38. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +21 -0
  39. package/dist/channel-in-app/in-app-channel.js +1 -0
  40. package/dist/channel-in-app/tables.js +5 -1
  41. package/dist/contact/challenge.d.ts +14 -0
  42. package/dist/contact/challenge.js +30 -0
  43. package/dist/contact/client/contact-client-source.d.ts +1 -0
  44. package/dist/contact/client/contact-client-source.js +203 -0
  45. package/dist/contact/entity.d.ts +777 -0
  46. package/dist/contact/entity.js +145 -0
  47. package/dist/contact/feature.d.ts +3 -0
  48. package/dist/contact/feature.js +130 -0
  49. package/dist/contact/handlers/access.d.ts +7 -0
  50. package/dist/contact/handlers/access.js +9 -0
  51. package/dist/contact/handlers/attempts.d.ts +14 -0
  52. package/dist/contact/handlers/attempts.js +54 -0
  53. package/dist/contact/handlers/challenge.query.d.ts +9 -0
  54. package/dist/contact/handlers/challenge.query.js +35 -0
  55. package/dist/contact/handlers/forward-request.write.d.ts +9 -0
  56. package/dist/contact/handlers/forward-request.write.js +61 -0
  57. package/dist/contact/handlers/mark-done.write.d.ts +7 -0
  58. package/dist/contact/handlers/mark-done.write.js +30 -0
  59. package/dist/contact/handlers/notify-reporter-in-app.write.d.ts +10 -0
  60. package/dist/contact/handlers/notify-reporter-in-app.write.js +36 -0
  61. package/dist/contact/handlers/open-count.d.ts +2 -0
  62. package/dist/contact/handlers/open-count.js +11 -0
  63. package/dist/contact/handlers/open-count.query.d.ts +3 -0
  64. package/dist/contact/handlers/open-count.query.js +13 -0
  65. package/dist/contact/handlers/replies.query.d.ts +11 -0
  66. package/dist/contact/handlers/replies.query.js +28 -0
  67. package/dist/contact/handlers/reply.write.d.ts +12 -0
  68. package/dist/contact/handlers/reply.write.js +118 -0
  69. package/dist/contact/handlers/report.write.d.ts +16 -0
  70. package/dist/contact/handlers/report.write.js +90 -0
  71. package/dist/contact/handlers/request-delivery.query.d.ts +16 -0
  72. package/dist/contact/handlers/request-delivery.query.js +85 -0
  73. package/dist/contact/handlers/request-detail.query.d.ts +41 -0
  74. package/dist/contact/handlers/request-detail.query.js +32 -0
  75. package/dist/contact/handlers/request-list.query.d.ts +2 -0
  76. package/dist/contact/handlers/request-list.query.js +9 -0
  77. package/dist/contact/handlers/send-reply-mail.write.d.ts +8 -0
  78. package/dist/contact/handlers/send-reply-mail.write.js +82 -0
  79. package/dist/contact/handlers/send-test.write.d.ts +5 -0
  80. package/dist/contact/handlers/send-test.write.js +36 -0
  81. package/dist/contact/handlers/submit.write.d.ts +20 -0
  82. package/dist/contact/handlers/submit.write.js +137 -0
  83. package/dist/contact/handlers/take-over-uploads.d.ts +9 -0
  84. package/dist/contact/handlers/take-over-uploads.js +33 -0
  85. package/dist/contact/i18n.d.ts +6 -0
  86. package/dist/contact/i18n.js +186 -0
  87. package/dist/contact/index.d.ts +5 -0
  88. package/dist/contact/index.js +4 -0
  89. package/dist/contact/lib.d.ts +101 -0
  90. package/dist/contact/lib.js +109 -0
  91. package/dist/contact/mail.d.ts +91 -0
  92. package/dist/contact/mail.js +279 -0
  93. package/dist/contact/options.d.ts +51 -0
  94. package/dist/contact/options.js +32 -0
  95. package/dist/contact/panels.d.ts +2 -0
  96. package/dist/contact/panels.js +21 -0
  97. package/dist/contact/payloads.d.ts +56 -0
  98. package/dist/contact/payloads.js +82 -0
  99. package/dist/contact/pow.d.ts +6 -0
  100. package/dist/contact/pow.js +19 -0
  101. package/dist/contact/screens.d.ts +5 -0
  102. package/dist/contact/screens.js +464 -0
  103. package/dist/contact/subject.d.ts +1 -0
  104. package/dist/contact/subject.js +13 -0
  105. package/dist/contact/user-agent.d.ts +1 -0
  106. package/dist/contact/user-agent.js +35 -0
  107. package/dist/contact/user-data-hooks.d.ts +3 -0
  108. package/dist/contact/user-data-hooks.js +129 -0
  109. package/dist/contact/web/constants.d.ts +127 -0
  110. package/dist/contact/web/constants.js +126 -0
  111. package/dist/contact/web/index.d.ts +1 -0
  112. package/dist/contact/web/index.js +1 -0
  113. package/dist/crypto-shredding/handlers/forget-subject.write.js +5 -13
  114. package/dist/data-retention/feature.js +16 -2
  115. package/dist/data-retention/index.d.ts +1 -0
  116. package/dist/data-retention/index.js +1 -0
  117. package/dist/data-retention/run-retention-cleanup.d.ts +14 -2
  118. package/dist/data-retention/run-retention-cleanup.js +102 -36
  119. package/dist/data-retention/tenant-destruction-hold.d.ts +23 -0
  120. package/dist/data-retention/tenant-destruction-hold.js +132 -0
  121. package/dist/delivery/address-opt-out.js +1 -0
  122. package/dist/delivery/channel-context.d.ts +1 -1
  123. package/dist/delivery/channel-context.js +2 -1
  124. package/dist/delivery/delivery-service.js +18 -8
  125. package/dist/delivery/events.d.ts +1 -0
  126. package/dist/delivery/events.js +2 -0
  127. package/dist/delivery/feature.js +3 -0
  128. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +15 -0
  129. package/dist/delivery/handlers/attempts-by-keys.query.js +35 -0
  130. package/dist/delivery/handlers/log.query.d.ts +1 -0
  131. package/dist/delivery/handlers/log.query.js +1 -1
  132. package/dist/delivery/jobs.js +5 -2
  133. package/dist/delivery/tables.js +12 -2
  134. package/dist/delivery/types.d.ts +2 -0
  135. package/dist/delivery/unsubscribe-page.js +2 -0
  136. package/dist/delivery/web/delivery-channel-cell.js +1 -1
  137. package/dist/delivery/web/delivery-error-cell.js +1 -1
  138. package/dist/delivery/web/delivery-status-cell.js +1 -1
  139. package/dist/delivery/web/delivery-time-cell.js +3 -2
  140. package/dist/delivery/web/delivery-type-cell.js +1 -1
  141. package/dist/delivery/web/public-names.d.ts +1 -0
  142. package/dist/delivery/web/public-names.js +1 -0
  143. package/dist/document-ingest-foundation/boot-checks.js +19 -11
  144. package/dist/document-ingest-foundation/boot-rules.d.ts +17 -0
  145. package/dist/document-ingest-foundation/boot-rules.js +17 -0
  146. package/dist/document-ingest-foundation/events.d.ts +8 -0
  147. package/dist/document-ingest-foundation/events.js +12 -0
  148. package/dist/document-ingest-foundation/feature.js +30 -2
  149. package/dist/document-ingest-foundation/index.d.ts +3 -1
  150. package/dist/document-ingest-foundation/index.js +3 -1
  151. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +14 -0
  152. package/dist/document-ingest-foundation/report-ingest-progress.js +20 -0
  153. package/dist/document-ingest-foundation/tables.d.ts +3 -0
  154. package/dist/document-ingest-foundation/tables.js +26 -0
  155. package/dist/files-tenant-data/hooks.js +4 -1
  156. package/dist/folders/web/folder-manager.js +3 -10
  157. package/dist/folders/web/folder-section.js +1 -1
  158. package/dist/form-draft-user-data/index.js +4 -1
  159. package/dist/inbound-mail-foundation/entities.d.ts +3 -0
  160. package/dist/inbound-mail-foundation/entities.js +2 -0
  161. package/dist/inbound-mail-foundation/events.d.ts +2 -0
  162. package/dist/inbound-mail-foundation/events.js +2 -0
  163. package/dist/inbound-mail-foundation/feature.js +6 -6
  164. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +3 -1
  165. package/dist/inbound-mail-foundation/handlers/ingest-message.write.js +5 -0
  166. package/dist/inbound-mail-foundation/handlers/list-messages.query.js +4 -2
  167. package/dist/inbound-mail-foundation/handlers/message-content.d.ts +1 -0
  168. package/dist/inbound-mail-foundation/handlers/message-content.js +8 -0
  169. package/dist/inbound-mail-foundation/handlers/message-content.query.d.ts +2 -0
  170. package/dist/inbound-mail-foundation/handlers/message-content.query.js +1 -0
  171. package/dist/inbound-mail-foundation/projection.d.ts +3 -0
  172. package/dist/inbound-mail-foundation/projection.js +2 -0
  173. package/dist/inbound-mail-foundation/sanitize-inbound-html.d.ts +2 -0
  174. package/dist/inbound-mail-foundation/sanitize-inbound-html.js +135 -0
  175. package/dist/inbound-mail-foundation/types.js +1 -0
  176. package/dist/jobs/job-run-logger.js +16 -20
  177. package/dist/ledger/handlers/reports.query.js +25 -27
  178. package/dist/ledger/recurring.js +1 -0
  179. package/dist/notes-history/web/notes-section.js +3 -2
  180. package/dist/personal-access-tokens/feature.js +5 -18
  181. package/dist/personal-access-tokens/handlers/create.write.js +2 -5
  182. package/dist/secrets/handlers/delete.write.d.ts +4 -0
  183. package/dist/secrets/handlers/delete.write.js +9 -4
  184. package/dist/secrets/handlers/list.query.d.ts +6 -1
  185. package/dist/secrets/handlers/list.query.js +7 -3
  186. package/dist/secrets/handlers/set.write.d.ts +4 -0
  187. package/dist/secrets/handlers/set.write.js +10 -4
  188. package/dist/secrets/secret-scope.d.ts +17 -0
  189. package/dist/secrets/secret-scope.js +18 -0
  190. package/dist/sessions/feature.d.ts +3 -0
  191. package/dist/sessions/feature.js +13 -19
  192. package/dist/sessions/handlers/last-activity-probe.query.d.ts +7 -0
  193. package/dist/sessions/handlers/last-activity-probe.query.js +40 -0
  194. package/dist/sessions/handlers/last-activity-probe.route.d.ts +2 -0
  195. package/dist/sessions/handlers/last-activity-probe.route.js +30 -0
  196. package/dist/sessions/screens.js +1 -0
  197. package/dist/sessions/session-callbacks.d.ts +2 -0
  198. package/dist/sessions/session-callbacks.js +9 -7
  199. package/dist/sessions/web/i18n.js +4 -1
  200. package/dist/shared/assert-billing-live.d.ts +2 -0
  201. package/dist/shared/assert-billing-live.js +7 -0
  202. package/dist/shared/collect-extension-options.d.ts +1 -0
  203. package/dist/shared/collect-extension-options.js +8 -0
  204. package/dist/shared/index.d.ts +7 -1
  205. package/dist/shared/index.js +7 -1
  206. package/dist/shared/late-bound-slot.d.ts +5 -0
  207. package/dist/shared/late-bound-slot.js +13 -0
  208. package/dist/shared/mail-locale-templates.d.ts +1 -0
  209. package/dist/shared/mail-locale-templates.js +1 -1
  210. package/dist/shared/price-env-shape.d.ts +11 -0
  211. package/dist/shared/price-env-shape.js +15 -0
  212. package/dist/shared/purge-row-file-refs.d.ts +1 -0
  213. package/dist/shared/purge-row-file-refs.js +1 -1
  214. package/dist/shared/read-feature-export-fn.d.ts +2 -0
  215. package/dist/shared/read-feature-export-fn.js +11 -0
  216. package/dist/shared/signup-handover.js +3 -5
  217. package/dist/shared/tenant-destruction-hold.d.ts +23 -0
  218. package/dist/shared/tenant-destruction-hold.js +15 -0
  219. package/dist/shared/unprocessable.d.ts +4 -0
  220. package/dist/shared/unprocessable.js +4 -0
  221. package/dist/shared/web/index.d.ts +3 -0
  222. package/dist/shared/web/index.js +3 -0
  223. package/dist/subscription-paddle/feature.d.ts +1 -5
  224. package/dist/subscription-paddle/feature.js +7 -9
  225. package/dist/subscription-paddle/runtime.js +3 -7
  226. package/dist/subscription-stripe/feature.d.ts +1 -5
  227. package/dist/subscription-stripe/feature.js +7 -9
  228. package/dist/subscription-stripe/runtime.js +3 -7
  229. package/dist/tags/entity.js +1 -0
  230. package/dist/tags/web/tag-chip.d.ts +7 -0
  231. package/dist/tags/web/tag-chip.js +4 -0
  232. package/dist/tags/web/tag-filter.js +2 -5
  233. package/dist/tags/web/tag-manager.js +1 -1
  234. package/dist/tags/web/tag-section.js +3 -6
  235. package/dist/tags/web/tags-cell.js +2 -5
  236. package/dist/template-resolver/compile-document-body.js +12 -17
  237. package/dist/template-resolver/handlers/by-tenant.query.js +3 -1
  238. package/dist/template-resolver/handlers/discard-draft.write.js +1 -0
  239. package/dist/template-resolver/handlers/overview.query.js +3 -1
  240. package/dist/template-resolver/handlers/send-test.write.js +2 -4
  241. package/dist/template-resolver/handlers/toggle-status.write.js +3 -0
  242. package/dist/template-resolver/linked-resources.js +6 -5
  243. package/dist/template-resolver/store-template-resource.js +5 -10
  244. package/dist/template-resolver/web/document-images.js +6 -6
  245. package/dist/template-resolver/web/document-insert-fields.js +22 -4
  246. package/dist/template-resolver/web/document-schema.js +11 -12
  247. package/dist/template-resolver/web/tiptap-attribute-parse-rule.d.ts +15 -0
  248. package/dist/template-resolver/web/tiptap-attribute-parse-rule.js +11 -0
  249. package/dist/tenant/i18n.js +3 -0
  250. package/dist/tenant/schema/tenant.d.ts +9 -7
  251. package/dist/tenant/schema/tenant.js +1 -0
  252. package/dist/tenant/web/member-roles-cell.js +1 -1
  253. package/dist/tenant/web/member-status-cell.js +1 -1
  254. package/dist/tenant-inactivity/check-inactive-tenants.d.ts +3 -0
  255. package/dist/tenant-inactivity/check-inactive-tenants.js +184 -0
  256. package/dist/tenant-inactivity/constants.d.ts +10 -0
  257. package/dist/tenant-inactivity/constants.js +10 -0
  258. package/dist/tenant-inactivity/email-templates.d.ts +3 -0
  259. package/dist/tenant-inactivity/email-templates.js +16 -0
  260. package/dist/tenant-inactivity/feature.d.ts +8 -0
  261. package/dist/tenant-inactivity/feature.js +45 -0
  262. package/dist/tenant-inactivity/handlers/inactivity-state.query.d.ts +11 -0
  263. package/dist/tenant-inactivity/handlers/inactivity-state.query.js +45 -0
  264. package/dist/tenant-inactivity/handlers/keep-account.write.d.ts +8 -0
  265. package/dist/tenant-inactivity/handlers/keep-account.write.js +48 -0
  266. package/dist/tenant-inactivity/inactivity-plan.d.ts +51 -0
  267. package/dist/tenant-inactivity/inactivity-plan.js +113 -0
  268. package/dist/tenant-inactivity/index.d.ts +5 -0
  269. package/dist/tenant-inactivity/index.js +3 -0
  270. package/dist/tenant-inactivity/keep-token.d.ts +16 -0
  271. package/dist/tenant-inactivity/keep-token.js +24 -0
  272. package/dist/tenant-inactivity/mail-notifications.d.ts +4 -0
  273. package/dist/tenant-inactivity/mail-notifications.js +42 -0
  274. package/dist/tenant-inactivity/options.d.ts +27 -0
  275. package/dist/tenant-inactivity/options.js +5 -0
  276. package/dist/tenant-inactivity/remote-activity.d.ts +15 -0
  277. package/dist/tenant-inactivity/remote-activity.js +24 -0
  278. package/dist/tenant-inactivity/state-store.d.ts +10 -0
  279. package/dist/tenant-inactivity/state-store.js +50 -0
  280. package/dist/tenant-inactivity/state-table.d.ts +109 -0
  281. package/dist/tenant-inactivity/state-table.js +38 -0
  282. package/dist/tenant-lifecycle/boot-checks.js +8 -3
  283. package/dist/tenant-lifecycle/boot-rules.d.ts +12 -0
  284. package/dist/tenant-lifecycle/boot-rules.js +12 -0
  285. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  286. package/dist/tenant-lifecycle/constants.js +5 -0
  287. package/dist/tenant-lifecycle/events.d.ts +2 -0
  288. package/dist/tenant-lifecycle/events.js +2 -0
  289. package/dist/tenant-lifecycle/feature.js +18 -3
  290. package/dist/tenant-lifecycle/handlers/request-destruction.write.js +11 -67
  291. package/dist/tenant-lifecycle/index.d.ts +2 -1
  292. package/dist/tenant-lifecycle/index.js +2 -1
  293. package/dist/tenant-lifecycle/request-tenant-destruction.d.ts +20 -0
  294. package/dist/tenant-lifecycle/request-tenant-destruction.js +66 -0
  295. package/dist/tenant-lifecycle/retention-config-destroy-hooks.d.ts +5 -0
  296. package/dist/tenant-lifecycle/retention-config-destroy-hooks.js +29 -0
  297. package/dist/tenant-lifecycle/run-tenant-destroy.d.ts +5 -0
  298. package/dist/tenant-lifecycle/run-tenant-destroy.js +85 -12
  299. package/dist/tenant-lifecycle/stages.d.ts +3 -0
  300. package/dist/tenant-lifecycle/stages.js +27 -3
  301. package/dist/tenant-lifecycle/testing.js +1 -1
  302. package/dist/tier-engine/caps-for-tier-from-map.d.ts +5 -0
  303. package/dist/tier-engine/caps-for-tier-from-map.js +12 -0
  304. package/dist/tier-engine/compose-app.d.ts +0 -22
  305. package/dist/tier-engine/compose-app.js +9 -16
  306. package/dist/tier-engine/index.d.ts +1 -0
  307. package/dist/tier-engine/index.js +1 -0
  308. package/dist/user/handlers/detail.query.d.ts +1 -1
  309. package/dist/user-data-rights/feature.js +2 -0
  310. package/dist/user-data-rights/run-forget-cleanup.js +2 -0
  311. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  312. package/dist/user-data-rights/zip-path.js +1 -0
  313. package/dist/user-data-rights-defaults/hooks/config-value.userdata-hook.d.ts +1 -1
  314. package/dist/user-data-rights-defaults/hooks/config-value.userdata-hook.js +7 -20
  315. package/dist/user-data-rights-defaults/hooks/delivery-attempt.userdata-hook.js +3 -1
  316. package/dist/user-data-rights-defaults/hooks/forget-own-rows-delete-hook.d.ts +10 -0
  317. package/dist/user-data-rights-defaults/hooks/forget-own-rows-delete-hook.js +26 -0
  318. package/dist/user-data-rights-defaults/hooks/notification-preference.userdata-hook.d.ts +1 -1
  319. package/dist/user-data-rights-defaults/hooks/notification-preference.userdata-hook.js +7 -20
  320. package/dist/user-profile/handlers/change-email.write.js +2 -4
  321. package/dist/user-profile/web/profile-screen.js +2 -3
  322. package/kumiko-es-tables.json +12 -0
  323. package/package.json +46 -12
  324. package/src/admin-shell/changes.json +6 -0
  325. package/src/agent-tools/changes.json +6 -0
  326. package/src/channel-in-app/changes.json +7 -0
  327. package/src/contact/changes.json +27 -0
  328. package/src/data-retention/changes.json +6 -0
  329. package/src/delivery/changes.json +7 -0
  330. package/src/document-ingest-foundation/changes.json +6 -0
  331. package/src/files-tenant-data/changes.json +6 -0
  332. package/src/inbound-mail-foundation/changes.json +13 -0
  333. package/src/secrets/changes.json +6 -0
  334. package/src/sessions/changes.json +6 -0
  335. package/src/tenant-inactivity/changes.json +8 -0
  336. package/src/tenant-lifecycle/changes.json +30 -0
  337. package/src/tier-engine/changes.json +6 -0
@@ -1,10 +1,12 @@
1
1
  import { defineFeature, EXT_EXTERNAL_RESOURCE, EXT_INFRA_RESOURCE, EXT_SEARCH_ADAPTER, EXT_STORAGE_PROVIDER, EXT_TENANT_DATA, EXT_TENANT_LIFECYCLE_STATUS, } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { EXT_TENANT_DESTRUCTION_HOLD } from "../shared/index.js";
2
3
  import { validateTenantDataHookCoverage, validateTenantDestroyHookShapes, warnIfFilesMountedWithoutTenantData, } from "./boot-checks.js";
3
4
  import { DESTRUCTION_CANCELLED_EVENT_SHORT, DESTRUCTION_REQUESTED_EVENT_SHORT, TENANT_DESTRUCTION_COMPLETED_EVENT_SHORT, TENANT_DESTRUCTION_FAILED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_ABANDONED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_FAILED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_PROGRESSED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_STARTED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_SUCCEEDED_EVENT_SHORT, TENANT_DESTRUCTION_STARTED_EVENT_SHORT, } from "./constants.js";
4
5
  import { destructionCancelledSchema, destructionRequestedSchema, tenantDestructionCompletedSchema, tenantDestructionFailedSchema, tenantDestructionStageAbandonedSchema, tenantDestructionStageFailedSchema, tenantDestructionStageProgressedSchema, tenantDestructionStageStartedSchema, tenantDestructionStageSucceededSchema, tenantDestructionStartedSchema, } from "./events.js";
5
6
  import { cancelDestructionWrite } from "./handlers/cancel-destruction.write.js";
6
7
  import { requestDestructionWrite } from "./handlers/request-destruction.write.js";
7
- import { hasTenantDestructionWork, resolveTenantLifecycleGate, runTenantDestructionSweep, } from "./run-tenant-destroy.js";
8
+ import { COMPLIANCE_PROFILE_ENTITY_NAME, complianceProfileTenantDestroyHook, RETENTION_OVERRIDE_ENTITY_NAME, retentionOverrideTenantDestroyHook, } from "./retention-config-destroy-hooks.js";
9
+ import { hasTenantDestructionWork, resolveTenantLifecycleGate, runTenantDestructionSweep, tenantDestructionHoldProvider, } from "./run-tenant-destroy.js";
8
10
  const tenantLifecycleStatusPlugin = {
9
11
  async resolveStatus(tenantId, { db }) {
10
12
  const gate = await resolveTenantLifecycleGate(db, tenantId);
@@ -20,13 +22,26 @@ export function createTenantLifecycleFeature() {
20
22
  recommended: false,
21
23
  });
22
24
  r.requires({ features: ["tenant", "compliance-profiles"] });
23
- r.optionalRequires("sessions");
25
+ r.optionalRequires("sessions", "data-retention");
24
26
  r.usesApi("compliance.forTenant");
25
27
  r.extendsRegistrar(EXT_TENANT_DATA, {});
26
28
  r.extendsRegistrar(EXT_SEARCH_ADAPTER, {});
27
29
  r.extendsRegistrar(EXT_EXTERNAL_RESOURCE, {});
28
30
  r.extendsRegistrar(EXT_STORAGE_PROVIDER, {});
29
31
  r.extendsRegistrar(EXT_INFRA_RESOURCE, {});
32
+ // Self-extension: data-retention hands a parked tenant back through this, see shared/tenant-destruction-hold.ts.
33
+ r.extendsRegistrar(EXT_TENANT_DESTRUCTION_HOLD, {});
34
+ r.useExtension(EXT_TENANT_DESTRUCTION_HOLD, "tenant-lifecycle", tenantDestructionHoldProvider);
35
+ // Registered here because the hosts of these entities cannot require tenant-lifecycle (cycle,
36
+ // resp. standalone use); the override hook no-ops without data-retention.
37
+ r.useExtension(EXT_TENANT_DATA, COMPLIANCE_PROFILE_ENTITY_NAME, {
38
+ destroy: complianceProfileTenantDestroyHook,
39
+ phase: "tenant-row",
40
+ });
41
+ r.useExtension(EXT_TENANT_DATA, RETENTION_OVERRIDE_ENTITY_NAME, {
42
+ destroy: retentionOverrideTenantDestroyHook,
43
+ phase: "tenant-row",
44
+ });
30
45
  // Self-extension, same pattern as `user`/EXT_PRINCIPAL_STATUS — declares
31
46
  // AND fulfils tenantLifecycleStatus so teardown state is visible with no per-app wiring.
32
47
  r.extendsRegistrar(EXT_TENANT_LIFECYCLE_STATUS, {});
@@ -67,7 +82,7 @@ export function createTenantLifecycleFeature() {
67
82
  const RUN_TENANT_DESTRUCTION_REASON = "sweeps tenant destruction across every tenant";
68
83
  r.job({
69
84
  name: "run-tenant-destruction",
70
- trigger: { cron: "0 * * * * *" },
85
+ trigger: { cron: "0 * * * * *", wakesSleepingApp: false },
71
86
  concurrency: "skip",
72
87
  escapeHatch: { reason: RUN_TENANT_DESTRUCTION_REASON },
73
88
  handler: async (_payload, ctx) => {
@@ -1,16 +1,6 @@
1
- import { addDurationSpec } from "@cosmicdrift/kumiko-framework/compliance";
2
- import { createEventStoreExecutor, fetchOne } from "@cosmicdrift/kumiko-framework/db";
3
- import { defineWriteHandler, SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
4
- import { UnprocessableError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
5
- import { appendDomainEventCore } from "@cosmicdrift/kumiko-framework/pipeline";
6
- import { getTemporal } from "@cosmicdrift/kumiko-framework/time";
1
+ import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
7
2
  import * as z from "zod";
8
- import { resolveProfileForTenant } from "../../compliance-profiles/index.js";
9
- import { tenantEntity, tenantTable } from "../../tenant/index.js";
10
- import { DESTRUCTION_REQUESTED_EVENT_QN, TENANT_LIFECYCLE_FEATURE } from "../constants.js";
11
- import { revokeTenantSessions } from "../lib/revoke-tenant-sessions.js";
12
- import { invalidateTenantLifecycleGate } from "../lifecycle-gate.js";
13
- const crud = createEventStoreExecutor(tenantTable, tenantEntity, { entityName: "tenant" });
3
+ import { requestTenantDestruction } from "../request-tenant-destruction.js";
14
4
  const REQUEST_DESTRUCTION_TENANT_ROW_REASON = "reads the caller's tenant row (a global row on the system tenant), its compliance profile, appends to the tenant stream on the system tenant and revokes its sessions via DbRunner helpers";
15
5
  export const requestDestructionWrite = defineWriteHandler({
16
6
  name: "request-destruction",
@@ -22,59 +12,13 @@ export const requestDestructionWrite = defineWriteHandler({
22
12
  grants: ["unsafeRaw"],
23
13
  reason: REQUEST_DESTRUCTION_TENANT_ROW_REASON,
24
14
  },
25
- handler: async (event, ctx) => {
26
- const tenantId = event.user.tenantId;
27
- const runner = ctx.db.unsafeRaw();
28
- const row = await fetchOne(runner, tenantTable, { id: tenantId });
29
- if (!row) {
30
- return writeFailure(new UnprocessableError("tenant_not_found", { details: { tenantId } }));
31
- }
32
- if (row.status !== "active") {
33
- return writeFailure(new UnprocessableError("tenant_not_active", {
34
- details: { status: row.status },
35
- }));
36
- }
37
- const { profile } = await resolveProfileForTenant({ db: runner, tenantId });
38
- const T = getTemporal();
39
- const gracePeriodEnd = addDurationSpec(T.Now.instant(), profile.tenantDestroyGracePeriod);
40
- const update = await crud.update({
41
- id: tenantId,
42
- changes: {
43
- status: "destroyRequested",
44
- destroyRequestedAt: T.Now.instant(),
45
- destroyRequestedBy: event.user.id,
46
- gracePeriodEnd,
47
- },
48
- }, event.user, ctx.db, { skipOptimisticLock: true });
49
- if (!update.isSuccess)
50
- return update;
51
- invalidateTenantLifecycleGate(tenantId);
52
- await appendDomainEventCore({
53
- registry: ctx.registry,
54
- db: runner,
55
- tenantId: SYSTEM_TENANT_ID,
56
- userId: String(event.user.id),
57
- callSiteLabel: "tenant-lifecycle request-destruction",
58
- callerFeature: TENANT_LIFECYCLE_FEATURE,
59
- }, {
60
- aggregateId: tenantId,
61
- aggregateType: "tenant",
62
- type: DESTRUCTION_REQUESTED_EVENT_QN,
63
- payload: {
64
- requestedBy: event.user.id,
65
- gracePeriodEnd: gracePeriodEnd.toString(),
66
- },
67
- });
68
- if (await ctx.hasFeature("sessions")) {
69
- await revokeTenantSessions(runner, tenantId);
70
- }
71
- return {
72
- isSuccess: true,
73
- data: {
74
- tenantId,
75
- status: "destroyRequested",
76
- gracePeriodEnd: gracePeriodEnd.toString(),
77
- },
78
- };
79
- },
15
+ handler: async (event, ctx) => requestTenantDestruction({
16
+ tenantId: event.user.tenantId,
17
+ actor: event.user,
18
+ now: ctx.tz.now(),
19
+ db: ctx.db,
20
+ runner: ctx.db.unsafeRaw(),
21
+ registry: ctx.registry,
22
+ revokeSessions: await ctx.hasFeature("sessions"),
23
+ }),
80
24
  });
@@ -1,4 +1,5 @@
1
1
  export { archiveAndDeleteTenantRows, TENANT_DESTROY_ARCHIVE_REASON, TENANT_DESTROY_ARCHIVED_BY, } from "./archive-and-delete-tenant-rows.ts";
2
- export { TENANT_DESTRUCTION_STAGES, TENANT_LIFECYCLE_FEATURE, TenantLifecycleHandlers, } from "./constants.ts";
2
+ export { TENANT_DESTRUCTION_STAGE_FAILED_EVENT_QN, TENANT_DESTRUCTION_STAGE_PROGRESSED_EVENT_QN, TENANT_DESTRUCTION_STAGES, TENANT_LIFECYCLE_FEATURE, TenantLifecycleHandlers, } from "./constants.ts";
3
3
  export { createTenantLifecycleFeature } from "./feature.ts";
4
+ export { type RequestTenantDestructionArgs, requestTenantDestruction, } from "./request-tenant-destruction.ts";
4
5
  export { resolveTenantLifecycleGate } from "./run-tenant-destroy.ts";
@@ -1,4 +1,5 @@
1
1
  export { archiveAndDeleteTenantRows, TENANT_DESTROY_ARCHIVE_REASON, TENANT_DESTROY_ARCHIVED_BY, } from "./archive-and-delete-tenant-rows.js";
2
- export { TENANT_DESTRUCTION_STAGES, TENANT_LIFECYCLE_FEATURE, TenantLifecycleHandlers, } from "./constants.js";
2
+ export { TENANT_DESTRUCTION_STAGE_FAILED_EVENT_QN, TENANT_DESTRUCTION_STAGE_PROGRESSED_EVENT_QN, TENANT_DESTRUCTION_STAGES, TENANT_LIFECYCLE_FEATURE, TenantLifecycleHandlers, } from "./constants.js";
3
3
  export { createTenantLifecycleFeature } from "./feature.js";
4
+ export { requestTenantDestruction, } from "./request-tenant-destruction.js";
4
5
  export { resolveTenantLifecycleGate } from "./run-tenant-destroy.js";
@@ -0,0 +1,20 @@
1
+ import { type DbRunner, type TenantDb } from "@cosmicdrift/kumiko-framework/db";
2
+ import { type Registry, type SessionUser, type TenantId } from "@cosmicdrift/kumiko-framework/engine";
3
+ import type { Temporal } from "@cosmicdrift/kumiko-types/temporal";
4
+ export type RequestTenantDestructionArgs = {
5
+ readonly tenantId: TenantId;
6
+ readonly actor: SessionUser;
7
+ readonly now: Temporal.Instant;
8
+ readonly db: TenantDb;
9
+ readonly runner: DbRunner;
10
+ readonly registry: Registry;
11
+ readonly revokeSessions: boolean;
12
+ };
13
+ export declare function requestTenantDestruction(args: RequestTenantDestructionArgs): Promise<import("@cosmicdrift/kumiko-types/write-error-info-types").WriteFailure | {
14
+ isSuccess: true;
15
+ data: {
16
+ tenantId: string;
17
+ status: "destroyRequested";
18
+ gracePeriodEnd: string;
19
+ };
20
+ }>;
@@ -0,0 +1,66 @@
1
+ import { addDurationSpec } from "@cosmicdrift/kumiko-framework/compliance";
2
+ import { createEventStoreExecutor, fetchOne, } from "@cosmicdrift/kumiko-framework/db";
3
+ import { SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
4
+ import { UnprocessableError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
5
+ import { appendDomainEventCore } from "@cosmicdrift/kumiko-framework/pipeline";
6
+ import { resolveProfileForTenant } from "../compliance-profiles/index.js";
7
+ import { tenantEntity, tenantTable } from "../tenant/index.js";
8
+ import { DESTRUCTION_REQUESTED_EVENT_QN, TENANT_LIFECYCLE_FEATURE } from "./constants.js";
9
+ import { revokeTenantSessions } from "./lib/revoke-tenant-sessions.js";
10
+ import { invalidateTenantLifecycleGate } from "./lifecycle-gate.js";
11
+ const crud = createEventStoreExecutor(tenantTable, tenantEntity, { entityName: "tenant" });
12
+ // Shared by the owner-facing request-destruction handler and by system callers such as
13
+ // tenant-inactivity, so both start the same compliance-profile grace period.
14
+ export async function requestTenantDestruction(args) {
15
+ const { tenantId, actor, now, db, runner, registry } = args;
16
+ const row = await fetchOne(runner, tenantTable, { id: tenantId });
17
+ if (!row) {
18
+ return writeFailure(new UnprocessableError("tenant_not_found", { details: { tenantId } }));
19
+ }
20
+ if (row.status !== "active") {
21
+ return writeFailure(new UnprocessableError("tenant_not_active", {
22
+ details: { status: row.status },
23
+ }));
24
+ }
25
+ const { profile } = await resolveProfileForTenant({ db: runner, tenantId });
26
+ const gracePeriodEnd = addDurationSpec(now, profile.tenantDestroyGracePeriod);
27
+ const update = await crud.update({
28
+ id: tenantId,
29
+ changes: {
30
+ status: "destroyRequested",
31
+ destroyRequestedAt: now,
32
+ destroyRequestedBy: actor.id,
33
+ gracePeriodEnd,
34
+ },
35
+ }, actor, db, { skipOptimisticLock: true });
36
+ if (!update.isSuccess)
37
+ return update;
38
+ invalidateTenantLifecycleGate(tenantId);
39
+ await appendDomainEventCore({
40
+ registry,
41
+ db: runner,
42
+ tenantId: SYSTEM_TENANT_ID,
43
+ userId: String(actor.id),
44
+ callSiteLabel: "tenant-lifecycle request-destruction",
45
+ callerFeature: TENANT_LIFECYCLE_FEATURE,
46
+ }, {
47
+ aggregateId: tenantId,
48
+ aggregateType: "tenant",
49
+ type: DESTRUCTION_REQUESTED_EVENT_QN,
50
+ payload: {
51
+ requestedBy: actor.id,
52
+ gracePeriodEnd: gracePeriodEnd.toString(),
53
+ },
54
+ });
55
+ if (args.revokeSessions) {
56
+ await revokeTenantSessions(runner, tenantId);
57
+ }
58
+ return {
59
+ isSuccess: true,
60
+ data: {
61
+ tenantId,
62
+ status: "destroyRequested",
63
+ gracePeriodEnd: gracePeriodEnd.toString(),
64
+ },
65
+ };
66
+ }
@@ -0,0 +1,5 @@
1
+ import { type TenantDataHookCtx } from "@cosmicdrift/kumiko-framework/engine";
2
+ export declare const COMPLIANCE_PROFILE_ENTITY_NAME = "tenant-compliance-profile";
3
+ export declare const RETENTION_OVERRIDE_ENTITY_NAME = "tenant-retention-override";
4
+ export declare function complianceProfileTenantDestroyHook(ctx: TenantDataHookCtx): Promise<void>;
5
+ export declare function retentionOverrideTenantDestroyHook(ctx: TenantDataHookCtx): Promise<void>;
@@ -0,0 +1,29 @@
1
+ // The tenant's retention configuration (compliance profile, retention overrides) decides which
2
+ // entities are blockDelete-held. It is erased in the "tenant-row" phase, after the hold check, because
3
+ // deleting it earlier would change the hold predicate while the tenant still waits on held rows.
4
+ import { createEventStoreExecutor } from "@cosmicdrift/kumiko-framework/db";
5
+ import { createSystemUser, } from "@cosmicdrift/kumiko-framework/engine";
6
+ import { tenantComplianceProfileEntity, tenantComplianceProfileTable, } from "../compliance-profiles/index.js";
7
+ import { tenantRetentionOverrideEntity, tenantRetentionOverrideTable, } from "../data-retention/index.js";
8
+ export const COMPLIANCE_PROFILE_ENTITY_NAME = "tenant-compliance-profile";
9
+ export const RETENTION_OVERRIDE_ENTITY_NAME = "tenant-retention-override";
10
+ async function forgetAllTenantRows(ctx, table, entity, entityName) {
11
+ const executor = createEventStoreExecutor(table, entity, { entityName });
12
+ const user = createSystemUser(ctx.tenantId);
13
+ const rows = await ctx.db.selectMany(table, { tenantId: ctx.tenantId });
14
+ for (const row of rows) {
15
+ const forgotten = await executor.forget({ id: row.id }, user, ctx.db);
16
+ if (!forgotten.isSuccess) {
17
+ throw new Error(`tenant-lifecycle: failed to forget ${entityName} ${row.id} for tenant ${ctx.tenantId}: ${forgotten.error.message}`);
18
+ }
19
+ }
20
+ }
21
+ export async function complianceProfileTenantDestroyHook(ctx) {
22
+ await forgetAllTenantRows(ctx, tenantComplianceProfileTable, tenantComplianceProfileEntity, COMPLIANCE_PROFILE_ENTITY_NAME);
23
+ }
24
+ export async function retentionOverrideTenantDestroyHook(ctx) {
25
+ // skip: data-retention is optional, without it the override table does not exist
26
+ if (!ctx.registry.getEntity(RETENTION_OVERRIDE_ENTITY_NAME))
27
+ return;
28
+ await forgetAllTenantRows(ctx, tenantRetentionOverrideTable, tenantRetentionOverrideEntity, RETENTION_OVERRIDE_ENTITY_NAME);
29
+ }
@@ -4,11 +4,14 @@ import { type EscapeHatchAuditSink, type Registry, type TenantId } from "@cosmic
4
4
  import type { FileProviderResolver } from "@cosmicdrift/kumiko-framework/files";
5
5
  import type { Logger } from "@cosmicdrift/kumiko-framework/logging";
6
6
  import type { SearchAdapter } from "@cosmicdrift/kumiko-framework/search";
7
+ import type { TenantDestructionHoldProvider } from "../shared/index.ts";
7
8
  type StageTickResult = {
8
9
  readonly done: boolean;
9
10
  readonly error?: string;
10
11
  readonly halted?: boolean;
11
12
  readonly progressed?: boolean;
13
+ readonly pending?: boolean;
14
+ readonly held?: boolean;
12
15
  };
13
16
  export declare function runNextDestructionStage(args: {
14
17
  readonly db: DbRunner;
@@ -21,8 +24,10 @@ export declare function runNextDestructionStage(args: {
21
24
  readonly escapeHatchAuditLog?: Logger;
22
25
  readonly actor?: string;
23
26
  readonly deadlineAt?: number;
27
+ readonly now?: Temporal.Instant;
24
28
  }): Promise<StageTickResult>;
25
29
  export declare function hasTenantDestructionWork(reads: Pick<TenantDb, "count">, now: Temporal.Instant): Promise<boolean>;
30
+ export declare const tenantDestructionHoldProvider: TenantDestructionHoldProvider;
26
31
  /** Cron entry: start destruction for tenants past grace, then advance stages. */
27
32
  export declare function runTenantDestructionSweep(args: {
28
33
  readonly db: DbRunner;
@@ -1,9 +1,10 @@
1
- import { createEventStoreExecutor, createTenantDb, selectMany, WritePurposes, } from "@cosmicdrift/kumiko-framework/db";
1
+ import { createEventStoreExecutor, createTenantDb, fetchOne, selectMany, WritePurposes, } from "@cosmicdrift/kumiko-framework/db";
2
2
  import { createSystemUser, SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
3
3
  import { append, loadAggregate, VersionConflictError, } from "@cosmicdrift/kumiko-framework/event-store";
4
4
  import { getTemporal } from "@cosmicdrift/kumiko-framework/time";
5
+ import { tenantHasBlockDeleteRows } from "../data-retention/index.js";
5
6
  import { tenantEntity, tenantTable } from "../tenant/index.js";
6
- import { DESTRUCTION_STAGE_MIN_SLICE_MS, DESTRUCTION_STAGE_TICK_BUDGET_MS, TENANT_AGGREGATE_TYPE, TENANT_DESTRUCTION_COMPLETED_EVENT_QN, TENANT_DESTRUCTION_FAILED_EVENT_QN, TENANT_DESTRUCTION_STAGE_ABANDONED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_FAILED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_PROGRESSED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_STARTED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_SUCCEEDED_EVENT_SHORT, TENANT_DESTRUCTION_STARTED_EVENT_SHORT, } from "./constants.js";
7
+ import { DESTRUCTION_STAGE_MAX_PENDING_MS, DESTRUCTION_STAGE_MIN_SLICE_MS, DESTRUCTION_STAGE_TICK_BUDGET_MS, TENANT_AGGREGATE_TYPE, TENANT_DESTRUCTION_COMPLETED_EVENT_QN, TENANT_DESTRUCTION_FAILED_EVENT_QN, TENANT_DESTRUCTION_STAGE_ABANDONED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_FAILED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_PROGRESSED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_STARTED_EVENT_SHORT, TENANT_DESTRUCTION_STAGE_SUCCEEDED_EVENT_SHORT, TENANT_DESTRUCTION_STARTED_EVENT_SHORT, } from "./constants.js";
7
8
  import { invalidateTenantLifecycleGate, TEARDOWN_GATE_SETTLE_MS } from "./lifecycle-gate.js";
8
9
  import { isDestructionPipelineComplete, pickNextStage, } from "./stages.js";
9
10
  const tenantCrud = createEventStoreExecutor(tenantTable, tenantEntity, { entityName: "tenant" });
@@ -44,6 +45,20 @@ function isStageContinuation(events, stageName) {
44
45
  const lastStageEvent = events.findLast((event) => stageEventTypes.has(event.type) && event.payload["stage"] === stageName);
45
46
  return lastStageEvent?.type === qualified(TENANT_DESTRUCTION_STAGE_PROGRESSED_EVENT_SHORT);
46
47
  }
48
+ // Stage-started events written before startedAt existed fall back to their append time.
49
+ function currentAttemptStartedAt(events, stageName) {
50
+ const started = events.findLast((event) => event.type === qualified(TENANT_DESTRUCTION_STAGE_STARTED_EVENT_SHORT) &&
51
+ event.payload["stage"] === stageName);
52
+ if (!started)
53
+ return undefined;
54
+ const startedAt = started.payload["startedAt"];
55
+ return typeof startedAt === "string" ? getTemporal().Instant.from(startedAt) : started.createdAt;
56
+ }
57
+ function isPendingWindowOpen(events, stageName, now) {
58
+ const startedAt = currentAttemptStartedAt(events, stageName);
59
+ return (startedAt !== undefined &&
60
+ now.epochMilliseconds - startedAt.epochMilliseconds <= DESTRUCTION_STAGE_MAX_PENDING_MS);
61
+ }
47
62
  function lastEventVersion(events) {
48
63
  const last = events.at(-1);
49
64
  return last?.version ?? 0;
@@ -87,7 +102,7 @@ async function appendTenantStageEventIdempotent(db, tenantId, type, payload, exp
87
102
  const events = await loadAggregate(db, tenantId, SYSTEM_TENANT_ID);
88
103
  return lastEventVersion(events);
89
104
  }
90
- async function markTenantDestroyFailed(db, tenantId) {
105
+ async function setTenantLifecycleStatus(db, tenantId, status) {
91
106
  const user = createSystemUser(tenantId);
92
107
  const scopedDb = createTenantDb({
93
108
  db,
@@ -97,10 +112,16 @@ async function markTenantDestroyFailed(db, tenantId) {
97
112
  });
98
113
  await tenantCrud.update({
99
114
  id: tenantId,
100
- changes: { status: "destroyFailed" },
115
+ changes: { status },
101
116
  }, user, scopedDb, { skipOptimisticLock: true, writePurpose: WritePurposes.erasure });
102
117
  invalidateTenantLifecycleGate(tenantId);
103
118
  }
119
+ // True while the tenant still owns rows whose blockDelete retention has not run out.
120
+ async function tenantOwnsRetentionHeldRows(args) {
121
+ if (!args.registry.features.has("data-retention"))
122
+ return false;
123
+ return await tenantHasBlockDeleteRows(args);
124
+ }
104
125
  async function haltPipelineOnAbandon(args) {
105
126
  const T = getTemporal();
106
127
  const failedAt = T.Now.instant();
@@ -113,7 +134,7 @@ async function haltPipelineOnAbandon(args) {
113
134
  const eventsAfterAbandon = await loadAggregate(args.db, args.tenantId, SYSTEM_TENANT_ID);
114
135
  const versionAfterAbandon = lastEventVersion(eventsAfterAbandon);
115
136
  await appendTenantStageEvent(args.db, args.tenantId, TENANT_DESTRUCTION_FAILED_EVENT_QN, { stage: args.stage, error: args.error, failedAt: failedAt.toString() }, versionAfterAbandon);
116
- await markTenantDestroyFailed(args.db, args.tenantId);
137
+ await setTenantLifecycleStatus(args.db, args.tenantId, "destroyFailed");
117
138
  }
118
139
  async function maybeAppendDestructionCompleted(db, tenantId, completed) {
119
140
  if (!isDestructionPipelineComplete(completed)) {
@@ -144,7 +165,28 @@ async function recordFailedStageAttempt(args) {
144
165
  await appendTenantStageEvent(args.db, args.tenantId, qualified(TENANT_DESTRUCTION_STAGE_FAILED_EVENT_SHORT), { stage: args.stage.name, attempts: args.attempt, error: args.error }, args.version);
145
166
  return { done: false, error: args.error };
146
167
  }
168
+ // A tick that neither finishes nor processes anything would otherwise loop forever,
169
+ // because progressed events do not count as attempts. A pending tick still appends a
170
+ // progressed event: without it the next tick would open a new stage-started and the
171
+ // pending window would never close.
172
+ async function recordIdleStageTick(args) {
173
+ if (args.pending && isPendingWindowOpen(args.events, args.stage.name, args.now)) {
174
+ await appendTenantStageEvent(args.db, args.tenantId, qualified(TENANT_DESTRUCTION_STAGE_PROGRESSED_EVENT_SHORT), { stage: args.stage.name, attempts: args.attempt, processed: 0, pending: true }, lastEventVersion(args.events));
175
+ return { done: false, pending: true };
176
+ }
177
+ return await recordFailedStageAttempt({
178
+ db: args.db,
179
+ tenantId: args.tenantId,
180
+ stage: args.stage,
181
+ attempt: args.attempt,
182
+ error: args.pending
183
+ ? `stage "${args.stage.name}" still pending after ${DESTRUCTION_STAGE_MAX_PENDING_MS / 60_000} min`
184
+ : `stage "${args.stage.name}" made no progress`,
185
+ version: lastEventVersion(args.events),
186
+ });
187
+ }
147
188
  export async function runNextDestructionStage(args) {
189
+ const now = args.now ?? getTemporal().Now.instant();
148
190
  const events = await loadAggregate(args.db, args.tenantId, SYSTEM_TENANT_ID);
149
191
  const { completed, abandoned, attemptsByStage } = replayStageState(events);
150
192
  if (abandoned.size > 0) {
@@ -155,6 +197,17 @@ export async function runNextDestructionStage(args) {
155
197
  await maybeAppendDestructionCompleted(args.db, args.tenantId, completed);
156
198
  return { done: isDestructionPipelineComplete(completed) };
157
199
  }
200
+ // Parking is no stage attempt: no stage-started event, no attempt count, no failure.
201
+ if (next.name === "tenant-row" &&
202
+ (await tenantOwnsRetentionHeldRows({
203
+ db: args.db,
204
+ registry: args.registry,
205
+ tenantId: args.tenantId,
206
+ now,
207
+ }))) {
208
+ await setTenantLifecycleStatus(args.db, args.tenantId, "destroyHeld");
209
+ return { done: false, held: true };
210
+ }
158
211
  const priorAttempts = attemptsByStage.get(next.name) ?? 0;
159
212
  const attempt = priorAttempts + 1;
160
213
  const ctx = {
@@ -168,10 +221,11 @@ export async function runNextDestructionStage(args) {
168
221
  escapeHatchAuditLog: args.escapeHatchAuditLog,
169
222
  actor: args.actor,
170
223
  deadlineAt: args.deadlineAt ?? Date.now() + DESTRUCTION_STAGE_TICK_BUDGET_MS,
224
+ now,
171
225
  };
172
226
  let version = lastEventVersion(events);
173
227
  if (!isStageContinuation(events, next.name)) {
174
- version = await appendTenantStageEventIdempotent(args.db, args.tenantId, qualified(TENANT_DESTRUCTION_STAGE_STARTED_EVENT_SHORT), { stage: next.name, attempts: attempt }, version, stageOutcomeRecorded(events, next.name, TENANT_DESTRUCTION_STAGE_SUCCEEDED_EVENT_SHORT));
228
+ version = await appendTenantStageEventIdempotent(args.db, args.tenantId, qualified(TENANT_DESTRUCTION_STAGE_STARTED_EVENT_SHORT), { stage: next.name, attempts: attempt, startedAt: now.toString() }, version, stageOutcomeRecorded(events, next.name, TENANT_DESTRUCTION_STAGE_SUCCEEDED_EVENT_SHORT));
175
229
  }
176
230
  try {
177
231
  const outcome = await next.run(ctx);
@@ -180,16 +234,15 @@ export async function runNextDestructionStage(args) {
180
234
  // the version fresh instead of trusting the pre-run `version`, or this
181
235
  // append throws VersionConflictError on every stage whose run() writes.
182
236
  const eventsAfterRun = await loadAggregate(args.db, args.tenantId, SYSTEM_TENANT_ID);
183
- // A tick that neither finishes nor processes anything would otherwise loop
184
- // forever, because progressed events do not count as attempts.
185
237
  if (!outcome.done && outcome.processed === 0) {
186
- return await recordFailedStageAttempt({
238
+ return await recordIdleStageTick({
187
239
  db: args.db,
188
240
  tenantId: args.tenantId,
189
241
  stage: next,
190
242
  attempt,
191
- error: `stage "${next.name}" made no progress`,
192
- version: lastEventVersion(eventsAfterRun),
243
+ pending: outcome.pending === true,
244
+ events: eventsAfterRun,
245
+ now,
193
246
  });
194
247
  }
195
248
  if (!outcome.done) {
@@ -226,6 +279,25 @@ export async function hasTenantDestructionWork(reads, now) {
226
279
  ]);
227
280
  return due > 0 || destroying > 0;
228
281
  }
282
+ // A destroyHeld tenant is not sweep work: the daily retention run releases it once its last held row
283
+ // is gone, and the sweep then runs tenant-row as a fresh first attempt.
284
+ export const tenantDestructionHoldProvider = {
285
+ async isParked({ db, tenantId }) {
286
+ return (await tenantStatusOf(db, tenantId)) === "destroyHeld";
287
+ },
288
+ async releaseIfFree({ db, registry, tenantId, now }) {
289
+ if ((await tenantStatusOf(db, tenantId)) !== "destroyHeld")
290
+ return false;
291
+ if (await tenantOwnsRetentionHeldRows({ db, registry, tenantId, now }))
292
+ return false;
293
+ await setTenantLifecycleStatus(db, tenantId, "destroying");
294
+ return true;
295
+ },
296
+ };
297
+ async function tenantStatusOf(db, tenantId) {
298
+ const row = await fetchOne(db, tenantTable, { id: tenantId });
299
+ return row?.status;
300
+ }
229
301
  /** Cron entry: start destruction for tenants past grace, then advance stages. */
230
302
  export async function runTenantDestructionSweep(args) {
231
303
  const T = getTemporal();
@@ -267,6 +339,7 @@ export async function runTenantDestructionSweep(args) {
267
339
  try {
268
340
  const result = await runNextDestructionStage({
269
341
  deadlineAt: tenantDeadlineAt,
342
+ now,
270
343
  db: args.db,
271
344
  registry: args.registry,
272
345
  tenantId: row.id,
@@ -277,7 +350,7 @@ export async function runTenantDestructionSweep(args) {
277
350
  escapeHatchAuditLog: args.escapeHatchAuditLog,
278
351
  actor: args.actor,
279
352
  });
280
- if (!result.error && !result.halted)
353
+ if (!result.error && !result.halted && !result.held)
281
354
  advanced++;
282
355
  }
283
356
  catch (err) {
@@ -1,3 +1,4 @@
1
+ /// <reference types="temporal-polyfill/global" preserve="true" />
1
2
  import { type DbRunner } from "@cosmicdrift/kumiko-framework/db";
2
3
  import { type EscapeHatchAuditSink, type Registry, type TenantId } from "@cosmicdrift/kumiko-framework/engine";
3
4
  import type { FileProviderResolver } from "@cosmicdrift/kumiko-framework/files";
@@ -15,10 +16,12 @@ export type DestructionStageCtx = {
15
16
  readonly escapeHatchAuditLog?: Logger;
16
17
  readonly actor?: string;
17
18
  readonly deadlineAt: number;
19
+ readonly now: Temporal.Instant;
18
20
  };
19
21
  export type StageRunOutcome = {
20
22
  readonly done: boolean;
21
23
  readonly processed: number;
24
+ readonly pending?: boolean;
22
25
  };
23
26
  export type DestructionStage = {
24
27
  readonly name: TenantDestructionStageName;
@@ -1,3 +1,4 @@
1
+ /// <reference types="temporal-polyfill/global" preserve="true" />
1
2
  import { configuredPiiSubjectKms, subjectIdToKey, } from "@cosmicdrift/kumiko-framework/crypto";
2
3
  import { createEventStoreExecutor, createTenantDataDestroyDb, createTenantDb, selectMany, WritePurposes, } from "@cosmicdrift/kumiko-framework/db";
3
4
  import { createSystemUser, EXT_EXTERNAL_RESOURCE, EXT_INFRA_RESOURCE, EXT_SEARCH_ADAPTER, EXT_STORAGE_PROVIDER, EXT_TENANT_DATA, extensionUsageEscapeHatchReason, isTenantDataExtensionHooks, isTenantResourceExtensionHooks, } from "@cosmicdrift/kumiko-framework/engine";
@@ -5,6 +6,7 @@ import { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
5
6
  import { createEscapeHatchReporter, UNATTRIBUTED_ACTOR, } from "@cosmicdrift/kumiko-framework/pipeline";
6
7
  import { purgeSearchDocumentsForSubject, } from "@cosmicdrift/kumiko-framework/search";
7
8
  import { getTemporal } from "@cosmicdrift/kumiko-framework/time";
9
+ import { holdBlockDeleteRowsForDestruction, } from "../data-retention/index.js";
8
10
  import { tenantEntity, tenantMembershipEntity, tenantMembershipsTable, tenantTable, } from "../tenant/index.js";
9
11
  import { invalidateTenantLifecycleGate } from "./lifecycle-gate.js";
10
12
  const STAGE_DONE = { done: true, processed: 0 };
@@ -17,14 +19,17 @@ const tenantMembershipCrud = createEventStoreExecutor(tenantMembershipsTable, te
17
19
  // hooks time out with nothing processed until it finishes.
18
20
  function newOutcomeAccumulator() {
19
21
  let allDone = true;
22
+ let pending = false;
20
23
  let processed = 0;
21
24
  return {
22
25
  add: (result) => {
23
26
  if (result?.done === false)
24
27
  allDone = false;
28
+ if (result?.done === false && result.pending === true)
29
+ pending = true;
25
30
  processed += result?.processed ?? 0;
26
31
  },
27
- outcome: () => ({ done: allDone, processed }),
32
+ outcome: () => ({ done: allDone, processed, pending }),
28
33
  };
29
34
  }
30
35
  async function runExtensionDestroyHooks(registry, extensionName, ctx) {
@@ -38,13 +43,28 @@ async function runExtensionDestroyHooks(registry, extensionName, ctx) {
38
43
  }
39
44
  return total.outcome();
40
45
  }
41
- async function runTenantDataHooks(ctx) {
46
+ const NOTHING_HELD = { entityNames: new Set(), fileRefIds: new Set() };
47
+ async function runTenantDataHooks(ctx, phase) {
42
48
  const usages = ctx.registry.getExtensionUsages(EXT_TENANT_DATA);
43
49
  const total = newOutcomeAccumulator();
50
+ // Rows inside a blockDelete keepFor must outlive the account; their hook is skipped, the rows are
51
+ // anonymized and the fileRefs they point at are handed to the other hooks. Recomputed every tick.
52
+ const hold = phase === "app-data" && ctx.registry.features.has("data-retention")
53
+ ? await holdBlockDeleteRowsForDestruction({
54
+ db: ctx.db,
55
+ registry: ctx.registry,
56
+ tenantId: ctx.tenantId,
57
+ now: ctx.now,
58
+ })
59
+ : NOTHING_HELD;
44
60
  for (const usage of usages) {
45
61
  if (!isTenantDataExtensionHooks(usage.options)) {
46
62
  throw new Error(`${EXT_TENANT_DATA} registration for "${usage.entityName}" has no destroy function`);
47
63
  }
64
+ if ((usage.options["phase"] ?? "app-data") !== phase)
65
+ continue;
66
+ if (hold.entityNames.has(usage.entityName))
67
+ continue;
48
68
  const destroy = usage.options.destroy;
49
69
  const reason = extensionUsageEscapeHatchReason(usage);
50
70
  const report = createEscapeHatchReporter({
@@ -67,6 +87,7 @@ async function runTenantDataHooks(ctx) {
67
87
  tenantId: ctx.tenantId,
68
88
  deadlineAt: ctx.deadlineAt,
69
89
  fileProviderResolver: ctx.fileProviderResolver,
90
+ heldFileRefIds: hold.fileRefIds,
70
91
  log: ctx.log,
71
92
  };
72
93
  total.add(await destroy(hookCtx));
@@ -128,6 +149,9 @@ async function purgeTenantCache(ctx) {
128
149
  return STAGE_DONE;
129
150
  }
130
151
  async function tombstoneTenantRow(ctx) {
152
+ const lateHooks = await runTenantDataHooks(ctx, "tenant-row");
153
+ if (!lateHooks.done)
154
+ return lateHooks;
131
155
  const now = getTemporal().Now.instant();
132
156
  const user = createSystemUser(ctx.tenantId);
133
157
  const db = createTenantDb({
@@ -188,7 +212,7 @@ export const DESTRUCTION_STAGES = [
188
212
  {
189
213
  name: "app-data",
190
214
  maxAttempts: 3,
191
- run: runTenantDataHooks,
215
+ run: (ctx) => runTenantDataHooks(ctx, "app-data"),
192
216
  },
193
217
  {
194
218
  name: "subject-keys",
@@ -35,7 +35,7 @@ export async function driveDestructionToCompletion(stack, db, tenantId, searchAd
35
35
  });
36
36
  const rows = await selectMany(db, tenantTable, { id: tenantId });
37
37
  status = String(rows[0]?.["status"]);
38
- if (status === "destroyed" || status === "destroyFailed")
38
+ if (status === "destroyed" || status === "destroyFailed" || status === "destroyHeld")
39
39
  break;
40
40
  }
41
41
  return status;
@@ -0,0 +1,5 @@
1
+ /** Caps lookup for `TierResolverDeps.capsForTier`: an unknown tier name falls back to the default
2
+ * tier (least-privileged by convention), a name missing from the map is a wiring bug and throws. */
3
+ export declare function capsForTierFromMap<TTier extends string, TCaps>(tierMap: Readonly<Record<TTier, {
4
+ readonly caps: TCaps;
5
+ }>>, isTierName: (value: string) => value is TTier, defaultTier: TTier): (tier: string) => TCaps;
@@ -0,0 +1,12 @@
1
+ /** Caps lookup for `TierResolverDeps.capsForTier`: an unknown tier name falls back to the default
2
+ * tier (least-privileged by convention), a name missing from the map is a wiring bug and throws. */
3
+ export function capsForTierFromMap(tierMap, isTierName, defaultTier) {
4
+ return (tier) => {
5
+ const name = isTierName(tier) ? tier : defaultTier;
6
+ const def = tierMap[name];
7
+ if (!def) {
8
+ throw new Error(`tier-map: tier "${name}" not in tier map`);
9
+ }
10
+ return def.caps;
11
+ };
12
+ }