create-ailk 0.23.0 → 0.25.1

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 (604) hide show
  1. package/README.md +68 -33
  2. package/component-catalog.json +3 -3
  3. package/component-catalog.md +3 -3
  4. package/dist/add-module.js +10 -3
  5. package/dist/add-route.d.ts +12 -1
  6. package/dist/add-route.js +38 -4
  7. package/dist/cli.js +12 -7
  8. package/dist/derive-architecture.d.ts +3 -4
  9. package/dist/derive-architecture.js +75 -22
  10. package/dist/lib/design-checks.d.ts +9 -4
  11. package/dist/lib/design-checks.js +13 -7
  12. package/dist/lib/extract-module-bundle.js +29 -2
  13. package/dist/lib/fetch-template-snapshot.d.ts +1 -1
  14. package/dist/lib/fetch-template-snapshot.js +7 -3
  15. package/dist/lib/import-graph.d.ts +1 -1
  16. package/dist/lib/import-graph.js +4 -4
  17. package/dist/lib/module-license-gate.d.ts +12 -1
  18. package/dist/lib/module-license-gate.js +34 -12
  19. package/dist/lib/scaffold-render-sweep.d.ts +33 -0
  20. package/dist/lib/scaffold-render-sweep.js +45 -0
  21. package/dist/module-architecture.d.ts +20 -3
  22. package/dist/module-architecture.js +122 -538
  23. package/dist/paid-sections.d.ts +25 -1
  24. package/dist/paid-sections.js +88 -3
  25. package/dist/surfaces.js +10 -2
  26. package/dist/sync-routes.d.ts +30 -4
  27. package/dist/sync-routes.js +271 -18
  28. package/dist/template-record.d.ts +14 -4
  29. package/dist/template-record.js +23 -5
  30. package/dist/topology.d.ts +16 -3
  31. package/dist/topology.js +31 -19
  32. package/dist/update.d.ts +10 -1
  33. package/dist/update.js +540 -16
  34. package/package.json +3 -3
  35. package/release-scope.json +1 -1
  36. package/templates/.claude/cloudparity-repo-hooks.json +5 -0
  37. package/templates/.claude/hooks/template-guard.sh +137 -0
  38. package/templates/.claude/rules/extending.md +106 -0
  39. package/templates/.claude/rules/loop-contract.md +2 -2
  40. package/templates/.claude/settings.json +11 -0
  41. package/templates/.env.example +9 -5
  42. package/templates/.github/workflows/ci.yml +7 -4
  43. package/templates/CLAUDE.md +15 -3
  44. package/templates/CONVENTIONS.md +8 -10
  45. package/templates/README.md +14 -13
  46. package/templates/apps/api/.env.example +9 -2
  47. package/templates/apps/api/CLAUDE.md +122 -82
  48. package/templates/apps/api/jest.config.cjs +15 -5
  49. package/templates/apps/api/package.json +16 -20
  50. package/templates/apps/api/src/__tests__/trusted-origins.server.test.ts +2 -2
  51. package/templates/apps/api/src/__tests__/vercel-handler.test.ts +4 -4
  52. package/templates/apps/api/src/index.ts +1 -1
  53. package/templates/apps/api/src/lib/__mocks__/prisma.ts +7 -4
  54. package/templates/apps/api/src/modules/commerce.ts +10 -0
  55. package/templates/apps/api/src/modules/content-write.ts +10 -0
  56. package/templates/apps/api/src/modules/multi-tenant.ts +10 -0
  57. package/templates/apps/api/src/modules/scheduling.ts +10 -0
  58. package/templates/apps/api/src/modules/signal-collectors.ts +10 -0
  59. package/templates/apps/api/src/modules/workspace.ts +10 -0
  60. package/templates/apps/api/src/server.ts +117 -1857
  61. package/templates/apps/api/vercel.json +2 -2
  62. package/templates/apps/mcp/CLAUDE.md +77 -24
  63. package/templates/apps/mcp/__tests__/app-entry.test.ts +4 -254
  64. package/templates/apps/mcp/__tests__/boot-file.test.ts +92 -0
  65. package/templates/apps/mcp/jest.config.cjs +6 -1
  66. package/templates/apps/mcp/package.json +5 -12
  67. package/templates/apps/mcp/src/app.ts +8 -7
  68. package/templates/apps/mcp/src/index.ts +6 -34
  69. package/templates/apps/mcp/src/lib/paid-tools.generated.ts +10 -0
  70. package/templates/apps/mcp/src/lib/topology.generated.ts +2 -2
  71. package/templates/apps/mcp/src/site.ts +12 -0
  72. package/templates/apps/web/.env.example +1 -1
  73. package/templates/apps/web/CLAUDE.md +21 -5
  74. package/templates/apps/web/app/.well-known/mcp.json/route.ts +9 -3
  75. package/templates/apps/web/app/[locale]/contact/__tests__/ConversationalIntakeWrapper.test.tsx +1 -1
  76. package/templates/apps/web/app/[locale]/contact/contact.actions.ts +14 -4
  77. package/templates/apps/web/app/[locale]/contact/intake-analytics.ts +1 -1
  78. package/templates/apps/web/app/[locale]/contact/intake-script.ts +1 -1
  79. package/templates/apps/web/app/[locale]/flows/[slug]/__tests__/magnet-page.test.tsx +22 -1
  80. package/templates/apps/web/app/[locale]/flows/[slug]/magnet-page.tsx +28 -7
  81. package/templates/apps/web/app/[locale]/pricing/__tests__/unconnected.test.tsx +43 -0
  82. package/templates/apps/web/app/[locale]/pricing/page.tsx +7 -3
  83. package/templates/apps/web/app/api/offerings/checkout/[lookupKey]/__tests__/route.test.ts +222 -0
  84. package/templates/apps/web/app/api/offerings/checkout/[lookupKey]/route.ts +10 -3
  85. package/templates/apps/web/app/api/revalidate/route.ts +3 -3
  86. package/templates/apps/web/auth.ts +2 -2
  87. package/templates/apps/web/jest.config.cjs +1 -0
  88. package/templates/apps/web/lib/__tests__/magnet-routes.test.ts +7 -0
  89. package/templates/apps/web/lib/auth-email.ts +1 -1
  90. package/templates/apps/web/lib/magnet-routes.ts +3 -1
  91. package/templates/apps/web/lib/newsletter.actions.ts +9 -6
  92. package/templates/apps/web/lib/relay.ts +2 -2
  93. package/templates/apps/web/lib/release-scope.ts +47 -0
  94. package/templates/apps/web/lib/server-api.ts +1 -1
  95. package/templates/apps/web/src/lib/commerce-claim.ts +1 -1
  96. package/templates/customizations.yaml +37 -0
  97. package/templates/database/prisma.config.ts +10 -14
  98. package/templates/database/seed-test.ts +2 -2
  99. package/templates/database/seed.ts +32 -5
  100. package/templates/package.json +12 -6
  101. package/templates/pnpm-workspace.yaml +0 -1
  102. package/templates/project.yaml +16 -8
  103. package/templates/tools/jest/reporters.cjs +65 -0
  104. package/templates/tools/lint-architecture.ts +757 -7
  105. package/templates/tsconfig.json +1 -2
  106. package/versions.json +48 -35
  107. package/templates/apps/api/src/__tests__/commerce-claim-registration.test.ts +0 -409
  108. package/templates/apps/api/src/__tests__/factories/agent-caller.ts +0 -102
  109. package/templates/apps/api/src/__tests__/factories/content-fixture.ts +0 -138
  110. package/templates/apps/api/src/__tests__/factories/in-memory-prisma.ts +0 -441
  111. package/templates/apps/api/src/__tests__/factories/index.ts +0 -70
  112. package/templates/apps/api/src/__tests__/factories/lead-fixture.ts +0 -82
  113. package/templates/apps/api/src/__tests__/leads-forwarded-rate-limit.test.ts +0 -135
  114. package/templates/apps/api/src/__tests__/services/enrichment-shim.test.ts +0 -126
  115. package/templates/apps/api/src/__tests__/stripe-boot.test.ts +0 -132
  116. package/templates/apps/api/src/__tests__/support/hub-sign-in-fake-db.ts +0 -362
  117. package/templates/apps/api/src/bin/__tests__/rate-limit-probe.test.ts +0 -184
  118. package/templates/apps/api/src/bin/abandon-sweep.ts +0 -42
  119. package/templates/apps/api/src/bin/rate-limit-probe.ts +0 -53
  120. package/templates/apps/api/src/bin/spokes.ts +0 -198
  121. package/templates/apps/api/src/bin/stripe-connections-rekey.ts +0 -45
  122. package/templates/apps/api/src/config/__tests__/hub-require-spoke-key.test.ts +0 -196
  123. package/templates/apps/api/src/config/__tests__/index.test.ts +0 -233
  124. package/templates/apps/api/src/config/__tests__/modules.test.ts +0 -76
  125. package/templates/apps/api/src/config/__tests__/stripe-connection-key.test.ts +0 -185
  126. package/templates/apps/api/src/config/__tests__/trusted-origins.test.ts +0 -238
  127. package/templates/apps/api/src/config/index.ts +0 -596
  128. package/templates/apps/api/src/config/modules.ts +0 -83
  129. package/templates/apps/api/src/lib/__tests__/agent-store.test.ts +0 -581
  130. package/templates/apps/api/src/lib/__tests__/auth-email-budget.test.ts +0 -143
  131. package/templates/apps/api/src/lib/__tests__/consent-ledger-double.ts +0 -237
  132. package/templates/apps/api/src/lib/__tests__/consent-store.test.ts +0 -353
  133. package/templates/apps/api/src/lib/__tests__/content-adapter.test.ts +0 -201
  134. package/templates/apps/api/src/lib/__tests__/deliverable-asset-store.test.ts +0 -224
  135. package/templates/apps/api/src/lib/__tests__/error-serializer.test.ts +0 -120
  136. package/templates/apps/api/src/lib/__tests__/errors.test.ts +0 -94
  137. package/templates/apps/api/src/lib/__tests__/file-fallback.test.ts +0 -144
  138. package/templates/apps/api/src/lib/__tests__/fixtures/HomePage/home.mdx +0 -8
  139. package/templates/apps/api/src/lib/__tests__/flow-completion-store.test.ts +0 -149
  140. package/templates/apps/api/src/lib/__tests__/flow-rename-race.db.test.ts +0 -116
  141. package/templates/apps/api/src/lib/__tests__/hub-sign-in-store.test.ts +0 -209
  142. package/templates/apps/api/src/lib/__tests__/lead-capture-store.test.ts +0 -257
  143. package/templates/apps/api/src/lib/__tests__/lead-delivery.test.ts +0 -96
  144. package/templates/apps/api/src/lib/__tests__/outbound-http.test.ts +0 -125
  145. package/templates/apps/api/src/lib/__tests__/prisma.test.ts +0 -165
  146. package/templates/apps/api/src/lib/__tests__/require-commerce-claim.test.ts +0 -317
  147. package/templates/apps/api/src/lib/__tests__/require-paid-tier.test.ts +0 -129
  148. package/templates/apps/api/src/lib/__tests__/site.test.ts +0 -292
  149. package/templates/apps/api/src/lib/__tests__/slice-load.test.ts +0 -89
  150. package/templates/apps/api/src/lib/__tests__/spoke-store.test.ts +0 -202
  151. package/templates/apps/api/src/lib/__tests__/stripe-admission.test.ts +0 -217
  152. package/templates/apps/api/src/lib/__tests__/stripe.test.ts +0 -82
  153. package/templates/apps/api/src/lib/agent-store.ts +0 -613
  154. package/templates/apps/api/src/lib/auth-email-budget.ts +0 -161
  155. package/templates/apps/api/src/lib/consent-store.ts +0 -363
  156. package/templates/apps/api/src/lib/content-adapter.ts +0 -112
  157. package/templates/apps/api/src/lib/deliverable-asset-store.ts +0 -96
  158. package/templates/apps/api/src/lib/error-serializer.ts +0 -164
  159. package/templates/apps/api/src/lib/errors.ts +0 -95
  160. package/templates/apps/api/src/lib/file-fallback.ts +0 -87
  161. package/templates/apps/api/src/lib/flow-completion-store.ts +0 -136
  162. package/templates/apps/api/src/lib/hub-sign-in-store.ts +0 -455
  163. package/templates/apps/api/src/lib/lead-capture-store.ts +0 -122
  164. package/templates/apps/api/src/lib/lead-delivery.ts +0 -52
  165. package/templates/apps/api/src/lib/license-key-store.ts +0 -45
  166. package/templates/apps/api/src/lib/locales.ts +0 -201
  167. package/templates/apps/api/src/lib/outbound-http.ts +0 -127
  168. package/templates/apps/api/src/lib/prisma.ts +0 -21
  169. package/templates/apps/api/src/lib/proposal-paid-store.ts +0 -66
  170. package/templates/apps/api/src/lib/rate-limit-probe.ts +0 -165
  171. package/templates/apps/api/src/lib/rate-limit-store.ts +0 -142
  172. package/templates/apps/api/src/lib/require-commerce-claim.ts +0 -250
  173. package/templates/apps/api/src/lib/require-paid-tier.ts +0 -53
  174. package/templates/apps/api/src/lib/site.ts +0 -254
  175. package/templates/apps/api/src/lib/slice-load.ts +0 -90
  176. package/templates/apps/api/src/lib/spoke-store.ts +0 -180
  177. package/templates/apps/api/src/lib/stripe.ts +0 -318
  178. package/templates/apps/api/src/lib/webhook-idempotency.ts +0 -156
  179. package/templates/apps/api/src/middleware/__tests__/adversarial/bearer-token-format.test.ts +0 -111
  180. package/templates/apps/api/src/middleware/__tests__/adversarial/cookie-or-bearer-precedence.test.ts +0 -172
  181. package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-bearer-skip.test.ts +0 -119
  182. package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-cookie-path.test.ts +0 -138
  183. package/templates/apps/api/src/middleware/__tests__/adversarial/csrf-trusted-origins.test.ts +0 -142
  184. package/templates/apps/api/src/middleware/__tests__/adversarial/session-fixation.test.ts +0 -155
  185. package/templates/apps/api/src/middleware/__tests__/adversarial/session-timeout.test.ts +0 -139
  186. package/templates/apps/api/src/middleware/__tests__/auth.bearer-path.test.ts +0 -562
  187. package/templates/apps/api/src/middleware/__tests__/auth.both-present-precedence.test.ts +0 -76
  188. package/templates/apps/api/src/middleware/__tests__/auth.cookie-path.test.ts +0 -220
  189. package/templates/apps/api/src/middleware/__tests__/auth.database-not-configured.test.ts +0 -97
  190. package/templates/apps/api/src/middleware/__tests__/auth.hub-session-path.test.ts +0 -557
  191. package/templates/apps/api/src/middleware/__tests__/auth.neither-present.test.ts +0 -72
  192. package/templates/apps/api/src/middleware/__tests__/auth.optional-cookie.test.ts +0 -140
  193. package/templates/apps/api/src/middleware/__tests__/default-tenant.test.ts +0 -721
  194. package/templates/apps/api/src/middleware/__tests__/rate-limit-cross-isolate.db.test.ts +0 -220
  195. package/templates/apps/api/src/middleware/__tests__/rate-limit-store.test.ts +0 -430
  196. package/templates/apps/api/src/middleware/__tests__/rate-limit.test.ts +0 -1409
  197. package/templates/apps/api/src/middleware/__tests__/write-budget.test.ts +0 -174
  198. package/templates/apps/api/src/middleware/auth.ts +0 -864
  199. package/templates/apps/api/src/middleware/default-tenant.ts +0 -166
  200. package/templates/apps/api/src/middleware/rate-limit.ts +0 -983
  201. package/templates/apps/api/src/openapi/__tests__/openapi.test.ts +0 -264
  202. package/templates/apps/api/src/openapi/__tests__/spec-identity.test.ts +0 -182
  203. package/templates/apps/api/src/openapi/index.ts +0 -18
  204. package/templates/apps/api/src/openapi/spec.ts +0 -1815
  205. package/templates/apps/api/src/openapi/surface-drift.ts +0 -195
  206. package/templates/apps/api/src/routes/aeo/__tests__/index.test.ts +0 -175
  207. package/templates/apps/api/src/routes/aeo/index.ts +0 -107
  208. package/templates/apps/api/src/routes/auth/__tests__/auth-tokens.functional.test.ts +0 -196
  209. package/templates/apps/api/src/routes/auth/__tests__/auth-user.functional.test.ts +0 -249
  210. package/templates/apps/api/src/routes/auth/__tests__/hub-sign-in.test.ts +0 -532
  211. package/templates/apps/api/src/routes/auth/__tests__/tokens.test.ts +0 -313
  212. package/templates/apps/api/src/routes/auth/__tests__/transactional-email.test.ts +0 -413
  213. package/templates/apps/api/src/routes/auth/__tests__/user.test.ts +0 -609
  214. package/templates/apps/api/src/routes/auth/hub-sign-in.ts +0 -242
  215. package/templates/apps/api/src/routes/auth/tokens.ts +0 -211
  216. package/templates/apps/api/src/routes/auth/transactional-email.ts +0 -301
  217. package/templates/apps/api/src/routes/auth/user.ts +0 -305
  218. package/templates/apps/api/src/routes/billing/plan-checkout.ts +0 -325
  219. package/templates/apps/api/src/routes/checkout/__tests__/live-key.test.ts +0 -178
  220. package/templates/apps/api/src/routes/checkout/__tests__/offerings-authorization.test.ts +0 -1300
  221. package/templates/apps/api/src/routes/checkout/__tests__/session.test.ts +0 -448
  222. package/templates/apps/api/src/routes/checkout/__tests__/sessions.test.ts +0 -1742
  223. package/templates/apps/api/src/routes/checkout/index.ts +0 -34
  224. package/templates/apps/api/src/routes/checkout/session.ts +0 -171
  225. package/templates/apps/api/src/routes/checkout/sessions.ts +0 -540
  226. package/templates/apps/api/src/routes/consent/__tests__/account.test.ts +0 -386
  227. package/templates/apps/api/src/routes/consent/__tests__/sign-up-rate-limit.test.ts +0 -160
  228. package/templates/apps/api/src/routes/consent/account.ts +0 -268
  229. package/templates/apps/api/src/routes/consent/cookie.ts +0 -90
  230. package/templates/apps/api/src/routes/consent/index.ts +0 -26
  231. package/templates/apps/api/src/routes/consent/unsubscribe.ts +0 -127
  232. package/templates/apps/api/src/routes/content/__tests__/get-page.test.ts +0 -853
  233. package/templates/apps/api/src/routes/content/__tests__/list-pages.test.ts +0 -230
  234. package/templates/apps/api/src/routes/content/__tests__/list-types.test.ts +0 -44
  235. package/templates/apps/api/src/routes/content/__tests__/locale.test.ts +0 -118
  236. package/templates/apps/api/src/routes/content/__tests__/offerings.test.ts +0 -731
  237. package/templates/apps/api/src/routes/content/__tests__/pricing.test.ts +0 -753
  238. package/templates/apps/api/src/routes/content/__tests__/rate-limit.test.ts +0 -51
  239. package/templates/apps/api/src/routes/content/__tests__/search.test.ts +0 -450
  240. package/templates/apps/api/src/routes/content/__tests__/shown-offerings.test.ts +0 -762
  241. package/templates/apps/api/src/routes/content/get-page.ts +0 -268
  242. package/templates/apps/api/src/routes/content/index.ts +0 -49
  243. package/templates/apps/api/src/routes/content/list-pages.ts +0 -95
  244. package/templates/apps/api/src/routes/content/list-types.ts +0 -19
  245. package/templates/apps/api/src/routes/content/offerings.ts +0 -184
  246. package/templates/apps/api/src/routes/content/pricing.ts +0 -176
  247. package/templates/apps/api/src/routes/content/rate-limit.ts +0 -22
  248. package/templates/apps/api/src/routes/content/search.ts +0 -129
  249. package/templates/apps/api/src/routes/content/shown-offerings.ts +0 -229
  250. package/templates/apps/api/src/routes/content/slug.ts +0 -9
  251. package/templates/apps/api/src/routes/leads/__tests__/capture.test.ts +0 -88
  252. package/templates/apps/api/src/routes/leads/__tests__/list.test.ts +0 -171
  253. package/templates/apps/api/src/routes/leads/__tests__/magnet-completion.test.ts +0 -515
  254. package/templates/apps/api/src/routes/leads/__tests__/spoke.test.ts +0 -392
  255. package/templates/apps/api/src/routes/leads/__tests__/track.test.ts +0 -165
  256. package/templates/apps/api/src/routes/leads/index.ts +0 -573
  257. package/templates/apps/api/src/routes/leads/list.ts +0 -104
  258. package/templates/apps/api/src/routes/project-listings/__tests__/configured-application.test.ts +0 -626
  259. package/templates/apps/api/src/routes/project-listings/__tests__/drafts.test.ts +0 -1268
  260. package/templates/apps/api/src/routes/project-listings/__tests__/founder-identity.test.ts +0 -847
  261. package/templates/apps/api/src/routes/project-listings/__tests__/me.test.ts +0 -480
  262. package/templates/apps/api/src/routes/project-listings/__tests__/public.test.ts +0 -465
  263. package/templates/apps/api/src/routes/project-listings/__tests__/resume-email.test.ts +0 -872
  264. package/templates/apps/api/src/routes/project-listings/__tests__/site-answers.test.ts +0 -1022
  265. package/templates/apps/api/src/routes/project-listings/__tests__/site-key.test.ts +0 -484
  266. package/templates/apps/api/src/routes/project-listings/__tests__/structured-address.test.ts +0 -535
  267. package/templates/apps/api/src/routes/project-listings/index.ts +0 -164
  268. package/templates/apps/api/src/routes/project-listings/me.ts +0 -87
  269. package/templates/apps/api/src/routes/project-listings/patch-copy.ts +0 -224
  270. package/templates/apps/api/src/routes/project-listings/patch-draft.ts +0 -102
  271. package/templates/apps/api/src/routes/project-listings/public.ts +0 -98
  272. package/templates/apps/api/src/routes/project-listings/respond.ts +0 -48
  273. package/templates/apps/api/src/routes/project-listings/resume-token.ts +0 -27
  274. package/templates/apps/api/src/routes/project-listings/start.ts +0 -140
  275. package/templates/apps/api/src/routes/project-listings/submit.ts +0 -130
  276. package/templates/apps/api/src/routes/project-listings/verify-email.ts +0 -150
  277. package/templates/apps/api/src/routes/requests/__tests__/confirm.test.ts +0 -686
  278. package/templates/apps/api/src/routes/requests/confirm.ts +0 -601
  279. package/templates/apps/api/src/routes/requests/index.ts +0 -54
  280. package/templates/apps/api/src/routes/test/auth/__tests__/session.test.ts +0 -306
  281. package/templates/apps/api/src/routes/test/auth/session.ts +0 -143
  282. package/templates/apps/api/src/routes/webhooks/README.md +0 -398
  283. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-checkout-consent.test.ts +0 -649
  284. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-dunning.test.ts +0 -749
  285. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-flow-checkout.test.ts +0 -448
  286. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-idempotency.test.ts +0 -264
  287. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-livemode-live.test.ts +0 -159
  288. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-livemode.test.ts +0 -158
  289. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-offerings.test.ts +0 -814
  290. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-org-billing.test.ts +0 -301
  291. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-proposal-paid.test.ts +0 -369
  292. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-rate-limit.test.ts +0 -215
  293. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-request-paid.test.ts +0 -301
  294. package/templates/apps/api/src/routes/webhooks/__tests__/stripe-site-filter.test.ts +0 -808
  295. package/templates/apps/api/src/routes/webhooks/__tests__/stripe.test.ts +0 -1155
  296. package/templates/apps/api/src/routes/webhooks/index.ts +0 -141
  297. package/templates/apps/api/src/routes/webhooks/stripe-offerings.ts +0 -384
  298. package/templates/apps/api/src/routes/webhooks/stripe.ts +0 -2026
  299. package/templates/apps/api/src/services/__tests__/abandon-email.test.ts +0 -528
  300. package/templates/apps/api/src/services/__tests__/answer-distributions.test.ts +0 -132
  301. package/templates/apps/api/src/services/__tests__/audit-log.test.ts +0 -1028
  302. package/templates/apps/api/src/services/__tests__/checkout-plan.test.ts +0 -313
  303. package/templates/apps/api/src/services/__tests__/consent-ledger.test.ts +0 -503
  304. package/templates/apps/api/src/services/__tests__/consent-migration.test.ts +0 -65
  305. package/templates/apps/api/src/services/__tests__/consent.test.ts +0 -299
  306. package/templates/apps/api/src/services/__tests__/default-tenant.test.ts +0 -147
  307. package/templates/apps/api/src/services/__tests__/deliverable-fulfillment.test.ts +0 -867
  308. package/templates/apps/api/src/services/__tests__/deliverable-resend.test.ts +0 -379
  309. package/templates/apps/api/src/services/__tests__/dunning-policy.test.ts +0 -368
  310. package/templates/apps/api/src/services/__tests__/entitlements.test.ts +0 -142
  311. package/templates/apps/api/src/services/__tests__/hub-sign-in.test.ts +0 -854
  312. package/templates/apps/api/src/services/__tests__/keyless-workspace-predicate.test.ts +0 -234
  313. package/templates/apps/api/src/services/__tests__/lead-accept-user.test.ts +0 -251
  314. package/templates/apps/api/src/services/__tests__/lead-routing.test.ts +0 -2660
  315. package/templates/apps/api/src/services/__tests__/listing-config.test.ts +0 -166
  316. package/templates/apps/api/src/services/__tests__/magnet-completion.test.ts +0 -389
  317. package/templates/apps/api/src/services/__tests__/person.test.ts +0 -1176
  318. package/templates/apps/api/src/services/__tests__/plan-offerings.test.ts +0 -444
  319. package/templates/apps/api/src/services/__tests__/project-listings.fence.test.ts +0 -154
  320. package/templates/apps/api/src/services/__tests__/public-site-resolver.test.ts +0 -137
  321. package/templates/apps/api/src/services/__tests__/request-confirm.test.ts +0 -531
  322. package/templates/apps/api/src/services/__tests__/revalidation.test.ts +0 -372
  323. package/templates/apps/api/src/services/__tests__/slack-notify.test.ts +0 -348
  324. package/templates/apps/api/src/services/__tests__/spoke-resolution.test.ts +0 -660
  325. package/templates/apps/api/src/services/__tests__/usage-aggregation.test.ts +0 -941
  326. package/templates/apps/api/src/services/__tests__/usage-credits.test.ts +0 -588
  327. package/templates/apps/api/src/services/__tests__/verified-email.test.ts +0 -78
  328. package/templates/apps/api/src/services/abandon-email.ts +0 -313
  329. package/templates/apps/api/src/services/aeo-score.ts +0 -325
  330. package/templates/apps/api/src/services/answer-distributions.ts +0 -138
  331. package/templates/apps/api/src/services/audit-log.ts +0 -961
  332. package/templates/apps/api/src/services/checkout-buyer.ts +0 -168
  333. package/templates/apps/api/src/services/consent.ts +0 -834
  334. package/templates/apps/api/src/services/default-tenant.ts +0 -416
  335. package/templates/apps/api/src/services/deliverable-fulfillment.ts +0 -755
  336. package/templates/apps/api/src/services/dunning-policy.ts +0 -294
  337. package/templates/apps/api/src/services/enrichment-shim.ts +0 -53
  338. package/templates/apps/api/src/services/entitlements.ts +0 -338
  339. package/templates/apps/api/src/services/hub-sign-in.ts +0 -472
  340. package/templates/apps/api/src/services/lead-accept-user.ts +0 -126
  341. package/templates/apps/api/src/services/lead-promotion.ts +0 -160
  342. package/templates/apps/api/src/services/lead-routing.ts +0 -1372
  343. package/templates/apps/api/src/services/leads-inbox.ts +0 -312
  344. package/templates/apps/api/src/services/listing-config.ts +0 -178
  345. package/templates/apps/api/src/services/magnet-completion.ts +0 -242
  346. package/templates/apps/api/src/services/offerings/__tests__/catalog.test.ts +0 -295
  347. package/templates/apps/api/src/services/offerings/__tests__/checkout-session-record.test.ts +0 -268
  348. package/templates/apps/api/src/services/offerings/__tests__/connection.test.ts +0 -868
  349. package/templates/apps/api/src/services/offerings/__tests__/fixtures.ts +0 -416
  350. package/templates/apps/api/src/services/offerings/__tests__/org-products.test.ts +0 -396
  351. package/templates/apps/api/src/services/offerings/__tests__/readers.test.ts +0 -681
  352. package/templates/apps/api/src/services/offerings/__tests__/source.test.ts +0 -231
  353. package/templates/apps/api/src/services/offerings/catalog.ts +0 -308
  354. package/templates/apps/api/src/services/offerings/checkout-authorization.ts +0 -385
  355. package/templates/apps/api/src/services/offerings/checkout-session-record.ts +0 -192
  356. package/templates/apps/api/src/services/offerings/connection.ts +0 -1003
  357. package/templates/apps/api/src/services/offerings/index.ts +0 -614
  358. package/templates/apps/api/src/services/offerings/source.ts +0 -140
  359. package/templates/apps/api/src/services/offerings/store.ts +0 -150
  360. package/templates/apps/api/src/services/owner-workspaces.ts +0 -132
  361. package/templates/apps/api/src/services/person.ts +0 -1188
  362. package/templates/apps/api/src/services/plan-offerings.ts +0 -125
  363. package/templates/apps/api/src/services/project-listing-resume-email.ts +0 -326
  364. package/templates/apps/api/src/services/project-listings.ts +0 -2073
  365. package/templates/apps/api/src/services/public-site-resolver.ts +0 -396
  366. package/templates/apps/api/src/services/request-confirm.ts +0 -698
  367. package/templates/apps/api/src/services/revalidation.ts +0 -235
  368. package/templates/apps/api/src/services/slack-notify.ts +0 -291
  369. package/templates/apps/api/src/services/usage-aggregation.ts +0 -516
  370. package/templates/apps/api/src/services/usage-credits.ts +0 -340
  371. package/templates/apps/api/src/services/verified-email.ts +0 -71
  372. package/templates/apps/mcp/__tests__/abuse/daily-cap.test.ts +0 -52
  373. package/templates/apps/mcp/__tests__/abuse/email-validator.test.ts +0 -46
  374. package/templates/apps/mcp/__tests__/abuse/guard.test.ts +0 -198
  375. package/templates/apps/mcp/__tests__/abuse/honeypot.test.ts +0 -36
  376. package/templates/apps/mcp/__tests__/abuse/user-agent-deny.test.ts +0 -54
  377. package/templates/apps/mcp/__tests__/aeo-cli-parity.test.ts +0 -116
  378. package/templates/apps/mcp/__tests__/audit-single-page.test.ts +0 -299
  379. package/templates/apps/mcp/__tests__/boot.test.ts +0 -280
  380. package/templates/apps/mcp/__tests__/catalog-drift.test.ts +0 -359
  381. package/templates/apps/mcp/__tests__/config/modules.test.ts +0 -78
  382. package/templates/apps/mcp/__tests__/get_business_hours.test.ts +0 -82
  383. package/templates/apps/mcp/__tests__/get_faq.test.ts +0 -80
  384. package/templates/apps/mcp/__tests__/get_locations.test.ts +0 -65
  385. package/templates/apps/mcp/__tests__/get_offerings.test.ts +0 -557
  386. package/templates/apps/mcp/__tests__/get_pricing.test.ts +0 -524
  387. package/templates/apps/mcp/__tests__/get_site_info.test.ts +0 -81
  388. package/templates/apps/mcp/__tests__/http-transport.test.ts +0 -1151
  389. package/templates/apps/mcp/__tests__/index.test.ts +0 -195
  390. package/templates/apps/mcp/__tests__/lib/audit-single-page-readiness-scan.test.ts +0 -191
  391. package/templates/apps/mcp/__tests__/lib/commerce-claim.test.ts +0 -531
  392. package/templates/apps/mcp/__tests__/lib/content-adapter-parity.test.ts +0 -65
  393. package/templates/apps/mcp/__tests__/lib/content-adapter.test.ts +0 -187
  394. package/templates/apps/mcp/__tests__/lib/content-root.test.ts +0 -93
  395. package/templates/apps/mcp/__tests__/lib/errors.test.ts +0 -75
  396. package/templates/apps/mcp/__tests__/lib/fail-closed-tools.test.ts +0 -165
  397. package/templates/apps/mcp/__tests__/lib/public-workspace.test.ts +0 -124
  398. package/templates/apps/mcp/__tests__/list_pages.test.ts +0 -228
  399. package/templates/apps/mcp/__tests__/locale.test.ts +0 -135
  400. package/templates/apps/mcp/__tests__/module-exclusion.test.ts +0 -175
  401. package/templates/apps/mcp/__tests__/purchase-disabled.test.ts +0 -101
  402. package/templates/apps/mcp/__tests__/read_content.test.ts +0 -474
  403. package/templates/apps/mcp/__tests__/request_callback.test.ts +0 -225
  404. package/templates/apps/mcp/__tests__/search_content.test.ts +0 -256
  405. package/templates/apps/mcp/__tests__/server.test.ts +0 -388
  406. package/templates/apps/mcp/__tests__/start_purchase.test.ts +0 -448
  407. package/templates/apps/mcp/__tests__/submit_lead.test.ts +0 -307
  408. package/templates/apps/mcp/__tests__/subscribe_newsletter.test.ts +0 -223
  409. package/templates/apps/mcp/__tests__/tools/create_project.test.ts +0 -243
  410. package/templates/apps/mcp/__tests__/tools/purchase.test.ts +0 -451
  411. package/templates/apps/mcp/src/abuse/daily-cap.ts +0 -47
  412. package/templates/apps/mcp/src/abuse/email-validator.ts +0 -25
  413. package/templates/apps/mcp/src/abuse/honeypot.ts +0 -21
  414. package/templates/apps/mcp/src/abuse/index.ts +0 -342
  415. package/templates/apps/mcp/src/abuse/user-agent-deny.ts +0 -58
  416. package/templates/apps/mcp/src/boot.ts +0 -167
  417. package/templates/apps/mcp/src/config/modules.ts +0 -43
  418. package/templates/apps/mcp/src/http-transport.ts +0 -526
  419. package/templates/apps/mcp/src/lib/audit-single-page.ts +0 -308
  420. package/templates/apps/mcp/src/lib/commerce-claim.ts +0 -263
  421. package/templates/apps/mcp/src/lib/content-adapter.ts +0 -142
  422. package/templates/apps/mcp/src/lib/empty-content-adapter.ts +0 -139
  423. package/templates/apps/mcp/src/lib/errors.ts +0 -61
  424. package/templates/apps/mcp/src/lib/license-key-store.ts +0 -45
  425. package/templates/apps/mcp/src/lib/locales.ts +0 -171
  426. package/templates/apps/mcp/src/lib/prisma.ts +0 -39
  427. package/templates/apps/mcp/src/lib/public-workspace.ts +0 -133
  428. package/templates/apps/mcp/src/lib/resolve-locale.ts +0 -30
  429. package/templates/apps/mcp/src/lib/shown-offerings.ts +0 -105
  430. package/templates/apps/mcp/src/lib/stripe-tax-signal.ts +0 -59
  431. package/templates/apps/mcp/src/request-context.ts +0 -52
  432. package/templates/apps/mcp/src/server.ts +0 -343
  433. package/templates/apps/mcp/src/serverless-app.ts +0 -88
  434. package/templates/apps/mcp/src/tools/audit.ts +0 -127
  435. package/templates/apps/mcp/src/tools/capture_lead.ts +0 -64
  436. package/templates/apps/mcp/src/tools/create_project.ts +0 -134
  437. package/templates/apps/mcp/src/tools/get_business_hours.ts +0 -68
  438. package/templates/apps/mcp/src/tools/get_faq.ts +0 -71
  439. package/templates/apps/mcp/src/tools/get_locations.ts +0 -88
  440. package/templates/apps/mcp/src/tools/get_offerings.ts +0 -96
  441. package/templates/apps/mcp/src/tools/get_pricing.ts +0 -94
  442. package/templates/apps/mcp/src/tools/get_site_info.ts +0 -86
  443. package/templates/apps/mcp/src/tools/index.ts +0 -137
  444. package/templates/apps/mcp/src/tools/list_pages.ts +0 -74
  445. package/templates/apps/mcp/src/tools/person_notes.ts +0 -25
  446. package/templates/apps/mcp/src/tools/proposals.ts +0 -27
  447. package/templates/apps/mcp/src/tools/purchase.ts +0 -205
  448. package/templates/apps/mcp/src/tools/read_content.ts +0 -75
  449. package/templates/apps/mcp/src/tools/request_callback.ts +0 -59
  450. package/templates/apps/mcp/src/tools/search_content.ts +0 -67
  451. package/templates/apps/mcp/src/tools/subscribe_newsletter.ts +0 -57
  452. package/templates/apps/mcp/src/workspace-server.ts +0 -224
  453. package/templates/database/CHANGELOG.md +0 -961
  454. package/templates/database/LICENSE +0 -202
  455. package/templates/database/NOTICE +0 -2
  456. package/templates/database/README.md +0 -243
  457. package/templates/database/__tests__/agents.db.test.ts +0 -320
  458. package/templates/database/__tests__/appointment.db.test.ts +0 -106
  459. package/templates/database/__tests__/artifact-content-store.db.test.ts +0 -316
  460. package/templates/database/__tests__/composite-fence.db.test.ts +0 -206
  461. package/templates/database/__tests__/consent-ledger.db.test.ts +0 -345
  462. package/templates/database/__tests__/consent-source-checkout-migration.test.ts +0 -79
  463. package/templates/database/__tests__/fence-fan-out.db.test.ts +0 -715
  464. package/templates/database/__tests__/fixtures/appointment-create-probe.ts +0 -79
  465. package/templates/database/__tests__/fixtures/person-backfill.json +0 -264
  466. package/templates/database/__tests__/fixtures/person-contact-backfill.json +0 -182
  467. package/templates/database/__tests__/fixtures/project-listing-consent-probe.ts +0 -100
  468. package/templates/database/__tests__/flow-completion-migration.test.ts +0 -115
  469. package/templates/database/__tests__/flow-completion.db.test.ts +0 -136
  470. package/templates/database/__tests__/flow-workspace-key.db.test.ts +0 -263
  471. package/templates/database/__tests__/flows-listing-diagnostic.test.ts +0 -392
  472. package/templates/database/__tests__/flows-presets.test.ts +0 -173
  473. package/templates/database/__tests__/in-page-magnets-migration.test.ts +0 -161
  474. package/templates/database/__tests__/lead-idempotency-key.db.test.ts +0 -92
  475. package/templates/database/__tests__/member-area.db.test.ts +0 -257
  476. package/templates/database/__tests__/member-contract-migration.test.ts +0 -85
  477. package/templates/database/__tests__/member-contract.db.test.ts +0 -413
  478. package/templates/database/__tests__/offerings-checkout-session.db.test.ts +0 -270
  479. package/templates/database/__tests__/offerings-migration.test.ts +0 -197
  480. package/templates/database/__tests__/offerings-shown-price-ids-migration.test.ts +0 -86
  481. package/templates/database/__tests__/offerings.db.test.ts +0 -303
  482. package/templates/database/__tests__/outbound-message-action.db.test.ts +0 -80
  483. package/templates/database/__tests__/person-contact.db.test.ts +0 -563
  484. package/templates/database/__tests__/person-notes.db.test.ts +0 -249
  485. package/templates/database/__tests__/person.db.test.ts +0 -586
  486. package/templates/database/__tests__/piece-kind-migration.test.ts +0 -67
  487. package/templates/database/__tests__/piece-kind.db.test.ts +0 -208
  488. package/templates/database/__tests__/prefixed-ids.db.test.ts +0 -222
  489. package/templates/database/__tests__/project-listing-consent-at.db.test.ts +0 -111
  490. package/templates/database/__tests__/seed.test.ts +0 -240
  491. package/templates/database/__tests__/spoke-registry.db.test.ts +0 -191
  492. package/templates/database/__tests__/tenancy.test.ts +0 -141
  493. package/templates/database/__tests__/user-cascade.test.ts +0 -140
  494. package/templates/database/_gitignore +0 -8
  495. package/templates/database/auth/.gitkeep +0 -0
  496. package/templates/database/auth/schema.prisma +0 -641
  497. package/templates/database/config/.gitkeep +0 -0
  498. package/templates/database/config/schema.prisma +0 -441
  499. package/templates/database/content/.gitkeep +0 -0
  500. package/templates/database/content/schema.prisma +0 -339
  501. package/templates/database/eslint.config.mjs +0 -69
  502. package/templates/database/flows/listing-diagnostic.ts +0 -182
  503. package/templates/database/flows/presets.ts +0 -315
  504. package/templates/database/inbox/.gitkeep +0 -0
  505. package/templates/database/inbox/README.md +0 -3
  506. package/templates/database/inbox/__tests__/schema.test.ts +0 -44
  507. package/templates/database/inbox/schema.prisma +0 -1447
  508. package/templates/database/jest.config.cjs +0 -36
  509. package/templates/database/migrations/20260508000000_add_inbox_namespace/migration.sql +0 -328
  510. package/templates/database/migrations/20260513000000_better_auth_migration/migration.sql +0 -100
  511. package/templates/database/migrations/20260515000000_add_user_billing_fields/migration.sql +0 -28
  512. package/templates/database/migrations/20260516000000_add_user_tier_care_plan_seat/migration.sql +0 -25
  513. package/templates/database/migrations/20260518000000_add_telemetry_records/migration.sql +0 -42
  514. package/templates/database/migrations/20260525000000_theme_wiring/migration.sql +0 -67
  515. package/templates/database/migrations/20260710000000_retire_commercial_tier/migration.sql +0 -21
  516. package/templates/database/migrations/20260712215647_add_multi_tenant_tenancy/migration.sql +0 -201
  517. package/templates/database/migrations/20260713143320_reanchor_site_config_to_workspace/migration.sql +0 -67
  518. package/templates/database/migrations/20260713174000_add_audit_logs/migration.sql +0 -46
  519. package/templates/database/migrations/20260713190000_drop_telemetry_records/migration.sql +0 -25
  520. package/templates/database/migrations/20260713192000_add_uuidv7_function/migration.sql +0 -49
  521. package/templates/database/migrations/20260713192429_prefixed_uuid_entity_ids/migration.sql +0 -197
  522. package/templates/database/migrations/20260713200000_add_org_billing/migration.sql +0 -32
  523. package/templates/database/migrations/20260714000000_add_lead_promotion_fields/migration.sql +0 -22
  524. package/templates/database/migrations/20260714010000_add_usage_billing_content_models/migration.sql +0 -151
  525. package/templates/database/migrations/20260714020000_add_usage_billing_auth_config_models/migration.sql +0 -223
  526. package/templates/database/migrations/20260714030000_credit_balance_non_negative/migration.sql +0 -22
  527. package/templates/database/migrations/20260714030000_widen_usage_billing_report_aggregates/migration.sql +0 -32
  528. package/templates/database/migrations/20260810233516_add_flow_engine_models/migration.sql +0 -40
  529. package/templates/database/migrations/20260811020000_add_flow_session_abandon_email_columns/migration.sql +0 -4
  530. package/templates/database/migrations/20260811030000_add_flow_session_abandon_email_index/migration.sql +0 -2
  531. package/templates/database/migrations/20260811040000_add_flow_session_segment/migration.sql +0 -2
  532. package/templates/database/migrations/20260811050000_add_deliverable_models/migration.sql +0 -29
  533. package/templates/database/migrations/20260812000000_add_deliverable_grant_send_columns/migration.sql +0 -6
  534. package/templates/database/migrations/20260902222948_add_waitlist_experiment_models/migration.sql +0 -39
  535. package/templates/database/migrations/20260902224500_add_waitlist_id_format_checks/migration.sql +0 -24
  536. package/templates/database/migrations/20260903004112_add_flow_session_flags_aeo_score/migration.sql +0 -3
  537. package/templates/database/migrations/20260903010000_add_playbook_instance/migration.sql +0 -33
  538. package/templates/database/migrations/20260904000000_add_waitlist_followup_send/migration.sql +0 -30
  539. package/templates/database/migrations/20260905230000_add_flow_checkout/migration.sql +0 -47
  540. package/templates/database/migrations/20260906000000_add_flow_checkout_idempotency/migration.sql +0 -16
  541. package/templates/database/migrations/20260907120000_add_project_listing/migration.sql +0 -47
  542. package/templates/database/migrations/20260907130000_add_project_listing_slack_columns/migration.sql +0 -10
  543. package/templates/database/migrations/20260907180000_add_listing_csv_send/migration.sql +0 -26
  544. package/templates/database/migrations/20260909120000_project_listings_platform/migration.sql +0 -90
  545. package/templates/database/migrations/20260909180000_listing_draft_and_fields/migration.sql +0 -174
  546. package/templates/database/migrations/20260910120000_listing_public_site_key/migration.sql +0 -14
  547. package/templates/database/migrations/20260911120000_listing_copy_edit_audit/migration.sql +0 -25
  548. package/templates/database/migrations/20260911140000_listing_structured_address/migration.sql +0 -32
  549. package/templates/database/migrations/20260911180000_consent_grants/migration.sql +0 -71
  550. package/templates/database/migrations/20260911200000_listing_site_answers/migration.sql +0 -30
  551. package/templates/database/migrations/20260912120000_listing_owner_link/migration.sql +0 -49
  552. package/templates/database/migrations/20260914120000_listing_founder_identity/migration.sql +0 -123
  553. package/templates/database/migrations/20260915120000_project_listing_solution/migration.sql +0 -15
  554. package/templates/database/migrations/20260916120000_artifact_content_store/migration.sql +0 -158
  555. package/templates/database/migrations/20260917120000_callback_request_confirm/migration.sql +0 -40
  556. package/templates/database/migrations/20260918120000_add_appointment/migration.sql +0 -67
  557. package/templates/database/migrations/20260918120000_asset_metadata_columns/migration.sql +0 -70
  558. package/templates/database/migrations/20260919120000_flow_workspace_key/migration.sql +0 -181
  559. package/templates/database/migrations/20260919130000_flow_definition_admin_columns/migration.sql +0 -172
  560. package/templates/database/migrations/20260919130000_workspace_meetings/migration.sql +0 -41
  561. package/templates/database/migrations/20260919140000_inbox_workspace_key/migration.sql +0 -185
  562. package/templates/database/migrations/20260920120000_lead_handled_at/migration.sql +0 -70
  563. package/templates/database/migrations/20260920130000_lead_workspace_source_index/migration.sql +0 -57
  564. package/templates/database/migrations/20260921120000_deliverable_grant_workspace_key/migration.sql +0 -68
  565. package/templates/database/migrations/20260922120000_tenancy_fence/migration.sql +0 -1067
  566. package/templates/database/migrations/20260923120000_listing_capturing_magnet/migration.sql +0 -210
  567. package/templates/database/migrations/20261003120000_spoke_registry/migration.sql +0 -80
  568. package/templates/database/migrations/20261003130000_scheduling_connection/migration.sql +0 -49
  569. package/templates/database/migrations/20261005120000_agents/migration.sql +0 -84
  570. package/templates/database/migrations/20261008120000_user_last_workspace/migration.sql +0 -35
  571. package/templates/database/migrations/20261008130000_lead_idempotency_key/migration.sql +0 -20
  572. package/templates/database/migrations/20261009120000_agent_grants/migration.sql +0 -33
  573. package/templates/database/migrations/20261010120000_person/migration.sql +0 -106
  574. package/templates/database/migrations/20261010121000_person_backfill/migration.sql +0 -132
  575. package/templates/database/migrations/20261010130000_agent_grants_people_read/migration.sql +0 -20
  576. package/templates/database/migrations/20261011120000_member_area/migration.sql +0 -158
  577. package/templates/database/migrations/20261011130000_agent_grants_member_pieces_manage/migration.sql +0 -21
  578. package/templates/database/migrations/20261012120000_member_contract/migration.sql +0 -192
  579. package/templates/database/migrations/20261013120000_lead_spoke_checkout/migration.sql +0 -20
  580. package/templates/database/migrations/20261014120000_consent_ledger/migration.sql +0 -122
  581. package/templates/database/migrations/20261014120000_person_contact/migration.sql +0 -231
  582. package/templates/database/migrations/20261015120000_person_notes/migration.sql +0 -77
  583. package/templates/database/migrations/20261015120000_rate_limit_counters/migration.sql +0 -43
  584. package/templates/database/migrations/20261016120000_piece_kind/migration.sql +0 -95
  585. package/templates/database/migrations/20261017120000_outbound_message_action/migration.sql +0 -30
  586. package/templates/database/migrations/20261018120000_flow_completion/migration.sql +0 -52
  587. package/templates/database/migrations/20261019120000_consent_source_checkout/migration.sql +0 -27
  588. package/templates/database/migrations/20261020120000_offerings_data_model/migration.sql +0 -146
  589. package/templates/database/migrations/20261021120000_offerings_checkout_session/migration.sql +0 -77
  590. package/templates/database/migrations/20261022120000_in_page_magnets/migration.sql +0 -45
  591. package/templates/database/migrations/20261023120000_offerings_shown_price_ids/migration.sql +0 -47
  592. package/templates/database/migrations/20261024120000_organization_plan_checkout_session/migration.sql +0 -16
  593. package/templates/database/migrations/migration_lock.toml +0 -3
  594. package/templates/database/ops/.gitkeep +0 -0
  595. package/templates/database/ops/schema.prisma +0 -43
  596. package/templates/database/package.json +0 -89
  597. package/templates/database/schema.prisma +0 -71
  598. package/templates/database/scripts/db-generate-locked.sh +0 -80
  599. package/templates/database/scripts/person-backfill.sql +0 -132
  600. package/templates/database/tenancy.ts +0 -183
  601. package/templates/database/tsconfig.build.json +0 -16
  602. package/templates/database/tsconfig.flows.json +0 -15
  603. package/templates/database/tsconfig.json +0 -16
  604. package/templates/database/tsconfig.tenancy.json +0 -14
