@simplysm/sd-cli 13.0.0-beta.46 → 13.0.0-beta.48

package/src/sd-cli.ts

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+
+// side-effect: Map/Array 프로토타입 확장 (getOrCreate 등)
+import "@simplysm/core-common";
+import yargs, { type Argv } from "yargs";
+import { hideBin } from "yargs/helpers";
+import { runLint } from "./commands/lint";
+import { runTypecheck } from "./commands/typecheck";
+import { runWatch } from "./commands/watch";
+import { runDev } from "./commands/dev";
+import { runBuild } from "./commands/build";
+import { runPublish } from "./commands/publish";
+import { runDevice } from "./commands/device";
+import path from "path";
+import fs from "fs";
+import { fileURLToPath } from "url";
+import { EventEmitter } from "node:events";
+import { consola, LogLevels } from "consola";
+
+Error.stackTraceLimit = Infinity;
+EventEmitter.defaultMaxListeners = 100;
+
+/**
+ * CLI 파서를 생성한다.
+ * @internal 테스트용으로 export
+ */
+export function createCliParser(argv: string[]): Argv {
+  return yargs(argv)
+    .help("help", "도움말")
+    .alias("help", "h")
+    .option("debug", {
+      type: "boolean",
+      describe: "debug 로그 출력",
+      default: false,
+      global: true,
+    })
+    .middleware((args) => {
+      if (args.debug) consola.level = LogLevels.debug;
+    })
+    .command(
+      "lint [targets..]",
+      "ESLint를 실행한다.",
+      (cmd) =>
+        cmd
+          .version(false)
+          .hide("help")
+          .positional("targets", {
+            type: "string",
+            array: true,
+            describe: "린트할 경로 (예: packages/core-common, tests/orm)",
+            default: [],
+          })
+          .options({
+            fix: {
+              type: "boolean",
+              describe: "자동 수정",
+              default: false,
+            },
+            timing: {
+              type: "boolean",
+              describe: "규칙별 실행 시간 출력",
+              default: false,
+            },
+          }),
+      async (args) => {
+        await runLint({
+          targets: args.targets,
+          fix: args.fix,
+          timing: args.timing,
+        });
+      },
+    )
+    .command(
+      "typecheck [targets..]",
+      "TypeScript 타입체크를 실행한다.",
+      (cmd) =>
+        cmd
+          .version(false)
+          .hide("help")
+          .positional("targets", {
+            type: "string",
+            array: true,
+            describe: "타입체크할 경로 (예: packages/core-common, tests/orm)",
+            default: [],
+          })
+          .options({
+            options: {
+              type: "string",
+              array: true,
+              alias: "o",
+              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              default: [] as string[],
+            },
+          }),
+      async (args) => {
+        await runTypecheck({
+          targets: args.targets,
+          options: args.options,
+        });
+      },
+    )
+    .command(
+      "watch [targets..]",
+      "패키지를 watch 모드로 빌드한다.",
+      (cmd) =>
+        cmd
+          .version(false)
+          .hide("help")
+          .positional("targets", {
+            type: "string",
+            array: true,
+            describe: "watch할 패키지 (예: solid, solid-demo)",
+            default: [],
+          })
+          .options({
+            options: {
+              type: "string",
+              array: true,
+              alias: "o",
+              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              default: [] as string[],
+            },
+          }),
+      async (args) => {
+        await runWatch({
+          targets: args.targets,
+          options: args.options,
+        });
+      },
+    )
+    .command(
+      "dev [targets..]",
+      "Client와 Server 패키지를 개발 모드로 실행한다.",
+      (cmd) =>
+        cmd
+          .version(false)
+          .hide("help")
+          .positional("targets", {
+            type: "string",
+            array: true,
+            describe: "실행할 패키지 (예: solid-demo)",
+            default: [],
+          })
+          .options({
+            options: {
+              type: "string",
+              array: true,
+              alias: "o",
+              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              default: [] as string[],
+            },
+          }),
+      async (args) => {
+        await runDev({
+          targets: args.targets,
+          options: args.options,
+        });
+      },
+    )
+    .command(
+      "build [targets..]",
+      "프로덕션 빌드를 실행한다.",
+      (cmd) =>
+        cmd
+          .version(false)
+          .hide("help")
+          .positional("targets", {
+            type: "string",
+            array: true,
+            describe: "빌드할 패키지 (예: solid, core-common)",
+            default: [],
+          })
+          .options({
+            options: {
+              type: "string",
+              array: true,
+              alias: "o",
+              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              default: [] as string[],
+            },
+          }),
+      async (args) => {
+        await runBuild({
+          targets: args.targets,
+          options: args.options,
+        });
+      },
+    )
+    .command(
+      "device",
+      "Android 디바이스에서 앱을 실행한다.",
+      (cmd) =>
+        cmd
+          .version(false)
+          .hide("help")
+          .options({
+            package: {
+              type: "string",
+              alias: "p",
+              describe: "패키지 이름",
+              demandOption: true,
+            },
+            url: {
+              type: "string",
+              alias: "u",
+              describe: "개발 서버 URL (미지정 시 sd.config.ts의 server 설정 사용)",
+            },
+            options: {
+              type: "string",
+              array: true,
+              alias: "o",
+              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              default: [] as string[],
+            },
+          }),
+      async (args) => {
+        await runDevice({
+          package: args.package,
+          url: args.url,
+          options: args.options,
+        });
+      },
+    )
+    .command(
+      "init",
+      "새 프로젝트를 초기화한다.",
+      (cmd) => cmd.version(false).hide("help"),
+      async () => {
+        const { runInit } = await import("./commands/init.js");
+        await runInit({});
+      },
+    )
+    .command("add", "프로젝트에 패키지를 추가한다.", (cmd) =>
+      cmd
+        .version(false)
+        .hide("help")
+        .command(
+          "client",
+          "클라이언트 패키지를 추가한다.",
+          (subCmd) => subCmd.version(false).hide("help"),
+          async () => {
+            const { runAddClient } = await import("./commands/add-client.js");
+            await runAddClient({});
+          },
+        )
+        .command(
+          "server",
+          "서버 패키지를 추가한다.",
+          (subCmd) => subCmd.version(false).hide("help"),
+          async () => {
+            const { runAddServer } = await import("./commands/add-server.js");
+            await runAddServer({});
+          },
+        )
+        .demandCommand(1, "패키지 타입을 지정해주세요. (client, server)"),
+    )
+    .command(
+      "publish [targets..]",
+      "패키지를 배포한다.",
+      (cmd) =>
+        cmd
+          .version(false)
+          .hide("help")
+          .positional("targets", {
+            type: "string",
+            array: true,
+            describe: "배포할 패키지 (예: solid, core-common)",
+            default: [],
+          })
+          .options({
+            "build": {
+              type: "boolean",
+              describe: "빌드 실행 (--no-build로 스킵)",
+              default: true,
+            },
+            "dry-run": {
+              type: "boolean",
+              describe: "실제 배포 없이 시뮬레이션",
+              default: false,
+            },
+            "options": {
+              type: "string",
+              array: true,
+              alias: "o",
+              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              default: [] as string[],
+            },
+          }),
+      async (args) => {
+        await runPublish({
+          targets: args.targets,
+          noBuild: !args.build,
+          dryRun: args.dryRun,
+          options: args.options,
+        });
+      },
+    )
+    .demandCommand(1, "명령어를 지정해주세요.")
+    .strict();
+}
+
+// CLI로 직접 실행될 때만 파싱 수행
+// ESM에서 메인 모듈 판별: import.meta.url과 process.argv[1]을 정규화하여 비교
+const cliEntryPath = process.argv.at(1);
+if (cliEntryPath != null && fileURLToPath(import.meta.url) === fs.realpathSync(path.resolve(cliEntryPath))) {
+  await createCliParser(hideBin(process.argv)).parse();
+}

