@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 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cold-connect/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Branding for the cold-connect page. Every field is plain text (NOT HTML) — the
|
|
3
|
+
* page JSON-embeds them into a JS-string-safe config and writes them via
|
|
4
|
+
* `textContent`, so no field can inject markup. `accentColor` is regex-validated
|
|
5
|
+
* to a 6-digit hex before it ever reaches a stylesheet.
|
|
6
|
+
*/
|
|
7
|
+
export interface ColdConnectBranding {
|
|
8
|
+
/** Page `<title>` + heading before the user confirms. */
|
|
9
|
+
title: string;
|
|
10
|
+
/** Body copy under the heading. */
|
|
11
|
+
blurb: string;
|
|
12
|
+
/** Heading + body shown after a successful bind. */
|
|
13
|
+
successCopy: {
|
|
14
|
+
heading: string;
|
|
15
|
+
body: string;
|
|
16
|
+
};
|
|
17
|
+
/** Heading + body shown after a failed/expired bind. */
|
|
18
|
+
errorCopy: {
|
|
19
|
+
heading: string;
|
|
20
|
+
body: string;
|
|
21
|
+
};
|
|
22
|
+
/** A short emoji/glyph rendered in the badge (fallback when `iconSvg` is unset). */
|
|
23
|
+
badge: string;
|
|
24
|
+
/**
|
|
25
|
+
* Inline platform-logo SVG rendered in the badge instead of `badge`.
|
|
26
|
+
*
|
|
27
|
+
* SECURITY: unlike every other field here (plain text, written via
|
|
28
|
+
* `textContent`), this is inlined into the page markup verbatim. It MUST be a
|
|
29
|
+
* static, developer-authored `<svg>…</svg>` from connector source — NEVER
|
|
30
|
+
* runtime/user input. Author it with `fill="currentColor"`; the badge tints it
|
|
31
|
+
* white.
|
|
32
|
+
*/
|
|
33
|
+
iconSvg?: string;
|
|
34
|
+
/** Accent color (`#rrggbb`); validated, falls back to a safe blue. */
|
|
35
|
+
accentColor?: string;
|
|
36
|
+
/** Uppercase micro-label above the badge (Studio `.eyebrow`). Defaults to "Hogsend". */
|
|
37
|
+
eyebrow?: string;
|
|
38
|
+
/**
|
|
39
|
+
* Reassurance footnote under the button ("didn't request this? ignore it").
|
|
40
|
+
* Hidden once the bind resolves. Has a safe default if omitted.
|
|
41
|
+
*/
|
|
42
|
+
reassurance?: string;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Self-contained connect page, styled to the Hogsend Studio "Crimzon" design
|
|
46
|
+
* language (ink background, hairline-bordered surface card, Inter, eyebrow
|
|
47
|
+
* micro-label, faint grain) while keeping each connector's platform accent on
|
|
48
|
+
* the badge tint + Confirm button.
|
|
49
|
+
*
|
|
50
|
+
* Security (from the adversarial review):
|
|
51
|
+
* - `?tok=` is read CLIENT-side and never reflected into the markup.
|
|
52
|
+
* - The bind happens on a human button CLICK (POST), NEVER on GET — an email
|
|
53
|
+
* link-preview prefetch can't complete it.
|
|
54
|
+
* - The page identifies CLIENT-side (real geo/IP) keyed to the SERVER-proven
|
|
55
|
+
* `contactKey` the exchange returns — it never sends a distinct_id the server
|
|
56
|
+
* resolves a contact on, so there is no graft/takeover vector.
|
|
57
|
+
* - posthog-js inits with `cross_subdomain_cookie: true` so it reads the
|
|
58
|
+
* visitor's existing `.hogsend.com` distinct_id and folds their prior
|
|
59
|
+
* anonymous browsing into the now-identified person.
|
|
60
|
+
*
|
|
61
|
+
* Branding is plain-text/JSON-embedded; `accentColor` is regex-validated.
|
|
62
|
+
*/
|
|
63
|
+
export declare function coldConnectPageHtml(branding: ColdConnectBranding, opts: {
|
|
64
|
+
posthogKey: string | null;
|
|
65
|
+
posthogHost: string | null;
|
|
66
|
+
exchangeUrl: string;
|
|
67
|
+
identifyPropKey: string;
|
|
68
|
+
}): string;
|
|
69
|
+
//# sourceMappingURL=page.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/cold-connect/page.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,wDAAwD;IACxD,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,GACA,MAAM,CAyLR"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Mint-throttle config for a cold-connect flow. Two independent budgets — one
|
|
3
|
+
* keyed on the platform user id, one on the email — each a fixed-window counter
|
|
4
|
+
* (`windowSeconds` / `max`). Both default to a conservative "a few per 15 min".
|
|
5
|
+
*/
|
|
6
|
+
export interface ColdConnectThrottleConfig {
|
|
7
|
+
/** Per-platform-user budget. */
|
|
8
|
+
perUser?: {
|
|
9
|
+
windowSeconds?: number;
|
|
10
|
+
max?: number;
|
|
11
|
+
};
|
|
12
|
+
/** Per-email budget. */
|
|
13
|
+
perEmail?: {
|
|
14
|
+
windowSeconds?: number;
|
|
15
|
+
max?: number;
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
export type ThrottleResult = {
|
|
19
|
+
ok: true;
|
|
20
|
+
} | {
|
|
21
|
+
ok: false;
|
|
22
|
+
reason: "rate_limited" | "redis_unavailable";
|
|
23
|
+
};
|
|
24
|
+
/**
|
|
25
|
+
* Mint-counted, Redis-INCR throttle for a cold-connect confirm mint. Bumps both
|
|
26
|
+
* the per-user and per-email windows and rejects when EITHER is over its cap.
|
|
27
|
+
*
|
|
28
|
+
* Fail-CLOSED: any Redis fault returns `{ ok:false, reason:"redis_unavailable"
|
|
29
|
+
* }` so the caller (`mintConfirm`) returns `{ ok:false }` and does NOT send a
|
|
30
|
+
* link. Cold-connect deliberately stays OFF the `connectorLinkCodes` DB table —
|
|
31
|
+
* these counters live only in Redis.
|
|
32
|
+
*/
|
|
33
|
+
export declare function checkColdConnectThrottle(args: {
|
|
34
|
+
connectorId: string;
|
|
35
|
+
platformUserId: string;
|
|
36
|
+
email: string;
|
|
37
|
+
config?: ColdConnectThrottleConfig;
|
|
38
|
+
}): Promise<ThrottleResult>;
|
|
39
|
+
//# sourceMappingURL=throttle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/cold-connect/throttle.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAKD,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;AAkBhE;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB1B"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/** Default time-to-live for a cold-connect confirm token (seconds). */
|
|
2
|
+
export declare const COLD_CONNECT_DEFAULT_TTL_SECONDS = 900;
|
|
3
|
+
/**
|
|
4
|
+
* The sealed cold-connect binding. The `connectorId` is sealed IN the value so
|
|
5
|
+
* the exchange route can assert it matches the route it was redeemed on
|
|
6
|
+
* (cross-connector token isolation): a token minted for one connector can never
|
|
7
|
+
* be redeemed by another, even if a composer miswires the mounts.
|
|
8
|
+
*/
|
|
9
|
+
export interface ColdConnectBinding<S = Record<string, unknown>> {
|
|
10
|
+
connectorId: string;
|
|
11
|
+
platformUserId: string;
|
|
12
|
+
email: string;
|
|
13
|
+
/** Caller-supplied extra scalars carried through to the exchange. */
|
|
14
|
+
scalars?: S;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Mint a cold-connect confirm token sealing `{ connectorId, platformUserId,
|
|
18
|
+
* email, scalars }` server-side in Redis (TTL-bounded). The token rides in a
|
|
19
|
+
* link emailed to that address — clicking it proves inbox ownership. The web
|
|
20
|
+
* caller never names the platform id OR an arbitrary email; both come from the
|
|
21
|
+
* server-sealed token, not the request. Returns the token, or `null` when Redis
|
|
22
|
+
* is unavailable (fail-closed — the caller must not send a link it can't honor).
|
|
23
|
+
*/
|
|
24
|
+
export declare function mintColdConnectToken<S = Record<string, unknown>>(args: {
|
|
25
|
+
binding: ColdConnectBinding<S>;
|
|
26
|
+
ttlSeconds?: number;
|
|
27
|
+
}): Promise<string | null>;
|
|
28
|
+
/**
|
|
29
|
+
* PEEK a token's sealed binding WITHOUT consuming it (Redis GET). The exchange
|
|
30
|
+
* consumes the token only AFTER the bind ingest commits, so a transient failure
|
|
31
|
+
* doesn't burn the user's single click. Returns `null` on unknown/expired/
|
|
32
|
+
* malformed token.
|
|
33
|
+
*/
|
|
34
|
+
export declare function peekColdConnectToken<S = Record<string, unknown>>(args: {
|
|
35
|
+
connectorId: string;
|
|
36
|
+
token: string;
|
|
37
|
+
}): Promise<ColdConnectBinding<S> | null>;
|
|
38
|
+
/**
|
|
39
|
+
* Consume (single-use delete) a token AFTER its bind ingest has committed.
|
|
40
|
+
* Idempotent: a second click then sees the token gone. Best-effort — a Redis
|
|
41
|
+
* blip here leaves the token to expire on its TTL.
|
|
42
|
+
*/
|
|
43
|
+
export declare function consumeColdConnectToken(args: {
|
|
44
|
+
connectorId: string;
|
|
45
|
+
token: string;
|
|
46
|
+
}): Promise<void>;
|
|
47
|
+
/**
|
|
48
|
+
* Build the email-confirmation connect URL on the customer's own API_PUBLIC_URL.
|
|
49
|
+
* The path is derived from `connectorId` (`/connect/<connectorId>?tok=…`) — the
|
|
50
|
+
* same basePath `cc.routes` mounts, so a minted URL always resolves.
|
|
51
|
+
*/
|
|
52
|
+
export declare function buildColdConnectUrl(args: {
|
|
53
|
+
apiPublicUrl: string;
|
|
54
|
+
connectorId: string;
|
|
55
|
+
token: string;
|
|
56
|
+
}): string;
|
|
57
|
+
//# sourceMappingURL=token.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/cold-connect/token.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAgBD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IAC5E,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAezB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAwBxC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAKT"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { DefinedConnectorAction } from "./define-action.js";
|
|
2
|
+
/**
|
|
3
|
+
* The process-wide connector-action registry, set once by `createHogsendClient`.
|
|
4
|
+
* Mirrors {@link ConnectorRegistry}: keyed by `${connectorId}:${name}`,
|
|
5
|
+
* last-writer-wins, with a lazy empty fallback so a self-booting context (the
|
|
6
|
+
* standalone {@link sendConnectorAction}) resolves cleanly even before any
|
|
7
|
+
* container ran (it just finds no actions).
|
|
8
|
+
*/
|
|
9
|
+
export declare class ConnectorActionRegistry {
|
|
10
|
+
private readonly byKey;
|
|
11
|
+
constructor(actions?: DefinedConnectorAction[]);
|
|
12
|
+
register(action: DefinedConnectorAction): void;
|
|
13
|
+
get(connectorId: string, name: string): DefinedConnectorAction | undefined;
|
|
14
|
+
getAll(): DefinedConnectorAction[];
|
|
15
|
+
count(): number;
|
|
16
|
+
}
|
|
17
|
+
export declare function setConnectorActionRegistry(registry: ConnectorActionRegistry): void;
|
|
18
|
+
export declare function getConnectorActionRegistry(): ConnectorActionRegistry;
|
|
19
|
+
/** Reset the installed registry — only for test cleanup. */
|
|
20
|
+
export declare function resetConnectorActionRegistry(): void;
|
|
21
|
+
//# sourceMappingURL=action-registry-singleton.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"action-registry-singleton.d.ts","sourceRoot":"","sources":["../../src/connectors/action-registry-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;gBAEvD,OAAO,GAAE,sBAAsB,EAAO;IAIlD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAI9C,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI1E,MAAM,IAAI,sBAAsB,EAAE;IAIlC,KAAK,IAAI,MAAM;CAGhB;AAKD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAEN;AAED,wBAAgB,0BAA0B,IAAI,uBAAuB,CAIpE;AAED,4DAA4D;AAC5D,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
import type { Database } from "@hogsend/db";
|
|
2
|
+
import type { Logger } from "../lib/logger.js";
|
|
3
|
+
/**
|
|
4
|
+
* Connector OUTBOUND ACTIONS — the journey-callable, socket-free face of a
|
|
5
|
+
* connector. Distinct from event fan-out (the durable `emitOutbound` →
|
|
6
|
+
* destination spine): an action is an IMPERATIVE call a journey/workflow makes
|
|
7
|
+
* ("post this to #general", "@mention these members", "DM this user"). On
|
|
8
|
+
* Discord these are pure bot-REST calls needing only the bot token — so they run
|
|
9
|
+
* on ANY replica and are INDEPENDENT of the inbound gateway socket (a deployment
|
|
10
|
+
* with the gateway off can still send).
|
|
11
|
+
*
|
|
12
|
+
* A platform plugin contributes actions (e.g. `discordActions`); the consumer
|
|
13
|
+
* registers them via `createHogsendClient({ connectorActions })`. A journey
|
|
14
|
+
* invokes one through the standalone {@link sendConnectorAction} export (NOT on
|
|
15
|
+
* `ctx` — features are standalone imports, mirroring `sendEmail()`).
|
|
16
|
+
*/
|
|
17
|
+
/** A contact resolved for an outbound action — a platform-neutral projection. */
|
|
18
|
+
export interface ResolvedActionContact {
|
|
19
|
+
id: string;
|
|
20
|
+
email: string | null;
|
|
21
|
+
discordId: string | null;
|
|
22
|
+
externalId: string | null;
|
|
23
|
+
/**
|
|
24
|
+
* Provenance (`contacts.source`) — the id of the origin that minted the
|
|
25
|
+
* contact ("api"/"posthog"/a Contact Source id like "clay"). Consulted by the
|
|
26
|
+
* cold-channel gate: a value naming a registered Contact Source classifies
|
|
27
|
+
* the contact as a cold prospect. OPTIONAL (additive) so pre-existing
|
|
28
|
+
* constructors of this public shape keep compiling; the engine's resolver
|
|
29
|
+
* always populates it, and an absent value is treated as "not a prospect"
|
|
30
|
+
* (fail open), matching the gate's posture.
|
|
31
|
+
*/
|
|
32
|
+
source?: string | null;
|
|
33
|
+
properties: Record<string, unknown>;
|
|
34
|
+
}
|
|
35
|
+
export interface ConnectorActionCtx {
|
|
36
|
+
db: Database;
|
|
37
|
+
logger: Logger;
|
|
38
|
+
/**
|
|
39
|
+
* Resolve a contact by email, external id, or a platform id (e.g. a Discord
|
|
40
|
+
* snowflake). The engine owns the contacts schema, so a plugin action resolves
|
|
41
|
+
* a recipient WITHOUT coupling to `@hogsend/db`. Null when no live contact
|
|
42
|
+
* matches.
|
|
43
|
+
*/
|
|
44
|
+
resolveContact(ref: string): Promise<ResolvedActionContact | null>;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Declares an action MEMBER-DIRECTED — aimed at an individual recipient rather
|
|
48
|
+
* than a channel/ops surface. Its presence gates the action on the recipient's
|
|
49
|
+
* channel preferences (the auto-registered per-connector opt-out list) before
|
|
50
|
+
* the plugin runs; enforcement lands in a later phase. Absent audience =
|
|
51
|
+
* ops/channel-directed = never gated.
|
|
52
|
+
*/
|
|
53
|
+
export interface MemberAudience<A = unknown> {
|
|
54
|
+
kind: "member";
|
|
55
|
+
/**
|
|
56
|
+
* Candidate recipient refs (email | externalId | platform id | namespaced key
|
|
57
|
+
* like "telegram:<chatId>"), tried in order; first resolving contact wins.
|
|
58
|
+
* Returning undefined (or throwing) fails OPEN — the send proceeds.
|
|
59
|
+
*
|
|
60
|
+
* Method shorthand (bivariant) so a `DefinedConnectorAction<DmArgs, …>` stays
|
|
61
|
+
* assignable to the erased `DefinedConnectorAction[]` the registry/plugin
|
|
62
|
+
* index files use (same reason `run` is method shorthand).
|
|
63
|
+
*/
|
|
64
|
+
ref(args: A): string | string[] | undefined;
|
|
65
|
+
}
|
|
66
|
+
export interface DefinedConnectorAction<A = unknown, R = unknown> {
|
|
67
|
+
/** The connector this action belongs to (e.g. "discord"). Keys the registry. */
|
|
68
|
+
connectorId: string;
|
|
69
|
+
/** Action name, unique within the connector (e.g. "sendChannelMessage"). */
|
|
70
|
+
name: string;
|
|
71
|
+
/** Optional human description (Studio enumeration / docs). */
|
|
72
|
+
description?: string;
|
|
73
|
+
/**
|
|
74
|
+
* When set, declares the action member-directed: the engine will gate it on
|
|
75
|
+
* the recipient's channel preferences before the plugin runs (enforcement
|
|
76
|
+
* lands in a later phase). Absent = ops/channel-directed = never gated.
|
|
77
|
+
*/
|
|
78
|
+
audience?: MemberAudience<A>;
|
|
79
|
+
/** Perform the outbound action. Single-object-in, result-out. */
|
|
80
|
+
run(args: A, ctx: ConnectorActionCtx): Promise<R>;
|
|
81
|
+
}
|
|
82
|
+
/** Identity/validating authoring helper (mirrors `defineConnector`/`defineDestination`). */
|
|
83
|
+
export declare function defineConnectorAction<A, R>(def: DefinedConnectorAction<A, R>): DefinedConnectorAction<A, R>;
|
|
84
|
+
/**
|
|
85
|
+
* The verdict returned when the engine SKIPS a member-directed connector action
|
|
86
|
+
* because the resolved recipient opted out — either the global master opt-out
|
|
87
|
+
* (`unsubscribed_all`) or the per-connector channel list (`channel_unsubscribed`)
|
|
88
|
+
* — or because the recipient is a cold prospect (their `contacts.source` names a
|
|
89
|
+
* registered Contact Source) whose source posture blocks this connector's
|
|
90
|
+
* channel (`cold_channel_blocked`).
|
|
91
|
+
*
|
|
92
|
+
* A plain JSON-safe POJO so it is memo-recordable and replays VERBATIM through
|
|
93
|
+
* both the Hatchet durable `memo` (Layer 1) AND the `connector_deliveries.result`
|
|
94
|
+
* jsonb round-trip (Layer 2) — although a skip in practice NEVER writes a
|
|
95
|
+
* delivery row (the gate runs BEFORE the ledger claim), so a skip is observable
|
|
96
|
+
* only via logs + this returned value.
|
|
97
|
+
*
|
|
98
|
+
* The shape DELIBERATELY does NOT mimic per-action result shapes (it carries no
|
|
99
|
+
* `messageId`/`delivered`): the `skipped: true` discriminant must be
|
|
100
|
+
* unambiguous. An existing consumer reading `result.delivered` gets `undefined`
|
|
101
|
+
* (falsy) on a skip — which degrades in the correct direction (treated as "not
|
|
102
|
+
* delivered").
|
|
103
|
+
*/
|
|
104
|
+
export interface ConnectorActionSkipped {
|
|
105
|
+
skipped: true;
|
|
106
|
+
reason: "unsubscribed_all" | "channel_unsubscribed" | "cold_channel_blocked";
|
|
107
|
+
connectorId: string;
|
|
108
|
+
action: string;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Narrow an outbound-action result to a {@link ConnectorActionSkipped} verdict.
|
|
112
|
+
* Checks a non-null object with `skipped === true` plus string
|
|
113
|
+
* `reason`/`connectorId`/`action` — enough to disambiguate from every per-action
|
|
114
|
+
* result shape.
|
|
115
|
+
*/
|
|
116
|
+
export declare function isConnectorActionSkipped(r: unknown): r is ConnectorActionSkipped;
|
|
117
|
+
//# sourceMappingURL=define-action.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"define-action.d.ts","sourceRoot":"","sources":["../../src/connectors/define-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;CACpE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAC9D,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7B,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnD;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EACxC,GAAG,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAE9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,OAAO,GACT,CAAC,IAAI,sBAAsB,CAS7B"}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
import type { Database } from "@hogsend/db";
|
|
2
|
+
import type { z } from "zod";
|
|
3
|
+
import type { env as engineEnv } from "../env.js";
|
|
4
|
+
import type { ConnectorStateIntent } from "../lib/connector-state.js";
|
|
5
|
+
import type { IngestEvent } from "../lib/ingestion.js";
|
|
6
|
+
import type { Logger } from "../lib/logger.js";
|
|
7
|
+
import type { SignatureScheme, VerifySignatureArgs } from "../webhook-sources/verify.js";
|
|
8
|
+
/**
|
|
9
|
+
* The unified INBOUND connector abstraction. A connector is one platform's
|
|
10
|
+
* inbound face — it turns a raw platform payload into an {@link IngestEvent}
|
|
11
|
+
* via {@link DefinedConnector.transform}. The transform contract is IDENTICAL
|
|
12
|
+
* across transports; only the ACTIVATION RUNTIME differs:
|
|
13
|
+
*
|
|
14
|
+
* - `"webhook"` — an HTTP route (`POST /v1/webhooks/:id`) verifies the inbound
|
|
15
|
+
* request and calls `transform`. (The long-standing `defineWebhookSource`
|
|
16
|
+
* behavior, now one transport under this umbrella.)
|
|
17
|
+
* - `"gateway"` — a long-lived worker process (its OWN entrypoint / Railway
|
|
18
|
+
* service, NOT a Hatchet task) holds a socket to the platform, and on each
|
|
19
|
+
* platform event POSTs into this connector's own ingress
|
|
20
|
+
* (`POST /v1/connectors/:id/ingress`, shared internal secret) so ALL
|
|
21
|
+
* transform logic stays here and the socket worker stays dumb.
|
|
22
|
+
* - `"poll"` — a Hatchet cron pulls the platform on a schedule (using the
|
|
23
|
+
* stored credential) and runs `transform` per pulled item.
|
|
24
|
+
*
|
|
25
|
+
* The symmetric INBOUND twin of {@link DefinedDestination}.
|
|
26
|
+
* {@link defineConnector} is an identity / validating function.
|
|
27
|
+
*/
|
|
28
|
+
export type ConnectorTransport = "webhook" | "gateway" | "poll";
|
|
29
|
+
/**
|
|
30
|
+
* INBOUND-REQUEST VERIFICATION — webhook transport only. "Does this HTTP
|
|
31
|
+
* request prove it came from the platform?" The EXACT pre-existing
|
|
32
|
+
* `WebhookSourceAuth` union, re-homed here (re-exported by
|
|
33
|
+
* define-webhook-source for back-compat). `match` = shared-secret equality
|
|
34
|
+
* (OPEN when unset); `signature` = provider HMAC (FAIL CLOSED when unset).
|
|
35
|
+
*/
|
|
36
|
+
export type InboundVerifyAuth = {
|
|
37
|
+
type: "match";
|
|
38
|
+
header: string;
|
|
39
|
+
envKey: string;
|
|
40
|
+
} | {
|
|
41
|
+
type: "signature";
|
|
42
|
+
scheme: SignatureScheme;
|
|
43
|
+
envKey: string;
|
|
44
|
+
header: string;
|
|
45
|
+
fallbackMatchHeader?: string;
|
|
46
|
+
verify?(args: VerifySignatureArgs): boolean | Promise<boolean>;
|
|
47
|
+
};
|
|
48
|
+
/**
|
|
49
|
+
* STORED OUTBOUND CREDENTIAL — gateway/poll transports only. The connector PULLS
|
|
50
|
+
* from the platform and must present a credential. Declares WHICH
|
|
51
|
+
* `provider_credentials` row to read. The engine resolves the row at activation
|
|
52
|
+
* time and hands the decrypted material to the gateway worker / poll cron —
|
|
53
|
+
* never the transform. SEPARATE from {@link InboundVerifyAuth} by design.
|
|
54
|
+
*/
|
|
55
|
+
export interface StoredCredentialRef {
|
|
56
|
+
/** `provider_credentials.providerId` to read (defaults to `meta.id`). */
|
|
57
|
+
providerId?: string;
|
|
58
|
+
/** Which credential kind the runtime resolves. Default `"oauth"`. */
|
|
59
|
+
kind?: "oauth" | "derived";
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Side context handed to {@link DefinedConnector.transform}. A superset of the
|
|
63
|
+
* old `WebhookSourceCtx`: `rawBody`/`headers` are populated by the webhook
|
|
64
|
+
* route; `transport` lets a shared transform branch when a platform feeds more
|
|
65
|
+
* than one transport.
|
|
66
|
+
*/
|
|
67
|
+
export interface ConnectorCtx {
|
|
68
|
+
db: Database;
|
|
69
|
+
logger: Logger;
|
|
70
|
+
/** Which activation runtime invoked the transform. */
|
|
71
|
+
transport: ConnectorTransport;
|
|
72
|
+
/** Webhook transport only — EXACT raw request bytes. */
|
|
73
|
+
rawBody?: string;
|
|
74
|
+
/** Webhook transport only — inbound request headers (lowercased keys). */
|
|
75
|
+
headers?: Record<string, string>;
|
|
76
|
+
}
|
|
77
|
+
export interface ConnectorMeta {
|
|
78
|
+
id: string;
|
|
79
|
+
name: string;
|
|
80
|
+
description?: string;
|
|
81
|
+
/** The activation runtime. Defaults to `"webhook"` (back-compat). */
|
|
82
|
+
transport?: ConnectorTransport;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Minimal handler context for the generic connector routes. `env` is the EXACT
|
|
86
|
+
* validated engine env object (number/boolean fields included) — NOT a string
|
|
87
|
+
* Record — so the route can pass `c.get("container").env` straight through.
|
|
88
|
+
*/
|
|
89
|
+
export interface ConnectorRouteCtx {
|
|
90
|
+
db: Database;
|
|
91
|
+
logger: Logger;
|
|
92
|
+
env: typeof engineEnv;
|
|
93
|
+
/** Public base URL of this instance (redirect-URI construction). */
|
|
94
|
+
apiPublicUrl: string;
|
|
95
|
+
}
|
|
96
|
+
export type ConnectorOAuthResult = {
|
|
97
|
+
kind: "redirect";
|
|
98
|
+
location: string;
|
|
99
|
+
} | {
|
|
100
|
+
kind: "json";
|
|
101
|
+
status: number;
|
|
102
|
+
body: unknown;
|
|
103
|
+
} | {
|
|
104
|
+
kind: "html";
|
|
105
|
+
status: number;
|
|
106
|
+
body: string;
|
|
107
|
+
};
|
|
108
|
+
export type ConnectorInteractionResult = {
|
|
109
|
+
kind: "ack";
|
|
110
|
+
status?: number;
|
|
111
|
+
body?: unknown;
|
|
112
|
+
} | {
|
|
113
|
+
kind: "ingest";
|
|
114
|
+
event: IngestEvent;
|
|
115
|
+
} | {
|
|
116
|
+
kind: "unauthorized";
|
|
117
|
+
};
|
|
118
|
+
/**
|
|
119
|
+
* OPTIONAL per-connector OAuth + interactions hooks dispatched by the GENERIC
|
|
120
|
+
* engine routes (mirrors how `/v1/webhooks/:sourceId` dispatches `transform`),
|
|
121
|
+
* so platform #3 needs no new routes.
|
|
122
|
+
*
|
|
123
|
+
* - `oauthCallback` — handle `GET|POST /v1/connectors/:id/oauth/callback`:
|
|
124
|
+
* exchange the code, persist into `provider_credentials`, return a
|
|
125
|
+
* redirect/JSON result. The connector imports the engine's credential-save
|
|
126
|
+
* helpers directly (they are public exports). The ENGINE owns CSRF `state`
|
|
127
|
+
* verification GENERICALLY (the route verifies the signed state before
|
|
128
|
+
* dispatch and hands the decoded {@link ConnectorStateIntent} in as `state`);
|
|
129
|
+
* the handler must NOT re-verify the raw query `state`.
|
|
130
|
+
* - `interactions` — handle `POST /v1/connectors/:id/interactions`: the
|
|
131
|
+
* connector verifies the platform signature ITSELF (Discord ed25519), may
|
|
132
|
+
* 200 a handshake (Discord PING), and may return an {@link IngestEvent}.
|
|
133
|
+
*/
|
|
134
|
+
export interface ConnectorHandlers {
|
|
135
|
+
oauthCallback?(args: {
|
|
136
|
+
query: Record<string, string>;
|
|
137
|
+
body: unknown;
|
|
138
|
+
/** Engine-verified, decoded OAuth `state` (CSRF + member-link binding). */
|
|
139
|
+
state: ConnectorStateIntent;
|
|
140
|
+
ctx: ConnectorRouteCtx;
|
|
141
|
+
}): Promise<ConnectorOAuthResult>;
|
|
142
|
+
interactions?(args: {
|
|
143
|
+
rawBody: string;
|
|
144
|
+
headers: Record<string, string>;
|
|
145
|
+
ctx: ConnectorRouteCtx;
|
|
146
|
+
}): Promise<ConnectorInteractionResult>;
|
|
147
|
+
}
|
|
148
|
+
export interface DefinedConnector<T = unknown> {
|
|
149
|
+
meta: ConnectorMeta;
|
|
150
|
+
/**
|
|
151
|
+
* Inbound-request verification — REQUIRED for `transport: "webhook"`,
|
|
152
|
+
* forbidden otherwise.
|
|
153
|
+
*/
|
|
154
|
+
inboundVerify?: InboundVerifyAuth;
|
|
155
|
+
/** Stored outbound credential to pull with — used by `gateway`/`poll`. */
|
|
156
|
+
credential?: StoredCredentialRef;
|
|
157
|
+
/** Optional Zod schema validating the payload BEFORE transform. */
|
|
158
|
+
schema?: z.ZodSchema<T>;
|
|
159
|
+
/**
|
|
160
|
+
* The transport-invariant heart: raw platform payload →
|
|
161
|
+
* `IngestEvent | IngestEvent[] | null`. Returning an ARRAY fans one inbound
|
|
162
|
+
* dispatch into multiple subject-keyed events (e.g. a Discord reaction →
|
|
163
|
+
* reactor-keyed `reaction_added` + author-keyed `reaction_received`); each
|
|
164
|
+
* element ingests independently with its own idempotencyKey (see
|
|
165
|
+
* `ingestTransformResult`).
|
|
166
|
+
*/
|
|
167
|
+
transform(payload: T, ctx: ConnectorCtx): Promise<IngestEvent | IngestEvent[] | null>;
|
|
168
|
+
/** OPTIONAL OAuth + interactions hooks for the generic dispatch routes. */
|
|
169
|
+
handlers?: ConnectorHandlers;
|
|
170
|
+
}
|
|
171
|
+
export declare function defineConnector<T>(def: DefinedConnector<T>): DefinedConnector<T>;
|
|
172
|
+
//# sourceMappingURL=define-connector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"define-connector.d.ts","sourceRoot":"","sources":["../../src/connectors/define-connector.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { env as engineEnv } from "../../env.js";
|
|
2
|
+
import type { DefinedConnector } from "../define-connector.js";
|
|
3
|
+
/**
|
|
4
|
+
* Every shipped connector preset, keyed by id. Webhook-transport presets are
|
|
5
|
+
* the existing `defineWebhookSource` presets lifted onto the umbrella; gateway/
|
|
6
|
+
* poll presets (Discord) are SHIPPED IN THE PLUGIN, not here — the engine
|
|
7
|
+
* bundles no Discord code.
|
|
8
|
+
*/
|
|
9
|
+
export declare const PRESET_CONNECTORS: Record<string, DefinedConnector>;
|
|
10
|
+
/**
|
|
11
|
+
* Resolve which connector presets to register from env. Webhook presets keep
|
|
12
|
+
* their exact env-secret gating (delegated to `presetsFromEnv`). Gateway/poll
|
|
13
|
+
* presets are consumer-supplied via `opts.connectors` (the Discord plugin), so
|
|
14
|
+
* this preset resolver covers only the engine-shipped webhook presets.
|
|
15
|
+
*/
|
|
16
|
+
export declare function connectorsFromEnv(env: typeof engineEnv): DefinedConnector[];
|
|
17
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AASrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAS5D,CAAC;AAEJ;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,SAAS,GAAG,gBAAgB,EAAE,CAE3E"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import type { ConnectorTransport, DefinedConnector } from "./define-connector.js";
|
|
2
|
+
/**
|
|
3
|
+
* The process-wide connector registry, set once by `createHogsendClient` at
|
|
4
|
+
* startup. Mirrors {@link DestinationRegistry}: keyed by `meta.id`,
|
|
5
|
+
* last-writer-wins on collision, with a lazy preset-only fallback so a
|
|
6
|
+
* self-booting context (a bare poll cron, a test harness) still resolves the
|
|
7
|
+
* shipped presets even before any container ran.
|
|
8
|
+
*
|
|
9
|
+
* Read by: the webhook route (`getByTransport("webhook")`), the generic
|
|
10
|
+
* `/v1/connectors/:id/*` routes (`get(id)` → `handlers`), the poll-cron
|
|
11
|
+
* registrar, and the gateway launcher.
|
|
12
|
+
*/
|
|
13
|
+
export declare class ConnectorRegistry {
|
|
14
|
+
private readonly byId;
|
|
15
|
+
constructor(connectors?: DefinedConnector[]);
|
|
16
|
+
/** Register / overwrite a connector (last-writer-wins). */
|
|
17
|
+
register(connector: DefinedConnector): void;
|
|
18
|
+
/**
|
|
19
|
+
* Remove a connector by id (no-op when absent). Used by the deprecated
|
|
20
|
+
* `createApp({ enablePresets: false })` strip path to suppress env presets the
|
|
21
|
+
* container already installed.
|
|
22
|
+
*/
|
|
23
|
+
unregister(id: string): boolean;
|
|
24
|
+
get(id: string): DefinedConnector | undefined;
|
|
25
|
+
getAll(): DefinedConnector[];
|
|
26
|
+
/** Every connector whose (defaulted) transport matches. */
|
|
27
|
+
getByTransport(transport: ConnectorTransport): DefinedConnector[];
|
|
28
|
+
count(): number;
|
|
29
|
+
}
|
|
30
|
+
export declare function setConnectorRegistry(registry: ConnectorRegistry): void;
|
|
31
|
+
export declare function getConnectorRegistry(): ConnectorRegistry;
|
|
32
|
+
/** Reset the installed registry — only for test cleanup. */
|
|
33
|
+
export declare function resetConnectorRegistry(): void;
|
|
34
|
+
//# sourceMappingURL=registry-singleton.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry-singleton.d.ts","sourceRoot":"","sources":["../../src/connectors/registry-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;gBAEhD,UAAU,GAAE,gBAAgB,EAAO;IAM/C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAI3C;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C,MAAM,IAAI,gBAAgB,EAAE;IAI5B,2DAA2D;IAC3D,cAAc,CAAC,SAAS,EAAE,kBAAkB,GAAG,gBAAgB,EAAE;IAMjE,KAAK,IAAI,MAAM;CAGhB;AAKD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEtE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAMxD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import type { HogsendClient } from "../container.js";
|
|
2
|
+
import type { Logger } from "../lib/logger.js";
|
|
3
|
+
/**
|
|
4
|
+
* The connector-agnostic INBOUND RUNTIME seam. A `gateway`-transport connector
|
|
5
|
+
* (Discord today, Slack tomorrow) needs a long-lived process holding a socket to
|
|
6
|
+
* the platform. Rather than a hand-wired standalone service per consumer, the
|
|
7
|
+
* engine boots that runtime INLINE inside the process every consumer already
|
|
8
|
+
* runs (the Hatchet worker by default), gated by a Redis LEADER LEASE so exactly
|
|
9
|
+
* ONE replica ever holds the socket — one bot token permits one live session.
|
|
10
|
+
*
|
|
11
|
+
* A platform plugin contributes a {@link ConnectorRuntimeFactory} (supplied to
|
|
12
|
+
* `createWorker({ connectorRuntimes })`); the engine owns everything
|
|
13
|
+
* platform-neutral: lease election, the in-process dispatch→transform→ingest
|
|
14
|
+
* sink (no HTTP hop, no shared secret), the owned heartbeat, and shutdown
|
|
15
|
+
* ordering. A second connector reuses this verbatim — it only writes a
|
|
16
|
+
* `defineConnector` + a runtime factory, and touches zero engine code.
|
|
17
|
+
*/
|
|
18
|
+
/** The minimal long-lived runtime a platform plugin supplies (e.g. a discord.js socket). */
|
|
19
|
+
export interface ConnectorRuntime {
|
|
20
|
+
/** Open the socket. Rejects loudly on a fatal config error (bad token/intents). */
|
|
21
|
+
start(): Promise<void>;
|
|
22
|
+
/** Close the socket and clear timers (awaited on demotion / shutdown). */
|
|
23
|
+
stop(): Promise<void>;
|
|
24
|
+
/** Platform metadata to fold into the heartbeat (e.g. `{ intents }`). */
|
|
25
|
+
getMetadata(): Record<string, unknown>;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* What the engine injects into a runtime factory. `ingest` is the in-process
|
|
29
|
+
* sink: hand it a raw platform dispatch and the engine runs the connector's own
|
|
30
|
+
* `transform` then `ingestEvent` — the EXACT pair the HTTP ingress route runs,
|
|
31
|
+
* minus the network hop. `onMetadata` folds a late-observed field (e.g. the
|
|
32
|
+
* guild id seen at GUILD_CREATE) into the live heartbeat.
|
|
33
|
+
*/
|
|
34
|
+
export interface ConnectorRuntimeDeps {
|
|
35
|
+
ingest(dispatchType: string, data: unknown): Promise<{
|
|
36
|
+
ok: boolean;
|
|
37
|
+
status: number;
|
|
38
|
+
}>;
|
|
39
|
+
onMetadata(patch: Record<string, unknown>): void;
|
|
40
|
+
logger: Logger;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Build a runtime for a connector, or return `null` when it is not configured to
|
|
44
|
+
* run here (e.g. the platform's bot token env is unset) — the engine then simply
|
|
45
|
+
* skips it without holding a lease.
|
|
46
|
+
*/
|
|
47
|
+
export type ConnectorRuntimeFactory = (deps: ConnectorRuntimeDeps) => ConnectorRuntime | null;
|
|
48
|
+
export interface ConnectorRuntimesHandle {
|
|
49
|
+
/** Release every lease + delete heartbeats BEFORE stopping sockets. */
|
|
50
|
+
stop(): Promise<void>;
|
|
51
|
+
}
|
|
52
|
+
export interface StartConnectorRuntimesArgs {
|
|
53
|
+
client: HogsendClient;
|
|
54
|
+
/** Platform runtime factories keyed by connector id (from createWorker opts). */
|
|
55
|
+
factories: Record<string, ConnectorRuntimeFactory>;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Boot the inline runtimes for every registered `gateway`-transport connector
|
|
59
|
+
* that has a supplied factory. Fire-and-forget per connector (each runs its own
|
|
60
|
+
* lease loop); returns a handle whose `stop()` releases all leases + deletes
|
|
61
|
+
* heartbeats before stopping sockets (graceful, heartbeat-first ordering).
|
|
62
|
+
*
|
|
63
|
+
* No-ops cleanly when there are no gateway connectors, no factories, or a
|
|
64
|
+
* factory declines (returns null) — so a deploy with nothing configured carries
|
|
65
|
+
* zero cost.
|
|
66
|
+
*/
|
|
67
|
+
export declare function startConnectorRuntimes(args: StartConnectorRuntimesArgs): ConnectorRuntimesHandle;
|
|
68
|
+
//# sourceMappingURL=runtime.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/connectors/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAYrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;;;;;;;GAcG;AAEH,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,yEAAyE;IACzE,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CACJ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,IAAI,EAAE,oBAAoB,KACvB,gBAAgB,GAAG,IAAI,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAmMD,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,0BAA0B,GAC/B,uBAAuB,CA+BzB"}
|