@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,56 @@
|
|
|
1
|
+
import { type Database } from "@hogsend/db";
|
|
2
|
+
import { type LiftVerdict } from "./lift-stats.js";
|
|
3
|
+
/**
|
|
4
|
+
* Counts-only cohort: the /lift route merges per-currency values back in
|
|
5
|
+
* (computeLiftValues); the phase-2b /impact overall block and the phase-3b
|
|
6
|
+
* digest consume counts as-is.
|
|
7
|
+
*/
|
|
8
|
+
export interface LiftCohort {
|
|
9
|
+
contacts: number;
|
|
10
|
+
converters: number;
|
|
11
|
+
rate: number;
|
|
12
|
+
}
|
|
13
|
+
export interface JourneyLiftResult {
|
|
14
|
+
treatment: LiftCohort;
|
|
15
|
+
control: LiftCohort;
|
|
16
|
+
verdict: LiftVerdict;
|
|
17
|
+
}
|
|
18
|
+
interface LiftQueryOpts {
|
|
19
|
+
db: Database;
|
|
20
|
+
journeyId: string;
|
|
21
|
+
since: Date;
|
|
22
|
+
/** Snapshot instant; defaults to now (both bounds become no-ops). */
|
|
23
|
+
asOf?: Date;
|
|
24
|
+
/** Scope the outcome to one conversion definition; default any. */
|
|
25
|
+
definitionId?: string;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Holdout lift for one journey — the ONE implementation of the causal math
|
|
29
|
+
* (routes/admin/funnels.ts:16 law). Treatment = status != 'held_out';
|
|
30
|
+
* control = status = 'held_out'; outcome = ≥1 qualifying conversions row
|
|
31
|
+
* with occurred_at >= the state row's created_at (intent-to-treat clock).
|
|
32
|
+
*
|
|
33
|
+
* `asOf` (default: now) snapshots the read: cohort rows require
|
|
34
|
+
* created_at < asOf and conversions require occurred_at <= asOf. With
|
|
35
|
+
* asOf = now both bounds are no-ops (future-dated rows cannot exist), so
|
|
36
|
+
* the /lift route's behavior is unchanged by the extraction — pinned by a
|
|
37
|
+
* regression fixture (apps/api journey-lift.test.ts).
|
|
38
|
+
*/
|
|
39
|
+
export declare function computeJourneyLift(opts: LiftQueryOpts): Promise<JourneyLiftResult>;
|
|
40
|
+
/**
|
|
41
|
+
* Per-currency qualifying conversion value for both cohorts (full value,
|
|
42
|
+
* not fractional credit). Kept SEPARATE from the counts helper: /lift
|
|
43
|
+
* composes it into its wire shape; the digest and overview never need it.
|
|
44
|
+
*/
|
|
45
|
+
export declare function computeLiftValues(opts: LiftQueryOpts): Promise<{
|
|
46
|
+
treatment: Array<{
|
|
47
|
+
currency: string | null;
|
|
48
|
+
value: number;
|
|
49
|
+
}>;
|
|
50
|
+
control: Array<{
|
|
51
|
+
currency: string | null;
|
|
52
|
+
value: number;
|
|
53
|
+
}>;
|
|
54
|
+
}>;
|
|
55
|
+
export {};
|
|
56
|
+
//# sourceMappingURL=journey-lift.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journey-lift.d.ts","sourceRoot":"","sources":["../../src/lib/journey-lift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,UAAU,aAAa;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,CAAC;IACZ,qEAAqE;IACrE,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAcD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAuD5B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;IACpE,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAAC,CA+BD"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import type { Database } from "@hogsend/db";
|
|
2
|
+
import type { JourneyBoundary } from "../journeys/journey-boundary.js";
|
|
3
|
+
/**
|
|
4
|
+
* True if a non-failed `email_sends` row exists for THIS journey — across ALL
|
|
5
|
+
* of its enrollments — to THIS recipient within the suppress window. The
|
|
6
|
+
* INNER JOIN to `journey_states` on `journey_state_id`, filtered by
|
|
7
|
+
* `journey_id`, is what crosses enrollments: `meta.suppress` is a per-JOURNEY
|
|
8
|
+
* min-gap, not per-enrollment, so a re-enrollment inside the window is still
|
|
9
|
+
* gapped. Failed rows (`status = 'failed'`, never dispatched) are excluded,
|
|
10
|
+
* mirroring {@link countRecentSends}. EXISTS semantics only — `limit(1)`, no
|
|
11
|
+
* count needed.
|
|
12
|
+
*/
|
|
13
|
+
export declare function hasRecentJourneySend(opts: {
|
|
14
|
+
db: Database;
|
|
15
|
+
journeyId: string;
|
|
16
|
+
to: string;
|
|
17
|
+
since: Date;
|
|
18
|
+
}): Promise<boolean>;
|
|
19
|
+
/**
|
|
20
|
+
* The SMS leg of {@link hasRecentJourneySend}: same cross-enrollment EXISTS
|
|
21
|
+
* over `sms_sends` keyed by recipient phone. `meta.suppress` is a per-journey,
|
|
22
|
+
* per-recipient min-gap — it must gap SMS exactly as it gaps email.
|
|
23
|
+
*/
|
|
24
|
+
export declare function hasRecentJourneySmsSend(opts: {
|
|
25
|
+
db: Database;
|
|
26
|
+
journeyId: string;
|
|
27
|
+
to: string;
|
|
28
|
+
since: Date;
|
|
29
|
+
}): Promise<boolean>;
|
|
30
|
+
/**
|
|
31
|
+
* The RECORDED-once journey-suppress verdict for a boundary send. Returns
|
|
32
|
+
* `{ suppressed }` — `true` means the tracked mailer must skip the send
|
|
33
|
+
* (`journey_suppressed`, no provider call, no `email_sends` row).
|
|
34
|
+
*
|
|
35
|
+
* REPLAY STABILITY (non-negotiable): the live EXISTS check diverges on replay —
|
|
36
|
+
* the run's OWN send lands in the window, so an originally-ALLOWED send would
|
|
37
|
+
* re-check as suppressed (a late duplicate), and an originally-SUPPRESSED send
|
|
38
|
+
* could re-check as allowed if the blocking row was purged. So the verdict is
|
|
39
|
+
* frozen set-once under `context.__throttle__` keyed by the send's resolved
|
|
40
|
+
* idempotency key (already per-run-unique via `registerKey`, so it needs no
|
|
41
|
+
* extra registration) and replayed verbatim thereafter — durable on ANY engine.
|
|
42
|
+
*
|
|
43
|
+
* The guard is INERT (returns `{ suppressed: false }` without touching the DB)
|
|
44
|
+
* when there is no boundary, no `journeyId`, a zero `suppressMs`, or no resolved
|
|
45
|
+
* idempotency key — i.e. every non-journey / transactional send is unaffected.
|
|
46
|
+
*/
|
|
47
|
+
export declare function checkJourneySuppress(opts: {
|
|
48
|
+
db: Database;
|
|
49
|
+
boundary: JourneyBoundary | undefined;
|
|
50
|
+
to: string;
|
|
51
|
+
idempotencyKey: string | undefined;
|
|
52
|
+
/** Which channel's send history the min-gap EXISTS runs against. */
|
|
53
|
+
channel?: "email" | "sms";
|
|
54
|
+
/** Injectable clock for tests; defaults to the live wall clock. */
|
|
55
|
+
now?: number;
|
|
56
|
+
}): Promise<{
|
|
57
|
+
suppressed: boolean;
|
|
58
|
+
}>;
|
|
59
|
+
//# sourceMappingURL=journey-suppress.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journey-suppress.d.ts","sourceRoot":"","sources":["../../src/lib/journey-suppress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,CAAC;CACb,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBnB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,CAAC;CACb,GAAG,OAAO,CAAC,OAAO,CAAC,CAenB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC1B,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CA0BnC"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { Redis } from "ioredis";
|
|
2
|
+
/** A process-unique fencing token to stamp on an acquired lease. */
|
|
3
|
+
export declare function newLeaseToken(): string;
|
|
4
|
+
/**
|
|
5
|
+
* Try to acquire the lease. Returns `true` only when this call set the key (it
|
|
6
|
+
* was absent). A `false` means another holder owns it OR Redis is unreachable —
|
|
7
|
+
* either way the caller must NOT open the socket.
|
|
8
|
+
*/
|
|
9
|
+
export declare function acquireLeaderLease(args: {
|
|
10
|
+
key: string;
|
|
11
|
+
token: string;
|
|
12
|
+
ttlMs: number;
|
|
13
|
+
redis?: Redis;
|
|
14
|
+
}): Promise<boolean>;
|
|
15
|
+
/**
|
|
16
|
+
* Renew our hold on the lease (compare-and-extend). Returns `false` if we no
|
|
17
|
+
* longer own it (expired / taken over) or Redis is unreachable — the caller must
|
|
18
|
+
* then self-demote and stop the socket.
|
|
19
|
+
*/
|
|
20
|
+
export declare function renewLeaderLease(args: {
|
|
21
|
+
key: string;
|
|
22
|
+
token: string;
|
|
23
|
+
ttlMs: number;
|
|
24
|
+
redis?: Redis;
|
|
25
|
+
}): Promise<boolean>;
|
|
26
|
+
/**
|
|
27
|
+
* Release the lease if (and only if) we still own it. Best-effort: a failure is
|
|
28
|
+
* swallowed because the TTL expires the key anyway. Returns `true` when our own
|
|
29
|
+
* key was deleted.
|
|
30
|
+
*/
|
|
31
|
+
export declare function releaseLeaderLease(args: {
|
|
32
|
+
key: string;
|
|
33
|
+
token: string;
|
|
34
|
+
redis?: Redis;
|
|
35
|
+
}): Promise<boolean>;
|
|
36
|
+
//# sourceMappingURL=leader-lease.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"leader-lease.d.ts","sourceRoot":"","sources":["../../src/lib/leader-lease.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAgCrC,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAQnB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAcnB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAQnB"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Holdout lift statistics: Bayesian beta-binomial with a uniform Beta(1,1)
|
|
3
|
+
* prior — the
|
|
4
|
+
* lean, honest method at self-hosted volumes. Win probability is
|
|
5
|
+
* P(treatment rate > control rate) under independent posteriors
|
|
6
|
+
* Beta(k+1, n−k+1), computed by DETERMINISTIC numeric integration (no
|
|
7
|
+
* sampling — stable across runs and trivially testable).
|
|
8
|
+
*
|
|
9
|
+
* Presentation guards, per the plan's honesty stance:
|
|
10
|
+
* - suppression floor: fewer than {@link MIN_COMBINED_CONVERSIONS} combined
|
|
11
|
+
* conversions ⇒ no win probability at all (Klaviyo suppresses at the same
|
|
12
|
+
* threshold; below it the number is noise wearing a percentage sign);
|
|
13
|
+
* - small-sample flag: either cohort under {@link SMALL_SAMPLE_FLOOR}
|
|
14
|
+
* contacts ⇒ `smallSample: true` so surfaces can warn loudly (Braze's
|
|
15
|
+
* rule of thumb is ~1,000; we present rather than lock out).
|
|
16
|
+
*/
|
|
17
|
+
export declare const MIN_COMBINED_CONVERSIONS = 10;
|
|
18
|
+
export declare const SMALL_SAMPLE_FLOOR = 100;
|
|
19
|
+
/**
|
|
20
|
+
* P(X > Y) for X ~ Beta(a1,b1), Y ~ Beta(a2,b2): midpoint-rule integration
|
|
21
|
+
* of ∫ f_X(x)·F_Y(x) dx. Midpoints (never 0 or 1) sidestep the boundary —
|
|
22
|
+
* Beta pdfs are singular or discontinuous there for shape params ≤ 1, which
|
|
23
|
+
* a trapezoid pass silently truncates.
|
|
24
|
+
*/
|
|
25
|
+
export declare function betaWinProbability(a1: number, b1: number, a2: number, b2: number): number;
|
|
26
|
+
export interface LiftVerdict {
|
|
27
|
+
/** (treatmentRate − controlRate) / controlRate; null when control is 0. */
|
|
28
|
+
liftPercent: number | null;
|
|
29
|
+
/** P(treatment > control); null when suppressed. */
|
|
30
|
+
winProbability: number | null;
|
|
31
|
+
/** True when combined conversions are under the suppression floor. */
|
|
32
|
+
suppressed: boolean;
|
|
33
|
+
/** True when either cohort is under the small-sample floor. */
|
|
34
|
+
smallSample: boolean;
|
|
35
|
+
}
|
|
36
|
+
export declare function computeLift(opts: {
|
|
37
|
+
treatment: {
|
|
38
|
+
contacts: number;
|
|
39
|
+
converters: number;
|
|
40
|
+
};
|
|
41
|
+
control: {
|
|
42
|
+
contacts: number;
|
|
43
|
+
converters: number;
|
|
44
|
+
};
|
|
45
|
+
}): LiftVerdict;
|
|
46
|
+
//# sourceMappingURL=lift-stats.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lift-stats.d.ts","sourceRoot":"","sources":["../../src/lib/lift-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAwCtC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,MAAM,CAcR;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oDAAoD;IACpD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD,GAAG,WAAW,CAyBd"}
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
import { type Database } from "@hogsend/db";
|
|
2
|
+
/**
|
|
3
|
+
* The channel-agnostic MANAGED tracked-link mint — the counterpart to the email
|
|
4
|
+
* HTML-rewrite path (`prepareTrackedHtml`). Any non-email channel (the Studio
|
|
5
|
+
* Links UI, a Discord DM/channel post, SMS, a share link) mints through here.
|
|
6
|
+
*
|
|
7
|
+
* It inserts a durable `links` row (the operator/campaign identity that the
|
|
8
|
+
* Studio lists + manages) plus a `tracked_links` click-counter row pointing back
|
|
9
|
+
* at it, and returns the `/v1/t/c/:id` redirect URL. Email does NOT use this — it
|
|
10
|
+
* rewrites HTML at send time and keeps `tracked_links.link_id` NULL, so the two
|
|
11
|
+
* remain independent consumers of the same click spine.
|
|
12
|
+
*
|
|
13
|
+
* SHARE-SAFE INVARIANT: a link is identity-bearing (carries a `distinctId` the
|
|
14
|
+
* click can stitch + may mint a single-use `hs_t`) ONLY when `type: "personal"`
|
|
15
|
+
* AND an explicit `distinctId` is passed. A `"public"` link NEVER carries a
|
|
16
|
+
* person token - a shared/reshared public link attributes by campaign only.
|
|
17
|
+
* `"shared"` (a referral link) is owned by a person and clicked by SOMEONE
|
|
18
|
+
* ELSE, so it sits on the PUBLIC side of that invariant: it attributes to
|
|
19
|
+
* `ownerContactId` and stitches nobody.
|
|
20
|
+
*/
|
|
21
|
+
export type LinkType = "personal" | "public" | "shared";
|
|
22
|
+
/**
|
|
23
|
+
* Thrown when the `shared` link ownership invariant is broken (PRD 05 5.2):
|
|
24
|
+
* a `shared` link with no `ownerContactId` credits nobody, and an
|
|
25
|
+
* `ownerContactId` on a `personal`/`public` link is a silent no-op that reads
|
|
26
|
+
* as if attribution were configured. Both are authoring errors, so they throw
|
|
27
|
+
* at mint time rather than minting a link that quietly does nothing.
|
|
28
|
+
*/
|
|
29
|
+
export declare class LinkOwnershipError extends Error {
|
|
30
|
+
constructor(message: string);
|
|
31
|
+
}
|
|
32
|
+
export interface MintLinkOptions {
|
|
33
|
+
db: Database;
|
|
34
|
+
/** The destination URL the redirect 302s to. Must be http(s). */
|
|
35
|
+
url: string;
|
|
36
|
+
/** Public base URL of this instance (the tracking host) — the redirect prefix. */
|
|
37
|
+
baseUrl: string;
|
|
38
|
+
/** Originating channel: "studio" | "discord" | "sms" | "referral" | … (open). */
|
|
39
|
+
source: string;
|
|
40
|
+
/**
|
|
41
|
+
* "personal" (1:1, identity-bearing) | "public" (shareable) | "shared"
|
|
42
|
+
* (owned by a person, clicked by others - a referral link). Default
|
|
43
|
+
* "public".
|
|
44
|
+
*/
|
|
45
|
+
type?: LinkType;
|
|
46
|
+
/**
|
|
47
|
+
* The contact this link earns credit FOR. REQUIRED for `type: "shared"`,
|
|
48
|
+
* forbidden on `personal`/`public` (see {@link LinkOwnershipError}).
|
|
49
|
+
*
|
|
50
|
+
* This is an ATTRIBUTION field, never an identity one: it is deliberately
|
|
51
|
+
* not `distinctId`, because a referral link's clicker must never be stitched
|
|
52
|
+
* to its owner. Reusing `personal` for this would identify every referee AS
|
|
53
|
+
* the referrer, which is precisely the share-safe invariant's failure mode.
|
|
54
|
+
*/
|
|
55
|
+
ownerContactId?: string;
|
|
56
|
+
/** Operator-facing name (Studio list). */
|
|
57
|
+
label?: string;
|
|
58
|
+
/**
|
|
59
|
+
* Longer operator note — what/where this link or its printed QR actually is
|
|
60
|
+
* ("sticker on the workshop door"), for telling codes apart in bulk.
|
|
61
|
+
*/
|
|
62
|
+
description?: string;
|
|
63
|
+
/** UTM-style campaign grouping (public links). */
|
|
64
|
+
campaign?: string;
|
|
65
|
+
/**
|
|
66
|
+
* The `defineReferral` id this link belongs to (`getReferralLink` sets it).
|
|
67
|
+
* Stored on the row so a CLICK can find the DEFINITION that owns it - the
|
|
68
|
+
* hooks, the bind window and the qualify rule - without inferring it from
|
|
69
|
+
* `campaign`, which is operator-facing grouping and may be absent or shared.
|
|
70
|
+
*/
|
|
71
|
+
referralId?: string;
|
|
72
|
+
/**
|
|
73
|
+
* The canonical contact key a click should stitch - honoured ONLY for
|
|
74
|
+
* `type: "personal"`; dropped for public AND shared links (the share-safe
|
|
75
|
+
* invariant).
|
|
76
|
+
*/
|
|
77
|
+
distinctId?: string;
|
|
78
|
+
/** The admin actor who minted it (Studio). */
|
|
79
|
+
createdBy?: string;
|
|
80
|
+
/**
|
|
81
|
+
* Optional vanity slug — the `/l/:slug` short path layered over the UUID
|
|
82
|
+
* redirect. Normalized lowercase; unique per instance (SlugTakenError on
|
|
83
|
+
* conflict). Managed links only — email's per-send links stay UUID.
|
|
84
|
+
*/
|
|
85
|
+
slug?: string;
|
|
86
|
+
/**
|
|
87
|
+
* Arrival attribution opt-in: append `hs_ref=<click id>` to every redirect
|
|
88
|
+
* from this link so the landing page can report the visitor back to
|
|
89
|
+
* `POST /v1/t/arrive`. Off by default — an appended param breaks strict
|
|
90
|
+
* OAuth redirect_uri destinations.
|
|
91
|
+
*/
|
|
92
|
+
appendRef?: boolean;
|
|
93
|
+
/**
|
|
94
|
+
* Idempotent-mint key for slugless links: re-minting with the same key +
|
|
95
|
+
* same destination returns the EXISTING link (`existing: true`) instead of
|
|
96
|
+
* a duplicate; same key + different destination is an
|
|
97
|
+
* IdempotencyConflictError (→ 409). Unique among LIVE links only (partial
|
|
98
|
+
* index) — archiving frees the key. Mutually exclusive with `slug` (a slug
|
|
99
|
+
* IS an idempotency key: same slug + same url + same type recovers too).
|
|
100
|
+
*/
|
|
101
|
+
idempotencyKey?: string;
|
|
102
|
+
}
|
|
103
|
+
export interface MintedLink {
|
|
104
|
+
/** The `links` row id (the managed identity). */
|
|
105
|
+
linkId: string;
|
|
106
|
+
/** The `tracked_links` row id — the `:id` in the redirect URL. */
|
|
107
|
+
trackedLinkId: string;
|
|
108
|
+
/** The short redirect URL: `${baseUrl}/v1/t/c/:id`. */
|
|
109
|
+
url: string;
|
|
110
|
+
/** The normalized vanity slug, if one was minted. */
|
|
111
|
+
slug: string | null;
|
|
112
|
+
/** The vanity short URL (`${baseUrl}/l/:slug`), if a slug was minted. */
|
|
113
|
+
vanityUrl: string | null;
|
|
114
|
+
/** The link's type, as stored. */
|
|
115
|
+
type: LinkType;
|
|
116
|
+
/** The credited owner for a `shared` link; null for personal/public. */
|
|
117
|
+
ownerContactId: string | null;
|
|
118
|
+
/**
|
|
119
|
+
* True when the mint RECOVERED an existing live link (same slug or
|
|
120
|
+
* idempotencyKey + same destination) instead of inserting a new one.
|
|
121
|
+
*/
|
|
122
|
+
existing: boolean;
|
|
123
|
+
}
|
|
124
|
+
/** Thrown when a requested slug is already held by another link → HTTP 409. */
|
|
125
|
+
export declare class SlugTakenError extends Error {
|
|
126
|
+
constructor(slug: string);
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* Lowercase-normalize + validate a requested vanity slug. Throws on an
|
|
130
|
+
* invalid shape (→ HTTP 400). Case-insensitivity comes from normalizing at
|
|
131
|
+
* every write — the DB unique index then only ever sees lowercase.
|
|
132
|
+
*/
|
|
133
|
+
export declare function normalizeSlug(raw: string): string;
|
|
134
|
+
/** True when a DB error is the unique_violation on the slug index. */
|
|
135
|
+
export declare function isSlugUniqueViolation(err: unknown): boolean;
|
|
136
|
+
/**
|
|
137
|
+
* True when a DB error is the unique_violation on the partial (live-rows-only)
|
|
138
|
+
* idempotency-key index.
|
|
139
|
+
*/
|
|
140
|
+
export declare function isIdempotencyKeyViolation(err: unknown): boolean;
|
|
141
|
+
/**
|
|
142
|
+
* Thrown when an idempotencyKey is already held by a LIVE link with a
|
|
143
|
+
* DIFFERENT destination → HTTP 409. (Same destination is not a conflict — it
|
|
144
|
+
* recovers the existing link.)
|
|
145
|
+
*/
|
|
146
|
+
export declare class IdempotencyConflictError extends Error {
|
|
147
|
+
constructor(key: string);
|
|
148
|
+
}
|
|
149
|
+
export declare function vanityUrlFor(baseUrl: string, slug: string): string;
|
|
150
|
+
/** The `tracked_links.source` marker of a link's per-link QR scan row. */
|
|
151
|
+
export declare const QR_TRACKED_SOURCE = "qr";
|
|
152
|
+
/**
|
|
153
|
+
* Lazily mint (or fetch) a managed link's QR scan row — the SECOND
|
|
154
|
+
* `tracked_links` row for the link, `source: "qr"`. The QR code encodes
|
|
155
|
+
* `/v1/t/c/<this row>` (the durable UID URL, never the slug), so scans are
|
|
156
|
+
* attributable separately from link clicks while a PATCH re-target (which
|
|
157
|
+
* updates every tracked row scoped by `link_id`) keeps a printed code
|
|
158
|
+
* pointing at the current destination.
|
|
159
|
+
*
|
|
160
|
+
* Race-safe via the partial unique index `tracked_links(link_id) WHERE
|
|
161
|
+
* source = 'qr'`: a concurrent double-mint loses the insert cleanly and
|
|
162
|
+
* re-reads the winner's row. Returns null when the link doesn't exist.
|
|
163
|
+
*/
|
|
164
|
+
export declare function ensureQrTrackedLink(opts: {
|
|
165
|
+
db: Database;
|
|
166
|
+
linkId: string;
|
|
167
|
+
}): Promise<{
|
|
168
|
+
trackedLinkId: string;
|
|
169
|
+
created: boolean;
|
|
170
|
+
} | null>;
|
|
171
|
+
/**
|
|
172
|
+
* SQL predicate selecting a link's CANONICAL tracked row — the redirect row
|
|
173
|
+
* minted alongside the link, as opposed to the lazily-minted per-link QR scan
|
|
174
|
+
* row (`source = 'qr'`). The ONE definition of "which tracked row is the
|
|
175
|
+
* link's redirect row"; every consumer (vanity resolver, admin aggregates)
|
|
176
|
+
* must use it rather than re-deriving QR-awareness.
|
|
177
|
+
*/
|
|
178
|
+
export declare function canonicalTrackedRowFilter(): import("drizzle-orm").SQL<unknown> | undefined;
|
|
179
|
+
/**
|
|
180
|
+
* Reject a non-http(s) destination at mint time. The click route 302s to the
|
|
181
|
+
* stored URL verbatim, so giving operators a UI to mint these would otherwise
|
|
182
|
+
* widen the latent open-redirect into `javascript:`/`data:` territory.
|
|
183
|
+
*/
|
|
184
|
+
export declare function assertHttpUrl(url: string): void;
|
|
185
|
+
export declare function mintLink(opts: MintLinkOptions): Promise<MintedLink>;
|
|
186
|
+
//# sourceMappingURL=links.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/lib/links.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAuB,MAAM,aAAa,CAAC;AAGjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kCAAkC;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,wEAAwE;IACxE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AASD,+EAA+E;AAC/E,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,IAAI,EAAE,MAAM;CAIzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AA4BD,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,GAAG,EAAE,MAAM;CAIxB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAsD9D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,mDAKxC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAY/C;AAqCD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA6HzE"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared loader for the engine's OPT-IN plugin packages (`@hogsend/plugin-apollo`,
|
|
3
|
+
* `-postmark`, `-twilio`). Each is an engine `optionalDependency`, never a hard
|
|
4
|
+
* one: a static import would make the package mandatory at engine load and break
|
|
5
|
+
* `npm install @hogsend/engine` for every consumer without it.
|
|
6
|
+
*
|
|
7
|
+
* So each preset loads its package lazily, ONCE, behind a guarded dynamic import
|
|
8
|
+
* gated on the relevant credential. The specifier is assembled at runtime (not a
|
|
9
|
+
* literal) so `tsc` never resolves the module's types for a consumer that does
|
|
10
|
+
* not have the opt-in package.
|
|
11
|
+
*
|
|
12
|
+
* ## Why the failure message matters so much
|
|
13
|
+
*
|
|
14
|
+
* All three presets previously swallowed the failure — SMS silently, enrichment
|
|
15
|
+
* behind a message that said "is not installed" for EVERY failure mode. That
|
|
16
|
+
* message was actively wrong in the most common real case (installed, but the
|
|
17
|
+
* package shipped raw `.ts` that Node cannot type-strip inside node_modules), so
|
|
18
|
+
* an operator following it reinstalled a package they already had. The whole
|
|
19
|
+
* point of this module is that the two failure modes are DIFFERENT problems with
|
|
20
|
+
* different fixes, and conflating them sends people to fix the wrong thing.
|
|
21
|
+
*
|
|
22
|
+
* `not-installed` is a configuration problem the operator can fix.
|
|
23
|
+
* `load-failed` is OUR bug and should be reported, not worked around.
|
|
24
|
+
*/
|
|
25
|
+
export type PluginLoadOutcome = "not-installed" | "load-failed" | "missing-export";
|
|
26
|
+
/**
|
|
27
|
+
* Resolve a named factory export from an optional plugin package.
|
|
28
|
+
*
|
|
29
|
+
* Returns the factory, or `null` when the package cannot be loaded — in which
|
|
30
|
+
* case `onFailure` fires (once, since every call site runs at module scope, once
|
|
31
|
+
* per process) and NOTHING throws. A credential set without a working plugin
|
|
32
|
+
* degrades gracefully; if the provider was EXPLICITLY selected the container
|
|
33
|
+
* still throws its own clear "not registered" error at boot.
|
|
34
|
+
*
|
|
35
|
+
* Deliberately testable against an INJECTED specifier so the guard can be
|
|
36
|
+
* exercised without depending on a real package being absent — once these
|
|
37
|
+
* packages are engine optionalDependencies, an absence-based test would silently
|
|
38
|
+
* assert the opposite of what it means.
|
|
39
|
+
*/
|
|
40
|
+
export declare function loadOptionalPlugin<T>(opts: {
|
|
41
|
+
specifier: string;
|
|
42
|
+
exportName: string;
|
|
43
|
+
/** What switched this on, e.g. `"APOLLO_API_KEY is set"`. Named in the message. */
|
|
44
|
+
enabledBy: string;
|
|
45
|
+
onFailure?: (message: string, outcome: PluginLoadOutcome) => void;
|
|
46
|
+
}): Promise<T | null>;
|
|
47
|
+
//# sourceMappingURL=load-optional-plugin.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"load-optional-plugin.d.ts","sourceRoot":"","sources":["../../src/lib/load-optional-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,aAAa,GACb,gBAAgB,CAAC;AA+DrB;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACnE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA8BpB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAO9B,wBAAgB,YAAY,CAAC,KAAK,GAAE,MAAe,kBAwBlD;AAED,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { EmailProvider } from "@hogsend/core";
|
|
2
|
+
import type { DomainStatusService } from "./domain-status.js";
|
|
3
|
+
import { type EmailService, type EmailServiceConfig } from "./email-service-types.js";
|
|
4
|
+
import type { PrepareTrackedHtmlFn } from "./tracked.js";
|
|
5
|
+
import { type PushTrackingEventOpts } from "./tracking-events.js";
|
|
6
|
+
/**
|
|
7
|
+
* See `createTrackedMailer`'s `pushReplyEvent` dep.
|
|
8
|
+
*
|
|
9
|
+
* `registry` is deliberately NOT part of this signature. The real push needs
|
|
10
|
+
* the journey registry, which lives in a process singleton that THROWS when it
|
|
11
|
+
* has not been set — so reading it at the call site would make every injected
|
|
12
|
+
* override depend on a global the override does not use. The default wrapper
|
|
13
|
+
* reads it, and only it.
|
|
14
|
+
*/
|
|
15
|
+
export type PushReplyEventFn = (opts: Omit<PushTrackingEventOpts, "registry">) => Promise<unknown>;
|
|
16
|
+
/**
|
|
17
|
+
* The engine-owned high-level mailer. It owns the full send pipeline —
|
|
18
|
+
* render → preference/suppression check → tracked-html rewrite → `email_sends`
|
|
19
|
+
* insert → `provider.send(...)` → status record — and delegates only the raw
|
|
20
|
+
* provider delivery + webhook parse/verify to the injected {@link EmailProvider}.
|
|
21
|
+
*/
|
|
22
|
+
export declare function createTrackedMailer(config: EmailServiceConfig, deps: {
|
|
23
|
+
provider: EmailProvider;
|
|
24
|
+
prepareTrackedHtml?: PrepareTrackedHtmlFn;
|
|
25
|
+
/**
|
|
26
|
+
* Cached sending-domain status, injected by the container. Drives test-mode
|
|
27
|
+
* redirect: when `testModeCached().active`, every send is redirected to the
|
|
28
|
+
* safe inbox before reaching the provider. OPTIONAL — direct construction
|
|
29
|
+
* without it (tests) keeps today's behavior; the container always passes it.
|
|
30
|
+
*/
|
|
31
|
+
domainStatus?: DomainStatusService;
|
|
32
|
+
/**
|
|
33
|
+
* The INTERNAL bus push used by the `email.replied` path. Defaults to the
|
|
34
|
+
* real {@link pushTrackingEvent}, which resolves identity and pushes the
|
|
35
|
+
* event through `ingestEvent` so a journey can `ctx.waitForEvent` on it.
|
|
36
|
+
*
|
|
37
|
+
* Injectable for the same reason `prepareTrackedHtml` is: the default
|
|
38
|
+
* reaches the identity resolver and Hatchet, and a test asserting WHAT the
|
|
39
|
+
* mailer hands the bus should not have to stand up either.
|
|
40
|
+
*/
|
|
41
|
+
pushReplyEvent?: PushReplyEventFn;
|
|
42
|
+
}): EmailService;
|
|
43
|
+
//# sourceMappingURL=mailer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mailer.d.ts","sourceRoot":"","sources":["../../src/lib/mailer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,aAAa,EAEd,MAAM,eAAe,CAAC;AAYvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAOxB,MAAM,0BAA0B,CAAC;AAYlC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAOzD,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,sBAAsB,CAAC;AA2C9B;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,KAC1C,OAAO,CAAC,OAAO,CAAC,CAAC;AA2BtB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE;IACJ,QAAQ,EAAE,aAAa,CAAC;IACxB,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC;CACnC,GACA,YAAY,CA0tBd"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/** Guarded divide, rounded to 4 decimal places. Returns 0 when denom <= 0. */
|
|
2
|
+
export declare const rate: (num: number, denom: number) => number;
|
|
3
|
+
/** `date_trunc` granularity literals, keyed by the API's period/granularity enum. */
|
|
4
|
+
export declare const TRUNC_SQL: {
|
|
5
|
+
readonly hour: import("drizzle-orm").SQL<unknown>;
|
|
6
|
+
readonly day: import("drizzle-orm").SQL<unknown>;
|
|
7
|
+
readonly week: import("drizzle-orm").SQL<unknown>;
|
|
8
|
+
readonly month: import("drizzle-orm").SQL<unknown>;
|
|
9
|
+
};
|
|
10
|
+
export type TruncPeriod = keyof typeof TRUNC_SQL;
|
|
11
|
+
//# sourceMappingURL=metrics-sql.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metrics-sql.d.ts","sourceRoot":"","sources":["../../src/lib/metrics-sql.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,eAAO,MAAM,IAAI,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,WACY,CAAC;AAE5D,qFAAqF;AACrF,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export declare function sendWebhook(url: string, payload: Record<string, unknown>): Promise<{
|
|
2
|
+
ok: boolean;
|
|
3
|
+
error?: string;
|
|
4
|
+
}>;
|
|
5
|
+
export declare function sendSlackNotification(webhookUrl: string, text: string): Promise<{
|
|
6
|
+
ok: boolean;
|
|
7
|
+
error?: string;
|
|
8
|
+
}>;
|
|
9
|
+
export declare function sendEmailNotification(opts: {
|
|
10
|
+
to: string;
|
|
11
|
+
subject: string;
|
|
12
|
+
body: string;
|
|
13
|
+
}): Promise<{
|
|
14
|
+
ok: boolean;
|
|
15
|
+
error?: string;
|
|
16
|
+
}>;
|
|
17
|
+
//# sourceMappingURL=notifications.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/lib/notifications.ts"],"names":[],"mappings":"AAEA,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB1C;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAE1C;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB3C"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import type { Database } from "@hogsend/db";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import type { Logger } from "./logger.js";
|
|
4
|
+
import { type OAuthCredentialPayload } from "./provider-credentials.js";
|
|
5
|
+
/**
|
|
6
|
+
* The CIMD document URL — doubles as the OAuth `client_id` (PostHog public
|
|
7
|
+
* client, `token_endpoint_auth_method: "none"`). Sent on every refresh.
|
|
8
|
+
*
|
|
9
|
+
* LOCKSTEP (M5): this URL is deliberately re-typed in THREE places — here,
|
|
10
|
+
* the CLI's `POSTHOG_CLIENT_ID` (`packages/cli/src/lib/oauth.ts`), and the
|
|
11
|
+
* `client_id` field inside the hosted CIMD document
|
|
12
|
+
* (`apps/docs/public/.well-known/hogsend-posthog-client.json`). The CLI has
|
|
13
|
+
* no engine dependency, so there is no single importable source of truth;
|
|
14
|
+
* grep all three before changing any of them.
|
|
15
|
+
*/
|
|
16
|
+
export declare const HOGSEND_POSTHOG_CLIENT_ID = "https://hogsend.com/.well-known/hogsend-posthog-client.json";
|
|
17
|
+
/** Refresh when fewer than 60s of access-token life remain. */
|
|
18
|
+
export declare const EXPIRY_SKEW_MS = 60000;
|
|
19
|
+
/** Negative-cache window for "no credential row" — runtime-connect pickup. */
|
|
20
|
+
export declare const ABSENT_RECHECK_MS = 30000;
|
|
21
|
+
/** Minimum gap between failed refresh attempts. */
|
|
22
|
+
export declare const FAILURE_BACKOFF_MS = 60000;
|
|
23
|
+
export declare const oauthCredentialPayloadSchema: z.ZodObject<{
|
|
24
|
+
accessToken: z.ZodString;
|
|
25
|
+
refreshToken: z.ZodString;
|
|
26
|
+
expiresAt: z.ZodString;
|
|
27
|
+
tokenEndpoint: z.ZodString;
|
|
28
|
+
clientId: z.ZodString;
|
|
29
|
+
scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
30
|
+
scopedTeams: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
|
|
31
|
+
scopedOrganizations: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
32
|
+
}, z.core.$strip>;
|
|
33
|
+
/** Test/cross-lane seam over the credential store. */
|
|
34
|
+
export interface CredentialStore {
|
|
35
|
+
/** Decrypted payload JSON of the (providerId, "oauth") row, or null. */
|
|
36
|
+
load(): Promise<Record<string, unknown> | null>;
|
|
37
|
+
save(payload: OAuthCredentialPayload): Promise<void>;
|
|
38
|
+
}
|
|
39
|
+
export type CredentialState = "unknown" | "present" | "absent";
|
|
40
|
+
export interface TokenManager {
|
|
41
|
+
/**
|
|
42
|
+
* Resolve a live access token, refreshing if necessary. NEVER throws.
|
|
43
|
+
* Returns null when no usable credential exists (absent, malformed, or
|
|
44
|
+
* refresh failed and the old token is hard-expired) — callers degrade.
|
|
45
|
+
*/
|
|
46
|
+
getAccessToken(): Promise<string | null>;
|
|
47
|
+
/** Synchronous best-known state — drives `capabilities.personReads`. */
|
|
48
|
+
credentialState(): CredentialState;
|
|
49
|
+
/** Load-only warm-up (no refresh). Fire-and-forget at boot. */
|
|
50
|
+
prime(): Promise<void>;
|
|
51
|
+
/**
|
|
52
|
+
* Drop the in-memory payload and force a refresh attempt on the next
|
|
53
|
+
* getAccessToken (still subject to failure backoff).
|
|
54
|
+
*/
|
|
55
|
+
invalidate(): void;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Per-process OAuth access-token manager: in-memory cache + single-flight
|
|
59
|
+
* refresh against the credential payload's stored `tokenEndpoint`, persisting
|
|
60
|
+
* rotations back through the credential store. One instance per process (API
|
|
61
|
+
* and worker each have their own) — the DB row is the shared truth, so the
|
|
62
|
+
* manager ALWAYS re-loads from the store before refreshing (a sibling process
|
|
63
|
+
* may have refreshed first; adopting its result avoids a cross-process
|
|
64
|
+
* stampede against an endpoint whose rotation semantics are undocumented).
|
|
65
|
+
*/
|
|
66
|
+
export declare function createTokenManager(opts: {
|
|
67
|
+
providerId: string;
|
|
68
|
+
db?: Database;
|
|
69
|
+
store?: CredentialStore;
|
|
70
|
+
logger?: Logger;
|
|
71
|
+
fetchImpl?: typeof fetch;
|
|
72
|
+
now?: () => number;
|
|
73
|
+
}): TokenManager;
|
|
74
|
+
//# sourceMappingURL=oauth-token-manager.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"oauth-token-manager.d.ts","sourceRoot":"","sources":["../../src/lib/oauth-token-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,gEACyB,CAAC;AAEhE,+DAA+D;AAC/D,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAOzC,eAAO,MAAM,4BAA4B;;;;;;;;;iBASvC,CAAC;AAEH,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,wEAAwE;IACxE,eAAe,IAAI,eAAe,CAAC;IACnC,+DAA+D;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,YAAY,CAkPf"}
|