Open History to see the last commit
1import { dirname, resolve } from 'node:path'
2import { fileURLToPath } from 'node:url'
3import express from 'express'
4import cors from 'cors'
5import chalk from 'chalk'
6
7import {
8 AddOnCompiledSchema,
9 StarterCompiledSchema,
10 handleSpecialURL,
11} from '@tanstack/cta-engine'
12
13import { addToAppWrapper } from './engine-handling/add-to-app-wrapper.js'
14import { createAppWrapper } from './engine-handling/create-app-wrapper.js'
15import { generateInitialPayload } from './engine-handling/generate-initial-payload.js'
16import { setServerEnvironment } from './engine-handling/server-environment.js'
17
18import type { ServerEnvironment } from './engine-handling/server-environment.js'
19import type { Environment } from '@tanstack/cta-engine'
20
21export function launchUI(
22 options: Partial<ServerEnvironment> & {
23 port?: number
24 environmentFactory?: () => Environment
25 webBase?: string
26 },
27) {
28 const { port: requestedPort, webBase, ...rest } = options
29 setServerEnvironment(rest)
30
31 const app = express()
32
33 app.use(cors())
34 app.use(express.json())
35 app.use(express.urlencoded({ extended: true }))
36
37 const packagePath = resolve(dirname(fileURLToPath(import.meta.url)), '..')
38
39 const launchUI = !process.env.CTA_DISABLE_UI
40 if (launchUI) {
41 app.use(express.static(webBase || resolve(packagePath, 'dist')))
42 }
43
44 app.post('/api/add-to-app', async (req, res) => {
45 await addToAppWrapper(req.body.addOns, {
46 response: res,
47 environmentFactory: options.environmentFactory,
48 })
49 })
50
51 app.post('/api/create-app', async (req, res) => {
52 await createAppWrapper(req.body.options, {
53 response: res,
54 environmentFactory: options.environmentFactory,
55 })
56 })
57
58 app.post('/api/dry-run-add-to-app', async (req, res) => {
59 try {
60 res.send(
61 await addToAppWrapper(req.body.addOns, {
62 dryRun: true,
63 environmentFactory: options.environmentFactory,
64 }),
65 )
66 } catch {
67 res.send({
68 files: {},
69 commands: [],
70 deletedFiles: [],
71 })
72 }
73 })
74
75 app.post('/api/dry-run-create-app', async (req, res) => {
76 try {
77 res.send(
78 await createAppWrapper(req.body.options, {
79 dryRun: true,
80 environmentFactory: options.environmentFactory,
81 }),
82 )
83 } catch {
84 res.send({
85 files: {},
86 commands: [],
87 deletedFiles: [],
88 })
89 }
90 })
91
92 app.get('/api/initial-payload', async (_req, res) => {
93 res.send(await generateInitialPayload())
94 })
95
96 app.get('/api/load-remote-add-on', async (req, res) => {
97 const { url } = req.query
98 if (!url) {
99 res.status(400).send('URL is required')
100 return
101 }
102 try {
103 const fixedUrl = handleSpecialURL(url as string)
104 const response = await fetch(fixedUrl)
105 const data = await response.json()
106 const parsed = AddOnCompiledSchema.safeParse(data)
107 if (!parsed.success) {
108 res.status(400).json({ error: 'Invalid add-on data' })
109 } else {
110 res.json({
111 id: fixedUrl,
112 name: parsed.data.name,
113 description: parsed.data.description,
114 version: parsed.data.version,
115 author: parsed.data.author,
116 license: parsed.data.license,
117 link: parsed.data.link,
118 smallLogo: parsed.data.smallLogo,
119 logo: parsed.data.logo,
120 type: parsed.data.type,
121 modes: parsed.data.modes,
122 })
123 }
124 } catch {
125 res.status(500).send('Failed to load add-on')
126 }
127 })
128
129 app.get('/api/load-starter', async (req, res) => {
130 const { url } = req.query
131 if (!url) {
132 res.status(400).send('URL is required')
133 return
134 }
135 try {
136 const fixedUrl = handleSpecialURL(url as string)
137 const response = await fetch(fixedUrl)
138 const data = await response.json()
139 const parsed = StarterCompiledSchema.safeParse(data)
140 if (!parsed.success) {
141 res.status(400).json({ error: 'Invalid starter data' })
142 } else {
143 res.json({
144 url: fixedUrl,
145 id: parsed.data.id,
146 name: parsed.data.name,
147 description: parsed.data.description,
148 version: parsed.data.version,
149 author: parsed.data.author,
150 license: parsed.data.license,
151 dependsOn: parsed.data.dependsOn,
152 mode: parsed.data.mode,
153 typescript: parsed.data.typescript,
154 tailwind: parsed.data.tailwind,
155 banner: parsed.data.banner
156 ? fixedUrl.replace('starter.json', parsed.data.banner)
157 : undefined,
158 })
159 }
160 } catch {
161 res.status(500).send('Failed to load starter')
162 }
163 })
164
165 app.post('/api/shutdown', (_req, res) => {
166 setTimeout(() => {
167 process.exit(0)
168 }, 50)
169 res.send({ shutdown: true })
170 })
171
172 const port = requestedPort || process.env.PORT || 8080
173 app.listen(port, () => {
174 console.log(
175 `🔥 ${chalk.blueBright(`Create TanStack ${launchUI ? 'App' : 'API'}`)} is running on ${chalk.underline(
176 `http://localhost:${port}`,
177 )}`,
178 )
179 })
180}