@simplysm/sd-cli 13.0.0-beta.45 → 13.0.0-beta.47

package/src/builders/DtsBuilder.ts

@@ -0,0 +1,138 @@
+import type * as DtsWorkerModule from "../workers/dts.worker";
+import type { BuildResult } from "../infra/ResultCollector";
+import type { TypecheckEnv } from "../utils/tsconfig";
+import type { BuildEventData, ErrorEventData } from "../utils/worker-events";
+import { BaseBuilder } from "./BaseBuilder";
+import type { PackageInfo } from "./types";
+
+/**
+ * .d.ts 파일 생성을 담당하는 Builder
+ *
+ * Library 패키지의 TypeScript 선언 파일 생성을 처리한다.
+ * Watch 모드와 프로덕션 빌드를 모두 지원한다.
+ */
+export class DtsBuilder extends BaseBuilder {
+  private readonly _workerPath: string;
+
+  constructor(options: ConstructorParameters<typeof BaseBuilder>[0]) {
+    super(options);
+    this._workerPath = import.meta.resolve("../workers/dts.worker");
+  }
+
+  protected getBuilderType(): string {
+    return "dts";
+  }
+
+  /**
+   * 패키지 타겟에서 TypecheckEnv 결정
+   */
+  private _getEnv(pkg: PackageInfo): TypecheckEnv {
+    const target = pkg.config.target;
+    if (target === "node") return "node";
+    return "browser"; // browser, neutral, client 모두 browser 환경
+  }
+
+  protected createWorkers(): void {
+    for (const pkg of this.packages) {
+      this.workerManager.create<typeof DtsWorkerModule>(`${pkg.name}:dts`, this._workerPath);
+    }
+  }
+
+  protected registerEventHandlers(): void {
+    for (const pkg of this.packages) {
+      const worker = this.workerManager.get<typeof DtsWorkerModule>(`${pkg.name}:dts`)!;
+      const resultKey = `${pkg.name}:dts`;
+      const listrTitle = `${pkg.name} (dts)`;
+
+      let isInitialBuild = true;
+
+      // 빌드 시작 (리빌드 시)
+      worker.on("buildStart", () => {
+        if (!isInitialBuild && this.rebuildManager != null) {
+          const resolver = this.rebuildManager.registerBuild(resultKey, listrTitle);
+          this.buildResolvers.set(resultKey, resolver);
+        }
+      });
+
+      // 빌드 완료
+      worker.on("build", (data) => {
+        const event = data as BuildEventData;
+        const result: BuildResult = {
+          name: pkg.name,
+          target: pkg.config.target,
+          type: "dts",
+          status: event.success ? "success" : "error",
+          message: event.errors?.join("\n"),
+        };
+        this.resultCollector.add(result);
+
+        if (isInitialBuild) {
+          isInitialBuild = false;
+        }
+        this.completeBuild(pkg);
+      });
+
+      // 에러
+      worker.on("error", (data) => {
+        const event = data as ErrorEventData;
+        const result: BuildResult = {
+          name: pkg.name,
+          target: pkg.config.target,
+          type: "dts",
+          status: "error",
+          message: event.message,
+        };
+        this.resultCollector.add(result);
+
+        if (isInitialBuild) {
+          isInitialBuild = false;
+        }
+        this.completeBuild(pkg);
+      });
+    }
+  }
+
+  protected async buildPackage(pkg: PackageInfo): Promise<void> {
+    const worker = this.workerManager.get<typeof DtsWorkerModule>(`${pkg.name}:dts`)!;
+
+    const buildPromise = new Promise<void>((resolve) => {
+      const originalResolver = this.buildResolvers.get(`${pkg.name}:dts`);
+      this.buildResolvers.set(`${pkg.name}:dts`, () => {
+        originalResolver?.();
+        resolve();
+      });
+    });
+
+    void worker.startDtsWatch({
+      name: pkg.name,
+      cwd: this.cwd,
+      pkgDir: pkg.dir,
+      env: this._getEnv(pkg),
+    });
+
+    await buildPromise;
+  }
+
+  protected startWatchPackage(pkg: PackageInfo): void {
+    const worker = this.workerManager.get<typeof DtsWorkerModule>(`${pkg.name}:dts`)!;
+
+    worker
+      .startDtsWatch({
+        name: pkg.name,
+        cwd: this.cwd,
+        pkgDir: pkg.dir,
+        env: this._getEnv(pkg),
+      })
+      .catch((err: unknown) => {
+        const result: BuildResult = {
+          name: pkg.name,
+          target: pkg.config.target,
+          type: "dts",
+          status: "error",
+          message: err instanceof Error ? err.message : String(err),
+        };
+        this.resultCollector.add(result);
+        this.completeBuild(pkg);
+      });
+  }
+}

