@buenojs/bueno 0.8.3 → 0.8.5

package/src/cli/commands/start.ts

@@ -4,17 +4,17 @@
  * Start the production server
  */
 
-import { defineCommand } from './index';
-import { getOption, hasFlag, type ParsedArgs } from '../core/args';
-import { cliConsole, colors } from '../core/console';
-import { spinner } from '../core/spinner';
+import { type ParsedArgs, getOption, hasFlag } from "../core/args";
+import { cliConsole, colors } from "../core/console";
+import { spinner } from "../core/spinner";
+import { CLIError, CLIErrorType } from "../index";
 import {
 	fileExists,
 	getProjectRoot,
 	isBuenoProject,
 	joinPaths,
-} from '../utils/fs';
-import { CLIError, CLIErrorType } from '../index';
+} from "../utils/fs";
+import { defineCommand } from "./index";
 
 /**
  * Find the entry point for the application
@@ -22,10 +22,10 @@ import { CLIError, CLIErrorType } from '../index';
 async function findEntryPoint(projectRoot: string): Promise<string | null> {
 	// Check for built files first
 	const possibleBuiltEntries = [
-		'dist/index.js',
-		'dist/main.js',
-		'dist/server.js',
-		'dist/app.js',
+		"dist/index.js",
+		"dist/main.js",
+		"dist/server.js",
+		"dist/app.js",
 	];
 
 	for (const entry of possibleBuiltEntries) {
@@ -37,13 +37,13 @@ async function findEntryPoint(projectRoot: string): Promise<string | null> {
 
 	// Fall back to source files
 	const possibleSourceEntries = [
-		'server/main.ts',
-		'src/main.ts',
-		'src/index.ts',
-		'main.ts',
-		'index.ts',
-		'server.ts',
-		'app.ts',
+		"server/main.ts",
+		"src/main.ts",
+		"src/index.ts",
+		"main.ts",
+		"index.ts",
+		"server.ts",
+		"app.ts",
 	];
 
 	for (const entry of possibleSourceEntries) {
@@ -61,49 +61,49 @@ async function findEntryPoint(projectRoot: string): Promise<string | null> {
  */
 async function handleStart(args: ParsedArgs): Promise<void> {
 	// Get options
-	const port = getOption(args, 'port', {
-		name: 'port',
-		alias: 'p',
-		type: 'number',
+	const port = getOption(args, "port", {
+		name: "port",
+		alias: "p",
+		type: "number",
 		default: 3000,
-		description: '',
+		description: "",
 	});
 
-	const host = getOption<string>(args, 'host', {
-		name: 'host',
-		alias: 'H',
-		type: 'string',
-		default: '0.0.0.0',
-		description: '',
+	const host = getOption<string>(args, "host", {
+		name: "host",
+		alias: "H",
+		type: "string",
+		default: "0.0.0.0",
+		description: "",
 	});
 
-	const workers = getOption(args, 'workers', {
-		name: 'workers',
-		alias: 'w',
-		type: 'string',
-		default: 'auto',
-		description: '',
+	const workers = getOption(args, "workers", {
+		name: "workers",
+		alias: "w",
+		type: "string",
+		default: "auto",
+		description: "",
 	});
 
-	const configPath = getOption<string>(args, 'config', {
-		name: 'config',
-		alias: 'c',
-		type: 'string',
-		description: '',
+	const configPath = getOption<string>(args, "config", {
+		name: "config",
+		alias: "c",
+		type: "string",
+		description: "",
 	});
 
 	// Check if in a Bueno project
 	const projectRoot = await getProjectRoot();
 	if (!projectRoot) {
 		throw new CLIError(
-			'Not in a project directory. Run this command from a Bueno project.',
+			"Not in a project directory. Run this command from a Bueno project.",
 			CLIErrorType.NOT_FOUND,
 		);
 	}
 
 	if (!(await isBuenoProject())) {
 		throw new CLIError(
-			'Not a Bueno project. Make sure you have a bueno.config.ts or bueno in your dependencies.',
+			"Not a Bueno project. Make sure you have a bueno.config.ts or bueno in your dependencies.",
 			CLIErrorType.NOT_FOUND,
 		);
 	}
@@ -112,22 +112,22 @@ async function handleStart(args: ParsedArgs): Promise<void> {
 	const entryPoint = await findEntryPoint(projectRoot);
 	if (!entryPoint) {
 		throw new CLIError(
-			'Could not find entry point. Make sure you have built the application or have a main.ts file.',
+			"Could not find entry point. Make sure you have built the application or have a main.ts file.",
 			CLIErrorType.FILE_NOT_FOUND,
 		);
 	}
 
 	// Display startup info
-	cliConsole.header('Starting Production Server');
-	cliConsole.log(`${colors.bold('Entry:')} ${entryPoint}`);
-	cliConsole.log(`${colors.bold('Port:')} ${port}`);
-	cliConsole.log(`${colors.bold('Host:')} ${host}`);
-	cliConsole.log(`${colors.bold('Workers:')} ${workers}`);
-	cliConsole.log('');
+	cliConsole.header("Starting Production Server");
+	cliConsole.log(`${colors.bold("Entry:")} ${entryPoint}`);
+	cliConsole.log(`${colors.bold("Port:")} ${port}`);
+	cliConsole.log(`${colors.bold("Host:")} ${host}`);
+	cliConsole.log(`${colors.bold("Workers:")} ${workers}`);
+	cliConsole.log("");
 
 	// Set environment variables
 	const env: Record<string, string> = {
-		NODE_ENV: 'production',
+		NODE_ENV: "production",
 		PORT: String(port),
 		HOST: host,
 	};
@@ -137,18 +137,20 @@ async function handleStart(args: ParsedArgs): Promise<void> {
 	}
 
 	// Start the server using Bun
-	const s = spinner('Starting production server...');
+	const s = spinner("Starting production server...");
 
 	try {
 		// Use Bun's spawn to run the production server
-		const proc = Bun.spawn(['bun', 'run', entryPoint], {
+		const proc = Bun.spawn(["bun", "run", entryPoint], {
 			cwd: projectRoot,
 			env: { ...process.env, ...env },
-			stdout: 'inherit',
-			stderr: 'inherit',
+			stdout: "inherit",
+			stderr: "inherit",
 		});
 
-		s.success(`Production server running at ${colors.cyan(`http://${host}:${port}`)}`);
+		s.success(
+			`Production server running at ${colors.cyan(`http://${host}:${port}`)}`,
+		);
 
 		// Wait for the process to exit
 		const exitCode = await proc.exited;
@@ -166,43 +168,43 @@ async function handleStart(args: ParsedArgs): Promise<void> {
 // Register the command
 defineCommand(
 	{
-		name: 'start',
-		description: 'Start the production server',
+		name: "start",
+		description: "Start the production server",
 		options: [
 			{
-				name: 'port',
-				alias: 'p',
-				type: 'number',
+				name: "port",
+				alias: "p",
+				type: "number",
 				default: 3000,
-				description: 'Server port',
+				description: "Server port",
 			},
 			{
-				name: 'host',
-				alias: 'H',
-				type: 'string',
-				default: '0.0.0.0',
-				description: 'Server hostname',
+				name: "host",
+				alias: "H",
+				type: "string",
+				default: "0.0.0.0",
+				description: "Server hostname",
 			},
 			{
-				name: 'workers',
-				alias: 'w',
-				type: 'string',
-				default: 'auto',
-				description: 'Number of worker threads',
+				name: "workers",
+				alias: "w",
+				type: "string",
+				default: "auto",
+				description: "Number of worker threads",
 			},
 			{
-				name: 'config',
-				alias: 'c',
-				type: 'string',
-				description: 'Path to config file',
+				name: "config",
+				alias: "c",
+				type: "string",
+				description: "Path to config file",
 			},
 		],
 		examples: [
-			'bueno start',
-			'bueno start --port 8080',
-			'bueno start --host 0.0.0.0',
-			'bueno start --workers 4',
+			"bueno start",
+			"bueno start --port 8080",
+			"bueno start --host 0.0.0.0",
+			"bueno start --workers 4",
 		],
 	},
 	handleStart,
-);
+);

package/src/cli/core/args.ts

@@ -15,7 +15,7 @@ export interface ParsedArgs {
 export interface OptionDefinition {
 	name: string;
 	alias?: string;
-	type: 'string' | 'boolean' | 'number';
+	type: "string" | "boolean" | "number";
 	default?: string | boolean | number;
 	description: string;
 }
@@ -32,11 +32,9 @@ export interface CommandDefinition {
 /**
  * Parse command line arguments
  */
-export function parseArgs(
-	argv: string[] = process.argv.slice(2),
-): ParsedArgs {
+export function parseArgs(argv: string[] = process.argv.slice(2)): ParsedArgs {
 	const result: ParsedArgs = {
-		command: '',
+		command: "",
 		positionals: [],
 		options: {},
 		flags: new Set(),
@@ -48,8 +46,8 @@ export function parseArgs(
 		if (!arg) continue;
 
 		// Long option: --option=value or --option value
-		if (arg.startsWith('--')) {
-			const eqIndex = arg.indexOf('=');
+		if (arg.startsWith("--")) {
+			const eqIndex = arg.indexOf("=");
 			if (eqIndex !== -1) {
 				// --option=value
 				const name = arg.slice(2, eqIndex);
@@ -61,7 +59,7 @@ export function parseArgs(
 				const nextArg = argv[i + 1];
 
 				// Check if it's a flag (no value or next arg starts with -)
-				if (!nextArg || nextArg.startsWith('-')) {
+				if (!nextArg || nextArg.startsWith("-")) {
 					result.options[name] = true;
 					result.flags.add(name);
 				} else {
@@ -71,7 +69,7 @@ export function parseArgs(
 			}
 		}
 		// Short option: -o value or -abc (multiple flags)
-		else if (arg.startsWith('-') && arg.length > 1) {
+		else if (arg.startsWith("-") && arg.length > 1) {
 			const chars = arg.slice(1);
 
 			// Check if it's a combined flag like -abc
@@ -86,7 +84,7 @@ export function parseArgs(
 				const name = chars;
 				const nextArg = argv[i + 1];
 
-				if (!nextArg || nextArg.startsWith('-')) {
+				if (!nextArg || nextArg.startsWith("-")) {
 					result.options[name] = true;
 					result.flags.add(name);
 				} else {
@@ -116,18 +114,24 @@ export function getOption<T extends string | boolean | number>(
 	name: string,
 	definition: OptionDefinition,
 ): T {
-	const value = parsed.options[name] ?? parsed.options[definition.alias ?? ''];
+	const value = parsed.options[name] ?? parsed.options[definition.alias ?? ""];
 
 	if (value === undefined) {
 		return definition.default as T;
 	}
 
-	if (definition.type === 'boolean') {
-		return (value === true || value === 'true') as T;
+	if (definition.type === "boolean") {
+		return (value === true || value === "true") as T;
 	}
 
-	if (definition.type === 'number') {
-		return (typeof value === 'number' ? value : typeof value === 'string' ? parseInt(value, 10) : NaN) as T;
+	if (definition.type === "number") {
+		return (
+			typeof value === "number"
+				? value
+				: typeof value === "string"
+					? Number.parseInt(value, 10)
+					: Number.NaN
+		) as T;
 	}
 
 	return value as T;
@@ -136,14 +140,22 @@ export function getOption<T extends string | boolean | number>(
 /**
  * Check if a flag is set
  */
-export function hasFlag(parsed: ParsedArgs, name: string, alias?: string): boolean {
+export function hasFlag(
+	parsed: ParsedArgs,
+	name: string,
+	alias?: string,
+): boolean {
 	return parsed.flags.has(name) || (alias ? parsed.flags.has(alias) : false);
 }
 
 /**
  * Check if an option is set (either as flag or with value)
  */
-export function hasOption(parsed: ParsedArgs, name: string, alias?: string): boolean {
+export function hasOption(
+	parsed: ParsedArgs,
+	name: string,
+	alias?: string,
+): boolean {
 	return name in parsed.options || (alias ? alias in parsed.options : false);
 }
 
@@ -151,18 +163,22 @@ export function hasOption(parsed: ParsedArgs, name: string, alias?: string): boo
  * Get all values for an option that can be specified multiple times
  * Parses raw argv to collect all occurrences of the option
  */
-export function getOptionValues(parsed: ParsedArgs, name: string, alias?: string): string[] {
+export function getOptionValues(
+	parsed: ParsedArgs,
+	name: string,
+	alias?: string,
+): string[] {
 	const values: string[] = [];
 	const argv = process.argv.slice(2);
-	
+
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
 		if (!arg) continue;
-		
+
 		// Long option: --name value or --name=value
 		if (arg === `--${name}`) {
 			const nextArg = argv[i + 1];
-			if (nextArg && !nextArg.startsWith('-')) {
+			if (nextArg && !nextArg.startsWith("-")) {
 				values.push(nextArg);
 				i++; // Skip next arg
 			}
@@ -173,13 +189,13 @@ export function getOptionValues(parsed: ParsedArgs, name: string, alias?: string
 		// Short option: -n value
 		else if (alias && arg === `-${alias}`) {
 			const nextArg = argv[i + 1];
-			if (nextArg && !nextArg.startsWith('-')) {
+			if (nextArg && !nextArg.startsWith("-")) {
 				values.push(nextArg);
 				i++; // Skip next arg
 			}
 		}
 	}
-	
+
 	return values;
 }
 
@@ -188,7 +204,7 @@ export function getOptionValues(parsed: ParsedArgs, name: string, alias?: string
  */
 export function generateHelpText(
 	command: CommandDefinition,
-	cliName = 'bueno',
+	cliName = "bueno",
 ): string {
 	const lines: string[] = [];
 
@@ -196,7 +212,7 @@ export function generateHelpText(
 	lines.push(`\n${command.description}\n`);
 
 	// Usage
-	lines.push('Usage:');
+	lines.push("Usage:");
 	let usage = `  ${cliName} ${command.name}`;
 
 	if (command.positionals) {
@@ -205,48 +221,48 @@ export function generateHelpText(
 		}
 	}
 
-	usage += ' [options]';
-	lines.push(usage + '\n');
+	usage += " [options]";
+	lines.push(usage + "\n");
 
 	// Positionals
 	if (command.positionals && command.positionals.length > 0) {
-		lines.push('Arguments:');
+		lines.push("Arguments:");
 		for (const pos of command.positionals) {
-			const required = pos.required ? ' (required)' : '';
+			const required = pos.required ? " (required)" : "";
 			lines.push(`  ${pos.name.padEnd(20)} ${pos.description}${required}`);
 		}
-		lines.push('');
+		lines.push("");
 	}
 
 	// Options
 	if (command.options && command.options.length > 0) {
-		lines.push('Options:');
+		lines.push("Options:");
 		for (const opt of command.options) {
 			let flag = `--${opt.name}`;
 			if (opt.alias) {
 				flag = `-${opt.alias}, ${flag}`;
 			}
 
-			let defaultValue = '';
+			let defaultValue = "";
 			if (opt.default !== undefined) {
 				defaultValue = ` (default: ${opt.default})`;
 			}
 
 			lines.push(`  ${flag.padEnd(20)} ${opt.description}${defaultValue}`);
 		}
-		lines.push('');
+		lines.push("");
 	}
 
 	// Examples
 	if (command.examples && command.examples.length > 0) {
-		lines.push('Examples:');
+		lines.push("Examples:");
 		for (const example of command.examples) {
 			lines.push(`  ${example}`);
 		}
-		lines.push('');
+		lines.push("");
 	}
 
-	return lines.join('\n');
+	return lines.join("\n");
 }
 
 /**
@@ -254,30 +270,32 @@ export function generateHelpText(
  */
 export function generateGlobalHelpText(
 	commands: CommandDefinition[],
-	cliName = 'bueno',
+	cliName = "bueno",
 ): string {
 	const lines: string[] = [];
 
 	lines.push(`\n${cliName} - A Bun-Native Full-Stack Framework CLI\n`);
-	lines.push('Usage:');
+	lines.push("Usage:");
 	lines.push(`  ${cliName} <command> [options]\n`);
 
-	lines.push('Commands:');
+	lines.push("Commands:");
 	for (const cmd of commands) {
 		const name = cmd.alias ? `${cmd.name} (${cmd.alias})` : cmd.name;
 		lines.push(`  ${name.padEnd(20)} ${cmd.description}`);
 	}
-	lines.push('');
+	lines.push("");
 
-	lines.push('Global Options:');
-	lines.push('  --help, -h          Show help for command');
-	lines.push('  --version, -v       Show CLI version');
-	lines.push('  --verbose           Enable verbose output');
-	lines.push('  --quiet             Suppress non-essential output');
-	lines.push('  --no-color          Disable colored output');
-	lines.push('');
+	lines.push("Global Options:");
+	lines.push("  --help, -h          Show help for command");
+	lines.push("  --version, -v       Show CLI version");
+	lines.push("  --verbose           Enable verbose output");
+	lines.push("  --quiet             Suppress non-essential output");
+	lines.push("  --no-color          Disable colored output");
+	lines.push("");
 
-	lines.push(`Run '${cliName} <command> --help' for more information about a command.\n`);
+	lines.push(
+		`Run '${cliName} <command> --help' for more information about a command.\n`,
+	);
 
-	return lines.join('\n');
-}
+	return lines.join("\n");
+}