@simplysm/sd-cli 14.0.98 → 14.0.99

package/src/commands/init/init-client.ts

@@ -0,0 +1,155 @@
+import crypto from "crypto";
+import path from "path";
+import { createLogger } from "@simplysm/core-common";
+import { fsx } from "@simplysm/core-node";
+import { generateClient } from "./generators/client";
+import { normalize } from "./normalize";
+import {
+  type FilePatch,
+  patchAppStructure,
+  patchDevService,
+  patchRootPackageJson,
+  patchSdConfig,
+  patchVitestConfig,
+} from "./patch";
+import { promptInitClient } from "./prompts";
+import { recoverWorkspace } from "./recover";
+import type { InitInput, RenderData } from "./types";
+import { validateInitClientInput } from "./validate";
+import { shellSpawn } from "../../utils/shell-spawn";
+
+const logger = createLogger("sd:cli:init-client");
+
+export interface InitClientOptions {
+  cwd: string;
+}
+
+export async function runInitClient(opts: InitClientOptions): Promise<void> {
+  const recovered = await recoverWorkspace(opts.cwd);
+
+  const { client: newClientInput, mobileAppId } = await promptInitClient(
+    recovered.input.mobileAppId != null,
+  );
+  await validateInitClientInput(opts.cwd, newClientInput, recovered.input.clients);
+
+  const mergedInput: InitInput = {
+    ...recovered.input,
+    clients: [...recovered.input.clients, newClientInput],
+    mobileAppId: recovered.input.mobileAppId ?? mobileAppId,
+  };
+  const data: RenderData = {
+    ...normalize(mergedInput),
+    // client-common 은 새로 생성하지 않음 — 실재 여부에 맞춰 신규 클라이언트의 의존 포함 여부 결정
+    hasClientCommon: recovered.hasClientCommonPkg,
+    jwtSecret: crypto.randomBytes(32).toString("hex"),
+  };
+  const client = data.clients[data.clients.length - 1];
+  const outDir = path.resolve(opts.cwd, "packages", client.name);
+
+  //-- mobile 은 루트 package.json 의 description 이 capacitor 앱 표시 이름(appName)으로 들어감
+  if (client.isMobile && data.description.trim().length === 0) {
+    throw new Error(
+      "mobile 클라이언트는 capacitor 앱 표시 이름으로 루트 package.json 의 description 을 사용합니다. description 을 채운 뒤 다시 실행하세요.",
+    );
+  }
+
+  //-- 공유 파일 패치를 메모리에서 준비 (원자성: 전부 준비된 뒤에만 기록)
+  const isFirstMobile =
+    client.isMobile && recovered.input.clients.every((c) => c.type !== "mobile");
+  const needsAppStructure = data.hasAuth && client.hasRouter;
+
+  //-- 기존 라우팅 클라이언트 0개면 기본 메뉴 구조 export("appStructureItems")는
+  //   파일에 남기되 서버 초기화의 import·권한 계산에서 신규 export 로 대체 (init 동등)
+  const isFirstRouterClient = recovered.input.clients.every((c) => !c.hasRouter);
+  const fallbackExportName =
+    isFirstRouterClient && recovered.appStructureExportNames.includes("appStructureItems")
+      ? "appStructureItems"
+      : undefined;
+  const combineExportNames =
+    fallbackExportName != null
+      ? recovered.appStructureExportNames.filter((n) => n !== fallbackExportName)
+      : recovered.appStructureExportNames;
+
+  const patchTargets: { relPath: string; apply: (src: string) => FilePatch }[] = [
+    { relPath: "sd.config.ts", apply: (src) => patchSdConfig(src, data, client) },
+    { relPath: "vitest.config.ts", apply: (src) => patchVitestConfig(src, client) },
+    ...(isFirstMobile
+      ? [{ relPath: "package.json", apply: (src: string) => patchRootPackageJson(src, client) }]
+      : []),
+    ...(needsAppStructure
+      ? [
+          {
+            relPath: "packages/common/src/app-structure.ts",
+            apply: (src: string) => patchAppStructure(src, data, client),
+          },
+          {
+            relPath: "packages/server/src/services/dev.service.ts",
+            apply: (src: string) =>
+              patchDevService(src, combineExportNames, data, client, fallbackExportName),
+          },
+        ]
+      : []),
+  ];
+
+  const writes: { absPath: string; content: string }[] = [];
+  const manualGuides: { relPath: string; snippet: string }[] = [];
+  for (const target of patchTargets) {
+    const absPath = path.resolve(opts.cwd, target.relPath);
+    if (!(await fsx.exists(absPath))) {
+      const r = target.apply("");
+      manualGuides.push({ relPath: target.relPath, snippet: r.snippet });
+      continue;
+    }
+    const r = target.apply(await fsx.read(absPath));
+    if (r.patched != null) {
+      writes.push({ absPath, content: r.patched });
+    } else {
+      manualGuides.push({ relPath: target.relPath, snippet: r.snippet });
+    }
+  }
+
+  logger.info(`클라이언트 패키지 생성 시작: packages/${client.name}`);
+
+  //-- 신규 패키지 생성 (실패 시 생성분 제거 후 중단 — 공유 파일은 아직 미기록)
+  try {
+    await generateClient(opts.cwd, data, client);
+  } catch (err) {
+    try {
+      await fsx.rm(outDir);
+    } catch {
+      const leftovers = await fsx.glob(path.join(outDir, "**/*")).catch(() => []);
+      logger.error(
+        `생성 잔여물 제거 실패 — packages/${client.name} 를 수동 삭제하세요. 남은 항목:\n` +
+          [outDir, ...leftovers].map((p) => `  - ${p}`).join("\n"),
+      );
+    }
+    throw err;
+  }
+
+  //-- 공유 파일 일괄 기록
+  for (const w of writes) {
+    await fsx.write(w.absPath, w.content);
+  }
+
+  logger.info(`클라이언트 패키지 생성 완료: packages/${client.name}`);
+
+  for (const guide of manualGuides) {
+    logger.error(
+      `${guide.relPath} 자동 갱신 실패 — 아래 내용을 직접 반영하세요:\n${guide.snippet}`,
+    );
+  }
+
+  logger.info("의존성 설치 중...");
+  await shellSpawn("pnpm", ["install", "--config.dangerously-allow-all-builds=true"], {
+    cwd: opts.cwd,
+    stdio: "inherit",
+  });
+  logger.info("의존성 설치 완료.");
+
+  if (client.isMobile) {
+    logger.info("다음 단계:");
+    logger.info(
+      `  1. (prod 빌드 필요 시) capacitor 키스토어를 packages/${client.name}/res/ 에 배치 후 sd.config.ts 의 capacitor.platform.android.sign 블록 수동 추가`,
+    );
+  }
+}

