@kyuujs/cli 0.1.0-alpha.0 → 0.1.0-alpha.1

package/src/project/scaffolder.ts

@@ -1,140 +0,0 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import type { ProjectCreationOptions } from "./options.js";
-import { getVersion } from "../version.js";
-
-/**
- * Scaffolds project files and directory structure based on ProjectCreationOptions.
- */
-export async function scaffoldProject(options: ProjectCreationOptions): Promise<void> {
-  const version = getVersion();
-  const kyuuDepVersion = `^${version}`;
-
-  mkdirSync(options.directory, { recursive: true });
-
-  if (options.language === "typescript") {
-    // 1. kyuu.config.ts
-    writeFile(
-      join(options.directory, "kyuu.config.ts"),
-      `import { defineConfig } from "@kyuujs/core";
-
-export default defineConfig({
-  server: {
-    port: 3000,
-    host: "127.0.0.1",
-  },
-});
-`,
-    );
-
-    // 2. package.json
-    const pkgContent = {
-      name: options.name,
-      version: "0.1.0",
-      private: true,
-      type: "module",
-      scripts: {
-        dev: "kyuu dev",
-        build: "kyuu build",
-        start: "kyuu start",
-      },
-      dependencies: {
-        "@kyuujs/core": kyuuDepVersion,
-      },
-      devDependencies: {
-        "@kyuujs/cli": kyuuDepVersion,
-        typescript: "^5.0.0",
-      },
-    };
-    writeFile(join(options.directory, "package.json"), JSON.stringify(pkgContent, null, 2) + "\n");
-
-    // 3. tsconfig.json
-    const tsconfigContent = {
-      compilerOptions: {
-        target: "ES2022",
-        module: "NodeNext",
-        moduleResolution: "NodeNext",
-        esModuleInterop: true,
-        strict: true,
-        skipLibCheck: true,
-        outDir: "dist",
-      },
-      include: ["src/**/*", "kyuu.config.ts"],
-    };
-    writeFile(
-      join(options.directory, "tsconfig.json"),
-      JSON.stringify(tsconfigContent, null, 2) + "\n",
-    );
-
-    // 4. src/app/route.ts
-    writeFile(
-      join(options.directory, "src", "app", "route.ts"),
-      `import type { Request, Response } from "@kyuujs/core";
-
-export const GET = async (_req: Request, res: Response) => {
-  return res.json({ message: "Hello from Kyuu!" });
-};
-`,
-    );
-  } else {
-    // JavaScript project scaffolding
-    // 1. kyuu.config.js
-    writeFile(
-      join(options.directory, "kyuu.config.js"),
-      `import { defineConfig } from "@kyuujs/core";
-
-export default defineConfig({
-  server: {
-    port: 3000,
-    host: "127.0.0.1",
-  },
-});
-`,
-    );
-
-    // 2. package.json
-    const pkgContent = {
-      name: options.name,
-      version: "0.1.0",
-      private: true,
-      type: "module",
-      scripts: {
-        dev: "kyuu dev",
-        start: "kyuu start",
-      },
-      dependencies: {
-        "@kyuujs/core": kyuuDepVersion,
-      },
-      devDependencies: {
-        "@kyuujs/cli": kyuuDepVersion,
-      },
-    };
-    writeFile(join(options.directory, "package.json"), JSON.stringify(pkgContent, null, 2) + "\n");
-
-    // 3. src/app/route.js
-    writeFile(
-      join(options.directory, "src", "app", "route.js"),
-      `export const GET = async (_req, res) => {
-  return res.json({ message: "Hello from Kyuu!" });
-};
-`,
-    );
-  }
-
-  // Common files
-  // .gitignore
-  writeFile(
-    join(options.directory, ".gitignore"),
-    `node_modules/
-dist/
-.kyuu/
-.env
-*.log
-`,
-  );
-}
-
-function writeFile(path: string, content: string): void {
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, content, "utf8");
-}

package/src/project/validation.ts

