@cosmicdrift/kumiko-bundled-features 0.413.1 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (588) hide show
  1. package/dist/admin-shell/feature.js +2 -2
  2. package/dist/agent-tools/agent-doc-lint.js +2 -1
  3. package/dist/agent-tools/agent-manifest.js +33 -25
  4. package/dist/agent-tools/api-docs/collect-events.js +4 -1
  5. package/dist/agent-tools/api-docs/collect.js +3 -3
  6. package/dist/agent-tools/api-docs/generate.js +4 -1
  7. package/dist/agent-tools/api-docs/index.d.ts +1 -0
  8. package/dist/agent-tools/api-docs/index.js +1 -0
  9. package/dist/agent-tools/api-docs/problems.d.ts +21 -0
  10. package/dist/agent-tools/api-docs/problems.js +11 -1
  11. package/dist/agent-tools/api-docs/render-openapi.js +2 -0
  12. package/dist/agent-tools/api-docs/resolve-config.d.ts +9 -0
  13. package/dist/agent-tools/api-docs/resolve-config.js +11 -0
  14. package/dist/agent-tools/api-docs/scope-slug-collisions.d.ts +4 -0
  15. package/dist/agent-tools/api-docs/scope-slug-collisions.js +10 -0
  16. package/dist/agent-tools/api-docs/translation-gaps.d.ts +4 -0
  17. package/dist/agent-tools/api-docs/translation-gaps.js +29 -0
  18. package/dist/agent-tools/api-docs/webhook-example-problems.d.ts +6 -0
  19. package/dist/agent-tools/api-docs/webhook-example-problems.js +25 -0
  20. package/dist/agent-tools/index.d.ts +1 -1
  21. package/dist/agent-tools/index.js +1 -1
  22. package/dist/agent-tools/labels.d.ts +3 -2
  23. package/dist/agent-tools/labels.js +21 -4
  24. package/dist/agent-tools/tool-catalog.d.ts +5 -5
  25. package/dist/agent-tools/tool-catalog.js +12 -10
  26. package/dist/agent-tools/tool-dispatch.js +11 -1
  27. package/dist/agent-tools/types.d.ts +4 -0
  28. package/dist/audit/event-classification.js +6 -0
  29. package/dist/audit/web/i18n.js +1 -0
  30. package/dist/auth-email-password/errors.js +0 -13
  31. package/dist/auth-email-password/handlers/invite-signup-complete.write.js +101 -84
  32. package/dist/auth-email-password/handlers/login-options.query.js +1 -1
  33. package/dist/auth-email-password/handlers/request-account-unlock.write.js +1 -1
  34. package/dist/auth-email-password/handlers/request-email-verification.write.js +0 -1
  35. package/dist/auth-email-password/handlers/request-password-reset.write.js +0 -1
  36. package/dist/auth-email-password/handlers/self-registration-status.query.js +1 -1
  37. package/dist/auth-email-password/reset-token.js +0 -2
  38. package/dist/auth-email-password/seeding.js +34 -8
  39. package/dist/auth-email-password/unlock-token.js +0 -2
  40. package/dist/auth-email-password/verification-token.js +0 -2
  41. package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
  42. package/dist/auth-email-password/web/auth-gate.js +2 -2
  43. package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
  44. package/dist/auth-email-password/web/auth-redirect.js +4 -0
  45. package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
  46. package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
  47. package/dist/auth-email-password/web/return-path.d.ts +2 -1
  48. package/dist/auth-email-password/web/return-path.js +2 -1
  49. package/dist/auth-email-password/web/session.js +11 -12
  50. package/dist/auth-email-password/web/signup-screen.js +1 -5
  51. package/dist/auth-email-password/web/static-account.js +6 -2
  52. package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
  53. package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
  54. package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
  55. package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
  56. package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
  57. package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
  58. package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
  59. package/dist/auth-mfa-user-data/index.js +5 -6
  60. package/dist/billing-foundation/aggregate-id.js +0 -4
  61. package/dist/billing-foundation/checkout-core.js +8 -1
  62. package/dist/billing-foundation/checkout-ledger.d.ts +15 -0
  63. package/dist/billing-foundation/checkout-ledger.js +32 -0
  64. package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
  65. package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
  66. package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
  67. package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
  68. package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
  69. package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
  70. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
  71. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
  72. package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
  73. package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
  74. package/dist/billing-foundation/events.d.ts +22 -0
  75. package/dist/billing-foundation/events.js +38 -10
  76. package/dist/billing-foundation/feature.js +12 -1
  77. package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
  78. package/dist/billing-foundation/handlers/create-checkout-session.write.js +1 -1
  79. package/dist/billing-foundation/handlers/process-event.write.d.ts +2 -2
  80. package/dist/billing-foundation/handlers/process-event.write.js +94 -12
  81. package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
  82. package/dist/billing-foundation/handlers/process-payment-event.write.js +29 -9
  83. package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
  84. package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
  85. package/dist/billing-foundation/handlers/start-plan-checkout.write.js +1 -1
  86. package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
  87. package/dist/billing-foundation/i18n.js +3 -0
  88. package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
  89. package/dist/billing-foundation/pending-plan-switch.js +57 -0
  90. package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
  91. package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
  92. package/dist/billing-foundation/types.d.ts +40 -24
  93. package/dist/billing-foundation/validate-options.js +14 -0
  94. package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
  95. package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
  96. package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
  97. package/dist/billing-foundation/web/constants.d.ts +3 -0
  98. package/dist/billing-foundation/web/constants.js +5 -2
  99. package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
  100. package/dist/billing-foundation/webhook-handler.js +53 -11
  101. package/dist/cap-counter/aggregate-id.js +0 -2
  102. package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
  103. package/dist/cap-counter/stock-cap-guard.js +18 -4
  104. package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
  105. package/dist/cap-overview/i18n.js +1 -0
  106. package/dist/cap-overview/index.d.ts +1 -1
  107. package/dist/cap-overview/types.d.ts +4 -0
  108. package/dist/cap-overview/web/cap-cards-panel.js +6 -2
  109. package/dist/cap-overview/web/cap-usage-bar.js +6 -1
  110. package/dist/cap-overview/web/usage-math.d.ts +1 -0
  111. package/dist/cap-overview/web/usage-math.js +4 -0
  112. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
  113. package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
  114. package/dist/channel-whatsapp/aggregate-id.js +18 -0
  115. package/dist/channel-whatsapp/constants.d.ts +25 -0
  116. package/dist/channel-whatsapp/constants.js +36 -0
  117. package/dist/channel-whatsapp/events.d.ts +87 -0
  118. package/dist/channel-whatsapp/events.js +70 -0
  119. package/dist/channel-whatsapp/feature.d.ts +3 -0
  120. package/dist/channel-whatsapp/feature.js +56 -0
  121. package/dist/channel-whatsapp/graph-client.d.ts +85 -0
  122. package/dist/channel-whatsapp/graph-client.js +272 -0
  123. package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
  124. package/dist/channel-whatsapp/in-memory-meta.js +181 -0
  125. package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
  126. package/dist/channel-whatsapp/inbound-handlers.js +127 -0
  127. package/dist/channel-whatsapp/index.d.ts +10 -0
  128. package/dist/channel-whatsapp/index.js +10 -0
  129. package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
  130. package/dist/channel-whatsapp/meta-signature.js +19 -0
  131. package/dist/channel-whatsapp/options.d.ts +32 -0
  132. package/dist/channel-whatsapp/options.js +83 -0
  133. package/dist/channel-whatsapp/pii.d.ts +32 -0
  134. package/dist/channel-whatsapp/pii.js +61 -0
  135. package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
  136. package/dist/channel-whatsapp/webhook-normalize.js +185 -0
  137. package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
  138. package/dist/channel-whatsapp/webhook-routes.js +118 -0
  139. package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
  140. package/dist/config/handlers/set.write.js +7 -0
  141. package/dist/config/handlers/values.query.js +8 -1
  142. package/dist/config/index.d.ts +1 -1
  143. package/dist/config/index.js +1 -1
  144. package/dist/config/read-redaction.d.ts +1 -0
  145. package/dist/config/read-redaction.js +5 -2
  146. package/dist/config/table.js +1 -0
  147. package/dist/config/write-helpers.js +3 -2
  148. package/dist/crypto-shredding/constants.d.ts +1 -0
  149. package/dist/crypto-shredding/constants.js +1 -0
  150. package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
  151. package/dist/crypto-shredding/index.d.ts +1 -0
  152. package/dist/crypto-shredding/index.js +1 -0
  153. package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
  154. package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
  155. package/dist/custom-fields/aggregate-id.js +0 -1
  156. package/dist/custom-fields/entity.js +1 -0
  157. package/dist/custom-fields/wire-for-entity.js +0 -1
  158. package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
  159. package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
  160. package/dist/data-retention/feature.js +1 -5
  161. package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
  162. package/dist/data-retention/run-retention-cleanup.js +39 -19
  163. package/dist/data-retention/tenant-destruction-hold.js +7 -0
  164. package/dist/delivery/attempt-log-factory.d.ts +3 -0
  165. package/dist/delivery/attempt-log-factory.js +5 -0
  166. package/dist/delivery/attempt-log.d.ts +2 -2
  167. package/dist/delivery/channel-context.d.ts +1 -1
  168. package/dist/delivery/channel-context.js +5 -2
  169. package/dist/delivery/db/queries/preferences.js +0 -1
  170. package/dist/delivery/delivery-service.js +3 -0
  171. package/dist/delivery/feature.d.ts +1 -4
  172. package/dist/delivery/feature.js +3 -1
  173. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
  174. package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
  175. package/dist/delivery/handlers/opted-in-user-ids.query.js +41 -0
  176. package/dist/delivery/handlers/preferences.query.js +2 -20
  177. package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
  178. package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
  179. package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
  180. package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
  181. package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
  182. package/dist/delivery/index.d.ts +3 -1
  183. package/dist/delivery/index.js +1 -0
  184. package/dist/delivery/options.d.ts +4 -0
  185. package/dist/delivery/options.js +1 -0
  186. package/dist/delivery/preference-rows.d.ts +9 -0
  187. package/dist/delivery/preference-rows.js +22 -0
  188. package/dist/delivery/set-preference-enabled.d.ts +17 -0
  189. package/dist/delivery/set-preference-enabled.js +26 -0
  190. package/dist/delivery/tables.d.ts +2 -2
  191. package/dist/delivery/testing.d.ts +1 -1
  192. package/dist/delivery/testing.js +3 -1
  193. package/dist/delivery/types.d.ts +1 -0
  194. package/dist/delivery/unsubscribe-page.js +5 -1
  195. package/dist/delivery/upsert-preference.js +0 -1
  196. package/dist/delivery/web/public-names.d.ts +1 -0
  197. package/dist/delivery/web/public-names.js +1 -0
  198. package/dist/derivatives-sharp/render.js +9 -9
  199. package/dist/document-ingest-foundation/aggregate-id.js +0 -1
  200. package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
  201. package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
  202. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
  203. package/dist/document-ingest-foundation/report-ingest-progress.js +29 -13
  204. package/dist/documents/aggregate-id.js +0 -2
  205. package/dist/documents/constants.d.ts +6 -0
  206. package/dist/documents/constants.js +8 -2
  207. package/dist/documents/ensure-link.d.ts +5 -8
  208. package/dist/documents/ensure-link.js +4 -2
  209. package/dist/documents/feature.d.ts +3 -1
  210. package/dist/documents/feature.js +24 -5
  211. package/dist/documents/handlers/import.write.js +2 -2
  212. package/dist/documents/queries/expiry-overview.query.js +2 -1
  213. package/dist/documents/queries/for-record.query.js +3 -4
  214. package/dist/documents/queries/list-page.js +11 -3
  215. package/dist/documents/queries/overview.query.js +2 -2
  216. package/dist/documents/screens.js +3 -3
  217. package/dist/documents/tab.js +1 -1
  218. package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
  219. package/dist/feature-toggles/toggle-sync-signal.js +3 -2
  220. package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
  221. package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
  222. package/dist/file-foundation/probe.js +9 -3
  223. package/dist/file-foundation/read-file-ref-content.js +23 -11
  224. package/dist/file-provider-inmemory/feature.js +1 -1
  225. package/dist/file-provider-s3/env-feature.js +1 -1
  226. package/dist/file-provider-s3/env-named-feature.js +1 -1
  227. package/dist/file-provider-s3/env-schema.d.ts +10 -1
  228. package/dist/file-provider-s3/env-schema.js +20 -7
  229. package/dist/file-provider-s3/feature.js +1 -1
  230. package/dist/file-provider-s3/index.d.ts +1 -1
  231. package/dist/file-provider-s3/index.js +1 -1
  232. package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
  233. package/dist/file-provider-s3/lib/env-helper.js +13 -12
  234. package/dist/file-provider-s3/lib/s3-provider.js +10 -2
  235. package/dist/folders/aggregate-id.js +0 -1
  236. package/dist/folders/web/folder-manager.js +1 -1
  237. package/dist/folders-user-data/index.js +12 -14
  238. package/dist/helpdesk/entity.js +4 -1
  239. package/dist/helpdesk/feature.js +36 -0
  240. package/dist/helpdesk/handlers/access.d.ts +0 -1
  241. package/dist/helpdesk/handlers/access.js +0 -3
  242. package/dist/helpdesk/handlers/attempts.js +7 -13
  243. package/dist/helpdesk/handlers/challenge.query.js +1 -2
  244. package/dist/helpdesk/handlers/reply.write.js +4 -5
  245. package/dist/helpdesk/handlers/report.write.js +3 -7
  246. package/dist/helpdesk/handlers/submit.write.js +4 -9
  247. package/dist/helpdesk/index.d.ts +1 -1
  248. package/dist/helpdesk/index.js +1 -1
  249. package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
  250. package/dist/helpdesk/legacy-contact-config.js +57 -0
  251. package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
  252. package/dist/helpdesk/legacy-contact-erasure.js +19 -0
  253. package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
  254. package/dist/helpdesk/legacy-contact-retention.js +53 -0
  255. package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
  256. package/dist/helpdesk/legacy-contact-streams.js +121 -0
  257. package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
  258. package/dist/helpdesk/legacy-contact-user-data.js +62 -0
  259. package/dist/helpdesk/lib.d.ts +7 -1
  260. package/dist/helpdesk/lib.js +29 -29
  261. package/dist/helpdesk/user-data-hooks.d.ts +10 -1
  262. package/dist/helpdesk/user-data-hooks.js +47 -36
  263. package/dist/helpdesk/web/constants.d.ts +0 -1
  264. package/dist/helpdesk/web/constants.js +0 -1
  265. package/dist/inbound-mail-foundation/account-health.js +1 -1
  266. package/dist/inbound-mail-foundation/account-poll.js +1 -1
  267. package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
  268. package/dist/inbound-mail-foundation/constants.d.ts +6 -0
  269. package/dist/inbound-mail-foundation/constants.js +6 -0
  270. package/dist/inbound-mail-foundation/content-refetch.d.ts +1 -0
  271. package/dist/inbound-mail-foundation/content-refetch.js +15 -1
  272. package/dist/inbound-mail-foundation/entities.js +57 -15
  273. package/dist/inbound-mail-foundation/events.js +15 -16
  274. package/dist/inbound-mail-foundation/feature.js +3 -1
  275. package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
  276. package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
  277. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
  278. package/dist/inbound-mail-foundation/handlers/connect-account.write.js +12 -7
  279. package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
  280. package/dist/inbound-mail-foundation/handlers/forget-message.write.js +54 -0
  281. package/dist/inbound-mail-foundation/i18n.js +3 -0
  282. package/dist/inbound-mail-foundation/index.d.ts +1 -0
  283. package/dist/inbound-mail-foundation/index.js +1 -0
  284. package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
  285. package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
  286. package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
  287. package/dist/inbound-mail-foundation/personal-address.js +16 -0
  288. package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
  289. package/dist/inbound-mail-foundation/purge-messages.js +33 -0
  290. package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
  291. package/dist/inbound-mail-foundation/quarantine.js +9 -5
  292. package/dist/inbound-mail-foundation/retention-job.js +1 -5
  293. package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
  294. package/dist/inbound-mail-foundation/send-from-account.js +9 -1
  295. package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
  296. package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
  297. package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
  298. package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
  299. package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
  300. package/dist/inbound-provider-imap/byte-budget.js +53 -0
  301. package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
  302. package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
  303. package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
  304. package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
  305. package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
  306. package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
  307. package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
  308. package/dist/inbound-provider-imap/download-batch.js +21 -6
  309. package/dist/inbound-provider-imap/feature.js +7 -4
  310. package/dist/inbound-provider-imap/fetch-content.js +35 -30
  311. package/dist/inbound-provider-imap/i18n.js +2 -2
  312. package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
  313. package/dist/inbound-provider-imap/parse-message.js +8 -0
  314. package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
  315. package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
  316. package/dist/inbound-provider-imap/send-mail.js +32 -6
  317. package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
  318. package/dist/inbound-provider-imap/smtp-client.js +15 -3
  319. package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
  320. package/dist/inbound-provider-inmemory/feature.js +1 -1
  321. package/dist/jobs/events.d.ts +13 -0
  322. package/dist/jobs/events.js +8 -0
  323. package/dist/jobs/feature.js +2 -0
  324. package/dist/jobs/handlers/consumer.write.js +31 -20
  325. package/dist/jobs/web/constants.d.ts +3 -0
  326. package/dist/jobs/web/constants.js +3 -0
  327. package/dist/mail-transport-inmemory/feature.js +1 -1
  328. package/dist/mail-transport-smtp/feature.js +3 -2
  329. package/dist/managed-pages/handlers/branding.query.js +1 -1
  330. package/dist/managed-pages/handlers/by-slug.query.js +1 -1
  331. package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
  332. package/dist/managed-pages/render-page-body.d.ts +2 -0
  333. package/dist/managed-pages/render-page-body.js +12 -8
  334. package/dist/managed-pages/screens/page-screens.d.ts +3 -2
  335. package/dist/managed-pages/screens/page-screens.js +14 -33
  336. package/dist/managed-pages/table.js +1 -0
  337. package/dist/managed-pages/web/client-plugin.js +8 -6
  338. package/dist/managed-pages/web/constants.d.ts +5 -1
  339. package/dist/managed-pages/web/constants.js +6 -1
  340. package/dist/managed-pages/web/i18n.js +11 -3
  341. package/dist/managed-pages/web/markdown-to-document.js +1 -1
  342. package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
  343. package/dist/managed-pages/web/page-edit-draft.js +76 -0
  344. package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
  345. package/dist/managed-pages/web/page-edit-screen.js +106 -0
  346. package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
  347. package/dist/managed-pages/web/page-settings-rail.js +14 -0
  348. package/dist/notes-history-user-data/index.js +8 -14
  349. package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
  350. package/dist/personal-access-tokens/boot-rules.js +5 -0
  351. package/dist/personal-access-tokens/handlers/create.write.js +0 -1
  352. package/dist/personal-access-tokens/scope-events-check.js +26 -6
  353. package/dist/presence/handlers/list.query.js +18 -8
  354. package/dist/presence/room.d.ts +2 -0
  355. package/dist/presence/room.js +8 -5
  356. package/dist/presence/store.d.ts +2 -0
  357. package/dist/presence/store.js +62 -26
  358. package/dist/readiness/handlers/latest-summary.query.js +10 -6
  359. package/dist/readiness/handlers/run-probes.write.js +24 -4
  360. package/dist/readiness/handlers/run-tone.js +3 -2
  361. package/dist/readiness/handlers/status.query.js +11 -3
  362. package/dist/readiness/probe-context.js +7 -10
  363. package/dist/readiness/screens.js +4 -4
  364. package/dist/readiness/visible-results.d.ts +1 -1
  365. package/dist/readiness/visible-results.js +5 -2
  366. package/dist/renderer-foundation/api.js +6 -12
  367. package/dist/renderer-foundation/types.d.ts +2 -2
  368. package/dist/secrets/db/queries/read.d.ts +2 -1
  369. package/dist/secrets/db/queries/read.js +10 -1
  370. package/dist/secrets/handlers/list.query.js +4 -2
  371. package/dist/secrets/secret-scope.d.ts +0 -1
  372. package/dist/secrets/secret-scope.js +2 -2
  373. package/dist/secrets/secrets-context.js +4 -4
  374. package/dist/secrets/table.d.ts +1 -1
  375. package/dist/secrets/write-gate.js +4 -2
  376. package/dist/seo/handlers/seo-config.query.js +1 -1
  377. package/dist/shared/acknowledged-system-db.d.ts +5 -0
  378. package/dist/shared/acknowledged-system-db.js +9 -0
  379. package/dist/shared/assert-billing-live.d.ts +1 -0
  380. package/dist/shared/assert-billing-live.js +5 -2
  381. package/dist/shared/index.d.ts +6 -2
  382. package/dist/shared/index.js +6 -2
  383. package/dist/shared/parent-visibility.d.ts +1 -0
  384. package/dist/shared/parent-visibility.js +16 -1
  385. package/dist/shared/password-hashing.js +0 -1
  386. package/dist/shared/price-env-shape.js +1 -1
  387. package/dist/shared/register-user-data-hooks.d.ts +11 -0
  388. package/dist/shared/register-user-data-hooks.js +11 -0
  389. package/dist/shared/require-bootstrap-extension.d.ts +9 -0
  390. package/dist/shared/require-bootstrap-extension.js +16 -0
  391. package/dist/shared/send-best-effort.d.ts +2 -0
  392. package/dist/shared/send-best-effort.js +14 -0
  393. package/dist/shared/stream-tenant-backfill.d.ts +1 -0
  394. package/dist/shared/stream-tenant-backfill.js +17 -1
  395. package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
  396. package/dist/shared/stream-tenant-derived-state.js +19 -2
  397. package/dist/step-dispatcher/constants.d.ts +4 -0
  398. package/dist/step-dispatcher/constants.js +11 -0
  399. package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
  400. package/dist/step-dispatcher/deliver-dispatch-request.js +38 -2
  401. package/dist/step-dispatcher/feature.js +20 -2
  402. package/dist/step-dispatcher/mail-runner.js +0 -1
  403. package/dist/step-dispatcher/sweep-abandoned.d.ts +10 -0
  404. package/dist/step-dispatcher/sweep-abandoned.js +43 -0
  405. package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
  406. package/dist/subscription-mollie/plugin-methods.js +1 -2
  407. package/dist/subscription-mollie/verify-webhook.js +5 -5
  408. package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
  409. package/dist/subscription-paddle/backfill-checkout-ledger.js +110 -0
  410. package/dist/subscription-paddle/checkout-config.query.js +1 -1
  411. package/dist/subscription-paddle/checkout-methods.js +2 -8
  412. package/dist/subscription-paddle/constants.d.ts +0 -1
  413. package/dist/subscription-paddle/constants.js +1 -2
  414. package/dist/subscription-paddle/feature.d.ts +0 -4
  415. package/dist/subscription-paddle/feature.js +21 -20
  416. package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
  417. package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
  418. package/dist/subscription-paddle/plan-switch-methods.js +2 -8
  419. package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
  420. package/dist/subscription-paddle/redeliver-legacy-checkout.js +26 -0
  421. package/dist/subscription-paddle/runtime.d.ts +3 -5
  422. package/dist/subscription-paddle/runtime.js +4 -7
  423. package/dist/subscription-paddle/subscription-state.d.ts +1 -0
  424. package/dist/subscription-paddle/subscription-state.js +1 -0
  425. package/dist/subscription-paddle/webhook-events.d.ts +4 -0
  426. package/dist/subscription-paddle/webhook-events.js +40 -22
  427. package/dist/subscription-stripe/feature.d.ts +4 -0
  428. package/dist/subscription-stripe/feature.js +1 -0
  429. package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
  430. package/dist/subscription-stripe/plugin-methods.js +2 -5
  431. package/dist/subscription-stripe/runtime.d.ts +2 -1
  432. package/dist/subscription-stripe/runtime.js +5 -7
  433. package/dist/subscription-stripe/verify-webhook.js +21 -6
  434. package/dist/tags/aggregate-id.js +0 -1
  435. package/dist/tags/web/tag-chip.js +0 -1
  436. package/dist/tags/web/tag-manager.js +3 -1
  437. package/dist/template-resolver/api.js +6 -12
  438. package/dist/template-resolver/document-sanitizer.d.ts +1 -1
  439. package/dist/template-resolver/document-sanitizer.js +18 -0
  440. package/dist/template-resolver/feature.d.ts +1 -0
  441. package/dist/template-resolver/feature.js +2 -0
  442. package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
  443. package/dist/template-resolver/handlers/body-preview.query.js +41 -0
  444. package/dist/template-resolver/handlers/by-slug.query.js +1 -1
  445. package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
  446. package/dist/template-resolver/handlers/collection-shared.js +5 -8
  447. package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
  448. package/dist/template-resolver/handlers/overview.query.js +2 -1
  449. package/dist/template-resolver/handlers/send-test.write.js +27 -8
  450. package/dist/template-resolver/linked-resources.js +2 -6
  451. package/dist/template-resolver/seeding.js +67 -1
  452. package/dist/template-resolver/table.js +1 -0
  453. package/dist/template-resolver/template-draft.js +2 -1
  454. package/dist/template-resolver/template-preview.js +12 -3
  455. package/dist/template-resolver/testing.js +0 -2
  456. package/dist/template-resolver/web/client-plugin.js +3 -0
  457. package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
  458. package/dist/template-resolver/web/constants.d.ts +2 -0
  459. package/dist/template-resolver/web/constants.js +2 -0
  460. package/dist/template-resolver/web/content-tree-provider.js +0 -1
  461. package/dist/template-resolver/web/content-workbench.d.ts +22 -0
  462. package/dist/template-resolver/web/content-workbench.js +32 -0
  463. package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
  464. package/dist/template-resolver/web/document-insert-model.js +1 -2
  465. package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
  466. package/dist/template-resolver/web/document-link-policy.js +53 -0
  467. package/dist/template-resolver/web/document-schema.d.ts +2 -4
  468. package/dist/template-resolver/web/document-schema.js +2 -53
  469. package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
  470. package/dist/template-resolver/web/document-tiptap-context.js +2 -2
  471. package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
  472. package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
  473. package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
  474. package/dist/template-resolver/web/editor-handle.js +1 -0
  475. package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
  476. package/dist/template-resolver/web/fill-document-variables.js +22 -0
  477. package/dist/template-resolver/web/i18n.js +10 -0
  478. package/dist/template-resolver/web/index.d.ts +3 -0
  479. package/dist/template-resolver/web/index.js +2 -0
  480. package/dist/template-resolver/web/preview-targets.d.ts +5 -0
  481. package/dist/template-resolver/web/preview-targets.js +21 -0
  482. package/dist/template-resolver/web/qualified-names.d.ts +1 -0
  483. package/dist/template-resolver/web/qualified-names.js +1 -0
  484. package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
  485. package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
  486. package/dist/template-resolver/web/string-values.d.ts +1 -0
  487. package/dist/template-resolver/web/string-values.js +8 -0
  488. package/dist/template-resolver/web/text-block-editor.js +18 -11
  489. package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
  490. package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
  491. package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
  492. package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
  493. package/dist/template-resolver/web/use-text-block-editor.js +26 -5
  494. package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
  495. package/dist/template-resolver/web/web-preview-renderer.js +41 -0
  496. package/dist/template-resolver-user-data/index.js +11 -10
  497. package/dist/tenant/handlers/create.write.js +3 -7
  498. package/dist/tenant/handlers/list.query.js +3 -8
  499. package/dist/tenant/handlers/member-directory.query.js +10 -5
  500. package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
  501. package/dist/tenant/invited-membership.js +9 -1
  502. package/dist/tenant/seeding.d.ts +3 -0
  503. package/dist/tenant/seeding.js +3 -1
  504. package/dist/tenant/stream-tenant-backfill.js +5 -1
  505. package/dist/tenant/testing.js +1 -1
  506. package/dist/tenant-inactivity/check-inactive-tenants.js +5 -5
  507. package/dist/tenant-inactivity/constants.js +1 -2
  508. package/dist/tenant-inactivity/handlers/keep-account.write.js +1 -2
  509. package/dist/tenant-inactivity/state-store.d.ts +1 -0
  510. package/dist/tenant-inactivity/state-store.js +9 -1
  511. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  512. package/dist/tenant-lifecycle/constants.js +3 -0
  513. package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
  514. package/dist/tenant-lifecycle/stages.js +14 -2
  515. package/dist/tier-engine/aggregate-id.js +0 -1
  516. package/dist/tier-engine/feature.js +9 -2
  517. package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
  518. package/dist/user/handlers/me.query.js +4 -1
  519. package/dist/user/index.d.ts +1 -0
  520. package/dist/user/index.js +1 -0
  521. package/dist/user/resolve-verified-user-email.d.ts +2 -0
  522. package/dist/user/resolve-verified-user-email.js +14 -0
  523. package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
  524. package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
  525. package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
  526. package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
  527. package/dist/user-data-rights/run-export-jobs.js +0 -2
  528. package/dist/user-data-rights/run-forget-cleanup.js +2 -2
  529. package/dist/user-data-rights/schema/download-attempt.js +3 -2
  530. package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
  531. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  532. package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
  533. package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
  534. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
  535. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
  536. package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
  537. package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
  538. package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
  539. package/dist/user-profile/handlers/change-email.write.js +0 -1
  540. package/dist/waitlist/handlers/submit.write.js +5 -18
  541. package/dist/waitlist/lib.js +2 -7
  542. package/dist/waitlist/user-data-hooks.js +6 -20
  543. package/dist/workflow-runner/aggregate-id.js +0 -1
  544. package/dist/workflow-runner/event-trigger.js +6 -2
  545. package/dist/workflow-runner/feature.js +1 -5
  546. package/dist/workflow-runner/handlers/resume-run.write.js +4 -3
  547. package/dist/workflow-runner/runner.d.ts +1 -0
  548. package/package.json +35 -11
  549. package/src/admin-shell/changes.json +6 -0
  550. package/src/agent-tools/changes.json +12 -0
  551. package/src/auth-email-password/changes.json +18 -0
  552. package/src/billing-foundation/changes.json +37 -0
  553. package/src/cap-counter/changes.json +6 -0
  554. package/src/cap-overview/changes.json +6 -0
  555. package/src/channel-in-app/changes.json +6 -0
  556. package/src/channel-whatsapp/changes.json +8 -0
  557. package/src/config/changes.json +12 -0
  558. package/src/crypto-shredding/changes.json +18 -0
  559. package/src/data-retention/changes.json +12 -0
  560. package/src/delivery/changes.json +6 -0
  561. package/src/documents/changes.json +18 -0
  562. package/src/file-provider-s3/changes.json +14 -0
  563. package/src/files/changes.json +7 -0
  564. package/src/helpdesk/changes.json +50 -0
  565. package/src/inbound-mail-foundation/changes.json +48 -0
  566. package/src/inbound-provider-imap/changes.json +13 -0
  567. package/src/mail-foundation/changes.json +6 -0
  568. package/src/managed-pages/changes.json +12 -0
  569. package/src/presence/changes.json +6 -0
  570. package/src/readiness/changes.json +25 -0
  571. package/src/secrets/changes.json +7 -0
  572. package/src/shared/changes.json +6 -0
  573. package/src/step-dispatcher/changes.json +12 -0
  574. package/src/subscription-mollie/changes.json +7 -0
  575. package/src/subscription-paddle/changes.json +13 -0
  576. package/src/subscription-stripe/changes.json +7 -0
  577. package/src/template-resolver/changes.json +36 -0
  578. package/src/tenant/changes.json +6 -0
  579. package/src/tenant-lifecycle/changes.json +18 -0
  580. package/src/tier-engine/changes.json +6 -0
  581. package/src/user/changes.json +6 -0
  582. package/src/waitlist/changes.json +6 -0
  583. package/dist/managed-pages/web/page-body-section.d.ts +0 -3
  584. package/dist/managed-pages/web/page-body-section.js +0 -40
  585. package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
  586. package/dist/subscription-paddle/tenant-binding.js +0 -26
  587. package/dist/template-resolver/web/content-field.d.ts +0 -9
  588. package/dist/template-resolver/web/content-field.js +0 -14