package/src/commands/init/normalize.ts

@@ -50,6 +50,7 @@ export function normalize(input: InitInput): NormalizedInput {
     const isMobile = c.type === "mobile";
     const hasRouter = isMobile ? false : c.hasRouter;
     const baseName = name.startsWith("client-") ? name.slice("client-".length) : name;
+    const useSsg = hasRouter && !isMobile && (c.useSsg ?? false);
     return {
       name,
       type: c.type,
@@ -57,7 +58,8 @@ export function normalize(input: InitInput): NormalizedInput {
       isMobile,
       appStructureName: `${str.toCamelCase(baseName)}AppStructureItems`,
       needsNgIcons: (hasRouter && hasAuth) || hasDb,
-      useSsg: hasRouter && !isMobile && (c.useSsg ?? false),
+      useSsg,
+      robotsDirective: useSsg ? "Allow: /" : "Disallow: /",
     };
   });
 

package/src/commands/init/patch.ts

@@ -0,0 +1,306 @@
+import ts from "typescript";
+import { findPackagesObject, getPropertyName, getProp } from "./ts-ast";
+import type { ClientSpec, RenderData } from "./types";
+
+/** 공유 파일 1개에 대한 패치 결과 */
+export interface FilePatch {
+  /** 패치 성공 시 새 파일 내용. 앵커 탐색 실패 시 undefined */
+  patched?: string;
+  /** 수동 반영 안내용 스니펫 */
+  snippet: string;
+}
+
+interface TextEdit {
+  start: number;
+  end: number;
+  text: string;
+}
+
+function applyEdits(source: string, edits: TextEdit[]): string {
+  let result = source;
+  for (const edit of [...edits].sort((a, b) => b.start - a.start)) {
+    result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
+  }
+  return result;
+}
+
+function lineStartOf(source: string, pos: number): number {
+  return source.lastIndexOf("\n", pos - 1) + 1;
+}
+
+function parseTs(fileName: string, source: string): ts.SourceFile {
+  return ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true);
+}
+
+//-- sd.config.ts
+
+function buildSdConfigClientBlock(data: RenderData, client: ClientSpec): string {
+  const lines: string[] = [];
+  lines.push(`    "${client.name}": {`);
+  lines.push(`      target: "client",`);
+  if (data.hasServer) {
+    lines.push(`      server: "server",`);
+  }
+  if (client.useSsg) {
+    lines.push(`      prerender: ["/"],`);
+  }
+  if (client.isMobile) {
+    lines.push(`      pwa: false,`);
+    lines.push(`      capacitor: {`);
+    lines.push(`        appId: "${data.mobileAppId}",`);
+    lines.push(`        appName: "${data.description}",`);
+    lines.push(`        icon: "res/icon.png",`);
+    lines.push(`        platform: {`);
+    lines.push(`          android: {},`);
+    lines.push(`        },`);
+    lines.push(`      },`);
+  }
+  lines.push(`    },`);
+  return lines.join("\n") + "\n";
+}
+
+export function patchSdConfig(source: string, data: RenderData, client: ClientSpec): FilePatch {
+  const block = buildSdConfigClientBlock(data, client);
+  const snippet = block;
+
+  const sf = parseTs("sd.config.ts", source);
+  const packagesObj = findPackagesObject(sf);
+  if (packagesObj == null) return { snippet };
+
+  const closeBracePos = packagesObj.getEnd() - 1;
+  const lastProp = packagesObj.properties.at(-1);
+  if (lastProp != null && !source.slice(lastProp.end, closeBracePos).includes(",")) {
+    return { snippet };
+  }
+
+  const insertPos = lineStartOf(source, closeBracePos);
+  return {
+    patched: applyEdits(source, [{ start: insertPos, end: insertPos, text: block }]),
+    snippet,
+  };
+}
+
+//-- vitest.config.ts
+
+function buildVitestProjectBlock(client: ClientSpec): string {
+  return (
+    [
+      `      {`,
+      `        extends: true,`,
+      `        plugins: [sdAngularPlugin({ pkg: "${client.name}" })],`,
+      `        test: {`,
+      `          name: "${client.name}",`,
+      `          setupFiles: ["packages/${client.name}/tests/vitest.setup.ts"],`,
+      `          include: ["packages/${client.name}/tests/**/*.spec.{ts,js,mjs,cjs}"],`,
+      `          browser: {`,
+      `            provider: playwright(),`,
+      `            enabled: true,`,
+      `            headless: true,`,
+      `            screenshotFailures: false,`,
+      `            instances: [{ browser: "chromium", viewport: { width: 1920, height: 1080 } }],`,
+      `          },`,
+      `        },`,
+      `      },`,
+    ].join("\n") + "\n"
+  );
+}
+
+export function patchVitestConfig(source: string, client: ClientSpec): FilePatch {
+  const block = buildVitestProjectBlock(client);
+  const snippet = block;
+
+  const sf = parseTs("vitest.config.ts", source);
+
+  let projectsArray: ts.ArrayLiteralExpression | undefined;
+  const visit = (node: ts.Node): void => {
+    if (projectsArray != null) return;
+    if (
+      ts.isPropertyAssignment(node) &&
+      getPropertyName(node.name) === "projects" &&
+      ts.isArrayLiteralExpression(node.initializer)
+    ) {
+      projectsArray = node.initializer;
+      return;
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(sf);
+  if (projectsArray == null) return { snippet };
+
+  const closeBracketPos = projectsArray.getEnd() - 1;
+  const lastElement = projectsArray.elements.at(-1);
+  if (lastElement != null && !source.slice(lastElement.end, closeBracketPos).includes(",")) {
+    return { snippet };
+  }
+
+  const insertPos = lineStartOf(source, closeBracketPos);
+  return {
+    patched: applyEdits(source, [{ start: insertPos, end: insertPos, text: block }]),
+    snippet,
+  };
+}
+
+//-- 루트 package.json
+
+export function patchRootPackageJson(source: string, client: ClientSpec): FilePatch {
+  const block = `    "run-device": "sd-cli device -t ${client.name}",\n    "-----": "",\n`;
+  const snippet = block;
+
+  const sf = ts.parseJsonText("package.json", source);
+  const rootStmt = sf.statements.at(0);
+  if (rootStmt == null || !ts.isObjectLiteralExpression(rootStmt.expression)) {
+    return { snippet };
+  }
+  const scriptsExpr = getProp(rootStmt.expression, "scripts");
+  if (scriptsExpr == null || !ts.isObjectLiteralExpression(scriptsExpr)) {
+    return { snippet };
+  }
+
+  const separatorProp = scriptsExpr.properties.find(
+    (p) => ts.isPropertyAssignment(p) && getPropertyName(p.name) === "----",
+  );
+  if (separatorProp != null) {
+    const lineEnd = source.indexOf("\n", separatorProp.end);
+    if (lineEnd < 0) return { snippet };
+    const insertPos = lineEnd + 1;
+    return {
+      patched: applyEdits(source, [{ start: insertPos, end: insertPos, text: block }]),
+      snippet,
+    };
+  }
+
+  const replaceDepsProp = scriptsExpr.properties.find(
+    (p) => ts.isPropertyAssignment(p) && getPropertyName(p.name) === "replace-deps",
+  );
+  if (replaceDepsProp != null) {
+    const insertPos = lineStartOf(source, replaceDepsProp.getStart(sf));
+    return {
+      patched: applyEdits(source, [{ start: insertPos, end: insertPos, text: block }]),
+      snippet,
+    };
+  }
+
+  return { snippet };
+}
+
+//-- common/src/app-structure.ts
+
+function buildAppStructureBlock(data: RenderData, client: ClientSpec): string {
+  return `export const ${client.appStructureName}: AppStructureItem[] = [
+  { title: "메인화면", code: "main", isNotMenu: true },
+  { title: "내 정보 수정", code: "my-info", isNotMenu: true },
+
+  {
+    code: "master",
+    title: "기준정보",
+    icon: tablerDatabase,
+    children: [
+      { code: "role-permission", title: "역할/권한", perms: ["use", "edit"] },
+      { code: "${data.userEntityKebab}", title: "${data.userEntityLabel}", perms: ["use", "edit"] },
+    ],
+  },
+  {
+    code: "system",
+    title: "시스템",
+    icon: tablerSettings,
+    children: [
+      { code: "data-log", title: "데이터 변경내역", perms: ["use"] },
+      { code: "system-log", title: "시스템 로그", perms: ["use"] },
+    ],
+  },
+];
+`;
+}
+
+export function patchAppStructure(source: string, data: RenderData, client: ClientSpec): FilePatch {
+  const block = buildAppStructureBlock(data, client);
+  const base = source.endsWith("\n") ? source : `${source}\n`;
+  return { patched: `${base}\n${block}`, snippet: block };
+}
+
+//-- server/src/services/dev.service.ts
+
+export function patchDevService(
+  source: string,
+  existingExportNames: string[],
+  data: RenderData,
+  client: ClientSpec,
+  /** 권한 계산·import 에서 신규 export 로 대체할 기본 export 이름 (기존 라우팅 클라이언트 0개 케이스) */
+  replaceExportName?: string,
+): FilePatch {
+  const combinedNames = [...existingExportNames, client.appStructureName];
+  const combinedExpr =
+    combinedNames.length > 1
+      ? `[${combinedNames.map((n) => `...${n}`).join(", ")}]`
+      : combinedNames[0];
+  const snippet = [
+    `- import 에 ${client.appStructureName} 추가 (from "@${data.workspaceName}/common")`,
+    `- getFlatPermissions 첫 번째 인자를 ${combinedExpr} 로 변경`,
+  ].join("\n");
+
+  const sf = parseTs("dev.service.ts", source);
+
+  //-- ① import 명세자 추가 (대체 대상이 있으면 그 명세자를 신규 이름으로 교체)
+  const moduleName = `@${data.workspaceName}/common`;
+  let importSpecifiers: ts.NodeArray<ts.ImportSpecifier> | undefined;
+  for (const stmt of sf.statements) {
+    if (
+      ts.isImportDeclaration(stmt) &&
+      ts.isStringLiteral(stmt.moduleSpecifier) &&
+      stmt.moduleSpecifier.text === moduleName &&
+      stmt.importClause?.namedBindings != null &&
+      ts.isNamedImports(stmt.importClause.namedBindings) &&
+      stmt.importClause.namedBindings.elements.length > 0
+    ) {
+      importSpecifiers = stmt.importClause.namedBindings.elements;
+      break;
+    }
+  }
+  if (importSpecifiers == null) return { snippet };
+
+  const replaceTarget =
+    replaceExportName != null
+      ? importSpecifiers.find((s) => s.name.text === replaceExportName)
+      : undefined;
+  const importEdit: TextEdit =
+    replaceTarget != null
+      ? {
+          start: replaceTarget.getStart(sf),
+          end: replaceTarget.end,
+          text: client.appStructureName,
+        }
+      : (() => {
+          const lastSpecifier = importSpecifiers[importSpecifiers.length - 1];
+          return {
+            start: lastSpecifier.end,
+            end: lastSpecifier.end,
+            text: `, ${client.appStructureName}`,
+          };
+        })();
+
+  //-- ② getFlatPermissions 첫 번째 인자 교체
+  let permsArg: ts.Expression | undefined;
+  const visit = (node: ts.Node): void => {
+    if (permsArg != null) return;
+    if (
+      ts.isCallExpression(node) &&
+      ts.isIdentifier(node.expression) &&
+      node.expression.text === "getFlatPermissions" &&
+      node.arguments.length > 0
+    ) {
+      permsArg = node.arguments[0];
+      return;
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(sf);
+  if (permsArg == null) return { snippet };
+
+  return {
+    patched: applyEdits(source, [
+      importEdit,
+      { start: permsArg.getStart(sf), end: permsArg.end, text: combinedExpr },
+    ]),
+    snippet,
+  };
+}

package/src/commands/init/prompts.ts

@@ -49,7 +49,7 @@ export async function promptInit(workspaceNameDefault: string): Promise<InitInpu
       });
 
       hasAuth = await confirm({
-        message: "사용자 인증을 사용할까요? (사용자/역할/권한/로그 테이블 부트스트랩)",
+        message: "사용자 인증을 사용할까요? (사용자/역할/권한)",
         default: true,
       });
       if (hasAuth) {
@@ -92,43 +92,12 @@ export async function promptInit(workspaceNameDefault: string): Promise<InitInpu
         : await confirm({ message: "다른 client 를 더 추가할까요?", default: false });
     if (!shouldAdd) break;
 
-    const clientName = await input({
-      message: "client 이름 (예: admin → 자동으로 client-admin):",
-      validate: (v) => KEBAB_CASE_RE.test(v) || "영문 kebab-case 만 허용됩니다.",
-    });
-    const clientType = await select<ClientType>({
-      message: "client 타입:",
-      choices: [
-        { name: "일반 웹", value: "web" },
-        { name: "모바일 (capacitor)", value: "mobile" },
-      ],
-    });
-
-    let hasRouter = false;
-    if (clientType !== "mobile") {
-      hasRouter = await confirm({
-        message: `${clientName}: 라우팅 (@angular/router) 을 쓸까요?`,
-        default: true,
-      });
-    }
-
-    let useSsg = false;
-    if (clientType === "web" && hasRouter) {
-      useSsg = await confirm({
-        message: `${clientName}: SSG (SEO 용 빌드 타임 프리렌더) 를 쓸까요?`,
-        default: false,
-      });
-    }
-
-    clients.push({ name: clientName, type: clientType, hasRouter, useSsg });
+    clients.push(await promptClientSpec());
   }
 
   let mobileAppId: string | undefined;
   if (clients.some((c) => c.type === "mobile")) {
-    mobileAppId = await input({
-      message: "capacitor appId (reverse-DNS, 예: kr.co.example.app):",
-      validate: (v) => APPID_RE.test(v) || "reverse-DNS 형식이어야 합니다.",
-    });
+    mobileAppId = await promptMobileAppId();
   }
 
   return {
@@ -146,3 +115,56 @@ export async function promptInit(workspaceNameDefault: string): Promise<InitInpu
     serverPort,
   };
 }
+
+/** init client — 신규 클라이언트 질문 (워크스페이스에 capacitor appId 가 없고 mobile 이면 appId 질문 포함) */
+export async function promptInitClient(
+  hasExistingMobileAppId: boolean,
+): Promise<{ client: ClientInputSpec; mobileAppId?: string }> {
+  const client = await promptClientSpec();
+
+  let mobileAppId: string | undefined;
+  if (client.type === "mobile" && !hasExistingMobileAppId) {
+    mobileAppId = await promptMobileAppId();
+  }
+
+  return { client, mobileAppId };
+}
+
+async function promptClientSpec(): Promise<ClientInputSpec> {
+  const clientName = await input({
+    message: "client 이름 (예: admin → 자동으로 client-admin):",
+    validate: (v) => KEBAB_CASE_RE.test(v) || "영문 kebab-case 만 허용됩니다.",
+  });
+  const clientType = await select<ClientType>({
+    message: "client 타입:",
+    choices: [
+      { name: "일반 웹", value: "web" },
+      { name: "모바일 (capacitor)", value: "mobile" },
+    ],
+  });
+
+  let hasRouter = false;
+  if (clientType !== "mobile") {
+    hasRouter = await confirm({
+      message: `${clientName}: 라우팅 (@angular/router) 을 쓸까요?`,
+      default: true,
+    });
+  }
+
+  let useSsg = false;
+  if (clientType === "web" && hasRouter) {
+    useSsg = await confirm({
+      message: `${clientName}: SSG (SEO 용 빌드 타임 프리렌더) 를 쓸까요?`,
+      default: false,
+    });
+  }
+
+  return { name: clientName, type: clientType, hasRouter, useSsg };
+}
+
+async function promptMobileAppId(): Promise<string> {
+  return input({
+    message: "capacitor appId (reverse-DNS, 예: kr.co.example.app):",
+    validate: (v) => APPID_RE.test(v) || "reverse-DNS 형식이어야 합니다.",
+  });
+}