create-fuzionx 0.1.35 → 0.1.38

package/index.js

@@ -193,7 +193,8 @@ try {
     cd ${name}
     npm install
     ${type === 'spa' ? `cd app/spa/views/default/spa && npm install && cd ../../../../..
-    ` : ''}${nextCmd}
+    ` : ''}npx fx db:sync --apply
+    ${nextCmd}
 `);
 } catch (err) {
     console.error(`❌ Failed to create app: ${err.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-fuzionx",
-  "version": "0.1.35",
+  "version": "0.1.38",
   "description": "Create a new FuzionX application — npx create-fuzionx my-app",
   "type": "module",
   "bin": {

package/templates/common/database/models/Attachment.js

@@ -0,0 +1,41 @@
+import { SQLiteModel } from '@fuzionx/framework';
+
+/**
+ * Attachment — 게시글 첨부파일 모델
+ *
+ * 게시글에 첨부된 파일 메타데이터를 관리.
+ * 실제 파일은 storage/uploads/ 에 저장, DB에는 경로만 보관.
+ *
+ * @extends SQLiteModel
+ */
+export default class Attachment extends SQLiteModel {
+  /** @type {string} 테이블 명 */
+  static table = 'attachments';
+
+  /** @type {boolean} created_at 자동 관리 */
+  static timestamps = true;
+
+  /**
+   * 컬럼 정의
+   *
+   * @type {Object<string, import('@fuzionx/framework').ColumnDefinition>}
+   * @property {Object} id            - 자동 증가 기본키 (PK)
+   * @property {Object} post_id       - 게시글 ID (FK → posts.id)
+   * @property {Object} original_name - 원본 파일명
+   * @property {Object} file_path     - Storage 상대 경로 (uploads/posts/xxx.jpg)
+   * @property {Object} mime_type     - MIME 타입 (image/jpeg, application/pdf 등)
+   * @property {Object} size          - 파일 크기 (bytes)
+   * @property {Object} created_at    - 업로드 일시
+   * @property {Object} updated_at    - 수정 일시
+   */
+  static columns = {
+    id:            { type: 'increments' },
+    post_id:       { type: 'integer' },
+    original_name: { type: 'string', length: 255 },
+    file_path:     { type: 'string', length: 500 },
+    mime_type:     { type: 'string', length: 100 },
+    size:          { type: 'integer' },
+    created_at:    { type: 'datetime' },
+    updated_at:    { type: 'datetime' },
+  };
+}

package/templates/common/database/models/Post.js

@@ -0,0 +1,39 @@
+import { SQLiteModel } from '@fuzionx/framework';
+
+/**
+ * Post — 게시글 모델
+ *
+ * 게시판의 게시글 데이터를 관리하는 모델.
+ * 사용자(User)와 N:1 관계로, `user_id` 외래키로 연결.
+ *
+ * @extends SQLiteModel
+ */
+export default class Post extends SQLiteModel {
+  /** @type {string} 테이블 명 */
+  static table = 'posts';
+
+  /** @type {boolean} created_at / updated_at 자동 관리 */
+  static timestamps = true;
+
+  /**
+   * 컬럼 정의
+   *
+   * @type {Object<string, import('@fuzionx/framework').ColumnDefinition>}
+   * @property {Object} id         - 자동 증가 기본키 (PK)
+   * @property {Object} user_id    - 작성자 ID (FK → users.id)
+   * @property {Object} title      - 게시글 제목 (최대 200자)
+   * @property {Object} content    - 게시글 본문 (TEXT)
+   * @property {Object} status     - 상태: 'published' | 'processing'
+   * @property {Object} created_at - 생성 일시
+   * @property {Object} updated_at - 수정 일시
+   */
+  static columns = {
+    id:         { type: 'increments' },
+    user_id:    { type: 'integer' },
+    title:      { type: 'string', length: 200 },
+    content:    { type: 'text' },
+    status:     { type: 'string', length: 20, default: 'published' },
+    created_at: { type: 'datetime' },
+    updated_at: { type: 'datetime' },
+  };
+}

package/templates/common/database/models/Thumbnail.js

@@ -0,0 +1,53 @@
+import { SQLiteModel } from '@fuzionx/framework';
+
+/**
+ * Thumbnail — 첨부파일 썸네일 모델
+ *
+ * 이미지/비디오 첨부파일의 썸네일 메타데이터.
+ * - 이미지: 원본을 리사이즈하여 webp로 저장
+ * - 비디오: 3초 지점 프레임 추출 후 리사이즈
+ *
+ * Attachment 1:1 관계 (attachment_id FK).
+ * 실제 파일은 storage/uploads/thumbs/ 에 저장.
+ *
+ * @example
+ * // 썸네일 조회
+ * const thumb = await Thumbnail.where('attachment_id', att.id).first();
+ * const url = app.storage.url(thumb.file_path);
+ *
+ * @extends SQLiteModel
+ */
+export default class Thumbnail extends SQLiteModel {
+  /** @type {string} 테이블 명 */
+  static table = 'thumbnails';
+
+  /** @type {boolean} created_at 자동 관리 */
+  static timestamps = true;
+
+  /**
+   * 컬럼 정의
+   *
+   * @type {Object<string, import('@fuzionx/framework').ColumnDefinition>}
+   * @property {Object} id            - 자동 증가 PK
+   * @property {Object} attachment_id - 첨부파일 ID (FK → attachments.id)
+   * @property {Object} file_path     - Storage 상대 경로 (uploads/thumbs/xxx.webp)
+   * @property {Object} width         - 썸네일 가로 크기 (px)
+   * @property {Object} height        - 썸네일 세로 크기 (px)
+   * @property {Object} format        - 포맷 (webp, jpeg)
+   * @property {Object} size          - 파일 크기 (bytes)
+   * @property {Object} source_type   - 원본 타입 (image|video)
+   * @property {Object} created_at    - 생성 일시
+   */
+  static columns = {
+    id:            { type: 'increments' },
+    attachment_id: { type: 'integer' },
+    file_path:     { type: 'string', length: 500 },
+    width:         { type: 'integer' },
+    height:        { type: 'integer' },
+    format:        { type: 'string', length: 20 },
+    size:          { type: 'integer' },
+    source_type:   { type: 'string', length: 20 },
+    created_at:    { type: 'datetime' },
+    updated_at:    { type: 'datetime' },
+  };
+}

package/templates/common/database/models/User.js

@@ -1,9 +1,35 @@
-import { MariaModel } from '@fuzionx/framework';
-
-export default class User extends MariaModel {
-    static table = 'users';
-    static connection = 'main';
-    static softDelete = true;
-    static hidden = ['password'];
-    static fillable = ['name', 'email', 'password', 'role'];
+import { SQLiteModel } from '@fuzionx/framework';
+
+/**
+ * User — 사용자 모델
+ *
+ * 인증 및 사용자 프로필 데이터를 관리하는 모델.
+ * `password` 필드는 hidden 처리되어 JSON 직렬화 시 제외.
+ *
+ * @extends SQLiteModel
+ */
+export default class User extends SQLiteModel {
+  /** @type {string} 테이블 명 */
+  static table = 'users';
+
+  /** @type {boolean} created_at / updated_at 자동 관리 */
+  static timestamps = true;
+
+  /** @type {string[]} JSON 직렬화 시 제외할 필드 */
+  static hidden = ['password'];
+
+  /**
+   * 컬럼 정의
+   *
+   * @type {Object<string, import('@fuzionx/framework').ColumnDefinition>}
+   */
+  static columns = {
+    id:         { type: 'increments' },
+    name:       { type: 'string', length: 100 },
+    email:      { type: 'string', length: 150, unique: true },
+    password:   { type: 'string', length: 255 },
+    role:       { type: 'string', length: 20, default: 'user' },
+    created_at: { type: 'datetime' },
+    updated_at: { type: 'datetime' },
+  };
 }

package/templates/common/locales/en.json

@@ -1,52 +1,250 @@
 {
-    "app": {
-        "name": "FuzionX Test App",
-        "welcome": "Welcome to FuzionX",
-        "description": "Full-stack framework testing environment"
-    },
-    "nav": {
-        "home": "Home",
-        "dashboard": "Dashboard",
-        "users": "Users",
-        "upload": "Upload",
-        "websocket": "WebSocket",
-        "docs": "API Docs",
-        "settings": "Settings"
-    },
-    "user": {
-        "name": "Name",
-        "email": "Email",
-        "role": "Role",
-        "create": "Create User",
-        "edit": "Edit",
-        "delete": "Delete",
-        "list": "User List",
-        "created": "User has been created",
-        "deleted": "User has been deleted",
-        "not_found": "User not found"
-    },
-    "auth": {
-        "login": "Login",
-        "logout": "Logout",
-        "login_required": "Login required",
-        "invalid_credentials": "Invalid credentials"
-    },
-    "common": {
-        "save": "Save",
-        "cancel": "Cancel",
-        "confirm": "Confirm",
-        "search": "Search",
-        "loading": "Loading...",
-        "error": "An error occurred",
-        "success": "Success",
-        "greeting": "Hello, {name}!",
-        "items_count": "{count} items total"
-    },
-    "upload": {
-        "select_file": "Select a file",
-        "drag_drop": "Drag & drop or click to select",
-        "uploading": "Uploading...",
-        "complete": "Upload complete",
-        "error": "Upload failed"
-    }
+  "auth": {
+    "email_exists": "Email already registered.",
+    "has_account": "Already have an account?",
+    "login_failed": "Invalid email or password.",
+    "no_account": "Don't have an account?",
+    "password_mismatch": "Passwords do not match.",
+    "register_success": "Registration complete. Please log in."
+  },
+  "board": {
+    "attached_files": "Existing files",
+    "author": "Author",
+    "confirm_delete": "Are you sure you want to delete?",
+    "date": "Date",
+    "delete_success": "Post deleted successfully.",
+    "drop_files": "Click or drag files here",
+    "edit_title": "Edit Post",
+    "empty": "No posts yet.",
+    "file_hint": "Max 10MB, images and documents",
+    "new_title": "New Post",
+    "processing": "Processing",
+    "store_success": "Post saved successfully.",
+    "title": "Board",
+    "update_success": "Post updated successfully."
+  },
+  "btn": {
+    "back": "← Back",
+    "cancel": "Cancel",
+    "create": "Create",
+    "delete": "Delete",
+    "edit": "Edit",
+    "go_home": "Go Home",
+    "login": "Login",
+    "new_post": "New Post",
+    "register": "Register",
+    "save": "Save"
+  },
+  "chat": {
+    "btn_join": "Join Chat",
+    "btn_leave": "Leave Chat",
+    "btn_send": "Send",
+    "connecting": "connecting...",
+    "demo_sub": "Experience FuzionX real-time WebSocket in action.",
+    "demo_tech": "Built with",
+    "demo_title": "Chat Demo",
+    "footer": "Powered by WsHandler",
+    "footer_link": "WebSocket Features",
+    "meta_desc": "Live WebSocket chat demo powered by FuzionX WsHandler. Try the real-time messaging with user presence.",
+    "msg_placeholder": "Type a message...",
+    "nickname_placeholder": "Enter your nickname...",
+    "online": "Online",
+    "page_title": "Chat Demo",
+    "room_title": "Chat Room",
+    "typing": "is typing..."
+  },
+  "common": {
+    "forbidden": "Forbidden."
+  },
+  "dashboard": {
+    "about_title": "FuzionX Framework",
+    "edit_profile": "Edit",
+    "feat_auth": "Built-in Authentication",
+    "feat_auth_desc": "Session-based auth, bcrypt/argon2 hashing, and CSRF protection included out of the box.",
+    "feat_i18n": "Internationalization (i18n)",
+    "feat_i18n_desc": "JSON-based locale files with auto-detection of missing keys for seamless multi-language support.",
+    "feat_perf": "High-Performance Rust Bridge",
+    "feat_perf_desc": "Rust N-API based HTTP server, session management, encryption, and hashing at native speed.",
+    "feat_ssr": "SSR + SPA Support",
+    "feat_ssr_desc": "Run Tera template-based SSR and Vue.js SPA simultaneously in a single project.",
+    "go_board": "Go",
+    "qs_controller": "Write Controllers",
+    "qs_controller_desc": "Delegate business logic to services, handle rendering and redirects.",
+    "qs_route": "Define Routes",
+    "qs_route_desc": "Map URLs to controllers in routes.js.",
+    "quickstart_title": "Quick Start"
+  },
+  "feat": {
+    "badge": "Framework Features",
+    "bridge_code_title": "Native Performance — Zero JS Overhead",
+    "bridge_crypto": "Native Crypto",
+    "bridge_crypto_desc": "bcrypt, argon2id, AES-256-GCM, SHA-256, MD5, UUID v4 — all executed in Rust. No crypto module overhead, no C++ addon compilation issues.",
+    "bridge_media": "Media Processing",
+    "bridge_media_desc": "Image resizing (Lanczos3), WebP conversion, and video thumbnail extraction powered by Rust image crate and ffmpeg bindings.",
+    "bridge_rps": "The HTTP engine runs entirely in Rust through N-API, delivering throughput that JavaScript-based servers cannot match. Request parsing, routing, and response serialization happen at native speed.",
+    "bridge_sub": "Native performance for core operations — no JavaScript overhead.",
+    "bridge_title": "Rust N-API Bridge",
+    "bridge_zerocopy": "Zero-Copy File Uploads",
+    "bridge_zerocopy_desc": "Multipart parsing happens in Rust. Files are written directly to disk — the file buffer never enters JavaScript memory, making large file uploads safe and efficient.",
+    "btn_back": "Back to Home",
+    "btn_chat": "Try Chat Demo",
+    "btn_try_chat": "Try Live Chat Demo →",
+    "cta_sub": "One command to scaffold. Zero configuration to start.",
+    "cta_title_1": "Start Building",
+    "cta_title_2": "Today",
+    "dx_autoscan": "Auto-Scanning",
+    "dx_autoscan_desc": "Drop a file in controllers/, services/, ws/, or jobs/ — the framework discovers and registers it automatically. Zero manual wiring.",
+    "dx_cli": "CLI Code Generator",
+    "dx_cli_desc": "fx make:controller, fx make:model, fx make:service — scaffold any component instantly with proper boilerplate.",
+    "dx_openapi": "OpenAPI Auto-Generation",
+    "dx_openapi_desc": "Swagger UI at /docs with zero configuration. Route definitions are automatically converted to OpenAPI 3.0 spec.",
+    "dx_sub": "CLI scaffolding, auto-scanning, hot reload, OpenAPI docs — everything to keep you productive.",
+    "dx_test": "Testing Helpers",
+    "dx_test_desc": "In-process HTTP test client, database transaction rollbacks, isolated test contexts. vitest integration out of the box.",
+    "dx_title": "Developer Experience",
+    "header_sub": "Every feature designed for performance, developer experience, and enterprise readiness.",
+    "header_title_1": "Built for",
+    "header_title_2": "Production",
+    "meta_desc": "Explore FuzionX features: Rust N-API Bridge, Multi-DB ORM, WebSocket, Task Queue, and more.",
+    "orm_access": "3-Level Access",
+    "orm_access_desc": "Unified API for 99% of cases → Raw Query for DB-specific features → Native driver access when you need full control.",
+    "orm_relations": "Relationships",
+    "orm_relations_desc": "hasMany, hasOne, belongsTo, belongsToMany — define relations as methods. Eager loading with .with('posts.comments').",
+    "orm_schema": "Model-Based Schema Sync",
+    "orm_schema_desc": "Define columns in the model with static columns, then run fx db:sync. No more writing migration files — the model IS the schema.",
+    "orm_sub": "One API for MariaDB, PostgreSQL, and MongoDB. Model = Schema = Single source of truth.",
+    "orm_title": "Multi-Database ORM",
+    "orm_unified": "Unified Query API",
+    "orm_unified_desc": "Write User.where('active', true).paginate(1, 20) and it works across all databases. No database-specific code needed for CRUD operations.",
+    "page_title": "Features",
+    "queue_queued": "Queued Tasks",
+    "queue_queued_desc": "Async dispatch with retries: app.dispatch('SendEmail', data). Memory or Redis backend. Failed tasks call failed() hook.",
+    "queue_scheduled": "Scheduled Jobs",
+    "queue_scheduled_desc": "Cron-based recurring tasks. static schedule = 'daily:02:00'. Runs on master process with Redis distributed lock for multi-server.",
+    "queue_sub": "Three ways to handle background work — scheduled, queued, and CPU-isolated.",
+    "queue_title": "Task Queue + Workers",
+    "queue_worker_desc": "CPU-heavy work in worker_threads: app.worker.run('csv-parser', data). Prevents event loop blocking. Timeout + auto-cleanup.",
+    "sec_asp": "ASP Wire Encryption",
+    "sec_asp_desc": "FuzionX Stealth Protocol encrypts all HTTP request/response bodies on the wire. Transparent to application code, impenetrable to MITM attacks.",
+    "sec_hash": "Native Password Hashing",
+    "sec_hash_desc": "bcrypt (cost 12) and argon2id hashing in Rust — orders of magnitude faster than JavaScript implementations with the same security guarantees.",
+    "sec_rate": "Rate Limiting + CSRF",
+    "sec_rate_desc": "Per-IP rate limiting in the Rust bridge layer. CSRF token generation and validation. IP whitelist/blacklist. HSTS and CSP headers.",
+    "sec_session": "Session + JWT Auth",
+    "sec_session_desc": "File-based or Redis session store. JWT access/refresh token rotation. Built-in auth() middleware with route guards.",
+    "sec_sub": "Production-grade security built into every layer — from wire encryption to password hashing.",
+    "sec_title": "Enterprise Security",
+    "ssr_i18n": "Built-in i18n",
+    "ssr_i18n_desc": "JSON-based translations with auto-detection, fallback locales, and missing key auto-complete.",
+    "ssr_multiapp": "Multi-App Routing",
+    "ssr_multiapp_desc": "Route different domains to different apps: api.example.com → spa, www.example.com → ssr. One codebase, multiple frontends.",
+    "ssr_sub": "Server-rendered pages and single-page apps in one project with domain routing.",
+    "ssr_tera": "Tera Template Engine",
+    "ssr_tera_desc": "Jinja2-compatible template engine compiled in Rust. Layouts, blocks, inheritance, filters, and macros for fast SSR rendering.",
+    "ssr_theme": "Theme System",
+    "ssr_theme_desc": "Multiple view themes with views/{theme}/ structure. Switch themes via config without changing any controller code.",
+    "ssr_title": "SSR + SPA Hybrid",
+    "ws_dsl": "Event Routing DSL",
+    "ws_dsl_desc": "static events(e) declares event → handler mappings, just like controller routes. Clean, declarative, and auto-scanned from ws/ folder.",
+    "ws_hub": "Hub Broadcasting",
+    "ws_hub_desc": "Multi-server? Just add { hub: true } to broadcast. Messages route through Hub server to all connected instances.",
+    "ws_middleware": "Middleware Sharing",
+    "ws_middleware_desc": "Reuse the same HTTP middleware for WebSocket handshake. Auth middleware works for both HTTP and WS connections.",
+    "ws_rooms": "Rooms",
+    "ws_rooms_desc": "socket.join('room:123'), socket.to('room:123').send({...}) — built-in room management without external libraries.",
+    "ws_sub": "Namespace-based event routing with rooms, middleware sharing, and multi-server Hub.",
+    "ws_title": "Real-time WebSocket"
+  },
+  "home": {
+    "arch_bridge_desc": "Rust N-API binary — libuv Fusion HTTP, native crypto, media processing, file I/O. Zero-copy where possible.",
+    "arch_core_desc": "Express-level HTTP engine wrapping the Rust bridge. Routing, request/response lifecycle, WebSocket server.",
+    "arch_engine": "Engine",
+    "arch_framework_desc": "Controllers, Services, Models, Middleware, WebSocket Handlers, Jobs — Laravel-style MVC with full DI container",
+    "arch_native": "Native",
+    "arch_subtitle": "Three-tier design separating concerns for maximum performance and developer ergonomics.",
+    "arch_title_1": "Layered",
+    "arch_title_2": "Architecture",
+    "arch_you_write": "You Write",
+    "btn_all_features": "View All Features",
+    "btn_demo": "Live Demo",
+    "btn_features": "Explore Features",
+    "btn_try_chat": "Try Chat Demo",
+    "cmp_3rd_party": "3rd party",
+    "cmp_builtin": "Built-in",
+    "cmp_feature": "Feature",
+    "cmp_http": "HTTP Engine",
+    "cmp_model_based": "Model-based",
+    "cmp_orm": "ORM Built-in",
+    "cmp_queue": "Task Queue",
+    "cmp_schema": "Schema Sync",
+    "cmp_upload": "File Upload",
+    "cta_subtitle": "Get started with FuzionX in seconds. One command, zero configuration.",
+    "cta_title_1": "Ready to Build",
+    "cta_title_2": "Something Fast",
+    "feat_bridge": "Rust N-API Bridge",
+    "feat_bridge_desc": "HTTP server, session management, cryptography, and file processing at native speed. No JavaScript overhead for core operations.",
+    "feat_orm": "Multi-DB ORM",
+    "feat_orm_desc": "One unified API for MariaDB, PostgreSQL, and MongoDB. Model-based schema sync replaces migration files.",
+    "feat_queue": "Task Queue + Workers",
+    "feat_queue_desc": "Scheduled jobs (cron), async task queues with retry logic, and WorkerPool for CPU-heavy operations in isolated threads.",
+    "feat_security": "Enterprise Security",
+    "feat_security_desc": "Native bcrypt/argon2 hashing, AES-256-GCM encryption, ASP wire protocol, CSRF protection, and rate limiting.",
+    "feat_ssr": "SSR + SPA Hybrid",
+    "feat_ssr_desc": "Tera template engine for SSR pages alongside Vue.js SPA — run both in a single project with domain-based routing.",
+    "feat_subtitle": "A production-ready framework that ships with batteries included — powered by Rust under the hood.",
+    "feat_title_1": "Everything You Need.",
+    "feat_title_2": "Nothing You Don't.",
+    "feat_ws": "Real-time WebSocket",
+    "feat_ws_desc": "Namespace routing, rooms, event-based handlers, and multi-server Hub broadcasting built into the framework.",
+    "footer": "Rust-powered Node.js framework for the modern web.",
+    "hero_badge": "Powered by Rust N-API",
+    "hero_sub_1": "Full-stack MVC framework for Node.js with a Rust-powered core engine.",
+    "hero_sub_2": "500K+ requests per second. Zero-copy file handling. Native-speed crypto.",
+    "hero_title_1": "Build",
+    "hero_title_2": "Blazing Fast",
+    "hero_title_3": "Web Applications",
+    "meta_desc": "Build blazing-fast web applications with FuzionX. Rust N-API bridge delivering 500K+ RPS, multi-DB ORM, real-time WebSocket, and enterprise-grade security.",
+    "stat_db": "Database Drivers",
+    "stat_modules": "Core Modules",
+    "stat_rps": "Requests/sec",
+    "stat_zero_copy": "Memory Copy Uploads",
+    "title": "Rust-Powered Full-Stack Node.js Framework",
+    "why_subtitle": "See how FuzionX stacks up against popular Node.js frameworks.",
+    "why_title_1": "Why"
+  },
+  "label": {
+    "attachments": "Attachments",
+    "content": "Content",
+    "email": "Email",
+    "name": "Name",
+    "password": "Password",
+    "password_confirm": "Confirm Password",
+    "title": "Title"
+  },
+  "nav": {
+    "board": "Board",
+    "chat": "Chat Demo",
+    "features": "Features",
+    "home": "Home",
+    "login": "Login",
+    "logout": "Logout",
+    "profile": "Profile",
+    "register": "Register"
+  },
+  "page": {
+    "404": "Page not found",
+    "500": "Server error",
+    "dashboard": "Dashboard",
+    "login": "Login",
+    "register": "Register"
+  },
+  "post": {
+    "not_found": "Post not found."
+  },
+  "profile": {
+    "new_password": "New Password (optional)",
+    "title": "Edit Profile",
+    "update_success": "Profile updated."
+  },
+  "welcome": "Welcome, {name}! 👋"
 }