@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,98 @@
|
|
|
1
|
+
import type { ConversionDestination, ConversionDispatchInput } from "@hogsend/core";
|
|
2
|
+
import { type Database } from "@hogsend/db";
|
|
3
|
+
import type { Logger } from "./logger.js";
|
|
4
|
+
/**
|
|
5
|
+
* Conversion dispatch (plan §5.2): fired conversions → destination providers,
|
|
6
|
+
* durably. The ingest hook creates `conversion_dispatches` rows (idempotent
|
|
7
|
+
* on (destination, event_id)) and enqueues the durable task per row; the task
|
|
8
|
+
* assembles the enriched payload (contact identifiers + recovered click
|
|
9
|
+
* context) and calls the provider, retrying with the SAME deterministic
|
|
10
|
+
* event_id so the platform dedups.
|
|
11
|
+
*/
|
|
12
|
+
export declare class ConversionDestinationRegistry {
|
|
13
|
+
private byId;
|
|
14
|
+
constructor(destinations?: ConversionDestination[]);
|
|
15
|
+
get(id: string): ConversionDestination | undefined;
|
|
16
|
+
}
|
|
17
|
+
export declare const setConversionDestinations: (value: ConversionDestinationRegistry | undefined) => void;
|
|
18
|
+
export declare const getConversionDestinations: () => ConversionDestinationRegistry | undefined;
|
|
19
|
+
/** Reset the singleton — only for test cleanup. */
|
|
20
|
+
export declare const resetConversionDestinations: () => void;
|
|
21
|
+
/** Deterministic dedup id — stable across retries AND re-evaluations. */
|
|
22
|
+
export declare function conversionEventId(opts: {
|
|
23
|
+
contactId: string;
|
|
24
|
+
definitionId: string;
|
|
25
|
+
eventRowId: string;
|
|
26
|
+
}): string;
|
|
27
|
+
/**
|
|
28
|
+
* Create the dispatch rows for a fired conversion (idempotent) and return the
|
|
29
|
+
* ids that were FRESHLY created (the caller enqueues the task for those).
|
|
30
|
+
*/
|
|
31
|
+
export declare function createConversionDispatches(opts: {
|
|
32
|
+
db: Database;
|
|
33
|
+
conversionId: string;
|
|
34
|
+
eventId: string;
|
|
35
|
+
destinationIds: string[];
|
|
36
|
+
}): Promise<string[]>;
|
|
37
|
+
/**
|
|
38
|
+
* Recover the contact's click context: the most recent `campaign.arrived`
|
|
39
|
+
* touchpoint at-or-before the conversion carrying at least one allowlisted
|
|
40
|
+
* click ID. A later click-ID-less arrival (a `utm_*`-only newsletter landing)
|
|
41
|
+
* must not shadow a real ad click, so we scan back past it; only when NO
|
|
42
|
+
* arrival carries a click ID does the latest one stand (for `landingPage`).
|
|
43
|
+
* The chosen arrival's `occurredAt` doubles as the click timestamp (`fbc`
|
|
44
|
+
* needs the real one).
|
|
45
|
+
*/
|
|
46
|
+
export declare function recoverClickContext(opts: {
|
|
47
|
+
db: Database;
|
|
48
|
+
userKey: string;
|
|
49
|
+
/**
|
|
50
|
+
* The trusted owner uuid. REQUIRED (not optional) for the same reason the
|
|
51
|
+
* enrollment guards' is: an optional field silently defaults a new caller
|
|
52
|
+
* onto the mutable text key, and an arrival recorded under the visitor's
|
|
53
|
+
* anon-era key would then be invisible — the click id the ad platform needs
|
|
54
|
+
* to match the conversion goes missing exactly when it matters (the click
|
|
55
|
+
* IS the anonymous era). Pass `null` explicitly for a subject with no
|
|
56
|
+
* contact; `userKey` still serves that case.
|
|
57
|
+
*/
|
|
58
|
+
contactId: string | null;
|
|
59
|
+
before: Date;
|
|
60
|
+
}): Promise<ConversionDispatchInput["clicks"]>;
|
|
61
|
+
/**
|
|
62
|
+
* Deliver ONE dispatch row: load, enrich, send, record. Called by the durable
|
|
63
|
+
* task (which owns retry/backoff); a throw here signals Hatchet to retry.
|
|
64
|
+
* `maxAttempts` marks the row failed instead of throwing once exhausted.
|
|
65
|
+
*/
|
|
66
|
+
export declare function deliverConversionDispatch(opts: {
|
|
67
|
+
db: Database;
|
|
68
|
+
logger: Logger;
|
|
69
|
+
dispatchId: string;
|
|
70
|
+
registry?: ConversionDestinationRegistry;
|
|
71
|
+
maxAttempts?: number;
|
|
72
|
+
}): Promise<{
|
|
73
|
+
status: "delivered" | "failed" | "skipped";
|
|
74
|
+
}>;
|
|
75
|
+
export interface ConversionDispatchTask {
|
|
76
|
+
runNoWait(input: {
|
|
77
|
+
dispatchId: string;
|
|
78
|
+
}): unknown;
|
|
79
|
+
}
|
|
80
|
+
export declare const setConversionDispatchTask: (value: ConversionDispatchTask | undefined) => void;
|
|
81
|
+
export declare const getConversionDispatchTask: () => ConversionDispatchTask | undefined;
|
|
82
|
+
/** Reset the singleton — only for test cleanup. */
|
|
83
|
+
export declare const resetConversionDispatchTask: () => void;
|
|
84
|
+
/**
|
|
85
|
+
* Ingest-side fan-out: create dispatch rows for a fired conversion and
|
|
86
|
+
* enqueue the durable task for each fresh row. Best-effort — the conversion
|
|
87
|
+
* row is already durable; a failed enqueue is retriable via the row's
|
|
88
|
+
* pending status (a future reaper can re-drive).
|
|
89
|
+
*/
|
|
90
|
+
export declare function enqueueConversionDispatches(opts: {
|
|
91
|
+
db: Database;
|
|
92
|
+
logger: Logger;
|
|
93
|
+
task?: ConversionDispatchTask;
|
|
94
|
+
conversionId: string;
|
|
95
|
+
eventId: string;
|
|
96
|
+
destinationIds: string[];
|
|
97
|
+
}): Promise<void>;
|
|
98
|
+
//# sourceMappingURL=conversion-dispatch.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"conversion-dispatch.d.ts","sourceRoot":"","sources":["../../src/lib/conversion-dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAIL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;;;GAOG;AAEH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,IAAI,CAA4C;gBAE5C,YAAY,GAAE,qBAAqB,EAAO;IAMtD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;CAGnD;AAGD,eAAO,MAAM,yBAAyB,4DAAgB,CAAC;AACvD,eAAO,MAAM,yBAAyB,iDAAgB,CAAC;AACvD,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,YAAkB,CAAC;AAE3D,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAIT;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,EAAE,EAAE,QAAQ,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC;CACd,GAAG,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAmD7C;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;CAAE,CAAC,CAgH1D;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CACnD;AAOD,eAAO,MAAM,yBAAyB,qDAAoB,CAAC;AAC3D,eAAO,MAAM,yBAAyB,0CAAoB,CAAC;AAC3D,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,YAAsB,CAAC;AAE/D;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import type { DefinedConversion } from "@hogsend/core";
|
|
2
|
+
import { type Database } from "@hogsend/db";
|
|
3
|
+
import type { Logger } from "./logger.js";
|
|
4
|
+
/**
|
|
5
|
+
* Conversion evaluation at ingest —
|
|
6
|
+
* the hook `ingestEvent` calls after a FRESH event insert. Definitions are
|
|
7
|
+
* code-first (`createHogsendClient({ conversions })`); a fired instance is
|
|
8
|
+
* recorded once per (definition, event row) — the unique index makes a
|
|
9
|
+
* replayed evaluation a no-op, so this inherits the spine's idempotency.
|
|
10
|
+
*/
|
|
11
|
+
export interface FiredConversion {
|
|
12
|
+
conversionId: string;
|
|
13
|
+
definition: DefinedConversion;
|
|
14
|
+
value: number | null;
|
|
15
|
+
currency: string | null;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Registry: definitions indexed by trigger event name. `trigger.event: "*"`
|
|
19
|
+
* is a WILDCARD (impact plan §5.2): the definition is a candidate for EVERY
|
|
20
|
+
* ingested event, narrowed only by its `where`/`sources` gates — how the
|
|
21
|
+
* built-in zero-config `revenue` conversion matches any trusted valued
|
|
22
|
+
* event without naming it.
|
|
23
|
+
*/
|
|
24
|
+
export declare class ConversionRegistry {
|
|
25
|
+
private byEvent;
|
|
26
|
+
private wildcard;
|
|
27
|
+
private all;
|
|
28
|
+
constructor(definitions?: DefinedConversion[]);
|
|
29
|
+
forEvent(event: string): DefinedConversion[];
|
|
30
|
+
getAll(): DefinedConversion[];
|
|
31
|
+
count(): number;
|
|
32
|
+
/**
|
|
33
|
+
* Membership check over ALL definitions (named-trigger + wildcard) by
|
|
34
|
+
* `meta.id` — the container's `meta.goal` boot validation reads this.
|
|
35
|
+
*/
|
|
36
|
+
has(id: string): boolean;
|
|
37
|
+
}
|
|
38
|
+
export declare const setConversionRegistry: (value: ConversionRegistry | undefined) => void;
|
|
39
|
+
export declare const getConversionRegistry: () => ConversionRegistry | undefined;
|
|
40
|
+
/** Reset the singleton — only for test cleanup. */
|
|
41
|
+
export declare const resetConversionRegistry: () => void;
|
|
42
|
+
/**
|
|
43
|
+
* The built-in zero-config revenue conversion (impact plan §5.2): any
|
|
44
|
+
* TRUSTED valued event fires it — a fresh adopter who points one Stripe /
|
|
45
|
+
* order webhook at a source sees the Impact tab populate with no
|
|
46
|
+
* configuration. Seeded by `createHogsendClient` unless the consumer
|
|
47
|
+
* authors their own `id: "revenue"` definition or sets
|
|
48
|
+
* `HOGSEND_DEFAULT_REVENUE_CONVERSION=false`.
|
|
49
|
+
*
|
|
50
|
+
* Guards, matching the revenue-rollup semantics (lib/revenue.ts):
|
|
51
|
+
* - `value > 0` — valueless events never fire it;
|
|
52
|
+
* - quote-shaped events excluded (`crm.stage_changed` re-carries a deal's
|
|
53
|
+
* value on every change; a quote is unrealized money) — only
|
|
54
|
+
* `crm.deal_sold` and genuine order/subscription events count;
|
|
55
|
+
* - browser (`inapp`) events excluded by the default `sources` gate
|
|
56
|
+
* (forged-value guard).
|
|
57
|
+
*/
|
|
58
|
+
export declare const defaultRevenueConversion: DefinedConversion;
|
|
59
|
+
export declare function evaluateConversionsAtIngest(opts: {
|
|
60
|
+
db: Database;
|
|
61
|
+
logger: Logger;
|
|
62
|
+
registry: ConversionRegistry | undefined;
|
|
63
|
+
event: {
|
|
64
|
+
name: string;
|
|
65
|
+
source: string | null;
|
|
66
|
+
properties: Record<string, unknown>;
|
|
67
|
+
value: number | null;
|
|
68
|
+
currency: string | null;
|
|
69
|
+
occurredAt: Date;
|
|
70
|
+
};
|
|
71
|
+
eventRowId: string;
|
|
72
|
+
contactId: string;
|
|
73
|
+
userKey: string;
|
|
74
|
+
}): Promise<FiredConversion[]>;
|
|
75
|
+
//# sourceMappingURL=conversions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"conversions.d.ts","sourceRoot":"","sources":["../../src/lib/conversions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQvD,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,GAAG,CAA2B;gBAE1B,WAAW,GAAE,iBAAiB,EAAO;IAajD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAM5C,MAAM,IAAI,iBAAiB,EAAE;IAI7B,KAAK,IAAI,MAAM;IAIf;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGzB;AAGD,eAAO,MAAM,qBAAqB,iDAAgB,CAAC;AACnD,eAAO,MAAM,qBAAqB,sCAAgB,CAAC;AACnD,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,YAAkB,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAiBrC,CAAC;AAEH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzC,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAwE7B"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import type { Auth } from "./auth.js";
|
|
2
|
+
/**
|
|
3
|
+
* Shared admin-minting primitive used by BOTH the CLI's `admin create` and the
|
|
4
|
+
* engine's env bootstrap. Mints a credential admin via better-auth's
|
|
5
|
+
* INTERNAL ADAPTER (scrypt-identical to the running app) rather than the public
|
|
6
|
+
* sign-up endpoint — which is now blocked by `disableSignUp` (see lib/auth.ts).
|
|
7
|
+
*
|
|
8
|
+
* Why the internal adapter (not `auth.api.signUpEmail`): in better-auth 1.6.11
|
|
9
|
+
* the `disableSignUp` check lives INSIDE the sign-up endpoint handler, and
|
|
10
|
+
* `auth.api.signUpEmail` dispatches through that SAME handler — so with sign-up
|
|
11
|
+
* disabled it throws `EMAIL_PASSWORD_SIGN_UP_DISABLED` for the in-process API
|
|
12
|
+
* too. The internal adapter is NOT subject to that guard. This mirrors exactly
|
|
13
|
+
* what admin-recovery's `reset()` already does for its no-credential branch
|
|
14
|
+
* (`ctx.password.hash` + `ctx.internalAdapter.createAccount({ providerId:
|
|
15
|
+
* "credential" })`).
|
|
16
|
+
*
|
|
17
|
+
* Security invariants (acceptance gates, not preferences):
|
|
18
|
+
* - The password is hashed via `ctx.password.hash` (scrypt, identical to the
|
|
19
|
+
* app). There is NO raw SQL password write.
|
|
20
|
+
* - The password is never logged and never returned in any result object.
|
|
21
|
+
* - `emailVerified: true` because this is an operator-minted admin (CLI or
|
|
22
|
+
* boot env), not a self-service signup.
|
|
23
|
+
*
|
|
24
|
+
* Lives in `lib/` (reachable via the `@hogsend/engine/create-admin` subpath)
|
|
25
|
+
* with a module graph that touches ONLY better-auth — it never pulls `env.ts`,
|
|
26
|
+
* Hatchet, or Resend — so the CLI can import it the same way it imports
|
|
27
|
+
* `createAuth` from `@hogsend/engine/auth`.
|
|
28
|
+
*/
|
|
29
|
+
/** A single admin row, no secrets. Shared with the CLI's `AdminSummary`. */
|
|
30
|
+
export interface CreatedAdmin {
|
|
31
|
+
id: string;
|
|
32
|
+
email: string;
|
|
33
|
+
name: string;
|
|
34
|
+
createdAt: string;
|
|
35
|
+
}
|
|
36
|
+
/** Thrown when an admin with the given email already exists. */
|
|
37
|
+
export declare class AdminAlreadyExistsError extends Error {
|
|
38
|
+
readonly email: string;
|
|
39
|
+
constructor(email: string);
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Create a credential admin user against a built better-auth instance. Throws
|
|
43
|
+
* {@link AdminAlreadyExistsError} if the email already exists (so callers can
|
|
44
|
+
* point the operator at `reset`). The unique constraint on `user.email` is the
|
|
45
|
+
* backstop: a concurrent racer that slips past the pre-check throws on
|
|
46
|
+
* `createUser` — callers that need idempotency should catch that.
|
|
47
|
+
*/
|
|
48
|
+
export declare function createAdminUser(opts: {
|
|
49
|
+
auth: Auth;
|
|
50
|
+
email: string;
|
|
51
|
+
name?: string;
|
|
52
|
+
password: string;
|
|
53
|
+
}): Promise<CreatedAdmin>;
|
|
54
|
+
//# sourceMappingURL=create-admin.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-admin.d.ts","sourceRoot":"","sources":["../../src/lib/create-admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,qBAAa,uBAAwB,SAAQ,KAAK;aACpB,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAO1C;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0CxB"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { CanonicalStage, CrmStageEvent, PipelineLadder } from "@hogsend/core";
|
|
2
|
+
import { type Database } from "@hogsend/db";
|
|
3
|
+
import type { Logger } from "./logger.js";
|
|
4
|
+
/**
|
|
5
|
+
* The deals projection + external-id alias map
|
|
6
|
+
*. Events stay the append-only truth;
|
|
7
|
+
* this module materializes current deal state with the MONOTONIC stage rule:
|
|
8
|
+
* a change applies only when it advances the canonical rank (heals
|
|
9
|
+
* webhook+poll double-detection and out-of-order delivery), `lost` applies
|
|
10
|
+
* from any non-sold state, and a deal value update always lands (latest
|
|
11
|
+
* value wins — quotes get revised).
|
|
12
|
+
*/
|
|
13
|
+
/** The synthetic provider id for deals minted by funnel event triggers —
|
|
14
|
+
* reserved (a `CrmProvider` may not register under it). */
|
|
15
|
+
export declare const EVENTS_DEAL_PROVIDER = "events";
|
|
16
|
+
/** Resolve a CRM contact via the alias map: contact link, then deal link. */
|
|
17
|
+
export declare function resolveCrmLinkedContact(opts: {
|
|
18
|
+
db: Database;
|
|
19
|
+
providerId: string;
|
|
20
|
+
event: Pick<CrmStageEvent, "contactId" | "dealId">;
|
|
21
|
+
}): Promise<string | null>;
|
|
22
|
+
/** Mint the alias rows (idempotent) so future events resolve without email. */
|
|
23
|
+
export declare function ensureCrmLinks(opts: {
|
|
24
|
+
db: Database;
|
|
25
|
+
providerId: string;
|
|
26
|
+
contactId: string;
|
|
27
|
+
event: Pick<CrmStageEvent, "contactId" | "dealId">;
|
|
28
|
+
}): Promise<void>;
|
|
29
|
+
export interface AppliedStageChange {
|
|
30
|
+
dealId: string;
|
|
31
|
+
/** The deal FIRST reached the ladder's quote stage with this event. */
|
|
32
|
+
freshQuoted: boolean;
|
|
33
|
+
/** The deal FIRST reached the ladder's sold stage with this event. */
|
|
34
|
+
freshSold: boolean;
|
|
35
|
+
/** Current projected value after this event. */
|
|
36
|
+
value: number | null;
|
|
37
|
+
currency: string | null;
|
|
38
|
+
canonicalStage: CanonicalStage | null;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Apply one stage event to the projection. `canonicalStage` is the engine's
|
|
42
|
+
* stage-map resolution (null = unmapped: native fields still record, the
|
|
43
|
+
* canonical stage holds). `event` is the minimal projection input — the CRM
|
|
44
|
+
* path passes a full {@link CrmStageEvent}; the event-trigger path builds
|
|
45
|
+
* one synthetically (providerId "events").
|
|
46
|
+
*/
|
|
47
|
+
export declare function applyCrmStageEvent(opts: {
|
|
48
|
+
db: Database;
|
|
49
|
+
logger: Logger;
|
|
50
|
+
providerId: string;
|
|
51
|
+
contactId: string;
|
|
52
|
+
event: Pick<CrmStageEvent, "dealId" | "stageId" | "pipelineId" | "value" | "occurredAt">;
|
|
53
|
+
canonicalStage: CanonicalStage | null;
|
|
54
|
+
/** The claiming funnel's ladder; defaults to the built-in five. */
|
|
55
|
+
ladder?: PipelineLadder;
|
|
56
|
+
/** The claiming funnel's id (stamped on the deal). */
|
|
57
|
+
funnelId?: string | null;
|
|
58
|
+
/**
|
|
59
|
+
* Skip the "latest value wins" update when the deal is already terminal
|
|
60
|
+
* (sold/lost). The event-trigger path sets this — a new-cycle trigger
|
|
61
|
+
* colliding with a closed synthetic row must not clobber its realized
|
|
62
|
+
* value. CRM paths keep the default (post-sale value revisions are real).
|
|
63
|
+
*/
|
|
64
|
+
protectTerminalValue?: boolean;
|
|
65
|
+
}): Promise<AppliedStageChange>;
|
|
66
|
+
//# sourceMappingURL=crm-deals.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"crm-deals.d.ts","sourceRoot":"","sources":["../../src/lib/crm-deals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAY,KAAK,QAAQ,EAAS,MAAM,aAAa,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;GAQG;AAEH;2DAC2D;AAC3D,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,6EAA6E;AAC7E,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,EAAE,EAAE,QAAQ,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBzB;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,QAAQ,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,CACT,aAAa,EACb,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,YAAY,CAC7D,CAAC;IACF,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,mEAAmE;IACnE,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoM9B"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
|
|
2
|
+
import type { AnalyticsProvider, CrmStageEvent } from "@hogsend/core";
|
|
3
|
+
import type { JourneyRegistry } from "@hogsend/core/registry";
|
|
4
|
+
import { type Database } from "@hogsend/db";
|
|
5
|
+
import type { FunnelRegistry } from "./funnel-registry.js";
|
|
6
|
+
import type { Logger } from "./logger.js";
|
|
7
|
+
/**
|
|
8
|
+
* Land normalized {@link CrmStageEvent}s on the spine — the shared sink of
|
|
9
|
+
* BOTH the webhook route and the reconciliation poll
|
|
10
|
+
*.
|
|
11
|
+
*
|
|
12
|
+
* Per event: (1) resolve the contact — `crm_links` alias first (works with
|
|
13
|
+
* zero PII in the payload), else the payload email (minting the links so the
|
|
14
|
+
* NEXT event resolves aliased); (2) ingest `funnel.stage_changed` (valued, flat
|
|
15
|
+
* native ids + the stage-map's canonical resolution, idempotent across
|
|
16
|
+
* webhook/poll double-detection); (3) apply the deals projection (monotonic);
|
|
17
|
+
* (4) on a FRESH canonical transition, ingest the money events
|
|
18
|
+
* `deal.quoted` / `deal.sold` (once per deal per stage, ever) with
|
|
19
|
+
* the projected deal value; (5) fan the family out on the outbound spine.
|
|
20
|
+
*/
|
|
21
|
+
export declare const FUNNEL_STAGE_CHANGED: "funnel.stage_changed";
|
|
22
|
+
export declare const DEAL_QUOTED: "deal.quoted";
|
|
23
|
+
export declare const DEAL_SOLD: "deal.sold";
|
|
24
|
+
export declare function ingestCrmStageEvents(opts: {
|
|
25
|
+
db: Database;
|
|
26
|
+
registry: JourneyRegistry;
|
|
27
|
+
hatchet: HatchetClient;
|
|
28
|
+
logger: Logger;
|
|
29
|
+
analytics?: AnalyticsProvider;
|
|
30
|
+
providerId: string;
|
|
31
|
+
events: CrmStageEvent[];
|
|
32
|
+
/** Funnel routing (which funnel claims each (provider, pipeline)). */
|
|
33
|
+
funnels?: FunnelRegistry;
|
|
34
|
+
}): Promise<{
|
|
35
|
+
ingested: number;
|
|
36
|
+
skipped: number;
|
|
37
|
+
}>;
|
|
38
|
+
//# sourceMappingURL=crm-ingest.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"crm-ingest.d.ts","sourceRoot":"","sources":["../../src/lib/crm-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAY,KAAK,QAAQ,EAAS,MAAM,aAAa,CAAC;AAU7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAC;AACpE,eAAO,MAAM,WAAW,EAAG,aAAsB,CAAC;AAClD,eAAO,MAAM,SAAS,EAAG,WAAoB,CAAC;AAE9C,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,sEAAsE;IACtE,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6SjD"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { CrmProvider } from "@hogsend/core";
|
|
2
|
+
/**
|
|
3
|
+
* Container-held registry of CRM providers, keyed by `provider.meta.id`. The
|
|
4
|
+
* webhook route (`POST /v1/webhooks/crm/:providerId`) resolves the verifying
|
|
5
|
+
* provider out of this; the reconciliation poll task walks `getAll()`.
|
|
6
|
+
*
|
|
7
|
+
* The CRM sibling of {@link SmsProviderRegistry}. Unlike email/SMS there is
|
|
8
|
+
* no single "active" provider — MANY CRMs sync concurrently (an agency
|
|
9
|
+
* deployment syncs a different CRM per client); `pushLead` callers name the
|
|
10
|
+
* provider explicitly.
|
|
11
|
+
*/
|
|
12
|
+
export declare class CrmProviderRegistry {
|
|
13
|
+
private byId;
|
|
14
|
+
constructor(providers?: CrmProvider[]);
|
|
15
|
+
register(provider: CrmProvider): void;
|
|
16
|
+
get(id: string): CrmProvider | undefined;
|
|
17
|
+
getAll(): CrmProvider[];
|
|
18
|
+
count(): number;
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=crm-provider-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"crm-provider-registry.d.ts","sourceRoot":"","sources":["../../src/lib/crm-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAkC;gBAElC,SAAS,GAAE,WAAW,EAAO;IAIzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IASrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,MAAM,IAAI,WAAW,EAAE;IAIvB,KAAK,IAAI,MAAM;CAGhB"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { CrmProviderRegistry } from "./crm-provider-registry.js";
|
|
2
|
+
import type { FunnelRegistry } from "./funnel-registry.js";
|
|
3
|
+
/**
|
|
4
|
+
* Process singleton for the CRM sync layer — set by `createHogsendClient`
|
|
5
|
+
* (both API and worker call it), read by the `crm-reconcile` cron task which
|
|
6
|
+
* has no client reference. Optional: a deploy with no CRM providers leaves it
|
|
7
|
+
* unset and the cron no-ops.
|
|
8
|
+
*/
|
|
9
|
+
export interface CrmSyncConfig {
|
|
10
|
+
registry: CrmProviderRegistry;
|
|
11
|
+
/** Funnel routing — includes the synthesized "default" (crm sugar). */
|
|
12
|
+
funnels: FunnelRegistry;
|
|
13
|
+
}
|
|
14
|
+
export declare const setCrmSyncConfig: (value: CrmSyncConfig | undefined) => void;
|
|
15
|
+
export declare const getCrmSyncConfig: () => CrmSyncConfig | undefined;
|
|
16
|
+
/** Reset the singleton — only for test cleanup. */
|
|
17
|
+
export declare const resetCrmSyncConfig: () => void;
|
|
18
|
+
//# sourceMappingURL=crm-registry-singleton.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"crm-registry-singleton.d.ts","sourceRoot":"","sources":["../../src/lib/crm-registry-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,uEAAuE;IACvE,OAAO,EAAE,cAAc,CAAC;CACzB;AAID,eAAO,MAAM,gBAAgB,4CAAgB,CAAC;AAC9C,eAAO,MAAM,gBAAgB,iCAAgB,CAAC;AAC9C,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,YAAkB,CAAC"}
|
package/dist/lib/db.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5D,wBAAgB,KAAK,IAAI,QAAQ,CAQhC"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
|
|
2
|
+
import type { AnalyticsProvider, PipelineLadder } from "@hogsend/core";
|
|
3
|
+
import type { JourneyRegistry } from "@hogsend/core/registry";
|
|
4
|
+
import type { Database } from "@hogsend/db";
|
|
5
|
+
import type { AppliedStageChange } from "./crm-deals.js";
|
|
6
|
+
import type { Logger } from "./logger.js";
|
|
7
|
+
import { type CrmDealEventPayload } from "./outbound.js";
|
|
8
|
+
/**
|
|
9
|
+
* Mint the once-per-deal money events (`deal.quoted`/`deal.sold`) after a
|
|
10
|
+
* projection apply — the shared tail of BOTH stage-change producers (the
|
|
11
|
+
* CRM ingest sink and the event-trigger path). Freshness is the projection
|
|
12
|
+
* row's fact (`freshQuoted`/`freshSold`), so whichever producer reaches a
|
|
13
|
+
* milestone first mints it; the idempotency key only guards replays of the
|
|
14
|
+
* same mint.
|
|
15
|
+
*/
|
|
16
|
+
export declare function mintDealMoneyEvents(opts: {
|
|
17
|
+
db: Database;
|
|
18
|
+
registry: JourneyRegistry;
|
|
19
|
+
hatchet: HatchetClient;
|
|
20
|
+
logger: Logger;
|
|
21
|
+
analytics?: AnalyticsProvider;
|
|
22
|
+
applied: AppliedStageChange;
|
|
23
|
+
ladder: PipelineLadder;
|
|
24
|
+
/** `crm-canonical:${provider}:${dealId}` | `funnel-canonical:${funnelId}:${externalId}` */
|
|
25
|
+
idempotencyPrefix: string;
|
|
26
|
+
source: string;
|
|
27
|
+
userId: string;
|
|
28
|
+
userEmail?: string;
|
|
29
|
+
contactId: string;
|
|
30
|
+
/** Path-specific extras; the helper adds `canonical_stage` itself. */
|
|
31
|
+
baseProperties: Record<string, unknown>;
|
|
32
|
+
occurredAt: string;
|
|
33
|
+
outboundPayload: CrmDealEventPayload;
|
|
34
|
+
}): Promise<void>;
|
|
35
|
+
//# sourceMappingURL=deal-money-events.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deal-money-events.d.ts","sourceRoot":"","sources":["../../src/lib/deal-money-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,mBAAmB,EAAgB,MAAM,eAAe,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,2FAA2F;IAC3F,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,mBAAmB,CAAC;CACtC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhB"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { Logger } from "./logger.js";
|
|
2
|
+
export interface DiscordGatewayHeartbeat {
|
|
3
|
+
/** True when a fresh gateway-worker heartbeat is present in Redis. */
|
|
4
|
+
alive: boolean;
|
|
5
|
+
/** ISO timestamp the gateway worker last wrote, when alive. */
|
|
6
|
+
lastSeenAt?: string;
|
|
7
|
+
/** The guild id the live worker observed (confirms the bot is in a server). */
|
|
8
|
+
guildId?: string;
|
|
9
|
+
/** The intents bitfield the live worker requested at login. */
|
|
10
|
+
intents?: number;
|
|
11
|
+
}
|
|
12
|
+
/** The mutable state a running heartbeat exposes for late-bound folding. */
|
|
13
|
+
export interface DiscordGatewayHeartbeatState {
|
|
14
|
+
/**
|
|
15
|
+
* Fold the worker-observed guild id into the heartbeat and write immediately,
|
|
16
|
+
* so Studio can confirm "Bot installed" as soon as the socket sees a guild.
|
|
17
|
+
*/
|
|
18
|
+
setGuildId(guildId: string): void;
|
|
19
|
+
/**
|
|
20
|
+
* Fold the worker's resolved intents bitfield into the heartbeat and write
|
|
21
|
+
* immediately, so Studio's intents chip reflects what the LIVE worker requested
|
|
22
|
+
* (preferred over the derived credential, which is never written by install).
|
|
23
|
+
*/
|
|
24
|
+
setIntents(intents: number): void;
|
|
25
|
+
}
|
|
26
|
+
export interface DiscordGatewayHeartbeatHandle {
|
|
27
|
+
/** Mutable state — call `setGuildId` from the worker's `onGuildObserved` tap. */
|
|
28
|
+
state: DiscordGatewayHeartbeatState;
|
|
29
|
+
/** Clear the timer and delete the key for an immediate "down" on shutdown. */
|
|
30
|
+
stop(): Promise<void>;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Begin writing the Discord gateway-worker heartbeat. Writes once immediately,
|
|
34
|
+
* then refreshes every {@link REFRESH_MS} with a {@link TTL_SECONDS} expiry — so
|
|
35
|
+
* an ungraceful worker death is reflected as "down" within the TTL. The returned
|
|
36
|
+
* handle exposes `state.setGuildId(id)` (fold in the observed guild + write now)
|
|
37
|
+
* and `stop()` (clear the timer + delete the key for an immediate "down").
|
|
38
|
+
*/
|
|
39
|
+
export declare function startDiscordGatewayHeartbeat(logger: Logger): DiscordGatewayHeartbeatHandle;
|
|
40
|
+
/**
|
|
41
|
+
* Read the current Discord gateway-worker heartbeat. Resolves to
|
|
42
|
+
* `{ alive: false }` if the key is missing or Redis is unreachable. Tolerates a
|
|
43
|
+
* legacy plain-string value (treated as alive with no guild) so a reader can
|
|
44
|
+
* outlive a payload-shape change.
|
|
45
|
+
*/
|
|
46
|
+
export declare function getDiscordGatewayHeartbeat(): Promise<DiscordGatewayHeartbeat>;
|
|
47
|
+
//# sourceMappingURL=discord-gateway-heartbeat.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"discord-gateway-heartbeat.d.ts","sourceRoot":"","sources":["../../src/lib/discord-gateway-heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA0B1C,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD,4EAA4E;AAC5E,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,6BAA6B;IAC5C,iFAAiF;IACjF,KAAK,EAAE,4BAA4B,CAAC;IACpC,8EAA8E;IAC9E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,GACb,6BAA6B,CA2D/B;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAqBnF"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import type { DomainStatus, EmailProvider } from "@hogsend/core";
|
|
2
|
+
import type { env as envSchema } from "../env.js";
|
|
3
|
+
import type { Logger } from "./logger.js";
|
|
4
|
+
import { type SendingDomainGuidance } from "./sending-domain-guidance.js";
|
|
5
|
+
/**
|
|
6
|
+
* Per-send test-mode snapshot (PROJECT_SPEC pinned shape).
|
|
7
|
+
*
|
|
8
|
+
* F1 ships the FULL shape STUBBED INACTIVE — `testModeCached()` and the
|
|
9
|
+
* `testMode` block of `getStatus()` always return
|
|
10
|
+
* `{ active: false, reason: null, redirectTo: null, fromOverride: null }`.
|
|
11
|
+
* F3 test-mode-sends replaces this stub with the real env-flag +
|
|
12
|
+
* domain-unverified logic; every surface that renders the block (admin route,
|
|
13
|
+
* CLI, Studio) lights up with zero further changes.
|
|
14
|
+
*/
|
|
15
|
+
export interface TestModeState {
|
|
16
|
+
active: boolean;
|
|
17
|
+
reason: "env_flag" | "domain_unverified" | null;
|
|
18
|
+
/** HOGSEND_TEST_EMAIL ?? STUDIO_ADMIN_EMAIL ?? null (F3). */
|
|
19
|
+
redirectTo: string | null;
|
|
20
|
+
/** "onboarding@resend.dev" when providerId==="resend" && active (F3); else null. */
|
|
21
|
+
fromOverride: string | null;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* The engine-level domain snapshot every surface consumes: the admin route
|
|
25
|
+
* (`GET /v1/admin/domain`), the CLI (`hogsend domain status`), Studio's Setup
|
|
26
|
+
* view, and (cached, F3) the mailer's test-mode check.
|
|
27
|
+
*/
|
|
28
|
+
export interface EngineDomainStatus {
|
|
29
|
+
/**
|
|
30
|
+
* EMAIL_DOMAIN ?? host part of EMAIL_FROM (?? RESEND_FROM_EMAIL); `null`
|
|
31
|
+
* when underivable.
|
|
32
|
+
*/
|
|
33
|
+
domain: string | null;
|
|
34
|
+
providerId: string;
|
|
35
|
+
/** `!!provider.domains` — presence of the capability is the gate. */
|
|
36
|
+
supported: boolean;
|
|
37
|
+
/**
|
|
38
|
+
* Whether `provider.domains.setReturnPath` exists — the branded-return-path
|
|
39
|
+
* upgrade's own gate (PRD 20). Studio/CLI key the toggle off this so a
|
|
40
|
+
* provider without the method gets NO dead control; the POST would 501.
|
|
41
|
+
* Optional in the TYPE only for wire skew (an older engine never sends it,
|
|
42
|
+
* and clients ship separately from engines); this engine always sets it.
|
|
43
|
+
*/
|
|
44
|
+
returnPathSupported?: boolean;
|
|
45
|
+
/** `null` when `!supported || !domain` (the provider is never called then). */
|
|
46
|
+
status: DomainStatus | null;
|
|
47
|
+
testMode: TestModeState;
|
|
48
|
+
/** Static setup advice. Same words in Studio and the CLI, one source. */
|
|
49
|
+
guidance: SendingDomainGuidance;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Cached domain-status service. The per-send safety contract:
|
|
53
|
+
* `isVerifiedCached()`/`testModeCached()` are SYNC and cache-only (never await
|
|
54
|
+
* a provider call, never throw), and `refreshIfStale()` is fire-and-forget —
|
|
55
|
+
* so the mailer's hot path adds zero provider latency.
|
|
56
|
+
*/
|
|
57
|
+
export interface DomainStatusService {
|
|
58
|
+
/** `refresh: true` bypasses + busts the cache (admin `?refresh=true`, CLI `domain check`). */
|
|
59
|
+
getStatus(opts?: {
|
|
60
|
+
refresh?: boolean;
|
|
61
|
+
}): Promise<EngineDomainStatus>;
|
|
62
|
+
/**
|
|
63
|
+
* Cache-only, NEVER awaits a provider call, never throws. FAIL-OPEN: no
|
|
64
|
+
* cache entry / unknown ⇒ `true`, so a provider outage can never silently
|
|
65
|
+
* redirect production mail.
|
|
66
|
+
*/
|
|
67
|
+
isVerifiedCached(): boolean;
|
|
68
|
+
/** Sync snapshot for the per-send path (mailer). Cache-only. */
|
|
69
|
+
testModeCached(): TestModeState;
|
|
70
|
+
/**
|
|
71
|
+
* Fire-and-forget refresh when the cache is stale; called by the mailer per
|
|
72
|
+
* send and once at boot. Cheap no-op when fresh; concurrent refreshes are
|
|
73
|
+
* deduped; errors are swallowed + `logger.warn`ed.
|
|
74
|
+
*/
|
|
75
|
+
refreshIfStale(): void;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Build the cached {@link DomainStatusService} for the active email provider.
|
|
79
|
+
* In-memory cache ONLY (one process = one cache; the API and worker each keep
|
|
80
|
+
* their own) — no Redis dependency.
|
|
81
|
+
*/
|
|
82
|
+
export declare function createDomainStatusService(deps: {
|
|
83
|
+
provider: EmailProvider;
|
|
84
|
+
env: typeof envSchema;
|
|
85
|
+
logger: Logger;
|
|
86
|
+
}): DomainStatusService;
|
|
87
|
+
//# sourceMappingURL=domain-status.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"domain-status.d.ts","sourceRoot":"","sources":["../../src/lib/domain-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI,CAAC;IAChD,6DAA6D;IAC7D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+EAA+E;IAC/E,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,yEAAyE;IACzE,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,SAAS,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrE;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC;IAC5B,gEAAgE;IAChE,cAAc,IAAI,aAAa,CAAC;IAChC;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AAsGD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,EAAE,OAAO,SAAS,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,mBAAmB,CAkQtB"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { EmailProvider } from "@hogsend/core";
|
|
2
|
+
/**
|
|
3
|
+
* Container-held registry of email providers, keyed by `provider.meta.id`. The
|
|
4
|
+
* webhook route (`POST /v1/webhooks/email/:providerId`) resolves the verifying
|
|
5
|
+
* provider out of this registry via `c.get("container")`, and the container
|
|
6
|
+
* also picks ONE `active` provider out of it for the mailer.
|
|
7
|
+
*
|
|
8
|
+
* Deliberately NOT a process singleton: unlike the `DestinationRegistry`
|
|
9
|
+
* singleton — which exists only because the self-booting `deliverWebhookTask`
|
|
10
|
+
* has no container — both readers of this registry (the mailer the container
|
|
11
|
+
* constructs, and the webhook route which has the container) have a container
|
|
12
|
+
* reference, so the singleton + lazy-preset fallback would be dead weight.
|
|
13
|
+
*
|
|
14
|
+
* Keyed by `meta.id` with last-writer-wins, so a consumer-supplied provider of
|
|
15
|
+
* the same id overrides an env preset of that id.
|
|
16
|
+
*/
|
|
17
|
+
export declare class EmailProviderRegistry {
|
|
18
|
+
private byId;
|
|
19
|
+
constructor(providers?: EmailProvider[]);
|
|
20
|
+
/**
|
|
21
|
+
* Register (or replace) a provider. Falls back to `"resend"` for a provider
|
|
22
|
+
* built before `meta` existed (the contract keeps `meta` optional for
|
|
23
|
+
* back-compat). Last-writer-wins.
|
|
24
|
+
*/
|
|
25
|
+
register(provider: EmailProvider): void;
|
|
26
|
+
get(id: string): EmailProvider | undefined;
|
|
27
|
+
getAll(): EmailProvider[];
|
|
28
|
+
count(): number;
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=email-provider-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"email-provider-registry.d.ts","sourceRoot":"","sources":["../../src/lib/email-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,IAAI,CAAoC;gBAEpC,SAAS,GAAE,aAAa,EAAO;IAI3C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,MAAM,IAAI,aAAa,EAAE;IAIzB,KAAK,IAAI,MAAM;CAGhB"}
|