@hogsend/engine 0.67.0 → 0.68.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/README.md +3 -2
- package/dist/account-links/__fixtures__/fake-fetch.d.ts +38 -0
- package/dist/account-links/__fixtures__/fake-fetch.d.ts.map +1 -0
- package/dist/account-links/battlenet.d.ts +36 -0
- package/dist/account-links/battlenet.d.ts.map +1 -0
- package/dist/account-links/epic.d.ts +36 -0
- package/dist/account-links/epic.d.ts.map +1 -0
- package/dist/account-links/index.d.ts +7 -0
- package/dist/account-links/index.d.ts.map +1 -0
- package/dist/account-links/riot.d.ts +35 -0
- package/dist/account-links/riot.d.ts.map +1 -0
- package/dist/account-links/steam.d.ts +35 -0
- package/dist/account-links/steam.d.ts.map +1 -0
- package/dist/account-links/twitch.d.ts +38 -0
- package/dist/account-links/twitch.d.ts.map +1 -0
- package/dist/account-links/xbox.d.ts +39 -0
- package/dist/account-links/xbox.d.ts.map +1 -0
- package/dist/app.d.ts +50 -0
- package/dist/app.d.ts.map +1 -0
- package/dist/buckets/bucket-access.d.ts +60 -0
- package/dist/buckets/bucket-access.d.ts.map +1 -0
- package/dist/buckets/bucket-reactions.d.ts +100 -0
- package/dist/buckets/bucket-reactions.d.ts.map +1 -0
- package/dist/buckets/check-membership.d.ts +105 -0
- package/dist/buckets/check-membership.d.ts.map +1 -0
- package/dist/buckets/define-bucket.d.ts +53 -0
- package/dist/buckets/define-bucket.d.ts.map +1 -0
- package/dist/buckets/membership-epoch.d.ts +74 -0
- package/dist/buckets/membership-epoch.d.ts.map +1 -0
- package/dist/buckets/registry-singleton.d.ts +6 -0
- package/dist/buckets/registry-singleton.d.ts.map +1 -0
- package/dist/buckets/registry.d.ts +59 -0
- package/dist/buckets/registry.d.ts.map +1 -0
- package/dist/campaigns/cohort-sql.d.ts +54 -0
- package/dist/campaigns/cohort-sql.d.ts.map +1 -0
- package/dist/campaigns/define-campaign.d.ts +105 -0
- package/dist/campaigns/define-campaign.d.ts.map +1 -0
- package/dist/campaigns/reconcile.d.ts +13 -0
- package/dist/campaigns/reconcile.d.ts.map +1 -0
- package/dist/campaigns/steps.d.ts +29 -0
- package/dist/campaigns/steps.d.ts.map +1 -0
- package/dist/cold-connect/index.d.ts +98 -0
- package/dist/cold-connect/index.d.ts.map +1 -0
- package/dist/cold-connect/page.d.ts +69 -0
- package/dist/cold-connect/page.d.ts.map +1 -0
- package/dist/cold-connect/throttle.d.ts +39 -0
- package/dist/cold-connect/throttle.d.ts.map +1 -0
- package/dist/cold-connect/token.d.ts +57 -0
- package/dist/cold-connect/token.d.ts.map +1 -0
- package/dist/connectors/action-registry-singleton.d.ts +21 -0
- package/dist/connectors/action-registry-singleton.d.ts.map +1 -0
- package/dist/connectors/define-action.d.ts +117 -0
- package/dist/connectors/define-action.d.ts.map +1 -0
- package/dist/connectors/define-connector.d.ts +172 -0
- package/dist/connectors/define-connector.d.ts.map +1 -0
- package/dist/connectors/presets/index.d.ts +17 -0
- package/dist/connectors/presets/index.d.ts.map +1 -0
- package/dist/connectors/registry-singleton.d.ts +34 -0
- package/dist/connectors/registry-singleton.d.ts.map +1 -0
- package/dist/connectors/runtime.d.ts +68 -0
- package/dist/connectors/runtime.d.ts.map +1 -0
- package/dist/container.d.ts +678 -0
- package/dist/container.d.ts.map +1 -0
- package/dist/destinations/define-destination.d.ts +96 -0
- package/dist/destinations/define-destination.d.ts.map +1 -0
- package/dist/destinations/presets/index.d.ts +42 -0
- package/dist/destinations/presets/index.d.ts.map +1 -0
- package/dist/destinations/presets/posthog.d.ts +12 -0
- package/dist/destinations/presets/posthog.d.ts.map +1 -0
- package/dist/destinations/presets/segment.d.ts +15 -0
- package/dist/destinations/presets/segment.d.ts.map +1 -0
- package/dist/destinations/presets/slack.d.ts +10 -0
- package/dist/destinations/presets/slack.d.ts.map +1 -0
- package/dist/destinations/presets/webhook.d.ts +14 -0
- package/dist/destinations/presets/webhook.d.ts.map +1 -0
- package/dist/destinations/registry-singleton.d.ts +44 -0
- package/dist/destinations/registry-singleton.d.ts.map +1 -0
- package/dist/env.d.ts +119 -0
- package/dist/env.d.ts.map +1 -0
- package/dist/flags/reconcile.d.ts +36 -0
- package/dist/flags/reconcile.d.ts.map +1 -0
- package/dist/index.d.ts +210 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/journeys/authoring.d.ts +15 -0
- package/dist/journeys/authoring.d.ts.map +1 -0
- package/dist/journeys/client-defaults-singleton.d.ts +16 -0
- package/dist/journeys/client-defaults-singleton.d.ts.map +1 -0
- package/dist/journeys/constants.d.ts +32 -0
- package/dist/journeys/constants.d.ts.map +1 -0
- package/dist/journeys/define-journey.d.ts +33 -0
- package/dist/journeys/define-journey.d.ts.map +1 -0
- package/dist/journeys/durable-law-harness.d.ts +74 -0
- package/dist/journeys/durable-law-harness.d.ts.map +1 -0
- package/dist/journeys/errors.d.ts +13 -0
- package/dist/journeys/errors.d.ts.map +1 -0
- package/dist/journeys/execute-journey-run.d.ts +160 -0
- package/dist/journeys/execute-journey-run.d.ts.map +1 -0
- package/dist/journeys/graph/build-graph.d.ts +24 -0
- package/dist/journeys/graph/build-graph.d.ts.map +1 -0
- package/dist/journeys/group-scope.d.ts +56 -0
- package/dist/journeys/group-scope.d.ts.map +1 -0
- package/dist/journeys/journey-boundary.d.ts +264 -0
- package/dist/journeys/journey-boundary.d.ts.map +1 -0
- package/dist/journeys/journey-context.d.ts +60 -0
- package/dist/journeys/journey-context.d.ts.map +1 -0
- package/dist/journeys/journey-log.d.ts +42 -0
- package/dist/journeys/journey-log.d.ts.map +1 -0
- package/dist/journeys/journey-source-locations-singleton.d.ts +6 -0
- package/dist/journeys/journey-source-locations-singleton.d.ts.map +1 -0
- package/dist/journeys/journey-sources-singleton.d.ts +5 -0
- package/dist/journeys/journey-sources-singleton.d.ts.map +1 -0
- package/dist/journeys/journey-task-factory.d.ts +11 -0
- package/dist/journeys/journey-task-factory.d.ts.map +1 -0
- package/dist/journeys/journey-task-runtime.d.ts +2 -0
- package/dist/journeys/journey-task-runtime.d.ts.map +1 -0
- package/dist/journeys/journey-version.d.ts +71 -0
- package/dist/journeys/journey-version.d.ts.map +1 -0
- package/dist/journeys/record-once.d.ts +56 -0
- package/dist/journeys/record-once.d.ts.map +1 -0
- package/dist/journeys/registry-singleton.d.ts +6 -0
- package/dist/journeys/registry-singleton.d.ts.map +1 -0
- package/dist/journeys/registry.d.ts +59 -0
- package/dist/journeys/registry.d.ts.map +1 -0
- package/dist/journeys/with-durable-gate.d.ts +97 -0
- package/dist/journeys/with-durable-gate.d.ts.map +1 -0
- package/dist/lib/account-link-emit.d.ts +69 -0
- package/dist/lib/account-link-emit.d.ts.map +1 -0
- package/dist/lib/account-link-events.d.ts +128 -0
- package/dist/lib/account-link-events.d.ts.map +1 -0
- package/dist/lib/account-link-hooks.d.ts +32 -0
- package/dist/lib/account-link-hooks.d.ts.map +1 -0
- package/dist/lib/account-link-ingest.d.ts +78 -0
- package/dist/lib/account-link-ingest.d.ts.map +1 -0
- package/dist/lib/account-link-nonce.d.ts +29 -0
- package/dist/lib/account-link-nonce.d.ts.map +1 -0
- package/dist/lib/account-link-origins.d.ts +37 -0
- package/dist/lib/account-link-origins.d.ts.map +1 -0
- package/dist/lib/account-link-pkce.d.ts +48 -0
- package/dist/lib/account-link-pkce.d.ts.map +1 -0
- package/dist/lib/account-link-provider-registry.d.ts +35 -0
- package/dist/lib/account-link-provider-registry.d.ts.map +1 -0
- package/dist/lib/account-link-throttle.d.ts +76 -0
- package/dist/lib/account-link-throttle.d.ts.map +1 -0
- package/dist/lib/account-link-url.d.ts +41 -0
- package/dist/lib/account-link-url.d.ts.map +1 -0
- package/dist/lib/account-links-from-env.d.ts +62 -0
- package/dist/lib/account-links-from-env.d.ts.map +1 -0
- package/dist/lib/account-links.d.ts +353 -0
- package/dist/lib/account-links.d.ts.map +1 -0
- package/dist/lib/agent/config.d.ts +14 -0
- package/dist/lib/agent/config.d.ts.map +1 -0
- package/dist/lib/agent/proposals.d.ts +52 -0
- package/dist/lib/agent/proposals.d.ts.map +1 -0
- package/dist/lib/agent/provider.d.ts +9 -0
- package/dist/lib/agent/provider.d.ts.map +1 -0
- package/dist/lib/agent/risk.d.ts +24 -0
- package/dist/lib/agent/risk.d.ts.map +1 -0
- package/dist/lib/agent/system-prompt.d.ts +8 -0
- package/dist/lib/agent/system-prompt.d.ts.map +1 -0
- package/dist/lib/agent/tools.d.ts +258 -0
- package/dist/lib/agent/tools.d.ts.map +1 -0
- package/dist/lib/alerting.d.ts +7 -0
- package/dist/lib/alerting.d.ts.map +1 -0
- package/dist/lib/analytics-adapter.d.ts +24 -0
- package/dist/lib/analytics-adapter.d.ts.map +1 -0
- package/dist/lib/analytics-identity.d.ts +60 -0
- package/dist/lib/analytics-identity.d.ts.map +1 -0
- package/dist/lib/analytics-provider-registry.d.ts +20 -0
- package/dist/lib/analytics-provider-registry.d.ts.map +1 -0
- package/dist/lib/analytics-providers-from-env.d.ts +41 -0
- package/dist/lib/analytics-providers-from-env.d.ts.map +1 -0
- package/dist/lib/analytics-singleton.d.ts +10 -0
- package/dist/lib/analytics-singleton.d.ts.map +1 -0
- package/dist/lib/api-key-hash.d.ts +9 -0
- package/dist/lib/api-key-hash.d.ts.map +1 -0
- package/dist/lib/app-secret.d.ts +29 -0
- package/dist/lib/app-secret.d.ts.map +1 -0
- package/dist/lib/attachments.d.ts +53 -0
- package/dist/lib/attachments.d.ts.map +1 -0
- package/dist/lib/attribution-backfill.d.ts +48 -0
- package/dist/lib/attribution-backfill.d.ts.map +1 -0
- package/dist/lib/attribution.d.ts +44 -0
- package/dist/lib/attribution.d.ts.map +1 -0
- package/dist/lib/auth.d.ts +136 -0
- package/dist/lib/auth.d.ts.map +1 -0
- package/dist/lib/backfill.d.ts +41 -0
- package/dist/lib/backfill.d.ts.map +1 -0
- package/dist/lib/banner.d.ts +52 -0
- package/dist/lib/banner.d.ts.map +1 -0
- package/dist/lib/blueprint-lock.d.ts +19 -0
- package/dist/lib/blueprint-lock.d.ts.map +1 -0
- package/dist/lib/blueprints.d.ts +573 -0
- package/dist/lib/blueprints.d.ts.map +1 -0
- package/dist/lib/boot-api-key.d.ts +38 -0
- package/dist/lib/boot-api-key.d.ts.map +1 -0
- package/dist/lib/boot.d.ts +23 -0
- package/dist/lib/boot.d.ts.map +1 -0
- package/dist/lib/bootstrap-admin.d.ts +33 -0
- package/dist/lib/bootstrap-admin.d.ts.map +1 -0
- package/dist/lib/bot-prefetch.d.ts +21 -0
- package/dist/lib/bot-prefetch.d.ts.map +1 -0
- package/dist/lib/bucket-emit.d.ts +75 -0
- package/dist/lib/bucket-emit.d.ts.map +1 -0
- package/dist/lib/bucket-posthog-sync.d.ts +29 -0
- package/dist/lib/bucket-posthog-sync.d.ts.map +1 -0
- package/dist/lib/campaign-send-key.d.ts +31 -0
- package/dist/lib/campaign-send-key.d.ts.map +1 -0
- package/dist/lib/connector-actions.d.ts +83 -0
- package/dist/lib/connector-actions.d.ts.map +1 -0
- package/dist/lib/connector-heartbeat.d.ts +35 -0
- package/dist/lib/connector-heartbeat.d.ts.map +1 -0
- package/dist/lib/connector-link-codes.d.ts +105 -0
- package/dist/lib/connector-link-codes.d.ts.map +1 -0
- package/dist/lib/connector-state.d.ts +97 -0
- package/dist/lib/connector-state.d.ts.map +1 -0
- package/dist/lib/contacts.d.ts +622 -0
- package/dist/lib/contacts.d.ts.map +1 -0
- package/dist/lib/conversion-dispatch.d.ts +98 -0
- package/dist/lib/conversion-dispatch.d.ts.map +1 -0
- package/dist/lib/conversions.d.ts +75 -0
- package/dist/lib/conversions.d.ts.map +1 -0
- package/dist/lib/create-admin.d.ts +54 -0
- package/dist/lib/create-admin.d.ts.map +1 -0
- package/dist/lib/crm-deals.d.ts +66 -0
- package/dist/lib/crm-deals.d.ts.map +1 -0
- package/dist/lib/crm-ingest.d.ts +38 -0
- package/dist/lib/crm-ingest.d.ts.map +1 -0
- package/dist/lib/crm-provider-registry.d.ts +20 -0
- package/dist/lib/crm-provider-registry.d.ts.map +1 -0
- package/dist/lib/crm-registry-singleton.d.ts +18 -0
- package/dist/lib/crm-registry-singleton.d.ts.map +1 -0
- package/dist/lib/db.d.ts +3 -0
- package/dist/lib/db.d.ts.map +1 -0
- package/dist/lib/deal-money-events.d.ts +35 -0
- package/dist/lib/deal-money-events.d.ts.map +1 -0
- package/dist/lib/discord-gateway-heartbeat.d.ts +47 -0
- package/dist/lib/discord-gateway-heartbeat.d.ts.map +1 -0
- package/dist/lib/domain-status.d.ts +87 -0
- package/dist/lib/domain-status.d.ts.map +1 -0
- package/dist/lib/email-provider-registry.d.ts +30 -0
- package/dist/lib/email-provider-registry.d.ts.map +1 -0
- package/dist/lib/email-providers-from-env.d.ts +12 -0
- package/dist/lib/email-providers-from-env.d.ts.map +1 -0
- package/dist/lib/email-service-types.d.ts +189 -0
- package/dist/lib/email-service-types.d.ts.map +1 -0
- package/dist/lib/email-stats.d.ts +12 -0
- package/dist/lib/email-stats.d.ts.map +1 -0
- package/dist/lib/email.d.ts +73 -0
- package/dist/lib/email.d.ts.map +1 -0
- package/dist/lib/enrichment-ledger.d.ts +101 -0
- package/dist/lib/enrichment-ledger.d.ts.map +1 -0
- package/dist/lib/enrichment-provider-registry.d.ts +20 -0
- package/dist/lib/enrichment-provider-registry.d.ts.map +1 -0
- package/dist/lib/enrichment-providers-from-env.d.ts +13 -0
- package/dist/lib/enrichment-providers-from-env.d.ts.map +1 -0
- package/dist/lib/enrichment-registry-singleton.d.ts +9 -0
- package/dist/lib/enrichment-registry-singleton.d.ts.map +1 -0
- package/dist/lib/enrollment-guards.d.ts +28 -0
- package/dist/lib/enrollment-guards.d.ts.map +1 -0
- package/dist/lib/enrollment-policy.d.ts +25 -0
- package/dist/lib/enrollment-policy.d.ts.map +1 -0
- package/dist/lib/event-names.d.ts +27 -0
- package/dist/lib/event-names.d.ts.map +1 -0
- package/dist/lib/feed.d.ts +64 -0
- package/dist/lib/feed.d.ts.map +1 -0
- package/dist/lib/flags-registry.d.ts +23 -0
- package/dist/lib/flags-registry.d.ts.map +1 -0
- package/dist/lib/flags.d.ts +143 -0
- package/dist/lib/flags.d.ts.map +1 -0
- package/dist/lib/frequency-cap.d.ts +38 -0
- package/dist/lib/frequency-cap.d.ts.map +1 -0
- package/dist/lib/from-address.d.ts +15 -0
- package/dist/lib/from-address.d.ts.map +1 -0
- package/dist/lib/funnel-progress.d.ts +37 -0
- package/dist/lib/funnel-progress.d.ts.map +1 -0
- package/dist/lib/funnel-registry.d.ts +44 -0
- package/dist/lib/funnel-registry.d.ts.map +1 -0
- package/dist/lib/funnel-transitions.d.ts +63 -0
- package/dist/lib/funnel-transitions.d.ts.map +1 -0
- package/dist/lib/fx.d.ts +118 -0
- package/dist/lib/fx.d.ts.map +1 -0
- package/dist/lib/global-control-readout.d.ts +72 -0
- package/dist/lib/global-control-readout.d.ts.map +1 -0
- package/dist/lib/groups.d.ts +138 -0
- package/dist/lib/groups.d.ts.map +1 -0
- package/dist/lib/hatchet-duration.d.ts +14 -0
- package/dist/lib/hatchet-duration.d.ts.map +1 -0
- package/dist/lib/hatchet.d.ts +3 -0
- package/dist/lib/hatchet.d.ts.map +1 -0
- package/dist/lib/headers.d.ts +8 -0
- package/dist/lib/headers.d.ts.map +1 -0
- package/dist/lib/holdout.d.ts +36 -0
- package/dist/lib/holdout.d.ts.map +1 -0
- package/dist/lib/html.d.ts +5 -0
- package/dist/lib/html.d.ts.map +1 -0
- package/dist/lib/identity-service.d.ts +60 -0
- package/dist/lib/identity-service.d.ts.map +1 -0
- package/dist/lib/identity-token.d.ts +81 -0
- package/dist/lib/identity-token.d.ts.map +1 -0
- package/dist/lib/ingestion.d.ts +218 -0
- package/dist/lib/ingestion.d.ts.map +1 -0
- package/dist/lib/journey-lift.d.ts +56 -0
- package/dist/lib/journey-lift.d.ts.map +1 -0
- package/dist/lib/journey-suppress.d.ts +59 -0
- package/dist/lib/journey-suppress.d.ts.map +1 -0
- package/dist/lib/leader-lease.d.ts +36 -0
- package/dist/lib/leader-lease.d.ts.map +1 -0
- package/dist/lib/lift-stats.d.ts +46 -0
- package/dist/lib/lift-stats.d.ts.map +1 -0
- package/dist/lib/links.d.ts +186 -0
- package/dist/lib/links.d.ts.map +1 -0
- package/dist/lib/load-optional-plugin.d.ts +47 -0
- package/dist/lib/load-optional-plugin.d.ts.map +1 -0
- package/dist/lib/logger.d.ts +4 -0
- package/dist/lib/logger.d.ts.map +1 -0
- package/dist/lib/mailer.d.ts +43 -0
- package/dist/lib/mailer.d.ts.map +1 -0
- package/dist/lib/metrics-sql.d.ts +11 -0
- package/dist/lib/metrics-sql.d.ts.map +1 -0
- package/dist/lib/notifications.d.ts +17 -0
- package/dist/lib/notifications.d.ts.map +1 -0
- package/dist/lib/oauth-token-manager.d.ts +74 -0
- package/dist/lib/oauth-token-manager.d.ts.map +1 -0
- package/dist/lib/operator-settings.d.ts +33 -0
- package/dist/lib/operator-settings.d.ts.map +1 -0
- package/dist/lib/operator.d.ts +20 -0
- package/dist/lib/operator.d.ts.map +1 -0
- package/dist/lib/outbound-endpoint-cache.d.ts +25 -0
- package/dist/lib/outbound-endpoint-cache.d.ts.map +1 -0
- package/dist/lib/outbound.d.ts +687 -0
- package/dist/lib/outbound.d.ts.map +1 -0
- package/dist/lib/phone.d.ts +11 -0
- package/dist/lib/phone.d.ts.map +1 -0
- package/dist/lib/posthog-scopes.d.ts +30 -0
- package/dist/lib/posthog-scopes.d.ts.map +1 -0
- package/dist/lib/posthog.d.ts +16 -0
- package/dist/lib/posthog.d.ts.map +1 -0
- package/dist/lib/preferences.d.ts +72 -0
- package/dist/lib/preferences.d.ts.map +1 -0
- package/dist/lib/provider-credentials.d.ts +149 -0
- package/dist/lib/provider-credentials.d.ts.map +1 -0
- package/dist/lib/provision-posthog-loop.d.ts +100 -0
- package/dist/lib/provision-posthog-loop.d.ts.map +1 -0
- package/dist/lib/recipient-preferences.d.ts +29 -0
- package/dist/lib/recipient-preferences.d.ts.map +1 -0
- package/dist/lib/redis.d.ts +33 -0
- package/dist/lib/redis.d.ts.map +1 -0
- package/dist/lib/referral-intent.d.ts +99 -0
- package/dist/lib/referral-intent.d.ts.map +1 -0
- package/dist/lib/referral-link.d.ts +59 -0
- package/dist/lib/referral-link.d.ts.map +1 -0
- package/dist/lib/referral-registry.d.ts +37 -0
- package/dist/lib/referral-registry.d.ts.map +1 -0
- package/dist/lib/referral-report.d.ts +178 -0
- package/dist/lib/referral-report.d.ts.map +1 -0
- package/dist/lib/referral-runtime.d.ts +43 -0
- package/dist/lib/referral-runtime.d.ts.map +1 -0
- package/dist/lib/referrals.d.ts +184 -0
- package/dist/lib/referrals.d.ts.map +1 -0
- package/dist/lib/refine-chain.d.ts +236 -0
- package/dist/lib/refine-chain.d.ts.map +1 -0
- package/dist/lib/refine-traits.d.ts +78 -0
- package/dist/lib/refine-traits.d.ts.map +1 -0
- package/dist/lib/refine.d.ts +35 -0
- package/dist/lib/refine.d.ts.map +1 -0
- package/dist/lib/reset-email.d.ts +38 -0
- package/dist/lib/reset-email.d.ts.map +1 -0
- package/dist/lib/revenue.d.ts +61 -0
- package/dist/lib/revenue.d.ts.map +1 -0
- package/dist/lib/schemas.d.ts +9 -0
- package/dist/lib/schemas.d.ts.map +1 -0
- package/dist/lib/seed-posthog-destination.d.ts +22 -0
- package/dist/lib/seed-posthog-destination.d.ts.map +1 -0
- package/dist/lib/semantic-click.d.ts +58 -0
- package/dist/lib/semantic-click.d.ts.map +1 -0
- package/dist/lib/sending-domain-guidance.d.ts +40 -0
- package/dist/lib/sending-domain-guidance.d.ts.map +1 -0
- package/dist/lib/singleton.d.ts +24 -0
- package/dist/lib/singleton.d.ts.map +1 -0
- package/dist/lib/sms-frequency-cap.d.ts +16 -0
- package/dist/lib/sms-frequency-cap.d.ts.map +1 -0
- package/dist/lib/sms-inbound.d.ts +37 -0
- package/dist/lib/sms-inbound.d.ts.map +1 -0
- package/dist/lib/sms-link-tracking.d.ts +53 -0
- package/dist/lib/sms-link-tracking.d.ts.map +1 -0
- package/dist/lib/sms-mailer.d.ts +12 -0
- package/dist/lib/sms-mailer.d.ts.map +1 -0
- package/dist/lib/sms-provider-registry.d.ts +20 -0
- package/dist/lib/sms-provider-registry.d.ts.map +1 -0
- package/dist/lib/sms-providers-from-env.d.ts +4 -0
- package/dist/lib/sms-providers-from-env.d.ts.map +1 -0
- package/dist/lib/sms-service-types.d.ts +131 -0
- package/dist/lib/sms-service-types.d.ts.map +1 -0
- package/dist/lib/sms-tracked.d.ts +36 -0
- package/dist/lib/sms-tracked.d.ts.map +1 -0
- package/dist/lib/sms.d.ts +58 -0
- package/dist/lib/sms.d.ts.map +1 -0
- package/dist/lib/snippet.d.ts +32 -0
- package/dist/lib/snippet.d.ts.map +1 -0
- package/dist/lib/stable-stringify.d.ts +12 -0
- package/dist/lib/stable-stringify.d.ts.map +1 -0
- package/dist/lib/studio.d.ts +21 -0
- package/dist/lib/studio.d.ts.map +1 -0
- package/dist/lib/survey.d.ts +35 -0
- package/dist/lib/survey.d.ts.map +1 -0
- package/dist/lib/test-mode.d.ts +77 -0
- package/dist/lib/test-mode.d.ts.map +1 -0
- package/dist/lib/timezone.d.ts +55 -0
- package/dist/lib/timezone.d.ts.map +1 -0
- package/dist/lib/tracked.d.ts +95 -0
- package/dist/lib/tracked.d.ts.map +1 -0
- package/dist/lib/tracking-event-names.d.ts +7 -0
- package/dist/lib/tracking-event-names.d.ts.map +1 -0
- package/dist/lib/tracking-events.d.ts +232 -0
- package/dist/lib/tracking-events.d.ts.map +1 -0
- package/dist/lib/tracking.d.ts +47 -0
- package/dist/lib/tracking.d.ts.map +1 -0
- package/dist/lib/unconfigured-email-provider.d.ts +20 -0
- package/dist/lib/unconfigured-email-provider.d.ts.map +1 -0
- package/dist/lib/unique-violation.d.ts +22 -0
- package/dist/lib/unique-violation.d.ts.map +1 -0
- package/dist/lib/user-token.d.ts +44 -0
- package/dist/lib/user-token.d.ts.map +1 -0
- package/dist/lib/variant.d.ts +44 -0
- package/dist/lib/variant.d.ts.map +1 -0
- package/dist/lib/webhook-signing.d.ts +120 -0
- package/dist/lib/webhook-signing.d.ts.map +1 -0
- package/dist/lib/worker-heartbeat.d.ts +18 -0
- package/dist/lib/worker-heartbeat.d.ts.map +1 -0
- package/dist/lists/channels.d.ts +43 -0
- package/dist/lists/channels.d.ts.map +1 -0
- package/dist/lists/define-list.d.ts +76 -0
- package/dist/lists/define-list.d.ts.map +1 -0
- package/dist/lists/registry-singleton.d.ts +8 -0
- package/dist/lists/registry-singleton.d.ts.map +1 -0
- package/dist/lists/registry.d.ts +66 -0
- package/dist/lists/registry.d.ts.map +1 -0
- package/dist/lists/subscription.d.ts +10 -0
- package/dist/lists/subscription.d.ts.map +1 -0
- package/dist/mcp/authoring-guide.d.ts +33 -0
- package/dist/mcp/authoring-guide.d.ts.map +1 -0
- package/dist/mcp/blueprint-tools.d.ts +266 -0
- package/dist/mcp/blueprint-tools.d.ts.map +1 -0
- package/dist/middleware/api-key.d.ts +45 -0
- package/dist/middleware/api-key.d.ts.map +1 -0
- package/dist/middleware/audit.d.ts +3 -0
- package/dist/middleware/audit.d.ts.map +1 -0
- package/dist/middleware/error-handler.d.ts +4 -0
- package/dist/middleware/error-handler.d.ts.map +1 -0
- package/dist/middleware/publishable-key.d.ts +27 -0
- package/dist/middleware/publishable-key.d.ts.map +1 -0
- package/dist/middleware/rate-limit.d.ts +105 -0
- package/dist/middleware/rate-limit.d.ts.map +1 -0
- package/dist/middleware/request-logger.d.ts +4 -0
- package/dist/middleware/request-logger.d.ts.map +1 -0
- package/dist/middleware/require-admin.d.ts +3 -0
- package/dist/middleware/require-admin.d.ts.map +1 -0
- package/dist/routes/_shared.d.ts +52 -0
- package/dist/routes/_shared.d.ts.map +1 -0
- package/dist/routes/accounts/callback.d.ts +18 -0
- package/dist/routes/accounts/callback.d.ts.map +1 -0
- package/dist/routes/accounts/emit.d.ts +96 -0
- package/dist/routes/accounts/emit.d.ts.map +1 -0
- package/dist/routes/accounts/import-links.d.ts +4 -0
- package/dist/routes/accounts/import-links.d.ts.map +1 -0
- package/dist/routes/accounts/index.d.ts +39 -0
- package/dist/routes/accounts/index.d.ts.map +1 -0
- package/dist/routes/accounts/lookup.d.ts +6 -0
- package/dist/routes/accounts/lookup.d.ts.map +1 -0
- package/dist/routes/accounts/me.d.ts +5 -0
- package/dist/routes/accounts/me.d.ts.map +1 -0
- package/dist/routes/accounts/mint.d.ts +5 -0
- package/dist/routes/accounts/mint.d.ts.map +1 -0
- package/dist/routes/accounts/pages.d.ts +23 -0
- package/dist/routes/accounts/pages.d.ts.map +1 -0
- package/dist/routes/accounts/resolve.d.ts +33 -0
- package/dist/routes/accounts/resolve.d.ts.map +1 -0
- package/dist/routes/accounts/serialize.d.ts +57 -0
- package/dist/routes/accounts/serialize.d.ts.map +1 -0
- package/dist/routes/accounts/shared.d.ts +68 -0
- package/dist/routes/accounts/shared.d.ts.map +1 -0
- package/dist/routes/accounts/start.d.ts +16 -0
- package/dist/routes/accounts/start.d.ts.map +1 -0
- package/dist/routes/accounts/unlink.d.ts +36 -0
- package/dist/routes/accounts/unlink.d.ts.map +1 -0
- package/dist/routes/admin/agent.d.ts +4 -0
- package/dist/routes/admin/agent.d.ts.map +1 -0
- package/dist/routes/admin/alerts.d.ts +190 -0
- package/dist/routes/admin/alerts.d.ts.map +1 -0
- package/dist/routes/admin/analytics.d.ts +137 -0
- package/dist/routes/admin/analytics.d.ts.map +1 -0
- package/dist/routes/admin/api-keys.d.ts +158 -0
- package/dist/routes/admin/api-keys.d.ts.map +1 -0
- package/dist/routes/admin/attribution.d.ts +93 -0
- package/dist/routes/admin/attribution.d.ts.map +1 -0
- package/dist/routes/admin/audit-logs.d.ts +40 -0
- package/dist/routes/admin/audit-logs.d.ts.map +1 -0
- package/dist/routes/admin/blueprints.d.ts +4 -0
- package/dist/routes/admin/blueprints.d.ts.map +1 -0
- package/dist/routes/admin/buckets.d.ts +215 -0
- package/dist/routes/admin/buckets.d.ts.map +1 -0
- package/dist/routes/admin/bulk.d.ts +203 -0
- package/dist/routes/admin/bulk.d.ts.map +1 -0
- package/dist/routes/admin/campaigns.d.ts +198 -0
- package/dist/routes/admin/campaigns.d.ts.map +1 -0
- package/dist/routes/admin/connectors.d.ts +116 -0
- package/dist/routes/admin/connectors.d.ts.map +1 -0
- package/dist/routes/admin/contacts.d.ts +246 -0
- package/dist/routes/admin/contacts.d.ts.map +1 -0
- package/dist/routes/admin/conversions.d.ts +103 -0
- package/dist/routes/admin/conversions.d.ts.map +1 -0
- package/dist/routes/admin/deals.d.ts +136 -0
- package/dist/routes/admin/deals.d.ts.map +1 -0
- package/dist/routes/admin/dlq.d.ts +100 -0
- package/dist/routes/admin/dlq.d.ts.map +1 -0
- package/dist/routes/admin/domain.d.ts +314 -0
- package/dist/routes/admin/domain.d.ts.map +1 -0
- package/dist/routes/admin/emails.d.ts +127 -0
- package/dist/routes/admin/emails.d.ts.map +1 -0
- package/dist/routes/admin/events.d.ts +140 -0
- package/dist/routes/admin/events.d.ts.map +1 -0
- package/dist/routes/admin/flags.d.ts +719 -0
- package/dist/routes/admin/flags.d.ts.map +1 -0
- package/dist/routes/admin/funnels.d.ts +71 -0
- package/dist/routes/admin/funnels.d.ts.map +1 -0
- package/dist/routes/admin/groups.d.ts +169 -0
- package/dist/routes/admin/groups.d.ts.map +1 -0
- package/dist/routes/admin/identity.d.ts +72 -0
- package/dist/routes/admin/identity.d.ts.map +1 -0
- package/dist/routes/admin/impact-schemas.d.ts +48 -0
- package/dist/routes/admin/impact-schemas.d.ts.map +1 -0
- package/dist/routes/admin/impact.d.ts +316 -0
- package/dist/routes/admin/impact.d.ts.map +1 -0
- package/dist/routes/admin/index.d.ts +4 -0
- package/dist/routes/admin/index.d.ts.map +1 -0
- package/dist/routes/admin/journey-impact.d.ts +320 -0
- package/dist/routes/admin/journey-impact.d.ts.map +1 -0
- package/dist/routes/admin/journey-logs.d.ts +57 -0
- package/dist/routes/admin/journey-logs.d.ts.map +1 -0
- package/dist/routes/admin/journeys.d.ts +736 -0
- package/dist/routes/admin/journeys.d.ts.map +1 -0
- package/dist/routes/admin/links.d.ts +382 -0
- package/dist/routes/admin/links.d.ts.map +1 -0
- package/dist/routes/admin/lists.d.ts +22 -0
- package/dist/routes/admin/lists.d.ts.map +1 -0
- package/dist/routes/admin/maintenance.d.ts +72 -0
- package/dist/routes/admin/maintenance.d.ts.map +1 -0
- package/dist/routes/admin/metrics.d.ts +212 -0
- package/dist/routes/admin/metrics.d.ts.map +1 -0
- package/dist/routes/admin/open-editor.d.ts +36 -0
- package/dist/routes/admin/open-editor.d.ts.map +1 -0
- package/dist/routes/admin/preferences.d.ts +109 -0
- package/dist/routes/admin/preferences.d.ts.map +1 -0
- package/dist/routes/admin/provider-credentials.d.ts +108 -0
- package/dist/routes/admin/provider-credentials.d.ts.map +1 -0
- package/dist/routes/admin/readiness.d.ts +24 -0
- package/dist/routes/admin/readiness.d.ts.map +1 -0
- package/dist/routes/admin/referrals.d.ts +230 -0
- package/dist/routes/admin/referrals.d.ts.map +1 -0
- package/dist/routes/admin/reporting.d.ts +149 -0
- package/dist/routes/admin/reporting.d.ts.map +1 -0
- package/dist/routes/admin/settings.d.ts +80 -0
- package/dist/routes/admin/settings.d.ts.map +1 -0
- package/dist/routes/admin/suppressions.d.ts +90 -0
- package/dist/routes/admin/suppressions.d.ts.map +1 -0
- package/dist/routes/admin/targeting.d.ts +58 -0
- package/dist/routes/admin/targeting.d.ts.map +1 -0
- package/dist/routes/admin/templates.d.ts +197 -0
- package/dist/routes/admin/templates.d.ts.map +1 -0
- package/dist/routes/admin/timeline.d.ts +51 -0
- package/dist/routes/admin/timeline.d.ts.map +1 -0
- package/dist/routes/admin/webhooks.d.ts +250 -0
- package/dist/routes/admin/webhooks.d.ts.map +1 -0
- package/dist/routes/campaigns/index.d.ts +239 -0
- package/dist/routes/campaigns/index.d.ts.map +1 -0
- package/dist/routes/connectors/index.d.ts +16 -0
- package/dist/routes/connectors/index.d.ts.map +1 -0
- package/dist/routes/contacts/index.d.ts +187 -0
- package/dist/routes/contacts/index.d.ts.map +1 -0
- package/dist/routes/email/index.d.ts +4 -0
- package/dist/routes/email/index.d.ts.map +1 -0
- package/dist/routes/email/preferences.d.ts +17 -0
- package/dist/routes/email/preferences.d.ts.map +1 -0
- package/dist/routes/email/unsubscribe.d.ts +17 -0
- package/dist/routes/email/unsubscribe.d.ts.map +1 -0
- package/dist/routes/emails/index.d.ts +90 -0
- package/dist/routes/emails/index.d.ts.map +1 -0
- package/dist/routes/events/index.d.ts +116 -0
- package/dist/routes/events/index.d.ts.map +1 -0
- package/dist/routes/feed/index.d.ts +248 -0
- package/dist/routes/feed/index.d.ts.map +1 -0
- package/dist/routes/feed/recipient.d.ts +65 -0
- package/dist/routes/feed/recipient.d.ts.map +1 -0
- package/dist/routes/flags/index.d.ts +94 -0
- package/dist/routes/flags/index.d.ts.map +1 -0
- package/dist/routes/groups/index.d.ts +192 -0
- package/dist/routes/groups/index.d.ts.map +1 -0
- package/dist/routes/health.d.ts +57 -0
- package/dist/routes/health.d.ts.map +1 -0
- package/dist/routes/index.d.ts +8 -0
- package/dist/routes/index.d.ts.map +1 -0
- package/dist/routes/lists/index.d.ts +266 -0
- package/dist/routes/lists/index.d.ts.map +1 -0
- package/dist/routes/referrals/index.d.ts +22 -0
- package/dist/routes/referrals/index.d.ts.map +1 -0
- package/dist/routes/referrals/me.d.ts +4 -0
- package/dist/routes/referrals/me.d.ts.map +1 -0
- package/dist/routes/referrals/report.d.ts +5 -0
- package/dist/routes/referrals/report.d.ts.map +1 -0
- package/dist/routes/referrals/shared.d.ts +16 -0
- package/dist/routes/referrals/shared.d.ts.map +1 -0
- package/dist/routes/referrals/touch.d.ts +5 -0
- package/dist/routes/referrals/touch.d.ts.map +1 -0
- package/dist/routes/snippet.d.ts +12 -0
- package/dist/routes/snippet.d.ts.map +1 -0
- package/dist/routes/tracking/answer.d.ts +56 -0
- package/dist/routes/tracking/answer.d.ts.map +1 -0
- package/dist/routes/tracking/arrive.d.ts +32 -0
- package/dist/routes/tracking/arrive.d.ts.map +1 -0
- package/dist/routes/tracking/click-pipeline.d.ts +213 -0
- package/dist/routes/tracking/click-pipeline.d.ts.map +1 -0
- package/dist/routes/tracking/click.d.ts +26 -0
- package/dist/routes/tracking/click.d.ts.map +1 -0
- package/dist/routes/tracking/identify.d.ts +32 -0
- package/dist/routes/tracking/identify.d.ts.map +1 -0
- package/dist/routes/tracking/index.d.ts +4 -0
- package/dist/routes/tracking/index.d.ts.map +1 -0
- package/dist/routes/tracking/open.d.ts +17 -0
- package/dist/routes/tracking/open.d.ts.map +1 -0
- package/dist/routes/tracking/short.d.ts +17 -0
- package/dist/routes/tracking/short.d.ts.map +1 -0
- package/dist/routes/tracking/vanity.d.ts +17 -0
- package/dist/routes/tracking/vanity.d.ts.map +1 -0
- package/dist/routes/webhooks/crm-provider.d.ts +24 -0
- package/dist/routes/webhooks/crm-provider.d.ts.map +1 -0
- package/dist/routes/webhooks/email-provider.d.ts +21 -0
- package/dist/routes/webhooks/email-provider.d.ts.map +1 -0
- package/dist/routes/webhooks/index.d.ts +8 -0
- package/dist/routes/webhooks/index.d.ts.map +1 -0
- package/dist/routes/webhooks/resend.d.ts +35 -0
- package/dist/routes/webhooks/resend.d.ts.map +1 -0
- package/dist/routes/webhooks/sms-provider.d.ts +23 -0
- package/dist/routes/webhooks/sms-provider.d.ts.map +1 -0
- package/dist/routes/webhooks/sources.d.ts +12 -0
- package/dist/routes/webhooks/sources.d.ts.map +1 -0
- package/dist/sources/define-contact-source.d.ts +114 -0
- package/dist/sources/define-contact-source.d.ts.map +1 -0
- package/dist/sources/registry.d.ts +31 -0
- package/dist/sources/registry.d.ts.map +1 -0
- package/dist/sources/webhook-source.d.ts +53 -0
- package/dist/sources/webhook-source.d.ts.map +1 -0
- package/dist/testing.d.ts +10 -0
- package/dist/testing.d.ts.map +1 -0
- package/dist/webhook-sources/define-webhook-source.d.ts +60 -0
- package/dist/webhook-sources/define-webhook-source.d.ts.map +1 -0
- package/dist/webhook-sources/presets/clerk.d.ts +9 -0
- package/dist/webhook-sources/presets/clerk.d.ts.map +1 -0
- package/dist/webhook-sources/presets/index.d.ts +140 -0
- package/dist/webhook-sources/presets/index.d.ts.map +1 -0
- package/dist/webhook-sources/presets/intercom.d.ts +44 -0
- package/dist/webhook-sources/presets/intercom.d.ts.map +1 -0
- package/dist/webhook-sources/presets/segment.d.ts +16 -0
- package/dist/webhook-sources/presets/segment.d.ts.map +1 -0
- package/dist/webhook-sources/presets/stripe.d.ts +20 -0
- package/dist/webhook-sources/presets/stripe.d.ts.map +1 -0
- package/dist/webhook-sources/presets/supabase.d.ts +23 -0
- package/dist/webhook-sources/presets/supabase.d.ts.map +1 -0
- package/dist/webhook-sources/verify.d.ts +48 -0
- package/dist/webhook-sources/verify.d.ts.map +1 -0
- package/dist/worker.d.ts +37 -0
- package/dist/worker.d.ts.map +1 -0
- package/dist/workflows/backfill-contact-id.d.ts +202 -0
- package/dist/workflows/backfill-contact-id.d.ts.map +1 -0
- package/dist/workflows/bucket-backfill.d.ts +64 -0
- package/dist/workflows/bucket-backfill.d.ts.map +1 -0
- package/dist/workflows/bucket-reconcile.d.ts +73 -0
- package/dist/workflows/bucket-reconcile.d.ts.map +1 -0
- package/dist/workflows/check-alerts.d.ts +10 -0
- package/dist/workflows/check-alerts.d.ts.map +1 -0
- package/dist/workflows/confirm-semantic-click.d.ts +15 -0
- package/dist/workflows/confirm-semantic-click.d.ts.map +1 -0
- package/dist/workflows/crm-reconcile.d.ts +27 -0
- package/dist/workflows/crm-reconcile.d.ts.map +1 -0
- package/dist/workflows/deliver-webhook.d.ts +88 -0
- package/dist/workflows/deliver-webhook.d.ts.map +1 -0
- package/dist/workflows/dispatch-conversion.d.ts +14 -0
- package/dist/workflows/dispatch-conversion.d.ts.map +1 -0
- package/dist/workflows/identity-alias-backfill.d.ts +96 -0
- package/dist/workflows/identity-alias-backfill.d.ts.map +1 -0
- package/dist/workflows/impact-digest.d.ts +142 -0
- package/dist/workflows/impact-digest.d.ts.map +1 -0
- package/dist/workflows/import-contacts.d.ts +14 -0
- package/dist/workflows/import-contacts.d.ts.map +1 -0
- package/dist/workflows/import-suppressions.d.ts +55 -0
- package/dist/workflows/import-suppressions.d.ts.map +1 -0
- package/dist/workflows/journey-blueprint-interpreter.d.ts +73 -0
- package/dist/workflows/journey-blueprint-interpreter.d.ts.map +1 -0
- package/dist/workflows/send-campaign.d.ts +128 -0
- package/dist/workflows/send-campaign.d.ts.map +1 -0
- package/dist/workflows/send-email.d.ts +15 -0
- package/dist/workflows/send-email.d.ts.map +1 -0
- package/dist/workflows/send-feed.d.ts +37 -0
- package/dist/workflows/send-feed.d.ts.map +1 -0
- package/package.json +60 -22
- package/src/app.ts +9 -1
- package/src/buckets/check-membership.ts +54 -20
- package/src/env.ts +30 -0
- package/src/journeys/journey-log.ts +25 -8
- package/src/lib/contacts.ts +47 -1
- package/src/lib/email-service-types.ts +10 -0
- package/src/lib/ingestion.ts +30 -19
- package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
- package/src/lib/mailer-replied.test.ts +7 -2
- package/src/lib/mailer.ts +1 -0
- package/src/lib/outbound-endpoint-cache.ts +83 -0
- package/src/lib/outbound.ts +56 -37
- package/src/lib/seed-posthog-destination.ts +5 -1
- package/src/lib/tracked.ts +11 -3
- package/src/lib/tracking-events.ts +20 -3
- package/src/middleware/api-key.ts +69 -60
- package/src/middleware/publishable-key.ts +11 -23
- package/src/middleware/rate-limit.ts +165 -3
- package/src/routes/admin/api-keys.ts +148 -0
- package/src/routes/admin/targeting.ts +6 -1
- package/src/routes/admin/webhooks.ts +4 -0
- package/src/routes/index.ts +67 -24
- package/src/workflows/backfill-contact-id.ts +3 -7
- package/src/workflows/bucket-backfill.ts +2 -2
- package/src/workflows/bucket-reconcile.ts +28 -12
- package/src/workflows/check-alerts.ts +3 -9
- package/src/workflows/crm-reconcile.ts +3 -2
- package/src/workflows/deliver-webhook.ts +21 -8
- package/src/workflows/dispatch-conversion.ts +2 -2
- package/src/workflows/identity-alias-backfill.ts +3 -2
- package/src/workflows/impact-digest.ts +2 -2
- package/src/workflows/import-contacts.ts +3 -4
- package/src/workflows/import-suppressions.ts +4 -5
- package/src/workflows/send-campaign.ts +10 -1
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { EmailProvider } from "@hogsend/core";
|
|
2
|
+
import type { env as envSchema } from "../env.js";
|
|
3
|
+
/**
|
|
4
|
+
* Build the env-enabled email-provider presets. Mirrors `destinationsFromEnv`:
|
|
5
|
+
* a preset is constructed ONLY when its credential is present, so a
|
|
6
|
+
* Postmark-only deploy (no `RESEND_API_KEY`) contributes no Resend provider.
|
|
7
|
+
*
|
|
8
|
+
* These presets come FIRST in the container's merge — a consumer-supplied
|
|
9
|
+
* provider of the same id wins (last-writer-wins on the registry).
|
|
10
|
+
*/
|
|
11
|
+
export declare function emailProvidersFromEnv(env: typeof envSchema): EmailProvider[];
|
|
12
|
+
//# sourceMappingURL=email-providers-from-env.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"email-providers-from-env.d.ts","sourceRoot":"","sources":["../../src/lib/email-providers-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AA8ElD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,SAAS,GAAG,aAAa,EAAE,CA4E5E"}
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
import type { BatchEmailItem, DurationObject, EmailAttachment, EmailEvent, EmailEventType, SendEmailOptions, SendResult, WebhookHandlerMap } from "@hogsend/core";
|
|
2
|
+
import type { EmailServiceRenderOptions, EmailServiceRenderResult, RetryOptions, TemplateName, TemplateRegistry, TemplateRegistryMap } from "@hogsend/email";
|
|
3
|
+
import type { Logger } from "./logger.js";
|
|
4
|
+
export type { BatchEmailItem, SendEmailOptions, SendResult, } from "@hogsend/core";
|
|
5
|
+
/**
|
|
6
|
+
* Input to the mailer's low-level {@link EmailService.sendRaw}: the provider
|
|
7
|
+
* contract's `SendEmailOptions`, but `from` is optional — the mailer resolves it
|
|
8
|
+
* from `config.defaultFrom` when absent (see `resolveFrom` in mailer.ts). The
|
|
9
|
+
* wire contract keeps `from` required because the provider always receives a
|
|
10
|
+
* resolved address.
|
|
11
|
+
*/
|
|
12
|
+
export type SendRawOptions = Omit<SendEmailOptions, "from"> & {
|
|
13
|
+
from?: string;
|
|
14
|
+
};
|
|
15
|
+
export interface SendTrackedEmailOptions<K extends TemplateName = TemplateName> {
|
|
16
|
+
templateKey: K;
|
|
17
|
+
props: TemplateRegistryMap[K];
|
|
18
|
+
from: string;
|
|
19
|
+
to: string;
|
|
20
|
+
subject?: string;
|
|
21
|
+
journeyStateId?: string;
|
|
22
|
+
/**
|
|
23
|
+
* Campaign identity for campaign-dispatched sends, persisted on the
|
|
24
|
+
* email_sends row (attribution scope + stats). NULL for journey /
|
|
25
|
+
* transactional sends.
|
|
26
|
+
*/
|
|
27
|
+
campaignId?: string;
|
|
28
|
+
/**
|
|
29
|
+
* The recipient's `contacts.id` when the caller already holds it fresh (a
|
|
30
|
+
* campaign resolver that joined `contacts`). The mailer then stamps
|
|
31
|
+
* `email_sends.contact_id` with it instead of resolving `userId` again. Leave
|
|
32
|
+
* it unset unless the id was read in the same unit of work: a journey's
|
|
33
|
+
* enrollment-time id can go stale across a merge.
|
|
34
|
+
*/
|
|
35
|
+
contactId?: string;
|
|
36
|
+
/** Denormalized recipient identity, persisted on the email_sends row for reporting. */
|
|
37
|
+
userId?: string;
|
|
38
|
+
userEmail?: string;
|
|
39
|
+
category?: string;
|
|
40
|
+
tags?: Array<{
|
|
41
|
+
name: string;
|
|
42
|
+
value: string;
|
|
43
|
+
}>;
|
|
44
|
+
headers?: Record<string, string>;
|
|
45
|
+
replyTo?: string | string[];
|
|
46
|
+
skipPreferenceCheck?: boolean;
|
|
47
|
+
baseUrl?: string;
|
|
48
|
+
/**
|
|
49
|
+
* Caller-supplied idempotency key (POST /v1/emails). A retry with the same key
|
|
50
|
+
* short-circuits to the prior `email_sends` row instead of dispatching a
|
|
51
|
+
* duplicate provider send.
|
|
52
|
+
*/
|
|
53
|
+
idempotencyKey?: string;
|
|
54
|
+
/**
|
|
55
|
+
* Neutral attachments (PRD 17), validated + capability-gated before ANY send
|
|
56
|
+
* work (see `assertAttachmentsSendable`) and handed to the provider alongside
|
|
57
|
+
* the TRACKED html — tracking is applied first, attachments ride alongside;
|
|
58
|
+
* an attachment never causes tracking to be skipped. `email_sends.metadata`
|
|
59
|
+
* records filenames/sizes/types only, never the bytes.
|
|
60
|
+
*/
|
|
61
|
+
attachments?: EmailAttachment[];
|
|
62
|
+
}
|
|
63
|
+
export interface TrackedSendResult {
|
|
64
|
+
emailSendId: string;
|
|
65
|
+
/** The provider's neutral message id (Resend email_id / Postmark MessageID). */
|
|
66
|
+
messageId: string;
|
|
67
|
+
/**
|
|
68
|
+
* @deprecated Renamed to {@link TrackedSendResult.messageId}. This read-alias
|
|
69
|
+
* always mirrors `messageId`; kept for one minor and removed the following
|
|
70
|
+
* minor. Build results via {@link trackedSendResult} so the alias stays live.
|
|
71
|
+
*/
|
|
72
|
+
resendId: string;
|
|
73
|
+
status: "sent" | "suppressed" | "unsubscribed" | "skipped";
|
|
74
|
+
/**
|
|
75
|
+
* Present only when `status === "skipped"`:
|
|
76
|
+
* - `"frequency_capped"` — the per-recipient frequency cap was hit.
|
|
77
|
+
* - `"journey_suppressed"` — the enclosing journey's `meta.suppress` min-gap
|
|
78
|
+
* was in force: a non-failed send for this journey to this recipient already
|
|
79
|
+
* went out inside the window, so this one was skipped (no row, no send).
|
|
80
|
+
* - `"test_mode_blocked"` — test mode was active but no redirect address
|
|
81
|
+
* resolved (no `HOGSEND_TEST_EMAIL` / `STUDIO_ADMIN_EMAIL`), so the send was
|
|
82
|
+
* blocked rather than delivered to the real recipient.
|
|
83
|
+
* - `"control_group"` — the recipient is in the global control group
|
|
84
|
+
* (impact plan §4.3): non-transactional sends are withheld so
|
|
85
|
+
* program-level lift is measurable. Transactional mail still delivers.
|
|
86
|
+
*/
|
|
87
|
+
reason?: "frequency_capped" | "journey_suppressed" | "test_mode_blocked" | "control_group";
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Build a {@link TrackedSendResult}, attaching a live `@deprecated` `resendId`
|
|
91
|
+
* read-alias getter that mirrors `messageId`. Lets every send path return a
|
|
92
|
+
* single canonical `messageId` while public consumers reading the old `resendId`
|
|
93
|
+
* field keep working for one minor.
|
|
94
|
+
*/
|
|
95
|
+
export declare function trackedSendResult(result: Omit<TrackedSendResult, "resendId">): TrackedSendResult;
|
|
96
|
+
export interface FrequencyCapWindow {
|
|
97
|
+
count: number;
|
|
98
|
+
window: DurationObject;
|
|
99
|
+
}
|
|
100
|
+
export interface FrequencyCapConfig {
|
|
101
|
+
/** Global send count allowed within `window` per recipient. */
|
|
102
|
+
count: number;
|
|
103
|
+
window: DurationObject;
|
|
104
|
+
/** Per-category overrides (count + window, filtered by that category). */
|
|
105
|
+
byCategory?: Record<string, FrequencyCapWindow>;
|
|
106
|
+
/** Categories exempt from capping. Defaults to ["transactional"]. */
|
|
107
|
+
exemptCategories?: string[];
|
|
108
|
+
}
|
|
109
|
+
export interface EmailServiceConfig {
|
|
110
|
+
defaultFrom: string;
|
|
111
|
+
/**
|
|
112
|
+
* The client app's template registry (key → component + subject + category).
|
|
113
|
+
* Threaded into `getTemplate(..., { registry })` at send + render time so the
|
|
114
|
+
* engine never bakes in concrete business templates. Required to send/render
|
|
115
|
+
* any template; an empty registry simply has no sendable keys.
|
|
116
|
+
*/
|
|
117
|
+
templates: TemplateRegistry;
|
|
118
|
+
db?: unknown;
|
|
119
|
+
webhookHandlers?: WebhookHandlerMap;
|
|
120
|
+
retryOptions?: RetryOptions;
|
|
121
|
+
bounceThreshold?: number;
|
|
122
|
+
baseUrl?: string;
|
|
123
|
+
/**
|
|
124
|
+
* Optional per-client frequency cap. When set, sends are counted per
|
|
125
|
+
* recipient within the window and skipped (no provider call, no `sent` row)
|
|
126
|
+
* once the cap is reached. Opt-in: undefined ⇒ no capping.
|
|
127
|
+
*/
|
|
128
|
+
frequencyCap?: FrequencyCapConfig;
|
|
129
|
+
/** Optional structured logger; used e.g. to record frequency-cap skips. */
|
|
130
|
+
logger?: Logger;
|
|
131
|
+
}
|
|
132
|
+
export interface EmailServiceSendOptions<K extends TemplateName = TemplateName> {
|
|
133
|
+
template: K;
|
|
134
|
+
props: TemplateRegistryMap[K];
|
|
135
|
+
to: string;
|
|
136
|
+
from?: string;
|
|
137
|
+
subject?: string;
|
|
138
|
+
journeyStateId?: string;
|
|
139
|
+
/** Campaign identity for campaign-dispatched sends (see SendTrackedEmailOptions). */
|
|
140
|
+
campaignId?: string;
|
|
141
|
+
/** A fresh `contacts.id` for the recipient (see SendTrackedEmailOptions). */
|
|
142
|
+
contactId?: string;
|
|
143
|
+
/** Denormalized recipient identity, persisted on the email_sends row for reporting. */
|
|
144
|
+
userId?: string;
|
|
145
|
+
userEmail?: string;
|
|
146
|
+
category?: string;
|
|
147
|
+
tags?: Array<{
|
|
148
|
+
name: string;
|
|
149
|
+
value: string;
|
|
150
|
+
}>;
|
|
151
|
+
headers?: Record<string, string>;
|
|
152
|
+
replyTo?: string | string[];
|
|
153
|
+
skipPreferenceCheck?: boolean;
|
|
154
|
+
/** Caller-supplied idempotency key (POST /v1/emails) — dedups duplicate sends. */
|
|
155
|
+
idempotencyKey?: string;
|
|
156
|
+
/** Neutral attachments — see `SendTrackedEmailOptions.attachments`. */
|
|
157
|
+
attachments?: EmailAttachment[];
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* @deprecated The route now verifies the provider webhook and hands
|
|
161
|
+
* {@link EmailService.handleWebhook} an already-parsed {@link EmailEvent}. This
|
|
162
|
+
* raw `{ payload, headers }` shape is no longer the handler input.
|
|
163
|
+
*/
|
|
164
|
+
export interface EmailServiceWebhookOptions {
|
|
165
|
+
payload: string;
|
|
166
|
+
headers: Record<string, string>;
|
|
167
|
+
}
|
|
168
|
+
export interface EmailServiceWebhookResult {
|
|
169
|
+
type: EmailEventType;
|
|
170
|
+
handled: boolean;
|
|
171
|
+
}
|
|
172
|
+
export interface EmailService {
|
|
173
|
+
send<K extends TemplateName>(options: EmailServiceSendOptions<K>): Promise<TrackedSendResult>;
|
|
174
|
+
sendRaw(options: SendRawOptions): Promise<SendResult>;
|
|
175
|
+
sendBatch(options: {
|
|
176
|
+
emails: BatchEmailItem[];
|
|
177
|
+
}): Promise<{
|
|
178
|
+
results: SendResult[];
|
|
179
|
+
}>;
|
|
180
|
+
render<K extends TemplateName>(options: EmailServiceRenderOptions<K>): Promise<EmailServiceRenderResult>;
|
|
181
|
+
/**
|
|
182
|
+
* Dispatch an already-verified, provider-neutral {@link EmailEvent} into the
|
|
183
|
+
* status/suppression/outbound pipeline. The webhook route owns provider
|
|
184
|
+
* resolution + signature verification and passes the parsed event + the
|
|
185
|
+
* resolving `providerId` (the latter is informational for now).
|
|
186
|
+
*/
|
|
187
|
+
handleWebhook(event: EmailEvent, providerId?: string): Promise<EmailServiceWebhookResult>;
|
|
188
|
+
}
|
|
189
|
+
//# sourceMappingURL=email-service-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"email-service-types.d.ts","sourceRoot":"","sources":["../../src/lib/email-service-types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { type Database } from "@hogsend/db";
|
|
2
|
+
export interface EmailStatsResult {
|
|
3
|
+
total: number;
|
|
4
|
+
delivered: number;
|
|
5
|
+
bounced: number;
|
|
6
|
+
complained: number;
|
|
7
|
+
}
|
|
8
|
+
export declare function getEmailStats(opts: {
|
|
9
|
+
db: Database;
|
|
10
|
+
since: Date;
|
|
11
|
+
}): Promise<EmailStatsResult>;
|
|
12
|
+
//# sourceMappingURL=email-stats.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"email-stats.d.ts","sourceRoot":"","sources":["../../src/lib/email-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,aAAa,CAAC;AAGxD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB5B"}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import type { EmailAttachment } from "@hogsend/core";
|
|
2
|
+
import { type TemplateName } from "@hogsend/email";
|
|
3
|
+
import type { EmailService } from "./email-service-types.js";
|
|
4
|
+
export declare const setEmailService: (value: EmailService) => void;
|
|
5
|
+
/**
|
|
6
|
+
* The injected {@link EmailService} (set by `createHogsendClient` →
|
|
7
|
+
* `setEmailService`). Exposed so module-level task-execution sites with no
|
|
8
|
+
* client reference (the `send-email` Hatchet task, the alerting task) deliver
|
|
9
|
+
* through the same provider-backed mailer the container built, honoring a
|
|
10
|
+
* swapped provider instead of constructing a raw Resend client of their own.
|
|
11
|
+
* Throws if read before the container has installed the service — same
|
|
12
|
+
* guarantee as the journey/bucket registry singletons (the container always
|
|
13
|
+
* runs first in both the API and worker processes).
|
|
14
|
+
*/
|
|
15
|
+
export declare const getEmailService: () => EmailService;
|
|
16
|
+
export interface SendEmailOptions {
|
|
17
|
+
to: string;
|
|
18
|
+
userId: string;
|
|
19
|
+
/**
|
|
20
|
+
* The template to send. Typed as {@link TemplateName} — the union of keys the
|
|
21
|
+
* consumer has registered by augmenting `@hogsend/email`'s
|
|
22
|
+
* `TemplateRegistryMap` (see the consumer's `src/emails/templates.d.ts`). A
|
|
23
|
+
* key that was never registered (a typo, or a slash-key when the registry
|
|
24
|
+
* uses hyphen-keys) is a COMPILE error here, so a journey can no longer ship
|
|
25
|
+
* pointing at an email that doesn't exist. `getTemplate` also throws a loud,
|
|
26
|
+
* actionable error at send time as a runtime backstop for keys resolved
|
|
27
|
+
* dynamically (e.g. the public `POST /v1/emails`).
|
|
28
|
+
*/
|
|
29
|
+
template: TemplateName;
|
|
30
|
+
/**
|
|
31
|
+
* The email subject. Optional: when omitted, the tracked mailer falls back
|
|
32
|
+
* to the template registry's `defaultSubject` for {@link template} (the
|
|
33
|
+
* blueprint interpreter's send nodes rely on this — a blueprint send node
|
|
34
|
+
* carries only a template key). Code journeys typically pass it explicitly.
|
|
35
|
+
*/
|
|
36
|
+
subject?: string;
|
|
37
|
+
journeyName?: string;
|
|
38
|
+
journeyStateId?: string;
|
|
39
|
+
props?: Record<string, unknown>;
|
|
40
|
+
/**
|
|
41
|
+
* Explicit idempotency key. A public caller (e.g. POST /v1/emails) sets this
|
|
42
|
+
* directly; it always wins over the engine's auto-derivation. Journey sends
|
|
43
|
+
* leave it unset — the engine derives a deterministic key from the active
|
|
44
|
+
* journey boundary (see {@link idempotencyLabel}).
|
|
45
|
+
*/
|
|
46
|
+
idempotencyKey?: string;
|
|
47
|
+
/**
|
|
48
|
+
* Disambiguates a send's exactly-once idempotency key when the SAME template
|
|
49
|
+
* is sent more than once in one journey enrollment on divergent branches.
|
|
50
|
+
* Normally the engine auto-derives the key from the nearest authored wait
|
|
51
|
+
* label, so this is rarely needed; pass a distinct label per call if the
|
|
52
|
+
* engine throws an intra-run key-collision error. Additive and optional.
|
|
53
|
+
*/
|
|
54
|
+
idempotencyLabel?: string;
|
|
55
|
+
/**
|
|
56
|
+
* Files to send with the email (invoices, receipts, tickets, exports).
|
|
57
|
+
* Neutral {@link EmailAttachment} shape; validated + capability-gated by the
|
|
58
|
+
* tracked mailer BEFORE any work — a provider that does not declare
|
|
59
|
+
* `capabilities.attachments` throws rather than delivering the message
|
|
60
|
+
* without its files. Attachments do NOT enter the replay-stable idempotency
|
|
61
|
+
* key (that stays `kind:anchor:site:template`), so no authoring change is
|
|
62
|
+
* needed for exactly-once — but if something NON-deterministic picks the
|
|
63
|
+
* attachment, wrap that choice in `ctx.once` like any other non-deterministic
|
|
64
|
+
* send input.
|
|
65
|
+
*/
|
|
66
|
+
attachments?: EmailAttachment[];
|
|
67
|
+
}
|
|
68
|
+
export interface SendEmailResult {
|
|
69
|
+
emailSendId: string;
|
|
70
|
+
sentAt: string;
|
|
71
|
+
}
|
|
72
|
+
export declare function sendEmail(opts: SendEmailOptions): Promise<SendEmailResult>;
|
|
73
|
+
//# sourceMappingURL=email.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/lib/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM3E,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,0BAA0B,CAAC;AAKlC,eAAO,MAAM,eAAe,+BAAe,CAAC;AAE5C;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,oBAAe,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,eAAe,CAAC,CA8H1B"}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { type Database } from "@hogsend/db";
|
|
2
|
+
/** The lookup subject's kind — mirrors the `enrichment_lookup_kind` pgEnum. */
|
|
3
|
+
export type EnrichmentLookupKind = "email" | "domain";
|
|
4
|
+
/**
|
|
5
|
+
* The lookup's outcome — mirrors the `enrichment_lookup_status` pgEnum.
|
|
6
|
+
* `found`/`not_found` are both PAID answers and suppress re-spend until the row
|
|
7
|
+
* expires; `error` is not a paid answer and must never suppress a retry.
|
|
8
|
+
*/
|
|
9
|
+
export type EnrichmentLookupStatus = "found" | "not_found" | "error";
|
|
10
|
+
/** A ledger row as the refinement gate chain reads it. */
|
|
11
|
+
export interface EnrichmentLookupRow {
|
|
12
|
+
id: string;
|
|
13
|
+
provider: string;
|
|
14
|
+
lookupKind: EnrichmentLookupKind;
|
|
15
|
+
lookupKey: string;
|
|
16
|
+
status: EnrichmentLookupStatus;
|
|
17
|
+
contactId: string | null;
|
|
18
|
+
refinedAt: Date;
|
|
19
|
+
expiresAt: Date;
|
|
20
|
+
raw: Record<string, unknown> | null;
|
|
21
|
+
/** The normalized canonical trait patch the paid answer produced. */
|
|
22
|
+
traits: Record<string, unknown> | null;
|
|
23
|
+
spendWindow: Date | null;
|
|
24
|
+
spendCount: number;
|
|
25
|
+
lastErrorAt: Date | null;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* The ledger row for a `(provider, lookupKind, lookupKey)` triple, or null when
|
|
29
|
+
* this subject has never been looked up by this provider.
|
|
30
|
+
*
|
|
31
|
+
* Deliberately returns the row REGARDLESS of status and expiry: the gate chain
|
|
32
|
+
* owns the "unexpired AND paid" verdict so the `error`-never-short-circuits rule
|
|
33
|
+
* lives next to the rest of the gate ordering rather than being buried in a
|
|
34
|
+
* WHERE clause.
|
|
35
|
+
*/
|
|
36
|
+
export declare function findEnrichmentLookup(opts: {
|
|
37
|
+
db: Database;
|
|
38
|
+
provider: string;
|
|
39
|
+
lookupKind: EnrichmentLookupKind;
|
|
40
|
+
lookupKey: string;
|
|
41
|
+
}): Promise<EnrichmentLookupRow | null>;
|
|
42
|
+
/**
|
|
43
|
+
* Record a lookup against the `(provider, lookup_kind, lookup_key)` unique index
|
|
44
|
+
* — the Layer-2, version-independent exactly-once backstop for refinement — AND
|
|
45
|
+
* the spend it cost.
|
|
46
|
+
*
|
|
47
|
+
* Conflict behaviour is status-dependent, and deliberately asymmetric:
|
|
48
|
+
*
|
|
49
|
+
* - a PAID answer (`found` / `not_found`) UPDATES the existing row, so a
|
|
50
|
+
* `force: true` re-lookup refreshes the TTL + the stored traits in place
|
|
51
|
+
* instead of inserting a duplicate (the unique index would reject one
|
|
52
|
+
* anyway);
|
|
53
|
+
* - an `error` never touches the CACHE columns (`status`/`expiresAt`/`raw`/
|
|
54
|
+
* `traits`/`refinedAt`), so a transient vendor 5xx during a forced re-lookup
|
|
55
|
+
* can never clobber a live, good cached row.
|
|
56
|
+
*
|
|
57
|
+
* What BOTH branches always do is bump the spend counter and stamp
|
|
58
|
+
* `spend_window`. That is the whole point: the row is one-per-key, so counting
|
|
59
|
+
* rows counts SUBJECTS, not vendor calls — a `force` loop, or an outage
|
|
60
|
+
* retrying an already-refined base, would otherwise spend real money without
|
|
61
|
+
* ever moving the budget cap. `spend_count` resets to 1 whenever the call lands
|
|
62
|
+
* in a window later than the one on the row, so a previous month's attempts can
|
|
63
|
+
* never be pulled into this month's ceiling.
|
|
64
|
+
*/
|
|
65
|
+
export declare function upsertEnrichmentLookup(opts: {
|
|
66
|
+
db: Database;
|
|
67
|
+
provider: string;
|
|
68
|
+
lookupKind: EnrichmentLookupKind;
|
|
69
|
+
lookupKey: string;
|
|
70
|
+
status: EnrichmentLookupStatus;
|
|
71
|
+
contactId?: string | null;
|
|
72
|
+
refinedAt: Date;
|
|
73
|
+
expiresAt: Date;
|
|
74
|
+
raw?: unknown;
|
|
75
|
+
traits?: Record<string, unknown> | null;
|
|
76
|
+
/** First instant of the budget window this call is charged to. */
|
|
77
|
+
spendWindow: Date;
|
|
78
|
+
}): Promise<void>;
|
|
79
|
+
/**
|
|
80
|
+
* How many provider LOOKUPS the ledger recorded in the budget window starting
|
|
81
|
+
* at `since` — the number behind `ENRICHMENT_MONTHLY_LOOKUPS`.
|
|
82
|
+
*
|
|
83
|
+
* A SUM of `spend_count` over the rows stamped with this window, not a COUNT of
|
|
84
|
+
* rows: the table holds one row per subject, so a row count would answer "how
|
|
85
|
+
* many distinct subjects were touched", which equals spend only when nothing is
|
|
86
|
+
* ever re-looked-up. Errors are included — an `error` row still represents a
|
|
87
|
+
* request that left the building, and the operator's cap is a ceiling on
|
|
88
|
+
* requests, not on successful matches. Served by
|
|
89
|
+
* `enrichment_lookups_spend_window_idx`.
|
|
90
|
+
*/
|
|
91
|
+
export declare function countEnrichmentLookups(opts: {
|
|
92
|
+
db: Database;
|
|
93
|
+
since: Date;
|
|
94
|
+
}): Promise<number>;
|
|
95
|
+
/**
|
|
96
|
+
* The first instant of `at`'s calendar month in UTC — the lower bound of the
|
|
97
|
+
* monthly budget window. UTC (not local) so the cap resets at the same instant
|
|
98
|
+
* for every process regardless of the host's timezone.
|
|
99
|
+
*/
|
|
100
|
+
export declare function startOfUtcMonth(at: Date): Date;
|
|
101
|
+
//# sourceMappingURL=enrichment-ledger.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"enrichment-ledger.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,aAAa,CAAC;AAG/D,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAatC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,kEAAkE;IAClE,WAAW,EAAE,IAAI,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAE9C"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { EnrichmentProvider } from "@hogsend/core";
|
|
2
|
+
/**
|
|
3
|
+
* Container-held registry of enrichment providers, keyed by `provider.meta.id`.
|
|
4
|
+
* The container picks ONE active provider out of it (resolved as
|
|
5
|
+
* `enrichment.defaultProvider ?? ENRICHMENT_PROVIDER ?? "apollo"`) for the
|
|
6
|
+
* `refineContact()` pipeline.
|
|
7
|
+
*
|
|
8
|
+
* The enrichment sibling of {@link SmsProviderRegistry}. `meta` is REQUIRED on
|
|
9
|
+
* the enrichment contract (no pre-registry back-compat), so there is no
|
|
10
|
+
* fallback id — last-writer-wins on `meta.id`.
|
|
11
|
+
*/
|
|
12
|
+
export declare class EnrichmentProviderRegistry {
|
|
13
|
+
private byId;
|
|
14
|
+
constructor(providers?: EnrichmentProvider[]);
|
|
15
|
+
register(provider: EnrichmentProvider): void;
|
|
16
|
+
get(id: string): EnrichmentProvider | undefined;
|
|
17
|
+
getAll(): EnrichmentProvider[];
|
|
18
|
+
count(): number;
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=enrichment-provider-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"enrichment-provider-registry.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,IAAI,CAAyC;gBAEzC,SAAS,GAAE,kBAAkB,EAAO;IAIhD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/C,MAAM,IAAI,kBAAkB,EAAE;IAI9B,KAAK,IAAI,MAAM;CAGhB"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { EnrichmentProvider } from "@hogsend/core";
|
|
2
|
+
import type { env as envSchema } from "../env.js";
|
|
3
|
+
/**
|
|
4
|
+
* Build the env-enabled enrichment-provider presets. A preset is constructed
|
|
5
|
+
* ONLY when its credential is present AND the opt-in package resolved (see the
|
|
6
|
+
* guarded dynamic import above), so a deploy without an Apollo key never
|
|
7
|
+
* touches the package and contributes no provider.
|
|
8
|
+
*
|
|
9
|
+
* These presets come FIRST in the container's merge — a consumer-supplied
|
|
10
|
+
* provider of the same id wins (last-writer-wins on the registry).
|
|
11
|
+
*/
|
|
12
|
+
export declare function enrichmentProvidersFromEnv(env: typeof envSchema): EnrichmentProvider[];
|
|
13
|
+
//# sourceMappingURL=enrichment-providers-from-env.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"enrichment-providers-from-env.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-providers-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AA+BlD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,SAAS,GACpB,kBAAkB,EAAE,CAQtB"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { EnrichmentProvider } from "@hogsend/core";
|
|
2
|
+
import type { EnrichmentProviderRegistry } from "./enrichment-provider-registry.js";
|
|
3
|
+
export declare function setEnrichmentProviders(registry: EnrichmentProviderRegistry, active?: EnrichmentProvider): void;
|
|
4
|
+
export declare function getEnrichmentProviderRegistry(): EnrichmentProviderRegistry | undefined;
|
|
5
|
+
/** The single resolved active enrichment provider (undefined = not configured). */
|
|
6
|
+
export declare function getEnrichmentProvider(): EnrichmentProvider | undefined;
|
|
7
|
+
/** Reset the installed state — only for test cleanup. */
|
|
8
|
+
export declare function resetEnrichmentProviders(): void;
|
|
9
|
+
//# sourceMappingURL=enrichment-registry-singleton.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"enrichment-registry-singleton.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-registry-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAsBpF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,kBAAkB,GAC1B,IAAI,CAEN;AAED,wBAAgB,6BAA6B,IACzC,0BAA0B,GAC1B,SAAS,CAEZ;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,SAAS,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { JourneyMeta } from "@hogsend/core/types";
|
|
2
|
+
import { type Database } from "@hogsend/db";
|
|
3
|
+
/**
|
|
4
|
+
* The subject these guards read history for. `contactId` is REQUIRED (not
|
|
5
|
+
* optional) for the same reason `ConditionContext.contactId` is: an optional
|
|
6
|
+
* field silently defaults a new caller onto the mutable text key, which is
|
|
7
|
+
* exactly the entry-limit miss this batch exists to close. Pass `null`
|
|
8
|
+
* explicitly for a subject with no contact — a permanent, supported state (the
|
|
9
|
+
* engine refuses to mint a contact on observation).
|
|
10
|
+
*/
|
|
11
|
+
export declare function checkEntryLimit(opts: {
|
|
12
|
+
db: Database;
|
|
13
|
+
journey: JourneyMeta;
|
|
14
|
+
userId: string;
|
|
15
|
+
contactId: string | null;
|
|
16
|
+
}): Promise<{
|
|
17
|
+
allowed: boolean;
|
|
18
|
+
reason?: string;
|
|
19
|
+
}>;
|
|
20
|
+
/** See {@link checkEntryLimit} for why `contactId` is required. */
|
|
21
|
+
export declare function checkEmailPreferences(opts: {
|
|
22
|
+
db: Database;
|
|
23
|
+
userId: string;
|
|
24
|
+
contactId: string | null;
|
|
25
|
+
}): Promise<{
|
|
26
|
+
unsubscribed: boolean;
|
|
27
|
+
}>;
|
|
28
|
+
//# sourceMappingURL=enrollment-guards.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"enrollment-guards.d.ts","sourceRoot":"","sources":["../../src/lib/enrollment-guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,QAAQ,EAAmC,MAAM,aAAa,CAAC;AAG7E;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BjD;AAED,mEAAmE;AACnE,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAOrC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { JourneyMeta } from "@hogsend/core/types";
|
|
2
|
+
export interface EnrollmentPolicyFacts {
|
|
3
|
+
/** Omit when there is no persisted admin override. */
|
|
4
|
+
adminEnabled?: boolean;
|
|
5
|
+
entry?: {
|
|
6
|
+
allowed: boolean;
|
|
7
|
+
reason?: string;
|
|
8
|
+
};
|
|
9
|
+
unsubscribed?: boolean;
|
|
10
|
+
heldOut?: boolean;
|
|
11
|
+
alreadyActive?: boolean;
|
|
12
|
+
}
|
|
13
|
+
export type EnrollmentPolicyResult = {
|
|
14
|
+
allowed: true;
|
|
15
|
+
} | {
|
|
16
|
+
allowed: false;
|
|
17
|
+
reason: string;
|
|
18
|
+
};
|
|
19
|
+
/** Pure enrollment guard ordering shared by production and test fixtures. */
|
|
20
|
+
export declare function evaluateEnrollmentPolicy(opts: {
|
|
21
|
+
journey: JourneyMeta;
|
|
22
|
+
properties: Record<string, unknown>;
|
|
23
|
+
facts?: EnrollmentPolicyFacts;
|
|
24
|
+
}): EnrollmentPolicyResult;
|
|
25
|
+
//# sourceMappingURL=enrollment-policy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"enrollment-policy.d.ts","sourceRoot":"","sources":["../../src/lib/enrollment-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,GAAG,sBAAsB,CA6BzB"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { z } from "@hono/zod-openapi";
|
|
2
|
+
import type { HogsendClient } from "../container.js";
|
|
3
|
+
/**
|
|
4
|
+
* One merged event-name entry. Canonical shape shared by the helper's return,
|
|
5
|
+
* the `list_events` tool, and the `GET /v1/admin/events/names` OpenAPI response
|
|
6
|
+
* (the route imports this instead of re-declaring it, so they can never drift).
|
|
7
|
+
*/
|
|
8
|
+
export declare const eventNameEntrySchema: z.ZodObject<{
|
|
9
|
+
name: z.ZodString;
|
|
10
|
+
occurrences: z.ZodNumber;
|
|
11
|
+
firstSeenAt: z.ZodNullable<z.ZodString>;
|
|
12
|
+
lastSeenAt: z.ZodNullable<z.ZodString>;
|
|
13
|
+
usedBy: z.ZodArray<z.ZodString>;
|
|
14
|
+
}, z.core.$strip>;
|
|
15
|
+
export type EventNameEntry = z.infer<typeof eventNameEntrySchema>;
|
|
16
|
+
export declare function listEventNameVocabulary(opts: {
|
|
17
|
+
db: HogsendClient["db"];
|
|
18
|
+
registry: HogsendClient["registry"];
|
|
19
|
+
/** Case-insensitive substring filter on the event name. */
|
|
20
|
+
search?: string;
|
|
21
|
+
/** Cap on the observed-events scan (the declared merge is uncapped). */
|
|
22
|
+
limit: number;
|
|
23
|
+
}): Promise<{
|
|
24
|
+
note: string;
|
|
25
|
+
events: EventNameEntry[];
|
|
26
|
+
}>;
|
|
27
|
+
//# sourceMappingURL=event-names.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"event-names.d.ts","sourceRoot":"","sources":["../../src/lib/event-names.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAQ/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAqGtD"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { type FeedBlock } from "@hogsend/db";
|
|
2
|
+
import { IN_APP_LIST_ID } from "../lists/channels.js";
|
|
3
|
+
/**
|
|
4
|
+
* Reserved list id governing in-app feed suppression (mirrors the built-in
|
|
5
|
+
* `transactional` / `journey` categories). A recipient unsubscribed from
|
|
6
|
+
* `in_app` (or `unsubscribed_all`) gets no feed items. Canonically defined in
|
|
7
|
+
* `../lists/channels.js` (where the in-app channel is synthesized); re-exported
|
|
8
|
+
* here so the engine's existing export surface stays stable.
|
|
9
|
+
*/
|
|
10
|
+
export { IN_APP_LIST_ID };
|
|
11
|
+
export interface SendFeedItemOptions {
|
|
12
|
+
recipient: {
|
|
13
|
+
userId?: string;
|
|
14
|
+
email?: string;
|
|
15
|
+
anonymousId?: string;
|
|
16
|
+
};
|
|
17
|
+
type: string;
|
|
18
|
+
title?: string;
|
|
19
|
+
body?: string;
|
|
20
|
+
blocks?: FeedBlock[];
|
|
21
|
+
actionUrl?: string;
|
|
22
|
+
metadata?: Record<string, unknown>;
|
|
23
|
+
/** Item category (the feed it lands in). Default `"in_app"`. */
|
|
24
|
+
category?: string;
|
|
25
|
+
templateKey?: string;
|
|
26
|
+
journeyStateId?: string;
|
|
27
|
+
/**
|
|
28
|
+
* Explicit idempotency key. A public caller sets it directly; it always wins
|
|
29
|
+
* over the engine's journey auto-derivation. Journey sends leave it unset.
|
|
30
|
+
*/
|
|
31
|
+
idempotencyKey?: string;
|
|
32
|
+
/**
|
|
33
|
+
* Disambiguates the exactly-once key when the SAME feed type is sent more than
|
|
34
|
+
* once in one journey enrollment on divergent branches sharing a nearest wait
|
|
35
|
+
* label. Mirrors `sendEmail()`'s `idempotencyLabel`. Additive and optional.
|
|
36
|
+
*/
|
|
37
|
+
idempotencyLabel?: string;
|
|
38
|
+
}
|
|
39
|
+
export interface SendFeedItemResult {
|
|
40
|
+
/** The inserted row id, or `null` when suppressed or idempotent-deduped. */
|
|
41
|
+
feedItemId: string | null;
|
|
42
|
+
/** The resolved canonical recipient key (null only when no recipient given). */
|
|
43
|
+
recipientKey: string | null;
|
|
44
|
+
suppressed: boolean;
|
|
45
|
+
createdAt: string | null;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Journey-callable in-app feed send — the standalone, single-object-in /
|
|
49
|
+
* result-out counterpart to `sendEmail()` / `sendConnectorAction()`. NOT on
|
|
50
|
+
* `JourneyContext` (features are standalone imports).
|
|
51
|
+
*
|
|
52
|
+
* Pipeline: resolve recipient → canonical key → `in_app` suppression check →
|
|
53
|
+
* insert a `feed_items` row (replay-safe idempotency when in a journey) → publish
|
|
54
|
+
* to the Redis realtime channel `feed:<recipientKey>` on the COMMAND singleton.
|
|
55
|
+
*
|
|
56
|
+
* Replay-safety mirrors `sendEmail()`: inside a journey the engine derives a
|
|
57
|
+
* deterministic, branch-stable key off `boundary.runAnchor` (the Hatchet run id,
|
|
58
|
+
* NOT the freshly-minted state id) so a replay re-firing the same logical send
|
|
59
|
+
* re-derives the SAME key and the unique `feed_items.idempotencyKey` index
|
|
60
|
+
* (`onConflictDoNothing`, Layer 2) absorbs the duplicate insert. When eviction is
|
|
61
|
+
* supported, the whole insert+publish runs inside `boundary.memoize` (Layer 1).
|
|
62
|
+
*/
|
|
63
|
+
export declare function sendFeedItem(opts: SendFeedItemOptions): Promise<SendFeedItemResult>;
|
|
64
|
+
//# sourceMappingURL=feed.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../../src/lib/feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,aAAa,CAAC;AAMxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAgBtD;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gFAAgF;IAChF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA0R7B"}
|