@@ -1,67 +0,0 @@
-import { existsSync, readdirSync } from "node:fs";
-import { isAbsolute, resolve } from "node:path";
-
-export interface ValidationResult {
-  valid: boolean;
-  error?: string;
-  targetDirectory?: string;
-}
-
-/**
- * Validates project name and resolves the target directory.
- */
-export function validateProjectName(name: string, cwd: string = process.cwd()): ValidationResult {
-  if (!name || name.trim().length === 0) {
-    return { valid: false, error: "Project name cannot be empty." };
-  }
-
-  const trimmed = name.trim();
-
-  // Prevent path traversal and relative navigation in project name
-  if (
-    trimmed.includes("/") ||
-    trimmed.includes("\\") ||
-    trimmed.includes("..") ||
-    isAbsolute(trimmed)
-  ) {
-    return {
-      valid: false,
-      error: `Invalid project name "${trimmed}". Path traversal and absolute paths are not allowed.`,
-    };
-  }
-
-  // Prevent invalid npm package / directory name characters
-  const validNameRegex = /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/i;
-  if (!validNameRegex.test(trimmed)) {
-    return {
-      valid: false,
-      error: `Invalid project name "${trimmed}". Must be a valid package/directory name.`,
-    };
-  }
-
-  const targetDirectory = resolve(cwd, trimmed);
-
-  if (existsSync(targetDirectory)) {
-    try {
-      const files = readdirSync(targetDirectory);
-      if (files.length > 0) {
-        return {
-          valid: false,
-          error: `Target directory already exists and is non-empty: ${targetDirectory}`,
-          targetDirectory,
-        };
-      }
-    } catch {
-      return {
-        valid: false,
-        error: `Target directory cannot be read: ${targetDirectory}`,
-        targetDirectory,
-      };
-    }
-  }
-
-  return {
-    valid: true,
-    targetDirectory,
-  };
-}

package/src/project/wizard.ts

@@ -1,89 +0,0 @@
-import { createInterface } from "node:readline/promises";
-import { stdin as input, stdout as output } from "node:process";
-import type { PackageManager, ProjectCreationOptions, ProjectLanguage } from "./options.js";
-
-export interface WizardOptions {
-  name: string;
-  directory: string;
-  defaults?: Partial<ProjectCreationOptions>;
-  interactive?: boolean;
-  input?: NodeJS.ReadableStream;
-  output?: NodeJS.WritableStream;
-}
-
-export class CancelledError extends Error {
-  constructor() {
-    super("Project creation cancelled by user.");
-    this.name = "CancelledError";
-  }
-}
-
-/**
- * Runs the interactive project creation wizard to resolve ProjectCreationOptions.
- */
-export async function runWizard(options: WizardOptions): Promise<ProjectCreationOptions> {
-  const isInteractive = options.interactive ?? Boolean(process.stdout.isTTY && !process.env.CI);
-
-  // If non-interactive, return options immediately using defaults
-  if (!isInteractive) {
-    return {
-      name: options.name,
-      directory: options.directory,
-      language: options.defaults?.language ?? "typescript",
-      packageManager: options.defaults?.packageManager ?? "pnpm",
-      initializeGit: options.defaults?.initializeGit ?? true,
-      skipInstall: options.defaults?.skipInstall ?? false,
-    };
-  }
-
-  const rl = createInterface({
-    input: options.input ?? input,
-    output: options.output ?? output,
-  });
-
-  let cancelled = false;
-  rl.on("SIGINT", () => {
-    cancelled = true;
-    rl.close();
-  });
-
-  try {
-    // Question 1: Language
-    const langAnswer = await rl.question(
-      "\nWhich language would you like to use?\n  1) TypeScript (default)\n  2) JavaScript\nSelect [1-2]: ",
-    );
-    if (cancelled) throw new CancelledError();
-    const language: ProjectLanguage = langAnswer.trim() === "2" ? "javascript" : "typescript";
-
-    // Question 2: Package Manager
-    const pmAnswer = await rl.question(
-      "\nWhich package manager would you like to use?\n  1) pnpm (default)\n  2) npm\n  3) yarn\nSelect [1-3]: ",
-    );
-    if (cancelled) throw new CancelledError();
-    let packageManager: PackageManager = "pnpm";
-    if (pmAnswer.trim() === "2") packageManager = "npm";
-    if (pmAnswer.trim() === "3") packageManager = "yarn";
-
-    // Question 3: Git
-    const gitAnswer = await rl.question("\nInitialize a Git repository? [Y/n]: ");
-    if (cancelled) throw new CancelledError();
-    const initializeGit = !gitAnswer.trim().toLowerCase().startsWith("n");
-
-    rl.close();
-
-    return {
-      name: options.name,
-      directory: options.directory,
-      language,
-      packageManager,
-      initializeGit,
-      skipInstall: options.defaults?.skipInstall ?? false,
-    };
-  } catch (err) {
-    rl.close();
-    if (cancelled || (err instanceof Error && err.name === "AbortError")) {
-      throw new CancelledError();
-    }
-    throw err;
-  }
-}

package/src/runner/app-runner.ts

