@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
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// subscription-paddle — Paddle Billing (merchant of record) plugin for the
|
|
4
4
|
// billing-foundation plugin API. Credentials, the billing-live master switch and
|
|
5
5
|
// the API environment (sandbox | live) are config keys resolved at call time, like
|
|
6
|
-
// subscription-stripe. The `apiKey` / `webhookSecret` /
|
|
6
|
+
// subscription-stripe. The `apiKey` / `webhookSecret` /
|
|
7
7
|
// `clientToken` options are env→config bridge fallbacks.
|
|
8
8
|
import { validateOneOffPriceIds, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
|
|
9
9
|
import { access, createSystemConfig, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
|
|
@@ -12,12 +12,15 @@ import { egress } from "@cosmicdrift/kumiko-framework/http";
|
|
|
12
12
|
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
13
13
|
import * as z from "zod";
|
|
14
14
|
import { priceEnvSchema } from "../shared/index.js";
|
|
15
|
+
import { runBackfillCheckoutLedger } from "./backfill-checkout-ledger.js";
|
|
15
16
|
import { makeCheckoutConfigQuery } from "./checkout-config.query.js";
|
|
16
17
|
import { createPaddleCancelSubscription, createPaddleCheckoutSession, createPaddlePortalSession, createPaddleResumeSubscription, } from "./checkout-methods.js";
|
|
17
18
|
import { servePaddleCheckoutPage } from "./checkout-page.js";
|
|
18
|
-
import { PADDLE_API_KEY_CONFIG, PADDLE_BILLING_LIVE_CONFIG, PADDLE_CLIENT_TOKEN_CONFIG, PADDLE_ENVIRONMENT_CONFIG, PADDLE_PROVIDER_NAME,
|
|
19
|
+
import { PADDLE_API_KEY_CONFIG, PADDLE_BILLING_LIVE_CONFIG, PADDLE_CLIENT_TOKEN_CONFIG, PADDLE_ENVIRONMENT_CONFIG, PADDLE_PROVIDER_NAME, PADDLE_WEBHOOK_SECRET_CONFIG, PaddleEnvironments, SUBSCRIPTION_PADDLE_FEATURE, } from "./constants.js";
|
|
20
|
+
import { LEDGER_BACKFILL_EVENT_SHORT, ledgerBackfillMarkerHandler, ledgerBackfillPayloadSchema, } from "./ledger-backfill-marker.js";
|
|
19
21
|
import { createPaddleApplyPlanSwitch, createPaddlePreviewPlanSwitch, createPaddleRetrieveSubscription, } from "./plan-switch-methods.js";
|
|
20
22
|
import { createPaddlePriceCache, createPaddleRetrievePrices } from "./price-methods.js";
|
|
23
|
+
import { shouldRedeliverLegacyCheckout } from "./redeliver-legacy-checkout.js";
|
|
21
24
|
import { createPaddleRuntimes } from "./runtime.js";
|
|
22
25
|
import { verifyAndParsePaddleWebhook } from "./webhook-events.js";
|
|
23
26
|
/** Bridge contract: all fields are optional fallbacks for the config store. */
|
|
@@ -34,12 +37,6 @@ export const subscriptionPaddleEnvSchema = z.object({
|
|
|
34
37
|
.describe("Paddle notification secret (`pdl_ntfset_...`). Bridge-fallback — prefer the secret.")
|
|
35
38
|
.meta({ kumiko: { pulumi: { secret: true } } })
|
|
36
39
|
.optional(),
|
|
37
|
-
PADDLE_TENANT_BINDING_KEY: z
|
|
38
|
-
.string()
|
|
39
|
-
.min(1)
|
|
40
|
-
.describe("Server-only HMAC key binding a Paddle checkout to its tenant. Bridge-fallback — prefer the secret.")
|
|
41
|
-
.meta({ kumiko: { pulumi: { secret: true } } })
|
|
42
|
-
.optional(),
|
|
43
40
|
PADDLE_CLIENT_TOKEN: z
|
|
44
41
|
.string()
|
|
45
42
|
.regex(/^(test|live)_/, "PADDLE_CLIENT_TOKEN must start with 'test_' or 'live_'")
|
|
@@ -63,7 +60,7 @@ export function createSubscriptionPaddleFeature(options = {}) {
|
|
|
63
60
|
validateOneOffPriceIds("subscription-paddle", options.oneOffPriceIds ?? []);
|
|
64
61
|
const now = options.now ?? (() => Temporal.Now.instant().epochMilliseconds);
|
|
65
62
|
const feature = defineFeature(SUBSCRIPTION_PADDLE_FEATURE, (r) => {
|
|
66
|
-
r.describe('Paddle Billing provider plugin for `billing-foundation`. Paddle acts as merchant of record: it sells to the customer and issues invoice and VAT, so the consumer-protection texts for this provider come from `consumerProtection.providerTexts`. Reads its API key
|
|
63
|
+
r.describe('Paddle Billing provider plugin for `billing-foundation`. Paddle acts as merchant of record: it sells to the customer and issues invoice and VAT, so the consumer-protection texts for this provider come from `consumerProtection.providerTexts`. Reads its API key and webhook secret from system config keys with `backing:"secrets"` (envelope-encrypted in the secrets store under the system tenant), the public Paddle.js `client-token`, a `billingLive` master switch and an `environment` key (sandbox | live). `environment` is its own key because Paddle serves sandbox and live from different API hosts and a live key must never hit the sandbox host or the other way round; `billingLive` only decides whether checkouts are offered at all. All of them are runtime config, so keys rotate and prod goes live without a redeploy, and the `mask` on each derives the sysadmin settings screen and nav. Mount via `createSubscriptionPaddleFeature({ priceToTier })`; the optional `apiKey`/`webhookSecret`/`clientToken` options are env to config bridge fallbacks (`PADDLE_API_KEY`, `PADDLE_WEBHOOK_SECRET`, `PADDLE_CLIENT_TOKEN`). The plugin always mounts; `createCheckoutSession` throws `feature_disabled` unless `billingLive` is true, and billing counts as enabled only with the API key present. Webhooks arrive at `/webhooks/subscription/paddle` when mounted through the server-runtime `billing.paddle` boot option, or at `/api/subscription/webhook/paddle` when `createSubscriptionWebhookRoute` is mounted by hand and are verified with the `Paddle-Signature` header (HMAC-SHA256 over `ts:rawBody` keyed with the raw secret, any `h1` may match, 5 minute tolerance). Paddle.js can open checkouts with arbitrary `customData` from the browser, so `custom_data.tenantId` only locates the tenant stream: billing-foundation keeps a checkout ledger and accepts a webhook only for a transaction the server opened itself (a `subscription.created` must name it in `transaction_id`), so events for prices outside `priceToTier`, without a tenant or for foreign transactions are dropped. The `backfill-checkout-ledger` job ledgers Paddle checkouts that were open when the ledger was introduced, then goes quiet. Paddle has no hosted checkout page, so the feature serves the Default Payment Link itself at `/billing/paddle-checkout` (the Default Payment Link in the Paddle dashboard must point to `<APP_BASE_URL>/billing/paddle-checkout`; it is the only source, because checkouts are created without a `checkout.url`). Create subscription prices in the Paddle catalog with quantity minimum and maximum 1; for one-off packs set the quantity limits on purpose, because the payment event carries `quantity` and the app has to multiply its credits by it: an anonymous page with its own CSP that loads Paddle.js from cdn.paddle.com, the one external script this framework allows, and opens the overlay for the transaction. Implements checkout, customer portal, cancel and resume, `retrievePrices` (batched, 10-minute TTL cache), `retrieveSubscription` for the sync job, and an in-app plan switch: `previewPlanSwitch` shows the proration before the customer confirms, `applyPlanSwitch` changes the plan without a hosted page and waits for the `subscription.updated` webhook to move the tier.');
|
|
67
64
|
r.uiHints({
|
|
68
65
|
displayLabel: "Billing · Paddle",
|
|
69
66
|
category: "billing",
|
|
@@ -87,12 +84,6 @@ export function createSubscriptionPaddleFeature(options = {}) {
|
|
|
87
84
|
read: access.admin,
|
|
88
85
|
mask: { title: "subscription-paddle.webhook-secret", icon: "shield", order: 2 },
|
|
89
86
|
}),
|
|
90
|
-
[PADDLE_TENANT_BINDING_KEY_CONFIG]: createSystemConfig("text", {
|
|
91
|
-
backing: "secrets",
|
|
92
|
-
write: access.systemAdmin,
|
|
93
|
-
read: access.admin,
|
|
94
|
-
mask: { title: "subscription-paddle.tenant-binding-key", icon: "lock", order: 3 },
|
|
95
|
-
}),
|
|
96
87
|
[PADDLE_CLIENT_TOKEN_CONFIG]: createSystemConfig("text", {
|
|
97
88
|
write: access.systemAdmin,
|
|
98
89
|
read: access.admin,
|
|
@@ -117,7 +108,6 @@ export function createSubscriptionPaddleFeature(options = {}) {
|
|
|
117
108
|
keys: {
|
|
118
109
|
"subscription-paddle.api-key": { en: "Paddle API key" },
|
|
119
110
|
"subscription-paddle.webhook-secret": { en: "Paddle webhook secret" },
|
|
120
|
-
"subscription-paddle.tenant-binding-key": { en: "Paddle tenant binding key" },
|
|
121
111
|
"subscription-paddle.client-token": { en: "Paddle client-side token" },
|
|
122
112
|
"subscription-paddle.environment": { en: "Paddle environment" },
|
|
123
113
|
"subscription-paddle.billing-live": { en: "Live billing" },
|
|
@@ -129,7 +119,6 @@ export function createSubscriptionPaddleFeature(options = {}) {
|
|
|
129
119
|
const runtimes = createPaddleRuntimes({
|
|
130
120
|
apiKeyHandle: configKeys[PADDLE_API_KEY_CONFIG],
|
|
131
121
|
webhookSecretHandle: configKeys[PADDLE_WEBHOOK_SECRET_CONFIG],
|
|
132
|
-
tenantBindingKeyHandle: configKeys[PADDLE_TENANT_BINDING_KEY_CONFIG],
|
|
133
122
|
clientTokenHandle: configKeys[PADDLE_CLIENT_TOKEN_CONFIG],
|
|
134
123
|
billingLiveHandle: configKeys[PADDLE_BILLING_LIVE_CONFIG],
|
|
135
124
|
environmentHandle: configKeys[PADDLE_ENVIRONMENT_CONFIG],
|
|
@@ -137,13 +126,23 @@ export function createSubscriptionPaddleFeature(options = {}) {
|
|
|
137
126
|
fallback: {
|
|
138
127
|
...(options.apiKey !== undefined && { apiKey: options.apiKey }),
|
|
139
128
|
...(options.webhookSecret !== undefined && { webhookSecret: options.webhookSecret }),
|
|
140
|
-
...(options.tenantBindingKey !== undefined && {
|
|
141
|
-
tenantBindingKey: options.tenantBindingKey,
|
|
142
|
-
}),
|
|
143
129
|
...(options.clientToken !== undefined && { clientToken: options.clientToken }),
|
|
144
130
|
},
|
|
145
131
|
});
|
|
146
132
|
r.queryHandler(makeCheckoutConfigQuery(runtimes.readCheckoutConfig));
|
|
133
|
+
r.defineEvent(LEDGER_BACKFILL_EVENT_SHORT, ledgerBackfillPayloadSchema, { piiFields: "none" });
|
|
134
|
+
r.writeHandler(ledgerBackfillMarkerHandler);
|
|
135
|
+
r.job({
|
|
136
|
+
name: "backfill-checkout-ledger",
|
|
137
|
+
trigger: { cron: "*/5 * * * *" },
|
|
138
|
+
concurrency: "skip",
|
|
139
|
+
// writeAs: ledgers each checkout in the stream of the tenant that opened it.
|
|
140
|
+
escapeHatch: {
|
|
141
|
+
reason: "ledgers open legacy Paddle checkouts in each tenant's stream via writeAs",
|
|
142
|
+
grants: ["systemIdentity"],
|
|
143
|
+
},
|
|
144
|
+
handler: (_payload, ctx) => runBackfillCheckoutLedger(ctx, { runtime: runtimes.ctx, priceToTier }),
|
|
145
|
+
});
|
|
147
146
|
r.httpRoute({
|
|
148
147
|
method: "GET",
|
|
149
148
|
// Literal for the feature-AST extractor; must equal PADDLE_CHECKOUT_PATH (integration test).
|
|
@@ -156,8 +155,10 @@ export function createSubscriptionPaddleFeature(options = {}) {
|
|
|
156
155
|
displayName: "Paddle",
|
|
157
156
|
verifyAndParseWebhook: verifyAndParsePaddleWebhook(runtimes.webhook, {
|
|
158
157
|
priceToTier,
|
|
158
|
+
oneOffPriceIds: options.oneOffPriceIds ?? [],
|
|
159
159
|
...(options.nowSeconds && { nowSeconds: options.nowSeconds }),
|
|
160
160
|
}),
|
|
161
|
+
shouldRedeliverIgnoredEvent: ({ event, reason, deps }) => shouldRedeliverLegacyCheckout({ event, reason, deps }),
|
|
161
162
|
createCheckoutSession: createPaddleCheckoutSession(runtimes.ctx),
|
|
162
163
|
createPortalSession: createPaddlePortalSession(runtimes.ctx),
|
|
163
164
|
cancelSubscription: createPaddleCancelSubscription(runtimes.ctx),
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
|
|
2
|
+
import * as z from "zod";
|
|
3
|
+
export declare const LEDGER_BACKFILL_EVENT_SHORT: "ledger-backfill-sweep-completed";
|
|
4
|
+
export declare const LEDGER_BACKFILL_EVENT_QN: "subscription-paddle:event:ledger-backfill-sweep-completed";
|
|
5
|
+
export declare const LEDGER_BACKFILL_AGGREGATE_TYPE: "paddle-ledger-backfill";
|
|
6
|
+
export declare const LEDGER_BACKFILL_AGGREGATE_ID: string;
|
|
7
|
+
export declare const ledgerBackfillPayloadSchema: z.ZodObject<{
|
|
8
|
+
completedAt: z.ZodString;
|
|
9
|
+
}, z.core.$strip>;
|
|
10
|
+
export declare const ledgerBackfillMarkerPayloadSchema: z.ZodObject<{
|
|
11
|
+
markCompleted: z.ZodBoolean;
|
|
12
|
+
}, z.core.$strip>;
|
|
13
|
+
export type LedgerBackfillMarkerResult = {
|
|
14
|
+
readonly completedAt: string | null;
|
|
15
|
+
};
|
|
16
|
+
export declare const LEDGER_BACKFILL_MARKER_HANDLER_QN: "subscription-paddle:write:ledger-backfill-marker";
|
|
17
|
+
export declare const ledgerBackfillMarkerHandler: WriteHandlerDef;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
// Marker for the one-time checkout-ledger backfill: the first completed sweep is
|
|
2
|
+
// recorded as an event on a fixed system-tenant stream, so every worker and every
|
|
3
|
+
// restart agrees on when the takeover window began.
|
|
4
|
+
import { v5 as uuidv5 } from "uuid";
|
|
5
|
+
import * as z from "zod";
|
|
6
|
+
import { SUBSCRIPTION_PADDLE_FEATURE } from "./constants.js";
|
|
7
|
+
export const LEDGER_BACKFILL_EVENT_SHORT = "ledger-backfill-sweep-completed";
|
|
8
|
+
export const LEDGER_BACKFILL_EVENT_QN = `${SUBSCRIPTION_PADDLE_FEATURE}:event:${LEDGER_BACKFILL_EVENT_SHORT}`;
|
|
9
|
+
export const LEDGER_BACKFILL_AGGREGATE_TYPE = "paddle-ledger-backfill";
|
|
10
|
+
// Set in stone: changing it would orphan the marker and restart the takeover window.
|
|
11
|
+
const LEDGER_BACKFILL_NAMESPACE = "b4c1e7a2-5d38-4f6b-9a0e-2c7d8e1f3a59";
|
|
12
|
+
export const LEDGER_BACKFILL_AGGREGATE_ID = uuidv5("paddle-ledger-backfill", LEDGER_BACKFILL_NAMESPACE);
|
|
13
|
+
export const ledgerBackfillPayloadSchema = z.object({ completedAt: z.string().min(1) });
|
|
14
|
+
export const ledgerBackfillMarkerPayloadSchema = z.object({ markCompleted: z.boolean() });
|
|
15
|
+
export const LEDGER_BACKFILL_MARKER_HANDLER_QN = `${SUBSCRIPTION_PADDLE_FEATURE}:write:ledger-backfill-marker`;
|
|
16
|
+
// Reads the marker; with markCompleted it also writes it when absent. One handler
|
|
17
|
+
// for both, so the job never reads an event stream itself.
|
|
18
|
+
export const ledgerBackfillMarkerHandler = {
|
|
19
|
+
name: "ledger-backfill-marker",
|
|
20
|
+
agent: { expose: false },
|
|
21
|
+
schema: ledgerBackfillMarkerPayloadSchema,
|
|
22
|
+
access: { roles: ["system"] },
|
|
23
|
+
handler: async (event, ctx) => {
|
|
24
|
+
// @cast-boundary engine-payload — dispatcher-zod-validated payload
|
|
25
|
+
const { markCompleted } = event.payload;
|
|
26
|
+
const stored = await ctx.events.load(LEDGER_BACKFILL_AGGREGATE_ID);
|
|
27
|
+
const marker = stored.find((entry) => entry.type === LEDGER_BACKFILL_EVENT_QN);
|
|
28
|
+
if (marker) {
|
|
29
|
+
const parsed = ledgerBackfillPayloadSchema.parse(marker.payload);
|
|
30
|
+
return {
|
|
31
|
+
isSuccess: true,
|
|
32
|
+
data: { completedAt: parsed.completedAt },
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
if (!markCompleted) {
|
|
36
|
+
return {
|
|
37
|
+
isSuccess: true,
|
|
38
|
+
data: { completedAt: null },
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
const completedAt = ctx.tz.now().toString();
|
|
42
|
+
await ctx.events.unsafeAppend({
|
|
43
|
+
aggregateId: LEDGER_BACKFILL_AGGREGATE_ID,
|
|
44
|
+
aggregateType: LEDGER_BACKFILL_AGGREGATE_TYPE,
|
|
45
|
+
type: LEDGER_BACKFILL_EVENT_QN,
|
|
46
|
+
payload: { completedAt },
|
|
47
|
+
});
|
|
48
|
+
return {
|
|
49
|
+
isSuccess: true,
|
|
50
|
+
data: { completedAt },
|
|
51
|
+
};
|
|
52
|
+
},
|
|
53
|
+
};
|
|
@@ -5,7 +5,6 @@ import { paddleSubscriptionPath } from "./checkout-methods.js";
|
|
|
5
5
|
import { PaddleHttpError } from "./client.js";
|
|
6
6
|
import { paddleAmountSchema } from "./price-methods.js";
|
|
7
7
|
import { mapPaddleSubscriptionState, paddleSubscriptionSchema } from "./subscription-state.js";
|
|
8
|
-
import { signTenantBinding } from "./tenant-binding.js";
|
|
9
8
|
const NOT_FOUND = 404;
|
|
10
9
|
function parseAmount(amount) {
|
|
11
10
|
return Number.parseInt(amount, 10);
|
|
@@ -67,21 +66,16 @@ export function createPaddlePreviewPlanSwitch(runtime, now) {
|
|
|
67
66
|
}
|
|
68
67
|
// The switch itself arrives later as a subscription.updated webhook;
|
|
69
68
|
// prevent_change keeps the old plan if the immediate charge fails. PATCH
|
|
70
|
-
// replaces custom_data as a whole, so the tenant
|
|
69
|
+
// replaces custom_data as a whole, so the tenant id (the webhook's stream locator) is sent again.
|
|
71
70
|
export function createPaddleApplyPlanSwitch(runtime) {
|
|
72
71
|
return async (ctx, options) => {
|
|
73
|
-
const bindingKey = await runtime.tenantBindingKey(ctx);
|
|
74
72
|
await runtime.call(ctx, {
|
|
75
73
|
method: "PATCH",
|
|
76
74
|
path: paddleSubscriptionPath(options.providerSubscriptionId),
|
|
77
75
|
body: {
|
|
78
76
|
...changePlanBody(options.targetPriceId),
|
|
79
77
|
on_payment_failure: "prevent_change",
|
|
80
|
-
custom_data: {
|
|
81
|
-
tenantId: options.tenantId,
|
|
82
|
-
tenantBinding: signTenantBinding(bindingKey, options.tenantId),
|
|
83
|
-
...(options.consentId && { consentId: options.consentId }),
|
|
84
|
-
},
|
|
78
|
+
custom_data: { tenantId: options.tenantId },
|
|
85
79
|
},
|
|
86
80
|
});
|
|
87
81
|
};
|
|
@@ -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,43 @@
|
|
|
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 { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
|
|
7
|
+
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
8
|
+
import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
9
|
+
import { isTakeoverWindowOver } from "./backfill-checkout-ledger.js";
|
|
10
|
+
import { LEDGER_BACKFILL_MARKER_HANDLER_QN, } from "./ledger-backfill-marker.js";
|
|
11
|
+
import { hasLegacyTenantBinding } from "./webhook-events.js";
|
|
12
|
+
const log = createFallbackLogger("subscription-paddle");
|
|
13
|
+
// A retry cannot fix these: the marker handler is missing, disabled or not permitted.
|
|
14
|
+
const MARKER_CONFIGURATION_ERROR_CODES = [
|
|
15
|
+
"access_denied",
|
|
16
|
+
"not_found",
|
|
17
|
+
"feature_disabled",
|
|
18
|
+
];
|
|
19
|
+
export async function shouldRedeliverLegacyCheckout(args) {
|
|
20
|
+
if (!hasLegacyTenantBinding(args.event))
|
|
21
|
+
return false;
|
|
22
|
+
const marker = await args.deps.dispatchWriteAs({
|
|
23
|
+
handlerQn: LEDGER_BACKFILL_MARKER_HANDLER_QN,
|
|
24
|
+
tenantId: SYSTEM_TENANT_ID,
|
|
25
|
+
roles: [],
|
|
26
|
+
payload: { markCompleted: false },
|
|
27
|
+
});
|
|
28
|
+
if (!marker.isSuccess) {
|
|
29
|
+
// tenantBinding is client-settable, so a permanent failure must not turn into endless 503s.
|
|
30
|
+
if (isOneOf(MARKER_CONFIGURATION_ERROR_CODES, marker.error.code)) {
|
|
31
|
+
log.warn("ledger backfill marker not readable, not redelivering", {
|
|
32
|
+
errorCode: marker.error.code,
|
|
33
|
+
});
|
|
34
|
+
return false;
|
|
35
|
+
}
|
|
36
|
+
// Transient or internal: Paddle redelivers only a bounded number of times, so retrying is safe.
|
|
37
|
+
return true;
|
|
38
|
+
}
|
|
39
|
+
const { completedAt } = marker.data; // @cast-boundary engine-payload
|
|
40
|
+
if (completedAt === null)
|
|
41
|
+
return true;
|
|
42
|
+
return !isTakeoverWindowOver(completedAt, (args.now ?? Temporal.Now.instant)());
|
|
43
|
+
}
|
|
@@ -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:
|
|
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
|
-
|
|
74
|
-
if (live !== true)
|
|
74
|
+
if (!(await isBillingLive(ctx, deps.billingLiveHandle)))
|
|
75
75
|
return false;
|
|
76
|
-
return
|
|
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.
|
|
3
|
-
//
|
|
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
|
|
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
|
|
54
|
-
if (!
|
|
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
|
|
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,
|
|
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
|
|
83
|
-
const state = mapPaddleSubscriptionState(sub,
|
|
84
|
-
if (!
|
|
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
|
|
92
|
-
...(
|
|
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,
|
|
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
|
-
|
|
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)
|