create-fuzionx 0.1.5

package/index.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * create-fuzionx — FuzionX 앱 스캐폴딩 CLI
+ *
+ * Usage:
+ *   npx create-fuzionx my-app
+ *   npx create-fuzionx my-app /path/to/dir
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TPL_DIR = path.join(__dirname, 'templates');
+
+// ── 템플릿 엔진 ({{var}} → value) ──
+
+function render(template, vars) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? '');
+}
+
+async function loadTemplate(relPath, vars) {
+    const raw = await fs.readFile(path.join(TPL_DIR, relPath), 'utf-8');
+    return render(raw, vars);
+}
+
+// ── 스캐폴딩 파일 목록 ──
+
+const APP_FILES = [
+    { tpl: 'package.json.tpl', dest: 'package.json' },
+    { tpl: 'fuzionx.yaml.tpl', dest: 'fuzionx.yaml' },
+    { tpl: 'app.js.tpl', dest: 'app.js' },
+    { tpl: 'routes/web.js.tpl', dest: 'routes/web.js' },
+    { tpl: 'routes/api.js.tpl', dest: 'routes/api.js' },
+    { tpl: '.env.example.tpl', dest: '.env.example' },
+    { tpl: '.env.example.tpl', dest: '.env' },
+    { tpl: '.gitignore.tpl', dest: '.gitignore' },
+];
+
+const APP_DIRS = [
+    'controllers',
+    'models',
+    'services',
+    'middleware',
+    'ws',
+    'jobs',
+    'events',
+    'workers',
+    'migrations',
+    'seeds',
+    'storage/logs',
+    'storage/uploads',
+    'public/css',
+    'public/js',
+    'locales',
+    'tests',
+];
+
+// ── createApp ──
+
+async function createApp(name, targetDir) {
+    const dir = targetDir || path.resolve(name);
+    const vars = {
+        name,
+        dbName: name.replace(/-/g, '_'),
+    };
+
+    // 디렉토리 생성
+    for (const d of APP_DIRS) {
+        await fs.mkdir(path.join(dir, d), { recursive: true });
+        await fs.writeFile(path.join(dir, d, '.gitkeep'), '');
+    }
+
+    // 템플릿 파일 생성
+    for (const { tpl, dest } of APP_FILES) {
+        const content = await loadTemplate(tpl, vars);
+        const fullPath = path.join(dir, dest);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, content);
+    }
+
+    // HomeController 복사
+    const hcSrc = path.join(TPL_DIR, 'controllers/HomeController.js');
+    const hcDst = path.join(dir, 'controllers/HomeController.js');
+    await fs.copyFile(hcSrc, hcDst);
+
+    // Views — views/{theme}/ 구조
+    const viewsSrc = path.join(TPL_DIR, 'views/default');
+    const viewsDst = path.join(dir, 'views/default');
+
+    const layoutDir = path.join(viewsDst, 'layouts');
+    await fs.mkdir(layoutDir, { recursive: true });
+    await fs.copyFile(path.join(viewsSrc, 'layouts/main.html'), path.join(layoutDir, 'main.html'));
+
+    const pagesDir = path.join(viewsDst, 'pages');
+    await fs.mkdir(pagesDir, { recursive: true });
+    await fs.copyFile(path.join(viewsSrc, 'pages/home.html'), path.join(pagesDir, 'home.html'));
+
+    const errDir = path.join(viewsDst, 'errors');
+    await fs.mkdir(errDir, { recursive: true });
+    await fs.copyFile(path.join(viewsSrc, 'errors/404.html'), path.join(errDir, '404.html'));
+    await fs.copyFile(path.join(viewsSrc, 'errors/500.html'), path.join(errDir, '500.html'));
+
+    return dir;
+}
+
+// ── CLI 엔트리 ──
+
+const name = process.argv[2];
+const targetDir = process.argv[3];
+
+if (!name) {
+    console.error(`
+  Usage: npx create-fuzionx <app-name> [target-dir]
+
+  Examples:
+    npx create-fuzionx my-app
+    npx create-fuzionx my-app /path/to/dir
+`);
+    process.exit(1);
+}
+
+try {
+    const dir = await createApp(name, targetDir);
+    console.log(`
+  ✅ Created ${name} at ${dir}
+
+  Next steps:
+
+    cd ${name}
+    npm install
+    npx fx dev
+`);
+} catch (err) {
+    console.error(`❌ Failed to create app: ${err.message}`);
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "create-fuzionx",
+  "version": "0.1.5",
+  "description": "Create a new FuzionX application — npx create-fuzionx my-app",
+  "type": "module",
+  "bin": {
+    "create-fuzionx": "./index.js"
+  },
+  "keywords": ["fuzionx", "create", "scaffold", "cli", "framework"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/saytohenry/fuzionx"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "index.js",
+    "templates/"
+  ]
+}

