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,356 +0,0 @@
1
- // oss: false
2
- /**
3
- * @file config-tenant-isolation.test.ts
4
- *
5
- * THE ACCEPTANCE GATE for the workspace-scoped site-config write surface
6
- * (STC-P4 / #3634): a member of Org A must not read or write Org B's site
7
- * config (theme / identity / seo) by ANY route.
8
- *
9
- * Fixture: two orgs, alice = owner of org A (active wsA), bob = owner of org B
10
- * (active wsB). The prisma mock HONORS where-clauses (workspace/membership
11
- * compound key) and keeps a per-workspace in-memory config store so a PUT then
12
- * GET round-trips — cross-tenant denials are additionally asserted by "config
13
- * query never ran" (the guard 403s before any handler touches the model).
14
- *
15
- * Registration mirrors server.ts exactly: auth preHandler → nested scope
16
- * { tenant guard → workspaceConfigRoutes }.
17
- *
18
- * SECURITY-SENSITIVE (tenant isolation for untrusted end-tenants) — see spec
19
- * §5.3: this suite is the objective pass/fail record the mandatory
20
- * `security-reviewer` verifies against.
21
- */
22
- import Fastify from "fastify";
23
- import type { FastifyInstance } from "fastify";
24
-
25
- // eslint-disable-next-line no-restricted-syntax -- jest mock factory must be hoisted
26
- jest.mock("../../../lib/prisma.js", () => ({
27
- prisma: {
28
- session: { findUnique: jest.fn(), update: jest.fn() },
29
- apiToken: {
30
- findUnique: jest.fn(),
31
- update: jest.fn().mockResolvedValue(undefined),
32
- },
33
- workspace: { findUnique: jest.fn(), count: jest.fn() },
34
- membership: { findUnique: jest.fn() },
35
- workspaceTheme: {
36
- findUnique: jest.fn(),
37
- upsert: jest.fn(),
38
- deleteMany: jest.fn(),
39
- },
40
- workspaceSiteIdentity: {
41
- findUnique: jest.fn(),
42
- upsert: jest.fn(),
43
- deleteMany: jest.fn(),
44
- },
45
- workspaceSEO: {
46
- findUnique: jest.fn(),
47
- upsert: jest.fn(),
48
- deleteMany: jest.fn(),
49
- },
50
- },
51
- }));
52
-
53
- import { prisma } from "../../../lib/prisma.js";
54
- import { authPreHandlerPlugin } from "../../../middleware/auth.js";
55
- import { tenantPreHandlerPlugin } from "../../../middleware/tenant.js";
56
- import { workspaceConfigRoutes } from "../config.js";
57
-
58
- const FRONTEND = "https://app.example.com";
59
- const FUTURE = new Date(Date.now() + 60 * 60 * 1000);
60
-
61
- const WS_A = "wksp_00000000-0000-7000-8000-0000000000aa";
62
- const WS_B = "wksp_00000000-0000-7000-8000-0000000000bb";
63
- const ORG_A = "org_00000000-0000-7000-8000-000000000aaa";
64
- const ORG_B = "org_00000000-0000-7000-8000-000000000bbb";
65
-
66
- // ── Fixture data ────────────────────────────────────────────────────────────
67
-
68
- const WORKSPACES = [
69
- { id: WS_A, organizationId: ORG_A },
70
- { id: WS_B, organizationId: ORG_B },
71
- ];
72
-
73
- const MEMBERSHIPS = [
74
- { organizationId: ORG_A, userId: "alice", role: "owner" },
75
- { organizationId: ORG_B, userId: "bob", role: "owner" },
76
- ];
77
-
78
- const SESSION_ROWS: Record<string, Record<string, unknown>> = {
79
- cookie_alice: {
80
- id: "sess_alice",
81
- userId: "alice",
82
- expiresAt: FUTURE,
83
- activeOrganizationId: ORG_A,
84
- activeWorkspaceId: WS_A,
85
- },
86
- cookie_bob: {
87
- id: "sess_bob",
88
- userId: "bob",
89
- expiresAt: FUTURE,
90
- activeOrganizationId: ORG_B,
91
- activeWorkspaceId: WS_B,
92
- },
93
- };
94
-
95
- // ── Valid config bodies (schema-conformant) ─────────────────────────────────
96
-
97
- const PALETTE = {
98
- bg: "#ffffff",
99
- bgMuted: "#f5f5f5",
100
- surface: "#ffffff",
101
- border: "#e5e5e5",
102
- text: "#111111",
103
- textMuted: "#666666",
104
- primary: "#2563eb",
105
- primaryFg: "#ffffff",
106
- accent: "#9333ea",
107
- accentFg: "#ffffff",
108
- destructive: "#dc2626",
109
- destructiveFg: "#ffffff",
110
- };
111
-
112
- const VALID_THEME = {
113
- version: "1",
114
- colors: { light: PALETTE, dark: PALETTE },
115
- radius: { sm: "2px", md: "6px", lg: "12px" },
116
- shadow: { sm: "0 1px 2px", md: "0 2px 4px", lg: "0 4px 8px" },
117
- fonts: { display: "Inter", body: "Inter" },
118
- lineHeight: { tight: "1.1", normal: "1.5", relaxed: "1.8" },
119
- icon: { sm: "16px", md: "20px", lg: "24px" },
120
- breakpoint: { sm: "640px", md: "768px", lg: "1024px", xl: "1280px" },
121
- container: { sm: "640px", md: "768px", lg: "1024px", xl: "1280px" },
122
- };
123
-
124
- const VALID_IDENTITY = {
125
- kind: "Organization",
126
- name: "Acme",
127
- url: "https://acme.example",
128
- };
129
-
130
- const VALID_SEO = { version: "1", description: "Acme site" };
131
-
132
- const CONFIG_CASES = [
133
- { type: "theme", model: "workspaceTheme", valid: VALID_THEME },
134
- { type: "identity", model: "workspaceSiteIdentity", valid: VALID_IDENTITY },
135
- { type: "seo", model: "workspaceSEO", valid: VALID_SEO },
136
- ] as const;
137
-
138
- // ── Where-clause-honoring mock wiring (stateful config store) ───────────────
139
-
140
- type Where = Record<string, unknown>;
141
-
142
- /** Per-model, per-workspaceId in-memory store so PUT→GET round-trips. */
143
- function installFixtureMocks(): void {
144
- (prisma.session.findUnique as jest.Mock).mockImplementation(
145
- ({ where }: { where: { token?: string } }) =>
146
- Promise.resolve(where.token ? (SESSION_ROWS[where.token] ?? null) : null),
147
- );
148
- (prisma.session.update as jest.Mock).mockResolvedValue({});
149
-
150
- (prisma.workspace.findUnique as jest.Mock).mockImplementation(
151
- ({ where }: { where: { id?: string } }) =>
152
- Promise.resolve(WORKSPACES.find((w) => w.id === where.id) ?? null),
153
- );
154
- // Genuinely multi-tenant (2 workspaces) — the single-tenant default-resolution
155
- // branch (count() === 1) must never fire, so an unbound session keeps denying.
156
- (prisma.workspace.count as jest.Mock).mockResolvedValue(WORKSPACES.length);
157
-
158
- (prisma.membership.findUnique as jest.Mock).mockImplementation(
159
- ({
160
- where,
161
- }: {
162
- where: {
163
- organizationId_userId?: { organizationId: string; userId: string };
164
- };
165
- }) => {
166
- const key = where.organizationId_userId;
167
- if (!key) return Promise.resolve(null);
168
- return Promise.resolve(
169
- MEMBERSHIPS.find(
170
- (m) =>
171
- m.organizationId === key.organizationId && m.userId === key.userId,
172
- ) ?? null,
173
- );
174
- },
175
- );
176
-
177
- for (const { model } of CONFIG_CASES) {
178
- const store = new Map<
179
- string,
180
- { id: string; workspaceId: string; data: unknown }
181
- >();
182
- const delegate = prisma[model];
183
- (delegate.findUnique as jest.Mock).mockImplementation(
184
- ({ where }: { where: { workspaceId?: string } }) =>
185
- Promise.resolve(
186
- where.workspaceId ? (store.get(where.workspaceId) ?? null) : null,
187
- ),
188
- );
189
- (delegate.upsert as jest.Mock).mockImplementation(
190
- ({
191
- where,
192
- create,
193
- update,
194
- }: {
195
- where: { workspaceId: string };
196
- create: { workspaceId: string; data: unknown };
197
- update: { data: unknown };
198
- }) => {
199
- const existing = store.get(where.workspaceId);
200
- const row = existing
201
- ? { ...existing, data: update.data }
202
- : {
203
- id: `${model}_row`,
204
- workspaceId: create.workspaceId,
205
- data: create.data,
206
- };
207
- store.set(where.workspaceId, row);
208
- return Promise.resolve(row);
209
- },
210
- );
211
- (delegate.deleteMany as jest.Mock).mockImplementation(
212
- ({ where }: { where: { workspaceId?: string } }) => {
213
- const had = where.workspaceId ? store.has(where.workspaceId) : false;
214
- if (where.workspaceId) store.delete(where.workspaceId);
215
- return Promise.resolve({ count: had ? 1 : 0 });
216
- },
217
- );
218
- }
219
- }
220
-
221
- // ── App assembly (mirrors server.ts registration order) ─────────────────────
222
-
223
- async function buildApp(): Promise<FastifyInstance> {
224
- const app = Fastify();
225
- app.register(authPreHandlerPlugin, { frontendOrigin: FRONTEND });
226
- app.register(async (scope) => {
227
- await scope.register(tenantPreHandlerPlugin);
228
- await scope.register(workspaceConfigRoutes);
229
- });
230
- await app.ready();
231
- return app;
232
- }
233
-
234
- function cookieHeaders(
235
- token: string,
236
- mutating = false,
237
- ): Record<string, string> {
238
- return {
239
- cookie: `better-auth.session_token=${token}`,
240
- ...(mutating ? { origin: FRONTEND } : {}),
241
- };
242
- }
243
-
244
- describe("site-config tenant isolation — cross-org read/write denied on every config route", () => {
245
- let app: FastifyInstance;
246
-
247
- beforeEach(async () => {
248
- jest.clearAllMocks();
249
- installFixtureMocks();
250
- app = await buildApp();
251
- });
252
-
253
- afterEach(async () => {
254
- await app.close();
255
- });
256
-
257
- describe.each(CONFIG_CASES)("$type", ({ type, model, valid }) => {
258
- const own = `/v1/workspaces/${WS_A}/${type}`;
259
- const foreign = `/v1/workspaces/${WS_B}/${type}`;
260
- // The mocked delegate for this config type — jest's `expect` accepts the
261
- // mock fns directly (matching the sibling tenant-isolation.test.ts pattern).
262
- const delegate = prisma[model];
263
-
264
- // AC-1 — own-workspace write then read round-trips; server-side scope only.
265
- it("PUT own workspace with a valid body → 200 and GET returns the stored blob", async () => {
266
- const put = await app.inject({
267
- method: "PUT",
268
- url: own,
269
- headers: cookieHeaders("cookie_alice", true),
270
- payload: valid,
271
- });
272
- expect(put.statusCode).toBe(200);
273
- expect(put.json().ok).toBe(true);
274
- expect(put.json().data).toEqual(valid);
275
- // The upsert is scoped to the resolved workspace, never a body-supplied id.
276
- expect(delegate.upsert).toHaveBeenCalledWith(
277
- expect.objectContaining({ where: { workspaceId: WS_A } }),
278
- );
279
-
280
- const get = await app.inject({
281
- method: "GET",
282
- url: own,
283
- headers: cookieHeaders("cookie_alice"),
284
- });
285
- expect(get.statusCode).toBe(200);
286
- expect(get.json().data).toEqual(valid);
287
- });
288
-
289
- // AC-4 — GET a not-yet-configured workspace → data: null (not 404).
290
- it("GET an unconfigured workspace → { ok: true, data: null }", async () => {
291
- const res = await app.inject({
292
- method: "GET",
293
- url: own,
294
- headers: cookieHeaders("cookie_alice"),
295
- });
296
- expect(res.statusCode).toBe(200);
297
- expect(res.json()).toEqual({ ok: true, data: null });
298
- });
299
-
300
- // AC-3 — invalid body → 400, no upsert.
301
- it("PUT with a schema-invalid body → 400 validation_failed, no upsert runs", async () => {
302
- const res = await app.inject({
303
- method: "PUT",
304
- url: own,
305
- headers: cookieHeaders("cookie_alice", true),
306
- payload: { bogus: true },
307
- });
308
- expect(res.statusCode).toBe(400);
309
- expect(res.json().error.code).toBe("validation_failed");
310
- expect(delegate.upsert).not.toHaveBeenCalled();
311
- });
312
-
313
- // AC-2 — cross-workspace READ denied, no config query runs.
314
- it("GET a foreign workspace's config → 403, no config query runs", async () => {
315
- const res = await app.inject({
316
- method: "GET",
317
- url: foreign,
318
- headers: cookieHeaders("cookie_alice"),
319
- });
320
- expect(res.statusCode).toBe(403);
321
- expect(delegate.findUnique).not.toHaveBeenCalled();
322
- });
323
-
324
- // AC-2 — cross-workspace WRITE denied, no config query runs.
325
- it("PUT a foreign workspace's config → 403, no upsert runs", async () => {
326
- const res = await app.inject({
327
- method: "PUT",
328
- url: foreign,
329
- headers: cookieHeaders("cookie_alice", true),
330
- payload: valid,
331
- });
332
- expect(res.statusCode).toBe(403);
333
- expect(delegate.upsert).not.toHaveBeenCalled();
334
- });
335
-
336
- // AC-2 — unauthenticated → 401.
337
- it("GET without a session → 401", async () => {
338
- const res = await app.inject({ method: "GET", url: own });
339
- expect(res.statusCode).toBe(401);
340
- });
341
-
342
- // Grant path works for the other tenant too.
343
- it("the owning tenant of the other org CAN write its own config", async () => {
344
- const res = await app.inject({
345
- method: "PUT",
346
- url: `/v1/workspaces/${WS_B}/${type}`,
347
- headers: cookieHeaders("cookie_bob", true),
348
- payload: valid,
349
- });
350
- expect(res.statusCode).toBe(200);
351
- expect(delegate.upsert).toHaveBeenCalledWith(
352
- expect.objectContaining({ where: { workspaceId: WS_B } }),
353
- );
354
- });
355
- });
356
- });