@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,23 @@
|
|
|
1
|
+
import type { DefinedFlag } from "@hogsend/core";
|
|
2
|
+
import type { Logger } from "./logger.js";
|
|
3
|
+
/**
|
|
4
|
+
* Registry of code-defined feature flags ({@link defineFlag}), the flag sibling
|
|
5
|
+
* of `ConversionRegistry`. Indexed by `meta.key`; a duplicate key warns and is
|
|
6
|
+
* skipped (first definition wins) so one fat-fingered copy-paste never silently
|
|
7
|
+
* shadows another flag. Constructed by `createHogsendClient` from `opts.flags`
|
|
8
|
+
* and installed on the process singleton so the boot reconciler + Studio can
|
|
9
|
+
* read it without a client reference.
|
|
10
|
+
*/
|
|
11
|
+
export declare class FlagRegistry {
|
|
12
|
+
private byKey;
|
|
13
|
+
constructor(definitions?: DefinedFlag[], logger?: Logger);
|
|
14
|
+
get(key: string): DefinedFlag | undefined;
|
|
15
|
+
has(key: string): boolean;
|
|
16
|
+
getAll(): DefinedFlag[];
|
|
17
|
+
count(): number;
|
|
18
|
+
}
|
|
19
|
+
export declare const setFlagRegistry: (value: FlagRegistry | undefined) => void;
|
|
20
|
+
export declare const getFlagRegistry: () => FlagRegistry | undefined;
|
|
21
|
+
/** Reset the singleton — only for test cleanup. */
|
|
22
|
+
export declare const resetFlagRegistry: () => void;
|
|
23
|
+
//# sourceMappingURL=flags-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flags-registry.d.ts","sourceRoot":"","sources":["../../src/lib/flags-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAkC;gBAEnC,WAAW,GAAE,WAAW,EAAO,EAAE,MAAM,CAAC,EAAE,MAAM;IAW5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,IAAI,WAAW,EAAE;IAIvB,KAAK,IAAI,MAAM;CAGhB;AAGD,eAAO,MAAM,eAAe,2CAAgB,CAAC;AAC7C,eAAO,MAAM,eAAe,gCAAgB,CAAC;AAC7C,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,YAAkB,CAAC"}
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import type { ConditionSet, FlagTargeting, FlagVariant, PropertyCondition } from "@hogsend/core";
|
|
2
|
+
import { type Database } from "@hogsend/db";
|
|
3
|
+
/**
|
|
4
|
+
* The structural subset of a flag the evaluator reads. Both the drizzle row
|
|
5
|
+
* (`flags.$inferSelect`) and the portable `FlagDefinition` (@hogsend/core)
|
|
6
|
+
* satisfy it, so the same pure function serves the DB path and any in-memory
|
|
7
|
+
* caller. `targeting` accepts BOTH the legacy `PropertyCondition[]` (implicit
|
|
8
|
+
* AND) and the condition tree ({@link FlagTargeting}); `conditionSets` is the
|
|
9
|
+
* richer ordered form (first matching set wins) and, when present, takes
|
|
10
|
+
* precedence over `targeting`+`rollout`.
|
|
11
|
+
*/
|
|
12
|
+
export interface EvaluableFlag {
|
|
13
|
+
key: string;
|
|
14
|
+
enabled: boolean;
|
|
15
|
+
type: string;
|
|
16
|
+
variants: FlagVariant[];
|
|
17
|
+
defaultValue: unknown;
|
|
18
|
+
targeting: FlagTargeting | PropertyCondition[];
|
|
19
|
+
rollout: number;
|
|
20
|
+
conditionSets?: ConditionSet[] | null;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* The FIXED, snapshot of the materialized contact state the pure targeting
|
|
24
|
+
* leaves read. Loaded ONCE per flag evaluation request (never per flag), so the
|
|
25
|
+
* browser `GET /v1/flags` hot path stays O(1) in the number of flags:
|
|
26
|
+
* - `properties` — the contact's stored properties (property leaves)
|
|
27
|
+
* - `email` — the contact's email, the key `email_engagement` scan leaves
|
|
28
|
+
* look up `email_sends` on (SERVER path only; `contactKey` is
|
|
29
|
+
* NOT an email, so without this the leaf never matches)
|
|
30
|
+
* - `buckets` — the ids of the contact's ACTIVE bucket memberships
|
|
31
|
+
* - `journeys` — per journey id, whether it is live (active/waiting) and/or
|
|
32
|
+
* has completed
|
|
33
|
+
* - `deals` — the contact's CRM deal posture (won/open + furthest stage)
|
|
34
|
+
*/
|
|
35
|
+
export interface TargetingSnapshot {
|
|
36
|
+
properties: Record<string, unknown>;
|
|
37
|
+
email: string | null;
|
|
38
|
+
buckets: Set<string>;
|
|
39
|
+
journeys: Map<string, {
|
|
40
|
+
active: boolean;
|
|
41
|
+
completed: boolean;
|
|
42
|
+
}>;
|
|
43
|
+
deals: {
|
|
44
|
+
won: boolean;
|
|
45
|
+
open: boolean;
|
|
46
|
+
stage: string | null;
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
/** An empty snapshot (anon contact / no materialized rows). */
|
|
50
|
+
export declare function emptySnapshot(properties?: Record<string, unknown>): TargetingSnapshot;
|
|
51
|
+
/**
|
|
52
|
+
* Load the FIXED ~4-query targeting snapshot for a contact. `contactId` is the
|
|
53
|
+
* trusted uuid: it scopes the property + deal reads (see
|
|
54
|
+
* `evaluateFlagsForContact`'s security note) AND, via `bySubject`, the bucket +
|
|
55
|
+
* journey history reads. `contactKey` (`external_id ?? anonymous_id ?? id`) is
|
|
56
|
+
* the fallback those two history reads use when NO contact is resolved — an
|
|
57
|
+
* anonymous visitor, whose rows are still text-keyed. An anon contact with no
|
|
58
|
+
* rows yields empty sets — correct (targeting-gated flags fall to default).
|
|
59
|
+
*/
|
|
60
|
+
export declare function loadTargetingSnapshot(opts: {
|
|
61
|
+
db: Database;
|
|
62
|
+
contactKey: string;
|
|
63
|
+
contactId?: string;
|
|
64
|
+
}): Promise<TargetingSnapshot>;
|
|
65
|
+
/**
|
|
66
|
+
* The context an async targeting evaluation runs in. `mode` gates the SERVER-
|
|
67
|
+
* ONLY scan leaves (`event`/`email_engagement`): they resolve via
|
|
68
|
+
* `evaluateCondition` ONLY when `mode==="server"` with `db`+`userId`, and
|
|
69
|
+
* short-circuit to `false` on the browser path (keeping the browser query count
|
|
70
|
+
* fixed — no per-flag DB access).
|
|
71
|
+
*/
|
|
72
|
+
export interface TargetingEvalContext {
|
|
73
|
+
snapshot: TargetingSnapshot;
|
|
74
|
+
mode: "browser" | "server";
|
|
75
|
+
db?: Database;
|
|
76
|
+
userId?: string;
|
|
77
|
+
/**
|
|
78
|
+
* The SERVER-TRUSTED `contacts.id` for `userId`, forwarded verbatim to
|
|
79
|
+
* `ConditionContext.contactId` so a scan leaf reads the PERSON's history
|
|
80
|
+
* rather than whatever the mutable `userId` text key happens to name. Absent
|
|
81
|
+
* / null for a subject with no contact (an anonymous visitor), which keeps
|
|
82
|
+
* the scan on the text key exactly as before.
|
|
83
|
+
*/
|
|
84
|
+
contactId?: string | null;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Fully evaluate a targeting node against the snapshot + mode. PURE leaves
|
|
88
|
+
* resolve from the snapshot; the SERVER-ONLY scan leaves resolve via
|
|
89
|
+
* `evaluateCondition` on the server path (else `false`); a COMPOSITE folds
|
|
90
|
+
* AND/OR (short-circuiting) over its children. A bare `PropertyCondition[]` is
|
|
91
|
+
* an implicit AND (empty ⇒ everyone); an empty COMPOSITE ⇒ everyone.
|
|
92
|
+
*/
|
|
93
|
+
export declare function evaluateTargeting(node: FlagTargeting | PropertyCondition[] | null | undefined, ctx: TargetingEvalContext): Promise<boolean>;
|
|
94
|
+
/**
|
|
95
|
+
* Deterministic percent bucket in [0, 100) from a string. Mirrors the holdout
|
|
96
|
+
* hashing law (sha256's first 4 bytes → uniform bucket): NO RNG and NO clock,
|
|
97
|
+
* so the same input buckets identically forever. A contact is IN a set's
|
|
98
|
+
* rollout when `bucket < set.rollout` (see {@link evaluateFlag}).
|
|
99
|
+
*/
|
|
100
|
+
export declare function flagBucket(input: string): number;
|
|
101
|
+
/**
|
|
102
|
+
* Deterministic unit in [0, 1) from a string — the weighted-variant selector.
|
|
103
|
+
* Same sha256-first-4-bytes construction as {@link flagBucket}, normalized over
|
|
104
|
+
* the full 32-bit range so the multivariate pick is uniform.
|
|
105
|
+
*/
|
|
106
|
+
export declare function flagUnit(input: string): number;
|
|
107
|
+
/**
|
|
108
|
+
* SYNC, browser-pure evaluation of a flag for a contact. PURE leaves
|
|
109
|
+
* (property/bucket/journey/deal) resolve from `snapshot` (or, back-compat, from
|
|
110
|
+
* bare `properties`); the SERVER-ONLY scan leaves (event/email_engagement)
|
|
111
|
+
* evaluate to `false`. STICKY by construction. Precedence — walk the ordered
|
|
112
|
+
* condition sets; the FIRST set whose targeting matches AND whose per-set
|
|
113
|
+
* rollout bucket ({@link rolloutKey}) admits the contact wins; otherwise
|
|
114
|
+
* `defaultValue`.
|
|
115
|
+
*/
|
|
116
|
+
export declare function evaluateFlag(flag: EvaluableFlag, ctx: {
|
|
117
|
+
contactKey: string;
|
|
118
|
+
properties: Record<string, unknown>;
|
|
119
|
+
snapshot?: TargetingSnapshot;
|
|
120
|
+
}): unknown;
|
|
121
|
+
/**
|
|
122
|
+
* Evaluate EVERY live (enabled, non-archived) flag for a contact and return the
|
|
123
|
+
* `{ key: value }` map. `contactKey` is the STICKY bucketing identity AND the
|
|
124
|
+
* key `bucket_memberships`/`journey_states`/`user_events` are read on; the
|
|
125
|
+
* SERVER-TRUSTED `contactId` (a resolved `contacts.id`, NEVER a re-resolved raw
|
|
126
|
+
* `contactKey`) scopes the property + deal reads — the same security boundary as
|
|
127
|
+
* before (a pk_ caller's raw `contactKey` must never load another contact's
|
|
128
|
+
* properties/deals).
|
|
129
|
+
*
|
|
130
|
+
* THE INVARIANT: the snapshot is loaded ONCE (a fixed ~4 indexed queries) and
|
|
131
|
+
* every flag evaluates against it, so the browser path issues a FIXED query
|
|
132
|
+
* count (flags query + snapshot) regardless of flag count. On `mode:"browser"`
|
|
133
|
+
* the server-only scan leaves (event/email_engagement) short-circuit to false —
|
|
134
|
+
* NO per-flag DB query runs. `mode:"server"` (the secret-key evaluate route)
|
|
135
|
+
* resolves those leaves via `evaluateCondition` keyed on `contactKey`.
|
|
136
|
+
*/
|
|
137
|
+
export declare function evaluateFlagsForContact(opts: {
|
|
138
|
+
db: Database;
|
|
139
|
+
contactKey: string;
|
|
140
|
+
contactId?: string;
|
|
141
|
+
mode: "browser" | "server";
|
|
142
|
+
}): Promise<Record<string, unknown>>;
|
|
143
|
+
//# sourceMappingURL=flags.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/lib/flags.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAGL,KAAK,QAAQ,EAId,MAAM,aAAa,CAAC;AAGrB;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,aAAa,GAAG,iBAAiB,EAAE,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/D,KAAK,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC9D;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACvC,iBAAiB,CAQnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,QAAQ,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsF7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AA6CD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,aAAa,GAAG,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC5D,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,OAAO,CAAC,CA0ClB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAeD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AA0CD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,GACA,OAAO,CAeT;AAiED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,EAAE,EAAE,QAAQ,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BnC"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { Database } from "@hogsend/db";
|
|
2
|
+
import type { FrequencyCapConfig } from "./email-service-types.js";
|
|
3
|
+
/**
|
|
4
|
+
* The windowed non-failed send count for a recipient — the COUNT behind
|
|
5
|
+
* {@link isFrequencyCapped}, shared with `ctx.throttle` (and later the suppress
|
|
6
|
+
* guard). Served by the `email_sends_freq_cap_idx (to_email, created_at,
|
|
7
|
+
* category)` index. Never-dispatched / failed rows (`status = 'failed'`) are
|
|
8
|
+
* excluded; a `category` narrows the count to that category.
|
|
9
|
+
*
|
|
10
|
+
* NOTE: NO exemption semantics live here — unlike {@link isFrequencyCapped}
|
|
11
|
+
* (which short-circuits an exempt "transactional" category), a `category` passed
|
|
12
|
+
* here genuinely counts that category's sends.
|
|
13
|
+
*/
|
|
14
|
+
export declare function countRecentSends(opts: {
|
|
15
|
+
db: Database;
|
|
16
|
+
to: string;
|
|
17
|
+
since: Date;
|
|
18
|
+
category?: string;
|
|
19
|
+
}): Promise<number>;
|
|
20
|
+
/**
|
|
21
|
+
* True if this recipient has hit the configured send cap within the window.
|
|
22
|
+
*
|
|
23
|
+
* - `config` undefined → false (feature is opt-in; safe default = no cap).
|
|
24
|
+
* - An exempt `category` (default "transactional") → false.
|
|
25
|
+
* - A `byCategory[category]` override uses its own count/window AND filters the
|
|
26
|
+
* COUNT by that category; otherwise the global rule counts ALL of the
|
|
27
|
+
* recipient's non-failed sends in the window (NULL-category rows included).
|
|
28
|
+
*
|
|
29
|
+
* The COUNT is served by `email_sends_freq_cap_idx (to_email, created_at,
|
|
30
|
+
* category)`. Never-dispatched / failed rows (`status = 'failed'`) are excluded.
|
|
31
|
+
*/
|
|
32
|
+
export declare function isFrequencyCapped(opts: {
|
|
33
|
+
db: Database;
|
|
34
|
+
to: string;
|
|
35
|
+
category?: string;
|
|
36
|
+
config?: FrequencyCapConfig;
|
|
37
|
+
}): Promise<boolean>;
|
|
38
|
+
//# sourceMappingURL=frequency-cap.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"frequency-cap.d.ts","sourceRoot":"","sources":["../../src/lib/frequency-cap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,EAAE,EAAE,QAAQ,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,EAAE,EAAE,QAAQ,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBnB"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* From-address helpers. A configured from address may be a bare addr-spec
|
|
3
|
+
* ("doug@hogsend.com") or carry a display name ("Doug at Hogsend
|
|
4
|
+
* <doug@hogsend.com>") — both are valid on the wire for every supported
|
|
5
|
+
* provider. These helpers parse either form so env validation and
|
|
6
|
+
* domain derivation agree on what the address part is.
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* Extract the addr-spec from a from address ("Doug <d@x.com>" → "d@x.com",
|
|
10
|
+
* "d@x.com" → "d@x.com"). Returns null when no valid address is present.
|
|
11
|
+
*/
|
|
12
|
+
export declare function addrSpecOf(value: string | undefined): string | null;
|
|
13
|
+
/** Host part of a from address ("Doug <d@x.com>" → "x.com"). */
|
|
14
|
+
export declare function hostOfFromAddress(value: string | undefined): string | null;
|
|
15
|
+
//# sourceMappingURL=from-address.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"from-address.d.ts","sourceRoot":"","sources":["../../src/lib/from-address.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKnE;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM1E"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { type Database } from "@hogsend/db";
|
|
2
|
+
import type { FunnelRegistry } from "./funnel-registry.js";
|
|
3
|
+
import type { Logger } from "./logger.js";
|
|
4
|
+
/**
|
|
5
|
+
* Event-funnel REPORTING projection —
|
|
6
|
+
* one first-reach row per (contact, funnel, stage), the raw material for
|
|
7
|
+
* progression counts ("how many reached activated") and velocity ("median
|
|
8
|
+
* time signed_up → activated"). Complements the deals projection the
|
|
9
|
+
* transition machinery (funnel-transitions.ts) maintains: deals hold ONE
|
|
10
|
+
* current stage + money timestamps; this holds every stage's first-reach
|
|
11
|
+
* instant, which is what progression rates and velocity medians read.
|
|
12
|
+
*
|
|
13
|
+
* Targets come from {@link resolveFunnelTargets} — the SAME gates and
|
|
14
|
+
* winner selection as the deal mover, so the two projections can never
|
|
15
|
+
* disagree about what counts as a stage event. `lost` is a deal outcome,
|
|
16
|
+
* not progress, and is skipped; the unique (contact, funnel, stage) index
|
|
17
|
+
* absorbs replays and repeats — `reachedAt` is FIRST reach by construction.
|
|
18
|
+
*/
|
|
19
|
+
export declare function recordFunnelProgressAtIngest(opts: {
|
|
20
|
+
db: Database;
|
|
21
|
+
logger: Logger;
|
|
22
|
+
funnels: FunnelRegistry | undefined;
|
|
23
|
+
event: {
|
|
24
|
+
name: string;
|
|
25
|
+
source: string | null;
|
|
26
|
+
properties: Record<string, unknown>;
|
|
27
|
+
value: number | null;
|
|
28
|
+
currency: string | null;
|
|
29
|
+
occurredAt: Date;
|
|
30
|
+
};
|
|
31
|
+
eventRowId: string;
|
|
32
|
+
contactId: string;
|
|
33
|
+
userKey: string;
|
|
34
|
+
}): Promise<{
|
|
35
|
+
reached: number;
|
|
36
|
+
}>;
|
|
37
|
+
//# sourceMappingURL=funnel-progress.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"funnel-progress.d.ts","sourceRoot":"","sources":["../../src/lib/funnel-progress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,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;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuC/B"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { DefinedFunnel, FunnelBinding, FunnelTransition } from "@hogsend/core";
|
|
2
|
+
/** A resolved claim: the owning funnel + the binding that matched (absent
|
|
3
|
+
* when traffic merely fell through to the default funnel). */
|
|
4
|
+
export interface ResolvedFunnelClaim {
|
|
5
|
+
funnel: DefinedFunnel;
|
|
6
|
+
binding?: FunnelBinding;
|
|
7
|
+
}
|
|
8
|
+
/** One event→stage rule bound to its owning funnel. */
|
|
9
|
+
export interface FunnelTransitionMatch {
|
|
10
|
+
funnel: DefinedFunnel;
|
|
11
|
+
transition: FunnelTransition;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Funnel routing (plan §5b.4): which funnel claims a stage event's
|
|
15
|
+
* (provider, pipeline). Claims come straight from each funnel's CRM
|
|
16
|
+
* `bindings` — an exact pipeline claim beats a provider-wide `"*"`.
|
|
17
|
+
* Overlapping claims are a boot error, not a runtime coin-flip. Events
|
|
18
|
+
* nobody claims fall back to the `"default"` funnel when one is registered
|
|
19
|
+
* (the `crm.{stages,stageMaps}` sugar synthesizes it).
|
|
20
|
+
*/
|
|
21
|
+
export declare class FunnelRegistry {
|
|
22
|
+
private byId;
|
|
23
|
+
/** `${provider}:${pipelineId}` (or `${provider}:*`) → funnel + binding. */
|
|
24
|
+
private claims;
|
|
25
|
+
/** Event name → the transitions (across funnels) it can fire. */
|
|
26
|
+
private transitions;
|
|
27
|
+
/** Trigger events wired to a quoted/won milestone stage. */
|
|
28
|
+
private milestoneTriggers;
|
|
29
|
+
constructor(funnels?: DefinedFunnel[]);
|
|
30
|
+
/** Event→stage rules listening on this event name (empty when none). */
|
|
31
|
+
transitionsFor(event: string): FunnelTransitionMatch[];
|
|
32
|
+
/**
|
|
33
|
+
* Trigger events wired to a money-milestone stage in ANY funnel. Their
|
|
34
|
+
* value is handed to the minted `deal.quoted`/`deal.sold`, so revenue
|
|
35
|
+
* rollups exclude the raw trigger rows (else one sale counts twice).
|
|
36
|
+
*/
|
|
37
|
+
milestoneTriggerEvents(): string[];
|
|
38
|
+
/** Route one stage event: exact pipeline claim → provider `"*"` → default. */
|
|
39
|
+
resolve(providerId: string, pipelineId: string | undefined): ResolvedFunnelClaim | undefined;
|
|
40
|
+
get(id: string): DefinedFunnel | undefined;
|
|
41
|
+
getAll(): DefinedFunnel[];
|
|
42
|
+
count(): number;
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=funnel-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"funnel-registry.d.ts","sourceRoot":"","sources":["../../src/lib/funnel-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB;8DAC8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAoC;IAChD,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAA0C;IACxD,iEAAiE;IACjE,OAAO,CAAC,WAAW,CAA8C;IACjE,4DAA4D;IAC5D,OAAO,CAAC,iBAAiB,CAAqB;gBAElC,OAAO,GAAE,aAAa,EAAO;IA+BzC,wEAAwE;IACxE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAItD;;;;OAIG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC,8EAA8E;IAC9E,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,mBAAmB,GAAG,SAAS;IAUlC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,MAAM,IAAI,aAAa,EAAE;IAIzB,KAAK,IAAI,MAAM;CAGhB"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
|
|
2
|
+
import type { AnalyticsProvider, DefinedFunnel } 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
|
+
* Event-driven funnel stage transitions — the step-(5d) ingest hook. For
|
|
9
|
+
* each funnel whose `on`/`lostOn` triggers match the just-stored event:
|
|
10
|
+
* trust-gate the source, evaluate the `where` conditions, pick the winning
|
|
11
|
+
* stage, and apply it to the contact's open deal in that funnel (one deal
|
|
12
|
+
* per contact per funnel, across producers — an open CRM-born row is moved
|
|
13
|
+
* in place; no open deal mints a synthetic `events`-provider row). Money
|
|
14
|
+
* milestones ride the same projection freshness as the CRM path, so
|
|
15
|
+
* whichever producer reaches a milestone first mints it.
|
|
16
|
+
*
|
|
17
|
+
* The triggering event IS already on the spine, so this path never ingests
|
|
18
|
+
* a `funnel.stage_changed` twin — it emits outbound only. Loop safety is
|
|
19
|
+
* define-time: `deal.`/`funnel.`/`crm.` events are rejected as triggers, so
|
|
20
|
+
* the money events this hook mints can never re-enter it.
|
|
21
|
+
*/
|
|
22
|
+
/**
|
|
23
|
+
* The gated, per-funnel WINNING stage targets for one event — source
|
|
24
|
+
* allowlist, `where` over money-overlaid properties, then the highest-ranked
|
|
25
|
+
* matching positive stage per funnel (`lost` only wins unopposed). Shared by
|
|
26
|
+
* the deal mover below and the `funnel_progress` reporting projection
|
|
27
|
+
* (funnel-progress.ts) so the two projections apply IDENTICAL rules and can
|
|
28
|
+
* never disagree about what counts as a stage event.
|
|
29
|
+
*/
|
|
30
|
+
export declare function resolveFunnelTargets(opts: {
|
|
31
|
+
funnels: FunnelRegistry;
|
|
32
|
+
event: {
|
|
33
|
+
name: string;
|
|
34
|
+
source: string | null;
|
|
35
|
+
properties: Record<string, unknown>;
|
|
36
|
+
value: number | null;
|
|
37
|
+
currency: string | null;
|
|
38
|
+
};
|
|
39
|
+
logger?: Logger;
|
|
40
|
+
}): Array<{
|
|
41
|
+
funnel: DefinedFunnel;
|
|
42
|
+
target: string;
|
|
43
|
+
}>;
|
|
44
|
+
export declare function applyFunnelTransitionsAtIngest(opts: {
|
|
45
|
+
db: Database;
|
|
46
|
+
registry: JourneyRegistry;
|
|
47
|
+
hatchet: HatchetClient;
|
|
48
|
+
logger: Logger;
|
|
49
|
+
analytics?: AnalyticsProvider;
|
|
50
|
+
funnels: FunnelRegistry;
|
|
51
|
+
event: {
|
|
52
|
+
name: string;
|
|
53
|
+
source: string | null;
|
|
54
|
+
properties: Record<string, unknown>;
|
|
55
|
+
value: number | null;
|
|
56
|
+
currency: string | null;
|
|
57
|
+
occurredAt: Date;
|
|
58
|
+
};
|
|
59
|
+
eventRowId: string;
|
|
60
|
+
contactId: string;
|
|
61
|
+
userKey: string;
|
|
62
|
+
}): Promise<void>;
|
|
63
|
+
//# sourceMappingURL=funnel-transitions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"funnel-transitions.d.ts","sourceRoot":"","sources":["../../src/lib/funnel-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,aAAa,CAAC;AAKnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;;;;;;;;;;GAcG;AACH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,cAAc,CAAC;IACxB,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;KACzB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgDnD;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,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,cAAc,CAAC;IACxB,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,IAAI,CAAC,CAgKhB"}
|
package/dist/lib/fx.d.ts
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
import type { FxRateProvider } from "@hogsend/core";
|
|
2
|
+
import type { Database } from "@hogsend/db";
|
|
3
|
+
import type { env as envSchema } from "../env.js";
|
|
4
|
+
import type { Logger } from "./logger.js";
|
|
5
|
+
/**
|
|
6
|
+
* Parse the `FX_RATES` env JSON into a quote→rate map. THROWS on anything
|
|
7
|
+
* malformed (bad JSON, non-object, non-finite or non-positive rates) — a
|
|
8
|
+
* typo'd rate sheet must fail the boot loudly, never silently convert money
|
|
9
|
+
* wrong (the same fail-loud posture as an unresolvable `EMAIL_PROVIDER`).
|
|
10
|
+
* Keys are uppercased so lookups never miss on case.
|
|
11
|
+
*/
|
|
12
|
+
export declare function parseFxRatesEnv(raw: string): Record<string, number>;
|
|
13
|
+
/**
|
|
14
|
+
* The sovereign default rate source: a fixed operator-supplied sheet, which
|
|
15
|
+
* is exactly the sovereignty trade: no network, no drift, rates change only
|
|
16
|
+
* when the operator changes them.
|
|
17
|
+
*
|
|
18
|
+
* THE HONESTY RULE: a static sheet is only meaningful against the ONE base
|
|
19
|
+
* it was quoted in (`quotedBase` — the env `BASE_CURRENCY` the operator's
|
|
20
|
+
* `FX_RATES` were written for). `getRates(base)` serves the sheet ONLY when
|
|
21
|
+
* `base === quotedBase` and resolves null for any other base — a USD-quoted
|
|
22
|
+
* sheet must never silently convert into EUR just because the effective base
|
|
23
|
+
* changed (e.g. via the Studio setting). A `quotedBase` of null (FX_RATES
|
|
24
|
+
* with no BASE_CURRENCY) is a base-less sheet: it serves null for EVERY
|
|
25
|
+
* base — inert, warned at boot in {@link fxProviderFromEnv}.
|
|
26
|
+
*/
|
|
27
|
+
export declare function createStaticFxProvider(opts: {
|
|
28
|
+
rates: Record<string, number>;
|
|
29
|
+
asOf?: string | null;
|
|
30
|
+
/** The base the sheet's rates are quoted against (null = base-less/inert). */
|
|
31
|
+
quotedBase: string | null;
|
|
32
|
+
}): FxRateProvider;
|
|
33
|
+
/**
|
|
34
|
+
* ECB daily reference rates via frankfurter.app, opt-in
|
|
35
|
+
* (`FX_PROVIDER=frankfurter`). ONE request serves every quote:
|
|
36
|
+
* `latest?from=<base>` returns base→quote rates (1 base = N quote) for all
|
|
37
|
+
* supported currencies, which we INVERT (quote→base = 1/N) — there is no
|
|
38
|
+
* `latest?to=<base>` batch form.
|
|
39
|
+
*
|
|
40
|
+
* Every successful fetch is upserted into `fx_rates`, and the cache is
|
|
41
|
+
* authoritative until it goes stale, so the API sees at most one call per
|
|
42
|
+
* staleness window and a day's conversions are pinned to one recorded sheet.
|
|
43
|
+
* Staleness is measured from `fetched_at`, NOT `as_of`: the ECB reference
|
|
44
|
+
* date legitimately freezes over weekends/holidays, so keying the refetch off
|
|
45
|
+
* `as_of` would re-hit the API on every request all weekend for rates that
|
|
46
|
+
* cannot have changed.
|
|
47
|
+
*
|
|
48
|
+
* FAIL-SOFT throughout: a failed/malformed fetch serves the last cached sheet
|
|
49
|
+
* when one exists, else resolves null. Nothing here ever throws into a
|
|
50
|
+
* request path.
|
|
51
|
+
*/
|
|
52
|
+
export declare function createFrankfurterFxProvider(opts: {
|
|
53
|
+
db: Database;
|
|
54
|
+
logger?: Logger;
|
|
55
|
+
/** Test seam — injected fetch. Defaults to the global. */
|
|
56
|
+
fetchImpl?: typeof fetch;
|
|
57
|
+
/** Refetch window in ms. Defaults to 24h (ECB publishes daily). */
|
|
58
|
+
maxAgeMs?: number;
|
|
59
|
+
}): FxRateProvider;
|
|
60
|
+
/**
|
|
61
|
+
* Resolve the ONE env-configured rate source, mirroring the env-preset spirit
|
|
62
|
+
* of `analyticsProvidersFromEnv` without the registry: `FX_PROVIDER=
|
|
63
|
+
* frankfurter` opts into the network source; otherwise a set `FX_RATES`
|
|
64
|
+
* builds the sovereign static sheet (throwing at boot on a malformed one);
|
|
65
|
+
* otherwise there is no source. A consumer `fx.provider` wins over this
|
|
66
|
+
* entirely (checked at the container call site).
|
|
67
|
+
*/
|
|
68
|
+
export declare function fxProviderFromEnv(env: typeof envSchema, deps: {
|
|
69
|
+
db: Database;
|
|
70
|
+
logger?: Logger;
|
|
71
|
+
}): FxRateProvider | undefined;
|
|
72
|
+
/**
|
|
73
|
+
* A resolved quote→base sheet, normalized for consumers: keys uppercased,
|
|
74
|
+
* non-usable rates dropped, and the identity rate (base→base = 1) injected so
|
|
75
|
+
* no reader special-cases the base currency. Carries the base it converts TO
|
|
76
|
+
* — a sheet is only meaningful relative to its base, so readers never have to
|
|
77
|
+
* pair it back up with the lens.
|
|
78
|
+
*/
|
|
79
|
+
export interface FxRatesToBase {
|
|
80
|
+
baseCurrency: string;
|
|
81
|
+
rates: Record<string, number>;
|
|
82
|
+
asOf: string | null;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* The minimal FX surface the container exposes (`client.fx`). The effective
|
|
86
|
+
* base currency is resolved PER CALL (never boot-frozen): the container's
|
|
87
|
+
* resolver walks code pin → Studio operator setting → env `BASE_CURRENCY`,
|
|
88
|
+
* so a base chosen/changed/cleared in Studio takes effect on the next
|
|
89
|
+
* request without a reboot. Null base = the lens is OFF: `getRatesToBase`
|
|
90
|
+
* resolves null and every consumer renders the unconverted truth, unchanged.
|
|
91
|
+
*/
|
|
92
|
+
export interface FxLens {
|
|
93
|
+
/** The active rate source's id (`meta.id`), or null when none is wired. */
|
|
94
|
+
providerId: string | null;
|
|
95
|
+
/**
|
|
96
|
+
* Resolve the operator's EFFECTIVE reporting currency (uppercased), or
|
|
97
|
+
* null when the lens is off. Fail-soft: a throwing resolver reads as off.
|
|
98
|
+
*/
|
|
99
|
+
getBaseCurrency(): Promise<string | null>;
|
|
100
|
+
/**
|
|
101
|
+
* Resolve the quote→base sheet from the active provider. Null when the
|
|
102
|
+
* lens is off, no provider is configured, or the provider has nothing to
|
|
103
|
+
* serve. NEVER throws — the lens is the fail-soft chokepoint even for a
|
|
104
|
+
* misbehaving BYO provider, so no request path needs its own guard.
|
|
105
|
+
*/
|
|
106
|
+
getRatesToBase(): Promise<FxRatesToBase | null>;
|
|
107
|
+
}
|
|
108
|
+
/** Build the container's {@link FxLens} from the base resolver + provider. */
|
|
109
|
+
export declare function createFxLens(opts: {
|
|
110
|
+
/**
|
|
111
|
+
* Resolves the effective base per call (the container builds it from the
|
|
112
|
+
* code pin / operator setting / env precedence). Null = lens off.
|
|
113
|
+
*/
|
|
114
|
+
resolveBaseCurrency: () => Promise<string | null>;
|
|
115
|
+
provider?: FxRateProvider;
|
|
116
|
+
logger: Logger;
|
|
117
|
+
}): FxLens;
|
|
118
|
+
//# sourceMappingURL=fx.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fx.d.ts","sourceRoot":"","sources":["../../src/lib/fx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgC1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,cAAc,CAmBjB;AAYD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CA4FjB;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,SAAS,EACrB,IAAI,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC,cAAc,GAAG,SAAS,CAsB5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,cAAc,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACjD;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA8CT"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import type { Database } from "@hogsend/db";
|
|
2
|
+
import { type LiftVerdict } from "./lift-stats.js";
|
|
3
|
+
/**
|
|
4
|
+
* Program-level global-control readout (impact-experiments spec D4.5e).
|
|
5
|
+
* Assignment lives only in env + hash (no assignment table), so the
|
|
6
|
+
* readout recomputes membership per contact as
|
|
7
|
+
* key = externalId ?? anonymousId ?? id, which is what
|
|
8
|
+
* isGlobalControl(options.userId ?? options.to) hashes at send time
|
|
9
|
+
* (lib/tracked.ts:245-246, lib/sms-tracked.ts:225-226) for JOURNEY sends —
|
|
10
|
+
* a journey's `userId` is the ingest-resolved key
|
|
11
|
+
* (event.userId ?? event.anonymousId, lib/ingestion.ts), so an
|
|
12
|
+
* anonymous-triggered journey hashes the same anonymousId the readout
|
|
13
|
+
* falls back to.
|
|
14
|
+
*
|
|
15
|
+
* DISCLOSED APPROXIMATION: two OTHER send paths resolve a different key and
|
|
16
|
+
* can disagree with the readout for a contact whose external_id is NULL but
|
|
17
|
+
* anonymous_id is set (the readout hashes anonymous_id; these paths hash the
|
|
18
|
+
* contact's UUID instead, never anonymous_id):
|
|
19
|
+
* - bare POST /v1/emails — regardless of whether the caller supplied a
|
|
20
|
+
* userId, the route always resolves the send's userId as
|
|
21
|
+
* recipient.externalId ?? recipient.contactId (routes/emails/index.ts),
|
|
22
|
+
* so it can never fall through to anonymous_id.
|
|
23
|
+
* - list-audience campaign broadcasts — the send-campaign cursor query
|
|
24
|
+
* resolves the same externalId ?? contactId fallback
|
|
25
|
+
* (workflows/send-campaign.ts), also never anonymous_id.
|
|
26
|
+
* Journey sends stay in parity with the readout (see above); the
|
|
27
|
+
* divergence is bounded to these two paths, so the fallback chain remains
|
|
28
|
+
* a reasonable, disclosed approximation for a mixed-population program —
|
|
29
|
+
* not a blanket "no userId" case.
|
|
30
|
+
*
|
|
31
|
+
* Converter outcomes aggregate ALL definitions (global control suppresses
|
|
32
|
+
* all non-transactional sends, so any registered conversion is a fair
|
|
33
|
+
* program-level outcome; no definitionId knob in v1). ITT caveat: this is
|
|
34
|
+
* a cross-sectional randomized comparison — outcome window
|
|
35
|
+
* occurred_at >= since for BOTH buckets; random assignment keeps it
|
|
36
|
+
* causal, window symmetry keeps it fair.
|
|
37
|
+
*/
|
|
38
|
+
/** In-request scan ceiling — above this the readout reports `skipped`
|
|
39
|
+
* (honest ceiling; a cached cron materialization is explicitly deferred). */
|
|
40
|
+
export declare const GLOBAL_CONTROL_SCAN_CEILING = 500000;
|
|
41
|
+
export type GlobalControlReadout = {
|
|
42
|
+
state: "off";
|
|
43
|
+
} | {
|
|
44
|
+
state: "skipped";
|
|
45
|
+
reason: "too_many_contacts";
|
|
46
|
+
percent: number;
|
|
47
|
+
contactCount: number;
|
|
48
|
+
} | ({
|
|
49
|
+
state: "computed";
|
|
50
|
+
causal: true;
|
|
51
|
+
percent: number;
|
|
52
|
+
contactsScanned: number;
|
|
53
|
+
treatment: {
|
|
54
|
+
contacts: number;
|
|
55
|
+
converters: number;
|
|
56
|
+
rate: number;
|
|
57
|
+
};
|
|
58
|
+
control: {
|
|
59
|
+
contacts: number;
|
|
60
|
+
converters: number;
|
|
61
|
+
rate: number;
|
|
62
|
+
};
|
|
63
|
+
} & LiftVerdict);
|
|
64
|
+
export declare function computeGlobalControlReadout(opts: {
|
|
65
|
+
db: Database;
|
|
66
|
+
since: Date;
|
|
67
|
+
/** Scan ceiling override — the route always uses the default; the
|
|
68
|
+
* parameter exists so the skipped state is testable. */
|
|
69
|
+
scanCeiling?: number;
|
|
70
|
+
batchSize?: number;
|
|
71
|
+
}): Promise<GlobalControlReadout>;
|
|
72
|
+
//# sourceMappingURL=global-control-readout.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"global-control-readout.d.ts","sourceRoot":"","sources":["../../src/lib/global-control-readout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;6EAC6E;AAC7E,eAAO,MAAM,2BAA2B,SAAU,CAAC;AAmCnD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,GAChB;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD,CAAC;IACC,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE,GAAG,WAAW,CAAC,CAAC;AAErB,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ;4DACwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+DhC"}
|