@@ -0,0 +1,11 @@
1
+ import type { SignatureExtraRouteDeps } from "@cosmicdrift/kumiko-framework/api";
2
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
3
+ import { hasLegacyTenantBinding } from "./webhook-events.ts";
4
+ type IgnoredEvent = Parameters<typeof hasLegacyTenantBinding>[0];
5
+ export declare function shouldRedeliverLegacyCheckout(args: {
6
+ readonly event: IgnoredEvent;
7
+ readonly reason: string;
8
+ readonly deps: SignatureExtraRouteDeps;
9
+ readonly now?: () => Temporal.Instant;
10
+ }): Promise<boolean>;
11
+ export {};
@@ -0,0 +1,26 @@
1
+ // While the takeover window of the checkout-ledger backfill is open, a Paddle event of a legacy
2
+ // checkout (custom_data still has the tenantBinding) that billing-foundation ignored as
3
+ // "not in the ledger" may only be waiting for the next sweep. Answering it with a retryable
4
+ // 5xx makes Paddle deliver it again once the sweep has ledgered the checkout.
5
+ import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
6
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
7
+ import { isTakeoverWindowOver } from "./backfill-checkout-ledger.js";
8
+ import { LEDGER_BACKFILL_MARKER_HANDLER_QN, } from "./ledger-backfill-marker.js";
9
+ import { hasLegacyTenantBinding } from "./webhook-events.js";
10
+ export async function shouldRedeliverLegacyCheckout(args) {
11
+ if (!hasLegacyTenantBinding(args.event))
12
+ return false;
13
+ const marker = await args.deps.dispatchWriteAs({
14
+ handlerQn: LEDGER_BACKFILL_MARKER_HANDLER_QN,
15
+ tenantId: SYSTEM_TENANT_ID,
16
+ roles: [],
17
+ payload: { markCompleted: false },
18
+ });
19
+ // Cannot tell whether the sweep is still open: err towards redelivery, Paddle retries a bounded number of times.
20
+ if (!marker.isSuccess)
21
+ return true;
22
+ const { completedAt } = marker.data; // @cast-boundary engine-payload
23
+ if (completedAt === null)
24
+ return true;
25
+ return !isTakeoverWindowOver(completedAt, (args.now ?? Temporal.Now.instant)());
26
+ }
@@ -7,28 +7,26 @@ export type PaddlePluginMethod<TName extends keyof SubscriptionProviderPlugin> =
7
7
  export type PaddleFallbacks = {
8
8
  readonly apiKey?: string;
9
9
  readonly webhookSecret?: string;
10
- readonly tenantBindingKey?: string;
11
10
  readonly clientToken?: string;
12
11
  };