@@ -1,61 +0,0 @@
-import { loadApplicationContext } from "@kyuujs/core";
-
-async function run(): Promise<void> {
-  const projectRoot =
-    process.env.KYUU_PROJECT_ROOT ?? process.env.KYUU_PROJECT_ROOT ?? process.cwd();
-
-  try {
-    const context = await loadApplicationContext({ projectRoot });
-    const server = context.app.listen();
-
-    if (!server.listening) {
-      await new Promise<void>((res, rej) => {
-        server.once("listening", res);
-        server.once("error", rej);
-      });
-    }
-
-    const address = server.address();
-    let port = context.config.server.port;
-    let host = context.config.server.host;
-    if (address && typeof address === "object") {
-      port = address.port;
-      host = address.address;
-    }
-
-    const url = `http://${host === "0.0.0.0" || host === "127.0.0.1" ? "localhost" : host}:${port}`;
-
-    if (process.send) {
-      process.send({ type: "started", port, host, url });
-    }
-
-    const cleanup = async () => {
-      try {
-        await context.app.close();
-      } catch {
-        // Ignore shutdown errors
-      }
-      process.exit(0);
-    };
-
-    process.on("SIGINT", cleanup);
-    process.on("SIGTERM", cleanup);
-    process.on("message", (msg) => {
-      if (msg === "shutdown") {
-        cleanup();
-      }
-    });
-  } catch (err: unknown) {
-    const errorMsg = err instanceof Error ? err.message : String(err);
-    if (process.send) {
-      process.send({
-        type: "error",
-        error: errorMsg,
-        stack: err instanceof Error ? err.stack : undefined,
-      });
-    }
-    process.exit(1);
-  }
-}
-
-run();

package/src/runner/dev-runner.ts

