create-ailk 0.23.0 → 0.25.1
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 +68 -33
- package/component-catalog.json +3 -3
- package/component-catalog.md +3 -3
- package/dist/add-module.js +10 -3
- package/dist/add-route.d.ts +12 -1
- package/dist/add-route.js +38 -4
- package/dist/cli.js +12 -7
- package/dist/derive-architecture.d.ts +3 -4
- package/dist/derive-architecture.js +75 -22
- package/dist/lib/design-checks.d.ts +9 -4
- package/dist/lib/design-checks.js +13 -7
- package/dist/lib/extract-module-bundle.js +29 -2
- package/dist/lib/fetch-template-snapshot.d.ts +1 -1
- package/dist/lib/fetch-template-snapshot.js +7 -3
- package/dist/lib/import-graph.d.ts +1 -1
- package/dist/lib/import-graph.js +4 -4
- package/dist/lib/module-license-gate.d.ts +12 -1
- package/dist/lib/module-license-gate.js +34 -12
- package/dist/lib/scaffold-render-sweep.d.ts +33 -0
- package/dist/lib/scaffold-render-sweep.js +45 -0
- package/dist/module-architecture.d.ts +20 -3
- package/dist/module-architecture.js +122 -538
- package/dist/paid-sections.d.ts +25 -1
- package/dist/paid-sections.js +88 -3
- package/dist/surfaces.js +10 -2
- package/dist/sync-routes.d.ts +30 -4
- package/dist/sync-routes.js +271 -18
- package/dist/template-record.d.ts +14 -4
- package/dist/template-record.js +23 -5
- package/dist/topology.d.ts +16 -3
- package/dist/topology.js +31 -19
- package/dist/update.d.ts +10 -1
- package/dist/update.js +540 -16
- package/package.json +3 -3
- package/release-scope.json +1 -1
- package/templates/.claude/cloudparity-repo-hooks.json +5 -0
- package/templates/.claude/hooks/template-guard.sh +137 -0
- package/templates/.claude/rules/extending.md +106 -0
- package/templates/.claude/rules/loop-contract.md +2 -2
- package/templates/.claude/settings.json +11 -0
- package/templates/.env.example +9 -5
- package/templates/.github/workflows/ci.yml +7 -4
- package/templates/CLAUDE.md +15 -3
- package/templates/CONVENTIONS.md +8 -10
- package/templates/README.md +14 -13
- package/templates/apps/api/.env.example +9 -2
- package/templates/apps/api/CLAUDE.md +122 -82
- package/templates/apps/api/jest.config.cjs +15 -5
- package/templates/apps/api/package.json +16 -20
- package/templates/apps/api/src/__tests__/trusted-origins.server.test.ts +2 -2
- package/templates/apps/api/src/__tests__/vercel-handler.test.ts +4 -4
- package/templates/apps/api/src/index.ts +1 -1
- package/templates/apps/api/src/lib/__mocks__/prisma.ts +7 -4
- package/templates/apps/api/src/modules/commerce.ts +10 -0
- package/templates/apps/api/src/modules/content-write.ts +10 -0
- package/templates/apps/api/src/modules/multi-tenant.ts +10 -0
- package/templates/apps/api/src/modules/scheduling.ts +10 -0
- package/templates/apps/api/src/modules/signal-collectors.ts +10 -0
- package/templates/apps/api/src/modules/workspace.ts +10 -0
- package/templates/apps/api/src/server.ts +117 -1857
- package/templates/apps/api/vercel.json +2 -2
- package/templates/apps/mcp/CLAUDE.md +77 -24
- package/templates/apps/mcp/__tests__/app-entry.test.ts +4 -254
- package/templates/apps/mcp/__tests__/boot-file.test.ts +92 -0
- package/templates/apps/mcp/jest.config.cjs +6 -1
- package/templates/apps/mcp/package.json +5 -12
- package/templates/apps/mcp/src/app.ts +8 -7
- package/templates/apps/mcp/src/index.ts +6 -34
- package/templates/apps/mcp/src/lib/paid-tools.generated.ts +10 -0
- package/templates/apps/mcp/src/lib/topology.generated.ts +2 -2
- package/templates/apps/mcp/src/site.ts +12 -0
- package/templates/apps/web/.env.example +1 -1
- package/templates/apps/web/CLAUDE.md +21 -5
- package/templates/apps/web/app/.well-known/mcp.json/route.ts +9 -3
- package/templates/apps/web/app/[locale]/contact/__tests__/ConversationalIntakeWrapper.test.tsx +1 -1
- package/templates/apps/web/app/[locale]/contact/contact.actions.ts +14 -4
- package/templates/apps/web/app/[locale]/contact/intake-analytics.ts +1 -1
- package/templates/apps/web/app/[locale]/contact/intake-script.ts +1 -1
- package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/magnet-page.test.tsx +22 -1
- package/templates/apps/web/app/[locale]/flows/[slug]/magnet-page.tsx +28 -7
- package/templates/apps/web/app/[locale]/pricing/__tests__/unconnected.test.tsx +43 -0
- package/templates/apps/web/app/[locale]/pricing/page.tsx +7 -3
- package/templates/apps/web/app/api/offerings/checkout/[lookupKey]/__tests__/route.test.ts +222 -0
- package/templates/apps/web/app/api/offerings/checkout/[lookupKey]/route.ts +10 -3
- package/templates/apps/web/app/api/revalidate/route.ts +3 -3
- package/templates/apps/web/auth.ts +2 -2
- package/templates/apps/web/jest.config.cjs +1 -0
- package/templates/apps/web/lib/__tests__/magnet-routes.test.ts +7 -0
- package/templates/apps/web/lib/auth-email.ts +1 -1
- package/templates/apps/web/lib/magnet-routes.ts +3 -1
- package/templates/apps/web/lib/newsletter.actions.ts +9 -6
- package/templates/apps/web/lib/relay.ts +2 -2
- package/templates/apps/web/lib/release-scope.ts +47 -0
- package/templates/apps/web/lib/server-api.ts +1 -1
- package/templates/apps/web/src/lib/commerce-claim.ts +1 -1
- package/templates/customizations.yaml +37 -0
- package/templates/database/prisma.config.ts +10 -14
- package/templates/database/seed-test.ts +2 -2
- package/templates/database/seed.ts +32 -5
- package/templates/package.json +12 -6
- package/templates/pnpm-workspace.yaml +0 -1
- package/templates/project.yaml +16 -8
- package/templates/tools/jest/reporters.cjs +65 -0
- package/templates/tools/lint-architecture.ts +757 -7
- package/templates/tsconfig.json +1 -2
- package/versions.json +48 -35
- package/templates/apps/api/src/__tests__/commerce-claim-registration.test.ts +0 -409
- package/templates/apps/api/src/__tests__/factories/agent-caller.ts +0 -102
- package/templates/apps/api/src/__tests__/factories/content-fixture.ts +0 -138
- package/templates/apps/api/src/__tests__/factories/in-memory-prisma.ts +0 -441
- package/templates/apps/api/src/__tests__/factories/index.ts +0 -70
- package/templates/apps/api/src/__tests__/factories/lead-fixture.ts +0 -82
- package/templates/apps/api/src/__tests__/leads-forwarded-rate-limit.test.ts +0 -135
- package/templates/apps/api/src/__tests__/services/enrichment-shim.test.ts +0 -126
- package/templates/apps/api/src/__tests__/stripe-boot.test.ts +0 -132
- package/templates/apps/api/src/__tests__/support/hub-sign-in-fake-db.ts +0 -362
- package/templates/apps/api/src/bin/__tests__/rate-limit-probe.test.ts +0 -184
- package/templates/apps/api/src/bin/abandon-sweep.ts +0 -42
- package/templates/apps/api/src/bin/rate-limit-probe.ts +0 -53
- package/templates/apps/api/src/bin/spokes.ts +0 -198
- package/templates/apps/api/src/bin/stripe-connections-rekey.ts +0 -45
- package/templates/apps/api/src/config/__tests__/hub-require-spoke-key.test.ts +0 -196
- package/templates/apps/api/src/config/__tests__/index.test.ts +0 -233
- package/templates/apps/api/src/config/__tests__/modules.test.ts +0 -76
- package/templates/apps/api/src/config/__tests__/stripe-connection-key.test.ts +0 -185
- package/templates/apps/api/src/config/__tests__/trusted-origins.test.ts +0 -238
- package/templates/apps/api/src/config/index.ts +0 -596
- package/templates/apps/api/src/config/modules.ts +0 -83
- package/templates/apps/api/src/lib/__tests__/agent-store.test.ts +0 -581
- package/templates/apps/api/src/lib/__tests__/auth-email-budget.test.ts +0 -143
- package/templates/apps/api/src/lib/__tests__/consent-ledger-double.ts +0 -237
- package/templates/apps/api/src/lib/__tests__/consent-store.test.ts +0 -353
- package/templates/apps/api/src/lib/__tests__/content-adapter.test.ts +0 -201
- package/templates/apps/api/src/lib/__tests__/deliverable-asset-store.test.ts +0 -224
- package/templates/apps/api/src/lib/__tests__/error-serializer.test.ts +0 -120
- package/templates/apps/api/src/lib/__tests__/errors.test.ts +0 -94
- package/templates/apps/api/src/lib/__tests__/file-fallback.test.ts +0 -144
- package/templates/apps/api/src/lib/__tests__/fixtures/HomePage/home.mdx +0 -8
- package/templates/apps/api/src/lib/__tests__/flow-completion-store.test.ts +0 -149
- package/templates/apps/api/src/lib/__tests__/flow-rename-race.db.test.ts +0 -116
- package/templates/apps/api/src/lib/__tests__/hub-sign-in-store.test.ts +0 -209
- package/templates/apps/api/src/lib/__tests__/lead-capture-store.test.ts +0 -257
- package/templates/apps/api/src/lib/__tests__/lead-delivery.test.ts +0 -96
- package/templates/apps/api/src/lib/__tests__/outbound-http.test.ts +0 -125
- package/templates/apps/api/src/lib/__tests__/prisma.test.ts +0 -165
- package/templates/apps/api/src/lib/__tests__/require-commerce-claim.test.ts +0 -317
- package/templates/apps/api/src/lib/__tests__/require-paid-tier.test.ts +0 -129
- package/templates/apps/api/src/lib/__tests__/site.test.ts +0 -292
- package/templates/apps/api/src/lib/__tests__/slice-load.test.ts +0 -89
- package/templates/apps/api/src/lib/__tests__/spoke-store.test.ts +0 -202
- package/templates/apps/api/src/lib/__tests__/stripe-admission.test.ts +0 -217
- package/templates/apps/api/src/lib/__tests__/stripe.test.ts +0 -82
- package/templates/apps/api/src/lib/agent-store.ts +0 -613
- package/templates/apps/api/src/lib/auth-email-budget.ts +0 -161
- package/templates/apps/api/src/lib/consent-store.ts +0 -363
- package/templates/apps/api/src/lib/content-adapter.ts +0 -112
- package/templates/apps/api/src/lib/deliverable-asset-store.ts +0 -96
- package/templates/apps/api/src/lib/error-serializer.ts +0 -164
- package/templates/apps/api/src/lib/errors.ts +0 -95
- package/templates/apps/api/src/lib/file-fallback.ts +0 -87
- package/templates/apps/api/src/lib/flow-completion-store.ts +0 -136
- package/templates/apps/api/src/lib/hub-sign-in-store.ts +0 -455
- package/templates/apps/api/src/lib/lead-capture-store.ts +0 -122
- package/templates/apps/api/src/lib/lead-delivery.ts +0 -52
- package/templates/apps/api/src/lib/license-key-store.ts +0 -45
- package/templates/apps/api/src/lib/locales.ts +0 -201
- package/templates/apps/api/src/lib/outbound-http.ts +0 -127
- package/templates/apps/api/src/lib/prisma.ts +0 -21
- package/templates/apps/api/src/lib/proposal-paid-store.ts +0 -66
- package/templates/apps/api/src/lib/rate-limit-probe.ts +0 -165
- package/templates/apps/api/src/lib/rate-limit-store.ts +0 -142
- package/templates/apps/api/src/lib/require-commerce-claim.ts +0 -250
- package/templates/apps/api/src/lib/require-paid-tier.ts +0 -53
- package/templates/apps/api/src/lib/site.ts +0 -254
- package/templates/apps/api/src/lib/slice-load.ts +0 -90
- package/templates/apps/api/src/lib/spoke-store.ts +0 -180
- package/templates/apps/api/src/lib/stripe.ts +0 -318
- package/templates/apps/api/src/lib/webhook-idempotency.ts +0 -156
- package/templates/apps/api/src/middleware/__tests__/adversarial/bearer-token-format.test.ts +0 -111
- package/templates/apps/api/src/middleware/__tests__/adversarial/cookie-or-bearer-precedence.test.ts +0 -172
- package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-bearer-skip.test.ts +0 -119
- package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-cookie-path.test.ts +0 -138
- package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-trusted-origins.test.ts +0 -142
- package/templates/apps/api/src/middleware/__tests__/adversarial/session-fixation.test.ts +0 -155
- package/templates/apps/api/src/middleware/__tests__/adversarial/session-timeout.test.ts +0 -139
- package/templates/apps/api/src/middleware/__tests__/auth.bearer-path.test.ts +0 -562
- package/templates/apps/api/src/middleware/__tests__/auth.both-present-precedence.test.ts +0 -76
- package/templates/apps/api/src/middleware/__tests__/auth.cookie-path.test.ts +0 -220
- package/templates/apps/api/src/middleware/__tests__/auth.database-not-configured.test.ts +0 -97
- package/templates/apps/api/src/middleware/__tests__/auth.hub-session-path.test.ts +0 -557
- package/templates/apps/api/src/middleware/__tests__/auth.neither-present.test.ts +0 -72
- package/templates/apps/api/src/middleware/__tests__/auth.optional-cookie.test.ts +0 -140
- package/templates/apps/api/src/middleware/__tests__/default-tenant.test.ts +0 -721
- package/templates/apps/api/src/middleware/__tests__/rate-limit-cross-isolate.db.test.ts +0 -220
- package/templates/apps/api/src/middleware/__tests__/rate-limit-store.test.ts +0 -430
- package/templates/apps/api/src/middleware/__tests__/rate-limit.test.ts +0 -1409
- package/templates/apps/api/src/middleware/__tests__/write-budget.test.ts +0 -174
- package/templates/apps/api/src/middleware/auth.ts +0 -864
- package/templates/apps/api/src/middleware/default-tenant.ts +0 -166
- package/templates/apps/api/src/middleware/rate-limit.ts +0 -983
- package/templates/apps/api/src/openapi/__tests__/openapi.test.ts +0 -264
- package/templates/apps/api/src/openapi/__tests__/spec-identity.test.ts +0 -182
- package/templates/apps/api/src/openapi/index.ts +0 -18
- package/templates/apps/api/src/openapi/spec.ts +0 -1815
- package/templates/apps/api/src/openapi/surface-drift.ts +0 -195
- package/templates/apps/api/src/routes/aeo/__tests__/index.test.ts +0 -175
- package/templates/apps/api/src/routes/aeo/index.ts +0 -107
- package/templates/apps/api/src/routes/auth/__tests__/auth-tokens.functional.test.ts +0 -196
- package/templates/apps/api/src/routes/auth/__tests__/auth-user.functional.test.ts +0 -249
- package/templates/apps/api/src/routes/auth/__tests__/hub-sign-in.test.ts +0 -532
- package/templates/apps/api/src/routes/auth/__tests__/tokens.test.ts +0 -313
- package/templates/apps/api/src/routes/auth/__tests__/transactional-email.test.ts +0 -413
- package/templates/apps/api/src/routes/auth/__tests__/user.test.ts +0 -609
- package/templates/apps/api/src/routes/auth/hub-sign-in.ts +0 -242
- package/templates/apps/api/src/routes/auth/tokens.ts +0 -211
- package/templates/apps/api/src/routes/auth/transactional-email.ts +0 -301
- package/templates/apps/api/src/routes/auth/user.ts +0 -305
- package/templates/apps/api/src/routes/billing/plan-checkout.ts +0 -325
- package/templates/apps/api/src/routes/checkout/__tests__/live-key.test.ts +0 -178
- package/templates/apps/api/src/routes/checkout/__tests__/offerings-authorization.test.ts +0 -1300
- package/templates/apps/api/src/routes/checkout/__tests__/session.test.ts +0 -448
- package/templates/apps/api/src/routes/checkout/__tests__/sessions.test.ts +0 -1742
- package/templates/apps/api/src/routes/checkout/index.ts +0 -34
- package/templates/apps/api/src/routes/checkout/session.ts +0 -171
- package/templates/apps/api/src/routes/checkout/sessions.ts +0 -540
- package/templates/apps/api/src/routes/consent/__tests__/account.test.ts +0 -386
- package/templates/apps/api/src/routes/consent/__tests__/sign-up-rate-limit.test.ts +0 -160
- package/templates/apps/api/src/routes/consent/account.ts +0 -268
- package/templates/apps/api/src/routes/consent/cookie.ts +0 -90
- package/templates/apps/api/src/routes/consent/index.ts +0 -26
- package/templates/apps/api/src/routes/consent/unsubscribe.ts +0 -127
- package/templates/apps/api/src/routes/content/__tests__/get-page.test.ts +0 -853
- package/templates/apps/api/src/routes/content/__tests__/list-pages.test.ts +0 -230
- package/templates/apps/api/src/routes/content/__tests__/list-types.test.ts +0 -44
- package/templates/apps/api/src/routes/content/__tests__/locale.test.ts +0 -118
- package/templates/apps/api/src/routes/content/__tests__/offerings.test.ts +0 -731
- package/templates/apps/api/src/routes/content/__tests__/pricing.test.ts +0 -753
- package/templates/apps/api/src/routes/content/__tests__/rate-limit.test.ts +0 -51
- package/templates/apps/api/src/routes/content/__tests__/search.test.ts +0 -450
- package/templates/apps/api/src/routes/content/__tests__/shown-offerings.test.ts +0 -762
- package/templates/apps/api/src/routes/content/get-page.ts +0 -268
- package/templates/apps/api/src/routes/content/index.ts +0 -49
- package/templates/apps/api/src/routes/content/list-pages.ts +0 -95
- package/templates/apps/api/src/routes/content/list-types.ts +0 -19
- package/templates/apps/api/src/routes/content/offerings.ts +0 -184
- package/templates/apps/api/src/routes/content/pricing.ts +0 -176
- package/templates/apps/api/src/routes/content/rate-limit.ts +0 -22
- package/templates/apps/api/src/routes/content/search.ts +0 -129
- package/templates/apps/api/src/routes/content/shown-offerings.ts +0 -229
- package/templates/apps/api/src/routes/content/slug.ts +0 -9
- package/templates/apps/api/src/routes/leads/__tests__/capture.test.ts +0 -88
- package/templates/apps/api/src/routes/leads/__tests__/list.test.ts +0 -171
- package/templates/apps/api/src/routes/leads/__tests__/magnet-completion.test.ts +0 -515
- package/templates/apps/api/src/routes/leads/__tests__/spoke.test.ts +0 -392
- package/templates/apps/api/src/routes/leads/__tests__/track.test.ts +0 -165
- package/templates/apps/api/src/routes/leads/index.ts +0 -573
- package/templates/apps/api/src/routes/leads/list.ts +0 -104
- package/templates/apps/api/src/routes/project-listings/__tests__/configured-application.test.ts +0 -626
- package/templates/apps/api/src/routes/project-listings/__tests__/drafts.test.ts +0 -1268
- package/templates/apps/api/src/routes/project-listings/__tests__/founder-identity.test.ts +0 -847
- package/templates/apps/api/src/routes/project-listings/__tests__/me.test.ts +0 -480
- package/templates/apps/api/src/routes/project-listings/__tests__/public.test.ts +0 -465
- package/templates/apps/api/src/routes/project-listings/__tests__/resume-email.test.ts +0 -872
- package/templates/apps/api/src/routes/project-listings/__tests__/site-answers.test.ts +0 -1022
- package/templates/apps/api/src/routes/project-listings/__tests__/site-key.test.ts +0 -484
- package/templates/apps/api/src/routes/project-listings/__tests__/structured-address.test.ts +0 -535
- package/templates/apps/api/src/routes/project-listings/index.ts +0 -164
- package/templates/apps/api/src/routes/project-listings/me.ts +0 -87
- package/templates/apps/api/src/routes/project-listings/patch-copy.ts +0 -224
- package/templates/apps/api/src/routes/project-listings/patch-draft.ts +0 -102
- package/templates/apps/api/src/routes/project-listings/public.ts +0 -98
- package/templates/apps/api/src/routes/project-listings/respond.ts +0 -48
- package/templates/apps/api/src/routes/project-listings/resume-token.ts +0 -27
- package/templates/apps/api/src/routes/project-listings/start.ts +0 -140
- package/templates/apps/api/src/routes/project-listings/submit.ts +0 -130
- package/templates/apps/api/src/routes/project-listings/verify-email.ts +0 -150
- package/templates/apps/api/src/routes/requests/__tests__/confirm.test.ts +0 -686
- package/templates/apps/api/src/routes/requests/confirm.ts +0 -601
- package/templates/apps/api/src/routes/requests/index.ts +0 -54
- package/templates/apps/api/src/routes/test/auth/__tests__/session.test.ts +0 -306
- package/templates/apps/api/src/routes/test/auth/session.ts +0 -143
- package/templates/apps/api/src/routes/webhooks/README.md +0 -398
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-checkout-consent.test.ts +0 -649
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-dunning.test.ts +0 -749
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-flow-checkout.test.ts +0 -448
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-idempotency.test.ts +0 -264
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-livemode-live.test.ts +0 -159
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-livemode.test.ts +0 -158
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-offerings.test.ts +0 -814
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-org-billing.test.ts +0 -301
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-proposal-paid.test.ts +0 -369
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-rate-limit.test.ts +0 -215
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-request-paid.test.ts +0 -301
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-site-filter.test.ts +0 -808
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe.test.ts +0 -1155
- package/templates/apps/api/src/routes/webhooks/index.ts +0 -141
- package/templates/apps/api/src/routes/webhooks/stripe-offerings.ts +0 -384
- package/templates/apps/api/src/routes/webhooks/stripe.ts +0 -2026
- package/templates/apps/api/src/services/__tests__/abandon-email.test.ts +0 -528
- package/templates/apps/api/src/services/__tests__/answer-distributions.test.ts +0 -132
- package/templates/apps/api/src/services/__tests__/audit-log.test.ts +0 -1028
- package/templates/apps/api/src/services/__tests__/checkout-plan.test.ts +0 -313
- package/templates/apps/api/src/services/__tests__/consent-ledger.test.ts +0 -503
- package/templates/apps/api/src/services/__tests__/consent-migration.test.ts +0 -65
- package/templates/apps/api/src/services/__tests__/consent.test.ts +0 -299
- package/templates/apps/api/src/services/__tests__/default-tenant.test.ts +0 -147
- package/templates/apps/api/src/services/__tests__/deliverable-fulfillment.test.ts +0 -867
- package/templates/apps/api/src/services/__tests__/deliverable-resend.test.ts +0 -379
- package/templates/apps/api/src/services/__tests__/dunning-policy.test.ts +0 -368
- package/templates/apps/api/src/services/__tests__/entitlements.test.ts +0 -142
- package/templates/apps/api/src/services/__tests__/hub-sign-in.test.ts +0 -854
- package/templates/apps/api/src/services/__tests__/keyless-workspace-predicate.test.ts +0 -234
- package/templates/apps/api/src/services/__tests__/lead-accept-user.test.ts +0 -251
- package/templates/apps/api/src/services/__tests__/lead-routing.test.ts +0 -2660
- package/templates/apps/api/src/services/__tests__/listing-config.test.ts +0 -166
- package/templates/apps/api/src/services/__tests__/magnet-completion.test.ts +0 -389
- package/templates/apps/api/src/services/__tests__/person.test.ts +0 -1176
- package/templates/apps/api/src/services/__tests__/plan-offerings.test.ts +0 -444
- package/templates/apps/api/src/services/__tests__/project-listings.fence.test.ts +0 -154
- package/templates/apps/api/src/services/__tests__/public-site-resolver.test.ts +0 -137
- package/templates/apps/api/src/services/__tests__/request-confirm.test.ts +0 -531
- package/templates/apps/api/src/services/__tests__/revalidation.test.ts +0 -372
- package/templates/apps/api/src/services/__tests__/slack-notify.test.ts +0 -348
- package/templates/apps/api/src/services/__tests__/spoke-resolution.test.ts +0 -660
- package/templates/apps/api/src/services/__tests__/usage-aggregation.test.ts +0 -941
- package/templates/apps/api/src/services/__tests__/usage-credits.test.ts +0 -588
- package/templates/apps/api/src/services/__tests__/verified-email.test.ts +0 -78
- package/templates/apps/api/src/services/abandon-email.ts +0 -313
- package/templates/apps/api/src/services/aeo-score.ts +0 -325
- package/templates/apps/api/src/services/answer-distributions.ts +0 -138
- package/templates/apps/api/src/services/audit-log.ts +0 -961
- package/templates/apps/api/src/services/checkout-buyer.ts +0 -168
- package/templates/apps/api/src/services/consent.ts +0 -834
- package/templates/apps/api/src/services/default-tenant.ts +0 -416
- package/templates/apps/api/src/services/deliverable-fulfillment.ts +0 -755
- package/templates/apps/api/src/services/dunning-policy.ts +0 -294
- package/templates/apps/api/src/services/enrichment-shim.ts +0 -53
- package/templates/apps/api/src/services/entitlements.ts +0 -338
- package/templates/apps/api/src/services/hub-sign-in.ts +0 -472
- package/templates/apps/api/src/services/lead-accept-user.ts +0 -126
- package/templates/apps/api/src/services/lead-promotion.ts +0 -160
- package/templates/apps/api/src/services/lead-routing.ts +0 -1372
- package/templates/apps/api/src/services/leads-inbox.ts +0 -312
- package/templates/apps/api/src/services/listing-config.ts +0 -178
- package/templates/apps/api/src/services/magnet-completion.ts +0 -242
- package/templates/apps/api/src/services/offerings/__tests__/catalog.test.ts +0 -295
- package/templates/apps/api/src/services/offerings/__tests__/checkout-session-record.test.ts +0 -268
- package/templates/apps/api/src/services/offerings/__tests__/connection.test.ts +0 -868
- package/templates/apps/api/src/services/offerings/__tests__/fixtures.ts +0 -416
- package/templates/apps/api/src/services/offerings/__tests__/org-products.test.ts +0 -396
- package/templates/apps/api/src/services/offerings/__tests__/readers.test.ts +0 -681
- package/templates/apps/api/src/services/offerings/__tests__/source.test.ts +0 -231
- package/templates/apps/api/src/services/offerings/catalog.ts +0 -308
- package/templates/apps/api/src/services/offerings/checkout-authorization.ts +0 -385
- package/templates/apps/api/src/services/offerings/checkout-session-record.ts +0 -192
- package/templates/apps/api/src/services/offerings/connection.ts +0 -1003
- package/templates/apps/api/src/services/offerings/index.ts +0 -614
- package/templates/apps/api/src/services/offerings/source.ts +0 -140
- package/templates/apps/api/src/services/offerings/store.ts +0 -150
- package/templates/apps/api/src/services/owner-workspaces.ts +0 -132
- package/templates/apps/api/src/services/person.ts +0 -1188
- package/templates/apps/api/src/services/plan-offerings.ts +0 -125
- package/templates/apps/api/src/services/project-listing-resume-email.ts +0 -326
- package/templates/apps/api/src/services/project-listings.ts +0 -2073
- package/templates/apps/api/src/services/public-site-resolver.ts +0 -396
- package/templates/apps/api/src/services/request-confirm.ts +0 -698
- package/templates/apps/api/src/services/revalidation.ts +0 -235
- package/templates/apps/api/src/services/slack-notify.ts +0 -291
- package/templates/apps/api/src/services/usage-aggregation.ts +0 -516
- package/templates/apps/api/src/services/usage-credits.ts +0 -340
- package/templates/apps/api/src/services/verified-email.ts +0 -71
- package/templates/apps/mcp/__tests__/abuse/daily-cap.test.ts +0 -52
- package/templates/apps/mcp/__tests__/abuse/email-validator.test.ts +0 -46
- package/templates/apps/mcp/__tests__/abuse/guard.test.ts +0 -198
- package/templates/apps/mcp/__tests__/abuse/honeypot.test.ts +0 -36
- package/templates/apps/mcp/__tests__/abuse/user-agent-deny.test.ts +0 -54
- package/templates/apps/mcp/__tests__/aeo-cli-parity.test.ts +0 -116
- package/templates/apps/mcp/__tests__/audit-single-page.test.ts +0 -299
- package/templates/apps/mcp/__tests__/boot.test.ts +0 -280
- package/templates/apps/mcp/__tests__/catalog-drift.test.ts +0 -359
- package/templates/apps/mcp/__tests__/config/modules.test.ts +0 -78
- package/templates/apps/mcp/__tests__/get_business_hours.test.ts +0 -82
- package/templates/apps/mcp/__tests__/get_faq.test.ts +0 -80
- package/templates/apps/mcp/__tests__/get_locations.test.ts +0 -65
- package/templates/apps/mcp/__tests__/get_offerings.test.ts +0 -557
- package/templates/apps/mcp/__tests__/get_pricing.test.ts +0 -524
- package/templates/apps/mcp/__tests__/get_site_info.test.ts +0 -81
- package/templates/apps/mcp/__tests__/http-transport.test.ts +0 -1151
- package/templates/apps/mcp/__tests__/index.test.ts +0 -195
- package/templates/apps/mcp/__tests__/lib/audit-single-page-readiness-scan.test.ts +0 -191
- package/templates/apps/mcp/__tests__/lib/commerce-claim.test.ts +0 -531
- package/templates/apps/mcp/__tests__/lib/content-adapter-parity.test.ts +0 -65
- package/templates/apps/mcp/__tests__/lib/content-adapter.test.ts +0 -187
- package/templates/apps/mcp/__tests__/lib/content-root.test.ts +0 -93
- package/templates/apps/mcp/__tests__/lib/errors.test.ts +0 -75
- package/templates/apps/mcp/__tests__/lib/fail-closed-tools.test.ts +0 -165
- package/templates/apps/mcp/__tests__/lib/public-workspace.test.ts +0 -124
- package/templates/apps/mcp/__tests__/list_pages.test.ts +0 -228
- package/templates/apps/mcp/__tests__/locale.test.ts +0 -135
- package/templates/apps/mcp/__tests__/module-exclusion.test.ts +0 -175
- package/templates/apps/mcp/__tests__/purchase-disabled.test.ts +0 -101
- package/templates/apps/mcp/__tests__/read_content.test.ts +0 -474
- package/templates/apps/mcp/__tests__/request_callback.test.ts +0 -225
- package/templates/apps/mcp/__tests__/search_content.test.ts +0 -256
- package/templates/apps/mcp/__tests__/server.test.ts +0 -388
- package/templates/apps/mcp/__tests__/start_purchase.test.ts +0 -448
- package/templates/apps/mcp/__tests__/submit_lead.test.ts +0 -307
- package/templates/apps/mcp/__tests__/subscribe_newsletter.test.ts +0 -223
- package/templates/apps/mcp/__tests__/tools/create_project.test.ts +0 -243
- package/templates/apps/mcp/__tests__/tools/purchase.test.ts +0 -451
- package/templates/apps/mcp/src/abuse/daily-cap.ts +0 -47
- package/templates/apps/mcp/src/abuse/email-validator.ts +0 -25
- package/templates/apps/mcp/src/abuse/honeypot.ts +0 -21
- package/templates/apps/mcp/src/abuse/index.ts +0 -342
- package/templates/apps/mcp/src/abuse/user-agent-deny.ts +0 -58
- package/templates/apps/mcp/src/boot.ts +0 -167
- package/templates/apps/mcp/src/config/modules.ts +0 -43
- package/templates/apps/mcp/src/http-transport.ts +0 -526
- package/templates/apps/mcp/src/lib/audit-single-page.ts +0 -308
- package/templates/apps/mcp/src/lib/commerce-claim.ts +0 -263
- package/templates/apps/mcp/src/lib/content-adapter.ts +0 -142
- package/templates/apps/mcp/src/lib/empty-content-adapter.ts +0 -139
- package/templates/apps/mcp/src/lib/errors.ts +0 -61
- package/templates/apps/mcp/src/lib/license-key-store.ts +0 -45
- package/templates/apps/mcp/src/lib/locales.ts +0 -171
- package/templates/apps/mcp/src/lib/prisma.ts +0 -39
- package/templates/apps/mcp/src/lib/public-workspace.ts +0 -133
- package/templates/apps/mcp/src/lib/resolve-locale.ts +0 -30
- package/templates/apps/mcp/src/lib/shown-offerings.ts +0 -105
- package/templates/apps/mcp/src/lib/stripe-tax-signal.ts +0 -59
- package/templates/apps/mcp/src/request-context.ts +0 -52
- package/templates/apps/mcp/src/server.ts +0 -343
- package/templates/apps/mcp/src/serverless-app.ts +0 -88
- package/templates/apps/mcp/src/tools/audit.ts +0 -127
- package/templates/apps/mcp/src/tools/capture_lead.ts +0 -64
- package/templates/apps/mcp/src/tools/create_project.ts +0 -134
- package/templates/apps/mcp/src/tools/get_business_hours.ts +0 -68
- package/templates/apps/mcp/src/tools/get_faq.ts +0 -71
- package/templates/apps/mcp/src/tools/get_locations.ts +0 -88
- package/templates/apps/mcp/src/tools/get_offerings.ts +0 -96
- package/templates/apps/mcp/src/tools/get_pricing.ts +0 -94
- package/templates/apps/mcp/src/tools/get_site_info.ts +0 -86
- package/templates/apps/mcp/src/tools/index.ts +0 -137
- package/templates/apps/mcp/src/tools/list_pages.ts +0 -74
- package/templates/apps/mcp/src/tools/person_notes.ts +0 -25
- package/templates/apps/mcp/src/tools/proposals.ts +0 -27
- package/templates/apps/mcp/src/tools/purchase.ts +0 -205
- package/templates/apps/mcp/src/tools/read_content.ts +0 -75
- package/templates/apps/mcp/src/tools/request_callback.ts +0 -59
- package/templates/apps/mcp/src/tools/search_content.ts +0 -67
- package/templates/apps/mcp/src/tools/subscribe_newsletter.ts +0 -57
- package/templates/apps/mcp/src/workspace-server.ts +0 -224
- package/templates/database/CHANGELOG.md +0 -961
- package/templates/database/LICENSE +0 -202
- package/templates/database/NOTICE +0 -2
- package/templates/database/README.md +0 -243
- package/templates/database/__tests__/agents.db.test.ts +0 -320
- package/templates/database/__tests__/appointment.db.test.ts +0 -106
- package/templates/database/__tests__/artifact-content-store.db.test.ts +0 -316
- package/templates/database/__tests__/composite-fence.db.test.ts +0 -206
- package/templates/database/__tests__/consent-ledger.db.test.ts +0 -345
- package/templates/database/__tests__/consent-source-checkout-migration.test.ts +0 -79
- package/templates/database/__tests__/fence-fan-out.db.test.ts +0 -715
- package/templates/database/__tests__/fixtures/appointment-create-probe.ts +0 -79
- package/templates/database/__tests__/fixtures/person-backfill.json +0 -264
- package/templates/database/__tests__/fixtures/person-contact-backfill.json +0 -182
- package/templates/database/__tests__/fixtures/project-listing-consent-probe.ts +0 -100
- package/templates/database/__tests__/flow-completion-migration.test.ts +0 -115
- package/templates/database/__tests__/flow-completion.db.test.ts +0 -136
- package/templates/database/__tests__/flow-workspace-key.db.test.ts +0 -263
- package/templates/database/__tests__/flows-listing-diagnostic.test.ts +0 -392
- package/templates/database/__tests__/flows-presets.test.ts +0 -173
- package/templates/database/__tests__/in-page-magnets-migration.test.ts +0 -161
- package/templates/database/__tests__/lead-idempotency-key.db.test.ts +0 -92
- package/templates/database/__tests__/member-area.db.test.ts +0 -257
- package/templates/database/__tests__/member-contract-migration.test.ts +0 -85
- package/templates/database/__tests__/member-contract.db.test.ts +0 -413
- package/templates/database/__tests__/offerings-checkout-session.db.test.ts +0 -270
- package/templates/database/__tests__/offerings-migration.test.ts +0 -197
- package/templates/database/__tests__/offerings-shown-price-ids-migration.test.ts +0 -86
- package/templates/database/__tests__/offerings.db.test.ts +0 -303
- package/templates/database/__tests__/outbound-message-action.db.test.ts +0 -80
- package/templates/database/__tests__/person-contact.db.test.ts +0 -563
- package/templates/database/__tests__/person-notes.db.test.ts +0 -249
- package/templates/database/__tests__/person.db.test.ts +0 -586
- package/templates/database/__tests__/piece-kind-migration.test.ts +0 -67
- package/templates/database/__tests__/piece-kind.db.test.ts +0 -208
- package/templates/database/__tests__/prefixed-ids.db.test.ts +0 -222
- package/templates/database/__tests__/project-listing-consent-at.db.test.ts +0 -111
- package/templates/database/__tests__/seed.test.ts +0 -240
- package/templates/database/__tests__/spoke-registry.db.test.ts +0 -191
- package/templates/database/__tests__/tenancy.test.ts +0 -141
- package/templates/database/__tests__/user-cascade.test.ts +0 -140
- package/templates/database/_gitignore +0 -8
- package/templates/database/auth/.gitkeep +0 -0
- package/templates/database/auth/schema.prisma +0 -641
- package/templates/database/config/.gitkeep +0 -0
- package/templates/database/config/schema.prisma +0 -441
- package/templates/database/content/.gitkeep +0 -0
- package/templates/database/content/schema.prisma +0 -339
- package/templates/database/eslint.config.mjs +0 -69
- package/templates/database/flows/listing-diagnostic.ts +0 -182
- package/templates/database/flows/presets.ts +0 -315
- package/templates/database/inbox/.gitkeep +0 -0
- package/templates/database/inbox/README.md +0 -3
- package/templates/database/inbox/__tests__/schema.test.ts +0 -44
- package/templates/database/inbox/schema.prisma +0 -1447
- package/templates/database/jest.config.cjs +0 -36
- package/templates/database/migrations/20260508000000_add_inbox_namespace/migration.sql +0 -328
- package/templates/database/migrations/20260513000000_better_auth_migration/migration.sql +0 -100
- package/templates/database/migrations/20260515000000_add_user_billing_fields/migration.sql +0 -28
- package/templates/database/migrations/20260516000000_add_user_tier_care_plan_seat/migration.sql +0 -25
- package/templates/database/migrations/20260518000000_add_telemetry_records/migration.sql +0 -42
- package/templates/database/migrations/20260525000000_theme_wiring/migration.sql +0 -67
- package/templates/database/migrations/20260710000000_retire_commercial_tier/migration.sql +0 -21
- package/templates/database/migrations/20260712215647_add_multi_tenant_tenancy/migration.sql +0 -201
- package/templates/database/migrations/20260713143320_reanchor_site_config_to_workspace/migration.sql +0 -67
- package/templates/database/migrations/20260713174000_add_audit_logs/migration.sql +0 -46
- package/templates/database/migrations/20260713190000_drop_telemetry_records/migration.sql +0 -25
- package/templates/database/migrations/20260713192000_add_uuidv7_function/migration.sql +0 -49
- package/templates/database/migrations/20260713192429_prefixed_uuid_entity_ids/migration.sql +0 -197
- package/templates/database/migrations/20260713200000_add_org_billing/migration.sql +0 -32
- package/templates/database/migrations/20260714000000_add_lead_promotion_fields/migration.sql +0 -22
- package/templates/database/migrations/20260714010000_add_usage_billing_content_models/migration.sql +0 -151
- package/templates/database/migrations/20260714020000_add_usage_billing_auth_config_models/migration.sql +0 -223
- package/templates/database/migrations/20260714030000_credit_balance_non_negative/migration.sql +0 -22
- package/templates/database/migrations/20260714030000_widen_usage_billing_report_aggregates/migration.sql +0 -32
- package/templates/database/migrations/20260810233516_add_flow_engine_models/migration.sql +0 -40
- package/templates/database/migrations/20260811020000_add_flow_session_abandon_email_columns/migration.sql +0 -4
- package/templates/database/migrations/20260811030000_add_flow_session_abandon_email_index/migration.sql +0 -2
- package/templates/database/migrations/20260811040000_add_flow_session_segment/migration.sql +0 -2
- package/templates/database/migrations/20260811050000_add_deliverable_models/migration.sql +0 -29
- package/templates/database/migrations/20260812000000_add_deliverable_grant_send_columns/migration.sql +0 -6
- package/templates/database/migrations/20260902222948_add_waitlist_experiment_models/migration.sql +0 -39
- package/templates/database/migrations/20260902224500_add_waitlist_id_format_checks/migration.sql +0 -24
- package/templates/database/migrations/20260903004112_add_flow_session_flags_aeo_score/migration.sql +0 -3
- package/templates/database/migrations/20260903010000_add_playbook_instance/migration.sql +0 -33
- package/templates/database/migrations/20260904000000_add_waitlist_followup_send/migration.sql +0 -30
- package/templates/database/migrations/20260905230000_add_flow_checkout/migration.sql +0 -47
- package/templates/database/migrations/20260906000000_add_flow_checkout_idempotency/migration.sql +0 -16
- package/templates/database/migrations/20260907120000_add_project_listing/migration.sql +0 -47
- package/templates/database/migrations/20260907130000_add_project_listing_slack_columns/migration.sql +0 -10
- package/templates/database/migrations/20260907180000_add_listing_csv_send/migration.sql +0 -26
- package/templates/database/migrations/20260909120000_project_listings_platform/migration.sql +0 -90
- package/templates/database/migrations/20260909180000_listing_draft_and_fields/migration.sql +0 -174
- package/templates/database/migrations/20260910120000_listing_public_site_key/migration.sql +0 -14
- package/templates/database/migrations/20260911120000_listing_copy_edit_audit/migration.sql +0 -25
- package/templates/database/migrations/20260911140000_listing_structured_address/migration.sql +0 -32
- package/templates/database/migrations/20260911180000_consent_grants/migration.sql +0 -71
- package/templates/database/migrations/20260911200000_listing_site_answers/migration.sql +0 -30
- package/templates/database/migrations/20260912120000_listing_owner_link/migration.sql +0 -49
- package/templates/database/migrations/20260914120000_listing_founder_identity/migration.sql +0 -123
- package/templates/database/migrations/20260915120000_project_listing_solution/migration.sql +0 -15
- package/templates/database/migrations/20260916120000_artifact_content_store/migration.sql +0 -158
- package/templates/database/migrations/20260917120000_callback_request_confirm/migration.sql +0 -40
- package/templates/database/migrations/20260918120000_add_appointment/migration.sql +0 -67
- package/templates/database/migrations/20260918120000_asset_metadata_columns/migration.sql +0 -70
- package/templates/database/migrations/20260919120000_flow_workspace_key/migration.sql +0 -181
- package/templates/database/migrations/20260919130000_flow_definition_admin_columns/migration.sql +0 -172
- package/templates/database/migrations/20260919130000_workspace_meetings/migration.sql +0 -41
- package/templates/database/migrations/20260919140000_inbox_workspace_key/migration.sql +0 -185
- package/templates/database/migrations/20260920120000_lead_handled_at/migration.sql +0 -70
- package/templates/database/migrations/20260920130000_lead_workspace_source_index/migration.sql +0 -57
- package/templates/database/migrations/20260921120000_deliverable_grant_workspace_key/migration.sql +0 -68
- package/templates/database/migrations/20260922120000_tenancy_fence/migration.sql +0 -1067
- package/templates/database/migrations/20260923120000_listing_capturing_magnet/migration.sql +0 -210
- package/templates/database/migrations/20261003120000_spoke_registry/migration.sql +0 -80
- package/templates/database/migrations/20261003130000_scheduling_connection/migration.sql +0 -49
- package/templates/database/migrations/20261005120000_agents/migration.sql +0 -84
- package/templates/database/migrations/20261008120000_user_last_workspace/migration.sql +0 -35
- package/templates/database/migrations/20261008130000_lead_idempotency_key/migration.sql +0 -20
- package/templates/database/migrations/20261009120000_agent_grants/migration.sql +0 -33
- package/templates/database/migrations/20261010120000_person/migration.sql +0 -106
- package/templates/database/migrations/20261010121000_person_backfill/migration.sql +0 -132
- package/templates/database/migrations/20261010130000_agent_grants_people_read/migration.sql +0 -20
- package/templates/database/migrations/20261011120000_member_area/migration.sql +0 -158
- package/templates/database/migrations/20261011130000_agent_grants_member_pieces_manage/migration.sql +0 -21
- package/templates/database/migrations/20261012120000_member_contract/migration.sql +0 -192
- package/templates/database/migrations/20261013120000_lead_spoke_checkout/migration.sql +0 -20
- package/templates/database/migrations/20261014120000_consent_ledger/migration.sql +0 -122
- package/templates/database/migrations/20261014120000_person_contact/migration.sql +0 -231
- package/templates/database/migrations/20261015120000_person_notes/migration.sql +0 -77
- package/templates/database/migrations/20261015120000_rate_limit_counters/migration.sql +0 -43
- package/templates/database/migrations/20261016120000_piece_kind/migration.sql +0 -95
- package/templates/database/migrations/20261017120000_outbound_message_action/migration.sql +0 -30
- package/templates/database/migrations/20261018120000_flow_completion/migration.sql +0 -52
- package/templates/database/migrations/20261019120000_consent_source_checkout/migration.sql +0 -27
- package/templates/database/migrations/20261020120000_offerings_data_model/migration.sql +0 -146
- package/templates/database/migrations/20261021120000_offerings_checkout_session/migration.sql +0 -77
- package/templates/database/migrations/20261022120000_in_page_magnets/migration.sql +0 -45
- package/templates/database/migrations/20261023120000_offerings_shown_price_ids/migration.sql +0 -47
- package/templates/database/migrations/20261024120000_organization_plan_checkout_session/migration.sql +0 -16
- package/templates/database/migrations/migration_lock.toml +0 -3
- package/templates/database/ops/.gitkeep +0 -0
- package/templates/database/ops/schema.prisma +0 -43
- package/templates/database/package.json +0 -89
- package/templates/database/schema.prisma +0 -71
- package/templates/database/scripts/db-generate-locked.sh +0 -80
- package/templates/database/scripts/person-backfill.sql +0 -132
- package/templates/database/tenancy.ts +0 -183
- package/templates/database/tsconfig.build.json +0 -16
- package/templates/database/tsconfig.flows.json +0 -15
- package/templates/database/tsconfig.json +0 -16
- package/templates/database/tsconfig.tenancy.json +0 -14
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Per-IP daily cap counter.
|
|
3
|
-
*
|
|
4
|
-
* Tracks how many times each IP has triggered a capped action within a
|
|
5
|
-
* 24-hour rolling window. Uses an in-memory Map — loss on restart is
|
|
6
|
-
* acceptable for OSS. The paid layer replaces this with a durable store
|
|
7
|
-
* (Redis or the lead-routing service).
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
const ONE_DAY_MS = 24 * 60 * 60 * 1000;
|
|
11
|
-
const DEFAULT_CAP = 50;
|
|
12
|
-
|
|
13
|
-
interface Entry {
|
|
14
|
-
count: number;
|
|
15
|
-
windowStart: number;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
export class DailyCapTracker {
|
|
19
|
-
private readonly cap: number;
|
|
20
|
-
private readonly counters = new Map<string, Entry>();
|
|
21
|
-
|
|
22
|
-
constructor(cap: number = DEFAULT_CAP) {
|
|
23
|
-
this.cap = cap;
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* Returns true if the given IP is below the daily cap (and increments the
|
|
28
|
-
* counter). Returns false if the cap has already been reached today.
|
|
29
|
-
*/
|
|
30
|
-
isAllowed(ip: string): boolean {
|
|
31
|
-
const now = Date.now();
|
|
32
|
-
const entry = this.counters.get(ip);
|
|
33
|
-
|
|
34
|
-
if (!entry || now - entry.windowStart >= ONE_DAY_MS) {
|
|
35
|
-
// Fresh window
|
|
36
|
-
this.counters.set(ip, { count: 1, windowStart: now });
|
|
37
|
-
return true;
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
if (entry.count >= this.cap) {
|
|
41
|
-
return false;
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
entry.count += 1;
|
|
45
|
-
return true;
|
|
46
|
-
}
|
|
47
|
-
}
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* RFC 5322-style email format validation for abuse rules.
|
|
3
|
-
*
|
|
4
|
-
* Validates that a string is a plausibly well-formed email address.
|
|
5
|
-
* This is intentionally lenient — the goal is to reject obviously malformed
|
|
6
|
-
* values (missing @, missing domain, missing TLD) rather than to implement
|
|
7
|
-
* the full RFC 5322 grammar.
|
|
8
|
-
*
|
|
9
|
-
* Paid-layer (lead-routing.ts) adds real deliverability checks via an
|
|
10
|
-
* external service; OSS gets basic format protection.
|
|
11
|
-
*/
|
|
12
|
-
|
|
13
|
-
// Requires: local@domain.tld — at least one dot in the domain part.
|
|
14
|
-
const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
|
|
15
|
-
|
|
16
|
-
/**
|
|
17
|
-
* Returns true if `email` passes the basic format check.
|
|
18
|
-
* Returns false for empty strings, missing @, missing domain, or missing TLD.
|
|
19
|
-
*/
|
|
20
|
-
export function isValidEmail(email: string): boolean {
|
|
21
|
-
if (!email || typeof email !== "string") return false;
|
|
22
|
-
// Reject multiple @ characters
|
|
23
|
-
if ((email.match(/@/g) ?? []).length !== 1) return false;
|
|
24
|
-
return EMAIL_RE.test(email);
|
|
25
|
-
}
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Honeypot field check for abuse rules.
|
|
3
|
-
*
|
|
4
|
-
* If the tool input contains a `honeypot` field with any non-empty value,
|
|
5
|
-
* the request is rejected as bot traffic. Legitimate human-driven agents
|
|
6
|
-
* never populate hidden honeypot fields.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
/**
|
|
10
|
-
* Returns true if the honeypot field is present and non-empty in `input`.
|
|
11
|
-
* Treats missing, null, or empty-string honeypot as clean.
|
|
12
|
-
*/
|
|
13
|
-
export function isHoneypotTripped(input: unknown): boolean {
|
|
14
|
-
if (!input || typeof input !== "object") return false;
|
|
15
|
-
const rec = input as Record<string, unknown>;
|
|
16
|
-
if (!("honeypot" in rec)) return false;
|
|
17
|
-
const val = rec["honeypot"];
|
|
18
|
-
if (val === null || val === undefined) return false;
|
|
19
|
-
if (typeof val === "string" && val.length === 0) return false;
|
|
20
|
-
return true;
|
|
21
|
-
}
|
|
@@ -1,342 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Abuse rule orchestrator for MCP write tools.
|
|
3
|
-
*
|
|
4
|
-
* Runs all in-process heuristics for the anonymous write tools:
|
|
5
|
-
* capture_lead, subscribe_newsletter, request_callback, start_purchase
|
|
6
|
-
* (#5971), and — since #8071 — create_booking and submit_flow_step.
|
|
7
|
-
*
|
|
8
|
-
* Rules applied (in order):
|
|
9
|
-
* 1. User-Agent deny list (applies to all write tools)
|
|
10
|
-
* 2. Honeypot field check (applies to all write tools)
|
|
11
|
-
* 3. Email format validation (capture_lead, subscribe_newsletter, and
|
|
12
|
-
* create_booking's attendee.email)
|
|
13
|
-
* 4. Per-IP daily cap (capture_lead, start_purchase, create_booking and
|
|
14
|
-
* submit_flow_step, each on its OWN tracker — sharing one would let one
|
|
15
|
-
* tool's calls consume another's budget, a silent cross-tool denial of
|
|
16
|
-
* service)
|
|
17
|
-
*
|
|
18
|
-
* The paid layer (lead-routing.ts) extends with real abuse-protection
|
|
19
|
-
* services. OSS gets basic heuristics that stop obvious bots.
|
|
20
|
-
*/
|
|
21
|
-
|
|
22
|
-
import type { FastifyRequest } from "fastify";
|
|
23
|
-
|
|
24
|
-
import { DailyCapTracker } from "./daily-cap.js";
|
|
25
|
-
import { isValidEmail } from "./email-validator.js";
|
|
26
|
-
import { isHoneypotTripped } from "./honeypot.js";
|
|
27
|
-
import { buildDenyList, isUserAgentBlocked } from "./user-agent-deny.js";
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* Tools that require email format validation on their input, each mapped to
|
|
31
|
-
* where the email sits in it: top level for the lead tools, `attendee.email`
|
|
32
|
-
* for create_booking (#8071 D3). submit_flow_step has no fixed email field —
|
|
33
|
-
* its `values` is a free record the hub's flow engine validates.
|
|
34
|
-
*/
|
|
35
|
-
const EMAIL_VALIDATED_TOOLS = new Map<string, readonly string[]>([
|
|
36
|
-
["capture_lead", ["email"]],
|
|
37
|
-
["subscribe_newsletter", ["email"]],
|
|
38
|
-
["create_booking", ["attendee", "email"]],
|
|
39
|
-
]);
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* The value at `path` in `input`, or undefined when any step is not a plain
|
|
43
|
-
* object — a `null`, string or array `attendee` reads as a missing email, so a
|
|
44
|
-
* malformed body can never throw out of the guard (#8071 SEC-13).
|
|
45
|
-
*/
|
|
46
|
-
function valueAt(input: unknown, path: readonly string[]): unknown {
|
|
47
|
-
let value = input;
|
|
48
|
-
for (const key of path) {
|
|
49
|
-
if (!value || typeof value !== "object" || Array.isArray(value)) {
|
|
50
|
-
return undefined;
|
|
51
|
-
}
|
|
52
|
-
value = (value as Record<string, unknown>)[key];
|
|
53
|
-
}
|
|
54
|
-
return value;
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
/** The per-tool daily-cap budgets, keyed by MCP tool name. */
|
|
58
|
-
type DailyCapKey =
|
|
59
|
-
| "captureLead"
|
|
60
|
-
| "startPurchase"
|
|
61
|
-
| "createBooking"
|
|
62
|
-
| "submitFlowStep";
|
|
63
|
-
|
|
64
|
-
/**
|
|
65
|
-
* The typed reason codes an {@link AbuseResult} refusal can carry.
|
|
66
|
-
*
|
|
67
|
-
* The code — not the prose in `reason` — is the contract between this module
|
|
68
|
-
* and its callers. `http-transport.ts` maps each code to an HTTP status
|
|
69
|
-
* (`ABUSE_REFUSAL_STATUS`), so a reworded refusal reason can never move a
|
|
70
|
-
* refusal between statuses, and a NEW code fails to compile until the
|
|
71
|
-
* transport declares a status for it (#5994).
|
|
72
|
-
*/
|
|
73
|
-
export const AbuseReasonCode = {
|
|
74
|
-
/** The caller's User-Agent is on the deny list. */
|
|
75
|
-
BLOCKED_USER_AGENT: "blocked_user_agent",
|
|
76
|
-
/** The submitted input filled a honeypot field. */
|
|
77
|
-
HONEYPOT_FILLED: "honeypot_filled",
|
|
78
|
-
/** The submitted input carried a malformed email address. */
|
|
79
|
-
INVALID_EMAIL: "invalid_email",
|
|
80
|
-
/** The caller's IP has spent this tool's per-IP daily budget. */
|
|
81
|
-
DAILY_CAP_REACHED: "daily_cap_reached",
|
|
82
|
-
} as const;
|
|
83
|
-
|
|
84
|
-
export type AbuseReasonCode =
|
|
85
|
-
(typeof AbuseReasonCode)[keyof typeof AbuseReasonCode];
|
|
86
|
-
|
|
87
|
-
/**
|
|
88
|
-
* Tools that apply a per-IP daily cap, each mapped to the tracker that budgets
|
|
89
|
-
* it and the refusal reason it answers with. One tracker per entry — never
|
|
90
|
-
* shared across tools, since a shared budget would let one tool's calls
|
|
91
|
-
* consume another's allowance (purchase attempts the lead budget, flow steps
|
|
92
|
-
* the lead budget they could otherwise mint Leads past).
|
|
93
|
-
*
|
|
94
|
-
* The reason strings here are prose for the caller and nothing more: every
|
|
95
|
-
* entry refuses with {@link AbuseReasonCode.DAILY_CAP_REACHED}, and that code
|
|
96
|
-
* is what decides the HTTP status. Reword either one freely.
|
|
97
|
-
*/
|
|
98
|
-
const DAILY_CAPPED_TOOLS = new Map<
|
|
99
|
-
string,
|
|
100
|
-
{ tracker: DailyCapKey; reason: string }
|
|
101
|
-
>([
|
|
102
|
-
[
|
|
103
|
-
"capture_lead",
|
|
104
|
-
{
|
|
105
|
-
tracker: "captureLead",
|
|
106
|
-
reason: "daily capture_lead cap reached for this IP",
|
|
107
|
-
},
|
|
108
|
-
],
|
|
109
|
-
[
|
|
110
|
-
"start_purchase",
|
|
111
|
-
{
|
|
112
|
-
tracker: "startPurchase",
|
|
113
|
-
reason: "daily cap reached for start_purchase from this IP",
|
|
114
|
-
},
|
|
115
|
-
],
|
|
116
|
-
[
|
|
117
|
-
"create_booking",
|
|
118
|
-
{
|
|
119
|
-
tracker: "createBooking",
|
|
120
|
-
reason: "daily cap reached for create_booking from this IP",
|
|
121
|
-
},
|
|
122
|
-
],
|
|
123
|
-
[
|
|
124
|
-
"submit_flow_step",
|
|
125
|
-
{
|
|
126
|
-
tracker: "submitFlowStep",
|
|
127
|
-
reason: "daily cap reached for submit_flow_step from this IP",
|
|
128
|
-
},
|
|
129
|
-
],
|
|
130
|
-
]);
|
|
131
|
-
|
|
132
|
-
export interface AbuseConfig {
|
|
133
|
-
/** Per-IP daily cap for capture_lead. Default 50. */
|
|
134
|
-
captureLeadDailyCapPerIp: number;
|
|
135
|
-
/**
|
|
136
|
-
* Per-IP daily cap for start_purchase (#5971). Default 20 — lower than
|
|
137
|
-
* capture_lead's, because each call creates a real Stripe Checkout Session.
|
|
138
|
-
* Optional so existing callers that construct an AbuseConfig without it
|
|
139
|
-
* keep compiling; omitted falls back to the default.
|
|
140
|
-
*/
|
|
141
|
-
startPurchaseDailyCapPerIp?: number;
|
|
142
|
-
/**
|
|
143
|
-
* Per-IP daily cap for create_booking (#8071). Default 20, as for
|
|
144
|
-
* start_purchase: each call creates a real calendar event and emails the
|
|
145
|
-
* attendee an invite. Optional; omitted falls back to the default.
|
|
146
|
-
*/
|
|
147
|
-
createBookingDailyCapPerIp?: number;
|
|
148
|
-
/**
|
|
149
|
-
* Per-IP daily cap for submit_flow_step (#8071). Default 50, equal to
|
|
150
|
-
* capture_lead's and no higher: a one-step flow creates a Lead in one call.
|
|
151
|
-
* Optional; omitted falls back to the default.
|
|
152
|
-
*/
|
|
153
|
-
submitFlowStepDailyCapPerIp?: number;
|
|
154
|
-
/** Comma-separated extra UA substrings to block. */
|
|
155
|
-
blockedUserAgents: string;
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
/** Default per-IP daily cap for start_purchase when none is configured. */
|
|
159
|
-
export const DEFAULT_START_PURCHASE_DAILY_CAP = 20;
|
|
160
|
-
|
|
161
|
-
/** Default per-IP daily cap for capture_lead when none is configured. */
|
|
162
|
-
export const DEFAULT_CAPTURE_LEAD_DAILY_CAP = 50;
|
|
163
|
-
|
|
164
|
-
/** Default per-IP daily cap for create_booking when none is configured. */
|
|
165
|
-
export const DEFAULT_CREATE_BOOKING_DAILY_CAP = 20;
|
|
166
|
-
|
|
167
|
-
/** Default per-IP daily cap for submit_flow_step when none is configured. */
|
|
168
|
-
export const DEFAULT_SUBMIT_FLOW_STEP_DAILY_CAP = 50;
|
|
169
|
-
|
|
170
|
-
/**
|
|
171
|
-
* Reads a positive-integer env var, falling back to `fallback` for anything
|
|
172
|
-
* that is not one.
|
|
173
|
-
*
|
|
174
|
-
* `parseInt(process.env[X] ?? "20", 10)` is NOT enough, and the gap is a
|
|
175
|
-
* silent fail-OPEN on a security threshold (#5971 security review round 2):
|
|
176
|
-
* `?? "20"` fires only when the var is UNSET, so a var that is present but
|
|
177
|
-
* BLANK — the shape `.env.example` itself teaches for three neighbouring
|
|
178
|
-
* vars — reaches `parseInt("")` and yields `NaN`. `NaN` then survives every
|
|
179
|
-
* downstream `??` guard (nullish coalescing catches null/undefined, not NaN),
|
|
180
|
-
* and `count >= NaN` is always false, so the cap silently stops refusing
|
|
181
|
-
* anything. A misconfigured deployment looks identical to a correct one at
|
|
182
|
-
* rest, which is exactly why this needs a guard rather than a convention.
|
|
183
|
-
*/
|
|
184
|
-
export function readPositiveIntEnv(name: string, fallback: number): number {
|
|
185
|
-
const parsed = Number.parseInt(process.env[name] ?? "", 10);
|
|
186
|
-
return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
|
|
187
|
-
}
|
|
188
|
-
|
|
189
|
-
/** Coerces a configured cap to a usable one, defaulting anything non-finite
|
|
190
|
-
* or non-positive. The in-process twin of {@link readPositiveIntEnv}, for a
|
|
191
|
-
* cap that arrives through {@link AbuseConfig} rather than the environment. */
|
|
192
|
-
function usableCap(value: number | undefined, fallback: number): number {
|
|
193
|
-
return typeof value === "number" && Number.isFinite(value) && value > 0
|
|
194
|
-
? value
|
|
195
|
-
: fallback;
|
|
196
|
-
}
|
|
197
|
-
|
|
198
|
-
/** A refusal: always carries both the typed code and its caller-facing prose. */
|
|
199
|
-
export interface AbuseRefusal {
|
|
200
|
-
allowed: false;
|
|
201
|
-
/** What kind of refusal this is — the machine-readable half. */
|
|
202
|
-
code: AbuseReasonCode;
|
|
203
|
-
/** Caller-facing prose. Free to reword; nothing keys control flow on it. */
|
|
204
|
-
reason: string;
|
|
205
|
-
}
|
|
206
|
-
|
|
207
|
-
/** The verdict of {@link AbuseGuard.validate}. */
|
|
208
|
-
export type AbuseResult = { allowed: true } | AbuseRefusal;
|
|
209
|
-
|
|
210
|
-
export class AbuseGuard {
|
|
211
|
-
private readonly denyList: RegExp[];
|
|
212
|
-
private readonly caps: Record<DailyCapKey, DailyCapTracker>;
|
|
213
|
-
|
|
214
|
-
constructor(config: AbuseConfig) {
|
|
215
|
-
this.denyList = buildDenyList(config.blockedUserAgents);
|
|
216
|
-
this.caps = {
|
|
217
|
-
captureLead: new DailyCapTracker(
|
|
218
|
-
usableCap(
|
|
219
|
-
config.captureLeadDailyCapPerIp,
|
|
220
|
-
DEFAULT_CAPTURE_LEAD_DAILY_CAP,
|
|
221
|
-
),
|
|
222
|
-
),
|
|
223
|
-
startPurchase: new DailyCapTracker(
|
|
224
|
-
usableCap(
|
|
225
|
-
config.startPurchaseDailyCapPerIp,
|
|
226
|
-
DEFAULT_START_PURCHASE_DAILY_CAP,
|
|
227
|
-
),
|
|
228
|
-
),
|
|
229
|
-
createBooking: new DailyCapTracker(
|
|
230
|
-
usableCap(
|
|
231
|
-
config.createBookingDailyCapPerIp,
|
|
232
|
-
DEFAULT_CREATE_BOOKING_DAILY_CAP,
|
|
233
|
-
),
|
|
234
|
-
),
|
|
235
|
-
submitFlowStep: new DailyCapTracker(
|
|
236
|
-
usableCap(
|
|
237
|
-
config.submitFlowStepDailyCapPerIp,
|
|
238
|
-
DEFAULT_SUBMIT_FLOW_STEP_DAILY_CAP,
|
|
239
|
-
),
|
|
240
|
-
),
|
|
241
|
-
};
|
|
242
|
-
}
|
|
243
|
-
|
|
244
|
-
/**
|
|
245
|
-
* Validates all abuse rules for the given tool call.
|
|
246
|
-
*
|
|
247
|
-
* @param toolName - MCP tool name (e.g. "capture_lead")
|
|
248
|
-
* @param input - Parsed tool arguments object
|
|
249
|
-
* @param request - Fastify request (for IP + UA extraction)
|
|
250
|
-
*/
|
|
251
|
-
validate(
|
|
252
|
-
toolName: string,
|
|
253
|
-
input: unknown,
|
|
254
|
-
request: FastifyRequest,
|
|
255
|
-
): AbuseResult {
|
|
256
|
-
const ua = request.headers["user-agent"];
|
|
257
|
-
const ip = request.ip;
|
|
258
|
-
|
|
259
|
-
// Rule 1: User-Agent deny list
|
|
260
|
-
if (isUserAgentBlocked(ua, this.denyList)) {
|
|
261
|
-
return {
|
|
262
|
-
allowed: false,
|
|
263
|
-
code: AbuseReasonCode.BLOCKED_USER_AGENT,
|
|
264
|
-
reason: "blocked user agent",
|
|
265
|
-
};
|
|
266
|
-
}
|
|
267
|
-
|
|
268
|
-
// Rule 2: Honeypot
|
|
269
|
-
if (isHoneypotTripped(input)) {
|
|
270
|
-
return {
|
|
271
|
-
allowed: false,
|
|
272
|
-
code: AbuseReasonCode.HONEYPOT_FILLED,
|
|
273
|
-
reason: "honeypot field filled",
|
|
274
|
-
};
|
|
275
|
-
}
|
|
276
|
-
|
|
277
|
-
// Rule 3: Email format validation, at the tool's own email path. A
|
|
278
|
-
// missing or non-string email passes — the handler's Zod schema is the
|
|
279
|
-
// authority on required fields.
|
|
280
|
-
const emailPath = EMAIL_VALIDATED_TOOLS.get(toolName);
|
|
281
|
-
if (emailPath !== undefined) {
|
|
282
|
-
const email = valueAt(input, emailPath);
|
|
283
|
-
if (typeof email === "string" && !isValidEmail(email)) {
|
|
284
|
-
return {
|
|
285
|
-
allowed: false,
|
|
286
|
-
code: AbuseReasonCode.INVALID_EMAIL,
|
|
287
|
-
reason: "invalid email format",
|
|
288
|
-
};
|
|
289
|
-
}
|
|
290
|
-
}
|
|
291
|
-
|
|
292
|
-
// Rule 4: Per-IP daily cap, on the tool's OWN tracker and with the
|
|
293
|
-
// tool's OWN refusal prose — one shared code, see DAILY_CAPPED_TOOLS.
|
|
294
|
-
const cap = DAILY_CAPPED_TOOLS.get(toolName);
|
|
295
|
-
if (cap !== undefined && !this.caps[cap.tracker].isAllowed(ip)) {
|
|
296
|
-
return {
|
|
297
|
-
allowed: false,
|
|
298
|
-
code: AbuseReasonCode.DAILY_CAP_REACHED,
|
|
299
|
-
reason: cap.reason,
|
|
300
|
-
};
|
|
301
|
-
}
|
|
302
|
-
|
|
303
|
-
return { allowed: true };
|
|
304
|
-
}
|
|
305
|
-
}
|
|
306
|
-
|
|
307
|
-
/**
|
|
308
|
-
* The abuse configuration, read from the environment. The one reader of the
|
|
309
|
-
* MCP_ABUSE_* variables: both entries reach it through
|
|
310
|
-
* `httpTransportConfigFromEnv()` (`src/boot.ts`), and
|
|
311
|
-
* {@link createAbuseGuardFromEnv} wraps it, so a new cap is added here once.
|
|
312
|
-
*
|
|
313
|
-
* Every cap goes through {@link readPositiveIntEnv}: a blank, zero or
|
|
314
|
-
* non-numeric value yields its default, never an unlimited cap.
|
|
315
|
-
*/
|
|
316
|
-
export function abuseConfigFromEnv(): Required<AbuseConfig> {
|
|
317
|
-
return {
|
|
318
|
-
captureLeadDailyCapPerIp: readPositiveIntEnv(
|
|
319
|
-
"MCP_ABUSE_CAPTURE_LEAD_DAILY_CAP",
|
|
320
|
-
DEFAULT_CAPTURE_LEAD_DAILY_CAP,
|
|
321
|
-
),
|
|
322
|
-
startPurchaseDailyCapPerIp: readPositiveIntEnv(
|
|
323
|
-
"MCP_ABUSE_START_PURCHASE_DAILY_CAP",
|
|
324
|
-
DEFAULT_START_PURCHASE_DAILY_CAP,
|
|
325
|
-
),
|
|
326
|
-
createBookingDailyCapPerIp: readPositiveIntEnv(
|
|
327
|
-
"MCP_ABUSE_CREATE_BOOKING_DAILY_CAP",
|
|
328
|
-
DEFAULT_CREATE_BOOKING_DAILY_CAP,
|
|
329
|
-
),
|
|
330
|
-
submitFlowStepDailyCapPerIp: readPositiveIntEnv(
|
|
331
|
-
"MCP_ABUSE_SUBMIT_FLOW_STEP_DAILY_CAP",
|
|
332
|
-
DEFAULT_SUBMIT_FLOW_STEP_DAILY_CAP,
|
|
333
|
-
),
|
|
334
|
-
// A literal read, so create-ailk's declared-env scan finds it (#7874).
|
|
335
|
-
blockedUserAgents: process.env["MCP_ABUSE_BLOCKED_USER_AGENTS"] ?? "",
|
|
336
|
-
};
|
|
337
|
-
}
|
|
338
|
-
|
|
339
|
-
/** An AbuseGuard built from {@link abuseConfigFromEnv}. */
|
|
340
|
-
export function createAbuseGuardFromEnv(): AbuseGuard {
|
|
341
|
-
return new AbuseGuard(abuseConfigFromEnv());
|
|
342
|
-
}
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* User-Agent deny list for abuse rules.
|
|
3
|
-
*
|
|
4
|
-
* Built-in list blocks well-known script-runner and scraper UAs.
|
|
5
|
-
* Additional patterns can be provided via MCP_ABUSE_BLOCKED_USER_AGENTS
|
|
6
|
-
* (comma-separated substrings; case-insensitive prefix/infix match).
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
/**
|
|
10
|
-
* Built-in patterns for well-known bot/script user agents.
|
|
11
|
-
* Each is a case-insensitive regex that matches a substring of the UA string.
|
|
12
|
-
*/
|
|
13
|
-
const BUILTIN_PATTERNS: RegExp[] = [
|
|
14
|
-
/python-requests/i,
|
|
15
|
-
/curl\//i,
|
|
16
|
-
/wget\//i,
|
|
17
|
-
/scrapy/i,
|
|
18
|
-
/go-http-client/i,
|
|
19
|
-
/libwww-perl/i,
|
|
20
|
-
/java\//i,
|
|
21
|
-
/httpx/i,
|
|
22
|
-
/aiohttp/i,
|
|
23
|
-
/node-fetch/i,
|
|
24
|
-
/axios/i,
|
|
25
|
-
];
|
|
26
|
-
|
|
27
|
-
/**
|
|
28
|
-
* Build the full deny list by merging built-in patterns with any
|
|
29
|
-
* comma-separated substrings from `extraPatterns` (e.g., from env).
|
|
30
|
-
*/
|
|
31
|
-
export function buildDenyList(extraPatterns?: string): RegExp[] {
|
|
32
|
-
const list = [...BUILTIN_PATTERNS];
|
|
33
|
-
|
|
34
|
-
if (extraPatterns) {
|
|
35
|
-
for (const raw of extraPatterns.split(",")) {
|
|
36
|
-
const trimmed = raw.trim();
|
|
37
|
-
if (trimmed.length > 0) {
|
|
38
|
-
// Escape special regex chars so literal substrings match correctly
|
|
39
|
-
const escaped = trimmed.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
40
|
-
list.push(new RegExp(escaped, "i"));
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
return list;
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
/**
|
|
49
|
-
* Returns true if the user agent string matches any pattern in the deny list,
|
|
50
|
-
* or if the UA is missing/empty (headless script behaviour).
|
|
51
|
-
*/
|
|
52
|
-
export function isUserAgentBlocked(
|
|
53
|
-
ua: string | null | undefined,
|
|
54
|
-
denyList: RegExp[],
|
|
55
|
-
): boolean {
|
|
56
|
-
if (!ua || ua.trim().length === 0) return true;
|
|
57
|
-
return denyList.some((pattern) => pattern.test(ua));
|
|
58
|
-
}
|
|
@@ -1,167 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The boot sequence and the HTTP env→config reader both entrypoints share
|
|
3
|
-
* (#8070 D1, D2).
|
|
4
|
-
*
|
|
5
|
-
* `src/index.ts` (stdio, or HTTP on `MCP_HTTP_PORT`) and `src/app.ts` (the
|
|
6
|
-
* Vercel entry) each call {@link bootMcp} before they build a transport, and
|
|
7
|
-
* read the HTTP configuration through {@link httpTransportConfigFromEnv} and
|
|
8
|
-
* {@link readStatelessEnv}. One copy of each, so the two entries cannot drift.
|
|
9
|
-
*
|
|
10
|
-
* Nothing here loads Fastify: the HTTP transport's config type is imported as
|
|
11
|
-
* a type only, so the stdio entry still never loads the HTTP stack.
|
|
12
|
-
*/
|
|
13
|
-
|
|
14
|
-
import { abuseConfigFromEnv, readPositiveIntEnv } from "./abuse/index.js";
|
|
15
|
-
import type { HttpTransportConfig } from "./http-transport.js";
|
|
16
|
-
import {
|
|
17
|
-
initMcpCommerceClaim,
|
|
18
|
-
startMcpClaimRefresh,
|
|
19
|
-
} from "./lib/commerce-claim.js";
|
|
20
|
-
import {
|
|
21
|
-
initPublicWorkspace,
|
|
22
|
-
registerLicenseKeyStore,
|
|
23
|
-
} from "./lib/topology.generated.js";
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* Runs the boot sequence, in order: the workspace resolution, the licence-key
|
|
27
|
-
* store, the commerce claim, the claim re-read loop and the one-release
|
|
28
|
-
* licence warning. Each step that can fail is guarded so one failure never
|
|
29
|
-
* takes the other tools down.
|
|
30
|
-
*/
|
|
31
|
-
export async function bootMcp(): Promise<void> {
|
|
32
|
-
// Resolves the MCP server's own workspace ONCE, before any transport is
|
|
33
|
-
// built — a no-op unless CONTENT_ADAPTER=database (#5876 spec D4/D6).
|
|
34
|
-
// This is the one `await` that covers every transport:
|
|
35
|
-
// `getMcpContentAdapter()` (content-adapter.ts) stays synchronous and reads
|
|
36
|
-
// the memoised result.
|
|
37
|
-
//
|
|
38
|
-
// A REJECTION here (a transient DB error — unreachable at boot, a migration
|
|
39
|
-
// in progress, a bad DATABASE_URL) is caught rather than left to crash the
|
|
40
|
-
// process: every OTHER tool (lead capture, scheduling, …) has nothing to do
|
|
41
|
-
// with the content adapter and must keep serving. The module's un-resolved
|
|
42
|
-
// `{ kind: "not-required" }` state is left in place on a caught failure —
|
|
43
|
-
// the SAME fail-closed shape an ambiguous workspace count already produces
|
|
44
|
-
// (D5) — so content tools serve their empty/not-found shape rather than the
|
|
45
|
-
// whole server going dark over one adapter's connectivity.
|
|
46
|
-
try {
|
|
47
|
-
await initPublicWorkspace();
|
|
48
|
-
} catch (err) {
|
|
49
|
-
console.error(
|
|
50
|
-
"[mcp] initPublicWorkspace() failed — content tools will serve their " +
|
|
51
|
-
"fail-closed empty shape under CONTENT_ADAPTER=database until this " +
|
|
52
|
-
"resolves; every other tool is unaffected:",
|
|
53
|
-
err,
|
|
54
|
-
);
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
// Registers the renewed licence key's durable home (#6677 DD-6) BEFORE the
|
|
58
|
-
// commerce claim below memoises the licence: with a database, the key a
|
|
59
|
-
// sibling app renewed lives in one SiteSetting row, and the claim must read
|
|
60
|
-
// it. Never throws; without DATABASE_URL the file store stays in place.
|
|
61
|
-
await registerLicenseKeyStore();
|
|
62
|
-
|
|
63
|
-
// Resolves the deployment's `commerce` add-on claim at boot, before any
|
|
64
|
-
// transport is built — the sibling of the workspace resolution above and
|
|
65
|
-
// the same #5876 idiom (#5971 spec D2). Without this await the memoised
|
|
66
|
-
// claim is never resolved and `start_purchase` is invisible on a KEYED
|
|
67
|
-
// site too. The same single licence read now also resolves the licence
|
|
68
|
-
// features the deployment holds, which gate the five `feature`-tagged
|
|
69
|
-
// tools (#7136). The re-read loop below runs every `MCP_CLAIM_REFRESH_MS`
|
|
70
|
-
// thereafter (#7156), so the server's origin agrees with the manifest
|
|
71
|
-
// route's origin response within that bound; the route answers
|
|
72
|
-
// `cache-control: public, max-age=86400`, so a downstream cache may serve
|
|
73
|
-
// an older manifest for up to 24 hours.
|
|
74
|
-
//
|
|
75
|
-
// A REJECTION is caught for the same reason: a licence read that fails
|
|
76
|
-
// must not take the other 19 tools down. `initMcpCommerceClaim()` already
|
|
77
|
-
// resolves to the fail-closed "unclaimed" internally, so this catch is
|
|
78
|
-
// belt-and-braces for anything thrown outside its own try.
|
|
79
|
-
try {
|
|
80
|
-
await initMcpCommerceClaim();
|
|
81
|
-
} catch (err) {
|
|
82
|
-
console.error(
|
|
83
|
-
"[mcp] initMcpCommerceClaim() failed — start_purchase stays unregistered " +
|
|
84
|
-
"(fail-closed) until this resolves; every other tool is unaffected:",
|
|
85
|
-
err,
|
|
86
|
-
);
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
// Starts the bounded re-read (#7156 spec D1), after the boot read resolves
|
|
90
|
-
// so the first re-read never races it. Never throws; the timer is unref'd.
|
|
91
|
-
startMcpClaimRefresh();
|
|
92
|
-
|
|
93
|
-
// The one-release warning cycle (#7136): once per process, whichever
|
|
94
|
-
// transport follows, one stderr line per tool served without its licence
|
|
95
|
-
// feature. After the claim resolves, or it would warn for every tool.
|
|
96
|
-
//
|
|
97
|
-
// A throw here must not stop the server (#7156 spec D2, L1) — only the call
|
|
98
|
-
// is guarded, not the import: if `./server.js` fails to load, every
|
|
99
|
-
// transport loads it again and the server could not start anyway.
|
|
100
|
-
const { reportUnlicensedProTools } = await import("./server.js");
|
|
101
|
-
try {
|
|
102
|
-
reportUnlicensedProTools();
|
|
103
|
-
} catch (err) {
|
|
104
|
-
console.error(
|
|
105
|
-
"[mcp] reportUnlicensedProTools() failed — the licence boot warning was " +
|
|
106
|
-
"not written; every tool is served as registered:",
|
|
107
|
-
err,
|
|
108
|
-
);
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
/**
|
|
113
|
-
* Whether the HTTP transport runs stateless, from `MCP_HTTP_STATELESS`
|
|
114
|
-
* (#8070 D1). Trimmed and case-insensitive: `true`/`1` → on, `false`/`0` →
|
|
115
|
-
* off, unset or empty → `defaultValue`. Anything else throws, so a typo fails
|
|
116
|
-
* the boot rather than silently picking a mode.
|
|
117
|
-
*
|
|
118
|
-
* Each entry passes its own default: `src/index.ts` passes `false` (today's
|
|
119
|
-
* stateful server, unchanged); the Vercel entry passes `true`, because a
|
|
120
|
-
* stateful transport keeps its sessions in one instance's memory and cannot
|
|
121
|
-
* work across the instances a serverless host runs.
|
|
122
|
-
*/
|
|
123
|
-
export function readStatelessEnv(defaultValue: boolean): boolean {
|
|
124
|
-
// A literal read, so create-ailk's declared-env scan finds it (#7874).
|
|
125
|
-
const raw = process.env["MCP_HTTP_STATELESS"];
|
|
126
|
-
const value = (raw ?? "").trim().toLowerCase();
|
|
127
|
-
if (value === "") return defaultValue;
|
|
128
|
-
if (value === "true" || value === "1") return true;
|
|
129
|
-
if (value === "false" || value === "0") return false;
|
|
130
|
-
throw new Error(
|
|
131
|
-
`MCP_HTTP_STATELESS must be one of true, false, 1 or 0 (got "${raw}")`,
|
|
132
|
-
);
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
/**
|
|
136
|
-
* The HTTP transport's configuration, read from the environment as
|
|
137
|
-
* `src/index.ts` has always read it — with one change: the two per-minute
|
|
138
|
-
* rates go through {@link readPositiveIntEnv}, as the daily caps already do,
|
|
139
|
-
* so a blank or non-numeric value falls back to its default instead of
|
|
140
|
-
* yielding `NaN` and silently disabling the limit (#8070 S8070-06).
|
|
141
|
-
*
|
|
142
|
-
* Every variable is optional; the defaults are shown in
|
|
143
|
-
* `apps/mcp/.env.example`. Stateless mode is not read here: each entry reads
|
|
144
|
-
* it through {@link readStatelessEnv} with its own default.
|
|
145
|
-
*/
|
|
146
|
-
export function httpTransportConfigFromEnv(): HttpTransportConfig & {
|
|
147
|
-
port: number;
|
|
148
|
-
} {
|
|
149
|
-
const port = parseInt(process.env["MCP_HTTP_PORT"] ?? "8080", 10);
|
|
150
|
-
const path = process.env["MCP_HTTP_PATH"] ?? "/mcp";
|
|
151
|
-
const readPerMin = readPositiveIntEnv("MCP_RATE_LIMIT_READ_PER_MIN", 60);
|
|
152
|
-
const writePerMin = readPositiveIntEnv("MCP_RATE_LIMIT_WRITE_PER_MIN", 10);
|
|
153
|
-
const writeOriginsRaw = process.env["MCP_CORS_WRITE_ALLOWED_ORIGINS"] ?? "";
|
|
154
|
-
const writeAllowedOrigins = writeOriginsRaw
|
|
155
|
-
? writeOriginsRaw.split(",").map((o) => o.trim())
|
|
156
|
-
: [];
|
|
157
|
-
return {
|
|
158
|
-
port,
|
|
159
|
-
path,
|
|
160
|
-
rateLimits: { readPerMin, writePerMin },
|
|
161
|
-
cors: { writeAllowedOrigins },
|
|
162
|
-
// The MCP_ABUSE_* variables have one reader, shared with
|
|
163
|
-
// createAbuseGuardFromEnv (#8071); every cap falls back to its default
|
|
164
|
-
// on a blank or non-numeric value, never to unlimited (#5971).
|
|
165
|
-
abuse: abuseConfigFromEnv(),
|
|
166
|
-
};
|
|
167
|
-
}
|