13
12
  export type PaddleRuntimeDeps = {
14
13
  readonly apiKeyHandle: ConfigKeyHandle<"text">;
15
14
  readonly webhookSecretHandle: ConfigKeyHandle<"text">;
16
- readonly tenantBindingKeyHandle: ConfigKeyHandle<"text">;
17
15
  readonly clientTokenHandle: ConfigKeyHandle<"text">;
18
16
  readonly billingLiveHandle: ConfigKeyHandle<"boolean">;
19
17
  readonly environmentHandle: ConfigKeyHandle<"select">;
20
18
  readonly send: PaddleSend;
21
19
  readonly fallback: PaddleFallbacks;
22
20
  };
21
+ export type PaddleCallSource = Pick<HandlerContext, "config" | "services" | "user">;
23
22
  export type PaddleCtxRuntime = {
24
- readonly call: (ctx: HandlerContext, request: PaddleRequest) => Promise<unknown>;
23
+ readonly call: (ctx: PaddleCallSource, request: PaddleRequest) => Promise<unknown>;
24
+ readonly hasApiKey: (ctx: PaddleCallSource) => Promise<boolean>;
25
25
  readonly assertBillingLive: (ctx: HandlerContext, handlerName?: string) => Promise<void>;
26
26
  readonly isBillingEnabled: (ctx: HandlerContext) => Promise<boolean>;
27
- readonly tenantBindingKey: (ctx: HandlerContext) => Promise<string>;
28
27
  };