package/src/sd-config.types.ts

@@ -0,0 +1,271 @@
+/**
+ * 빌드 타겟 유형 (esbuild로 빌드)
+ * - node: Node.js 전용 패키지
+ * - browser: 브라우저 전용 패키지
+ * - neutral: Node/브라우저 공용 패키지
+ */
+export type BuildTarget = "node" | "browser" | "neutral";
+
+//#region Publish 설정 타입
+
+/**
+ * 패키지 publish 설정
+ * - "npm": npm 레지스트리에 배포
+ * - SdLocalDirectoryPublishConfig: 로컬 디렉토리에 복사
+ * - SdStoragePublishConfig: FTP/FTPS/SFTP 서버에 업로드
+ */
+export type SdPublishConfig = "npm" | SdLocalDirectoryPublishConfig | SdStoragePublishConfig;
+
+/**
+ * 로컬 디렉토리 publish 설정
+ */
+export interface SdLocalDirectoryPublishConfig {
+  type: "local-directory";
+  /** 배포 대상 경로 (환경변수 치환 지원: %VER%, %PROJECT%) */
+  path: string;
+}
+
+/**
+ * 스토리지 (FTP/FTPS/SFTP) publish 설정
+ */
+export interface SdStoragePublishConfig {
+  type: "ftp" | "ftps" | "sftp";
+  host: string;
+  port?: number;
+  path?: string;
+  user?: string;
+  pass?: string;
+}
+
+/**
+ * postPublish 스크립트 설정
+ */
+export interface SdPostPublishScriptConfig {
+  type: "script";
+  cmd: string;
+  /** 스크립트 인자 (환경변수 치환 지원: %VER%, %PROJECT%) */
+  args: string[];
+}
+
+//#endregion
+
+/**
+ * 패키지 설정 (node/browser/neutral)
+ */
+export interface SdBuildPackageConfig {
+  /** 빌드 타겟 */
+  target: BuildTarget;
+  /** publish 설정 */
+  publish?: SdPublishConfig;
+  /** src/에서 dist/로 복사할 파일 glob 패턴 (src/ 기준 상대 경로) */
+  copySrc?: string[];
+}
+
+/**
+ * Capacitor Android 서명 설정
+ */
+export interface SdCapacitorSignConfig {
+  /** keystore 파일 경로 (패키지 디렉토리 기준 상대경로) */
+  keystore: string;
+  /** keystore 비밀번호 */
+  storePassword: string;
+  /** 키 별칭 */
+  alias: string;
+  /** 키 비밀번호 */
+  password: string;
+  /** keystore 타입 (기본값: "jks") */
+  keystoreType?: string;
+}
+
+/**
+ * Capacitor Android 권한 설정
+ */
+export interface SdCapacitorPermission {
+  /** 권한 이름 (예: "CAMERA", "WRITE_EXTERNAL_STORAGE") */
+  name: string;
+  /** 최대 SDK 버전 */
+  maxSdkVersion?: number;
+  /** tools:ignore 속성 값 */
+  ignore?: string;
+}
+
+/**
+ * Capacitor Android Intent Filter 설정
+ */
+export interface SdCapacitorIntentFilter {
+  /** intent action (예: "android.intent.action.VIEW") */
+  action?: string;
+  /** intent category (예: "android.intent.category.DEFAULT") */
+  category?: string;
+}
+
+/**
+ * Capacitor Android 플랫폼 설정
+ */
+export interface SdCapacitorAndroidConfig {
+  /** AndroidManifest.xml application 태그 속성 (예: { requestLegacyExternalStorage: "true" }) */
+  config?: Record<string, string>;
+  /** AAB 번들 빌드 여부 (false면 APK) */
+  bundle?: boolean;
+  /** Intent Filter 설정 */
+  intentFilters?: SdCapacitorIntentFilter[];
+  /** APK/AAB 서명 설정 */
+  sign?: SdCapacitorSignConfig;
+  /** Android SDK 버전 (minSdk, targetSdk) */
+  sdkVersion?: number;
+  /** 추가 권한 설정 */
+  permissions?: SdCapacitorPermission[];
+}
+
+/**
+ * Capacitor 설정
+ */
+export interface SdCapacitorConfig {
+  /** 앱 ID (예: "com.example.app") */
+  appId: string;
+  /** 앱 이름 */
+  appName: string;
+  /** Capacitor 플러그인 설정 (키: 패키지명, 값: true 또는 플러그인 옵션) */
+  plugins?: Record<string, Record<string, unknown> | true>;
+  /** 앱 아이콘 경로 (패키지 디렉토리 기준 상대경로) */
+  icon?: string;
+  /** 디버그 빌드 여부 */
+  debug?: boolean;
+  /** 플랫폼별 설정 */
+  platform?: {
+    android?: SdCapacitorAndroidConfig;
+  };
+}
+
+/**
+ * Electron 설정
+ */
+export interface SdElectronConfig {
+  /** Electron 앱 ID (예: "com.example.myapp") */
+  appId: string;
+  /** portable .exe (true) 또는 NSIS 인스톨러 (false/미지정) */
+  portable?: boolean;
+  /** 인스톨러 아이콘 경로 (.ico, 패키지 디렉토리 기준 상대경로) */
+  installerIcon?: string;
+  /** Electron에 포함할 npm 패키지 (native 모듈 등) */
+  reinstallDependencies?: string[];
+  /** npm postinstall 스크립트 */
+  postInstallScript?: string;
+  /** NSIS 옵션 (portable이 아닌 경우) */
+  nsisOptions?: Record<string, unknown>;
+  /** 환경변수 (electron-main.ts에서 process.env로 접근) */
+  env?: Record<string, string>;
+}
+
+/**
+ * 클라이언트 패키지 설정 (Vite 개발 서버)
+ */
+export interface SdClientPackageConfig {
+  /** 빌드 타겟 */
+  target: "client";
+  /**
+   * 서버 설정
+   * - string: 연결할 서버 패키지명 (예: "solid-demo-server")
+   * - number: Vite 직접 포트 사용 (하위 호환성)
+   */
+  server: string | number;
+  /** 빌드 시 치환할 환경변수 (process.env를 객체로 치환) */
+  env?: Record<string, string>;
+  /** publish 설정 */
+  publish?: SdPublishConfig;
+  /** Capacitor 설정 */
+  capacitor?: SdCapacitorConfig;
+  /** Electron 설정 */
+  electron?: SdElectronConfig;
+  /** runtime config (written to dist/.config.json during build) */
+  configs?: Record<string, unknown>;
+}
+
+/**
+ * 서버 패키지 설정 (Fastify 서버)
+ */
+export interface SdServerPackageConfig {
+  /** 빌드 타겟 */
+  target: "server";
+  /** 빌드 시 치환할 환경변수 (process.env.KEY를 상수로 치환) */
+  env?: Record<string, string>;
+  /** publish 설정 */
+  publish?: SdPublishConfig;
+  /** runtime config (written to dist/.config.json during build) */
+  configs?: Record<string, unknown>;
+  /** esbuild에서 번들에 포함하지 않을 외부 모듈 (binding.gyp 자동 감지에 더해 수동 지정) */
+  externals?: string[];
+  /** PM2 설정 (지정 시 dist/pm2.config.cjs 생성) */
+  pm2?: {
+    /** PM2 프로세스 이름 (미지정 시 package.json name에서 생성) */
+    name?: string;
+    /** PM2 watch에서 제외할 경로 */
+    ignoreWatchPaths?: string[];
+  };
+  /** Package manager to use (affects mise.toml or volta settings generation) */
+  packageManager?: "volta" | "mise";
+}
+
+/**
+ * 스크립트 전용 패키지 설정 (watch/typecheck 제외)
+ */
+export interface SdScriptsPackageConfig {
+  /** 빌드 타겟 */
+  target: "scripts";
+}
+
+/**
+ * 패키지 설정
+ */
+export type SdPackageConfig =
+  | SdBuildPackageConfig
+  | SdClientPackageConfig
+  | SdServerPackageConfig
+  | SdScriptsPackageConfig;
+
+/**
+ * sd.config.ts 설정 타입
+ */
+export interface SdConfig {
+  /** 패키지별 설정 (키: packages/ 하위 디렉토리 이름, 예: "core-common") */
+  packages: Record<string, SdPackageConfig | undefined>;
+  /**
+   * 의존성 교체 설정 (node_modules 패키지를 로컬 소스로 symlink 교체)
+   * - 키: node_modules에서 찾을 패키지 glob 패턴 (예: "@simplysm/*")
+   * - 값: 소스 디렉토리 경로 (키의 * 캡처값이 값의 *에 치환됨)
+   * - 예: { "@simplysm/*": "../simplysm/packages/*" }
+   */
+  replaceDeps?: Record<string, string>;
+  /** 배포 완료 후 실행할 스크립트 */
+  postPublish?: SdPostPublishScriptConfig[];
+}
+
+/**
+ * sd.config.ts 함수에 전달되는 파라미터
+ */
+export interface SdConfigParams {
+  /** 현재 작업 디렉토리 */
+  cwd: string;
+  /** 개발 모드 여부 */
+  dev: boolean;
+  /** 추가 옵션 (CLI의 -o 플래그) */
+  opt: string[];
+}
+
+/**
+ * sd.config.ts는 다음과 같은 형태의 함수를 default export해야 한다:
+ *
+ * ```typescript
+ * import type { SdConfig, SdConfigFn, SdConfigParams } from "@simplysm/sd-cli";
+ *
+ * const config: SdConfigFn = (params: SdConfigParams) => ({
+ *   packages: {
+ *     "core-common": { target: "neutral" },
+ *     "core-node": { target: "node" },
+ *   },
+ * });
+ *
+ * export default config;
+ * ```
+ */
+export type SdConfigFn = (params: SdConfigParams) => SdConfig | Promise<SdConfig>;

package/src/utils/build-env.ts

@@ -0,0 +1,12 @@
+import path from "path";
+import fs from "fs/promises";
+
+/**
+ * 루트 package.json에서 version 가져오기
+ */
+export async function getVersion(cwd: string): Promise<string> {
+  const pkgJsonPath = path.join(cwd, "package.json");
+  const pkgJsonContent = await fs.readFile(pkgJsonPath, "utf-8");
+  const pkgJson = JSON.parse(pkgJsonContent) as { version?: string };
+  return pkgJson.version ?? "0.0.0";
+}