@veloxts/cli 0.2.0 → 0.2.2

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * VeloxTS CLI - Main entry point
+ *
+ * A beautiful, Laravel-inspired command-line interface for the VeloxTS Framework
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+/**
+ * VeloxTS CLI - Main entry point
+ *
+ * A beautiful, Laravel-inspired command-line interface for the VeloxTS Framework
+ */
+import { Command } from 'commander';
+import { createDevCommand } from './commands/dev.js';
+import { createMigrateCommand } from './commands/migrate.js';
+import { CLI_VERSION } from './index.js';
+/**
+ * Create the main CLI program
+ */
+function createCLI() {
+    const program = new Command();
+    program
+        .name('velox')
+        .description('VeloxTS Framework - Laravel-inspired TypeScript full-stack framework')
+        .version(CLI_VERSION, '-v, --version', 'Output the current version')
+        .helpOption('-h, --help', 'Display help for command');
+    // Register commands
+    program.addCommand(createDevCommand(CLI_VERSION));
+    program.addCommand(createMigrateCommand());
+    return program;
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    const program = createCLI();
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+        }
+        else {
+            console.error('An unknown error occurred');
+        }
+        process.exit(1);
+    }
+}
+// Run the CLI
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,SAAS,SAAS;IAChB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC;SACb,WAAW,CAAC,sEAAsE,CAAC;SACnF,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,4BAA4B,CAAC;SACnE,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;IAExD,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAE3C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,cAAc;AACd,IAAI,EAAE,CAAC"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Dev command - Start development server with hot reload
+ *
+ * Inspired by Laravel's `php artisan serve` and Vite's dev server
+ */
+import { Command } from 'commander';
+/**
+ * Create the dev command
+ */
+export declare function createDevCommand(version: string): Command;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CASzD"}

package/dist/commands/dev.js

