create-ailk 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (396) hide show
  1. package/README.md +55 -8
  2. package/component-catalog.json +12248 -0
  3. package/component-catalog.md +193 -68
  4. package/dist/cli.js +29 -1
  5. package/dist/derive-architecture.js +5 -2
  6. package/dist/lib/api-boot-assertion.d.ts +46 -0
  7. package/dist/lib/api-boot-assertion.js +70 -0
  8. package/dist/lib/extract-module-bundle.d.ts +50 -2
  9. package/dist/lib/extract-module-bundle.js +223 -15
  10. package/dist/lib/fetch-guard.d.ts +28 -0
  11. package/dist/lib/fetch-guard.js +101 -0
  12. package/dist/lib/fetch-module.js +4 -0
  13. package/dist/lib/fetch-template.js +4 -0
  14. package/dist/lib/import-graph.d.ts +29 -0
  15. package/dist/lib/import-graph.js +140 -0
  16. package/dist/module-architecture.d.ts +60 -8
  17. package/dist/module-architecture.js +587 -242
  18. package/dist/parse-args.js +6 -2
  19. package/dist/programmatic.d.ts +10 -0
  20. package/dist/programmatic.js +134 -19
  21. package/dist/site-chrome.d.ts +80 -0
  22. package/dist/site-chrome.js +135 -0
  23. package/dist/surfaces.d.ts +21 -6
  24. package/dist/surfaces.js +209 -36
  25. package/dist/template-manifest.d.ts +88 -3
  26. package/dist/template-manifest.js +281 -29
  27. package/dist/template-names.d.ts +1 -1
  28. package/dist/template-names.js +2 -0
  29. package/package.json +10 -2
  30. package/site-templates/_base/ailk-template.json +6 -0
  31. package/site-templates/_base/content/en/Pricing/pricing.mdx +169 -0
  32. package/site-templates/marketing-site/TEMPLATE-MANIFEST.json +351 -0
  33. package/site-templates/marketing-site/TEMPLATE-MANIFEST.md +400 -0
  34. package/site-templates/marketing-site/ailk-template.json +11 -0
  35. package/site-templates/marketing-site/content/en/blog/05-this-vc-morning-routine-will-make-you-super-annoying.mdx +36 -0
  36. package/site-templates/marketing-site/provenance.json +4 -0
  37. package/site-templates/marketing-site-free/TEMPLATE-MANIFEST.json +288 -0
  38. package/site-templates/marketing-site-free/TEMPLATE-MANIFEST.md +286 -0
  39. package/site-templates/marketing-site-free/ailk-template.json +2 -1
  40. package/site-templates/minimalism-site/TEMPLATE-MANIFEST.json +279 -0
  41. package/site-templates/minimalism-site/TEMPLATE-MANIFEST.md +336 -0
  42. package/site-templates/minimalism-site/ailk-template.json +22 -0
  43. package/site-templates/minimalism-site/assets/avatar-placeholder-1.svg +7 -0
  44. package/site-templates/minimalism-site/assets/avatar-placeholder-2.svg +7 -0
  45. package/site-templates/minimalism-site/assets/avatar-placeholder-3.svg +7 -0
  46. package/site-templates/minimalism-site/assets/avatar-placeholder-4.svg +7 -0
  47. package/site-templates/minimalism-site/assets/avatar-placeholder-5.svg +7 -0
  48. package/site-templates/minimalism-site/assets/avatar-placeholder-6.svg +7 -0
  49. package/site-templates/minimalism-site/assets/hero-backdrop.svg +17 -0
  50. package/site-templates/minimalism-site/assets/logo-placeholder-1.svg +6 -0
  51. package/site-templates/minimalism-site/assets/logo-placeholder-2.svg +6 -0
  52. package/site-templates/minimalism-site/assets/logo-placeholder-3.svg +6 -0
  53. package/site-templates/minimalism-site/assets/wordmark-placeholder.svg +28 -0
  54. package/site-templates/minimalism-site/content/en/AboutPage/about.mdx +110 -0
  55. package/site-templates/minimalism-site/content/en/ContactPage/contact.mdx +68 -0
  56. package/site-templates/minimalism-site/content/en/FAQPage/faq.mdx +57 -0
  57. package/site-templates/minimalism-site/content/en/HomePage/home.mdx +244 -0
  58. package/site-templates/minimalism-site/content/en/LandingPage/referral.mdx +77 -0
  59. package/site-templates/minimalism-site/content/en/LandingPage/reports.mdx +73 -0
  60. package/site-templates/minimalism-site/content/en/ReportPage/annual-letter-2024.mdx +52 -0
  61. package/site-templates/minimalism-site/content/en/ReportPage/field-notes-2023.mdx +52 -0
  62. package/site-templates/minimalism-site/content/en/ReportPage/platform-shift-2025.mdx +52 -0
  63. package/site-templates/minimalism-site/content/en/ReportPage/state-of-the-market-2026.mdx +52 -0
  64. package/site-templates/minimalism-site/content/en/Service/first-engagement.mdx +38 -0
  65. package/site-templates/minimalism-site/content/en/Service/second-engagement.mdx +38 -0
  66. package/site-templates/minimalism-site/content/en/Service/third-engagement.mdx +38 -0
  67. package/site-templates/minimalism-site/content/en/ServicesList/services.mdx +73 -0
  68. package/site-templates/minimalism-site/flows/referral.flow.json +71 -0
  69. package/site-templates/minimalism-site/provenance.json +4 -0
  70. package/site-templates/saas-product/TEMPLATE-MANIFEST.md +61 -0
  71. package/site-templates/saas-product/ailk-template.json +16 -0
  72. package/site-templates/saas-product/provenance.json +10 -0
  73. package/site-templates/simple-service/TEMPLATE-MANIFEST.json +240 -0
  74. package/site-templates/simple-service/TEMPLATE-MANIFEST.md +278 -0
  75. package/site-templates/simple-service/ailk-template.json +10 -0
  76. package/site-templates/simple-service/content/en/AboutPage/about.mdx +38 -0
  77. package/site-templates/simple-service/content/en/ContactPage/contact.mdx +67 -0
  78. package/site-templates/simple-service/content/en/FAQPage/faq.mdx +56 -0
  79. package/site-templates/simple-service/content/en/HomePage/home.mdx +85 -0
  80. package/site-templates/simple-service/content/en/Service/landscape-design.mdx +40 -0
  81. package/site-templates/simple-service/content/en/Service/lawn-maintenance.mdx +40 -0
  82. package/site-templates/simple-service/content/en/Service/seasonal-cleanup.mdx +40 -0
  83. package/site-templates/simple-service/content/en/ServicesList/services.mdx +72 -0
  84. package/site-templates/simple-service/provenance.json +4 -0
  85. package/templates/.claude/skills/README.md +16 -25
  86. package/templates/.env.example +102 -12
  87. package/templates/.github/workflows/ci.yml +48 -0
  88. package/templates/README.md +3 -1
  89. package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-31.552Z-fallback-1789916251590-037e9005.json +8 -0
  90. package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-33.840Z-fallback-1789916253842-b52659e9.json +12 -0
  91. package/templates/apps/api/.ailk/inbox/2026-09-20T14-57-33.844Z-fallback-1789916253845-6b266f8c.json +12 -0
  92. package/templates/apps/api/.env.example +13 -0
  93. package/templates/apps/api/CLAUDE.md +29 -2
  94. package/templates/apps/api/eslint.config.mjs +69 -0
  95. package/templates/apps/api/jest.config.cjs +3 -0
  96. package/templates/apps/api/package.json +7 -2
  97. package/templates/apps/api/src/__tests__/commerce-claim-registration.test.ts +407 -0
  98. package/templates/apps/api/src/__tests__/module-exclusion.test.ts +89 -9
  99. package/templates/apps/api/src/__tests__/review-surface-registration.test.ts +167 -0
  100. package/templates/apps/api/src/__tests__/server.test.ts +471 -0
  101. package/templates/apps/api/src/__tests__/vercel-handler.test.ts +45 -0
  102. package/templates/apps/api/src/__tests__/workspace-module-registration.test.ts +10 -1
  103. package/templates/apps/api/src/config/index.ts +62 -0
  104. package/templates/apps/api/src/config/modules.ts +7 -3
  105. package/templates/apps/api/src/lib/__mocks__/prisma.ts +241 -2
  106. package/templates/apps/api/src/lib/__tests__/auth-email-budget.test.ts +143 -0
  107. package/templates/apps/api/src/lib/__tests__/content-adapter.test.ts +23 -0
  108. package/templates/apps/api/src/lib/__tests__/deliverable-asset-store.test.ts +125 -0
  109. package/templates/apps/api/src/lib/__tests__/error-serializer.test.ts +20 -0
  110. package/templates/apps/api/src/lib/__tests__/require-commerce-claim.test.ts +317 -0
  111. package/templates/apps/api/src/lib/__tests__/site.test.ts +238 -0
  112. package/templates/apps/api/src/lib/__tests__/stripe.test.ts +75 -0
  113. package/templates/apps/api/src/lib/auth-email-budget.ts +160 -0
  114. package/templates/apps/api/src/lib/content-adapter.ts +57 -31
  115. package/templates/apps/api/src/lib/deliverable-asset-store.ts +76 -0
  116. package/templates/apps/api/src/lib/error-serializer.ts +23 -3
  117. package/templates/apps/api/src/lib/outbound-http.ts +7 -2
  118. package/templates/apps/api/src/lib/require-commerce-claim.ts +250 -0
  119. package/templates/apps/api/src/lib/site.ts +208 -9
  120. package/templates/apps/api/src/lib/stripe.ts +66 -0
  121. package/templates/apps/api/src/middleware/__tests__/default-tenant.test.ts +521 -0
  122. package/templates/apps/api/src/middleware/__tests__/rate-limit.test.ts +150 -0
  123. package/templates/apps/api/src/middleware/default-tenant.ts +136 -0
  124. package/templates/apps/api/src/middleware/rate-limit.ts +7 -1
  125. package/templates/apps/api/src/openapi/spec.ts +543 -2
  126. package/templates/apps/api/src/routes/auth/__tests__/auth-user.functional.test.ts +48 -0
  127. package/templates/apps/api/src/routes/auth/__tests__/transactional-email.test.ts +309 -0
  128. package/templates/apps/api/src/routes/auth/__tests__/user.test.ts +123 -0
  129. package/templates/apps/api/src/routes/auth/transactional-email.ts +273 -0
  130. package/templates/apps/api/src/routes/auth/user.ts +61 -0
  131. package/templates/apps/api/src/routes/checkout/__tests__/session.test.ts +434 -0
  132. package/templates/apps/api/src/routes/checkout/__tests__/sessions.test.ts +888 -0
  133. package/templates/apps/api/src/routes/checkout/index.ts +34 -0
  134. package/templates/apps/api/src/routes/checkout/session.ts +139 -0
  135. package/templates/apps/api/src/routes/checkout/sessions.ts +197 -0
  136. package/templates/apps/api/src/routes/content/__tests__/get-page.test.ts +554 -0
  137. package/templates/apps/api/src/routes/content/__tests__/list-pages.test.ts +108 -0
  138. package/templates/apps/api/src/routes/content/__tests__/search.test.ts +450 -0
  139. package/templates/apps/api/src/routes/content/get-page.ts +94 -12
  140. package/templates/apps/api/src/routes/content/index.ts +13 -73
  141. package/templates/apps/api/src/routes/content/list-pages.ts +15 -3
  142. package/templates/apps/api/src/routes/content/rate-limit.ts +15 -6
  143. package/templates/apps/api/src/routes/content/search.ts +129 -0
  144. package/templates/apps/api/src/routes/leads/__tests__/index.test.ts +447 -31
  145. package/templates/apps/api/src/routes/leads/__tests__/list.test.ts +171 -0
  146. package/templates/apps/api/src/routes/leads/index.ts +100 -13
  147. package/templates/apps/api/src/routes/leads/list.ts +104 -0
  148. package/templates/apps/api/src/routes/project-listings/__tests__/configured-application.test.ts +51 -0
  149. package/templates/apps/api/src/routes/project-listings/__tests__/drafts.test.ts +351 -0
  150. package/templates/apps/api/src/routes/project-listings/__tests__/founder-identity.test.ts +51 -0
  151. package/templates/apps/api/src/routes/project-listings/__tests__/me.test.ts +5 -2
  152. package/templates/apps/api/src/routes/project-listings/__tests__/public.test.ts +4 -1
  153. package/templates/apps/api/src/routes/project-listings/__tests__/resume-email.test.ts +58 -0
  154. package/templates/apps/api/src/routes/project-listings/__tests__/site-answers.test.ts +107 -6
  155. package/templates/apps/api/src/routes/project-listings/__tests__/site-key.test.ts +87 -2
  156. package/templates/apps/api/src/routes/project-listings/__tests__/structured-address.test.ts +51 -0
  157. package/templates/apps/api/src/routes/project-listings/start.ts +5 -1
  158. package/templates/apps/api/src/routes/requests/__tests__/confirm.test.ts +686 -0
  159. package/templates/apps/api/src/routes/requests/confirm.ts +601 -0
  160. package/templates/apps/api/src/routes/requests/index.ts +54 -0
  161. package/templates/apps/api/src/routes/webhooks/README.md +265 -0
  162. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-dunning.test.ts +749 -0
  163. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-flow-checkout.test.ts +330 -0
  164. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-idempotency.test.ts +262 -0
  165. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-org-billing.test.ts +285 -0
  166. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-rate-limit.test.ts +213 -0
  167. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-request-paid.test.ts +301 -0
  168. package/templates/apps/api/src/routes/webhooks/__tests__/stripe.test.ts +648 -0
  169. package/templates/apps/api/src/routes/webhooks/index.ts +89 -0
  170. package/templates/apps/api/src/routes/webhooks/stripe.ts +1399 -0
  171. package/templates/apps/api/src/server.ts +521 -55
  172. package/templates/apps/api/src/services/__tests__/abandon-email.test.ts +39 -0
  173. package/templates/apps/api/src/services/__tests__/aeo-score.test.ts +217 -40
  174. package/templates/apps/api/src/services/__tests__/audit-log.test.ts +620 -0
  175. package/templates/apps/api/src/services/__tests__/consent.test.ts +2 -0
  176. package/templates/apps/api/src/services/__tests__/deliverable-fulfillment.test.ts +300 -5
  177. package/templates/apps/api/src/services/__tests__/deliverable-resend.test.ts +20 -0
  178. package/templates/apps/api/src/services/__tests__/dunning-policy.test.ts +368 -0
  179. package/templates/apps/api/src/services/__tests__/lead-promotion.test.ts +408 -0
  180. package/templates/apps/api/src/services/__tests__/lead-routing.test.ts +160 -0
  181. package/templates/apps/api/src/services/__tests__/leads-inbox.test.ts +329 -0
  182. package/templates/apps/api/src/services/__tests__/listing-config.test.ts +166 -0
  183. package/templates/apps/api/src/services/__tests__/project-listings.fence.test.ts +154 -0
  184. package/templates/apps/api/src/services/__tests__/public-site-resolver.test.ts +137 -0
  185. package/templates/apps/api/src/services/__tests__/request-confirm.test.ts +444 -0
  186. package/templates/apps/api/src/services/__tests__/revalidation.test.ts +238 -0
  187. package/templates/apps/api/src/services/__tests__/verified-email.test.ts +78 -0
  188. package/templates/apps/api/src/services/abandon-email.ts +8 -2
  189. package/templates/apps/api/src/services/aeo-score.ts +49 -12
  190. package/templates/apps/api/src/services/audit-log.ts +668 -0
  191. package/templates/apps/api/src/services/consent.ts +18 -0
  192. package/templates/apps/api/src/services/default-tenant.ts +300 -0
  193. package/templates/apps/api/src/services/deliverable-fulfillment.ts +141 -13
  194. package/templates/apps/api/src/services/dunning-policy.ts +294 -0
  195. package/templates/apps/api/src/services/entitlements.ts +80 -0
  196. package/templates/apps/api/src/services/lead-promotion.ts +160 -0
  197. package/templates/apps/api/src/services/lead-routing.ts +161 -2
  198. package/templates/apps/api/src/services/leads-inbox.ts +284 -0
  199. package/templates/apps/api/src/services/listing-config.ts +27 -9
  200. package/templates/apps/api/src/services/owner-workspaces.ts +132 -0
  201. package/templates/apps/api/src/services/project-listings.ts +201 -6
  202. package/templates/apps/api/src/services/public-site-resolver.ts +106 -0
  203. package/templates/apps/api/src/services/request-confirm.ts +646 -0
  204. package/templates/apps/api/src/services/revalidation.ts +173 -0
  205. package/templates/apps/api/src/services/verified-email.ts +71 -0
  206. package/templates/apps/api/src/vercel-handler.ts +75 -35
  207. package/templates/apps/mcp/.env.example +17 -0
  208. package/templates/apps/mcp/CLAUDE.md +58 -25
  209. package/templates/apps/mcp/__tests__/aeo-cli-parity.test.ts +6 -0
  210. package/templates/apps/mcp/__tests__/audit.test.ts +137 -8
  211. package/templates/apps/mcp/__tests__/catalog-drift.test.ts +79 -36
  212. package/templates/apps/mcp/__tests__/get_offerings.test.ts +111 -2
  213. package/templates/apps/mcp/__tests__/get_pricing.test.ts +82 -2
  214. package/templates/apps/mcp/__tests__/http-transport.test.ts +541 -2
  215. package/templates/apps/mcp/__tests__/index.test.ts +39 -0
  216. package/templates/apps/mcp/__tests__/lib/audit-single-page-readiness-scan.test.ts +143 -0
  217. package/templates/apps/mcp/__tests__/lib/commerce-claim.test.ts +111 -0
  218. package/templates/apps/mcp/__tests__/lib/content-adapter-parity.test.ts +65 -0
  219. package/templates/apps/mcp/__tests__/lib/content-adapter.test.ts +188 -0
  220. package/templates/apps/mcp/__tests__/lib/fail-closed-tools.test.ts +165 -0
  221. package/templates/apps/mcp/__tests__/lib/public-workspace.test.ts +124 -0
  222. package/templates/apps/mcp/__tests__/list_pages.test.ts +116 -0
  223. package/templates/apps/mcp/__tests__/module-exclusion.test.ts +7 -1
  224. package/templates/apps/mcp/__tests__/parity.test.ts +12 -9
  225. package/templates/apps/mcp/__tests__/purchase-disabled.test.ts +89 -22
  226. package/templates/apps/mcp/__tests__/read_content.test.ts +322 -1
  227. package/templates/apps/mcp/__tests__/search_content.test.ts +105 -2
  228. package/templates/apps/mcp/__tests__/server.test.ts +67 -14
  229. package/templates/apps/mcp/__tests__/start_purchase.test.ts +252 -0
  230. package/templates/apps/mcp/__tests__/tools/{scaffold.test.ts → create_project.test.ts} +23 -23
  231. package/templates/apps/mcp/__tests__/tools/purchase.test.ts +300 -123
  232. package/templates/apps/mcp/eslint.config.mjs +69 -0
  233. package/templates/apps/mcp/jest.config.cjs +13 -0
  234. package/templates/apps/mcp/package.json +8 -2
  235. package/templates/apps/mcp/src/abuse/index.ts +159 -24
  236. package/templates/apps/mcp/src/config/modules.ts +10 -5
  237. package/templates/apps/mcp/src/http-transport.ts +102 -29
  238. package/templates/apps/mcp/src/index.ts +73 -11
  239. package/templates/apps/mcp/src/lib/audit-single-page.ts +90 -3
  240. package/templates/apps/mcp/src/lib/commerce-claim.ts +94 -0
  241. package/templates/apps/mcp/src/lib/content-adapter.ts +113 -0
  242. package/templates/apps/mcp/src/lib/empty-content-adapter.ts +139 -0
  243. package/templates/apps/mcp/src/lib/prisma.ts +39 -0
  244. package/templates/apps/mcp/src/lib/public-workspace.ts +133 -0
  245. package/templates/apps/mcp/src/lib/stripe-tax-signal.ts +59 -0
  246. package/templates/apps/mcp/src/server.ts +61 -37
  247. package/templates/apps/mcp/src/tools/audit.ts +26 -2
  248. package/templates/apps/mcp/src/tools/{scaffold.ts → create_project.ts} +3 -3
  249. package/templates/apps/mcp/src/tools/get_business_hours.ts +4 -3
  250. package/templates/apps/mcp/src/tools/get_faq.ts +4 -3
  251. package/templates/apps/mcp/src/tools/get_locations.ts +5 -3
  252. package/templates/apps/mcp/src/tools/get_offerings.ts +16 -4
  253. package/templates/apps/mcp/src/tools/get_pricing.ts +25 -6
  254. package/templates/apps/mcp/src/tools/get_site_info.ts +4 -3
  255. package/templates/apps/mcp/src/tools/index.ts +9 -7
  256. package/templates/apps/mcp/src/tools/list_pages.ts +4 -3
  257. package/templates/apps/mcp/src/tools/purchase.ts +128 -45
  258. package/templates/apps/mcp/src/tools/read_content.ts +20 -6
  259. package/templates/apps/mcp/src/tools/search_content.ts +11 -4
  260. package/templates/apps/web/.env.example +74 -8
  261. package/templates/apps/web/CLAUDE.md +46 -0
  262. package/templates/apps/web/app/.well-known/mcp.json/build-manifest.ts +18 -2
  263. package/templates/apps/web/app/.well-known/mcp.json/route.ts +11 -3
  264. package/templates/apps/web/app/[locale]/(auth)/__tests__/auth-pages.test.tsx +282 -0
  265. package/templates/apps/web/app/[locale]/(auth)/__tests__/password-reset.test.tsx +515 -0
  266. package/templates/apps/web/app/[locale]/(auth)/forgot-password/forgot-password-card.tsx +89 -0
  267. package/templates/apps/web/app/[locale]/(auth)/forgot-password/page.tsx +109 -0
  268. package/templates/apps/web/app/[locale]/(auth)/layout.tsx +92 -0
  269. package/templates/apps/web/app/[locale]/(auth)/reset-password/page.tsx +135 -0
  270. package/templates/apps/web/app/[locale]/(auth)/reset-password/reset-password-card.tsx +109 -0
  271. package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/__tests__/page.test.tsx +48 -2
  272. package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/page.tsx +20 -6
  273. package/templates/apps/web/app/[locale]/(auth)/sign-in/sign-in-card.tsx +125 -0
  274. package/templates/apps/web/app/[locale]/(auth)/sign-up/page.tsx +96 -0
  275. package/templates/apps/web/app/[locale]/(auth)/sign-up/sign-up-card.tsx +101 -0
  276. package/templates/apps/web/app/[locale]/(auth)/use-auth-card-flow.ts +102 -0
  277. package/templates/apps/web/app/[locale]/(auth)/verify-email/page.tsx +87 -0
  278. package/templates/apps/web/app/[locale]/(authed)/__tests__/gate.test.tsx +20 -10
  279. package/templates/apps/web/app/[locale]/(authed)/account/__tests__/page.test.tsx +84 -0
  280. package/templates/apps/web/app/[locale]/(authed)/account/actions.ts +58 -0
  281. package/templates/apps/web/app/[locale]/(authed)/account/page.tsx +67 -14
  282. package/templates/apps/web/app/[locale]/(authed)/layout.tsx +19 -2
  283. package/templates/apps/web/app/[locale]/(authed)/leads/__tests__/page.test.tsx +181 -0
  284. package/templates/apps/web/app/[locale]/(authed)/leads/components/LeadsTable.tsx +137 -0
  285. package/templates/apps/web/app/[locale]/(authed)/leads/page.tsx +111 -0
  286. package/templates/apps/web/app/[locale]/(authed)/sign-in-gate.tsx +1 -1
  287. package/templates/apps/web/app/[locale]/[slug]/__tests__/page.test.tsx +111 -0
  288. package/templates/apps/web/app/[locale]/[slug]/page.tsx +65 -0
  289. package/templates/apps/web/app/[locale]/cancellation/page.tsx +44 -0
  290. package/templates/apps/web/app/[locale]/flows/[slug]/FlowStepperClient.tsx +1 -1
  291. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/FlowStepperClient.permalink.test.tsx +1 -1
  292. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/FlowStepperClient.test.tsx +6 -5
  293. package/templates/apps/web/app/[locale]/flows/[slug]/flow.actions.ts +1 -1
  294. package/templates/apps/web/app/[locale]/layout.tsx +308 -65
  295. package/templates/apps/web/app/[locale]/purchase/__tests__/cancel.test.tsx +162 -0
  296. package/templates/apps/web/app/[locale]/purchase/__tests__/module-scope.test.ts +68 -0
  297. package/templates/apps/web/app/[locale]/purchase/__tests__/success.test.tsx +361 -0
  298. package/templates/apps/web/app/[locale]/purchase/cancel/page.tsx +115 -0
  299. package/templates/apps/web/app/[locale]/purchase/success/page.tsx +307 -0
  300. package/templates/apps/web/app/[locale]/returns/page.tsx +44 -0
  301. package/templates/apps/web/app/[locale]/shipping/page.tsx +44 -0
  302. package/templates/apps/web/app/api/revalidate/__tests__/route.test.ts +670 -0
  303. package/templates/apps/web/app/api/revalidate/route.ts +194 -0
  304. package/templates/apps/web/auth.ts +407 -8
  305. package/templates/apps/web/components/google-analytics.tsx +18 -1
  306. package/templates/apps/web/eslint.config.mjs +69 -0
  307. package/templates/apps/web/jest.config.cjs +15 -19
  308. package/templates/apps/web/lib/__tests__/auth-email.test.ts +214 -0
  309. package/templates/apps/web/lib/__tests__/auth-routes.test.ts +74 -0
  310. package/templates/apps/web/lib/__tests__/meeting-slugs.test.ts +72 -0
  311. package/templates/apps/web/lib/__tests__/structured-data.test.tsx +50 -6
  312. package/templates/apps/web/lib/auth-email.ts +318 -0
  313. package/templates/apps/web/lib/auth-env.ts +85 -0
  314. package/templates/apps/web/lib/auth-routes.ts +55 -0
  315. package/templates/apps/web/lib/meeting-slugs.ts +53 -0
  316. package/templates/apps/web/lib/nav-config.ts +27 -7
  317. package/templates/apps/web/lib/server-api.ts +1 -1
  318. package/templates/apps/web/lib/site-chrome.ts +29 -0
  319. package/templates/apps/web/lib/telemetry-scrub.ts +50 -0
  320. package/templates/apps/web/messages/en.json +216 -2
  321. package/templates/apps/web/next.config.mjs +20 -0
  322. package/templates/apps/web/package.json +8 -3
  323. package/templates/apps/web/sentry.client.config.ts +131 -0
  324. package/templates/apps/web/sentry.edge.config.ts +72 -0
  325. package/templates/apps/web/sentry.server.config.ts +72 -0
  326. package/templates/apps/web/src/lib/commerce-claim.ts +33 -0
  327. package/templates/apps/web/src/lib/commerce-sections.ts +61 -0
  328. package/templates/apps/web/src/lib/routes.ts +13 -18
  329. package/templates/brand_assets/README.md +24 -0
  330. package/templates/content/en/AboutPage/about.mdx +160 -15
  331. package/templates/content/en/CancellationPolicyPage/cancellation.mdx +108 -0
  332. package/templates/content/en/ContactPage/contact.mdx +90 -13
  333. package/templates/content/en/FAQPage/faq.mdx +62 -22
  334. package/templates/content/en/HomePage/home.mdx +244 -20
  335. package/templates/content/en/LandingPage/blog.mdx +83 -0
  336. package/templates/content/en/LandingPage/features.mdx +103 -0
  337. package/templates/content/en/LandingPage/how-it-works.mdx +143 -0
  338. package/templates/content/en/ReturnsPolicyPage/returns.mdx +108 -0
  339. package/templates/content/en/ShippingPolicyPage/shipping.mdx +108 -0
  340. package/templates/database/CHANGELOG.md +149 -0
  341. package/templates/database/README.md +10 -3
  342. package/templates/database/__tests__/appointment.db.test.ts +106 -0
  343. package/templates/database/__tests__/artifact-content-store.db.test.ts +316 -0
  344. package/templates/database/__tests__/composite-fence.db.test.ts +206 -0
  345. package/templates/database/__tests__/fence-fan-out.db.test.ts +711 -0
  346. package/templates/database/__tests__/fixtures/appointment-create-probe.ts +79 -0
  347. package/templates/database/__tests__/fixtures/project-listing-consent-probe.ts +100 -0
  348. package/templates/database/__tests__/flow-workspace-key.db.test.ts +263 -0
  349. package/templates/database/__tests__/prefixed-ids.db.test.ts +85 -9
  350. package/templates/database/__tests__/project-listing-consent-at.db.test.ts +111 -0
  351. package/templates/database/__tests__/seed.test.ts +1 -1
  352. package/templates/database/__tests__/tenancy.test.ts +141 -0
  353. package/templates/database/config/schema.prisma +79 -2
  354. package/templates/database/content/schema.prisma +87 -11
  355. package/templates/database/eslint.config.mjs +69 -0
  356. package/templates/database/inbox/schema.prisma +452 -9
  357. package/templates/database/jest.config.cjs +5 -3
  358. package/templates/database/migrations/20260915120000_project_listing_solution/migration.sql +15 -0
  359. package/templates/database/migrations/20260916120000_artifact_content_store/migration.sql +158 -0
  360. package/templates/database/migrations/20260917120000_callback_request_confirm/migration.sql +40 -0
  361. package/templates/database/migrations/20260918120000_add_appointment/migration.sql +67 -0
  362. package/templates/database/migrations/20260918120000_asset_metadata_columns/migration.sql +70 -0
  363. package/templates/database/migrations/20260919120000_flow_workspace_key/migration.sql +181 -0
  364. package/templates/database/migrations/20260919130000_flow_definition_admin_columns/migration.sql +172 -0
  365. package/templates/database/migrations/20260919130000_workspace_meetings/migration.sql +41 -0
  366. package/templates/database/migrations/20260919140000_inbox_workspace_key/migration.sql +185 -0
  367. package/templates/database/migrations/20260920120000_lead_handled_at/migration.sql +70 -0
  368. package/templates/database/migrations/20260920130000_lead_workspace_source_index/migration.sql +57 -0
  369. package/templates/database/migrations/20260921120000_deliverable_grant_workspace_key/migration.sql +68 -0
  370. package/templates/database/migrations/20260922120000_tenancy_fence/migration.sql +1067 -0
  371. package/templates/database/migrations/20260923120000_listing_capturing_magnet/migration.sql +210 -0
  372. package/templates/database/package.json +7 -3
  373. package/templates/database/seed.ts +1 -1
  374. package/templates/database/tenancy.ts +86 -1
  375. package/templates/database/tsconfig.json +1 -0
  376. package/templates/package.json +1 -14
  377. package/versions.json +52 -0
  378. package/site-templates/marketing-site-free/content/en/Pricing/pricing.mdx +0 -103
  379. package/templates/apps/api/src/routes/content/__tests__/create.test.ts +0 -253
  380. package/templates/apps/api/src/routes/content/__tests__/delete.test.ts +0 -215
  381. package/templates/apps/api/src/routes/content/__tests__/update.test.ts +0 -266
  382. package/templates/apps/api/src/routes/content/create.ts +0 -115
  383. package/templates/apps/api/src/routes/content/delete.ts +0 -82
  384. package/templates/apps/api/src/routes/content/update.ts +0 -112
  385. package/templates/apps/mcp/__tests__/create_page.test.ts +0 -202
  386. package/templates/apps/mcp/__tests__/delete_page.test.ts +0 -177
  387. package/templates/apps/mcp/__tests__/update_page.test.ts +0 -196
  388. package/templates/apps/mcp/src/tools/create_page.ts +0 -96
  389. package/templates/apps/mcp/src/tools/delete_page.ts +0 -74
  390. package/templates/apps/mcp/src/tools/update_page.ts +0 -92
  391. package/templates/apps/web/app/[locale]/sign-in/sign-in-card.tsx +0 -123
  392. /package/site-templates/{marketing-site-free → _base}/content/en/PrivacyPage/privacy.mdx +0 -0
  393. /package/site-templates/{marketing-site-free → _base}/content/en/TermsPage/terms.mdx +0 -0
  394. /package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/__tests__/next-path.test.ts +0 -0
  395. /package/templates/apps/web/app/[locale]/{sign-in → (auth)/sign-in}/next-path.ts +0 -0
  396. /package/templates/apps/web/{src/components → components}/SiteNav.tsx +0 -0
