@voltx/cli 0.3.4 → 0.3.6

package/dist/create.mjs

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
 import {
   createProject
-} from "./chunk-P5FSO2UH.mjs";
+} from "./chunk-TFVNHM7S.mjs";
 import "./chunk-IV352HZA.mjs";
-import "./chunk-Y6FXYEAI.mjs";
 export {
   createProject
 };

package/dist/dev.d.mts

@@ -1,7 +1,7 @@
 interface DevOptions {
     /** Port override (reads from voltx.config.ts or env if not set) */
     port?: number;
-    /** Entry file (default: src/index.ts) */
+    /** Entry file (default: server.ts) */
     entry?: string;
     /** Extra directories to watch */
     watch?: string[];
@@ -9,10 +9,12 @@ interface DevOptions {
     clearScreen?: boolean;
 }
 /**
- * Start the VoltX dev server with hot reload.
+ * Start the VoltX dev server.
  *
- * Spawns `tsx watch` on the app entry point. tsx handles TypeScript
- * compilation and automatic restarts when files change.
+ * Detects whether the project is full-stack (has vite.config.ts or server.ts).
+ * - If yes: starts Vite with @hono/vite-dev-server plugin — one process,
+ *   one port, frontend HMR + backend API routes together.
+ * - If no: spawns tsx watch for fast API-only development.
  */
 declare function runDev(options?: DevOptions): Promise<void>;
 

package/dist/dev.d.ts

@@ -1,7 +1,7 @@
 interface DevOptions {
     /** Port override (reads from voltx.config.ts or env if not set) */
     port?: number;
-    /** Entry file (default: src/index.ts) */
+    /** Entry file (default: server.ts) */
     entry?: string;
     /** Extra directories to watch */
     watch?: string[];
@@ -9,10 +9,12 @@ interface DevOptions {
     clearScreen?: boolean;
 }
 /**
- * Start the VoltX dev server with hot reload.
+ * Start the VoltX dev server.
  *
- * Spawns `tsx watch` on the app entry point. tsx handles TypeScript
- * compilation and automatic restarts when files change.
+ * Detects whether the project is full-stack (has vite.config.ts or server.ts).
+ * - If yes: starts Vite with @hono/vite-dev-server plugin — one process,
+ *   one port, frontend HMR + backend API routes together.
+ * - If no: spawns tsx watch for fast API-only development.
  */
 declare function runDev(options?: DevOptions): Promise<void>;
 

package/dist/dev.js

@@ -26,6 +26,7 @@ module.exports = __toCommonJS(dev_exports);
 var import_node_child_process = require("child_process");
 var import_node_path = require("path");
 var import_node_fs = require("fs");
+var import_core = require("@voltx/core");
 async function runDev(options = {}) {
   const cwd = process.cwd();
   const {
@@ -34,7 +35,7 @@ async function runDev(options = {}) {
     clearScreen = true
   } = options;
   if (!entry) {
-    console.error("[voltx] Could not find entry point. Expected src/index.ts or src/index.js");
+    console.error("[voltx] Could not find entry point. Expected server.ts or src/index.ts");
     process.exit(1);
   }
   const entryPath = (0, import_node_path.resolve)(cwd, entry);
@@ -42,56 +43,124 @@ async function runDev(options = {}) {
     console.error(`[voltx] Entry file not found: ${entry}`);
     process.exit(1);
   }
-  const envFile = (0, import_node_path.resolve)(cwd, ".env");
+  (0, import_core.loadEnv)("development", cwd);
+  const hasViteConfig = (0, import_node_fs.existsSync)((0, import_node_path.resolve)(cwd, "vite.config.ts"));
+  const hasServerEntry = (0, import_node_fs.existsSync)((0, import_node_path.resolve)(cwd, "server.ts"));
+  const isFullStack = hasViteConfig || hasServerEntry;
+  if (isFullStack) {
+    await startViteDevServer(cwd, port, entry, options);
+  } else {
+    await startTsxWatch(cwd, port, entry, options);
+  }
+}
+async function startViteDevServer(cwd, port, entry, options) {
+  const resolvedPort = port ?? (Number(process.env.PORT) || 3e3);
+  printDevBanner(entry, resolvedPort, true);
+  const userViteConfig = (0, import_node_path.resolve)(cwd, "vite.config.ts");
+  const hasUserViteConfig = (0, import_node_fs.existsSync)(userViteConfig);
+  let tempConfigPath = null;
+  if (!hasUserViteConfig) {
+    tempConfigPath = (0, import_node_path.resolve)(cwd, "vite.config.voltx.ts");
+    const viteConfigContent = generateViteConfig(entry, resolvedPort);
+    (0, import_node_fs.writeFileSync)(tempConfigPath, viteConfigContent, "utf-8");
+  }
   const env = {
     ...process.env,
     NODE_ENV: "development"
   };
-  if ((0, import_node_fs.existsSync)(envFile)) {
-    const envContent = (0, import_node_fs.readFileSync)(envFile, "utf-8");
-    for (const line of envContent.split("\n")) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const eqIdx = trimmed.indexOf("=");
-      if (eqIdx === -1) continue;
-      const key = trimmed.slice(0, eqIdx).trim();
-      const value = trimmed.slice(eqIdx + 1).trim();
-      env[key] = value;
+  if (port) {
+    env.PORT = String(port);
+  }
+  const viteBin = findBin(cwd, "vite");
+  const viteArgs = ["dev"];
+  if (tempConfigPath) {
+    viteArgs.push("--config", tempConfigPath);
+  }
+  viteArgs.push("--port", String(resolvedPort));
+  let child;
+  if (viteBin) {
+    child = (0, import_node_child_process.spawn)(viteBin, viteArgs, { cwd, env, stdio: "inherit" });
+  } else {
+    child = (0, import_node_child_process.spawn)("npx", ["vite", ...viteArgs], { cwd, env, stdio: "inherit" });
+  }
+  const cleanup = () => {
+    if (tempConfigPath && (0, import_node_fs.existsSync)(tempConfigPath)) {
+      try {
+        (0, import_node_fs.unlinkSync)(tempConfigPath);
+      } catch {
+      }
     }
+  };
+  const signals = ["SIGINT", "SIGTERM"];
+  for (const signal of signals) {
+    process.on(signal, () => {
+      cleanup();
+      child.kill(signal);
+    });
   }
+  child.on("error", (err) => {
+    cleanup();
+    if (err.code === "ENOENT") {
+      console.error("[voltx] vite not found. Install it with: npm install -D vite @hono/vite-dev-server");
+    } else {
+      console.error("[voltx] Dev server error:", err.message);
+    }
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    cleanup();
+    process.exit(code ?? 0);
+  });
+}
+function generateViteConfig(entry, port) {
+  return `// Auto-generated by VoltX \u2014 do not commit this file
+import { defineConfig } from "vite";
+import devServer from "@hono/vite-dev-server";
+
+export default defineConfig({
+  server: {
+    port: ${port},
+  },
+  plugins: [
+    devServer({
+      entry: "${entry}",
+      exclude: [
+        /.*\\.tsx?($|\\?)/,
+        /.*\\.(s?css|less)($|\\?)/,
+        /.*\\.(svg|png|jpg|jpeg|gif|webp|ico)($|\\?)/,
+        /^\\/@.+$/,
+        /^\\/favicon\\.svg$/,
+        /^\\/node_modules\\/.*/,
+        /^\\/src\\/.*/,
+      ],
+      injectClientScript: false,
+    }),
+  ],
+});
+`;
+}
+async function startTsxWatch(cwd, port, entry, options) {
+  const resolvedPort = port ?? (Number(process.env.PORT) || 3e3);
+  printDevBanner(entry, resolvedPort, false);
+  const env = {
+    ...process.env,
+    NODE_ENV: "development"
+  };
   if (port) {
     env.PORT = String(port);
   }
-  printDevBanner(entry, port);
   const tsxArgs = ["watch"];
-  if (clearScreen) {
+  if (options.clearScreen ?? true) {
     tsxArgs.push("--clear-screen=false");
   }
-  const watchDirs = [
-    "src/routes",
-    "src/agents",
-    "src/tools",
-    "src/jobs",
-    "src/lib",
-    "voltx.config.ts",
-    ...options.watch ?? []
-  ];
   tsxArgs.push("--ignore=node_modules", "--ignore=dist", "--ignore=.turbo");
   tsxArgs.push(entry);
-  const tsxBin = findTsxBin(cwd);
+  const tsxBin = findBin(cwd, "tsx");
   let child;
   if (tsxBin) {
-    child = (0, import_node_child_process.spawn)(tsxBin, tsxArgs, {
-      cwd,
-      env,
-      stdio: "inherit"
-    });
+    child = (0, import_node_child_process.spawn)(tsxBin, tsxArgs, { cwd, env, stdio: "inherit" });
   } else {
-    child = (0, import_node_child_process.spawn)("npx", ["tsx", ...tsxArgs], {
-      cwd,
-      env,
-      stdio: "inherit"
-    });
+    child = (0, import_node_child_process.spawn)("npx", ["tsx", ...tsxArgs], { cwd, env, stdio: "inherit" });
   }
   const signals = ["SIGINT", "SIGTERM"];
   for (const signal of signals) {
@@ -102,7 +171,6 @@ async function runDev(options = {}) {
   child.on("error", (err) => {
     if (err.code === "ENOENT") {
       console.error("[voltx] tsx not found. Install it with: npm install -D tsx");
-      console.error("[voltx] Or run your app directly: npx tsx watch src/index.ts");
     } else {
       console.error("[voltx] Dev server error:", err.message);
     }
@@ -114,6 +182,8 @@ async function runDev(options = {}) {
 }
 function findEntryPoint(cwd) {
   const candidates = [
+    "server.ts",
+    "server.js",
     "src/index.ts",
     "src/index.js",
     "src/index.mts",
@@ -129,24 +199,27 @@ function findEntryPoint(cwd) {
   }
   return null;
 }
-function findTsxBin(cwd) {
-  const localBin = (0, import_node_path.join)(cwd, "node_modules", ".bin", "tsx");
-  if ((0, import_node_fs.existsSync)(localBin)) return localBin;
-  const parentBin = (0, import_node_path.join)(cwd, "..", "node_modules", ".bin", "tsx");
-  if ((0, import_node_fs.existsSync)(parentBin)) return parentBin;
-  const rootBin = (0, import_node_path.join)(cwd, "..", "..", "node_modules", ".bin", "tsx");
-  if ((0, import_node_fs.existsSync)(rootBin)) return rootBin;
+function findBin(cwd, name) {
+  const paths = [
+    (0, import_node_path.join)(cwd, "node_modules", ".bin", name),
+    (0, import_node_path.join)(cwd, "..", "node_modules", ".bin", name),
+    (0, import_node_path.join)(cwd, "..", "..", "node_modules", ".bin", name)
+  ];
+  for (const p of paths) {
+    if ((0, import_node_fs.existsSync)(p)) return p;
+  }
   return null;
 }
-function printDevBanner(entry, port) {
+function printDevBanner(entry, port, fullStack) {
   console.log("");
   console.log("  \u26A1 VoltX Dev Server");
   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");
   console.log(`  Entry:   ${entry}`);
-  if (port) {
-    console.log(`  Port:    ${port}`);
+  console.log(`  Port:    ${port}`);
+  console.log(`  Mode:    ${fullStack ? "full-stack (Vite + Hono)" : "API-only (tsx watch)"}`);
+  if (fullStack) {
+    console.log(`  HMR:     enabled (frontend + backend)`);
   }
-  console.log(`  Mode:    development (hot reload)`);
   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");
   console.log("");
 }

package/dist/dev.mjs

@@ -1,7 +1,6 @@
 import {
   runDev
-} from "./chunk-QND74HUW.mjs";
-import "./chunk-Y6FXYEAI.mjs";
+} from "./chunk-AD3WMFZF.mjs";
 export {
   runDev
 };

package/dist/generate.js

@@ -49,13 +49,13 @@ async function runGenerate(options) {
 }
 function generateRoute(cwd, name, method = "POST") {
   const routePath = name.startsWith("/") ? name.slice(1) : name;
-  const filePath = (0, import_node_path.join)(cwd, "src", "routes", `${routePath}.ts`);
+  const filePath = (0, import_node_path.join)(cwd, "api", `${routePath}.ts`);
   if ((0, import_node_fs.existsSync)(filePath)) {
-    console.error(`[voltx] Route already exists: src/routes/${routePath}.ts`);
+    console.error(`[voltx] Route already exists: api/${routePath}.ts`);
     process.exit(1);
   }
   const upperMethod = method.toUpperCase();
-  const urlPath = "/" + routePath;
+  const urlPath = "/api/" + routePath;
   const content = `// ${upperMethod} ${urlPath}
 import type { Context } from "@voltx/server";
 
@@ -64,13 +64,13 @@ export async function ${upperMethod}(c: Context) {
 }
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created route: src/routes/${routePath}.ts`);
+  console.log(`  \u2713 Created route: api/${routePath}.ts`);
   console.log(`    ${upperMethod} ${urlPath}`);
 }
 function generateAgent(cwd, name) {
-  const filePath = (0, import_node_path.join)(cwd, "src", "agents", `${name}.ts`);
+  const filePath = (0, import_node_path.join)(cwd, "agents", `${name}.ts`);
   if ((0, import_node_fs.existsSync)(filePath)) {
-    console.error(`[voltx] Agent already exists: src/agents/${name}.ts`);
+    console.error(`[voltx] Agent already exists: agents/${name}.ts`);
     process.exit(1);
   }
   const content = `// Agent: ${name}
@@ -92,12 +92,12 @@ export const ${toCamelCase(name)} = createAgent({
 });
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created agent: src/agents/${name}.ts`);
+  console.log(`  \u2713 Created agent: agents/${name}.ts`);
 }
 function generateTool(cwd, name) {
-  const filePath = (0, import_node_path.join)(cwd, "src", "tools", `${name}.ts`);
+  const filePath = (0, import_node_path.join)(cwd, "tools", `${name}.ts`);
   if ((0, import_node_fs.existsSync)(filePath)) {
-    console.error(`[voltx] Tool already exists: src/tools/${name}.ts`);
+    console.error(`[voltx] Tool already exists: tools/${name}.ts`);
     process.exit(1);
   }
   const content = `// Tool: ${name}
@@ -119,12 +119,12 @@ export const ${toCamelCase(name)}Tool = {
 };
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created tool: src/tools/${name}.ts`);
+  console.log(`  \u2713 Created tool: tools/${name}.ts`);
 }
 function generateJob(cwd, name) {
-  const filePath = (0, import_node_path.join)(cwd, "src", "jobs", `${name}.ts`);
+  const filePath = (0, import_node_path.join)(cwd, "jobs", `${name}.ts`);
   if ((0, import_node_fs.existsSync)(filePath)) {
-    console.error(`[voltx] Job already exists: src/jobs/${name}.ts`);
+    console.error(`[voltx] Job already exists: jobs/${name}.ts`);
     process.exit(1);
   }
   const content = `// Job: ${name}
@@ -149,7 +149,7 @@ export async function run(ctx: any, data?: Record<string, unknown>) {
 }
 `;
   writeFileSafe(filePath, content);
-  console.log(`  \u2713 Created job: src/jobs/${name}.ts`);
+  console.log(`  \u2713 Created job: jobs/${name}.ts`);
 }
 function writeFileSafe(filePath, content) {
   const dir = (0, import_node_path.dirname)(filePath);

package/dist/generate.mjs

@@ -1,7 +1,6 @@
 import {
   runGenerate
-} from "./chunk-HAFJKS2O.mjs";
-import "./chunk-Y6FXYEAI.mjs";
+} from "./chunk-7JVIEGSA.mjs";
 export {
   runGenerate
 };