create-ailk 0.1.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 (533) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +39 -0
  3. package/dist/cli.d.ts +2 -0
  4. package/dist/cli.js +80 -0
  5. package/dist/copy.d.ts +8 -0
  6. package/dist/copy.js +109 -0
  7. package/dist/index.d.ts +10 -0
  8. package/dist/index.js +10 -0
  9. package/dist/lib/pro-callout.d.ts +12 -0
  10. package/dist/lib/pro-callout.js +20 -0
  11. package/dist/parse-args.d.ts +13 -0
  12. package/dist/parse-args.js +81 -0
  13. package/dist/programmatic.d.ts +49 -0
  14. package/dist/programmatic.js +89 -0
  15. package/dist/substitute.d.ts +31 -0
  16. package/dist/substitute.js +45 -0
  17. package/dist/validate.d.ts +8 -0
  18. package/dist/validate.js +70 -0
  19. package/package.json +47 -0
  20. package/templates/.claude/.gitkeep +0 -0
  21. package/templates/.claude/agents/web.md +80 -0
  22. package/templates/.claude/rules/architecture.md +62 -0
  23. package/templates/.claude/rules/preserve-existing-style.md +51 -0
  24. package/templates/.claude/skills/README.md +43 -0
  25. package/templates/.claude/skills/add-schema/SKILL.md +270 -0
  26. package/templates/.claude/skills/add-schema/references/conflict-handling.md +200 -0
  27. package/templates/.claude/skills/add-schema/references/file-finding.md +123 -0
  28. package/templates/.claude/skills/add-schema/references/schema-types.md +131 -0
  29. package/templates/.claude/skills/audit-site/SKILL.md +213 -0
  30. package/templates/.claude/skills/audit-site/references/common-errors.md +113 -0
  31. package/templates/.claude/skills/audit-site/references/findings-glossary.md +138 -0
  32. package/templates/.claude/skills/audit-site/references/severity-levels.md +114 -0
  33. package/templates/.claude/skills/provision-config/SKILL.md +243 -0
  34. package/templates/.claude/skills/provision-config/references/env-vars-template.md +184 -0
  35. package/templates/.claude/skills/provision-config/references/runbook-template.md +248 -0
  36. package/templates/.claude/skills/provision-config/references/vercel-json-template.md +98 -0
  37. package/templates/.claude/skills/scaffold-auth/SKILL.md +261 -0
  38. package/templates/.claude/skills/scaffold-auth/references/env-vars.md +91 -0
  39. package/templates/.claude/skills/scaffold-auth/references/oauth-app-setup.md +171 -0
  40. package/templates/.claude/skills/scaffold-commerce/SKILL.md +310 -0
  41. package/templates/.claude/skills/scaffold-commerce/references/lookup-keys-template.md +71 -0
  42. package/templates/.claude/skills/scaffold-commerce/references/marketplace-brand-pages.md +83 -0
  43. package/templates/.claude/skills/scaffold-commerce/templates/marketplace-cta-route.tsx.tmpl +72 -0
  44. package/templates/.claude/skills/scaffold-page/SKILL.md +243 -0
  45. package/templates/.claude/skills/scaffold-page/references/page-types.md +169 -0
  46. package/templates/.claude/skills/scaffold-page/templates/content.mdx.tmpl +28 -0
  47. package/templates/.claude/skills/scaffold-page/templates/route.tsx.tmpl +28 -0
  48. package/templates/.claude/skills/suggest-site-pages/SKILL.md +242 -0
  49. package/templates/.claude/skills/suggest-site-pages/references/categories.md +287 -0
  50. package/templates/.env.example +205 -0
  51. package/templates/.gitkeep +2 -0
  52. package/templates/CLAUDE.md +142 -0
  53. package/templates/CONVENTIONS.md +222 -0
  54. package/templates/README.md +110 -0
  55. package/templates/apps/api/.env.example +40 -0
  56. package/templates/apps/api/CLAUDE.md +63 -0
  57. package/templates/apps/api/api/index.ts +144 -0
  58. package/templates/apps/api/jest.config.cjs +74 -0
  59. package/templates/apps/api/package.json +54 -0
  60. package/templates/apps/api/src/__tests__/factories/content-fixture.ts +138 -0
  61. package/templates/apps/api/src/__tests__/factories/index.ts +70 -0
  62. package/templates/apps/api/src/__tests__/factories/lead-fixture.ts +82 -0
  63. package/templates/apps/api/src/__tests__/index.test.ts +118 -0
  64. package/templates/apps/api/src/__tests__/server.test.ts +207 -0
  65. package/templates/apps/api/src/__tests__/services/enrichment-shim.test.ts +126 -0
  66. package/templates/apps/api/src/__tests__/setup.ts +24 -0
  67. package/templates/apps/api/src/cli.ts +30 -0
  68. package/templates/apps/api/src/config/__tests__/index.test.ts +97 -0
  69. package/templates/apps/api/src/config/index.ts +56 -0
  70. package/templates/apps/api/src/index.ts +32 -0
  71. package/templates/apps/api/src/lib/__mocks__/prisma-client.js +15 -0
  72. package/templates/apps/api/src/lib/__mocks__/prisma.ts +45 -0
  73. package/templates/apps/api/src/lib/__tests__/content-adapter.test.ts +178 -0
  74. package/templates/apps/api/src/lib/__tests__/error-serializer.test.ts +100 -0
  75. package/templates/apps/api/src/lib/__tests__/errors.test.ts +94 -0
  76. package/templates/apps/api/src/lib/__tests__/file-fallback.test.ts +144 -0
  77. package/templates/apps/api/src/lib/__tests__/fixtures/HomePage/home.mdx +8 -0
  78. package/templates/apps/api/src/lib/__tests__/lead-capture-store.test.ts +227 -0
  79. package/templates/apps/api/src/lib/__tests__/outbound-http.test.ts +125 -0
  80. package/templates/apps/api/src/lib/__tests__/prisma.test.ts +165 -0
  81. package/templates/apps/api/src/lib/__tests__/require-paid-tier.test.ts +129 -0
  82. package/templates/apps/api/src/lib/__tests__/stripe.test.ts +74 -0
  83. package/templates/apps/api/src/lib/content-adapter.ts +86 -0
  84. package/templates/apps/api/src/lib/error-serializer.ts +77 -0
  85. package/templates/apps/api/src/lib/errors.ts +95 -0
  86. package/templates/apps/api/src/lib/file-fallback.ts +87 -0
  87. package/templates/apps/api/src/lib/lead-capture-store.ts +110 -0
  88. package/templates/apps/api/src/lib/locales.ts +201 -0
  89. package/templates/apps/api/src/lib/outbound-http.ts +122 -0
  90. package/templates/apps/api/src/lib/prisma.ts +21 -0
  91. package/templates/apps/api/src/lib/require-paid-tier.ts +53 -0
  92. package/templates/apps/api/src/lib/stripe.ts +30 -0
  93. package/templates/apps/api/src/lib/webhook-idempotency.ts +92 -0
  94. package/templates/apps/api/src/middleware/__tests__/adversarial/bearer-token-format.test.ts +111 -0
  95. package/templates/apps/api/src/middleware/__tests__/adversarial/cookie-or-bearer-precedence.test.ts +172 -0
  96. package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-bearer-skip.test.ts +119 -0
  97. package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-cookie-path.test.ts +138 -0
  98. package/templates/apps/api/src/middleware/__tests__/adversarial/session-fixation.test.ts +149 -0
  99. package/templates/apps/api/src/middleware/__tests__/adversarial/session-timeout.test.ts +139 -0
  100. package/templates/apps/api/src/middleware/__tests__/auth.bearer-path.test.ts +175 -0
  101. package/templates/apps/api/src/middleware/__tests__/auth.both-present-precedence.test.ts +76 -0
  102. package/templates/apps/api/src/middleware/__tests__/auth.cookie-path.test.ts +153 -0
  103. package/templates/apps/api/src/middleware/__tests__/auth.neither-present.test.ts +72 -0
  104. package/templates/apps/api/src/middleware/__tests__/rate-limit.test.ts +292 -0
  105. package/templates/apps/api/src/middleware/auth.ts +246 -0
  106. package/templates/apps/api/src/middleware/rate-limit.ts +132 -0
  107. package/templates/apps/api/src/openapi/__tests__/openapi.test.ts +129 -0
  108. package/templates/apps/api/src/openapi/index.ts +12 -0
  109. package/templates/apps/api/src/openapi/spec.ts +408 -0
  110. package/templates/apps/api/src/routes/auth/__tests__/auth-tokens.functional.test.ts +193 -0
  111. package/templates/apps/api/src/routes/auth/__tests__/auth-user.functional.test.ts +201 -0
  112. package/templates/apps/api/src/routes/auth/__tests__/tokens.test.ts +294 -0
  113. package/templates/apps/api/src/routes/auth/__tests__/user.test.ts +486 -0
  114. package/templates/apps/api/src/routes/auth/tokens.ts +199 -0
  115. package/templates/apps/api/src/routes/auth/user.ts +244 -0
  116. package/templates/apps/api/src/routes/checkout/__tests__/sessions.test.ts +588 -0
  117. package/templates/apps/api/src/routes/checkout/index.ts +13 -0
  118. package/templates/apps/api/src/routes/checkout/sessions.ts +185 -0
  119. package/templates/apps/api/src/routes/content/__tests__/create.test.ts +239 -0
  120. package/templates/apps/api/src/routes/content/__tests__/delete.test.ts +201 -0
  121. package/templates/apps/api/src/routes/content/__tests__/get-page.test.ts +141 -0
  122. package/templates/apps/api/src/routes/content/__tests__/list-pages.test.ts +122 -0
  123. package/templates/apps/api/src/routes/content/__tests__/list-types.test.ts +44 -0
  124. package/templates/apps/api/src/routes/content/__tests__/locale.test.ts +118 -0
  125. package/templates/apps/api/src/routes/content/__tests__/rate-limit.test.ts +51 -0
  126. package/templates/apps/api/src/routes/content/__tests__/update.test.ts +252 -0
  127. package/templates/apps/api/src/routes/content/create.ts +114 -0
  128. package/templates/apps/api/src/routes/content/delete.ts +81 -0
  129. package/templates/apps/api/src/routes/content/get-page.ts +98 -0
  130. package/templates/apps/api/src/routes/content/index.ts +32 -0
  131. package/templates/apps/api/src/routes/content/list-pages.ts +83 -0
  132. package/templates/apps/api/src/routes/content/list-types.ts +19 -0
  133. package/templates/apps/api/src/routes/content/rate-limit.ts +13 -0
  134. package/templates/apps/api/src/routes/content/slug.ts +9 -0
  135. package/templates/apps/api/src/routes/content/update.ts +111 -0
  136. package/templates/apps/api/src/routes/leads/__tests__/index.test.ts +415 -0
  137. package/templates/apps/api/src/routes/leads/__tests__/track.test.ts +165 -0
  138. package/templates/apps/api/src/routes/leads/index.ts +130 -0
  139. package/templates/apps/api/src/routes/test/auth/__tests__/session.test.ts +296 -0
  140. package/templates/apps/api/src/routes/test/auth/session.ts +141 -0
  141. package/templates/apps/api/src/routes/webhooks/README.md +57 -0
  142. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-idempotency.test.ts +247 -0
  143. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-rate-limit.test.ts +198 -0
  144. package/templates/apps/api/src/routes/webhooks/__tests__/stripe.test.ts +633 -0
  145. package/templates/apps/api/src/routes/webhooks/index.ts +41 -0
  146. package/templates/apps/api/src/routes/webhooks/stripe.ts +253 -0
  147. package/templates/apps/api/src/server.ts +157 -0
  148. package/templates/apps/api/src/services/__tests__/lead-routing.test.ts +395 -0
  149. package/templates/apps/api/src/services/enrichment-shim.ts +53 -0
  150. package/templates/apps/api/src/services/lead-routing.ts +338 -0
  151. package/templates/apps/api/tsconfig.json +34 -0
  152. package/templates/apps/api/vercel.json +17 -0
  153. package/templates/apps/mcp/.env.example +52 -0
  154. package/templates/apps/mcp/CLAUDE.md +84 -0
  155. package/templates/apps/mcp/__tests__/abuse/daily-cap.test.ts +52 -0
  156. package/templates/apps/mcp/__tests__/abuse/email-validator.test.ts +46 -0
  157. package/templates/apps/mcp/__tests__/abuse/honeypot.test.ts +36 -0
  158. package/templates/apps/mcp/__tests__/abuse/user-agent-deny.test.ts +54 -0
  159. package/templates/apps/mcp/__tests__/aeo-cli-parity.test.ts +110 -0
  160. package/templates/apps/mcp/__tests__/audit-single-page.test.ts +213 -0
  161. package/templates/apps/mcp/__tests__/audit.test.ts +217 -0
  162. package/templates/apps/mcp/__tests__/catalog-drift.test.ts +52 -0
  163. package/templates/apps/mcp/__tests__/create_page.test.ts +201 -0
  164. package/templates/apps/mcp/__tests__/delete_page.test.ts +176 -0
  165. package/templates/apps/mcp/__tests__/get_business_hours.test.ts +82 -0
  166. package/templates/apps/mcp/__tests__/get_faq.test.ts +80 -0
  167. package/templates/apps/mcp/__tests__/get_locations.test.ts +65 -0
  168. package/templates/apps/mcp/__tests__/get_offerings.test.ts +90 -0
  169. package/templates/apps/mcp/__tests__/get_pricing.test.ts +80 -0
  170. package/templates/apps/mcp/__tests__/get_site_info.test.ts +81 -0
  171. package/templates/apps/mcp/__tests__/http-transport.test.ts +323 -0
  172. package/templates/apps/mcp/__tests__/lib/errors.test.ts +75 -0
  173. package/templates/apps/mcp/__tests__/lib/require-paid-tier.test.ts +75 -0
  174. package/templates/apps/mcp/__tests__/list_pages.test.ts +112 -0
  175. package/templates/apps/mcp/__tests__/locale.test.ts +135 -0
  176. package/templates/apps/mcp/__tests__/parity.test.ts +205 -0
  177. package/templates/apps/mcp/__tests__/purchase-disabled.test.ts +34 -0
  178. package/templates/apps/mcp/__tests__/read_content.test.ts +153 -0
  179. package/templates/apps/mcp/__tests__/request_callback.test.ts +163 -0
  180. package/templates/apps/mcp/__tests__/search_content.test.ts +153 -0
  181. package/templates/apps/mcp/__tests__/server.test.ts +115 -0
  182. package/templates/apps/mcp/__tests__/submit_lead.test.ts +165 -0
  183. package/templates/apps/mcp/__tests__/subscribe_newsletter.test.ts +161 -0
  184. package/templates/apps/mcp/__tests__/tools/purchase.test.ts +227 -0
  185. package/templates/apps/mcp/__tests__/tools/scaffold.test.ts +237 -0
  186. package/templates/apps/mcp/__tests__/update_page.test.ts +195 -0
  187. package/templates/apps/mcp/jest.config.cjs +82 -0
  188. package/templates/apps/mcp/package.json +37 -0
  189. package/templates/apps/mcp/src/abuse/daily-cap.ts +47 -0
  190. package/templates/apps/mcp/src/abuse/email-validator.ts +25 -0
  191. package/templates/apps/mcp/src/abuse/honeypot.ts +21 -0
  192. package/templates/apps/mcp/src/abuse/index.ts +111 -0
  193. package/templates/apps/mcp/src/abuse/user-agent-deny.ts +58 -0
  194. package/templates/apps/mcp/src/http-transport.ts +303 -0
  195. package/templates/apps/mcp/src/index.ts +67 -0
  196. package/templates/apps/mcp/src/lib/audit-single-page.ts +194 -0
  197. package/templates/apps/mcp/src/lib/errors.ts +61 -0
  198. package/templates/apps/mcp/src/lib/locales.ts +171 -0
  199. package/templates/apps/mcp/src/lib/require-paid-tier.ts +44 -0
  200. package/templates/apps/mcp/src/lib/resolve-locale.ts +30 -0
  201. package/templates/apps/mcp/src/server.ts +139 -0
  202. package/templates/apps/mcp/src/tools/audit.ts +103 -0
  203. package/templates/apps/mcp/src/tools/capture_lead.ts +52 -0
  204. package/templates/apps/mcp/src/tools/create_page.ts +95 -0
  205. package/templates/apps/mcp/src/tools/delete_page.ts +73 -0
  206. package/templates/apps/mcp/src/tools/get_business_hours.ts +66 -0
  207. package/templates/apps/mcp/src/tools/get_faq.ts +69 -0
  208. package/templates/apps/mcp/src/tools/get_locations.ts +85 -0
  209. package/templates/apps/mcp/src/tools/get_offerings.ts +66 -0
  210. package/templates/apps/mcp/src/tools/get_pricing.ts +74 -0
  211. package/templates/apps/mcp/src/tools/get_site_info.ts +84 -0
  212. package/templates/apps/mcp/src/tools/index.ts +125 -0
  213. package/templates/apps/mcp/src/tools/list_pages.ts +72 -0
  214. package/templates/apps/mcp/src/tools/purchase.ts +89 -0
  215. package/templates/apps/mcp/src/tools/read_content.ts +61 -0
  216. package/templates/apps/mcp/src/tools/request_callback.ts +51 -0
  217. package/templates/apps/mcp/src/tools/scaffold.ts +119 -0
  218. package/templates/apps/mcp/src/tools/search_content.ts +59 -0
  219. package/templates/apps/mcp/src/tools/subscribe_newsletter.ts +47 -0
  220. package/templates/apps/mcp/src/tools/update_page.ts +91 -0
  221. package/templates/apps/mcp/tsconfig.json +19 -0
  222. package/templates/apps/web/.env.example +47 -0
  223. package/templates/apps/web/CLAUDE.md +81 -0
  224. package/templates/apps/web/__tests__/auth/adversarial/cookie-attributes.test.ts +94 -0
  225. package/templates/apps/web/__tests__/auth/adversarial/oauth-state-parameter.test.ts +75 -0
  226. package/templates/apps/web/__tests__/auth/adversarial/redirect-uri-allowlist.test.ts +82 -0
  227. package/templates/apps/web/__tests__/auth/env-helpers.test.ts +168 -0
  228. package/templates/apps/web/__tests__/authority-list-routes.test.tsx +208 -0
  229. package/templates/apps/web/__tests__/better-stack.test.ts +66 -0
  230. package/templates/apps/web/__tests__/blog-dir-resolution.test.ts +87 -0
  231. package/templates/apps/web/__tests__/blog-source-populated.test.ts +130 -0
  232. package/templates/apps/web/__tests__/data-testid-coverage.test.tsx +60 -0
  233. package/templates/apps/web/__tests__/google-analytics.test.tsx +104 -0
  234. package/templates/apps/web/__tests__/i18n/middleware.test.ts +119 -0
  235. package/templates/apps/web/__tests__/i18n/routing.test.ts +114 -0
  236. package/templates/apps/web/__tests__/i18n/translations.test.ts +191 -0
  237. package/templates/apps/web/__tests__/json-ld.test.ts +98 -0
  238. package/templates/apps/web/__tests__/knowledge-events-routes.test.tsx +580 -0
  239. package/templates/apps/web/__tests__/layout-stealth.test.ts +39 -0
  240. package/templates/apps/web/__tests__/lighthouse-fixtures/improvement-image-shrink.tsx +103 -0
  241. package/templates/apps/web/__tests__/lighthouse-fixtures/override-fixture.md +114 -0
  242. package/templates/apps/web/__tests__/lighthouse-fixtures/regression-bloat.tsx +94 -0
  243. package/templates/apps/web/__tests__/page.test.tsx +230 -0
  244. package/templates/apps/web/__tests__/products-services-phase1.test.tsx +321 -0
  245. package/templates/apps/web/__tests__/projects-routes.test.tsx +392 -0
  246. package/templates/apps/web/__tests__/resources-downloads-integrations-phase2.test.tsx +475 -0
  247. package/templates/apps/web/__tests__/routes/ai-plugin-json.test.ts +53 -0
  248. package/templates/apps/web/__tests__/routes/blog-route.test.tsx +191 -0
  249. package/templates/apps/web/__tests__/routes/llms-txt.test.ts +123 -0
  250. package/templates/apps/web/__tests__/routes/robots-txt.test.ts +52 -0
  251. package/templates/apps/web/__tests__/routes/sitemap-xml.test.ts +78 -0
  252. package/templates/apps/web/__tests__/routes/well-known-mcp.test.ts +203 -0
  253. package/templates/apps/web/__tests__/section-routes.test.tsx +693 -0
  254. package/templates/apps/web/__tests__/security-headers.test.ts +201 -0
  255. package/templates/apps/web/__tests__/sentry-config.test.ts +116 -0
  256. package/templates/apps/web/__tests__/setup.ts +82 -0
  257. package/templates/apps/web/__tests__/sitemap-locales.test.ts +415 -0
  258. package/templates/apps/web/__tests__/standalone-informational-routes.test.tsx +844 -0
  259. package/templates/apps/web/app/.well-known/ai-plugin.json/route.ts +81 -0
  260. package/templates/apps/web/app/.well-known/mcp.json/build-manifest.ts +110 -0
  261. package/templates/apps/web/app/.well-known/mcp.json/route.ts +58 -0
  262. package/templates/apps/web/app/[locale]/__tests__/layout.test.tsx +120 -0
  263. package/templates/apps/web/app/[locale]/__tests__/page-renderer-migration.test.tsx +202 -0
  264. package/templates/apps/web/app/[locale]/about/page.tsx +31 -0
  265. package/templates/apps/web/app/[locale]/blog/[[...slug]]/page.tsx +173 -0
  266. package/templates/apps/web/app/[locale]/careers/[slug]/page.tsx +45 -0
  267. package/templates/apps/web/app/[locale]/careers/__tests__/page-renderer-migration.test.tsx +117 -0
  268. package/templates/apps/web/app/[locale]/careers/page.tsx +25 -0
  269. package/templates/apps/web/app/[locale]/case-studies/[slug]/page.tsx +44 -0
  270. package/templates/apps/web/app/[locale]/case-studies/__tests__/page-renderer-migration.test.tsx +113 -0
  271. package/templates/apps/web/app/[locale]/case-studies/page.tsx +25 -0
  272. package/templates/apps/web/app/[locale]/clients/__tests__/page-renderer-migration.test.tsx +63 -0
  273. package/templates/apps/web/app/[locale]/clients/page.tsx +27 -0
  274. package/templates/apps/web/app/[locale]/contact/ContactForm.tsx +130 -0
  275. package/templates/apps/web/app/[locale]/contact/__tests__/contact.actions.test.ts +152 -0
  276. package/templates/apps/web/app/[locale]/contact/__tests__/page-renderer-migration.test.tsx +92 -0
  277. package/templates/apps/web/app/[locale]/contact/contact.actions.ts +79 -0
  278. package/templates/apps/web/app/[locale]/contact/error.tsx +24 -0
  279. package/templates/apps/web/app/[locale]/contact/page.tsx +38 -0
  280. package/templates/apps/web/app/[locale]/courses/[slug]/page.tsx +34 -0
  281. package/templates/apps/web/app/[locale]/courses/__tests__/page-renderer-migration.test.tsx +119 -0
  282. package/templates/apps/web/app/[locale]/courses/page.tsx +25 -0
  283. package/templates/apps/web/app/[locale]/dev/purchase/__tests__/actions.test.ts +160 -0
  284. package/templates/apps/web/app/[locale]/dev/purchase/error.tsx +25 -0
  285. package/templates/apps/web/app/[locale]/dev/purchase/page.tsx +117 -0
  286. package/templates/apps/web/app/[locale]/dev/purchase/purchase.actions.ts +58 -0
  287. package/templates/apps/web/app/[locale]/docs/[[...slug]]/page.tsx +118 -0
  288. package/templates/apps/web/app/[locale]/downloads/__tests__/page-renderer-migration.test.tsx +72 -0
  289. package/templates/apps/web/app/[locale]/downloads/page.tsx +25 -0
  290. package/templates/apps/web/app/[locale]/events/[slug]/page.tsx +47 -0
  291. package/templates/apps/web/app/[locale]/events/__tests__/page-renderer-migration.test.tsx +130 -0
  292. package/templates/apps/web/app/[locale]/events/page.tsx +25 -0
  293. package/templates/apps/web/app/[locale]/faq/page.tsx +36 -0
  294. package/templates/apps/web/app/[locale]/how-to/[slug]/page.tsx +34 -0
  295. package/templates/apps/web/app/[locale]/how-to/__tests__/page-renderer-migration.test.tsx +78 -0
  296. package/templates/apps/web/app/[locale]/how-to/page.tsx +40 -0
  297. package/templates/apps/web/app/[locale]/integrations/[slug]/page.tsx +43 -0
  298. package/templates/apps/web/app/[locale]/integrations/__tests__/page-renderer-migration.test.tsx +129 -0
  299. package/templates/apps/web/app/[locale]/integrations/page.tsx +25 -0
  300. package/templates/apps/web/app/[locale]/launch-service/page.tsx +31 -0
  301. package/templates/apps/web/app/[locale]/layout.tsx +241 -0
  302. package/templates/apps/web/app/[locale]/page.tsx +41 -0
  303. package/templates/apps/web/app/[locale]/partners/[slug]/page.tsx +44 -0
  304. package/templates/apps/web/app/[locale]/partners/__tests__/page-renderer-migration.test.tsx +113 -0
  305. package/templates/apps/web/app/[locale]/partners/page.tsx +25 -0
  306. package/templates/apps/web/app/[locale]/products/[slug]/page.tsx +43 -0
  307. package/templates/apps/web/app/[locale]/products/__tests__/page-renderer-migration.test.tsx +129 -0
  308. package/templates/apps/web/app/[locale]/products/page.tsx +25 -0
  309. package/templates/apps/web/app/[locale]/projects/[slug]/page.tsx +39 -0
  310. package/templates/apps/web/app/[locale]/projects/__tests__/page-renderer-migration.test.tsx +138 -0
  311. package/templates/apps/web/app/[locale]/projects/page.tsx +30 -0
  312. package/templates/apps/web/app/[locale]/resources/[slug]/page.tsx +51 -0
  313. package/templates/apps/web/app/[locale]/resources/__tests__/page-renderer-migration.test.tsx +117 -0
  314. package/templates/apps/web/app/[locale]/resources/page.tsx +27 -0
  315. package/templates/apps/web/app/[locale]/services/[slug]/page.tsx +43 -0
  316. package/templates/apps/web/app/[locale]/services/__tests__/page-renderer-migration.test.tsx +129 -0
  317. package/templates/apps/web/app/[locale]/services/page.tsx +25 -0
  318. package/templates/apps/web/app/[locale]/software/[slug]/page.tsx +34 -0
  319. package/templates/apps/web/app/[locale]/software/__tests__/page-renderer-migration.test.tsx +81 -0
  320. package/templates/apps/web/app/[locale]/software/page.tsx +39 -0
  321. package/templates/apps/web/app/[locale]/tech-articles/[slug]/page.tsx +34 -0
  322. package/templates/apps/web/app/[locale]/tech-articles/__tests__/page-renderer-migration.test.tsx +82 -0
  323. package/templates/apps/web/app/[locale]/tech-articles/page.tsx +39 -0
  324. package/templates/apps/web/app/[locale]/testimonials/__tests__/page-renderer-migration.test.tsx +63 -0
  325. package/templates/apps/web/app/[locale]/testimonials/page.tsx +27 -0
  326. package/templates/apps/web/app/[locale]/use-cases/__tests__/page-renderer-migration.test.tsx +63 -0
  327. package/templates/apps/web/app/[locale]/use-cases/page.tsx +27 -0
  328. package/templates/apps/web/app/[locale]/whitepapers/[slug]/page.tsx +34 -0
  329. package/templates/apps/web/app/[locale]/whitepapers/__tests__/page-renderer-migration.test.tsx +82 -0
  330. package/templates/apps/web/app/[locale]/whitepapers/page.tsx +39 -0
  331. package/templates/apps/web/app/__tests__/error-boundaries.test.tsx +152 -0
  332. package/templates/apps/web/app/api/auth/[...all]/route.ts +16 -0
  333. package/templates/apps/web/app/error-fallback.tsx +75 -0
  334. package/templates/apps/web/app/error.tsx +23 -0
  335. package/templates/apps/web/app/layout.tsx +18 -0
  336. package/templates/apps/web/app/llms.txt/route.ts +101 -0
  337. package/templates/apps/web/app/not-found.tsx +48 -0
  338. package/templates/apps/web/app/og/__tests__/route.test.ts +164 -0
  339. package/templates/apps/web/app/og/route.tsx +135 -0
  340. package/templates/apps/web/app/robots.txt/route.ts +36 -0
  341. package/templates/apps/web/app/sitemap.xml/route.ts +146 -0
  342. package/templates/apps/web/auth.ts +141 -0
  343. package/templates/apps/web/components/ThemeToggle.tsx +60 -0
  344. package/templates/apps/web/components/google-analytics.tsx +34 -0
  345. package/templates/apps/web/content/en/blog/index.mdx +15 -0
  346. package/templates/apps/web/content/en/blog/launching-ailk.mdx +20 -0
  347. package/templates/apps/web/content/en/docs/getting-started.mdx +30 -0
  348. package/templates/apps/web/i18n/request.ts +36 -0
  349. package/templates/apps/web/jest.config.cjs +100 -0
  350. package/templates/apps/web/lib/__mocks__/next-mdx-remote-rsc.js +12 -0
  351. package/templates/apps/web/lib/__mocks__/source-server.js +31 -0
  352. package/templates/apps/web/lib/__tests__/og.test.ts +65 -0
  353. package/templates/apps/web/lib/auth-env.ts +66 -0
  354. package/templates/apps/web/lib/blog-list-data.ts +95 -0
  355. package/templates/apps/web/lib/blog-post-data.ts +79 -0
  356. package/templates/apps/web/lib/nav-config.ts +13 -0
  357. package/templates/apps/web/lib/observability/better-stack.ts +27 -0
  358. package/templates/apps/web/lib/og.ts +23 -0
  359. package/templates/apps/web/lib/prisma-for-auth.ts +34 -0
  360. package/templates/apps/web/lib/source.ts +34 -0
  361. package/templates/apps/web/messages/en.json +131 -0
  362. package/templates/apps/web/middleware.ts +80 -0
  363. package/templates/apps/web/next.config.mjs +167 -0
  364. package/templates/apps/web/package.json +62 -0
  365. package/templates/apps/web/public/.well-known/security.txt +17 -0
  366. package/templates/apps/web/public/android-chrome-192x192.png +0 -0
  367. package/templates/apps/web/public/android-chrome-512x512.png +0 -0
  368. package/templates/apps/web/public/apple-touch-icon.png +0 -0
  369. package/templates/apps/web/public/favicon-16x16.png +0 -0
  370. package/templates/apps/web/public/favicon-32x32.png +0 -0
  371. package/templates/apps/web/public/favicon.ico +0 -0
  372. package/templates/apps/web/public/favicon.svg +4 -0
  373. package/templates/apps/web/public/logo-dark.svg +21 -0
  374. package/templates/apps/web/public/logo-light.svg +21 -0
  375. package/templates/apps/web/public/logomark-dark.svg +4 -0
  376. package/templates/apps/web/public/logomark-light.svg +4 -0
  377. package/templates/apps/web/public/og-default.png +0 -0
  378. package/templates/apps/web/public/site.webmanifest +19 -0
  379. package/templates/apps/web/scripts/assert-content-bundled.ts +55 -0
  380. package/templates/apps/web/security-headers.config.ts +132 -0
  381. package/templates/apps/web/sentry.client.config.ts +27 -0
  382. package/templates/apps/web/sentry.edge.config.ts +15 -0
  383. package/templates/apps/web/sentry.server.config.ts +20 -0
  384. package/templates/apps/web/source.config.ts +78 -0
  385. package/templates/apps/web/src/components/SiteNav.tsx +21 -0
  386. package/templates/apps/web/src/lib/routes.ts +37 -0
  387. package/templates/apps/web/tsconfig.json +35 -0
  388. package/templates/apps/web/types/messages.d.ts +19 -0
  389. package/templates/content/.gitkeep +0 -0
  390. package/templates/content/CLAUDE.md +85 -0
  391. package/templates/content/_site.mdx +38 -0
  392. package/templates/content/ar/HomePage/home.mdx +123 -0
  393. package/templates/content/ar/_site.mdx +35 -0
  394. package/templates/content/de/_site.mdx +29 -0
  395. package/templates/content/en/.gitkeep +0 -0
  396. package/templates/content/en/AboutPage/about.mdx +19 -0
  397. package/templates/content/en/AboutPage/about.schema.json +82 -0
  398. package/templates/content/en/BookCall/book-call.mdx +19 -0
  399. package/templates/content/en/BookCall/book-call.schema.json +121 -0
  400. package/templates/content/en/BreadcrumbList/site-breadcrumbs.mdx +20 -0
  401. package/templates/content/en/CareersList/careers.mdx +24 -0
  402. package/templates/content/en/CaseStudiesList/case-studies.mdx +22 -0
  403. package/templates/content/en/CaseStudiesList/showcase.mdx +8 -0
  404. package/templates/content/en/CaseStudy/ailk-aeo-rollout.mdx +32 -0
  405. package/templates/content/en/CaseStudy/schema-builder-migration.mdx +41 -0
  406. package/templates/content/en/ClientsList/clients.mdx +38 -0
  407. package/templates/content/en/ContactPage/contact.mdx +19 -0
  408. package/templates/content/en/ContactPage/contact.schema.json +100 -0
  409. package/templates/content/en/ContactPoint/primary.mdx +14 -0
  410. package/templates/content/en/Course/aeo-fundamentals.mdx +37 -0
  411. package/templates/content/en/Course/schema-builder-workshop.mdx +62 -0
  412. package/templates/content/en/CoursesList/courses.mdx +22 -0
  413. package/templates/content/en/DownloadsList/downloads.mdx +22 -0
  414. package/templates/content/en/Event/aeo-office-hours-may-2026.mdx +39 -0
  415. package/templates/content/en/Event/ailk-launch-day-2026.mdx +35 -0
  416. package/templates/content/en/EventsList/events.mdx +26 -0
  417. package/templates/content/en/FAQPage/faq.mdx +420 -0
  418. package/templates/content/en/FAQPage/faq.schema.json +231 -0
  419. package/templates/content/en/GlossaryList/glossary.mdx +19 -0
  420. package/templates/content/en/GlossaryList/glossary.schema.json +300 -0
  421. package/templates/content/en/HomePage/home.mdx +312 -0
  422. package/templates/content/en/HomePage/home.schema.json +88 -0
  423. package/templates/content/en/HomePage/launch-service.mdx +475 -0
  424. package/templates/content/en/HomePage/launch-service.schema.json +138 -0
  425. package/templates/content/en/HowTo/add-mdx-content.mdx +38 -0
  426. package/templates/content/en/HowTo/configure-aeo-scoring.mdx +35 -0
  427. package/templates/content/en/HowTo/set-up-json-ld.mdx +36 -0
  428. package/templates/content/en/Integration/github-actions.mdx +31 -0
  429. package/templates/content/en/Integration/openai-api.mdx +26 -0
  430. package/templates/content/en/Integration/vercel.mdx +32 -0
  431. package/templates/content/en/IntegrationsList/integrations.mdx +22 -0
  432. package/templates/content/en/JobPosting/content-strategist.mdx +46 -0
  433. package/templates/content/en/JobPosting/developer-advocate.mdx +47 -0
  434. package/templates/content/en/JobPosting/senior-fullstack-engineer.mdx +57 -0
  435. package/templates/content/en/LandingPage/aeo-audit.mdx +19 -0
  436. package/templates/content/en/LandingPage/aeo-audit.schema.json +92 -0
  437. package/templates/content/en/LandingPage/agency-waitlist.mdx +340 -0
  438. package/templates/content/en/LandingPage/agency-waitlist.schema.json +152 -0
  439. package/templates/content/en/LandingPage/developers.mdx +19 -0
  440. package/templates/content/en/LandingPage/developers.schema.json +109 -0
  441. package/templates/content/en/LandingPage/for-agencies.mdx +390 -0
  442. package/templates/content/en/LandingPage/for-agencies.schema.json +107 -0
  443. package/templates/content/en/LandingPage/for-ai-search-agencies.mdx +417 -0
  444. package/templates/content/en/LandingPage/for-ai-search-agencies.schema.json +105 -0
  445. package/templates/content/en/LandingPage/for-businesses.mdx +19 -0
  446. package/templates/content/en/LandingPage/for-businesses.schema.json +96 -0
  447. package/templates/content/en/LandingPage/platform.mdx +369 -0
  448. package/templates/content/en/LandingPage/platform.schema.json +166 -0
  449. package/templates/content/en/LandingPage/vs-ai-website-builders.mdx +19 -0
  450. package/templates/content/en/LandingPage/vs-ai-website-builders.schema.json +102 -0
  451. package/templates/content/en/LandingPage/vs-wordpress.mdx +19 -0
  452. package/templates/content/en/LandingPage/vs-wordpress.schema.json +53 -0
  453. package/templates/content/en/NewsletterSignup/newsletter.mdx +236 -0
  454. package/templates/content/en/NewsletterSignup/newsletter.schema.json +91 -0
  455. package/templates/content/en/Organization/site-owner.mdx +16 -0
  456. package/templates/content/en/Partner/prisma.mdx +31 -0
  457. package/templates/content/en/Partner/supabase.mdx +30 -0
  458. package/templates/content/en/Partner/vercel.mdx +28 -0
  459. package/templates/content/en/PartnersList/partners.mdx +22 -0
  460. package/templates/content/en/Person/founder.mdx +18 -0
  461. package/templates/content/en/Pricing/pricing.mdx +538 -0
  462. package/templates/content/en/Pricing/pricing.schema.json +209 -0
  463. package/templates/content/en/PrivacyPage/privacy.mdx +165 -0
  464. package/templates/content/en/PrivacyPage/privacy.schema.json +64 -0
  465. package/templates/content/en/Product/ailk.mdx +19 -0
  466. package/templates/content/en/Product/ailk.schema.json +94 -0
  467. package/templates/content/en/Product/api-launch-kit.mdx +26 -0
  468. package/templates/content/en/Product/launch-kit.mdx +28 -0
  469. package/templates/content/en/ProductsList/products.mdx +26 -0
  470. package/templates/content/en/Project/ailk-phase-2.mdx +54 -0
  471. package/templates/content/en/ProjectsList/projects.mdx +25 -0
  472. package/templates/content/en/ResourceDetail/aeo-scoring-guide.mdx +27 -0
  473. package/templates/content/en/ResourceDetail/content-model-whitepaper.mdx +28 -0
  474. package/templates/content/en/ResourceDetail/schema-org-quick-reference.mdx +39 -0
  475. package/templates/content/en/ResourcesHub/resources.mdx +22 -0
  476. package/templates/content/en/Service/consulting.mdx +22 -0
  477. package/templates/content/en/Service/implementation.mdx +30 -0
  478. package/templates/content/en/Service/launch-service.mdx +232 -0
  479. package/templates/content/en/Service/launch.mdx +228 -0
  480. package/templates/content/en/ServicesList/services.mdx +84 -0
  481. package/templates/content/en/SoftwareProduct/ailk-aeo.mdx +44 -0
  482. package/templates/content/en/SoftwareProduct/ailk-content-adapters.mdx +47 -0
  483. package/templates/content/en/SoftwareProduct/ailk-schema.mdx +49 -0
  484. package/templates/content/en/TeamList/team.mdx +63 -0
  485. package/templates/content/en/TeamMember/founder.mdx +72 -0
  486. package/templates/content/en/TermsPage/terms.mdx +19 -0
  487. package/templates/content/en/TermsPage/terms.schema.json +99 -0
  488. package/templates/content/en/TestimonialsList/testimonials.mdx +44 -0
  489. package/templates/content/en/UseCasesList/use-cases.mdx +30 -0
  490. package/templates/content/en/Whitepaper/ax-first-product-development.mdx +27 -0
  491. package/templates/content/en/Whitepaper/open-core-commercial-strategy.mdx +27 -0
  492. package/templates/content/en/Whitepaper/structured-data-for-answer-engines.mdx +31 -0
  493. package/templates/content/en-XA/AboutPage/about.mdx +8 -0
  494. package/templates/content/en-XA/FAQPage/faq.mdx +8 -0
  495. package/templates/content/en-XA/HomePage/home.mdx +8 -0
  496. package/templates/content/es/_site.mdx +30 -0
  497. package/templates/content/fr/_site.mdx +30 -0
  498. package/templates/content/ja/_site.mdx +30 -0
  499. package/templates/content/pt-BR/AboutPage/about.mdx +8 -0
  500. package/templates/content/pt-BR/FAQPage/faq.mdx +8 -0
  501. package/templates/content/pt-BR/HomePage/home.mdx +23 -0
  502. package/templates/database/CHANGELOG.md +5 -0
  503. package/templates/database/README.md +234 -0
  504. package/templates/database/__tests__/user-cascade.test.ts +125 -0
  505. package/templates/database/auth/.gitkeep +0 -0
  506. package/templates/database/config/.gitkeep +0 -0
  507. package/templates/database/content/.gitkeep +0 -0
  508. package/templates/database/inbox/.gitkeep +0 -0
  509. package/templates/database/inbox/README.md +3 -0
  510. package/templates/database/inbox/__tests__/schema.test.ts +40 -0
  511. package/templates/database/inbox/schema.prisma +52 -0
  512. package/templates/database/jest.config.cjs +29 -0
  513. package/templates/database/migrations/20260508000000_add_inbox_namespace/migration.sql +328 -0
  514. package/templates/database/migrations/20260513000000_better_auth_migration/migration.sql +100 -0
  515. package/templates/database/migrations/20260515000000_add_user_billing_fields/migration.sql +28 -0
  516. package/templates/database/migrations/20260516000000_add_user_tier_care_plan_seat/migration.sql +25 -0
  517. package/templates/database/migrations/20260518000000_add_telemetry_records/migration.sql +42 -0
  518. package/templates/database/migrations/20260525000000_theme_wiring/migration.sql +67 -0
  519. package/templates/database/migrations/20260710000000_retire_commercial_tier/migration.sql +21 -0
  520. package/templates/database/migrations/migration_lock.toml +3 -0
  521. package/templates/database/ops/.gitkeep +0 -0
  522. package/templates/database/package.json +45 -0
  523. package/templates/database/prisma.config.ts +20 -0
  524. package/templates/database/schema.prisma +487 -0
  525. package/templates/database/scripts/db-generate-locked.sh +80 -0
  526. package/templates/database/seed-test.ts +85 -0
  527. package/templates/database/tsconfig.build.json +16 -0
  528. package/templates/database/tsconfig.json +9 -0
  529. package/templates/package.json +125 -0
  530. package/templates/pnpm-workspace.yaml +6 -0
  531. package/templates/project.yaml +59 -0
  532. package/templates/tsconfig.base.json +18 -0
  533. package/templates/tsconfig.json +45 -0
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Slug allowlist for D14a content-write routes.
3
+ *
4
+ * Re-exported from `@working-theory/content-adapters` (single source of truth, per
5
+ * issue #398). The adapter sanitizes slug + type before any path
6
+ * construction or git argument; this regex is the route-layer fail-fast
7
+ * mirror so malformed input gets a 400 before reaching the adapter.
8
+ */
9
+ export { SLUG_PATTERN } from "@working-theory/content-adapters";
@@ -0,0 +1,111 @@
1
+ /**
2
+ * PATCH /v1/content/:type/:slug
3
+ *
4
+ * Updates an existing page of `:type` at `:slug`. Paid-licensed deploys only.
5
+ *
6
+ * Optimistic locking is mandatory: the request MUST carry an `If-Match`
7
+ * header containing the `version` token returned by a prior read or write.
8
+ * Missing/empty header → 409. Stale token → 409 with `details.currentVersion`
9
+ * echoed so the caller can re-fetch and retry.
10
+ *
11
+ * 404 when the page does not exist.
12
+ *
13
+ * Adapter errors (`AdapterWriteError("not_found" | "conflict" | …)`) are
14
+ * translated by the hoisted `mapAdapterError` from `@working-theory/content-adapters`
15
+ * (issue #398) — single source of truth across the API + MCP surfaces.
16
+ */
17
+ import {
18
+ FrontmatterSchema,
19
+ SCHEMA_ORG_TYPES,
20
+ type SchemaOrgType,
21
+ } from "@working-theory/content-adapters";
22
+ import type { FastifyPluginAsync, FastifyReply } from "fastify";
23
+ import { z } from "zod";
24
+
25
+ import { getContentAdapter } from "../../lib/content-adapter.js";
26
+ import {
27
+ adapterErrorResponse,
28
+ conflictError,
29
+ validationError,
30
+ type ErrorBody,
31
+ } from "../../lib/errors.js";
32
+ import { requirePaidTier } from "../../lib/require-paid-tier.js";
33
+
34
+ import { SLUG_PATTERN } from "./slug.js";
35
+
36
+ const paramsSchema = z.object({
37
+ type: z.enum(SCHEMA_ORG_TYPES),
38
+ slug: z.string().regex(SLUG_PATTERN),
39
+ });
40
+
41
+ const writeBodySchema = FrontmatterSchema.extend({ body: z.string().min(1) });
42
+
43
+ function send(reply: FastifyReply, status: number, body: ErrorBody) {
44
+ return reply.status(status).send(body);
45
+ }
46
+
47
+ export const updatePageRoute: FastifyPluginAsync = async (fastify) => {
48
+ fastify.patch<{
49
+ Params: { type: string; slug: string };
50
+ Body: unknown;
51
+ }>(
52
+ "/v1/content/:type/:slug",
53
+
54
+ { preHandler: requirePaidTier },
55
+ async (request, reply) => {
56
+ const params = paramsSchema.safeParse(request.params);
57
+ if (!params.success) {
58
+ const err = validationError("Invalid type or slug", {
59
+ issues: params.error.issues,
60
+ });
61
+ return send(reply, err.status, err.body);
62
+ }
63
+
64
+ const ifMatch = request.headers["if-match"];
65
+ if (typeof ifMatch !== "string" || ifMatch.length === 0) {
66
+ const err = conflictError(
67
+ "Missing required If-Match header (version token)",
68
+ );
69
+ return send(reply, err.status, err.body);
70
+ }
71
+
72
+ const parsed = writeBodySchema.safeParse(request.body);
73
+ if (!parsed.success) {
74
+ const err = validationError("Invalid request body", {
75
+ issues: parsed.error.issues,
76
+ });
77
+ return send(reply, err.status, err.body);
78
+ }
79
+
80
+ const { type, slug } = params.data;
81
+ const { body: pageBody, ...page } = parsed.data;
82
+
83
+ if (page.type !== type || page.slug !== slug) {
84
+ const err = validationError(
85
+ "Body `type`/`slug` must match URL params",
86
+ {
87
+ url: { type, slug },
88
+ body: { type: page.type, slug: page.slug },
89
+ },
90
+ );
91
+ return send(reply, err.status, err.body);
92
+ }
93
+
94
+ try {
95
+ const adapter = getContentAdapter();
96
+ const result = await adapter.updatePage(
97
+ type as SchemaOrgType,
98
+ slug,
99
+ { ...page, body: pageBody },
100
+ { ifMatch },
101
+ );
102
+ return reply.status(200).send(result);
103
+ } catch (error) {
104
+ const err = adapterErrorResponse(error, { type, slug });
105
+ if (err) return send(reply, err.status, err.body);
106
+ request.log.error({ err: error }, "[Content] updatePage failed");
107
+ return reply.status(500).send({ error: "Internal server error" });
108
+ }
109
+ },
110
+ );
111
+ };
@@ -0,0 +1,415 @@
1
+ /**
2
+ * @file index.test.ts
3
+ * Route-level inject tests for POST /api/leads/:kind
4
+ *
5
+ * Property under test: attacker-supplied `id` in the request body is never
6
+ * persisted. buildInput() explicitly destructures only known fields (first wall).
7
+ * The discriminatedUnion .strict() schema rejects unknown keys (second wall).
8
+ *
9
+ * These tests exercise both walls together at the HTTP boundary.
10
+ *
11
+ * Real dependencies (Issue #507):
12
+ * - appendLeadRecord (lead-capture-store): real — writes to LEAD_CAPTURE_FILE temp file
13
+ * - writeLeadFallback (file-fallback): real — writes to AILK_INBOX_FALLBACK_DIR temp dir
14
+ * - enrichLead (enrichment-shim): real — pass-through shim (no network calls in tests)
15
+ *
16
+ * Mocked:
17
+ * - prisma (lib/prisma.js): manual mock via __mocks__/prisma.ts — inbox models added
18
+ * - @working-theory/email: external package boundary — stays mocked
19
+ * - @working-theory/license: consumed by enrichment-shim; stays mocked to avoid license key dep
20
+ */
21
+
22
+ import * as fs from "fs/promises";
23
+
24
+ import type { FastifyInstance } from "fastify";
25
+
26
+ // eslint-disable-next-line no-restricted-syntax -- prisma is a DB boundary; __mocks__/prisma.ts activates the auto-mock (Jest requires explicit call for local files)
27
+ jest.mock("../../../lib/prisma.js");
28
+
29
+ jest.mock("@working-theory/email", () => ({
30
+ sendLeadNotification: jest.fn().mockResolvedValue({
31
+ ok: true,
32
+ messageId: "msg-test",
33
+ }),
34
+ }));
35
+
36
+ // @working-theory/license: consumed transitively by enrichment-shim; mocked to avoid
37
+ // needing a license key in tests.
38
+ jest.mock("@working-theory/license", () => ({
39
+ checkLicense: jest.fn().mockResolvedValue({
40
+ tier: "free",
41
+ plan: null,
42
+ features: [],
43
+ expiresAt: null,
44
+ revoked: false,
45
+ }),
46
+ }));
47
+
48
+ import {
49
+ leadSubmitRoute,
50
+ leadSubscribeRoute,
51
+ leadCallbackRoute,
52
+ } from "../index";
53
+ import { prisma } from "../../../lib/prisma.js";
54
+ import { setupLeadFileEnv } from "../../../__tests__/factories/lead-fixture";
55
+
56
+ const fileEnv = setupLeadFileEnv("index");
57
+
58
+ // ─── Suite setup ──────────────────────────────────────────────────────────────
59
+
60
+ describe("POST /api/leads — id isolation", () => {
61
+ let app: FastifyInstance;
62
+
63
+ beforeEach(async () => {
64
+ jest.clearAllMocks();
65
+ process.env.AILK_LEAD_NOTIFICATION_TO = "owner@example.com";
66
+ process.env.AILK_LEAD_NOTIFICATION_FROM = "noreply@example.com";
67
+ process.env.DATABASE_URL = "postgres://stub";
68
+
69
+ const fastify = require("fastify")();
70
+ await fastify.register(leadSubmitRoute);
71
+ await fastify.register(leadSubscribeRoute);
72
+ await fastify.register(leadCallbackRoute);
73
+ app = fastify;
74
+ });
75
+
76
+ afterEach(async () => {
77
+ await app.close();
78
+ delete process.env.AILK_LEAD_NOTIFICATION_TO;
79
+ delete process.env.AILK_LEAD_NOTIFICATION_FROM;
80
+ delete process.env.DATABASE_URL;
81
+ delete process.env.LEAD_CAPTURE_FILE_DISABLED;
82
+ delete process.env.LEAD_CAPTURE_INCLUDE_IP;
83
+ });
84
+
85
+ it("POST /api/leads/lead — attacker-supplied id is not returned (server uuid used)", async () => {
86
+ const serverGeneratedId = "cuid-lead-server-1";
87
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
88
+
89
+ const res = await app.inject({
90
+ method: "POST",
91
+ url: "/v1/leads/lead",
92
+ payload: {
93
+ id: "attacker",
94
+ kind: "lead",
95
+ siteId: "site-abc",
96
+ source: "contact",
97
+ email: "test@example.com",
98
+ payload: { message: "hello" },
99
+ },
100
+ });
101
+
102
+ // buildInput drops `id` before it reaches validation or persistence.
103
+ // The schema's .strict() would also reject it — both walls active.
104
+ expect([201, 400]).toContain(res.statusCode);
105
+ if (res.statusCode === 201) {
106
+ const body = res.json();
107
+ expect(body.id).not.toBe("attacker");
108
+ expect(body.id).toBe(serverGeneratedId);
109
+ }
110
+ });
111
+
112
+ it("POST /api/leads/subscribe — attacker-supplied id is not returned (server uuid used)", async () => {
113
+ const serverGeneratedId = "cuid-sub-server-1";
114
+ (prisma.subscriber.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
115
+
116
+ const res = await app.inject({
117
+ method: "POST",
118
+ url: "/v1/leads/subscribe",
119
+ payload: {
120
+ id: "attacker",
121
+ kind: "subscribe",
122
+ siteId: "site-abc",
123
+ email: "sub@example.com",
124
+ source: "footer",
125
+ },
126
+ });
127
+
128
+ expect([201, 400]).toContain(res.statusCode);
129
+ if (res.statusCode === 201) {
130
+ const body = res.json();
131
+ expect(body.id).not.toBe("attacker");
132
+ expect(body.id).toBe(serverGeneratedId);
133
+ }
134
+ });
135
+
136
+ it("POST /api/leads/callback — attacker-supplied id is not returned (server uuid used)", async () => {
137
+ const serverGeneratedId = "cuid-cb-server-1";
138
+ (prisma.callback.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
139
+
140
+ const res = await app.inject({
141
+ method: "POST",
142
+ url: "/v1/leads/callback",
143
+ payload: {
144
+ id: "attacker",
145
+ kind: "callback",
146
+ siteId: "site-abc",
147
+ name: "Alice",
148
+ phone: "+15551234567",
149
+ payload: { notes: "urgent" },
150
+ },
151
+ });
152
+
153
+ expect([201, 400]).toContain(res.statusCode);
154
+ if (res.statusCode === 201) {
155
+ const body = res.json();
156
+ expect(body.id).not.toBe("attacker");
157
+ expect(body.id).toBe(serverGeneratedId);
158
+ }
159
+ });
160
+
161
+ // ── Lead capture store integration cases ──────────────────────────────────
162
+
163
+ it("file-on-success — appendLeadRecord writes to LEAD_CAPTURE_FILE on successful DB persist", async () => {
164
+ const serverGeneratedId = "cuid-file-success-1";
165
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
166
+
167
+ const res = await app.inject({
168
+ method: "POST",
169
+ url: "/v1/leads/lead",
170
+ payload: {
171
+ kind: "lead",
172
+ siteId: "site-abc",
173
+ source: "contact",
174
+ email: "test@example.com",
175
+ payload: { message: "hello" },
176
+ },
177
+ });
178
+
179
+ expect([201, 400]).toContain(res.statusCode);
180
+ if (res.statusCode === 201) {
181
+ expect(res.json().id).toBe(serverGeneratedId);
182
+ const record = await fileEnv.readLastCaptureRecord();
183
+ expect(record.id).toBe(serverGeneratedId);
184
+ expect(record.source).toBe("contact");
185
+ }
186
+ });
187
+
188
+ it("dual-write — real lead-capture-store AND DB are both invoked on success", async () => {
189
+ const serverGeneratedId = "cuid-dual-write-1";
190
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
191
+
192
+ const res = await app.inject({
193
+ method: "POST",
194
+ url: "/v1/leads/lead",
195
+ payload: {
196
+ kind: "lead",
197
+ siteId: "site-abc",
198
+ source: "contact",
199
+ email: "dual@example.com",
200
+ payload: { message: "dual-write test" },
201
+ },
202
+ });
203
+
204
+ if (res.statusCode === 201) {
205
+ expect(prisma.lead.create).toHaveBeenCalledTimes(1);
206
+ const record = await fileEnv.readLastCaptureRecord();
207
+ expect(typeof record.id).toBe("string");
208
+ }
209
+ });
210
+
211
+ it("disabled — appendLeadRecord is skipped when LEAD_CAPTURE_FILE_DISABLED=true", async () => {
212
+ process.env.LEAD_CAPTURE_FILE_DISABLED = "true";
213
+
214
+ const serverGeneratedId = "cuid-disabled-1";
215
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
216
+
217
+ const res = await app.inject({
218
+ method: "POST",
219
+ url: "/v1/leads/lead",
220
+ payload: {
221
+ kind: "lead",
222
+ siteId: "site-abc",
223
+ source: "contact",
224
+ email: "disabled@example.com",
225
+ payload: { message: "no file" },
226
+ },
227
+ });
228
+
229
+ expect([201, 400]).toContain(res.statusCode);
230
+ if (res.statusCode === 201) {
231
+ // The real lead-capture-store short-circuits when LEAD_CAPTURE_FILE_DISABLED=true.
232
+ // The capture file must not be written.
233
+ await expect(
234
+ fs.access(fileEnv.getCaptureFilePath()),
235
+ ).rejects.toThrow();
236
+ }
237
+ });
238
+
239
+ it("config_missing — 503 with lead_capture_not_configured when file disabled and no DATABASE_URL", async () => {
240
+ process.env.LEAD_CAPTURE_FILE_DISABLED = "true";
241
+ delete process.env.DATABASE_URL;
242
+
243
+ const res = await app.inject({
244
+ method: "POST",
245
+ url: "/v1/leads/lead",
246
+ payload: {
247
+ kind: "lead",
248
+ siteId: "site-abc",
249
+ source: "contact",
250
+ email: "nocapture@example.com",
251
+ payload: { message: "no config" },
252
+ },
253
+ });
254
+
255
+ expect(res.statusCode).toBe(503);
256
+ const body = res.json();
257
+ expect(body.error).toBe("lead_capture_not_configured");
258
+ expect(body.message).toBe("Lead capture is not configured.");
259
+ expect(prisma.lead.create).not.toHaveBeenCalled();
260
+ });
261
+
262
+ it("IP-include — metadata.ip present in capture record when LEAD_CAPTURE_INCLUDE_IP=true", async () => {
263
+ process.env.LEAD_CAPTURE_INCLUDE_IP = "true";
264
+ const serverGeneratedId = "cuid-ip-include-1";
265
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
266
+
267
+ const res = await app.inject({
268
+ method: "POST",
269
+ url: "/v1/leads/lead",
270
+ headers: { "x-forwarded-for": "1.2.3.4" },
271
+ payload: {
272
+ kind: "lead",
273
+ siteId: "site-abc",
274
+ source: "contact",
275
+ email: "ip@example.com",
276
+ payload: { message: "ip test" },
277
+ },
278
+ });
279
+
280
+ if (res.statusCode === 201) {
281
+ const record = await fileEnv.readLastCaptureRecord();
282
+ expect((record.metadata as Record<string, unknown>)).toHaveProperty("ip");
283
+ }
284
+ });
285
+
286
+ // ── buildInput branch coverage ─────────────────────────────────────────────
287
+
288
+ it("lead — payload absent from body defaults to empty object via ?? (payload ?? {} branch)", async () => {
289
+ const serverGeneratedId = "cuid-nopayload-1";
290
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
291
+
292
+ const bodyWithoutPayload: Record<string, unknown> = {
293
+ kind: "lead",
294
+ siteId: "site-abc",
295
+ source: "contact",
296
+ email: "nopayload@example.com",
297
+ payload: undefined,
298
+ };
299
+
300
+ const res = await app.inject({
301
+ method: "POST",
302
+ url: "/v1/leads/lead",
303
+ payload: bodyWithoutPayload,
304
+ });
305
+
306
+ expect([201, 400]).toContain(res.statusCode);
307
+ if (res.statusCode === 201) {
308
+ expect(res.json().id).toBe(serverGeneratedId);
309
+ }
310
+ });
311
+
312
+ it("callback — preferredTime included when provided (preferredTime spread branch)", async () => {
313
+ const serverGeneratedId = "cuid-callback-ptime-1";
314
+ (prisma.callback.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
315
+
316
+ const res = await app.inject({
317
+ method: "POST",
318
+ url: "/v1/leads/callback",
319
+ payload: {
320
+ kind: "callback",
321
+ siteId: "site-abc",
322
+ name: "Alice",
323
+ phone: "+15551234567",
324
+ preferredTime: "morning",
325
+ payload: { notes: "prefers AM" },
326
+ },
327
+ });
328
+
329
+ expect([201, 400]).toContain(res.statusCode);
330
+ if (res.statusCode === 201) {
331
+ expect(res.json().id).toBe(serverGeneratedId);
332
+ }
333
+ });
334
+
335
+ it("callback — payload absent from body defaults to empty object via ?? (callback payload ?? {} branch)", async () => {
336
+ const serverGeneratedId = "cuid-callback-nopayload-1";
337
+ (prisma.callback.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
338
+
339
+ const bodyWithoutPayload: Record<string, unknown> = {
340
+ kind: "callback",
341
+ siteId: "site-abc",
342
+ name: "Bob",
343
+ phone: "+15559876543",
344
+ payload: undefined,
345
+ };
346
+
347
+ const res = await app.inject({
348
+ method: "POST",
349
+ url: "/v1/leads/callback",
350
+ payload: bodyWithoutPayload,
351
+ });
352
+
353
+ expect([201, 400]).toContain(res.statusCode);
354
+ if (res.statusCode === 201) {
355
+ expect(res.json().id).toBe(serverGeneratedId);
356
+ }
357
+ });
358
+
359
+ // ── emailKind branch coverage ──────────────────────────────────────────────
360
+
361
+ it("email skipped — emailKind=skipped logged when env vars are unset", async () => {
362
+ delete process.env.AILK_LEAD_NOTIFICATION_TO;
363
+ delete process.env.AILK_LEAD_NOTIFICATION_FROM;
364
+ const serverGeneratedId = "cuid-email-skipped-1";
365
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
366
+
367
+ const res = await app.inject({
368
+ method: "POST",
369
+ url: "/v1/leads/lead",
370
+ payload: {
371
+ kind: "lead",
372
+ siteId: "site-abc",
373
+ source: "contact",
374
+ email: "skipped@example.com",
375
+ payload: { message: "test" },
376
+ },
377
+ });
378
+
379
+ expect([201, 400]).toContain(res.statusCode);
380
+ if (res.statusCode === 201) {
381
+ const body = res.json();
382
+ expect(body.id).toBe(serverGeneratedId);
383
+ expect(body.email).toHaveProperty("skipped", true);
384
+ }
385
+ });
386
+
387
+ it("email error — emailKind=error logged when sendLeadNotification returns ok:false", async () => {
388
+ const { sendLeadNotification } = jest.requireMock("@working-theory/email");
389
+ (sendLeadNotification as jest.Mock).mockResolvedValueOnce({
390
+ ok: false,
391
+ error: { kind: "send_error", message: "SMTP timeout" },
392
+ });
393
+ const serverGeneratedId = "cuid-email-error-1";
394
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
395
+
396
+ const res = await app.inject({
397
+ method: "POST",
398
+ url: "/v1/leads/lead",
399
+ payload: {
400
+ kind: "lead",
401
+ siteId: "site-abc",
402
+ source: "contact",
403
+ email: "erroremail@example.com",
404
+ payload: { message: "test" },
405
+ },
406
+ });
407
+
408
+ expect([201, 400]).toContain(res.statusCode);
409
+ if (res.statusCode === 201) {
410
+ const body = res.json();
411
+ expect(body.id).toBe(serverGeneratedId);
412
+ expect(body.email).toHaveProperty("ok", false);
413
+ }
414
+ });
415
+ });
@@ -0,0 +1,165 @@
1
+ /**
2
+ * @file track.test.ts
3
+ * Verifies that track('lead-captured', ...) fires after successful persistence
4
+ * and does NOT fire on validation/persistence failure.
5
+ *
6
+ * Real dependencies (Issue #507):
7
+ * - appendLeadRecord (lead-capture-store): real — writes to LEAD_CAPTURE_FILE temp file
8
+ * - writeLeadFallback (file-fallback): real — writes to AILK_INBOX_FALLBACK_DIR temp dir
9
+ * - enrichLead (enrichment-shim): real — pass-through shim
10
+ *
11
+ * Mocked:
12
+ * - @working-theory/analytics/server: external package boundary — stays mocked
13
+ * - prisma (lib/prisma.js): manual mock via __mocks__/prisma.ts
14
+ * - @working-theory/email: external package boundary — stays mocked
15
+ * - @working-theory/license: consumed by enrichment-shim; stays mocked
16
+ */
17
+
18
+ import type { FastifyInstance } from "fastify";
19
+
20
+ const mockTrack = jest.fn().mockResolvedValue(undefined);
21
+
22
+ jest.mock("@working-theory/analytics/server", () => ({
23
+ track: (...args: unknown[]) => mockTrack(...args),
24
+ }));
25
+
26
+ // eslint-disable-next-line no-restricted-syntax -- prisma is a DB boundary; __mocks__/prisma.ts activates the auto-mock (Jest requires explicit call for local files)
27
+ jest.mock("../../../lib/prisma.js");
28
+
29
+ jest.mock("@working-theory/email", () => ({
30
+ sendLeadNotification: jest
31
+ .fn()
32
+ .mockResolvedValue({ ok: true, messageId: "msg-test" }),
33
+ }));
34
+
35
+ // @working-theory/license: consumed transitively by enrichment-shim; mocked to avoid
36
+ // needing a license key in tests.
37
+ jest.mock("@working-theory/license", () => ({
38
+ checkLicense: jest.fn().mockResolvedValue({
39
+ tier: "free",
40
+ plan: null,
41
+ features: [],
42
+ expiresAt: null,
43
+ revoked: false,
44
+ }),
45
+ }));
46
+
47
+ import { leadSubmitRoute } from "../index";
48
+ import { prisma } from "../../../lib/prisma.js";
49
+ import { setupLeadFileEnv } from "../../../__tests__/factories/lead-fixture";
50
+
51
+ setupLeadFileEnv("track");
52
+
53
+ // ─── Suite setup ──────────────────────────────────────────────────────────────
54
+
55
+ describe("POST /api/leads — track() telemetry", () => {
56
+ let app: FastifyInstance;
57
+
58
+ beforeEach(async () => {
59
+ jest.clearAllMocks();
60
+ process.env.AILK_LEAD_NOTIFICATION_TO = "owner@example.com";
61
+ process.env.AILK_LEAD_NOTIFICATION_FROM = "noreply@example.com";
62
+ process.env.DATABASE_URL = "postgres://stub";
63
+
64
+ const fastify = require("fastify")();
65
+ await fastify.register(leadSubmitRoute);
66
+ app = fastify;
67
+ });
68
+
69
+ afterEach(async () => {
70
+ await app.close();
71
+ delete process.env.AILK_LEAD_NOTIFICATION_TO;
72
+ delete process.env.AILK_LEAD_NOTIFICATION_FROM;
73
+ delete process.env.DATABASE_URL;
74
+ });
75
+
76
+ it("calls track('lead-captured') with source and locale on successful submission", async () => {
77
+ const serverGeneratedId = "cuid-track-success-1";
78
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
79
+
80
+ const res = await app.inject({
81
+ method: "POST",
82
+ url: "/v1/leads/lead",
83
+ payload: {
84
+ kind: "lead",
85
+ siteId: "site-abc",
86
+ source: "newsletter",
87
+ email: "test@example.com",
88
+ payload: { locale: "en-US" },
89
+ },
90
+ });
91
+
92
+ if (res.statusCode === 201) {
93
+ expect(mockTrack).toHaveBeenCalledTimes(1);
94
+ expect(mockTrack).toHaveBeenCalledWith(
95
+ "lead-captured",
96
+ expect.objectContaining({ source: "newsletter" }),
97
+ );
98
+ }
99
+ });
100
+
101
+ it("does NOT call track() when both DB and file fallback fail (persist_failed → 503)", async () => {
102
+ (prisma.lead.create as jest.Mock).mockRejectedValue(
103
+ new Error("DB connection refused"),
104
+ );
105
+
106
+ // Make the real writeLeadFallback fail by pointing it at a non-writable path.
107
+ process.env.AILK_INBOX_FALLBACK_DIR = "/nonexistent-readonly-path-ailk-test";
108
+
109
+ const res = await app.inject({
110
+ method: "POST",
111
+ url: "/v1/leads/lead",
112
+ payload: {
113
+ kind: "lead",
114
+ siteId: "site-abc",
115
+ source: "contact",
116
+ email: "fail@example.com",
117
+ payload: {},
118
+ },
119
+ });
120
+
121
+ expect(res.statusCode).toBe(503);
122
+ expect(mockTrack).not.toHaveBeenCalled();
123
+ });
124
+
125
+ it("does NOT call track() when validation fails (missing required field → 400 or 503)", async () => {
126
+ const res = await app.inject({
127
+ method: "POST",
128
+ url: "/v1/leads/lead",
129
+ payload: {
130
+ // missing email — required field for lead kind
131
+ kind: "lead",
132
+ siteId: "site-abc",
133
+ source: "contact",
134
+ payload: {},
135
+ },
136
+ });
137
+
138
+ // The route may return 400 (invalid_input) or 503 (config_missing).
139
+ expect(mockTrack).not.toHaveBeenCalled();
140
+ });
141
+
142
+ it("track() props contain only source and locale — no PII fields", async () => {
143
+ const serverGeneratedId = "cuid-pii-check-1";
144
+ (prisma.lead.create as jest.Mock).mockResolvedValue({ id: serverGeneratedId });
145
+
146
+ const res = await app.inject({
147
+ method: "POST",
148
+ url: "/v1/leads/lead",
149
+ payload: {
150
+ kind: "lead",
151
+ siteId: "site-abc",
152
+ source: "landing-page",
153
+ email: "pii@example.com",
154
+ payload: { name: "Alice" },
155
+ },
156
+ });
157
+
158
+ if (res.statusCode === 201 && mockTrack.mock.calls.length > 0) {
159
+ const [, props] = mockTrack.mock.calls[0];
160
+ expect(props).not.toHaveProperty("email");
161
+ expect(props).not.toHaveProperty("name");
162
+ expect(props).not.toHaveProperty("ip");
163
+ }
164
+ });
165
+ });