@@ -1,256 +0,0 @@
-import { fork, type ChildProcess } from "node:child_process";
-import { existsSync, watch as fsWatch, type FSWatcher } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-export interface DevServerOptions {
-  projectRoot: string;
-  watch?: boolean;
-  stdout?: (msg: string) => void;
-  stderr?: (msg: string) => void;
-}
-
-export interface DevServerController {
-  url?: string;
-  port?: number;
-  host?: string;
-  stop: () => Promise<void>;
-  restart: () => Promise<void>;
-}
-
-function getRunnerPathAndArgs(): { execPath: string; execArgs: string[] } {
-  const currentFile = fileURLToPath(import.meta.url);
-  const currentDir = dirname(currentFile);
-
-  const jsInSameDir = resolve(currentDir, "app-runner.js");
-  if (existsSync(jsInSameDir)) {
-    return { execPath: jsInSameDir, execArgs: ["--experimental-strip-types"] };
-  }
-
-  const jsInDist = resolve(currentDir, "..", "..", "dist", "runner", "app-runner.js");
-  if (existsSync(jsInDist)) {
-    return { execPath: jsInDist, execArgs: ["--experimental-strip-types"] };
-  }
-
-  const tsInSameDir = resolve(currentDir, "app-runner.ts");
-  if (existsSync(tsInSameDir)) {
-    return { execPath: tsInSameDir, execArgs: ["--experimental-strip-types"] };
-  }
-
-  return { execPath: jsInSameDir, execArgs: ["--experimental-strip-types"] };
-}
-
-export async function startDevServer(options: DevServerOptions): Promise<DevServerController> {
-  const writeOut = options.stdout ?? ((msg: string) => process.stdout.write(msg + "\n"));
-  const writeErr = options.stderr ?? ((msg: string) => process.stderr.write(msg + "\n"));
-  const shouldWatch = options.watch ?? true;
-  const projectRoot = resolve(options.projectRoot);
-
-  let currentChild: ChildProcess | null = null;
-  let watchers: FSWatcher[] = [];
-  let debounceTimer: NodeJS.Timeout | null = null;
-
-  let currentUrl: string | undefined;
-  let currentPort: number | undefined;
-  let currentHost: string | undefined;
-
-  const { execPath, execArgs } = getRunnerPathAndArgs();
-
-  const stopChild = async (): Promise<void> => {
-    if (!currentChild) return;
-    const child = currentChild;
-    currentChild = null;
-
-    if (child.exitCode !== null || child.killed) {
-      return;
-    }
-
-    await new Promise<void>((res) => {
-      const timer = setTimeout(() => {
-        try {
-          child.kill("SIGKILL");
-        } catch {
-          // Ignore kill error
-        }
-        res();
-      }, 2000);
-
-      child.once("exit", () => {
-        clearTimeout(timer);
-        res();
-      });
-
-      try {
-        if (child.connected) {
-          child.send("shutdown");
-        } else {
-          child.kill("SIGINT");
-        }
-      } catch {
-        child.kill("SIGINT");
-      }
-    });
-  };
-
-  const spawnChild = async (): Promise<boolean> => {
-    await stopChild();
-
-    return new Promise<boolean>((res) => {
-      const child = fork(execPath, [], {
-        execArgv: execArgs,
-        env: {
-          ...process.env,
-          KYUU_PROJECT_ROOT: projectRoot,
-          NODE_ENV: "development",
-        },
-        stdio: ["inherit", "pipe", "pipe", "ipc"],
-      });
-
-      currentChild = child;
-      let handled = false;
-
-      child.stdout?.on("data", (chunk: Buffer) => {
-        writeOut(chunk.toString("utf8").trimEnd());
-      });
-
-      child.stderr?.on("data", (chunk: Buffer) => {
-        writeErr(chunk.toString("utf8").trimEnd());
-      });
-
-      child.on("message", (msg: unknown) => {
-        if (typeof msg === "object" && msg !== null && "type" in msg) {
-          const payload = msg as {
-            type: string;
-            port?: number;
-            host?: string;
-            url?: string;
-            error?: string;
-          };
-          if (payload.type === "started") {
-            handled = true;
-            currentPort = payload.port;
-            currentHost = payload.host;
-            currentUrl = payload.url;
-
-            const banner = [
-              "Kyuu",
-              "",
-              "✓ Configuration loaded",
-              "✓ Routes loaded",
-              "✓ Server started",
-              "",
-              `Local: ${payload.url}`,
-            ].join("\n");
-            writeOut(banner);
-            res(true);
-          } else if (payload.type === "error") {
-            handled = true;
-            writeErr(`Unable to start Kyuu server.\n\n${payload.error}`);
-            res(false);
-          }
-        }
-      });
-
-      child.on("exit", (code) => {
-        if (!handled) {
-          handled = true;
-          if (code !== 0) {
-            writeErr(`Application process exited with code ${code}.`);
-          }
-          res(false);
-        }
-      });
-    });
-  };
-
-  const restart = async (): Promise<void> => {
-    writeOut("\nFile change detected. Restarting application...");
-    const success = await spawnChild();
-    if (!success) {
-      writeErr("\n✗ Failed to restart Kyuu application.\nWaiting for changes...");
-    }
-  };
-
-  // Initial spawn
-  await spawnChild();
-
-  // Watcher setup
-  if (shouldWatch) {
-    const handleFileChange = (_eventType: string, filename: string | null) => {
-      if (filename) {
-        const lower = filename.toLowerCase();
-        if (
-          lower.includes("node_modules") ||
-          lower.includes(".git") ||
-          lower.includes("dist") ||
-          lower.includes("coverage")
-        ) {
-          return;
-        }
-      }
-
-      if (debounceTimer) {
-        clearTimeout(debounceTimer);
-      }
-
-      debounceTimer = setTimeout(() => {
-        void restart();
-      }, 150);
-    };
-
-    try {
-      // Watch project root for kyuu.config changes
-      const rootWatcher = fsWatch(projectRoot, { recursive: false }, handleFileChange);
-      watchers.push(rootWatcher);
-
-      // Watch src directory for app route changes
-      const srcDir = join(projectRoot, "src");
-      if (existsSync(srcDir)) {
-        const srcWatcher = fsWatch(srcDir, { recursive: true }, handleFileChange);
-        watchers.push(srcWatcher);
-      }
-    } catch {
-      // Fallback if watching fails
-    }
-  }
-
-  const cleanupAll = async (): Promise<void> => {
-    if (debounceTimer) {
-      clearTimeout(debounceTimer);
-    }
-    for (const w of watchers) {
-      try {
-        w.close();
-      } catch {
-        // Ignore close error
-      }
-    }
-    watchers = [];
-    await stopChild();
-  };
-
-  // Signal handlers
-  const sigintHandler = () => {
-    void cleanupAll().then(() => process.exit(0));
-  };
-  process.once("SIGINT", sigintHandler);
-  process.once("SIGTERM", sigintHandler);
-
-  return {
-    get url() {
-      return currentUrl;
-    },
-    get port() {
-      return currentPort;
-    },
-    get host() {
-      return currentHost;
-    },
-    stop: async () => {
-      process.removeListener("SIGINT", sigintHandler);
-      process.removeListener("SIGTERM", sigintHandler);
-      await cleanupAll();
-    },
-    restart,
-  };
-}

package/src/version.ts

@@ -1,15 +0,0 @@
-import { readFileSync } from "node:fs";
-
-/**
- * Returns the authoritative version string from package.json.
- */
-export function getVersion(): string {
-  try {
-    const pkgUrl = new URL("../package.json", import.meta.url);
-    const pkgContent = readFileSync(pkgUrl, "utf8");
-    const pkg = JSON.parse(pkgContent) as { version?: string };
-    return pkg.version ?? "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src",
-    "outDir": "dist"
-  },
-  "include": ["src"],
-  "references": [{ "path": "../core" }]
-}