@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,266 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Journey Blueprint authoring tools (spec §9, phase 4) — the agent-facing
|
|
3
|
+
* surface for creating, validating, and operating blueprints without a
|
|
4
|
+
* deploy in the loop.
|
|
5
|
+
*
|
|
6
|
+
* Deliberately TRANSPORT-AGNOSTIC: this repo runs no MCP server today, so
|
|
7
|
+
* each tool is a plain `{ name, description, inputSchema, handler }` record
|
|
8
|
+
* rather than a registration against a specific SDK. That shape mounts
|
|
9
|
+
* 1:1 onto whatever hosts it:
|
|
10
|
+
* - an MCP server: `server.registerTool(t.name, { description, inputSchema }, t.handler)`
|
|
11
|
+
* - the Vercel AI SDK (like `buildAgentTools`): `tool({ description, inputSchema, execute: t.handler })`
|
|
12
|
+
* - direct in-process calls (tests, scripts): `await t.handler(input)`
|
|
13
|
+
*
|
|
14
|
+
* Handlers call the SAME service layer the admin routes use
|
|
15
|
+
* (`lib/blueprints.ts`) — in-process function calls, no HTTP round-trip, no
|
|
16
|
+
* parallel auth or storage path (spec §9: "thin wrapper … no parallel auth
|
|
17
|
+
* or storage path"). Authentication is the MOUNTING surface's job, exactly
|
|
18
|
+
* as `adminRouter` middleware is for the routes: do not expose these tools
|
|
19
|
+
* without an auth gate in front of them.
|
|
20
|
+
*
|
|
21
|
+
* Contract: handlers NEVER throw for expected failures. Every result is a
|
|
22
|
+
* discriminated union on `ok` (+ `code` on failures), and graph problems
|
|
23
|
+
* carry the same structured `BlueprintValidationIssue[]` the admin routes
|
|
24
|
+
* return — an authoring agent iterates on an itemized "what's wrong and
|
|
25
|
+
* where" list, not a caught exception's `.message`. Unexpected errors (DB
|
|
26
|
+
* down, …) still throw and are the host's problem.
|
|
27
|
+
*/
|
|
28
|
+
import type { BlueprintValidationIssue } from "@hogsend/core";
|
|
29
|
+
import { z } from "zod";
|
|
30
|
+
import { type BlueprintServiceContainer, type SerializedBlueprint } from "../lib/blueprints.js";
|
|
31
|
+
/** Issue shape shared by input parsing and graph validation failures. */
|
|
32
|
+
export type BlueprintToolIssue = {
|
|
33
|
+
nodeId?: string;
|
|
34
|
+
edgeId?: string;
|
|
35
|
+
path: (string | number)[];
|
|
36
|
+
code: string;
|
|
37
|
+
message: string;
|
|
38
|
+
};
|
|
39
|
+
/** Returned when the tool call's arguments don't parse against `inputSchema`. */
|
|
40
|
+
export type BlueprintToolInvalidInput = {
|
|
41
|
+
ok: false;
|
|
42
|
+
code: "invalid_input";
|
|
43
|
+
error: string;
|
|
44
|
+
issues: BlueprintToolIssue[];
|
|
45
|
+
};
|
|
46
|
+
/**
|
|
47
|
+
* One tool: a name, an agent-facing description, a Zod input schema (convert
|
|
48
|
+
* with `z.toJSONSchema` for hosts that speak JSON Schema, e.g. MCP), and a
|
|
49
|
+
* handler. The handler safe-parses its own input (applying defaults), so it
|
|
50
|
+
* is self-contained even when the host doesn't pre-validate.
|
|
51
|
+
*/
|
|
52
|
+
export interface BlueprintToolDefinition<S extends z.ZodType, Out> {
|
|
53
|
+
name: string;
|
|
54
|
+
description: string;
|
|
55
|
+
inputSchema: S;
|
|
56
|
+
handler: (input: unknown) => Promise<Out | BlueprintToolInvalidInput>;
|
|
57
|
+
}
|
|
58
|
+
type ToolWriteSuccess = {
|
|
59
|
+
ok: true;
|
|
60
|
+
blueprint: SerializedBlueprint;
|
|
61
|
+
};
|
|
62
|
+
type ToolNotFound = {
|
|
63
|
+
ok: false;
|
|
64
|
+
code: "not_found";
|
|
65
|
+
error: string;
|
|
66
|
+
};
|
|
67
|
+
type ToolConflict = {
|
|
68
|
+
ok: false;
|
|
69
|
+
code: "conflict";
|
|
70
|
+
error: string;
|
|
71
|
+
};
|
|
72
|
+
type ToolPromoted = {
|
|
73
|
+
ok: false;
|
|
74
|
+
code: "promoted";
|
|
75
|
+
error: string;
|
|
76
|
+
};
|
|
77
|
+
type ToolInFlight = {
|
|
78
|
+
ok: false;
|
|
79
|
+
code: "in_flight";
|
|
80
|
+
error: string;
|
|
81
|
+
};
|
|
82
|
+
type ToolVersionConflict = {
|
|
83
|
+
ok: false;
|
|
84
|
+
code: "version_conflict";
|
|
85
|
+
error: string;
|
|
86
|
+
};
|
|
87
|
+
type ToolInvalidGraph = {
|
|
88
|
+
ok: false;
|
|
89
|
+
code: "invalid_graph";
|
|
90
|
+
error: string;
|
|
91
|
+
issues: BlueprintValidationIssue[];
|
|
92
|
+
};
|
|
93
|
+
export interface JourneyBlueprintToolsOptions {
|
|
94
|
+
/** The DI client (or a Pick of db/registry/templates/connectorActionRegistry). */
|
|
95
|
+
container: BlueprintServiceContainer;
|
|
96
|
+
/**
|
|
97
|
+
* Actor label stamped into `journey_blueprints.createdBy` for every create —
|
|
98
|
+
* bind the mounting session's identity here (e.g. an MCP session id or
|
|
99
|
+
* operator email) for Studio's post-hoc oversight. It is NOT a tool input:
|
|
100
|
+
* a model cannot attribute a blueprint to anyone, exactly as `source` is
|
|
101
|
+
* stamped by the surface.
|
|
102
|
+
*/
|
|
103
|
+
createdBy?: string;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Build the journey-blueprint tool set (spec §9). See the module docs for
|
|
107
|
+
* the mounting contract; `Object.values(tools)` gives the array form.
|
|
108
|
+
*/
|
|
109
|
+
export declare function createJourneyBlueprintTools(options: JourneyBlueprintToolsOptions): {
|
|
110
|
+
create_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
|
|
111
|
+
name: z.ZodString;
|
|
112
|
+
status: z.ZodDefault<z.ZodEnum<{
|
|
113
|
+
draft: "draft";
|
|
114
|
+
enabled: "enabled";
|
|
115
|
+
}>>;
|
|
116
|
+
description: z.ZodOptional<z.ZodString>;
|
|
117
|
+
triggerEvent: z.ZodString;
|
|
118
|
+
triggerWhere: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
119
|
+
type: z.ZodLiteral<"property">;
|
|
120
|
+
property: z.ZodString;
|
|
121
|
+
operator: z.ZodEnum<{
|
|
122
|
+
eq: "eq";
|
|
123
|
+
neq: "neq";
|
|
124
|
+
gt: "gt";
|
|
125
|
+
gte: "gte";
|
|
126
|
+
lt: "lt";
|
|
127
|
+
lte: "lte";
|
|
128
|
+
exists: "exists";
|
|
129
|
+
not_exists: "not_exists";
|
|
130
|
+
contains: "contains";
|
|
131
|
+
}>;
|
|
132
|
+
value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
|
|
133
|
+
}, z.core.$strip>>>;
|
|
134
|
+
entryLimit: z.ZodEnum<{
|
|
135
|
+
once: "once";
|
|
136
|
+
once_per_period: "once_per_period";
|
|
137
|
+
unlimited: "unlimited";
|
|
138
|
+
}>;
|
|
139
|
+
entryPeriod: z.ZodOptional<z.ZodObject<{
|
|
140
|
+
hours: z.ZodOptional<z.ZodNumber>;
|
|
141
|
+
minutes: z.ZodOptional<z.ZodNumber>;
|
|
142
|
+
seconds: z.ZodOptional<z.ZodNumber>;
|
|
143
|
+
}, z.core.$strict>>;
|
|
144
|
+
exitOn: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
145
|
+
event: z.ZodString;
|
|
146
|
+
where: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
147
|
+
type: z.ZodLiteral<"property">;
|
|
148
|
+
property: z.ZodString;
|
|
149
|
+
operator: z.ZodEnum<{
|
|
150
|
+
eq: "eq";
|
|
151
|
+
neq: "neq";
|
|
152
|
+
gt: "gt";
|
|
153
|
+
gte: "gte";
|
|
154
|
+
lt: "lt";
|
|
155
|
+
lte: "lte";
|
|
156
|
+
exists: "exists";
|
|
157
|
+
not_exists: "not_exists";
|
|
158
|
+
contains: "contains";
|
|
159
|
+
}>;
|
|
160
|
+
value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
|
|
161
|
+
}, z.core.$strip>>>;
|
|
162
|
+
}, z.core.$strip>>>;
|
|
163
|
+
suppress: z.ZodObject<{
|
|
164
|
+
hours: z.ZodOptional<z.ZodNumber>;
|
|
165
|
+
minutes: z.ZodOptional<z.ZodNumber>;
|
|
166
|
+
seconds: z.ZodOptional<z.ZodNumber>;
|
|
167
|
+
}, z.core.$strict>;
|
|
168
|
+
graph: z.ZodUnknown;
|
|
169
|
+
}, z.core.$strip>, ToolWriteSuccess | ToolConflict | ToolInvalidGraph>;
|
|
170
|
+
update_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
|
|
171
|
+
name: z.ZodOptional<z.ZodString>;
|
|
172
|
+
description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
173
|
+
triggerEvent: z.ZodOptional<z.ZodString>;
|
|
174
|
+
triggerWhere: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
|
|
175
|
+
type: z.ZodLiteral<"property">;
|
|
176
|
+
property: z.ZodString;
|
|
177
|
+
operator: z.ZodEnum<{
|
|
178
|
+
eq: "eq";
|
|
179
|
+
neq: "neq";
|
|
180
|
+
gt: "gt";
|
|
181
|
+
gte: "gte";
|
|
182
|
+
lt: "lt";
|
|
183
|
+
lte: "lte";
|
|
184
|
+
exists: "exists";
|
|
185
|
+
not_exists: "not_exists";
|
|
186
|
+
contains: "contains";
|
|
187
|
+
}>;
|
|
188
|
+
value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
|
|
189
|
+
}, z.core.$strip>>>>;
|
|
190
|
+
entryLimit: z.ZodOptional<z.ZodEnum<{
|
|
191
|
+
once: "once";
|
|
192
|
+
once_per_period: "once_per_period";
|
|
193
|
+
unlimited: "unlimited";
|
|
194
|
+
}>>;
|
|
195
|
+
entryPeriod: z.ZodOptional<z.ZodNullable<z.ZodObject<{
|
|
196
|
+
hours: z.ZodOptional<z.ZodNumber>;
|
|
197
|
+
minutes: z.ZodOptional<z.ZodNumber>;
|
|
198
|
+
seconds: z.ZodOptional<z.ZodNumber>;
|
|
199
|
+
}, z.core.$strict>>>;
|
|
200
|
+
exitOn: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
|
|
201
|
+
event: z.ZodString;
|
|
202
|
+
where: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
203
|
+
type: z.ZodLiteral<"property">;
|
|
204
|
+
property: z.ZodString;
|
|
205
|
+
operator: z.ZodEnum<{
|
|
206
|
+
eq: "eq";
|
|
207
|
+
neq: "neq";
|
|
208
|
+
gt: "gt";
|
|
209
|
+
gte: "gte";
|
|
210
|
+
lt: "lt";
|
|
211
|
+
lte: "lte";
|
|
212
|
+
exists: "exists";
|
|
213
|
+
not_exists: "not_exists";
|
|
214
|
+
contains: "contains";
|
|
215
|
+
}>;
|
|
216
|
+
value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
|
|
217
|
+
}, z.core.$strip>>>;
|
|
218
|
+
}, z.core.$strip>>>>;
|
|
219
|
+
suppress: z.ZodOptional<z.ZodObject<{
|
|
220
|
+
hours: z.ZodOptional<z.ZodNumber>;
|
|
221
|
+
minutes: z.ZodOptional<z.ZodNumber>;
|
|
222
|
+
seconds: z.ZodOptional<z.ZodNumber>;
|
|
223
|
+
}, z.core.$strict>>;
|
|
224
|
+
graph: z.ZodOptional<z.ZodUnknown>;
|
|
225
|
+
id: z.ZodString;
|
|
226
|
+
}, z.core.$strip>, ToolWriteSuccess | ToolNotFound | ToolPromoted | ToolInFlight | ToolVersionConflict | ToolInvalidGraph>;
|
|
227
|
+
validate_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
|
|
228
|
+
graph: z.ZodOptional<z.ZodUnknown>;
|
|
229
|
+
id: z.ZodOptional<z.ZodString>;
|
|
230
|
+
}, z.core.$strip>, ToolNotFound | {
|
|
231
|
+
ok: true;
|
|
232
|
+
valid: boolean;
|
|
233
|
+
issues: BlueprintValidationIssue[];
|
|
234
|
+
}>;
|
|
235
|
+
list_email_templates: BlueprintToolDefinition<z.ZodObject<{}, z.core.$strip>, {
|
|
236
|
+
ok: true;
|
|
237
|
+
templates: {
|
|
238
|
+
key: string;
|
|
239
|
+
defaultSubject: string | undefined;
|
|
240
|
+
category: string | undefined;
|
|
241
|
+
}[];
|
|
242
|
+
}>;
|
|
243
|
+
list_events: BlueprintToolDefinition<z.ZodObject<{
|
|
244
|
+
search: z.ZodOptional<z.ZodString>;
|
|
245
|
+
limit: z.ZodDefault<z.ZodNumber>;
|
|
246
|
+
}, z.core.$strip>, {
|
|
247
|
+
ok: true;
|
|
248
|
+
note: string;
|
|
249
|
+
events: {
|
|
250
|
+
name: string;
|
|
251
|
+
occurrences: number;
|
|
252
|
+
firstSeenAt: string | null;
|
|
253
|
+
lastSeenAt: string | null;
|
|
254
|
+
usedBy: string[];
|
|
255
|
+
}[];
|
|
256
|
+
}>;
|
|
257
|
+
enable_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
|
|
258
|
+
id: z.ZodString;
|
|
259
|
+
}, z.core.$strip>, ToolWriteSuccess | ToolNotFound | ToolPromoted | ToolInvalidGraph>;
|
|
260
|
+
disable_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
|
|
261
|
+
id: z.ZodString;
|
|
262
|
+
}, z.core.$strip>, ToolWriteSuccess | ToolNotFound>;
|
|
263
|
+
};
|
|
264
|
+
export type JourneyBlueprintTools = ReturnType<typeof createJourneyBlueprintTools>;
|
|
265
|
+
export {};
|
|
266
|
+
//# sourceMappingURL=blueprint-tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"blueprint-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/blueprint-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,KAAK,yBAAyB,EAO9B,KAAK,mBAAmB,EAIzB,MAAM,sBAAsB,CAAC;AAQ9B,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,GAAG,yBAAyB,CAAC,CAAC;CACvE;AAqCD,KAAK,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,mBAAmB,CAAA;CAAE,CAAC;AACrE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AACF,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACpC,CAAC;AAsDF,MAAM,WAAW,4BAA4B;IAC3C,kFAAkF;IAClF,SAAS,EAAE,yBAAyB,CAAC;IACrC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA4EzB,IAAI;eAAS,OAAO;gBAAU,wBAAwB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2GrE;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAC5C,OAAO,2BAA2B,CACnC,CAAC"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { type Database } from "@hogsend/db";
|
|
2
|
+
import type { AppEnv } from "../app.js";
|
|
3
|
+
export interface ApiKeyContext {
|
|
4
|
+
id: string;
|
|
5
|
+
name: string;
|
|
6
|
+
scopes: string[];
|
|
7
|
+
allowedOrigins?: string[] | null;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Single source of truth for scope checks.
|
|
11
|
+
*
|
|
12
|
+
* - Hierarchical scopes (`read` < `journey-admin` < `full-admin`): the key
|
|
13
|
+
* passes when the MAX hierarchical rank it holds is >= the required rank.
|
|
14
|
+
* - Orthogonal scopes (e.g. `ingest`): NOT part of the hierarchy. A key must
|
|
15
|
+
* either be granted the scope explicitly OR hold `full-admin` (which implies
|
|
16
|
+
* every orthogonal data-plane scope).
|
|
17
|
+
*
|
|
18
|
+
* This fixes the latent bug where an orthogonal required scope was looked up in
|
|
19
|
+
* SCOPE_HIERARCHY (`?? 0`), letting ANY authenticated key satisfy it.
|
|
20
|
+
*/
|
|
21
|
+
export declare function hasScope(keyScopes: string[], required: string): boolean;
|
|
22
|
+
/** An `api_keys` row as both auth guards need it, cached per process. */
|
|
23
|
+
export interface CachedApiKey extends ApiKeyContext {
|
|
24
|
+
expiresAt: Date | null;
|
|
25
|
+
lastUsedAt: Date | null;
|
|
26
|
+
allowedOrigins: string[] | null;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Drop a key's cached auth entry so THIS process re-reads the row on the key's
|
|
30
|
+
* next request. Called after a revoke or a rotation changes the row. The cache
|
|
31
|
+
* is per process: other API instances keep their entry until its TTL (60s)
|
|
32
|
+
* runs out, which is the documented revocation lag.
|
|
33
|
+
*/
|
|
34
|
+
export declare function evictCachedApiKey(keyHash: string): void;
|
|
35
|
+
/**
|
|
36
|
+
* Read a live (unrevoked) key by hash through the 60s per-process cache, for
|
|
37
|
+
* secret and publishable keys alike. Misses are not cached, so a key minted a
|
|
38
|
+
* moment ago works on its first request. Expiry is the caller's check (it is
|
|
39
|
+
* re-evaluated on every request, cached or not). On a cache fill, `lastUsedAt`
|
|
40
|
+
* is bumped fire-and-forget at most once per five minutes.
|
|
41
|
+
*/
|
|
42
|
+
export declare function loadApiKey(db: Database, keyHash: string): Promise<CachedApiKey | null>;
|
|
43
|
+
export declare const requireApiKey: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
|
|
44
|
+
export declare function requireScope(scope: string): import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
|
|
45
|
+
//# sourceMappingURL=api-key.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../../src/middleware/api-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IAIjB,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAClC;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkBvE;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAoC9B;AAED,eAAO,MAAM,aAAa,gEA6BxB,CAAC;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,kEAazC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/middleware/audit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAkBxC,eAAO,MAAM,eAAe,gEA0B1B,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/middleware/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,MAAM,CAiB7C,CAAC"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { AppEnv } from "../app.js";
|
|
2
|
+
/**
|
|
3
|
+
* Data-plane guard for the BROWSER-REACHABLE subset of `/v1` (POST /events, the
|
|
4
|
+
* contacts upsert, GET /lists, list subscribe/unsubscribe, GET /lists/preferences).
|
|
5
|
+
*
|
|
6
|
+
* Accepts EITHER credential class:
|
|
7
|
+
*
|
|
8
|
+
* - SECRET key (anything NOT prefixed `pk_`): delegates to the UNCHANGED
|
|
9
|
+
* `requireApiKey` (legacy ADMIN_API_KEY + 60s cache + expiry), then applies
|
|
10
|
+
* the same `requireScope("ingest")` check inline. This path is
|
|
11
|
+
* byte-for-byte behaviorally identical to the existing
|
|
12
|
+
* `requireApiKey` → `requireScope("ingest")` stack.
|
|
13
|
+
*
|
|
14
|
+
* - PUBLISHABLE key (`pk_` bearer): read through the same 60s key cache
|
|
15
|
+
* (`loadApiKey`, which carries `allowed_origins`) with the same debounced
|
|
16
|
+
* `lastUsedAt` bump as secret keys. Requires scope `ingest-public`
|
|
17
|
+
* and REJECTS any pk_ token that somehow also carries `ingest`/`full-admin`
|
|
18
|
+
* (defence in depth — a prefix never implies privilege). Enforces the
|
|
19
|
+
* per-key Origin allowlist FAIL-CLOSED (no/empty allowlist ⇒ reject; Origin
|
|
20
|
+
* not in the allowlist ⇒ reject), then sets `publishable = true`.
|
|
21
|
+
*
|
|
22
|
+
* A pk_ key therefore cannot reach any route this guard is not mounted on, and
|
|
23
|
+
* cannot pass `requireScope("ingest")` anywhere else (its `["ingest-public"]`
|
|
24
|
+
* scope is neither `ingest` nor `full-admin`).
|
|
25
|
+
*/
|
|
26
|
+
export declare const requirePublishableOrIngest: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
|
|
27
|
+
//# sourceMappingURL=publishable-key.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"publishable-key.d.ts","sourceRoot":"","sources":["../../src/middleware/publishable-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,0BAA0B,gEA6EtC,CAAC"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import type { Context } from "hono";
|
|
2
|
+
import type { AppEnv } from "../app.js";
|
|
3
|
+
/**
|
|
4
|
+
* Every header `createRateLimit` can set. `app.ts` passes this list to the CORS
|
|
5
|
+
* `exposeHeaders` option: none of these is a CORS-safelisted response header,
|
|
6
|
+
* so without it a browser (`@hogsend/js` on a pk_ key) could not read them —
|
|
7
|
+
* including `Retry-After`, which the SDK maps to `RateLimitError.retryAfter`.
|
|
8
|
+
*/
|
|
9
|
+
export declare const RATE_LIMIT_HEADERS: readonly ["RateLimit-Limit", "RateLimit-Remaining", "RateLimit-Reset", "RateLimit-Policy", "X-RateLimit-Limit", "X-RateLimit-Remaining", "Retry-After"];
|
|
10
|
+
export interface RateLimitOptions {
|
|
11
|
+
windowMs?: number;
|
|
12
|
+
max?: number;
|
|
13
|
+
prefix?: string;
|
|
14
|
+
/**
|
|
15
|
+
* Derive the per-request bucket key. Default keys on the resolved api-key /
|
|
16
|
+
* user id (falling back to "anonymous") — correct for the authenticated data
|
|
17
|
+
* plane. Pass `clientIpKey` for UNAUTHENTICATED surfaces (e.g. the first-admin
|
|
18
|
+
* sign-up gate) where every request would otherwise collapse onto the single
|
|
19
|
+
* "anonymous" bucket and let one attacker exhaust the budget for everyone.
|
|
20
|
+
*/
|
|
21
|
+
keyFn?: (c: Context<AppEnv>) => string;
|
|
22
|
+
/**
|
|
23
|
+
* The middleware no-ops under `NODE_ENV=test` by default so the suite isn't
|
|
24
|
+
* throttled. Set `false` to keep it ACTIVE in tests — required to assert the
|
|
25
|
+
* unauthenticated sign-up limiter actually returns 429 past the threshold.
|
|
26
|
+
*/
|
|
27
|
+
disableInTest?: boolean;
|
|
28
|
+
}
|
|
29
|
+
/** Bucket key for unauthenticated, IP-scoped surfaces (e.g. sign-up). */
|
|
30
|
+
export declare function clientIpKey(c: Context<AppEnv>): string;
|
|
31
|
+
/**
|
|
32
|
+
* Bucket key for the browser-reachable ingest surface (the routes behind
|
|
33
|
+
* `requirePublishableOrIngest`). Runs AFTER that guard, so `apiKey` is set.
|
|
34
|
+
*
|
|
35
|
+
* - Secret key: one bucket per key. A secret key is one server integration.
|
|
36
|
+
* - Publishable (pk_) key: one bucket per key PER CLIENT IP. A pk_ key is
|
|
37
|
+
* public and shared by every visitor of the site, so a per-key bucket
|
|
38
|
+
* would 429 the whole site once its aggregate traffic crossed the limit,
|
|
39
|
+
* and would let one client holding the (public) key exhaust everyone's
|
|
40
|
+
* budget.
|
|
41
|
+
* - No resolved key (not reachable behind the guard): client IP, so a
|
|
42
|
+
* misordered mount still never collapses onto one shared bucket.
|
|
43
|
+
*/
|
|
44
|
+
export declare function ingestRateLimitKey(c: Context<AppEnv>): string;
|
|
45
|
+
/**
|
|
46
|
+
* Build a sliding-window rate-limit middleware.
|
|
47
|
+
*
|
|
48
|
+
* Each instance owns an isolated in-memory fallback store (keyed by `prefix`)
|
|
49
|
+
* and a distinct Redis key namespace, so two middlewares with different
|
|
50
|
+
* prefixes (e.g. "ratelimit" vs "ratelimit:emails") never share a budget —
|
|
51
|
+
* an email send must not consume the contact-upsert sliding window.
|
|
52
|
+
*
|
|
53
|
+
* Headers, on every limited response (allowed or 429):
|
|
54
|
+
* - `RateLimit-Limit` / `RateLimit-Remaining` / `RateLimit-Reset` /
|
|
55
|
+
* `RateLimit-Policy` (IETF draft-ietf-httpapi-ratelimit-headers, the
|
|
56
|
+
* separate-header form). `RateLimit-Reset` is the seconds until the window
|
|
57
|
+
* frees the next unit; `RateLimit-Policy` is `<max>;w=<window seconds>`.
|
|
58
|
+
* - `X-RateLimit-Limit` / `X-RateLimit-Remaining`, kept for existing readers.
|
|
59
|
+
* - `Retry-After` (seconds) on a 429 only: when the next request is accepted.
|
|
60
|
+
*
|
|
61
|
+
* An instance counts a request at most ONCE, however many matching `use`
|
|
62
|
+
* registrations reach it. Hono runs every matching `use`, and a `/<prefix>/*`
|
|
63
|
+
* pattern also matches the bare `/<prefix>`, so the same instance mounted on
|
|
64
|
+
* overlapping patterns would otherwise log two entries per request and halve
|
|
65
|
+
* the effective budget.
|
|
66
|
+
*/
|
|
67
|
+
export declare function createRateLimit(opts?: RateLimitOptions): import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
|
|
68
|
+
export declare const rateLimit: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
|
|
69
|
+
/**
|
|
70
|
+
* Data-plane budget defaults. `env.ts` declares the matching variables as
|
|
71
|
+
* optional so these stay the one place the numbers live.
|
|
72
|
+
*
|
|
73
|
+
* - Secret key on the ingest routes: 3000/min (50 req/s sustained). A secret
|
|
74
|
+
* key is usually one backend forwarding every user's events, and there is no
|
|
75
|
+
* batch event endpoint, so the budget has to cover a busy production app; it
|
|
76
|
+
* still stops a runaway loop well before it saturates an API instance.
|
|
77
|
+
* - Publishable key on the ingest routes: 1000/min per client IP. A browser on
|
|
78
|
+
* `@hogsend/js` makes a few requests a minute (one per captured event, plus a
|
|
79
|
+
* feed poll every 12s), so this leaves room for many visitors behind one
|
|
80
|
+
* office or carrier NAT while capping a single client that holds the public
|
|
81
|
+
* key.
|
|
82
|
+
* - `/v1/emails`: 30/min per key (unchanged). A loop sending more than that is
|
|
83
|
+
* almost certainly a runaway.
|
|
84
|
+
*/
|
|
85
|
+
export declare const DEFAULT_INGEST_RATE_LIMIT_MAX = 3000;
|
|
86
|
+
export declare const DEFAULT_INGEST_PUBLIC_RATE_LIMIT_MAX = 1000;
|
|
87
|
+
export declare const DEFAULT_INGEST_RATE_LIMIT_WINDOW_MS = 60000;
|
|
88
|
+
export declare const DEFAULT_EMAIL_RATE_LIMIT_MAX = 30;
|
|
89
|
+
export interface IngestRateLimitOptions {
|
|
90
|
+
/** Requests per window per secret key. */
|
|
91
|
+
max?: number;
|
|
92
|
+
/** Requests per window per publishable key per client IP. */
|
|
93
|
+
publicMax?: number;
|
|
94
|
+
windowMs?: number;
|
|
95
|
+
disableInTest?: boolean;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* The rate limit for the browser-reachable ingest routes. Two isolated budgets
|
|
99
|
+
* (own prefixes, so neither shares a window with `/v1/emails` or the admin
|
|
100
|
+
* plane), picked by the key class `requirePublishableOrIngest` resolved. Mount
|
|
101
|
+
* it AFTER that guard: the bucket key and the budget both read what the guard
|
|
102
|
+
* set (`apiKey`, `publishable`).
|
|
103
|
+
*/
|
|
104
|
+
export declare function createIngestRateLimit(opts?: IngestRateLimitOptions): import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
|
|
105
|
+
//# sourceMappingURL=rate-limit.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQxC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,yJAQrB,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAeD,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAK7D;AA4BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,gBAAqB,kEA6F1D;AAED,eAAO,MAAM,SAAS,gEAAoB,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,oCAAoC,OAAO,CAAC;AACzD,eAAO,MAAM,mCAAmC,QAAS,CAAC;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,sBAA2B,kEAmBtE"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../src/middleware/request-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,iBAAiB,CAAC,MAAM,CAenD,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-admin.d.ts","sourceRoot":"","sources":["../../src/middleware/require-admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASxC,eAAO,MAAM,YAAY,gEA4CvB,CAAC"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { Context } from "hono";
|
|
2
|
+
/**
|
|
3
|
+
* The data-plane identity guard shared by `/v1/contacts`, `/v1/events`,
|
|
4
|
+
* `/v1/emails`, and `/v1/lists`: a request must carry at least one resolvable
|
|
5
|
+
* identity key. Returns the 400 JSON response when BOTH keys are absent (so the
|
|
6
|
+
* caller can `return guard;`), or `null` to proceed.
|
|
7
|
+
*
|
|
8
|
+
* `/v1/emails` names its recipient field `to` rather than `email`; pass
|
|
9
|
+
* `{ field: "to" }` so the 400 message matches that route's wording exactly.
|
|
10
|
+
*/
|
|
11
|
+
export declare function requireIdentity(c: Context, identity: {
|
|
12
|
+
email?: string;
|
|
13
|
+
userId?: string;
|
|
14
|
+
}, opts?: {
|
|
15
|
+
field?: "email" | "to";
|
|
16
|
+
}): (Response & import("hono").TypedResponse<{
|
|
17
|
+
error: string;
|
|
18
|
+
}, 400, "json">) | null;
|
|
19
|
+
/**
|
|
20
|
+
* The publishable-key identity gate, shared by every browser-reachable handler
|
|
21
|
+
* (events ingest, contacts upsert, list subscribe/unsubscribe).
|
|
22
|
+
*
|
|
23
|
+
* - SECRET key (`!c.get("publishable")`): defers to the UNCHANGED
|
|
24
|
+
* `requireIdentity` — identical 400 wording, identical behavior.
|
|
25
|
+
*
|
|
26
|
+
* - PUBLISHABLE key: a token-less pk_ key may act ONLY on its own anon id.
|
|
27
|
+
* - No claimed identity (`email`/`userId` both absent) → allowed (the
|
|
28
|
+
* secure anon-only default). Returns `null`.
|
|
29
|
+
* - A claimed identity REQUIRES a verified `userToken` proving the
|
|
30
|
+
* `userId`. Reject with 403 when: no `userToken`; `email` is asserted
|
|
31
|
+
* (no email arm exists in v1 — a token only binds a userId); or the
|
|
32
|
+
* token's `userId` does not match the claimed `userId`.
|
|
33
|
+
*
|
|
34
|
+
* Returns a `Response` to `return`, or `null` to proceed.
|
|
35
|
+
*/
|
|
36
|
+
export declare function gatePublishableIdentity(c: Context, body: {
|
|
37
|
+
email?: string;
|
|
38
|
+
userId?: string;
|
|
39
|
+
userToken?: string;
|
|
40
|
+
}, secret: string, opts?: {
|
|
41
|
+
field?: "email" | "to";
|
|
42
|
+
}): (Response & import("hono").TypedResponse<{
|
|
43
|
+
error: string;
|
|
44
|
+
}, 400, "json">) | (Response & import("hono").TypedResponse<{
|
|
45
|
+
error: string;
|
|
46
|
+
}, 403, "json">) | null;
|
|
47
|
+
/**
|
|
48
|
+
* Extract a human-readable message from an `applyListMembership` failure,
|
|
49
|
+
* matching the wording every data-plane route used inline.
|
|
50
|
+
*/
|
|
51
|
+
export declare function listMembershipError(err: unknown): string;
|
|
52
|
+
//# sourceMappingURL=_shared.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/routes/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,CAAC,EAAE,OAAO,EACV,QAAQ,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE;;wBAOlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,OAAO,EACV,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE;;;;wBAqClC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAExD"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type OpenAPIHono } from "@hono/zod-openapi";
|
|
2
|
+
import type { AppEnv } from "../../app.js";
|
|
3
|
+
/**
|
|
4
|
+
* `GET /v1/accounts/:provider/callback` — the ONE place in the whole feature
|
|
5
|
+
* where a link may MOVE (DECISIONS §6.1). Everything else — the import path,
|
|
6
|
+
* the SDK, the manage page — is structurally unable to displace a live owner,
|
|
7
|
+
* because only this route ever passes `allowDisplaceLiveOwner: true`, and only
|
|
8
|
+
* on the WARM path.
|
|
9
|
+
*
|
|
10
|
+
* The order below mirrors `routes/connectors/index.ts:100-159` step for step,
|
|
11
|
+
* because that dispatcher's hardening is the thing being reused rather than
|
|
12
|
+
* re-derived: verify BEFORE dispatching, reject a cross-surface state, burn the
|
|
13
|
+
* nonce single-use. The two deliberate divergences are commented at their
|
|
14
|
+
* sites: a null Redis REFUSES here (fail closed), and the contact side of the
|
|
15
|
+
* link is decided here rather than by the store.
|
|
16
|
+
*/
|
|
17
|
+
export declare function registerAccountLinkCallbackRoute(router: OpenAPIHono<AppEnv>): void;
|
|
18
|
+
//# sourceMappingURL=callback.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["../../../src/routes/accounts/callback.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,WAAW,EAAK,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAwB3C;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,QAob3E"}
|