@simplysm/sd-cli 13.0.10 → 13.0.12

package/src/workers/client.worker.ts

@@ -6,6 +6,7 @@ import { consola } from "consola";
 import type { SdClientPackageConfig } from "../sd-config.types";
 import { parseRootTsconfig, getCompilerOptionsForPackage } from "../utils/tsconfig";
 import { createViteConfig } from "../utils/vite-config";
+import { registerCleanupHandlers } from "../utils/worker-utils";
 
 //#region Types
 
@@ -97,25 +98,7 @@ async function cleanup(): Promise<void> {
 // 프로세스 종료 전 리소스 정리 (SIGTERM/SIGINT)
 // 주의: worker.terminate()는 이 핸들러들을 호출하지 않고 즉시 종료됨.
 // 그러나 watch 모드에서 정상 종료는 메인 프로세스의 SIGINT/SIGTERM을 통해 이루어지므로 문제없음.
-process.on("SIGTERM", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
-});
-
-process.on("SIGINT", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
-});
+registerCleanupHandlers(cleanup, logger);
 
 //#endregion
 
@@ -208,6 +191,7 @@ async function startWatch(info: ClientWatchInfo): Promise<void> {
     // 실제 할당된 포트 반환 (config.server.port는 설정값이므로 httpServer에서 실제 포트를 가져옴)
     const address = viteServer.httpServer?.address();
     const actualPort = typeof address === "object" && address != null ? address.port : viteServer.config.server.port;
+
     sender.send("serverReady", { port: actualPort });
   } catch (err) {
     sender.send("error", {

package/src/workers/library.worker.ts

@@ -5,6 +5,7 @@ import { consola } from "consola";
 import type { SdBuildPackageConfig } from "../sd-config.types";
 import { parseRootTsconfig, getPackageSourceFiles, getCompilerOptionsForPackage } from "../utils/tsconfig";
 import { createLibraryEsbuildOptions, getTypecheckEnvFromTarget } from "../utils/esbuild-config";
+import { registerCleanupHandlers } from "../utils/worker-utils";
 
 //#region Types
 
@@ -90,25 +91,7 @@ async function cleanup(): Promise<void> {
 // 프로세스 종료 전 리소스 정리 (SIGTERM/SIGINT)
 // 주의: worker.terminate()는 이 핸들러들을 호출하지 않고 즉시 종료됨.
 // 그러나 watch 모드에서 정상 종료는 메인 프로세스의 SIGINT/SIGTERM을 통해 이루어지므로 문제없음.
-process.on("SIGTERM", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
-});
-
-process.on("SIGINT", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
-});
+registerCleanupHandlers(cleanup, logger);
 
 //#endregion
 

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

@@ -2,6 +2,7 @@ import proxy from "@fastify/http-proxy";
 import { createWorker } from "@simplysm/core-node";
 import { consola } from "consola";
 import net from "net";
+import { registerCleanupHandlers } from "../utils/worker-utils";
 
 //#region Types
 
@@ -53,26 +54,24 @@ async function cleanup(): Promise<void> {
   serverInstance = undefined;
 }
 
-process.on("SIGTERM", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
+// 서버 listen() 이후 발생하는 런타임 에러를 잡아서 custom "error" 이벤트로 전송
+// (이 핸들러가 없으면 worker가 crash만 하고, dev.ts의 buildResolver가 호출되지 않아 listr가 멈춤)
+process.on("uncaughtException", (err) => {
+  logger.error("Server Runtime 미처리 오류", err);
+  sender.send("error", {
+    message: err instanceof Error ? err.message : String(err),
+  });
 });
 
-process.on("SIGINT", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
+process.on("unhandledRejection", (reason) => {
+  logger.error("Server Runtime 미처리 Promise 거부", reason);
+  sender.send("error", {
+    message: reason instanceof Error ? reason.message : String(reason),
+  });
 });
 
+registerCleanupHandlers(cleanup, logger);
+
 /**
  * 포트가 사용 가능한지 확인
  */
@@ -97,7 +96,7 @@ async function findAvailablePort(startPort: number, maxRetries = 20): Promise<nu
       return port;
     }
   }
-  return startPort;
+  throw new Error(`포트 ${startPort}부터 ${startPort + maxRetries - 1}까지 사용 가능한 포트가 없습니다.`);
 }
 
 /**

package/src/workers/server.worker.ts

@@ -10,6 +10,7 @@ import {
   collectUninstalledOptionalPeerDeps,
   collectNativeModuleExternals,
 } from "../utils/esbuild-config";
+import { registerCleanupHandlers } from "../utils/worker-utils";
 
 //#region Types
 
@@ -251,25 +252,7 @@ function generateProductionFiles(info: ServerBuildInfo, externals: string[]): vo
 // 프로세스 종료 전 리소스 정리 (SIGTERM/SIGINT)
 // 주의: worker.terminate()는 이 핸들러들을 호출하지 않고 즉시 종료됨.
 // 그러나 watch 모드에서 정상 종료는 메인 프로세스의 SIGINT/SIGTERM을 통해 이루어지므로 문제없음.
-process.on("SIGTERM", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
-});
-
-process.on("SIGINT", () => {
-  cleanup()
-    .catch((err) => {
-      logger.error("cleanup 실패", err);
-    })
-    .finally(() => {
-      process.exit(0);
-    });
-});
+registerCleanupHandlers(cleanup, logger);
 
 //#endregion
 

package/templates/add-client/__CLIENT__/package.json.hbs

@@ -4,7 +4,7 @@
   "type": "module",
   "private": true,
   "dependencies": {
-    "@simplysm/solid": "~13.0.10",
+    "@simplysm/solid": "~13.0.12",
 {{#if router}}
     "@solidjs/router": "^0.15.4",
 {{/if}}

package/templates/add-server/__SERVER__/package.json.hbs

@@ -4,7 +4,7 @@
   "type": "module",
   "private": true,
   "dependencies": {
-    "@simplysm/core-common": "~13.0.10",
-    "@simplysm/service-server": "~13.0.10"
+    "@simplysm/core-common": "~13.0.12",
+    "@simplysm/service-server": "~13.0.12"
   }
 }

package/templates/init/package.json.hbs

@@ -15,9 +15,9 @@
     "vitest": "vitest"
   },
   "devDependencies": {
-    "@simplysm/sd-cli": "~13.0.10",
-    "@simplysm/claude": "~13.0.10",
-    "@simplysm/lint": "~13.0.10",
+    "@simplysm/sd-cli": "~13.0.12",
+    "@simplysm/claude": "~13.0.12",
+    "@simplysm/lint": "~13.0.12",
     "@types/node": "^20.19.33",
     "eslint": "^9.39.2",
     "prettier": "^3.8.1",

package/dist/utils/listr-manager.d.ts

@@ -1,37 +0,0 @@
-import { EventEmitter } from "node:events";
-import type { consola } from "consola";
-/**
- * RebuildListrManager 이벤트 타입
- */
-interface RebuildListrManagerEvents {
-    batchComplete: [];
-}
-/**
- * 리빌드 시 Listr 실행을 관리하는 클래스
- *
- * 여러 Worker가 동시에 buildStart를 발생시킬 때, 한 번에 하나의 Listr만 실행되도록 보장합니다.
- * 실행 중에 들어온 빌드 요청은 pending에 모아두었다가 현재 배치가 완료되면 다음 배치로 실행합니다.
- *
- * EventEmitter를 확장하여 배치 완료 시 `batchComplete` 이벤트를 발생시킵니다.
- */
-export declare class RebuildListrManager extends EventEmitter<RebuildListrManagerEvents> {
-    private readonly _logger;
-    private _isRunning;
-    private readonly _pendingBuilds;
-    constructor(_logger: ReturnType<typeof consola.withTag>);
-    /**
-     * 빌드를 등록하고 resolver 함수를 반환합니다.
-     *
-     * @param key - 빌드를 식별하는 고유 키 (예: "core-common:build")
-     * @param title - Listr에 표시할 제목 (예: "core-common (node)")
-     * @returns 워커가 빌드 완료 시 호출할 resolver 함수
-     */
-    registerBuild(key: string, title: string): () => void;
-    /**
-     * pending에 있는 빌드들을 모아서 하나의 Listr로 실행합니다.
-     * 실행 중에 들어온 새 빌드는 다음 배치로 넘어갑니다.
-     */
-    private _runBatch;
-}
-export {};
-//# sourceMappingURL=listr-manager.d.ts.map

package/dist/utils/listr-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"listr-manager.d.ts","sourceRoot":"","sources":["../../src/utils/listr-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;GAEG;AACH,UAAU,yBAAyB;IACjC,aAAa,EAAE,EAAE,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,YAAY,CAAC,yBAAyB,CAAC;IAIlE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsF;gBAExF,OAAO,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC;IAIxE;;;;;;OAMG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI;IAgBrD;;;OAGG;YACW,SAAS;CAkCxB"}

package/dist/utils/listr-manager.js

@@ -1,59 +0,0 @@
-import { EventEmitter } from "node:events";
-import { Listr } from "listr2";
-class RebuildListrManager extends EventEmitter {
-  constructor(_logger) {
-    super();
-    this._logger = _logger;
-  }
-  _isRunning = false;
-  _pendingBuilds = /* @__PURE__ */ new Map();
-  /**
-   * 빌드를 등록하고 resolver 함수를 반환합니다.
-   *
-   * @param key - 빌드를 식별하는 고유 키 (예: "core-common:build")
-   * @param title - Listr에 표시할 제목 (예: "core-common (node)")
-   * @returns 워커가 빌드 완료 시 호출할 resolver 함수
-   */
-  registerBuild(key, title) {
-    let resolver;
-    const promise = new Promise((resolve) => {
-      resolver = resolve;
-    });
-    this._pendingBuilds.set(key, { title, promise, resolver });
-    if (!this._isRunning) {
-      void Promise.resolve().then(() => void this._runBatch());
-    }
-    return resolver;
-  }
-  /**
-   * pending에 있는 빌드들을 모아서 하나의 Listr로 실행합니다.
-   * 실행 중에 들어온 새 빌드는 다음 배치로 넘어갑니다.
-   */
-  async _runBatch() {
-    if (this._isRunning || this._pendingBuilds.size === 0) {
-      return;
-    }
-    this._isRunning = true;
-    const batchBuilds = new Map(this._pendingBuilds);
-    this._pendingBuilds.clear();
-    const tasks = Array.from(batchBuilds.entries()).map(([, { title, promise }]) => ({
-      title,
-      task: () => promise
-    }));
-    const listr = new Listr(tasks, { concurrent: true });
-    try {
-      await listr.run();
-      this.emit("batchComplete");
-    } catch (err) {
-      this._logger.error("listr \uC2E4\uD589 \uC911 \uC624\uB958 \uBC1C\uC0DD", { error: String(err) });
-    }
-    this._isRunning = false;
-    if (this._pendingBuilds.size > 0) {
-      void this._runBatch();
-    }
-  }
-}
-export {
-  RebuildListrManager
-};
-//# sourceMappingURL=listr-manager.js.map

package/dist/utils/listr-manager.js.map

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/listr-manager.ts"],
-  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,aAAa;AAkBf,MAAM,4BAA4B,aAAwC;AAAA,EAI/E,YAA6B,SAA6C;AACxE,UAAM;AADqB;AAAA,EAE7B;AAAA,EALQ,aAAa;AAAA,EACJ,iBAAiB,oBAAI,IAA6E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAanH,cAAc,KAAa,OAA2B;AACpD,QAAI;AACJ,UAAM,UAAU,IAAI,QAAc,CAAC,YAAY;AAC7C,iBAAW;AAAA,IACb,CAAC;AAED,SAAK,eAAe,IAAI,KAAK,EAAE,OAAO,SAAS,SAAS,CAAC;AAGzD,QAAI,CAAC,KAAK,YAAY;AACpB,WAAK,QAAQ,QAAQ,EAAE,KAAK,MAAM,KAAK,KAAK,UAAU,CAAC;AAAA,IACzD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,YAA2B;AACvC,QAAI,KAAK,cAAc,KAAK,eAAe,SAAS,GAAG;AACrD;AAAA,IACF;AAEA,SAAK,aAAa;AAGlB,UAAM,cAAc,IAAI,IAAI,KAAK,cAAc;AAC/C,SAAK,eAAe,MAAM;AAG1B,UAAM,QAAQ,MAAM,KAAK,YAAY,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,OAAO,QAAQ,CAAC,OAAO;AAAA,MAC/E;AAAA,MACA,MAAM,MAAM;AAAA,IACd,EAAE;AAEF,UAAM,QAAQ,IAAI,MAAM,OAAO,EAAE,YAAY,KAAK,CAAC;AAEnD,QAAI;AACF,YAAM,MAAM,IAAI;AAEhB,WAAK,KAAK,eAAe;AAAA,IAC3B,SAAS,KAAK;AACZ,WAAK,QAAQ,MAAM,uDAAoB,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,IAC/D;AAEA,SAAK,aAAa;AAGlB,QAAI,KAAK,eAAe,OAAO,GAAG;AAChC,WAAK,KAAK,UAAU;AAAA,IACtB;AAAA,EACF;AACF;",
-  "names": []
-}

