@hogsend/engine 0.67.0 → 0.68.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -2
- package/dist/account-links/__fixtures__/fake-fetch.d.ts +38 -0
- package/dist/account-links/__fixtures__/fake-fetch.d.ts.map +1 -0
- package/dist/account-links/battlenet.d.ts +36 -0
- package/dist/account-links/battlenet.d.ts.map +1 -0
- package/dist/account-links/epic.d.ts +36 -0
- package/dist/account-links/epic.d.ts.map +1 -0
- package/dist/account-links/index.d.ts +7 -0
- package/dist/account-links/index.d.ts.map +1 -0
- package/dist/account-links/riot.d.ts +35 -0
- package/dist/account-links/riot.d.ts.map +1 -0
- package/dist/account-links/steam.d.ts +35 -0
- package/dist/account-links/steam.d.ts.map +1 -0
- package/dist/account-links/twitch.d.ts +38 -0
- package/dist/account-links/twitch.d.ts.map +1 -0
- package/dist/account-links/xbox.d.ts +39 -0
- package/dist/account-links/xbox.d.ts.map +1 -0
- package/dist/app.d.ts +50 -0
- package/dist/app.d.ts.map +1 -0
- package/dist/buckets/bucket-access.d.ts +60 -0
- package/dist/buckets/bucket-access.d.ts.map +1 -0
- package/dist/buckets/bucket-reactions.d.ts +100 -0
- package/dist/buckets/bucket-reactions.d.ts.map +1 -0
- package/dist/buckets/check-membership.d.ts +105 -0
- package/dist/buckets/check-membership.d.ts.map +1 -0
- package/dist/buckets/define-bucket.d.ts +53 -0
- package/dist/buckets/define-bucket.d.ts.map +1 -0
- package/dist/buckets/membership-epoch.d.ts +74 -0
- package/dist/buckets/membership-epoch.d.ts.map +1 -0
- package/dist/buckets/registry-singleton.d.ts +6 -0
- package/dist/buckets/registry-singleton.d.ts.map +1 -0
- package/dist/buckets/registry.d.ts +59 -0
- package/dist/buckets/registry.d.ts.map +1 -0
- package/dist/campaigns/cohort-sql.d.ts +54 -0
- package/dist/campaigns/cohort-sql.d.ts.map +1 -0
- package/dist/campaigns/define-campaign.d.ts +105 -0
- package/dist/campaigns/define-campaign.d.ts.map +1 -0
- package/dist/campaigns/reconcile.d.ts +13 -0
- package/dist/campaigns/reconcile.d.ts.map +1 -0
- package/dist/campaigns/steps.d.ts +29 -0
- package/dist/campaigns/steps.d.ts.map +1 -0
- package/dist/cold-connect/index.d.ts +98 -0
- package/dist/cold-connect/index.d.ts.map +1 -0
- package/dist/cold-connect/page.d.ts +69 -0
- package/dist/cold-connect/page.d.ts.map +1 -0
- package/dist/cold-connect/throttle.d.ts +39 -0
- package/dist/cold-connect/throttle.d.ts.map +1 -0
- package/dist/cold-connect/token.d.ts +57 -0
- package/dist/cold-connect/token.d.ts.map +1 -0
- package/dist/connectors/action-registry-singleton.d.ts +21 -0
- package/dist/connectors/action-registry-singleton.d.ts.map +1 -0
- package/dist/connectors/define-action.d.ts +117 -0
- package/dist/connectors/define-action.d.ts.map +1 -0
- package/dist/connectors/define-connector.d.ts +172 -0
- package/dist/connectors/define-connector.d.ts.map +1 -0
- package/dist/connectors/presets/index.d.ts +17 -0
- package/dist/connectors/presets/index.d.ts.map +1 -0
- package/dist/connectors/registry-singleton.d.ts +34 -0
- package/dist/connectors/registry-singleton.d.ts.map +1 -0
- package/dist/connectors/runtime.d.ts +68 -0
- package/dist/connectors/runtime.d.ts.map +1 -0
- package/dist/container.d.ts +678 -0
- package/dist/container.d.ts.map +1 -0
- package/dist/destinations/define-destination.d.ts +96 -0
- package/dist/destinations/define-destination.d.ts.map +1 -0
- package/dist/destinations/presets/index.d.ts +42 -0
- package/dist/destinations/presets/index.d.ts.map +1 -0
- package/dist/destinations/presets/posthog.d.ts +12 -0
- package/dist/destinations/presets/posthog.d.ts.map +1 -0
- package/dist/destinations/presets/segment.d.ts +15 -0
- package/dist/destinations/presets/segment.d.ts.map +1 -0
- package/dist/destinations/presets/slack.d.ts +10 -0
- package/dist/destinations/presets/slack.d.ts.map +1 -0
- package/dist/destinations/presets/webhook.d.ts +14 -0
- package/dist/destinations/presets/webhook.d.ts.map +1 -0
- package/dist/destinations/registry-singleton.d.ts +44 -0
- package/dist/destinations/registry-singleton.d.ts.map +1 -0
- package/dist/env.d.ts +119 -0
- package/dist/env.d.ts.map +1 -0
- package/dist/flags/reconcile.d.ts +36 -0
- package/dist/flags/reconcile.d.ts.map +1 -0
- package/dist/index.d.ts +210 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/journeys/authoring.d.ts +15 -0
- package/dist/journeys/authoring.d.ts.map +1 -0
- package/dist/journeys/client-defaults-singleton.d.ts +16 -0
- package/dist/journeys/client-defaults-singleton.d.ts.map +1 -0
- package/dist/journeys/constants.d.ts +32 -0
- package/dist/journeys/constants.d.ts.map +1 -0
- package/dist/journeys/define-journey.d.ts +33 -0
- package/dist/journeys/define-journey.d.ts.map +1 -0
- package/dist/journeys/durable-law-harness.d.ts +74 -0
- package/dist/journeys/durable-law-harness.d.ts.map +1 -0
- package/dist/journeys/errors.d.ts +13 -0
- package/dist/journeys/errors.d.ts.map +1 -0
- package/dist/journeys/execute-journey-run.d.ts +160 -0
- package/dist/journeys/execute-journey-run.d.ts.map +1 -0
- package/dist/journeys/graph/build-graph.d.ts +24 -0
- package/dist/journeys/graph/build-graph.d.ts.map +1 -0
- package/dist/journeys/group-scope.d.ts +56 -0
- package/dist/journeys/group-scope.d.ts.map +1 -0
- package/dist/journeys/journey-boundary.d.ts +264 -0
- package/dist/journeys/journey-boundary.d.ts.map +1 -0
- package/dist/journeys/journey-context.d.ts +60 -0
- package/dist/journeys/journey-context.d.ts.map +1 -0
- package/dist/journeys/journey-log.d.ts +42 -0
- package/dist/journeys/journey-log.d.ts.map +1 -0
- package/dist/journeys/journey-source-locations-singleton.d.ts +6 -0
- package/dist/journeys/journey-source-locations-singleton.d.ts.map +1 -0
- package/dist/journeys/journey-sources-singleton.d.ts +5 -0
- package/dist/journeys/journey-sources-singleton.d.ts.map +1 -0
- package/dist/journeys/journey-task-factory.d.ts +11 -0
- package/dist/journeys/journey-task-factory.d.ts.map +1 -0
- package/dist/journeys/journey-task-runtime.d.ts +2 -0
- package/dist/journeys/journey-task-runtime.d.ts.map +1 -0
- package/dist/journeys/journey-version.d.ts +71 -0
- package/dist/journeys/journey-version.d.ts.map +1 -0
- package/dist/journeys/record-once.d.ts +56 -0
- package/dist/journeys/record-once.d.ts.map +1 -0
- package/dist/journeys/registry-singleton.d.ts +6 -0
- package/dist/journeys/registry-singleton.d.ts.map +1 -0
- package/dist/journeys/registry.d.ts +59 -0
- package/dist/journeys/registry.d.ts.map +1 -0
- package/dist/journeys/with-durable-gate.d.ts +97 -0
- package/dist/journeys/with-durable-gate.d.ts.map +1 -0
- package/dist/lib/account-link-emit.d.ts +69 -0
- package/dist/lib/account-link-emit.d.ts.map +1 -0
- package/dist/lib/account-link-events.d.ts +128 -0
- package/dist/lib/account-link-events.d.ts.map +1 -0
- package/dist/lib/account-link-hooks.d.ts +32 -0
- package/dist/lib/account-link-hooks.d.ts.map +1 -0
- package/dist/lib/account-link-ingest.d.ts +78 -0
- package/dist/lib/account-link-ingest.d.ts.map +1 -0
- package/dist/lib/account-link-nonce.d.ts +29 -0
- package/dist/lib/account-link-nonce.d.ts.map +1 -0
- package/dist/lib/account-link-origins.d.ts +37 -0
- package/dist/lib/account-link-origins.d.ts.map +1 -0
- package/dist/lib/account-link-pkce.d.ts +48 -0
- package/dist/lib/account-link-pkce.d.ts.map +1 -0
- package/dist/lib/account-link-provider-registry.d.ts +35 -0
- package/dist/lib/account-link-provider-registry.d.ts.map +1 -0
- package/dist/lib/account-link-throttle.d.ts +76 -0
- package/dist/lib/account-link-throttle.d.ts.map +1 -0
- package/dist/lib/account-link-url.d.ts +41 -0
- package/dist/lib/account-link-url.d.ts.map +1 -0
- package/dist/lib/account-links-from-env.d.ts +62 -0
- package/dist/lib/account-links-from-env.d.ts.map +1 -0
- package/dist/lib/account-links.d.ts +353 -0
- package/dist/lib/account-links.d.ts.map +1 -0
- package/dist/lib/agent/config.d.ts +14 -0
- package/dist/lib/agent/config.d.ts.map +1 -0
- package/dist/lib/agent/proposals.d.ts +52 -0
- package/dist/lib/agent/proposals.d.ts.map +1 -0
- package/dist/lib/agent/provider.d.ts +9 -0
- package/dist/lib/agent/provider.d.ts.map +1 -0
- package/dist/lib/agent/risk.d.ts +24 -0
- package/dist/lib/agent/risk.d.ts.map +1 -0
- package/dist/lib/agent/system-prompt.d.ts +8 -0
- package/dist/lib/agent/system-prompt.d.ts.map +1 -0
- package/dist/lib/agent/tools.d.ts +258 -0
- package/dist/lib/agent/tools.d.ts.map +1 -0
- package/dist/lib/alerting.d.ts +7 -0
- package/dist/lib/alerting.d.ts.map +1 -0
- package/dist/lib/analytics-adapter.d.ts +24 -0
- package/dist/lib/analytics-adapter.d.ts.map +1 -0
- package/dist/lib/analytics-identity.d.ts +60 -0
- package/dist/lib/analytics-identity.d.ts.map +1 -0
- package/dist/lib/analytics-provider-registry.d.ts +20 -0
- package/dist/lib/analytics-provider-registry.d.ts.map +1 -0
- package/dist/lib/analytics-providers-from-env.d.ts +41 -0
- package/dist/lib/analytics-providers-from-env.d.ts.map +1 -0
- package/dist/lib/analytics-singleton.d.ts +10 -0
- package/dist/lib/analytics-singleton.d.ts.map +1 -0
- package/dist/lib/api-key-hash.d.ts +9 -0
- package/dist/lib/api-key-hash.d.ts.map +1 -0
- package/dist/lib/app-secret.d.ts +29 -0
- package/dist/lib/app-secret.d.ts.map +1 -0
- package/dist/lib/attachments.d.ts +53 -0
- package/dist/lib/attachments.d.ts.map +1 -0
- package/dist/lib/attribution-backfill.d.ts +48 -0
- package/dist/lib/attribution-backfill.d.ts.map +1 -0
- package/dist/lib/attribution.d.ts +44 -0
- package/dist/lib/attribution.d.ts.map +1 -0
- package/dist/lib/auth.d.ts +136 -0
- package/dist/lib/auth.d.ts.map +1 -0
- package/dist/lib/backfill.d.ts +41 -0
- package/dist/lib/backfill.d.ts.map +1 -0
- package/dist/lib/banner.d.ts +52 -0
- package/dist/lib/banner.d.ts.map +1 -0
- package/dist/lib/blueprint-lock.d.ts +19 -0
- package/dist/lib/blueprint-lock.d.ts.map +1 -0
- package/dist/lib/blueprints.d.ts +573 -0
- package/dist/lib/blueprints.d.ts.map +1 -0
- package/dist/lib/boot-api-key.d.ts +38 -0
- package/dist/lib/boot-api-key.d.ts.map +1 -0
- package/dist/lib/boot.d.ts +23 -0
- package/dist/lib/boot.d.ts.map +1 -0
- package/dist/lib/bootstrap-admin.d.ts +33 -0
- package/dist/lib/bootstrap-admin.d.ts.map +1 -0
- package/dist/lib/bot-prefetch.d.ts +21 -0
- package/dist/lib/bot-prefetch.d.ts.map +1 -0
- package/dist/lib/bucket-emit.d.ts +75 -0
- package/dist/lib/bucket-emit.d.ts.map +1 -0
- package/dist/lib/bucket-posthog-sync.d.ts +29 -0
- package/dist/lib/bucket-posthog-sync.d.ts.map +1 -0
- package/dist/lib/campaign-send-key.d.ts +31 -0
- package/dist/lib/campaign-send-key.d.ts.map +1 -0
- package/dist/lib/connector-actions.d.ts +83 -0
- package/dist/lib/connector-actions.d.ts.map +1 -0
- package/dist/lib/connector-heartbeat.d.ts +35 -0
- package/dist/lib/connector-heartbeat.d.ts.map +1 -0
- package/dist/lib/connector-link-codes.d.ts +105 -0
- package/dist/lib/connector-link-codes.d.ts.map +1 -0
- package/dist/lib/connector-state.d.ts +97 -0
- package/dist/lib/connector-state.d.ts.map +1 -0
- package/dist/lib/contacts.d.ts +622 -0
- package/dist/lib/contacts.d.ts.map +1 -0
- package/dist/lib/conversion-dispatch.d.ts +98 -0
- package/dist/lib/conversion-dispatch.d.ts.map +1 -0
- package/dist/lib/conversions.d.ts +75 -0
- package/dist/lib/conversions.d.ts.map +1 -0
- package/dist/lib/create-admin.d.ts +54 -0
- package/dist/lib/create-admin.d.ts.map +1 -0
- package/dist/lib/crm-deals.d.ts +66 -0
- package/dist/lib/crm-deals.d.ts.map +1 -0
- package/dist/lib/crm-ingest.d.ts +38 -0
- package/dist/lib/crm-ingest.d.ts.map +1 -0
- package/dist/lib/crm-provider-registry.d.ts +20 -0
- package/dist/lib/crm-provider-registry.d.ts.map +1 -0
- package/dist/lib/crm-registry-singleton.d.ts +18 -0
- package/dist/lib/crm-registry-singleton.d.ts.map +1 -0
- package/dist/lib/db.d.ts +3 -0
- package/dist/lib/db.d.ts.map +1 -0
- package/dist/lib/deal-money-events.d.ts +35 -0
- package/dist/lib/deal-money-events.d.ts.map +1 -0
- package/dist/lib/discord-gateway-heartbeat.d.ts +47 -0
- package/dist/lib/discord-gateway-heartbeat.d.ts.map +1 -0
- package/dist/lib/domain-status.d.ts +87 -0
- package/dist/lib/domain-status.d.ts.map +1 -0
- package/dist/lib/email-provider-registry.d.ts +30 -0
- package/dist/lib/email-provider-registry.d.ts.map +1 -0
- package/dist/lib/email-providers-from-env.d.ts +12 -0
- package/dist/lib/email-providers-from-env.d.ts.map +1 -0
- package/dist/lib/email-service-types.d.ts +189 -0
- package/dist/lib/email-service-types.d.ts.map +1 -0
- package/dist/lib/email-stats.d.ts +12 -0
- package/dist/lib/email-stats.d.ts.map +1 -0
- package/dist/lib/email.d.ts +73 -0
- package/dist/lib/email.d.ts.map +1 -0
- package/dist/lib/enrichment-ledger.d.ts +101 -0
- package/dist/lib/enrichment-ledger.d.ts.map +1 -0
- package/dist/lib/enrichment-provider-registry.d.ts +20 -0
- package/dist/lib/enrichment-provider-registry.d.ts.map +1 -0
- package/dist/lib/enrichment-providers-from-env.d.ts +13 -0
- package/dist/lib/enrichment-providers-from-env.d.ts.map +1 -0
- package/dist/lib/enrichment-registry-singleton.d.ts +9 -0
- package/dist/lib/enrichment-registry-singleton.d.ts.map +1 -0
- package/dist/lib/enrollment-guards.d.ts +28 -0
- package/dist/lib/enrollment-guards.d.ts.map +1 -0
- package/dist/lib/enrollment-policy.d.ts +25 -0
- package/dist/lib/enrollment-policy.d.ts.map +1 -0
- package/dist/lib/event-names.d.ts +27 -0
- package/dist/lib/event-names.d.ts.map +1 -0
- package/dist/lib/feed.d.ts +64 -0
- package/dist/lib/feed.d.ts.map +1 -0
- package/dist/lib/flags-registry.d.ts +23 -0
- package/dist/lib/flags-registry.d.ts.map +1 -0
- package/dist/lib/flags.d.ts +143 -0
- package/dist/lib/flags.d.ts.map +1 -0
- package/dist/lib/frequency-cap.d.ts +38 -0
- package/dist/lib/frequency-cap.d.ts.map +1 -0
- package/dist/lib/from-address.d.ts +15 -0
- package/dist/lib/from-address.d.ts.map +1 -0
- package/dist/lib/funnel-progress.d.ts +37 -0
- package/dist/lib/funnel-progress.d.ts.map +1 -0
- package/dist/lib/funnel-registry.d.ts +44 -0
- package/dist/lib/funnel-registry.d.ts.map +1 -0
- package/dist/lib/funnel-transitions.d.ts +63 -0
- package/dist/lib/funnel-transitions.d.ts.map +1 -0
- package/dist/lib/fx.d.ts +118 -0
- package/dist/lib/fx.d.ts.map +1 -0
- package/dist/lib/global-control-readout.d.ts +72 -0
- package/dist/lib/global-control-readout.d.ts.map +1 -0
- package/dist/lib/groups.d.ts +138 -0
- package/dist/lib/groups.d.ts.map +1 -0
- package/dist/lib/hatchet-duration.d.ts +14 -0
- package/dist/lib/hatchet-duration.d.ts.map +1 -0
- package/dist/lib/hatchet.d.ts +3 -0
- package/dist/lib/hatchet.d.ts.map +1 -0
- package/dist/lib/headers.d.ts +8 -0
- package/dist/lib/headers.d.ts.map +1 -0
- package/dist/lib/holdout.d.ts +36 -0
- package/dist/lib/holdout.d.ts.map +1 -0
- package/dist/lib/html.d.ts +5 -0
- package/dist/lib/html.d.ts.map +1 -0
- package/dist/lib/identity-service.d.ts +60 -0
- package/dist/lib/identity-service.d.ts.map +1 -0
- package/dist/lib/identity-token.d.ts +81 -0
- package/dist/lib/identity-token.d.ts.map +1 -0
- package/dist/lib/ingestion.d.ts +218 -0
- package/dist/lib/ingestion.d.ts.map +1 -0
- package/dist/lib/journey-lift.d.ts +56 -0
- package/dist/lib/journey-lift.d.ts.map +1 -0
- package/dist/lib/journey-suppress.d.ts +59 -0
- package/dist/lib/journey-suppress.d.ts.map +1 -0
- package/dist/lib/leader-lease.d.ts +36 -0
- package/dist/lib/leader-lease.d.ts.map +1 -0
- package/dist/lib/lift-stats.d.ts +46 -0
- package/dist/lib/lift-stats.d.ts.map +1 -0
- package/dist/lib/links.d.ts +186 -0
- package/dist/lib/links.d.ts.map +1 -0
- package/dist/lib/load-optional-plugin.d.ts +47 -0
- package/dist/lib/load-optional-plugin.d.ts.map +1 -0
- package/dist/lib/logger.d.ts +4 -0
- package/dist/lib/logger.d.ts.map +1 -0
- package/dist/lib/mailer.d.ts +43 -0
- package/dist/lib/mailer.d.ts.map +1 -0
- package/dist/lib/metrics-sql.d.ts +11 -0
- package/dist/lib/metrics-sql.d.ts.map +1 -0
- package/dist/lib/notifications.d.ts +17 -0
- package/dist/lib/notifications.d.ts.map +1 -0
- package/dist/lib/oauth-token-manager.d.ts +74 -0
- package/dist/lib/oauth-token-manager.d.ts.map +1 -0
- package/dist/lib/operator-settings.d.ts +33 -0
- package/dist/lib/operator-settings.d.ts.map +1 -0
- package/dist/lib/operator.d.ts +20 -0
- package/dist/lib/operator.d.ts.map +1 -0
- package/dist/lib/outbound-endpoint-cache.d.ts +25 -0
- package/dist/lib/outbound-endpoint-cache.d.ts.map +1 -0
- package/dist/lib/outbound.d.ts +687 -0
- package/dist/lib/outbound.d.ts.map +1 -0
- package/dist/lib/phone.d.ts +11 -0
- package/dist/lib/phone.d.ts.map +1 -0
- package/dist/lib/posthog-scopes.d.ts +30 -0
- package/dist/lib/posthog-scopes.d.ts.map +1 -0
- package/dist/lib/posthog.d.ts +16 -0
- package/dist/lib/posthog.d.ts.map +1 -0
- package/dist/lib/preferences.d.ts +72 -0
- package/dist/lib/preferences.d.ts.map +1 -0
- package/dist/lib/provider-credentials.d.ts +149 -0
- package/dist/lib/provider-credentials.d.ts.map +1 -0
- package/dist/lib/provision-posthog-loop.d.ts +100 -0
- package/dist/lib/provision-posthog-loop.d.ts.map +1 -0
- package/dist/lib/recipient-preferences.d.ts +29 -0
- package/dist/lib/recipient-preferences.d.ts.map +1 -0
- package/dist/lib/redis.d.ts +33 -0
- package/dist/lib/redis.d.ts.map +1 -0
- package/dist/lib/referral-intent.d.ts +99 -0
- package/dist/lib/referral-intent.d.ts.map +1 -0
- package/dist/lib/referral-link.d.ts +59 -0
- package/dist/lib/referral-link.d.ts.map +1 -0
- package/dist/lib/referral-registry.d.ts +37 -0
- package/dist/lib/referral-registry.d.ts.map +1 -0
- package/dist/lib/referral-report.d.ts +178 -0
- package/dist/lib/referral-report.d.ts.map +1 -0
- package/dist/lib/referral-runtime.d.ts +43 -0
- package/dist/lib/referral-runtime.d.ts.map +1 -0
- package/dist/lib/referrals.d.ts +184 -0
- package/dist/lib/referrals.d.ts.map +1 -0
- package/dist/lib/refine-chain.d.ts +236 -0
- package/dist/lib/refine-chain.d.ts.map +1 -0
- package/dist/lib/refine-traits.d.ts +78 -0
- package/dist/lib/refine-traits.d.ts.map +1 -0
- package/dist/lib/refine.d.ts +35 -0
- package/dist/lib/refine.d.ts.map +1 -0
- package/dist/lib/reset-email.d.ts +38 -0
- package/dist/lib/reset-email.d.ts.map +1 -0
- package/dist/lib/revenue.d.ts +61 -0
- package/dist/lib/revenue.d.ts.map +1 -0
- package/dist/lib/schemas.d.ts +9 -0
- package/dist/lib/schemas.d.ts.map +1 -0
- package/dist/lib/seed-posthog-destination.d.ts +22 -0
- package/dist/lib/seed-posthog-destination.d.ts.map +1 -0
- package/dist/lib/semantic-click.d.ts +58 -0
- package/dist/lib/semantic-click.d.ts.map +1 -0
- package/dist/lib/sending-domain-guidance.d.ts +40 -0
- package/dist/lib/sending-domain-guidance.d.ts.map +1 -0
- package/dist/lib/singleton.d.ts +24 -0
- package/dist/lib/singleton.d.ts.map +1 -0
- package/dist/lib/sms-frequency-cap.d.ts +16 -0
- package/dist/lib/sms-frequency-cap.d.ts.map +1 -0
- package/dist/lib/sms-inbound.d.ts +37 -0
- package/dist/lib/sms-inbound.d.ts.map +1 -0
- package/dist/lib/sms-link-tracking.d.ts +53 -0
- package/dist/lib/sms-link-tracking.d.ts.map +1 -0
- package/dist/lib/sms-mailer.d.ts +12 -0
- package/dist/lib/sms-mailer.d.ts.map +1 -0
- package/dist/lib/sms-provider-registry.d.ts +20 -0
- package/dist/lib/sms-provider-registry.d.ts.map +1 -0
- package/dist/lib/sms-providers-from-env.d.ts +4 -0
- package/dist/lib/sms-providers-from-env.d.ts.map +1 -0
- package/dist/lib/sms-service-types.d.ts +131 -0
- package/dist/lib/sms-service-types.d.ts.map +1 -0
- package/dist/lib/sms-tracked.d.ts +36 -0
- package/dist/lib/sms-tracked.d.ts.map +1 -0
- package/dist/lib/sms.d.ts +58 -0
- package/dist/lib/sms.d.ts.map +1 -0
- package/dist/lib/snippet.d.ts +32 -0
- package/dist/lib/snippet.d.ts.map +1 -0
- package/dist/lib/stable-stringify.d.ts +12 -0
- package/dist/lib/stable-stringify.d.ts.map +1 -0
- package/dist/lib/studio.d.ts +21 -0
- package/dist/lib/studio.d.ts.map +1 -0
- package/dist/lib/survey.d.ts +35 -0
- package/dist/lib/survey.d.ts.map +1 -0
- package/dist/lib/test-mode.d.ts +77 -0
- package/dist/lib/test-mode.d.ts.map +1 -0
- package/dist/lib/timezone.d.ts +55 -0
- package/dist/lib/timezone.d.ts.map +1 -0
- package/dist/lib/tracked.d.ts +95 -0
- package/dist/lib/tracked.d.ts.map +1 -0
- package/dist/lib/tracking-event-names.d.ts +7 -0
- package/dist/lib/tracking-event-names.d.ts.map +1 -0
- package/dist/lib/tracking-events.d.ts +232 -0
- package/dist/lib/tracking-events.d.ts.map +1 -0
- package/dist/lib/tracking.d.ts +47 -0
- package/dist/lib/tracking.d.ts.map +1 -0
- package/dist/lib/unconfigured-email-provider.d.ts +20 -0
- package/dist/lib/unconfigured-email-provider.d.ts.map +1 -0
- package/dist/lib/unique-violation.d.ts +22 -0
- package/dist/lib/unique-violation.d.ts.map +1 -0
- package/dist/lib/user-token.d.ts +44 -0
- package/dist/lib/user-token.d.ts.map +1 -0
- package/dist/lib/variant.d.ts +44 -0
- package/dist/lib/variant.d.ts.map +1 -0
- package/dist/lib/webhook-signing.d.ts +120 -0
- package/dist/lib/webhook-signing.d.ts.map +1 -0
- package/dist/lib/worker-heartbeat.d.ts +18 -0
- package/dist/lib/worker-heartbeat.d.ts.map +1 -0
- package/dist/lists/channels.d.ts +43 -0
- package/dist/lists/channels.d.ts.map +1 -0
- package/dist/lists/define-list.d.ts +76 -0
- package/dist/lists/define-list.d.ts.map +1 -0
- package/dist/lists/registry-singleton.d.ts +8 -0
- package/dist/lists/registry-singleton.d.ts.map +1 -0
- package/dist/lists/registry.d.ts +66 -0
- package/dist/lists/registry.d.ts.map +1 -0
- package/dist/lists/subscription.d.ts +10 -0
- package/dist/lists/subscription.d.ts.map +1 -0
- package/dist/mcp/authoring-guide.d.ts +33 -0
- package/dist/mcp/authoring-guide.d.ts.map +1 -0
- package/dist/mcp/blueprint-tools.d.ts +266 -0
- package/dist/mcp/blueprint-tools.d.ts.map +1 -0
- package/dist/middleware/api-key.d.ts +45 -0
- package/dist/middleware/api-key.d.ts.map +1 -0
- package/dist/middleware/audit.d.ts +3 -0
- package/dist/middleware/audit.d.ts.map +1 -0
- package/dist/middleware/error-handler.d.ts +4 -0
- package/dist/middleware/error-handler.d.ts.map +1 -0
- package/dist/middleware/publishable-key.d.ts +27 -0
- package/dist/middleware/publishable-key.d.ts.map +1 -0
- package/dist/middleware/rate-limit.d.ts +105 -0
- package/dist/middleware/rate-limit.d.ts.map +1 -0
- package/dist/middleware/request-logger.d.ts +4 -0
- package/dist/middleware/request-logger.d.ts.map +1 -0
- package/dist/middleware/require-admin.d.ts +3 -0
- package/dist/middleware/require-admin.d.ts.map +1 -0
- package/dist/routes/_shared.d.ts +52 -0
- package/dist/routes/_shared.d.ts.map +1 -0
- package/dist/routes/accounts/callback.d.ts +18 -0
- package/dist/routes/accounts/callback.d.ts.map +1 -0
- package/dist/routes/accounts/emit.d.ts +96 -0
- package/dist/routes/accounts/emit.d.ts.map +1 -0
- package/dist/routes/accounts/import-links.d.ts +4 -0
- package/dist/routes/accounts/import-links.d.ts.map +1 -0
- package/dist/routes/accounts/index.d.ts +39 -0
- package/dist/routes/accounts/index.d.ts.map +1 -0
- package/dist/routes/accounts/lookup.d.ts +6 -0
- package/dist/routes/accounts/lookup.d.ts.map +1 -0
- package/dist/routes/accounts/me.d.ts +5 -0
- package/dist/routes/accounts/me.d.ts.map +1 -0
- package/dist/routes/accounts/mint.d.ts +5 -0
- package/dist/routes/accounts/mint.d.ts.map +1 -0
- package/dist/routes/accounts/pages.d.ts +23 -0
- package/dist/routes/accounts/pages.d.ts.map +1 -0
- package/dist/routes/accounts/resolve.d.ts +33 -0
- package/dist/routes/accounts/resolve.d.ts.map +1 -0
- package/dist/routes/accounts/serialize.d.ts +57 -0
- package/dist/routes/accounts/serialize.d.ts.map +1 -0
- package/dist/routes/accounts/shared.d.ts +68 -0
- package/dist/routes/accounts/shared.d.ts.map +1 -0
- package/dist/routes/accounts/start.d.ts +16 -0
- package/dist/routes/accounts/start.d.ts.map +1 -0
- package/dist/routes/accounts/unlink.d.ts +36 -0
- package/dist/routes/accounts/unlink.d.ts.map +1 -0
- package/dist/routes/admin/agent.d.ts +4 -0
- package/dist/routes/admin/agent.d.ts.map +1 -0
- package/dist/routes/admin/alerts.d.ts +190 -0
- package/dist/routes/admin/alerts.d.ts.map +1 -0
- package/dist/routes/admin/analytics.d.ts +137 -0
- package/dist/routes/admin/analytics.d.ts.map +1 -0
- package/dist/routes/admin/api-keys.d.ts +158 -0
- package/dist/routes/admin/api-keys.d.ts.map +1 -0
- package/dist/routes/admin/attribution.d.ts +93 -0
- package/dist/routes/admin/attribution.d.ts.map +1 -0
- package/dist/routes/admin/audit-logs.d.ts +40 -0
- package/dist/routes/admin/audit-logs.d.ts.map +1 -0
- package/dist/routes/admin/blueprints.d.ts +4 -0
- package/dist/routes/admin/blueprints.d.ts.map +1 -0
- package/dist/routes/admin/buckets.d.ts +215 -0
- package/dist/routes/admin/buckets.d.ts.map +1 -0
- package/dist/routes/admin/bulk.d.ts +203 -0
- package/dist/routes/admin/bulk.d.ts.map +1 -0
- package/dist/routes/admin/campaigns.d.ts +198 -0
- package/dist/routes/admin/campaigns.d.ts.map +1 -0
- package/dist/routes/admin/connectors.d.ts +116 -0
- package/dist/routes/admin/connectors.d.ts.map +1 -0
- package/dist/routes/admin/contacts.d.ts +246 -0
- package/dist/routes/admin/contacts.d.ts.map +1 -0
- package/dist/routes/admin/conversions.d.ts +103 -0
- package/dist/routes/admin/conversions.d.ts.map +1 -0
- package/dist/routes/admin/deals.d.ts +136 -0
- package/dist/routes/admin/deals.d.ts.map +1 -0
- package/dist/routes/admin/dlq.d.ts +100 -0
- package/dist/routes/admin/dlq.d.ts.map +1 -0
- package/dist/routes/admin/domain.d.ts +314 -0
- package/dist/routes/admin/domain.d.ts.map +1 -0
- package/dist/routes/admin/emails.d.ts +127 -0
- package/dist/routes/admin/emails.d.ts.map +1 -0
- package/dist/routes/admin/events.d.ts +140 -0
- package/dist/routes/admin/events.d.ts.map +1 -0
- package/dist/routes/admin/flags.d.ts +719 -0
- package/dist/routes/admin/flags.d.ts.map +1 -0
- package/dist/routes/admin/funnels.d.ts +71 -0
- package/dist/routes/admin/funnels.d.ts.map +1 -0
- package/dist/routes/admin/groups.d.ts +169 -0
- package/dist/routes/admin/groups.d.ts.map +1 -0
- package/dist/routes/admin/identity.d.ts +72 -0
- package/dist/routes/admin/identity.d.ts.map +1 -0
- package/dist/routes/admin/impact-schemas.d.ts +48 -0
- package/dist/routes/admin/impact-schemas.d.ts.map +1 -0
- package/dist/routes/admin/impact.d.ts +316 -0
- package/dist/routes/admin/impact.d.ts.map +1 -0
- package/dist/routes/admin/index.d.ts +4 -0
- package/dist/routes/admin/index.d.ts.map +1 -0
- package/dist/routes/admin/journey-impact.d.ts +320 -0
- package/dist/routes/admin/journey-impact.d.ts.map +1 -0
- package/dist/routes/admin/journey-logs.d.ts +57 -0
- package/dist/routes/admin/journey-logs.d.ts.map +1 -0
- package/dist/routes/admin/journeys.d.ts +736 -0
- package/dist/routes/admin/journeys.d.ts.map +1 -0
- package/dist/routes/admin/links.d.ts +382 -0
- package/dist/routes/admin/links.d.ts.map +1 -0
- package/dist/routes/admin/lists.d.ts +22 -0
- package/dist/routes/admin/lists.d.ts.map +1 -0
- package/dist/routes/admin/maintenance.d.ts +72 -0
- package/dist/routes/admin/maintenance.d.ts.map +1 -0
- package/dist/routes/admin/metrics.d.ts +212 -0
- package/dist/routes/admin/metrics.d.ts.map +1 -0
- package/dist/routes/admin/open-editor.d.ts +36 -0
- package/dist/routes/admin/open-editor.d.ts.map +1 -0
- package/dist/routes/admin/preferences.d.ts +109 -0
- package/dist/routes/admin/preferences.d.ts.map +1 -0
- package/dist/routes/admin/provider-credentials.d.ts +108 -0
- package/dist/routes/admin/provider-credentials.d.ts.map +1 -0
- package/dist/routes/admin/readiness.d.ts +24 -0
- package/dist/routes/admin/readiness.d.ts.map +1 -0
- package/dist/routes/admin/referrals.d.ts +230 -0
- package/dist/routes/admin/referrals.d.ts.map +1 -0
- package/dist/routes/admin/reporting.d.ts +149 -0
- package/dist/routes/admin/reporting.d.ts.map +1 -0
- package/dist/routes/admin/settings.d.ts +80 -0
- package/dist/routes/admin/settings.d.ts.map +1 -0
- package/dist/routes/admin/suppressions.d.ts +90 -0
- package/dist/routes/admin/suppressions.d.ts.map +1 -0
- package/dist/routes/admin/targeting.d.ts +58 -0
- package/dist/routes/admin/targeting.d.ts.map +1 -0
- package/dist/routes/admin/templates.d.ts +197 -0
- package/dist/routes/admin/templates.d.ts.map +1 -0
- package/dist/routes/admin/timeline.d.ts +51 -0
- package/dist/routes/admin/timeline.d.ts.map +1 -0
- package/dist/routes/admin/webhooks.d.ts +250 -0
- package/dist/routes/admin/webhooks.d.ts.map +1 -0
- package/dist/routes/campaigns/index.d.ts +239 -0
- package/dist/routes/campaigns/index.d.ts.map +1 -0
- package/dist/routes/connectors/index.d.ts +16 -0
- package/dist/routes/connectors/index.d.ts.map +1 -0
- package/dist/routes/contacts/index.d.ts +187 -0
- package/dist/routes/contacts/index.d.ts.map +1 -0
- package/dist/routes/email/index.d.ts +4 -0
- package/dist/routes/email/index.d.ts.map +1 -0
- package/dist/routes/email/preferences.d.ts +17 -0
- package/dist/routes/email/preferences.d.ts.map +1 -0
- package/dist/routes/email/unsubscribe.d.ts +17 -0
- package/dist/routes/email/unsubscribe.d.ts.map +1 -0
- package/dist/routes/emails/index.d.ts +90 -0
- package/dist/routes/emails/index.d.ts.map +1 -0
- package/dist/routes/events/index.d.ts +116 -0
- package/dist/routes/events/index.d.ts.map +1 -0
- package/dist/routes/feed/index.d.ts +248 -0
- package/dist/routes/feed/index.d.ts.map +1 -0
- package/dist/routes/feed/recipient.d.ts +65 -0
- package/dist/routes/feed/recipient.d.ts.map +1 -0
- package/dist/routes/flags/index.d.ts +94 -0
- package/dist/routes/flags/index.d.ts.map +1 -0
- package/dist/routes/groups/index.d.ts +192 -0
- package/dist/routes/groups/index.d.ts.map +1 -0
- package/dist/routes/health.d.ts +57 -0
- package/dist/routes/health.d.ts.map +1 -0
- package/dist/routes/index.d.ts +8 -0
- package/dist/routes/index.d.ts.map +1 -0
- package/dist/routes/lists/index.d.ts +266 -0
- package/dist/routes/lists/index.d.ts.map +1 -0
- package/dist/routes/referrals/index.d.ts +22 -0
- package/dist/routes/referrals/index.d.ts.map +1 -0
- package/dist/routes/referrals/me.d.ts +4 -0
- package/dist/routes/referrals/me.d.ts.map +1 -0
- package/dist/routes/referrals/report.d.ts +5 -0
- package/dist/routes/referrals/report.d.ts.map +1 -0
- package/dist/routes/referrals/shared.d.ts +16 -0
- package/dist/routes/referrals/shared.d.ts.map +1 -0
- package/dist/routes/referrals/touch.d.ts +5 -0
- package/dist/routes/referrals/touch.d.ts.map +1 -0
- package/dist/routes/snippet.d.ts +12 -0
- package/dist/routes/snippet.d.ts.map +1 -0
- package/dist/routes/tracking/answer.d.ts +56 -0
- package/dist/routes/tracking/answer.d.ts.map +1 -0
- package/dist/routes/tracking/arrive.d.ts +32 -0
- package/dist/routes/tracking/arrive.d.ts.map +1 -0
- package/dist/routes/tracking/click-pipeline.d.ts +213 -0
- package/dist/routes/tracking/click-pipeline.d.ts.map +1 -0
- package/dist/routes/tracking/click.d.ts +26 -0
- package/dist/routes/tracking/click.d.ts.map +1 -0
- package/dist/routes/tracking/identify.d.ts +32 -0
- package/dist/routes/tracking/identify.d.ts.map +1 -0
- package/dist/routes/tracking/index.d.ts +4 -0
- package/dist/routes/tracking/index.d.ts.map +1 -0
- package/dist/routes/tracking/open.d.ts +17 -0
- package/dist/routes/tracking/open.d.ts.map +1 -0
- package/dist/routes/tracking/short.d.ts +17 -0
- package/dist/routes/tracking/short.d.ts.map +1 -0
- package/dist/routes/tracking/vanity.d.ts +17 -0
- package/dist/routes/tracking/vanity.d.ts.map +1 -0
- package/dist/routes/webhooks/crm-provider.d.ts +24 -0
- package/dist/routes/webhooks/crm-provider.d.ts.map +1 -0
- package/dist/routes/webhooks/email-provider.d.ts +21 -0
- package/dist/routes/webhooks/email-provider.d.ts.map +1 -0
- package/dist/routes/webhooks/index.d.ts +8 -0
- package/dist/routes/webhooks/index.d.ts.map +1 -0
- package/dist/routes/webhooks/resend.d.ts +35 -0
- package/dist/routes/webhooks/resend.d.ts.map +1 -0
- package/dist/routes/webhooks/sms-provider.d.ts +23 -0
- package/dist/routes/webhooks/sms-provider.d.ts.map +1 -0
- package/dist/routes/webhooks/sources.d.ts +12 -0
- package/dist/routes/webhooks/sources.d.ts.map +1 -0
- package/dist/sources/define-contact-source.d.ts +114 -0
- package/dist/sources/define-contact-source.d.ts.map +1 -0
- package/dist/sources/registry.d.ts +31 -0
- package/dist/sources/registry.d.ts.map +1 -0
- package/dist/sources/webhook-source.d.ts +53 -0
- package/dist/sources/webhook-source.d.ts.map +1 -0
- package/dist/testing.d.ts +10 -0
- package/dist/testing.d.ts.map +1 -0
- package/dist/webhook-sources/define-webhook-source.d.ts +60 -0
- package/dist/webhook-sources/define-webhook-source.d.ts.map +1 -0
- package/dist/webhook-sources/presets/clerk.d.ts +9 -0
- package/dist/webhook-sources/presets/clerk.d.ts.map +1 -0
- package/dist/webhook-sources/presets/index.d.ts +140 -0
- package/dist/webhook-sources/presets/index.d.ts.map +1 -0
- package/dist/webhook-sources/presets/intercom.d.ts +44 -0
- package/dist/webhook-sources/presets/intercom.d.ts.map +1 -0
- package/dist/webhook-sources/presets/segment.d.ts +16 -0
- package/dist/webhook-sources/presets/segment.d.ts.map +1 -0
- package/dist/webhook-sources/presets/stripe.d.ts +20 -0
- package/dist/webhook-sources/presets/stripe.d.ts.map +1 -0
- package/dist/webhook-sources/presets/supabase.d.ts +23 -0
- package/dist/webhook-sources/presets/supabase.d.ts.map +1 -0
- package/dist/webhook-sources/verify.d.ts +48 -0
- package/dist/webhook-sources/verify.d.ts.map +1 -0
- package/dist/worker.d.ts +37 -0
- package/dist/worker.d.ts.map +1 -0
- package/dist/workflows/backfill-contact-id.d.ts +202 -0
- package/dist/workflows/backfill-contact-id.d.ts.map +1 -0
- package/dist/workflows/bucket-backfill.d.ts +64 -0
- package/dist/workflows/bucket-backfill.d.ts.map +1 -0
- package/dist/workflows/bucket-reconcile.d.ts +73 -0
- package/dist/workflows/bucket-reconcile.d.ts.map +1 -0
- package/dist/workflows/check-alerts.d.ts +10 -0
- package/dist/workflows/check-alerts.d.ts.map +1 -0
- package/dist/workflows/confirm-semantic-click.d.ts +15 -0
- package/dist/workflows/confirm-semantic-click.d.ts.map +1 -0
- package/dist/workflows/crm-reconcile.d.ts +27 -0
- package/dist/workflows/crm-reconcile.d.ts.map +1 -0
- package/dist/workflows/deliver-webhook.d.ts +88 -0
- package/dist/workflows/deliver-webhook.d.ts.map +1 -0
- package/dist/workflows/dispatch-conversion.d.ts +14 -0
- package/dist/workflows/dispatch-conversion.d.ts.map +1 -0
- package/dist/workflows/identity-alias-backfill.d.ts +96 -0
- package/dist/workflows/identity-alias-backfill.d.ts.map +1 -0
- package/dist/workflows/impact-digest.d.ts +142 -0
- package/dist/workflows/impact-digest.d.ts.map +1 -0
- package/dist/workflows/import-contacts.d.ts +14 -0
- package/dist/workflows/import-contacts.d.ts.map +1 -0
- package/dist/workflows/import-suppressions.d.ts +55 -0
- package/dist/workflows/import-suppressions.d.ts.map +1 -0
- package/dist/workflows/journey-blueprint-interpreter.d.ts +73 -0
- package/dist/workflows/journey-blueprint-interpreter.d.ts.map +1 -0
- package/dist/workflows/send-campaign.d.ts +128 -0
- package/dist/workflows/send-campaign.d.ts.map +1 -0
- package/dist/workflows/send-email.d.ts +15 -0
- package/dist/workflows/send-email.d.ts.map +1 -0
- package/dist/workflows/send-feed.d.ts +37 -0
- package/dist/workflows/send-feed.d.ts.map +1 -0
- package/package.json +60 -22
- package/src/app.ts +9 -1
- package/src/buckets/check-membership.ts +54 -20
- package/src/env.ts +30 -0
- package/src/journeys/journey-log.ts +25 -8
- package/src/lib/contacts.ts +47 -1
- package/src/lib/email-service-types.ts +10 -0
- package/src/lib/ingestion.ts +30 -19
- package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
- package/src/lib/mailer-replied.test.ts +7 -2
- package/src/lib/mailer.ts +1 -0
- package/src/lib/outbound-endpoint-cache.ts +83 -0
- package/src/lib/outbound.ts +56 -37
- package/src/lib/seed-posthog-destination.ts +5 -1
- package/src/lib/tracked.ts +11 -3
- package/src/lib/tracking-events.ts +20 -3
- package/src/middleware/api-key.ts +69 -60
- package/src/middleware/publishable-key.ts +11 -23
- package/src/middleware/rate-limit.ts +165 -3
- package/src/routes/admin/api-keys.ts +148 -0
- package/src/routes/admin/targeting.ts +6 -1
- package/src/routes/admin/webhooks.ts +4 -0
- package/src/routes/index.ts +67 -24
- package/src/workflows/backfill-contact-id.ts +3 -7
- package/src/workflows/bucket-backfill.ts +2 -2
- package/src/workflows/bucket-reconcile.ts +28 -12
- package/src/workflows/check-alerts.ts +3 -9
- package/src/workflows/crm-reconcile.ts +3 -2
- package/src/workflows/deliver-webhook.ts +21 -8
- package/src/workflows/dispatch-conversion.ts +2 -2
- package/src/workflows/identity-alias-backfill.ts +3 -2
- package/src/workflows/impact-digest.ts +2 -2
- package/src/workflows/import-contacts.ts +3 -4
- package/src/workflows/import-suppressions.ts +4 -5
- package/src/workflows/send-campaign.ts +10 -1
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { type TimeZone } from "@hogsend/core/schedule";
|
|
2
|
+
import { type Database } from "@hogsend/db";
|
|
3
|
+
export interface ResolveTimezoneInput {
|
|
4
|
+
/** Explicit per-call override, e.g. from `ctx.when.tz("Area/City")`. */
|
|
5
|
+
explicit?: string;
|
|
6
|
+
/** PostHog person properties ($timezone, $geoip_time_zone). */
|
|
7
|
+
posthogProperties?: Record<string, unknown>;
|
|
8
|
+
/** The `contacts.timezone` cache column. */
|
|
9
|
+
contactTimezone?: string | null;
|
|
10
|
+
/** The `contacts.properties` jsonb. */
|
|
11
|
+
contactProperties?: Record<string, unknown> | null;
|
|
12
|
+
/** The client `defaults.timezone`. */
|
|
13
|
+
defaultTimezone?: string;
|
|
14
|
+
logger?: {
|
|
15
|
+
warn(msg: string): void;
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Source of a resolved timezone, surfaced so callers (e.g. `define-journey`)
|
|
20
|
+
* can decide whether to opportunistically cache it back to `contacts.timezone`.
|
|
21
|
+
*/
|
|
22
|
+
export type TimezoneSource = "explicit" | "posthog_timezone" | "posthog_geoip" | "contact_column" | "contact_properties" | "default" | "fallback";
|
|
23
|
+
export interface ResolveTimezoneResult {
|
|
24
|
+
timezone: string;
|
|
25
|
+
source: TimezoneSource;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Resolve a user's IANA timezone via the precedence chain. The first *valid*
|
|
29
|
+
* candidate wins; invalid candidates are skipped and warned. Never throws —
|
|
30
|
+
* the terminal fallback is `"UTC"`.
|
|
31
|
+
*
|
|
32
|
+
* Precedence: explicit → PostHog `$timezone` → PostHog `$geoip_time_zone` →
|
|
33
|
+
* `contacts.timezone` → `contacts.properties.timezone` → client default → UTC.
|
|
34
|
+
*/
|
|
35
|
+
export declare function resolveTimezoneWithSource(input: ResolveTimezoneInput): ResolveTimezoneResult;
|
|
36
|
+
/** Convenience wrapper returning just the resolved IANA timezone string. */
|
|
37
|
+
export declare function resolveTimezone(input: ResolveTimezoneInput): string;
|
|
38
|
+
/**
|
|
39
|
+
* Persist a known timezone for a contact (e.g. one the user picked in your
|
|
40
|
+
* app's settings) into the canonical `contacts.timezone` column, so the
|
|
41
|
+
* resolution chain prefers it over PostHog/geoip on the next journey run.
|
|
42
|
+
*
|
|
43
|
+
* Validates the zone and throws `TypeError` on an invalid one — this is an
|
|
44
|
+
* explicit, author-driven write, not best-effort data ingestion. Returns
|
|
45
|
+
* `{ updated: false }` if no contact exists yet for `userId` (it is created on
|
|
46
|
+
* first event ingestion); call again once the contact exists.
|
|
47
|
+
*/
|
|
48
|
+
export declare function setContactTimezone(opts: {
|
|
49
|
+
db: Database;
|
|
50
|
+
userId: string;
|
|
51
|
+
timezone: TimeZone;
|
|
52
|
+
}): Promise<{
|
|
53
|
+
updated: boolean;
|
|
54
|
+
}>;
|
|
55
|
+
//# sourceMappingURL=timezone.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/lib/timezone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAItD,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnD,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB;AAMD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,oBAAoB,GAC1B,qBAAqB,CAwCvB;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBhC"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { EmailProvider } from "@hogsend/core";
|
|
2
|
+
import type { Database } from "@hogsend/db";
|
|
3
|
+
import type { RetryOptions, TemplateName, TemplateRegistry } from "@hogsend/email";
|
|
4
|
+
import type { TestModeState } from "./domain-status.js";
|
|
5
|
+
import { type FrequencyCapConfig, type SendTrackedEmailOptions, type TrackedSendResult } from "./email-service-types.js";
|
|
6
|
+
import { type Logger } from "./logger.js";
|
|
7
|
+
export type PrepareTrackedHtmlFn = (opts: {
|
|
8
|
+
html: string;
|
|
9
|
+
emailSendId: string;
|
|
10
|
+
baseUrl: string;
|
|
11
|
+
db: Database;
|
|
12
|
+
}) => Promise<string>;
|
|
13
|
+
/**
|
|
14
|
+
* Does the ACTIVE provider's TRANSPORT consume the `Idempotency-Key` header —
|
|
15
|
+
* lifting it off the message before anything reaches a recipient?
|
|
16
|
+
*
|
|
17
|
+
* THE RULE: a provider gets the engine's replay-stable key if and only if it
|
|
18
|
+
* DECLARES `capabilities.consumesIdempotencyKey: true`. Nothing else qualifies
|
|
19
|
+
* it — not its id, not its package. A third party opts in the same way the
|
|
20
|
+
* first-party relay does, by writing the declaration.
|
|
21
|
+
*
|
|
22
|
+
* Absence is NOT consent, and the default is the whole safety story. Resend and
|
|
23
|
+
* Postmark forward `SendEmailOptions.headers` VERBATIM onto the delivered
|
|
24
|
+
* message (Resend `headers`, Postmark `Headers`), so volunteering the key to a
|
|
25
|
+
* provider that never asked would stamp internal keys — which embed Hatchet run
|
|
26
|
+
* ids and wait labels (`journeySend:<runId>:<site>:<template>`) and, for
|
|
27
|
+
* campaign sends, the recipient's own address (`campaign:<id>:<email>`) — onto
|
|
28
|
+
* real customer mail, silently, on nothing more than an engine upgrade. So an
|
|
29
|
+
* absent or `false` flag means the delivered headers are byte-for-byte what
|
|
30
|
+
* they were before any of this existed.
|
|
31
|
+
*
|
|
32
|
+
* An `Idempotency-Key` the CALLER placed in `options.headers` themselves is
|
|
33
|
+
* untouched by this gate: explicit headers pass through regardless of what the
|
|
34
|
+
* provider declares, exactly as they did before the key threading existed.
|
|
35
|
+
*/
|
|
36
|
+
export declare function providerConsumesIdempotencyKey(provider: EmailProvider): boolean;
|
|
37
|
+
/**
|
|
38
|
+
* Thread the send's replay-stable idempotency key onto the provider wire.
|
|
39
|
+
*
|
|
40
|
+
* `SendEmailOptions` has no `idempotencyKey` field — the contract is
|
|
41
|
+
* deliberately provider-NEUTRAL, so the key rides as a header, and ONLY to a
|
|
42
|
+
* provider that consumes it ({@link providerConsumesIdempotencyKey}): a
|
|
43
|
+
* header-forwarding provider (Resend, Postmark) would deliver it to the
|
|
44
|
+
* recipient as an SMTP header, so the caller passes `undefined` for those.
|
|
45
|
+
*
|
|
46
|
+
* This is load-bearing rather than a nicety. A transport that has to invent its
|
|
47
|
+
* own key can only hash the message bytes, and that CANNOT protect a crash
|
|
48
|
+
* replay: `prepareTrackedHtml` mints fresh `tracked_links` ids and an open pixel
|
|
49
|
+
* carrying the send id on every attempt, so a re-drive of the SAME logical send
|
|
50
|
+
* produces different HTML, a different hash, and no replay protection at all. A
|
|
51
|
+
* journey replayed after a worker crash would send twice. The engine already
|
|
52
|
+
* holds the only key that survives a replay (`journeySend:<runId>:<site>:<template>`,
|
|
53
|
+
* the same one the `email_sends` unique index dedups on), so it hands it over —
|
|
54
|
+
* one key, both dedup layers.
|
|
55
|
+
*
|
|
56
|
+
* An `Idempotency-Key` the CALLER already set is never clobbered: an explicit
|
|
57
|
+
* header is a deliberate override, and silently replacing it would make two
|
|
58
|
+
* distinct sends look like one to the transport.
|
|
59
|
+
*/
|
|
60
|
+
export declare function withIdempotencyHeader(headers: Record<string, string> | undefined, key: string | undefined): Record<string, string> | undefined;
|
|
61
|
+
interface TrackedEmailDeps {
|
|
62
|
+
db: Database;
|
|
63
|
+
provider: EmailProvider;
|
|
64
|
+
/** The client app's template registry, threaded into {@link getTemplate}. */
|
|
65
|
+
registry: TemplateRegistry;
|
|
66
|
+
retryOptions?: RetryOptions;
|
|
67
|
+
prepareTrackedHtml?: PrepareTrackedHtmlFn;
|
|
68
|
+
/** Optional per-client frequency cap; undefined disables capping. */
|
|
69
|
+
frequencyCap?: FrequencyCapConfig;
|
|
70
|
+
/** Optional structured logger for operational events (e.g. cap skips). */
|
|
71
|
+
logger?: Logger;
|
|
72
|
+
/**
|
|
73
|
+
* The active test-mode state, resolved ONCE by the mailer (cache-only) and
|
|
74
|
+
* threaded in so this module stays domainStatus-unaware. `null` ⇒ live send.
|
|
75
|
+
* When active, suppression/frequency/unsubscribe still key to the ORIGINAL
|
|
76
|
+
* recipient (`options.to`); only the wire + `email_sends` row are redirected.
|
|
77
|
+
*/
|
|
78
|
+
testMode?: TestModeState | null;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Boundary-aware entry point. When a send reaches the tracked mailer from INSIDE
|
|
82
|
+
* a journey `run()` WITHOUT an idempotency key already set — i.e. a journey that
|
|
83
|
+
* called the raw `getEmailService().send(...)` instead of the `sendEmail()`
|
|
84
|
+
* helper (which derives its own key) — derive the same deterministic, replay-
|
|
85
|
+
* stable key HERE so the engine's exactly-once guarantee covers that path too.
|
|
86
|
+
* This closes the raw-service footgun: ANY journey send is auto-keyed + memoized
|
|
87
|
+
* regardless of which import the author reached for. Outside a journey, or when
|
|
88
|
+
* a key is already set (sendEmail / POST /v1/emails), this is a transparent
|
|
89
|
+
* pass-through to {@link sendTrackedEmailInner}.
|
|
90
|
+
*/
|
|
91
|
+
export declare function sendTrackedEmail<K extends TemplateName>(opts: TrackedEmailDeps & {
|
|
92
|
+
options: SendTrackedEmailOptions<K>;
|
|
93
|
+
}): Promise<TrackedSendResult>;
|
|
94
|
+
export {};
|
|
95
|
+
//# sourceMappingURL=tracked.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracked.d.ts","sourceRoot":"","sources":["../../src/lib/tracked.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAoBxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAgBxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,QAAQ,CAAC;CACd,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAKtB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQpC;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,qEAAqE;IACrE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,YAAY,EAC3D,IAAI,EAAE,gBAAgB,GAAG;IAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAA;CAAE,GAC/D,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export declare const EMAIL_OPENED: "email.opened";
|
|
2
|
+
export declare const EMAIL_LINK_CLICKED: "email.link_clicked";
|
|
3
|
+
export declare const EMAIL_REPLIED: "email.replied";
|
|
4
|
+
export declare const LINK_CLICKED: "link.clicked";
|
|
5
|
+
export declare const LINK_ARRIVED: "link.arrived";
|
|
6
|
+
export declare const SMS_LINK_CLICKED: "sms.link_clicked";
|
|
7
|
+
//# sourceMappingURL=tracking-event-names.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracking-event-names.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-event-names.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AACpD,eAAO,MAAM,kBAAkB,EAAG,oBAA6B,CAAC;AAShE,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAC;AAStD,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAQpD,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAMpD,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC"}
|
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
|
|
2
|
+
import type { JourneyRegistry } from "@hogsend/core/registry";
|
|
3
|
+
import { type Database } from "@hogsend/db";
|
|
4
|
+
import { type IngestResult } from "./ingestion.js";
|
|
5
|
+
import type { Logger } from "./logger.js";
|
|
6
|
+
interface EmailSendContext {
|
|
7
|
+
/**
|
|
8
|
+
* Display/attribution identity: the enrollment's key, else the send's
|
|
9
|
+
* recorded `user_id`, else the recipient address. Never re-ingest this as
|
|
10
|
+
* `userId` — use {@link subjectKey}, which is null for a bare-address send.
|
|
11
|
+
*/
|
|
12
|
+
userId: string;
|
|
13
|
+
userEmail: string;
|
|
14
|
+
/**
|
|
15
|
+
* The subject key the send was actually made for (enrollment key, else
|
|
16
|
+
* `email_sends.user_id`), or null for a bare-address send. Bus re-ingests key
|
|
17
|
+
* on this, so a raw send's address is offered as an EMAIL key, never as an
|
|
18
|
+
* external `userId` (which would fill a free `external_id` with the address
|
|
19
|
+
* and flip the contact's canonical key).
|
|
20
|
+
*/
|
|
21
|
+
subjectKey: string | null;
|
|
22
|
+
/**
|
|
23
|
+
* PRD 05 T6 — the send's owning contact (`email_sends.contact_id`, falling
|
|
24
|
+
* back to the enrollment's stamp). The denormalized `userId` string above is
|
|
25
|
+
* FROZEN at send time and goes stale when the contact adopts a new key; the
|
|
26
|
+
* re-ingest pins this id so tracking events land on the contact, not on
|
|
27
|
+
* whatever key happened to be canonical when the mail left.
|
|
28
|
+
*/
|
|
29
|
+
contactId: string | null;
|
|
30
|
+
templateKey: string | null;
|
|
31
|
+
messageId: string | null;
|
|
32
|
+
to: string;
|
|
33
|
+
/**
|
|
34
|
+
* Attribution scope (plan §1.2): the enrollment's journey id and the send's
|
|
35
|
+
* campaign id, stamped into every tracking event's properties so the credit
|
|
36
|
+
* ledger can slice by journey/campaign without a join back through
|
|
37
|
+
* email_sends. Null for transactional/raw sends.
|
|
38
|
+
*/
|
|
39
|
+
journeyId: string | null;
|
|
40
|
+
campaignId: string | null;
|
|
41
|
+
}
|
|
42
|
+
export declare function resolveEmailSendContext(db: Database, emailSendId: string | null): Promise<EmailSendContext | null>;
|
|
43
|
+
export interface EmailSendContextByMessageId {
|
|
44
|
+
emailSendId: string;
|
|
45
|
+
userId: string;
|
|
46
|
+
userEmail: string;
|
|
47
|
+
/** See {@link EmailSendContext.contactId}. */
|
|
48
|
+
contactId: string | null;
|
|
49
|
+
templateKey: string | null;
|
|
50
|
+
to: string;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* @deprecated Renamed to {@link EmailSendContextByMessageId} as part of the
|
|
54
|
+
* provider-neutral `resendId` → `messageId` rename. Kept as an alias for one
|
|
55
|
+
* minor; removed the following minor.
|
|
56
|
+
*/
|
|
57
|
+
export type ResendEmailSendContext = EmailSendContextByMessageId;
|
|
58
|
+
/**
|
|
59
|
+
* Mirror of {@link resolveEmailSendContext} that resolves by the provider's
|
|
60
|
+
* `messageId` instead of the internal `email_sends.id`. Used by the
|
|
61
|
+
* provider-webhook enrichment path (`email.delivered`/`email.bounced`) where the
|
|
62
|
+
* only handle we hold is the provider message id.
|
|
63
|
+
*
|
|
64
|
+
* Returns the internal `emailSendId` plus the same denormalized identity
|
|
65
|
+
* (`userId`/`userEmail` fall back to the recipient address, exactly like the
|
|
66
|
+
* id-keyed resolver) and `to` recipient. Returns null when no send row carries
|
|
67
|
+
* that `messageId` yet (e.g. a webhook arriving before the send row is committed).
|
|
68
|
+
*/
|
|
69
|
+
export declare function resolveEmailSendContextByMessageId(db: Database, messageId: string): Promise<EmailSendContextByMessageId | null>;
|
|
70
|
+
/**
|
|
71
|
+
* @deprecated Renamed to {@link resolveEmailSendContextByMessageId} as part of
|
|
72
|
+
* the provider-neutral `resendId` → `messageId` rename. Kept as an alias for one
|
|
73
|
+
* minor; removed the following minor.
|
|
74
|
+
*/
|
|
75
|
+
export declare const resolveEmailSendContextByResendId: typeof resolveEmailSendContextByMessageId;
|
|
76
|
+
export interface PushTrackingEventOpts {
|
|
77
|
+
db: Database;
|
|
78
|
+
hatchet: HatchetClient;
|
|
79
|
+
registry: JourneyRegistry;
|
|
80
|
+
logger: Logger;
|
|
81
|
+
event: string;
|
|
82
|
+
emailSendId: string;
|
|
83
|
+
properties?: Record<string, unknown>;
|
|
84
|
+
/**
|
|
85
|
+
* Pre-resolved send context. When provided (including `null`), the duplicate
|
|
86
|
+
* `resolveEmailSendContext` read is skipped — the tracking routes resolve once
|
|
87
|
+
* and share the result with the outbound emit on the hot path. Omit to resolve
|
|
88
|
+
* lazily.
|
|
89
|
+
*/
|
|
90
|
+
resolvedContext?: EmailSendContext | null;
|
|
91
|
+
/**
|
|
92
|
+
* Threaded straight into `ingestEvent` — a duplicate key returns
|
|
93
|
+
* `{ stored: false }` BEFORE the Hatchet push, so journeys never see the
|
|
94
|
+
* duplicate. Semantic link answers use `sem:<emailSendId>:<event>` for
|
|
95
|
+
* first-answer-per-send semantics.
|
|
96
|
+
*/
|
|
97
|
+
idempotencyKey?: string;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Re-push a first-party tracking event (open/click) back onto the INTERNAL bus
|
|
101
|
+
* (`ingestEvent`) for journey routing + `userEvents` persistence.
|
|
102
|
+
*
|
|
103
|
+
* NOTE (Phase 2): this NO LONGER fires a fire-and-forget PostHog `captureEvent`.
|
|
104
|
+
* PostHog now receives opens/clicks PER-HIT via the durable outbound spine — a
|
|
105
|
+
* `kind="posthog"` destination subscribed to `email.opened`/`email.clicked` (the
|
|
106
|
+
* tracking routes call `emitOutbound` alongside this). The legacy double-emit was
|
|
107
|
+
* removed so PostHog gets exactly one, durable copy of each hit.
|
|
108
|
+
*/
|
|
109
|
+
export declare function pushTrackingEvent(opts: PushTrackingEventOpts): Promise<IngestResult | undefined>;
|
|
110
|
+
export interface PushLinkClickEventOpts {
|
|
111
|
+
db: Database;
|
|
112
|
+
hatchet: HatchetClient;
|
|
113
|
+
registry: JourneyRegistry;
|
|
114
|
+
logger: Logger;
|
|
115
|
+
/**
|
|
116
|
+
* The MANAGED `links.id` — the durable, re-mint-safe key a journey filters on
|
|
117
|
+
* via `trigger.where`/`ctx.waitForEvent` (`where: b.prop("linkId").eq(...)`).
|
|
118
|
+
* Null when the tracked link has no managed parent row.
|
|
119
|
+
*/
|
|
120
|
+
linkId: string | null;
|
|
121
|
+
/** The `tracked_links.id` (the redirect `:id`); disambiguates a re-mint. */
|
|
122
|
+
trackedLinkId: string;
|
|
123
|
+
campaign: string | null;
|
|
124
|
+
source: string | null;
|
|
125
|
+
linkType: string | null;
|
|
126
|
+
linkUrl: string;
|
|
127
|
+
/**
|
|
128
|
+
* The personal link's canonical contact key (`links.distinct_id`). MUST be the
|
|
129
|
+
* subject's EXTERNAL canonical key (an app `external_id`) or the contact's
|
|
130
|
+
* canonical uuid key — a raw snowflake or anonymous id would fork an orphan
|
|
131
|
+
* contact. NOTE: a Discord member is keyed by the `discord_id` COLUMN, not an
|
|
132
|
+
* `external_id`, so a `"discord:<id>"` value here would fork an orphan contact;
|
|
133
|
+
* reach a discord-keyed contact by its resolved canonical key instead. Null ⇒
|
|
134
|
+
* a broadcast/public link (no person) ⇒ no re-ingest.
|
|
135
|
+
*/
|
|
136
|
+
distinctId: string | null;
|
|
137
|
+
idempotencyKey?: string;
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Re-push a NON-email managed-link click onto the INTERNAL bus (`ingestEvent`)
|
|
141
|
+
* as the first-party `link.clicked` event so journeys can trigger / await a
|
|
142
|
+
* click of a SPECIFIC managed link (filtered by `linkId`/`campaign`).
|
|
143
|
+
*
|
|
144
|
+
* IDENTITY GATE (crash-guard): the resolve THROWS on a zero-key event, so a
|
|
145
|
+
* broadcast/public link (`distinctId == null`) returns `undefined` WITHOUT
|
|
146
|
+
* calling ingest. The click route ALSO suppresses bot/prefetch hits upstream
|
|
147
|
+
* (`isBotOrPrefetch`), so an unfurl bot never reaches here. All six payload
|
|
148
|
+
* keys are scalars (or null) so they survive ingest and reach `trigger.where` +
|
|
149
|
+
* `waitForEvent.properties`.
|
|
150
|
+
*
|
|
151
|
+
* NEVER MINTS (D11). This is a re-ingest DERIVED from an earlier observation,
|
|
152
|
+
* so it inherits that observation's refusal — `allowCreate: false`. `mintLink`
|
|
153
|
+
* copies whatever `distinctId` the caller passes for a `personal` link, so a
|
|
154
|
+
* link minted for a visitor who was never identified carries an ANON key; with
|
|
155
|
+
* creation allowed the create arm wrote `external_id = <anonId>`, the shape
|
|
156
|
+
* #621 calls strictly WORSE than the ghost it replaces (it then answers
|
|
157
|
+
* `collidesWithIdentified` (contacts.ts) and 403-locks the visitor out of their
|
|
158
|
+
* own feed). Safe by construction: a link carrying a `distinctId` was minted for
|
|
159
|
+
* someone already known, so either the key resolves — fill-in-link, unchanged —
|
|
160
|
+
* or it was refused at observation time and must STAY refused.
|
|
161
|
+
*
|
|
162
|
+
* Unlike `sendFeedItem`'s `userId` arm (lib/feed.ts), the mint here has no
|
|
163
|
+
* confidentiality role. There it is load-bearing: the minted row is the only
|
|
164
|
+
* signal `collidesWithIdentified` has, and refusing would convert a private
|
|
165
|
+
* feed row into an anon-addressable one. This is an event ingest, not a
|
|
166
|
+
* feed-read authorization — `collidesWithIdentified` is consulted only by
|
|
167
|
+
* `routes/feed/recipient.ts` and `routes/tracking/arrive.ts`, neither of which
|
|
168
|
+
* reads anything this function writes.
|
|
169
|
+
*
|
|
170
|
+
* Nothing is lost by the refusal: `resolvedKey` is always a real string (D8),
|
|
171
|
+
* so `user_events` still stores under the same key and journeys still trigger.
|
|
172
|
+
* `tracked_links` has no `contact_id` column (only `distinctId`), so inheriting
|
|
173
|
+
* the refusal is the correct fix rather than threading a provenance pin — if a
|
|
174
|
+
* later change adds `contact_id` there, revisit.
|
|
175
|
+
*
|
|
176
|
+
* Distinct from the per-hit OUTBOUND `link.clicked` webhook: that fires for
|
|
177
|
+
* EVERY hit and carries `trackedLinks.id` + the raw mint distinctId; THIS bus
|
|
178
|
+
* event carries the managed `links.id` + the resolved survivor contact key.
|
|
179
|
+
*/
|
|
180
|
+
export declare function pushLinkClickEvent(opts: PushLinkClickEventOpts): Promise<IngestResult | undefined>;
|
|
181
|
+
export interface SmsSendContext {
|
|
182
|
+
/**
|
|
183
|
+
* The resolved contact key: the enrollment's userId, else the send row's
|
|
184
|
+
* denormalized userId, else NULL. Deliberately NO phone fallback — phone is
|
|
185
|
+
* not a merge-participating contact `Kind`, so a phone-keyed ingest would
|
|
186
|
+
* fork an orphan contact.
|
|
187
|
+
*/
|
|
188
|
+
userId: string | null;
|
|
189
|
+
userEmail: string | null;
|
|
190
|
+
/**
|
|
191
|
+
* PRD 05 T6 — the enrollment's contact stamp (`sms_sends` itself carries no
|
|
192
|
+
* dual-write column). Null for a journeyless send.
|
|
193
|
+
*/
|
|
194
|
+
contactId: string | null;
|
|
195
|
+
templateKey: string | null;
|
|
196
|
+
messageId: string | null;
|
|
197
|
+
to: string;
|
|
198
|
+
/**
|
|
199
|
+
* Attribution scope (plan §1.2): the enrollment's journey id. No campaign
|
|
200
|
+
* leg — campaign steps are email-only today, so `sms_sends` carries no
|
|
201
|
+
* campaign column (plan §5 Q3).
|
|
202
|
+
*/
|
|
203
|
+
journeyId: string | null;
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* The SMS sibling of {@link resolveEmailSendContext}: one LEFT JOIN from
|
|
207
|
+
* `sms_sends` to `journey_states` giving the click pipeline the identity +
|
|
208
|
+
* template context for the bus re-ingest and the `sms.clicked` outbound emit.
|
|
209
|
+
*/
|
|
210
|
+
export declare function resolveSmsSendContext(db: Database, smsSendId: string | null): Promise<SmsSendContext | null>;
|
|
211
|
+
export interface PushSmsTrackingEventOpts {
|
|
212
|
+
db: Database;
|
|
213
|
+
hatchet: HatchetClient;
|
|
214
|
+
registry: JourneyRegistry;
|
|
215
|
+
logger: Logger;
|
|
216
|
+
event: string;
|
|
217
|
+
smsSendId: string;
|
|
218
|
+
properties?: Record<string, unknown>;
|
|
219
|
+
/** Pre-resolved send context (including null) skips the duplicate read. */
|
|
220
|
+
resolvedContext?: SmsSendContext | null;
|
|
221
|
+
idempotencyKey?: string;
|
|
222
|
+
}
|
|
223
|
+
/**
|
|
224
|
+
* Re-push a first-party SMS tracking event (short-link click) onto the
|
|
225
|
+
* INTERNAL bus for journey routing + `userEvents` persistence — the SMS
|
|
226
|
+
* sibling of {@link pushTrackingEvent}. Returns undefined without ingesting
|
|
227
|
+
* when the send has no resolvable contact key (`ingestEvent` throws on a
|
|
228
|
+
* zero-key event, and phone is not a contact key).
|
|
229
|
+
*/
|
|
230
|
+
export declare function pushSmsTrackingEvent(opts: PushSmsTrackingEventOpts): Promise<IngestResult | undefined>;
|
|
231
|
+
export {};
|
|
232
|
+
//# sourceMappingURL=tracking-events.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracking-events.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,KAAK,QAAQ,EAId,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,UAAU,gBAAgB;IACxB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAuClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CA6B7C;AAED;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,2CACV,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAoCnC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA0BnC;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8BhC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA+BnC"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { Database } from "@hogsend/db";
|
|
2
|
+
/** Never rewrite unsubscribe/preference URLs (shared with the SMS rewriter). */
|
|
3
|
+
export declare function shouldSkipUrl(url: string): boolean;
|
|
4
|
+
export declare function rewriteLinks(opts: {
|
|
5
|
+
html: string;
|
|
6
|
+
emailSendId: string;
|
|
7
|
+
baseUrl: string;
|
|
8
|
+
db: Database;
|
|
9
|
+
}): Promise<string>;
|
|
10
|
+
export declare function injectOpenPixel(opts: {
|
|
11
|
+
html: string;
|
|
12
|
+
emailSendId: string;
|
|
13
|
+
baseUrl: string;
|
|
14
|
+
}): string;
|
|
15
|
+
export declare function prepareTrackedHtml(opts: {
|
|
16
|
+
html: string;
|
|
17
|
+
emailSendId: string;
|
|
18
|
+
baseUrl: string;
|
|
19
|
+
db: Database;
|
|
20
|
+
}): Promise<string>;
|
|
21
|
+
/**
|
|
22
|
+
* The mint surface for a NON-email tracked link (Discord, referral, ad-hoc).
|
|
23
|
+
* Inserts a `tracked_links` row with a NULL `emailSendId` and returns the
|
|
24
|
+
* `/v1/t/c/:id` redirect URL to use in place of the raw destination.
|
|
25
|
+
*
|
|
26
|
+
* This is the SINGLE chokepoint enforcing "broadcast links carry no subject":
|
|
27
|
+
* a link only becomes identity-bearing when the caller EXPLICITLY passes
|
|
28
|
+
* `distinctId` (the canonical contact key the click should stitch into). Per
|
|
29
|
+
* MF-4, the referral path does NOT pass `distinctId` by default (referral
|
|
30
|
+
* pages are shareable → broadcast), and the Discord destination passes
|
|
31
|
+
* `distinctId: undefined`. The `hs_t` mint at click time is still gated by
|
|
32
|
+
* `TRACKING_IDENTITY_TOKEN` (default false); a row with a NULL `distinctId`
|
|
33
|
+
* never mints a token regardless.
|
|
34
|
+
*/
|
|
35
|
+
export declare function createTrackedLink(opts: {
|
|
36
|
+
db: Database;
|
|
37
|
+
url: string;
|
|
38
|
+
/**
|
|
39
|
+
* The canonical contact key a click should fold the visitor's anon session
|
|
40
|
+
* into. OMIT for a broadcast link (the safe default) — only an explicit,
|
|
41
|
+
* single-subject, non-shareable link should pass this.
|
|
42
|
+
*/
|
|
43
|
+
distinctId?: string;
|
|
44
|
+
source: "discord" | "referral" | "link";
|
|
45
|
+
baseUrl: string;
|
|
46
|
+
}): Promise<string>;
|
|
47
|
+
//# sourceMappingURL=tracking.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/lib/tracking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8B5C,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAwFD,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,QAAQ,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ElB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAUT;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,QAAQ,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The inert email provider a container boots with when NO provider is
|
|
3
|
+
* configured and none was explicitly requested (mirrors the SMS channel's
|
|
4
|
+
* operator-opt-in posture: unconfigured ⇒ inert stub, not a boot crash).
|
|
5
|
+
*
|
|
6
|
+
* A fresh scaffold has no RESEND_API_KEY yet — it should still boot, serve
|
|
7
|
+
* Studio, ingest events and run non-email journeys. Every email send fails
|
|
8
|
+
* per-call with this actionable message instead; the container logs one boot
|
|
9
|
+
* warning. Never registered in the provider registry, so no webhook route
|
|
10
|
+
* resolves it.
|
|
11
|
+
*
|
|
12
|
+
* DELIBERATE seam choice (vs SMS's service-level stub): the stub is the WIRE
|
|
13
|
+
* inside the real tracked mailer, so an unconfigured send still runs the
|
|
14
|
+
* pipeline (preferences → render → tracking → `email_sends` write) and fails
|
|
15
|
+
* at dispatch — leaving a failed-send row visible in Studio, which is exactly
|
|
16
|
+
* the operator-facing breadcrumb a "why didn't my email go out?" moment needs.
|
|
17
|
+
*/
|
|
18
|
+
export declare const UNCONFIGURED_EMAIL_MESSAGE: string;
|
|
19
|
+
export declare function createUnconfiguredEmailProvider(): import("@hogsend/core").EmailProvider;
|
|
20
|
+
//# sourceMappingURL=unconfigured-email-provider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"unconfigured-email-provider.d.ts","sourceRoot":"","sources":["../../src/lib/unconfigured-email-provider.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,0BAA0B,QAGb,CAAC;AAE3B,wBAAgB,+BAA+B,0CAoB9C"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PRD 05 T3 — the shared "was this a unique_violation on THAT index?" probe.
|
|
3
|
+
*
|
|
4
|
+
* The contact-scoped uniqueness indexes are pure CONSTRAINTS: no upsert names
|
|
5
|
+
* them as an `ON CONFLICT` arbiter, because drizzle can only target columns and
|
|
6
|
+
* a bare `(contact_id, …)` arbiter would never fire for the NULL (contactless)
|
|
7
|
+
* population — an anonymous re-trigger would then insert a second row and die on
|
|
8
|
+
* the retained string index. So each writer keeps its string arbiter and
|
|
9
|
+
* converts THIS error into its own already-exists branch.
|
|
10
|
+
*
|
|
11
|
+
* Postgres reports the code as 23505 and names the index in `constraint_name`,
|
|
12
|
+
* but drizzle wraps the driver error in a `DrizzleQueryError`, so the real
|
|
13
|
+
* payload lives on `cause` (sometimes nested) — walk the chain, bounded. Mirrors
|
|
14
|
+
* `isSlugUniqueViolation` (lib/links.ts) and `isPhoneUniqueViolation`
|
|
15
|
+
* (lib/contacts.ts); this is the extracted, shared form.
|
|
16
|
+
*/
|
|
17
|
+
export declare function isUniqueViolationOn(err: unknown, index: string): boolean;
|
|
18
|
+
/** `journey_states` — one live enrollment per (contact, journey). */
|
|
19
|
+
export declare const UQ_CONTACT_JOURNEY_ACTIVE = "uq_contact_journey_active";
|
|
20
|
+
/** `email_preferences` — one row per (contact, email). */
|
|
21
|
+
export declare const UQ_CONTACT_EMAIL_PREFERENCES = "email_preferences_contact_email_idx";
|
|
22
|
+
//# sourceMappingURL=unique-violation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"unique-violation.d.ts","sourceRoot":"","sources":["../../src/lib/unique-violation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAoBxE;AAED,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,wCACF,CAAC"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The publishable-key `userToken` — a short-lived HMAC over a `userId`, signed
|
|
3
|
+
* with `BETTER_AUTH_SECRET` (the same trust root as the `hs_t` identity token).
|
|
4
|
+
*
|
|
5
|
+
* Unlike `hs_t` (AES-256-GCM ENCRYPTED, because it can carry an email), this
|
|
6
|
+
* token is SIGNED-NOT-ENCRYPTED: it carries only a `userId` the integrating
|
|
7
|
+
* server already knows and chose to assert, so there is no PII to hide — only
|
|
8
|
+
* integrity (a browser must not be able to forge another person's userId) to
|
|
9
|
+
* guarantee.
|
|
10
|
+
*
|
|
11
|
+
* v1 use: a publishable (pk_) key is ANON-ONLY by default. To act on a concrete
|
|
12
|
+
* `userId`, the browser must present a `userToken` the integrating server minted
|
|
13
|
+
* SERVER-SIDE (v3 ships the mint helper into the SDK / a signing endpoint). In
|
|
14
|
+
* v1 the VERIFY function exists and is wired into every publishable-reachable
|
|
15
|
+
* handler, but with no mint path exposed a pk_ key is effectively anon-only —
|
|
16
|
+
* the secure default, and the point.
|
|
17
|
+
*/
|
|
18
|
+
export interface UserTokenPayload {
|
|
19
|
+
userId: string;
|
|
20
|
+
exp: number;
|
|
21
|
+
}
|
|
22
|
+
export declare class InvalidUserTokenError extends Error {
|
|
23
|
+
constructor(message: string);
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* MINT helper — v3. Present but UNUSED by the engine in v1 (publishable keys are
|
|
27
|
+
* anon-only by default). Wired here so v3 can expose a signer (SDK / endpoint)
|
|
28
|
+
* without re-touching the verify path. Produces `<base64url(payload)>.<sig>`.
|
|
29
|
+
*/
|
|
30
|
+
export declare function generateUserToken(opts: {
|
|
31
|
+
secret: string;
|
|
32
|
+
userId: string;
|
|
33
|
+
expiresInSeconds?: number;
|
|
34
|
+
}): string;
|
|
35
|
+
/**
|
|
36
|
+
* VERIFY: parse `<base64url(payload)>.<sig>`, verify the HMAC in constant time,
|
|
37
|
+
* and check expiry. Throws {@link InvalidUserTokenError} on any failure
|
|
38
|
+
* (malformed, bad signature, bad payload shape, expired).
|
|
39
|
+
*/
|
|
40
|
+
export declare function verifyUserToken(opts: {
|
|
41
|
+
token: string;
|
|
42
|
+
secret: string;
|
|
43
|
+
}): UserTokenPayload;
|
|
44
|
+
//# sourceMappingURL=user-token.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"user-token.d.ts","sourceRoot":"","sources":["../../src/lib/user-token.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAQD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAST;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,gBAAgB,CAiCnB"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Uniform 0-9999 bucket. Hash input is `variant:<journeyId>:<key>:<userId>`
|
|
3
|
+
* — the `variant:` prefix + the key segment make this hash family DISJOINT
|
|
4
|
+
* from holdoutBucket's `<salt>:<journeyId>:<userId>` (holdout.ts:17), so
|
|
5
|
+
* variant assignment is statistically independent of holdout assignment.
|
|
6
|
+
* `key` cannot contain `:` (validated), so segments are unambiguous.
|
|
7
|
+
* FROZEN COMPATIBILITY CONTRACT under the replay law — locked by a
|
|
8
|
+
* golden-value test; changing it re-buckets live experiments mid-flight.
|
|
9
|
+
*/
|
|
10
|
+
export declare function variantBucket(opts: {
|
|
11
|
+
journeyId: string;
|
|
12
|
+
key: string;
|
|
13
|
+
userId: string;
|
|
14
|
+
}): number;
|
|
15
|
+
/**
|
|
16
|
+
* Key-syntax-only check — runs BEFORE the recordOnce read (it gates the
|
|
17
|
+
* jsonb path). Throws RangeError. 1-64 chars of [A-Za-z0-9_.-], starting
|
|
18
|
+
* with a letter or digit; no `:` (it delimits the hash-input segments) and
|
|
19
|
+
* no whitespace.
|
|
20
|
+
*/
|
|
21
|
+
export declare function validateVariantKey(key: string): void;
|
|
22
|
+
/**
|
|
23
|
+
* Arms validation — runs ONLY inside the compute path (see performVariant
|
|
24
|
+
* in journeys/journey-context.ts): an enrollment with a recorded arm must
|
|
25
|
+
* never crash on a later deploy that ships malformed arms. Throws
|
|
26
|
+
* RangeError on: zero arms (JS callers; TS blocks via the tuple type),
|
|
27
|
+
* empty/non-string arm, duplicate arms.
|
|
28
|
+
*/
|
|
29
|
+
export declare function validateVariantArms(arms: readonly string[]): void;
|
|
30
|
+
/**
|
|
31
|
+
* Deterministically pick one arm, equal split. Threshold for arm i is
|
|
32
|
+
* Math.round(((i + 1) / arms.length) * 10000); the LAST arm is forced to
|
|
33
|
+
* 10000 so rounding can never leave bucket 9999 unassigned. Weighted arms
|
|
34
|
+
* are deliberately NOT supported (v1 = equal split; a weight edit would
|
|
35
|
+
* remap buckets and reassign re-entrants of unlimited/once_per_period
|
|
36
|
+
* journeys — see the impact-experiments design spec, D2).
|
|
37
|
+
*/
|
|
38
|
+
export declare function pickVariant(opts: {
|
|
39
|
+
journeyId: string;
|
|
40
|
+
key: string;
|
|
41
|
+
userId: string;
|
|
42
|
+
arms: readonly string[];
|
|
43
|
+
}): string;
|
|
44
|
+
//# sourceMappingURL=variant.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"variant.d.ts","sourceRoot":"","sources":["../../src/lib/variant.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQpD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAkBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB,GAAG,MAAM,CAST"}
|