@@ -1,161 +0,0 @@
1
- /**
2
- * Per-recipient hourly send budget for the auth transactional-email relay
3
- * (#5962 § D8c).
4
- *
5
- * WHY IT IS PER RECIPIENT AND NOT PER SITE. The first draft of #5962's spec
6
- * carried a second, site-wide cap. It was removed, and its removal is the
7
- * point of this module's shape: Better Auth writes the `Verification` row
8
- * BEFORE it invokes `sendResetPassword`, so every attacker request both feeds
9
- * a site-wide counter and refreshes its window — roughly one request per 72
10
- * seconds would hold a site permanently at its cap and silence reset mail for
11
- * EVERY user, indefinitely. A site-wide cap an attacker can hold open is a
12
- * denial of the control it implements. `siteVolumeAlert()` below replaces it
13
- * with an operator SIGNAL that never refuses a send.
14
- *
15
- * The per-recipient budget IS a lockout weapon, narrowly: an attacker who
16
- * requests three resets for one address in an hour denies that person a reset
17
- * for the rest of it. Accepted for the reason
18
- * `services/project-listing-resume-email.ts` gives and this module can
19
- * honestly claim — the window is an hour rather than forever, it clears
20
- * itself, and it is bounded to ONE victim rather than to the whole site.
21
- *
22
- * SINGLE-REPLICA CAVEAT, stated rather than hidden: the store is an in-process
23
- * Map, so on an N-instance deployment the effective ceiling is N × the cap.
24
- * Identical to the caveat `middleware/rate-limit.ts` documents for itself. The
25
- * durable alternative needs a table `database/auth/schema.prisma` does not
26
- * have, and #5962 adds no migration (Q16).
27
- *
28
- * PII: the key is `sha256(lowercased recipient + ":" + kind)`. This module is
29
- * memory an operator can dump, and a plaintext address in it would be a
30
- * recipient list.
31
- */
32
-
33
- import { createHash } from "node:crypto";
34
-
35
- import { getClock } from "@working-theory/common";
36
-
37
- /** The four fixed message kinds the relay will send. */
38
- export type AuthEmailKind =
39
- | "password-reset"
40
- | "email-verification"
41
- | "password-changed"
42
- | "magic-link";
43
-
44
- /** Sends allowed per (recipient, kind) per hour. */
45
- export const RECIPIENT_HOURLY_MAX = 3;
46
-
47
- /**
48
- * Sends per hour, site-wide, past which ONE operator warning is logged. Never
49
- * a refusal — see the module comment.
50
- */
51
- export const SITE_HOURLY_ALERT_THRESHOLD = 50;
52
-
53
- const WINDOW_MS = 60 * 60 * 1000;
54
-
55
- /**
56
- * Cap on distinct entries, independent of the time-based window. The key is
57
- * derived from a caller-supplied address, so a caller minting a fresh address
58
- * per request would otherwise grow the map without bound for the lifetime of
59
- * one isolate. Same reasoning, same shape, as `rate-limit.ts`'s MAX_BUCKETS.
60
- */
61
- export const MAX_BUCKETS = 10_000;
62
-
63
- type Bucket = { count: number; windowStartMs: number };
64
-
65
- const buckets = new Map<string, Bucket>();
66
-
67
- let siteWindowStartMs = 0;
68
- let siteCount = 0;
69
- let siteAlertedThisWindow = false;
70
-
71
- export interface BudgetOptions {
72
- /** Explicit clock reading. Defaults to `getClock().now()`. Tests inject it. */
73
- nowMs?: number;
74
- /** Entry cap. Exposed for tests only — no production caller overrides it. */
75
- maxBuckets?: number;
76
- }
77
-
78
- function bucketKey(recipient: string, kind: AuthEmailKind): string {
79
- const normalized = recipient.trim().toLowerCase();
80
- return createHash("sha256").update(`${normalized}:${kind}`).digest("hex");
81
- }
82
-
83
- /**
84
- * Counts one send against `(recipient, kind)` and reports whether it may
85
- * proceed.
86
- *
87
- * `false` means SUPPRESS THE SEND — it never means "tell the caller". The
88
- * relay answers 202 either way, because an observable suppression is the same
89
- * account-enumeration oracle the rest of this flow is built to close.
90
- */
91
- export function consumeRecipientBudget(
92
- recipient: string,
93
- kind: AuthEmailKind,
94
- options: BudgetOptions = {},
95
- ): boolean {
96
- const now = options.nowMs ?? getClock().now();
97
- const maxBuckets = options.maxBuckets ?? MAX_BUCKETS;
98
- const key = bucketKey(recipient, kind);
99
-
100
- let bucket = buckets.get(key);
101
-
102
- if (!bucket || now - bucket.windowStartMs >= WINDOW_MS) {
103
- // A genuinely new identity at capacity evicts the single oldest-inserted
104
- // entry (`Map` iteration order is insertion order) before inserting
105
- // itself — O(1) amortized, and no behaviour change under the cap.
106
- if (!buckets.has(key) && buckets.size >= maxBuckets) {
107
- const oldestKey = buckets.keys().next().value;
108
- if (oldestKey !== undefined) buckets.delete(oldestKey);
109
- }
110
- bucket = { count: 0, windowStartMs: now };
111
- buckets.set(key, bucket);
112
- }
113
-
114
- if (bucket.count >= RECIPIENT_HOURLY_MAX) return false;
115
-
116
- bucket.count += 1;
117
- return true;
118
- }
119
-
120
- /**
121
- * Counts one send site-wide and reports whether THIS call is the one that
122
- * should emit the hourly operator warning.
123
- *
124
- * It is a signal, not a gate: nothing in this module consults its return value
125
- * to deny a send, and nothing may be added that does.
126
- */
127
- export function siteVolumeAlert(options: BudgetOptions = {}): boolean {
128
- const now = options.nowMs ?? getClock().now();
129
-
130
- if (now - siteWindowStartMs >= WINDOW_MS) {
131
- siteWindowStartMs = now;
132
- siteCount = 0;
133
- siteAlertedThisWindow = false;
134
- }
135
-
136
- siteCount += 1;
137
-
138
- if (siteCount >= SITE_HOURLY_ALERT_THRESHOLD && !siteAlertedThisWindow) {
139
- siteAlertedThisWindow = true;
140
- return true;
141
- }
142
- return false;
143
- }
144
-
145
- /** Test-only reset. Not intended for production use. */
146
- export function __resetAuthEmailBudget(): void {
147
- buckets.clear();
148
- siteWindowStartMs = 0;
149
- siteCount = 0;
150
- siteAlertedThisWindow = false;
151
- }
152
-
153
- /** Test-only accessor for the distinct-bucket count. */
154
- export function __authEmailBucketCount(): number {
155
- return buckets.size;
156
- }
157
-
158
- /** Test-only accessor proving the stored keys carry no plaintext address. */
159
- export function __authEmailBudgetKeys(): string[] {
160
- return [...buckets.keys()];
161
- }
@@ -1,363 +0,0 @@
1
- /**
2
- * The consent ledger's read boundary (#8438, spec
3
- * docs/specs/8438-consent-registry-and-ledger-step-spec.md D4).
4
- *
5
- * `consent_grants` is append-only and a Person's current state is the newest
6
- * row per purpose, so every reader here asks the database for exactly that.
7
- * Nothing is read through a window: `DISTINCT ON (purpose_id) … ORDER BY
8
- * purpose_id, created_at DESC, id DESC` is one indexed pass over ALL the
9
- * matching rows, so no number of other rows can push an answer out
10
- * (SEC-8438-2).
11
- *
12
- * TWO READINGS of a Person's rows (SEC-8438-1). A Person is keyed on an email
13
- * anyone can type into a form, so a row an anonymous writer attached to it
14
- * proves nothing about what the person themself chose:
15
- *
16
- * - OWN rows: `person_id = P` and a source only a verified caller or a
17
- * signed link sent to the person can write — `sign_up`,
18
- * `account_settings`, `email_unsubscribe` (`OWN_CONSENT_SOURCES`). The
19
- * member's screens, the sign-up prompt, and every future send read only
20
- * these.
21
- * - ANY-SOURCE rows: every row with `person_id = P`, plus the cookie rows
22
- * of every visitor linked to P. The operator's Person page reads these,
23
- * marked `unverified` when the source proves nothing.
24
- *
25
- * Every query takes an explicit `workspaceId`, and a join to a linked
26
- * visitor's rows matches `workspace_id` on both tables (SEC-8438-11) — a
27
- * visitor id is client-chosen and not namespaced, so another tenant's rows
28
- * under the same id must never join.
29
- *
30
- * This file is the ONLY non-test reader of `consent_grants` and
31
- * `consent_visitor_links` (`architecture.yaml` names it as a data-access
32
- * boundary, the kind `member-store.ts` is). The writes are
33
- * `services/consent.ts`. Logs carry nothing: no email, visitor id, token or
34
- * statement.
35
- */
36
- import type { Prisma } from "@working-theory/database";
37
- import {
38
- consentPurposeKind,
39
- type ConsentPurposeKind,
40
- type ConsentSource,
41
- type SiteConsentConfig,
42
- } from "@working-theory/validation";
43
-
44
- import { prisma } from "./prisma.js";
45
-
46
- /** What every reader needs of a client: raw reads only. */
47
- export type ConsentReadClient = Pick<Prisma.TransactionClient, "$queryRaw">;
48
-
49
- /**
50
- * The sources only a verified caller or a signed link can write (D4,
51
- * SEC-8438-1). The SQL below names the same three literals; the store's test
52
- * asserts the two agree.
53
- */
54
- export const OWN_CONSENT_SOURCES = [
55
- "sign_up",
56
- "account_settings",
57
- "email_unsubscribe",
58
- ] as const satisfies readonly ConsentSource[];
59
-
60
- /** The sources whose rows prove nothing the client confirmed themself. */
61
- const UNVERIFIED_SOURCES: ReadonlySet<ConsentSource> = new Set([
62
- "magnet",
63
- "api",
64
- "cookie_banner",
65
- "legacy",
66
- // #8765 D13, C10: the payer at a Stripe Checkout is not a signed-in user.
67
- "checkout",
68
- ]);
69
-
70
- /** Whether a row from `source` is unconfirmed by the client (D4). */
71
- export function isUnverifiedSource(source: ConsentSource): boolean {
72
- return UNVERIFIED_SOURCES.has(source);
73
- }
74
-
75
- /** A history page's size (D7). */
76
- export const CONSENT_HISTORY_PAGE_SIZE = 500;
77
-
78
- /** The most platform rows one user can have in view (D4). */
79
- const PLATFORM_ROWS_MAX = 100;
80
-
81
- /** The newest ledger row for one purpose, as the readers serve it. */
82
- export interface ConsentStateRow {
83
- id: string;
84
- purposeId: string;
85
- granted: boolean;
86
- at: Date;
87
- source: ConsentSource;
88
- sourceRef: string | null;
89
- policyVersion: number | null;
90
- }
91
-
92
- export interface ConsentHistoryRow extends ConsentStateRow {
93
- locale: string;
94
- statement: string;
95
- subjectType: string;
96
- }
97
-
98
- /** A registry purpose with the newest row read for it and what that means now. */
99
- export interface PurposeConsentState {
100
- purposeId: string;
101
- kind: ConsentPurposeKind;
102
- row: ConsentStateRow | null;
103
- /** Granted now: the row's answer, else on for a preference and off otherwise. */
104
- effective: boolean;
105
- }
106
-
107
- /** The effective answer for a purpose given its newest row (D4). */
108
- export function effectiveConsent(
109
- kind: ConsentPurposeKind,
110
- row: { granted: boolean } | null,
111
- ): boolean {
112
- if (row !== null) return row.granted;
113
- return kind === "preference";
114
- }
115
-
116
- /** Fold the newest row per purpose id into the registry's purposes. */
117
- export function foldRowsIntoPurposes(
118
- config: SiteConsentConfig,
119
- rows: readonly ConsentStateRow[],
120
- ): PurposeConsentState[] {
121
- const byPurpose = new Map(rows.map((row) => [row.purposeId, row]));
122
- return config.purposes.map((purpose) => {
123
- const kind = consentPurposeKind(purpose);
124
- const row = byPurpose.get(purpose.id) ?? null;
125
- return {
126
- purposeId: purpose.id,
127
- kind,
128
- row,
129
- effective: effectiveConsent(kind, row),
130
- };
131
- });
132
- }
133
-
134
- /**
135
- * The newest OWN row per purpose id for a Person, unfolded (D4): one indexed
136
- * `DISTINCT ON` pass over all own rows, never a window.
137
- */
138
- export async function ownConsentRows(
139
- workspaceId: string,
140
- personId: string,
141
- db: ConsentReadClient = prisma,
142
- ): Promise<ConsentStateRow[]> {
143
- return db.$queryRaw<ConsentStateRow[]>`
144
- SELECT DISTINCT ON (g."purpose_id")
145
- g."id", g."purpose_id" AS "purposeId", g."granted", g."created_at" AS "at",
146
- g."source", g."source_ref" AS "sourceRef", g."policy_version" AS "policyVersion"
147
- FROM "consent_grants" g
148
- WHERE g."workspace_id" = ${workspaceId}
149
- AND g."person_id" = ${personId}
150
- AND g."source" IN ('sign_up', 'account_settings', 'email_unsubscribe')
151
- ORDER BY g."purpose_id", g."created_at" DESC, g."id" DESC`;
152
- }
153
-
154
- /**
155
- * The newest ANY-SOURCE row per purpose id for a Person: `person_id = P` or a
156
- * cookie row of a visitor linked to P, in this workspace on both tables.
157
- * Includes purposes the registry no longer declares — the operator still sees
158
- * what was recorded.
159
- */
160
- export async function anySourceConsentRows(
161
- workspaceId: string,
162
- personId: string,
163
- db: ConsentReadClient = prisma,
164
- ): Promise<ConsentStateRow[]> {
165
- return db.$queryRaw<ConsentStateRow[]>`
166
- SELECT DISTINCT ON (g."purpose_id")
167
- g."id", g."purpose_id" AS "purposeId", g."granted", g."created_at" AS "at",
168
- g."source", g."source_ref" AS "sourceRef", g."policy_version" AS "policyVersion"
169
- FROM "consent_grants" g
170
- WHERE g."workspace_id" = ${workspaceId}
171
- AND (
172
- g."person_id" = ${personId}
173
- OR (g."subject_type" = 'visitor' AND g."subject_id" IN (
174
- SELECT l."visitor_id" FROM "consent_visitor_links" l
175
- WHERE l."workspace_id" = ${workspaceId} AND l."person_id" = ${personId}
176
- ))
177
- )
178
- ORDER BY g."purpose_id", g."created_at" DESC, g."id" DESC`;
179
- }
180
-
181
- /**
182
- * Whether this Person already holds the `checkout` row of one Checkout
183
- * Session for one purpose (#8765 D14, NFR7) — the webhook's replay check.
184
- * Filters on `(workspace_id, person_id, purpose_id)` first, so the existing
185
- * `(workspace_id, person_id, purpose_id, created_at)` index serves it
186
- * (SEC-8765-N).
187
- */
188
- export async function personHasCheckoutGrant(
189
- workspaceId: string,
190
- personId: string,
191
- purposeId: string,
192
- sessionId: string,
193
- db: ConsentReadClient = prisma,
194
- ): Promise<boolean> {
195
- const rows = await db.$queryRaw<Array<{ found: number }>>`
196
- SELECT 1 AS "found"
197
- FROM "consent_grants" g
198
- WHERE g."workspace_id" = ${workspaceId}
199
- AND g."person_id" = ${personId}
200
- AND g."purpose_id" = ${purposeId}
201
- AND g."source" = 'checkout'
202
- AND g."source_ref" = ${sessionId}
203
- LIMIT 1`;
204
- return rows.length > 0;
205
- }
206
-
207
- /**
208
- * A Person's OWN reading, per registry purpose (D4). The member's screens and
209
- * the sign-up prompt read only this.
210
- */
211
- export async function ownConsentState(
212
- workspaceId: string,
213
- personId: string,
214
- config: SiteConsentConfig,
215
- db: ConsentReadClient = prisma,
216
- ): Promise<PurposeConsentState[]> {
217
- return foldRowsIntoPurposes(
218
- config,
219
- await ownConsentRows(workspaceId, personId, db),
220
- );
221
- }
222
-
223
- /**
224
- * A Person's ANY-SOURCE reading, per registry purpose. The operator's Person
225
- * page and the unsubscribe dedupe read it; a row here is never a member's own
226
- * answer (D4).
227
- */
228
- export async function anySourceConsentState(
229
- workspaceId: string,
230
- personId: string,
231
- config: SiteConsentConfig,
232
- db: ConsentReadClient = prisma,
233
- ): Promise<PurposeConsentState[]> {
234
- return foldRowsIntoPurposes(
235
- config,
236
- await anySourceConsentRows(workspaceId, personId, db),
237
- );
238
- }
239
-
240
- /** One page of a Person's any-source history, newest first. */
241
- export interface ConsentHistoryPage {
242
- rows: ConsentHistoryRow[];
243
- /** The id of the page's last row when another page follows, else `null`. */
244
- nextCursor: string | null;
245
- }
246
-
247
- /**
248
- * A Person's any-source history, 500 rows a page, newest first, keyed by
249
- * `(created_at, id)`. Every page is complete: nothing is truncated (D7).
250
- * Returns `"invalid_cursor"` for a cursor that is not one of this Person's
251
- * rows — checked inside the Person's own scope, so a row id of another
252
- * Person or workspace reads exactly like an unknown one.
253
- */
254
- export async function personConsentHistory(
255
- workspaceId: string,
256
- personId: string,
257
- cursor: string | undefined,
258
- db: ConsentReadClient = prisma,
259
- ): Promise<ConsentHistoryPage | "invalid_cursor"> {
260
- if (cursor !== undefined) {
261
- const found = await db.$queryRaw<Array<{ id: string }>>`
262
- SELECT g."id" FROM "consent_grants" g
263
- WHERE g."workspace_id" = ${workspaceId}
264
- AND g."id" = ${cursor}
265
- AND (
266
- g."person_id" = ${personId}
267
- OR (g."subject_type" = 'visitor' AND g."subject_id" IN (
268
- SELECT l."visitor_id" FROM "consent_visitor_links" l
269
- WHERE l."workspace_id" = ${workspaceId} AND l."person_id" = ${personId}
270
- ))
271
- )
272
- LIMIT 1`;
273
- if (found.length === 0) return "invalid_cursor";
274
- }
275
- const cursorId = cursor ?? null;
276
- const rows = await db.$queryRaw<ConsentHistoryRow[]>`
277
- SELECT g."id", g."purpose_id" AS "purposeId", g."granted", g."created_at" AS "at",
278
- g."source", g."source_ref" AS "sourceRef", g."policy_version" AS "policyVersion",
279
- g."locale", g."statement", g."subject_type" AS "subjectType"
280
- FROM "consent_grants" g
281
- WHERE g."workspace_id" = ${workspaceId}
282
- AND (
283
- g."person_id" = ${personId}
284
- OR (g."subject_type" = 'visitor' AND g."subject_id" IN (
285
- SELECT l."visitor_id" FROM "consent_visitor_links" l
286
- WHERE l."workspace_id" = ${workspaceId} AND l."person_id" = ${personId}
287
- ))
288
- )
289
- AND (${cursorId}::text IS NULL OR (g."created_at", g."id") < (
290
- SELECT c."created_at", c."id" FROM "consent_grants" c WHERE c."id" = ${cursorId}::text
291
- ))
292
- ORDER BY g."created_at" DESC, g."id" DESC
293
- LIMIT ${CONSENT_HISTORY_PAGE_SIZE + 1}`;
294
- const page = rows.slice(0, CONSENT_HISTORY_PAGE_SIZE);
295
- const last = page[page.length - 1];
296
- return {
297
- rows: page,
298
- nextCursor:
299
- rows.length > CONSENT_HISTORY_PAGE_SIZE && last ? last.id : null,
300
- };
301
- }
302
-
303
- /**
304
- * The newest row recording a visitor's choice for one purpose — the cookie
305
- * writer's dedupe: each CHANGE of choice is logged, a replay adds nothing
306
- * (D3, SEC-8438-2).
307
- */
308
- export async function latestVisitorChoice(
309
- workspaceId: string,
310
- visitorId: string,
311
- purposeId: string,
312
- db: ConsentReadClient = prisma,
313
- ): Promise<{ granted: boolean; policyVersion: number | null } | null> {
314
- const rows = await db.$queryRaw<
315
- Array<{ granted: boolean; policyVersion: number | null }>
316
- >`
317
- SELECT g."granted", g."policy_version" AS "policyVersion"
318
- FROM "consent_grants" g
319
- WHERE g."workspace_id" = ${workspaceId}
320
- AND g."subject_type" = 'visitor'
321
- AND g."subject_id" = ${visitorId}
322
- AND g."purpose_id" = ${purposeId}
323
- ORDER BY g."created_at" DESC, g."id" DESC
324
- LIMIT 1`;
325
- return rows[0] ?? null;
326
- }
327
-
328
- /**
329
- * When the caller's own `User` row was created — the sign-up window's only
330
- * input (SEC-8438-5: `via: "sign_up"` is honored for a user created within
331
- * the last 24 hours). `null` when no such user exists.
332
- */
333
- export async function userCreatedAt(
334
- userId: string,
335
- db: Pick<Prisma.TransactionClient, "user"> = prisma,
336
- ): Promise<Date | null> {
337
- const user = await db.user.findUnique({
338
- where: { id: userId },
339
- select: { createdAt: true },
340
- });
341
- return user?.createdAt ?? null;
342
- }
343
-
344
- /**
345
- * The owner's rows for the Working Theory platform purposes (C8): subject
346
- * `user` / `userId`, newest per purpose, at most 100.
347
- */
348
- export async function userPlatformRows(
349
- workspaceId: string,
350
- userId: string,
351
- db: ConsentReadClient = prisma,
352
- ): Promise<ConsentStateRow[]> {
353
- return db.$queryRaw<ConsentStateRow[]>`
354
- SELECT DISTINCT ON (g."purpose_id")
355
- g."id", g."purpose_id" AS "purposeId", g."granted", g."created_at" AS "at",
356
- g."source", g."source_ref" AS "sourceRef", g."policy_version" AS "policyVersion"
357
- FROM "consent_grants" g
358
- WHERE g."workspace_id" = ${workspaceId}
359
- AND g."subject_type" = 'user'
360
- AND g."subject_id" = ${userId}
361
- ORDER BY g."purpose_id", g."created_at" DESC, g."id" DESC
362
- LIMIT ${PLATFORM_ROWS_MAX}`;
363
- }
@@ -1,112 +0,0 @@
1
- /**
2
- * Shared content adapter singleton for apps/api.
3
- *
4
- * Adapter selection is NOT decided here — it is `resolveContentAdapter()`'s job
5
- * (#5804, roadmap D3: one resolver, one env var). This module supplies the
6
- * app's own inputs (content root, default locale, manifest path, the projection
7
- * factory) and memoises the result for the process.
8
- *
9
- * `CONTENT_ADAPTER` selects: `mdx` (default) | `projection` | `database`.
10
- * `CONTENT_BACKEND` is read for one more release by the resolver's shim.
11
- *
12
- * Content-root resolution order:
13
- * 1. `CONTENT_ROOT` env var (explicit override — recommended for production)
14
- * 2. `<cwd>/content` (works when the server is started from the repo root)
15
- * 3. `<cwd>/../../content` (works when started from `apps/api/` via pnpm)
16
- *
17
- * Manifest-path resolution (projection only):
18
- * 1. `MANIFEST_PATH` env var (explicit override)
19
- * 2. `<content-root>/.compiled/manifest.json` (the resolver's default)
20
- *
21
- * `workspaceId` is supplied by the CALLER, never read here (#5852). A public
22
- * read resolves its workspace through `services/public-site-resolver.ts` and
23
- * passes the result in; a caller that passes none still raises the resolver's
24
- * "workspaceId required" error under `CONTENT_ADAPTER=database`, rather than
25
- * silently reading some other workspace's pages. There is no local ADAPTER memo
26
- * slot: `resolveContentAdapter()` already memoises on the full key
27
- * (kind + workspaceId + root + locale + manifest), and a second cache keyed on
28
- * less than that is how one workspace's adapter reaches the next request. This
29
- * module's own INPUTS — the content root and the default locale, both
30
- * workspace-independent and both fixed for the process — stay memoised, so a
31
- * public read costs no more filesystem work than it did before the seam widened.
32
- */
33
- import { existsSync } from "node:fs";
34
- import { resolve } from "node:path";
35
-
36
- import {
37
- resetResolvedContentAdapter,
38
- resolveContentAdapter,
39
- type ArtifactPrismaClient,
40
- type ContentAdapter,
41
- type MdxContentAdapter,
42
- } from "@working-theory/content-adapters";
43
- import { createProjectionAdapter } from "@working-theory/content-projection";
44
- import { loadManifestFromDisk } from "@working-theory/content-projection/node";
45
-
46
- import { readDefaultLocale } from "./locales.js";
47
-
48
- /** Process-fixed inputs, resolved once: neither depends on the workspace. */
49
- let memoisedContentRoot: string | undefined;
50
- let memoisedDefaultLocale: string | undefined;
51
-
52
- /** Caller-supplied inputs; everything else is this module's own (#5852 D5). */
53
- export interface GetContentAdapterOptions {
54
- /** The resolved tenant. Required by `CONTENT_ADAPTER=database`, ignored otherwise. */
55
- workspaceId?: string | undefined;
56
- /** apps/api's client. The database adapter never constructs one. */
57
- prisma?: ArtifactPrismaClient | undefined;
58
- }
59
-
60
- /**
61
- * Resolve the content root. Honours `CONTENT_ROOT` env first, then probes the
62
- * cwd-relative candidates above.
63
- */
64
- export function getContentRoot(): string {
65
- if (process.env.CONTENT_ROOT) return process.env.CONTENT_ROOT;
66
-
67
- const cwd = process.cwd();
68
- const cwdContent = resolve(cwd, "content");
69
- const repoContent = resolve(cwd, "../../content");
70
- if (existsSync(cwdContent)) return cwdContent;
71
- if (existsSync(repoContent)) return repoContent;
72
- // Last resort — cwd-relative, even if missing. The adapter will return
73
- // null/empty for missing pages; routes will surface 404s.
74
- return cwdContent;
75
- }
76
-
77
- /**
78
- * Returns the content adapter for the given tenant, memoised by the resolver.
79
- * Safe to call repeatedly. Adapter type is determined by `CONTENT_ADAPTER` env,
80
- * read by the resolver.
81
- */
82
- export function getContentAdapter(
83
- options: GetContentAdapterOptions = {},
84
- ): ContentAdapter {
85
- memoisedContentRoot ??= getContentRoot();
86
- memoisedDefaultLocale ??= readDefaultLocale();
87
-
88
- return resolveContentAdapter({
89
- workspaceId: options.workspaceId,
90
- prisma: options.prisma,
91
- contentRoot: memoisedContentRoot,
92
- defaultLocale: memoisedDefaultLocale,
93
- manifestPath: process.env.MANIFEST_PATH,
94
- // The projection adapter lives in a package that depends on
95
- // content-adapters, so the resolver cannot import it without closing a
96
- // cycle. apps/api depends on both, and injects it.
97
- createProjectionAdapter: (manifestPath) =>
98
- createProjectionAdapter({ manifest: loadManifestFromDisk(manifestPath) }),
99
- });
100
- }
101
-
102
- /**
103
- * Test/utility helper — drop the memoised adapter so the next call rebuilds
104
- * with current env. Not used in production.
105
- */
106
- export function resetContentAdapter(): void {
107
- memoisedContentRoot = undefined;
108
- memoisedDefaultLocale = undefined;
109
- resetResolvedContentAdapter();
110
- }
111
-
112
- export type { MdxContentAdapter };