@fuzionx/framework 0.1.6 → 0.1.7

package/README.md

@@ -13,13 +13,18 @@
 ## Quick Start
 
 ```bash
+# 글로벌 CLI 설치 (fx + create-fuzionx)
+npm install -g create-fuzionx
+
 # 프로젝트 생성
-npx create-fuzionx my-app
+fx new my-app
+# 또는: npx create-fuzionx my-app
+
 cd my-app
 npm install
 
 # 개발 서버
-npx fx dev              # --watch 자동 재시작
+fx dev              # 또는: npx fx dev
 
 # 또는 직접 실행
 node app.js

package/lib/core/Application.js

@@ -296,6 +296,10 @@ export default class Application {
         port = port || this.config.get('bridge.server.port', 3000);
 
         if (!this._booted) await this.boot();
+
+        // 포트 사용 여부 확인 — 충돌 시 명확한 에러
+        await this._checkPort(port);
+
         await this.emit('ready');
 
         // Bridge 연동
@@ -333,6 +337,33 @@ export default class Application {
         return this;
     }
 
+    /**
+     * 포트 사용 여부 확인 — 이미 바인딩된 포트면 명확한 에러
+     * @param {number} port
+     * @private
+     */
+    async _checkPort(port) {
+        const net = await import('node:net');
+        return new Promise((resolve, reject) => {
+            const tester = net.createServer()
+                .once('error', (err) => {
+                    if (err.code === 'EADDRINUSE') {
+                        reject(new Error(
+                            `❌ 포트 ${port}이(가) 이미 사용 중입니다. ` +
+                            `다른 FuzionX 인스턴스가 실행 중인지 확인하세요.\n` +
+                            `   확인: lsof -i :${port}  |  종료: fuser -k ${port}/tcp`
+                        ));
+                    } else {
+                        reject(err);
+                    }
+                })
+                .once('listening', () => {
+                    tester.close(() => resolve());
+                })
+                .listen(port, '0.0.0.0');
+        });
+    }
+
     /**
      * 싱글톤 컨트롤러 초기화
      * @private

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzionx/framework",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "description": "Full-stack MVC framework built on @fuzionx/core — Controller, Service, Model, Middleware, DI, EventBus",
   "main": "index.js",
@@ -34,7 +34,7 @@
     "url": "https://github.com/saytohenry/fuzionx"
   },
   "dependencies": {
-    "@fuzionx/core": "^0.1.6",
+    "@fuzionx/core": "^0.1.7",
     "better-sqlite3": "^12.8.0",
     "knex": "^3.2.5",
     "mongoose": "^9.3.2",