package/templates/.env.example.tpl

@@ -0,0 +1,14 @@
+# .env — 이 파일을 .env로 복사 후 값을 채우세요
+
+# Database
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_USER=root
+DB_PASSWORD=
+DB_NAME={{dbName}}
+
+# Auth
+JWT_SECRET=
+
+# Redis (세션/큐 공용)
+REDIS_URL=

package/templates/.gitignore.tpl

@@ -0,0 +1,4 @@
+.env
+node_modules/
+storage/logs/
+storage/uploads/

package/templates/app.js.tpl

@@ -0,0 +1,14 @@
+import { Application } from '@fuzionx/framework';
+import webRoutes from './routes/web.js';
+import apiRoutes from './routes/api.js';
+
+const app = new Application({ configPath: './fuzionx.yaml' });
+
+app.routes(webRoutes);
+app.routes(apiRoutes);
+
+await app.boot();
+
+app.listen(49080, () => {
+    console.log('🚀 FuzionX running on http://localhost:49080');
+});

package/templates/controllers/HomeController.js

@@ -0,0 +1,13 @@
+import { Controller } from '@fuzionx/framework';
+
+/**
+ * Home 컨트롤러.
+ * routes/web.js에서 라우트를 등록하세요.
+ */
+export default class HomeController extends Controller {
+
+    /** 홈 페이지 */
+    async index(ctx) {
+        ctx.render('pages/home');
+    }
+}

package/templates/fuzionx.yaml.tpl

@@ -0,0 +1,30 @@
+# FuzionX Configuration
+bridge:
+  port: 49080
+  workers: 4
+  worker_timeout: 30
+
+  rate_limit:
+    enabled: true
+    per_ip: 1000
+
+database:
+  main:
+    driver: sqlite
+    path: ./storage/database.sqlite
+
+app:
+  name: '{{name}}'
+  environment: development
+  auth:
+    secret: 'change-me-in-production'
+    accessTtl: '15m'
+  i18n:
+    default_locale: 'ko'
+    fallback: 'en'
+  docs:
+    enabled: true
+    path: '/docs'
+
+themes:
+  default: 'default'

package/templates/package.json.tpl

@@ -0,0 +1,15 @@
+{
+  "name": "{{name}}",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "fx dev",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@fuzionx/framework": "^0.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0"
+  }
+}

package/templates/routes/api.js.tpl

@@ -0,0 +1,7 @@
+export default (r) => {
+    r.group('/api', (r) => {
+        r.get('/health', (ctx) => {
+            ctx.json({ status: 'ok', timestamp: Date.now() });
+        });
+    });
+};

package/templates/routes/web.js.tpl

@@ -0,0 +1,5 @@
+export default (r) => {
+    r.get('/', (ctx) => {
+        ctx.render('home');
+    });
+};

package/templates/views/default/errors/404.html

