@simplysm/sd-cli 14.0.98 → 14.0.100

package/src/commands/init/recover.ts

@@ -0,0 +1,236 @@
+import path from "path";
+import ts from "typescript";
+import { str } from "@simplysm/core-common";
+import { fsx } from "@simplysm/core-node";
+import { findPackagesObject, getObjectProp, getProp, getPropertyName, getStringProp } from "./ts-ast";
+import type { ClientInputSpec, DbDialect, InitInput } from "./types";
+
+/** 기존 워크스페이스 파일에서 복원한 init 입력 + 부가 정보 */
+export interface RecoveredWorkspace {
+  /** 기존 워크스페이스를 표현하는 init 입력 (clients = 기존 클라이언트 목록) */
+  input: InitInput;
+  /** packages/client-common 패키지 실재 여부 */
+  hasClientCommonPkg: boolean;
+  /** common/src/app-structure.ts 의 실제 export 식별자 목록 (선언 순서) */
+  appStructureExportNames: string[];
+}
+
+export async function recoverWorkspace(cwd: string): Promise<RecoveredWorkspace> {
+  const rootPkg = await readRootPackageJson(cwd);
+  const sdConfig = await parseSdConfig(cwd);
+
+  const clients: ClientInputSpec[] = [];
+  for (const c of sdConfig.clients) {
+    clients.push({
+      name: c.name,
+      type: c.isMobile ? "mobile" : "web",
+      hasRouter: await fsx.exists(path.resolve(cwd, "packages", c.name, "src/routes.ts")),
+      useSsg: c.useSsg,
+    });
+  }
+
+  const commonSrc = path.resolve(cwd, "packages/common/src");
+  const appStructurePath = path.join(commonSrc, "app-structure.ts");
+  const hasAuth = await fsx.exists(appStructurePath);
+
+  let dbContextName: string | undefined;
+  let userEntityName: string | undefined;
+  let userEntityLabel: string | undefined;
+  let appStructureExportNames: string[] = [];
+
+  if (sdConfig.hasDb) {
+    const dbFolderName = await findDbFolderName(commonSrc);
+    dbContextName = str.toCamelCase(dbFolderName.slice("db-".length));
+
+    if (hasAuth) {
+      userEntityName = await findUserEntityName(path.join(commonSrc, dbFolderName));
+    }
+  }
+
+  if (hasAuth) {
+    const appStructureSource = await fsx.read(appStructurePath);
+    const sf = ts.createSourceFile(
+      "app-structure.ts",
+      appStructureSource,
+      ts.ScriptTarget.Latest,
+      true,
+    );
+    appStructureExportNames = findExportedVariableNames(sf);
+    if (userEntityName != null) {
+      userEntityLabel = findMenuTitleByCode(sf, userEntityName);
+      if (userEntityLabel == null) {
+        throw new Error(
+          `common/src/app-structure.ts 에서 사용자 엔티티("${userEntityName}") 메뉴 정의를 찾을 수 없습니다.`,
+        );
+      }
+    }
+  }
+
+  return {
+    input: {
+      workspaceName: rootPkg.workspaceName,
+      description: rootPkg.description,
+      hasServer: sdConfig.hasServer,
+      clients,
+      hasDb: sdConfig.hasDb,
+      dbDialect: sdConfig.dbDialect,
+      dbContextName,
+      hasAuth,
+      userEntityName,
+      userEntityLabel,
+      mobileAppId: sdConfig.mobileAppId,
+      serverPort: sdConfig.serverPort,
+    },
+    hasClientCommonPkg: await fsx.exists(path.resolve(cwd, "packages/client-common")),
+    appStructureExportNames,
+  };
+}
+
+//-- 루트 package.json
+
+async function readRootPackageJson(
+  cwd: string,
+): Promise<{ workspaceName: string; description: string }> {
+  const pkgPath = path.resolve(cwd, "package.json");
+  if (!(await fsx.exists(pkgPath))) {
+    throw new Error(`루트 package.json 을 찾을 수 없습니다: ${pkgPath}`);
+  }
+  const pkg = JSON.parse(await fsx.read(pkgPath)) as { name?: string; description?: string };
+  if (pkg.name == null) {
+    throw new Error("루트 package.json 에 name 이 없습니다.");
+  }
+  return { workspaceName: pkg.name, description: pkg.description ?? "" };
+}
+
+//-- sd.config.ts
+
+interface SdConfigInfo {
+  hasServer: boolean;
+  serverPort?: number;
+  hasDb: boolean;
+  dbDialect?: DbDialect;
+  mobileAppId?: string;
+  clients: { name: string; isMobile: boolean; useSsg: boolean }[];
+}
+
+async function parseSdConfig(cwd: string): Promise<SdConfigInfo> {
+  const configPath = path.resolve(cwd, "sd.config.ts");
+  if (!(await fsx.exists(configPath))) {
+    throw new Error(`sd.config.ts 를 찾을 수 없습니다: ${configPath}`);
+  }
+  const source = await fsx.read(configPath);
+  const sf = ts.createSourceFile("sd.config.ts", source, ts.ScriptTarget.Latest, true);
+
+  const packagesObj = findPackagesObject(sf);
+  if (packagesObj == null) {
+    throw new Error("sd.config.ts 에서 packages 정의를 찾을 수 없습니다.");
+  }
+
+  const info: SdConfigInfo = { hasServer: false, hasDb: false, clients: [] };
+
+  for (const prop of packagesObj.properties) {
+    if (!ts.isPropertyAssignment(prop) || !ts.isObjectLiteralExpression(prop.initializer)) {
+      continue;
+    }
+    const pkgName = getPropertyName(prop.name);
+    if (pkgName == null) continue;
+    const pkgObj = prop.initializer;
+    const target = getStringProp(pkgObj, "target");
+
+    if (target === "server") {
+      info.hasServer = true;
+
+      const envObj = getObjectProp(pkgObj, "env");
+      const portStr = envObj != null ? getStringProp(envObj, "SERVER_PORT") : undefined;
+      if (portStr != null) info.serverPort = Number(portStr);
+
+      const configsObj = getObjectProp(pkgObj, "configs");
+      const ormObj = configsObj != null ? getObjectProp(configsObj, "orm") : undefined;
+      if (ormObj != null) {
+        info.hasDb = true;
+        const firstConn = ormObj.properties.find(
+          (p): p is ts.PropertyAssignment =>
+            ts.isPropertyAssignment(p) && ts.isObjectLiteralExpression(p.initializer),
+        );
+        if (firstConn != null) {
+          info.dbDialect = getStringProp(
+            firstConn.initializer as ts.ObjectLiteralExpression,
+            "dialect",
+          ) as DbDialect | undefined;
+        }
+      }
+    } else if (target === "client") {
+      const capacitorObj = getObjectProp(pkgObj, "capacitor");
+      if (capacitorObj != null && info.mobileAppId == null) {
+        info.mobileAppId = getStringProp(capacitorObj, "appId");
+      }
+      info.clients.push({
+        name: pkgName,
+        isMobile: capacitorObj != null,
+        useSsg: getProp(pkgObj, "prerender") != null,
+      });
+    }
+  }
+
+  return info;
+}
+
+//-- common 패키지 구조
+
+async function findDbFolderName(commonSrc: string): Promise<string> {
+  if (!(await fsx.exists(commonSrc))) {
+    throw new Error(`packages/common/src 를 찾을 수 없습니다: ${commonSrc}`);
+  }
+  const children = await fsx.readdir(commonSrc);
+  const dbFolderName = children.find((c) => c.startsWith("db-"));
+  if (dbFolderName == null) {
+    throw new Error("packages/common/src 에서 DB context 폴더(db-*)를 찾을 수 없습니다.");
+  }
+  return dbFolderName;
+}
+
+async function findUserEntityName(dbFolder: string): Promise<string> {
+  const masterDir = path.join(dbFolder, "tables/master");
+  if (!(await fsx.exists(masterDir))) {
+    throw new Error(`사용자 엔티티 테이블 폴더를 찾을 수 없습니다: ${masterDir}`);
+  }
+  const fileNames = await fsx.readdir(masterDir);
+  for (const fileName of fileNames) {
+    if (!fileName.endsWith(".ts") || fileName.endsWith("-config.ts")) continue;
+    const base = fileName.slice(0, -".ts".length);
+    if (fileNames.includes(`${base}-config.ts`)) return base;
+  }
+  throw new Error(
+    `사용자 엔티티 테이블 쌍(<엔티티>.ts + <엔티티>-config.ts)을 찾을 수 없습니다: ${masterDir}`,
+  );
+}
+
+//-- app-structure.ts
+
+function findExportedVariableNames(sf: ts.SourceFile): string[] {
+  const exportNames: string[] = [];
+  for (const stmt of sf.statements) {
+    if (!ts.isVariableStatement(stmt)) continue;
+    const isExported = stmt.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+    if (isExported !== true) continue;
+    for (const decl of stmt.declarationList.declarations) {
+      if (ts.isIdentifier(decl.name)) exportNames.push(decl.name.text);
+    }
+  }
+  return exportNames;
+}
+
+function findMenuTitleByCode(sf: ts.SourceFile, code: string): string | undefined {
+  let title: string | undefined;
+  const visit = (node: ts.Node): void => {
+    if (title != null) return;
+    if (ts.isObjectLiteralExpression(node) && getStringProp(node, "code") === code) {
+      title = getStringProp(node, "title");
+      if (title != null) return;
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(sf);
+  return title;
+}
+

package/src/commands/init/templates/client/public/robots.txt.hbs

@@ -0,0 +1,2 @@
+User-agent: *
+{{client.robotsDirective}}

package/src/commands/init/templates/client/src/app/home/master/role-permission/role.list.ts.hbs

@@ -86,20 +86,18 @@ const ITEMS_PER_PAGE = 50;
       (restore)="onRestore($event)"
     >
       <ng-template #filterTpl>
-        <div class="form-box-inline">
-          <div>
-            <label>검색어</label>
-            <sd-textfield
-              [type]="'text'"
-              [(value)]="filter().searchText"
-              (valueChange)="mark(filter)"
-            />
-          </div>
-          <div class="form-box-item">
-            <sd-checkbox [(value)]="filter().isIncludeDeleted" (valueChange)="mark(filter)">
-              삭제항목 포함
-            </sd-checkbox>
-          </div>
+        <div>
+          <label>검색어</label>
+          <sd-textfield
+            [type]="'text'"
+            [(value)]="filter().searchText"
+            (valueChange)="mark(filter)"
+          />
+        </div>
+        <div>
+          <sd-checkbox [(value)]="filter().isIncludeDeleted" (valueChange)="mark(filter)">
+            삭제항목 포함
+          </sd-checkbox>
         </div>
       </ng-template>
 

package/src/commands/init/templates/client/src/app/home/master/user.list.ts.hbs

@@ -87,33 +87,31 @@ const ITEMS_PER_PAGE = 50;
       (restore)="onRestore($event)"
     >
       <ng-template #filterTpl>
-        <div class="form-box-inline">
-          <div>
-            <label>검색어</label>
-            <sd-textfield
-              [type]="'text'"
-              [(value)]="filter().searchText"
-              (valueChange)="mark(filter)"
-            />
-          </div>
-          <div>
-            <label>역할</label>
-            <sd-shared-data-select
-              [selectMode]="'multi'"
-              [items]="sharedRoles.items()"
-              [(value)]="filter().roleIds"
-              (valueChange)="mark(filter)"
-            >
-              <ng-template [itemOf]="sharedRoles.items()" let-item="item">
-                \{{ item.name }}
-              </ng-template>
-            </sd-shared-data-select>
-          </div>
-          <div class="form-box-item">
-            <sd-checkbox [(value)]="filter().isIncludeDeleted" (valueChange)="mark(filter)">
-              삭제항목 포함
-            </sd-checkbox>
-          </div>
+        <div>
+          <label>검색어</label>
+          <sd-textfield
+            [type]="'text'"
+            [(value)]="filter().searchText"
+            (valueChange)="mark(filter)"
+          />
+        </div>
+        <div>
+          <label>역할</label>
+          <sd-shared-data-select
+            [selectMode]="'multi'"
+            [items]="sharedRoles.items()"
+            [(value)]="filter().roleIds"
+            (valueChange)="mark(filter)"
+          >
+            <ng-template [itemOf]="sharedRoles.items()" let-item="item">
+              \{{ item.name }}
+            </ng-template>
+          </sd-shared-data-select>
+        </div>
+        <div>
+          <sd-checkbox [(value)]="filter().isIncludeDeleted" (valueChange)="mark(filter)">
+            삭제항목 포함
+          </sd-checkbox>
         </div>
       </ng-template>
 

package/src/commands/init/templates/client/src/app/home/system/data-log/data-log.list.ts.hbs

@@ -74,37 +74,35 @@ const ITEMS_PER_PAGE = 50;
       (filterSubmit)="onFilterSubmit()"
     >
       <ng-template #filterTpl>
-        <div class="form-box-inline">
-          <div>
-            <label>기간</label>
-            <sd-date-range-picker
-              [(from)]="filter().fromDate"
-              (fromChange)="mark(filter)"
-              [(to)]="filter().toDate"
-              (toChange)="mark(filter)"
-            />
-          </div>
-          <div>
-            <label>검색어</label>
-            <sd-textfield
-              [type]="'text'"
-              [(value)]="filter().searchText"
-              (valueChange)="mark(filter)"
-            />
-          </div>
-          <div>
-            <label>수행자</label>
-            <sd-shared-data-select
-              [selectMode]="'multi'"
-              [items]="shared{{userEntityPascal}}s.items()"
-              [(value)]="filter().{{userEntityCamel}}Ids"
-              (valueChange)="mark(filter)"
-            >
-              <ng-template [itemOf]="shared{{userEntityPascal}}s.items()" let-item="item">
-                \{{ item.name }}
-              </ng-template>
-            </sd-shared-data-select>
-          </div>
+        <div>
+          <label>기간</label>
+          <sd-date-range-picker
+            [(from)]="filter().fromDate"
+            (fromChange)="mark(filter)"
+            [(to)]="filter().toDate"
+            (toChange)="mark(filter)"
+          />
+        </div>
+        <div>
+          <label>검색어</label>
+          <sd-textfield
+            [type]="'text'"
+            [(value)]="filter().searchText"
+            (valueChange)="mark(filter)"
+          />
+        </div>
+        <div>
+          <label>수행자</label>
+          <sd-shared-data-select
+            [selectMode]="'multi'"
+            [items]="shared{{userEntityPascal}}s.items()"
+            [(value)]="filter().{{userEntityCamel}}Ids"
+            (valueChange)="mark(filter)"
+          >
+            <ng-template [itemOf]="shared{{userEntityPascal}}s.items()" let-item="item">
+              \{{ item.name }}
+            </ng-template>
+          </sd-shared-data-select>
         </div>
       </ng-template>
 

package/src/commands/init/templates/client/src/app/home/system/system-log/system-log.list.ts.hbs

@@ -82,54 +82,52 @@ type TSeverity = "error" | "warn" | "log";
       (filterSubmit)="onFilterSubmit()"
     >
       <ng-template #filterTpl>
-        <div class="form-box-inline">
-          <div>
-            <label>기간</label>
-            <sd-date-range-picker
-              [(from)]="filter().fromDate"
-              (fromChange)="mark(filter)"
-              [(to)]="filter().toDate"
-              (toChange)="mark(filter)"
-            />
-          </div>
-          <div>
-            <label>심각도</label>
-            <sd-select [(value)]="filter().severity" (valueChange)="mark(filter)">
-              <sd-select-item [value]="undefined">
-                <span class="tx-theme-gray-default">전체</span>
-              </sd-select-item>
-              <sd-select-item [value]="'error'">
-                <sd-label [theme]="'danger'">error</sd-label>
-              </sd-select-item>
-              <sd-select-item [value]="'warn'">
-                <sd-label [theme]="'warning'">warn</sd-label>
-              </sd-select-item>
-              <sd-select-item [value]="'log'">
-                <sd-label [theme]="'gray'">log</sd-label>
-              </sd-select-item>
-            </sd-select>
-          </div>
-          <div>
-            <label>검색어</label>
-            <sd-textfield
-              [type]="'text'"
-              [(value)]="filter().searchText"
-              (valueChange)="mark(filter)"
-            />
-          </div>
-          <div>
-            <label>사용자</label>
-            <sd-shared-data-select
-              [selectMode]="'multi'"
-              [items]="shared{{userEntityPascal}}s.items()"
-              [(value)]="filter().{{userEntityCamel}}Ids"
-              (valueChange)="mark(filter)"
-            >
-              <ng-template [itemOf]="shared{{userEntityPascal}}s.items()" let-item="item">
-                \{{ item.name }}
-              </ng-template>
-            </sd-shared-data-select>
-          </div>
+        <div>
+          <label>기간</label>
+          <sd-date-range-picker
+            [(from)]="filter().fromDate"
+            (fromChange)="mark(filter)"
+            [(to)]="filter().toDate"
+            (toChange)="mark(filter)"
+          />
+        </div>
+        <div>
+          <label>심각도</label>
+          <sd-select [(value)]="filter().severity" (valueChange)="mark(filter)">
+            <sd-select-item [value]="undefined">
+              <span class="tx-theme-gray-default">전체</span>
+            </sd-select-item>
+            <sd-select-item [value]="'error'">
+              <sd-label [theme]="'danger'">error</sd-label>
+            </sd-select-item>
+            <sd-select-item [value]="'warn'">
+              <sd-label [theme]="'warning'">warn</sd-label>
+            </sd-select-item>
+            <sd-select-item [value]="'log'">
+              <sd-label [theme]="'gray'">log</sd-label>
+            </sd-select-item>
+          </sd-select>
+        </div>
+        <div>
+          <label>검색어</label>
+          <sd-textfield
+            [type]="'text'"
+            [(value)]="filter().searchText"
+            (valueChange)="mark(filter)"
+          />
+        </div>
+        <div>
+          <label>사용자</label>
+          <sd-shared-data-select
+            [selectMode]="'multi'"
+            [items]="shared{{userEntityPascal}}s.items()"
+            [(value)]="filter().{{userEntityCamel}}Ids"
+            (valueChange)="mark(filter)"
+          >
+            <ng-template [itemOf]="shared{{userEntityPascal}}s.items()" let-item="item">
+              \{{ item.name }}
+            </ng-template>
+          </sd-shared-data-select>
         </div>
       </ng-template>
 

package/src/commands/init/templates/workspace-root/gitignore

@@ -1,4 +1,12 @@
-.claude
+.claude/sd-*
+.claude/references/sd-*
+.claude/rules/sd-*
+.claude/scripts/sd_*
+.claude/skills/sd-*
+.claude/skills/playwright-cli
+.claude/skills/angular-developer
+.claude/settings.json
+.claude/simplysm.json
 
 .playwright-cli
 __pycache__

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

@@ -0,0 +1,48 @@
+import ts from "typescript";
+
+/** sd.config.ts 의 `packages` 객체 리터럴 탐색 */
+export function findPackagesObject(sf: ts.SourceFile): ts.ObjectLiteralExpression | undefined {
+  let found: ts.ObjectLiteralExpression | undefined;
+  const visit = (node: ts.Node): void => {
+    if (found != null) return;
+    if (
+      ts.isPropertyAssignment(node) &&
+      getPropertyName(node.name) === "packages" &&
+      ts.isObjectLiteralExpression(node.initializer)
+    ) {
+      found = node.initializer;
+      return;
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(sf);
+  return found;
+}
+
+export function getPropertyName(propName: ts.PropertyName): string | undefined {
+  if (ts.isIdentifier(propName) || ts.isStringLiteral(propName)) return propName.text;
+  return undefined;
+}
+
+export function getProp(
+  obj: ts.ObjectLiteralExpression,
+  key: string,
+): ts.Expression | undefined {
+  for (const p of obj.properties) {
+    if (ts.isPropertyAssignment(p) && getPropertyName(p.name) === key) return p.initializer;
+  }
+  return undefined;
+}
+
+export function getObjectProp(
+  obj: ts.ObjectLiteralExpression,
+  key: string,
+): ts.ObjectLiteralExpression | undefined {
+  const expr = getProp(obj, key);
+  return expr != null && ts.isObjectLiteralExpression(expr) ? expr : undefined;
+}
+
+export function getStringProp(obj: ts.ObjectLiteralExpression, key: string): string | undefined {
+  const expr = getProp(obj, key);
+  return expr != null && ts.isStringLiteral(expr) ? expr.text : undefined;
+}

package/src/commands/init/types.ts

@@ -32,6 +32,8 @@ export interface ClientSpec {
   appStructureName: string;
   needsNgIcons: boolean;
   useSsg: boolean;
+  /** robots.txt 지시문 — SSG(SEO) 클라이언트는 전체 허용, 그 외는 전체 차단 */
+  robotsDirective: string;
 }
 
 export interface NormalizedInput {

package/src/commands/init/validate.ts

@@ -1,5 +1,6 @@
+import path from "path";
 import { fsx } from "@simplysm/core-node";
-import type { InitInput } from "./types";
+import type { ClientInputSpec, InitInput } from "./types";
 
 const KEBAB_CASE_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 
@@ -46,3 +47,25 @@ export function validateInput(input: InitInput): void {
     clientNames.add(normalized);
   }
 }
+
+/** init client — 신규 클라이언트가 기존 워크스페이스와 충돌하지 않는지 검증 */
+export async function validateInitClientInput(
+  cwd: string,
+  newClient: ClientInputSpec,
+  existingClients: ClientInputSpec[],
+): Promise<void> {
+  if (!KEBAB_CASE_RE.test(newClient.name)) {
+    throw new Error(`client 이름은 영문 kebab-case 여야 합니다. 입력값: "${newClient.name}"`);
+  }
+
+  const toNormalized = (clientName: string): string =>
+    clientName.startsWith("client-") ? clientName : `client-${clientName}`;
+  const normalized = toNormalized(newClient.name);
+  if (existingClients.some((c) => toNormalized(c.name) === normalized)) {
+    throw new Error(`이미 존재하는 client 입니다: "${normalized}"`);
+  }
+
+  if (await fsx.exists(path.resolve(cwd, "packages", normalized))) {
+    throw new Error(`이미 존재하는 패키지 디렉토리입니다: packages/${normalized}`);
+  }
+}

package/src/esbuild/esbuild-client-config.ts

@@ -175,6 +175,23 @@ export async function createClientEsbuildContext(
     entryNames: isDev ? "[name]" : "[name]-[hash]",
     chunkNames: "[name]-[hash]",
     assetNames: isDev ? "[name]" : "[name]-[hash]",
+    // CSS/SCSS url() 로 참조하는 폰트·이미지 자산을 outdir로 복사하고 url을 출력 경로로 재작성.
+    // esbuild 기본 loader 맵에는 js/ts/css/json/text만 있어, 미설정 시 url(*.woff) 등에서
+    // "No loader is configured" 에러가 발생한다.
+    loader: {
+      ".woff": "file",
+      ".woff2": "file",
+      ".ttf": "file",
+      ".eot": "file",
+      ".otf": "file",
+      ".svg": "file",
+      ".png": "file",
+      ".jpg": "file",
+      ".jpeg": "file",
+      ".gif": "file",
+      ".webp": "file",
+      ".ico": "file",
+    },
     bundle: true,
     splitting: options.legacyModule !== true,
     format: "esm",