@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
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
|
|
2
|
+
import { InternalError, RateLimitError } from "@cosmicdrift/kumiko-framework/errors";
|
|
3
|
+
import { whatsappMessageAggregateId, whatsappStatusAggregateId } from "./aggregate-id.js";
|
|
4
|
+
import { receiveMessageInputSchema, recordStatusInputSchema, WHATSAPP_MESSAGE_AGGREGATE_TYPE, WHATSAPP_MESSAGE_RECEIVED_EVENT_QN, WHATSAPP_STATUS_AGGREGATE_TYPE, WHATSAPP_STATUS_UPDATED_EVENT_QN, WHATSAPP_THROTTLED_EVENT_QN, } from "./events.js";
|
|
5
|
+
import { encryptWhatsappPii, WhatsappPiiFields } from "./pii.js";
|
|
6
|
+
const WHATSAPP_STREAM_LOCK_NAMESPACE = 0x77616d73;
|
|
7
|
+
const OUTCOME_STORED = { isSuccess: true, data: { outcome: "stored" } };
|
|
8
|
+
const OUTCOME_DUPLICATE = { isSuccess: true, data: { outcome: "duplicate" } };
|
|
9
|
+
const OUTCOME_THROTTLED = { isSuccess: true, data: { outcome: "throttled" } };
|
|
10
|
+
// Counts one message against every per-sender window. Only a RateLimitError means "throttled";
|
|
11
|
+
// anything else (Redis down, bad config) propagates so the webhook answers 5xx and Meta redelivers.
|
|
12
|
+
// A one-token marker bucket per wamid makes the charge once-only across failed rounds and
|
|
13
|
+
// concurrent deliveries. The marker is taken before the charge: a crash in between loses one
|
|
14
|
+
// charge, never doubles one. A redelivery after a throttled-then-failed attempt skips the charge.
|
|
15
|
+
// ponytail: that redelivery also skips the throttle decision (RateLimitResolver cannot read without
|
|
16
|
+
// consuming), so at most one message per failed round gets past the limit; upgrade: add a peek.
|
|
17
|
+
async function chargeSender(ctx, options, tenantId, from, wamid) {
|
|
18
|
+
if (options.senderRateLimits.length === 0)
|
|
19
|
+
return null;
|
|
20
|
+
const { rateLimit } = ctx.services;
|
|
21
|
+
const digest = ctx.rateLimitDigest;
|
|
22
|
+
if (!rateLimit || !digest) {
|
|
23
|
+
throw new InternalError({
|
|
24
|
+
message: "channel-whatsapp: the per-sender limit needs a rate limiter and a digest key",
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
const markerWindowSeconds = Math.max(...options.senderRateLimits.map((l) => l.windowSeconds));
|
|
28
|
+
try {
|
|
29
|
+
await rateLimit.enforce(`whatsapp-inbound-charged:${tenantId}:${wamid}`, {
|
|
30
|
+
limit: 1,
|
|
31
|
+
windowSeconds: markerWindowSeconds,
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
catch (error) {
|
|
35
|
+
if (error instanceof RateLimitError)
|
|
36
|
+
return null;
|
|
37
|
+
throw error;
|
|
38
|
+
}
|
|
39
|
+
const senderKey = `whatsapp-inbound:${tenantId}:${digest(from)}`;
|
|
40
|
+
try {
|
|
41
|
+
await rateLimit.enforceAll(options.senderRateLimits.map(({ limit, windowSeconds }) => ({
|
|
42
|
+
bucket: `${senderKey}:${windowSeconds}s`,
|
|
43
|
+
config: { limit, windowSeconds },
|
|
44
|
+
})));
|
|
45
|
+
return null;
|
|
46
|
+
}
|
|
47
|
+
catch (error) {
|
|
48
|
+
if (error instanceof RateLimitError)
|
|
49
|
+
return error;
|
|
50
|
+
throw error;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
export function createReceiveMessageHandler(options) {
|
|
54
|
+
return defineWriteHandler({
|
|
55
|
+
name: "receive-message",
|
|
56
|
+
schema: receiveMessageInputSchema,
|
|
57
|
+
access: { roles: ["SystemAdmin"] },
|
|
58
|
+
rateLimit: options.rateLimit,
|
|
59
|
+
agent: { expose: false },
|
|
60
|
+
description: "Stores one inbound WhatsApp message verified by the webhook route as a message-received event; a redelivered wamid is a duplicate, a sender over its limit becomes a throttled event.",
|
|
61
|
+
handler: async (event, ctx) => {
|
|
62
|
+
const input = event.payload;
|
|
63
|
+
const tenantId = event.user.tenantId;
|
|
64
|
+
const aggregateId = whatsappMessageAggregateId(tenantId, input.wamid);
|
|
65
|
+
// tryAppend re-reads the stream version, so a delivery that committed after our load would land as a second event.
|
|
66
|
+
await ctx.db.advisoryXactLock(WHATSAPP_STREAM_LOCK_NAMESPACE, aggregateId);
|
|
67
|
+
// Dedupe before the limit: Meta's redeliveries must not use up the sender's budget.
|
|
68
|
+
if ((await ctx.events.load(aggregateId)).length > 0)
|
|
69
|
+
return OUTCOME_DUPLICATE;
|
|
70
|
+
const throttle = await chargeSender(ctx, options, tenantId, input.from, input.wamid);
|
|
71
|
+
const requestId = `channel-whatsapp:receive-message:${aggregateId}`;
|
|
72
|
+
const from = await encryptWhatsappPii(tenantId, throttle ? WhatsappPiiFields.throttledFrom : WhatsappPiiFields.receivedFrom, input.from, requestId);
|
|
73
|
+
if (throttle) {
|
|
74
|
+
const payload = {
|
|
75
|
+
phoneNumberId: input.phoneNumberId,
|
|
76
|
+
wamid: input.wamid,
|
|
77
|
+
from,
|
|
78
|
+
timestampIso: input.timestampIso,
|
|
79
|
+
retryAfterSeconds: throttle.details.retryAfterSeconds,
|
|
80
|
+
};
|
|
81
|
+
const appended = await ctx.events.tryAppend({
|
|
82
|
+
aggregateId,
|
|
83
|
+
aggregateType: WHATSAPP_MESSAGE_AGGREGATE_TYPE,
|
|
84
|
+
type: WHATSAPP_THROTTLED_EVENT_QN,
|
|
85
|
+
payload,
|
|
86
|
+
});
|
|
87
|
+
return appended.ok ? OUTCOME_THROTTLED : OUTCOME_DUPLICATE;
|
|
88
|
+
}
|
|
89
|
+
const payload = {
|
|
90
|
+
phoneNumberId: input.phoneNumberId,
|
|
91
|
+
wamid: input.wamid,
|
|
92
|
+
from,
|
|
93
|
+
timestampIso: input.timestampIso,
|
|
94
|
+
messageType: input.messageType,
|
|
95
|
+
text: input.text === null
|
|
96
|
+
? null
|
|
97
|
+
: await encryptWhatsappPii(tenantId, WhatsappPiiFields.receivedText, input.text, requestId),
|
|
98
|
+
buttonPayload: input.buttonPayload === null
|
|
99
|
+
? null
|
|
100
|
+
: await encryptWhatsappPii(tenantId, WhatsappPiiFields.receivedButtonPayload, input.buttonPayload, requestId),
|
|
101
|
+
contextWamid: input.contextWamid,
|
|
102
|
+
mediaId: input.mediaId,
|
|
103
|
+
mimeType: input.mimeType,
|
|
104
|
+
};
|
|
105
|
+
const appended = await ctx.events.tryAppend({
|
|
106
|
+
aggregateId,
|
|
107
|
+
aggregateType: WHATSAPP_MESSAGE_AGGREGATE_TYPE,
|
|
108
|
+
type: WHATSAPP_MESSAGE_RECEIVED_EVENT_QN,
|
|
109
|
+
payload,
|
|
110
|
+
});
|
|
111
|
+
return appended.ok ? OUTCOME_STORED : OUTCOME_DUPLICATE;
|
|
112
|
+
},
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
export function createRecordStatusHandler(options) {
|
|
116
|
+
return defineWriteHandler({
|
|
117
|
+
name: "record-status",
|
|
118
|
+
schema: recordStatusInputSchema,
|
|
119
|
+
access: { roles: ["SystemAdmin"] },
|
|
120
|
+
rateLimit: options.rateLimit,
|
|
121
|
+
agent: { expose: false },
|
|
122
|
+
description: "Stores one delivery status (sent, delivered, read, failed) of an outbound WhatsApp message as a status-updated event; a repeated status of the same wamid is a duplicate.",
|
|
123
|
+
handler: async (event, ctx) => {
|
|
124
|
+
const input = event.payload;
|
|
125
|
+
const tenantId = event.user.tenantId;
|
|
126
|
+
const aggregateId = whatsappStatusAggregateId(tenantId, input.wamid, input.status, input.rawStatus);
|
|
127
|
+
// tryAppend re-reads the stream version, so a delivery that committed after our load would land as a second event.
|
|
128
|
+
await ctx.db.advisoryXactLock(WHATSAPP_STREAM_LOCK_NAMESPACE, aggregateId);
|
|
129
|
+
if ((await ctx.events.load(aggregateId)).length > 0)
|
|
130
|
+
return OUTCOME_DUPLICATE;
|
|
131
|
+
const payload = {
|
|
132
|
+
phoneNumberId: input.phoneNumberId,
|
|
133
|
+
wamid: input.wamid,
|
|
134
|
+
status: input.status,
|
|
135
|
+
timestampIso: input.timestampIso,
|
|
136
|
+
recipient: await encryptWhatsappPii(tenantId, WhatsappPiiFields.statusRecipient, input.recipient, `channel-whatsapp:record-status:${aggregateId}`),
|
|
137
|
+
errorCode: input.errorCode,
|
|
138
|
+
};
|
|
139
|
+
const appended = await ctx.events.tryAppend({
|
|
140
|
+
aggregateId,
|
|
141
|
+
aggregateType: WHATSAPP_STATUS_AGGREGATE_TYPE,
|
|
142
|
+
type: WHATSAPP_STATUS_UPDATED_EVENT_QN,
|
|
143
|
+
payload,
|
|
144
|
+
});
|
|
145
|
+
return appended.ok ? OUTCOME_STORED : OUTCOME_DUPLICATE;
|
|
146
|
+
},
|
|
147
|
+
});
|
|
148
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export { whatsappMessageAggregateId, whatsappStatusAggregateId } from "./aggregate-id.ts";
|
|
2
|
+
export { CHANNEL_WHATSAPP_FEATURE, WHATSAPP_DEFAULT_ALLOWED_HOSTS, WHATSAPP_DEFAULT_API_BASE_URL, WHATSAPP_DEFAULT_WEBHOOK_PATH, WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE, WHATSAPP_SECRET_KEYS, type WhatsappMessageType, type WhatsappStatusKind, } from "./constants.ts";
|
|
3
|
+
export { type MessageReceivedPayload, type StatusUpdatedPayload, type ThrottledPayload, WHATSAPP_MESSAGE_RECEIVED_EVENT_QN, WHATSAPP_STATUS_UPDATED_EVENT_QN, WHATSAPP_THROTTLED_EVENT_QN, } from "./events.ts";
|
|
4
|
+
export { createChannelWhatsappFeature } from "./feature.ts";
|
|
5
|
+
export { buildWhatsappClient, createWhatsappClient, type WhatsappButtonsInput, type WhatsappCallContext, type WhatsappClient, type WhatsappMediaFailure, type WhatsappMediaInput, type WhatsappMediaResult, type WhatsappReplyButton, type WhatsappSendFailure, type WhatsappSendResult, type WhatsappTemplateInput, type WhatsappTextInput, } from "./graph-client.ts";
|
|
6
|
+
export { createInMemoryMeta, deliverMetaWebhook, type InMemoryMeta, type InMemoryMetaRejection, type InMemoryMetaRequest, type InMemoryMetaSentMessage, metaButtonReplyMessage, metaMediaMessage, metaStatus, metaTextMessage, metaWebhookPayload, requestMetaVerification, } from "./in-memory-meta.ts";
|
|
7
|
+
export { signMetaBody } from "./meta-signature.ts";
|
|
8
|
+
export { type ChannelWhatsappOptions, DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT, DEFAULT_WHATSAPP_SENDER_RATE_LIMITS, type WhatsappSenderRateLimit, type WhatsappTransport, } from "./options.ts";
|
|
9
|
+
export { type DecryptedWhatsappMessage, type DecryptedWhatsappStatus, type DecryptedWhatsappThrottled, readWhatsappMessagePii, readWhatsappStatusPii, readWhatsappThrottledPii, } from "./pii.ts";
|
|
10
|
+
export { createWhatsappWebhookRoutes, type WhatsappWebhookRouteOptions } from "./webhook-routes.ts";
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export { whatsappMessageAggregateId, whatsappStatusAggregateId } from "./aggregate-id.js";
|
|
2
|
+
export { CHANNEL_WHATSAPP_FEATURE, WHATSAPP_DEFAULT_ALLOWED_HOSTS, WHATSAPP_DEFAULT_API_BASE_URL, WHATSAPP_DEFAULT_WEBHOOK_PATH, WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE, WHATSAPP_SECRET_KEYS, } from "./constants.js";
|
|
3
|
+
export { WHATSAPP_MESSAGE_RECEIVED_EVENT_QN, WHATSAPP_STATUS_UPDATED_EVENT_QN, WHATSAPP_THROTTLED_EVENT_QN, } from "./events.js";
|
|
4
|
+
export { createChannelWhatsappFeature } from "./feature.js";
|
|
5
|
+
export { buildWhatsappClient, createWhatsappClient, } from "./graph-client.js";
|
|
6
|
+
export { createInMemoryMeta, deliverMetaWebhook, metaButtonReplyMessage, metaMediaMessage, metaStatus, metaTextMessage, metaWebhookPayload, requestMetaVerification, } from "./in-memory-meta.js";
|
|
7
|
+
export { signMetaBody } from "./meta-signature.js";
|
|
8
|
+
export { DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT, DEFAULT_WHATSAPP_SENDER_RATE_LIMITS, } from "./options.js";
|
|
9
|
+
export { readWhatsappMessagePii, readWhatsappStatusPii, readWhatsappThrottledPii, } from "./pii.js";
|
|
10
|
+
export { createWhatsappWebhookRoutes } from "./webhook-routes.js";
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
/** Meta's `X-Hub-Signature-256` value for a raw body: `sha256=<hex HMAC with the app secret>`. */
|
|
2
|
+
export declare function signMetaBody(appSecret: string, rawBody: string): string;
|
|
3
|
+
export declare function isValidMetaSignature(appSecret: string, rawBody: string, header: string | undefined): boolean;
|
|
4
|
+
/** Hashing first gives both sides one length, so the comparison leaks nothing about the secret's length. */
|
|
5
|
+
export declare function secretsMatch(candidate: string, secret: string): boolean;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
|
|
2
|
+
const SIGNATURE_HEADER_PATTERN = /^sha256=([0-9a-f]{64})$/i;
|
|
3
|
+
/** Meta's `X-Hub-Signature-256` value for a raw body: `sha256=<hex HMAC with the app secret>`. */
|
|
4
|
+
export function signMetaBody(appSecret, rawBody) {
|
|
5
|
+
return `sha256=${createHmac("sha256", appSecret).update(rawBody, "utf8").digest("hex")}`;
|
|
6
|
+
}
|
|
7
|
+
export function isValidMetaSignature(appSecret, rawBody, header) {
|
|
8
|
+
const match = header === undefined ? null : SIGNATURE_HEADER_PATTERN.exec(header.trim());
|
|
9
|
+
if (match === null)
|
|
10
|
+
return false;
|
|
11
|
+
const received = Buffer.from((match[1] ?? "").toLowerCase(), "hex");
|
|
12
|
+
const expected = createHmac("sha256", appSecret).update(rawBody, "utf8").digest();
|
|
13
|
+
return received.length === expected.length && timingSafeEqual(received, expected);
|
|
14
|
+
}
|
|
15
|
+
/** Hashing first gives both sides one length, so the comparison leaks nothing about the secret's length. */
|
|
16
|
+
export function secretsMatch(candidate, secret) {
|
|
17
|
+
const digestOf = (value) => createHash("sha256").update(value, "utf8").digest();
|
|
18
|
+
return timingSafeEqual(digestOf(candidate), digestOf(secret));
|
|
19
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { type RateLimitDeclaration } from "@cosmicdrift/kumiko-types/handlers";
|
|
2
|
+
export type WhatsappTransport = (url: string, init: RequestInit) => Promise<Response>;
|
|
3
|
+
/** Limit on messages per sender number, counted inside the inbound write handler. */
|
|
4
|
+
export type WhatsappSenderRateLimit = {
|
|
5
|
+
readonly limit: number;
|
|
6
|
+
readonly windowSeconds: number;
|
|
7
|
+
};
|
|
8
|
+
export type ChannelWhatsappOptions = {
|
|
9
|
+
readonly apiBaseUrl?: string;
|
|
10
|
+
readonly apiVersion?: string;
|
|
11
|
+
readonly allowedHosts?: readonly string[];
|
|
12
|
+
readonly requireHttps?: boolean;
|
|
13
|
+
readonly timeoutMs?: number;
|
|
14
|
+
readonly mediaMaxBytes?: number;
|
|
15
|
+
readonly transport?: WhatsappTransport;
|
|
16
|
+
readonly senderRateLimits?: readonly WhatsappSenderRateLimit[];
|
|
17
|
+
readonly rateLimit?: RateLimitDeclaration;
|
|
18
|
+
};
|
|
19
|
+
export type ResolvedWhatsappOptions = {
|
|
20
|
+
readonly apiBaseUrl: string;
|
|
21
|
+
readonly apiVersion: string;
|
|
22
|
+
readonly allowedHosts: readonly string[];
|
|
23
|
+
readonly requireHttps: boolean;
|
|
24
|
+
readonly timeoutMs: number;
|
|
25
|
+
readonly mediaMaxBytes: number;
|
|
26
|
+
readonly transport: WhatsappTransport | undefined;
|
|
27
|
+
readonly senderRateLimits: readonly WhatsappSenderRateLimit[];
|
|
28
|
+
readonly rateLimit: RateLimitDeclaration;
|
|
29
|
+
};
|
|
30
|
+
export declare const DEFAULT_WHATSAPP_SENDER_RATE_LIMITS: readonly WhatsappSenderRateLimit[];
|
|
31
|
+
export declare const DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT: RateLimitDeclaration;
|
|
32
|
+
export declare function resolveWhatsappOptions(options: ChannelWhatsappOptions): ResolvedWhatsappOptions;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { isRateLimitDisabled } from "@cosmicdrift/kumiko-types/handlers";
|
|
2
|
+
import { checkChatWebhookTarget } from "../delivery/index.js";
|
|
3
|
+
import { WHATSAPP_DEFAULT_ALLOWED_HOSTS, WHATSAPP_DEFAULT_API_BASE_URL, WHATSAPP_DEFAULT_API_VERSION, WHATSAPP_DEFAULT_MEDIA_MAX_BYTES, WHATSAPP_DEFAULT_TIMEOUT_MS, } from "./constants.js";
|
|
4
|
+
export const DEFAULT_WHATSAPP_SENDER_RATE_LIMITS = [
|
|
5
|
+
{ limit: 30, windowSeconds: 60 * 60 },
|
|
6
|
+
{ limit: 200, windowSeconds: 24 * 60 * 60 },
|
|
7
|
+
];
|
|
8
|
+
export const DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT = {
|
|
9
|
+
per: "tenant+handler",
|
|
10
|
+
limit: 12_000,
|
|
11
|
+
windowSeconds: 60,
|
|
12
|
+
};
|
|
13
|
+
const API_VERSION_PATTERN = /^v\d+\.\d+$/;
|
|
14
|
+
function isPositiveInteger(value) {
|
|
15
|
+
return Number.isInteger(value) && value > 0;
|
|
16
|
+
}
|
|
17
|
+
// Fail at boot: a misconfigured base URL must not surface as per-send failures.
|
|
18
|
+
function assertApiBaseUrl(apiBaseUrl, allowedHosts, requireHttps) {
|
|
19
|
+
let parsedBase;
|
|
20
|
+
try {
|
|
21
|
+
parsedBase = new URL(apiBaseUrl);
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
throw new Error("channel-whatsapp: apiBaseUrl is not a valid URL");
|
|
25
|
+
}
|
|
26
|
+
// The same check the sends run at runtime, so boot and runtime cannot disagree.
|
|
27
|
+
if (checkChatWebhookTarget({ allowedHosts, requireHttps }, apiBaseUrl) !== undefined)
|
|
28
|
+
return;
|
|
29
|
+
if (requireHttps && parsedBase.protocol !== "https:") {
|
|
30
|
+
throw new Error("channel-whatsapp: apiBaseUrl must use https (set requireHttps: false to opt out)");
|
|
31
|
+
}
|
|
32
|
+
if (requireHttps && parsedBase.port !== "") {
|
|
33
|
+
throw new Error("channel-whatsapp: apiBaseUrl must not carry a port while requireHttps is set");
|
|
34
|
+
}
|
|
35
|
+
if (parsedBase.username !== "" || parsedBase.password !== "") {
|
|
36
|
+
throw new Error("channel-whatsapp: apiBaseUrl must not carry credentials");
|
|
37
|
+
}
|
|
38
|
+
throw new Error(`channel-whatsapp: apiBaseUrl host "${parsedBase.hostname}" is not in allowedHosts`);
|
|
39
|
+
}
|
|
40
|
+
function assertRateLimits(senderRateLimits, rateLimit) {
|
|
41
|
+
for (const { limit, windowSeconds } of senderRateLimits) {
|
|
42
|
+
if (!isPositiveInteger(limit) || !isPositiveInteger(windowSeconds)) {
|
|
43
|
+
throw new Error("channel-whatsapp: senderRateLimits entries need a positive integer limit and windowSeconds");
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
// A disabled flood guard would leave the handler without a declared limit and the
|
|
47
|
+
// per-sender counting without the resolver the declaration makes the engine build.
|
|
48
|
+
if (isRateLimitDisabled(rateLimit) && senderRateLimits.length > 0) {
|
|
49
|
+
throw new Error("channel-whatsapp: rateLimit cannot be disabled while senderRateLimits is set (pass senderRateLimits: [] to switch both off)");
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
export function resolveWhatsappOptions(options) {
|
|
53
|
+
const apiBaseUrl = (options.apiBaseUrl ?? WHATSAPP_DEFAULT_API_BASE_URL).replace(/\/+$/, "");
|
|
54
|
+
const apiVersion = options.apiVersion ?? WHATSAPP_DEFAULT_API_VERSION;
|
|
55
|
+
const allowedHosts = options.allowedHosts ?? WHATSAPP_DEFAULT_ALLOWED_HOSTS;
|
|
56
|
+
const requireHttps = options.requireHttps ?? true;
|
|
57
|
+
const senderRateLimits = options.senderRateLimits ?? DEFAULT_WHATSAPP_SENDER_RATE_LIMITS;
|
|
58
|
+
const rateLimit = options.rateLimit ?? DEFAULT_WHATSAPP_INBOUND_RATE_LIMIT;
|
|
59
|
+
assertApiBaseUrl(apiBaseUrl, allowedHosts, requireHttps);
|
|
60
|
+
if (!API_VERSION_PATTERN.test(apiVersion)) {
|
|
61
|
+
throw new Error('channel-whatsapp: apiVersion must look like "v21.0"');
|
|
62
|
+
}
|
|
63
|
+
assertRateLimits(senderRateLimits, rateLimit);
|
|
64
|
+
const timeoutMs = options.timeoutMs ?? WHATSAPP_DEFAULT_TIMEOUT_MS;
|
|
65
|
+
const mediaMaxBytes = options.mediaMaxBytes ?? WHATSAPP_DEFAULT_MEDIA_MAX_BYTES;
|
|
66
|
+
if (!isPositiveInteger(timeoutMs)) {
|
|
67
|
+
throw new Error("channel-whatsapp: timeoutMs must be a positive integer");
|
|
68
|
+
}
|
|
69
|
+
if (!isPositiveInteger(mediaMaxBytes)) {
|
|
70
|
+
throw new Error("channel-whatsapp: mediaMaxBytes must be a positive integer");
|
|
71
|
+
}
|
|
72
|
+
return {
|
|
73
|
+
apiBaseUrl,
|
|
74
|
+
apiVersion,
|
|
75
|
+
allowedHosts,
|
|
76
|
+
requireHttps,
|
|
77
|
+
timeoutMs,
|
|
78
|
+
mediaMaxBytes,
|
|
79
|
+
transport: options.transport,
|
|
80
|
+
senderRateLimits,
|
|
81
|
+
rateLimit,
|
|
82
|
+
};
|
|
83
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { TenantId } from "@cosmicdrift/kumiko-types/identifiers";
|
|
2
|
+
export declare const WhatsappPiiFields: {
|
|
3
|
+
readonly receivedFrom: "channel-whatsapp.message-received.from";
|
|
4
|
+
readonly receivedText: "channel-whatsapp.message-received.text";
|
|
5
|
+
readonly receivedButtonPayload: "channel-whatsapp.message-received.buttonPayload";
|
|
6
|
+
readonly statusRecipient: "channel-whatsapp.status-updated.recipient";
|
|
7
|
+
readonly throttledFrom: "channel-whatsapp.throttled.from";
|
|
8
|
+
};
|
|
9
|
+
export type WhatsappPiiField = (typeof WhatsappPiiFields)[keyof typeof WhatsappPiiFields];
|
|
10
|
+
/** Without a configured PII KMS the value passes through, like every other event-sourced inbound path. */
|
|
11
|
+
export declare function encryptWhatsappPii(tenantId: TenantId, field: WhatsappPiiField, value: string, requestId: string): Promise<string>;
|
|
12
|
+
export declare function decryptWhatsappPii(tenantId: TenantId, field: WhatsappPiiField, value: string): Promise<string>;
|
|
13
|
+
export type DecryptedWhatsappMessage = {
|
|
14
|
+
readonly from: string;
|
|
15
|
+
readonly text: string | null;
|
|
16
|
+
readonly buttonPayload: string | null;
|
|
17
|
+
};
|
|
18
|
+
export type DecryptedWhatsappStatus = {
|
|
19
|
+
readonly recipient: string;
|
|
20
|
+
};
|
|
21
|
+
export type DecryptedWhatsappThrottled = {
|
|
22
|
+
readonly from: string;
|
|
23
|
+
};
|
|
24
|
+
/** Plaintext recipient of a `status-updated` event payload. */
|
|
25
|
+
export declare function readWhatsappStatusPii(tenantId: TenantId, payload: unknown): Promise<DecryptedWhatsappStatus>;
|
|
26
|
+
/** Plaintext sender of a `throttled` event payload. */
|
|
27
|
+
export declare function readWhatsappThrottledPii(tenantId: TenantId, payload: unknown): Promise<DecryptedWhatsappThrottled>;
|
|
28
|
+
/**
|
|
29
|
+
* Plaintext of the PII fields of a `message-received` event payload, for the consumer.
|
|
30
|
+
* A tenant that was destroyed yields the erased sentinel instead of the value.
|
|
31
|
+
*/
|
|
32
|
+
export declare function readWhatsappMessagePii(tenantId: TenantId, payload: unknown): Promise<DecryptedWhatsappMessage>;
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { configuredPiiSubjectKms, decryptPiiValueForSubject, encryptPiiValueForSubject, } from "@cosmicdrift/kumiko-framework/crypto";
|
|
2
|
+
import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
3
|
+
// The sender has no user account, so the tenant key is the subject (as for inbound mail):
|
|
4
|
+
// destroying the tenant shreds the key and every stored number, text and payload with it.
|
|
5
|
+
// The field name is part of the ciphertext's AAD and must match between encrypt and decrypt.
|
|
6
|
+
export const WhatsappPiiFields = {
|
|
7
|
+
receivedFrom: "channel-whatsapp.message-received.from",
|
|
8
|
+
receivedText: "channel-whatsapp.message-received.text",
|
|
9
|
+
receivedButtonPayload: "channel-whatsapp.message-received.buttonPayload",
|
|
10
|
+
statusRecipient: "channel-whatsapp.status-updated.recipient",
|
|
11
|
+
throttledFrom: "channel-whatsapp.throttled.from",
|
|
12
|
+
};
|
|
13
|
+
/** Without a configured PII KMS the value passes through, like every other event-sourced inbound path. */
|
|
14
|
+
export async function encryptWhatsappPii(tenantId, field, value, requestId) {
|
|
15
|
+
const kms = configuredPiiSubjectKms();
|
|
16
|
+
if (!kms)
|
|
17
|
+
return value;
|
|
18
|
+
return encryptPiiValueForSubject(kms, { kind: "tenant", tenantId }, value, { requestId, tenantId }, field);
|
|
19
|
+
}
|
|
20
|
+
export async function decryptWhatsappPii(tenantId, field, value) {
|
|
21
|
+
const kms = configuredPiiSubjectKms();
|
|
22
|
+
if (!kms)
|
|
23
|
+
return value;
|
|
24
|
+
return decryptPiiValueForSubject(kms, value, { requestId: `channel-whatsapp:decrypt:${field}`, tenantId }, field);
|
|
25
|
+
}
|
|
26
|
+
/** Plaintext recipient of a `status-updated` event payload. */
|
|
27
|
+
export async function readWhatsappStatusPii(tenantId, payload) {
|
|
28
|
+
const recipient = propertyOf(payload, "recipient");
|
|
29
|
+
if (typeof recipient !== "string")
|
|
30
|
+
throw new Error("channel-whatsapp: payload has no recipient");
|
|
31
|
+
return {
|
|
32
|
+
recipient: await decryptWhatsappPii(tenantId, WhatsappPiiFields.statusRecipient, recipient),
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/** Plaintext sender of a `throttled` event payload. */
|
|
36
|
+
export async function readWhatsappThrottledPii(tenantId, payload) {
|
|
37
|
+
const from = propertyOf(payload, "from");
|
|
38
|
+
if (typeof from !== "string")
|
|
39
|
+
throw new Error("channel-whatsapp: payload has no sender");
|
|
40
|
+
return { from: await decryptWhatsappPii(tenantId, WhatsappPiiFields.throttledFrom, from) };
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Plaintext of the PII fields of a `message-received` event payload, for the consumer.
|
|
44
|
+
* A tenant that was destroyed yields the erased sentinel instead of the value.
|
|
45
|
+
*/
|
|
46
|
+
export async function readWhatsappMessagePii(tenantId, payload) {
|
|
47
|
+
const from = propertyOf(payload, "from");
|
|
48
|
+
const text = propertyOf(payload, "text");
|
|
49
|
+
const buttonPayload = propertyOf(payload, "buttonPayload");
|
|
50
|
+
if (typeof from !== "string")
|
|
51
|
+
throw new Error("channel-whatsapp: payload has no sender");
|
|
52
|
+
return {
|
|
53
|
+
from: await decryptWhatsappPii(tenantId, WhatsappPiiFields.receivedFrom, from),
|
|
54
|
+
text: typeof text === "string"
|
|
55
|
+
? await decryptWhatsappPii(tenantId, WhatsappPiiFields.receivedText, text)
|
|
56
|
+
: null,
|
|
57
|
+
buttonPayload: typeof buttonPayload === "string"
|
|
58
|
+
? await decryptWhatsappPii(tenantId, WhatsappPiiFields.receivedButtonPayload, buttonPayload)
|
|
59
|
+
: null,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type ReceiveMessageInput, type RecordStatusInput } from "./events.ts";
|
|
2
|
+
export type NormalizedWebhook = {
|
|
3
|
+
readonly messages: readonly ReceiveMessageInput[];
|
|
4
|
+
readonly statuses: readonly RecordStatusInput[];
|
|
5
|
+
readonly skipped: number;
|
|
6
|
+
};
|
|
7
|
+
export declare function normalizeWhatsappWebhook(body: unknown, nowIso: string): NormalizedWebhook;
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
|
|
2
|
+
import * as z from "zod";
|
|
3
|
+
import { WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS, WHATSAPP_STATUS_KINDS, WHATSAPP_TEXT_MAX_CHARS, } from "./constants.js";
|
|
4
|
+
import { MIME_TYPE_MAX_CHARS, PHONE_NUMBER_ID_MAX_CHARS, RAW_STATUS_MAX_CHARS, WAMID_MAX_CHARS, } from "./events.js";
|
|
5
|
+
// Meta adds fields and message types without notice. Every nested object is `.catch(undefined)`,
|
|
6
|
+
// so one unexpected shape costs that detail and not the whole message.
|
|
7
|
+
const mediaSchema = z.object({ id: z.string().optional(), mime_type: z.string().optional() });
|
|
8
|
+
const messageSchema = z.object({
|
|
9
|
+
id: z.string().min(1),
|
|
10
|
+
from: z.string(),
|
|
11
|
+
timestamp: z.string().optional(),
|
|
12
|
+
type: z.string().optional(),
|
|
13
|
+
text: z.object({ body: z.string() }).optional().catch(undefined),
|
|
14
|
+
audio: mediaSchema.optional().catch(undefined),
|
|
15
|
+
image: mediaSchema.optional().catch(undefined),
|
|
16
|
+
interactive: z
|
|
17
|
+
.object({
|
|
18
|
+
button_reply: z
|
|
19
|
+
.object({ id: z.string(), title: z.string().optional() })
|
|
20
|
+
.optional()
|
|
21
|
+
.catch(undefined),
|
|
22
|
+
})
|
|
23
|
+
.optional()
|
|
24
|
+
.catch(undefined),
|
|
25
|
+
button: z
|
|
26
|
+
.object({ payload: z.string().optional(), text: z.string().optional() })
|
|
27
|
+
.optional()
|
|
28
|
+
.catch(undefined),
|
|
29
|
+
context: z.object({ id: z.string().optional() }).optional().catch(undefined),
|
|
30
|
+
});
|
|
31
|
+
const statusSchema = z.object({
|
|
32
|
+
id: z.string().min(1),
|
|
33
|
+
status: z.string().optional(),
|
|
34
|
+
timestamp: z.string().optional(),
|
|
35
|
+
recipient_id: z.string().optional(),
|
|
36
|
+
errors: z
|
|
37
|
+
.array(z.object({ code: z.number().int().optional().catch(undefined) }))
|
|
38
|
+
.optional()
|
|
39
|
+
.catch(undefined),
|
|
40
|
+
});
|
|
41
|
+
const changeValueSchema = z.object({
|
|
42
|
+
metadata: z.object({ phone_number_id: z.string().optional() }).optional().catch(undefined),
|
|
43
|
+
messages: z.array(z.unknown()).optional().catch(undefined),
|
|
44
|
+
statuses: z.array(z.unknown()).optional().catch(undefined),
|
|
45
|
+
});
|
|
46
|
+
const webhookSchema = z.object({
|
|
47
|
+
entry: z
|
|
48
|
+
.array(z.object({
|
|
49
|
+
changes: z
|
|
50
|
+
.array(z.object({ value: changeValueSchema.optional().catch(undefined) }))
|
|
51
|
+
.optional()
|
|
52
|
+
.catch(undefined),
|
|
53
|
+
}))
|
|
54
|
+
.optional()
|
|
55
|
+
.catch(undefined),
|
|
56
|
+
});
|
|
57
|
+
// Temporal.Instant throws beyond 8.64e15 epoch milliseconds.
|
|
58
|
+
const MAX_EPOCH_SECONDS = 8.64e12;
|
|
59
|
+
const DIGITS_PATTERN = /^\d{5,20}$/;
|
|
60
|
+
function toE164(raw) {
|
|
61
|
+
const digits = raw.replace(/^\+/, "");
|
|
62
|
+
return DIGITS_PATTERN.test(digits) ? `+${digits}` : null;
|
|
63
|
+
}
|
|
64
|
+
function toIso(unixSeconds, fallbackIso) {
|
|
65
|
+
const seconds = Number(unixSeconds);
|
|
66
|
+
return unixSeconds !== undefined &&
|
|
67
|
+
Number.isFinite(seconds) &&
|
|
68
|
+
seconds > 0 &&
|
|
69
|
+
seconds <= MAX_EPOCH_SECONDS
|
|
70
|
+
? Temporal.Instant.fromEpochMilliseconds(Math.floor(seconds) * 1000).toString()
|
|
71
|
+
: fallbackIso;
|
|
72
|
+
}
|
|
73
|
+
function clip(value, maxChars) {
|
|
74
|
+
return value.length > maxChars ? value.slice(0, maxChars) : value;
|
|
75
|
+
}
|
|
76
|
+
const NO_CONTENT = { text: null, buttonPayload: null, mediaId: null, mimeType: null };
|
|
77
|
+
function optionalClip(value, maxChars) {
|
|
78
|
+
return value === undefined ? null : clip(value, maxChars);
|
|
79
|
+
}
|
|
80
|
+
// A truncated id would point at another object, so an oversized one is dropped, not clipped.
|
|
81
|
+
function optionalId(value) {
|
|
82
|
+
return value === undefined || value.length > WAMID_MAX_CHARS ? null : value;
|
|
83
|
+
}
|
|
84
|
+
function buttonContentOf(message) {
|
|
85
|
+
const reply = message.interactive?.button_reply;
|
|
86
|
+
if (message.type === "interactive" && reply) {
|
|
87
|
+
return {
|
|
88
|
+
...NO_CONTENT,
|
|
89
|
+
messageType: "interactive_button",
|
|
90
|
+
text: optionalClip(reply.title, WHATSAPP_TEXT_MAX_CHARS),
|
|
91
|
+
buttonPayload: clip(reply.id, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS),
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
// Quick-reply buttons of a template arrive as type "button".
|
|
95
|
+
if (message.type === "button" && message.button?.payload !== undefined) {
|
|
96
|
+
return {
|
|
97
|
+
...NO_CONTENT,
|
|
98
|
+
messageType: "interactive_button",
|
|
99
|
+
text: optionalClip(message.button.text, WHATSAPP_TEXT_MAX_CHARS),
|
|
100
|
+
buttonPayload: clip(message.button.payload, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS),
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
return null;
|
|
104
|
+
}
|
|
105
|
+
function mediaContentOf(message) {
|
|
106
|
+
if (message.type !== "audio" && message.type !== "image")
|
|
107
|
+
return null;
|
|
108
|
+
const media = message.type === "audio" ? message.audio : message.image;
|
|
109
|
+
if (!media)
|
|
110
|
+
return null;
|
|
111
|
+
return {
|
|
112
|
+
...NO_CONTENT,
|
|
113
|
+
messageType: message.type,
|
|
114
|
+
mediaId: optionalId(media.id),
|
|
115
|
+
mimeType: optionalClip(media.mime_type, MIME_TYPE_MAX_CHARS),
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
function contentOf(message) {
|
|
119
|
+
if (message.type === "text" && message.text) {
|
|
120
|
+
return {
|
|
121
|
+
...NO_CONTENT,
|
|
122
|
+
messageType: "text",
|
|
123
|
+
text: clip(message.text.body, WHATSAPP_TEXT_MAX_CHARS),
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
return (buttonContentOf(message) ?? mediaContentOf(message) ?? { ...NO_CONTENT, messageType: "other" });
|
|
127
|
+
}
|
|
128
|
+
function normalizeMessage(raw, phoneNumberId, nowIso) {
|
|
129
|
+
const parsed = messageSchema.safeParse(raw);
|
|
130
|
+
if (!parsed.success)
|
|
131
|
+
return null;
|
|
132
|
+
const message = parsed.data;
|
|
133
|
+
if (message.id.length > WAMID_MAX_CHARS || phoneNumberId.length > PHONE_NUMBER_ID_MAX_CHARS) {
|
|
134
|
+
return null;
|
|
135
|
+
}
|
|
136
|
+
const from = toE164(message.from);
|
|
137
|
+
if (from === null)
|
|
138
|
+
return null;
|
|
139
|
+
return {
|
|
140
|
+
phoneNumberId,
|
|
141
|
+
wamid: message.id,
|
|
142
|
+
from,
|
|
143
|
+
timestampIso: toIso(message.timestamp, nowIso),
|
|
144
|
+
contextWamid: optionalId(message.context?.id),
|
|
145
|
+
...contentOf(message),
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
function statusKindOf(raw) {
|
|
149
|
+
return WHATSAPP_STATUS_KINDS.find((kind) => kind === raw) ?? "other";
|
|
150
|
+
}
|
|
151
|
+
function normalizeStatus(raw, phoneNumberId, nowIso) {
|
|
152
|
+
const parsed = statusSchema.safeParse(raw);
|
|
153
|
+
if (!parsed.success)
|
|
154
|
+
return null;
|
|
155
|
+
const status = parsed.data;
|
|
156
|
+
if (status.id.length > WAMID_MAX_CHARS || phoneNumberId.length > PHONE_NUMBER_ID_MAX_CHARS) {
|
|
157
|
+
return null;
|
|
158
|
+
}
|
|
159
|
+
const recipient = toE164(status.recipient_id ?? "");
|
|
160
|
+
if (recipient === null)
|
|
161
|
+
return null;
|
|
162
|
+
return {
|
|
163
|
+
phoneNumberId,
|
|
164
|
+
wamid: status.id,
|
|
165
|
+
status: statusKindOf(status.status),
|
|
166
|
+
rawStatus: status.status === undefined ? null : clip(status.status, RAW_STATUS_MAX_CHARS),
|
|
167
|
+
timestampIso: toIso(status.timestamp, nowIso),
|
|
168
|
+
recipient,
|
|
169
|
+
errorCode: status.errors?.[0]?.code ?? null,
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
export function normalizeWhatsappWebhook(body, nowIso) {
|
|
173
|
+
const parsed = webhookSchema.safeParse(body);
|
|
174
|
+
const messages = [];
|
|
175
|
+
const statuses = [];
|
|
176
|
+
let skipped = 0;
|
|
177
|
+
if (!parsed.success)
|
|
178
|
+
return { messages, statuses, skipped };
|
|
179
|
+
for (const entry of parsed.data.entry ?? []) {
|
|
180
|
+
for (const change of entry.changes ?? []) {
|
|
181
|
+
const value = change.value;
|
|
182
|
+
const phoneNumberId = value?.metadata?.phone_number_id;
|
|
183
|
+
for (const raw of value?.messages ?? []) {
|
|
184
|
+
const normalized = phoneNumberId ? normalizeMessage(raw, phoneNumberId, nowIso) : null;
|
|
185
|
+
if (normalized)
|
|
186
|
+
messages.push(normalized);
|
|
187
|
+
else
|
|
188
|
+
skipped += 1;
|
|
189
|
+
}
|
|
190
|
+
for (const raw of value?.statuses ?? []) {
|
|
191
|
+
const normalized = phoneNumberId ? normalizeStatus(raw, phoneNumberId, nowIso) : null;
|
|
192
|
+
if (normalized)
|
|
193
|
+
statuses.push(normalized);
|
|
194
|
+
else
|
|
195
|
+
skipped += 1;
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
return { messages, statuses, skipped };
|
|
200
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type ExtraRouteDefinition } from "@cosmicdrift/kumiko-framework/api";
|
|
2
|
+
export type WhatsappWebhookRouteOptions = {
|
|
3
|
+
/** Route path; MUST carry `:tenantId`. The secrets are tenant-scoped, so the tenant is part of the URL. */
|
|
4
|
+
readonly path?: string;
|
|
5
|
+
};
|
|
6
|
+
/**
|
|
7
|
+
* The two routes Meta needs: GET answers the subscription handshake (`hub.challenge`), POST takes
|
|
8
|
+
* the signed notifications. Mount via `extraRoutes: createWhatsappWebhookRoutes()`.
|
|
9
|
+
*/
|
|
10
|
+
export declare function createWhatsappWebhookRoutes(options?: WhatsappWebhookRouteOptions): readonly ExtraRouteDefinition[];
|