create-ailk 0.2.0 → 0.4.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 (292) hide show
  1. package/component-catalog.md +50 -53
  2. package/dist/cli.js +19 -9
  3. package/dist/lib/apply-module-patches.d.ts +47 -0
  4. package/dist/lib/apply-module-patches.js +370 -0
  5. package/dist/lib/extract-module-bundle.d.ts +51 -3
  6. package/dist/lib/extract-module-bundle.js +327 -28
  7. package/dist/lib/fetch-module.d.ts +3 -38
  8. package/dist/lib/fetch-module.js +26 -8
  9. package/dist/lib/fetch-template.d.ts +20 -0
  10. package/dist/lib/fetch-template.js +129 -0
  11. package/dist/lib/module-license-gate.d.ts +10 -0
  12. package/dist/lib/module-license-gate.js +13 -4
  13. package/dist/lib/paid-paths.d.ts +16 -0
  14. package/dist/lib/paid-paths.js +90 -0
  15. package/dist/module-architecture.d.ts +197 -23
  16. package/dist/module-architecture.js +820 -25
  17. package/dist/parse-args.d.ts +9 -2
  18. package/dist/parse-args.js +46 -1
  19. package/dist/programmatic.d.ts +28 -2
  20. package/dist/programmatic.js +115 -8
  21. package/dist/surfaces.d.ts +12 -36
  22. package/dist/surfaces.js +77 -5
  23. package/dist/sync-routes.js +31 -1
  24. package/dist/template-manifest.d.ts +92 -0
  25. package/dist/template-manifest.js +168 -0
  26. package/dist/template-names.d.ts +41 -0
  27. package/dist/template-names.js +44 -0
  28. package/package.json +3 -2
  29. package/site-templates/marketing-site-free/ailk-template.json +8 -0
  30. package/site-templates/marketing-site-free/content/en/Pricing/pricing.mdx +103 -0
  31. package/site-templates/marketing-site-free/content/en/PrivacyPage/privacy.mdx +79 -0
  32. package/site-templates/marketing-site-free/content/en/TermsPage/terms.mdx +80 -0
  33. package/site-templates/marketing-site-free/provenance.json +4 -0
  34. package/templates/.claude/agents/web.md +2 -3
  35. package/templates/.claude/rules/architecture.md +5 -5
  36. package/templates/.claude/skills/README.md +2 -1
  37. package/templates/.env.example +21 -9
  38. package/templates/CONVENTIONS.md +6 -7
  39. package/templates/apps/api/.env.example +9 -0
  40. package/templates/apps/api/CLAUDE.md +33 -5
  41. package/templates/apps/api/package.json +0 -1
  42. package/templates/apps/api/src/__tests__/cors.test.ts +195 -0
  43. package/templates/apps/api/src/__tests__/module-exclusion.test.ts +60 -2
  44. package/templates/apps/api/src/__tests__/vercel-handler.test.ts +159 -0
  45. package/templates/apps/api/src/__tests__/workspace-module-registration.test.ts +166 -0
  46. package/templates/apps/api/src/config/__tests__/modules.test.ts +76 -0
  47. package/templates/apps/api/src/config/index.ts +19 -0
  48. package/templates/apps/api/src/config/modules.ts +12 -14
  49. package/templates/apps/api/src/lib/__mocks__/prisma.ts +3 -0
  50. package/templates/apps/api/src/lib/__tests__/slice-load.test.ts +89 -0
  51. package/templates/apps/api/src/lib/slice-load.ts +90 -0
  52. package/templates/apps/api/src/openapi/__tests__/openapi.test.ts +52 -32
  53. package/templates/apps/api/src/openapi/__tests__/spec-identity.test.ts +182 -0
  54. package/templates/apps/api/src/openapi/__tests__/surface-drift.test.ts +293 -0
  55. package/templates/apps/api/src/openapi/index.ts +9 -3
  56. package/templates/apps/api/src/openapi/spec.ts +505 -65
  57. package/templates/apps/api/src/openapi/surface-drift.ts +195 -0
  58. package/templates/apps/api/src/routes/content/__tests__/create.test.ts +14 -0
  59. package/templates/apps/api/src/routes/content/__tests__/delete.test.ts +14 -0
  60. package/templates/apps/api/src/routes/content/__tests__/update.test.ts +14 -0
  61. package/templates/apps/api/src/routes/content/index.ts +38 -11
  62. package/templates/apps/api/src/routes/project-listings/__tests__/configured-application.test.ts +17 -0
  63. package/templates/apps/api/src/routes/project-listings/__tests__/drafts.test.ts +17 -0
  64. package/templates/apps/api/src/routes/project-listings/__tests__/founder-identity.test.ts +796 -0
  65. package/templates/apps/api/src/routes/project-listings/__tests__/me.test.ts +10 -0
  66. package/templates/apps/api/src/routes/project-listings/__tests__/public.test.ts +38 -0
  67. package/templates/apps/api/src/routes/project-listings/__tests__/resume-email.test.ts +814 -0
  68. package/templates/apps/api/src/routes/project-listings/__tests__/site-answers.test.ts +10 -0
  69. package/templates/apps/api/src/routes/project-listings/__tests__/site-key.test.ts +24 -0
  70. package/templates/apps/api/src/routes/project-listings/__tests__/structured-address.test.ts +17 -0
  71. package/templates/apps/api/src/routes/project-listings/index.ts +37 -10
  72. package/templates/apps/api/src/routes/project-listings/me.ts +10 -0
  73. package/templates/apps/api/src/routes/project-listings/patch-draft.ts +5 -0
  74. package/templates/apps/api/src/routes/project-listings/public.ts +5 -0
  75. package/templates/apps/api/src/routes/project-listings/respond.ts +11 -0
  76. package/templates/apps/api/src/routes/project-listings/resume-token.ts +5 -0
  77. package/templates/apps/api/src/routes/project-listings/start.ts +30 -0
  78. package/templates/apps/api/src/routes/project-listings/submit.ts +5 -0
  79. package/templates/apps/api/src/routes/project-listings/verify-email.ts +150 -0
  80. package/templates/apps/api/src/server.ts +504 -137
  81. package/templates/apps/api/src/services/deliverable-fulfillment.ts +10 -0
  82. package/templates/apps/api/src/services/listing-config.ts +58 -0
  83. package/templates/apps/api/src/services/project-listing-resume-email.ts +326 -0
  84. package/templates/apps/api/src/services/project-listings.ts +229 -4
  85. package/templates/apps/api/src/vercel-handler.ts +60 -26
  86. package/templates/apps/mcp/.env.example +8 -0
  87. package/templates/apps/mcp/CLAUDE.md +2 -2
  88. package/templates/apps/mcp/__tests__/catalog-drift.test.ts +21 -0
  89. package/templates/apps/mcp/__tests__/config/modules.test.ts +78 -0
  90. package/templates/apps/mcp/__tests__/module-exclusion.test.ts +1 -1
  91. package/templates/apps/mcp/src/config/modules.ts +14 -13
  92. package/templates/apps/mcp/src/server.ts +8 -4
  93. package/templates/apps/mcp/src/tools/index.ts +7 -22
  94. package/templates/apps/web/.env.example +15 -0
  95. package/templates/apps/web/app/[locale]/(authed)/{waitlist/__tests__ → __tests__}/gate.test.tsx +4 -4
  96. package/templates/apps/web/app/[locale]/flows/[slug]/FlowStepperClient.tsx +2 -1
  97. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/FlowStepperClient.permalink.test.tsx +2 -1
  98. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/FlowStepperClient.test.tsx +2 -1
  99. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/flow.actions.test.ts +1 -0
  100. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/two-route-tool.test.tsx +1 -0
  101. package/templates/apps/web/app/[locale]/flows/[slug]/flow.actions.ts +2 -1
  102. package/templates/apps/web/app/[locale]/flows/[slug]/page.tsx +1 -0
  103. package/templates/apps/web/app/[locale]/flows/[slug]/start/page.tsx +1 -0
  104. package/templates/apps/web/app/[locale]/pricing/page.tsx +40 -0
  105. package/templates/apps/web/app/[locale]/privacy/page.tsx +40 -0
  106. package/templates/apps/web/app/[locale]/terms/page.tsx +40 -0
  107. package/templates/apps/web/app/llms.txt/route.ts +12 -9
  108. package/templates/apps/web/jest.config.cjs +19 -13
  109. package/templates/apps/web/lib/__tests__/server-api.test.ts +61 -0
  110. package/templates/apps/web/lib/server-api.ts +28 -12
  111. package/templates/apps/web/messages/en.json +58 -0
  112. package/templates/apps/web/next.config.mjs +1 -3
  113. package/templates/apps/web/package.json +0 -6
  114. package/templates/apps/web/public/android-chrome-192x192.png +0 -0
  115. package/templates/apps/web/public/android-chrome-512x512.png +0 -0
  116. package/templates/apps/web/public/apple-touch-icon.png +0 -0
  117. package/templates/apps/web/public/favicon-16x16.png +0 -0
  118. package/templates/apps/web/public/favicon-32x32.png +0 -0
  119. package/templates/apps/web/public/favicon.ico +0 -0
  120. package/templates/apps/web/public/favicon.svg +6 -3
  121. package/templates/apps/web/public/lockup-horizontal.svg +4 -0
  122. package/templates/apps/web/public/logomark.svg +4 -0
  123. package/templates/apps/web/public/site.webmanifest +2 -2
  124. package/templates/apps/web/public/wordmark.svg +4 -0
  125. package/templates/database/CHANGELOG.md +47 -0
  126. package/templates/database/inbox/schema.prisma +67 -0
  127. package/templates/database/migrations/20260914120000_listing_founder_identity/migration.sql +123 -0
  128. package/templates/database/package.json +1 -1
  129. package/templates/package.json +1 -1
  130. package/templates/.claude/skills/scaffold-commerce/SKILL.md +0 -807
  131. package/templates/.claude/skills/scaffold-commerce/references/lookup-keys-template.md +0 -71
  132. package/templates/.claude/skills/scaffold-commerce/references/marketplace-brand-pages.md +0 -83
  133. package/templates/.claude/skills/scaffold-commerce/templates/checkout-route.template.ts +0 -370
  134. package/templates/.claude/skills/scaffold-commerce/templates/invoice-route.template.ts +0 -376
  135. package/templates/.claude/skills/scaffold-commerce/templates/marketplace-cta-route.tsx.tmpl +0 -72
  136. package/templates/.claude/skills/scaffold-commerce/templates/payment-link-route.template.ts +0 -471
  137. package/templates/.claude/skills/scaffold-commerce/templates/portal-route.template.ts +0 -365
  138. package/templates/.claude/skills/scaffold-commerce/templates/stripe-config.template.ts +0 -60
  139. package/templates/.claude/skills/scaffold-commerce/templates/subscription-route.template.ts +0 -446
  140. package/templates/apps/api/src/__tests__/server.test.ts +0 -253
  141. package/templates/apps/api/src/bin/deliverable-resend.ts +0 -144
  142. package/templates/apps/api/src/bin/deliverable-upload.ts +0 -114
  143. package/templates/apps/api/src/bin/followup-sweep.ts +0 -44
  144. package/templates/apps/api/src/bin/listing-csv-sweep.ts +0 -46
  145. package/templates/apps/api/src/bin/seed-presets.ts +0 -58
  146. package/templates/apps/api/src/bin/seed-waitlist-experiments.ts +0 -104
  147. package/templates/apps/api/src/bin/session-retention-sweep.ts +0 -46
  148. package/templates/apps/api/src/lib/__tests__/stripe.test.ts +0 -74
  149. package/templates/apps/api/src/lib/stripe.ts +0 -52
  150. package/templates/apps/api/src/lib/tenant-db.ts +0 -225
  151. package/templates/apps/api/src/lib/ws-token.ts +0 -91
  152. package/templates/apps/api/src/middleware/tenant.ts +0 -99
  153. package/templates/apps/api/src/routes/billing/__tests__/portal.test.ts +0 -450
  154. package/templates/apps/api/src/routes/billing/__tests__/read.test.ts +0 -262
  155. package/templates/apps/api/src/routes/billing/__tests__/usage.test.ts +0 -436
  156. package/templates/apps/api/src/routes/billing/index.ts +0 -36
  157. package/templates/apps/api/src/routes/billing/portal.ts +0 -182
  158. package/templates/apps/api/src/routes/billing/read.ts +0 -75
  159. package/templates/apps/api/src/routes/billing/usage.ts +0 -153
  160. package/templates/apps/api/src/routes/checkout/__tests__/sessions.test.ts +0 -687
  161. package/templates/apps/api/src/routes/checkout/index.ts +0 -13
  162. package/templates/apps/api/src/routes/checkout/sessions.ts +0 -197
  163. package/templates/apps/api/src/routes/deliverables/__tests__/index.test.ts +0 -393
  164. package/templates/apps/api/src/routes/deliverables/index.ts +0 -200
  165. package/templates/apps/api/src/routes/flow-checkouts/__tests__/index.test.ts +0 -443
  166. package/templates/apps/api/src/routes/flow-checkouts/index.ts +0 -82
  167. package/templates/apps/api/src/routes/flows/README.md +0 -147
  168. package/templates/apps/api/src/routes/flows/__tests__/index.test.ts +0 -752
  169. package/templates/apps/api/src/routes/flows/__tests__/recommender.test.ts +0 -671
  170. package/templates/apps/api/src/routes/flows/index.ts +0 -202
  171. package/templates/apps/api/src/routes/flows/recommender.ts +0 -443
  172. package/templates/apps/api/src/routes/project-listings/__tests__/copy-edit.test.ts +0 -815
  173. package/templates/apps/api/src/routes/project-listings/__tests__/me-route-precedence.test.ts +0 -221
  174. package/templates/apps/api/src/routes/project-listings/__tests__/tenant-isolation.test.ts +0 -566
  175. package/templates/apps/api/src/routes/project-listings/get.ts +0 -70
  176. package/templates/apps/api/src/routes/project-listings/list.ts +0 -47
  177. package/templates/apps/api/src/routes/project-listings/patch.ts +0 -136
  178. package/templates/apps/api/src/routes/schedule/__tests__/index.test.ts +0 -490
  179. package/templates/apps/api/src/routes/schedule/index.ts +0 -249
  180. package/templates/apps/api/src/routes/slack/__tests__/actions.test.ts +0 -385
  181. package/templates/apps/api/src/routes/slack/actions.ts +0 -177
  182. package/templates/apps/api/src/routes/slack/index.ts +0 -38
  183. package/templates/apps/api/src/routes/waitlist-experiments/__tests__/tenant-isolation.test.ts +0 -577
  184. package/templates/apps/api/src/routes/waitlist-experiments/comparison.ts +0 -78
  185. package/templates/apps/api/src/routes/waitlist-experiments/index.ts +0 -41
  186. package/templates/apps/api/src/routes/waitlist-experiments/list.ts +0 -64
  187. package/templates/apps/api/src/routes/waitlist-experiments/respond.ts +0 -42
  188. package/templates/apps/api/src/routes/waitlist-experiments/signup.ts +0 -84
  189. package/templates/apps/api/src/routes/waitlist-experiments/signups.ts +0 -119
  190. package/templates/apps/api/src/routes/waitlist-signups/__tests__/index.test.ts +0 -238
  191. package/templates/apps/api/src/routes/waitlist-signups/index.ts +0 -101
  192. package/templates/apps/api/src/routes/webhooks/README.md +0 -80
  193. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-flow-checkout.test.ts +0 -315
  194. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-idempotency.test.ts +0 -247
  195. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-org-billing.test.ts +0 -270
  196. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-rate-limit.test.ts +0 -198
  197. package/templates/apps/api/src/routes/webhooks/__tests__/stripe.test.ts +0 -633
  198. package/templates/apps/api/src/routes/webhooks/index.ts +0 -41
  199. package/templates/apps/api/src/routes/webhooks/stripe.ts +0 -481
  200. package/templates/apps/api/src/routes/workspaces/__tests__/config-tenant-isolation.test.ts +0 -356
  201. package/templates/apps/api/src/routes/workspaces/__tests__/tenant-isolation.test.ts +0 -671
  202. package/templates/apps/api/src/routes/workspaces/config.ts +0 -125
  203. package/templates/apps/api/src/routes/workspaces/index.ts +0 -194
  204. package/templates/apps/api/src/routes/workspaces/sessions.ts +0 -218
  205. package/templates/apps/api/src/services/__tests__/flow-aggregate.test.ts +0 -425
  206. package/templates/apps/api/src/services/__tests__/flow-engine.test.ts +0 -2840
  207. package/templates/apps/api/src/services/__tests__/lead-promotion.test.ts +0 -393
  208. package/templates/apps/api/src/services/__tests__/listing-csv-sweep.test.ts +0 -560
  209. package/templates/apps/api/src/services/__tests__/listing-promotion.test.ts +0 -684
  210. package/templates/apps/api/src/services/__tests__/playbook-compile.test.ts +0 -406
  211. package/templates/apps/api/src/services/__tests__/playbook-render.test.ts +0 -290
  212. package/templates/apps/api/src/services/__tests__/project-listing-decision.test.ts +0 -736
  213. package/templates/apps/api/src/services/__tests__/project-listing-flow.test.ts +0 -475
  214. package/templates/apps/api/src/services/__tests__/project-listing-issue.test.ts +0 -340
  215. package/templates/apps/api/src/services/__tests__/recommender-capture.test.ts +0 -983
  216. package/templates/apps/api/src/services/__tests__/tenant-context-cascade.test.ts +0 -71
  217. package/templates/apps/api/src/services/__tests__/tenant-context.test.ts +0 -379
  218. package/templates/apps/api/src/services/__tests__/usage-metering.test.ts +0 -768
  219. package/templates/apps/api/src/services/__tests__/waitlist-dashboard.test.ts +0 -1314
  220. package/templates/apps/api/src/services/__tests__/waitlist-experiments.test.ts +0 -341
  221. package/templates/apps/api/src/services/__tests__/waitlist-followup.test.ts +0 -567
  222. package/templates/apps/api/src/services/__tests__/waitlist-scoring.test.ts +0 -474
  223. package/templates/apps/api/src/services/__tests__/waitlist-signups.test.ts +0 -354
  224. package/templates/apps/api/src/services/flow-aggregate.ts +0 -232
  225. package/templates/apps/api/src/services/flow-checkouts.ts +0 -123
  226. package/templates/apps/api/src/services/flow-engine.ts +0 -1296
  227. package/templates/apps/api/src/services/lead-promotion.ts +0 -176
  228. package/templates/apps/api/src/services/listing-csv-sweep.ts +0 -455
  229. package/templates/apps/api/src/services/listing-promotion.ts +0 -342
  230. package/templates/apps/api/src/services/playbook-compile.ts +0 -398
  231. package/templates/apps/api/src/services/playbook-render.ts +0 -263
  232. package/templates/apps/api/src/services/project-listing-decision.ts +0 -510
  233. package/templates/apps/api/src/services/project-listing-flow.ts +0 -426
  234. package/templates/apps/api/src/services/project-listing-issue.ts +0 -251
  235. package/templates/apps/api/src/services/recommender-capture.ts +0 -835
  236. package/templates/apps/api/src/services/scheduling/cal-provider.ts +0 -392
  237. package/templates/apps/api/src/services/scheduling/index.ts +0 -63
  238. package/templates/apps/api/src/services/scheduling/types.ts +0 -88
  239. package/templates/apps/api/src/services/tenant-context.ts +0 -451
  240. package/templates/apps/api/src/services/usage-metering.ts +0 -699
  241. package/templates/apps/api/src/services/waitlist-dashboard.ts +0 -947
  242. package/templates/apps/api/src/services/waitlist-experiments.ts +0 -213
  243. package/templates/apps/api/src/services/waitlist-followup.ts +0 -486
  244. package/templates/apps/api/src/services/waitlist-scoring.ts +0 -166
  245. package/templates/apps/api/src/services/waitlist-signups.ts +0 -165
  246. package/templates/apps/mcp/__tests__/schedule_tools.test.ts +0 -242
  247. package/templates/apps/mcp/src/tools/create_booking.ts +0 -58
  248. package/templates/apps/mcp/src/tools/get_event_meta.ts +0 -55
  249. package/templates/apps/mcp/src/tools/get_flow.ts +0 -61
  250. package/templates/apps/mcp/src/tools/list_availability.ts +0 -67
  251. package/templates/apps/mcp/src/tools/submit_flow_step.ts +0 -83
  252. package/templates/apps/web/app/[locale]/(authed)/waitlist/[experimentId]/page.tsx +0 -309
  253. package/templates/apps/web/app/[locale]/(authed)/waitlist/[experimentId]/signups/[leadId]/page.tsx +0 -149
  254. package/templates/apps/web/app/[locale]/(authed)/waitlist/__tests__/comparison.test.tsx +0 -273
  255. package/templates/apps/web/app/[locale]/(authed)/waitlist/__tests__/list.test.tsx +0 -171
  256. package/templates/apps/web/app/[locale]/(authed)/waitlist/__tests__/signup.test.tsx +0 -179
  257. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/ExperimentsTable.tsx +0 -116
  258. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/OfferFunnelTable.tsx +0 -66
  259. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/RollupTicker.tsx +0 -61
  260. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/ScoreTrace.tsx +0 -114
  261. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/SignupsTable.tsx +0 -139
  262. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/WaitlistComparisonTabs.tsx +0 -85
  263. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/status-badges.tsx +0 -67
  264. package/templates/apps/web/app/[locale]/(authed)/waitlist/page.tsx +0 -179
  265. package/templates/apps/web/app/[locale]/blog/[[...slug]]/page.tsx +0 -178
  266. package/templates/apps/web/app/[locale]/dev/purchase/__tests__/actions.test.ts +0 -160
  267. package/templates/apps/web/app/[locale]/dev/purchase/error.tsx +0 -25
  268. package/templates/apps/web/app/[locale]/dev/purchase/page.tsx +0 -117
  269. package/templates/apps/web/app/[locale]/dev/purchase/purchase.actions.ts +0 -58
  270. package/templates/apps/web/app/[locale]/docs/[[...slug]]/page.tsx +0 -119
  271. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/checkout.actions.test.ts +0 -287
  272. package/templates/apps/web/app/[locale]/flows/[slug]/checkout.actions.ts +0 -254
  273. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/ResultsClient.tsx +0 -532
  274. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/ResultsEmailStep.tsx +0 -121
  275. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/__tests__/ResultsClient.checkout.test.tsx +0 -457
  276. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/__tests__/page.test.tsx +0 -396
  277. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/page.tsx +0 -114
  278. package/templates/apps/web/app/[locale]/projects/apply/ListingApplicationClient.tsx +0 -110
  279. package/templates/apps/web/app/[locale]/projects/apply/__tests__/ListingApplicationClient.test.tsx +0 -96
  280. package/templates/apps/web/app/[locale]/schedule/__tests__/page.test.tsx +0 -117
  281. package/templates/apps/web/app/[locale]/schedule/confirmed/__tests__/page.test.tsx +0 -96
  282. package/templates/apps/web/app/[locale]/schedule/confirmed/page.tsx +0 -92
  283. package/templates/apps/web/app/[locale]/schedule/page.tsx +0 -82
  284. package/templates/apps/web/content/en/blog/README.txt +0 -25
  285. package/templates/apps/web/content/en/docs/index.mdx +0 -28
  286. package/templates/apps/web/lib/__mocks__/source-server.js +0 -31
  287. package/templates/apps/web/lib/blog-list-data.ts +0 -95
  288. package/templates/apps/web/lib/blog-post-data.ts +0 -79
  289. package/templates/apps/web/lib/source.ts +0 -34
  290. package/templates/apps/web/public/logomark-dark.svg +0 -4
  291. package/templates/apps/web/public/logomark-light.svg +0 -4
  292. package/templates/apps/web/source.config.ts +0 -78
