@voltx/cli 0.3.3 → 0.3.5

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 (58) hide show
  1. package/README.md +68 -14
  2. package/dist/build.d.mts +4 -3
  3. package/dist/build.d.ts +4 -3
  4. package/dist/build.js +56 -27
  5. package/dist/build.mjs +1 -2
  6. package/dist/chunk-2LHDOMF2.mjs +680 -0
  7. package/dist/chunk-4T26KROZ.mjs +456 -0
  8. package/dist/chunk-5DVBIJXU.mjs +84 -0
  9. package/dist/chunk-5RN2FYST.mjs +494 -0
  10. package/dist/chunk-65PVXS4D.mjs +894 -0
  11. package/dist/chunk-7JVIEGSA.mjs +141 -0
  12. package/dist/chunk-A4NA4AJN.mjs +786 -0
  13. package/dist/chunk-AAAHANST.mjs +839 -0
  14. package/dist/chunk-AD3WMFZF.mjs +205 -0
  15. package/dist/chunk-CFWXMM7Q.mjs +450 -0
  16. package/dist/chunk-CSSHLVYS.mjs +83 -0
  17. package/dist/chunk-CWOSNV5O.mjs +150 -0
  18. package/dist/chunk-EI6XBYKB.mjs +84 -0
  19. package/dist/chunk-EXMRIKIX.mjs +404 -0
  20. package/dist/chunk-FI2W4L4S.mjs +205 -0
  21. package/dist/chunk-FN7KZJ6H.mjs +363 -0
  22. package/dist/chunk-G2INQCCJ.mjs +907 -0
  23. package/dist/chunk-H2DTIOEO.mjs +150 -0
  24. package/dist/chunk-IS2WTE3C.mjs +138 -0
  25. package/dist/chunk-JECCDBYI.mjs +730 -0
  26. package/dist/chunk-KX2MRJUO.mjs +795 -0
  27. package/dist/chunk-LTGMHAZS.mjs +147 -0
  28. package/dist/chunk-OPO6RUFP.mjs +698 -0
  29. package/dist/chunk-P5FSO2UH.mjs +497 -0
  30. package/dist/chunk-PWQSKYAM.mjs +682 -0
  31. package/dist/chunk-Q5XCFN7L.mjs +1026 -0
  32. package/dist/chunk-QSU6FZC7.mjs +497 -0
  33. package/dist/chunk-RYWRFHEC.mjs +83 -0
  34. package/dist/chunk-SU4Q3PTH.mjs +201 -0
  35. package/dist/chunk-UO43CY7Y.mjs +497 -0
  36. package/dist/chunk-UXI3QSDN.mjs +121 -0
  37. package/dist/chunk-VD3CNPNP.mjs +123 -0
  38. package/dist/chunk-X6VOAPRJ.mjs +756 -0
  39. package/dist/cli.js +1023 -306
  40. package/dist/cli.mjs +7 -6
  41. package/dist/create.d.mts +1 -0
  42. package/dist/create.d.ts +1 -0
  43. package/dist/create.js +813 -189
  44. package/dist/create.mjs +1 -2
  45. package/dist/dev.d.mts +6 -4
  46. package/dist/dev.d.ts +6 -4
  47. package/dist/dev.js +119 -46
  48. package/dist/dev.mjs +1 -2
  49. package/dist/generate.js +13 -13
  50. package/dist/generate.mjs +1 -2
  51. package/dist/index.d.mts +1 -1
  52. package/dist/index.d.ts +1 -1
  53. package/dist/index.js +1010 -294
  54. package/dist/index.mjs +6 -7
  55. package/dist/start.js +7 -17
  56. package/dist/start.mjs +1 -2
  57. package/dist/welcome.mjs +0 -1
  58. package/package.json +11 -3
