@voltx/cli 0.2.0 → 0.3.0

package/dist/dev.js

@@ -0,0 +1,144 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/dev.ts
+var dev_exports = {};
+__export(dev_exports, {
+  runDev: () => runDev
+});
+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");
+async function runDev(options = {}) {
+  const cwd = process.cwd();
+  const {
+    port,
+    entry = findEntryPoint(cwd),
+    clearScreen = true
+  } = options;
+  if (!entry) {
+    console.error("[voltx] Could not find entry point. Expected src/index.ts or src/index.js");
+    process.exit(1);
+  }
+  const entryPath = (0, import_node_path.resolve)(cwd, entry);
+  if (!(0, import_node_fs.existsSync)(entryPath)) {
+    console.error(`[voltx] Entry file not found: ${entry}`);
+    process.exit(1);
+  }
+  const envFile = (0, import_node_path.resolve)(cwd, ".env");
+  const env = {
+    ...process.env,
+    NODE_ENV: "development"
+  };
+  if (port) {
+    env.PORT = String(port);
+  }
+  printDevBanner(entry, port);
+  const tsxArgs = ["watch"];
+  if (clearScreen) {
+    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);
+  let child;
+  if (tsxBin) {
+    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"
+    });
+  }
+  const signals = ["SIGINT", "SIGTERM"];
+  for (const signal of signals) {
+    process.on(signal, () => {
+      child.kill(signal);
+    });
+  }
+  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);
+    }
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+}
+function findEntryPoint(cwd) {
+  const candidates = [
+    "src/index.ts",
+    "src/index.js",
+    "src/index.mts",
+    "src/main.ts",
+    "src/main.js",
+    "index.ts",
+    "index.js"
+  ];
+  for (const candidate of candidates) {
+    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, candidate))) {
+      return candidate;
+    }
+  }
+  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;
+  return null;
+}
+function printDevBanner(entry, port) {
+  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(`  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("");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runDev
+});

package/dist/dev.mjs

@@ -0,0 +1,7 @@
+import {
+  runDev
+} from "./chunk-RN7BUALR.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  runDev
+};

package/dist/generate.d.mts

@@ -0,0 +1,13 @@
+type GeneratorType = "route" | "agent" | "tool" | "job";
+interface GenerateOptions {
+    type: GeneratorType;
+    name: string;
+    /** HTTP method for routes (default: POST) */
+    method?: string;
+}
+/**
+ * Generate a new file from a template.
+ */
+declare function runGenerate(options: GenerateOptions): Promise<void>;
+
+export { type GenerateOptions, type GeneratorType, runGenerate };

package/dist/generate.d.ts

@@ -0,0 +1,13 @@
+type GeneratorType = "route" | "agent" | "tool" | "job";
+interface GenerateOptions {
+    type: GeneratorType;
+    name: string;
+    /** HTTP method for routes (default: POST) */
+    method?: string;
+}
+/**
+ * Generate a new file from a template.
+ */
+declare function runGenerate(options: GenerateOptions): Promise<void>;
+
+export { type GenerateOptions, type GeneratorType, runGenerate };

package/dist/generate.js

@@ -0,0 +1,165 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/generate.ts
+var generate_exports = {};
+__export(generate_exports, {
+  runGenerate: () => runGenerate
+});
+module.exports = __toCommonJS(generate_exports);
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+async function runGenerate(options) {
+  const cwd = process.cwd();
+  const { type, name } = options;
+  switch (type) {
+    case "route":
+      generateRoute(cwd, name, options.method);
+      break;
+    case "agent":
+      generateAgent(cwd, name);
+      break;
+    case "tool":
+      generateTool(cwd, name);
+      break;
+    case "job":
+      generateJob(cwd, name);
+      break;
+    default:
+      console.error(`[voltx] Unknown generator type: ${type}`);
+      console.error("[voltx] Available: route, agent, tool, job");
+      process.exit(1);
+  }
+}
+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`);
+  if ((0, import_node_fs.existsSync)(filePath)) {
+    console.error(`[voltx] Route already exists: src/routes/${routePath}.ts`);
+    process.exit(1);
+  }
+  const upperMethod = method.toUpperCase();
+  const urlPath = "/" + routePath;
+  const content = `// ${upperMethod} ${urlPath}
+import type { Context } from "@voltx/server";
+
+export async function ${upperMethod}(c: Context) {
+  return c.json({ message: "Hello from ${urlPath}" });
+}
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created route: src/routes/${routePath}.ts`);
+  console.log(`    ${upperMethod} ${urlPath}`);
+}
+function generateAgent(cwd, name) {
+  const filePath = (0, import_node_path.join)(cwd, "src", "agents", `${name}.ts`);
+  if ((0, import_node_fs.existsSync)(filePath)) {
+    console.error(`[voltx] Agent already exists: src/agents/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Agent: ${name}
+import { createAgent } from "@voltx/agents";
+
+export const ${toCamelCase(name)} = createAgent({
+  name: "${name}",
+  model: "cerebras:llama-4-scout-17b-16e",
+  instructions: "You are a helpful AI assistant named ${name}.",
+  tools: [
+    // Add tools here:
+    // {
+    //   name: "example",
+    //   description: "An example tool",
+    //   parameters: { type: "object", properties: { input: { type: "string" } }, required: ["input"] },
+    //   execute: async (params) => \`Processed: \${params.input}\`,
+    // },
+  ],
+});
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created agent: src/agents/${name}.ts`);
+}
+function generateTool(cwd, name) {
+  const filePath = (0, import_node_path.join)(cwd, "src", "tools", `${name}.ts`);
+  if ((0, import_node_fs.existsSync)(filePath)) {
+    console.error(`[voltx] Tool already exists: src/tools/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Tool: ${name}
+
+export const ${toCamelCase(name)}Tool = {
+  name: "${name}",
+  description: "TODO: Describe what this tool does",
+  parameters: {
+    type: "object" as const,
+    properties: {
+      input: { type: "string", description: "The input to process" },
+    },
+    required: ["input"],
+  },
+  execute: async (params: { input: string }): Promise<string> => {
+    // TODO: Implement tool logic
+    return \`${name} result for: \${params.input}\`;
+  },
+};
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created tool: src/tools/${name}.ts`);
+}
+function generateJob(cwd, name) {
+  const filePath = (0, import_node_path.join)(cwd, "src", "jobs", `${name}.ts`);
+  if ((0, import_node_fs.existsSync)(filePath)) {
+    console.error(`[voltx] Job already exists: src/jobs/${name}.ts`);
+    process.exit(1);
+  }
+  const content = `// Job: ${name}
+// Runs on a schedule or triggered via ctx.jobs.enqueue("${name}", data)
+
+export const config = {
+  // Cron schedule (uncomment to enable):
+  // schedule: "0 */6 * * *",  // every 6 hours
+  //
+  // Or make it a queue job (triggered on-demand):
+  queue: true,
+  retries: 3,
+  timeout: "5m",
+};
+
+export async function run(ctx: any, data?: Record<string, unknown>) {
+  console.log("[job:${name}] Running...", data);
+
+  // TODO: Implement job logic
+
+  console.log("[job:${name}] Done.");
+}
+`;
+  writeFileSafe(filePath, content);
+  console.log(`  \u2713 Created job: src/jobs/${name}.ts`);
+}
+function writeFileSafe(filePath, content) {
+  const dir = (0, import_node_path.dirname)(filePath);
+  (0, import_node_fs.mkdirSync)(dir, { recursive: true });
+  (0, import_node_fs.writeFileSync)(filePath, content, "utf-8");
+}
+function toCamelCase(str) {
+  return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase()).replace(/^(.)/, (_, c) => c.toLowerCase());
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runGenerate
+});

package/dist/generate.mjs

@@ -0,0 +1,7 @@
+import {
+  runGenerate
+} from "./chunk-AONHLE42.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  runGenerate
+};

package/dist/index.d.mts

@@ -1,5 +1,9 @@
 export { CreateProjectOptions, createProject } from './create.mjs';
+export { DevOptions, runDev } from './dev.mjs';
+export { BuildOptions, runBuild } from './build.mjs';
+export { StartOptions, runStart } from './start.mjs';
+export { GenerateOptions, GeneratorType, runGenerate } from './generate.mjs';
 
-declare const CLI_VERSION = "0.1.0";
+declare const CLI_VERSION = "0.2.0";
 
 export { CLI_VERSION };

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 export { CreateProjectOptions, createProject } from './create.js';
+export { DevOptions, runDev } from './dev.js';
+export { BuildOptions, runBuild } from './build.js';
+export { StartOptions, runStart } from './start.js';
+export { GenerateOptions, GeneratorType, runGenerate } from './generate.js';
 
-declare const CLI_VERSION = "0.1.0";
+declare const CLI_VERSION = "0.2.0";
 
 export { CLI_VERSION };