@@ -1,64 +0,0 @@
1
- // oss: false
2
- /**
3
- * GET /v1/waitlist-experiments
4
- *
5
- * List + rollup in the caller's scope (#4665 D7, B0). The scope is ALWAYS
6
- * derived server-side from `request.tenant` via `resolveWaitlistReadScope`
7
- * (D2) — there is no client-supplied site/org id, so cross-tenant
8
- * enumeration is structurally impossible.
9
- *
10
- * Registered inside `server.ts`'s tenant scope (D7) behind
11
- * `tenantPreHandlerPlugin` — a caller with no resolvable tenant is denied by
12
- * the preHandler (403) before this handler ever runs.
13
- *
14
- * Role floor (D2): `owner | admin` — the dashboard exposes signup PII, so
15
- * membership alone is not authorization. Checked BEFORE any read, mirroring
16
- * `routes/billing/usage.ts`'s #3819 gate.
17
- */
18
- import { waitlistDashboardListSchema } from "@working-theory/validation";
19
- import type { FastifyReply, FastifyRequest } from "fastify";
20
-
21
- import {
22
- listExperiments,
23
- resolveWaitlistReadScope,
24
- WAITLIST_DASHBOARD_ROLES,
25
- } from "../../services/waitlist-dashboard.js";
26
-
27
- import { sendValidated } from "./respond.js";
28
-
29
- function unauthorized(reply: FastifyReply) {
30
- return reply.status(401).send({
31
- ok: false,
32
- error: { code: "unauthorized", message: "Authentication required" },
33
- });
34
- }
35
-
36
- function forbidden(reply: FastifyReply) {
37
- return reply.status(403).send({
38
- ok: false,
39
- error: { code: "forbidden", message: "Forbidden" },
40
- });
41
- }
42
-
43
- export async function listWaitlistExperimentsHandler(
44
- request: FastifyRequest,
45
- reply: FastifyReply,
46
- ): Promise<void> {
47
- const tenant = request.tenant;
48
- // Defensive fallback — the tenant preHandler denies an unresolvable tenant
49
- // before this handler runs; `request.tenant` is `TenantContext | undefined`
50
- // at the type level, mirroring the sibling billing routes.
51
- if (!tenant) return unauthorized(reply);
52
-
53
- if (!WAITLIST_DASHBOARD_ROLES.has(tenant.role)) {
54
- request.log.warn(
55
- { method: request.method, path: request.url, status: 403 },
56
- "[waitlist-experiments] list denied; insufficient role",
57
- );
58
- return forbidden(reply);
59
- }
60
-
61
- const scope = resolveWaitlistReadScope(tenant);
62
- const data = await listExperiments(scope);
63
- return sendValidated(reply, waitlistDashboardListSchema, data, "list");
64
- }
@@ -1,42 +0,0 @@
1
- // oss: false
2
- /**
3
- * Response-schema validation for the waitlist-experiments dashboard routes
4
- * (Low finding, PR #4687 security review: "response schemas are contract-
5
- * only, never enforced on the wire" — the D6 schemas types the service
6
- * layer, but nothing previously re-parsed the value against its own
7
- * `.strict()` schema before it left the process). A defensive net: the
8
- * service layer already guards against the anomalies this would catch (the
9
- * corrupt-config skip, the missing-`waitlistKey` skip), so this should never
10
- * fire in practice — if it does, it is a genuine internal error (a future
11
- * service change drifting from its own contract), not a client-facing 4xx.
12
- */
13
- import { logger } from "@working-theory/observability";
14
- import type { FastifyReply } from "fastify";
15
- import type { z } from "zod";
16
-
17
- /**
18
- * Parse `data` against `schema`; on success send the ORIGINAL `data` object
19
- * (not the parsed clone) at `200`, matching every route's existing envelope.
20
- * On failure, log the zod issues (never the raw `data`, which may carry
21
- * signup PII) and reply `500` — a shape drift is an internal-error class,
22
- * never something a client 4xx can describe.
23
- */
24
- export function sendValidated<T>(
25
- reply: FastifyReply,
26
- schema: z.ZodType<T>,
27
- data: T,
28
- routeName: string,
29
- ): FastifyReply {
30
- const parsed = schema.safeParse(data);
31
- if (!parsed.success) {
32
- logger.error(
33
- { route: routeName, issues: parsed.error.issues },
34
- "[waitlist-experiments] response failed its own contract schema",
35
- );
36
- return reply.status(500).send({
37
- ok: false,
38
- error: { code: "internal_error", message: "Response failed contract validation" },
39
- });
40
- }
41
- return reply.status(200).send({ ok: true, data });
42
- }
@@ -1,84 +0,0 @@
1
- // oss: false
2
- /**
3
- * GET /v1/waitlist-experiments/:experimentId/signups/:leadId
4
- *
5
- * One signup's answers + score (#4665 D7, B0). Both path ids are validated
6
- * at the boundary (`zWaitlistExperimentId`, `zLeadId`, ADR-0031 rule 5) — a
7
- * malformed id is `400`. The lead is loaded THROUGH its experiment (D3) — a
8
- * foreign or unrelated lead is `404`, indistinguishable from a missing one.
9
- *
10
- * Role floor + tenant guard — see `list.ts`'s header; identical contract.
11
- */
12
- import { zLeadId, zWaitlistExperimentId } from "@working-theory/ids";
13
- import { waitlistSignupDetailSchema } from "@working-theory/validation";
14
- import type { FastifyReply, FastifyRequest } from "fastify";
15
- import { z } from "zod";
16
-
17
- import {
18
- getSignup,
19
- resolveWaitlistReadScope,
20
- WAITLIST_DASHBOARD_ROLES,
21
- } from "../../services/waitlist-dashboard.js";
22
-
23
- import { sendValidated } from "./respond.js";
24
-
25
- const paramsSchema = z.object({
26
- experimentId: zWaitlistExperimentId,
27
- leadId: zLeadId,
28
- });
29
-
30
- function unauthorized(reply: FastifyReply) {
31
- return reply.status(401).send({
32
- ok: false,
33
- error: { code: "unauthorized", message: "Authentication required" },
34
- });
35
- }
36
-
37
- function forbidden(reply: FastifyReply) {
38
- return reply.status(403).send({
39
- ok: false,
40
- error: { code: "forbidden", message: "Forbidden" },
41
- });
42
- }
43
-
44
- function invalidParams(reply: FastifyReply) {
45
- return reply.status(400).send({
46
- ok: false,
47
- error: { code: "validation_failed", message: "Invalid experiment or lead id" },
48
- });
49
- }
50
-
51
- function notFound(reply: FastifyReply) {
52
- return reply.status(404).send({
53
- ok: false,
54
- error: { code: "not_found", message: "Signup not found" },
55
- });
56
- }
57
-
58
- export async function getWaitlistSignupHandler(
59
- request: FastifyRequest,
60
- reply: FastifyReply,
61
- ): Promise<void> {
62
- const tenant = request.tenant;
63
- if (!tenant) return unauthorized(reply);
64
- if (!WAITLIST_DASHBOARD_ROLES.has(tenant.role)) {
65
- request.log.warn(
66
- { method: request.method, path: request.url, status: 403 },
67
- "[waitlist-experiments] signup detail denied; insufficient role",
68
- );
69
- return forbidden(reply);
70
- }
71
-
72
- const parsedParams = paramsSchema.safeParse(request.params);
73
- if (!parsedParams.success) return invalidParams(reply);
74
-
75
- const scope = resolveWaitlistReadScope(tenant);
76
- const result = await getSignup(
77
- scope,
78
- parsedParams.data.experimentId,
79
- parsedParams.data.leadId,
80
- );
81
- if (!result.ok) return notFound(reply);
82
-
83
- return sendValidated(reply, waitlistSignupDetailSchema, result.value, "signup");
84
- }
@@ -1,119 +0,0 @@
1
- // oss: false
2
- /**
3
- * GET /v1/waitlist-experiments/:experimentId/signups?waitlist=&cursor=&limit=
4
- *
5
- * Paginated signups (#4665 D7, B0). `limit` defaults to 50, max 200;
6
- * `createdAt desc, id desc`; `cursor` is the previous page's last row's
7
- * `leadId` (a `zLeadId`-validated boundary value, per the same id-format
8
- * discipline as `:experimentId`). `waitlist` narrows to one declared
9
- * waitlist key (`flowIdentifierSchema`). A malformed query param is `400`
10
- * before any lookup runs.
11
- *
12
- * Role floor + tenant guard — see `list.ts`'s header; identical contract.
13
- */
14
- import { zLeadId, zWaitlistExperimentId } from "@working-theory/ids";
15
- import { flowIdentifierSchema, waitlistSignupListSchema } from "@working-theory/validation";
16
- import type { FastifyReply, FastifyRequest } from "fastify";
17
- import { z } from "zod";
18
-
19
- import {
20
- listSignups,
21
- resolveWaitlistReadScope,
22
- WAITLIST_DASHBOARD_ROLES,
23
- } from "../../services/waitlist-dashboard.js";
24
-
25
- import { sendValidated } from "./respond.js";
26
-
27
- const paramsSchema = z.object({ experimentId: zWaitlistExperimentId });
28
-
29
- const emptyToUndefined = (val: unknown) => (val === "" ? undefined : val);
30
-
31
- const DEFAULT_LIMIT = 50;
32
- const MAX_LIMIT = 200;
33
-
34
- const querySchema = z.object({
35
- waitlist: z.preprocess(emptyToUndefined, flowIdentifierSchema.optional()),
36
- cursor: z.preprocess(emptyToUndefined, zLeadId.optional()),
37
- limit: z.preprocess(
38
- emptyToUndefined,
39
- z.coerce.number().int().min(1).max(MAX_LIMIT).optional(),
40
- ),
41
- });
42
-
43
- function unauthorized(reply: FastifyReply) {
44
- return reply.status(401).send({
45
- ok: false,
46
- error: { code: "unauthorized", message: "Authentication required" },
47
- });
48
- }
49
-
50
- function forbidden(reply: FastifyReply) {
51
- return reply.status(403).send({
52
- ok: false,
53
- error: { code: "forbidden", message: "Forbidden" },
54
- });
55
- }
56
-
57
- function invalidParams(reply: FastifyReply) {
58
- return reply.status(400).send({
59
- ok: false,
60
- error: { code: "validation_failed", message: "Invalid experiment id" },
61
- });
62
- }
63
-
64
- function invalidQuery(reply: FastifyReply) {
65
- return reply.status(400).send({
66
- ok: false,
67
- error: { code: "validation_failed", message: "Invalid query parameters" },
68
- });
69
- }
70
-
71
- function notFound(reply: FastifyReply) {
72
- return reply.status(404).send({
73
- ok: false,
74
- error: { code: "not_found", message: "Experiment not found" },
75
- });
76
- }
77
-
78
- /** A supplied `cursor` that does not resolve within this experiment is a
79
- * client input error, not a missing-resource one (Low finding, PR #4687
80
- * security review) — distinct from `notFound`'s experiment-not-found case. */
81
- function invalidCursor(reply: FastifyReply) {
82
- return reply.status(400).send({
83
- ok: false,
84
- error: { code: "validation_failed", message: "cursor does not resolve within this experiment" },
85
- });
86
- }
87
-
88
- export async function listWaitlistSignupsHandler(
89
- request: FastifyRequest,
90
- reply: FastifyReply,
91
- ): Promise<void> {
92
- const tenant = request.tenant;
93
- if (!tenant) return unauthorized(reply);
94
- if (!WAITLIST_DASHBOARD_ROLES.has(tenant.role)) {
95
- request.log.warn(
96
- { method: request.method, path: request.url, status: 403 },
97
- "[waitlist-experiments] signups list denied; insufficient role",
98
- );
99
- return forbidden(reply);
100
- }
101
-
102
- const parsedParams = paramsSchema.safeParse(request.params);
103
- if (!parsedParams.success) return invalidParams(reply);
104
-
105
- const parsedQuery = querySchema.safeParse(request.query);
106
- if (!parsedQuery.success) return invalidQuery(reply);
107
-
108
- const scope = resolveWaitlistReadScope(tenant);
109
- const result = await listSignups(scope, parsedParams.data.experimentId, {
110
- waitlist: parsedQuery.data.waitlist,
111
- cursor: parsedQuery.data.cursor,
112
- limit: parsedQuery.data.limit ?? DEFAULT_LIMIT,
113
- });
114
- if (!result.ok) {
115
- return result.error.kind === "invalid_cursor" ? invalidCursor(reply) : notFound(reply);
116
- }
117
-
118
- return sendValidated(reply, waitlistSignupListSchema, result.value, "signups");
119
- }
@@ -1,238 +0,0 @@
1
- /**
2
- * @file index.test.ts
3
- *
4
- * THE ACCEPTANCE GATE for the respondent read route (#4731 AC-1/2/3/4/6).
5
- * Registration mirrors server.ts: REAL `authPreHandlerPlugin ->
6
- * waitlistSignupRoutes` (auth only, no tenant guard), mocked `lib/prisma.js`.
7
- * Proves: no session → the preHandler's own 401, untouched; an unverified
8
- * user → 403 `email_unverified` with NO Lead read; a verified respondent →
9
- * 200 with exactly the seven keys, parsing under the D5 schema; no lead →
10
- * 404 `signup_not_found`; an `email` query parameter is ignored (the SESSION
11
- * user's signup resolves, never the parameter's); a malformed experimentKey
12
- * → 400.
13
- */
14
- import Fastify from "fastify";
15
- import type { FastifyInstance } from "fastify";
16
- import { waitlistSignupMeResponseSchema } from "@working-theory/validation";
17
-
18
- // eslint-disable-next-line no-restricted-syntax -- jest mock factory must be hoisted
19
- jest.mock("../../../lib/prisma.js", () => ({
20
- prisma: {
21
- session: { findUnique: jest.fn() },
22
- apiToken: {
23
- findUnique: jest.fn(),
24
- update: jest.fn().mockResolvedValue(undefined),
25
- },
26
- user: { findUnique: jest.fn() },
27
- lead: { findFirst: jest.fn() },
28
- waitlistScore: { findFirst: jest.fn() },
29
- flowSession: { findFirst: jest.fn() },
30
- },
31
- }));
32
-
33
- import { prisma } from "../../../lib/prisma.js";
34
- import { authPreHandlerPlugin } from "../../../middleware/auth.js";
35
- import { waitlistSignupRoutes } from "../index.js";
36
-
37
- const FRONTEND = "https://app.example.com";
38
- const FUTURE = new Date(Date.now() + 60 * 60 * 1000);
39
- const SITE = "wksp_00000000-0000-7000-8000-000000000001";
40
- const EXPERIMENT = "ailk-founder-diagnostic";
41
- const LEAD_ID = "lead_00000000-0000-7000-8000-0000000000a1";
42
-
43
- const USERS: Record<string, { id: string; email: string; emailVerified: boolean }> = {
44
- alice: { id: "alice", email: "alice@example.com", emailVerified: true },
45
- // Email+password account whose address was never verified.
46
- mallory: { id: "mallory", email: "mallory@example.com", emailVerified: false },
47
- bob: { id: "bob", email: "bob@example.com", emailVerified: true },
48
- };
49
-
50
- const SESSION_ROWS: Record<string, Record<string, unknown>> = {
51
- cookie_alice: { id: "sess_alice", userId: "alice", expiresAt: FUTURE, activeOrganizationId: null, activeWorkspaceId: null },
52
- cookie_mallory: { id: "sess_mallory", userId: "mallory", expiresAt: FUTURE, activeOrganizationId: null, activeWorkspaceId: null },
53
- cookie_bob: { id: "sess_bob", userId: "bob", expiresAt: FUTURE, activeOrganizationId: null, activeWorkspaceId: null },
54
- };
55
-
56
- const ALICE_LEAD = {
57
- id: LEAD_ID,
58
- payload: {
59
- experimentKey: EXPERIMENT,
60
- waitlistKey: "early_bird",
61
- q1: "solo_builder",
62
- q3: "Our site never ships.",
63
- name: "Alice",
64
- url: "https://alice.example",
65
- email: "alice@example.com",
66
- },
67
- createdAt: new Date("2026-09-03T00:00:00.000Z"),
68
- };
69
-
70
- function installFixtureMocks(): void {
71
- (prisma.session.findUnique as jest.Mock).mockImplementation(
72
- ({ where }: { where: { token?: string } }) =>
73
- Promise.resolve(where.token ? (SESSION_ROWS[where.token] ?? null) : null),
74
- );
75
- (prisma.apiToken.findUnique as jest.Mock).mockResolvedValue(null);
76
- (prisma.user.findUnique as jest.Mock).mockImplementation(({ where }: { where: { id: string } }) =>
77
- Promise.resolve(USERS[where.id] ?? null),
78
- );
79
- // Only alice owns a lead — matched on the (insensitive) email the SERVICE
80
- // derives from the User row, never from the request.
81
- (prisma.lead.findFirst as jest.Mock).mockImplementation(
82
- ({ where }: { where: { siteId: string; email: { equals: string }; payload: { equals: string } } }) =>
83
- Promise.resolve(
84
- where.siteId === SITE &&
85
- where.email.equals === "alice@example.com" &&
86
- where.payload.equals === EXPERIMENT
87
- ? ALICE_LEAD
88
- : null,
89
- ),
90
- );
91
- (prisma.waitlistScore.findFirst as jest.Mock).mockImplementation(({ where }: { where: { leadId: string } }) =>
92
- Promise.resolve(where.leadId === LEAD_ID ? { tier: "hot", score: 12 } : null),
93
- );
94
- (prisma.flowSession.findFirst as jest.Mock).mockImplementation(({ where }: { where: { leadId: string } }) =>
95
- Promise.resolve(
96
- where.leadId === LEAD_ID
97
- ? { aeoScore: null, completedAt: new Date("2026-09-03T00:00:05.000Z") }
98
- : null,
99
- ),
100
- );
101
- }
102
-
103
- async function buildApp(): Promise<FastifyInstance> {
104
- const app = Fastify();
105
- await app.register(async (authScope) => {
106
- await authScope.register(authPreHandlerPlugin, { frontendOrigin: FRONTEND });
107
- await authScope.register(waitlistSignupRoutes);
108
- });
109
- await app.ready();
110
- return app;
111
- }
112
-
113
- const cookie = (token: string) => ({ cookie: `better-auth.session_token=${token}` });
114
- const URL_ME = `/v1/waitlist-signups/me?experimentKey=${EXPERIMENT}`;
115
-
116
- let app: FastifyInstance;
117
-
118
- beforeEach(async () => {
119
- jest.clearAllMocks();
120
- process.env.AILK_SITE_ID = SITE;
121
- installFixtureMocks();
122
- app = await buildApp();
123
- });
124
-
125
- afterEach(async () => {
126
- await app.close();
127
- });
128
-
129
- afterAll(() => {
130
- delete process.env.AILK_SITE_ID;
131
- });
132
-
133
- describe("GET /v1/waitlist-signups/me — auth (AC-2/AC-3)", () => {
134
- it("no session cookie and no bearer → the preHandler's existing 401, untouched; no User/Lead read", async () => {
135
- const res = await app.inject({ method: "GET", url: URL_ME });
136
-
137
- expect(res.statusCode).toBe(401);
138
- expect(res.json()).toEqual({ error: "unauthorized" });
139
- expect(prisma.user.findUnique).not.toHaveBeenCalled();
140
- expect(prisma.lead.findFirst).not.toHaveBeenCalled();
141
- });
142
-
143
- it("an expired / unknown cookie → 401", async () => {
144
- const res = await app.inject({ method: "GET", url: URL_ME, headers: cookie("cookie_nobody") });
145
-
146
- expect(res.statusCode).toBe(401);
147
- expect(prisma.lead.findFirst).not.toHaveBeenCalled();
148
- });
149
-
150
- it("unverified email → 403 email_unverified, BEFORE any Lead read", async () => {
151
- const res = await app.inject({ method: "GET", url: URL_ME, headers: cookie("cookie_mallory") });
152
-
153
- expect(res.statusCode).toBe(403);
154
- expect(res.json()).toEqual({
155
- ok: false,
156
- error: { code: "email_unverified", message: expect.any(String) },
157
- });
158
- expect(prisma.lead.findFirst).not.toHaveBeenCalled();
159
- expect(prisma.waitlistScore.findFirst).not.toHaveBeenCalled();
160
- expect(prisma.flowSession.findFirst).not.toHaveBeenCalled();
161
- });
162
- });
163
-
164
- describe("GET /v1/waitlist-signups/me — the read (AC-1/AC-4/AC-6)", () => {
165
- it("verified respondent → 200 with exactly the seven keys, parsing under waitlistSignupMeResponseSchema", async () => {
166
- const res = await app.inject({ method: "GET", url: URL_ME, headers: cookie("cookie_alice") });
167
-
168
- expect(res.statusCode).toBe(200);
169
- const body = res.json() as { ok: true; data: Record<string, unknown> };
170
- expect(body.ok).toBe(true);
171
- expect(Object.keys(body.data).sort()).toEqual(
172
- ["answers", "aeoScore", "completedAt", "experimentKey", "score", "tier", "waitlistKey"].sort(),
173
- );
174
- expect(waitlistSignupMeResponseSchema.parse(body.data)).toEqual({
175
- experimentKey: EXPERIMENT,
176
- waitlistKey: "early_bird",
177
- completedAt: "2026-09-03T00:00:05.000Z",
178
- tier: "hot",
179
- score: 12,
180
- aeoScore: null,
181
- answers: { q3: "Our site never ships." },
182
- });
183
- // No other payload key leaves the row (name / url / q1 / email).
184
- expect(res.body).not.toContain("Alice");
185
- expect(res.body).not.toContain("alice.example");
186
- expect(res.body).not.toContain("solo_builder");
187
- expect(res.body).not.toContain("@example.com");
188
- });
189
-
190
- it("verified user with no matching lead → 404 signup_not_found", async () => {
191
- const res = await app.inject({ method: "GET", url: URL_ME, headers: cookie("cookie_bob") });
192
-
193
- expect(res.statusCode).toBe(404);
194
- expect(res.json()).toEqual({
195
- ok: false,
196
- error: { code: "signup_not_found", message: expect.any(String) },
197
- });
198
- });
199
-
200
- it("an `email` query parameter is ignored — the SESSION user's signup resolves, never the parameter's", async () => {
201
- // bob is verified and owns nothing; naming alice's email must not read alice's row.
202
- const smuggled = await app.inject({
203
- method: "GET",
204
- url: `${URL_ME}&email=alice%40example.com`,
205
- headers: cookie("cookie_bob"),
206
- });
207
- expect(smuggled.statusCode).toBe(404);
208
- const bobLeadWhere = (prisma.lead.findFirst as jest.Mock).mock.calls[0][0].where as { email: { equals: string } };
209
- expect(bobLeadWhere.email.equals).toBe("bob@example.com");
210
-
211
- // …and alice naming someone else's email still gets HER OWN row.
212
- jest.clearAllMocks();
213
- installFixtureMocks();
214
- const own = await app.inject({
215
- method: "GET",
216
- url: `${URL_ME}&email=bob%40example.com`,
217
- headers: cookie("cookie_alice"),
218
- });
219
- expect(own.statusCode).toBe(200);
220
- expect((own.json() as { data: { waitlistKey: string } }).data.waitlistKey).toBe("early_bird");
221
- const aliceLeadWhere = (prisma.lead.findFirst as jest.Mock).mock.calls[0][0].where as { email: { equals: string } };
222
- expect(aliceLeadWhere.email.equals).toBe("alice@example.com");
223
- });
224
-
225
- it("missing or malformed experimentKey → 400 validation_failed, no read", async () => {
226
- const missing = await app.inject({ method: "GET", url: "/v1/waitlist-signups/me", headers: cookie("cookie_alice") });
227
- expect(missing.statusCode).toBe(400);
228
- expect((missing.json() as { error: { code: string } }).error.code).toBe("validation_failed");
229
-
230
- const malformed = await app.inject({
231
- method: "GET",
232
- url: "/v1/waitlist-signups/me?experimentKey=Not%20A%20Slug",
233
- headers: cookie("cookie_alice"),
234
- });
235
- expect(malformed.statusCode).toBe(400);
236
- expect(prisma.lead.findFirst).not.toHaveBeenCalled();
237
- });
238
- });
@@ -1,101 +0,0 @@
1
- /**
2
- * Waitlist-signups respondent route (#4731 D1 — the Phase C dependency of
3
- * the AILK diagnostic, samhenry#152 AC-7).
4
- *
5
- * Routes:
6
- * GET /v1/waitlist-signups/me?experimentKey=<slug> — the caller's OWN newest signup
7
- *
8
- * Registered INSIDE server.ts's `authScope` (auth only — NOT the inner
9
- * `tenantScope`: a respondent has no workspace membership, and the tenant
10
- * guard is default-deny) so `request.userId` is populated by
11
- * `authPreHandlerPlugin` before the handler runs. An unauthenticated caller
12
- * receives the preHandler's existing 401, untouched. The identity is
13
- * `request.userId` ONLY: the route never accepts an `email` parameter (the
14
- * query schema declares `experimentKey` alone; anything else is stripped,
15
- * never read), never enumerates, never reads across sites — see
16
- * `services/waitlist-signups.ts`.
17
- *
18
- * Envelope per apps/api/CLAUDE.md: `{ ok: true, data }` /
19
- * `{ ok: false, error: { code, message } }`, real HTTP status codes:
20
- * 400 validation_failed · 401 unauthorized · 403 email_unverified ·
21
- * 404 signup_not_found · 500 internal_error (the 200 body failed its own
22
- * contract schema — a drift is never a leak).
23
- *
24
- * API↔MCP parity: identity-bound (the session IS the identity; the OSS MCP
25
- * surface is identity-blind) — no MCP twin (#3591 exception, the same shape
26
- * as `/v1/billing/*`, `/v1/workspaces/*`, `/v1/waitlist-experiments/*`).
27
- */
28
- import { logger } from "@working-theory/observability";
29
- import {
30
- flowSlugSchema,
31
- waitlistSignupMeResponseSchema,
32
- } from "@working-theory/validation";
33
- import type { FastifyPluginAsync, FastifyReply } from "fastify";
34
- import { z } from "zod";
35
-
36
- import { readMySignup } from "../../services/waitlist-signups.js";
37
-
38
- /** Boundary validation (D2): `experimentKey` is the ONLY declared query key. */
39
- const meQuerySchema = z.object({ experimentKey: flowSlugSchema });
40
-
41
- function unauthorized(reply: FastifyReply) {
42
- return reply.status(401).send({
43
- ok: false,
44
- error: { code: "unauthorized", message: "Authentication required" },
45
- });
46
- }
47
-
48
- function invalidQuery(reply: FastifyReply) {
49
- return reply.status(400).send({
50
- ok: false,
51
- error: { code: "validation_failed", message: "Invalid experimentKey" },
52
- });
53
- }
54
-
55
- const ERROR_STATUS = {
56
- not_found_user: 404,
57
- email_unverified: 403,
58
- signup_not_found: 404,
59
- } as const;
60
-
61
- /** `not_found_user` is reported as `signup_not_found` — the row cannot exist for a user that does not. */
62
- const ERROR_CODE = {
63
- not_found_user: "signup_not_found",
64
- email_unverified: "email_unverified",
65
- signup_not_found: "signup_not_found",
66
- } as const;
67
-
68
- export const waitlistSignupRoutes: FastifyPluginAsync = async (fastify) => {
69
- fastify.get("/v1/waitlist-signups/me", async (request, reply) => {
70
- const userId = request.userId;
71
- if (!userId) return unauthorized(reply);
72
-
73
- const query = meQuerySchema.safeParse(request.query);
74
- if (!query.success) return invalidQuery(reply);
75
-
76
- const result = await readMySignup(userId, query.data.experimentKey);
77
- if (!result.ok) {
78
- return reply.status(ERROR_STATUS[result.error.kind]).send({
79
- ok: false,
80
- error: { code: ERROR_CODE[result.error.kind], message: result.error.message },
81
- });
82
- }
83
-
84
- // D5 — re-validate the body against its own strict contract before it
85
- // leaves the process (the waitlist-experiments `respond.ts` idiom): a
86
- // shape drift is an internal error, never a leak. Log issues only —
87
- // never the value.
88
- const parsed = waitlistSignupMeResponseSchema.safeParse(result.value);
89
- if (!parsed.success) {
90
- logger.error(
91
- { route: "waitlist-signups/me", issues: parsed.error.issues },
92
- "[waitlist-signups] response failed its own contract schema",
93
- );
94
- return reply.status(500).send({
95
- ok: false,
96
- error: { code: "internal_error", message: "Response failed contract validation" },
97
- });
98
- }
99
- return reply.status(200).send({ ok: true, data: parsed.data });
100
- });
101
- };