@cosmicdrift/kumiko-bundled-features 0.413.1 → 0.415.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin-shell/feature.js +2 -2
- package/dist/agent-tools/agent-doc-lint.js +2 -1
- package/dist/agent-tools/agent-manifest.js +33 -25
- package/dist/agent-tools/api-docs/collect-events.js +4 -1
- package/dist/agent-tools/api-docs/collect.js +3 -3
- package/dist/agent-tools/api-docs/generate.js +4 -1
- package/dist/agent-tools/api-docs/index.d.ts +1 -0
- package/dist/agent-tools/api-docs/index.js +1 -0
- package/dist/agent-tools/api-docs/problems.d.ts +21 -0
- package/dist/agent-tools/api-docs/problems.js +11 -1
- package/dist/agent-tools/api-docs/render-openapi.js +2 -0
- package/dist/agent-tools/api-docs/resolve-config.d.ts +9 -0
- package/dist/agent-tools/api-docs/resolve-config.js +11 -0
- package/dist/agent-tools/api-docs/scope-slug-collisions.d.ts +4 -0
- package/dist/agent-tools/api-docs/scope-slug-collisions.js +10 -0
- package/dist/agent-tools/api-docs/translation-gaps.d.ts +4 -0
- package/dist/agent-tools/api-docs/translation-gaps.js +29 -0
- package/dist/agent-tools/api-docs/webhook-example-problems.d.ts +6 -0
- package/dist/agent-tools/api-docs/webhook-example-problems.js +25 -0
- package/dist/agent-tools/index.d.ts +1 -1
- package/dist/agent-tools/index.js +1 -1
- package/dist/agent-tools/labels.d.ts +3 -2
- package/dist/agent-tools/labels.js +21 -4
- package/dist/agent-tools/tool-catalog.d.ts +5 -5
- package/dist/agent-tools/tool-catalog.js +12 -10
- package/dist/agent-tools/tool-dispatch.js +11 -1
- package/dist/agent-tools/types.d.ts +4 -0
- package/dist/audit/event-classification.js +6 -0
- package/dist/audit/web/i18n.js +1 -0
- package/dist/auth-email-password/errors.js +0 -13
- package/dist/auth-email-password/handlers/invite-signup-complete.write.js +101 -84
- package/dist/auth-email-password/handlers/login-options.query.js +1 -1
- package/dist/auth-email-password/handlers/request-account-unlock.write.js +1 -1
- package/dist/auth-email-password/handlers/request-email-verification.write.js +0 -1
- package/dist/auth-email-password/handlers/request-password-reset.write.js +0 -1
- package/dist/auth-email-password/handlers/self-registration-status.query.js +1 -1
- package/dist/auth-email-password/reset-token.js +0 -2
- package/dist/auth-email-password/seeding.js +34 -8
- package/dist/auth-email-password/signup-token-store.d.ts +2 -2
- package/dist/auth-email-password/signup-token-store.js +2 -4
- package/dist/auth-email-password/unlock-token.js +0 -2
- package/dist/auth-email-password/verification-token.js +0 -2
- package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
- package/dist/auth-email-password/web/auth-gate.js +2 -2
- package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
- package/dist/auth-email-password/web/auth-redirect.js +4 -0
- package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
- package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
- package/dist/auth-email-password/web/return-path.d.ts +2 -1
- package/dist/auth-email-password/web/return-path.js +2 -1
- package/dist/auth-email-password/web/session.js +13 -13
- package/dist/auth-email-password/web/signup-screen.js +1 -5
- package/dist/auth-email-password/web/static-account.js +6 -2
- package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
- package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
- package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
- package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
- package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
- package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
- package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
- package/dist/auth-mfa-user-data/index.js +5 -6
- package/dist/billing-foundation/aggregate-id.js +0 -4
- package/dist/billing-foundation/checkout-core.d.ts +2 -0
- package/dist/billing-foundation/checkout-core.js +17 -1
- package/dist/billing-foundation/checkout-ledger.d.ts +22 -0
- package/dist/billing-foundation/checkout-ledger.js +38 -0
- package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
- package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
- package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
- package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
- package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
- package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
- package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
- package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
- package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
- package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
- package/dist/billing-foundation/events.d.ts +23 -0
- package/dist/billing-foundation/events.js +39 -10
- package/dist/billing-foundation/feature.js +12 -1
- package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
- package/dist/billing-foundation/handlers/create-checkout-session.write.js +3 -2
- package/dist/billing-foundation/handlers/process-event.write.d.ts +4 -2
- package/dist/billing-foundation/handlers/process-event.write.js +132 -25
- package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
- package/dist/billing-foundation/handlers/process-payment-event.write.js +31 -11
- package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
- package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
- package/dist/billing-foundation/handlers/start-plan-checkout.write.js +3 -2
- package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
- package/dist/billing-foundation/i18n.js +3 -0
- package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
- package/dist/billing-foundation/pending-plan-switch.js +57 -0
- package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
- package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
- package/dist/billing-foundation/types.d.ts +40 -24
- package/dist/billing-foundation/validate-options.js +14 -0
- package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
- package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
- package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
- package/dist/billing-foundation/web/constants.d.ts +3 -0
- package/dist/billing-foundation/web/constants.js +5 -2
- package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
- package/dist/billing-foundation/webhook-handler.js +53 -11
- package/dist/cap-counter/aggregate-id.js +0 -2
- package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
- package/dist/cap-counter/stock-cap-guard.js +18 -4
- package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
- package/dist/cap-overview/i18n.js +1 -0
- package/dist/cap-overview/index.d.ts +1 -1
- package/dist/cap-overview/types.d.ts +4 -0
- package/dist/cap-overview/web/cap-cards-panel.js +6 -2
- package/dist/cap-overview/web/cap-usage-bar.js +6 -1
- package/dist/cap-overview/web/usage-math.d.ts +1 -0
- package/dist/cap-overview/web/usage-math.js +4 -0
- package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
- package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
- package/dist/channel-whatsapp/aggregate-id.js +18 -0
- package/dist/channel-whatsapp/constants.d.ts +25 -0
- package/dist/channel-whatsapp/constants.js +36 -0
- package/dist/channel-whatsapp/events.d.ts +90 -0
- package/dist/channel-whatsapp/events.js +71 -0
- package/dist/channel-whatsapp/feature.d.ts +3 -0
- package/dist/channel-whatsapp/feature.js +56 -0
- package/dist/channel-whatsapp/graph-client.d.ts +85 -0
- package/dist/channel-whatsapp/graph-client.js +272 -0
- package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
- package/dist/channel-whatsapp/in-memory-meta.js +181 -0
- package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
- package/dist/channel-whatsapp/inbound-handlers.js +148 -0
- package/dist/channel-whatsapp/index.d.ts +10 -0
- package/dist/channel-whatsapp/index.js +10 -0
- package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
- package/dist/channel-whatsapp/meta-signature.js +19 -0
- package/dist/channel-whatsapp/options.d.ts +32 -0
- package/dist/channel-whatsapp/options.js +83 -0
- package/dist/channel-whatsapp/pii.d.ts +32 -0
- package/dist/channel-whatsapp/pii.js +61 -0
- package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
- package/dist/channel-whatsapp/webhook-normalize.js +200 -0
- package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
- package/dist/channel-whatsapp/webhook-routes.js +118 -0
- package/dist/compliance-profiles/handlers/set-profile.write.js +2 -0
- package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
- package/dist/config/handlers/set.write.js +7 -0
- package/dist/config/handlers/values.query.js +8 -1
- package/dist/config/index.d.ts +1 -1
- package/dist/config/index.js +1 -1
- package/dist/config/read-redaction.d.ts +1 -0
- package/dist/config/read-redaction.js +5 -2
- package/dist/config/table.js +1 -0
- package/dist/config/write-helpers.js +3 -2
- package/dist/crypto-shredding/constants.d.ts +1 -0
- package/dist/crypto-shredding/constants.js +1 -0
- package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
- package/dist/crypto-shredding/index.d.ts +1 -0
- package/dist/crypto-shredding/index.js +1 -0
- package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
- package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
- package/dist/custom-fields/aggregate-id.js +0 -1
- package/dist/custom-fields/entity.js +1 -0
- package/dist/custom-fields/wire-for-entity.js +0 -1
- package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
- package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
- package/dist/data-retention/feature.js +2 -5
- package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
- package/dist/data-retention/run-retention-cleanup.js +39 -19
- package/dist/data-retention/tenant-destruction-hold.js +7 -0
- package/dist/delivery/attempt-log-factory.d.ts +3 -0
- package/dist/delivery/attempt-log-factory.js +5 -0
- package/dist/delivery/attempt-log.d.ts +2 -2
- package/dist/delivery/channel-context.d.ts +1 -1
- package/dist/delivery/channel-context.js +5 -2
- package/dist/delivery/db/queries/preferences.js +0 -1
- package/dist/delivery/delivery-service.js +3 -0
- package/dist/delivery/feature.d.ts +1 -4
- package/dist/delivery/feature.js +3 -1
- package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
- package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
- package/dist/delivery/handlers/opted-in-user-ids.query.js +50 -0
- package/dist/delivery/handlers/preferences.query.js +2 -20
- package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
- package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
- package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
- package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
- package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
- package/dist/delivery/index.d.ts +3 -1
- package/dist/delivery/index.js +1 -0
- package/dist/delivery/options.d.ts +4 -0
- package/dist/delivery/options.js +1 -0
- package/dist/delivery/preference-rows.d.ts +9 -0
- package/dist/delivery/preference-rows.js +22 -0
- package/dist/delivery/set-preference-enabled.d.ts +17 -0
- package/dist/delivery/set-preference-enabled.js +26 -0
- package/dist/delivery/tables.d.ts +2 -2
- package/dist/delivery/testing.d.ts +1 -1
- package/dist/delivery/testing.js +3 -1
- package/dist/delivery/types.d.ts +1 -0
- package/dist/delivery/unsubscribe-page.js +5 -1
- package/dist/delivery/upsert-preference.js +0 -1
- package/dist/delivery/web/public-names.d.ts +1 -0
- package/dist/delivery/web/public-names.js +1 -0
- package/dist/derivatives-sharp/render.js +9 -9
- package/dist/document-ingest-foundation/aggregate-id.js +0 -1
- package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
- package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
- package/dist/document-ingest-foundation/feature.js +1 -0
- package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
- package/dist/document-ingest-foundation/report-ingest-progress.js +32 -13
- package/dist/documents/aggregate-id.js +0 -2
- package/dist/documents/constants.d.ts +6 -0
- package/dist/documents/constants.js +8 -2
- package/dist/documents/ensure-link.d.ts +5 -8
- package/dist/documents/ensure-link.js +4 -2
- package/dist/documents/feature.d.ts +3 -1
- package/dist/documents/feature.js +29 -5
- package/dist/documents/handlers/import.write.js +2 -2
- package/dist/documents/queries/expiry-overview.query.js +2 -1
- package/dist/documents/queries/for-record.query.js +3 -4
- package/dist/documents/queries/list-page.js +11 -3
- package/dist/documents/queries/overview.query.js +2 -2
- package/dist/documents/screens.js +3 -3
- package/dist/documents/tab.js +1 -1
- package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
- package/dist/feature-toggles/toggle-sync-signal.js +3 -2
- package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
- package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
- package/dist/file-foundation/probe.js +9 -3
- package/dist/file-foundation/read-file-ref-content.js +23 -11
- package/dist/file-provider-inmemory/feature.js +1 -1
- package/dist/file-provider-s3/env-feature.js +1 -1
- package/dist/file-provider-s3/env-named-feature.js +1 -1
- package/dist/file-provider-s3/env-schema.d.ts +10 -1
- package/dist/file-provider-s3/env-schema.js +20 -7
- package/dist/file-provider-s3/feature.js +1 -1
- package/dist/file-provider-s3/index.d.ts +1 -1
- package/dist/file-provider-s3/index.js +1 -1
- package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
- package/dist/file-provider-s3/lib/env-helper.js +13 -12
- package/dist/file-provider-s3/lib/s3-provider.js +10 -2
- package/dist/folders/aggregate-id.js +0 -1
- package/dist/folders/web/folder-manager.js +1 -1
- package/dist/folders-user-data/index.js +12 -14
- package/dist/form-draft/feature.js +1 -0
- package/dist/helpdesk/entity.js +4 -1
- package/dist/helpdesk/feature.js +37 -0
- package/dist/helpdesk/handlers/access.d.ts +0 -1
- package/dist/helpdesk/handlers/access.js +0 -3
- package/dist/helpdesk/handlers/attempts.js +7 -13
- package/dist/helpdesk/handlers/challenge.query.js +1 -2
- package/dist/helpdesk/handlers/reply.write.js +7 -8
- package/dist/helpdesk/handlers/report.write.js +4 -7
- package/dist/helpdesk/handlers/submit.write.js +5 -9
- package/dist/helpdesk/index.d.ts +1 -1
- package/dist/helpdesk/index.js +1 -1
- package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
- package/dist/helpdesk/legacy-contact-config.js +57 -0
- package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
- package/dist/helpdesk/legacy-contact-erasure.js +19 -0
- package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
- package/dist/helpdesk/legacy-contact-retention.js +53 -0
- package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
- package/dist/helpdesk/legacy-contact-streams.js +124 -0
- package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
- package/dist/helpdesk/legacy-contact-user-data.js +62 -0
- package/dist/helpdesk/lib.d.ts +8 -2
- package/dist/helpdesk/lib.js +32 -32
- package/dist/helpdesk/user-data-hooks.d.ts +10 -1
- package/dist/helpdesk/user-data-hooks.js +47 -36
- package/dist/helpdesk/web/constants.d.ts +0 -1
- package/dist/helpdesk/web/constants.js +0 -1
- package/dist/inbound-mail-foundation/account-health.js +1 -1
- package/dist/inbound-mail-foundation/account-poll.js +3 -1
- package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
- package/dist/inbound-mail-foundation/constants.d.ts +6 -0
- package/dist/inbound-mail-foundation/constants.js +6 -0
- package/dist/inbound-mail-foundation/content-refetch.d.ts +4 -0
- package/dist/inbound-mail-foundation/content-refetch.js +13 -3
- package/dist/inbound-mail-foundation/entities.js +58 -15
- package/dist/inbound-mail-foundation/events.js +16 -16
- package/dist/inbound-mail-foundation/feature.js +3 -1
- package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
- package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
- package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
- package/dist/inbound-mail-foundation/handlers/connect-account.write.js +14 -8
- package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
- package/dist/inbound-mail-foundation/handlers/forget-message.write.js +58 -0
- package/dist/inbound-mail-foundation/handlers/ingest-message-schema.js +12 -5
- package/dist/inbound-mail-foundation/i18n.js +3 -0
- package/dist/inbound-mail-foundation/index.d.ts +1 -0
- package/dist/inbound-mail-foundation/index.js +1 -0
- package/dist/inbound-mail-foundation/normalize-inbound-message.d.ts +6 -0
- package/dist/inbound-mail-foundation/normalize-inbound-message.js +21 -8
- package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
- package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
- package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
- package/dist/inbound-mail-foundation/personal-address.js +16 -0
- package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
- package/dist/inbound-mail-foundation/purge-messages.js +33 -0
- package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
- package/dist/inbound-mail-foundation/quarantine.js +9 -5
- package/dist/inbound-mail-foundation/retention-job.js +1 -5
- package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
- package/dist/inbound-mail-foundation/sanitize-inbound-html.d.ts +0 -1
- package/dist/inbound-mail-foundation/sanitize-inbound-html.js +2 -4
- package/dist/inbound-mail-foundation/send-from-account.js +9 -1
- package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
- package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
- package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
- package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
- package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
- package/dist/inbound-provider-imap/byte-budget.js +53 -0
- package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
- package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
- package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
- package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
- package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
- package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
- package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
- package/dist/inbound-provider-imap/download-batch.js +21 -6
- package/dist/inbound-provider-imap/feature.js +7 -4
- package/dist/inbound-provider-imap/fetch-content.js +35 -30
- package/dist/inbound-provider-imap/i18n.js +2 -2
- package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
- package/dist/inbound-provider-imap/parse-message.js +8 -0
- package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
- package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
- package/dist/inbound-provider-imap/send-mail.js +32 -6
- package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
- package/dist/inbound-provider-imap/smtp-client.js +15 -3
- package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
- package/dist/inbound-provider-inmemory/feature.js +1 -1
- package/dist/jobs/events.d.ts +13 -0
- package/dist/jobs/events.js +8 -0
- package/dist/jobs/feature.js +2 -0
- package/dist/jobs/handlers/consumer.write.js +31 -20
- package/dist/jobs/web/constants.d.ts +3 -0
- package/dist/jobs/web/constants.js +3 -0
- package/dist/mail-transport-inmemory/feature.js +1 -1
- package/dist/mail-transport-smtp/feature.js +3 -2
- package/dist/managed-pages/handlers/branding.query.js +1 -1
- package/dist/managed-pages/handlers/by-slug.query.js +1 -1
- package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
- package/dist/managed-pages/render-page-body.d.ts +2 -0
- package/dist/managed-pages/render-page-body.js +12 -8
- package/dist/managed-pages/screens/page-screens.d.ts +3 -2
- package/dist/managed-pages/screens/page-screens.js +14 -33
- package/dist/managed-pages/table.js +1 -0
- package/dist/managed-pages/web/client-plugin.js +8 -6
- package/dist/managed-pages/web/constants.d.ts +5 -1
- package/dist/managed-pages/web/constants.js +6 -1
- package/dist/managed-pages/web/i18n.js +11 -3
- package/dist/managed-pages/web/markdown-to-document.js +1 -1
- package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
- package/dist/managed-pages/web/page-edit-draft.js +76 -0
- package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
- package/dist/managed-pages/web/page-edit-screen.js +113 -0
- package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
- package/dist/managed-pages/web/page-settings-rail.js +14 -0
- package/dist/notes-history-user-data/index.js +8 -14
- package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
- package/dist/personal-access-tokens/boot-rules.js +5 -0
- package/dist/personal-access-tokens/handlers/create.write.js +0 -1
- package/dist/personal-access-tokens/scope-events-check.js +26 -6
- package/dist/presence/handlers/list.query.js +18 -8
- package/dist/presence/room.d.ts +2 -0
- package/dist/presence/room.js +8 -5
- package/dist/presence/store.d.ts +2 -0
- package/dist/presence/store.js +62 -26
- package/dist/readiness/handlers/latest-summary.query.js +10 -6
- package/dist/readiness/handlers/run-probes.write.js +24 -4
- package/dist/readiness/handlers/run-tone.js +3 -2
- package/dist/readiness/handlers/status.query.js +11 -3
- package/dist/readiness/probe-context.js +7 -10
- package/dist/readiness/screens.js +4 -4
- package/dist/readiness/visible-results.d.ts +1 -1
- package/dist/readiness/visible-results.js +5 -2
- package/dist/renderer-foundation/api.js +6 -12
- package/dist/renderer-foundation/types.d.ts +2 -2
- package/dist/secrets/db/queries/read.d.ts +2 -1
- package/dist/secrets/db/queries/read.js +10 -1
- package/dist/secrets/handlers/list.query.js +4 -2
- package/dist/secrets/secret-scope.d.ts +0 -1
- package/dist/secrets/secret-scope.js +2 -2
- package/dist/secrets/secrets-context.js +4 -4
- package/dist/secrets/table.d.ts +1 -1
- package/dist/secrets/write-gate.js +4 -2
- package/dist/seo/handlers/seo-config.query.js +1 -1
- package/dist/shared/acknowledged-system-db.d.ts +5 -0
- package/dist/shared/acknowledged-system-db.js +9 -0
- package/dist/shared/assert-billing-live.d.ts +1 -0
- package/dist/shared/assert-billing-live.js +5 -2
- package/dist/shared/hmac-signature.js +4 -2
- package/dist/shared/index.d.ts +7 -2
- package/dist/shared/index.js +7 -2
- package/dist/shared/normalize-email.d.ts +1 -0
- package/dist/shared/normalize-email.js +3 -0
- package/dist/shared/parent-visibility.d.ts +1 -0
- package/dist/shared/parent-visibility.js +16 -1
- package/dist/shared/password-hashing.js +0 -1
- package/dist/shared/price-env-shape.js +1 -1
- package/dist/shared/register-user-data-hooks.d.ts +11 -0
- package/dist/shared/register-user-data-hooks.js +11 -0
- package/dist/shared/require-bootstrap-extension.d.ts +9 -0
- package/dist/shared/require-bootstrap-extension.js +16 -0
- package/dist/shared/send-best-effort.d.ts +3 -0
- package/dist/shared/send-best-effort.js +19 -0
- package/dist/shared/stream-tenant-backfill.d.ts +1 -0
- package/dist/shared/stream-tenant-backfill.js +17 -1
- package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
- package/dist/shared/stream-tenant-derived-state.js +19 -2
- package/dist/step-dispatcher/constants.d.ts +4 -0
- package/dist/step-dispatcher/constants.js +11 -0
- package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
- package/dist/step-dispatcher/deliver-dispatch-request.js +41 -3
- package/dist/step-dispatcher/feature.js +31 -2
- package/dist/step-dispatcher/mail-runner.js +0 -1
- package/dist/step-dispatcher/sweep-abandoned.d.ts +11 -0
- package/dist/step-dispatcher/sweep-abandoned.js +46 -0
- package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
- package/dist/subscription-mollie/plugin-methods.js +1 -2
- package/dist/subscription-mollie/verify-webhook.js +5 -5
- package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
- package/dist/subscription-paddle/backfill-checkout-ledger.js +112 -0
- package/dist/subscription-paddle/checkout-config.query.js +1 -1
- package/dist/subscription-paddle/checkout-methods.js +2 -8
- package/dist/subscription-paddle/constants.d.ts +0 -1
- package/dist/subscription-paddle/constants.js +1 -2
- package/dist/subscription-paddle/feature.d.ts +0 -4
- package/dist/subscription-paddle/feature.js +21 -20
- package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
- package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
- package/dist/subscription-paddle/plan-switch-methods.js +2 -8
- package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
- package/dist/subscription-paddle/redeliver-legacy-checkout.js +43 -0
- package/dist/subscription-paddle/runtime.d.ts +3 -5
- package/dist/subscription-paddle/runtime.js +4 -7
- package/dist/subscription-paddle/subscription-state.d.ts +1 -0
- package/dist/subscription-paddle/subscription-state.js +1 -0
- package/dist/subscription-paddle/webhook-events.d.ts +4 -0
- package/dist/subscription-paddle/webhook-events.js +40 -22
- package/dist/subscription-stripe/feature.d.ts +4 -0
- package/dist/subscription-stripe/feature.js +1 -0
- package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
- package/dist/subscription-stripe/plugin-methods.js +2 -5
- package/dist/subscription-stripe/runtime.d.ts +2 -1
- package/dist/subscription-stripe/runtime.js +5 -7
- package/dist/subscription-stripe/verify-webhook.js +31 -6
- package/dist/tags/aggregate-id.js +0 -1
- package/dist/tags/web/tag-chip.js +0 -1
- package/dist/tags/web/tag-manager.js +3 -1
- package/dist/template-resolver/api.js +6 -12
- package/dist/template-resolver/document-sanitizer.d.ts +1 -1
- package/dist/template-resolver/document-sanitizer.js +18 -0
- package/dist/template-resolver/feature.d.ts +1 -0
- package/dist/template-resolver/feature.js +2 -0
- package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
- package/dist/template-resolver/handlers/body-preview.query.js +41 -0
- package/dist/template-resolver/handlers/by-slug.query.js +1 -1
- package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
- package/dist/template-resolver/handlers/collection-shared.js +5 -8
- package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
- package/dist/template-resolver/handlers/overview.query.js +2 -1
- package/dist/template-resolver/handlers/send-test.write.js +27 -8
- package/dist/template-resolver/linked-resources.js +2 -6
- package/dist/template-resolver/seeding.js +92 -1
- package/dist/template-resolver/table.js +1 -0
- package/dist/template-resolver/template-draft.js +2 -1
- package/dist/template-resolver/template-preview.js +12 -3
- package/dist/template-resolver/testing.js +0 -2
- package/dist/template-resolver/web/client-plugin.js +3 -0
- package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
- package/dist/template-resolver/web/constants.d.ts +2 -0
- package/dist/template-resolver/web/constants.js +2 -0
- package/dist/template-resolver/web/content-tree-provider.js +0 -1
- package/dist/template-resolver/web/content-workbench.d.ts +22 -0
- package/dist/template-resolver/web/content-workbench.js +32 -0
- package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
- package/dist/template-resolver/web/document-insert-model.js +1 -2
- package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
- package/dist/template-resolver/web/document-link-policy.js +53 -0
- package/dist/template-resolver/web/document-schema.d.ts +2 -4
- package/dist/template-resolver/web/document-schema.js +2 -53
- package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
- package/dist/template-resolver/web/document-tiptap-context.js +2 -2
- package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
- package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
- package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
- package/dist/template-resolver/web/editor-handle.js +1 -0
- package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
- package/dist/template-resolver/web/fill-document-variables.js +22 -0
- package/dist/template-resolver/web/i18n.js +10 -0
- package/dist/template-resolver/web/index.d.ts +3 -0
- package/dist/template-resolver/web/index.js +2 -0
- package/dist/template-resolver/web/preview-targets.d.ts +5 -0
- package/dist/template-resolver/web/preview-targets.js +21 -0
- package/dist/template-resolver/web/qualified-names.d.ts +1 -0
- package/dist/template-resolver/web/qualified-names.js +1 -0
- package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
- package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
- package/dist/template-resolver/web/string-values.d.ts +1 -0
- package/dist/template-resolver/web/string-values.js +8 -0
- package/dist/template-resolver/web/text-block-editor.js +18 -11
- package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
- package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
- package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
- package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
- package/dist/template-resolver/web/use-text-block-editor.js +26 -5
- package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
- package/dist/template-resolver/web/web-preview-renderer.js +45 -0
- package/dist/template-resolver-user-data/index.js +11 -10
- package/dist/tenant/handlers/create.write.js +3 -7
- package/dist/tenant/handlers/list.query.js +3 -8
- package/dist/tenant/handlers/member-directory.query.js +10 -5
- package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
- package/dist/tenant/invited-membership.js +9 -1
- package/dist/tenant/seeding.d.ts +3 -0
- package/dist/tenant/seeding.js +3 -1
- package/dist/tenant/stream-tenant-backfill.js +5 -1
- package/dist/tenant/testing.js +1 -1
- package/dist/tenant-inactivity/check-inactive-tenants.js +29 -18
- package/dist/tenant-inactivity/constants.js +1 -2
- package/dist/tenant-inactivity/handlers/keep-account.write.js +8 -2
- package/dist/tenant-inactivity/state-store.d.ts +3 -1
- package/dist/tenant-inactivity/state-store.js +16 -1
- package/dist/tenant-lifecycle/constants.d.ts +1 -0
- package/dist/tenant-lifecycle/constants.js +3 -0
- package/dist/tenant-lifecycle/feature.js +1 -0
- package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
- package/dist/tenant-lifecycle/stages.js +14 -2
- package/dist/tier-engine/aggregate-id.js +0 -1
- package/dist/tier-engine/feature.js +9 -2
- package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
- package/dist/user/handlers/me.query.js +4 -1
- package/dist/user/index.d.ts +1 -0
- package/dist/user/index.js +1 -0
- package/dist/user/resolve-verified-user-email.d.ts +2 -0
- package/dist/user/resolve-verified-user-email.js +14 -0
- package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
- package/dist/user-data-rights/feature.js +1 -0
- package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
- package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
- package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
- package/dist/user-data-rights/run-export-jobs.js +0 -2
- package/dist/user-data-rights/run-forget-cleanup.js +2 -2
- package/dist/user-data-rights/schema/download-attempt.js +3 -2
- package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
- package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
- package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
- package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
- package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
- package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
- package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
- package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
- package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
- package/dist/user-profile/handlers/change-email.write.js +0 -1
- package/dist/waitlist/handlers/reject.write.js +2 -1
- package/dist/waitlist/handlers/submit.write.js +6 -19
- package/dist/waitlist/import.js +2 -1
- package/dist/waitlist/lib.d.ts +0 -1
- package/dist/waitlist/lib.js +2 -10
- package/dist/waitlist/link-on-signup.js +2 -2
- package/dist/waitlist/user-data-hooks.js +6 -20
- package/dist/workflow-runner/aggregate-id.js +0 -1
- package/dist/workflow-runner/event-trigger.js +6 -2
- package/dist/workflow-runner/feature.js +1 -5
- package/dist/workflow-runner/handlers/resume-run.write.js +6 -4
- package/dist/workflow-runner/runner.d.ts +1 -0
- package/package.json +35 -11
- package/src/admin-shell/changes.json +6 -0
- package/src/agent-tools/changes.json +12 -0
- package/src/auth-email-password/changes.json +18 -0
- package/src/auth-mfa/changes.json +6 -0
- package/src/billing-foundation/changes.json +61 -0
- package/src/cap-counter/changes.json +6 -0
- package/src/cap-overview/changes.json +6 -0
- package/src/channel-in-app/changes.json +6 -0
- package/src/channel-whatsapp/changes.json +32 -0
- package/src/compliance-profiles/changes.json +5 -0
- package/src/config/changes.json +12 -0
- package/src/crypto-shredding/changes.json +18 -0
- package/src/data-retention/changes.json +12 -0
- package/src/delivery/changes.json +12 -0
- package/src/document-ingest-foundation/changes.json +6 -0
- package/src/documents/changes.json +24 -0
- package/src/file-provider-s3/changes.json +14 -0
- package/src/files/changes.json +7 -0
- package/src/helpdesk/changes.json +56 -0
- package/src/inbound-mail-foundation/changes.json +54 -0
- package/src/inbound-provider-imap/changes.json +13 -0
- package/src/mail-foundation/changes.json +6 -0
- package/src/managed-pages/changes.json +12 -0
- package/src/presence/changes.json +6 -0
- package/src/readiness/changes.json +25 -0
- package/src/secrets/changes.json +7 -0
- package/src/shared/changes.json +12 -0
- package/src/step-dispatcher/changes.json +18 -0
- package/src/subscription-mollie/changes.json +7 -0
- package/src/subscription-paddle/changes.json +19 -0
- package/src/subscription-stripe/changes.json +13 -0
- package/src/template-resolver/changes.json +48 -0
- package/src/tenant/changes.json +6 -0
- package/src/tenant-inactivity/changes.json +6 -0
- package/src/tenant-lifecycle/changes.json +24 -0
- package/src/tier-engine/changes.json +6 -0
- package/src/user/changes.json +6 -0
- package/src/waitlist/changes.json +6 -0
- package/src/workflow-runner/changes.json +6 -0
- package/dist/managed-pages/web/page-body-section.d.ts +0 -3
- package/dist/managed-pages/web/page-body-section.js +0 -40
- package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
- package/dist/subscription-paddle/tenant-binding.js +0 -26
- package/dist/template-resolver/web/content-field.d.ts +0 -9
- package/dist/template-resolver/web/content-field.js +0 -14
|
@@ -9,9 +9,11 @@
|
|
|
9
9
|
// bucket — events are business facts: future consumers (billing-history,
|
|
10
10
|
// accounting-export, churn-analytics) listen directly for the event type
|
|
11
11
|
// without a payload discriminator.
|
|
12
|
+
import { piiCiphertextMaxLengthFor } from "@cosmicdrift/kumiko-framework/crypto";
|
|
12
13
|
import * as z from "zod";
|
|
13
14
|
import { BILLING_FOUNDATION_FEATURE, SubscriptionStatuses } from "./web/constants.js";
|
|
14
15
|
import { CONSENT_LOCALES } from "./web/consumer-protection/consent-locale.js";
|
|
16
|
+
export const PROVIDER_ID_MAX_CHARS = 200;
|
|
15
17
|
// Aggregate type for the event store. One subscription per tenant is
|
|
16
18
|
// one stream; the subscriptionAggregateId helper provides the stream ID.
|
|
17
19
|
export const SUBSCRIPTION_AGGREGATE_TYPE = "subscription";
|
|
@@ -42,12 +44,9 @@ const statusEnum = z.enum([
|
|
|
42
44
|
// PII, and event headers cannot be crypto-shredded.
|
|
43
45
|
export const subscriptionEventPayloadSchema = z.object({
|
|
44
46
|
providerName: z.string().min(1).max(50),
|
|
45
|
-
//
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
// provider id. A 200-char plaintext id becomes ~300+ chars of ciphertext.
|
|
49
|
-
providerCustomerId: z.string().min(1).max(1000),
|
|
50
|
-
providerSubscriptionId: z.string().min(1).max(1000),
|
|
47
|
+
// Ciphertext, not the raw id: the plaintext id is limited to PROVIDER_ID_MAX_CHARS.
|
|
48
|
+
providerCustomerId: z.string().min(1).max(piiCiphertextMaxLengthFor(PROVIDER_ID_MAX_CHARS)),
|
|
49
|
+
providerSubscriptionId: z.string().min(1).max(piiCiphertextMaxLengthFor(PROVIDER_ID_MAX_CHARS)),
|
|
51
50
|
status: statusEnum,
|
|
52
51
|
tier: z.string().min(1).max(50),
|
|
53
52
|
currentPeriodEndIso: z.string().min(1),
|
|
@@ -74,16 +73,46 @@ export const PAYMENT_RECEIVED_EVENT_SHORT = "payment-received";
|
|
|
74
73
|
export const PAYMENT_RECEIVED_EVENT_QN = `${BILLING_FOUNDATION_FEATURE}:event:${PAYMENT_RECEIVED_EVENT_SHORT}`;
|
|
75
74
|
export const paymentEventPayloadSchema = z.object({
|
|
76
75
|
providerName: z.string().min(1).max(50),
|
|
77
|
-
//
|
|
78
|
-
|
|
79
|
-
// subscriptionEventPayloadSchema's same rationale.
|
|
80
|
-
providerCustomerId: z.string().min(1).max(1000),
|
|
76
|
+
// Ciphertext, not the raw id (plaintext limit PROVIDER_ID_MAX_CHARS).
|
|
77
|
+
providerCustomerId: z.string().min(1).max(piiCiphertextMaxLengthFor(PROVIDER_ID_MAX_CHARS)),
|
|
81
78
|
priceId: z.string().min(1).max(200),
|
|
82
79
|
// Optional so payloads stored before quantity existed still parse; absent = 1.
|
|
83
80
|
quantity: z.number().int().positive().optional(),
|
|
84
81
|
consentId: z.string().min(1).max(100).optional(),
|
|
85
82
|
});
|
|
86
83
|
// =============================================================================
|
|
84
|
+
// checkout-opened — the server's checkout ledger
|
|
85
|
+
// =============================================================================
|
|
86
|
+
//
|
|
87
|
+
// Appended onto the subscription- or payment-stream (by checkout mode) right
|
|
88
|
+
// after the provider handed out a checkout. Webhooks are only accepted for
|
|
89
|
+
// checkouts listed here, so a checkout opened client-side (public provider
|
|
90
|
+
// tokens) cannot mint payments or subscriptions. No projection applies it.
|
|
91
|
+
export const CHECKOUT_OPENED_EVENT_SHORT = "checkout-opened";
|
|
92
|
+
export const CHECKOUT_OPENED_EVENT_QN = `${BILLING_FOUNDATION_FEATURE}:event:${CHECKOUT_OPENED_EVENT_SHORT}`;
|
|
93
|
+
export const CHECKOUT_MODES = ["subscription", "payment"];
|
|
94
|
+
export const checkoutOpenedPayloadSchema = z.object({
|
|
95
|
+
providerName: z.string().min(1).max(50),
|
|
96
|
+
providerCheckoutId: z.string().min(1).max(200),
|
|
97
|
+
priceId: z.string().min(1).max(200),
|
|
98
|
+
mode: z.enum(CHECKOUT_MODES),
|
|
99
|
+
consentId: z.string().min(1).max(100).optional(),
|
|
100
|
+
});
|
|
101
|
+
// =============================================================================
|
|
102
|
+
// plan-switch-requested — in-app plan switch in flight
|
|
103
|
+
// =============================================================================
|
|
104
|
+
//
|
|
105
|
+
// Appended onto the subscription stream when switch-plan applied a switch at the provider; the
|
|
106
|
+
// tier only changes once the provider's webhook arrives. No projection applies it. It blocks a
|
|
107
|
+
// second switch until a state event follows or the window runs out.
|
|
108
|
+
export const PLAN_SWITCH_REQUESTED_EVENT_SHORT = "plan-switch-requested";
|
|
109
|
+
export const PLAN_SWITCH_REQUESTED_EVENT_QN = `${BILLING_FOUNDATION_FEATURE}:event:${PLAN_SWITCH_REQUESTED_EVENT_SHORT}`;
|
|
110
|
+
export const planSwitchRequestedPayloadSchema = z.object({
|
|
111
|
+
tier: z.string().min(1).max(50),
|
|
112
|
+
priceId: z.string().min(1).max(200),
|
|
113
|
+
requestedAtIso: z.iso.datetime(),
|
|
114
|
+
});
|
|
115
|
+
// =============================================================================
|
|
87
116
|
// checkout-consent-recorded — consumer-protection consent
|
|
88
117
|
// =============================================================================
|
|
89
118
|
//
|
|
@@ -52,7 +52,7 @@ import { defineFeature, EXT_TENANT_DATA, } from "@cosmicdrift/kumiko-framework/e
|
|
|
52
52
|
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
53
53
|
import { registerConsumerProtection } from "./consumer-protection/register-consent.js";
|
|
54
54
|
import { paymentEntity, subscriptionEntity } from "./entities.js";
|
|
55
|
-
import { INVOICE_PAID_EVENT_QN, INVOICE_PAID_EVENT_SHORT, INVOICE_PAYMENT_FAILED_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_SHORT, PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, PAYMENT_RECEIVED_EVENT_SHORT, paymentEventPayloadSchema, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CANCELED_EVENT_SHORT, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_SHORT, SUBSCRIPTION_UPDATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_SHORT, subscriptionEventPayloadSchema, } from "./events.js";
|
|
55
|
+
import { CHECKOUT_OPENED_EVENT_SHORT, checkoutOpenedPayloadSchema, INVOICE_PAID_EVENT_QN, INVOICE_PAID_EVENT_SHORT, INVOICE_PAYMENT_FAILED_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_SHORT, PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, PAYMENT_RECEIVED_EVENT_SHORT, PLAN_SWITCH_REQUESTED_EVENT_SHORT, paymentEventPayloadSchema, planSwitchRequestedPayloadSchema, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CANCELED_EVENT_SHORT, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_SHORT, SUBSCRIPTION_UPDATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_SHORT, subscriptionEventPayloadSchema, } from "./events.js";
|
|
56
56
|
import { createBillingPlansQuery } from "./handlers/billing-plans.query.js";
|
|
57
57
|
import { createCheckoutSessionHandler } from "./handlers/create-checkout-session.write.js";
|
|
58
58
|
import { createPortalSessionHandler } from "./handlers/create-portal-session.write.js";
|
|
@@ -60,12 +60,14 @@ import { listSubscriptionsQuery } from "./handlers/list-subscriptions.query.js";
|
|
|
60
60
|
import { createPlanSwitchPreviewQuery } from "./handlers/plan-switch-preview.query.js";
|
|
61
61
|
import { createProcessEventHandler } from "./handlers/process-event.write.js";
|
|
62
62
|
import { processPaymentEventHandler } from "./handlers/process-payment-event.write.js";
|
|
63
|
+
import { recordCheckoutOpenedHandler } from "./handlers/record-checkout-opened.write.js";
|
|
63
64
|
import { createStartPlanCheckoutHandler } from "./handlers/start-plan-checkout.write.js";
|
|
64
65
|
import { createSwitchPlanHandler } from "./handlers/switch-plan.write.js";
|
|
65
66
|
import { syncSubscriptionHandler } from "./handlers/sync-subscription.write.js";
|
|
66
67
|
import { BILLING_FOUNDATION_I18N } from "./i18n.js";
|
|
67
68
|
import { applyInvoicePaid, applyInvoicePaymentFailed, applyPaymentReceived, applySubscriptionCanceled, applySubscriptionCreated, applySubscriptionUpdated, paymentsProjectionTable, subscriptionsProjectionTable, } from "./projection.js";
|
|
68
69
|
import { createBillingPlansScreen } from "./screens.js";
|
|
70
|
+
import { registerScrubRawPayloadHeadersJob } from "./scrub-raw-payload-headers.js";
|
|
69
71
|
import { PAYMENT_TENANT_DESTROY_ARCHIVE_REASON, paymentTenantDestroyHook, SUBSCRIPTION_TENANT_DESTROY_ARCHIVE_REASON, subscriptionTenantDestroyHook, } from "./tenant-destroy-hook.js";
|
|
70
72
|
import { validateOptions } from "./validate-options.js";
|
|
71
73
|
import { BILLING_FOUNDATION_FEATURE, SUBSCRIPTION_PROVIDER_EXTENSION, SubscriptionFoundationHandlers, } from "./web/constants.js";
|
|
@@ -121,6 +123,10 @@ export function createBillingFoundationFeature(options = {}) {
|
|
|
121
123
|
// state transition. piiFields: "none" for the same reason as the 5 above:
|
|
122
124
|
// providerCustomerId is tenantOwned ciphertext, not plaintext personal data.
|
|
123
125
|
r.defineEvent(PAYMENT_RECEIVED_EVENT_SHORT, paymentEventPayloadSchema, { piiFields: "none" });
|
|
126
|
+
// Checkout ledger: registered unconditionally, webhook acceptance depends on it.
|
|
127
|
+
r.defineEvent(CHECKOUT_OPENED_EVENT_SHORT, checkoutOpenedPayloadSchema, {
|
|
128
|
+
piiFields: "none",
|
|
129
|
+
});
|
|
124
130
|
// Inline projection: materialized current state in `read_subscriptions`.
|
|
125
131
|
// Apply runs in the same TX as ctx.events.unsafeAppend — read-your-own-
|
|
126
132
|
// write without a dispatcher tick.
|
|
@@ -161,6 +167,7 @@ export function createBillingFoundationFeature(options = {}) {
|
|
|
161
167
|
// - process-payment-event: programmatic entry-point from the webhook-
|
|
162
168
|
// handler for one-off-payments; appends onto the payment-aggregate
|
|
163
169
|
r.writeHandler(processPaymentEventHandler);
|
|
170
|
+
r.writeHandler(recordCheckoutOpenedHandler);
|
|
164
171
|
// - sync-subscription: backfill entry-point for the sync-subscriptions
|
|
165
172
|
// job below; pulls the live provider state and appends drift as a
|
|
166
173
|
// subscription.updated event. Registered unconditionally (not
|
|
@@ -182,6 +189,9 @@ export function createBillingFoundationFeature(options = {}) {
|
|
|
182
189
|
r.queryHandler(createBillingPlansQuery(widened, catalog));
|
|
183
190
|
r.queryHandler(createPlanSwitchPreviewQuery(catalog));
|
|
184
191
|
r.writeHandler(createStartPlanCheckoutHandler(widened, catalog));
|
|
192
|
+
r.defineEvent(PLAN_SWITCH_REQUESTED_EVENT_SHORT, planSwitchRequestedPayloadSchema, {
|
|
193
|
+
piiFields: "none",
|
|
194
|
+
});
|
|
185
195
|
r.writeHandler(createSwitchPlanHandler(widened, catalog));
|
|
186
196
|
r.screen(createBillingPlansScreen(catalog.viewRoles));
|
|
187
197
|
}
|
|
@@ -206,6 +216,7 @@ export function createBillingFoundationFeature(options = {}) {
|
|
|
206
216
|
ctx.obs.log.info(`[billing-foundation:sync-subscriptions] ${JSON.stringify(result.data)}`);
|
|
207
217
|
},
|
|
208
218
|
});
|
|
219
|
+
registerScrubRawPayloadHeadersJob(r);
|
|
209
220
|
r.useExtension(EXT_TENANT_DATA, "subscription", {
|
|
210
221
|
destroy: subscriptionTenantDestroyHook,
|
|
211
222
|
escapeHatch: { reason: SUBSCRIPTION_TENANT_DESTROY_ARCHIVE_REASON },
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// when `createBillingFoundationFeature` gets a `catalog`.
|
|
4
4
|
import * as z from "zod";
|
|
5
5
|
import { filterOfferedProviders, listCatalogProviders, } from "../checkout-core.js";
|
|
6
|
-
import { CONSENT_TEXTS, consentTextVersion, documentsAcknowledgementTextFor,
|
|
6
|
+
import { CONSENT_TEXTS, consentTextVersion, documentsAcknowledgementTextFor, hasProviderRefundLink, legalLinksFor, } from "../consumer-protection/consent-text.js";
|
|
7
7
|
import { buildProviderPlanViews, loadBillingPlansBase, toBillingPlansResult, } from "../plan-catalog.js";
|
|
8
8
|
const billingPlansSchema = z.object({}).strict();
|
|
9
9
|
export function createBillingPlansQuery(options, catalog) {
|
|
@@ -20,13 +20,7 @@ export function createBillingPlansQuery(options, catalog) {
|
|
|
20
20
|
return result;
|
|
21
21
|
return {
|
|
22
22
|
...result,
|
|
23
|
-
consumerProtection:
|
|
24
|
-
consentTexts: {
|
|
25
|
-
de: consentTextView(consumerProtection, "de"),
|
|
26
|
-
en: consentTextView(consumerProtection, "en"),
|
|
27
|
-
},
|
|
28
|
-
legalLinks: legalLinksPerLocale(consumerProtection.legalLinks),
|
|
29
|
-
},
|
|
23
|
+
consumerProtection: consumerProtectionView(consumerProtection, base.blockingSubscription ? base.subscriptionView?.providerName : undefined),
|
|
30
24
|
};
|
|
31
25
|
},
|
|
32
26
|
};
|
|
@@ -45,25 +39,41 @@ async function resolveProviderPlans(ctx, options, catalog, base) {
|
|
|
45
39
|
const firstViews = await buildProviderPlanViews(ctx, first?.plugin ?? null, catalog, base);
|
|
46
40
|
const result = toBillingPlansResult(catalog, base, firstViews);
|
|
47
41
|
const providerTexts = options.consumerProtection?.providerTexts;
|
|
48
|
-
const
|
|
49
|
-
|
|
42
|
+
const hasProviderSpecifics = first !== null &&
|
|
43
|
+
(providerTexts?.[first.name]?.checkoutNote !== undefined ||
|
|
44
|
+
(options.consumerProtection !== undefined &&
|
|
45
|
+
hasProviderRefundLink(options.consumerProtection, first.name)));
|
|
46
|
+
if (offered.length <= 1 && !(offered.length === 1 && hasProviderSpecifics))
|
|
50
47
|
return result;
|
|
51
|
-
const providers = await Promise.all(offered.map((provider, index) => providerView(ctx, catalog, base, provider,
|
|
48
|
+
const providers = await Promise.all(offered.map((provider, index) => providerView(ctx, catalog, base, provider, options.consumerProtection, index === 0 ? firstViews : null)));
|
|
52
49
|
return { ...result, providers };
|
|
53
50
|
}
|
|
54
|
-
async function providerView(ctx, catalog, base, provider,
|
|
51
|
+
async function providerView(ctx, catalog, base, provider, consumerProtection, known) {
|
|
55
52
|
const views = known ?? (await buildProviderPlanViews(ctx, provider.plugin, catalog, base));
|
|
56
|
-
const note = providerTexts?.[provider.name]?.checkoutNote;
|
|
53
|
+
const note = consumerProtection?.providerTexts?.[provider.name]?.checkoutNote;
|
|
54
|
+
const ownConsumerProtection = consumerProtection !== undefined && hasProviderRefundLink(consumerProtection, provider.name)
|
|
55
|
+
? consumerProtectionView(consumerProtection, provider.name)
|
|
56
|
+
: undefined;
|
|
57
57
|
return {
|
|
58
58
|
name: provider.name,
|
|
59
59
|
displayName: provider.plugin.displayName ?? provider.name,
|
|
60
60
|
...(note !== undefined && { note }),
|
|
61
|
+
...(ownConsumerProtection !== undefined && { consumerProtection: ownConsumerProtection }),
|
|
61
62
|
plans: views.plans,
|
|
62
63
|
};
|
|
63
64
|
}
|
|
64
|
-
function
|
|
65
|
+
function consumerProtectionView(consumerProtection, providerName) {
|
|
66
|
+
return {
|
|
67
|
+
consentTexts: {
|
|
68
|
+
de: consentTextView(consumerProtection, "de", providerName),
|
|
69
|
+
en: consentTextView(consumerProtection, "en", providerName),
|
|
70
|
+
},
|
|
71
|
+
legalLinks: legalLinksFor(consumerProtection, providerName),
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
function consentTextView(consumerProtection, locale, providerName) {
|
|
65
75
|
const { earlyPerformance, withdrawalLoss } = CONSENT_TEXTS[locale];
|
|
66
|
-
const documentsAcknowledgement = documentsAcknowledgementTextFor(consumerProtection, locale);
|
|
76
|
+
const documentsAcknowledgement = documentsAcknowledgementTextFor(consumerProtection, locale, providerName);
|
|
67
77
|
return {
|
|
68
78
|
earlyPerformance,
|
|
69
79
|
withdrawalLoss,
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
// hand-picked priceId.
|
|
24
24
|
import { InternalError, UnprocessableError } from "@cosmicdrift/kumiko-framework/errors";
|
|
25
25
|
import * as z from "zod";
|
|
26
|
-
import { assertCheckoutAllowed, openCheckout, startProviderCheckout, } from "../checkout-core.js";
|
|
26
|
+
import { assertCheckoutAllowed, CHECKOUT_START_RATE_LIMIT, openCheckout, startProviderCheckout, } from "../checkout-core.js";
|
|
27
27
|
import { assertValidOrderItem, consentCheckoutFields, consentPayloadSchema, prepareConsent, recordConsent, } from "../consumer-protection/consent-gate.js";
|
|
28
28
|
import { withOwnProviderCustomer } from "../one-off-customer.js";
|
|
29
29
|
const createCheckoutSessionSchema = z.object({
|
|
@@ -56,6 +56,7 @@ export function createCheckoutSessionHandler(options) {
|
|
|
56
56
|
// Tenant-Admin-only — the tenant must deliberately configure its own
|
|
57
57
|
// subscription. SystemAdmin as a fallback for operator-initiated flows.
|
|
58
58
|
access: { roles: ["TenantAdmin", "SystemAdmin"] },
|
|
59
|
+
rateLimit: CHECKOUT_START_RATE_LIMIT,
|
|
59
60
|
handler: async (event, ctx) => {
|
|
60
61
|
// @cast-boundary engine-payload — dispatcher-zod-validated payload
|
|
61
62
|
const payload = event.payload;
|
|
@@ -88,7 +89,7 @@ export function createCheckoutSessionHandler(options) {
|
|
|
88
89
|
? await consumerProtection.oneOffItemLabel?.(ctx, payload.priceId)
|
|
89
90
|
: undefined;
|
|
90
91
|
assertValidOrderItem(orderItem, payload.priceId);
|
|
91
|
-
const consent = await prepareConsent(ctx, consumerProtection, payload.consent, mode);
|
|
92
|
+
const consent = await prepareConsent(ctx, consumerProtection, payload.consent, mode, payload.providerName);
|
|
92
93
|
const result = await startProviderCheckout(ctx, plugin, {
|
|
93
94
|
...checkoutInput,
|
|
94
95
|
...consentCheckoutFields(consent),
|
|
@@ -24,7 +24,7 @@ export declare const processEventSchema: z.ZodObject<{
|
|
|
24
24
|
currentPeriodEndIso: z.ZodString;
|
|
25
25
|
cancelAtIso: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
26
26
|
providerEventAtIso: z.ZodOptional<z.ZodISODateTime>;
|
|
27
|
-
|
|
27
|
+
providerCheckoutId: z.ZodOptional<z.ZodString>;
|
|
28
28
|
}, z.core.$strip>;
|
|
29
29
|
export type ProcessEventPayload = z.infer<typeof processEventSchema>;
|
|
30
30
|
export declare function isLateStateEvent(storedEvents: readonly {
|
|
@@ -33,10 +33,12 @@ export declare function isLateStateEvent(storedEvents: readonly {
|
|
|
33
33
|
readonly headers?: Record<string, unknown>;
|
|
34
34
|
};
|
|
35
35
|
}[], payload: ProcessEventPayload): boolean;
|
|
36
|
+
type SubscriptionStreamEvent = Awaited<ReturnType<HandlerContext["events"]["load"]>>[number];
|
|
36
37
|
export declare function clampProviderEventAt(payload: ProcessEventPayload, now: Temporal.Instant): ProcessEventPayload;
|
|
37
|
-
export declare function appendSubscriptionEvent(ctx: HandlerContext, tenantId: string, rawPayload: ProcessEventPayload, now?: Temporal.Instant): Promise<{
|
|
38
|
+
export declare function appendSubscriptionEvent(ctx: HandlerContext, tenantId: string, rawPayload: ProcessEventPayload, now?: Temporal.Instant, consentId?: string, lockedStream?: readonly SubscriptionStreamEvent[]): Promise<{
|
|
38
39
|
readonly duplicate: boolean;
|
|
39
40
|
readonly stale?: true;
|
|
40
41
|
readonly subscriptionAggregateId: string;
|
|
41
42
|
}>;
|
|
42
43
|
export declare function createProcessEventHandler(now: () => Temporal.Instant): WriteHandlerDef;
|
|
44
|
+
export {};
|
|
@@ -7,17 +7,22 @@
|
|
|
7
7
|
// already-seen `metadata.providerEventId`. A provider replay
|
|
8
8
|
// (Stripe retry storm) has the same event ID → duplicate=true,
|
|
9
9
|
// with no second append.
|
|
10
|
-
// 2.
|
|
10
|
+
// 2. Admission (handler only, not the shared append): `created` needs a
|
|
11
|
+
// checkout from the server's ledger; every other type needs the tenant's
|
|
12
|
+
// current subscription or a ledgered checkout. Else the event is ignored.
|
|
13
|
+
// 3. Type mapping: SubscriptionEvent.type (= normalized by the plugin)
|
|
11
14
|
// → one of the 5 ES event types.
|
|
12
|
-
//
|
|
15
|
+
// 4. ctx.events.unsafeAppend — the inline projection materializes the
|
|
13
16
|
// `read_subscriptions` row in the same TX.
|
|
14
17
|
import { configuredPiiSubjectKms, encryptPiiFieldValues, } from "@cosmicdrift/kumiko-framework/crypto";
|
|
15
18
|
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
16
19
|
import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
17
20
|
import * as z from "zod";
|
|
18
21
|
import { subscriptionAggregateId } from "../aggregate-id.js";
|
|
22
|
+
import { findProviderPlugin } from "../checkout-core.js";
|
|
23
|
+
import { findCheckoutOpened, IgnoredEventReasons, } from "../checkout-ledger.js";
|
|
19
24
|
import { SUBSCRIPTION_PII_FIELDS, subscriptionEntity } from "../entities.js";
|
|
20
|
-
import { INVOICE_PAID_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_QN, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_QN, } from "../events.js";
|
|
25
|
+
import { CHECKOUT_CONSENT_RECORDED_EVENT_QN, checkoutConsentRecordedPayloadSchema, INVOICE_PAID_EVENT_QN, INVOICE_PAYMENT_FAILED_EVENT_QN, PROVIDER_ID_MAX_CHARS, SUBSCRIPTION_AGGREGATE_TYPE, SUBSCRIPTION_CANCELED_EVENT_QN, SUBSCRIPTION_CREATED_EVENT_QN, SUBSCRIPTION_UPDATED_EVENT_QN, } from "../events.js";
|
|
21
26
|
import { getSubscriptionForTenant } from "../get-subscription-for-tenant.js";
|
|
22
27
|
import { hasSeenProviderEvent } from "../provider-event-seen.js";
|
|
23
28
|
import { BILLING_SUBSCRIPTION_LOCK_NAMESPACE, isSubscriptionBlockingCheckout, isSwitchableSubscriptionStatus, SubscriptionEventTypes, SubscriptionStatuses, } from "../web/constants.js";
|
|
@@ -44,14 +49,14 @@ export const processEventSchema = z.object({
|
|
|
44
49
|
providerEventId: z.string().min(1).max(200),
|
|
45
50
|
providerName: z.string().min(1).max(50),
|
|
46
51
|
type: eventTypeSchema,
|
|
47
|
-
providerCustomerId: z.string().min(1).max(
|
|
48
|
-
providerSubscriptionId: z.string().min(1).max(
|
|
52
|
+
providerCustomerId: z.string().min(1).max(PROVIDER_ID_MAX_CHARS),
|
|
53
|
+
providerSubscriptionId: z.string().min(1).max(PROVIDER_ID_MAX_CHARS),
|
|
49
54
|
status: statusSchema,
|
|
50
55
|
tier: z.string().min(1).max(50),
|
|
51
56
|
currentPeriodEndIso: z.string().min(1),
|
|
52
57
|
cancelAtIso: z.string().min(1).nullable().optional(),
|
|
53
58
|
providerEventAtIso: z.iso.datetime().optional(),
|
|
54
|
-
|
|
59
|
+
providerCheckoutId: z.string().min(1).max(200).optional(),
|
|
55
60
|
});
|
|
56
61
|
// Map normalized SubscriptionEventType → fully-qualified ES event-name.
|
|
57
62
|
const NORMALIZED_TO_ES_EVENT = {
|
|
@@ -61,6 +66,11 @@ const NORMALIZED_TO_ES_EVENT = {
|
|
|
61
66
|
[SubscriptionEventTypes.invoicePaid]: INVOICE_PAID_EVENT_QN,
|
|
62
67
|
[SubscriptionEventTypes.invoicePaymentFailed]: INVOICE_PAYMENT_FAILED_EVENT_QN,
|
|
63
68
|
};
|
|
69
|
+
const STATE_EVENT_QNS = new Set([
|
|
70
|
+
SUBSCRIPTION_CREATED_EVENT_QN,
|
|
71
|
+
SUBSCRIPTION_UPDATED_EVENT_QN,
|
|
72
|
+
SUBSCRIPTION_CANCELED_EVENT_QN,
|
|
73
|
+
]);
|
|
64
74
|
const STATE_EVENT_TYPES = new Set([
|
|
65
75
|
SubscriptionEventTypes.created,
|
|
66
76
|
SubscriptionEventTypes.updated,
|
|
@@ -93,12 +103,10 @@ export function isLateStateEvent(storedEvents, payload) {
|
|
|
93
103
|
}
|
|
94
104
|
});
|
|
95
105
|
}
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
// who constructs `payload` and what `providerEventId` they use.
|
|
101
|
-
// =============================================================================
|
|
106
|
+
async function lockAndLoadSubscriptionStream(ctx, aggId) {
|
|
107
|
+
await ctx.db.advisoryXactLock(BILLING_SUBSCRIPTION_LOCK_NAMESPACE, aggId);
|
|
108
|
+
return ctx.events.load(aggId);
|
|
109
|
+
}
|
|
102
110
|
// A provider timestamp far in the future would make every later, genuine event look late.
|
|
103
111
|
const PROVIDER_EVENT_CLOCK_SKEW_SECONDS = 300;
|
|
104
112
|
export function clampProviderEventAt(payload, now) {
|
|
@@ -109,13 +117,12 @@ export function clampProviderEventAt(payload, now) {
|
|
|
109
117
|
? { ...payload, providerEventAtIso: ceiling.toString() }
|
|
110
118
|
: payload;
|
|
111
119
|
}
|
|
112
|
-
export async function appendSubscriptionEvent(ctx, tenantId, rawPayload, now = Temporal.Now.instant()) {
|
|
120
|
+
export async function appendSubscriptionEvent(ctx, tenantId, rawPayload, now = Temporal.Now.instant(), consentId, lockedStream) {
|
|
113
121
|
const aggId = subscriptionAggregateId(tenantId);
|
|
114
122
|
const payload = clampProviderEventAt(rawPayload, now);
|
|
115
|
-
//
|
|
116
|
-
// stream version itself, so without
|
|
117
|
-
//
|
|
118
|
-
await ctx.db.advisoryXactLock(BILLING_SUBSCRIPTION_LOCK_NAMESPACE, aggId);
|
|
123
|
+
// The lock serialises the read (idempotency + late check) with the append: the append re-reads the
|
|
124
|
+
// stream version itself, so without it a concurrent delivery could slip in between and the late
|
|
125
|
+
// check would have judged an outdated stream. A caller that already holds it passes its stream.
|
|
119
126
|
// ---------------------------------------------------------------
|
|
120
127
|
// 1. Idempotency: load the subscription stream and check whether this
|
|
121
128
|
// providerEventId was already seen. A provider retry storm (Stripe
|
|
@@ -127,7 +134,7 @@ export async function appendSubscriptionEvent(ctx, tenantId, rawPayload, now = T
|
|
|
127
134
|
// streams, optimize via snapshot or a per-tenant dedup table as the
|
|
128
135
|
// idempotency anchor (like cap-counter).
|
|
129
136
|
// ---------------------------------------------------------------
|
|
130
|
-
const existingEvents = await ctx
|
|
137
|
+
const existingEvents = lockedStream ?? (await lockAndLoadSubscriptionStream(ctx, aggId));
|
|
131
138
|
if (hasSeenProviderEvent(existingEvents, payload)) {
|
|
132
139
|
return { duplicate: true, subscriptionAggregateId: aggId };
|
|
133
140
|
}
|
|
@@ -183,7 +190,7 @@ export async function appendSubscriptionEvent(ctx, tenantId, rawPayload, now = T
|
|
|
183
190
|
tier: payload.tier,
|
|
184
191
|
currentPeriodEndIso: payload.currentPeriodEndIso,
|
|
185
192
|
...(payload.cancelAtIso !== undefined && { cancelAtIso: payload.cancelAtIso }),
|
|
186
|
-
...(
|
|
193
|
+
...(consentId !== undefined && { consentId }),
|
|
187
194
|
...(payload.providerEventAtIso !== undefined && {
|
|
188
195
|
providerEventAtIso: payload.providerEventAtIso,
|
|
189
196
|
}),
|
|
@@ -225,6 +232,93 @@ function isStaleSubscriptionEvent(current, payload, now) {
|
|
|
225
232
|
isSwitchableSubscriptionStatus(payload.status);
|
|
226
233
|
return !supersedesCurrent;
|
|
227
234
|
}
|
|
235
|
+
function isBoundToLedgerEntry(ctx, entry, payload) {
|
|
236
|
+
const plugin = findProviderPlugin(ctx, payload.providerName)?.plugin;
|
|
237
|
+
return plugin?.priceToTier?.[entry.priceId] === payload.tier;
|
|
238
|
+
}
|
|
239
|
+
// A plan switch has no checkout of its own: its consent is the newest one recorded for the target
|
|
240
|
+
// tier, as long as no stored subscription event carries it yet. No window by state events: another
|
|
241
|
+
// state event (renewal, status change) may arrive between the consent and the tier change. The age
|
|
242
|
+
// limit keeps an abandoned consent from being attached to a portal switch months later.
|
|
243
|
+
const SWITCH_CONSENT_MAX_AGE_HOURS = 24;
|
|
244
|
+
function providerEventInstant(payload, now) {
|
|
245
|
+
const iso = clampProviderEventAt(payload, now).providerEventAtIso;
|
|
246
|
+
return iso === undefined ? now : Temporal.Instant.from(iso);
|
|
247
|
+
}
|
|
248
|
+
function pendingSwitchConsentId(storedEvents, payload, now) {
|
|
249
|
+
const referenceAt = providerEventInstant(payload, now);
|
|
250
|
+
const oldestAcceptedAt = referenceAt.subtract({ hours: SWITCH_CONSENT_MAX_AGE_HOURS });
|
|
251
|
+
const carried = new Set();
|
|
252
|
+
for (const stored of storedEvents) {
|
|
253
|
+
// skip: only subscription state events can carry a consent
|
|
254
|
+
if (!STATE_EVENT_QNS.has(stored.type))
|
|
255
|
+
continue;
|
|
256
|
+
const consentId = propertyOf(stored.payload, "consentId");
|
|
257
|
+
if (typeof consentId === "string")
|
|
258
|
+
carried.add(consentId);
|
|
259
|
+
}
|
|
260
|
+
for (let index = storedEvents.length - 1; index >= 0; index--) {
|
|
261
|
+
const stored = storedEvents[index];
|
|
262
|
+
if (stored?.type !== CHECKOUT_CONSENT_RECORDED_EVENT_QN)
|
|
263
|
+
continue;
|
|
264
|
+
if (Temporal.Instant.compare(stored.createdAt, oldestAcceptedAt) < 0)
|
|
265
|
+
continue;
|
|
266
|
+
const parsed = checkoutConsentRecordedPayloadSchema.safeParse(stored.payload);
|
|
267
|
+
if (!parsed.success)
|
|
268
|
+
continue;
|
|
269
|
+
const consent = parsed.data;
|
|
270
|
+
if (consent.mode === "subscription" &&
|
|
271
|
+
consent.tier === payload.tier &&
|
|
272
|
+
(consent.providerName === undefined || consent.providerName === payload.providerName) &&
|
|
273
|
+
!carried.has(consent.consentId)) {
|
|
274
|
+
return consent.consentId;
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
return undefined;
|
|
278
|
+
}
|
|
279
|
+
// A `created` that never comes (subscription from before the ledger, foreign custom_data, deleted
|
|
280
|
+
// subscription) would otherwise answer 503 until the provider gives up, and Stripe disables an
|
|
281
|
+
// endpoint that keeps failing. Only a young event may still be overtaken by its `created`.
|
|
282
|
+
// A provider that sends no event time (mollie) cannot be aged and keeps retrying.
|
|
283
|
+
const MISSING_SUBSCRIPTION_RETRY_WINDOW_MINUTES = 60;
|
|
284
|
+
function isWithinMissingSubscriptionRetryWindow(payload, now) {
|
|
285
|
+
if (payload.providerEventAtIso === undefined)
|
|
286
|
+
return true;
|
|
287
|
+
const oldestRetriedAt = now.subtract({ minutes: MISSING_SUBSCRIPTION_RETRY_WINDOW_MINUTES });
|
|
288
|
+
return Temporal.Instant.compare(providerEventInstant(payload, now), oldestRetriedAt) >= 0;
|
|
289
|
+
}
|
|
290
|
+
function admitProviderEvent(ctx, storedEvents, current, payload, now) {
|
|
291
|
+
const entry = payload.providerCheckoutId === undefined
|
|
292
|
+
? undefined
|
|
293
|
+
: findCheckoutOpened(storedEvents, {
|
|
294
|
+
providerName: payload.providerName,
|
|
295
|
+
providerCheckoutId: payload.providerCheckoutId,
|
|
296
|
+
mode: "subscription",
|
|
297
|
+
});
|
|
298
|
+
if (entry !== undefined && isBoundToLedgerEntry(ctx, entry, payload)) {
|
|
299
|
+
return { admitted: true, ...(entry.consentId !== undefined && { consentId: entry.consentId }) };
|
|
300
|
+
}
|
|
301
|
+
if (payload.type === SubscriptionEventTypes.created) {
|
|
302
|
+
return { admitted: false, reason: IgnoredEventReasons.checkoutNotInLedger };
|
|
303
|
+
}
|
|
304
|
+
// The provider does not guarantee order: an update that beats the `created` of its
|
|
305
|
+
// subscription must be redelivered, not dropped.
|
|
306
|
+
if (current === null) {
|
|
307
|
+
return {
|
|
308
|
+
admitted: false,
|
|
309
|
+
reason: IgnoredEventReasons.subscriptionNotYetCreated,
|
|
310
|
+
...(isWithinMissingSubscriptionRetryWindow(payload, now) && { retry: true }),
|
|
311
|
+
};
|
|
312
|
+
}
|
|
313
|
+
const isCurrentSubscription = current.providerName === payload.providerName &&
|
|
314
|
+
current.providerSubscriptionId === payload.providerSubscriptionId;
|
|
315
|
+
if (!isCurrentSubscription)
|
|
316
|
+
return { admitted: false, reason: IgnoredEventReasons.foreignSubscription };
|
|
317
|
+
const switchConsentId = payload.type === SubscriptionEventTypes.updated && current.tier !== payload.tier
|
|
318
|
+
? pendingSwitchConsentId(storedEvents, payload, now)
|
|
319
|
+
: undefined;
|
|
320
|
+
return { admitted: true, ...(switchConsentId !== undefined && { consentId: switchConsentId }) };
|
|
321
|
+
}
|
|
228
322
|
export function createProcessEventHandler(now) {
|
|
229
323
|
return {
|
|
230
324
|
name: "process-event",
|
|
@@ -234,19 +328,32 @@ export function createProcessEventHandler(now) {
|
|
|
234
328
|
handler: async (event, ctx) => {
|
|
235
329
|
// @cast-boundary engine-payload — dispatcher-zod-validated payload
|
|
236
330
|
const payload = event.payload;
|
|
331
|
+
const aggId = subscriptionAggregateId(event.user.tenantId);
|
|
332
|
+
// One locked load serves admission and the append; the stream grows with every opened checkout.
|
|
333
|
+
// The lock comes first so the stream and `current` are both read under it.
|
|
334
|
+
const stream = await lockAndLoadSubscriptionStream(ctx, aggId);
|
|
237
335
|
const current = await getSubscriptionForTenant(ctx, event.user.tenantId);
|
|
238
|
-
|
|
239
|
-
|
|
336
|
+
const admission = admitProviderEvent(ctx, stream, current, payload, now());
|
|
337
|
+
if (!admission.admitted) {
|
|
338
|
+
ctx.obs.log?.warn(`[billing-foundation:process-event] ignored ${payload.type} ${payload.providerEventId} (${admission.reason}): provider ${payload.providerName}`);
|
|
240
339
|
return {
|
|
241
340
|
isSuccess: true,
|
|
242
341
|
data: {
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
342
|
+
ignored: true,
|
|
343
|
+
reason: admission.reason,
|
|
344
|
+
...(admission.retry === true && { retry: true }),
|
|
345
|
+
subscriptionAggregateId: aggId,
|
|
246
346
|
},
|
|
247
347
|
};
|
|
248
348
|
}
|
|
249
|
-
|
|
349
|
+
if (isStaleSubscriptionEvent(current, payload, now())) {
|
|
350
|
+
ctx.obs.log?.warn(`[billing-foundation:process-event] dropped stale ${payload.type} ${payload.providerEventId}: tenant already tracks another subscription`);
|
|
351
|
+
return {
|
|
352
|
+
isSuccess: true,
|
|
353
|
+
data: { duplicate: false, stale: true, subscriptionAggregateId: aggId },
|
|
354
|
+
};
|
|
355
|
+
}
|
|
356
|
+
const result = await appendSubscriptionEvent(ctx, event.user.tenantId, payload, now(), admission.consentId, stream);
|
|
250
357
|
return { isSuccess: true, data: result };
|
|
251
358
|
},
|
|
252
359
|
};
|
|
@@ -3,10 +3,9 @@ import * as z from "zod";
|
|
|
3
3
|
export declare const processPaymentEventSchema: z.ZodObject<{
|
|
4
4
|
providerEventId: z.ZodString;
|
|
5
5
|
providerName: z.ZodString;
|
|
6
|
-
providerCheckoutId: z.
|
|
6
|
+
providerCheckoutId: z.ZodString;
|
|
7
7
|
providerCustomerId: z.ZodString;
|
|
8
8
|
priceId: z.ZodString;
|
|
9
9
|
quantity: z.ZodOptional<z.ZodNumber>;
|
|
10
|
-
consentId: z.ZodOptional<z.ZodString>;
|
|
11
10
|
}, z.core.$strip>;
|
|
12
11
|
export declare const processPaymentEventHandler: WriteHandlerDef;
|
|
@@ -6,23 +6,25 @@
|
|
|
6
6
|
// 1. Idempotency-check: loads the payment-stream and scans for an
|
|
7
7
|
// already-seen `metadata.providerEventId`. A provider-replay with
|
|
8
8
|
// the same event-id → duplicate=true, no second append.
|
|
9
|
-
// 2.
|
|
9
|
+
// 2. Ledger check: the payment must name a checkout the server opened itself
|
|
10
|
+
// (same provider, same price); anything else is ignored.
|
|
11
|
+
// 3. ctx.events.unsafeAppend — inline-projection materializes a new
|
|
10
12
|
// `read_payments`-row (INSERT-once, not UPSERT — every payment is
|
|
11
13
|
// its own fact, not a state-update).
|
|
12
14
|
import { configuredPiiSubjectKms, encryptPiiFieldValues, } from "@cosmicdrift/kumiko-framework/crypto";
|
|
13
15
|
import * as z from "zod";
|
|
14
16
|
import { paymentAggregateId } from "../aggregate-id.js";
|
|
17
|
+
import { findCheckoutOpened, IgnoredEventReasons } from "../checkout-ledger.js";
|
|
15
18
|
import { PAYMENT_PII_FIELDS, paymentEntity } from "../entities.js";
|
|
16
|
-
import { PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, } from "../events.js";
|
|
19
|
+
import { PAYMENT_AGGREGATE_TYPE, PAYMENT_RECEIVED_EVENT_QN, PROVIDER_ID_MAX_CHARS, } from "../events.js";
|
|
17
20
|
import { hasSeenProviderEvent } from "../provider-event-seen.js";
|
|
18
21
|
export const processPaymentEventSchema = z.object({
|
|
19
22
|
providerEventId: z.string().min(1).max(200),
|
|
20
23
|
providerName: z.string().min(1).max(50),
|
|
21
|
-
providerCheckoutId: z.string().min(1).max(200)
|
|
22
|
-
providerCustomerId: z.string().min(1).max(
|
|
24
|
+
providerCheckoutId: z.string().min(1).max(200),
|
|
25
|
+
providerCustomerId: z.string().min(1).max(PROVIDER_ID_MAX_CHARS),
|
|
23
26
|
priceId: z.string().min(1).max(200),
|
|
24
27
|
quantity: z.number().int().positive().optional(),
|
|
25
|
-
consentId: z.string().min(1).max(100).optional(),
|
|
26
28
|
});
|
|
27
29
|
// SystemAdmin-only: this handler is called exclusively by the programmatic
|
|
28
30
|
// webhook-handler (with an internal SystemUser), never directly by the
|
|
@@ -51,7 +53,27 @@ export const processPaymentEventHandler = {
|
|
|
51
53
|
};
|
|
52
54
|
}
|
|
53
55
|
// ---------------------------------------------------------------
|
|
54
|
-
// 2.
|
|
56
|
+
// 2. Ledger: only checkouts this server opened may produce a payment.
|
|
57
|
+
// ---------------------------------------------------------------
|
|
58
|
+
const entry = findCheckoutOpened(existingEvents, {
|
|
59
|
+
providerName: payload.providerName,
|
|
60
|
+
providerCheckoutId: payload.providerCheckoutId,
|
|
61
|
+
mode: "payment",
|
|
62
|
+
});
|
|
63
|
+
const rejection = entry === undefined
|
|
64
|
+
? IgnoredEventReasons.checkoutNotInLedger
|
|
65
|
+
: entry.priceId !== payload.priceId
|
|
66
|
+
? IgnoredEventReasons.priceMismatch
|
|
67
|
+
: undefined;
|
|
68
|
+
if (rejection !== undefined) {
|
|
69
|
+
ctx.obs.log?.warn(`[billing-foundation:process-payment-event] ignored ${payload.providerEventId} (${rejection}): checkout ${payload.providerCheckoutId} of provider ${payload.providerName}`);
|
|
70
|
+
return {
|
|
71
|
+
isSuccess: true,
|
|
72
|
+
data: { ignored: true, reason: rejection, paymentAggregateId: aggId },
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
// ---------------------------------------------------------------
|
|
76
|
+
// 3. Encrypt the provider-subject PII field before it touches storage
|
|
55
77
|
// — same rationale as process-event.write.ts's step 3.
|
|
56
78
|
// ---------------------------------------------------------------
|
|
57
79
|
const piiKms = configuredPiiSubjectKms();
|
|
@@ -62,7 +84,7 @@ export const processPaymentEventHandler = {
|
|
|
62
84
|
}, { tenantId, entityName: PAYMENT_AGGREGATE_TYPE })
|
|
63
85
|
: { providerCustomerId: payload.providerCustomerId };
|
|
64
86
|
// ---------------------------------------------------------------
|
|
65
|
-
//
|
|
87
|
+
// 4. Append event on the payment-stream. Inline-projection
|
|
66
88
|
// materializes a new read_payments-row in the same TX.
|
|
67
89
|
// ---------------------------------------------------------------
|
|
68
90
|
const eventPayload = {
|
|
@@ -70,14 +92,12 @@ export const processPaymentEventHandler = {
|
|
|
70
92
|
providerCustomerId: encryptedFields.providerCustomerId,
|
|
71
93
|
priceId: payload.priceId,
|
|
72
94
|
...(payload.quantity !== undefined && { quantity: payload.quantity }),
|
|
73
|
-
...(
|
|
95
|
+
...(entry?.consentId !== undefined && { consentId: entry.consentId }),
|
|
74
96
|
};
|
|
75
97
|
const headers = {
|
|
76
98
|
providerEventId: payload.providerEventId,
|
|
77
99
|
providerName: payload.providerName,
|
|
78
|
-
|
|
79
|
-
providerCheckoutId: payload.providerCheckoutId,
|
|
80
|
-
}),
|
|
100
|
+
providerCheckoutId: payload.providerCheckoutId,
|
|
81
101
|
};
|
|
82
102
|
await ctx.events.unsafeAppend({
|
|
83
103
|
aggregateId: aggId,
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
// record-checkout-opened — ledgers a checkout that was opened before the
|
|
2
|
+
// ledger existed (provider migration jobs). Idempotent: an existing entry is
|
|
3
|
+
// left alone.
|
|
4
|
+
import { appendCheckoutOpened, findCheckoutOpened, ledgerAggregateId } from "../checkout-ledger.js";
|
|
5
|
+
import { checkoutOpenedPayloadSchema } from "../events.js";
|
|
6
|
+
export const recordCheckoutOpenedHandler = {
|
|
7
|
+
name: "record-checkout-opened",
|
|
8
|
+
agent: { expose: false },
|
|
9
|
+
schema: checkoutOpenedPayloadSchema,
|
|
10
|
+
access: { roles: ["SystemAdmin"] },
|
|
11
|
+
handler: async (event, ctx) => {
|
|
12
|
+
// @cast-boundary engine-payload — dispatcher-zod-validated payload
|
|
13
|
+
const entry = event.payload;
|
|
14
|
+
const tenantId = event.user.tenantId;
|
|
15
|
+
const existing = await ctx.events.load(ledgerAggregateId(tenantId, entry.mode));
|
|
16
|
+
if (findCheckoutOpened(existing, entry) !== undefined) {
|
|
17
|
+
return { isSuccess: true, data: { recorded: false } };
|
|
18
|
+
}
|
|
19
|
+
await appendCheckoutOpened(ctx, tenantId, entry);
|
|
20
|
+
return { isSuccess: true, data: { recorded: true } };
|
|
21
|
+
},
|
|
22
|
+
};
|