@@ -0,0 +1,15 @@
+{% extends "layouts/main.html" %}
+
+{% block title %}404 — 찾을 수 없습니다{% endblock %}
+
+{% block content %}
+<div style="text-align:center;padding:80px 20px;">
+    <h1 style="font-size:72px;color:#e74c3c;">{{ error.code }}</h1>
+    <p style="font-size:20px;margin:16px 0;">{{ error.message }}</p>
+    <p style="color:#888;">요청: {{ request.url }}</p>
+    {% if config.debug %}
+        <pre style="text-align:left;max-width:600px;margin:24px auto;background:#f5f5f5;padding:16px;border-radius:8px;overflow:auto;">{{ error.stack }}</pre>
+    {% endif %}
+    <a href="/" style="display:inline-block;margin-top:24px;padding:12px 24px;background:#e74c3c;color:#fff;text-decoration:none;border-radius:6px;">홈으로 돌아가기</a>
+</div>
+{% endblock %}

package/templates/views/default/errors/500.html

@@ -0,0 +1,14 @@
+{% extends "layouts/main.html" %}
+
+{% block title %}500 — 서버 오류{% endblock %}
+
+{% block content %}
+<div style="text-align:center;padding:80px 20px;">
+    <h1 style="font-size:72px;color:#e74c3c;">500</h1>
+    <p style="font-size:20px;margin:16px 0;">{{ error.message | default(value='Internal Server Error') }}</p>
+    {% if config.debug and error.stack %}
+        <pre style="text-align:left;max-width:600px;margin:24px auto;background:#f5f5f5;padding:16px;border-radius:8px;overflow:auto;">{{ error.stack }}</pre>
+    {% endif %}
+    <a href="/" style="display:inline-block;margin-top:24px;padding:12px 24px;background:#e74c3c;color:#fff;text-decoration:none;border-radius:6px;">홈으로 돌아가기</a>
+</div>
+{% endblock %}

package/templates/views/default/layouts/main.html

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="{{ locale | default(value='ko') }}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{% block title %}{{ config.app.name | default(value='FuzionX') }}{% endblock %}</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body { font-family: system-ui, -apple-system, sans-serif; line-height: 1.6; color: #333; }
+    </style>
+    {% block head %}{% endblock %}
+</head>
+<body>
+    {% include "partials/header.html" ignore missing %}
+
+    <main>
+        {% block content %}{% endblock %}
+    </main>
+
+    {% include "partials/footer.html" ignore missing %}
+</body>
+</html>

