create-ailk 0.1.1 → 0.3.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 (284) hide show
  1. package/component-catalog.md +210 -52
  2. package/dist/cli.js +0 -0
  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 +12 -3
  6. package/dist/lib/extract-module-bundle.js +236 -24
  7. package/dist/lib/fetch-module.d.ts +3 -38
  8. package/dist/lib/fetch-module.js +26 -8
  9. package/dist/lib/module-license-gate.d.ts +2 -0
  10. package/dist/lib/module-license-gate.js +1 -0
  11. package/dist/lib/paid-paths.d.ts +16 -0
  12. package/dist/lib/paid-paths.js +90 -0
  13. package/dist/module-architecture.d.ts +139 -23
  14. package/dist/module-architecture.js +668 -25
  15. package/dist/parse-args.d.ts +2 -2
  16. package/dist/parse-args.js +3 -1
  17. package/dist/programmatic.d.ts +2 -1
  18. package/dist/programmatic.js +15 -4
  19. package/dist/surfaces.d.ts +12 -36
  20. package/dist/surfaces.js +35 -5
  21. package/dist/sync-routes.js +31 -1
  22. package/package.json +14 -15
  23. package/templates/.claude/agents/web.md +2 -3
  24. package/templates/.claude/rules/architecture.md +5 -5
  25. package/templates/.claude/skills/README.md +2 -1
  26. package/templates/.env.example +21 -9
  27. package/templates/CONVENTIONS.md +6 -7
  28. package/templates/apps/api/.env.example +9 -0
  29. package/templates/apps/api/CLAUDE.md +35 -4
  30. package/templates/apps/api/package.json +0 -1
  31. package/templates/apps/api/src/__tests__/cors.test.ts +195 -0
  32. package/templates/apps/api/src/__tests__/module-exclusion.test.ts +60 -2
  33. package/templates/apps/api/src/__tests__/vercel-handler.test.ts +159 -0
  34. package/templates/apps/api/src/config/__tests__/modules.test.ts +76 -0
  35. package/templates/apps/api/src/config/index.ts +19 -0
  36. package/templates/apps/api/src/config/modules.ts +12 -14
  37. package/templates/apps/api/src/lib/__mocks__/prisma.ts +13 -0
  38. package/templates/apps/api/src/lib/__tests__/slice-load.test.ts +89 -0
  39. package/templates/apps/api/src/lib/slice-load.ts +90 -0
  40. package/templates/apps/api/src/openapi/__tests__/openapi.test.ts +52 -32
  41. package/templates/apps/api/src/openapi/__tests__/spec-identity.test.ts +182 -0
  42. package/templates/apps/api/src/openapi/__tests__/surface-drift.test.ts +293 -0
  43. package/templates/apps/api/src/openapi/index.ts +9 -3
  44. package/templates/apps/api/src/openapi/spec.ts +505 -65
  45. package/templates/apps/api/src/openapi/surface-drift.ts +195 -0
  46. package/templates/apps/api/src/routes/content/__tests__/create.test.ts +14 -0
  47. package/templates/apps/api/src/routes/content/__tests__/delete.test.ts +14 -0
  48. package/templates/apps/api/src/routes/content/__tests__/update.test.ts +14 -0
  49. package/templates/apps/api/src/routes/content/index.ts +38 -11
  50. package/templates/apps/api/src/routes/project-listings/__tests__/configured-application.test.ts +28 -0
  51. package/templates/apps/api/src/routes/project-listings/__tests__/drafts.test.ts +144 -0
  52. package/templates/apps/api/src/routes/project-listings/__tests__/founder-identity.test.ts +796 -0
  53. package/templates/apps/api/src/routes/project-listings/__tests__/me.test.ts +478 -0
  54. package/templates/apps/api/src/routes/project-listings/__tests__/public.test.ts +38 -0
  55. package/templates/apps/api/src/routes/project-listings/__tests__/resume-email.test.ts +814 -0
  56. package/templates/apps/api/src/routes/project-listings/__tests__/site-answers.test.ts +717 -0
  57. package/templates/apps/api/src/routes/project-listings/__tests__/site-key.test.ts +35 -0
  58. package/templates/apps/api/src/routes/project-listings/__tests__/structured-address.test.ts +484 -0
  59. package/templates/apps/api/src/routes/project-listings/index.ts +52 -10
  60. package/templates/apps/api/src/routes/project-listings/me.ts +86 -0
  61. package/templates/apps/api/src/routes/project-listings/patch-draft.ts +5 -0
  62. package/templates/apps/api/src/routes/project-listings/public.ts +5 -0
  63. package/templates/apps/api/src/routes/project-listings/respond.ts +11 -0
  64. package/templates/apps/api/src/routes/project-listings/resume-token.ts +5 -0
  65. package/templates/apps/api/src/routes/project-listings/start.ts +38 -0
  66. package/templates/apps/api/src/routes/project-listings/submit.ts +5 -0
  67. package/templates/apps/api/src/routes/project-listings/verify-email.ts +150 -0
  68. package/templates/apps/api/src/server.ts +471 -133
  69. package/templates/apps/api/src/services/__tests__/consent-migration.test.ts +65 -0
  70. package/templates/apps/api/src/services/__tests__/consent.test.ts +282 -0
  71. package/templates/apps/api/src/services/consent.ts +236 -0
  72. package/templates/apps/api/src/services/deliverable-fulfillment.ts +10 -0
  73. package/templates/apps/api/src/services/listing-config.ts +58 -0
  74. package/templates/apps/api/src/services/project-listing-resume-email.ts +326 -0
  75. package/templates/apps/api/src/services/project-listings.ts +602 -29
  76. package/templates/apps/api/src/vercel-handler.ts +60 -26
  77. package/templates/apps/mcp/.env.example +8 -0
  78. package/templates/apps/mcp/CLAUDE.md +2 -2
  79. package/templates/apps/mcp/__tests__/catalog-drift.test.ts +21 -0
  80. package/templates/apps/mcp/__tests__/config/modules.test.ts +78 -0
  81. package/templates/apps/mcp/__tests__/module-exclusion.test.ts +1 -1
  82. package/templates/apps/mcp/src/config/modules.ts +14 -13
  83. package/templates/apps/mcp/src/server.ts +8 -4
  84. package/templates/apps/mcp/src/tools/index.ts +7 -22
  85. package/templates/apps/web/.env.example +15 -0
  86. package/templates/apps/web/app/[locale]/(authed)/{waitlist/__tests__ → __tests__}/gate.test.tsx +4 -4
  87. package/templates/apps/web/app/[locale]/flows/[slug]/FlowStepperClient.tsx +2 -1
  88. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/FlowStepperClient.permalink.test.tsx +2 -1
  89. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/FlowStepperClient.test.tsx +2 -1
  90. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/flow.actions.test.ts +1 -0
  91. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/two-route-tool.test.tsx +1 -0
  92. package/templates/apps/web/app/[locale]/flows/[slug]/flow.actions.ts +2 -1
  93. package/templates/apps/web/app/[locale]/flows/[slug]/page.tsx +1 -0
  94. package/templates/apps/web/app/[locale]/flows/[slug]/start/page.tsx +1 -0
  95. package/templates/apps/web/app/[locale]/layout.tsx +13 -1
  96. package/templates/apps/web/app/llms.txt/route.ts +12 -9
  97. package/templates/apps/web/jest.config.cjs +20 -13
  98. package/templates/apps/web/lib/__tests__/site-theme.test.ts +112 -0
  99. package/templates/apps/web/lib/site-brand.tsx +4 -1
  100. package/templates/apps/web/lib/site-theme.ts +74 -0
  101. package/templates/apps/web/next.config.mjs +1 -3
  102. package/templates/apps/web/package.json +1 -6
  103. package/templates/apps/web/public/android-chrome-192x192.png +0 -0
  104. package/templates/apps/web/public/android-chrome-512x512.png +0 -0
  105. package/templates/apps/web/public/apple-touch-icon.png +0 -0
  106. package/templates/apps/web/public/favicon-16x16.png +0 -0
  107. package/templates/apps/web/public/favicon-32x32.png +0 -0
  108. package/templates/apps/web/public/favicon.ico +0 -0
  109. package/templates/apps/web/public/favicon.svg +6 -3
  110. package/templates/apps/web/public/lockup-horizontal.svg +4 -0
  111. package/templates/apps/web/public/logomark.svg +4 -0
  112. package/templates/apps/web/public/site.webmanifest +2 -2
  113. package/templates/apps/web/public/wordmark.svg +4 -0
  114. package/templates/content/_site.mdx +12 -0
  115. package/templates/database/CHANGELOG.md +94 -0
  116. package/templates/database/inbox/schema.prisma +165 -0
  117. package/templates/database/migrations/20260911140000_listing_structured_address/migration.sql +32 -0
  118. package/templates/database/migrations/20260911180000_consent_grants/migration.sql +71 -0
  119. package/templates/database/migrations/20260911200000_listing_site_answers/migration.sql +30 -0
  120. package/templates/database/migrations/20260912120000_listing_owner_link/migration.sql +49 -0
  121. package/templates/database/migrations/20260914120000_listing_founder_identity/migration.sql +123 -0
  122. package/templates/database/package.json +1 -1
  123. package/templates/database/scripts/db-generate-locked.sh +0 -0
  124. package/templates/package.json +1 -1
  125. package/templates/.claude/skills/scaffold-commerce/SKILL.md +0 -807
  126. package/templates/.claude/skills/scaffold-commerce/references/lookup-keys-template.md +0 -71
  127. package/templates/.claude/skills/scaffold-commerce/references/marketplace-brand-pages.md +0 -83
  128. package/templates/.claude/skills/scaffold-commerce/templates/checkout-route.template.ts +0 -370
  129. package/templates/.claude/skills/scaffold-commerce/templates/invoice-route.template.ts +0 -376
  130. package/templates/.claude/skills/scaffold-commerce/templates/marketplace-cta-route.tsx.tmpl +0 -72
  131. package/templates/.claude/skills/scaffold-commerce/templates/payment-link-route.template.ts +0 -471
  132. package/templates/.claude/skills/scaffold-commerce/templates/portal-route.template.ts +0 -365
  133. package/templates/.claude/skills/scaffold-commerce/templates/stripe-config.template.ts +0 -60
  134. package/templates/.claude/skills/scaffold-commerce/templates/subscription-route.template.ts +0 -446
  135. package/templates/apps/api/src/__tests__/server.test.ts +0 -253
  136. package/templates/apps/api/src/bin/deliverable-resend.ts +0 -144
  137. package/templates/apps/api/src/bin/deliverable-upload.ts +0 -114
  138. package/templates/apps/api/src/bin/followup-sweep.ts +0 -44
  139. package/templates/apps/api/src/bin/listing-csv-sweep.ts +0 -46
  140. package/templates/apps/api/src/bin/seed-presets.ts +0 -58
  141. package/templates/apps/api/src/bin/seed-waitlist-experiments.ts +0 -104
  142. package/templates/apps/api/src/bin/session-retention-sweep.ts +0 -46
  143. package/templates/apps/api/src/lib/__tests__/stripe.test.ts +0 -74
  144. package/templates/apps/api/src/lib/stripe.ts +0 -52
  145. package/templates/apps/api/src/lib/tenant-db.ts +0 -225
  146. package/templates/apps/api/src/lib/ws-token.ts +0 -91
  147. package/templates/apps/api/src/middleware/tenant.ts +0 -99
  148. package/templates/apps/api/src/routes/billing/__tests__/portal.test.ts +0 -450
  149. package/templates/apps/api/src/routes/billing/__tests__/read.test.ts +0 -262
  150. package/templates/apps/api/src/routes/billing/__tests__/usage.test.ts +0 -436
  151. package/templates/apps/api/src/routes/billing/index.ts +0 -36
  152. package/templates/apps/api/src/routes/billing/portal.ts +0 -182
  153. package/templates/apps/api/src/routes/billing/read.ts +0 -75
  154. package/templates/apps/api/src/routes/billing/usage.ts +0 -153
  155. package/templates/apps/api/src/routes/checkout/__tests__/sessions.test.ts +0 -687
  156. package/templates/apps/api/src/routes/checkout/index.ts +0 -13
  157. package/templates/apps/api/src/routes/checkout/sessions.ts +0 -197
  158. package/templates/apps/api/src/routes/deliverables/__tests__/index.test.ts +0 -393
  159. package/templates/apps/api/src/routes/deliverables/index.ts +0 -200
  160. package/templates/apps/api/src/routes/flow-checkouts/__tests__/index.test.ts +0 -443
  161. package/templates/apps/api/src/routes/flow-checkouts/index.ts +0 -82
  162. package/templates/apps/api/src/routes/flows/README.md +0 -147
  163. package/templates/apps/api/src/routes/flows/__tests__/index.test.ts +0 -752
  164. package/templates/apps/api/src/routes/flows/__tests__/recommender.test.ts +0 -671
  165. package/templates/apps/api/src/routes/flows/index.ts +0 -202
  166. package/templates/apps/api/src/routes/flows/recommender.ts +0 -443
  167. package/templates/apps/api/src/routes/project-listings/__tests__/copy-edit.test.ts +0 -815
  168. package/templates/apps/api/src/routes/project-listings/__tests__/tenant-isolation.test.ts +0 -566
  169. package/templates/apps/api/src/routes/project-listings/get.ts +0 -70
  170. package/templates/apps/api/src/routes/project-listings/list.ts +0 -47
  171. package/templates/apps/api/src/routes/project-listings/patch.ts +0 -136
  172. package/templates/apps/api/src/routes/schedule/__tests__/index.test.ts +0 -490
  173. package/templates/apps/api/src/routes/schedule/index.ts +0 -249
  174. package/templates/apps/api/src/routes/slack/__tests__/actions.test.ts +0 -385
  175. package/templates/apps/api/src/routes/slack/actions.ts +0 -177
  176. package/templates/apps/api/src/routes/slack/index.ts +0 -38
  177. package/templates/apps/api/src/routes/waitlist-experiments/__tests__/tenant-isolation.test.ts +0 -577
  178. package/templates/apps/api/src/routes/waitlist-experiments/comparison.ts +0 -78
  179. package/templates/apps/api/src/routes/waitlist-experiments/index.ts +0 -41
  180. package/templates/apps/api/src/routes/waitlist-experiments/list.ts +0 -64
  181. package/templates/apps/api/src/routes/waitlist-experiments/respond.ts +0 -42
  182. package/templates/apps/api/src/routes/waitlist-experiments/signup.ts +0 -84
  183. package/templates/apps/api/src/routes/waitlist-experiments/signups.ts +0 -119
  184. package/templates/apps/api/src/routes/waitlist-signups/__tests__/index.test.ts +0 -238
  185. package/templates/apps/api/src/routes/waitlist-signups/index.ts +0 -101
  186. package/templates/apps/api/src/routes/webhooks/README.md +0 -80
  187. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-flow-checkout.test.ts +0 -315
  188. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-idempotency.test.ts +0 -247
  189. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-org-billing.test.ts +0 -270
  190. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-rate-limit.test.ts +0 -198
  191. package/templates/apps/api/src/routes/webhooks/__tests__/stripe.test.ts +0 -633
  192. package/templates/apps/api/src/routes/webhooks/index.ts +0 -41
  193. package/templates/apps/api/src/routes/webhooks/stripe.ts +0 -481
  194. package/templates/apps/api/src/routes/workspaces/__tests__/config-tenant-isolation.test.ts +0 -356
  195. package/templates/apps/api/src/routes/workspaces/__tests__/tenant-isolation.test.ts +0 -671
  196. package/templates/apps/api/src/routes/workspaces/config.ts +0 -125
  197. package/templates/apps/api/src/routes/workspaces/index.ts +0 -194
  198. package/templates/apps/api/src/routes/workspaces/sessions.ts +0 -218
  199. package/templates/apps/api/src/services/__tests__/flow-aggregate.test.ts +0 -425
  200. package/templates/apps/api/src/services/__tests__/flow-engine.test.ts +0 -2840
  201. package/templates/apps/api/src/services/__tests__/lead-promotion.test.ts +0 -393
  202. package/templates/apps/api/src/services/__tests__/listing-csv-sweep.test.ts +0 -560
  203. package/templates/apps/api/src/services/__tests__/playbook-compile.test.ts +0 -406
  204. package/templates/apps/api/src/services/__tests__/playbook-render.test.ts +0 -290
  205. package/templates/apps/api/src/services/__tests__/project-listing-decision.test.ts +0 -736
  206. package/templates/apps/api/src/services/__tests__/project-listing-flow.test.ts +0 -475
  207. package/templates/apps/api/src/services/__tests__/project-listing-issue.test.ts +0 -340
  208. package/templates/apps/api/src/services/__tests__/recommender-capture.test.ts +0 -983
  209. package/templates/apps/api/src/services/__tests__/tenant-context-cascade.test.ts +0 -71
  210. package/templates/apps/api/src/services/__tests__/tenant-context.test.ts +0 -379
  211. package/templates/apps/api/src/services/__tests__/usage-metering.test.ts +0 -768
  212. package/templates/apps/api/src/services/__tests__/waitlist-dashboard.test.ts +0 -1314
  213. package/templates/apps/api/src/services/__tests__/waitlist-experiments.test.ts +0 -341
  214. package/templates/apps/api/src/services/__tests__/waitlist-followup.test.ts +0 -567
  215. package/templates/apps/api/src/services/__tests__/waitlist-scoring.test.ts +0 -474
  216. package/templates/apps/api/src/services/__tests__/waitlist-signups.test.ts +0 -354
  217. package/templates/apps/api/src/services/flow-aggregate.ts +0 -232
  218. package/templates/apps/api/src/services/flow-checkouts.ts +0 -123
  219. package/templates/apps/api/src/services/flow-engine.ts +0 -1278
  220. package/templates/apps/api/src/services/lead-promotion.ts +0 -176
  221. package/templates/apps/api/src/services/listing-csv-sweep.ts +0 -455
  222. package/templates/apps/api/src/services/playbook-compile.ts +0 -398
  223. package/templates/apps/api/src/services/playbook-render.ts +0 -263
  224. package/templates/apps/api/src/services/project-listing-decision.ts +0 -490
  225. package/templates/apps/api/src/services/project-listing-flow.ts +0 -426
  226. package/templates/apps/api/src/services/project-listing-issue.ts +0 -251
  227. package/templates/apps/api/src/services/recommender-capture.ts +0 -835
  228. package/templates/apps/api/src/services/scheduling/cal-provider.ts +0 -392
  229. package/templates/apps/api/src/services/scheduling/index.ts +0 -63
  230. package/templates/apps/api/src/services/scheduling/types.ts +0 -88
  231. package/templates/apps/api/src/services/tenant-context.ts +0 -451
  232. package/templates/apps/api/src/services/usage-metering.ts +0 -699
  233. package/templates/apps/api/src/services/waitlist-dashboard.ts +0 -947
  234. package/templates/apps/api/src/services/waitlist-experiments.ts +0 -213
  235. package/templates/apps/api/src/services/waitlist-followup.ts +0 -486
  236. package/templates/apps/api/src/services/waitlist-scoring.ts +0 -166
  237. package/templates/apps/api/src/services/waitlist-signups.ts +0 -165
  238. package/templates/apps/mcp/__tests__/schedule_tools.test.ts +0 -242
  239. package/templates/apps/mcp/src/tools/create_booking.ts +0 -58
  240. package/templates/apps/mcp/src/tools/get_event_meta.ts +0 -55
  241. package/templates/apps/mcp/src/tools/get_flow.ts +0 -61
  242. package/templates/apps/mcp/src/tools/list_availability.ts +0 -67
  243. package/templates/apps/mcp/src/tools/submit_flow_step.ts +0 -83
  244. package/templates/apps/web/app/[locale]/(authed)/waitlist/[experimentId]/page.tsx +0 -309
  245. package/templates/apps/web/app/[locale]/(authed)/waitlist/[experimentId]/signups/[leadId]/page.tsx +0 -149
  246. package/templates/apps/web/app/[locale]/(authed)/waitlist/__tests__/comparison.test.tsx +0 -273
  247. package/templates/apps/web/app/[locale]/(authed)/waitlist/__tests__/list.test.tsx +0 -171
  248. package/templates/apps/web/app/[locale]/(authed)/waitlist/__tests__/signup.test.tsx +0 -179
  249. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/ExperimentsTable.tsx +0 -116
  250. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/OfferFunnelTable.tsx +0 -66
  251. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/RollupTicker.tsx +0 -61
  252. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/ScoreTrace.tsx +0 -114
  253. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/SignupsTable.tsx +0 -139
  254. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/WaitlistComparisonTabs.tsx +0 -85
  255. package/templates/apps/web/app/[locale]/(authed)/waitlist/components/status-badges.tsx +0 -67
  256. package/templates/apps/web/app/[locale]/(authed)/waitlist/page.tsx +0 -179
  257. package/templates/apps/web/app/[locale]/blog/[[...slug]]/page.tsx +0 -178
  258. package/templates/apps/web/app/[locale]/dev/purchase/__tests__/actions.test.ts +0 -160
  259. package/templates/apps/web/app/[locale]/dev/purchase/error.tsx +0 -25
  260. package/templates/apps/web/app/[locale]/dev/purchase/page.tsx +0 -117
  261. package/templates/apps/web/app/[locale]/dev/purchase/purchase.actions.ts +0 -58
  262. package/templates/apps/web/app/[locale]/docs/[[...slug]]/page.tsx +0 -119
  263. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/checkout.actions.test.ts +0 -287
  264. package/templates/apps/web/app/[locale]/flows/[slug]/checkout.actions.ts +0 -254
  265. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/ResultsClient.tsx +0 -532
  266. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/ResultsEmailStep.tsx +0 -121
  267. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/__tests__/ResultsClient.checkout.test.tsx +0 -457
  268. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/__tests__/page.test.tsx +0 -396
  269. package/templates/apps/web/app/[locale]/flows/[slug]/results/[payload]/page.tsx +0 -114
  270. package/templates/apps/web/app/[locale]/projects/apply/ListingApplicationClient.tsx +0 -110
  271. package/templates/apps/web/app/[locale]/projects/apply/__tests__/ListingApplicationClient.test.tsx +0 -96
  272. package/templates/apps/web/app/[locale]/schedule/__tests__/page.test.tsx +0 -117
  273. package/templates/apps/web/app/[locale]/schedule/confirmed/__tests__/page.test.tsx +0 -96
  274. package/templates/apps/web/app/[locale]/schedule/confirmed/page.tsx +0 -92
  275. package/templates/apps/web/app/[locale]/schedule/page.tsx +0 -82
  276. package/templates/apps/web/content/en/blog/README.txt +0 -25
  277. package/templates/apps/web/content/en/docs/index.mdx +0 -28
  278. package/templates/apps/web/lib/__mocks__/source-server.js +0 -31
  279. package/templates/apps/web/lib/blog-list-data.ts +0 -95
  280. package/templates/apps/web/lib/blog-post-data.ts +0 -79
  281. package/templates/apps/web/lib/source.ts +0 -34
  282. package/templates/apps/web/public/logomark-dark.svg +0 -4
  283. package/templates/apps/web/public/logomark-light.svg +0 -4
  284. 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
- };