package/src/utils/listr-manager.ts

@@ -1,89 +0,0 @@
-import { EventEmitter } from "node:events";
-import { Listr } from "listr2";
-import type { consola } from "consola";
-
-/**
- * RebuildListrManager 이벤트 타입
- */
-interface RebuildListrManagerEvents {
-  batchComplete: [];
-}
-
-/**
- * 리빌드 시 Listr 실행을 관리하는 클래스
- *
- * 여러 Worker가 동시에 buildStart를 발생시킬 때, 한 번에 하나의 Listr만 실행되도록 보장합니다.
- * 실행 중에 들어온 빌드 요청은 pending에 모아두었다가 현재 배치가 완료되면 다음 배치로 실행합니다.
- *
- * EventEmitter를 확장하여 배치 완료 시 `batchComplete` 이벤트를 발생시킵니다.
- */
-export class RebuildListrManager extends EventEmitter<RebuildListrManagerEvents> {
-  private _isRunning = false;
-  private readonly _pendingBuilds = new Map<string, { title: string; promise: Promise<void>; resolver: () => void }>();
-
-  constructor(private readonly _logger: ReturnType<typeof consola.withTag>) {
-    super();
-  }
-
-  /**
-   * 빌드를 등록하고 resolver 함수를 반환합니다.
-   *
-   * @param key - 빌드를 식별하는 고유 키 (예: "core-common:build")
-   * @param title - Listr에 표시할 제목 (예: "core-common (node)")
-   * @returns 워커가 빌드 완료 시 호출할 resolver 함수
-   */
-  registerBuild(key: string, title: string): () => void {
-    let resolver!: () => void;
-    const promise = new Promise<void>((resolve) => {
-      resolver = resolve;
-    });
-
-    this._pendingBuilds.set(key, { title, promise, resolver });
-
-    // Listr가 실행 중이 아니면 다음 tick에 배치 실행
-    if (!this._isRunning) {
-      void Promise.resolve().then(() => void this._runBatch());
-    }
-
-    return resolver;
-  }
-
-  /**
-   * pending에 있는 빌드들을 모아서 하나의 Listr로 실행합니다.
-   * 실행 중에 들어온 새 빌드는 다음 배치로 넘어갑니다.
-   */
-  private async _runBatch(): Promise<void> {
-    if (this._isRunning || this._pendingBuilds.size === 0) {
-      return;
-    }
-
-    this._isRunning = true;
-
-    // 현재 pending을 스냅샷으로 가져옴
-    const batchBuilds = new Map(this._pendingBuilds);
-    this._pendingBuilds.clear();
-
-    // Listr 태스크 생성
-    const tasks = Array.from(batchBuilds.entries()).map(([, { title, promise }]) => ({
-      title,
-      task: () => promise,
-    }));
-
-    const listr = new Listr(tasks, { concurrent: true });
-
-    try {
-      await listr.run();
-      // 배치 완료 이벤트 발생
-      this.emit("batchComplete");
-    } catch (err) {
-      this._logger.error("listr 실행 중 오류 발생", { error: String(err) });
-    }
-
-    this._isRunning = false;
-
-    // 실행 중 새로 들어온 pending이 있으면 다음 배치 실행
-    if (this._pendingBuilds.size > 0) {
-      void this._runBatch();
-    }
-  }
-}