@simplysm/sd-cli 13.0.69 → 13.0.71

package/src/workers/server-runtime.worker.ts

@@ -1,157 +1,157 @@
-import proxy from "@fastify/http-proxy";
-import { createWorker } from "@simplysm/core-node";
-import { errorMessage } from "@simplysm/core-common";
-import { consola } from "consola";
-import net from "net";
-import { pathToFileURL } from "url";
-import { registerCleanupHandlers } from "../utils/worker-utils";
-
-//#region Types
-
-/**
- * Server Runtime 시작 정보
- */
-export interface ServerRuntimeStartInfo {
-  mainJsPath: string;
-  clientPorts: Record<string, number>;
-}
-
-/**
- * 서버 준비 이벤트
- */
-export interface ServerRuntimeReadyEvent {
-  port: number;
-}
-
-/**
- * 에러 이벤트
- */
-export interface ServerRuntimeErrorEvent {
-  message: string;
-}
-
-/**
- * Worker 이벤트 타입
- */
-export interface ServerRuntimeWorkerEvents extends Record<string, unknown> {
-  serverReady: ServerRuntimeReadyEvent;
-  error: ServerRuntimeErrorEvent;
-}
-
-//#endregion
-
-const logger = consola.withTag("sd:cli:server-runtime:worker");
-
-/** 서버 인스턴스 (정리 대상) */
-let serverInstance: { close: () => Promise<void> } | undefined;
-
-/**
- * 리소스 정리
- */
-async function cleanup(): Promise<void> {
-  const server = serverInstance;
-  if (server != null) {
-    await server.close();
-  }
-  serverInstance = undefined;
-}
-
-// 서버 listen() 이후 발생하는 런타임 에러를 잡아서 custom "error" 이벤트로 전송
-// (이 핸들러가 없으면 worker가 crash만 하고, dev.ts의 buildResolver가 호출되지 않아 listr가 멈춤)
-process.on("uncaughtException", (err) => {
-  logger.error("Server Runtime 미처리 오류", err);
-  sender.send("error", {
-    message: errorMessage(err),
-  });
-});
-
-process.on("unhandledRejection", (reason) => {
-  logger.error("Server Runtime 미처리 Promise 거부", reason);
-  sender.send("error", {
-    message: errorMessage(reason),
-  });
-});
-
-registerCleanupHandlers(cleanup, logger);
-
-/**
- * 포트가 사용 가능한지 확인
- */
-function isPortAvailable(port: number): Promise<boolean> {
-  return new Promise((resolve) => {
-    const server = net.createServer();
-    server.once("error", () => resolve(false));
-    server.once("listening", () => {
-      server.close(() => resolve(true));
-    });
-    server.listen(port, "0.0.0.0");
-  });
-}
-
-/**
- * 시작 포트부터 사용 가능한 포트를 찾아 반환
- */
-async function findAvailablePort(startPort: number, maxRetries = 20): Promise<number> {
-  for (let i = 0; i < maxRetries; i++) {
-    const port = startPort + i;
-    if (await isPortAvailable(port)) {
-      return port;
-    }
-  }
-  throw new Error(
-    `포트 ${startPort}부터 ${startPort + maxRetries - 1}까지 사용 가능한 포트가 없습니다.`,
-  );
-}
-
-/**
- * Server Runtime 시작
- * main.js를 import하고, Vite proxy를 설정한 후 listen
- */
-async function start(info: ServerRuntimeStartInfo): Promise<void> {
-  try {
-    // main.js import (server 인스턴스를 export해야 함)
-    const module = await import(pathToFileURL(info.mainJsPath).href);
-    const server = module.server;
-
-    if (server == null) {
-      throw new Error("main.js에서 server 인스턴스를 export해야 합니다.");
-    }
-
-    // 서버 인스턴스 저장 (cleanup용)
-    serverInstance = server;
-
-    // 사용 가능한 포트 탐색 (포트 충돌 시 자동 증가)
-    const originalPort = server.options.port;
-    const availablePort = await findAvailablePort(originalPort);
-    if (availablePort !== originalPort) {
-      logger.info(`포트 ${originalPort} 사용 중 → ${availablePort}로 변경`);
-      server.options.port = availablePort;
-    }
-
-    // Vite proxy 설정 (clientPorts가 있는 경우만)
-    for (const [name, port] of Object.entries(info.clientPorts)) {
-      await server.fastify.register(proxy, {
-        prefix: `/${name}`,
-        upstream: `http://127.0.0.1:${port}`,
-        rewritePrefix: `/${name}`,
-        websocket: true,
-      });
-    }
-
-    // 서버 시작
-    await server.listen();
-
-    sender.send("serverReady", { port: server.options.port });
-  } catch (err) {
-    logger.error("Server Runtime 시작 실패", err);
-    sender.send("error", {
-      message: errorMessage(err),
-    });
-  }
-}
-
-const sender = createWorker<{ start: typeof start }, ServerRuntimeWorkerEvents>({
-  start,
-});
-
-export default sender;
+import proxy from "@fastify/http-proxy";
+import { createWorker } from "@simplysm/core-node";
+import { errorMessage } from "@simplysm/core-common";
+import { consola } from "consola";
+import net from "net";
+import { pathToFileURL } from "url";
+import { registerCleanupHandlers } from "../utils/worker-utils";
+
+//#region Types
+
+/**
+ * Server runtime start info
+ */
+export interface ServerRuntimeStartInfo {
+  mainJsPath: string;
+  clientPorts: Record<string, number>;
+}
+
+/**
+ * Server ready event
+ */
+export interface ServerRuntimeReadyEvent {
+  port: number;
+}
+
+/**
+ * Error event
+ */
+export interface ServerRuntimeErrorEvent {
+  message: string;
+}
+
+/**
+ * Worker event types
+ */
+export interface ServerRuntimeWorkerEvents extends Record<string, unknown> {
+  serverReady: ServerRuntimeReadyEvent;
+  error: ServerRuntimeErrorEvent;
+}
+
+//#endregion
+
+const logger = consola.withTag("sd:cli:server-runtime:worker");
+
+/** Server instance (to be cleaned up) */
+let serverInstance: { close: () => Promise<void> } | undefined;
+
+/**
+ * Clean up resources
+ */
+async function cleanup(): Promise<void> {
+  const server = serverInstance;
+  if (server != null) {
+    await server.close();
+  }
+  serverInstance = undefined;
+}
+
+// Catch runtime errors that occur after server listen() and send them as a custom "error" event
+// (Without this handler, the worker will crash but dev.ts's buildResolver won't be called, causing listr to hang)
+process.on("uncaughtException", (err) => {
+  logger.error("Unhandled server runtime error", err);
+  sender.send("error", {
+    message: errorMessage(err),
+  });
+});
+
+process.on("unhandledRejection", (reason) => {
+  logger.error("Unhandled server runtime promise rejection", reason);
+  sender.send("error", {
+    message: errorMessage(reason),
+  });
+});
+
+registerCleanupHandlers(cleanup, logger);
+
+/**
+ * Check if a port is available for use
+ */
+function isPortAvailable(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.once("error", () => resolve(false));
+    server.once("listening", () => {
+      server.close(() => resolve(true));
+    });
+    server.listen(port, "0.0.0.0");
+  });
+}
+
+/**
+ * Find and return an available port starting from the specified port
+ */
+async function findAvailablePort(startPort: number, maxRetries = 20): Promise<number> {
+  for (let i = 0; i < maxRetries; i++) {
+    const port = startPort + i;
+    if (await isPortAvailable(port)) {
+      return port;
+    }
+  }
+  throw new Error(
+    `No available port found between ${startPort} and ${startPort + maxRetries - 1}.`,
+  );
+}
+
+/**
+ * Start Server Runtime
+ * Import main.js, configure Vite proxy, then listen
+ */
+async function start(info: ServerRuntimeStartInfo): Promise<void> {
+  try {
+    // Import main.js (must export a server instance)
+    const module = await import(pathToFileURL(info.mainJsPath).href);
+    const server = module.server;
+
+    if (server == null) {
+      throw new Error("main.js must export a server instance.");
+    }
+
+    // Save server instance (for cleanup)
+    serverInstance = server;
+
+    // Find available port (auto-increment on port conflict)
+    const originalPort = server.options.port;
+    const availablePort = await findAvailablePort(originalPort);
+    if (availablePort !== originalPort) {
+      logger.info(`Port ${originalPort} in use, changing to ${availablePort}`);
+      server.options.port = availablePort;
+    }
+
+    // Configure Vite proxy (only if clientPorts exists)
+    for (const [name, port] of Object.entries(info.clientPorts)) {
+      await server.fastify.register(proxy, {
+        prefix: `/${name}`,
+        upstream: `http://127.0.0.1:${port}`,
+        rewritePrefix: `/${name}`,
+        websocket: true,
+      });
+    }
+
+    // Start server
+    await server.listen();
+
+    sender.send("serverReady", { port: server.options.port });
+  } catch (err) {
+    logger.error("Server Runtime startup failed", err);
+    sender.send("error", {
+      message: errorMessage(err),
+    });
+  }
+}
+
+const sender = createWorker<{ start: typeof start }, ServerRuntimeWorkerEvents>({
+  start,
+});
+
+export default sender;