@@ -0,0 +1,404 @@
1
+ import {
2
+ printWelcomeBanner
3
+ } from "./chunk-IV352HZA.mjs";
4
+ import {
5
+ __require
6
+ } from "./chunk-Y6FXYEAI.mjs";
7
+
8
+ // src/create.ts
9
+ import * as fs from "fs";
10
+ import * as path from "path";
11
+ async function createProject(options) {
12
+ const { name, template = "blank", auth = "none" } = options;
13
+ const targetDir = path.resolve(process.cwd(), name);
14
+ if (fs.existsSync(targetDir)) {
15
+ console.error(`[voltx] Directory "${name}" already exists.`);
16
+ process.exit(1);
17
+ }
18
+ fs.mkdirSync(targetDir, { recursive: true });
19
+ const templateDeps = {
20
+ blank: {
21
+ "@voltx/core": "^0.3.0",
22
+ "@voltx/server": "^0.3.0"
23
+ },
24
+ chatbot: {
25
+ "@voltx/core": "^0.3.0",
26
+ "@voltx/ai": "^0.3.0",
27
+ "@voltx/server": "^0.3.0",
28
+ "@voltx/memory": "^0.3.0"
29
+ },
30
+ "rag-app": {
31
+ "@voltx/core": "^0.3.0",
32
+ "@voltx/ai": "^0.3.0",
33
+ "@voltx/server": "^0.3.0",
34
+ "@voltx/rag": "^0.3.0",
35
+ "@voltx/db": "^0.3.0"
36
+ },
37
+ "agent-app": {
38
+ "@voltx/core": "^0.3.0",
39
+ "@voltx/ai": "^0.3.0",
40
+ "@voltx/server": "^0.3.0",
41
+ "@voltx/agents": "^0.3.0",
42
+ "@voltx/memory": "^0.3.0"
43
+ }
44
+ };
45
+ const packageJson = {
46
+ name,
47
+ version: "0.1.0",
48
+ private: true,
49
+ scripts: {
50
+ dev: "voltx dev",
51
+ build: "voltx build",
52
+ start: "voltx start"
53
+ },
54
+ dependencies: {
55
+ ...templateDeps[template] ?? templateDeps["blank"],
56
+ "@voltx/cli": "^0.3.0",
57
+ ...auth === "better-auth" ? { "@voltx/auth": "^0.3.0", "better-auth": "^1.5.0" } : {},
58
+ ...auth === "jwt" ? { "@voltx/auth": "^0.3.0", "jose": "^6.0.0" } : {}
59
+ },
60
+ devDependencies: {
61
+ typescript: "^5.7.0",
62
+ tsx: "^4.21.0",
63
+ tsup: "^8.0.0",
64
+ "@types/node": "^22.0.0"
65
+ }
66
+ };
67
+ fs.writeFileSync(
68
+ path.join(targetDir, "package.json"),
69
+ JSON.stringify(packageJson, null, 2)
70
+ );
71
+ const hasDb = template === "rag-app" || template === "agent-app" || auth === "better-auth";
72
+ const provider = template === "rag-app" ? "openai" : "cerebras";
73
+ const model = template === "rag-app" ? "gpt-4o" : "llama3.1-8b";
74
+ let configContent = `import { defineConfig } from "@voltx/core";
75
+
76
+ export default defineConfig({
77
+ name: "${name}",
78
+ port: 3000,
79
+ ai: {
80
+ provider: "${provider}",
81
+ model: "${model}",
82
+ },`;
83
+ if (hasDb) {
84
+ configContent += `
85
+ db: {
86
+ url: process.env.DATABASE_URL,
87
+ },`;
88
+ }
89
+ if (auth !== "none") {
90
+ configContent += `
91
+ auth: {
92
+ provider: "${auth}",
93
+ },`;
94
+ }
95
+ configContent += `
96
+ server: {
97
+ routesDir: "src/routes",
98
+ staticDir: "public",
99
+ cors: true,
100
+ },
101
+ });
102
+ `;
103
+ fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
104
+ fs.mkdirSync(path.join(targetDir, "src", "routes", "api"), { recursive: true });
105
+ fs.mkdirSync(path.join(targetDir, "public"), { recursive: true });
106
+ fs.writeFileSync(
107
+ path.join(targetDir, "src", "index.ts"),
108
+ `import { createApp } from "@voltx/core";
109
+ import config from "../voltx.config";
110
+
111
+ const app = createApp(config);
112
+ app.start();
113
+ `
114
+ );
115
+ fs.writeFileSync(
116
+ path.join(targetDir, "src", "routes", "index.ts"),
117
+ `// GET / \u2014 Health check
118
+ import type { Context } from "@voltx/server";
119
+
120
+ export function GET(c: Context) {
121
+ return c.json({ name: "${name}", status: "ok" });
122
+ }
123
+ `
124
+ );
125
+ if (template === "chatbot" || template === "agent-app") {
126
+ fs.writeFileSync(
127
+ path.join(targetDir, "src", "routes", "api", "chat.ts"),
128
+ `// POST /api/chat \u2014 Streaming chat with conversation memory
129
+ import type { Context } from "@voltx/server";
130
+ import { streamText } from "@voltx/ai";
131
+ import { createMemory } from "@voltx/memory";
132
+
133
+ // In-memory for dev; swap to createMemory("postgres", { url }) for production
134
+ const memory = createMemory({ maxMessages: 50 });
135
+
136
+ export async function POST(c: Context) {
137
+ const { messages, conversationId = "default" } = await c.req.json();
138
+
139
+ // Store the latest user message
140
+ const lastMessage = messages[messages.length - 1];
141
+ if (lastMessage?.role === "user") {
142
+ await memory.add(conversationId, { role: "user", content: lastMessage.content });
143
+ }
144
+
145
+ // Get conversation history from memory
146
+ const history = await memory.get(conversationId);
147
+
148
+ const result = await streamText({
149
+ model: "${provider}:${model}",
150
+ system: "You are a helpful AI assistant.",
151
+ messages: history.map((m) => ({ role: m.role, content: m.content })),
152
+ });
153
+
154
+ // Store assistant response after stream completes
155
+ result.text.then(async (text) => {
156
+ await memory.add(conversationId, { role: "assistant", content: text });
157
+ });
158
+
159
+ return result.toSSEResponse();
160
+ }
161
+ `
162
+ );
163
+ }
164
+ if (template === "agent-app") {
165
+ fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
166
+ fs.mkdirSync(path.join(targetDir, "src", "tools"), { recursive: true });
167
+ fs.writeFileSync(
168
+ path.join(targetDir, "src", "agents", "assistant.ts"),
169
+ `import { createAgent } from "@voltx/agents";
170
+ import { searchTool } from "../tools/search";
171
+
172
+ export const assistant = createAgent({
173
+ name: "assistant",
174
+ model: "${provider}:${model}",
175
+ instructions: "You are a helpful AI assistant. Use your tools when needed.",
176
+ tools: [searchTool],
177
+ maxIterations: 5,
178
+ });
179
+ `
180
+ );
181
+ fs.writeFileSync(
182
+ path.join(targetDir, "src", "tools", "search.ts"),
183
+ `import type { Tool } from "@voltx/agents";
184
+
185
+ export const searchTool: Tool = {
186
+ name: "search",
187
+ description: "Search for information on a topic.",
188
+ parameters: {
189
+ type: "object",
190
+ properties: { query: { type: "string", description: "The search query" } },
191
+ required: ["query"],
192
+ },
193
+ async execute(args: { query: string }) {
194
+ return \`Search results for "\${args.query}": Placeholder \u2014 connect a real search API.\`;
195
+ },
196
+ };
197
+ `
198
+ );
199
+ fs.writeFileSync(
200
+ path.join(targetDir, "src", "routes", "api", "agent.ts"),
201
+ `import type { Context } from "@voltx/server";
202
+ import { assistant } from "../../agents/assistant";
203
+
204
+ export async function POST(c: Context) {
205
+ const { input } = await c.req.json();
206
+ if (!input) return c.json({ error: "Missing 'input' field" }, 400);
207
+ const result = await assistant.run(input);
208
+ return c.json({ content: result.content, steps: result.steps });
209
+ }
210
+ `
211
+ );
212
+ }
213
+ if (template === "rag-app") {
214
+ const embedModel = "openai:text-embedding-3-small";
215
+ fs.mkdirSync(path.join(targetDir, "src", "routes", "api", "rag"), { recursive: true });
216
+ fs.writeFileSync(
217
+ path.join(targetDir, "src", "routes", "api", "rag", "query.ts"),
218
+ `// POST /api/rag/query \u2014 Query documents with RAG
219
+ import type { Context } from "@voltx/server";
220
+ import { streamText } from "@voltx/ai";
221
+ import { createRAGPipeline, createEmbedder } from "@voltx/rag";
222
+ import { createVectorStore } from "@voltx/db";
223
+
224
+ const vectorStore = createVectorStore(); // swap to "pinecone" or "pgvector" for production
225
+ const embedder = createEmbedder({ model: "${embedModel}" });
226
+ const rag = createRAGPipeline({ embedder, vectorStore });
227
+
228
+ export async function POST(c: Context) {
229
+ const { question } = await c.req.json();
230
+
231
+ const context = await rag.getContext(question, { topK: 5 });
232
+
233
+ const result = await streamText({
234
+ model: "${provider}:${model}",
235
+ system: \`Answer the user's question based on the following context. If the context doesn't contain relevant information, say so.\\n\\nContext:\\n\${context}\`,
236
+ messages: [{ role: "user", content: question }],
237
+ });
238
+
239
+ return result.toSSEResponse();
240
+ }
241
+ `
242
+ );
243
+ fs.writeFileSync(
244
+ path.join(targetDir, "src", "routes", "api", "rag", "ingest.ts"),
245
+ `// POST /api/rag/ingest \u2014 Ingest documents into the vector store
246
+ import type { Context } from "@voltx/server";
247
+ import { createRAGPipeline, createEmbedder } from "@voltx/rag";
248
+ import { createVectorStore } from "@voltx/db";
249
+
250
+ const vectorStore = createVectorStore();
251
+ const embedder = createEmbedder({ model: "${embedModel}" });
252
+ const rag = createRAGPipeline({ embedder, vectorStore });
253
+
254
+ export async function POST(c: Context) {
255
+ const { text, idPrefix } = await c.req.json();
256
+
257
+ if (!text || typeof text !== "string") {
258
+ return c.json({ error: "Missing 'text' field" }, 400);
259
+ }
260
+
261
+ const result = await rag.ingest(text, idPrefix ?? "doc");
262
+ return c.json({ status: "ok", chunks: result.chunks, ids: result.ids });
263
+ }
264
+ `
265
+ );
266
+ }
267
+ if (auth === "better-auth") {
268
+ fs.mkdirSync(path.join(targetDir, "src", "routes", "api", "auth"), { recursive: true });
269
+ fs.writeFileSync(
270
+ path.join(targetDir, "src", "routes", "api", "auth", "[...path].ts"),
271
+ `// ALL /api/auth/* \u2014 Better Auth handler
272
+ import type { Context } from "@voltx/server";
273
+ import { auth } from "../../../lib/auth";
274
+ import { createAuthHandler } from "@voltx/auth";
275
+
276
+ const handler = createAuthHandler(auth);
277
+
278
+ export const GET = (c: Context) => handler(c);
279
+ export const POST = (c: Context) => handler(c);
280
+ `
281
+ );
282
+ fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
283
+ fs.writeFileSync(
284
+ path.join(targetDir, "src", "lib", "auth.ts"),
285
+ `// Auth configuration \u2014 Better Auth with DB-backed sessions
286
+ import { createAuth, createAuthMiddleware } from "@voltx/auth";
287
+
288
+ export const auth = createAuth("better-auth", {
289
+ database: process.env.DATABASE_URL!,
290
+ emailAndPassword: true,
291
+ });
292
+
293
+ export const authMiddleware = createAuthMiddleware({
294
+ provider: auth,
295
+ publicPaths: ["/api/auth", "/api/health", "/"],
296
+ });
297
+ `
298
+ );
299
+ } else if (auth === "jwt") {
300
+ fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
301
+ fs.writeFileSync(
302
+ path.join(targetDir, "src", "lib", "auth.ts"),
303
+ `// Auth configuration \u2014 JWT (stateless)
304
+ import { createAuth, createAuthMiddleware } from "@voltx/auth";
305
+
306
+ export const jwt = createAuth("jwt", {
307
+ secret: process.env.JWT_SECRET!,
308
+ expiresIn: "7d",
309
+ });
310
+
311
+ export const authMiddleware = createAuthMiddleware({
312
+ provider: jwt,
313
+ publicPaths: ["/api/auth", "/api/health", "/"],
314
+ });
315
+ `
316
+ );
317
+ fs.writeFileSync(
318
+ path.join(targetDir, "src", "routes", "api", "auth.ts"),
319
+ `// POST /api/auth/login \u2014 Example JWT login route
320
+ import type { Context } from "@voltx/server";
321
+ import { jwt } from "../../lib/auth";
322
+
323
+ export async function POST(c: Context) {
324
+ const { email, password } = await c.req.json();
325
+
326
+ if (!email || !password) {
327
+ return c.json({ error: "Email and password are required" }, 400);
328
+ }
329
+
330
+ const token = await jwt.sign({ sub: email, email });
331
+ return c.json({ token });
332
+ }
333
+ `
334
+ );
335
+ }
336
+ let envContent = "";
337
+ if (template === "rag-app") {
338
+ envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nOPENAI_API_KEY=sk-...\n\n";
339
+ envContent += "# \u2500\u2500\u2500 Database (Neon Postgres) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n\n";
340
+ envContent += "# \u2500\u2500\u2500 Vector Database (Pinecone) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPINECONE_API_KEY=pc-...\nPINECONE_INDEX=voltx-embeddings\n\n";
341
+ } else if (template === "chatbot" || template === "agent-app") {
342
+ envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nCEREBRAS_API_KEY=csk-...\n\n";
343
+ if (template === "agent-app") {
344
+ envContent += "# \u2500\u2500\u2500 Database (Neon Postgres \u2014 optional) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=\n\n";
345
+ }
346
+ } else {
347
+ envContent += "# \u2500\u2500\u2500 LLM Provider (add your key) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n# OPENAI_API_KEY=sk-...\n# CEREBRAS_API_KEY=csk-...\n\n";
348
+ }
349
+ if (auth === "better-auth") {
350
+ envContent += "# \u2500\u2500\u2500 Auth (Better Auth) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nBETTER_AUTH_SECRET=your-secret-key-min-32-chars-here\nBETTER_AUTH_URL=http://localhost:3000\n";
351
+ if (template !== "rag-app" && template !== "agent-app") {
352
+ envContent += "DATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n";
353
+ }
354
+ envContent += "# GITHUB_CLIENT_ID=\n# GITHUB_CLIENT_SECRET=\n\n";
355
+ } else if (auth === "jwt") {
356
+ envContent += "# \u2500\u2500\u2500 Auth (JWT) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nJWT_SECRET=your-jwt-secret-key\n\n";
357
+ }
358
+ envContent += "# \u2500\u2500\u2500 App \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPORT=3000\nNODE_ENV=development\n";
359
+ fs.writeFileSync(path.join(targetDir, ".env.example"), envContent);
360
+ fs.writeFileSync(
361
+ path.join(targetDir, ".gitignore"),
362
+ "node_modules\ndist\n.env\n"
363
+ );
364
+ fs.writeFileSync(
365
+ path.join(targetDir, "tsconfig.json"),
366
+ JSON.stringify(
367
+ {
368
+ compilerOptions: {
369
+ target: "ES2022",
370
+ module: "ESNext",
371
+ moduleResolution: "bundler",
372
+ strict: true,
373
+ esModuleInterop: true,
374
+ skipLibCheck: true,
375
+ outDir: "dist"
376
+ },
377
+ include: ["src", "voltx.config.ts"]
378
+ },
379
+ null,
380
+ 2
381
+ )
382
+ );
383
+ printWelcomeBanner(name);
384
+ }
385
+ var isDirectRun = typeof __require !== "undefined" && __require.main === module && process.argv[1]?.includes("create");
386
+ if (isDirectRun) {
387
+ const projectName = process.argv[2];
388
+ if (!projectName) {
389
+ console.log("Usage: create-voltx-app <project-name> [--template chatbot] [--auth jwt]");
390
+ process.exit(1);
391
+ }
392
+ const templateFlag = process.argv.indexOf("--template");
393
+ const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
394
+ const authFlag = process.argv.indexOf("--auth");
395
+ const auth = authFlag !== -1 ? process.argv[authFlag + 1] : "none";
396
+ createProject({ name: projectName, template, auth }).catch((err) => {
397
+ console.error("[voltx] Error:", err);
398
+ process.exit(1);
399
+ });
400
+ }
401
+
402
+ export {
403
+ createProject
404
+ };
@@ -0,0 +1,205 @@
1
+ // src/dev.ts
2
+ import { spawn } from "child_process";
3
+ import { resolve, join } from "path";
4
+ import { existsSync, writeFileSync, unlinkSync } from "fs";
5
+ import { loadEnv } from "@voltx/core";
6
+ async function runDev(options = {}) {
7
+ const cwd = process.cwd();
8
+ const {
9
+ port,
10
+ entry = findEntryPoint(cwd),
11
+ clearScreen = true
12
+ } = options;
13
+ if (!entry) {
14
+ console.error("[voltx] Could not find entry point. Expected server.ts or src/index.ts");
15
+ process.exit(1);
16
+ }
17
+ const entryPath = resolve(cwd, entry);
18
+ if (!existsSync(entryPath)) {
19
+ console.error(`[voltx] Entry file not found: ${entry}`);
20
+ process.exit(1);
21
+ }
22
+ loadEnv("development", cwd);
23
+ const hasViteConfig = existsSync(resolve(cwd, "vite.config.ts"));
24
+ const hasServerEntry = existsSync(resolve(cwd, "server.ts"));
25
+ const isFullStack = hasViteConfig || hasServerEntry;
26
+ if (isFullStack) {
27
+ await startViteDevServer(cwd, port, entry, options);
28
+ } else {
29
+ await startTsxWatch(cwd, port, entry, options);
30
+ }
31
+ }
32
+ async function startViteDevServer(cwd, port, entry, options) {
33
+ const resolvedPort = port ?? (Number(process.env.PORT) || 3e3);
34
+ printDevBanner(entry, resolvedPort, true);
35
+ const userViteConfig = resolve(cwd, "vite.config.ts");
36
+ const hasUserViteConfig = existsSync(userViteConfig);
37
+ let tempConfigPath = null;
38
+ if (!hasUserViteConfig) {
39
+ tempConfigPath = resolve(cwd, "vite.config.voltx.ts");
40
+ const viteConfigContent = generateViteConfig(entry, resolvedPort);
41
+ writeFileSync(tempConfigPath, viteConfigContent, "utf-8");
42
+ }
43
+ const env = {
44
+ ...process.env,
45
+ NODE_ENV: "development"
46
+ };
47
+ if (port) {
48
+ env.PORT = String(port);
49
+ }
50
+ const viteBin = findBin(cwd, "vite");
51
+ const viteArgs = ["dev"];
52
+ if (tempConfigPath) {
53
+ viteArgs.push("--config", tempConfigPath);
54
+ }
55
+ viteArgs.push("--port", String(resolvedPort));
56
+ let child;
57
+ if (viteBin) {
58
+ child = spawn(viteBin, viteArgs, { cwd, env, stdio: "inherit" });
59
+ } else {
60
+ child = spawn("npx", ["vite", ...viteArgs], { cwd, env, stdio: "inherit" });
61
+ }
62
+ const cleanup = () => {
63
+ if (tempConfigPath && existsSync(tempConfigPath)) {
64
+ try {
65
+ unlinkSync(tempConfigPath);
66
+ } catch {
67
+ }
68
+ }
69
+ };
70
+ const signals = ["SIGINT", "SIGTERM"];
71
+ for (const signal of signals) {
72
+ process.on(signal, () => {
73
+ cleanup();
74
+ child.kill(signal);
75
+ });
76
+ }
77
+ child.on("error", (err) => {
78
+ cleanup();
79
+ if (err.code === "ENOENT") {
80
+ console.error("[voltx] vite not found. Install it with: npm install -D vite @hono/vite-dev-server");
81
+ } else {
82
+ console.error("[voltx] Dev server error:", err.message);
83
+ }
84
+ process.exit(1);
85
+ });
86
+ child.on("exit", (code) => {
87
+ cleanup();
88
+ process.exit(code ?? 0);
89
+ });
90
+ }
91
+ function generateViteConfig(entry, port) {
92
+ return `// Auto-generated by VoltX \u2014 do not commit this file
93
+ import { defineConfig } from "vite";
94
+ import devServer from "@hono/vite-dev-server";
95
+
96
+ export default defineConfig({
97
+ server: {
98
+ port: ${port},
99
+ },
100
+ plugins: [
101
+ devServer({
102
+ entry: "${entry}",
103
+ exclude: [
104
+ /.*\\.tsx?($|\\?)/,
105
+ /.*\\.(s?css|less)($|\\?)/,
106
+ /.*\\.(svg|png|jpg|jpeg|gif|webp|ico)($|\\?)/,
107
+ /^\\/@.+$/,
108
+ /^\\/favicon\\.ico$/,
109
+ /^\\/node_modules\\/.*/,
110
+ /^\\/src\\/.*/,
111
+ ],
112
+ injectClientScript: false,
113
+ }),
114
+ ],
115
+ });
116
+ `;
117
+ }
118
+ async function startTsxWatch(cwd, port, entry, options) {
119
+ const resolvedPort = port ?? (Number(process.env.PORT) || 3e3);
120
+ printDevBanner(entry, resolvedPort, false);
121
+ const env = {
122
+ ...process.env,
123
+ NODE_ENV: "development"
124
+ };
125
+ if (port) {
126
+ env.PORT = String(port);
127
+ }
128
+ const tsxArgs = ["watch"];
129
+ if (options.clearScreen ?? true) {
130
+ tsxArgs.push("--clear-screen=false");
131
+ }
132
+ tsxArgs.push("--ignore=node_modules", "--ignore=dist", "--ignore=.turbo");
133
+ tsxArgs.push(entry);
134
+ const tsxBin = findBin(cwd, "tsx");
135
+ let child;
136
+ if (tsxBin) {
137
+ child = spawn(tsxBin, tsxArgs, { cwd, env, stdio: "inherit" });
138
+ } else {
139
+ child = spawn("npx", ["tsx", ...tsxArgs], { cwd, env, stdio: "inherit" });
140
+ }
141
+ const signals = ["SIGINT", "SIGTERM"];
142
+ for (const signal of signals) {
143
+ process.on(signal, () => {
144
+ child.kill(signal);
145
+ });
146
+ }
147
+ child.on("error", (err) => {
148
+ if (err.code === "ENOENT") {
149
+ console.error("[voltx] tsx not found. Install it with: npm install -D tsx");
150
+ } else {
151
+ console.error("[voltx] Dev server error:", err.message);
152
+ }
153
+ process.exit(1);
154
+ });
155
+ child.on("exit", (code) => {
156
+ process.exit(code ?? 0);
157
+ });
158
+ }
159
+ function findEntryPoint(cwd) {
160
+ const candidates = [
161
+ "server.ts",
162
+ "server.js",
163
+ "src/index.ts",
164
+ "src/index.js",
165
+ "src/index.mts",
166
+ "src/main.ts",
167
+ "src/main.js",
168
+ "index.ts",
169
+ "index.js"
170
+ ];
171
+ for (const candidate of candidates) {
172
+ if (existsSync(join(cwd, candidate))) {
173
+ return candidate;
174
+ }
175
+ }
176
+ return null;
177
+ }
178
+ function findBin(cwd, name) {
179
+ const paths = [
180
+ join(cwd, "node_modules", ".bin", name),
181
+ join(cwd, "..", "node_modules", ".bin", name),
182
+ join(cwd, "..", "..", "node_modules", ".bin", name)
183
+ ];
184
+ for (const p of paths) {
185
+ if (existsSync(p)) return p;
186
+ }
187
+ return null;
188
+ }
189
+ function printDevBanner(entry, port, fullStack) {
190
+ console.log("");
191
+ console.log(" \u26A1 VoltX Dev Server");
192
+ console.log(" \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
193
+ console.log(` Entry: ${entry}`);
194
+ console.log(` Port: ${port}`);
195
+ console.log(` Mode: ${fullStack ? "full-stack (Vite + Hono)" : "API-only (tsx watch)"}`);
196
+ if (fullStack) {
197
+ console.log(` HMR: enabled (frontend + backend)`);
198
+ }
199
+ console.log(" \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
200
+ console.log("");
201
+ }
202
+
203
+ export {
204
+ runDev
205
+ };