package/templates/views/default/pages/home.html

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>FuzionX</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        @import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;600;800&display=swap');
+
+        body {
+            font-family: 'Inter', system-ui, -apple-system, sans-serif;
+            min-height: 100vh;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            background: linear-gradient(135deg, #0f0c29 0%, #1a1a3e 40%, #24243e 100%);
+            color: #e0e0e0;
+            overflow: hidden;
+        }
+
+        .container {
+            text-align: center;
+            z-index: 1;
+            animation: fadeInUp 0.8s ease-out;
+        }
+
+        .logo {
+            font-size: 4rem;
+            font-weight: 800;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 50%, #f093fb 100%);
+            -webkit-background-clip: text;
+            background-clip: text;
+            -webkit-text-fill-color: transparent;
+            letter-spacing: -2px;
+            margin-bottom: 0.5rem;
+        }
+
+        .subtitle {
+            font-size: 1.1rem;
+            font-weight: 300;
+            color: rgba(255, 255, 255, 0.5);
+            margin-bottom: 2.5rem;
+            letter-spacing: 2px;
+        }
+
+        .card {
+            background: rgba(255, 255, 255, 0.05);
+            backdrop-filter: blur(20px);
+            border: 1px solid rgba(255, 255, 255, 0.1);
+            border-radius: 16px;
+            padding: 2rem 3rem;
+            max-width: 480px;
+            margin: 0 auto 2rem;
+        }
+
+        .version {
+            display: inline-block;
+            background: linear-gradient(135deg, #667eea, #764ba2);
+            color: white;
+            padding: 4px 14px;
+            border-radius: 20px;
+            font-size: 0.75rem;
+            font-weight: 600;
+            letter-spacing: 1px;
+            margin-bottom: 1.5rem;
+        }
+
+        .features {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 1rem;
+            text-align: left;
+            margin-top: 1.5rem;
+        }
+
+        .feature {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            font-size: 0.85rem;
+            color: rgba(255, 255, 255, 0.7);
+        }
+
+        .feature span {
+            font-size: 1.1rem;
+        }
+
+        .links {
+            display: flex;
+            gap: 1rem;
+            justify-content: center;
+            margin-top: 1rem;
+        }
+
+        .links a {
+            color: rgba(255, 255, 255, 0.6);
+            text-decoration: none;
+            font-size: 0.85rem;
+            padding: 8px 20px;
+            border: 1px solid rgba(255, 255, 255, 0.15);
+            border-radius: 8px;
+            transition: all 0.3s ease;
+        }
+
+        .links a:hover {
+            color: #fff;
+            border-color: #667eea;
+            background: rgba(102, 126, 234, 0.1);
+            transform: translateY(-2px);
+        }
+
+        .hint {
+            margin-top: 2rem;
+            font-size: 0.75rem;
+            color: rgba(255, 255, 255, 0.3);
+        }
+
+        .hint code {
+            background: rgba(255, 255, 255, 0.08);
+            padding: 2px 8px;
+            border-radius: 4px;
+            font-family: 'JetBrains Mono', monospace;
+        }
+
+        /* Background orbs */
+        .orb {
+            position: fixed;
+            border-radius: 50%;
+            filter: blur(80px);
+            opacity: 0.3;
+            animation: float 8s ease-in-out infinite;
+        }
+        .orb-1 { width: 400px; height: 400px; background: #667eea; top: -100px; right: -100px; }
+        .orb-2 { width: 300px; height: 300px; background: #764ba2; bottom: -80px; left: -80px; animation-delay: -4s; }
+        .orb-3 { width: 200px; height: 200px; background: #f093fb; top: 50%; left: 60%; animation-delay: -2s; }
+
+        @keyframes fadeInUp {
+            from { opacity: 0; transform: translateY(30px); }
+            to { opacity: 1; transform: translateY(0); }
+        }
+
+        @keyframes float {
+            0%, 100% { transform: translate(0, 0); }
+            50% { transform: translate(30px, -30px); }
+        }
+
+        @media (max-width: 600px) {
+            .logo { font-size: 2.5rem; }
+            .card { padding: 1.5rem; margin: 0 1rem; }
+            .features { grid-template-columns: 1fr; }
+        }
+    </style>
+</head>
+<body>
+    <div class="orb orb-1"></div>
+    <div class="orb orb-2"></div>
+    <div class="orb orb-3"></div>
+
+    <div class="container">
+        <h1 class="logo">FuzionX</h1>
+        <p class="subtitle">HIGH-PERFORMANCE NODE.JS FRAMEWORK</p>
+
+        <div class="card">
+            <div class="version">v0.1.0 · POWERED BY RUST</div>
+
+            <div class="features">
+                <div class="feature"><span>⚡</span> 500K+ RPS</div>
+                <div class="feature"><span>🦀</span> Rust N-API Bridge</div>
+                <div class="feature"><span>🎯</span> MVC Architecture</div>
+                <div class="feature"><span>🔌</span> WebSocket</div>
+                <div class="feature"><span>🗄️</span> Multi-DB ORM</div>
+                <div class="feature"><span>🔐</span> Auth & Session</div>
+                <div class="feature"><span>📡</span> Event System</div>
+                <div class="feature"><span>⏰</span> Job Scheduler</div>
+            </div>
+        </div>
+
+        <div class="links">
+            <a href="https://github.com/saytohenry/fuzionx">GitHub</a>
+            <a href="/docs">API Docs</a>
+            <a href="/api/health">Health Check</a>
+        </div>
+
+        <p class="hint">Edit <code>routes/web.js</code> to get started</p>
+    </div>
+</body>
+</html>