@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
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
export const CHANNEL_WHATSAPP_FEATURE = "channel-whatsapp";
|
|
2
|
+
export const WHATSAPP_SECRET_KEYS = {
|
|
3
|
+
accessToken: `${CHANNEL_WHATSAPP_FEATURE}:secret:access-token`,
|
|
4
|
+
appSecret: `${CHANNEL_WHATSAPP_FEATURE}:secret:app-secret`,
|
|
5
|
+
verifyToken: `${CHANNEL_WHATSAPP_FEATURE}:secret:verify-token`,
|
|
6
|
+
};
|
|
7
|
+
export const WhatsappHandlers = {
|
|
8
|
+
receiveMessage: `${CHANNEL_WHATSAPP_FEATURE}:write:receive-message`,
|
|
9
|
+
recordStatus: `${CHANNEL_WHATSAPP_FEATURE}:write:record-status`,
|
|
10
|
+
};
|
|
11
|
+
export const WHATSAPP_DEFAULT_API_BASE_URL = "https://graph.facebook.com";
|
|
12
|
+
export const WHATSAPP_DEFAULT_API_VERSION = "v21.0";
|
|
13
|
+
// Meta serves media downloads from lookaside.fbsbx.com, not from the Graph host.
|
|
14
|
+
export const WHATSAPP_DEFAULT_ALLOWED_HOSTS = [
|
|
15
|
+
"graph.facebook.com",
|
|
16
|
+
"lookaside.fbsbx.com",
|
|
17
|
+
];
|
|
18
|
+
export const WHATSAPP_DEFAULT_TIMEOUT_MS = 10_000;
|
|
19
|
+
export const WHATSAPP_DEFAULT_MEDIA_MAX_BYTES = 25 * 1024 * 1024;
|
|
20
|
+
export const WHATSAPP_DEFAULT_WEBHOOK_PATH = "/api/channel-whatsapp/webhook/:tenantId";
|
|
21
|
+
// Graph error code for a free-form message outside the 24h customer-service window.
|
|
22
|
+
export const WHATSAPP_OUTSIDE_WINDOW_ERROR_CODE = 131047;
|
|
23
|
+
export const WHATSAPP_MESSAGE_TYPES = [
|
|
24
|
+
"text",
|
|
25
|
+
"audio",
|
|
26
|
+
"image",
|
|
27
|
+
"interactive_button",
|
|
28
|
+
"other",
|
|
29
|
+
];
|
|
30
|
+
export const WHATSAPP_STATUS_KINDS = ["sent", "delivered", "read", "failed", "other"];
|
|
31
|
+
// Meta's documented body limits; the normalizer clips to them so an oversized value
|
|
32
|
+
// never turns into a permanently failing dispatch.
|
|
33
|
+
export const WHATSAPP_TEXT_MAX_CHARS = 4096;
|
|
34
|
+
export const WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS = 256;
|
|
35
|
+
export const WHATSAPP_BUTTON_TITLE_MAX_CHARS = 20;
|
|
36
|
+
export const WHATSAPP_MAX_REPLY_BUTTONS = 3;
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import * as z from "zod";
|
|
2
|
+
export declare const WHATSAPP_MESSAGE_AGGREGATE_TYPE: "whatsapp-message";
|
|
3
|
+
export declare const WHATSAPP_STATUS_AGGREGATE_TYPE: "whatsapp-status";
|
|
4
|
+
export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT: "message-received";
|
|
5
|
+
export declare const WHATSAPP_STATUS_UPDATED_EVENT_SHORT: "status-updated";
|
|
6
|
+
export declare const WHATSAPP_THROTTLED_EVENT_SHORT: "throttled";
|
|
7
|
+
export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_QN: "channel-whatsapp:event:message-received";
|
|
8
|
+
export declare const WHATSAPP_STATUS_UPDATED_EVENT_QN: "channel-whatsapp:event:status-updated";
|
|
9
|
+
export declare const WHATSAPP_THROTTLED_EVENT_QN: "channel-whatsapp:event:throttled";
|
|
10
|
+
export declare const RAW_STATUS_MAX_CHARS = 64;
|
|
11
|
+
export declare const receiveMessageInputSchema: z.ZodObject<{
|
|
12
|
+
phoneNumberId: z.ZodString;
|
|
13
|
+
wamid: z.ZodString;
|
|
14
|
+
from: z.ZodString;
|
|
15
|
+
timestampIso: z.ZodString;
|
|
16
|
+
messageType: z.ZodEnum<{
|
|
17
|
+
audio: "audio";
|
|
18
|
+
image: "image";
|
|
19
|
+
interactive_button: "interactive_button";
|
|
20
|
+
other: "other";
|
|
21
|
+
text: "text";
|
|
22
|
+
}>;
|
|
23
|
+
text: z.ZodNullable<z.ZodString>;
|
|
24
|
+
buttonPayload: z.ZodNullable<z.ZodString>;
|
|
25
|
+
contextWamid: z.ZodNullable<z.ZodString>;
|
|
26
|
+
mediaId: z.ZodNullable<z.ZodString>;
|
|
27
|
+
mimeType: z.ZodNullable<z.ZodString>;
|
|
28
|
+
}, z.core.$strip>;
|
|
29
|
+
export type ReceiveMessageInput = z.infer<typeof receiveMessageInputSchema>;
|
|
30
|
+
export declare const recordStatusInputSchema: z.ZodObject<{
|
|
31
|
+
phoneNumberId: z.ZodString;
|
|
32
|
+
wamid: z.ZodString;
|
|
33
|
+
status: z.ZodEnum<{
|
|
34
|
+
delivered: "delivered";
|
|
35
|
+
failed: "failed";
|
|
36
|
+
other: "other";
|
|
37
|
+
read: "read";
|
|
38
|
+
sent: "sent";
|
|
39
|
+
}>;
|
|
40
|
+
rawStatus: z.ZodNullable<z.ZodString>;
|
|
41
|
+
timestampIso: z.ZodString;
|
|
42
|
+
recipient: z.ZodString;
|
|
43
|
+
errorCode: z.ZodNullable<z.ZodNumber>;
|
|
44
|
+
}, z.core.$strip>;
|
|
45
|
+
export type RecordStatusInput = z.infer<typeof recordStatusInputSchema>;
|
|
46
|
+
export declare const messageReceivedPayloadSchema: z.ZodObject<{
|
|
47
|
+
phoneNumberId: z.ZodString;
|
|
48
|
+
wamid: z.ZodString;
|
|
49
|
+
from: z.ZodString;
|
|
50
|
+
timestampIso: z.ZodString;
|
|
51
|
+
messageType: z.ZodEnum<{
|
|
52
|
+
audio: "audio";
|
|
53
|
+
image: "image";
|
|
54
|
+
interactive_button: "interactive_button";
|
|
55
|
+
other: "other";
|
|
56
|
+
text: "text";
|
|
57
|
+
}>;
|
|
58
|
+
text: z.ZodNullable<z.ZodString>;
|
|
59
|
+
buttonPayload: z.ZodNullable<z.ZodString>;
|
|
60
|
+
contextWamid: z.ZodNullable<z.ZodString>;
|
|
61
|
+
mediaId: z.ZodNullable<z.ZodString>;
|
|
62
|
+
mimeType: z.ZodNullable<z.ZodString>;
|
|
63
|
+
}, z.core.$strip>;
|
|
64
|
+
export type MessageReceivedPayload = z.infer<typeof messageReceivedPayloadSchema>;
|
|
65
|
+
export declare const statusUpdatedPayloadSchema: z.ZodObject<{
|
|
66
|
+
phoneNumberId: z.ZodString;
|
|
67
|
+
wamid: z.ZodString;
|
|
68
|
+
status: z.ZodEnum<{
|
|
69
|
+
delivered: "delivered";
|
|
70
|
+
failed: "failed";
|
|
71
|
+
other: "other";
|
|
72
|
+
read: "read";
|
|
73
|
+
sent: "sent";
|
|
74
|
+
}>;
|
|
75
|
+
timestampIso: z.ZodString;
|
|
76
|
+
recipient: z.ZodString;
|
|
77
|
+
errorCode: z.ZodNullable<z.ZodNumber>;
|
|
78
|
+
}, z.core.$strip>;
|
|
79
|
+
export type StatusUpdatedPayload = z.infer<typeof statusUpdatedPayloadSchema>;
|
|
80
|
+
export declare const throttledPayloadSchema: z.ZodObject<{
|
|
81
|
+
phoneNumberId: z.ZodString;
|
|
82
|
+
wamid: z.ZodString;
|
|
83
|
+
from: z.ZodString;
|
|
84
|
+
timestampIso: z.ZodString;
|
|
85
|
+
retryAfterSeconds: z.ZodNumber;
|
|
86
|
+
}, z.core.$strip>;
|
|
87
|
+
export type ThrottledPayload = z.infer<typeof throttledPayloadSchema>;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { piiCiphertextMaxLengthFor } from "@cosmicdrift/kumiko-framework/crypto";
|
|
2
|
+
import * as z from "zod";
|
|
3
|
+
import { CHANNEL_WHATSAPP_FEATURE, WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS, WHATSAPP_MESSAGE_TYPES, WHATSAPP_STATUS_KINDS, WHATSAPP_TEXT_MAX_CHARS, } from "./constants.js";
|
|
4
|
+
export const WHATSAPP_MESSAGE_AGGREGATE_TYPE = "whatsapp-message";
|
|
5
|
+
export const WHATSAPP_STATUS_AGGREGATE_TYPE = "whatsapp-status";
|
|
6
|
+
export const WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT = "message-received";
|
|
7
|
+
export const WHATSAPP_STATUS_UPDATED_EVENT_SHORT = "status-updated";
|
|
8
|
+
export const WHATSAPP_THROTTLED_EVENT_SHORT = "throttled";
|
|
9
|
+
export const WHATSAPP_MESSAGE_RECEIVED_EVENT_QN = `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT}`;
|
|
10
|
+
export const WHATSAPP_STATUS_UPDATED_EVENT_QN = `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_STATUS_UPDATED_EVENT_SHORT}`;
|
|
11
|
+
export const WHATSAPP_THROTTLED_EVENT_QN = `${CHANNEL_WHATSAPP_FEATURE}:event:${WHATSAPP_THROTTLED_EVENT_SHORT}`;
|
|
12
|
+
const E164_MAX_CHARS = 32;
|
|
13
|
+
const WAMID_MAX_CHARS = 256;
|
|
14
|
+
const PHONE_NUMBER_ID_MAX_CHARS = 64;
|
|
15
|
+
export const RAW_STATUS_MAX_CHARS = 64;
|
|
16
|
+
// What the webhook route hands to the write handlers: normalized, still plaintext.
|
|
17
|
+
export const receiveMessageInputSchema = z.object({
|
|
18
|
+
phoneNumberId: z.string().min(1).max(PHONE_NUMBER_ID_MAX_CHARS),
|
|
19
|
+
wamid: z.string().min(1).max(WAMID_MAX_CHARS),
|
|
20
|
+
from: z.string().min(1).max(E164_MAX_CHARS),
|
|
21
|
+
timestampIso: z.string().min(1),
|
|
22
|
+
messageType: z.enum(WHATSAPP_MESSAGE_TYPES),
|
|
23
|
+
text: z.string().max(WHATSAPP_TEXT_MAX_CHARS).nullable(),
|
|
24
|
+
buttonPayload: z.string().max(WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS).nullable(),
|
|
25
|
+
contextWamid: z.string().max(WAMID_MAX_CHARS).nullable(),
|
|
26
|
+
mediaId: z.string().max(WAMID_MAX_CHARS).nullable(),
|
|
27
|
+
mimeType: z.string().max(255).nullable(),
|
|
28
|
+
});
|
|
29
|
+
export const recordStatusInputSchema = z.object({
|
|
30
|
+
phoneNumberId: z.string().min(1).max(PHONE_NUMBER_ID_MAX_CHARS),
|
|
31
|
+
wamid: z.string().min(1).max(WAMID_MAX_CHARS),
|
|
32
|
+
status: z.enum(WHATSAPP_STATUS_KINDS),
|
|
33
|
+
// Meta's own status word; only keys the stream of an unrecognised status, never stored in the event.
|
|
34
|
+
rawStatus: z.string().max(RAW_STATUS_MAX_CHARS).nullable(),
|
|
35
|
+
timestampIso: z.string().min(1),
|
|
36
|
+
recipient: z.string().min(1).max(E164_MAX_CHARS),
|
|
37
|
+
errorCode: z.number().int().nullable(),
|
|
38
|
+
});
|
|
39
|
+
// Event payloads: sender and recipient numbers, message text and button payloads are
|
|
40
|
+
// PII and stored as tenant-key ciphertext (see pii.ts).
|
|
41
|
+
export const messageReceivedPayloadSchema = z.object({
|
|
42
|
+
phoneNumberId: receiveMessageInputSchema.shape.phoneNumberId,
|
|
43
|
+
wamid: receiveMessageInputSchema.shape.wamid,
|
|
44
|
+
from: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
|
|
45
|
+
timestampIso: z.string().min(1),
|
|
46
|
+
messageType: receiveMessageInputSchema.shape.messageType,
|
|
47
|
+
text: z.string().max(piiCiphertextMaxLengthFor(WHATSAPP_TEXT_MAX_CHARS)).nullable(),
|
|
48
|
+
buttonPayload: z
|
|
49
|
+
.string()
|
|
50
|
+
.max(piiCiphertextMaxLengthFor(WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS))
|
|
51
|
+
.nullable(),
|
|
52
|
+
contextWamid: receiveMessageInputSchema.shape.contextWamid,
|
|
53
|
+
mediaId: receiveMessageInputSchema.shape.mediaId,
|
|
54
|
+
mimeType: receiveMessageInputSchema.shape.mimeType,
|
|
55
|
+
});
|
|
56
|
+
export const statusUpdatedPayloadSchema = z.object({
|
|
57
|
+
phoneNumberId: recordStatusInputSchema.shape.phoneNumberId,
|
|
58
|
+
wamid: recordStatusInputSchema.shape.wamid,
|
|
59
|
+
status: recordStatusInputSchema.shape.status,
|
|
60
|
+
timestampIso: z.string().min(1),
|
|
61
|
+
recipient: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
|
|
62
|
+
errorCode: recordStatusInputSchema.shape.errorCode,
|
|
63
|
+
});
|
|
64
|
+
export const throttledPayloadSchema = z.object({
|
|
65
|
+
phoneNumberId: receiveMessageInputSchema.shape.phoneNumberId,
|
|
66
|
+
wamid: receiveMessageInputSchema.shape.wamid,
|
|
67
|
+
from: z.string().min(1).max(piiCiphertextMaxLengthFor(E164_MAX_CHARS)),
|
|
68
|
+
timestampIso: z.string().min(1),
|
|
69
|
+
retryAfterSeconds: z.number().int().min(0),
|
|
70
|
+
});
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
|
|
2
|
+
import * as z from "zod";
|
|
3
|
+
import { CHANNEL_WHATSAPP_FEATURE } from "./constants.js";
|
|
4
|
+
import { messageReceivedPayloadSchema, statusUpdatedPayloadSchema, throttledPayloadSchema, WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT, WHATSAPP_STATUS_UPDATED_EVENT_SHORT, WHATSAPP_THROTTLED_EVENT_SHORT, } from "./events.js";
|
|
5
|
+
import { createReceiveMessageHandler, createRecordStatusHandler } from "./inbound-handlers.js";
|
|
6
|
+
import { resolveWhatsappOptions } from "./options.js";
|
|
7
|
+
const MAX_SECRET_CHARS = 512;
|
|
8
|
+
const secretValueSchema = z.string().min(1).max(MAX_SECRET_CHARS);
|
|
9
|
+
export function createChannelWhatsappFeature(options = {}) {
|
|
10
|
+
const resolved = resolveWhatsappOptions(options);
|
|
11
|
+
return defineFeature(CHANNEL_WHATSAPP_FEATURE, (r) => {
|
|
12
|
+
r.describe("WhatsApp Business (Meta Cloud API) as a two-way channel, not a delivery channel. Inbound: mount `createWhatsappWebhookRoutes()` via `extraRoutes` (default path `/api/channel-whatsapp/webhook/:tenantId`, the tenant id is part of the URL because the secrets are tenant-scoped); GET answers Meta's `hub.challenge` handshake, POST checks `X-Hub-Signature-256` over the raw body and normalizes each message and status. Events: `channel-whatsapp:event:message-received` (sender, wamid, type text|audio|image|interactive_button|other, text, button payload, `contextWamid`, media id and mime type, `phoneNumberId`), `status-updated` (sent|delivered|read|failed|other) and `throttled` (sender over the per-number limit). Sender number, text, button payload and status recipient are PII, stored as tenant-key ciphertext; read them with `readWhatsappMessagePii`. A redelivered wamid is stored once and answered 200; a failed dispatch answers 500 so Meta redelivers. Outbound: `createWhatsappClient(opts)` gives `sendText`, `sendTemplate`, `sendButtons`, `sendMedia` (each takes the sending `phoneNumberId` and answers `{ ok: true, wamid }` or a typed failure) and `fetchMedia` (media id to bytes and mime type; the URL from the Graph answer is checked against `allowedHosts` before the token is sent). Tenant secrets `channel-whatsapp:secret:access-token`, `app-secret` and `verify-token`. App options of `createChannelWhatsappFeature(opts)`: `apiBaseUrl`, `apiVersion` (default v21.0), `allowedHosts` (default graph.facebook.com and lookaside.fbsbx.com), `requireHttps` (default true; boot fails on a mismatch), `timeoutMs`, `mediaMaxBytes`, `transport` (in-memory Meta for tests), `senderRateLimits` (default 30 per hour and 200 per day per sender and tenant) and `rateLimit` (flood guard of the inbound handlers; cannot be disabled while a sender limit is set). Requires `secrets`. A worker-run job triggered by `message-received` attaches the business process.");
|
|
13
|
+
r.uiHints({
|
|
14
|
+
displayLabel: "WhatsApp Channel",
|
|
15
|
+
category: "notifications",
|
|
16
|
+
recommended: false,
|
|
17
|
+
});
|
|
18
|
+
r.requires({ features: ["secrets"] });
|
|
19
|
+
r.secret("accessToken", {
|
|
20
|
+
label: { en: "WhatsApp access token" },
|
|
21
|
+
hint: {
|
|
22
|
+
en: "System-user access token of the Meta app. Used to send messages and to download media.",
|
|
23
|
+
},
|
|
24
|
+
redact: () => "••••••••",
|
|
25
|
+
scope: "tenant",
|
|
26
|
+
valueSchema: secretValueSchema,
|
|
27
|
+
});
|
|
28
|
+
r.secret("appSecret", {
|
|
29
|
+
label: { en: "WhatsApp app secret" },
|
|
30
|
+
hint: { en: "App secret of the Meta app. Verifies the signature of every incoming webhook." },
|
|
31
|
+
redact: () => "••••••••",
|
|
32
|
+
scope: "tenant",
|
|
33
|
+
valueSchema: secretValueSchema,
|
|
34
|
+
});
|
|
35
|
+
r.secret("verifyToken", {
|
|
36
|
+
label: { en: "WhatsApp verify token" },
|
|
37
|
+
hint: {
|
|
38
|
+
en: "Any string you also enter in the Meta webhook settings; answers Meta's subscription handshake.",
|
|
39
|
+
},
|
|
40
|
+
redact: () => "••••••••",
|
|
41
|
+
scope: "tenant",
|
|
42
|
+
valueSchema: secretValueSchema,
|
|
43
|
+
});
|
|
44
|
+
r.defineEvent(WHATSAPP_MESSAGE_RECEIVED_EVENT_SHORT, messageReceivedPayloadSchema, {
|
|
45
|
+
piiFields: "none",
|
|
46
|
+
});
|
|
47
|
+
r.defineEvent(WHATSAPP_STATUS_UPDATED_EVENT_SHORT, statusUpdatedPayloadSchema, {
|
|
48
|
+
piiFields: "none",
|
|
49
|
+
});
|
|
50
|
+
r.defineEvent(WHATSAPP_THROTTLED_EVENT_SHORT, throttledPayloadSchema, {
|
|
51
|
+
piiFields: "none",
|
|
52
|
+
});
|
|
53
|
+
r.writeHandler(createReceiveMessageHandler(resolved));
|
|
54
|
+
r.writeHandler(createRecordStatusHandler(resolved));
|
|
55
|
+
});
|
|
56
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import type { SecretsContext } from "@cosmicdrift/kumiko-framework/secrets";
|
|
2
|
+
import type { TenantId } from "@cosmicdrift/kumiko-types/identifiers";
|
|
3
|
+
import { type ChannelWhatsappOptions, type ResolvedWhatsappOptions } from "./options.ts";
|
|
4
|
+
export type WhatsappSendFailure = {
|
|
5
|
+
readonly code: "missing_credentials";
|
|
6
|
+
} | {
|
|
7
|
+
readonly code: "invalid_phone_number_id";
|
|
8
|
+
} | {
|
|
9
|
+
readonly code: "invalid_recipient";
|
|
10
|
+
} | {
|
|
11
|
+
readonly code: "invalid_message";
|
|
12
|
+
} | {
|
|
13
|
+
readonly code: "host_not_allowed";
|
|
14
|
+
} | {
|
|
15
|
+
readonly code: "timeout";
|
|
16
|
+
} | {
|
|
17
|
+
readonly code: "unreachable";
|
|
18
|
+
} | {
|
|
19
|
+
readonly code: "invalid_response";
|
|
20
|
+
} | {
|
|
21
|
+
readonly code: "rejected";
|
|
22
|
+
readonly httpStatus: number;
|
|
23
|
+
readonly metaCode: number | null;
|
|
24
|
+
};
|
|
25
|
+
export type WhatsappSendResult = {
|
|
26
|
+
readonly ok: true;
|
|
27
|
+
readonly wamid: string;
|
|
28
|
+
} | ({
|
|
29
|
+
readonly ok: false;
|
|
30
|
+
} & WhatsappSendFailure);
|
|
31
|
+
export type WhatsappMediaFailure = WhatsappSendFailure | {
|
|
32
|
+
readonly code: "invalid_media_id";
|
|
33
|
+
} | {
|
|
34
|
+
readonly code: "redirect_blocked";
|
|
35
|
+
} | {
|
|
36
|
+
readonly code: "too_large";
|
|
37
|
+
};
|
|
38
|
+
export type WhatsappMediaResult = {
|
|
39
|
+
readonly ok: true;
|
|
40
|
+
readonly bytes: Uint8Array;
|
|
41
|
+
readonly mimeType: string;
|
|
42
|
+
} | ({
|
|
43
|
+
readonly ok: false;
|
|
44
|
+
} & WhatsappMediaFailure);
|
|
45
|
+
/** What a send needs from the caller: the tenant and `ctx.services.secrets` of the handler or job. */
|
|
46
|
+
export type WhatsappCallContext = {
|
|
47
|
+
readonly tenantId: TenantId;
|
|
48
|
+
readonly secrets: SecretsContext | undefined;
|
|
49
|
+
};
|
|
50
|
+
type SendBase = {
|
|
51
|
+
readonly phoneNumberId: string;
|
|
52
|
+
readonly to: string;
|
|
53
|
+
readonly replyToWamid?: string;
|
|
54
|
+
};
|
|
55
|
+
export type WhatsappTextInput = SendBase & {
|
|
56
|
+
readonly text: string;
|
|
57
|
+
};
|
|
58
|
+
export type WhatsappTemplateInput = SendBase & {
|
|
59
|
+
readonly templateName: string;
|
|
60
|
+
readonly languageCode: string;
|
|
61
|
+
readonly bodyParameters?: readonly string[];
|
|
62
|
+
};
|
|
63
|
+
export type WhatsappReplyButton = {
|
|
64
|
+
readonly payload: string;
|
|
65
|
+
readonly title: string;
|
|
66
|
+
};
|
|
67
|
+
export type WhatsappButtonsInput = SendBase & {
|
|
68
|
+
readonly text: string;
|
|
69
|
+
readonly buttons: readonly WhatsappReplyButton[];
|
|
70
|
+
};
|
|
71
|
+
export type WhatsappMediaInput = SendBase & {
|
|
72
|
+
readonly kind: "image";
|
|
73
|
+
readonly link: string;
|
|
74
|
+
readonly caption?: string;
|
|
75
|
+
};
|
|
76
|
+
export type WhatsappClient = {
|
|
77
|
+
sendText(ctx: WhatsappCallContext, input: WhatsappTextInput): Promise<WhatsappSendResult>;
|
|
78
|
+
sendTemplate(ctx: WhatsappCallContext, input: WhatsappTemplateInput): Promise<WhatsappSendResult>;
|
|
79
|
+
sendButtons(ctx: WhatsappCallContext, input: WhatsappButtonsInput): Promise<WhatsappSendResult>;
|
|
80
|
+
sendMedia(ctx: WhatsappCallContext, input: WhatsappMediaInput): Promise<WhatsappSendResult>;
|
|
81
|
+
fetchMedia(ctx: WhatsappCallContext, mediaId: string): Promise<WhatsappMediaResult>;
|
|
82
|
+
};
|
|
83
|
+
export declare function createWhatsappClient(options?: ChannelWhatsappOptions): WhatsappClient;
|
|
84
|
+
export declare function buildWhatsappClient(resolved: ResolvedWhatsappOptions): WhatsappClient;
|
|
85
|
+
export {};
|
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
import { BlockedHostError, egress } from "@cosmicdrift/kumiko-framework/http";
|
|
2
|
+
import { SYSTEM_USER_ID } from "@cosmicdrift/kumiko-types/identifiers";
|
|
3
|
+
import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
|
|
4
|
+
import { checkChatWebhookTarget } from "../delivery/index.js";
|
|
5
|
+
import { WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS, WHATSAPP_BUTTON_TITLE_MAX_CHARS, WHATSAPP_MAX_REPLY_BUTTONS, WHATSAPP_SECRET_KEYS, WHATSAPP_TEXT_MAX_CHARS, } from "./constants.js";
|
|
6
|
+
import { resolveWhatsappOptions, } from "./options.js";
|
|
7
|
+
const PHONE_NUMBER_ID_PATTERN = /^\d{1,32}$/;
|
|
8
|
+
const RECIPIENT_PATTERN = /^\+?\d{5,20}$/;
|
|
9
|
+
const MEDIA_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
|
|
10
|
+
const TEMPLATE_NAME_PATTERN = /^[a-z0-9_]{1,512}$/;
|
|
11
|
+
const LANGUAGE_CODE_PATTERN = /^[a-z]{2,3}(_[A-Za-z]{2,4})?$/;
|
|
12
|
+
const SECRET_AUDIT_HANDLER = "channel-whatsapp:graph-client";
|
|
13
|
+
// Only an absent or empty secret is missing_credentials; a failing secret store is a transient fault.
|
|
14
|
+
async function readAccessToken(ctx) {
|
|
15
|
+
try {
|
|
16
|
+
const revealed = await ctx.secrets?.get(ctx.tenantId, WHATSAPP_SECRET_KEYS.accessToken, {
|
|
17
|
+
userId: SYSTEM_USER_ID,
|
|
18
|
+
handlerName: SECRET_AUDIT_HANDLER,
|
|
19
|
+
});
|
|
20
|
+
const token = revealed?.reveal();
|
|
21
|
+
return token === undefined || token === ""
|
|
22
|
+
? { ok: false, code: "missing_credentials" }
|
|
23
|
+
: { ok: true, token };
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
return { ok: false, code: "unreachable" };
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
// The link is fetched by Meta, not by us, so no allowlist applies; it must still be a plain URL.
|
|
30
|
+
function isPublicMediaLink(link, requireHttps) {
|
|
31
|
+
try {
|
|
32
|
+
const parsed = new URL(link);
|
|
33
|
+
const protocolAllowed = parsed.protocol === "https:" || (!requireHttps && parsed.protocol === "http:");
|
|
34
|
+
return protocolAllowed && parsed.username === "" && parsed.password === "";
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return false;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
function isTimeout(err) {
|
|
41
|
+
return err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError");
|
|
42
|
+
}
|
|
43
|
+
function classifyTransportError(err) {
|
|
44
|
+
if (err instanceof BlockedHostError)
|
|
45
|
+
return { code: "host_not_allowed" };
|
|
46
|
+
return { code: isTimeout(err) ? "timeout" : "unreachable" };
|
|
47
|
+
}
|
|
48
|
+
export function createWhatsappClient(options = {}) {
|
|
49
|
+
return buildWhatsappClient(resolveWhatsappOptions(options));
|
|
50
|
+
}
|
|
51
|
+
export function buildWhatsappClient(resolved) {
|
|
52
|
+
const target = {
|
|
53
|
+
allowedHosts: resolved.allowedHosts,
|
|
54
|
+
requireHttps: resolved.requireHttps,
|
|
55
|
+
};
|
|
56
|
+
// The host and https check runs before any transport, so a swapped transport cannot
|
|
57
|
+
// route the bearer token to a host outside the allowlist.
|
|
58
|
+
async function callGraph(url, token, init) {
|
|
59
|
+
const checked = checkChatWebhookTarget(target, url);
|
|
60
|
+
if (!checked)
|
|
61
|
+
return { ok: false, code: "host_not_allowed" };
|
|
62
|
+
try {
|
|
63
|
+
const send = resolved.transport ??
|
|
64
|
+
egress(resolved.requireHttps
|
|
65
|
+
? { kind: "external" }
|
|
66
|
+
: { kind: "internal", allowOrigins: [checked.origin] });
|
|
67
|
+
const response = await send(checked.toString(), {
|
|
68
|
+
method: init.method,
|
|
69
|
+
redirect: "manual",
|
|
70
|
+
headers: {
|
|
71
|
+
authorization: `Bearer ${token}`,
|
|
72
|
+
...(init.body !== undefined && { "content-type": "application/json" }),
|
|
73
|
+
},
|
|
74
|
+
...(init.body !== undefined && { body: JSON.stringify(init.body) }),
|
|
75
|
+
signal: AbortSignal.timeout(resolved.timeoutMs),
|
|
76
|
+
});
|
|
77
|
+
return { ok: true, response };
|
|
78
|
+
}
|
|
79
|
+
catch (err) {
|
|
80
|
+
return { ok: false, ...classifyTransportError(err) };
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
async function readMediaAnnouncement(response) {
|
|
84
|
+
try {
|
|
85
|
+
const body = await response.json();
|
|
86
|
+
const url = propertyOf(body, "url");
|
|
87
|
+
const mimeType = propertyOf(body, "mime_type");
|
|
88
|
+
if (typeof url !== "string")
|
|
89
|
+
return { ok: false, code: "invalid_response" };
|
|
90
|
+
return { ok: true, url, mimeType: typeof mimeType === "string" ? mimeType : undefined };
|
|
91
|
+
}
|
|
92
|
+
catch {
|
|
93
|
+
return { ok: false, code: "invalid_response" };
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
async function readBoundedBytes(response, maxBytes) {
|
|
97
|
+
const announcedLength = Number(response.headers.get("content-length"));
|
|
98
|
+
if (announcedLength > maxBytes)
|
|
99
|
+
return { ok: false, code: "too_large" };
|
|
100
|
+
try {
|
|
101
|
+
if (!response.body) {
|
|
102
|
+
const bytes = new Uint8Array(await response.arrayBuffer());
|
|
103
|
+
return bytes.byteLength > maxBytes ? { ok: false, code: "too_large" } : { ok: true, bytes };
|
|
104
|
+
}
|
|
105
|
+
const reader = response.body.getReader();
|
|
106
|
+
const chunks = [];
|
|
107
|
+
let total = 0;
|
|
108
|
+
for (;;) {
|
|
109
|
+
const { done, value } = await reader.read();
|
|
110
|
+
if (done)
|
|
111
|
+
break;
|
|
112
|
+
total += value.byteLength;
|
|
113
|
+
if (total > maxBytes) {
|
|
114
|
+
await reader.cancel();
|
|
115
|
+
return { ok: false, code: "too_large" };
|
|
116
|
+
}
|
|
117
|
+
chunks.push(value);
|
|
118
|
+
}
|
|
119
|
+
const bytes = new Uint8Array(total);
|
|
120
|
+
let offset = 0;
|
|
121
|
+
for (const chunk of chunks) {
|
|
122
|
+
bytes.set(chunk, offset);
|
|
123
|
+
offset += chunk.byteLength;
|
|
124
|
+
}
|
|
125
|
+
return { ok: true, bytes };
|
|
126
|
+
}
|
|
127
|
+
catch (err) {
|
|
128
|
+
return { ok: false, ...classifyTransportError(err) };
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
async function rejection(response) {
|
|
132
|
+
let metaCode = null;
|
|
133
|
+
try {
|
|
134
|
+
const code = propertyOf(propertyOf(await response.json(), "error"), "code");
|
|
135
|
+
metaCode = typeof code === "number" ? code : null;
|
|
136
|
+
}
|
|
137
|
+
catch {
|
|
138
|
+
metaCode = null;
|
|
139
|
+
}
|
|
140
|
+
return { code: "rejected", httpStatus: response.status, metaCode };
|
|
141
|
+
}
|
|
142
|
+
async function postMessage(ctx, base, content) {
|
|
143
|
+
if (!PHONE_NUMBER_ID_PATTERN.test(base.phoneNumberId)) {
|
|
144
|
+
return { ok: false, code: "invalid_phone_number_id" };
|
|
145
|
+
}
|
|
146
|
+
if (!RECIPIENT_PATTERN.test(base.to))
|
|
147
|
+
return { ok: false, code: "invalid_recipient" };
|
|
148
|
+
const credentials = await readAccessToken(ctx);
|
|
149
|
+
if (!credentials.ok)
|
|
150
|
+
return credentials;
|
|
151
|
+
const outcome = await callGraph(`${resolved.apiBaseUrl}/${resolved.apiVersion}/${base.phoneNumberId}/messages`, credentials.token, {
|
|
152
|
+
method: "POST",
|
|
153
|
+
body: {
|
|
154
|
+
messaging_product: "whatsapp",
|
|
155
|
+
recipient_type: "individual",
|
|
156
|
+
to: base.to.replace(/^\+/, ""),
|
|
157
|
+
...(base.replyToWamid !== undefined && { context: { message_id: base.replyToWamid } }),
|
|
158
|
+
...content,
|
|
159
|
+
},
|
|
160
|
+
});
|
|
161
|
+
if (!outcome.ok)
|
|
162
|
+
return outcome;
|
|
163
|
+
if (!outcome.response.ok)
|
|
164
|
+
return { ok: false, ...(await rejection(outcome.response)) };
|
|
165
|
+
try {
|
|
166
|
+
const messages = propertyOf(await outcome.response.json(), "messages");
|
|
167
|
+
const wamid = Array.isArray(messages) ? propertyOf(messages[0], "id") : undefined;
|
|
168
|
+
return typeof wamid === "string" && wamid !== ""
|
|
169
|
+
? { ok: true, wamid }
|
|
170
|
+
: { ok: false, code: "invalid_response" };
|
|
171
|
+
}
|
|
172
|
+
catch {
|
|
173
|
+
return { ok: false, code: "invalid_response" };
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
async function fetchMedia(ctx, mediaId) {
|
|
177
|
+
if (!MEDIA_ID_PATTERN.test(mediaId))
|
|
178
|
+
return { ok: false, code: "invalid_media_id" };
|
|
179
|
+
const credentials = await readAccessToken(ctx);
|
|
180
|
+
if (!credentials.ok)
|
|
181
|
+
return credentials;
|
|
182
|
+
const { token } = credentials;
|
|
183
|
+
const meta = await callGraph(`${resolved.apiBaseUrl}/${resolved.apiVersion}/${mediaId}`, token, { method: "GET" });
|
|
184
|
+
if (!meta.ok)
|
|
185
|
+
return meta;
|
|
186
|
+
if (!meta.response.ok)
|
|
187
|
+
return { ok: false, ...(await rejection(meta.response)) };
|
|
188
|
+
const announced = await readMediaAnnouncement(meta.response);
|
|
189
|
+
if (!announced.ok)
|
|
190
|
+
return announced;
|
|
191
|
+
// The URL comes from the Graph answer and receives the bearer token: callGraph checks
|
|
192
|
+
// it against the same allowlist and https rule before anything is sent.
|
|
193
|
+
const download = await callGraph(announced.url, token, { method: "GET" });
|
|
194
|
+
if (!download.ok)
|
|
195
|
+
return download;
|
|
196
|
+
const { response } = download;
|
|
197
|
+
if (response.status >= 300 && response.status < 400) {
|
|
198
|
+
return { ok: false, code: "redirect_blocked" };
|
|
199
|
+
}
|
|
200
|
+
if (!response.ok)
|
|
201
|
+
return { ok: false, ...(await rejection(response)) };
|
|
202
|
+
const body = await readBoundedBytes(response, resolved.mediaMaxBytes);
|
|
203
|
+
if (!body.ok)
|
|
204
|
+
return body;
|
|
205
|
+
const mimeType = announced.mimeType ?? response.headers.get("content-type") ?? "application/octet-stream";
|
|
206
|
+
return { ok: true, bytes: body.bytes, mimeType };
|
|
207
|
+
}
|
|
208
|
+
return {
|
|
209
|
+
sendText: (ctx, input) => {
|
|
210
|
+
if (input.text === "" || input.text.length > WHATSAPP_TEXT_MAX_CHARS) {
|
|
211
|
+
return Promise.resolve({ ok: false, code: "invalid_message" });
|
|
212
|
+
}
|
|
213
|
+
return postMessage(ctx, input, {
|
|
214
|
+
type: "text",
|
|
215
|
+
text: { body: input.text, preview_url: false },
|
|
216
|
+
});
|
|
217
|
+
},
|
|
218
|
+
sendTemplate: (ctx, input) => {
|
|
219
|
+
if (!TEMPLATE_NAME_PATTERN.test(input.templateName) ||
|
|
220
|
+
!LANGUAGE_CODE_PATTERN.test(input.languageCode)) {
|
|
221
|
+
return Promise.resolve({ ok: false, code: "invalid_message" });
|
|
222
|
+
}
|
|
223
|
+
const parameters = (input.bodyParameters ?? []).map((text) => ({ type: "text", text }));
|
|
224
|
+
return postMessage(ctx, input, {
|
|
225
|
+
type: "template",
|
|
226
|
+
template: {
|
|
227
|
+
name: input.templateName,
|
|
228
|
+
language: { code: input.languageCode },
|
|
229
|
+
...(parameters.length > 0 && { components: [{ type: "body", parameters }] }),
|
|
230
|
+
},
|
|
231
|
+
});
|
|
232
|
+
},
|
|
233
|
+
sendButtons: (ctx, input) => {
|
|
234
|
+
const invalid = input.text === "" ||
|
|
235
|
+
input.text.length > WHATSAPP_TEXT_MAX_CHARS ||
|
|
236
|
+
input.buttons.length === 0 ||
|
|
237
|
+
input.buttons.length > WHATSAPP_MAX_REPLY_BUTTONS ||
|
|
238
|
+
input.buttons.some(({ payload, title }) => payload === "" ||
|
|
239
|
+
payload.length > WHATSAPP_BUTTON_PAYLOAD_MAX_CHARS ||
|
|
240
|
+
title === "" ||
|
|
241
|
+
title.length > WHATSAPP_BUTTON_TITLE_MAX_CHARS);
|
|
242
|
+
if (invalid)
|
|
243
|
+
return Promise.resolve({ ok: false, code: "invalid_message" });
|
|
244
|
+
return postMessage(ctx, input, {
|
|
245
|
+
type: "interactive",
|
|
246
|
+
interactive: {
|
|
247
|
+
type: "button",
|
|
248
|
+
body: { text: input.text },
|
|
249
|
+
action: {
|
|
250
|
+
buttons: input.buttons.map(({ payload, title }) => ({
|
|
251
|
+
type: "reply",
|
|
252
|
+
reply: { id: payload, title },
|
|
253
|
+
})),
|
|
254
|
+
},
|
|
255
|
+
},
|
|
256
|
+
});
|
|
257
|
+
},
|
|
258
|
+
sendMedia: (ctx, input) => {
|
|
259
|
+
if (!isPublicMediaLink(input.link, resolved.requireHttps)) {
|
|
260
|
+
return Promise.resolve({ ok: false, code: "invalid_message" });
|
|
261
|
+
}
|
|
262
|
+
return postMessage(ctx, input, {
|
|
263
|
+
type: input.kind,
|
|
264
|
+
[input.kind]: {
|
|
265
|
+
link: input.link,
|
|
266
|
+
...(input.caption !== undefined && { caption: input.caption }),
|
|
267
|
+
},
|
|
268
|
+
});
|
|
269
|
+
},
|
|
270
|
+
fetchMedia,
|
|
271
|
+
};
|
|
272
|
+
}
|