@hogsend/engine 0.66.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/container.ts +77 -0
- package/src/env.ts +30 -0
- package/src/index.ts +78 -0
- package/src/journeys/journey-log.ts +25 -8
- package/src/lib/contacts.ts +117 -1
- package/src/lib/email-service-types.ts +10 -0
- package/src/lib/ingestion.ts +91 -19
- package/src/lib/links.ts +94 -11
- 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 +150 -37
- package/src/lib/referral-intent.ts +723 -0
- package/src/lib/referral-link.ts +200 -0
- package/src/lib/referral-registry.ts +83 -0
- package/src/lib/referral-report.ts +739 -0
- package/src/lib/referral-runtime.ts +49 -0
- package/src/lib/referrals-no-emit.test.ts +109 -0
- package/src/lib/referrals.ts +712 -0
- 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/lib/webhook-signing.ts +10 -0
- 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 +153 -0
- package/src/routes/admin/index.ts +2 -0
- package/src/routes/admin/links.ts +14 -5
- package/src/routes/admin/referrals.ts +565 -0
- package/src/routes/admin/targeting.ts +6 -1
- package/src/routes/admin/webhooks.ts +4 -0
- package/src/routes/contacts/index.ts +78 -0
- package/src/routes/index.ts +104 -22
- package/src/routes/referrals/index.ts +41 -0
- package/src/routes/referrals/me.ts +123 -0
- package/src/routes/referrals/report.ts +285 -0
- package/src/routes/referrals/shared.ts +34 -0
- package/src/routes/referrals/touch.ts +313 -0
- package/src/routes/tracking/arrive.ts +90 -0
- package/src/routes/tracking/click-pipeline.ts +8 -0
- 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
package/src/lib/links.ts
CHANGED
|
@@ -16,9 +16,26 @@ import { and, eq, isNull, ne, or, sql } from "drizzle-orm";
|
|
|
16
16
|
* SHARE-SAFE INVARIANT: a link is identity-bearing (carries a `distinctId` the
|
|
17
17
|
* click can stitch + may mint a single-use `hs_t`) ONLY when `type: "personal"`
|
|
18
18
|
* AND an explicit `distinctId` is passed. A `"public"` link NEVER carries a
|
|
19
|
-
* person token
|
|
19
|
+
* person token - a shared/reshared public link attributes by campaign only.
|
|
20
|
+
* `"shared"` (a referral link) is owned by a person and clicked by SOMEONE
|
|
21
|
+
* ELSE, so it sits on the PUBLIC side of that invariant: it attributes to
|
|
22
|
+
* `ownerContactId` and stitches nobody.
|
|
20
23
|
*/
|
|
21
|
-
export type LinkType = "personal" | "public";
|
|
24
|
+
export type LinkType = "personal" | "public" | "shared";
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Thrown when the `shared` link ownership invariant is broken (PRD 05 5.2):
|
|
28
|
+
* a `shared` link with no `ownerContactId` credits nobody, and an
|
|
29
|
+
* `ownerContactId` on a `personal`/`public` link is a silent no-op that reads
|
|
30
|
+
* as if attribution were configured. Both are authoring errors, so they throw
|
|
31
|
+
* at mint time rather than minting a link that quietly does nothing.
|
|
32
|
+
*/
|
|
33
|
+
export class LinkOwnershipError extends Error {
|
|
34
|
+
constructor(message: string) {
|
|
35
|
+
super(message);
|
|
36
|
+
this.name = "LinkOwnershipError";
|
|
37
|
+
}
|
|
38
|
+
}
|
|
22
39
|
|
|
23
40
|
export interface MintLinkOptions {
|
|
24
41
|
db: Database;
|
|
@@ -28,8 +45,22 @@ export interface MintLinkOptions {
|
|
|
28
45
|
baseUrl: string;
|
|
29
46
|
/** Originating channel: "studio" | "discord" | "sms" | "referral" | … (open). */
|
|
30
47
|
source: string;
|
|
31
|
-
/**
|
|
48
|
+
/**
|
|
49
|
+
* "personal" (1:1, identity-bearing) | "public" (shareable) | "shared"
|
|
50
|
+
* (owned by a person, clicked by others - a referral link). Default
|
|
51
|
+
* "public".
|
|
52
|
+
*/
|
|
32
53
|
type?: LinkType;
|
|
54
|
+
/**
|
|
55
|
+
* The contact this link earns credit FOR. REQUIRED for `type: "shared"`,
|
|
56
|
+
* forbidden on `personal`/`public` (see {@link LinkOwnershipError}).
|
|
57
|
+
*
|
|
58
|
+
* This is an ATTRIBUTION field, never an identity one: it is deliberately
|
|
59
|
+
* not `distinctId`, because a referral link's clicker must never be stitched
|
|
60
|
+
* to its owner. Reusing `personal` for this would identify every referee AS
|
|
61
|
+
* the referrer, which is precisely the share-safe invariant's failure mode.
|
|
62
|
+
*/
|
|
63
|
+
ownerContactId?: string;
|
|
33
64
|
/** Operator-facing name (Studio list). */
|
|
34
65
|
label?: string;
|
|
35
66
|
/**
|
|
@@ -40,8 +71,16 @@ export interface MintLinkOptions {
|
|
|
40
71
|
/** UTM-style campaign grouping (public links). */
|
|
41
72
|
campaign?: string;
|
|
42
73
|
/**
|
|
43
|
-
* The
|
|
44
|
-
*
|
|
74
|
+
* The `defineReferral` id this link belongs to (`getReferralLink` sets it).
|
|
75
|
+
* Stored on the row so a CLICK can find the DEFINITION that owns it - the
|
|
76
|
+
* hooks, the bind window and the qualify rule - without inferring it from
|
|
77
|
+
* `campaign`, which is operator-facing grouping and may be absent or shared.
|
|
78
|
+
*/
|
|
79
|
+
referralId?: string;
|
|
80
|
+
/**
|
|
81
|
+
* The canonical contact key a click should stitch - honoured ONLY for
|
|
82
|
+
* `type: "personal"`; dropped for public AND shared links (the share-safe
|
|
83
|
+
* invariant).
|
|
45
84
|
*/
|
|
46
85
|
distinctId?: string;
|
|
47
86
|
/** The admin actor who minted it (Studio). */
|
|
@@ -81,6 +120,10 @@ export interface MintedLink {
|
|
|
81
120
|
slug: string | null;
|
|
82
121
|
/** The vanity short URL (`${baseUrl}/l/:slug`), if a slug was minted. */
|
|
83
122
|
vanityUrl: string | null;
|
|
123
|
+
/** The link's type, as stored. */
|
|
124
|
+
type: LinkType;
|
|
125
|
+
/** The credited owner for a `shared` link; null for personal/public. */
|
|
126
|
+
ownerContactId: string | null;
|
|
84
127
|
/**
|
|
85
128
|
* True when the mint RECOVERED an existing live link (same slug or
|
|
86
129
|
* idempotencyKey + same destination) instead of inserting a new one.
|
|
@@ -290,7 +333,12 @@ export function assertHttpUrl(url: string): void {
|
|
|
290
333
|
async function recoverExistingLink(
|
|
291
334
|
db: Database,
|
|
292
335
|
baseUrl: string,
|
|
293
|
-
row: {
|
|
336
|
+
row: {
|
|
337
|
+
id: string;
|
|
338
|
+
slug: string | null;
|
|
339
|
+
type: string;
|
|
340
|
+
ownerContactId: string | null;
|
|
341
|
+
},
|
|
294
342
|
): Promise<MintedLink | null> {
|
|
295
343
|
const [tracked] = await db
|
|
296
344
|
.select({ id: sql<string | null>`min(${trackedLinks.id}::text)` })
|
|
@@ -304,6 +352,8 @@ async function recoverExistingLink(
|
|
|
304
352
|
url: `${baseUrl}/v1/t/c/${trackedLinkId}`,
|
|
305
353
|
slug: row.slug,
|
|
306
354
|
vanityUrl: row.slug ? vanityUrlFor(baseUrl, row.slug) : null,
|
|
355
|
+
type: row.type as LinkType,
|
|
356
|
+
ownerContactId: row.ownerContactId,
|
|
307
357
|
existing: true,
|
|
308
358
|
};
|
|
309
359
|
}
|
|
@@ -314,7 +364,25 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
|
|
|
314
364
|
throw new Error("mintLink: slug and idempotencyKey are mutually exclusive");
|
|
315
365
|
}
|
|
316
366
|
const type: LinkType = opts.type ?? "public";
|
|
317
|
-
//
|
|
367
|
+
// THE OWNERSHIP INVARIANT (PRD 05 5.2). Loud at mint time, because both
|
|
368
|
+
// halves fail SILENTLY otherwise: an unowned shared link records touches
|
|
369
|
+
// that credit nobody, and an owner set on a public link looks like
|
|
370
|
+
// attribution is wired when nothing reads it.
|
|
371
|
+
const ownerContactId = opts.ownerContactId ?? null;
|
|
372
|
+
if (type === "shared" && !ownerContactId) {
|
|
373
|
+
throw new LinkOwnershipError(
|
|
374
|
+
'mintLink: type "shared" requires ownerContactId - a shared link is ' +
|
|
375
|
+
"owned by the person it credits",
|
|
376
|
+
);
|
|
377
|
+
}
|
|
378
|
+
if (type !== "shared" && ownerContactId) {
|
|
379
|
+
throw new LinkOwnershipError(
|
|
380
|
+
`mintLink: ownerContactId is only valid for type "shared", got "${type}"`,
|
|
381
|
+
);
|
|
382
|
+
}
|
|
383
|
+
// Only a PERSONAL link carries a person token. A public link must never
|
|
384
|
+
// carry one, and neither must a shared link: it is clicked by someone other
|
|
385
|
+
// than its owner, so stitching would identify every referee as the referrer.
|
|
318
386
|
const distinctId = type === "personal" ? (opts.distinctId ?? null) : null;
|
|
319
387
|
const slug = opts.slug !== undefined ? normalizeSlug(opts.slug) : null;
|
|
320
388
|
|
|
@@ -335,8 +403,10 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
|
|
|
335
403
|
description: opts.description ?? null,
|
|
336
404
|
appendRef: opts.appendRef ?? false,
|
|
337
405
|
campaign: opts.campaign ?? null,
|
|
406
|
+
referralId: opts.referralId ?? null,
|
|
338
407
|
source: opts.source,
|
|
339
408
|
distinctId,
|
|
409
|
+
ownerContactId,
|
|
340
410
|
createdBy: opts.createdBy ?? null,
|
|
341
411
|
idempotencyKey: opts.idempotencyKey ?? null,
|
|
342
412
|
});
|
|
@@ -360,13 +430,19 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
|
|
|
360
430
|
.from(links)
|
|
361
431
|
.where(and(eq(links.slug, slug), isNull(links.archivedAt)))
|
|
362
432
|
.limit(1);
|
|
363
|
-
if (
|
|
433
|
+
if (
|
|
434
|
+
row &&
|
|
435
|
+
row.originalUrl === opts.url &&
|
|
436
|
+
row.type === type &&
|
|
437
|
+
row.ownerContactId === ownerContactId
|
|
438
|
+
) {
|
|
364
439
|
const recovered = await recoverExistingLink(opts.db, opts.baseUrl, row);
|
|
365
440
|
if (recovered) return recovered;
|
|
366
441
|
}
|
|
367
442
|
// Slug held by an ARCHIVED link (the live lookup misses — archived
|
|
368
|
-
// links keep their slug reserved), a different destination,
|
|
369
|
-
// different type
|
|
443
|
+
// links keep their slug reserved), a different destination, a
|
|
444
|
+
// different type, or a different owner (two referrers whose slugFrom
|
|
445
|
+
// collide must NOT share one link) → conflict.
|
|
370
446
|
throw new SlugTakenError(slug);
|
|
371
447
|
}
|
|
372
448
|
if (opts.idempotencyKey && isIdempotencyKeyViolation(err)) {
|
|
@@ -380,7 +456,12 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
|
|
|
380
456
|
),
|
|
381
457
|
)
|
|
382
458
|
.limit(1);
|
|
383
|
-
if (
|
|
459
|
+
if (
|
|
460
|
+
row &&
|
|
461
|
+
row.originalUrl === opts.url &&
|
|
462
|
+
row.type === type &&
|
|
463
|
+
row.ownerContactId === ownerContactId
|
|
464
|
+
) {
|
|
384
465
|
const recovered = await recoverExistingLink(opts.db, opts.baseUrl, row);
|
|
385
466
|
if (recovered) return recovered;
|
|
386
467
|
}
|
|
@@ -398,6 +479,8 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
|
|
|
398
479
|
url: `${opts.baseUrl}/v1/t/c/${trackedLinkId}`,
|
|
399
480
|
slug,
|
|
400
481
|
vanityUrl: slug ? vanityUrlFor(opts.baseUrl, slug) : null,
|
|
482
|
+
type,
|
|
483
|
+
ownerContactId,
|
|
401
484
|
existing: false,
|
|
402
485
|
};
|
|
403
486
|
}
|
|
@@ -16,6 +16,7 @@ process.env.BETTER_AUTH_SECRET ??= "test-secret";
|
|
|
16
16
|
process.env.HATCHET_CLIENT_TOKEN ??=
|
|
17
17
|
"eyJhbGciOiJFUzI1NiIsImtpZCI6InRlc3QifQ.eyJhdWQiOiJsb2NhbGhvc3QiLCJleHAiOjQ5MzMyNDA5ODMsImdycGNfYnJvYWRjYXN0X2FkZHJlc3MiOiJsb2NhbGhvc3Q6NzA3NyIsImlhdCI6MTc3OTY0MDk4MywiaXNzIjoibG9jYWxob3N0Iiwic2VydmVyX3VybCI6ImxvY2FsaG9zdCIsInN1YiI6InRlc3QtdGVuYW50LWlkIiwidG9rZW5faWQiOiJ0ZXN0LXRva2VuLWlkIn0.test";
|
|
18
18
|
const { createTrackedMailer } = await import("./mailer.js");
|
|
19
|
+
const { WEBHOOK_EVENT_TYPES } = await import("./webhook-signing.js");
|
|
19
20
|
|
|
20
21
|
/**
|
|
21
22
|
* BOUNCE IDEMPOTENCY.
|
|
@@ -203,8 +204,12 @@ function fakeDb(rows: FakeSend[]): FakeDb {
|
|
|
203
204
|
),
|
|
204
205
|
}),
|
|
205
206
|
}),
|
|
206
|
-
// One subscribed
|
|
207
|
-
|
|
207
|
+
// One endpoint subscribed to every event, so the spine has
|
|
208
|
+
// somewhere to deliver whatever the path emits.
|
|
209
|
+
where: () =>
|
|
210
|
+
Promise.resolve([
|
|
211
|
+
{ id: "endpoint-1", eventTypes: [...WEBHOOK_EVENT_TYPES] },
|
|
212
|
+
]),
|
|
208
213
|
};
|
|
209
214
|
},
|
|
210
215
|
};
|
|
@@ -15,6 +15,7 @@ process.env.BETTER_AUTH_SECRET ??= "test-secret";
|
|
|
15
15
|
process.env.HATCHET_CLIENT_TOKEN ??=
|
|
16
16
|
"eyJhbGciOiJFUzI1NiIsImtpZCI6InRlc3QifQ.eyJhdWQiOiJsb2NhbGhvc3QiLCJleHAiOjQ5MzMyNDA5ODMsImdycGNfYnJvYWRjYXN0X2FkZHJlc3MiOiJsb2NhbGhvc3Q6NzA3NyIsImlhdCI6MTc3OTY0MDk4MywiaXNzIjoibG9jYWxob3N0Iiwic2VydmVyX3VybCI6ImxvY2FsaG9zdCIsInN1YiI6InRlc3QtdGVuYW50LWlkIiwidG9rZW5faWQiOiJ0ZXN0LXRva2VuLWlkIn0.test";
|
|
17
17
|
const { createTrackedMailer } = await import("./mailer.js");
|
|
18
|
+
const { WEBHOOK_EVENT_TYPES } = await import("./webhook-signing.js");
|
|
18
19
|
|
|
19
20
|
/**
|
|
20
21
|
* `email.replied` handling (PRD 16 task 5).
|
|
@@ -128,8 +129,12 @@ function recordingDb(selectRows: SendRow[] = []): {
|
|
|
128
129
|
leftJoin: () => ({
|
|
129
130
|
where: () => ({ limit: () => Promise.resolve(selectRows) }),
|
|
130
131
|
}),
|
|
131
|
-
// One subscribed
|
|
132
|
-
|
|
132
|
+
// One endpoint subscribed to every event, so the spine has
|
|
133
|
+
// somewhere to deliver whatever the path emits.
|
|
134
|
+
where: () =>
|
|
135
|
+
Promise.resolve([
|
|
136
|
+
{ id: "endpoint-1", eventTypes: [...WEBHOOK_EVENT_TYPES] },
|
|
137
|
+
]),
|
|
133
138
|
};
|
|
134
139
|
},
|
|
135
140
|
};
|
package/src/lib/mailer.ts
CHANGED
|
@@ -224,6 +224,7 @@ export function createTrackedMailer(
|
|
|
224
224
|
subject: options.subject,
|
|
225
225
|
journeyStateId: options.journeyStateId,
|
|
226
226
|
campaignId: options.campaignId,
|
|
227
|
+
contactId: options.contactId,
|
|
227
228
|
userId: options.userId,
|
|
228
229
|
userEmail: options.userEmail,
|
|
229
230
|
category: options.category,
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { type Database, webhookEndpoints } from "@hogsend/db";
|
|
2
|
+
import { and, eq, isNull } from "drizzle-orm";
|
|
3
|
+
|
|
4
|
+
/** How long the enabled-endpoint list is reused before a re-read. */
|
|
5
|
+
const DEFAULT_ENDPOINT_CACHE_TTL_MS = 30_000;
|
|
6
|
+
|
|
7
|
+
interface CachedEndpoint {
|
|
8
|
+
id: string;
|
|
9
|
+
eventTypes: string[];
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
interface CacheEntry {
|
|
13
|
+
rows: CachedEndpoint[];
|
|
14
|
+
loadedAt: number;
|
|
15
|
+
generation: number;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
// One entry per database client, so two databases in one process (tests,
|
|
19
|
+
// a multi-database host) never read each other's endpoints.
|
|
20
|
+
const endpointCache = new WeakMap<Database, CacheEntry>();
|
|
21
|
+
// Bumped by every invalidation. An entry from an older generation is ignored,
|
|
22
|
+
// and a read that started before an admin write can't put the pre-write list
|
|
23
|
+
// back into the cache when it finishes.
|
|
24
|
+
let endpointCacheGeneration = 0;
|
|
25
|
+
|
|
26
|
+
function endpointCacheTtlMs(): number {
|
|
27
|
+
const raw = process.env.OUTBOUND_ENDPOINT_CACHE_TTL_MS;
|
|
28
|
+
if (raw === undefined || raw === "") return DEFAULT_ENDPOINT_CACHE_TTL_MS;
|
|
29
|
+
const ttl = Number(raw);
|
|
30
|
+
return Number.isFinite(ttl) && ttl >= 0 ? ttl : DEFAULT_ENDPOINT_CACHE_TTL_MS;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Drop the cached endpoint list so the next emit re-reads `webhook_endpoints`.
|
|
35
|
+
* Every engine writer of that table calls this (the admin webhook routes and
|
|
36
|
+
* the PostHog destination seed). It only clears THIS process: another API
|
|
37
|
+
* instance or the worker picks the change up when its own copy expires
|
|
38
|
+
* (`OUTBOUND_ENDPOINT_CACHE_TTL_MS`, default 30 s). A disabled or deleted
|
|
39
|
+
* endpoint, or an event it was just unsubscribed from, is still never sent to
|
|
40
|
+
* inside that window: the delivery task re-reads the endpoint row before every
|
|
41
|
+
* attempt. `emitOutbound` retries once on the foreign-key error a deleted
|
|
42
|
+
* cached endpoint causes, so the other endpoints keep their delivery.
|
|
43
|
+
*/
|
|
44
|
+
export function invalidateOutboundEndpointCache(): void {
|
|
45
|
+
endpointCacheGeneration += 1;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Every enabled single-tenant endpoint with its subscriptions, read at most
|
|
50
|
+
* once per TTL. The per-event filter runs in memory: an install has a handful
|
|
51
|
+
* of endpoints, and this saves a query on every outbound emit.
|
|
52
|
+
*/
|
|
53
|
+
export async function loadSubscribableEndpoints(
|
|
54
|
+
db: Database,
|
|
55
|
+
): Promise<CachedEndpoint[]> {
|
|
56
|
+
const ttl = endpointCacheTtlMs();
|
|
57
|
+
const now = Date.now();
|
|
58
|
+
const cached = ttl > 0 ? endpointCache.get(db) : undefined;
|
|
59
|
+
if (
|
|
60
|
+
cached &&
|
|
61
|
+
cached.generation === endpointCacheGeneration &&
|
|
62
|
+
now - cached.loadedAt < ttl
|
|
63
|
+
) {
|
|
64
|
+
return cached.rows;
|
|
65
|
+
}
|
|
66
|
+
const generation = endpointCacheGeneration;
|
|
67
|
+
const rows = await db
|
|
68
|
+
.select({
|
|
69
|
+
id: webhookEndpoints.id,
|
|
70
|
+
eventTypes: webhookEndpoints.eventTypes,
|
|
71
|
+
})
|
|
72
|
+
.from(webhookEndpoints)
|
|
73
|
+
.where(
|
|
74
|
+
and(
|
|
75
|
+
eq(webhookEndpoints.disabled, false),
|
|
76
|
+
isNull(webhookEndpoints.organizationId),
|
|
77
|
+
),
|
|
78
|
+
);
|
|
79
|
+
if (ttl > 0 && generation === endpointCacheGeneration) {
|
|
80
|
+
endpointCache.set(db, { rows, loadedAt: now, generation });
|
|
81
|
+
}
|
|
82
|
+
return rows;
|
|
83
|
+
}
|
package/src/lib/outbound.ts
CHANGED
|
@@ -1,14 +1,13 @@
|
|
|
1
1
|
import { randomUUID } from "node:crypto";
|
|
2
2
|
import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
|
|
3
|
-
import {
|
|
4
|
-
type Database,
|
|
5
|
-
webhookDeliveries,
|
|
6
|
-
webhookEndpoints,
|
|
7
|
-
} from "@hogsend/db";
|
|
8
|
-
import { and, eq, isNull, sql } from "drizzle-orm";
|
|
3
|
+
import { type Database, webhookDeliveries } from "@hogsend/db";
|
|
9
4
|
import { deliverWebhookTask } from "../workflows/deliver-webhook.js";
|
|
10
5
|
import type { SerializedContact } from "./contacts.js";
|
|
11
6
|
import type { Logger } from "./logger.js";
|
|
7
|
+
import {
|
|
8
|
+
invalidateOutboundEndpointCache,
|
|
9
|
+
loadSubscribableEndpoints,
|
|
10
|
+
} from "./outbound-endpoint-cache.js";
|
|
12
11
|
import {
|
|
13
12
|
WEBHOOK_EVENT_TYPES,
|
|
14
13
|
type WebhookEventType,
|
|
@@ -28,6 +27,16 @@ export {
|
|
|
28
27
|
resolveEmailSendContextByResendId,
|
|
29
28
|
} from "./tracking-events.js";
|
|
30
29
|
|
|
30
|
+
/** Postgres `foreign_key_violation`; drizzle nests the driver error in `cause`. */
|
|
31
|
+
function isForeignKeyViolation(error: unknown): boolean {
|
|
32
|
+
for (let e = error, depth = 0; e && depth < 5; depth++) {
|
|
33
|
+
const candidate = e as { code?: string; cause?: unknown };
|
|
34
|
+
if (candidate.code === "23503") return true;
|
|
35
|
+
e = candidate.cause;
|
|
36
|
+
}
|
|
37
|
+
return false;
|
|
38
|
+
}
|
|
39
|
+
|
|
31
40
|
/**
|
|
32
41
|
* The outbound event catalog re-exported for the emit spine. Identical to the
|
|
33
42
|
* signing lib's {@link WEBHOOK_EVENT_TYPES} — the single source of truth.
|
|
@@ -318,6 +327,51 @@ export interface OutboundPayloads {
|
|
|
318
327
|
userEmail: string;
|
|
319
328
|
heldOutAt: string;
|
|
320
329
|
};
|
|
330
|
+
/**
|
|
331
|
+
* A referral EDGE reached its first end: someone clicked a `shared` link and
|
|
332
|
+
* landed. `refereeContactId` is NULL on the (normal) cold path — the referee
|
|
333
|
+
* is a browser id, not yet a person — which is exactly why this event names
|
|
334
|
+
* only the REFERRER as its subject and mints no contact.
|
|
335
|
+
*/
|
|
336
|
+
"referral.touched": ReferralTouchPayload;
|
|
337
|
+
/**
|
|
338
|
+
* The edge gained its second end: the referee identified and
|
|
339
|
+
* `adoptOrphanHistory` stamped the touch. Delivered ONCE per touch (one
|
|
340
|
+
* dedupe key), and re-ingested onto the journey bus for BOTH ends.
|
|
341
|
+
*/
|
|
342
|
+
"referral.bound": ReferralTouchPayload & { boundAt: string; side: string };
|
|
343
|
+
/**
|
|
344
|
+
* A bound referee did the thing the program asked for (`qualify.event`, with
|
|
345
|
+
* optional `where`). Exactly once per touch — the store's
|
|
346
|
+
* `qualified_at IS NULL` predicate is the guard.
|
|
347
|
+
*/
|
|
348
|
+
"referral.qualified": ReferralTouchPayload & {
|
|
349
|
+
event: string | null;
|
|
350
|
+
conversionId: string | null;
|
|
351
|
+
qualifiedAt: string;
|
|
352
|
+
side: string;
|
|
353
|
+
};
|
|
354
|
+
/** A referee converted; the DIRECT referrer is told (`level` is always 1). */
|
|
355
|
+
"referral.converted": ReferralConversionPayload;
|
|
356
|
+
/**
|
|
357
|
+
* An ANCESTOR above the direct referrer is told about the same conversion,
|
|
358
|
+
* one delivery per hop to depth 5. `level` is a FACT on the event: a reward
|
|
359
|
+
* journey filters with `trigger.where: (b) => b.prop("level").eq(1)`, and
|
|
360
|
+
* that is the only place levels appear in code. Depth and weights stay
|
|
361
|
+
* report-time parameters.
|
|
362
|
+
*/
|
|
363
|
+
"referral.tree_converted": ReferralConversionPayload;
|
|
364
|
+
/**
|
|
365
|
+
* An edge was refused — `self` (the referee turned out to BE the referrer,
|
|
366
|
+
* which falls out of the identity merge rather than a fraud heuristic),
|
|
367
|
+
* `window` (the touch was older than `bindWindow` at identify),
|
|
368
|
+
* `duplicate`, or `veto` (a `before*` hook said no; its free text rides
|
|
369
|
+
* `detail`).
|
|
370
|
+
*/
|
|
371
|
+
"referral.rejected": ReferralTouchPayload & {
|
|
372
|
+
reason: string | null;
|
|
373
|
+
detail?: string | null;
|
|
374
|
+
};
|
|
321
375
|
/**
|
|
322
376
|
* Weekly impact digest (impact experiments D5) — facts-only rollup of
|
|
323
377
|
* shipped journey changes and holdout-lift threshold crossings, emitted
|
|
@@ -569,6 +623,55 @@ export interface ImpactDigestLiftEntry {
|
|
|
569
623
|
smallSample: boolean;
|
|
570
624
|
}
|
|
571
625
|
|
|
626
|
+
/**
|
|
627
|
+
* The shared shape of every touch-scoped referral event. Scalars only: these
|
|
628
|
+
* payloads double as the journey-bus `eventProperties`, and `ingestEvent`
|
|
629
|
+
* filters the Hatchet push down to `string | number | boolean | null`, so a
|
|
630
|
+
* nested field would be silently dropped between `user_events` and the journey
|
|
631
|
+
* (and a `where` clause naming it would never match).
|
|
632
|
+
*/
|
|
633
|
+
export type ReferralTouchPayload = {
|
|
634
|
+
referralId: string;
|
|
635
|
+
touchId: string;
|
|
636
|
+
referrerContactId: string;
|
|
637
|
+
/** NULL until the edge binds. */
|
|
638
|
+
refereeContactId: string | null;
|
|
639
|
+
/** The canonical key at touch time — an ANONYMOUS id on a cold touch. */
|
|
640
|
+
refereeKey: string;
|
|
641
|
+
source: string;
|
|
642
|
+
linkId: string | null;
|
|
643
|
+
clickId: string | null;
|
|
644
|
+
status: string;
|
|
645
|
+
/** ISO 8601. */
|
|
646
|
+
touchedAt: string;
|
|
647
|
+
};
|
|
648
|
+
|
|
649
|
+
/** `referral.converted` / `referral.tree_converted`. */
|
|
650
|
+
export type ReferralConversionPayload = {
|
|
651
|
+
referralId: string;
|
|
652
|
+
touchId: string;
|
|
653
|
+
/** 1 = the direct referrer; 2+ = an ancestor. Capped at 5. */
|
|
654
|
+
level: number;
|
|
655
|
+
/** The contact being TOLD (who earns at this level). */
|
|
656
|
+
beneficiaryContactId: string;
|
|
657
|
+
/** The contact who actually converted. */
|
|
658
|
+
refereeContactId: string;
|
|
659
|
+
/** The next hop toward the referee — "your friend's friend". */
|
|
660
|
+
viaContactId: string;
|
|
661
|
+
conversionId: string;
|
|
662
|
+
/**
|
|
663
|
+
* The converted amount. NOT named `value`: this payload doubles verbatim as
|
|
664
|
+
* the journey-bus `eventProperties`, and a `value` there would fire the
|
|
665
|
+
* built-in wildcard `revenue` conversion (trigger `*` + `value > 0`) FOR THE
|
|
666
|
+
* BENEFICIARY - minting a phantom conversion on every ancestor and
|
|
667
|
+
* re-entering `convertReferral` up the whole chain.
|
|
668
|
+
*/
|
|
669
|
+
conversionValue: number | null;
|
|
670
|
+
currency: string | null;
|
|
671
|
+
/** ISO 8601. */
|
|
672
|
+
at: string;
|
|
673
|
+
};
|
|
674
|
+
|
|
572
675
|
export type ImpactDigestEntry =
|
|
573
676
|
| ImpactDigestShippedEntry
|
|
574
677
|
| ImpactDigestLiftEntry;
|
|
@@ -623,19 +726,14 @@ export async function emitOutbound<E extends OutboundEventName>(opts: {
|
|
|
623
726
|
const webhookId = `msg_${randomUUID()}`;
|
|
624
727
|
const timestamp = new Date();
|
|
625
728
|
|
|
626
|
-
// (2) Active, subscribed endpoints
|
|
627
|
-
//
|
|
628
|
-
//
|
|
629
|
-
const
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
.where(
|
|
633
|
-
and(
|
|
634
|
-
eq(webhookEndpoints.disabled, false),
|
|
635
|
-
isNull(webhookEndpoints.organizationId),
|
|
636
|
-
sql`${webhookEndpoints.eventTypes} @> ${JSON.stringify([event])}::jsonb`,
|
|
637
|
-
),
|
|
729
|
+
// (2) Active, subscribed endpoints, from the endpoint cache below.
|
|
730
|
+
// Single-tenant: organizationId IS NULL (NOT a hardcoded tenant — keeps the
|
|
731
|
+
// MT wiring non-breaking).
|
|
732
|
+
const subscribed = async () =>
|
|
733
|
+
(await loadSubscribableEndpoints(db)).filter((endpoint) =>
|
|
734
|
+
endpoint.eventTypes.includes(event),
|
|
638
735
|
);
|
|
736
|
+
let endpoints = await subscribed();
|
|
639
737
|
|
|
640
738
|
if (endpoints.length === 0) return;
|
|
641
739
|
|
|
@@ -649,25 +747,40 @@ export async function emitOutbound<E extends OutboundEventName>(opts: {
|
|
|
649
747
|
|
|
650
748
|
// (4) One delivery row per endpoint, sharing the webhookId. onConflictDoNothing
|
|
651
749
|
// on (endpointId, dedupeKey) is the producer-side fan-out idempotency guard.
|
|
652
|
-
const
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
750
|
+
const insertDeliveries = (targets: typeof endpoints) =>
|
|
751
|
+
db
|
|
752
|
+
.insert(webhookDeliveries)
|
|
753
|
+
.values(
|
|
754
|
+
targets.map((endpoint) => ({
|
|
755
|
+
endpointId: endpoint.id,
|
|
756
|
+
organizationId,
|
|
757
|
+
webhookId,
|
|
758
|
+
eventType: event,
|
|
759
|
+
dedupeKey: dedupeKey ?? null,
|
|
760
|
+
payload: envelope as unknown as Record<string, unknown>,
|
|
761
|
+
status: "pending" as const,
|
|
762
|
+
attemptCount: 0,
|
|
763
|
+
nextRetryAt: timestamp,
|
|
764
|
+
})),
|
|
765
|
+
)
|
|
766
|
+
.onConflictDoNothing({
|
|
767
|
+
target: [webhookDeliveries.endpointId, webhookDeliveries.dedupeKey],
|
|
768
|
+
})
|
|
769
|
+
.returning({ id: webhookDeliveries.id });
|
|
770
|
+
|
|
771
|
+
let inserted: Awaited<ReturnType<typeof insertDeliveries>>;
|
|
772
|
+
try {
|
|
773
|
+
inserted = await insertDeliveries(endpoints);
|
|
774
|
+
} catch (error) {
|
|
775
|
+
// A cached endpoint was deleted on another instance: the FK fails the
|
|
776
|
+
// whole multi-row insert, which would drop the event for every OTHER
|
|
777
|
+
// endpoint too. Re-read the endpoints and retry once without it.
|
|
778
|
+
if (!isForeignKeyViolation(error)) throw error;
|
|
779
|
+
invalidateOutboundEndpointCache();
|
|
780
|
+
endpoints = await subscribed();
|
|
781
|
+
if (endpoints.length === 0) return;
|
|
782
|
+
inserted = await insertDeliveries(endpoints);
|
|
783
|
+
}
|
|
671
784
|
|
|
672
785
|
// (5) Enqueue the durable delivery task per freshly-inserted row,
|
|
673
786
|
// fire-and-forget. A failed enqueue is recovered by the reaper (the row is
|