voltjs-framework 1.0.0

package/src/cli/create.js

@@ -0,0 +1,371 @@
+/**
+ * VoltJS CLI — `volt create <project-name>`
+ * Scaffolds a new VoltJS project.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const c = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m', cyan: '\x1b[36m',
+};
+
+module.exports = function create(args) {
+  const projectName = args[0];
+  if (!projectName) {
+    console.error(`${c.red}Error: Please specify a project name.${c.reset}`);
+    console.log(`  ${c.cyan}volt create my-app${c.reset}`);
+    process.exit(1);
+  }
+
+  const projectDir = path.resolve(process.cwd(), projectName);
+
+  if (fs.existsSync(projectDir)) {
+    console.error(`${c.red}Error: Directory "${projectName}" already exists.${c.reset}`);
+    process.exit(1);
+  }
+
+  console.log(`\n${c.cyan}${c.bold}⚡ Creating VoltJS project: ${projectName}${c.reset}\n`);
+
+  // Create directory structure
+  const dirs = [
+    '',
+    'pages',
+    'api',
+    'components',
+    'public',
+    'public/css',
+    'public/js',
+    'public/images',
+    'views',
+    'views/layouts',
+    'views/partials',
+    'models',
+    'middleware',
+    'config',
+    'database',
+    'database/migrations',
+    'database/seeders',
+    'storage',
+    'tests',
+    'logs',
+  ];
+
+  for (const dir of dirs) {
+    const fullPath = path.join(projectDir, dir);
+    fs.mkdirSync(fullPath, { recursive: true });
+    console.log(`  ${c.green}✓${c.reset} ${c.dim}${dir || projectName}/${c.reset}`);
+  }
+
+  // Create files
+  const files = {
+    'package.json': JSON.stringify({
+      name: projectName,
+      version: '1.0.0',
+      private: true,
+      scripts: {
+        dev: 'volt dev',
+        start: 'volt start',
+        build: 'volt build',
+        test: 'volt test',
+        'db:migrate': 'volt db:migrate',
+        'db:seed': 'volt db:seed',
+      },
+      dependencies: {
+        voltjs: '^1.0.0',
+      },
+    }, null, 2),
+
+    'app.js': `const { Volt } = require('voltjs');
+
+const app = new Volt();
+
+// Your routes
+app.get('/', (req, res) => {
+  res.render('index', {
+    title: '${projectName}',
+    message: 'Welcome to VoltJS! ⚡',
+  });
+});
+
+// API example
+app.get('/api/hello', (req, res) => {
+  res.json({ message: 'Hello from VoltJS API!', time: new Date().toISOString() });
+});
+
+// Start the server
+app.listen(3000, () => {
+  console.log('⚡ Server running at http://localhost:3000');
+});
+`,
+
+    'volt.config.js': `module.exports = {
+  // Server
+  port: process.env.PORT || 3000,
+
+  // Security (all enabled by default)
+  security: {
+    csrf: true,
+    cors: { origin: '*' },
+    rateLimit: { windowMs: 15 * 60 * 1000, max: 100 },
+    helmet: true,
+  },
+
+  // Views
+  views: {
+    dir: './views',
+    engine: 'volt',
+  },
+
+  // Database
+  database: {
+    driver: 'memory',  // 'memory', 'sqlite', 'mysql', 'postgres'
+    // host: 'localhost',
+    // port: 3306,
+    // database: '${projectName}',
+    // user: 'root',
+    // password: '',
+  },
+
+  // Mail
+  mail: {
+    host: process.env.MAIL_HOST || 'smtp.example.com',
+    port: process.env.MAIL_PORT || 587,
+    secure: false,
+    user: process.env.MAIL_USER || '',
+    pass: process.env.MAIL_PASS || '',
+    from: '${projectName} <noreply@example.com>',
+  },
+
+  // Logging
+  logging: {
+    level: process.env.NODE_ENV === 'production' ? 'info' : 'debug',
+    file: './logs/app.log',
+  },
+};
+`,
+
+    '.env': `# Environment
+NODE_ENV=development
+PORT=3000
+
+# Database
+DB_DRIVER=memory
+# DB_HOST=localhost
+# DB_PORT=3306
+# DB_DATABASE=${projectName}
+# DB_USER=root
+# DB_PASSWORD=
+
+# Mail
+# MAIL_HOST=smtp.example.com
+# MAIL_PORT=587
+# MAIL_USER=
+# MAIL_PASS=
+
+# Security
+APP_SECRET=${require('crypto').randomBytes(32).toString('hex')}
+`,
+
+    '.env.example': `# Environment
+NODE_ENV=development
+PORT=3000
+
+# Database
+DB_DRIVER=memory
+DB_HOST=localhost
+DB_PORT=3306
+DB_DATABASE=myapp
+DB_USER=root
+DB_PASSWORD=
+
+# Mail
+MAIL_HOST=smtp.example.com
+MAIL_PORT=587
+MAIL_USER=
+MAIL_PASS=
+
+# Security
+APP_SECRET=your-secret-key-here
+`,
+
+    '.gitignore': `node_modules/
+.env
+logs/
+storage/
+dist/
+*.log
+.DS_Store
+Thumbs.db
+`,
+
+    'views/layouts/main.volt': `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ title }} | ${projectName}</title>
+    <link rel="stylesheet" href="/css/app.css">
+</head>
+<body>
+    {> header}
+    <main>
+        {#slot content}
+    </main>
+    {> footer}
+    <script src="/js/app.js"></script>
+</body>
+</html>
+`,
+
+    'views/partials/header.volt': `<header style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 1rem 2rem;">
+  <nav style="display: flex; justify-content: space-between; align-items: center; max-width: 1200px; margin: 0 auto;">
+    <a href="/" style="color: white; text-decoration: none; font-size: 1.5rem; font-weight: bold;">⚡ ${projectName}</a>
+    <div>
+      <a href="/" style="color: white; text-decoration: none; margin-left: 1.5rem;">Home</a>
+      <a href="/api/hello" style="color: white; text-decoration: none; margin-left: 1.5rem;">API</a>
+    </div>
+  </nav>
+</header>
+`,
+
+    'views/partials/footer.volt': `<footer style="text-align: center; padding: 2rem; color: #666; border-top: 1px solid #eee; margin-top: 2rem;">
+  <p>Built with ⚡ <a href="https://github.com/voltjs" style="color: #667eea;">VoltJS</a></p>
+</footer>
+`,
+
+    'views/index.volt': `{#layout layouts/main}
+
+{#block content}
+<div style="text-align: center; padding: 4rem 2rem; max-width: 800px; margin: 0 auto;">
+  <h1 style="font-size: 3rem; margin-bottom: 0.5rem;">⚡ {{ title }}</h1>
+  <p style="font-size: 1.3rem; color: #666;">{{ message }}</p>
+  
+  <div style="margin-top: 3rem; display: grid; grid-template-columns: repeat(auto-fit, minmax(250px, 1fr)); gap: 1.5rem; text-align: left;">
+    <div style="padding: 1.5rem; border-radius: 8px; border: 1px solid #e2e8f0;">
+      <h3>🔒 Security First</h3>
+      <p style="color: #666;">CSRF, XSS, CORS, rate limiting, and helmet — all enabled by default.</p>
+    </div>
+    <div style="padding: 1.5rem; border-radius: 8px; border: 1px solid #e2e8f0;">
+      <h3>📦 Batteries Included</h3>
+      <p style="color: #666;">Email, SMS, PDF, Excel, caching, queues, cron — ready to use.</p>
+    </div>
+    <div style="padding: 1.5rem; border-radius: 8px; border: 1px solid #e2e8f0;">
+      <h3>🚀 Zero Config</h3>
+      <p style="color: #666;">Just 2 files to start. Everything works out of the box.</p>
+    </div>
+  </div>
+</div>
+{/block}
+`,
+
+    'public/css/app.css': `/* VoltJS Default Styles */
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+  line-height: 1.6;
+  color: #333;
+  min-height: 100vh;
+}
+
+a { color: #667eea; text-decoration: none; }
+a:hover { text-decoration: underline; }
+
+code {
+  background: #f4f4f5;
+  padding: 0.2em 0.4em;
+  border-radius: 4px;
+  font-size: 0.9em;
+}
+`,
+
+    'public/js/app.js': `// VoltJS Client-Side JavaScript
+console.log('⚡ VoltJS loaded');
+`,
+
+    'tests/app.test.js': `/**
+ * Basic tests for your VoltJS app
+ * Run: volt test
+ */
+
+const assert = require('assert');
+
+describe('App', () => {
+  it('should load without errors', () => {
+    assert.ok(true);
+  });
+});
+`,
+
+    'README.md': `# ${projectName}
+
+Built with ⚡ [VoltJS](https://github.com/voltjs) — the batteries-included, security-first JavaScript framework.
+
+## Quick Start
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+## Available Commands
+
+| Command | Description |
+|---------|-------------|
+| \`npm run dev\` | Start development server with hot reload |
+| \`npm start\` | Start production server |
+| \`npm run build\` | Build for production |
+| \`npm test\` | Run tests |
+| \`npm run db:migrate\` | Run database migrations |
+| \`npm run db:seed\` | Seed the database |
+
+## Project Structure
+
+\`\`\`
+${projectName}/
+├── app.js              # Main application entry
+├── volt.config.js      # Framework configuration
+├── pages/              # File-based routes (auto-discovered)
+├── api/                # API routes (auto-discovered)
+├── views/              # Templates
+│   ├── layouts/        # Layout files
+│   └── partials/       # Partial templates
+├── components/         # Reusable components
+├── models/             # Database models
+├── middleware/          # Custom middleware
+├── public/             # Static assets
+├── database/           # Migrations & seeders
+├── storage/            # File uploads
+├── tests/              # Test files
+└── logs/               # Log files
+\`\`\`
+`,
+  };
+
+  // Write files
+  for (const [filePath, content] of Object.entries(files)) {
+    const fullPath = path.join(projectDir, filePath);
+    const dir = path.dirname(fullPath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(fullPath, content);
+    console.log(`  ${c.green}✓${c.reset} ${filePath}`);
+  }
+
+  console.log(`
+${c.green}${c.bold}✓ Project created successfully!${c.reset}
+
+${c.bold}Next steps:${c.reset}
+
+  ${c.cyan}cd ${projectName}${c.reset}
+  ${c.cyan}npm install${c.reset}
+  ${c.cyan}npm run dev${c.reset}
+
+${c.dim}Your app will be running at ${c.cyan}http://localhost:3000${c.reset}
+`);
+};

package/src/cli/db.js

@@ -0,0 +1,106 @@
+/**
+ * VoltJS CLI — `volt db:migrate`, `volt db:seed`, `volt db:rollback`
+ */
+
+'use strict';
+
+const path = require('path');
+
+const c = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  red: '\x1b[31m', green: '\x1b[32m', cyan: '\x1b[36m',
+};
+
+module.exports = async function db(args) {
+  const action = args[0];
+  const cwd = process.cwd();
+
+  // Load config
+  let config = {};
+  try {
+    config = require(path.join(cwd, 'volt.config.js'));
+  } catch { }
+
+  // Import database and migration/seeder modules
+  let Database, Migration, Seeder;
+  try {
+    ({ Database } = require('../database'));
+    ({ Migration } = require('../database/migration'));
+    ({ Seeder } = require('../database/seeder'));
+  } catch (err) {
+    console.error(`${c.red}Error loading database modules: ${err.message}${c.reset}`);
+    process.exit(1);
+  }
+
+  const db = new Database(config.database || {});
+  await db.connect();
+
+  switch (action) {
+    case 'migrate': {
+      console.log(`${c.cyan}${c.bold}⚡ Running migrations...${c.reset}\n`);
+      const migrationsDir = path.join(cwd, 'database', 'migrations');
+      try {
+        const result = await Migration.run(db, migrationsDir);
+        if (result && result.length > 0) {
+          for (const m of result) {
+            console.log(`  ${c.green}✓${c.reset} ${m}`);
+          }
+        } else {
+          console.log(`  ${c.dim}Nothing to migrate.${c.reset}`);
+        }
+        console.log(`\n${c.green}Migrations complete.${c.reset}`);
+      } catch (err) {
+        console.error(`${c.red}Migration failed: ${err.message}${c.reset}`);
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'rollback': {
+      console.log(`${c.cyan}${c.bold}⚡ Rolling back...${c.reset}\n`);
+      const migrationsDir = path.join(cwd, 'database', 'migrations');
+      try {
+        const result = await Migration.rollback(db, migrationsDir);
+        if (result && result.length > 0) {
+          for (const m of result) {
+            console.log(`  ${c.green}✓${c.reset} Rolled back: ${m}`);
+          }
+        } else {
+          console.log(`  ${c.dim}Nothing to rollback.${c.reset}`);
+        }
+        console.log(`\n${c.green}Rollback complete.${c.reset}`);
+      } catch (err) {
+        console.error(`${c.red}Rollback failed: ${err.message}${c.reset}`);
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'seed': {
+      console.log(`${c.cyan}${c.bold}⚡ Running seeders...${c.reset}\n`);
+      const seedersDir = path.join(cwd, 'database', 'seeders');
+      try {
+        const result = await Seeder.run(db, seedersDir);
+        if (result && result.length > 0) {
+          for (const s of result) {
+            console.log(`  ${c.green}✓${c.reset} ${s}`);
+          }
+        } else {
+          console.log(`  ${c.dim}No seeders found.${c.reset}`);
+        }
+        console.log(`\n${c.green}Seeding complete.${c.reset}`);
+      } catch (err) {
+        console.error(`${c.red}Seeding failed: ${err.message}${c.reset}`);
+        process.exit(1);
+      }
+      break;
+    }
+
+    default:
+      console.error(`${c.red}Unknown db command: ${action}${c.reset}`);
+      console.log(`  Available: ${c.cyan}migrate${c.reset}, ${c.cyan}rollback${c.reset}, ${c.cyan}seed${c.reset}`);
+      process.exit(1);
+  }
+
+  process.exit(0);
+};

package/src/cli/dev.js

@@ -0,0 +1,114 @@
+/**
+ * VoltJS CLI — `volt dev`
+ * Starts a development server with hot reload (file watching).
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const c = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m', cyan: '\x1b[36m',
+};
+
+module.exports = function dev(args) {
+  const cwd = process.cwd();
+  const entry = findEntry(cwd);
+
+  if (!entry) {
+    console.error(`${c.red}Error: No app entry point found (app.js, index.js, or server.js).${c.reset}`);
+    process.exit(1);
+  }
+
+  console.log(`${c.cyan}${c.bold}⚡ VoltJS Dev Server${c.reset}`);
+  console.log(`${c.dim}Watching for file changes...${c.reset}\n`);
+
+  let child = null;
+  let restarting = false;
+  let debounceTimer = null;
+
+  function startServer() {
+    if (child) {
+      child.kill('SIGTERM');
+    }
+
+    child = spawn(process.execPath, [entry], {
+      cwd,
+      stdio: 'inherit',
+      env: { ...process.env, NODE_ENV: 'development', VOLT_DEV: '1' },
+    });
+
+    child.on('exit', (code, signal) => {
+      if (!restarting && signal !== 'SIGTERM') {
+        if (code !== 0) {
+          console.log(`\n${c.yellow}Process exited with code ${code}. Waiting for changes...${c.reset}`);
+        }
+      }
+    });
+
+    child.on('error', (err) => {
+      console.error(`${c.red}Failed to start: ${err.message}${c.reset}`);
+    });
+  }
+
+  function restart() {
+    if (debounceTimer) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(() => {
+      restarting = true;
+      console.log(`\n${c.cyan}↻ Restarting...${c.reset}`);
+      startServer();
+      restarting = false;
+    }, 200);
+  }
+
+  // Watch for file changes
+  const watchDirs = ['pages', 'api', 'views', 'components', 'models', 'middleware', 'config', 'src']
+    .map(d => path.join(cwd, d))
+    .filter(d => fs.existsSync(d));
+
+  // Also watch root JS files
+  watchDirs.push(cwd);
+
+  const watchedExtensions = ['.js', '.json', '.volt', '.html', '.css'];
+
+  for (const dir of watchDirs) {
+    try {
+      fs.watch(dir, { recursive: true }, (eventType, filename) => {
+        if (!filename) return;
+        const ext = path.extname(filename);
+        if (watchedExtensions.includes(ext)) {
+          console.log(`${c.dim}  Changed: ${filename}${c.reset}`);
+          restart();
+        }
+      });
+    } catch {
+      // Directory may not support recursive watching
+    }
+  }
+
+  // Graceful shutdown
+  process.on('SIGINT', () => {
+    console.log(`\n${c.dim}Shutting down dev server...${c.reset}`);
+    if (child) child.kill('SIGTERM');
+    process.exit(0);
+  });
+
+  process.on('SIGTERM', () => {
+    if (child) child.kill('SIGTERM');
+    process.exit(0);
+  });
+
+  startServer();
+};
+
+function findEntry(cwd) {
+  const candidates = ['app.js', 'index.js', 'server.js', 'src/app.js', 'src/index.js'];
+  for (const file of candidates) {
+    const fullPath = path.join(cwd, file);
+    if (fs.existsSync(fullPath)) return fullPath;
+  }
+  return null;
+}