@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
|
@@ -0,0 +1,285 @@
|
|
|
1
|
+
import { createRoute, type OpenAPIHono, z } from "@hono/zod-openapi";
|
|
2
|
+
import type { AppEnv } from "../../app.js";
|
|
3
|
+
import {
|
|
4
|
+
getReferralReport,
|
|
5
|
+
getReferralTree,
|
|
6
|
+
InvalidWindowError,
|
|
7
|
+
parseWindowMs,
|
|
8
|
+
REFERRAL_MODELS,
|
|
9
|
+
REFERRAL_REPORT_MAX_DEPTH,
|
|
10
|
+
resolveLevelWeights,
|
|
11
|
+
} from "../../lib/referral-report.js";
|
|
12
|
+
import { errorSchema } from "../../lib/schemas.js";
|
|
13
|
+
import {
|
|
14
|
+
referralIdQuery,
|
|
15
|
+
resolveNamedContactId,
|
|
16
|
+
resolveReferralId,
|
|
17
|
+
} from "./shared.js";
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* `GET /v1/referrals/report` and `GET /v1/referrals/tree/:contactId` (PRD 05
|
|
21
|
+
* §5.3). Model, window, depth and level weights are REQUEST parameters, so
|
|
22
|
+
* these two routes are the entire "reporting feature": nothing is persisted
|
|
23
|
+
* per model and nothing is backfilled when the reader changes their mind.
|
|
24
|
+
*/
|
|
25
|
+
|
|
26
|
+
const DEFAULT_WINDOW = "30d";
|
|
27
|
+
const DEFAULT_LIMIT = 50;
|
|
28
|
+
const MAX_LIMIT = 200;
|
|
29
|
+
const DEFAULT_TREE_DEPTH = 3;
|
|
30
|
+
const MAX_TREE_NODES = 1000;
|
|
31
|
+
|
|
32
|
+
const currencyValueSchema = z.object({
|
|
33
|
+
currency: z.string(),
|
|
34
|
+
value: z.number(),
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
const reportRoute = createRoute({
|
|
38
|
+
method: "get",
|
|
39
|
+
path: "/report",
|
|
40
|
+
tags: ["Referrals"],
|
|
41
|
+
summary: "Referral revenue and tree report",
|
|
42
|
+
description:
|
|
43
|
+
"Secret key + the `referrals` scope. Picks each referee's effective edge(s) under `model` within `window` (the touch-to-bind gap), walks the referrer chain to `depth`, and credits `weights[level] * edgeWeight * conversion value`. VALUES ARE NEVER CONVERTED BETWEEN CURRENCIES: every monetary field is a list of `{ currency, value }`.",
|
|
44
|
+
request: {
|
|
45
|
+
query: z.object({
|
|
46
|
+
referral: referralIdQuery,
|
|
47
|
+
model: z.enum(REFERRAL_MODELS).optional(),
|
|
48
|
+
window: z.string().optional(),
|
|
49
|
+
depth: z.coerce
|
|
50
|
+
.number()
|
|
51
|
+
.int()
|
|
52
|
+
.min(1)
|
|
53
|
+
.max(REFERRAL_REPORT_MAX_DEPTH)
|
|
54
|
+
.optional(),
|
|
55
|
+
weights: z.string().optional(),
|
|
56
|
+
from: z.string().optional(),
|
|
57
|
+
to: z.string().optional(),
|
|
58
|
+
limit: z.coerce.number().int().min(1).max(MAX_LIMIT).optional(),
|
|
59
|
+
cursor: z.string().optional(),
|
|
60
|
+
}),
|
|
61
|
+
},
|
|
62
|
+
responses: {
|
|
63
|
+
200: {
|
|
64
|
+
content: {
|
|
65
|
+
"application/json": {
|
|
66
|
+
schema: z.object({
|
|
67
|
+
referral: z.string(),
|
|
68
|
+
model: z.enum(REFERRAL_MODELS),
|
|
69
|
+
window: z.string(),
|
|
70
|
+
depth: z.number(),
|
|
71
|
+
weights: z.array(z.number()),
|
|
72
|
+
from: z.string().nullable(),
|
|
73
|
+
to: z.string().nullable(),
|
|
74
|
+
beneficiaries: z.array(
|
|
75
|
+
z.object({
|
|
76
|
+
contactId: z.string(),
|
|
77
|
+
direct: z.object({
|
|
78
|
+
touched: z.number(),
|
|
79
|
+
bound: z.number(),
|
|
80
|
+
qualified: z.number(),
|
|
81
|
+
}),
|
|
82
|
+
tree: z.array(
|
|
83
|
+
z.object({
|
|
84
|
+
level: z.number(),
|
|
85
|
+
referees: z.number(),
|
|
86
|
+
conversions: z.number(),
|
|
87
|
+
value: z.array(currencyValueSchema),
|
|
88
|
+
}),
|
|
89
|
+
),
|
|
90
|
+
value: z.array(currencyValueSchema),
|
|
91
|
+
}),
|
|
92
|
+
),
|
|
93
|
+
nextCursor: z.string().nullable(),
|
|
94
|
+
}),
|
|
95
|
+
},
|
|
96
|
+
},
|
|
97
|
+
description: "The report",
|
|
98
|
+
},
|
|
99
|
+
400: {
|
|
100
|
+
content: { "application/json": { schema: errorSchema } },
|
|
101
|
+
description: "Invalid window, weights, cursor or date",
|
|
102
|
+
},
|
|
103
|
+
},
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
const treeRoute = createRoute({
|
|
107
|
+
method: "get",
|
|
108
|
+
path: "/tree/{contactId}",
|
|
109
|
+
tags: ["Referrals"],
|
|
110
|
+
summary: "One referrer's descendants",
|
|
111
|
+
description:
|
|
112
|
+
"Secret key + the `referrals` scope. Walks DOWN from `contactId` to `depth` (default 3, cap 5) over every non-rejected edge. This is a ledger view, not a model: no window, no weights.",
|
|
113
|
+
request: {
|
|
114
|
+
params: z.object({ contactId: z.string().min(1) }),
|
|
115
|
+
query: z.object({
|
|
116
|
+
referral: referralIdQuery,
|
|
117
|
+
depth: z.coerce
|
|
118
|
+
.number()
|
|
119
|
+
.int()
|
|
120
|
+
.min(1)
|
|
121
|
+
.max(REFERRAL_REPORT_MAX_DEPTH)
|
|
122
|
+
.optional(),
|
|
123
|
+
}),
|
|
124
|
+
},
|
|
125
|
+
responses: {
|
|
126
|
+
200: {
|
|
127
|
+
content: {
|
|
128
|
+
"application/json": {
|
|
129
|
+
schema: z.object({
|
|
130
|
+
referral: z.string(),
|
|
131
|
+
contactId: z.string(),
|
|
132
|
+
depth: z.number(),
|
|
133
|
+
nodes: z.array(
|
|
134
|
+
z.object({
|
|
135
|
+
contactId: z.string(),
|
|
136
|
+
level: z.number(),
|
|
137
|
+
viaContactId: z.string(),
|
|
138
|
+
status: z.string(),
|
|
139
|
+
touchedAt: z.string(),
|
|
140
|
+
boundAt: z.string().nullable(),
|
|
141
|
+
qualifiedAt: z.string().nullable(),
|
|
142
|
+
conversions: z.number(),
|
|
143
|
+
value: z.array(currencyValueSchema),
|
|
144
|
+
}),
|
|
145
|
+
),
|
|
146
|
+
}),
|
|
147
|
+
},
|
|
148
|
+
},
|
|
149
|
+
description: "The descendant nodes",
|
|
150
|
+
},
|
|
151
|
+
400: {
|
|
152
|
+
content: { "application/json": { schema: errorSchema } },
|
|
153
|
+
description: "Unresolvable contact key",
|
|
154
|
+
},
|
|
155
|
+
},
|
|
156
|
+
});
|
|
157
|
+
|
|
158
|
+
/** `"1,0.5,0.25"` -> `[1, 0.5, 0.25]`. Throws on anything else. */
|
|
159
|
+
function parseWeights(input: string | undefined, depth: number): number[] {
|
|
160
|
+
if (!input) return [];
|
|
161
|
+
const parts = input.split(",").map((p) => p.trim());
|
|
162
|
+
if (parts.length > depth) {
|
|
163
|
+
throw new RangeError(
|
|
164
|
+
`weights has ${parts.length} entries but depth is ${depth}`,
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
return parts.map((part) => {
|
|
168
|
+
const value = Number(part);
|
|
169
|
+
if (!Number.isFinite(value) || value < 0) {
|
|
170
|
+
throw new RangeError(`weight "${part}" is not a non-negative number`);
|
|
171
|
+
}
|
|
172
|
+
return value;
|
|
173
|
+
});
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/** The cursor is an opaque decimal offset; a non-offset value is a 400. */
|
|
177
|
+
function parseCursor(input: string | undefined): number {
|
|
178
|
+
if (!input) return 0;
|
|
179
|
+
const offset = Number(input);
|
|
180
|
+
if (!Number.isInteger(offset) || offset < 0) {
|
|
181
|
+
throw new RangeError(`invalid cursor "${input}"`);
|
|
182
|
+
}
|
|
183
|
+
return offset;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
function parseDate(input: string | undefined, label: string): Date | undefined {
|
|
187
|
+
if (!input) return undefined;
|
|
188
|
+
const date = new Date(input);
|
|
189
|
+
if (Number.isNaN(date.getTime())) {
|
|
190
|
+
throw new RangeError(`invalid ${label} date "${input}"`);
|
|
191
|
+
}
|
|
192
|
+
return date;
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
export function registerReferralReportRoute(router: OpenAPIHono<AppEnv>) {
|
|
196
|
+
router.openapi(reportRoute, async (c) => {
|
|
197
|
+
const { db } = c.get("container");
|
|
198
|
+
const query = c.req.valid("query");
|
|
199
|
+
|
|
200
|
+
const referralId = resolveReferralId(query.referral);
|
|
201
|
+
const model = query.model ?? "first_touch";
|
|
202
|
+
const windowInput = query.window ?? DEFAULT_WINDOW;
|
|
203
|
+
const depth = query.depth ?? 1;
|
|
204
|
+
const limit = query.limit ?? DEFAULT_LIMIT;
|
|
205
|
+
|
|
206
|
+
let windowMs: number;
|
|
207
|
+
let weights: number[];
|
|
208
|
+
let offset: number;
|
|
209
|
+
let from: Date | undefined;
|
|
210
|
+
let to: Date | undefined;
|
|
211
|
+
try {
|
|
212
|
+
windowMs = parseWindowMs(windowInput);
|
|
213
|
+
weights = parseWeights(query.weights, depth);
|
|
214
|
+
offset = parseCursor(query.cursor);
|
|
215
|
+
from = parseDate(query.from, "from");
|
|
216
|
+
to = parseDate(query.to, "to");
|
|
217
|
+
} catch (err) {
|
|
218
|
+
if (err instanceof InvalidWindowError || err instanceof RangeError) {
|
|
219
|
+
return c.json({ error: err.message }, 400);
|
|
220
|
+
}
|
|
221
|
+
throw err;
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
const levelWeights = resolveLevelWeights(depth, weights);
|
|
225
|
+
const report = await getReferralReport({
|
|
226
|
+
db,
|
|
227
|
+
referralId,
|
|
228
|
+
model,
|
|
229
|
+
windowMs,
|
|
230
|
+
depth,
|
|
231
|
+
levelWeights,
|
|
232
|
+
...(from ? { from } : {}),
|
|
233
|
+
...(to ? { to } : {}),
|
|
234
|
+
limit,
|
|
235
|
+
offset,
|
|
236
|
+
});
|
|
237
|
+
|
|
238
|
+
return c.json(
|
|
239
|
+
{
|
|
240
|
+
referral: referralId,
|
|
241
|
+
model,
|
|
242
|
+
window: windowInput,
|
|
243
|
+
depth,
|
|
244
|
+
weights: levelWeights,
|
|
245
|
+
from: from ? from.toISOString() : null,
|
|
246
|
+
to: to ? to.toISOString() : null,
|
|
247
|
+
beneficiaries: report.beneficiaries,
|
|
248
|
+
nextCursor:
|
|
249
|
+
report.nextOffset === null ? null : String(report.nextOffset),
|
|
250
|
+
},
|
|
251
|
+
200,
|
|
252
|
+
);
|
|
253
|
+
});
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
export function registerReferralTreeRoute(router: OpenAPIHono<AppEnv>) {
|
|
257
|
+
router.openapi(treeRoute, async (c) => {
|
|
258
|
+
const { db } = c.get("container");
|
|
259
|
+
const { contactId } = c.req.valid("param");
|
|
260
|
+
const query = c.req.valid("query");
|
|
261
|
+
const referralId = resolveReferralId(query.referral);
|
|
262
|
+
const depth = query.depth ?? DEFAULT_TREE_DEPTH;
|
|
263
|
+
|
|
264
|
+
// A tree is addressed by the CONTACT, so an external key resolves the same
|
|
265
|
+
// way every other operator route resolves one. An unknown key is an empty
|
|
266
|
+
// tree, not a 404: "this person referred nobody" is the same answer.
|
|
267
|
+
const resolved = await resolveNamedContactId(db, contactId);
|
|
268
|
+
if (!resolved) {
|
|
269
|
+
return c.json({ referral: referralId, contactId, depth, nodes: [] }, 200);
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
const nodes = await getReferralTree({
|
|
273
|
+
db,
|
|
274
|
+
referralId,
|
|
275
|
+
contactId: resolved,
|
|
276
|
+
depth,
|
|
277
|
+
limit: MAX_TREE_NODES,
|
|
278
|
+
});
|
|
279
|
+
|
|
280
|
+
return c.json(
|
|
281
|
+
{ referral: referralId, contactId: resolved, depth, nodes },
|
|
282
|
+
200,
|
|
283
|
+
);
|
|
284
|
+
});
|
|
285
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { DEFAULT_REFERRAL_ID } from "@hogsend/core";
|
|
2
|
+
import type { Database } from "@hogsend/db";
|
|
3
|
+
import { z } from "@hono/zod-openapi";
|
|
4
|
+
import { resolveContact } from "../../lib/contacts.js";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Helpers shared by the `/v1/referrals` routes. Nothing here creates a
|
|
8
|
+
* contact: an operator naming a key is asking a QUESTION, and minting a row to
|
|
9
|
+
* answer it is the ghost-contact case PRD 02 forbade.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
/** Every route takes the same optional `referral` selector. */
|
|
13
|
+
export const referralIdQuery = z
|
|
14
|
+
.string()
|
|
15
|
+
.min(1)
|
|
16
|
+
.optional()
|
|
17
|
+
.describe(`The defineReferral id. Default "${DEFAULT_REFERRAL_ID}".`);
|
|
18
|
+
|
|
19
|
+
export function resolveReferralId(input: string | undefined): string {
|
|
20
|
+
return input ?? DEFAULT_REFERRAL_ID;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Resolve a contact an operator named by uuid or external key. `null` = no
|
|
25
|
+
* such contact; the caller decides whether that is a 404 or a skipped row.
|
|
26
|
+
*/
|
|
27
|
+
export async function resolveNamedContactId(
|
|
28
|
+
db: Database,
|
|
29
|
+
key: string | undefined,
|
|
30
|
+
): Promise<string | null> {
|
|
31
|
+
if (!key) return null;
|
|
32
|
+
const row = await resolveContact({ db, id: key });
|
|
33
|
+
return row?.id ?? null;
|
|
34
|
+
}
|
|
@@ -0,0 +1,313 @@
|
|
|
1
|
+
import { DEFAULT_REFERRAL_ID } from "@hogsend/core";
|
|
2
|
+
import type { Database } from "@hogsend/db";
|
|
3
|
+
import { links } from "@hogsend/db";
|
|
4
|
+
import { createRoute, type OpenAPIHono, z } from "@hono/zod-openapi";
|
|
5
|
+
import { and, eq, isNull } from "drizzle-orm";
|
|
6
|
+
import type { AppEnv } from "../../app.js";
|
|
7
|
+
import { touchReferral } from "../../lib/referral-intent.js";
|
|
8
|
+
import { recordTouch } from "../../lib/referrals.js";
|
|
9
|
+
import { errorSchema } from "../../lib/schemas.js";
|
|
10
|
+
import { resolveNamedContactId, resolveReferralId } from "./shared.js";
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* `POST /v1/referrals/touch` and `POST /v1/referrals/import` (PRD 05 §7.2).
|
|
14
|
+
*
|
|
15
|
+
* The two routes look alike and are deliberately NOT the same call:
|
|
16
|
+
*
|
|
17
|
+
* - `/touch` goes through `touchReferral` (the INTENT layer), so a fresh edge
|
|
18
|
+
* emits `referral.touched` / `referral.bound` on both planes and a reward
|
|
19
|
+
* journey fires. That is what an invite, a typed code or an operator
|
|
20
|
+
* correction IS.
|
|
21
|
+
* - `/import` goes through `recordTouch` (the STORE), which never emits. An
|
|
22
|
+
* import is SILENT HISTORY, exactly like `POST /v1/accounts/import`: back-
|
|
23
|
+
* filling a year of a competitor's referral ledger must not send a year of
|
|
24
|
+
* reward emails. It is also insert-only - an existing edge is reported as
|
|
25
|
+
* `existing`, never rewritten.
|
|
26
|
+
*/
|
|
27
|
+
|
|
28
|
+
const MAX_IMPORT_ROWS = 1000;
|
|
29
|
+
|
|
30
|
+
const sourceSchema = z.enum(["slug_entry", "invite", "manual"]);
|
|
31
|
+
|
|
32
|
+
const touchRoute = createRoute({
|
|
33
|
+
method: "post",
|
|
34
|
+
path: "/touch",
|
|
35
|
+
tags: ["Referrals"],
|
|
36
|
+
summary: "Record a referral touch",
|
|
37
|
+
description:
|
|
38
|
+
"Secret key + the `referrals` scope. Names the referrer by `referrerContactId`, `referrerKey` or the `slug` of their shared link (which also selects the referral). A `refereeContactId`/`refereeKey` that resolves to a contact BINDS the edge immediately; a bare `refereeKey` records the cold edge under that key. Emits `referral.touched` (and `referral.bound`) on a fresh write only.",
|
|
39
|
+
request: {
|
|
40
|
+
body: {
|
|
41
|
+
content: {
|
|
42
|
+
"application/json": {
|
|
43
|
+
schema: z
|
|
44
|
+
.object({
|
|
45
|
+
referral: z.string().min(1).optional(),
|
|
46
|
+
referrerContactId: z.string().min(1).optional(),
|
|
47
|
+
referrerKey: z.string().min(1).optional(),
|
|
48
|
+
slug: z.string().min(1).optional(),
|
|
49
|
+
refereeContactId: z.string().min(1).optional(),
|
|
50
|
+
refereeKey: z.string().min(1).optional(),
|
|
51
|
+
source: sourceSchema,
|
|
52
|
+
properties: z.record(z.string(), z.unknown()).optional(),
|
|
53
|
+
idempotencyKey: z.string().min(1).optional(),
|
|
54
|
+
})
|
|
55
|
+
.refine(
|
|
56
|
+
(b) => Boolean(b.referrerContactId ?? b.referrerKey ?? b.slug),
|
|
57
|
+
{
|
|
58
|
+
message:
|
|
59
|
+
"one of referrerContactId, referrerKey or slug is required",
|
|
60
|
+
},
|
|
61
|
+
)
|
|
62
|
+
.refine((b) => Boolean(b.refereeContactId ?? b.refereeKey), {
|
|
63
|
+
message: "one of refereeContactId or refereeKey is required",
|
|
64
|
+
}),
|
|
65
|
+
},
|
|
66
|
+
},
|
|
67
|
+
},
|
|
68
|
+
},
|
|
69
|
+
responses: {
|
|
70
|
+
200: {
|
|
71
|
+
content: {
|
|
72
|
+
"application/json": {
|
|
73
|
+
schema: z.object({
|
|
74
|
+
touchId: z.string().nullable(),
|
|
75
|
+
referral: z.string(),
|
|
76
|
+
referrerContactId: z.string(),
|
|
77
|
+
refereeContactId: z.string().nullable(),
|
|
78
|
+
status: z.string(),
|
|
79
|
+
created: z.boolean(),
|
|
80
|
+
rejected: z.boolean(),
|
|
81
|
+
}),
|
|
82
|
+
},
|
|
83
|
+
},
|
|
84
|
+
description: "The touch (fresh or recovered)",
|
|
85
|
+
},
|
|
86
|
+
404: {
|
|
87
|
+
content: { "application/json": { schema: errorSchema } },
|
|
88
|
+
description: "No such referrer, slug or referral",
|
|
89
|
+
},
|
|
90
|
+
},
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
const importRoute = createRoute({
|
|
94
|
+
method: "post",
|
|
95
|
+
path: "/import",
|
|
96
|
+
tags: ["Referrals"],
|
|
97
|
+
summary: "Import historical referral touches",
|
|
98
|
+
description:
|
|
99
|
+
'Secret key + the `referrals` scope. INSERT-ONLY and SILENT: every row is written with `source: "import"` at its own `touchedAt`, and NOTHING is emitted - no `referral.touched`, no `referral.bound`, no journey. A row carrying a referee that resolves to a contact is written already `bound` (the self-referral check still applies). An existing edge is counted as `existing` and left untouched.',
|
|
100
|
+
request: {
|
|
101
|
+
body: {
|
|
102
|
+
content: {
|
|
103
|
+
"application/json": {
|
|
104
|
+
schema: z.object({
|
|
105
|
+
referral: z.string().min(1).optional(),
|
|
106
|
+
touches: z
|
|
107
|
+
.array(
|
|
108
|
+
z.object({
|
|
109
|
+
referrerContactId: z.string().min(1).optional(),
|
|
110
|
+
referrerKey: z.string().min(1).optional(),
|
|
111
|
+
refereeContactId: z.string().min(1).optional(),
|
|
112
|
+
refereeKey: z.string().min(1).optional(),
|
|
113
|
+
touchedAt: z.string(),
|
|
114
|
+
properties: z.record(z.string(), z.unknown()).optional(),
|
|
115
|
+
idempotencyKey: z.string().min(1).optional(),
|
|
116
|
+
}),
|
|
117
|
+
)
|
|
118
|
+
.min(1)
|
|
119
|
+
.max(MAX_IMPORT_ROWS),
|
|
120
|
+
}),
|
|
121
|
+
},
|
|
122
|
+
},
|
|
123
|
+
},
|
|
124
|
+
},
|
|
125
|
+
responses: {
|
|
126
|
+
200: {
|
|
127
|
+
content: {
|
|
128
|
+
"application/json": {
|
|
129
|
+
schema: z.object({
|
|
130
|
+
referral: z.string(),
|
|
131
|
+
inserted: z.number(),
|
|
132
|
+
existing: z.number(),
|
|
133
|
+
rejected: z.number(),
|
|
134
|
+
skipped: z.number(),
|
|
135
|
+
}),
|
|
136
|
+
},
|
|
137
|
+
},
|
|
138
|
+
description: "Per-row outcome counts",
|
|
139
|
+
},
|
|
140
|
+
},
|
|
141
|
+
});
|
|
142
|
+
|
|
143
|
+
/** The live `shared` link behind a slug: its owner AND its referral. */
|
|
144
|
+
async function resolveSlug(
|
|
145
|
+
db: Database,
|
|
146
|
+
slug: string,
|
|
147
|
+
): Promise<{
|
|
148
|
+
referralId: string;
|
|
149
|
+
ownerContactId: string;
|
|
150
|
+
linkId: string;
|
|
151
|
+
} | null> {
|
|
152
|
+
const [row] = await db
|
|
153
|
+
.select({
|
|
154
|
+
id: links.id,
|
|
155
|
+
referralId: links.referralId,
|
|
156
|
+
ownerContactId: links.ownerContactId,
|
|
157
|
+
})
|
|
158
|
+
.from(links)
|
|
159
|
+
.where(and(eq(links.slug, slug.toLowerCase()), isNull(links.archivedAt)))
|
|
160
|
+
.limit(1);
|
|
161
|
+
if (!row?.ownerContactId) return null;
|
|
162
|
+
return {
|
|
163
|
+
referralId: row.referralId ?? DEFAULT_REFERRAL_ID,
|
|
164
|
+
ownerContactId: row.ownerContactId,
|
|
165
|
+
linkId: row.id,
|
|
166
|
+
};
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
export function registerReferralTouchRoute(router: OpenAPIHono<AppEnv>) {
|
|
170
|
+
router.openapi(touchRoute, async (c) => {
|
|
171
|
+
const container = c.get("container");
|
|
172
|
+
const { db, referrals } = container;
|
|
173
|
+
const body = c.req.valid("json");
|
|
174
|
+
|
|
175
|
+
let referralId = resolveReferralId(body.referral);
|
|
176
|
+
let referrerContactId: string | null = null;
|
|
177
|
+
let linkId: string | null = null;
|
|
178
|
+
|
|
179
|
+
if (body.slug) {
|
|
180
|
+
const link = await resolveSlug(db, body.slug);
|
|
181
|
+
if (!link) {
|
|
182
|
+
return c.json(
|
|
183
|
+
{ error: `no shared link with slug "${body.slug}"` },
|
|
184
|
+
404,
|
|
185
|
+
);
|
|
186
|
+
}
|
|
187
|
+
// The slug carries BOTH ends of the selection: an explicit `referral`
|
|
188
|
+
// that disagrees with the link's own would credit the wrong program, so
|
|
189
|
+
// the link always wins and the body's value is ignored.
|
|
190
|
+
referralId = link.referralId;
|
|
191
|
+
referrerContactId = link.ownerContactId;
|
|
192
|
+
linkId = link.linkId;
|
|
193
|
+
} else {
|
|
194
|
+
referrerContactId = await resolveNamedContactId(
|
|
195
|
+
db,
|
|
196
|
+
body.referrerContactId ?? body.referrerKey,
|
|
197
|
+
);
|
|
198
|
+
if (!referrerContactId) {
|
|
199
|
+
return c.json({ error: "no such referrer" }, 404);
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
const referral = referrals.get(referralId);
|
|
204
|
+
if (!referral) {
|
|
205
|
+
return c.json(
|
|
206
|
+
{ error: `no referral "${referralId}" is registered` },
|
|
207
|
+
404,
|
|
208
|
+
);
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
const refereeContactId = await resolveNamedContactId(
|
|
212
|
+
db,
|
|
213
|
+
body.refereeContactId ?? body.refereeKey,
|
|
214
|
+
);
|
|
215
|
+
// The referee KEY is what `adoptOrphanHistory` scans for later, so a cold
|
|
216
|
+
// touch must keep the caller's raw key verbatim.
|
|
217
|
+
const refereeKey = body.refereeKey ?? refereeContactId ?? "";
|
|
218
|
+
if (!refereeKey) {
|
|
219
|
+
return c.json({ error: "no such referee" }, 404);
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
const result = await touchReferral({
|
|
223
|
+
db,
|
|
224
|
+
hatchet: container.hatchet,
|
|
225
|
+
registry: container.registry,
|
|
226
|
+
logger: container.logger,
|
|
227
|
+
...(container.analytics ? { analytics: container.analytics } : {}),
|
|
228
|
+
referrals,
|
|
229
|
+
referral,
|
|
230
|
+
referrerContactId,
|
|
231
|
+
refereeKey,
|
|
232
|
+
refereeContactId,
|
|
233
|
+
linkId,
|
|
234
|
+
source: body.source,
|
|
235
|
+
...(body.properties ? { properties: body.properties } : {}),
|
|
236
|
+
...(body.idempotencyKey ? { idempotencyKey: body.idempotencyKey } : {}),
|
|
237
|
+
});
|
|
238
|
+
|
|
239
|
+
return c.json(
|
|
240
|
+
{
|
|
241
|
+
touchId: result.touch?.id ?? null,
|
|
242
|
+
referral: referralId,
|
|
243
|
+
referrerContactId,
|
|
244
|
+
refereeContactId: result.touch?.refereeContactId ?? null,
|
|
245
|
+
status: result.touch?.status ?? "skipped",
|
|
246
|
+
created: result.created,
|
|
247
|
+
rejected: result.rejected,
|
|
248
|
+
},
|
|
249
|
+
200,
|
|
250
|
+
);
|
|
251
|
+
});
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
export function registerReferralImportRoute(router: OpenAPIHono<AppEnv>) {
|
|
255
|
+
router.openapi(importRoute, async (c) => {
|
|
256
|
+
const { db, referrals } = c.get("container");
|
|
257
|
+
const body = c.req.valid("json");
|
|
258
|
+
const referralId = resolveReferralId(body.referral);
|
|
259
|
+
// The definition is OPTIONAL here: importing history into a program whose
|
|
260
|
+
// code was deleted is legitimate, and `recordTouch` only needs it for
|
|
261
|
+
// `beforeTouch` (which an import deliberately does not run through the
|
|
262
|
+
// intent layer anyway).
|
|
263
|
+
const referral = referrals.get(referralId);
|
|
264
|
+
|
|
265
|
+
let inserted = 0;
|
|
266
|
+
let existing = 0;
|
|
267
|
+
let rejected = 0;
|
|
268
|
+
let skipped = 0;
|
|
269
|
+
|
|
270
|
+
for (const row of body.touches) {
|
|
271
|
+
const touchedAt = new Date(row.touchedAt);
|
|
272
|
+
const referrerContactId = await resolveNamedContactId(
|
|
273
|
+
db,
|
|
274
|
+
row.referrerContactId ?? row.referrerKey,
|
|
275
|
+
);
|
|
276
|
+
if (!referrerContactId || Number.isNaN(touchedAt.getTime())) {
|
|
277
|
+
skipped++;
|
|
278
|
+
continue;
|
|
279
|
+
}
|
|
280
|
+
const refereeContactId = await resolveNamedContactId(
|
|
281
|
+
db,
|
|
282
|
+
row.refereeContactId ?? row.refereeKey,
|
|
283
|
+
);
|
|
284
|
+
const refereeKey = row.refereeKey ?? refereeContactId;
|
|
285
|
+
if (!refereeKey) {
|
|
286
|
+
skipped++;
|
|
287
|
+
continue;
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
const result = await recordTouch({
|
|
291
|
+
db,
|
|
292
|
+
referralId,
|
|
293
|
+
...(referral ? { referral } : {}),
|
|
294
|
+
referrerContactId,
|
|
295
|
+
refereeKey,
|
|
296
|
+
refereeContactId,
|
|
297
|
+
source: "import",
|
|
298
|
+
touchedAt,
|
|
299
|
+
...(row.properties ? { properties: row.properties } : {}),
|
|
300
|
+
...(row.idempotencyKey ? { idempotencyKey: row.idempotencyKey } : {}),
|
|
301
|
+
});
|
|
302
|
+
|
|
303
|
+
if (result.rejected) rejected++;
|
|
304
|
+
else if (result.created) inserted++;
|
|
305
|
+
else existing++;
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
return c.json(
|
|
309
|
+
{ referral: referralId, inserted, existing, rejected, skipped },
|
|
310
|
+
200,
|
|
311
|
+
);
|
|
312
|
+
});
|
|
313
|
+
}
|