package/src/builders/LibraryBuilder.ts

@@ -0,0 +1,161 @@
+import type * as LibraryWorkerModule from "../workers/library.worker";
+import type { BuildResult } from "../infra/ResultCollector";
+import type { SdBuildPackageConfig } from "../sd-config.types";
+import type { BuildEventData, ErrorEventData } from "../utils/worker-events";
+import { BaseBuilder } from "./BaseBuilder";
+import type { PackageInfo } from "./types";
+
+/**
+ * Library 패키지 빌드를 담당하는 Builder
+ *
+ * node/browser/neutral 타겟 패키지의 esbuild 빌드를 처리한다.
+ * Watch 모드와 프로덕션 빌드를 모두 지원한다.
+ */
+export class LibraryBuilder extends BaseBuilder {
+  private readonly _workerPath: string;
+
+  constructor(options: ConstructorParameters<typeof BaseBuilder>[0]) {
+    super(options);
+    this._workerPath = import.meta.resolve("../workers/library.worker");
+  }
+
+  protected getBuilderType(): string {
+    return "build";
+  }
+
+  protected createWorkers(): void {
+    for (const pkg of this.packages) {
+      this.workerManager.create<typeof LibraryWorkerModule>(`${pkg.name}:build`, this._workerPath);
+    }
+  }
+
+  protected registerEventHandlers(): void {
+    for (const pkg of this.packages) {
+      const worker = this.workerManager.get<typeof LibraryWorkerModule>(`${pkg.name}:build`)!;
+      const resultKey = `${pkg.name}:build`;
+      const listrTitle = `${pkg.name} (${pkg.config.target})`;
+
+      // 초기 빌드 여부 추적
+      let isInitialBuild = true;
+
+      // 빌드 시작 (리빌드 시)
+      worker.on("buildStart", () => {
+        if (!isInitialBuild && this.rebuildManager != null) {
+          // 리빌드 시 RebuildListrManager에 등록
+          const resolver = this.rebuildManager.registerBuild(resultKey, listrTitle);
+          this.buildResolvers.set(resultKey, resolver);
+        }
+      });
+
+      // 빌드 완료
+      worker.on("build", (data) => {
+        const event = data as BuildEventData;
+        const result: BuildResult = {
+          name: pkg.name,
+          target: pkg.config.target,
+          type: "build",
+          status: event.success ? "success" : "error",
+          message: event.errors?.join("\n"),
+        };
+        this.resultCollector.add(result);
+
+        if (isInitialBuild) {
+          isInitialBuild = false;
+        }
+        this.completeBuild(pkg);
+      });
+
+      // 에러
+      worker.on("error", (data) => {
+        const event = data as ErrorEventData;
+        const result: BuildResult = {
+          name: pkg.name,
+          target: pkg.config.target,
+          type: "build",
+          status: "error",
+          message: event.message,
+        };
+        this.resultCollector.add(result);
+
+        if (isInitialBuild) {
+          isInitialBuild = false;
+        }
+        this.completeBuild(pkg);
+      });
+    }
+  }
+
+  protected async buildPackage(pkg: PackageInfo): Promise<void> {
+    const worker = this.workerManager.get<typeof LibraryWorkerModule>(`${pkg.name}:build`)!;
+
+    // 빌드 완료 Promise 생성
+    const buildPromise = new Promise<void>((resolve) => {
+      const originalResolver = this.buildResolvers.get(`${pkg.name}:build`);
+      this.buildResolvers.set(`${pkg.name}:build`, () => {
+        originalResolver?.();
+        resolve();
+      });
+    });
+
+    // 빌드 시작 (await 없이 - 이벤트로 완료 감지)
+    // LibraryBuilder는 library 패키지(node/browser/neutral)만 받으므로 캐스팅 안전
+    void worker.startWatch({
+      name: pkg.name,
+      config: pkg.config as SdBuildPackageConfig,
+      cwd: this.cwd,
+      pkgDir: pkg.dir,
+    });
+
+    await buildPromise;
+  }
+
+  protected startWatchPackage(pkg: PackageInfo): void {
+    const worker = this.workerManager.get<typeof LibraryWorkerModule>(`${pkg.name}:build`)!;
+
+    // LibraryBuilder는 library 패키지(node/browser/neutral)만 받으므로 캐스팅 안전
+    worker
+      .startWatch({
+        name: pkg.name,
+        config: pkg.config as SdBuildPackageConfig,
+        cwd: this.cwd,
+        pkgDir: pkg.dir,
+      })
+      .catch((err: unknown) => {
+        const result: BuildResult = {
+          name: pkg.name,
+          target: pkg.config.target,
+          type: "build",
+          status: "error",
+          message: err instanceof Error ? err.message : String(err),
+        };
+        this.resultCollector.add(result);
+        this.completeBuild(pkg);
+      });
+  }
+
+  /**
+   * Graceful shutdown (esbuild context dispose)
+   */
+  override async shutdown(): Promise<void> {
+    const shutdownTimeout = 3000;
+
+    // 각 Worker의 stopWatch 메서드 호출 후 terminate
+    await Promise.all(
+      this.workerManager.ids.map(async (id) => {
+        const worker = this.workerManager.get<typeof LibraryWorkerModule>(id);
+        if (worker != null) {
+          try {
+            await Promise.race([
+              worker.stopWatch(),
+              new Promise<void>((resolve) => setTimeout(resolve, shutdownTimeout)),
+            ]);
+          } catch {
+            // stopWatch 실패해도 계속 진행
+          }
+        }
+      }),
+    );
+
+    await super.shutdown();
+  }
+}