29
28
  export type PaddleWebhookRuntime = {
30
29
  readonly resolveWebhookSecret: (systemSecrets?: SecretsContext) => Promise<string>;
31
- readonly resolveTenantBindingKey: (systemSecrets?: SecretsContext) => Promise<string>;
32
30
  };
33
31
  export type PaddleCheckoutConfig = {
34
32
  readonly clientToken: string | null;
@@ -10,7 +10,7 @@ import { parseStoredSecret, } from "@cosmicdrift/kumiko-bundled-features/billing
10
10
  import { requireSecretsContext } from "@cosmicdrift/kumiko-bundled-features/secrets";
11
11
  import { SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
12
12
  import { UnconfiguredError } from "@cosmicdrift/kumiko-framework/errors";
13
- import { assertBillingLive } from "../shared/index.js";
13
+ import { assertBillingLive, isBillingLive } from "../shared/index.js";
14
14
  import { createPaddleHttp } from "./client.js";
15
15
  import { PADDLE_BASE_URLS, PaddleEnvironments, SUBSCRIPTION_PADDLE_FEATURE, } from "./constants.js";
16
16
  function hintFor(shortName) {
@@ -68,19 +68,16 @@ export function createPaddleRuntimes(deps) {
68
68
  baseUrl: await baseUrlFor(ctx),
69
69
  apiKey: await ctxSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey, "api-key"),
70
70
  }, request),
71
+ hasApiKey: (ctx) => hasSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey),
71
72
  assertBillingLive: (ctx, handlerName = "create-checkout-session") => assertBillingLive(ctx, deps.billingLiveHandle, SUBSCRIPTION_PADDLE_FEATURE, handlerName),
