create-entity-server 0.4.2 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-entity-server",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Create a new entity-server project in one command — like create-react-app or create-vite.",
   "keywords": [
     "entity-server",

package/template/.env.example

@@ -18,7 +18,7 @@ JWT_SECRET=your-jwt-secret-here
 # 비워두면 암호화 비활성화. 설정 시 충분한 길이의 랜덤 문자열 권장.
 # BACKUP_ENCRYPT_KEY=your-backup-encryption-key-here
 
-# Database values (database.json의 ${ENV_VAR}와 매핑)
+# 개발 환경 DB 설정 (database.json의 ${ENV_VAR}와 매핑)
 DB_HOST_DEVELOPMENT=127.0.0.1
 DB_PORT_DEVELOPMENT=3306
 DB_NAME_DEVELOPMENT=your-development-db-name

package/template/scripts/reset-all.sh

@@ -30,6 +30,35 @@ if [ -f .env ]; then
 fi
 LANGUAGE=${LANGUAGE:-ko}
 
+warn_running_server_reload_needed() {
+    local run_pid_file="$PROJECT_ROOT/.run/entity-server.pid"
+    local server_pid=""
+
+    if [ -f "$run_pid_file" ]; then
+        server_pid=$(cat "$run_pid_file" 2>/dev/null || true)
+    fi
+
+    if [ -n "$server_pid" ] && kill -0 "$server_pid" 2>/dev/null; then
+        echo ""
+        echo "=================================================="
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "⚠️  Entity Server is still running with the previous in-memory API key map."
+            echo "   CLI reset-all updates the DB only, so restart the server before using the new API key:"
+            echo ""
+            echo "   ./scripts/run.sh stop"
+            echo "   ./scripts/run.sh start"
+        else
+            echo "⚠️  Entity Server가 이전 메모리 API 키 맵으로 계속 실행 중입니다."
+            echo "   CLI reset-all 은 DB만 갱신하므로, 새 API 키를 사용하기 전에 서버를 재시작해야 합니다:"
+            echo ""
+            echo "   ./scripts/run.sh stop"
+            echo "   ./scripts/run.sh start"
+        fi
+        echo "=================================================="
+        echo ""
+    fi
+}
+
 get_env_value() {
     local key="$1"
     local value="${!key}"
@@ -196,6 +225,8 @@ case "$1" in
         NEW_HMAC=$(echo "$API_KEY_OUTPUT" | grep -E '^hmac_secret' | awk '{print $NF}' || true)
 
         if [ -n "$NEW_API_KEY" ] && [ -n "$NEW_HMAC" ]; then
+            warn_running_server_reload_needed
+
             # 게이트웨이 .env 자동 업데이트 (개발 환경: entity-app-server/ 폴더가 같은 레벨에 있을 때만)
             GW_DIR="$(dirname "$PROJECT_ROOT")/entity-app-server"
             GW_ENV="$GW_DIR/.env"

package/template/scripts/run.sh

@@ -258,8 +258,14 @@ stop_pid_with_confirm() {
 
 stop_server() {
     if [ ! -f "$PID_FILE" ]; then
+        local port_pid
+        port_pid=$(find_pid_by_port)
+        if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
+            stop_pid_with_confirm "$port_pid" "port"
+            return $?
+        fi
         if is_port_in_use; then
-            show_unmanaged_server_message
+            show_port_in_use_message
             return 0
         fi
         if [ "$LANGUAGE" = "en" ]; then
@@ -274,8 +280,14 @@ stop_server() {
     pid=$(cat "$PID_FILE" 2>/dev/null)
     if [ -z "$pid" ]; then
         rm -f "$PID_FILE"
+        local port_pid
+        port_pid=$(find_pid_by_port)
+        if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
+            stop_pid_with_confirm "$port_pid" "port"
+            return $?
+        fi
         if is_port_in_use; then
-            show_unmanaged_server_message
+            show_port_in_use_message
             return 0
         fi
         if [ "$LANGUAGE" = "en" ]; then
@@ -288,14 +300,24 @@ stop_server() {
 
     if ! kill -0 "$pid" 2>/dev/null; then
         rm -f "$PID_FILE"
+        local port_pid
+        port_pid=$(find_pid_by_port)
+        if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
+            stop_pid_with_confirm "$port_pid" "port"
+            return $?
+        fi
         if is_port_in_use; then
-            show_unmanaged_server_message
+            show_port_in_use_message
             return 0
         fi
         if [ "$LANGUAGE" = "en" ]; then
-            echo "ℹ️  Stale pid file removed (process not found)."
+            echo "ℹ️  Server process already exited (stale pid file removed)."
+            echo "   Last log ($STDOUT_LOG):"
+            tail -5 "$STDOUT_LOG" 2>/dev/null | sed 's/^/   /'
         else
-            echo "ℹ️  실행 중인 프로세스가 없어 stale pid 파일을 정리했습니다."
+            echo "ℹ️  서버 프로세스가 이미 종료되어 있습니다 (stale pid 파일 정리됨)."
+            echo "   최근 로그 ($STDOUT_LOG):"
+            tail -5 "$STDOUT_LOG" 2>/dev/null | sed 's/^/   /'
         fi
         return 0
     fi
@@ -422,7 +444,6 @@ fi
 case "$MODE" in
     dev|development)
         if is_running; then
-            local running_pid
             running_pid=$(find_pid_by_port)
             if [ -n "$running_pid" ]; then
                 if [ "$LANGUAGE" = "en" ]; then
@@ -443,7 +464,6 @@ case "$MODE" in
         
     start)
         if is_running; then
-            local running_pid
             running_pid=$(find_pid_by_port)
             if [ -n "$running_pid" ]; then
                 if [ "$LANGUAGE" = "en" ]; then
@@ -462,11 +482,24 @@ case "$MODE" in
         SERVER_PID=$!
         echo "$SERVER_PID" > "$PID_FILE"
 
-        sleep 0.3
-        if kill -0 "$SERVER_PID" 2>/dev/null; then
+        # 포트가 실제로 Listen 상태가 될 때까지 최대 5초 대기 (25 × 0.2s)
+        start_ok=0
+        for _ in $(seq 1 25); do
+            sleep 0.2
+            if ! kill -0 "$SERVER_PID" 2>/dev/null; then
+                break  # 프로세스 사망
+            fi
+            if is_port_in_use; then
+                start_ok=1
+                break
+            fi
+        done
+
+        if [ "$start_ok" -eq 1 ]; then
             if [ "$LANGUAGE" = "en" ]; then
                 echo "✅ Entity Server started in background (pid: $SERVER_PID)"
                 echo "Status: ./run.sh status"
+                echo "Stop:   ./run.sh stop"
             else
                 echo "✅ Entity Server가 백그라운드에서 시작되었습니다 (pid: $SERVER_PID)"
                 echo "상태: ./run.sh status"
@@ -476,10 +509,12 @@ case "$MODE" in
             rm -f "$PID_FILE"
             if [ "$LANGUAGE" = "en" ]; then
                 echo "❌ Failed to start Entity Server in background"
-                echo "Check logs: $STDOUT_LOG"
+                echo "Last log ($STDOUT_LOG):"
+                tail -20 "$STDOUT_LOG" 2>/dev/null | sed 's/^/  /'
             else
                 echo "❌ Entity Server 백그라운드 시작에 실패했습니다"
-                echo "로그 확인: $STDOUT_LOG"
+                echo "최근 로그 ($STDOUT_LOG):"
+                tail -20 "$STDOUT_LOG" 2>/dev/null | sed 's/^/  /'
             fi
             exit 1
         fi