package/src/builders/index.ts

@@ -0,0 +1,4 @@
+export type { IBuilder, PackageInfo, BuilderOptions } from "./types";
+export { BaseBuilder } from "./BaseBuilder";
+export { LibraryBuilder } from "./LibraryBuilder";
+export { DtsBuilder } from "./DtsBuilder";

package/src/builders/types.ts

@@ -0,0 +1,55 @@
+import type { SdPackageConfig } from "../sd-config.types";
+import type { ResultCollector } from "../infra/ResultCollector";
+import type { RebuildListrManager } from "../utils/listr-manager";
+
+/**
+ * 패키지 정보
+ */
+export interface PackageInfo {
+  name: string;
+  dir: string;
+  config: SdPackageConfig;
+}
+
+/**
+ * Builder 공통 옵션
+ */
+export interface BuilderOptions {
+  cwd: string;
+  packages: PackageInfo[];
+  resultCollector: ResultCollector;
+  rebuildManager?: RebuildListrManager;
+}
+
+/**
+ * Builder 인터페이스
+ *
+ * 모든 Builder가 구현해야 하는 공통 인터페이스
+ */
+export interface IBuilder {
+  /**
+   * Builder 초기화 (Worker 생성, 이벤트 핸들러 등록)
+   */
+  initialize(): Promise<void>;
+
+  /**
+   * 일회성 빌드 (프로덕션 빌드용)
+   */
+  build(): Promise<void>;
+
+  /**
+   * Watch 모드 시작
+   * Promise는 초기 빌드 완료 시 resolve됨
+   */
+  startWatch(): Promise<void>;
+
+  /**
+   * Builder 종료 (Worker 정리)
+   */
+  shutdown(): Promise<void>;
+
+  /**
+   * 초기 빌드 Promise 맵 반환 (Listr 태스크용)
+   */
+  getInitialBuildPromises(): Map<string, Promise<void>>;
+}