72
73
  isBillingEnabled: async (ctx) => {
73
- const live = ctx.config ? await ctx.config(deps.billingLiveHandle) : undefined;
74
- if (live !== true)
74
+ if (!(await isBillingLive(ctx, deps.billingLiveHandle)))
75
75
  return false;
76
- return ((await hasSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey)) &&
77
- (await hasSecret(ctx, deps.tenantBindingKeyHandle, deps.fallback.tenantBindingKey)));
76
+ return hasSecret(ctx, deps.apiKeyHandle, deps.fallback.apiKey);
78
77
  },
79
- tenantBindingKey: (ctx) => ctxSecret(ctx, deps.tenantBindingKeyHandle, deps.fallback.tenantBindingKey, "tenant-binding-key"),
80
78
  },
81
79
  webhook: {
82
80
  resolveWebhookSecret: (systemSecrets) => webhookSecret(systemSecrets, deps.webhookSecretHandle, deps.fallback.webhookSecret),
83
- resolveTenantBindingKey: (systemSecrets) => webhookSecret(systemSecrets, deps.tenantBindingKeyHandle, deps.fallback.tenantBindingKey),
84
81
  },
85
82
  readCheckoutConfig: async (ctx) => {
86
83
  const stored = ctx.config ? await ctx.config(deps.clientTokenHandle) : undefined;
@@ -5,6 +5,7 @@ export declare const paddleSubscriptionSchema: z.ZodObject<{
5
5
  id: z.ZodString;
6
6
  status: z.ZodString;
7
7
  customer_id: z.ZodString;
8
+ transaction_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
8
9
  items: z.ZodArray<z.ZodObject<{
9
10
  price: z.ZodObject<{
10
11
  id: z.ZodString;
@@ -16,6 +16,7 @@ export const paddleSubscriptionSchema = z.object({
16
16
  id: z.string().min(1),
17
17
  status: z.string(),
18
18
  customer_id: z.string().min(1),
19
+ transaction_id: z.string().min(1).nullish(),
19
20
  items: z.array(z.object({
20
21
  price: z.object({ id: z.string().min(1) }),
21
22
  quantity: z.number().int().positive().optional(),
@@ -3,7 +3,11 @@ import type { SecretsContext } from "@cosmicdrift/kumiko-framework/secrets";
3
3
  import type { PaddleWebhookRuntime } from "./runtime.ts";
4
4
  export type PaddleWebhookOptions = {
5
5
  readonly priceToTier: Readonly<Record<string, string>>;
6
+ /** Prices a one-off payment may credit; Paddle.js lets a browser open checkouts with any customData. */
7
+ readonly oneOffPriceIds: readonly string[];
6
8
  /** Test seam: Unix seconds. Defaults to the wall clock. */
7
9
  readonly nowSeconds?: () => number;
8
10
  };
11
+ export declare function tenantIdOf(customData: Readonly<Record<string, unknown>> | null | undefined): string | undefined;
12
+ export declare function hasLegacyTenantBinding(event: SubscriptionEvent | PaymentEvent): boolean;
9
13
  export declare function verifyAndParsePaddleWebhook(runtime: PaddleWebhookRuntime, options: PaddleWebhookOptions): (rawBody: string, headers: Record<string, string>, systemSecrets?: SecretsContext) => Promise<SubscriptionEvent | PaymentEvent | null>;
@@ -1,14 +1,15 @@
1
1
  // Paddle webhook: signature check, then mapping of Paddle's event envelope onto
2
- // the foundation's normalized events. Events without a valid tenant binding are
3
- // dropped (200 ignored): see tenant-binding.ts.
2
+ // the foundation's normalized events. `custom_data.tenantId` only locates the
3
+ // tenant's stream; Paddle.js can open checkouts with any customData, so
4
+ // billing-foundation accepts an event only for a checkout in its own ledger.
4
5
  import { BillingEventKinds, SubscriptionEventTypes, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
5
6
  import { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
6
7
  import { parseJsonOrThrow } from "@cosmicdrift/kumiko-framework/utils";
7
8
  import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
9
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
8
10
  import * as z from "zod";
9
11
  import { PADDLE_PROVIDER_NAME } from "./constants.js";
10
12
  import { mapPaddleSubscriptionState, paddleCustomDataSchema, paddleSubscriptionSchema, } from "./subscription-state.js";
11
- import { boundTenantOf } from "./tenant-binding.js";
12
13
  import { verifyPaddleSignature } from "./verify-webhook.js";
13
14
  const PADDLE_SUBSCRIPTION_EVENT_TYPES = {
14
15
  "subscription.created": SubscriptionEventTypes.created,
@@ -40,7 +41,11 @@ const paddleTransactionSchema = z.object({
40
41
  function currentUnixSeconds() {
41
42
  return Math.floor(Temporal.Now.instant().epochMilliseconds / 1000);
42
43
  }
43
- function parsePaymentEvent(providerEventId, data, bindingKey) {
44
+ export function tenantIdOf(customData) {
45
+ const tenantId = customData?.["tenantId"];
46
+ return typeof tenantId === "string" && tenantId.length > 0 ? tenantId : undefined;
47
+ }
48
+ function parsePaymentEvent(providerEventId, data, oneOffPriceIds) {
44
49
  const parsed = paddleTransactionSchema.safeParse(data);
45
50
  if (!parsed.success)
46
51
  return null;
@@ -50,15 +55,18 @@ function parsePaymentEvent(providerEventId, data, bindingKey) {
50
55
  return null;
51
56
  const priceId = transaction.items[0]?.price.id;
52
57
  const quantity = transaction.items[0]?.quantity ?? 1;
53
- const bound = boundTenantOf(transaction.custom_data, bindingKey);
54
- if (!bound || !priceId || !transaction.customer_id)
58
+ const tenantId = tenantIdOf(transaction.custom_data);
59
+ if (!tenantId || !priceId || !transaction.customer_id)
60
+ return null;
61
+ if (!oneOffPriceIds.includes(priceId)) {
62
+ createFallbackLogger("subscription-paddle").warn("paddle one-off transaction dropped: price is not an allowed one-off price", { providerEventId, priceId });
55
63
  return null;
64
+ }
56
65
  return {
57
66
  kind: BillingEventKinds.payment,
58
67
  providerEventId,
59
68
  providerName: PADDLE_PROVIDER_NAME,
60
- tenantId: bound.tenantId,
61
- ...(bound.consentId !== undefined && { consentId: bound.consentId }),
69
+ tenantId,
62
70
  providerCheckoutId: transaction.id,
63
71
  providerCustomerId: transaction.customer_id,
64
72
  priceId,
@@ -74,51 +82,61 @@ function warnOnUnexpectedQuantity(providerEventId, items) {
74
82
  }
75
83
  }
76
84
  }
77
- function parseSubscriptionEvent(providerEventId, type, providerEventAt, data, options) {
85
+ function parseSubscriptionEvent(providerEventId, type, providerEventAt, data, priceToTier) {
78
86
  const parsed = paddleSubscriptionSchema.safeParse(data);
79
87
  if (!parsed.success)
80
88
  return null;
81
89
  const sub = parsed.data;
82
- const bound = boundTenantOf(sub.custom_data, options.bindingKey);
83
- const state = mapPaddleSubscriptionState(sub, options.priceToTier);
84
- if (!bound || !state)
90
+ const tenantId = tenantIdOf(sub.custom_data);
91
+ const state = mapPaddleSubscriptionState(sub, priceToTier);
92
+ if (!tenantId || !state)
85
93
  return null;
86
94
  warnOnUnexpectedQuantity(providerEventId, sub.items);
87
95
  return {
88
96
  providerEventId,
89
97
  providerName: PADDLE_PROVIDER_NAME,
90
98
  type,
91
- tenantId: bound.tenantId,
92
- ...(bound.consentId !== undefined && { consentId: bound.consentId }),
99
+ tenantId,
100
+ ...(sub.transaction_id && { providerCheckoutId: sub.transaction_id }),
93
101
  providerCustomerId: sub.customer_id,
94
102
  providerSubscriptionId: sub.id,
95
103
  providerEventAt,
96
104
  ...state,
97
105
  };
98
106
  }
107
+ // Events whose custom_data still carries the pre-ledger tenantBinding: they belong to a checkout
108
+ // the backfill sweep may not have ledgered yet. Kept beside the event, not on it, because
109
+ // billing-foundation must not know about the legacy binding.
110
+ const legacyBindingEvents = new WeakSet();
111
+ export function hasLegacyTenantBinding(event) {
112
+ return legacyBindingEvents.has(event);
113
+ }
114
+ function markLegacyBinding(event, data) {
115
+ if (event !== null &&
116
+ typeof propertyOf(propertyOf(data, "custom_data"), "tenantBinding") === "string") {
117
+ legacyBindingEvents.add(event);
118
+ }
119
+ return event;
120
+ }
99
121
  export function verifyAndParsePaddleWebhook(runtime, options) {
100
122
  const nowSeconds = options.nowSeconds ?? currentUnixSeconds;
101
123
  return async (rawBody, headers, systemSecrets) => {
102
124
  const secret = await runtime.resolveWebhookSecret(systemSecrets);
103
125
  verifyPaddleSignature(rawBody, headers, secret, nowSeconds());
104
- // After verification only: an unauthenticated request must not trigger a second secret read.
105
- const bindingKey = await runtime.resolveTenantBindingKey(systemSecrets);
106
126
  // Past verification the body is trusted to be Paddle's; a malformed shape is
107
127
  // schema drift, so it is dropped (200 ignored) instead of answered with a 401.
108
128
  const envelope = envelopeSchema.safeParse(parseJsonOrThrow(rawBody, "subscription-paddle webhook body"));
109
129
  if (!envelope.success)
110
130
  return null;
111
131
  const { event_id: providerEventId, event_type: type, occurred_at, data } = envelope.data;
112
- if (type === TRANSACTION_COMPLETED)
113
- return parsePaymentEvent(providerEventId, data, bindingKey);
132
+ if (type === TRANSACTION_COMPLETED) {
133
+ return markLegacyBinding(parsePaymentEvent(providerEventId, data, options.oneOffPriceIds), data);
134
+ }
114
135
  if (!Object.hasOwn(PADDLE_SUBSCRIPTION_EVENT_TYPES, type))
115
136
  return null;
116
137
  const normalizedType = PADDLE_SUBSCRIPTION_EVENT_TYPES[type];
117
138
  if (!normalizedType)
118
139
  return null;
119
- return parseSubscriptionEvent(providerEventId, normalizedType, occurred_at, data, {
120
- priceToTier: options.priceToTier,
121
- bindingKey,
122
- });
140
+ return markLegacyBinding(parseSubscriptionEvent(providerEventId, normalizedType, occurred_at, data, options.priceToTier), data);
123
141
  };
124
142
  }
@@ -1,5 +1,6 @@
1
1
  import { type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import { type FeatureWithEnvSchema } from "@cosmicdrift/kumiko-framework/env";
3
+ import type Stripe from "stripe";
3
4
  import * as z from "zod";
4
5
  /**
5
6
  * Env-vars contract for the `subscription-stripe` feature — now a **bridge
@@ -51,6 +52,9 @@ export type SubscriptionStripeOptions = {
51
52
  * explicit allowlist every one-off checkout is closed, the same
52
53
  * fail-closed default `priceToTier` has for mode:"subscription". */
53
54
  readonly oneOffPriceIds?: readonly string[];
55
+ /** Stripe SDK client config (host, protocol, retries) — lets tests point the
56
+ * client at a local fixture API. */
57
+ readonly clientConfig?: Stripe.StripeConfig;
54
58
  };
55
59
  /**
56
60
  * Factory for the subscription-stripe feature. Always mounts (no
@@ -151,6 +151,7 @@ export function createSubscriptionStripeFeature(options = {}) {
151
151
  ...(options.apiKey !== undefined && { apiKey: options.apiKey }),
152
152
  ...(options.webhookSecret !== undefined && { webhookSecret: options.webhookSecret }),
153
153
  },
154
+ ...(options.clientConfig !== undefined && { clientConfig: options.clientConfig }),
154
155
  });
155
156
  const priceCache = createStripePriceCache();
156
157
  const portalConfigurationCache = new Map();
@@ -11,6 +11,7 @@ export type StripeCheckoutSessionRuntimeOptions = {
11
11
  export declare function mapAppLocaleToStripeLocale(locale: string): Stripe.Checkout.SessionCreateParams.Locale;
12
12
  export declare function createStripeCheckoutSession(runtime: StripeCtxRuntime, { paymentInvoiceCreation }?: StripeCheckoutSessionRuntimeOptions): (ctx: HandlerContext, options: StripeCheckoutOptions) => Promise<{
13
13
  url: string;
14
+ providerCheckoutId: string;
14
15
  }>;
15
16
  export type StripePortalOptions = Parameters<NonNullable<SubscriptionProviderPlugin["createPortalSession"]>>[1];
16
17
  export declare function createStripePortalSession(runtime: StripeCtxRuntime): (ctx: HandlerContext, options: StripePortalOptions) => Promise<{
@@ -87,10 +87,7 @@ export function createStripeCheckoutSession(runtime, { paymentInvoiceCreation =
87
87
  await runtime.assertBillingLive(ctx);
88
88
  const stripe = await runtime.clientForCtx(ctx);
89
89
  const mode = options.mode ?? "subscription";
90
- const metadata = {
91
- tenantId: options.tenantId,
92
- ...(options.consentId && { consentId: options.consentId }),
93
- };
90
+ const metadata = { tenantId: options.tenantId };
94
91
  const sessionParams = (providerCustomerId) => ({
95
92
  mode,
96
93
  line_items: [{ price: options.priceId, quantity: 1 }],
@@ -139,7 +136,7 @@ export function createStripeCheckoutSession(runtime, { paymentInvoiceCreation =
139
136
  // guards against future API drift.
140
137
  throw new Error("subscription-stripe: checkout.sessions.create returned no url");
141
138
  }
142
- return { url: session.url };
139
+ return { url: session.url, providerCheckoutId: session.id };
143
140
  };
144
141
  }
145
142
  export function createStripePortalSession(runtime) {
@@ -4,7 +4,7 @@ import Stripe from "stripe";
4
4
  /** Memoize Stripe clients by api-key string — a fresh client is built only
5
5
  * when the key actually changes (rotation), so steady-state calls reuse one
6
6
  * connection-pooled instance per key. */
7
- export declare function createStripeClientCache(): (apiKey: string) => Stripe;
7
+ export declare function createStripeClientCache(clientConfig?: Stripe.StripeConfig): (apiKey: string) => Stripe;
8
8
  export type StripeRuntimeDeps = {
9
9
  readonly apiKeyHandle: ConfigKeyHandle<"text">;
10
10
  readonly webhookSecretHandle: ConfigKeyHandle<"text">;
@@ -13,6 +13,7 @@ export type StripeRuntimeDeps = {
13
13
  readonly apiKey?: string;
14
14
  readonly webhookSecret?: string;
15
15
  };
16
+ readonly clientConfig?: Stripe.StripeConfig;
16
17
  };
17
18
  /** Post-tenant runtime: used by checkout/portal/cancel which carry a full
18
19
  * HandlerContext (audited secret reads, config-gate). */
@@ -29,13 +29,13 @@ import { requireSecretsContext } from "@cosmicdrift/kumiko-bundled-features/secr
29
29
  import { SYSTEM_TENANT_ID, } from "@cosmicdrift/kumiko-framework/engine";
30
30
  import { UnconfiguredError } from "@cosmicdrift/kumiko-framework/errors";
31
31
  import Stripe from "stripe";
32
- import { assertBillingLive } from "../shared/index.js";
32
+ import { assertBillingLive, isBillingLive } from "../shared/index.js";
33
33
  import { SUBSCRIPTION_STRIPE_FEATURE } from "./constants.js";
34
34
  const API_KEY_HINT = "Set the Stripe API key via config:write:set on `subscription-stripe:config:api-key` (or seed it from STRIPE_API_KEY during the env bridge).";
35
35
  /** Memoize Stripe clients by api-key string — a fresh client is built only
36
36
  * when the key actually changes (rotation), so steady-state calls reuse one
37
37
  * connection-pooled instance per key. */
38
- export function createStripeClientCache() {
38
+ export function createStripeClientCache(clientConfig) {
39
39
  const cache = new Map();
40
40
  return (apiKey) => {
41
41
  const cached = cache.get(apiKey);
@@ -43,13 +43,13 @@ export function createStripeClientCache() {
43
43
  return cached;
44
44
  // No apiVersion pin — a string literal breaks consumers' typecheck on newer
45
45
  // stripe SDKs; the SDK's own default keeps wire-version and types aligned.
46
- const client = new Stripe(apiKey);
46
+ const client = new Stripe(apiKey, clientConfig);
47
47
  cache.set(apiKey, client);
48
48
  return client;
49
49
  };
50
50
  }
51
51
  export function createStripeRuntimes(deps) {
52
- const clientFor = createStripeClientCache();
52
+ const clientFor = createStripeClientCache(deps.clientConfig);
53
53
  async function ctxApiKey(ctx) {
54
54
  let key;
55
55
  if (ctx.services.secrets) {
@@ -81,12 +81,10 @@ export function createStripeRuntimes(deps) {
81
81
  }
82
82
  return {
83
83
  ctx: {
84
- // @wrapper-known semantic-alias
85
84
  clientForCtx: async (ctx) => clientFor(await ctxApiKey(ctx)),
86
85
  assertBillingLive: (ctx, handlerName = "create-checkout-session") => assertBillingLive(ctx, deps.billingLiveHandle, SUBSCRIPTION_STRIPE_FEATURE, handlerName),
87
86
  isBillingEnabled: async (ctx) => {
88
- const live = ctx.config ? await ctx.config(deps.billingLiveHandle) : undefined;
89
- if (live !== true)
87
+ if (!(await isBillingLive(ctx, deps.billingLiveHandle)))
90
88
  return false;
91
89
  const hasFallbackKey = deps.fallback.apiKey !== undefined && deps.fallback.apiKey.length > 0;
92
90
  if (hasFallbackKey)
@@ -30,7 +30,7 @@
30
30
  // status/tier/period-end mapping. resource_missing (deleted between webhook
31
31
  // and retrieval) returns null; any other Stripe error becomes 503 so Stripe
32
32
  // redelivers.
33
- import { BillingEventKinds, parseProviderConsentId, SubscriptionEventTypes, SubscriptionStatuses, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
33
+ import { BillingEventKinds, SubscriptionEventTypes, SubscriptionStatuses, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
34
34
  import { ExtraRouteRejection } from "@cosmicdrift/kumiko-framework/api";
35
35
  import { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
36
36
  import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
@@ -114,13 +114,16 @@ export function verifyAndParseStripeWebhook(runtime, options) {
114
114
  if (!state) {
115
115
  return null;
116
116
  }
117
- const consentId = parseProviderConsentId(sub.metadata?.["consentId"]);
117
+ // Only the checkout ledger can vouch for a new subscription, so `created` must name its session.
118
+ const providerCheckoutId = normalizedType === SubscriptionEventTypes.created
119
+ ? await findCheckoutSessionId(stripe, sub.id)
120
+ : undefined;
118
121
  return {
119
122
  providerEventId: event.id,
120
123
  providerName: STRIPE_PROVIDER_NAME,
121
124
  type: normalizedType,
122
125
  tenantId,
123
- ...(consentId !== undefined && { consentId }),
126
+ ...(providerCheckoutId !== undefined && { providerCheckoutId }),
124
127
  providerCustomerId: typeof sub.customer === "string" ? sub.customer : sub.customer.id,
125
128
  providerSubscriptionId: sub.id,
126
129
  providerEventAt: Temporal.Instant.fromEpochMilliseconds(event.created * 1000).toString(),
@@ -128,6 +131,21 @@ export function verifyAndParseStripeWebhook(runtime, options) {
128
131
  };
129
132
  };
130
133
  }
134
+ // Only a failing Stripe API call is answered with 503 so Stripe redelivers. A successful empty
135
+ // list means the subscription has no checkout session: the created event then carries no
136
+ // checkout id and the foundation ignores it as not in the ledger.
137
+ async function findCheckoutSessionId(stripe, subscriptionId) {
138
+ try {
139
+ const sessions = await stripe.checkout.sessions.list({
140
+ subscription: subscriptionId,
141
+ limit: 1,
142
+ });
143
+ return sessions.data[0]?.id;
144
+ }
145
+ catch (error) {
146
+ throw transientProviderRejection(error);
147
+ }
148
+ }
131
149
  /** Maps a Stripe subscription's price/status/period-end/cancel_at onto the
132
150
  * foundation's normalized shape. Null when the subscription's price isn't
133
151
  * in `priceToTier` (the app owner created the Stripe price but never
@@ -216,7 +234,6 @@ export function mapStripeStatus(stripeStatus) {
216
234
  /** Gets the subscription from the event. Subscription events include it
217
235
  * directly in data.object; invoice events include only the subscription ID
218
236
  * and require a lazy fetch via stripe.subscriptions.retrieve. */
219
- // @wrapper-known semantic-alias
220
237
  async function extractSubscriptionFromEvent(event, stripe) {
221
238
  switch (event.type) {
222
239
  case StripeEventTypes.customerSubscriptionCreated:
@@ -327,13 +344,11 @@ async function parsePaymentEvent(event, stripe) {
327
344
  if (!providerCustomerId) {
328
345
  return dropPaidSession(event, session, "missing_customer");
329
346
  }
330
- const consentId = parseProviderConsentId(paymentIntent.metadata?.["consentId"]);
331
347
  return {
332
348
  kind: BillingEventKinds.payment,
333
349
  providerEventId: event.id,
334
350
  providerName: STRIPE_PROVIDER_NAME,
335
351
  tenantId,
336
- ...(consentId !== undefined && { consentId }),
337
352
  providerCheckoutId: session.id,
338
353
  providerCustomerId,
339
354
  priceId,
@@ -10,7 +10,6 @@ const TAG_ASSIGNMENT_NAMESPACE = "a7f3c9d2-1b4e-4c8a-9f6d-2e5b8a1c3f7d";
10
10
  * stream → version_conflict instead of a duplicate row. The assign handler
11
11
  * pre-checks existence to keep re-assign idempotent (TX-safe).
12
12
  */
13
- // @wrapper-known uuid-domain
14
13
  export function tagAssignmentAggregateId(tenantId, tagId, entityType, entityId) {
15
14
  return uuidv5(`${tenantId}|${tagId}|${entityType}|${entityId}`, TAG_ASSIGNMENT_NAMESPACE);
16
15
  }
@@ -25,7 +25,6 @@ function hexToRgb(color) {
25
25
  b: Number.parseInt(hex.slice(4, 6), 16),
26
26
  };
27
27
  }
28
- // kumiko-lint-ignore no-inline-styles Tag color is user-defined (hex from the DB), no finite token palette possible
29
28
  const BASE_STYLE = {
30
29
  display: "inline-flex",
31
30
  alignItems: "center",
@@ -31,7 +31,9 @@ const PRESET_COLORS = [
31
31
  ];
32
32
  function ColorPicker({ value, onChange, idPrefix, }) {
33
33
  const { Input } = usePrimitives();
34
- return (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("div", { className: "flex flex-wrap gap-1", children: PRESET_COLORS.map((c) => (_jsx("button", { type: "button", "aria-label": c, "data-testid": `${idPrefix}-swatch-${c}`, onClick: () => onChange(c), style: {
34
+ return (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("div", { className: "flex flex-wrap gap-1", children: PRESET_COLORS.map((c) => (_jsx("button", { type: "button", "aria-label": c, "data-testid": `${idPrefix}-swatch-${c}`, onClick: () => onChange(c),
35
+ // biome-ignore lint/style/noInlineStyles: Preset swatch color is user-defined (hex), no finite token palette possible
36
+ style: {
35
37
  width: 22,
36
38
  height: 22,
37
39
  borderRadius: 4,
@@ -2,7 +2,7 @@
2
2
  // delivery and apps import types ONLY and take the implementation from
3
3
  // ctx.templateResolver at runtime.
4
4
  import { selectMany } from "@cosmicdrift/kumiko-framework/db";
5
- import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
5
+ import { requireBootstrapExtension } from "../shared/index.js";
6
6
  import { fileAttachmentsOf, imageLinksOf, parseLinkedResourceEntries, pdfAttachmentLinksOf, } from "./linked-resources.js";
7
7
  import { templateResourcesTable } from "./table.js";
8
8
  import { deliveryPolicyOf, isRowServed, isServedByCollectionOnly, } from "./template-delivery-policy.js";
@@ -183,15 +183,9 @@ export class TemplateNotFoundError extends Error {
183
183
  // Single source of truth for "this handler requires template-resolver".
184
184
  // Pattern symmetric with requireTextContent.
185
185
  export function requireTemplateResolver(ctx, callerName) {
186
- // @cast-boundary engine-bridge — templateResolver kommt per extraContext
187
- // from App-Bootstrap and lands in services.extensions; the framework does not know its type.
188
- const api = ctx.services.extensions["templateResolver"];
189
- if (!api) {
190
- throw new InternalError({
191
- message: `[${callerName}] ctx.templateResolver missing — App-Bootstrap muss ` +
192
- `extraContext: { templateResolver: createTemplateResolverApi(db, registry) } setzen ` +
193
- `(siehe template-resolver/README.md).`,
194
- });
195
- }
196
- return api;
186
+ return requireBootstrapExtension(ctx, callerName, {
187
+ key: "templateResolver",
188
+ bootstrapExample: "templateResolver: createTemplateResolverApi(db, registry)",
189
+ readme: "template-resolver/README.md",
190
+ });
197
191
  }
@@ -2,7 +2,7 @@ import type { FieldIssue } from "@cosmicdrift/kumiko-framework/errors";
2
2
  import type { JSONContent } from "@tiptap/core";
3
3
  import { type Element as ScanElement } from "happy-dom";
4
4
  import type { ContentFormat } from "./web/constants.ts";
5
- export type DocumentViolationCode = "script_element" | "event_handler_attribute" | "disallowed_link_href" | "external_image_source" | "image_without_resource" | "invalid_reference_name" | "embedded_content" | "unsafe_attribute_value" | "images_block_pdf_only" | "button_href_not_placeholder" | "document_requires_html_format" | "layout_requires_mjml_format" | "layout_invalid_structure" | "layout_missing_content_slot" | "layout_source_system_only";
5
+ export type DocumentViolationCode = "script_element" | "event_handler_attribute" | "disallowed_link_href" | "relative_link_without_base" | "external_image_source" | "image_without_resource" | "invalid_reference_name" | "embedded_content" | "unsafe_attribute_value" | "images_block_pdf_only" | "button_href_not_placeholder" | "document_requires_html_format" | "layout_requires_mjml_format" | "layout_invalid_structure" | "layout_missing_content_slot" | "layout_source_system_only";
6
6
  export type DocumentViolation = {
7
7
  readonly code: DocumentViolationCode;
8
8
  readonly detail: string;
@@ -202,6 +202,18 @@ function imagesBlockViolation(input) {
202
202
  ? violation("images_block_pdf_only", input.kind, `Record images blocks are only allowed in templates of kind ${IMAGES_BLOCK_KIND}`)
203
203
  : null;
204
204
  }
205
+ // Mails and PDFs have no base address, so compileDocumentBody turns a relative href into "#"; refuse it
206
+ // on save instead of losing the admin's input silently. Managed pages resolve it against their host.
207
+ function relativeLinkViolations(html) {
208
+ return withParsedDocument(html, (body) => Array.from(body.querySelectorAll("a[href]")).flatMap((anchor) => {
209
+ const href = anchor.getAttribute("href") ?? "";
210
+ return isAllowedDocumentLinkHref(href) && !isAllowedDocumentUrlHref(href)
211
+ ? [
212
+ violation("relative_link_without_base", href, `Link target "${href}" is relative, but mails and PDF documents have no base address; use an absolute https link`),
213
+ ]
214
+ : [];
215
+ }));
216
+ }
205
217
  export function sanitizeTemplateBody(input) {
206
218
  const formatViolation = requiredFormatViolation(input.kind, input.contentFormat);
207
219
  if (formatViolation !== null)
@@ -212,6 +224,11 @@ export function sanitizeTemplateBody(input) {
212
224
  if (!isSanitizedBody(input) || input.contentFormat !== "html" || input.content === null) {
213
225
  return { ok: true, content: input.content };
214
226
  }
227
+ if (HTML_ONLY_KINDS.has(input.kind)) {
228
+ const relativeLinks = relativeLinkViolations(input.content);
229
+ if (relativeLinks.length > 0)
230
+ return { ok: false, violations: relativeLinks };
231
+ }
215
232
  const result = sanitizeDocumentHtml(input.content);
216
233
  return result.ok ? { ok: true, content: result.html } : result;
217
234
  }
@@ -219,6 +236,7 @@ const VIOLATION_I18N_KEYS = {
219
236
  script_element: "templateResolver.errors.document.scriptElement",
220
237
  event_handler_attribute: "templateResolver.errors.document.eventHandlerAttribute",
221
238
  disallowed_link_href: "templateResolver.errors.document.disallowedLinkHref",
239
+ relative_link_without_base: "templateResolver.errors.document.relativeLinkWithoutBase",
222
240
  external_image_source: "templateResolver.errors.document.externalImageSource",
223
241
  image_without_resource: "templateResolver.errors.document.imageWithoutResource",
224
242
  invalid_reference_name: "templateResolver.errors.document.invalidReferenceName",
@@ -55,6 +55,7 @@ export declare function createTemplateResolverFeature(opts?: TemplateResolverOpt
55
55
  diffToSystem: import("@cosmicdrift/kumiko-types/handlers").HandlerRef;
56
56
  validate: import("@cosmicdrift/kumiko-types/handlers").HandlerRef;
57
57
  preview: import("@cosmicdrift/kumiko-types/handlers").HandlerRef;
58
+ bodyPreview: import("@cosmicdrift/kumiko-types/handlers").HandlerRef;
58
59
  documentBlocks: import("@cosmicdrift/kumiko-types/handlers").HandlerRef;
59
60
  exportBundle: import("@cosmicdrift/kumiko-types/handlers").HandlerRef;
60
61
  sendTestStatus: import("@cosmicdrift/kumiko-types/handlers").HandlerRef;
@@ -1,5 +1,6 @@
1
1
  import { bootRuleError, createSystemConfig, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import { TEMPLATE_RESOLVER_BOOT_RULES } from "./boot-rules.js";
3
+ import { makeBodyPreviewQuery } from "./handlers/body-preview.query.js";
3
4
  import { bySlugQuery } from "./handlers/by-slug.query.js";
4
5
  import { byTenantQuery } from "./handlers/by-tenant.query.js";
5
6
  import { makeCollectionItemQuery } from "./handlers/collection-item.query.js";
@@ -151,6 +152,7 @@ export function createTemplateResolverFeature(opts = {}) {
151
152
  diffToSystem: r.queryHandler(diffToSystemQuery),
152
153
  validate: r.queryHandler(validateQuery),
153
154
  preview: r.queryHandler(previewQuery),
155
+ bodyPreview: r.queryHandler(makeBodyPreviewQuery(policy)),
154
156
  documentBlocks: r.queryHandler(documentBlocksQuery),
155
157
  exportBundle: r.queryHandler(exportBundleQuery),
156
158
  sendTestStatus: r.queryHandler(makeSendTestStatusQuery(policy)),
@@ -0,0 +1,11 @@
1
+ import * as z from "zod";
2
+ import { type TemplateEditPolicy } from "../template-edit-policy.ts";
3
+ export declare function makeBodyPreviewQuery(policy: TemplateEditPolicy): import("@cosmicdrift/kumiko-types/define-handler").QueryHandlerDefinition<"body-preview", z.ZodObject<{
4
+ body: z.ZodNullable<z.ZodString>;
5
+ bodyFormat: z.ZodDefault<z.ZodEnum<{
6
+ document: "document";
7
+ markdown: "markdown";
8
+ }>>;
9
+ }, z.core.$strip>, {
10
+ html: string;
11
+ }, import("@cosmicdrift/kumiko-types/event-type-map").KumikoEventTypeMap>;