@@ -0,0 +1,156 @@
+/**
+ * Dev command - Start development server with hot reload
+ *
+ * Inspired by Laravel's `php artisan serve` and Vite's dev server
+ */
+import { spawn } from 'node:child_process';
+import * as p from '@clack/prompts';
+import { Command } from 'commander';
+import pc from 'picocolors';
+import { error, formatCommand, formatPath, info, instruction, printBanner, } from '../utils/output.js';
+import { findEntryPoint, isVeloxProject, validateEntryPath } from '../utils/paths.js';
+/**
+ * Create the dev command
+ */
+export function createDevCommand(version) {
+    return new Command('dev')
+        .description('Start the development server with hot reload')
+        .option('-p, --port <port>', 'Port to listen on', '3210')
+        .option('-H, --host <host>', 'Host to bind to', 'localhost')
+        .option('-e, --entry <file>', 'Entry point file (auto-detected if not specified)')
+        .action(async (options) => {
+        await runDevServer(options, version);
+    });
+}
+/**
+ * Run the development server
+ */
+async function runDevServer(options, version) {
+    const s = p.spinner();
+    try {
+        // Check if we're in a VeloxTS project
+        s.start('Checking project...');
+        const isVelox = await isVeloxProject();
+        if (!isVelox) {
+            s.stop('Project check failed');
+            error('This does not appear to be a VeloxTS project.');
+            instruction(`Run ${formatCommand('npx create-velox-app')} to create a new project.`);
+            process.exit(1);
+        }
+        s.stop('Project validated');
+        // Find and validate entry point
+        let entryPoint;
+        if (options.entry) {
+            // User specified an entry point - validate it
+            s.start('Validating entry point...');
+            try {
+                entryPoint = validateEntryPath(options.entry);
+                s.stop(`Entry point: ${formatPath(entryPoint)}`);
+            }
+            catch (err) {
+                s.stop('Invalid entry point');
+                error(err instanceof Error ? err.message : 'Invalid entry point');
+                process.exit(1);
+            }
+        }
+        else {
+            // Auto-detect entry point
+            s.start('Detecting entry point...');
+            const detected = findEntryPoint();
+            if (!detected) {
+                s.stop('Entry point not found');
+                error('Could not find application entry point.');
+                instruction('Try specifying the entry point with --entry flag:');
+                console.log(`  ${formatCommand('velox dev --entry src/index.ts')}`);
+                process.exit(1);
+            }
+            entryPoint = detected;
+            s.stop(`Entry point: ${formatPath(entryPoint)}`);
+        }
+        // Validate port and host
+        const port = options.port || '3210';
+        const host = options.host || 'localhost';
+        // Validate port is a valid number
+        const portNum = Number.parseInt(port, 10);
+        if (Number.isNaN(portNum) || portNum < 1 || portNum > 65535) {
+            error(`Invalid port: ${port}. Port must be a number between 1 and 65535.`);
+            process.exit(1);
+        }
+        // Validate host doesn't contain dangerous characters
+        const validHostPattern = /^[a-zA-Z0-9.-]+$/;
+        if (!validHostPattern.test(host)) {
+            error(`Invalid host: ${host}. Host should only contain alphanumeric characters, dots, and dashes.`);
+            process.exit(1);
+        }
+        // Print startup banner
+        printBanner(version);
+        info('Starting development server...');
+        console.log('');
+        // Set environment variables for the app
+        const env = {
+            ...process.env,
+            PORT: port,
+            HOST: host,
+            NODE_ENV: 'development',
+        };
+        // Spawn tsx in watch mode
+        const devProcess = spawn('npx', ['tsx', 'watch', entryPoint], {
+            stdio: 'inherit',
+            env,
+            shell: true,
+        });
+        // Handle process termination
+        let isShuttingDown = false;
+        const shutdown = (signal) => {
+            if (isShuttingDown)
+                return;
+            isShuttingDown = true;
+            console.log(`\n\n${pc.yellow('⚠')} ${pc.dim(`Received ${signal}, shutting down gracefully...`)}`);
+            devProcess.kill('SIGTERM');
+            // Force kill after 5 seconds if process doesn't exit
+            const forceKillTimeout = setTimeout(() => {
+                console.log(pc.red('✗ Force killing process...'));
+                devProcess.kill('SIGKILL');
+                process.exit(1);
+            }, 5000);
+            devProcess.on('exit', () => {
+                clearTimeout(forceKillTimeout);
+                console.log(pc.dim('Development server stopped.'));
+                process.exit(0);
+            });
+        };
+        // Handle Ctrl+C and other termination signals
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        // Handle dev process errors
+        devProcess.on('error', (err) => {
+            error(`Failed to start development server: ${err.message}`);
+            process.exit(1);
+        });
+        devProcess.on('exit', (code) => {
+            if (!isShuttingDown && code !== 0) {
+                error(`Development server exited with code ${code}`);
+                process.exit(code || 1);
+            }
+        });
+    }
+    catch (err) {
+        s.stop('Failed to start development server');
+        if (err instanceof Error) {
+            error(err.message);
+            // Provide helpful suggestions based on error
+            if (err.message.includes('EADDRINUSE')) {
+                instruction(`Port ${options.port} is already in use. Try a different port:`);
+                console.log(`  ${formatCommand(`velox dev --port ${Number(options.port || 3210) + 1}`)}`);
+            }
+            else if (err.message.includes('EACCES')) {
+                instruction('Permission denied. Try using a port above 1024.');
+            }
+        }
+        else {
+            error('An unknown error occurred');
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"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"}

package/dist/commands/migrate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migrate command - Run database migrations
+ *
+ * Wrapper around Prisma migrations with beautiful Laravel-inspired output
+ */
+import { Command } from 'commander';
+/**
+ * Create the migrate command
+ */
+export declare function createMigrateCommand(): Command;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAQ9C"}

package/dist/commands/migrate.js

@@ -0,0 +1,132 @@
+/**
+ * Migrate command - Run database migrations
+ *
+ * Wrapper around Prisma migrations with beautiful Laravel-inspired output
+ */
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import * as p from '@clack/prompts';
+import { Command } from 'commander';
+import pc from 'picocolors';
+import { error, formatCommand, info, instruction, success } from '../utils/output.js';
+import { fileExists } from '../utils/paths.js';
+/**
+ * Create the migrate command
+ */
+export function createMigrateCommand() {
+    return new Command('migrate')
+        .description('Run database migrations')
+        .option('--deploy', 'Run migrations in production mode (prisma migrate deploy)')
+        .option('--force', 'Force push schema without migration (development only)')
+        .action(async (options) => {
+        await runMigrations(options);
+    });
+}
+/**
+ * Run database migrations
+ */
+async function runMigrations(options) {
+    const s = p.spinner();
+    try {
+        // Check if Prisma schema exists
+        const schemaPath = path.join(process.cwd(), 'prisma', 'schema.prisma');
+        if (!fileExists(schemaPath)) {
+            error('Prisma schema not found.');
+            instruction('Expected to find prisma/schema.prisma in the current directory.');
+            instruction(`Initialize Prisma with: ${formatCommand('npx prisma init')}`);
+            process.exit(1);
+        }
+        // Determine which command to run
+        let command;
+        let description;
+        if (options.deploy) {
+            // Production: Apply pending migrations
+            command = ['prisma', 'migrate', 'deploy'];
+            description = 'Applying production migrations';
+        }
+        else if (options.force) {
+            // Development: Force push schema
+            command = ['prisma', 'db', 'push', '--skip-generate'];
+            description = 'Pushing database schema (development mode)';
+        }
+        else {
+            // Development: Push with generate
+            command = ['prisma', 'db', 'push'];
+            description = 'Synchronizing database schema';
+        }
+        info(description);
+        console.log('');
+        s.start('Running Prisma...');
+        // Run the Prisma command
+        await new Promise((resolve, reject) => {
+            const prismaProcess = spawn('npx', command, {
+                stdio: 'inherit',
+                shell: true,
+                env: process.env,
+            });
+            prismaProcess.on('error', (err) => {
+                reject(new Error(`Failed to run Prisma: ${err.message}`));
+            });
+            prismaProcess.on('exit', (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Prisma exited with code ${code}`));
+                }
+            });
+        });
+        s.stop('Migration completed');
+        console.log('');
+        success('Database schema synchronized successfully!');
+        // Show next steps for production migrations
+        if (options.deploy) {
+            instruction('Your database is now up to date with the latest migrations.');
+        }
+        else {
+            console.log('');
+            info('Development tips:');
+            console.log(`  ${pc.dim('•')} Use ${formatCommand('velox migrate')} to sync schema changes during development`);
+            console.log(`  ${pc.dim('•')} Use ${formatCommand('velox migrate --deploy')} in production to apply migrations`);
+            console.log(`  ${pc.dim('•')} Use ${formatCommand('npx prisma studio')} to explore your database`);
+            console.log('');
+        }
+    }
+    catch (err) {
+        s.stop('Migration failed');
+        console.log('');
+        if (err instanceof Error) {
+            error(err.message);
+            // Provide helpful suggestions based on error
+            if (err.message.includes('P1001')) {
+                instruction('Cannot reach database server. Check your connection:');
+                console.log(`  ${pc.dim('1.')} Verify DATABASE_URL in .env file`);
+                console.log(`  ${pc.dim('2.')} Ensure database server is running`);
+                console.log(`  ${pc.dim('3.')} Check network connectivity`);
+            }
+            else if (err.message.includes('P3009')) {
+                instruction('Migration failed. Your changes may conflict with existing data.');
+                console.log(`  ${pc.dim('•')} Review the Prisma error above`);
+                console.log(`  ${pc.dim('•')} Consider creating a manual migration`);
+            }
+            else if (err.message.includes('P1003')) {
+                instruction('Database does not exist. Create it first:');
+                console.log(`  ${pc.dim('•')} Check your DATABASE_URL`);
+                console.log(`  ${pc.dim('•')} Create the database manually if needed`);
+            }
+            else {
+                instruction('Common solutions:');
+                console.log(`  ${pc.dim('1.')} Check your DATABASE_URL in .env`);
+                console.log(`  ${pc.dim('2.')} Ensure Prisma schema is valid: ${formatCommand('npx prisma validate')}`);
+                console.log(`  ${pc.dim('3.')} Review Prisma logs above for specific errors`);
+            }
+            console.log('');
+            instruction(`For more help, see: ${pc.cyan('https://www.prisma.io/docs/reference/api-reference/command-reference')}`);
+        }
+        else {
+            error('An unknown error occurred');
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @veloxts/cli - Developer tooling and command-line interface
+ *
+ * A beautiful, Laravel-inspired CLI for the VeloxTS Framework that provides
+ * commands for development, database migrations, and other developer workflows.
+ *
+ * @example
+ * ```bash
+ * # Start development server
+ * velox dev
+ *
+ * # Run database migrations
+ * velox migrate
+ *
+ * # Show help
+ * velox --help
+ * ```
+ */
+/**
+ * CLI version (synchronized with package.json)
+ */
+export declare const CLI_VERSION = "0.1.0";
+/**
+ * Export command functions for programmatic usage
+ */
+export { createDevCommand } from './commands/dev.js';
+export { createMigrateCommand } from './commands/migrate.js';
+/**
+ * Export utilities for reuse in other packages
+ */
+export * from './utils/output.js';
+export * from './utils/paths.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D;;GAEG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * @veloxts/cli - Developer tooling and command-line interface
+ *
+ * A beautiful, Laravel-inspired CLI for the VeloxTS Framework that provides
+ * commands for development, database migrations, and other developer workflows.
+ *
+ * @example
+ * ```bash
+ * # Start development server
+ * velox dev
+ *
+ * # Run database migrations
+ * velox migrate
+ *
+ * # Show help
+ * velox --help
+ * ```
+ */
+/**
+ * CLI version (synchronized with package.json)
+ */
+export const CLI_VERSION = '0.1.0';
+/**
+ * Export command functions for programmatic usage
+ */
+export { createDevCommand } from './commands/dev.js';
+export { createMigrateCommand } from './commands/migrate.js';
+/**
+ * Export utilities for reuse in other packages
+ */
+export * from './utils/output.js';
+export * from './utils/paths.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D;;GAEG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Terminal output utilities
+ *
+ * Provides beautiful, Laravel-inspired terminal output formatting
+ */
+/**
+ * Print a beautiful VeloxTS banner
+ */
+export declare function printBanner(version: string): void;
+/**
+ * Print server listening information
+ */
+export declare function printServerInfo(url: string): void;
+/**
+ * Print a success message
+ */
+export declare function success(message: string): void;
+/**
+ * Print an error message
+ */
+export declare function error(message: string): void;
+/**
+ * Print a warning message
+ */
+export declare function warning(message: string): void;
+/**
+ * Print an info message
+ */
+export declare function info(message: string): void;
+/**
+ * Print a step in a process
+ */
+export declare function step(message: string): void;
+/**
+ * Print instructions for user
+ */
+export declare function instruction(message: string): void;
+/**
+ * Format a file path for display
+ */
+export declare function formatPath(path: string): string;
+/**
+ * Format a command for display
+ */
+export declare function formatCommand(command: string): string;
+/**
+ * Format a URL for display
+ */
+export declare function formatUrl(url: string): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/utils/output.js

@@ -0,0 +1,78 @@
+/**
+ * Terminal output utilities
+ *
+ * Provides beautiful, Laravel-inspired terminal output formatting
+ */
+import pc from 'picocolors';
+/**
+ * Print a beautiful VeloxTS banner
+ */
+export function printBanner(version) {
+    const divider = '═'.repeat(50);
+    console.log(`\n${pc.cyan(divider)}`);
+    console.log(pc.cyan(`  VELOX ${pc.bold(`v${version}`)}`));
+    console.log(pc.cyan(divider));
+}
+/**
+ * Print server listening information
+ */
+export function printServerInfo(url) {
+    console.log('');
+    console.log(`  ${pc.green('➜')}  Local:   ${pc.cyan(url)}`);
+    console.log('');
+}
+/**
+ * Print a success message
+ */
+export function success(message) {
+    console.log(`${pc.green('✓')} ${message}`);
+}
+/**
+ * Print an error message
+ */
+export function error(message) {
+    console.error(`${pc.red('✗')} ${pc.red(message)}`);
+}
+/**
+ * Print a warning message
+ */
+export function warning(message) {
+    console.warn(`${pc.yellow('⚠')} ${pc.yellow(message)}`);
+}
+/**
+ * Print an info message
+ */
+export function info(message) {
+    console.log(`${pc.blue('ℹ')} ${message}`);
+}
+/**
+ * Print a step in a process
+ */
+export function step(message) {
+    console.log(`  ${pc.dim('→')} ${message}`);
+}
+/**
+ * Print instructions for user
+ */
+export function instruction(message) {
+    console.log(`\n  ${pc.dim(message)}\n`);
+}
+/**
+ * Format a file path for display
+ */
+export function formatPath(path) {
+    return pc.cyan(path);
+}
+/**
+ * Format a command for display
+ */
+export function formatCommand(command) {
+    return pc.cyan(command);
+}
+/**
+ * Format a URL for display
+ */
+export function formatUrl(url) {
+    return pc.cyan(url);
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Path utilities for finding project files
+ */
+/**
+ * Find the project entry point
+ * Looks for common entry points in order of preference
+ */
+export declare function findEntryPoint(cwd?: string): string | null;
+/**
+ * Check if a file exists at the given path
+ */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Get the absolute path from a relative path
+ */
+export declare function getAbsolutePath(relativePath: string, cwd?: string): string;
+/**
+ * Validate that a path is safe for use in shell commands
+ *
+ * This prevents command injection attacks by ensuring:
+ * 1. Path is within the current working directory (no path traversal)
+ * 2. Path doesn't contain shell metacharacters
+ * 3. File exists and is a TypeScript/JavaScript file
+ *
+ * @param filePath - The path to validate
+ * @param cwd - The current working directory
+ * @returns The normalized, validated path
+ * @throws Error if the path is invalid or unsafe
+ */
+export declare function validateEntryPath(filePath: string, cwd?: string): string;
+/**
+ * Check if we're in a VeloxTS project
+ * Looks for package.json with @veloxts dependencies
+ */
+export declare function isVeloxProject(cwd?: string): Promise<boolean>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAWzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAuCvF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBlF"}

package/dist/utils/paths.js

@@ -0,0 +1,95 @@
+/**
+ * Path utilities for finding project files
+ */
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Find the project entry point
+ * Looks for common entry points in order of preference
+ */
+export function findEntryPoint(cwd = process.cwd()) {
+    const candidates = ['src/index.ts', 'src/main.ts', 'src/app.ts', 'index.ts', 'main.ts'];
+    for (const candidate of candidates) {
+        const fullPath = path.join(cwd, candidate);
+        if (existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return null;
+}
+/**
+ * Check if a file exists at the given path
+ */
+export function fileExists(filePath) {
+    return existsSync(filePath);
+}
+/**
+ * Get the absolute path from a relative path
+ */
+export function getAbsolutePath(relativePath, cwd = process.cwd()) {
+    return path.isAbsolute(relativePath) ? relativePath : path.join(cwd, relativePath);
+}
+/**
+ * Validate that a path is safe for use in shell commands
+ *
+ * This prevents command injection attacks by ensuring:
+ * 1. Path is within the current working directory (no path traversal)
+ * 2. Path doesn't contain shell metacharacters
+ * 3. File exists and is a TypeScript/JavaScript file
+ *
+ * @param filePath - The path to validate
+ * @param cwd - The current working directory
+ * @returns The normalized, validated path
+ * @throws Error if the path is invalid or unsafe
+ */
+export function validateEntryPath(filePath, cwd = process.cwd()) {
+    // Normalize the path to resolve any .. or . segments
+    const absolutePath = path.isAbsolute(filePath)
+        ? path.normalize(filePath)
+        : path.normalize(path.join(cwd, filePath));
+    // Ensure the path is within the current working directory
+    const normalizedCwd = path.normalize(cwd);
+    if (!absolutePath.startsWith(normalizedCwd)) {
+        throw new Error(`Entry path must be within the project directory. ` +
+            `Got: ${filePath}, which resolves to: ${absolutePath}`);
+    }
+    // Check for dangerous shell characters that could enable command injection
+    const dangerousChars = /[;&|`$(){}[\]<>!#*?\\'"\n\r\t]/;
+    if (dangerousChars.test(filePath)) {
+        throw new Error(`Entry path contains invalid characters. ` +
+            `Path should only contain alphanumeric characters, slashes, dots, and dashes.`);
+    }
+    // Verify the file exists
+    if (!existsSync(absolutePath)) {
+        throw new Error(`Entry point file not found: ${absolutePath}`);
+    }
+    // Verify it's a TypeScript or JavaScript file
+    const ext = path.extname(absolutePath).toLowerCase();
+    const validExtensions = ['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs', '.cts', '.cjs'];
+    if (!validExtensions.includes(ext)) {
+        throw new Error(`Entry point must be a TypeScript or JavaScript file. Got: ${ext || 'no extension'}`);
+    }
+    return absolutePath;
+}
+/**
+ * Check if we're in a VeloxTS project
+ * Looks for package.json with @veloxts dependencies
+ */
+export async function isVeloxProject(cwd = process.cwd()) {
+    const packageJsonPath = path.join(cwd, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return false;
+    }
+    try {
+        const fs = await import('node:fs/promises');
+        const content = await fs.readFile(packageJsonPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        // Check if any @veloxts packages are in dependencies
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        return Object.keys(deps).some((dep) => dep.startsWith('@veloxts/'));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Developer tooling and CLI commands for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -23,11 +23,11 @@
     "@clack/prompts": "0.11.0",
     "picocolors": "1.1.1",
     "tsx": "4.21.0",
-    "@veloxts/core": "0.2.0",
-    "@veloxts/router": "0.2.0",
-    "@veloxts/validation": "0.2.0",
-    "@veloxts/orm": "0.2.0",
-    "@veloxts/auth": "0.2.0"
+    "@veloxts/core": "0.2.2",
+    "@veloxts/router": "0.2.2",
+    "@veloxts/validation": "0.2.2",
+    "@veloxts/orm": "0.2.2",
+    "@veloxts/auth": "0.2.2"
   },
   "devDependencies": {
     "@types/node": "24.10.1",