@@ -0,0 +1,137 @@
1
+ /**
2
+ * @file public-site-resolver.test.ts
3
+ *
4
+ * Unit tests for `resolvePublicWorkspace(request)` (#5852, roadmap D4 read
5
+ * half). Database-free: the module-level `prisma` singleton is faked via the
6
+ * repo's manual-mock convention (`jest.mock("../../lib/prisma.js")` →
7
+ * `apps/api/src/lib/__mocks__/prisma.ts`), so every case runs in the ordinary
8
+ * workspace Jest run with no `DATABASE_URL`.
9
+ *
10
+ * The four arms under test: no-op off the database adapter (`mdx`,
11
+ * `projection`), resolved on a one-workspace deployment, and fail-closed on
12
+ * every ambiguity (zero, two, or a sole non-default workspace).
13
+ */
14
+
15
+ // 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.
16
+ jest.mock("../../lib/prisma.js");
17
+
18
+ import {
19
+ DEFAULT_ORG_ID,
20
+ DEFAULT_WORKSPACE_ID,
21
+ } from "@working-theory/database/tenancy";
22
+ import type { FastifyRequest } from "fastify";
23
+
24
+ import { prisma } from "../../lib/prisma.js";
25
+ import { resolvePublicWorkspace } from "../public-site-resolver.js";
26
+
27
+ // The resolver reads nothing off the request today (#5852 D1), so the stub is
28
+ // an empty object asserted at the parameter's type rather than a fixture.
29
+ const request = {} as FastifyRequest;
30
+
31
+ /** A one-workspace deployment seeded with the well-known default. */
32
+ function seedOneWorkspaceDeployment(): void {
33
+ (prisma.workspace.count as jest.Mock).mockResolvedValue(1);
34
+ (prisma.workspace.findUnique as jest.Mock).mockResolvedValue({
35
+ id: DEFAULT_WORKSPACE_ID,
36
+ organizationId: DEFAULT_ORG_ID,
37
+ });
38
+ }
39
+
40
+ describe("resolvePublicWorkspace", () => {
41
+ const savedAdapter = process.env.CONTENT_ADAPTER;
42
+
43
+ beforeEach(() => {
44
+ jest.clearAllMocks();
45
+ });
46
+
47
+ afterEach(() => {
48
+ if (savedAdapter === undefined) {
49
+ delete process.env.CONTENT_ADAPTER;
50
+ } else {
51
+ process.env.CONTENT_ADAPTER = savedAdapter;
52
+ }
53
+ });
54
+
55
+ describe("off the database adapter, it is a no-op (D4)", () => {
56
+ it("returns not-required under the default mdx adapter", async () => {
57
+ delete process.env.CONTENT_ADAPTER;
58
+
59
+ await expect(resolvePublicWorkspace(request)).resolves.toEqual({
60
+ kind: "not-required",
61
+ });
62
+ });
63
+
64
+ it("returns not-required under the projection adapter", async () => {
65
+ process.env.CONTENT_ADAPTER = "projection";
66
+
67
+ await expect(resolvePublicWorkspace(request)).resolves.toEqual({
68
+ kind: "not-required",
69
+ });
70
+ });
71
+
72
+ it("issues no tenancy query at all on the mdx arm", async () => {
73
+ delete process.env.CONTENT_ADAPTER;
74
+
75
+ await resolvePublicWorkspace(request);
76
+
77
+ expect(prisma.workspace.count).not.toHaveBeenCalled();
78
+ expect(prisma.workspace.findUnique).not.toHaveBeenCalled();
79
+ });
80
+ });
81
+
82
+ describe("under CONTENT_ADAPTER=database", () => {
83
+ beforeEach(() => {
84
+ process.env.CONTENT_ADAPTER = "database";
85
+ });
86
+
87
+ it("resolves the seeded default on a one-workspace deployment", async () => {
88
+ seedOneWorkspaceDeployment();
89
+
90
+ await expect(resolvePublicWorkspace(request)).resolves.toEqual({
91
+ kind: "resolved",
92
+ workspaceId: DEFAULT_WORKSPACE_ID,
93
+ });
94
+ });
95
+
96
+ it("is unresolved when the deployment has no workspace", async () => {
97
+ (prisma.workspace.count as jest.Mock).mockResolvedValue(0);
98
+
99
+ await expect(resolvePublicWorkspace(request)).resolves.toEqual({
100
+ kind: "unresolved",
101
+ reason: "ambiguous",
102
+ });
103
+ });
104
+
105
+ it("is unresolved when the deployment has two workspaces", async () => {
106
+ (prisma.workspace.count as jest.Mock).mockResolvedValue(2);
107
+
108
+ await expect(resolvePublicWorkspace(request)).resolves.toEqual({
109
+ kind: "unresolved",
110
+ reason: "ambiguous",
111
+ });
112
+ });
113
+
114
+ it("is unresolved when the sole workspace is not the seeded default", async () => {
115
+ (prisma.workspace.count as jest.Mock).mockResolvedValue(1);
116
+ (prisma.workspace.findUnique as jest.Mock).mockResolvedValue(null);
117
+
118
+ await expect(resolvePublicWorkspace(request)).resolves.toEqual({
119
+ kind: "unresolved",
120
+ reason: "ambiguous",
121
+ });
122
+ });
123
+
124
+ it("is unresolved when the sole workspace hangs off a non-sentinel org", async () => {
125
+ (prisma.workspace.count as jest.Mock).mockResolvedValue(1);
126
+ (prisma.workspace.findUnique as jest.Mock).mockResolvedValue({
127
+ id: DEFAULT_WORKSPACE_ID,
128
+ organizationId: "org_01930000-0000-7000-8000-00000000beef",
129
+ });
130
+
131
+ await expect(resolvePublicWorkspace(request)).resolves.toEqual({
132
+ kind: "unresolved",
133
+ reason: "ambiguous",
134
+ });
135
+ });
136
+ });
137
+ });
@@ -0,0 +1,444 @@
1
+ /**
2
+ * request-confirm.ts (#5970) — the credential, the configuration and the
3
+ * capture-side send.
4
+ *
5
+ * The Prisma boundary is the repo-standard `__mocks__/prisma.ts` double; the
6
+ * email package is mocked at the PACKAGE boundary (never at an internal
7
+ * module), the shape every service suite in this directory uses.
8
+ */
9
+
10
+ const mockSendRequestConfirmEmail = jest.fn();
11
+ const mockSendLeadNotification = jest.fn();
12
+
13
+ jest.mock("@working-theory/email", () => ({
14
+ sendRequestConfirmEmail: (...args: unknown[]) =>
15
+ mockSendRequestConfirmEmail(...args),
16
+ sendRequestPaidLinkEmail: jest.fn(),
17
+ sendLeadNotification: (...args: unknown[]) =>
18
+ mockSendLeadNotification(...args),
19
+ }));
20
+
21
+ // 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.
22
+ jest.mock("../../lib/prisma.js");
23
+
24
+ import { prisma } from "../../lib/prisma.js";
25
+ import { routeLead } from "../lead-routing.js";
26
+ import {
27
+ CONFIRM_TOKEN_TTL_MS,
28
+ claimConfirmation,
29
+ confirmLinkFor,
30
+ hashConfirmToken,
31
+ recordPaymentLink,
32
+ requestConfirmConfig,
33
+ requestConfirmSupersedesNotification,
34
+ resolveConfirmableRequest,
35
+ sendRequestConfirmLink,
36
+ } from "../request-confirm.js";
37
+
38
+ const CALLBACK_ID = "callbk_0000000000000001";
39
+ const REQUEST = { name: "Ada Lovelace", phone: "+44 7700 900000" };
40
+
41
+ /** Turn the fire-and-forget `void` entry point into something awaitable. */
42
+ const flush = () => new Promise((resolve) => setImmediate(resolve));
43
+
44
+ const ENV_KEYS = [
45
+ "AILK_REQUEST_CONFIRM_ENABLED",
46
+ "AILK_REQUEST_CONFIRM_TO",
47
+ "AILK_REQUEST_CONFIRM_FROM",
48
+ "AILK_REQUEST_CONFIRM_CURRENCY",
49
+ "AILK_REQUEST_CONFIRM_MAX_MINOR",
50
+ "AILK_LEAD_NOTIFICATION_TO",
51
+ "AILK_LEAD_NOTIFICATION_FROM",
52
+ "AILK_PUBLIC_API_URL",
53
+ "AILK_ENABLED_MODULES",
54
+ ] as const;
55
+
56
+ function enable(overrides: Record<string, string | undefined> = {}) {
57
+ process.env["AILK_REQUEST_CONFIRM_ENABLED"] = "true";
58
+ process.env["AILK_REQUEST_CONFIRM_TO"] = "owner@example.com";
59
+ process.env["AILK_REQUEST_CONFIRM_FROM"] = "hello@example.com";
60
+ process.env["AILK_PUBLIC_API_URL"] = "https://api.example.com";
61
+ for (const [key, value] of Object.entries(overrides)) {
62
+ if (value === undefined) delete process.env[key];
63
+ else process.env[key] = value;
64
+ }
65
+ }
66
+
67
+ beforeEach(() => {
68
+ jest.clearAllMocks();
69
+ for (const key of ENV_KEYS) delete process.env[key];
70
+ mockSendRequestConfirmEmail.mockResolvedValue({ ok: true, messageId: "m1" });
71
+ mockSendLeadNotification.mockResolvedValue({ ok: true, messageId: "m0" });
72
+ (prisma.callback.updateMany as jest.Mock).mockResolvedValue({ count: 1 });
73
+ (prisma.callback.update as jest.Mock).mockResolvedValue({});
74
+ (prisma.callback.findFirst as jest.Mock).mockResolvedValue(null);
75
+ });
76
+
77
+ afterEach(() => {
78
+ for (const key of ENV_KEYS) delete process.env[key];
79
+ });
80
+
81
+ // ── The credential ─────────────────────────────────────────────────────────
82
+
83
+ describe("the confirm credential", () => {
84
+ it("stores a digest that is never the token itself", async () => {
85
+ enable();
86
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
87
+ await flush();
88
+
89
+ const stored = (prisma.callback.updateMany as jest.Mock).mock.calls[0][0];
90
+ const link = mockSendRequestConfirmEmail.mock.calls[0][0]
91
+ .confirmLink as string;
92
+ const token = new URL(link).searchParams.get("token")!;
93
+
94
+ expect(token).toHaveLength(43); // 32 CSPRNG bytes, base64url
95
+ expect(stored.data.confirmTokenHash).toBe(hashConfirmToken(token));
96
+ expect(stored.data.confirmTokenHash).not.toBe(token);
97
+ // The mint guard is what makes the credential one-per-row — and
98
+ // `confirmedAt: null` beside it is what stops a fresh credential landing
99
+ // on an ALREADY-CONFIRMED row, whose digest is also null (#5970 security
100
+ // review, § 8).
101
+ expect(stored.where).toEqual({
102
+ id: CALLBACK_ID,
103
+ confirmTokenHash: null,
104
+ confirmedAt: null,
105
+ });
106
+ });
107
+
108
+ it("expires the credential seven days out", async () => {
109
+ enable();
110
+ const before = Date.now();
111
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
112
+ await flush();
113
+
114
+ const stored = (prisma.callback.updateMany as jest.Mock).mock.calls[0][0];
115
+ const expiry = (stored.data.confirmTokenExpiresAt as Date).getTime();
116
+ expect(CONFIRM_TOKEN_TTL_MS).toBe(7 * 24 * 60 * 60 * 1000);
117
+ expect(expiry).toBeGreaterThanOrEqual(before + CONFIRM_TOKEN_TTL_MS);
118
+ expect(expiry).toBeLessThanOrEqual(Date.now() + CONFIRM_TOKEN_TTL_MS);
119
+ });
120
+
121
+ it("mints a different token every time", async () => {
122
+ enable();
123
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
124
+ await flush();
125
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
126
+ await flush();
127
+ const [a, b] = mockSendRequestConfirmEmail.mock.calls.map(
128
+ (call) => call[0].confirmLink as string,
129
+ );
130
+ expect(a).not.toBe(b);
131
+ });
132
+
133
+ it("builds the confirm link on the API's own origin, token percent-encoded", () => {
134
+ const link = confirmLinkFor(
135
+ "https://api.example.com",
136
+ CALLBACK_ID,
137
+ "a+b/c=",
138
+ );
139
+ const url = new URL(link);
140
+ expect(url.origin).toBe("https://api.example.com");
141
+ expect(url.pathname).toBe(`/v1/requests/${CALLBACK_ID}/confirm`);
142
+ expect(url.searchParams.get("token")).toBe("a+b/c=");
143
+ expect(url.search).not.toContain("a+b/c=");
144
+ });
145
+ });
146
+
147
+ // ── Resolution: the four refusals are indistinguishable ────────────────────
148
+
149
+ describe("resolveConfirmableRequest()", () => {
150
+ it("puts the id, the digest, the expiry and the not-confirmed predicate in one where", async () => {
151
+ await resolveConfirmableRequest(CALLBACK_ID, "tok");
152
+ const call = (prisma.callback.findFirst as jest.Mock).mock.calls[0][0];
153
+ expect(call.where.id).toBe(CALLBACK_ID);
154
+ expect(call.where.confirmTokenHash).toBe(hashConfirmToken("tok"));
155
+ expect(call.where.confirmedAt).toBeNull();
156
+ expect(call.where.confirmTokenExpiresAt.gt).toBeInstanceOf(Date);
157
+ });
158
+
159
+ it("returns null when nothing matches — a tampered, expired, spent or cross-row token alike", async () => {
160
+ (prisma.callback.findFirst as jest.Mock).mockResolvedValue(null);
161
+ await expect(
162
+ resolveConfirmableRequest(CALLBACK_ID, "wrong"),
163
+ ).resolves.toBeNull();
164
+ });
165
+ });
166
+
167
+ // ── Claiming: verification and stamping in one guarded update ──────────────
168
+
169
+ describe("claimConfirmation()", () => {
170
+ const CLAIM = {
171
+ id: CALLBACK_ID,
172
+ token: "tok",
173
+ confirmedTime: "Tuesday 9am",
174
+ buyerEmail: "buyer@example.com",
175
+ amountMinor: 12900,
176
+ currency: "usd",
177
+ };
178
+
179
+ it("carries the same four predicates the resolver does, and spends the credential", async () => {
180
+ await expect(claimConfirmation(CLAIM)).resolves.toBe(true);
181
+ const call = (prisma.callback.updateMany as jest.Mock).mock.calls[0][0];
182
+ expect(call.where.id).toBe(CALLBACK_ID);
183
+ expect(call.where.confirmTokenHash).toBe(hashConfirmToken("tok"));
184
+ expect(call.where.confirmedAt).toBeNull();
185
+ expect(call.where.confirmTokenExpiresAt.gt).toBeInstanceOf(Date);
186
+ expect(call.data.confirmedAt).toBeInstanceOf(Date);
187
+ expect(call.data.confirmedTime).toBe("Tuesday 9am");
188
+ expect(call.data.buyerEmail).toBe("buyer@example.com");
189
+ expect(call.data.amountMinor).toBe(12900);
190
+ expect(call.data.currency).toBe("usd");
191
+ // Spending the credential is in the SAME statement as the stamp.
192
+ expect(call.data.confirmTokenHash).toBeNull();
193
+ });
194
+
195
+ it("omits amount and currency when the caller resolved a catalogue price instead", async () => {
196
+ await claimConfirmation({
197
+ id: CALLBACK_ID,
198
+ token: "tok",
199
+ confirmedTime: "Tuesday 9am",
200
+ buyerEmail: "buyer@example.com",
201
+ });
202
+ const call = (prisma.callback.updateMany as jest.Mock).mock.calls[0][0];
203
+ expect(call.data).not.toHaveProperty("amountMinor");
204
+ expect(call.data).not.toHaveProperty("currency");
205
+ });
206
+
207
+ it("reports false when no row matched — the loser of a double-POST race", async () => {
208
+ (prisma.callback.updateMany as jest.Mock).mockResolvedValue({ count: 0 });
209
+ await expect(claimConfirmation(CLAIM)).resolves.toBe(false);
210
+ });
211
+ });
212
+
213
+ describe("recordPaymentLink()", () => {
214
+ it("writes the artifact id the webhook stamp matches on", async () => {
215
+ await recordPaymentLink(CALLBACK_ID, "plink_abc");
216
+ expect(prisma.callback.update).toHaveBeenCalledWith({
217
+ where: { id: CALLBACK_ID },
218
+ data: { stripePaymentLinkId: "plink_abc" },
219
+ });
220
+ });
221
+ });
222
+
223
+ // ── Configuration ──────────────────────────────────────────────────────────
224
+
225
+ describe("requestConfirmConfig()", () => {
226
+ it("is null with the flag unset — the default every existing suite runs under", () => {
227
+ expect(requestConfirmConfig()).toBeNull();
228
+ expect(requestConfirmSupersedesNotification()).toBe(false);
229
+ });
230
+
231
+ it("is null when the flag is on but no recipient resolves", () => {
232
+ enable({ AILK_REQUEST_CONFIRM_TO: undefined });
233
+ expect(requestConfirmConfig()).toBeNull();
234
+ });
235
+
236
+ it("is null when the flag is on but no base URL resolves", () => {
237
+ enable({ AILK_PUBLIC_API_URL: undefined });
238
+ expect(requestConfirmConfig()).toBeNull();
239
+ });
240
+
241
+ it("falls back to the lead-notification pair for recipient and sender", () => {
242
+ enable({
243
+ AILK_REQUEST_CONFIRM_TO: undefined,
244
+ AILK_REQUEST_CONFIRM_FROM: undefined,
245
+ AILK_LEAD_NOTIFICATION_TO: "ops@example.com",
246
+ AILK_LEAD_NOTIFICATION_FROM: "noreply@example.com",
247
+ });
248
+ expect(requestConfirmConfig()).toMatchObject({
249
+ to: "ops@example.com",
250
+ from: "noreply@example.com",
251
+ });
252
+ });
253
+
254
+ it("is null on a MULTI-TENANT build, however completely it is configured", () => {
255
+ // #5970 security review, finding 3. Every value here is process-wide, as
256
+ // is STRIPE_SECRET_KEY — so on a multi-tenant deployment one tenant's
257
+ // customer would pay into the deployment's own Stripe account. The feature
258
+ // fails closed there rather than mis-routing money.
259
+ enable();
260
+ expect(requestConfirmConfig()).not.toBeNull();
261
+ process.env["AILK_ENABLED_MODULES"] = "multi-tenant,docs";
262
+ expect(requestConfirmConfig()).toBeNull();
263
+ // And because the notification predicate reads the same function, the
264
+ // generic lead notification is NOT suppressed on such a build — the
265
+ // callback path is byte-for-byte what it was before this feature.
266
+ expect(requestConfirmSupersedesNotification()).toBe(false);
267
+ });
268
+
269
+ it("caps the money-gate ceiling at the column's own limit", () => {
270
+ // `amount_minor` is a Postgres INTEGER. A ceiling above it would admit an
271
+ // amount that passes every check and then throws out of Prisma at write
272
+ // time — a 500 on a money path, from a configuration typo (§ 8).
273
+ enable({ AILK_REQUEST_CONFIRM_MAX_MINOR: "99999999999" });
274
+ expect(requestConfirmConfig()?.maxAmountMinor).toBe(2_147_483_647);
275
+ });
276
+
277
+ it("defaults the currency and the money-gate ceiling", () => {
278
+ enable();
279
+ expect(requestConfirmConfig()).toMatchObject({
280
+ currency: "usd",
281
+ maxAmountMinor: 1_000_000,
282
+ });
283
+ });
284
+
285
+ it("takes a configured currency and ceiling, and ignores ones that do not parse", () => {
286
+ enable({
287
+ AILK_REQUEST_CONFIRM_CURRENCY: "GBP",
288
+ AILK_REQUEST_CONFIRM_MAX_MINOR: "50000",
289
+ });
290
+ expect(requestConfirmConfig()).toMatchObject({
291
+ currency: "gbp",
292
+ maxAmountMinor: 50000,
293
+ });
294
+
295
+ // A ceiling that does not parse must not become NaN (which refuses every
296
+ // amount) or unbounded — it falls back to the platform default.
297
+ enable({ AILK_REQUEST_CONFIRM_MAX_MINOR: "lots" });
298
+ expect(requestConfirmConfig()?.maxAmountMinor).toBe(1_000_000);
299
+ enable({ AILK_REQUEST_CONFIRM_MAX_MINOR: "-5" });
300
+ expect(requestConfirmConfig()?.maxAmountMinor).toBe(1_000_000);
301
+ });
302
+ });
303
+
304
+ // ── The capture-side send ──────────────────────────────────────────────────
305
+
306
+ describe("sendRequestConfirmLink()", () => {
307
+ it("writes no credential and sends nothing when the feature is off", async () => {
308
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
309
+ await flush();
310
+ expect(prisma.callback.updateMany).not.toHaveBeenCalled();
311
+ expect(mockSendRequestConfirmEmail).not.toHaveBeenCalled();
312
+ });
313
+
314
+ it("sends exactly one email, carrying the request's details, when configured", async () => {
315
+ enable();
316
+ sendRequestConfirmLink(CALLBACK_ID, {
317
+ ...REQUEST,
318
+ preferredTime: "Tuesday morning",
319
+ });
320
+ await flush();
321
+
322
+ expect(mockSendRequestConfirmEmail).toHaveBeenCalledTimes(1);
323
+ expect(mockSendRequestConfirmEmail.mock.calls[0][0]).toMatchObject({
324
+ to: "owner@example.com",
325
+ fromAddress: "hello@example.com",
326
+ request: {
327
+ name: "Ada Lovelace",
328
+ phone: "+44 7700 900000",
329
+ preferredTime: "Tuesday morning",
330
+ },
331
+ });
332
+ });
333
+
334
+ it("sends nothing when the row already carries a live credential", async () => {
335
+ enable();
336
+ (prisma.callback.updateMany as jest.Mock).mockResolvedValue({ count: 0 });
337
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
338
+ await flush();
339
+ expect(mockSendRequestConfirmEmail).not.toHaveBeenCalled();
340
+ });
341
+
342
+ it("never throws when the email package reports a failure", async () => {
343
+ enable();
344
+ mockSendRequestConfirmEmail.mockResolvedValue({
345
+ ok: false,
346
+ error: { kind: "send_failed", message: "domain not verified" },
347
+ });
348
+ expect(() => sendRequestConfirmLink(CALLBACK_ID, REQUEST)).not.toThrow();
349
+ await flush();
350
+ });
351
+
352
+ it("never throws when the database write itself rejects", async () => {
353
+ enable();
354
+ (prisma.callback.updateMany as jest.Mock).mockRejectedValue(
355
+ new Error("connection reset"),
356
+ );
357
+ expect(() => sendRequestConfirmLink(CALLBACK_ID, REQUEST)).not.toThrow();
358
+ await flush();
359
+ expect(mockSendRequestConfirmEmail).not.toHaveBeenCalled();
360
+ });
361
+ });
362
+
363
+ // ── "Exactly one email" (AC-1), measured across both senders ───────────────
364
+ //
365
+ // The claim AC-1 makes is about the TENANT'S INBOX, and two modules decide
366
+ // what lands in it: `lead-routing.ts` sends the generic notification, this
367
+ // module sends the confirm message. Asserting either one alone would leave the
368
+ // interesting failure — both firing, or neither — untested. So these two cases
369
+ // drive `routeLead` itself and count BOTH senders.
370
+ describe("exactly one email reaches the tenant (AC-1)", () => {
371
+ const CALLBACK = {
372
+ kind: "callback" as const,
373
+ siteId: "site_1",
374
+ name: "Ada Lovelace",
375
+ phone: "+44 7700 900000",
376
+ payload: {},
377
+ };
378
+ const META = {
379
+ ip: "203.0.113.1",
380
+ userAgent: "test",
381
+ receivedAt: new Date().toISOString(),
382
+ };
383
+
384
+ beforeEach(() => {
385
+ process.env["DATABASE_URL"] = "postgresql://localhost/test";
386
+ (prisma.callback.create as jest.Mock).mockResolvedValue({
387
+ id: CALLBACK_ID,
388
+ });
389
+ });
390
+
391
+ it("with the feature ON: the confirm email replaces the generic notification", async () => {
392
+ enable();
393
+ const result = await routeLead(CALLBACK, META);
394
+ expect(result.ok).toBe(true);
395
+
396
+ // The generic notification is suppressed — that is what makes the total
397
+ // one rather than two.
398
+ expect(mockSendLeadNotification).not.toHaveBeenCalled();
399
+ expect(result.ok && result.email).toEqual({
400
+ skipped: true,
401
+ reason: "request_confirm",
402
+ });
403
+
404
+ // And the confirm message is the one that goes.
405
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
406
+ await flush();
407
+ expect(mockSendRequestConfirmEmail).toHaveBeenCalledTimes(1);
408
+ });
409
+
410
+ it("on the FILE-FALLBACK path the generic notification still goes, feature on or not", async () => {
411
+ // #5970 security review round 3, M1. When the DB is unavailable the
412
+ // callback is written to the file fallback and there is no row to mint a
413
+ // credential against — so suppressing the generic notification would have
414
+ // meant ZERO operator emails for every callback captured during an outage,
415
+ // on the one surface whose whole point is that an outage must not lose a
416
+ // lead.
417
+ enable();
418
+ process.env["AILK_LEAD_NOTIFICATION_TO"] = "ops@example.com";
419
+ process.env["AILK_LEAD_NOTIFICATION_FROM"] = "noreply@example.com";
420
+ (prisma.callback.create as jest.Mock).mockRejectedValue(
421
+ new Error("connection reset"),
422
+ );
423
+
424
+ const result = await routeLead(CALLBACK, META);
425
+ expect(result.ok).toBe(true);
426
+ expect(result.ok && result.persisted).toBe("file");
427
+ // The email the operator would otherwise never have received.
428
+ expect(mockSendLeadNotification).toHaveBeenCalledTimes(1);
429
+ expect(mockSendRequestConfirmEmail).not.toHaveBeenCalled();
430
+ });
431
+
432
+ it("with the feature OFF: the generic notification still goes, exactly as before", async () => {
433
+ process.env["AILK_LEAD_NOTIFICATION_TO"] = "ops@example.com";
434
+ process.env["AILK_LEAD_NOTIFICATION_FROM"] = "noreply@example.com";
435
+ const result = await routeLead(CALLBACK, META);
436
+ expect(result.ok).toBe(true);
437
+ expect(mockSendLeadNotification).toHaveBeenCalledTimes(1);
438
+
439
+ // And nothing from this feature runs at all.
440
+ sendRequestConfirmLink(CALLBACK_ID, REQUEST);
441
+ await flush();
442
+ expect(mockSendRequestConfirmEmail).not.toHaveBeenCalled();
443
+ });
444
+ });