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