create-ailk 0.5.0 → 0.6.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 +55 -8
- package/component-catalog.json +336 -27
- package/component-catalog.md +25 -12
- package/dist/cli.js +54 -5
- package/dist/copy.d.ts +14 -0
- package/dist/copy.js +38 -1
- package/dist/lib/api-boot-assertion.d.ts +46 -0
- package/dist/lib/api-boot-assertion.js +70 -0
- package/dist/lib/extract-module-bundle.d.ts +20 -1
- package/dist/lib/extract-module-bundle.js +64 -5
- package/dist/lib/import-graph.d.ts +29 -0
- package/dist/lib/import-graph.js +140 -0
- package/dist/lib/module-license-gate.d.ts +6 -1
- package/dist/lib/module-license-gate.js +6 -1
- package/dist/lib/pro-callout.js +1 -1
- package/dist/module-architecture.d.ts +1 -0
- package/dist/module-architecture.js +253 -127
- package/dist/modules/commerce/0.6.0.tar.gz +0 -0
- package/dist/modules/docs-blog/0.6.0.tar.gz +0 -0
- package/dist/modules/multi-tenant/0.6.0.tar.gz +0 -0
- package/dist/modules/scheduling/0.6.0.tar.gz +0 -0
- package/dist/modules/signal-collectors/0.6.0.tar.gz +0 -0
- package/dist/modules/workspace/0.6.0.tar.gz +0 -0
- package/dist/programmatic.js +14 -10
- package/dist/surfaces.js +105 -7
- package/dist/template-manifest.d.ts +33 -0
- package/dist/template-manifest.js +99 -16
- package/dist/template-names.d.ts +1 -1
- package/dist/template-names.js +1 -0
- package/package.json +3 -2
- package/site-templates/marketing-site/DESIGN.md +148 -0
- package/site-templates/marketing-site/TEMPLATE-MANIFEST.json +22 -2
- package/site-templates/marketing-site/TEMPLATE-MANIFEST.md +9 -2
- package/site-templates/marketing-site/ailk-template.json +1 -1
- package/site-templates/marketing-site-free/DESIGN.md +148 -0
- package/site-templates/marketing-site-free/TEMPLATE-MANIFEST.json +2 -2
- package/site-templates/marketing-site-free/TEMPLATE-MANIFEST.md +1 -0
- package/site-templates/minimalism-site/DESIGN.md +148 -0
- package/site-templates/minimalism-site/TEMPLATE-MANIFEST.json +10 -2
- package/site-templates/minimalism-site/TEMPLATE-MANIFEST.md +47 -35
- package/site-templates/minimalism-site/ailk-template.json +2 -1
- package/site-templates/minimalism-site/assets/wordmark-placeholder.svg +28 -0
- package/site-templates/minimalism-site/content/en/HomePage/home.mdx +49 -19
- package/site-templates/saas-product/DESIGN.md +148 -0
- package/site-templates/simple-service/DESIGN.md +148 -0
- package/site-templates/simple-service/TEMPLATE-MANIFEST.json +240 -0
- package/site-templates/simple-service/TEMPLATE-MANIFEST.md +278 -0
- package/site-templates/simple-service/ailk-template.json +10 -0
- package/site-templates/simple-service/content/en/AboutPage/about.mdx +38 -0
- package/site-templates/simple-service/content/en/ContactPage/contact.mdx +67 -0
- package/site-templates/simple-service/content/en/FAQPage/faq.mdx +56 -0
- package/site-templates/simple-service/content/en/HomePage/home.mdx +85 -0
- package/site-templates/simple-service/content/en/Service/landscape-design.mdx +40 -0
- package/site-templates/simple-service/content/en/Service/lawn-maintenance.mdx +40 -0
- package/site-templates/simple-service/content/en/Service/seasonal-cleanup.mdx +40 -0
- package/site-templates/simple-service/content/en/ServicesList/services.mdx +72 -0
- package/site-templates/simple-service/provenance.json +4 -0
- package/templates/.env.example +72 -7
- package/templates/CLAUDE.md +2 -3
- package/templates/DESIGN.md +155 -0
- package/templates/README.md +42 -8
- package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-31.552Z-fallback-1789916251590-037e9005.json +8 -0
- package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-33.840Z-fallback-1789916253842-b52659e9.json +12 -0
- package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-33.844Z-fallback-1789916253845-6b266f8c.json +12 -0
- package/templates/apps/api/.env.example +13 -0
- package/templates/apps/api/CLAUDE.md +26 -2
- package/templates/apps/api/jest.config.cjs +3 -0
- package/templates/apps/api/package.json +1 -0
- package/templates/apps/api/src/__tests__/commerce-claim-registration.test.ts +407 -0
- package/templates/apps/api/src/__tests__/module-exclusion.test.ts +83 -7
- package/templates/apps/api/src/__tests__/server.test.ts +471 -0
- package/templates/apps/api/src/__tests__/vercel-handler.test.ts +45 -0
- package/templates/apps/api/src/__tests__/workspace-module-registration.test.ts +2 -0
- package/templates/apps/api/src/config/index.ts +62 -0
- package/templates/apps/api/src/config/modules.ts +7 -3
- package/templates/apps/api/src/lib/__mocks__/prisma.ts +238 -2
- package/templates/apps/api/src/lib/__tests__/auth-email-budget.test.ts +143 -0
- package/templates/apps/api/src/lib/__tests__/content-adapter.test.ts +23 -0
- package/templates/apps/api/src/lib/__tests__/deliverable-asset-store.test.ts +125 -0
- package/templates/apps/api/src/lib/__tests__/error-serializer.test.ts +20 -0
- package/templates/apps/api/src/lib/__tests__/require-commerce-claim.test.ts +317 -0
- package/templates/apps/api/src/lib/__tests__/site.test.ts +238 -0
- package/templates/apps/api/src/lib/__tests__/stripe.test.ts +75 -0
- package/templates/apps/api/src/lib/auth-email-budget.ts +160 -0
- package/templates/apps/api/src/lib/content-adapter.ts +57 -31
- package/templates/apps/api/src/lib/deliverable-asset-store.ts +76 -0
- package/templates/apps/api/src/lib/error-serializer.ts +23 -3
- package/templates/apps/api/src/lib/outbound-http.ts +7 -2
- package/templates/apps/api/src/lib/require-commerce-claim.ts +250 -0
- package/templates/apps/api/src/lib/site.ts +208 -9
- package/templates/apps/api/src/lib/stripe.ts +66 -0
- package/templates/apps/api/src/middleware/__tests__/default-tenant.test.ts +182 -0
- package/templates/apps/api/src/middleware/__tests__/rate-limit.test.ts +42 -0
- package/templates/apps/api/src/middleware/rate-limit.ts +7 -1
- package/templates/apps/api/src/openapi/spec.ts +543 -2
- package/templates/apps/api/src/routes/auth/__tests__/auth-user.functional.test.ts +48 -0
- package/templates/apps/api/src/routes/auth/__tests__/transactional-email.test.ts +309 -0
- package/templates/apps/api/src/routes/auth/__tests__/user.test.ts +123 -0
- package/templates/apps/api/src/routes/auth/transactional-email.ts +273 -0
- package/templates/apps/api/src/routes/auth/user.ts +61 -0
- package/templates/apps/api/src/routes/checkout/__tests__/session.test.ts +434 -0
- package/templates/apps/api/src/routes/checkout/__tests__/sessions.test.ts +888 -0
- package/templates/apps/api/src/routes/checkout/index.ts +34 -0
- package/templates/apps/api/src/routes/checkout/session.ts +139 -0
- package/templates/apps/api/src/routes/checkout/sessions.ts +197 -0
- package/templates/apps/api/src/routes/content/__tests__/get-page.test.ts +554 -0
- package/templates/apps/api/src/routes/content/__tests__/list-pages.test.ts +108 -0
- package/templates/apps/api/src/routes/content/__tests__/search.test.ts +450 -0
- package/templates/apps/api/src/routes/content/get-page.ts +94 -12
- package/templates/apps/api/src/routes/content/index.ts +13 -73
- package/templates/apps/api/src/routes/content/list-pages.ts +15 -3
- package/templates/apps/api/src/routes/content/rate-limit.ts +15 -6
- package/templates/apps/api/src/routes/content/search.ts +129 -0
- package/templates/apps/api/src/routes/leads/__tests__/index.test.ts +447 -31
- package/templates/apps/api/src/routes/leads/index.ts +100 -13
- package/templates/apps/api/src/routes/project-listings/__tests__/configured-application.test.ts +51 -0
- package/templates/apps/api/src/routes/project-listings/__tests__/drafts.test.ts +351 -0
- package/templates/apps/api/src/routes/project-listings/__tests__/founder-identity.test.ts +51 -0
- package/templates/apps/api/src/routes/project-listings/__tests__/me.test.ts +5 -2
- package/templates/apps/api/src/routes/project-listings/__tests__/public.test.ts +4 -1
- package/templates/apps/api/src/routes/project-listings/__tests__/resume-email.test.ts +58 -0
- package/templates/apps/api/src/routes/project-listings/__tests__/site-answers.test.ts +107 -6
- package/templates/apps/api/src/routes/project-listings/__tests__/site-key.test.ts +87 -2
- package/templates/apps/api/src/routes/project-listings/__tests__/structured-address.test.ts +51 -0
- package/templates/apps/api/src/routes/project-listings/start.ts +5 -1
- package/templates/apps/api/src/routes/requests/__tests__/confirm.test.ts +686 -0
- package/templates/apps/api/src/routes/requests/confirm.ts +601 -0
- package/templates/apps/api/src/routes/requests/index.ts +54 -0
- package/templates/apps/api/src/routes/webhooks/README.md +265 -0
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-dunning.test.ts +749 -0
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-flow-checkout.test.ts +330 -0
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-idempotency.test.ts +262 -0
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-org-billing.test.ts +285 -0
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-rate-limit.test.ts +213 -0
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe-request-paid.test.ts +301 -0
- package/templates/apps/api/src/routes/webhooks/__tests__/stripe.test.ts +648 -0
- package/templates/apps/api/src/routes/webhooks/index.ts +89 -0
- package/templates/apps/api/src/routes/webhooks/stripe.ts +1399 -0
- package/templates/apps/api/src/server.ts +439 -49
- package/templates/apps/api/src/services/__tests__/abandon-email.test.ts +39 -0
- package/templates/apps/api/src/services/__tests__/aeo-score.test.ts +217 -40
- package/templates/apps/api/src/services/__tests__/audit-log.test.ts +620 -0
- package/templates/apps/api/src/services/__tests__/consent.test.ts +2 -0
- package/templates/apps/api/src/services/__tests__/deliverable-fulfillment.test.ts +300 -5
- package/templates/apps/api/src/services/__tests__/deliverable-resend.test.ts +20 -0
- package/templates/apps/api/src/services/__tests__/dunning-policy.test.ts +368 -0
- package/templates/apps/api/src/services/__tests__/lead-routing.test.ts +160 -0
- package/templates/apps/api/src/services/__tests__/listing-config.test.ts +166 -0
- package/templates/apps/api/src/services/__tests__/project-listings.fence.test.ts +154 -0
- package/templates/apps/api/src/services/__tests__/public-site-resolver.test.ts +137 -0
- package/templates/apps/api/src/services/__tests__/request-confirm.test.ts +444 -0
- package/templates/apps/api/src/services/__tests__/revalidation.test.ts +238 -0
- package/templates/apps/api/src/services/__tests__/verified-email.test.ts +78 -0
- package/templates/apps/api/src/services/abandon-email.ts +8 -2
- package/templates/apps/api/src/services/aeo-score.ts +49 -12
- package/templates/apps/api/src/services/audit-log.ts +668 -0
- package/templates/apps/api/src/services/consent.ts +18 -0
- package/templates/apps/api/src/services/default-tenant.ts +70 -31
- package/templates/apps/api/src/services/deliverable-fulfillment.ts +141 -13
- package/templates/apps/api/src/services/dunning-policy.ts +294 -0
- package/templates/apps/api/src/services/entitlements.ts +80 -0
- package/templates/apps/api/src/services/lead-promotion.ts +13 -14
- package/templates/apps/api/src/services/lead-routing.ts +161 -2
- package/templates/apps/api/src/services/leads-inbox.ts +23 -2
- package/templates/apps/api/src/services/listing-config.ts +27 -9
- package/templates/apps/api/src/services/project-listings.ts +201 -6
- package/templates/apps/api/src/services/public-site-resolver.ts +106 -0
- package/templates/apps/api/src/services/request-confirm.ts +646 -0
- package/templates/apps/api/src/services/revalidation.ts +173 -0
- package/templates/apps/api/src/services/verified-email.ts +71 -0
- package/templates/apps/api/src/vercel-handler.ts +75 -35
- package/templates/apps/mcp/.env.example +17 -0
- package/templates/apps/mcp/CLAUDE.md +57 -24
- package/templates/apps/mcp/__tests__/aeo-cli-parity.test.ts +6 -0
- package/templates/apps/mcp/__tests__/audit.test.ts +137 -8
- package/templates/apps/mcp/__tests__/catalog-drift.test.ts +79 -36
- package/templates/apps/mcp/__tests__/get_offerings.test.ts +111 -2
- package/templates/apps/mcp/__tests__/get_pricing.test.ts +82 -2
- package/templates/apps/mcp/__tests__/http-transport.test.ts +541 -2
- package/templates/apps/mcp/__tests__/index.test.ts +39 -0
- package/templates/apps/mcp/__tests__/lib/audit-single-page-readiness-scan.test.ts +143 -0
- package/templates/apps/mcp/__tests__/lib/commerce-claim.test.ts +111 -0
- package/templates/apps/mcp/__tests__/lib/content-adapter-parity.test.ts +65 -0
- package/templates/apps/mcp/__tests__/lib/content-adapter.test.ts +188 -0
- package/templates/apps/mcp/__tests__/lib/fail-closed-tools.test.ts +165 -0
- package/templates/apps/mcp/__tests__/lib/public-workspace.test.ts +124 -0
- package/templates/apps/mcp/__tests__/list_pages.test.ts +116 -0
- package/templates/apps/mcp/__tests__/module-exclusion.test.ts +7 -1
- package/templates/apps/mcp/__tests__/parity.test.ts +10 -7
- package/templates/apps/mcp/__tests__/purchase-disabled.test.ts +89 -22
- package/templates/apps/mcp/__tests__/read_content.test.ts +322 -1
- package/templates/apps/mcp/__tests__/search_content.test.ts +105 -2
- package/templates/apps/mcp/__tests__/server.test.ts +67 -14
- package/templates/apps/mcp/__tests__/start_purchase.test.ts +252 -0
- package/templates/apps/mcp/__tests__/tools/purchase.test.ts +300 -123
- package/templates/apps/mcp/jest.config.cjs +13 -0
- package/templates/apps/mcp/package.json +2 -0
- package/templates/apps/mcp/src/abuse/index.ts +159 -24
- package/templates/apps/mcp/src/config/modules.ts +10 -5
- package/templates/apps/mcp/src/http-transport.ts +102 -29
- package/templates/apps/mcp/src/index.ts +73 -11
- package/templates/apps/mcp/src/lib/audit-single-page.ts +90 -3
- package/templates/apps/mcp/src/lib/commerce-claim.ts +94 -0
- package/templates/apps/mcp/src/lib/content-adapter.ts +113 -0
- package/templates/apps/mcp/src/lib/empty-content-adapter.ts +139 -0
- package/templates/apps/mcp/src/lib/prisma.ts +39 -0
- package/templates/apps/mcp/src/lib/public-workspace.ts +133 -0
- package/templates/apps/mcp/src/lib/stripe-tax-signal.ts +59 -0
- package/templates/apps/mcp/src/server.ts +59 -35
- package/templates/apps/mcp/src/tools/audit.ts +26 -2
- package/templates/apps/mcp/src/tools/get_business_hours.ts +4 -3
- package/templates/apps/mcp/src/tools/get_faq.ts +4 -3
- package/templates/apps/mcp/src/tools/get_locations.ts +5 -3
- package/templates/apps/mcp/src/tools/get_offerings.ts +16 -4
- package/templates/apps/mcp/src/tools/get_pricing.ts +25 -6
- package/templates/apps/mcp/src/tools/get_site_info.ts +4 -3
- package/templates/apps/mcp/src/tools/index.ts +6 -4
- package/templates/apps/mcp/src/tools/list_pages.ts +4 -3
- package/templates/apps/mcp/src/tools/purchase.ts +128 -45
- package/templates/apps/mcp/src/tools/read_content.ts +20 -6
- package/templates/apps/mcp/src/tools/search_content.ts +11 -4
- package/templates/apps/web/.env.example +71 -5
- package/templates/apps/web/CLAUDE.md +44 -0
- package/templates/apps/web/PRODUCT.md +86 -0
- package/templates/apps/web/app/.well-known/mcp.json/build-manifest.ts +18 -2
- package/templates/apps/web/app/.well-known/mcp.json/route.ts +11 -3
- package/templates/apps/web/app/[locale]/(auth)/__tests__/auth-pages.test.tsx +282 -0
- package/templates/apps/web/app/[locale]/(auth)/__tests__/password-reset.test.tsx +515 -0
- package/templates/apps/web/app/[locale]/(auth)/forgot-password/forgot-password-card.tsx +89 -0
- package/templates/apps/web/app/[locale]/(auth)/forgot-password/page.tsx +109 -0
- package/templates/apps/web/app/[locale]/(auth)/layout.tsx +92 -0
- package/templates/apps/web/app/[locale]/(auth)/reset-password/page.tsx +135 -0
- package/templates/apps/web/app/[locale]/(auth)/reset-password/reset-password-card.tsx +109 -0
- package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/__tests__/page.test.tsx +48 -2
- package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/page.tsx +20 -6
- package/templates/apps/web/app/[locale]/(auth)/sign-in/sign-in-card.tsx +125 -0
- package/templates/apps/web/app/[locale]/(auth)/sign-up/page.tsx +96 -0
- package/templates/apps/web/app/[locale]/(auth)/sign-up/sign-up-card.tsx +101 -0
- package/templates/apps/web/app/[locale]/(auth)/use-auth-card-flow.ts +102 -0
- package/templates/apps/web/app/[locale]/(auth)/verify-email/page.tsx +87 -0
- package/templates/apps/web/app/[locale]/(authed)/__tests__/gate.test.tsx +20 -10
- package/templates/apps/web/app/[locale]/(authed)/account/__tests__/page.test.tsx +84 -0
- package/templates/apps/web/app/[locale]/(authed)/account/actions.ts +58 -0
- package/templates/apps/web/app/[locale]/(authed)/account/page.tsx +63 -8
- package/templates/apps/web/app/[locale]/(authed)/layout.tsx +18 -1
- package/templates/apps/web/app/[locale]/cancellation/page.tsx +44 -0
- package/templates/apps/web/app/[locale]/layout.tsx +133 -87
- package/templates/apps/web/app/[locale]/purchase/__tests__/cancel.test.tsx +162 -0
- package/templates/apps/web/app/[locale]/purchase/__tests__/module-scope.test.ts +68 -0
- package/templates/apps/web/app/[locale]/purchase/__tests__/success.test.tsx +361 -0
- package/templates/apps/web/app/[locale]/purchase/cancel/page.tsx +115 -0
- package/templates/apps/web/app/[locale]/purchase/success/page.tsx +307 -0
- package/templates/apps/web/app/[locale]/returns/page.tsx +44 -0
- package/templates/apps/web/app/[locale]/shipping/page.tsx +44 -0
- package/templates/apps/web/app/api/revalidate/__tests__/route.test.ts +670 -0
- package/templates/apps/web/app/api/revalidate/route.ts +194 -0
- package/templates/apps/web/auth.ts +407 -8
- package/templates/apps/web/jest.config.cjs +8 -4
- package/templates/apps/web/lib/__tests__/auth-email.test.ts +214 -0
- package/templates/apps/web/lib/__tests__/auth-routes.test.ts +74 -0
- package/templates/apps/web/lib/__tests__/meeting-slugs.test.ts +72 -0
- package/templates/apps/web/lib/__tests__/site-theme.test.ts +135 -20
- package/templates/apps/web/lib/__tests__/structured-data.test.tsx +18 -1
- package/templates/apps/web/lib/auth-email.ts +318 -0
- package/templates/apps/web/lib/auth-env.ts +85 -0
- package/templates/apps/web/lib/auth-routes.ts +55 -0
- package/templates/apps/web/lib/meeting-slugs.ts +53 -0
- package/templates/apps/web/lib/site-brand.tsx +4 -8
- package/templates/apps/web/lib/telemetry-scrub.ts +5 -1
- package/templates/apps/web/messages/en.json +187 -0
- package/templates/apps/web/middleware.ts +1 -1
- package/templates/apps/web/package.json +2 -1
- package/templates/apps/web/src/lib/commerce-claim.ts +33 -0
- package/templates/apps/web/src/lib/commerce-sections.ts +93 -0
- package/templates/content/_site.mdx +18 -3
- package/templates/content/en/CancellationPolicyPage/cancellation.mdx +108 -0
- package/templates/content/en/ReturnsPolicyPage/returns.mdx +108 -0
- package/templates/content/en/ShippingPolicyPage/shipping.mdx +108 -0
- package/templates/database/CHANGELOG.md +149 -0
- package/templates/database/README.md +10 -3
- package/templates/database/__tests__/appointment.db.test.ts +106 -0
- package/templates/database/__tests__/artifact-content-store.db.test.ts +316 -0
- package/templates/database/__tests__/composite-fence.db.test.ts +206 -0
- package/templates/database/__tests__/fence-fan-out.db.test.ts +711 -0
- package/templates/database/__tests__/fixtures/appointment-create-probe.ts +79 -0
- package/templates/database/__tests__/fixtures/project-listing-consent-probe.ts +100 -0
- package/templates/database/__tests__/flow-workspace-key.db.test.ts +263 -0
- package/templates/database/__tests__/prefixed-ids.db.test.ts +85 -9
- package/templates/database/__tests__/project-listing-consent-at.db.test.ts +111 -0
- package/templates/database/__tests__/tenancy.test.ts +141 -0
- package/templates/database/config/schema.prisma +79 -2
- package/templates/database/content/schema.prisma +87 -11
- package/templates/database/inbox/schema.prisma +452 -9
- package/templates/database/jest.config.cjs +5 -3
- package/templates/database/migrations/20260915120000_project_listing_solution/migration.sql +15 -0
- package/templates/database/migrations/20260916120000_artifact_content_store/migration.sql +158 -0
- package/templates/database/migrations/20260917120000_callback_request_confirm/migration.sql +40 -0
- package/templates/database/migrations/20260918120000_add_appointment/migration.sql +67 -0
- package/templates/database/migrations/20260918120000_asset_metadata_columns/migration.sql +70 -0
- package/templates/database/migrations/20260919120000_flow_workspace_key/migration.sql +181 -0
- package/templates/database/migrations/20260919130000_flow_definition_admin_columns/migration.sql +172 -0
- package/templates/database/migrations/20260919130000_workspace_meetings/migration.sql +41 -0
- package/templates/database/migrations/20260919140000_inbox_workspace_key/migration.sql +185 -0
- package/templates/database/migrations/20260920120000_lead_handled_at/migration.sql +70 -0
- package/templates/database/migrations/20260920130000_lead_workspace_source_index/migration.sql +57 -0
- package/templates/database/migrations/20260921120000_deliverable_grant_workspace_key/migration.sql +68 -0
- package/templates/database/migrations/20260922120000_tenancy_fence/migration.sql +1067 -0
- package/templates/database/migrations/20260923120000_listing_capturing_magnet/migration.sql +210 -0
- package/templates/database/package.json +3 -2
- package/templates/database/tenancy.ts +86 -1
- package/templates/database/tsconfig.json +1 -0
- package/versions.json +34 -34
- package/templates/apps/api/src/routes/content/__tests__/create.test.ts +0 -253
- package/templates/apps/api/src/routes/content/__tests__/delete.test.ts +0 -215
- package/templates/apps/api/src/routes/content/__tests__/update.test.ts +0 -266
- package/templates/apps/api/src/routes/content/create.ts +0 -115
- package/templates/apps/api/src/routes/content/delete.ts +0 -82
- package/templates/apps/api/src/routes/content/update.ts +0 -112
- package/templates/apps/mcp/__tests__/create_page.test.ts +0 -202
- package/templates/apps/mcp/__tests__/delete_page.test.ts +0 -177
- package/templates/apps/mcp/__tests__/update_page.test.ts +0 -196
- package/templates/apps/mcp/src/tools/create_page.ts +0 -96
- package/templates/apps/mcp/src/tools/delete_page.ts +0 -74
- package/templates/apps/mcp/src/tools/update_page.ts +0 -92
- package/templates/apps/web/app/[locale]/sign-in/sign-in-card.tsx +0 -123
- package/templates/apps/web/public/logo-dark.svg +0 -21
- package/templates/apps/web/public/logo-light.svg +0 -21
- /package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/__tests__/next-path.test.ts +0 -0
- /package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/next-path.ts +0 -0
|
@@ -0,0 +1,330 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* POST /api/webhooks/stripe — the recommender FlowCheckout stamp (#4838).
|
|
3
|
+
*
|
|
4
|
+
* The stripe.test.ts mock shape: `@working-theory/analytics/server` `track`,
|
|
5
|
+
* the prisma auto-mock, `@working-theory/stripe-client`'s
|
|
6
|
+
* `verifyWebhookSignature` at the package boundary. AC-1 … AC-5. The four
|
|
7
|
+
* pre-existing webhook suites are the regression floor and are not edited.
|
|
8
|
+
* AC-6 (#4862) adds the `no_payment_required` (zero-due) case.
|
|
9
|
+
*/
|
|
10
|
+
import type { FastifyInstance } from "fastify";
|
|
11
|
+
import Fastify from "fastify";
|
|
12
|
+
|
|
13
|
+
const mockTrack = jest.fn().mockResolvedValue(undefined);
|
|
14
|
+
// Commerce claim (D-64, #5796): the receiver is a base-tree primitive gated on
|
|
15
|
+
// the JWT `commerce` claim, so every case in this file is a COMMERCE-CLAIMED
|
|
16
|
+
// deployment — which is what each one was already asserting before the gate
|
|
17
|
+
// existed. The unclaimed matrix lives in
|
|
18
|
+
// `src/__tests__/commerce-claim-registration.test.ts`.
|
|
19
|
+
jest.mock("@working-theory/license", () => ({
|
|
20
|
+
checkLicense: jest.fn().mockResolvedValue({
|
|
21
|
+
tier: "pro",
|
|
22
|
+
plan: "pro-monthly",
|
|
23
|
+
features: ["commerce"],
|
|
24
|
+
expiresAt: null,
|
|
25
|
+
revoked: false,
|
|
26
|
+
}),
|
|
27
|
+
}));
|
|
28
|
+
|
|
29
|
+
jest.mock("@working-theory/analytics/server", () => ({
|
|
30
|
+
track: (...args: unknown[]) => mockTrack(...args),
|
|
31
|
+
}));
|
|
32
|
+
|
|
33
|
+
// eslint-disable-next-line no-restricted-syntax -- lib/prisma.ts wraps the external DB boundary (PrismaClient requires a live connection); __mocks__/prisma.ts is the repo-standard test double for this boundary.
|
|
34
|
+
jest.mock("../../../lib/prisma.js");
|
|
35
|
+
|
|
36
|
+
const mockVerifyWebhookSignature = jest.fn();
|
|
37
|
+
class MockStripeWebhookSignatureError extends Error {
|
|
38
|
+
constructor(message: string) {
|
|
39
|
+
super(message);
|
|
40
|
+
this.name = "StripeWebhookSignatureError";
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
jest.mock("@working-theory/stripe-client", () => ({
|
|
44
|
+
verifyWebhookSignature: (...args: unknown[]) => mockVerifyWebhookSignature(...args),
|
|
45
|
+
StripeWebhookSignatureError: MockStripeWebhookSignatureError,
|
|
46
|
+
assertSandboxKey: jest.fn(),
|
|
47
|
+
createCheckoutSession: jest.fn(),
|
|
48
|
+
getStripeClient: jest.fn(),
|
|
49
|
+
STRIPE_API_VERSION: "2024-06-20",
|
|
50
|
+
StripeConfigError: class StripeConfigError extends Error {},
|
|
51
|
+
UnknownProductCodeError: class UnknownProductCodeError extends Error {},
|
|
52
|
+
WEBHOOK_TOLERANCE_SECONDS: 300,
|
|
53
|
+
}));
|
|
54
|
+
|
|
55
|
+
import * as configModule from "../../../config/index.js";
|
|
56
|
+
import { stripeWebhookHandler } from "../stripe.js";
|
|
57
|
+
import { __resetIdempotencyStore } from "../../../lib/webhook-idempotency.js";
|
|
58
|
+
import { prisma } from "../../../lib/prisma.js";
|
|
59
|
+
|
|
60
|
+
// ── Helpers ──────────────────────────────────────────────────────────────────
|
|
61
|
+
|
|
62
|
+
const FLOW_CHECKOUT_ID = "flchk_test_1";
|
|
63
|
+
const SESSION_ID = "cs_test_session_12345678901234567890";
|
|
64
|
+
const CUSTOMER_ID = "cus_test_12345678901234567890";
|
|
65
|
+
const EMAIL = "alice@example.com";
|
|
66
|
+
const PERMALINK = "eyJ2ZXJzaW9uIjoxLCJmbG93U2x1ZyI6ImFpbGstcmVjbyJ9";
|
|
67
|
+
|
|
68
|
+
function sessionEvent(type: "checkout.session.completed" | "checkout.session.expired", object: Record<string, unknown> = {}) {
|
|
69
|
+
return {
|
|
70
|
+
id: "evt_test_12345678abcdef",
|
|
71
|
+
type,
|
|
72
|
+
data: {
|
|
73
|
+
object: {
|
|
74
|
+
id: SESSION_ID,
|
|
75
|
+
payment_status: "paid",
|
|
76
|
+
amount_total: 24900,
|
|
77
|
+
currency: "usd",
|
|
78
|
+
customer: CUSTOMER_ID,
|
|
79
|
+
customer_details: { email: EMAIL },
|
|
80
|
+
metadata: { flowCheckoutId: FLOW_CHECKOUT_ID, flowSlug: "ailk-reco", offerKey: "pro", permalink: PERMALINK },
|
|
81
|
+
...object,
|
|
82
|
+
},
|
|
83
|
+
},
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
type LogCall = [unknown, string?];
|
|
88
|
+
const logCalls: LogCall[] = [];
|
|
89
|
+
|
|
90
|
+
async function buildTestServer(): Promise<FastifyInstance> {
|
|
91
|
+
const server = Fastify({ logger: false });
|
|
92
|
+
await server.register(async (webhooksScope) => {
|
|
93
|
+
webhooksScope.addContentTypeParser("application/json", { parseAs: "buffer" }, (_req, body, done) => {
|
|
94
|
+
done(null, body);
|
|
95
|
+
});
|
|
96
|
+
webhooksScope.addHook("onRequest", async (request) => {
|
|
97
|
+
for (const level of ["info", "warn", "error"] as const) {
|
|
98
|
+
const original = request.log[level].bind(request.log);
|
|
99
|
+
request.log[level] = ((...args: unknown[]) => {
|
|
100
|
+
logCalls.push(args as LogCall);
|
|
101
|
+
return (original as (...a: unknown[]) => void)(...args);
|
|
102
|
+
}) as typeof request.log.info;
|
|
103
|
+
}
|
|
104
|
+
});
|
|
105
|
+
webhooksScope.post("/v1/webhooks/stripe", stripeWebhookHandler);
|
|
106
|
+
});
|
|
107
|
+
await server.ready();
|
|
108
|
+
return server;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
const VALID_BODY = Buffer.from(JSON.stringify({ type: "test" }));
|
|
112
|
+
const HEADERS = { "content-type": "application/json", "stripe-signature": "t=1234,v1=abc" };
|
|
113
|
+
|
|
114
|
+
let server: FastifyInstance;
|
|
115
|
+
|
|
116
|
+
beforeEach(async () => {
|
|
117
|
+
jest.clearAllMocks();
|
|
118
|
+
logCalls.length = 0;
|
|
119
|
+
__resetIdempotencyStore();
|
|
120
|
+
jest.replaceProperty(configModule, "config", {
|
|
121
|
+
...configModule.config,
|
|
122
|
+
STRIPE_WEBHOOK_SECRET: "whsec_test_secret",
|
|
123
|
+
});
|
|
124
|
+
(prisma.flowCheckout.findUnique as jest.Mock).mockResolvedValue({ amountMinor: 24900 });
|
|
125
|
+
(prisma.flowCheckout.updateMany as jest.Mock).mockResolvedValue({ count: 1 });
|
|
126
|
+
(prisma.user.findFirst as jest.Mock).mockResolvedValue(null);
|
|
127
|
+
(prisma.user.findUnique as jest.Mock).mockResolvedValue(null);
|
|
128
|
+
server = await buildTestServer();
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
afterEach(async () => {
|
|
132
|
+
await server.close();
|
|
133
|
+
jest.restoreAllMocks();
|
|
134
|
+
});
|
|
135
|
+
|
|
136
|
+
async function post() {
|
|
137
|
+
return server.inject({ method: "POST", url: "/v1/webhooks/stripe", payload: VALID_BODY, headers: HEADERS });
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
function stampCall() {
|
|
141
|
+
expect(prisma.flowCheckout.updateMany).toHaveBeenCalledTimes(1);
|
|
142
|
+
return (prisma.flowCheckout.updateMany as jest.Mock).mock.calls[0][0];
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
// ── AC-1 — completed stamps the row once, guarded, beside the legacy tasks ──
|
|
146
|
+
|
|
147
|
+
describe("AC-1 — completed stamps the row once, guarded, beside the legacy tasks", () => {
|
|
148
|
+
it("stamps completed with the guard, the session id and the customer; telemetry + billing still run", async () => {
|
|
149
|
+
mockVerifyWebhookSignature.mockReturnValue(sessionEvent("checkout.session.completed"));
|
|
150
|
+
const res = await post();
|
|
151
|
+
expect(res.statusCode).toBe(200);
|
|
152
|
+
expect(JSON.parse(res.body)).toEqual({ received: true });
|
|
153
|
+
|
|
154
|
+
const call = stampCall();
|
|
155
|
+
expect(call.where).toEqual({ id: FLOW_CHECKOUT_ID, status: "created" });
|
|
156
|
+
expect(call.data.status).toBe("completed");
|
|
157
|
+
expect(call.data.completedAt).toBeInstanceOf(Date);
|
|
158
|
+
expect(call.data.stripeSessionId).toBe(SESSION_ID);
|
|
159
|
+
expect(call.data.stripeCustomerId).toBe(CUSTOMER_ID);
|
|
160
|
+
|
|
161
|
+
// The legacy tasks, exactly as stripe.test.ts asserts them.
|
|
162
|
+
expect(mockTrack).toHaveBeenCalledTimes(1);
|
|
163
|
+
expect(mockTrack).toHaveBeenCalledWith("purchase-completed", {
|
|
164
|
+
amount: 24900,
|
|
165
|
+
currency: "usd",
|
|
166
|
+
productId: undefined,
|
|
167
|
+
eventType: "checkout.session.completed",
|
|
168
|
+
eventIdPrefix: "evt_test",
|
|
169
|
+
});
|
|
170
|
+
expect(prisma.user.findFirst).toHaveBeenCalledWith({
|
|
171
|
+
where: { billingProvider: "stripe", billingCustomerId: CUSTOMER_ID },
|
|
172
|
+
});
|
|
173
|
+
expect(prisma.user.findUnique).toHaveBeenCalledWith({ where: { email: EMAIL } });
|
|
174
|
+
});
|
|
175
|
+
});
|
|
176
|
+
|
|
177
|
+
// ── AC-2 — expired stamps expired ───────────────────────────────────────────
|
|
178
|
+
|
|
179
|
+
describe("AC-2 — expired stamps expired", () => {
|
|
180
|
+
it("stamps status expired under the same guard, with no completedAt", async () => {
|
|
181
|
+
mockVerifyWebhookSignature.mockReturnValue(sessionEvent("checkout.session.expired"));
|
|
182
|
+
const res = await post();
|
|
183
|
+
expect(res.statusCode).toBe(200);
|
|
184
|
+
const call = stampCall();
|
|
185
|
+
expect(call.where.status).toBe("created");
|
|
186
|
+
expect(call.where.id).toBe(FLOW_CHECKOUT_ID);
|
|
187
|
+
expect(call.data).toEqual({ status: "expired" });
|
|
188
|
+
expect(call.data).not.toHaveProperty("completedAt");
|
|
189
|
+
expect(prisma.flowCheckout.findUnique).not.toHaveBeenCalled();
|
|
190
|
+
expect(mockTrack).not.toHaveBeenCalled();
|
|
191
|
+
});
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
// ── AC-3 — the legacy paths are byte-unchanged ──────────────────────────────
|
|
195
|
+
|
|
196
|
+
describe("AC-3 — the legacy paths are byte-unchanged", () => {
|
|
197
|
+
it("an event without flowCheckoutId never touches prisma.flowCheckout", async () => {
|
|
198
|
+
mockVerifyWebhookSignature.mockReturnValue(
|
|
199
|
+
sessionEvent("checkout.session.completed", { metadata: { productId: "starter" } }),
|
|
200
|
+
);
|
|
201
|
+
const res = await post();
|
|
202
|
+
expect(res.statusCode).toBe(200);
|
|
203
|
+
expect(prisma.flowCheckout.findUnique).not.toHaveBeenCalled();
|
|
204
|
+
expect(prisma.flowCheckout.updateMany).not.toHaveBeenCalled();
|
|
205
|
+
expect(mockTrack).toHaveBeenCalledTimes(1);
|
|
206
|
+
});
|
|
207
|
+
|
|
208
|
+
it("an expired event without the key is a no-op 200 that logs the unhandled-event line", async () => {
|
|
209
|
+
mockVerifyWebhookSignature.mockReturnValue(sessionEvent("checkout.session.expired", { metadata: null }));
|
|
210
|
+
expect((await post()).statusCode).toBe(200);
|
|
211
|
+
expect(prisma.flowCheckout.updateMany).not.toHaveBeenCalled();
|
|
212
|
+
const unhandled = logCalls.find((c) => c[1] === "unhandled webhook event");
|
|
213
|
+
expect(unhandled?.[0]).toEqual({ eventType: "checkout.session.expired", eventIdPrefix: "evt_test" });
|
|
214
|
+
});
|
|
215
|
+
|
|
216
|
+
it("a completed session that is not paid logs `unpaid` and does NOT stamp — the row stays created", async () => {
|
|
217
|
+
mockVerifyWebhookSignature.mockReturnValue(
|
|
218
|
+
sessionEvent("checkout.session.completed", { payment_status: "unpaid" }),
|
|
219
|
+
);
|
|
220
|
+
expect((await post()).statusCode).toBe(200);
|
|
221
|
+
expect(prisma.flowCheckout.findUnique).not.toHaveBeenCalled();
|
|
222
|
+
expect(prisma.flowCheckout.updateMany).not.toHaveBeenCalled();
|
|
223
|
+
const unpaid = logCalls.find((c) => (c[0] as { outcome?: string })?.outcome === "unpaid");
|
|
224
|
+
expect(unpaid?.[0]).toEqual({
|
|
225
|
+
eventIdPrefix: "evt_test",
|
|
226
|
+
flowCheckoutIdPrefix: FLOW_CHECKOUT_ID.substring(0, 8),
|
|
227
|
+
outcome: "unpaid",
|
|
228
|
+
});
|
|
229
|
+
// The legacy tasks still ran for the event.
|
|
230
|
+
expect(mockTrack).toHaveBeenCalledTimes(1);
|
|
231
|
+
});
|
|
232
|
+
});
|
|
233
|
+
|
|
234
|
+
// ── AC-6 — a zero-due (no_payment_required) session stamps completed ───────
|
|
235
|
+
|
|
236
|
+
describe("AC-6 — no_payment_required stamps completed exactly as paid (#4862)", () => {
|
|
237
|
+
it("stamps completed with the guard, the session id and the customer; telemetry + billing still run", async () => {
|
|
238
|
+
mockVerifyWebhookSignature.mockReturnValue(
|
|
239
|
+
sessionEvent("checkout.session.completed", { payment_status: "no_payment_required" }),
|
|
240
|
+
);
|
|
241
|
+
const res = await post();
|
|
242
|
+
expect(res.statusCode).toBe(200);
|
|
243
|
+
expect(JSON.parse(res.body)).toEqual({ received: true });
|
|
244
|
+
|
|
245
|
+
const call = stampCall();
|
|
246
|
+
expect(call.where).toEqual({ id: FLOW_CHECKOUT_ID, status: "created" });
|
|
247
|
+
expect(call.data.status).toBe("completed");
|
|
248
|
+
expect(call.data.completedAt).toBeInstanceOf(Date);
|
|
249
|
+
expect(call.data.stripeSessionId).toBe(SESSION_ID);
|
|
250
|
+
expect(call.data.stripeCustomerId).toBe(CUSTOMER_ID);
|
|
251
|
+
|
|
252
|
+
expect(mockTrack).toHaveBeenCalledTimes(1);
|
|
253
|
+
const unpaid = logCalls.find((c) => (c[0] as { outcome?: string })?.outcome === "unpaid");
|
|
254
|
+
expect(unpaid).toBeUndefined();
|
|
255
|
+
});
|
|
256
|
+
});
|
|
257
|
+
|
|
258
|
+
// ── AC-4 — never a retry storm ──────────────────────────────────────────────
|
|
259
|
+
|
|
260
|
+
describe("AC-4 — never a retry storm", () => {
|
|
261
|
+
it("count 0 logs stale_or_unknown and still 200s", async () => {
|
|
262
|
+
(prisma.flowCheckout.updateMany as jest.Mock).mockResolvedValue({ count: 0 });
|
|
263
|
+
mockVerifyWebhookSignature.mockReturnValue(sessionEvent("checkout.session.completed"));
|
|
264
|
+
expect((await post()).statusCode).toBe(200);
|
|
265
|
+
const stale = logCalls.find((c) => (c[0] as { outcome?: string })?.outcome === "stale_or_unknown");
|
|
266
|
+
expect(stale).toBeDefined();
|
|
267
|
+
});
|
|
268
|
+
|
|
269
|
+
it("an updateMany rejection logs an error and still 200s", async () => {
|
|
270
|
+
(prisma.flowCheckout.updateMany as jest.Mock).mockRejectedValue(new Error("db down"));
|
|
271
|
+
mockVerifyWebhookSignature.mockReturnValue(sessionEvent("checkout.session.completed"));
|
|
272
|
+
expect((await post()).statusCode).toBe(200);
|
|
273
|
+
const failed = logCalls.find((c) => (c[0] as { outcome?: string })?.outcome === "stamp_failed");
|
|
274
|
+
expect(failed).toBeDefined();
|
|
275
|
+
});
|
|
276
|
+
|
|
277
|
+
it("a charged amount that differs from the quote logs both integers and STILL stamps completed", async () => {
|
|
278
|
+
mockVerifyWebhookSignature.mockReturnValue(sessionEvent("checkout.session.completed", { amount_total: 25000 }));
|
|
279
|
+
expect((await post()).statusCode).toBe(200);
|
|
280
|
+
const mismatch = logCalls.find((c) => (c[0] as { outcome?: string })?.outcome === "amount_mismatch");
|
|
281
|
+
expect(mismatch?.[0]).toEqual({
|
|
282
|
+
eventIdPrefix: "evt_test",
|
|
283
|
+
flowCheckoutIdPrefix: FLOW_CHECKOUT_ID.substring(0, 8),
|
|
284
|
+
outcome: "amount_mismatch",
|
|
285
|
+
expected: 24900,
|
|
286
|
+
received: 25000,
|
|
287
|
+
});
|
|
288
|
+
expect(stampCall().data.status).toBe("completed");
|
|
289
|
+
});
|
|
290
|
+
});
|
|
291
|
+
|
|
292
|
+
// ── AC-5 — PII boundary ─────────────────────────────────────────────────────
|
|
293
|
+
|
|
294
|
+
describe("AC-5 — PII boundary", () => {
|
|
295
|
+
it.each([
|
|
296
|
+
["the AC-1 event", sessionEvent("checkout.session.completed"), null],
|
|
297
|
+
["the AC-4 mismatch event", sessionEvent("checkout.session.completed", { amount_total: 25000 }), null],
|
|
298
|
+
[
|
|
299
|
+
"the stamp_failed branch",
|
|
300
|
+
sessionEvent("checkout.session.completed"),
|
|
301
|
+
new Error(`connection refused for ${EMAIL} at ${CUSTOMER_ID}`),
|
|
302
|
+
],
|
|
303
|
+
])("every log line for %s carries no email, customer_details, permalink, or a full cus_/cs_ id", async (_name, event, rejection) => {
|
|
304
|
+
if (rejection) (prisma.flowCheckout.updateMany as jest.Mock).mockRejectedValue(rejection);
|
|
305
|
+
mockVerifyWebhookSignature.mockReturnValue(event);
|
|
306
|
+
expect((await post()).statusCode).toBe(200);
|
|
307
|
+
const ALLOWED = new Set(["eventIdPrefix", "flowCheckoutIdPrefix", "outcome", "expected", "received", "errName"]);
|
|
308
|
+
const stampLines = logCalls.filter((c) => typeof c[0] === "object" && c[0] !== null && "flowCheckoutIdPrefix" in c[0]);
|
|
309
|
+
expect(stampLines.length).toBeGreaterThan(0);
|
|
310
|
+
for (const line of stampLines) {
|
|
311
|
+
for (const key of Object.keys(line[0] as object)) expect(ALLOWED.has(key)).toBe(true);
|
|
312
|
+
}
|
|
313
|
+
if (rejection) {
|
|
314
|
+
const failed = stampLines.find((c) => (c[0] as { outcome?: string }).outcome === "stamp_failed");
|
|
315
|
+
expect(failed?.[0]).toEqual({
|
|
316
|
+
eventIdPrefix: "evt_test",
|
|
317
|
+
flowCheckoutIdPrefix: FLOW_CHECKOUT_ID.substring(0, 8),
|
|
318
|
+
outcome: "stamp_failed",
|
|
319
|
+
errName: "Error",
|
|
320
|
+
});
|
|
321
|
+
}
|
|
322
|
+
for (const line of logCalls) {
|
|
323
|
+
const text = JSON.stringify(line);
|
|
324
|
+
expect(text).not.toContain(EMAIL);
|
|
325
|
+
expect(text).not.toContain("customer_details");
|
|
326
|
+
expect(text).not.toContain(PERMALINK);
|
|
327
|
+
for (const token of text.match(/\b(?:cus|cs)_[A-Za-z0-9_]+/g) ?? []) expect(token.length).toBeLessThanOrEqual(8);
|
|
328
|
+
}
|
|
329
|
+
});
|
|
330
|
+
});
|
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Stripe webhook idempotency — replay protection at the AILK layer.
|
|
3
|
+
*
|
|
4
|
+
* Stripe guarantees at-least-once delivery; an `event.id` can arrive multiple
|
|
5
|
+
* times (network retries, dashboard manual replay). The handler MUST be
|
|
6
|
+
* idempotent: a second arrival with the same `event.id` returns 200 without
|
|
7
|
+
* re-firing telemetry or any side effect.
|
|
8
|
+
*
|
|
9
|
+
* Implementation: module-scoped store with TTL — see
|
|
10
|
+
* `apps/api/src/lib/webhook-idempotency.ts` for the deliberate single-replica
|
|
11
|
+
* trade-off vs. a durable table.
|
|
12
|
+
*/
|
|
13
|
+
import type { FastifyInstance } from "fastify";
|
|
14
|
+
import Fastify from "fastify";
|
|
15
|
+
|
|
16
|
+
// ── Mocks ────────────────────────────────────────────────────────────────────
|
|
17
|
+
|
|
18
|
+
const mockConfig: { STRIPE_WEBHOOK_SECRET: string | undefined } = {
|
|
19
|
+
STRIPE_WEBHOOK_SECRET: "whsec_test_secret",
|
|
20
|
+
};
|
|
21
|
+
// eslint-disable-next-line no-restricted-syntax -- mirrors stripe.test.ts mock pattern
|
|
22
|
+
jest.mock("../../../config/index.js", () => ({
|
|
23
|
+
get config() {
|
|
24
|
+
return mockConfig;
|
|
25
|
+
},
|
|
26
|
+
}));
|
|
27
|
+
|
|
28
|
+
const mockTrack = jest.fn().mockResolvedValue(undefined);
|
|
29
|
+
// Commerce claim (D-64, #5796): the receiver is a base-tree primitive gated on
|
|
30
|
+
// the JWT `commerce` claim, so every case in this file is a COMMERCE-CLAIMED
|
|
31
|
+
// deployment — which is what each one was already asserting before the gate
|
|
32
|
+
// existed. The unclaimed matrix lives in
|
|
33
|
+
// `src/__tests__/commerce-claim-registration.test.ts`.
|
|
34
|
+
jest.mock("@working-theory/license", () => ({
|
|
35
|
+
checkLicense: jest.fn().mockResolvedValue({
|
|
36
|
+
tier: "pro",
|
|
37
|
+
plan: "pro-monthly",
|
|
38
|
+
features: ["commerce"],
|
|
39
|
+
expiresAt: null,
|
|
40
|
+
revoked: false,
|
|
41
|
+
}),
|
|
42
|
+
}));
|
|
43
|
+
|
|
44
|
+
jest.mock("@working-theory/analytics/server", () => ({
|
|
45
|
+
track: (...args: unknown[]) => mockTrack(...args),
|
|
46
|
+
}));
|
|
47
|
+
|
|
48
|
+
const mockVerifyWebhookSignature = jest.fn();
|
|
49
|
+
class MockStripeWebhookSignatureError extends Error {
|
|
50
|
+
constructor(message: string) {
|
|
51
|
+
super(message);
|
|
52
|
+
this.name = "StripeWebhookSignatureError";
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
// eslint-disable-next-line no-restricted-syntax -- mirrors stripe.test.ts mock pattern
|
|
56
|
+
jest.mock("../../../lib/stripe.js", () => ({
|
|
57
|
+
verifyWebhookSignature: (...args: unknown[]) =>
|
|
58
|
+
mockVerifyWebhookSignature(...args),
|
|
59
|
+
StripeWebhookSignatureError: MockStripeWebhookSignatureError,
|
|
60
|
+
}));
|
|
61
|
+
|
|
62
|
+
import { stripeWebhookHandler } from "../stripe.js";
|
|
63
|
+
import { __resetIdempotencyStore } from "../../../lib/webhook-idempotency.js";
|
|
64
|
+
|
|
65
|
+
// ── Helpers ──────────────────────────────────────────────────────────────────
|
|
66
|
+
|
|
67
|
+
function buildFakeEvent(id: string, overrides: Record<string, unknown> = {}) {
|
|
68
|
+
return {
|
|
69
|
+
id,
|
|
70
|
+
type: "checkout.session.completed",
|
|
71
|
+
data: {
|
|
72
|
+
object: {
|
|
73
|
+
amount_total: 4999,
|
|
74
|
+
currency: "usd",
|
|
75
|
+
metadata: { productId: "starter" },
|
|
76
|
+
},
|
|
77
|
+
},
|
|
78
|
+
...overrides,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
async function buildTestServer(): Promise<FastifyInstance> {
|
|
83
|
+
const server = Fastify({ logger: false });
|
|
84
|
+
|
|
85
|
+
await server.register(async (webhooksScope) => {
|
|
86
|
+
webhooksScope.addContentTypeParser(
|
|
87
|
+
"application/json",
|
|
88
|
+
{ parseAs: "buffer" },
|
|
89
|
+
(_req, body, done) => {
|
|
90
|
+
done(null, body);
|
|
91
|
+
},
|
|
92
|
+
);
|
|
93
|
+
webhooksScope.post("/v1/webhooks/stripe", stripeWebhookHandler);
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
await server.ready();
|
|
97
|
+
return server;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
const VALID_BODY = Buffer.from(JSON.stringify({ type: "test" }));
|
|
101
|
+
const VALID_SIGNATURE = "t=1234,v1=abc";
|
|
102
|
+
|
|
103
|
+
// ── Tests ────────────────────────────────────────────────────────────────────
|
|
104
|
+
|
|
105
|
+
describe("POST /api/webhooks/stripe — idempotency", () => {
|
|
106
|
+
let server: FastifyInstance;
|
|
107
|
+
|
|
108
|
+
beforeEach(async () => {
|
|
109
|
+
jest.clearAllMocks();
|
|
110
|
+
__resetIdempotencyStore();
|
|
111
|
+
mockConfig.STRIPE_WEBHOOK_SECRET = "whsec_test_secret";
|
|
112
|
+
server = await buildTestServer();
|
|
113
|
+
});
|
|
114
|
+
|
|
115
|
+
afterEach(async () => {
|
|
116
|
+
await server.close();
|
|
117
|
+
});
|
|
118
|
+
|
|
119
|
+
it("processes a first-time event normally (200 + track called)", async () => {
|
|
120
|
+
const event = buildFakeEvent("evt_first_time_aaaa");
|
|
121
|
+
mockVerifyWebhookSignature.mockReturnValue(event);
|
|
122
|
+
|
|
123
|
+
const response = await server.inject({
|
|
124
|
+
method: "POST",
|
|
125
|
+
url: "/v1/webhooks/stripe",
|
|
126
|
+
payload: VALID_BODY,
|
|
127
|
+
headers: {
|
|
128
|
+
"content-type": "application/json",
|
|
129
|
+
"stripe-signature": VALID_SIGNATURE,
|
|
130
|
+
},
|
|
131
|
+
});
|
|
132
|
+
|
|
133
|
+
expect(response.statusCode).toBe(200);
|
|
134
|
+
expect(JSON.parse(response.body)).toEqual({ received: true });
|
|
135
|
+
expect(mockTrack).toHaveBeenCalledTimes(1);
|
|
136
|
+
});
|
|
137
|
+
|
|
138
|
+
it("returns 200 on replay of same event.id without re-firing telemetry", async () => {
|
|
139
|
+
const event = buildFakeEvent("evt_replay_same_id_bbbb");
|
|
140
|
+
mockVerifyWebhookSignature.mockReturnValue(event);
|
|
141
|
+
|
|
142
|
+
// First delivery — processed normally
|
|
143
|
+
const first = await server.inject({
|
|
144
|
+
method: "POST",
|
|
145
|
+
url: "/v1/webhooks/stripe",
|
|
146
|
+
payload: VALID_BODY,
|
|
147
|
+
headers: {
|
|
148
|
+
"content-type": "application/json",
|
|
149
|
+
"stripe-signature": VALID_SIGNATURE,
|
|
150
|
+
},
|
|
151
|
+
});
|
|
152
|
+
|
|
153
|
+
expect(first.statusCode).toBe(200);
|
|
154
|
+
expect(mockTrack).toHaveBeenCalledTimes(1);
|
|
155
|
+
|
|
156
|
+
// Second delivery — same event.id, should be treated as duplicate
|
|
157
|
+
const second = await server.inject({
|
|
158
|
+
method: "POST",
|
|
159
|
+
url: "/v1/webhooks/stripe",
|
|
160
|
+
payload: VALID_BODY,
|
|
161
|
+
headers: {
|
|
162
|
+
"content-type": "application/json",
|
|
163
|
+
"stripe-signature": VALID_SIGNATURE,
|
|
164
|
+
},
|
|
165
|
+
});
|
|
166
|
+
|
|
167
|
+
expect(second.statusCode).toBe(200);
|
|
168
|
+
expect(JSON.parse(second.body)).toEqual({ received: true });
|
|
169
|
+
// Telemetry must NOT have fired again
|
|
170
|
+
expect(mockTrack).toHaveBeenCalledTimes(1);
|
|
171
|
+
});
|
|
172
|
+
|
|
173
|
+
it("processes distinct event.ids independently", async () => {
|
|
174
|
+
const eventA = buildFakeEvent("evt_distinct_aaaa");
|
|
175
|
+
const eventB = buildFakeEvent("evt_distinct_bbbb");
|
|
176
|
+
|
|
177
|
+
mockVerifyWebhookSignature.mockReturnValueOnce(eventA);
|
|
178
|
+
await server.inject({
|
|
179
|
+
method: "POST",
|
|
180
|
+
url: "/v1/webhooks/stripe",
|
|
181
|
+
payload: VALID_BODY,
|
|
182
|
+
headers: {
|
|
183
|
+
"content-type": "application/json",
|
|
184
|
+
"stripe-signature": VALID_SIGNATURE,
|
|
185
|
+
},
|
|
186
|
+
});
|
|
187
|
+
|
|
188
|
+
mockVerifyWebhookSignature.mockReturnValueOnce(eventB);
|
|
189
|
+
await server.inject({
|
|
190
|
+
method: "POST",
|
|
191
|
+
url: "/v1/webhooks/stripe",
|
|
192
|
+
payload: VALID_BODY,
|
|
193
|
+
headers: {
|
|
194
|
+
"content-type": "application/json",
|
|
195
|
+
"stripe-signature": VALID_SIGNATURE,
|
|
196
|
+
},
|
|
197
|
+
});
|
|
198
|
+
|
|
199
|
+
expect(mockTrack).toHaveBeenCalledTimes(2);
|
|
200
|
+
});
|
|
201
|
+
|
|
202
|
+
it("logs duplicate detection at info level on replay", async () => {
|
|
203
|
+
const event = buildFakeEvent("evt_logs_duplicate_cccc");
|
|
204
|
+
mockVerifyWebhookSignature.mockReturnValue(event);
|
|
205
|
+
|
|
206
|
+
const logLines: Array<Record<string, unknown>> = [];
|
|
207
|
+
const logCapture = Fastify({
|
|
208
|
+
logger: {
|
|
209
|
+
level: "info",
|
|
210
|
+
stream: {
|
|
211
|
+
write(msg: string) {
|
|
212
|
+
logLines.push(JSON.parse(msg) as Record<string, unknown>);
|
|
213
|
+
},
|
|
214
|
+
},
|
|
215
|
+
},
|
|
216
|
+
});
|
|
217
|
+
|
|
218
|
+
await logCapture.register(async (scope) => {
|
|
219
|
+
scope.addContentTypeParser(
|
|
220
|
+
"application/json",
|
|
221
|
+
{ parseAs: "buffer" },
|
|
222
|
+
(_req, body, done) => {
|
|
223
|
+
done(null, body);
|
|
224
|
+
},
|
|
225
|
+
);
|
|
226
|
+
scope.post("/v1/webhooks/stripe", stripeWebhookHandler);
|
|
227
|
+
});
|
|
228
|
+
await logCapture.ready();
|
|
229
|
+
|
|
230
|
+
try {
|
|
231
|
+
// First delivery
|
|
232
|
+
await logCapture.inject({
|
|
233
|
+
method: "POST",
|
|
234
|
+
url: "/v1/webhooks/stripe",
|
|
235
|
+
payload: VALID_BODY,
|
|
236
|
+
headers: {
|
|
237
|
+
"content-type": "application/json",
|
|
238
|
+
"stripe-signature": VALID_SIGNATURE,
|
|
239
|
+
},
|
|
240
|
+
});
|
|
241
|
+
// Replay
|
|
242
|
+
logLines.length = 0;
|
|
243
|
+
await logCapture.inject({
|
|
244
|
+
method: "POST",
|
|
245
|
+
url: "/v1/webhooks/stripe",
|
|
246
|
+
payload: VALID_BODY,
|
|
247
|
+
headers: {
|
|
248
|
+
"content-type": "application/json",
|
|
249
|
+
"stripe-signature": VALID_SIGNATURE,
|
|
250
|
+
},
|
|
251
|
+
});
|
|
252
|
+
|
|
253
|
+
const matched = logLines.some((line) => {
|
|
254
|
+
const msg = String(line["msg"] ?? "");
|
|
255
|
+
return msg.includes("duplicate") || msg.includes("idempotent");
|
|
256
|
+
});
|
|
257
|
+
expect(matched).toBe(true);
|
|
258
|
+
} finally {
|
|
259
|
+
await logCapture.close();
|
|
260
|
+
}
|
|
261
|
+
});
|
|
262
|
+
});
|