@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,78 @@
|
|
|
1
|
+
import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
|
|
2
|
+
import type { AnalyticsProvider } from "@hogsend/core";
|
|
3
|
+
import type { JourneyRegistry } from "@hogsend/core/registry";
|
|
4
|
+
import type { Database } from "@hogsend/db";
|
|
5
|
+
import type { AccountUnlinkedFacts } from "./account-link-events.js";
|
|
6
|
+
import type { LinkAccountResult } from "./account-links.js";
|
|
7
|
+
import { type Logger } from "./logger.js";
|
|
8
|
+
/** The container's handles, when the caller has a container. */
|
|
9
|
+
export interface AccountLinkIngestHandles {
|
|
10
|
+
registry?: JourneyRegistry;
|
|
11
|
+
hatchet?: HatchetClient;
|
|
12
|
+
logger?: Logger;
|
|
13
|
+
analytics?: AnalyticsProvider;
|
|
14
|
+
}
|
|
15
|
+
/** The two {@link LinkAccountResult} arms that actually bound something. */
|
|
16
|
+
type LinkedFacts = Extract<LinkAccountResult, {
|
|
17
|
+
status: "linked";
|
|
18
|
+
} | {
|
|
19
|
+
status: "relinked";
|
|
20
|
+
}>;
|
|
21
|
+
/**
|
|
22
|
+
* The subject a failed link can be attributed to, or `null` for none.
|
|
23
|
+
*
|
|
24
|
+
* `contactId` is the SEALED, server-minted id from a state that verified —
|
|
25
|
+
* unforgeable. `anonymousId` is the COLD path's browser-supplied value, which
|
|
26
|
+
* is why that arm is both `collidesWithIdentified`-screened and refused
|
|
27
|
+
* creation below.
|
|
28
|
+
*/
|
|
29
|
+
export type LinkFailedSubject = {
|
|
30
|
+
contactId: string;
|
|
31
|
+
anonymousId?: undefined;
|
|
32
|
+
} | {
|
|
33
|
+
anonymousId: string;
|
|
34
|
+
contactId?: undefined;
|
|
35
|
+
} | null;
|
|
36
|
+
/**
|
|
37
|
+
* `account.linked` onto the journey plane, beside the outbound emit.
|
|
38
|
+
*
|
|
39
|
+
* Fire-and-forget with an attributed catch, exactly like
|
|
40
|
+
* `emitAccountUnlinked`: a Hatchet hiccup or an uninitialized registry must
|
|
41
|
+
* never fail a link the player already completed. Returns `void` so there is
|
|
42
|
+
* deliberately nothing for a caller to await and therefore nothing for a
|
|
43
|
+
* caller to accidentally fail on.
|
|
44
|
+
*/
|
|
45
|
+
export declare function ingestAccountLinked(db: Database, facts: LinkedFacts, handles?: AccountLinkIngestHandles): void;
|
|
46
|
+
/**
|
|
47
|
+
* `account.unlinked` onto the journey plane, beside the outbound emit.
|
|
48
|
+
*
|
|
49
|
+
* Keyed on the facts' OWN pair — a `replacedSingleton` is a DIFFERENT pair
|
|
50
|
+
* with its own version sequence, and a key built from the arriving pair would
|
|
51
|
+
* collide with the `account.linked` idempotency key and silently drop this
|
|
52
|
+
* enrollment.
|
|
53
|
+
*/
|
|
54
|
+
export declare function ingestAccountUnlinked(db: Database, facts: AccountUnlinkedFacts, handles?: AccountLinkIngestHandles): void;
|
|
55
|
+
/**
|
|
56
|
+
* `account.link_failed` onto the journey plane, beside the outbound emit.
|
|
57
|
+
*
|
|
58
|
+
* NO `idempotencyKey`, mirroring the missing `dedupeKey`: the event carries no
|
|
59
|
+
* version, and two genuine failures in a row are two genuine facts.
|
|
60
|
+
*
|
|
61
|
+
* `allowCreate: false` is MANDATORY here (DECISIONS §8) and is what
|
|
62
|
+
* STRUCTURALLY enforces "a failed link never mints a contact" — rather than
|
|
63
|
+
* relying on the caller happening to pass no identity. On the cold arm the key
|
|
64
|
+
* is an `anonymous_id` typed into an unauthenticated URL, so a creating
|
|
65
|
+
* resolve would mint a CRM row for a link that never happened, on a value the
|
|
66
|
+
* visitor chose.
|
|
67
|
+
*
|
|
68
|
+
* A `null` subject is a no-op, not an error: a state that did not verify
|
|
69
|
+
* carries nothing to attribute a failure to, and `resolveContactNoCreate`
|
|
70
|
+
* would throw anyway (D8 — it needs `userId` or `anonymousId`).
|
|
71
|
+
*/
|
|
72
|
+
export declare function ingestAccountLinkFailed(db: Database, args: {
|
|
73
|
+
provider: string;
|
|
74
|
+
reason: "denied" | "vetoed" | "exchange_failed" | "state_invalid";
|
|
75
|
+
subject: LinkFailedSubject;
|
|
76
|
+
}, handles?: AccountLinkIngestHandles): void;
|
|
77
|
+
export {};
|
|
78
|
+
//# sourceMappingURL=account-link-ingest.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-link-ingest.d.ts","sourceRoot":"","sources":["../../src/lib/account-link-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAuExD,gEAAgE;AAChE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,4EAA4E;AAC5E,KAAK,WAAW,GAAG,OAAO,CACxB,iBAAiB,EACjB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAC9C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,CAAA;CAAE,GAC9C;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAC9C,IAAI,CAAC;AAET;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAkCN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAgCN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAClE,OAAO,EAAE,iBAAiB,CAAC;CAC5B,EACD,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAwCN"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The single-use nonce burn for the hosted account-link callback.
|
|
3
|
+
*
|
|
4
|
+
* Shape-identical to the connector callback's burn
|
|
5
|
+
* (`routes/connectors/index.ts:136-146`), down to the 900s TTL and the
|
|
6
|
+
* `"OK"`-comparison on the `SET NX` result: the signed state is otherwise
|
|
7
|
+
* TTL-replayable, so a captured callback URL works until `exp` unless the first
|
|
8
|
+
* use burns the per-mint nonce.
|
|
9
|
+
*
|
|
10
|
+
* ONE DELIBERATE DIVERGENCE, and it must stay: when Redis is absent the
|
|
11
|
+
* connector callback degrades to TTL-only validity ("we never block a callback
|
|
12
|
+
* on a cache miss"), and this one REFUSES. DECISIONS §6.8 says fail closed, and
|
|
13
|
+
* the threat differs — a replayed connector install re-captures a guild id,
|
|
14
|
+
* whereas a replayed account-link callback can MOVE a platform account between
|
|
15
|
+
* contacts (DECISIONS §6.1). It is a named function rather than four inline
|
|
16
|
+
* lines so the null-Redis arm is directly testable; a guard whose fail-closed
|
|
17
|
+
* branch no test can reach is a guard nobody will notice losing.
|
|
18
|
+
*/
|
|
19
|
+
export interface AccountLinkNonceRedis {
|
|
20
|
+
set(key: string, value: string, ex: "EX", ttlSeconds: number, nx: "NX"): Promise<string | null>;
|
|
21
|
+
}
|
|
22
|
+
/** Matches `connector:state:used:<nonce>`'s window so the marker outlives any valid state. */
|
|
23
|
+
export declare const NONCE_BURN_TTL_SECONDS = 900;
|
|
24
|
+
/**
|
|
25
|
+
* Claim a nonce. TRUE exactly once per nonce; FALSE on a replay, on a missing
|
|
26
|
+
* Redis, and on any Redis fault.
|
|
27
|
+
*/
|
|
28
|
+
export declare function burnAccountLinkNonce(nonce: string, redis?: AccountLinkNonceRedis | null): Promise<boolean>;
|
|
29
|
+
//# sourceMappingURL=account-link-nonce.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-link-nonce.d.ts","sourceRoot":"","sources":["../../src/lib/account-link-nonce.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,IAAI,EACR,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B;AAED,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,qBAAqB,GAAG,IAAI,GACnC,OAAO,CAAC,OAAO,CAAC,CAelB"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Parse the ONE origin allowlist governing `returnTo` (PRD 07) and the
|
|
3
|
+
* `postMessage` targetOrigin (PRD 10). THROWS on a malformed entry rather than
|
|
4
|
+
* dropping it: an allowlist is a security control, and a silently shortened one
|
|
5
|
+
* produces a link button that spins to a timeout while the link has already
|
|
6
|
+
* committed server-side — the single most likely first-run misconfiguration
|
|
7
|
+
* (PRD 13). Precedent: FX_RATES is parsed outside the env schema for exactly
|
|
8
|
+
* this reason (env.ts, lib/fx.ts).
|
|
9
|
+
*
|
|
10
|
+
* Accepts the csv env var (`ACCOUNT_LINK_ALLOWED_ORIGINS`) as a string, or the
|
|
11
|
+
* consumer option (`accountLinks.allowedOrigins`) as an array — the container
|
|
12
|
+
* concatenates env-first and parses both as ONE list, so the same rule applies
|
|
13
|
+
* to each. Entries are trimmed, empties dropped, and each remaining entry must
|
|
14
|
+
* be a parseable ABSOLUTE origin that round-trips (`new URL(e).origin === e`):
|
|
15
|
+
* a path suffix, a bare `*`, or a wildcard host all throw naming the entry.
|
|
16
|
+
* Returns the deduped list, order preserved.
|
|
17
|
+
*
|
|
18
|
+
* `source` names where the offending entry came from in the throw message;
|
|
19
|
+
* the container's single merged call keeps the default naming both.
|
|
20
|
+
*/
|
|
21
|
+
export declare function parseAllowedOrigins(entries: string | string[] | undefined, source?: string): string[];
|
|
22
|
+
/**
|
|
23
|
+
* Is this `returnTo` allowed to be a redirect target?
|
|
24
|
+
*
|
|
25
|
+
* The ONE rule, applied at BOTH ends of the flow: `/start` checks it before it
|
|
26
|
+
* mints a state, and `/callback` re-checks it before it redirects, because the
|
|
27
|
+
* allowlist can be edited while a signed state is in flight and the signature
|
|
28
|
+
* proves only that WE minted the value, never that it is still permitted.
|
|
29
|
+
*
|
|
30
|
+
* Fail-closed by construction: an empty allowlist allows nothing (the container
|
|
31
|
+
* warns once at boot when providers are registered with no origins), an
|
|
32
|
+
* unparseable `returnTo` is refused, and the comparison is on the parsed
|
|
33
|
+
* `origin` — never a `startsWith`, which `https://play.example.com.evil.test`
|
|
34
|
+
* walks straight through.
|
|
35
|
+
*/
|
|
36
|
+
export declare function isAllowedReturnTo(returnTo: string, allowedOrigins: readonly string[]): boolean;
|
|
37
|
+
//# sourceMappingURL=account-link-origins.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-link-origins.d.ts","sourceRoot":"","sources":["../../src/lib/account-link-origins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EACtC,MAAM,SAA+D,GACpE,MAAM,EAAE,CAqCV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAOT"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PKCE custody for the hosted account-link flow (RFC 7636, S256 only).
|
|
3
|
+
*
|
|
4
|
+
* The verifier NEVER travels: not in the signed state, not in the redirect
|
|
5
|
+
* URL, not in a log line. It lives in Redis for the life of one attempt, keyed
|
|
6
|
+
* by that attempt's nonce, and is consumed with `GETDEL` so it is single-use
|
|
7
|
+
* even if the nonce burn were somehow bypassed. Only the S256 CHALLENGE goes
|
|
8
|
+
* out on the authorize URL, which is the entire point of PKCE: an intercepted
|
|
9
|
+
* authorization code is worthless without the verifier the interceptor never
|
|
10
|
+
* saw.
|
|
11
|
+
*/
|
|
12
|
+
/** The slice of ioredis this module uses; narrowed so a test can inject a fake. */
|
|
13
|
+
export interface AccountLinkPkceRedis {
|
|
14
|
+
set(key: string, value: string, ex: "EX", ttlSeconds: number, nx: "NX"): Promise<string | null>;
|
|
15
|
+
getdel(key: string): Promise<string | null>;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* A fresh verifier + its S256 challenge.
|
|
19
|
+
*
|
|
20
|
+
* 32 random bytes → 43 base64url chars, the RFC 7636 MINIMUM length, which is
|
|
21
|
+
* also the maximum entropy the spec's 43..128 range can carry from a 256-bit
|
|
22
|
+
* source. base64url's alphabet is a subset of the spec's `unreserved`
|
|
23
|
+
* production, so the value needs no further encoding anywhere it appears.
|
|
24
|
+
*/
|
|
25
|
+
export declare function generatePkcePair(): {
|
|
26
|
+
verifier: string;
|
|
27
|
+
challenge: string;
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* Take custody of a verifier for one attempt. `SET NX` — returns FALSE when the
|
|
31
|
+
* nonce is already claimed rather than rebinding it, so a nonce collision (or a
|
|
32
|
+
* replayed `/start`) can never silently swap the verifier out from under a live
|
|
33
|
+
* attempt. `/start` treats `false` as a 500.
|
|
34
|
+
*
|
|
35
|
+
* Returns false on a Redis fault too: fail closed, never a PKCE-less flow.
|
|
36
|
+
*/
|
|
37
|
+
export declare function storePkceVerifier(nonce: string, verifier: string, ttlSeconds: number, redis?: AccountLinkPkceRedis | null): Promise<boolean>;
|
|
38
|
+
/**
|
|
39
|
+
* Consume the verifier for one attempt. `GETDEL` (Redis >= 6.2) so the read and
|
|
40
|
+
* the delete are one atomic step — a `GET` then `DEL` leaves a window in which
|
|
41
|
+
* two concurrent callbacks both read the same verifier.
|
|
42
|
+
*
|
|
43
|
+
* `null` means "no verifier for this nonce", which the callback treats as a
|
|
44
|
+
* rejection: a PKCE provider whose verifier is gone cannot complete an exchange
|
|
45
|
+
* that proves anything.
|
|
46
|
+
*/
|
|
47
|
+
export declare function takePkceVerifier(nonce: string, redis?: AccountLinkPkceRedis | null): Promise<string | null>;
|
|
48
|
+
//# sourceMappingURL=account-link-pkce.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-link-pkce.d.ts","sourceRoot":"","sources":["../../src/lib/account-link-pkce.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,IAAI,EACR,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7C;AAgBD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAI1E;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,GAClC,OAAO,CAAC,OAAO,CAAC,CAelB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { AccountLinkProvider } from "@hogsend/core";
|
|
2
|
+
/**
|
|
3
|
+
* Container-held registry of account-link providers, keyed by
|
|
4
|
+
* `provider.meta.id` — a direct structural mirror of the
|
|
5
|
+
* {@link EmailProviderRegistry} (`lib/email-provider-registry.ts`). The hosted
|
|
6
|
+
* flow routes (`/v1/accounts/:provider/start` + `/callback`, PRD 07), the data
|
|
7
|
+
* plane (PRD 09) and the property-sync cron (PRD 14) all resolve providers out
|
|
8
|
+
* of this via the container.
|
|
9
|
+
*
|
|
10
|
+
* Deliberately NOT a process singleton, for the same reason spelled out on the
|
|
11
|
+
* email registry: every reader holds a container reference, so a singleton +
|
|
12
|
+
* lazy-preset fallback would be dead weight.
|
|
13
|
+
*
|
|
14
|
+
* Divergence from the email registry: `meta.id` is REQUIRED here. The email
|
|
15
|
+
* registry falls back to `"resend"` for providers built before `meta` existed;
|
|
16
|
+
* this contract is new and has no pre-`meta` era, so an empty/absent id is a
|
|
17
|
+
* `TypeError` rather than a silent default. It does NOT re-validate
|
|
18
|
+
* `ACCOUNT_LINK_ID_RE` / `RESERVED_ACCOUNT_LINK_IDS` — `defineAccountLink()`
|
|
19
|
+
* already throws on both at definition time, and a second copy of that rule is
|
|
20
|
+
* a second place to update.
|
|
21
|
+
*
|
|
22
|
+
* Last-writer-wins on `meta.id`, so a consumer-supplied provider of the same id
|
|
23
|
+
* overrides an env preset of that id (env presets are constructed first).
|
|
24
|
+
*/
|
|
25
|
+
export declare class AccountLinkProviderRegistry {
|
|
26
|
+
private byId;
|
|
27
|
+
constructor(providers?: AccountLinkProvider[]);
|
|
28
|
+
/** Register (or replace) a provider. Last-writer-wins on `meta.id`. */
|
|
29
|
+
register(provider: AccountLinkProvider): void;
|
|
30
|
+
get(id: string): AccountLinkProvider | undefined;
|
|
31
|
+
getAll(): AccountLinkProvider[];
|
|
32
|
+
ids(): string[];
|
|
33
|
+
count(): number;
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=account-link-provider-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-link-provider-registry.d.ts","sourceRoot":"","sources":["../../src/lib/account-link-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,IAAI,CAA0C;gBAE1C,SAAS,GAAE,mBAAmB,EAAO;IAIjD,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAY7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIhD,MAAM,IAAI,mBAAmB,EAAE;IAI/B,GAAG,IAAI,MAAM,EAAE;IAIf,KAAK,IAAI,MAAM;CAGhB"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The public account-link surfaces (`/v1/accounts/:provider/start` and
|
|
3
|
+
* `/callback`) are UNAUTHENTICATED by construction — a browser redirect target
|
|
4
|
+
* carries no `Authorization` header — so they are throttled per IP, and the
|
|
5
|
+
* warm mint is additionally throttled per contact.
|
|
6
|
+
*
|
|
7
|
+
* FAIL-CLOSED (DECISIONS §6.8), which is a DELIBERATE divergence from the
|
|
8
|
+
* connector callback next door: that one degrades to TTL-only validity when
|
|
9
|
+
* Redis is absent on the stated principle that it will "never block a callback
|
|
10
|
+
* on a cache miss" (`routes/connectors/index.ts:134-136`). The threat is not
|
|
11
|
+
* the same. A replayed connector install re-captures a guild id; a replayed
|
|
12
|
+
* account-link callback can MOVE a platform account between contacts
|
|
13
|
+
* (DECISIONS §6.1). PKCE verifier custody also lives in Redis, so for the
|
|
14
|
+
* OAuth2 providers Redis is structurally required regardless. Do not "fix" this
|
|
15
|
+
* into the connector posture.
|
|
16
|
+
*
|
|
17
|
+
* Modelled on `cold-connect/throttle.ts` — the same fixed-window `INCR` + set
|
|
18
|
+
* the TTL on the FIRST increment idiom.
|
|
19
|
+
*/
|
|
20
|
+
/**
|
|
21
|
+
* The slice of ioredis this module uses. Narrowed so a test can inject a fake
|
|
22
|
+
* (and so `null` — the fail-closed arm — is expressible), the same seam
|
|
23
|
+
* `lib/leader-lease.ts` uses for its `redis` argument.
|
|
24
|
+
*/
|
|
25
|
+
export interface AccountLinkThrottleRedis {
|
|
26
|
+
incr(key: string): Promise<number>;
|
|
27
|
+
expire(key: string, seconds: number): Promise<unknown>;
|
|
28
|
+
}
|
|
29
|
+
export type ThrottleResult = {
|
|
30
|
+
ok: true;
|
|
31
|
+
} | {
|
|
32
|
+
ok: false;
|
|
33
|
+
reason: "rate_limited" | "redis_unavailable";
|
|
34
|
+
};
|
|
35
|
+
interface AccountLinkThrottleBase {
|
|
36
|
+
surface: "start" | "callback";
|
|
37
|
+
config?: {
|
|
38
|
+
windowSeconds?: number;
|
|
39
|
+
max?: number;
|
|
40
|
+
};
|
|
41
|
+
/**
|
|
42
|
+
* TEST SEAM (and the fail-closed arm). Defaults to
|
|
43
|
+
* {@link getRedisIfConnected}, NOT `getRedis()`: the account-link routes
|
|
44
|
+
* refuse to serve at all without a connected Redis, so this must never be the
|
|
45
|
+
* thing that lazily opens a connection and papers over that.
|
|
46
|
+
*/
|
|
47
|
+
redis?: AccountLinkThrottleRedis | null;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* At least ONE budget must be named, enforced by the union rather than by a
|
|
51
|
+
* runtime check — a call that names no budget would silently allow everything.
|
|
52
|
+
*
|
|
53
|
+
* `/start` calls this TWICE and that is deliberate: once on the IP alone,
|
|
54
|
+
* BEFORE anything is minted (the order of operations puts the throttle ahead of
|
|
55
|
+
* the binding resolution), and once on the sealed `contactId` alone once the
|
|
56
|
+
* WARM binding is known. One call cannot do both, because the contact is not
|
|
57
|
+
* known at the point the IP budget has to bite, and re-passing the IP on the
|
|
58
|
+
* second call would double-count every warm request against its own budget.
|
|
59
|
+
*/
|
|
60
|
+
export type AccountLinkThrottleArgs = AccountLinkThrottleBase & ({
|
|
61
|
+
/** Best-effort client IP; `"unknown"` shares ONE bounded bucket, never bypasses. */
|
|
62
|
+
ip: string;
|
|
63
|
+
contactId?: string;
|
|
64
|
+
} | {
|
|
65
|
+
ip?: undefined;
|
|
66
|
+
/** WARM only — the sealed contact gets its own budget across IPs. */
|
|
67
|
+
contactId: string;
|
|
68
|
+
});
|
|
69
|
+
/**
|
|
70
|
+
* Bump every budget this call owns and reject when ANY is over its cap. Both
|
|
71
|
+
* budgets are bumped even when the first is already over: a fixed-window
|
|
72
|
+
* counter that stops counting under attack is a counter that reopens early.
|
|
73
|
+
*/
|
|
74
|
+
export declare function checkAccountLinkThrottle(args: AccountLinkThrottleArgs): Promise<ThrottleResult>;
|
|
75
|
+
export {};
|
|
76
|
+
//# sourceMappingURL=account-link-throttle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-link-throttle.d.ts","sourceRoot":"","sources":["../../src/lib/account-link-throttle.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAA;CAAE,CAAC;AAQhE,UAAU,uBAAuB;IAC/B,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,GAC3D,CACI;IACE,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB,CACJ,CAAC;AAkBJ;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA2BzB"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Mint a WARM account-link URL for a KNOWN contact — the server-side half of
|
|
3
|
+
* DECISIONS §2's naming (`mintAccountLinkUrl`, never `mintLinkUrl` beside
|
|
4
|
+
* `mintLink`). PRD 09's `POST /v1/accounts/link-url` returns exactly this
|
|
5
|
+
* value, and the embed SDK derives its `postMessage` `expectedOrigin` from it.
|
|
6
|
+
*
|
|
7
|
+
* **It returns an ENGINE-origin URL** (DECISIONS §15.2):
|
|
8
|
+
*
|
|
9
|
+
* <API_PUBLIC_URL>/v1/accounts/<provider>/start?t=<signed account_link state>
|
|
10
|
+
*
|
|
11
|
+
* The provider's authorize URL is only ever a 302 target from `/start`, NEVER a
|
|
12
|
+
* value handed to a caller. This is not tidiness: the embed compares the
|
|
13
|
+
* `postMessage` origin against `new URL(url).origin`, so returning
|
|
14
|
+
* `https://steamcommunity.com/...` would make it silently drop every success
|
|
15
|
+
* message and time out while the link had committed server-side — and a
|
|
16
|
+
* fake-`Window` test cannot see that.
|
|
17
|
+
*/
|
|
18
|
+
export declare class AccountLinkReturnToError extends Error {
|
|
19
|
+
constructor(returnTo: string);
|
|
20
|
+
}
|
|
21
|
+
export interface MintAccountLinkUrlArgs {
|
|
22
|
+
/** The `AccountLinkProvider` `meta.id`. Sealed into the state as `providerId`. */
|
|
23
|
+
provider: string;
|
|
24
|
+
/**
|
|
25
|
+
* The contact this link attaches to, AUTHORITATIVELY. Sealed into the state,
|
|
26
|
+
* so the callback binds here and never to the email the provider reports
|
|
27
|
+
* (DECISIONS §6.3). Minting is an identity assertion, which is why PRD 09
|
|
28
|
+
* gates the route on a server-minted userToken and never on a `pk_` key.
|
|
29
|
+
*/
|
|
30
|
+
contactId: string;
|
|
31
|
+
/** Where to send the player afterwards. Checked HERE and again at redirect. */
|
|
32
|
+
returnTo?: string;
|
|
33
|
+
/** The container's parsed allowlist. Required to accept a `returnTo` at all. */
|
|
34
|
+
allowedOrigins?: readonly string[];
|
|
35
|
+
/** Defaults to `env.API_PUBLIC_URL`. */
|
|
36
|
+
apiPublicUrl?: string;
|
|
37
|
+
/** Defaults to `env.ACCOUNT_LINK_STATE_TTL_SECONDS`. */
|
|
38
|
+
ttlSeconds?: number;
|
|
39
|
+
}
|
|
40
|
+
export declare function mintAccountLinkUrl(args: MintAccountLinkUrlArgs): string;
|
|
41
|
+
//# sourceMappingURL=account-link-url.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-link-url.d.ts","sourceRoot":"","sources":["../../src/lib/account-link-url.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,QAAQ,EAAE,MAAM;CAQ7B;AAED,MAAM,WAAW,sBAAsB;IACrC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CA+BvE"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { AccountLinkProvider } from "@hogsend/core";
|
|
2
|
+
import type { env as envSchema } from "../env.js";
|
|
3
|
+
export interface AccountLinkEnvResult {
|
|
4
|
+
providers: AccountLinkProvider[];
|
|
5
|
+
/** One line per partially-configured provider. The container logs each ONCE. */
|
|
6
|
+
warnings: string[];
|
|
7
|
+
}
|
|
8
|
+
export interface AccountLinksFromEnvOptions {
|
|
9
|
+
/**
|
|
10
|
+
* True when the consumer passed ANY `accountLinks` option to
|
|
11
|
+
* `createHogsendClient` — even `accountLinks: {}`. Code-side intent: an
|
|
12
|
+
* operator who mentioned the feature gets the presets.
|
|
13
|
+
*/
|
|
14
|
+
consumerOptedIn?: boolean;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Build the env-enabled account-link provider presets. Structural mirror of
|
|
18
|
+
* `emailProvidersFromEnv` (`lib/email-providers-from-env.ts`), with two
|
|
19
|
+
* deliberate divergences:
|
|
20
|
+
*
|
|
21
|
+
* 1. **Static imports.** No `loadOptionalPlugin`, no runtime-assembled
|
|
22
|
+
* specifier, because the six built-in providers are IN-PACKAGE config over
|
|
23
|
+
* the `@hogsend/core` presets, not opt-in plugin packages (DECISIONS §3.1).
|
|
24
|
+
* No top-level `await`, so `createHogsendClient` stays synchronous.
|
|
25
|
+
* 2. **It returns warnings rather than calling `console.warn`.** The email
|
|
26
|
+
* preset builder warns straight to `console.warn` because it runs before a
|
|
27
|
+
* logger exists; here the container already has `logger`, so the strings
|
|
28
|
+
* come back and the container logs them through the real logger. That keeps
|
|
29
|
+
* this function pure and unit-testable with no console spy.
|
|
30
|
+
*
|
|
31
|
+
* Rules:
|
|
32
|
+
* - **Presets register only when the operator shows INTENT** in account links,
|
|
33
|
+
* preserving this repo's inert-when-unconfigured posture: a deploy that
|
|
34
|
+
* never asked for account linking gets no public `/v1/accounts/*` surface
|
|
35
|
+
* and no boot warning. Intent is EITHER env-side ({@link hasEnvIntent}: any
|
|
36
|
+
* `ACCOUNT_LINK_*` var, `STEAM_WEB_API_KEY`, or
|
|
37
|
+
* `ACCOUNT_LINK_ALLOWED_ORIGINS` set) OR code-side
|
|
38
|
+
* ({@link AccountLinksFromEnvOptions.consumerOptedIn}: any `accountLinks`
|
|
39
|
+
* option passed, even `{}`). No intent ⇒ empty result.
|
|
40
|
+
* - **Steam stays credential-free** and registers on ANY intent. "Sign in
|
|
41
|
+
* through Steam" is OpenID 2.0: the relying party presents no credential of
|
|
42
|
+
* any kind — no app registration, no client id, no secret. The whole
|
|
43
|
+
* security model is the server-side `check_authentication` round-trip,
|
|
44
|
+
* unauthenticated by design. `STEAM_WEB_API_KEY` is OPTIONAL and WIDENS the
|
|
45
|
+
* provider (persona/avatar pull + the playtime sync) rather than enabling
|
|
46
|
+
* it — the preset branches on it, so it is passed straight through, not
|
|
47
|
+
* re-derived here. The only genuine requirement is the realm:
|
|
48
|
+
* `API_PUBLIC_URL` (already required by the engine env), trailing slash
|
|
49
|
+
* stripped — Steam rejects the assertion under a wrong realm. Steam
|
|
50
|
+
* contributes no warning and cannot be half-configured.
|
|
51
|
+
* - OAuth providers (Twitch, Battle.net, Epic, Xbox, Riot) are registered iff
|
|
52
|
+
* BOTH `ACCOUNT_LINK_<ID>_CLIENT_ID` and `_CLIENT_SECRET` are set. Exactly
|
|
53
|
+
* one set ⇒ no registration (absent from the registry, not
|
|
54
|
+
* present-but-disabled) plus a warning naming the MISSING var.
|
|
55
|
+
* - Discord is the only excluded platform: it already ships via
|
|
56
|
+
* `plugin-discord`, and a second writer on `contacts.discordId` would drift.
|
|
57
|
+
*
|
|
58
|
+
* These presets come FIRST in the container's merge — a consumer-supplied
|
|
59
|
+
* provider of the same id wins (last-writer-wins on the registry).
|
|
60
|
+
*/
|
|
61
|
+
export declare function accountLinksFromEnv(env: typeof envSchema, options?: AccountLinksFromEnvOptions): AccountLinkEnvResult;
|
|
62
|
+
//# sourceMappingURL=account-links-from-env.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"account-links-from-env.d.ts","sourceRoot":"","sources":["../../src/lib/account-links-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOzD,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,SAAS,EACrB,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CA4FtB"}
|