@cosmicdrift/kumiko-bundled-features 0.413.1 → 0.414.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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/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 +11 -12
- 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.js +8 -1
- package/dist/billing-foundation/checkout-ledger.d.ts +15 -0
- package/dist/billing-foundation/checkout-ledger.js +32 -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 +22 -0
- package/dist/billing-foundation/events.js +38 -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 +1 -1
- package/dist/billing-foundation/handlers/process-event.write.d.ts +2 -2
- package/dist/billing-foundation/handlers/process-event.write.js +94 -12
- package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
- package/dist/billing-foundation/handlers/process-payment-event.write.js +29 -9
- 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 +1 -1
- 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 +87 -0
- package/dist/channel-whatsapp/events.js +70 -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 +127 -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 +185 -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/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 +1 -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 +41 -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/report-ingest-progress.d.ts +1 -1
- package/dist/document-ingest-foundation/report-ingest-progress.js +29 -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 +24 -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/helpdesk/entity.js +4 -1
- package/dist/helpdesk/feature.js +36 -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 +4 -5
- package/dist/helpdesk/handlers/report.write.js +3 -7
- package/dist/helpdesk/handlers/submit.write.js +4 -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 +121 -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 +7 -1
- package/dist/helpdesk/lib.js +29 -29
- 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 +1 -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 +1 -0
- package/dist/inbound-mail-foundation/content-refetch.js +15 -1
- package/dist/inbound-mail-foundation/entities.js +57 -15
- package/dist/inbound-mail-foundation/events.js +15 -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 +12 -7
- package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
- package/dist/inbound-mail-foundation/handlers/forget-message.write.js +54 -0
- 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/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/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 +106 -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/index.d.ts +6 -2
- package/dist/shared/index.js +6 -2
- 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 +2 -0
- package/dist/shared/send-best-effort.js +14 -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 +38 -2
- package/dist/step-dispatcher/feature.js +20 -2
- package/dist/step-dispatcher/mail-runner.js +0 -1
- package/dist/step-dispatcher/sweep-abandoned.d.ts +10 -0
- package/dist/step-dispatcher/sweep-abandoned.js +43 -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 +110 -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 +26 -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 +21 -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 +67 -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 +41 -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 +5 -5
- package/dist/tenant-inactivity/constants.js +1 -2
- package/dist/tenant-inactivity/handlers/keep-account.write.js +1 -2
- package/dist/tenant-inactivity/state-store.d.ts +1 -0
- package/dist/tenant-inactivity/state-store.js +9 -1
- package/dist/tenant-lifecycle/constants.d.ts +1 -0
- package/dist/tenant-lifecycle/constants.js +3 -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/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/submit.write.js +5 -18
- package/dist/waitlist/lib.js +2 -7
- 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 +4 -3
- 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/billing-foundation/changes.json +37 -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 +8 -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 +6 -0
- package/src/documents/changes.json +18 -0
- package/src/file-provider-s3/changes.json +14 -0
- package/src/files/changes.json +7 -0
- package/src/helpdesk/changes.json +50 -0
- package/src/inbound-mail-foundation/changes.json +48 -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 +6 -0
- package/src/step-dispatcher/changes.json +12 -0
- package/src/subscription-mollie/changes.json +7 -0
- package/src/subscription-paddle/changes.json +13 -0
- package/src/subscription-stripe/changes.json +7 -0
- package/src/template-resolver/changes.json +36 -0
- package/src/tenant/changes.json +6 -0
- package/src/tenant-lifecycle/changes.json +18 -0
- package/src/tier-engine/changes.json +6 -0
- package/src/user/changes.json +6 -0
- package/src/waitlist/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
|
@@ -11,8 +11,9 @@
|
|
|
11
11
|
import { defineFeature, STEP_DISPATCH_AGGREGATE_TYPE, STEP_DISPATCH_REQUESTED_TYPE, } from "@cosmicdrift/kumiko-framework/engine";
|
|
12
12
|
import { createMultiStreamApplyContext } from "@cosmicdrift/kumiko-framework/pipeline";
|
|
13
13
|
import * as z from "zod";
|
|
14
|
-
import { DELIVER_MAX_PER_TENANT, DELIVER_RETRIES, deliverJobId, STEP_DISPATCHER_FEATURE, StepDispatcherJobs, } from "./constants.js";
|
|
14
|
+
import { ABANDON_DISPATCH_AFTER_HOURS, DELIVER_MAX_PER_TENANT, DELIVER_RETRIES, deliverJobId, STEP_DISPATCHER_FEATURE, StepDispatcherJobs, } from "./constants.js";
|
|
15
15
|
import { deliverDispatchRequest, eraseDispatchKey, isDispatchOutcome, } from "./deliver-dispatch-request.js";
|
|
16
|
+
import { sweepAbandonedDispatches } from "./sweep-abandoned.js";
|
|
16
17
|
import { WEBHOOK_ALLOWED_PRIVATE_HOSTS_ENV_VAR, WEBHOOK_AUTH_SECRET_NAMESPACE_OPTIONS, } from "./webhook-runner.js";
|
|
17
18
|
export const stepDispatcherEnvSchema = z.object({
|
|
18
19
|
[WEBHOOK_ALLOWED_PRIVATE_HOSTS_ENV_VAR]: z
|
|
@@ -23,10 +24,11 @@ export const stepDispatcherEnvSchema = z.object({
|
|
|
23
24
|
export { STEP_DISPATCH_AGGREGATE_TYPE };
|
|
24
25
|
const NEEDS_JOB_RUNNER_ERROR = "step-dispatcher needs a job runner (Redis) to deliver";
|
|
25
26
|
const DELIVER_ESCAPE_HATCH_REASON = "reads the dispatch stream and appends its outcome event, which needs a raw connection";
|
|
27
|
+
const SWEEP_ESCAPE_HATCH_REASON = "finds dispatch streams without an outcome across every tenant and appends their failure event";
|
|
26
28
|
const deliverJobPayloadSchema = z.object({ aggregateId: z.string() });
|
|
27
29
|
export function createStepDispatcherFeature() {
|
|
28
30
|
return defineFeature("step-dispatcher", (r) => {
|
|
29
|
-
r.describe("Internal system feature that drains deferred Tier-2 side-effects (currently `webhook.send` and `mail.send`) after their originating transaction commits. An `r.multiStreamProjection` on the `kumiko:system:step.dispatch-requested` system event enqueues one `step-dispatcher:job:deliver` BullMQ job per dispatch (Redis carries only the stream id and tenant, never the request payload). The job performs the actual HTTP or mail delivery and appends `kumiko:system:step.dispatched` or `kumiko:system:step.dispatch-failed` back onto the same stream, so the outcome is recorded in the event log without a separate status table. Transient failures (network error, timeout, 5xx, 408, 429, any mail adapter failure) are retried 3 times with exponential backoff; the outcome is recorded after the final attempt and the payload key is erased only then. Permanent failures (invalid url, blocked host, other 4xx, unavailable auth secret) are recorded immediately. At most 2 deliveries per tenant run at once (`maxPerTenant` with `onLimit: \"defer\"`), so a slow receiver of one tenant does not delay other tenants. Requires a job runner (Redis) and a worker consuming the job's default `worker` lane; without a job runner the projection fails loudly. Mount this feature explicitly via `createStepDispatcherFeature()` in your app's feature list alongside any features that use `r.step.webhook.send` or `r.step.mail.send`. Requires the `secrets` feature (`createSecretsFeature()`) to be mounted — `webhook.send` auth resolves per-tenant through it, under `step-dispatcher:webhook-auth.<name>`. Every `webhook.send` request carries `Idempotency-Key: <dispatch stream id>`, stable across retries and redeliveries of the same dispatch request; an explicit `Idempotency-Key` in `headers` takes precedence.");
|
|
31
|
+
r.describe("Internal system feature that drains deferred Tier-2 side-effects (currently `webhook.send` and `mail.send`) after their originating transaction commits. An `r.multiStreamProjection` on the `kumiko:system:step.dispatch-requested` system event enqueues one `step-dispatcher:job:deliver` BullMQ job per dispatch (Redis carries only the stream id and tenant, never the request payload). The job performs the actual HTTP or mail delivery and appends `kumiko:system:step.dispatched` or `kumiko:system:step.dispatch-failed` back onto the same stream, so the outcome is recorded in the event log without a separate status table. Transient failures (network error, timeout, 5xx, 408, 429, any mail adapter failure) are retried 3 times with exponential backoff; the outcome is recorded after the final attempt and the payload key is erased only then. A request that still has no outcome after 24 hours (job stalled or lost, or its final attempt could not record one) is closed by the daily `step-dispatcher:job:sweep-abandoned` cron (it pages through all such requests; requests that already have an outcome are not swept) with a generic `dispatch-failed` event and its payload key is erased. Permanent failures (invalid url, blocked host, other 4xx, unavailable auth secret) are recorded immediately. At most 2 deliveries per tenant run at once (`maxPerTenant` with `onLimit: \"defer\"`), so a slow receiver of one tenant does not delay other tenants. Requires a job runner (Redis) and a worker consuming the job's default `worker` lane; without a job runner the projection fails loudly. Mount this feature explicitly via `createStepDispatcherFeature()` in your app's feature list alongside any features that use `r.step.webhook.send` or `r.step.mail.send`. Requires the `secrets` feature (`createSecretsFeature()`) to be mounted — `webhook.send` auth resolves per-tenant through it, under `step-dispatcher:webhook-auth.<name>`. Every `webhook.send` request carries `Idempotency-Key: <dispatch stream id>`, stable across retries and redeliveries of the same dispatch request; an explicit `Idempotency-Key` in `headers` takes precedence.");
|
|
30
32
|
r.secretNamespace("webhook-auth", WEBHOOK_AUTH_SECRET_NAMESPACE_OPTIONS);
|
|
31
33
|
r.uiHints({
|
|
32
34
|
displayLabel: "Step Dispatcher · Deferred Side-Effects",
|
|
@@ -63,6 +65,22 @@ export function createStepDispatcherFeature() {
|
|
|
63
65
|
}),
|
|
64
66
|
});
|
|
65
67
|
});
|
|
68
|
+
// Literal name, mirrored by StepDispatcherJobNames.sweepAbandoned (pinned in feature.boot.test.ts).
|
|
69
|
+
r.job("sweep-abandoned", {
|
|
70
|
+
trigger: { cron: "17 3 * * *", wakesSleepingApp: false },
|
|
71
|
+
concurrency: "skip",
|
|
72
|
+
escapeHatch: { reason: SWEEP_ESCAPE_HATCH_REASON },
|
|
73
|
+
}, async (_payload, ctx) => {
|
|
74
|
+
await sweepAbandonedDispatches({
|
|
75
|
+
db: ctx.db.unsafeRaw(),
|
|
76
|
+
registry: ctx.registry,
|
|
77
|
+
startedBeforeIso: ctx.tz
|
|
78
|
+
.now()
|
|
79
|
+
.subtract({ hours: ABANDON_DISPATCH_AFTER_HOURS })
|
|
80
|
+
.toString(),
|
|
81
|
+
onCloseFailure: (aggregateId, errorName) => ctx.obs.log.warn("abandoned dispatch could not be closed", { aggregateId, errorName }),
|
|
82
|
+
});
|
|
83
|
+
});
|
|
66
84
|
r.multiStreamProjection({
|
|
67
85
|
name: "step-dispatcher",
|
|
68
86
|
apply: {
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
|
|
2
|
+
import { type Registry } from "@cosmicdrift/kumiko-framework/engine";
|
|
3
|
+
export type SweepAbandonedArgs = {
|
|
4
|
+
readonly db: DbRunner;
|
|
5
|
+
readonly registry: Registry;
|
|
6
|
+
readonly startedBeforeIso: string;
|
|
7
|
+
readonly onCloseFailure: (aggregateId: string, errorName: string) => void;
|
|
8
|
+
readonly batchSize?: number;
|
|
9
|
+
};
|
|
10
|
+
export declare function sweepAbandonedDispatches(args: SweepAbandonedArgs): Promise<void>;
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { STEP_DISPATCH_AGGREGATE_TYPE, STEP_DISPATCH_FAILED_TYPE, STEP_DISPATCH_REQUESTED_TYPE, STEP_DISPATCHED_TYPE, } from "@cosmicdrift/kumiko-framework/engine";
|
|
2
|
+
import { selectOpenStreamsStartedBefore } from "@cosmicdrift/kumiko-framework/event-store";
|
|
3
|
+
import { createMultiStreamApplyContext } from "@cosmicdrift/kumiko-framework/pipeline";
|
|
4
|
+
import { SYSTEM_USER_ID } from "@cosmicdrift/kumiko-types/identifiers";
|
|
5
|
+
import { STEP_DISPATCHER_FEATURE, SWEEP_ABANDONED_BATCH_SIZE } from "./constants.js";
|
|
6
|
+
import { closeAbandonedDispatch } from "./deliver-dispatch-request.js";
|
|
7
|
+
// Pages by id until a short page: a stream that fails permanently stays open and would otherwise
|
|
8
|
+
// occupy the front of every run, starving the streams behind it.
|
|
9
|
+
export async function sweepAbandonedDispatches(args) {
|
|
10
|
+
const batchSize = args.batchSize ?? SWEEP_ABANDONED_BATCH_SIZE;
|
|
11
|
+
let afterId;
|
|
12
|
+
for (;;) {
|
|
13
|
+
const page = await selectOpenStreamsStartedBefore(args.db, {
|
|
14
|
+
aggregateType: STEP_DISPATCH_AGGREGATE_TYPE,
|
|
15
|
+
startedType: STEP_DISPATCH_REQUESTED_TYPE,
|
|
16
|
+
closingTypes: [STEP_DISPATCHED_TYPE, STEP_DISPATCH_FAILED_TYPE],
|
|
17
|
+
startedBeforeIso: args.startedBeforeIso,
|
|
18
|
+
limit: batchSize,
|
|
19
|
+
...(afterId !== undefined && { afterId }),
|
|
20
|
+
});
|
|
21
|
+
for (const { tenantId, aggregateId } of page) {
|
|
22
|
+
const applyContext = createMultiStreamApplyContext({
|
|
23
|
+
registry: args.registry,
|
|
24
|
+
db: args.db,
|
|
25
|
+
tenantId,
|
|
26
|
+
userId: SYSTEM_USER_ID,
|
|
27
|
+
callerFeature: STEP_DISPATCHER_FEATURE,
|
|
28
|
+
});
|
|
29
|
+
try {
|
|
30
|
+
await closeAbandonedDispatch(applyContext, aggregateId);
|
|
31
|
+
}
|
|
32
|
+
catch (err) {
|
|
33
|
+
// One broken stream must not keep the others open; the next run retries it.
|
|
34
|
+
args.onCloseFailure(aggregateId, err instanceof Error ? err.name : "unknown");
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
const last = page.at(-1);
|
|
38
|
+
// skip: a short page is the last one
|
|
39
|
+
if (page.length < batchSize || last === undefined)
|
|
40
|
+
return;
|
|
41
|
+
afterId = last.id;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -15,4 +15,5 @@ export type MolliePriceConfig = {
|
|
|
15
15
|
};
|
|
16
16
|
export declare function createMollieCheckoutSession(client: MollieClient, priceToConfig: Readonly<Record<string, MolliePriceConfig>>, appWebhookUrl: string): (_ctx: HandlerContext, options: MollieCheckoutOptions) => Promise<{
|
|
17
17
|
url: string;
|
|
18
|
+
providerCheckoutId: string;
|
|
18
19
|
}>;
|
|
@@ -50,7 +50,6 @@ export function createMollieCheckoutSession(client, priceToConfig, appWebhookUrl
|
|
|
50
50
|
metadata: {
|
|
51
51
|
tenantId: options.tenantId,
|
|
52
52
|
priceId: options.priceId,
|
|
53
|
-
...(options.consentId && { consentId: options.consentId }),
|
|
54
53
|
},
|
|
55
54
|
})); // @cast-boundary engine-bridge
|
|
56
55
|
const checkoutHref = payment.getCheckoutUrl();
|
|
@@ -58,6 +57,6 @@ export function createMollieCheckoutSession(client, priceToConfig, appWebhookUrl
|
|
|
58
57
|
const mandateHint = sequenceType === SequenceType.first ? " — first-payment-mandates ggf. nicht aktiviert" : "";
|
|
59
58
|
throw new Error(`subscription-mollie: payment.getCheckoutUrl() returned null (sequenceType=${sequenceType})${mandateHint}`);
|
|
60
59
|
}
|
|
61
|
-
return { url: checkoutHref };
|
|
60
|
+
return { url: checkoutHref, providerCheckoutId: payment.id };
|
|
62
61
|
};
|
|
63
62
|
}
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
// call `customerSubscriptions.create` itself). The plugin does that
|
|
14
14
|
// (idempotent via a list check) so the foundation receives a created event
|
|
15
15
|
// with a subscription id.
|
|
16
|
-
import {
|
|
16
|
+
import { SubscriptionEventTypes, SubscriptionStatuses, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
|
|
17
17
|
import { createFallbackLogger } from "@cosmicdrift/kumiko-framework/logging";
|
|
18
18
|
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
19
19
|
import { MOLLIE_PROVIDER_NAME } from "./constants.js";
|
|
@@ -85,13 +85,14 @@ export function verifyAndParseMollieWebhook(client, options) {
|
|
|
85
85
|
throw new Error(`subscription-mollie: subscription ${subscription.id} has neither nextPaymentDate nor startDate`);
|
|
86
86
|
}
|
|
87
87
|
const currentPeriodEnd = mollieDateStringToInstantIso(periodEndSource);
|
|
88
|
-
|
|
88
|
+
// The first payment is the checkout the foundation ledgered at createCheckoutSession.
|
|
89
|
+
const providerCheckoutId = triggerPayment?.sequenceType === "first" ? triggerPayment.id : undefined;
|
|
89
90
|
return {
|
|
90
91
|
providerEventId: id,
|
|
91
92
|
providerName: MOLLIE_PROVIDER_NAME,
|
|
92
93
|
type,
|
|
93
94
|
tenantId,
|
|
94
|
-
...(
|
|
95
|
+
...(providerCheckoutId !== undefined && { providerCheckoutId }),
|
|
95
96
|
providerCustomerId: subscription.customerId,
|
|
96
97
|
providerSubscriptionId: subscription.id,
|
|
97
98
|
status,
|
|
@@ -113,7 +114,6 @@ async function ensureSubscriptionForMandate(client, options, payment) {
|
|
|
113
114
|
const paymentMetadata = payment.metadata ?? {}; // @cast-boundary engine-bridge
|
|
114
115
|
const tenantId = paymentMetadata["tenantId"];
|
|
115
116
|
const priceId = paymentMetadata["priceId"];
|
|
116
|
-
const consentId = parseProviderConsentId(paymentMetadata["consentId"]);
|
|
117
117
|
if (!tenantId || !priceId)
|
|
118
118
|
return null;
|
|
119
119
|
const priceCfg = options.priceToConfig[priceId];
|
|
@@ -132,7 +132,7 @@ async function ensureSubscriptionForMandate(client, options, payment) {
|
|
|
132
132
|
amount: { currency: priceCfg.amountCurrency, value: priceCfg.amountValue },
|
|
133
133
|
interval: priceCfg.interval,
|
|
134
134
|
description: priceCfg.description,
|
|
135
|
-
metadata: { tenantId, priceId
|
|
135
|
+
metadata: { tenantId, priceId },
|
|
136
136
|
});
|
|
137
137
|
}
|
|
138
138
|
// =============================================================================
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { type JobContext } from "@cosmicdrift/kumiko-framework/engine";
|
|
2
|
+
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
3
|
+
import type { PaddleCtxRuntime } from "./runtime.ts";
|
|
4
|
+
export type BackfillDeps = {
|
|
5
|
+
readonly runtime: PaddleCtxRuntime;
|
|
6
|
+
readonly priceToTier: Readonly<Record<string, string>>;
|
|
7
|
+
};
|
|
8
|
+
export declare function isTakeoverWindowOver(completedAt: string, now: Temporal.Instant): boolean;
|
|
9
|
+
export declare function runBackfillCheckoutLedger(ctx: JobContext, deps: BackfillDeps): Promise<void>;
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
// Takes over Paddle checkouts that were opened before the checkout ledger
|
|
2
|
+
// existed: their custom_data still carries the old tenantBinding. Once the
|
|
3
|
+
// first sweep is done the job keeps sweeping for an hour (checkouts opened by
|
|
4
|
+
// the previous release can still be paid), then does nothing.
|
|
5
|
+
import { parseProviderConsentId, SubscriptionFoundationHandlers, } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
|
|
6
|
+
import { createSystemUser, parseTenantId, } from "@cosmicdrift/kumiko-framework/engine";
|
|
7
|
+
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
8
|
+
import * as z from "zod";
|
|
9
|
+
import { PADDLE_PROVIDER_NAME } from "./constants.js";
|
|
10
|
+
import { LEDGER_BACKFILL_MARKER_HANDLER_QN, } from "./ledger-backfill-marker.js";
|
|
11
|
+
import { tenantIdOf } from "./webhook-events.js";
|
|
12
|
+
const TAKEOVER_WINDOW_MS = 60 * 60 * 1000;
|
|
13
|
+
const PAGE_SIZE = "200";
|
|
14
|
+
const MAX_PAGES = 100;
|
|
15
|
+
// A checkout that completed between the deploy and the first sweep is no longer draft/ready,
|
|
16
|
+
// but its webhook is still pending, so completed ones are listed too, for a week back.
|
|
17
|
+
const LISTED_STATUSES = "draft,ready,billed,paid,completed";
|
|
18
|
+
const LOOKBACK_DAYS = 7;
|
|
19
|
+
const transactionListSchema = z.object({
|
|
20
|
+
data: z.array(z.object({
|
|
21
|
+
id: z.string().min(1),
|
|
22
|
+
custom_data: z.record(z.string(), z.unknown()).nullish(),
|
|
23
|
+
items: z.array(z.object({ price: z.object({ id: z.string().min(1) }) })),
|
|
24
|
+
})),
|
|
25
|
+
meta: z
|
|
26
|
+
.object({ pagination: z.object({ has_more: z.boolean().optional() }).optional() })
|
|
27
|
+
.optional(),
|
|
28
|
+
});
|
|
29
|
+
function isLegacyCheckout(transaction) {
|
|
30
|
+
return typeof transaction.custom_data?.["tenantBinding"] === "string";
|
|
31
|
+
}
|
|
32
|
+
function paddleCallSourceOf(ctx) {
|
|
33
|
+
return {
|
|
34
|
+
services: ctx.services,
|
|
35
|
+
user: ctx.systemUser,
|
|
36
|
+
...(ctx.config && { config: ctx.config }),
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
async function readMarker(ctx, markCompleted) {
|
|
40
|
+
const result = await ctx.dispatch.write(LEDGER_BACKFILL_MARKER_HANDLER_QN, { markCompleted });
|
|
41
|
+
if (!result.isSuccess) {
|
|
42
|
+
throw new Error(`backfill-checkout-ledger: marker handler failed (${result.error.code})`);
|
|
43
|
+
}
|
|
44
|
+
return result.data; // @cast-boundary engine-payload
|
|
45
|
+
}
|
|
46
|
+
export function isTakeoverWindowOver(completedAt, now) {
|
|
47
|
+
const elapsed = now.epochMilliseconds - Temporal.Instant.from(completedAt).epochMilliseconds;
|
|
48
|
+
return elapsed >= TAKEOVER_WINDOW_MS;
|
|
49
|
+
}
|
|
50
|
+
async function listOpenApiTransactions(ctx, runtime, after, createdSince) {
|
|
51
|
+
const raw = await runtime.call(paddleCallSourceOf(ctx), {
|
|
52
|
+
method: "GET",
|
|
53
|
+
path: "/transactions",
|
|
54
|
+
query: {
|
|
55
|
+
status: LISTED_STATUSES,
|
|
56
|
+
origin: "api",
|
|
57
|
+
"created_at[GTE]": createdSince,
|
|
58
|
+
order_by: "id[ASC]",
|
|
59
|
+
per_page: PAGE_SIZE,
|
|
60
|
+
...(after !== undefined && { after }),
|
|
61
|
+
},
|
|
62
|
+
});
|
|
63
|
+
return transactionListSchema.parse(raw);
|
|
64
|
+
}
|
|
65
|
+
async function ledgerTransaction(ctx, priceToTier, transaction) {
|
|
66
|
+
const tenantId = parseTenantId(tenantIdOf(transaction.custom_data));
|
|
67
|
+
const priceId = transaction.items[0]?.price.id;
|
|
68
|
+
// skip: a transaction without tenant or price cannot be ledgered
|
|
69
|
+
if (tenantId === null || !priceId)
|
|
70
|
+
return;
|
|
71
|
+
const consentId = parseProviderConsentId(transaction.custom_data?.["consentId"]);
|
|
72
|
+
const result = await ctx.dispatch.writeAs(createSystemUser(tenantId, ["SystemAdmin"]), SubscriptionFoundationHandlers.recordCheckoutOpened, {
|
|
73
|
+
providerName: PADDLE_PROVIDER_NAME,
|
|
74
|
+
providerCheckoutId: transaction.id,
|
|
75
|
+
priceId,
|
|
76
|
+
mode: priceId in priceToTier ? "subscription" : "payment",
|
|
77
|
+
...(consentId !== undefined && { consentId }),
|
|
78
|
+
});
|
|
79
|
+
if (!result.isSuccess) {
|
|
80
|
+
throw new Error(`backfill-checkout-ledger: ledgering ${transaction.id} failed (${result.error.code})`);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
export async function runBackfillCheckoutLedger(ctx, deps) {
|
|
84
|
+
// skip: without an API key there is no Paddle account to sweep
|
|
85
|
+
if (!(await deps.runtime.hasApiKey(paddleCallSourceOf(ctx))))
|
|
86
|
+
return;
|
|
87
|
+
const marker = await readMarker(ctx, false);
|
|
88
|
+
if (marker.completedAt !== null && isTakeoverWindowOver(marker.completedAt, ctx.tz.now())) {
|
|
89
|
+
// skip: the takeover window is over
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
const createdSince = ctx.tz
|
|
93
|
+
.now()
|
|
94
|
+
.subtract({ hours: LOOKBACK_DAYS * 24 })
|
|
95
|
+
.toString();
|
|
96
|
+
let after;
|
|
97
|
+
for (let page = 0; page < MAX_PAGES; page++) {
|
|
98
|
+
const listed = await listOpenApiTransactions(ctx, deps.runtime, after, createdSince);
|
|
99
|
+
for (const transaction of listed.data) {
|
|
100
|
+
if (isLegacyCheckout(transaction))
|
|
101
|
+
await ledgerTransaction(ctx, deps.priceToTier, transaction);
|
|
102
|
+
}
|
|
103
|
+
const last = listed.data.at(-1);
|
|
104
|
+
if (listed.meta?.pagination?.has_more !== true || last === undefined)
|
|
105
|
+
break;
|
|
106
|
+
after = last.id;
|
|
107
|
+
}
|
|
108
|
+
if (marker.completedAt === null)
|
|
109
|
+
await readMarker(ctx, true);
|
|
110
|
+
}
|
|
@@ -6,7 +6,7 @@ export function makeCheckoutConfigQuery(readCheckoutConfig) {
|
|
|
6
6
|
return defineQueryHandler({
|
|
7
7
|
name: "checkout-config",
|
|
8
8
|
schema: z.object({}),
|
|
9
|
-
access: { roles: ["anonymous"
|
|
9
|
+
access: { roles: ["anonymous"], anySignedIn: true },
|
|
10
10
|
rateLimit: { per: "ip+handler", limit: 60, windowSeconds: 60 },
|
|
11
11
|
description: "Answers the public Paddle.js client token and the Paddle environment for the checkout page; the client token is public by design and no other config leaves this handler.",
|
|
12
12
|
handler: async (_query, ctx) => readCheckoutConfig(ctx),
|
|
@@ -2,7 +2,6 @@
|
|
|
2
2
|
// is validated with Zod; every non-2xx throws a PaddleHttpError.
|
|
3
3
|
import { SubscriptionCancelTimings } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
|
|
4
4
|
import * as z from "zod";
|
|
5
|
-
import { signTenantBinding } from "./tenant-binding.js";
|
|
6
5
|
export function paddleSubscriptionPath(providerSubscriptionId) {
|
|
7
6
|
return `/subscriptions/${encodeURIComponent(providerSubscriptionId)}`;
|
|
8
7
|
}
|
|
@@ -20,7 +19,6 @@ export function createPaddleCheckoutSession(runtime) {
|
|
|
20
19
|
return async (ctx, options) => {
|
|
21
20
|
// No Paddle transaction may be created while billing is not live.
|
|
22
21
|
await runtime.assertBillingLive(ctx);
|
|
23
|
-
const bindingKey = await runtime.tenantBindingKey(ctx);
|
|
24
22
|
// No `checkout.url` in the body: Paddle rejects unapproved domains and otherwise
|
|
25
23
|
// answers with the dashboard's Default Payment Link plus `?_ptxn=`.
|
|
26
24
|
const { data } = checkoutResponseSchema.parse(await runtime.call(ctx, {
|
|
@@ -29,11 +27,7 @@ export function createPaddleCheckoutSession(runtime) {
|
|
|
29
27
|
body: {
|
|
30
28
|
items: [{ price_id: options.priceId, quantity: 1 }],
|
|
31
29
|
...(options.providerCustomerId && { customer_id: options.providerCustomerId }),
|
|
32
|
-
custom_data: {
|
|
33
|
-
tenantId: options.tenantId,
|
|
34
|
-
tenantBinding: signTenantBinding(bindingKey, options.tenantId),
|
|
35
|
-
...(options.consentId && { consentId: options.consentId }),
|
|
36
|
-
},
|
|
30
|
+
custom_data: { tenantId: options.tenantId },
|
|
37
31
|
},
|
|
38
32
|
}));
|
|
39
33
|
if (!data.checkout?.url) {
|
|
@@ -44,7 +38,7 @@ export function createPaddleCheckoutSession(runtime) {
|
|
|
44
38
|
url.searchParams.set("cancel", relativeTarget(options.cancelUrl));
|
|
45
39
|
if (options.locale)
|
|
46
40
|
url.searchParams.set("locale", options.locale);
|
|
47
|
-
return { url: url.href };
|
|
41
|
+
return { url: url.href, providerCheckoutId: data.id };
|
|
48
42
|
};
|
|
49
43
|
}
|
|
50
44
|
const portalResponseSchema = z.object({
|
|
@@ -3,7 +3,6 @@ export declare const PADDLE_PROVIDER_NAME: "paddle";
|
|
|
3
3
|
export declare const PADDLE_CHECKOUT_PATH: "/billing/paddle-checkout";
|
|
4
4
|
export declare const PADDLE_API_KEY_CONFIG: "api-key";
|
|
5
5
|
export declare const PADDLE_WEBHOOK_SECRET_CONFIG: "webhook-secret";
|
|
6
|
-
export declare const PADDLE_TENANT_BINDING_KEY_CONFIG: "tenant-binding-key";
|
|
7
6
|
export declare const PADDLE_CLIENT_TOKEN_CONFIG: "client-token";
|
|
8
7
|
export declare const PADDLE_ENVIRONMENT_CONFIG: "environment";
|
|
9
8
|
export declare const PADDLE_BILLING_LIVE_CONFIG: "billingLive";
|
|
@@ -5,10 +5,9 @@ export const PADDLE_PROVIDER_NAME = "paddle";
|
|
|
5
5
|
// Link itself; the same path goes into the Paddle dashboard.
|
|
6
6
|
export const PADDLE_CHECKOUT_PATH = "/billing/paddle-checkout";
|
|
7
7
|
// Config-key short-names, qualified to `subscription-paddle:config:<name>` at
|
|
8
|
-
// registry-build. api-key
|
|
8
|
+
// registry-build. api-key and webhook-secret are backing:"secrets".
|
|
9
9
|
export const PADDLE_API_KEY_CONFIG = "api-key";
|
|
10
10
|
export const PADDLE_WEBHOOK_SECRET_CONFIG = "webhook-secret";
|
|
11
|
-
export const PADDLE_TENANT_BINDING_KEY_CONFIG = "tenant-binding-key";
|
|
12
11
|
export const PADDLE_CLIENT_TOKEN_CONFIG = "client-token";
|
|
13
12
|
export const PADDLE_ENVIRONMENT_CONFIG = "environment";
|
|
14
13
|
export const PADDLE_BILLING_LIVE_CONFIG = "billingLive";
|
|
@@ -6,7 +6,6 @@ import type { PaddleSend } from "./client.ts";
|
|
|
6
6
|
export declare const subscriptionPaddleEnvSchema: z.ZodObject<{
|
|
7
7
|
PADDLE_API_KEY: z.ZodOptional<z.ZodString>;
|
|
8
8
|
PADDLE_WEBHOOK_SECRET: z.ZodOptional<z.ZodString>;
|
|
9
|
-
PADDLE_TENANT_BINDING_KEY: z.ZodOptional<z.ZodString>;
|
|
10
9
|
PADDLE_CLIENT_TOKEN: z.ZodOptional<z.ZodString>;
|
|
11
10
|
}, z.core.$strip>;
|
|
12
11
|
/** Paddle env block plus one `PADDLE_PRICE_<NAME>` slot per plan price the app
|
|
@@ -19,7 +18,6 @@ export declare function paddleEnvSchema<const TPrice extends string>(options: {
|
|
|
19
18
|
}): z.ZodObject<{
|
|
20
19
|
PADDLE_API_KEY: z.ZodOptional<z.ZodString>;
|
|
21
20
|
PADDLE_WEBHOOK_SECRET: z.ZodOptional<z.ZodString>;
|
|
22
|
-
PADDLE_TENANT_BINDING_KEY: z.ZodOptional<z.ZodString>;
|
|
23
21
|
PADDLE_CLIENT_TOKEN: z.ZodOptional<z.ZodString>;
|
|
24
22
|
} & import("../shared/price-env-shape.ts").PriceEnvShape<"PADDLE", TPrice> extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$strip>;
|
|
25
23
|
export type SubscriptionPaddleOptions = {
|
|
@@ -27,8 +25,6 @@ export type SubscriptionPaddleOptions = {
|
|
|
27
25
|
readonly apiKey?: string;
|
|
28
26
|
/** Bridge-fallback webhook secret; the `webhook-secret` config key wins when set. */
|
|
29
27
|
readonly webhookSecret?: string;
|
|
30
|
-
/** Bridge-fallback tenant binding key; the `tenant-binding-key` config key wins when set. */
|
|
31
|
-
readonly tenantBindingKey?: string;
|
|
32
28
|
/** Bridge-fallback Paddle.js client token; the `client-token` config key wins when set. */
|
|
33
29
|
readonly clientToken?: string;
|
|
34
30
|
/** Paddle price id → app tier name. Prices absent here drop the event. */
|
|
@@ -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
|
};
|