@simplysm/sd-cli 13.0.10 → 13.0.12

package/src/commands/dev.ts

@@ -1,30 +1,7 @@
-import fs from "fs";
-import path from "path";
-import { Listr } from "listr2";
-import { Worker, type WorkerProxy } from "@simplysm/core-node";
-import type { SdConfig, SdClientPackageConfig, SdServerPackageConfig } from "../sd-config.types";
-import { consola } from "consola";
-import { loadSdConfig } from "../utils/sd-config";
-import { getVersion } from "../utils/build-env";
-import { setupReplaceDeps, watchReplaceDeps, type WatchReplaceDepResult } from "../utils/replace-deps";
-import type * as ClientWorkerModule from "../workers/client.worker";
-import type * as ServerWorkerModule from "../workers/server.worker";
-import type * as ServerRuntimeWorkerModule from "../workers/server-runtime.worker";
-import { Capacitor } from "../capacitor/capacitor";
-import { filterPackagesByTargets, getWatchScopes, type PackageResult } from "../utils/package-utils";
-import { printErrors, printServers } from "../utils/output-utils";
-import { RebuildListrManager } from "../utils/listr-manager";
-import {
-  registerWorkerEventHandlers,
-  type ServerReadyEventData,
-  type ServerBuildEventData,
-  type ErrorEventData,
-} from "../utils/worker-events";
-
-//#region Types
+import { DevOrchestrator, type DevOrchestratorOptions } from "../orchestrators/DevOrchestrator";
 
 /**
- * Dev 명령 옵션
+ * Dev 명령 옵션 (하위 호환성)
  */
 export interface DevOptions {
   /** dev할 패키지 필터 (빈 배열이면 모든 패키지) */
@@ -32,21 +9,6 @@ export interface DevOptions {
   options: string[];
 }
 
-/**
- * Client Worker 정보 (Vite dev server용)
- */
-interface ClientWorkerInfo {
-  name: string;
-  config: SdClientPackageConfig;
-  worker: WorkerProxy<typeof ClientWorkerModule>;
-  isInitialBuild: boolean;
-  buildResolver: (() => void) | undefined;
-}
-
-//#endregion
-
-//#region Main
-
 /**
  * Client 및 Server 패키지를 개발 모드로 실행한다.
  *
@@ -61,550 +23,18 @@ interface ClientWorkerInfo {
  * @returns 종료 시그널 수신 시 resolve
  */
 export async function runDev(options: DevOptions): Promise<void> {
-  const { targets } = options;
-  const cwd = process.cwd();
-  const logger = consola.withTag("sd:cli:dev");
-
-  logger.debug("dev 시작", { targets });
-
-  // sd.config.ts 로드 (dev는 패키지 빌드 정보가 필요하므로 필수)
-  let sdConfig: SdConfig;
-  try {
-    sdConfig = await loadSdConfig({ cwd, dev: true, opt: options.options });
-    logger.debug("sd.config.ts 로드 완료");
-  } catch (err) {
-    consola.error(`sd.config.ts 로드 실패: ${err instanceof Error ? err.message : err}`);
-    process.exitCode = 1;
-    return;
-  }
-
-  // replaceDeps 설정이 있으면 symlink 교체
-  let replaceDepWatcher: WatchReplaceDepResult | undefined;
-  if (sdConfig.replaceDeps != null) {
-    await setupReplaceDeps(cwd, sdConfig.replaceDeps);
-    replaceDepWatcher = await watchReplaceDeps(cwd, sdConfig.replaceDeps);
-  }
-
-  // VER, DEV 환경변수 준비
-  const version = await getVersion(cwd);
-  const baseEnv = { VER: version, DEV: "true" };
-
-  // watchScopes 생성 (루트 package.json에서 scope 추출)
-  const rootPkgJsonPath = path.join(cwd, "package.json");
-  const rootPkgName = JSON.parse(fs.readFileSync(rootPkgJsonPath, "utf-8")).name as string;
-  const watchScopes = getWatchScopes(rootPkgName);
-
-  // targets 필터링
-  const allPackages = filterPackagesByTargets(sdConfig.packages, targets);
-
-  // client/server 패키지만 필터링
-  const serverPackages: Array<{ name: string; config: SdServerPackageConfig }> = [];
-  const clientPackages: Array<{ name: string; config: SdClientPackageConfig }> = [];
-
-  for (const [name, config] of Object.entries(allPackages)) {
-    if (config.target === "server") {
-      serverPackages.push({ name, config });
-    } else if (config.target === "client") {
-      clientPackages.push({ name, config });
-    }
-  }
-
-  if (serverPackages.length === 0 && clientPackages.length === 0) {
-    process.stdout.write("⚠ dev할 client/server 패키지가 없습니다.\n");
-    return;
-  }
-
-  // 서버와 연결된 클라이언트 찾기 (서버가 dev 대상인 경우만)
-  const serverNames = new Set(serverPackages.map(({ name }) => name));
-  const serverClientsMap = new Map<string, string[]>();
-  for (const { name, config } of clientPackages) {
-    if (typeof config.server === "string" && serverNames.has(config.server)) {
-      const clients = serverClientsMap.get(config.server) ?? [];
-      clients.push(name);
-      serverClientsMap.set(config.server, clients);
-    }
-  }
-
-  // Worker 경로
-  const clientWorkerPath = import.meta.resolve("../workers/client.worker");
-  const serverWorkerPath = import.meta.resolve("../workers/server.worker");
-  const serverRuntimeWorkerPath = import.meta.resolve("../workers/server-runtime.worker");
-
-  // 클라이언트가 단독 실행인 경우:
-  // - server가 숫자인 경우
-  // - server가 문자열이지만 해당 서버가 dev 대상이 아닌 경우
-  const standaloneClientWorkers: ClientWorkerInfo[] = clientPackages
-    .filter(
-      ({ config }) =>
-        typeof config.server === "number" || (typeof config.server === "string" && !serverNames.has(config.server)),
-    )
-    .map(({ name, config }) => ({
-      name,
-      config,
-      worker: Worker.create<typeof ClientWorkerModule>(clientWorkerPath),
-      isInitialBuild: true,
-      buildResolver: undefined,
-    }));
-
-  // 서버에 연결된 클라이언트의 Vite Worker (서버가 dev 대상인 경우만)
-  const viteClientWorkers: ClientWorkerInfo[] = clientPackages
-    .filter(({ config }) => typeof config.server === "string" && serverNames.has(config.server))
-    .map(({ name, config }) => ({
-      name,
-      config,
-      worker: Worker.create<typeof ClientWorkerModule>(clientWorkerPath),
-      isInitialBuild: true,
-      buildResolver: undefined,
-    }));
-
-  // 결과 상태 관리
-  const results = new Map<string, PackageResult>();
-
-  // RebuildListrManager 생성
-  const rebuildManager = new RebuildListrManager(logger);
-
-  // 배치 완료 시 에러와 서버 URL 출력
-  rebuildManager.on("batchComplete", () => {
-    printErrors(results);
-    printServers(results, serverClientsMap);
-  });
-
-  // 종료 Promise 생성
-  let resolveTerminate!: () => void;
-  const terminatePromise = new Promise<void>((resolve) => {
-    resolveTerminate = resolve;
-  });
-
-  // 종료 시그널 핸들러 등록
-  const signalHandler = () => {
-    process.off("SIGINT", signalHandler);
-    process.off("SIGTERM", signalHandler);
-    resolveTerminate();
+  const orchestratorOptions: DevOrchestratorOptions = {
+    targets: options.targets,
+    options: options.options,
   };
-  process.on("SIGINT", signalHandler);
-  process.on("SIGTERM", signalHandler);
-
-  // Standalone client 빌드 Promise 미리 생성
-  const standaloneClientBuildPromises = new Map<string, Promise<void>>();
-  for (const workerInfo of standaloneClientWorkers) {
-    standaloneClientBuildPromises.set(
-      workerInfo.name,
-      new Promise<void>((resolve) => {
-        workerInfo.buildResolver = resolve;
-      }),
-    );
-  }
-
-  // Vite client 빌드 Promise 미리 생성 (서버 연결 클라이언트)
-  const viteClientBuildPromises = new Map<string, Promise<void>>();
-  const viteClientReadyPromises = new Map<string, { promise: Promise<void>; resolver: () => void }>();
-  for (const workerInfo of viteClientWorkers) {
-    viteClientBuildPromises.set(
-      workerInfo.name,
-      new Promise<void>((resolve) => {
-        workerInfo.buildResolver = resolve;
-      }),
-    );
-    // Vite 서버 준비 완료 Promise (서버가 클라이언트 포트를 알 때까지 대기)
-    let readyResolver!: () => void;
-    const readyPromise = new Promise<void>((resolve) => {
-      readyResolver = resolve;
-    });
-    viteClientReadyPromises.set(workerInfo.name, { promise: readyPromise, resolver: readyResolver });
-  }
-
-  // Server Build Worker 및 Promise 생성
-  const serverBuildWorkers = new Map<
-    string,
-    {
-      worker: WorkerProxy<typeof ServerWorkerModule>;
-      buildPromise: Promise<void>;
-      buildResolver: () => void;
-      mainJsPath?: string;
-    }
-  >();
-  for (const { name } of serverPackages) {
-    let resolver!: () => void;
-    const promise = new Promise<void>((resolve) => {
-      resolver = resolve;
-    });
-    serverBuildWorkers.set(name, {
-      worker: Worker.create<typeof ServerWorkerModule>(serverWorkerPath),
-      buildPromise: promise,
-      buildResolver: resolver,
-    });
-  }
-
-  // clientPorts 캐시 (서버 재시작 시 재사용)
-  const clientPorts: Record<string, number> = {};
-
-  // Server Runtime Worker (서버당 하나, 재시작 시 교체)
-  const serverRuntimeWorkers = new Map<string, WorkerProxy<typeof ServerRuntimeWorkerModule>>();
 
-  // Server Runtime Promise (초기 서버 시작 완료 대기용)
-  const serverRuntimePromises = new Map<string, { promise: Promise<void>; resolver: () => void }>();
-  for (const { name } of serverPackages) {
-    let resolver!: () => void;
-    const promise = new Promise<void>((resolve) => {
-      resolver = resolve;
-    });
-    serverRuntimePromises.set(name, { promise, resolver });
-  }
-
-  // Standalone client 이벤트 핸들러 등록 및 completeTask 함수 저장
-  const clientCompleteTasks = new Map<string, (result: PackageResult) => void>();
-  for (const workerInfo of standaloneClientWorkers) {
-    const completeTask = registerWorkerEventHandlers(
-      workerInfo,
-      {
-        resultKey: `${workerInfo.name}:build`,
-        listrTitle: `${workerInfo.name} (client)`,
-        resultType: "build",
-      },
-      results,
-      rebuildManager,
-    );
-    clientCompleteTasks.set(workerInfo.name, completeTask);
-
-    // serverReady (Vite dev server)
-    workerInfo.worker.on("serverReady", (data) => {
-      const event = data as ServerReadyEventData;
-      completeTask({
-        name: workerInfo.name,
-        target: workerInfo.config.target,
-        type: "server",
-        status: "server",
-        port: event.port,
-      });
-    });
-  }
-
-  // Vite client (서버 연결) 이벤트 핸들러 등록
-  for (const workerInfo of viteClientWorkers) {
-    const completeTask = registerWorkerEventHandlers(
-      workerInfo,
-      {
-        resultKey: `${workerInfo.name}:build`,
-        listrTitle: `${workerInfo.name} (client)`,
-        resultType: "build",
-      },
-      results,
-      rebuildManager,
-    );
-    clientCompleteTasks.set(workerInfo.name, completeTask);
-
-    // serverReady - Vite 포트를 clientPorts에 저장 (URL은 서버를 통해 출력)
-    workerInfo.worker.on("serverReady", (data) => {
-      const event = data as ServerReadyEventData;
-      clientPorts[workerInfo.name] = event.port;
-      // Vite 서버 준비 완료 알림 (서버가 프록시 설정을 위해 대기 중)
-      viteClientReadyPromises.get(workerInfo.name)?.resolver();
-      // listr 완료를 위해 completeTask 호출 (Vite는 build 이벤트를 발생시키지 않음)
-      completeTask({
-        name: workerInfo.name,
-        target: workerInfo.config.target,
-        type: "build",
-        status: "success",
-      });
-    });
-  }
-
-  // Server Build Worker 이벤트 핸들러 등록
-  for (const { name } of serverPackages) {
-    const serverBuild = serverBuildWorkers.get(name)!;
-    let isFirstBuild = true;
-
-    serverBuild.worker.on("buildStart", () => {
-      if (!isFirstBuild) {
-        // 리빌드 시 RebuildListrManager에 등록
-        const resolver = rebuildManager.registerBuild(`${name}:server`, `${name} (server)`);
-        serverBuildWorkers.set(name, {
-          ...serverBuild,
-          buildResolver: resolver,
-        });
-      }
-    });
-
-    serverBuild.worker.on("build", async (data) => {
-      const event = data as ServerBuildEventData;
-
-      if (event.success) {
-        // mainJsPath 저장
-        const updatedBuild = serverBuildWorkers.get(name)!;
-        updatedBuild.mainJsPath = event.mainJsPath;
-
-        // 기존 Server Runtime Worker 종료
-        const existingRuntime = serverRuntimeWorkers.get(name);
-        if (existingRuntime != null) {
-          // 서버 재시작 중 메시지 출력
-          consola.info(`[${name}] 서버 재시작 중...`);
-          await existingRuntime.terminate();
-        }
-
-        // 새 Server Runtime Worker 생성 및 시작
-        const runtimeWorker = Worker.create<typeof ServerRuntimeWorkerModule>(serverRuntimeWorkerPath);
-        serverRuntimeWorkers.set(name, runtimeWorker);
-
-        // 이 서버에 연결된 클라이언트들의 Vite 서버가 준비될 때까지 대기
-        const connectedClients = serverClientsMap.get(name) ?? [];
-        const clientReadyPromises = connectedClients
-          .map((clientName) => viteClientReadyPromises.get(clientName)?.promise)
-          .filter((p): p is Promise<void> => p != null);
-        if (clientReadyPromises.length > 0) {
-          await Promise.all(clientReadyPromises);
-        }
-
-        // 이 서버에 연결된 클라이언트 포트 수집
-        const serverClientPorts: Record<string, number> = {};
-        for (const clientName of connectedClients) {
-          if (clientName in clientPorts) {
-            serverClientPorts[clientName] = clientPorts[clientName];
-          }
-        }
-
-        // Server Runtime 이벤트 핸들러
-        runtimeWorker.on("serverReady", (readyData) => {
-          const readyEvent = readyData as ServerReadyEventData;
-          results.set(`${name}:server`, {
-            name,
-            target: "server",
-            type: "server",
-            status: "server",
-            port: readyEvent.port,
-          });
-
-          if (isFirstBuild) {
-            isFirstBuild = false;
-            serverRuntimePromises.get(name)?.resolver();
-          }
-          updatedBuild.buildResolver();
-        });
-
-        runtimeWorker.on("error", (errorData) => {
-          const errorEvent = errorData as ErrorEventData;
-          results.set(`${name}:server`, {
-            name,
-            target: "server",
-            type: "server",
-            status: "error",
-            message: errorEvent.message,
-          });
-
-          if (isFirstBuild) {
-            isFirstBuild = false;
-            serverRuntimePromises.get(name)?.resolver();
-          }
-          updatedBuild.buildResolver();
-        });
-
-        // Server Runtime 시작
-        void runtimeWorker.start({
-          mainJsPath: event.mainJsPath,
-          clientPorts: serverClientPorts,
-        });
-      } else {
-        results.set(`${name}:build`, {
-          name,
-          target: "server",
-          type: "build",
-          status: "error",
-          message: event.errors?.join("\n"),
-        });
+  const orchestrator = new DevOrchestrator(orchestratorOptions);
 
-        if (isFirstBuild) {
-          isFirstBuild = false;
-          serverRuntimePromises.get(name)?.resolver();
-        }
-        serverBuild.buildResolver();
-      }
-    });
-
-    serverBuild.worker.on("error", (data) => {
-      const event = data as ErrorEventData;
-      results.set(`${name}:build`, {
-        name,
-        target: "server",
-        type: "build",
-        status: "error",
-        message: event.message,
-      });
-      if (isFirstBuild) {
-        isFirstBuild = false;
-        serverRuntimePromises.get(name)?.resolver();
-      }
-      serverBuild.buildResolver();
-    });
-  }
-
-  // 초기 빌드 listr (standalone client + vite client + server 빌드)
-  const initialListr = new Listr(
-    [
-      // Standalone client 태스크
-      ...standaloneClientWorkers.map((workerInfo) => ({
-        title: `${workerInfo.name} (client)`,
-        task: () => standaloneClientBuildPromises.get(workerInfo.name) ?? Promise.resolve(),
-      })),
-      // Vite client 태스크 (서버 연결)
-      ...viteClientWorkers.map((workerInfo) => ({
-        title: `${workerInfo.name} (client)`,
-        task: () => viteClientBuildPromises.get(workerInfo.name) ?? Promise.resolve(),
-      })),
-      // Server 빌드 태스크 (빌드 + 런타임 시작)
-      ...serverPackages.map(({ name }) => ({
-        title: `${name} (server)`,
-        task: () => serverRuntimePromises.get(name)?.promise ?? Promise.resolve(),
-      })),
-    ],
-    { concurrent: true },
-  );
-
-  // Standalone client 워커 시작
-  for (const workerInfo of standaloneClientWorkers) {
-    const pkgDir = path.join(cwd, "packages", workerInfo.name);
-    const completeTask = clientCompleteTasks.get(workerInfo.name)!;
-    const clientConfig: SdClientPackageConfig = {
-      ...workerInfo.config,
-      env: { ...baseEnv, ...workerInfo.config.env },
-    };
-    workerInfo.worker
-      .startWatch({
-        name: workerInfo.name,
-        config: clientConfig,
-        cwd,
-        pkgDir,
-        watchScopes,
-      })
-      .catch((err: unknown) => {
-        completeTask({
-          name: workerInfo.name,
-          target: workerInfo.config.target,
-          type: "build",
-          status: "error",
-          message: err instanceof Error ? err.message : String(err),
-        });
-      });
-  }
-
-  // Vite client 워커 시작 (서버 연결) - Vite 자동 포트 사용
-  for (const workerInfo of viteClientWorkers) {
-    const pkgDir = path.join(cwd, "packages", workerInfo.name);
-    const completeTask = clientCompleteTasks.get(workerInfo.name)!;
-    // Vite가 자동으로 포트를 할당하도록 설정
-    const viteConfig: SdClientPackageConfig = {
-      ...workerInfo.config,
-      server: 0, // Vite가 자동으로 포트 할당
-      env: { ...baseEnv, ...workerInfo.config.env },
-    };
-    workerInfo.worker
-      .startWatch({
-        name: workerInfo.name,
-        config: viteConfig,
-        cwd,
-        pkgDir,
-        watchScopes,
-      })
-      .catch((err: unknown) => {
-        completeTask({
-          name: workerInfo.name,
-          target: workerInfo.config.target,
-          type: "build",
-          status: "error",
-          message: err instanceof Error ? err.message : String(err),
-        });
-      });
-  }
-
-  // Server Build 워커 시작
-  for (const { name, config } of serverPackages) {
-    const pkgDir = path.join(cwd, "packages", name);
-    const serverBuild = serverBuildWorkers.get(name)!;
-    serverBuild.worker
-      .startWatch({
-        name,
-        cwd,
-        pkgDir,
-        env: { ...baseEnv, ...config.env },
-        configs: config.configs,
-        externals: config.externals,
-      })
-      .catch((err: unknown) => {
-        results.set(`${name}:build`, {
-          name,
-          target: "server",
-          type: "build",
-          status: "error",
-          message: err instanceof Error ? err.message : String(err),
-        });
-        serverRuntimePromises.get(name)?.resolver();
-        serverBuild.buildResolver();
-      });
-  }
-
-  // listr 실행 (초기 빌드 완료까지 대기)
-  await initialListr.run();
-
-  // Capacitor 초기화 (client 타겟 중 capacitor 설정이 있는 패키지)
-  const capacitorPackages: Array<[string, SdClientPackageConfig]> = [];
-  for (const { name, config } of clientPackages) {
-    if (config.capacitor != null) {
-      capacitorPackages.push([name, config]);
-    }
-  }
-
-  if (capacitorPackages.length > 0) {
-    const capacitorListr = new Listr(
-      capacitorPackages.map(([name, config]) => ({
-        title: `${name} (capacitor)`,
-        task: async () => {
-          const pkgDir = path.join(cwd, "packages", name);
-          try {
-            const cap = await Capacitor.create(pkgDir, config.capacitor!);
-            await cap.initialize();
-            results.set(`${name}:capacitor`, {
-              name,
-              target: "client",
-              type: "capacitor",
-              status: "success",
-            });
-          } catch (err) {
-            results.set(`${name}:capacitor`, {
-              name,
-              target: "client",
-              type: "capacitor",
-              status: "error",
-              message: err instanceof Error ? err.message : String(err),
-            });
-            throw err;
-          }
-        },
-      })),
-      { concurrent: false, exitOnError: false },
-    );
-
-    try {
-      await capacitorListr.run();
-    } catch {
-      // 에러는 results에 이미 기록됨
-    }
+  try {
+    await orchestrator.initialize();
+    await orchestrator.start();
+    await orchestrator.awaitTermination();
+  } finally {
+    await orchestrator.shutdown();
   }
-
-  // 초기 빌드 결과 출력
-  printErrors(results);
-  printServers(results, serverClientsMap);
-
-  // 종료 시그널까지 대기
-  await terminatePromise;
-
-  // Worker 종료 (모든 워커)
-  process.stdout.write("⏳ 종료 중...\n");
-  await Promise.all([
-    ...standaloneClientWorkers.map(({ worker }) => worker.terminate()),
-    ...viteClientWorkers.map(({ worker }) => worker.terminate()),
-    ...[...serverBuildWorkers.values()].map(({ worker }) => worker.terminate()),
-    ...[...serverRuntimeWorkers.values()].map((worker) => worker.terminate()),
-  ]);
-  replaceDepWatcher?.dispose();
-  process.stdout.write("✔ 완료\n");
 }
-
-//#endregion