@simplysm/sd-cli 13.0.85 → 13.0.87

package/docs/config-types.md

@@ -0,0 +1,253 @@
+# 설정 타입 레퍼런스
+
+`sd.config.ts`에서 사용하는 모든 타입의 상세 레퍼런스.
+
+## SdConfig
+
+`sd.config.ts`의 최상위 설정 타입.
+
+```typescript
+interface SdConfig {
+  packages: Record<string, SdPackageConfig | undefined>;
+  replaceDeps?: Record<string, string>;
+  postPublish?: SdPostPublishScriptConfig[];
+}
+```
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| `packages` | `Record<string, SdPackageConfig>` | 패키지별 설정. 키는 `packages/` 하위 디렉토리명 |
+| `replaceDeps` | `Record<string, string>` | 의존성 교체 설정. 키: glob 패턴, 값: 로컬 경로 (`*` 치환 지원) |
+| `postPublish` | `SdPostPublishScriptConfig[]` | 배포 완료 후 실행할 스크립트 |
+
+### replaceDeps 예시
+
+```typescript
+replaceDeps: {
+  "@simplysm/*": "../simplysm/packages/*"
+}
+// @simplysm/core-common → ../simplysm/packages/core-common 으로 심링크
+```
+
+## SdConfigFn / SdConfigParams
+
+```typescript
+type SdConfigFn = (params: SdConfigParams) => SdConfig | Promise<SdConfig>;
+
+interface SdConfigParams {
+  cwd: string;       // 현재 작업 디렉토리
+  dev: boolean;      // 개발 모드 여부 (dev/watch: true, build/publish: false)
+  options: string[];  // CLI -o 플래그 값 (예: ["key=value"])
+}
+```
+
+## 패키지 설정 타입
+
+### SdBuildPackageConfig
+
+라이브러리 패키지 (node/browser/neutral) 설정.
+
+```typescript
+interface SdBuildPackageConfig {
+  target: "node" | "browser" | "neutral";
+  publish?: SdPublishConfig;
+  copySrc?: string[];
+}
+```
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| `target` | `BuildTarget` | 빌드 대상 플랫폼 |
+| `publish` | `SdPublishConfig` | 배포 설정 |
+| `copySrc` | `string[]` | `src/`에서 `dist/`로 복사할 파일 glob 패턴 (src 기준 상대 경로) |
+
+### SdClientPackageConfig
+
+클라이언트 앱 패키지 설정 (Vite + SolidJS).
+
+```typescript
+interface SdClientPackageConfig {
+  target: "client";
+  server: string | number;
+  env?: Record<string, string>;
+  publish?: SdPublishConfig;
+  capacitor?: SdCapacitorConfig;
+  electron?: SdElectronConfig;
+  configs?: Record<string, unknown>;
+}
+```
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| `target` | `"client"` | 고정값 |
+| `server` | `string \| number` | 서버 패키지명(프록시 연결) 또는 Vite 포트 번호 |
+| `env` | `Record<string, string>` | 빌드 시 `process.env` 치환 값 |
+| `publish` | `SdPublishConfig` | 배포 설정 |
+| `capacitor` | `SdCapacitorConfig` | Capacitor 설정 (모바일 앱) |
+| `electron` | `SdElectronConfig` | Electron 설정 (데스크톱 앱) |
+| `configs` | `Record<string, unknown>` | 런타임 설정 (`dist/.config.json`에 기록) |
+
+### SdServerPackageConfig
+
+서버 앱 패키지 설정 (Fastify).
+
+```typescript
+interface SdServerPackageConfig {
+  target: "server";
+  env?: Record<string, string>;
+  publish?: SdPublishConfig;
+  configs?: Record<string, unknown>;
+  externals?: string[];
+  pm2?: {
+    name?: string;
+    ignoreWatchPaths?: string[];
+  };
+  packageManager?: "volta" | "mise";
+}
+```
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| `target` | `"server"` | 고정값 |
+| `env` | `Record<string, string>` | `process.env.KEY` 치환 값 |
+| `publish` | `SdPublishConfig` | 배포 설정 |
+| `configs` | `Record<string, unknown>` | 런타임 설정 (`dist/.config.json`에 기록) |
+| `externals` | `string[]` | esbuild 번들에서 제외할 외부 모듈 |
+| `pm2` | `object` | PM2 설정 (`dist/pm2.config.cjs` 생성) |
+| `packageManager` | `"volta" \| "mise"` | 패키지 매니저 설정 파일 생성 |
+
+### SdScriptsPackageConfig
+
+스크립트 전용 패키지 (빌드/watch/typecheck 제외).
+
+```typescript
+interface SdScriptsPackageConfig {
+  target: "scripts";
+  publish?: SdPublishConfig;
+}
+```
+
+## 배포 설정 타입
+
+### SdPublishConfig (유니온)
+
+```typescript
+type SdPublishConfig = SdNpmPublishConfig | SdLocalDirectoryPublishConfig | SdStoragePublishConfig;
+```
+
+### SdNpmPublishConfig
+
+```typescript
+interface SdNpmPublishConfig {
+  type: "npm";
+}
+```
+
+### SdLocalDirectoryPublishConfig
+
+```typescript
+interface SdLocalDirectoryPublishConfig {
+  type: "local-directory";
+  path: string;  // %VER%, %PROJECT% 치환 지원
+}
+```
+
+### SdStoragePublishConfig
+
+```typescript
+interface SdStoragePublishConfig {
+  type: "ftp" | "ftps" | "sftp";
+  host: string;
+  port?: number;
+  path?: string;
+  user?: string;
+  password?: string;  // 미지정 시 SSH 키 인증 사용 (SFTP)
+}
+```
+
+### SdPostPublishScriptConfig
+
+```typescript
+interface SdPostPublishScriptConfig {
+  type: "script";
+  cmd: string;
+  args: string[];  // %VER%, %PROJECT% 치환 지원
+}
+```
+
+## Capacitor 설정
+
+### SdCapacitorConfig
+
+```typescript
+interface SdCapacitorConfig {
+  appId: string;       // 예: "com.example.app"
+  appName: string;
+  plugins?: Record<string, Record<string, unknown> | true>;
+  icon?: string;       // 패키지 디렉토리 기준 상대 경로
+  debug?: boolean;
+  platform?: {
+    android?: SdCapacitorAndroidConfig;
+  };
+}
+```
+
+### SdCapacitorAndroidConfig
+
+```typescript
+interface SdCapacitorAndroidConfig {
+  config?: Record<string, string>;    // AndroidManifest application 속성
+  bundle?: boolean;                    // true: AAB, false: APK
+  intentFilters?: SdCapacitorIntentFilter[];
+  sign?: SdCapacitorSignConfig;
+  sdkVersion?: number;                // minSdk, targetSdk
+  permissions?: SdCapacitorPermission[];
+}
+```
+
+### SdCapacitorSignConfig
+
+```typescript
+interface SdCapacitorSignConfig {
+  keystore: string;      // 패키지 디렉토리 기준 상대 경로
+  storePassword: string;
+  alias: string;
+  password: string;
+  keystoreType?: string; // 기본값: "jks"
+}
+```
+
+### SdCapacitorPermission
+
+```typescript
+interface SdCapacitorPermission {
+  name: string;           // 예: "CAMERA"
+  maxSdkVersion?: number;
+  ignore?: string;        // tools:ignore 속성
+}
+```
+
+### SdCapacitorIntentFilter
+
+```typescript
+interface SdCapacitorIntentFilter {
+  action?: string;   // 예: "android.intent.action.VIEW"
+  category?: string; // 예: "android.intent.category.DEFAULT"
+}
+```
+
+## Electron 설정
+
+### SdElectronConfig
+
+```typescript
+interface SdElectronConfig {
+  appId: string;                     // 예: "com.example.myapp"
+  portable?: boolean;                // true: portable .exe, false: NSIS 설치
+  installerIcon?: string;            // .ico 파일 경로
+  reinstallDependencies?: string[];  // Electron에 포함할 npm 패키지
+  postInstallScript?: string;        // npm postinstall 스크립트
+  nsisOptions?: Record<string, unknown>;
+  env?: Record<string, string>;      // electron-main.ts에서 사용할 환경 변수
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-cli",
-  "version": "13.0.85",
+  "version": "13.0.87",
   "description": "Simplysm package - CLI tool",
   "author": "simplysm",
   "license": "Apache-2.0",
@@ -24,7 +24,7 @@
     "@fastify/http-proxy": "^11.4.1",
     "@inquirer/prompts": "^8.3.0",
     "consola": "^3.4.2",
-    "esbuild": "^0.27.3",
+    "esbuild": "^0.27.4",
     "esbuild-plugin-solid": "^0.6.0",
     "eslint": "^9.39.4",
     "execa": "^9.6.1",
@@ -40,12 +40,12 @@
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-pwa": "^1.2.0",
-    "vite-plugin-solid": "^2.11.10",
+    "vite-plugin-solid": "^2.11.11",
     "vite-tsconfig-paths": "^6.1.1",
     "yargs": "^18.0.0",
-    "@simplysm/core-common": "13.0.85",
-    "@simplysm/storage": "13.0.85",
-    "@simplysm/core-node": "13.0.85"
+    "@simplysm/storage": "13.0.87",
+    "@simplysm/core-common": "13.0.87",
+    "@simplysm/core-node": "13.0.87"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",

package/templates/init/.gitignore.hbs

@@ -0,0 +1,35 @@
+.tmp
+.tasks
+.playwright
+.coverage
+__pycache__
+.claude/worktrees
+
+.cache
+node_modules
+packages/*/.*
+packages/*/dist
+packages/sd-claude/claude
+*.~*
+~*.*
+
+signCert.der
+signPri.key
+
+# TypeScript 컴파일 결과물 (소스 디렉토리에서 제외)
+packages/*/src/**/*.js
+packages/*/src/**/*.js.map
+packages/*/src/**/*.d.ts
+!packages/*/src/env.d.ts
+packages/*/src/**/*.d.ts.map
+
+packages/*/tests/**/*.js
+packages/*/tests/**/*.js.map
+packages/*/tests/**/*.d.ts
+!packages/*/tests/vitest-env.d.ts
+packages/*/tests/**/*.d.ts.map
+
+tests/**/*.js
+tests/**/*.js.map
+tests/**/*.d.ts
+tests/**/*.d.ts.map

package/templates/init/.npmrc.hbs

@@ -0,0 +1 @@
+side-effects-cache=false

package/templates/init/mise.toml

@@ -1,3 +1,3 @@
 [tools]
-node = "20.20.0"
-pnpm = "10.30.0"
+node = "20"
+pnpm = "latest"

package/templates/init/package.json.hbs

@@ -14,16 +14,21 @@
     "lint": "sd-cli lint",
     "lint:fix": "sd-cli lint --fix",
     "check": "sd-cli check",
-    "vitest": "vitest"
+    "test": "vitest run",
+    "test:e2e": "vitest run -c vitest-e2e.config.ts",
+    "postinstall": "playwright install && playwright-cli install --skills"
   },
   "devDependencies": {
-    "@simplysm/lint": "~13.0.85",
-    "@simplysm/sd-cli": "~13.0.85",
+    "@simplysm/lint": "~13.0.87",
+    "@simplysm/sd-cli": "~13.0.87",
+    "@simplysm/sd-claude": "~13.0.87",
     "@types/node": "^20.19.35",
     "eslint": "^9.39.3",
     "prettier": "^3.8.1",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^6.1.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "@playwright/cli": "^0.1.1",
+    "playwright": "^1.58.2"
   }
 }

package/templates/init/packages/client-admin/package.json.hbs

@@ -6,12 +6,13 @@
   "private": true,
   "dependencies": {
     "@{{projectName}}/db-main": "workspace:*",
-    "@simplysm/core-browser": "~13.0.85",
-    "@simplysm/core-common": "~13.0.85",
+    "@simplysm/core-browser": "~13.0.87",
+    "@simplysm/core-common": "~13.0.87",
     "@simplysm/excel": "^13.0.71",
-    "@simplysm/orm-common": "~13.0.85",
-    "@simplysm/service-client": "~13.0.85",
-    "@simplysm/solid": "~13.0.85",
+    "@simplysm/orm-common": "~13.0.87",
+    "@simplysm/service-client": "~13.0.87",
+    "@simplysm/service-common": "~13.0.87",
+    "@simplysm/solid": "~13.0.87",
     "@solid-primitives/event-listener": "^2.4.5",
     "@solidjs/router": "^0.15.4",
     "@tabler/icons-solidjs": "^3.37.1",

package/templates/init/packages/client-admin/src/events/AuthChangeEvent.ts

@@ -0,0 +1,3 @@
+import { defineEvent } from "@simplysm/service-common";
+
+export const AuthChangeEvent = defineEvent<{ employeeId: number }, void>("AuthChangeEvent");

package/templates/init/packages/client-admin/src/main.tsx.hbs

@@ -8,7 +8,7 @@ import {
   useLogger,
   useSyncStorage,
 } from "@simplysm/solid";
-import { DateTime, env, jsonStringify } from "@simplysm/core-common";
+import { DateTime, env, json } from "@simplysm/core-common";
 import { expr } from "@{{projectName}}/db-main";
 import { App } from "./App";
 
@@ -85,7 +85,7 @@ function AppRoot() {
       }
 
       try {
-        const message = data.map((d) => (typeof d === "string" ? d : jsonStringify(d))).join(" ");
+        const message = data.map((d) => (typeof d === "string" ? d : json.stringify(d))).join(" ");
 
         await appService.orm.connect(async (db) => {
           await db._log().insert([

package/templates/init/packages/client-admin/src/providers/AppServiceProvider.tsx.hbs

@@ -9,7 +9,7 @@ import {
 import { useServiceClient } from "@simplysm/solid";
 import {
   createOrmClientConnector,
-  type RemoteService,
+  type ServiceProxy,
   type ServiceClient,
 } from "@simplysm/service-client";
 import type {
@@ -20,9 +20,9 @@ import type {
 import { MainDbContext, type MainDbContext as MainDbContextType } from "@{{projectName}}/db-main";
 
 export interface IAppServiceClient {
-  auth: RemoteService<AuthServiceMethods>;
-  dev: RemoteService<DevServiceMethods>;
-  employee: RemoteService<EmployeeServiceMethods>;
+  auth: ServiceProxy<AuthServiceMethods>;
+  dev: ServiceProxy<DevServiceMethods>;
+  employee: ServiceProxy<EmployeeServiceMethods>;
   sc: ServiceClient;
   orm: {
     connect: <R>(

package/templates/init/packages/client-admin/src/providers/AuthProvider.tsx.hbs

@@ -3,11 +3,12 @@ import { createSignal } from "solid-js";
 import { useLocalStorage } from "@simplysm/solid";
 import { useAppService } from "./AppServiceProvider";
 import type { IAuthData } from "@{{projectName}}/server";
+import { AuthChangeEvent } from "../events/AuthChangeEvent";
 
 interface IAuthContextValue {
   authInfo: Accessor<IAuthData | undefined>;
   login: (email: string, password: string) => Promise<void>;
-  logout: () => void;
+  logout: () => Promise<void>;
   tryReloadAuth: () => Promise<boolean>;
 }
 
@@ -18,6 +19,26 @@ export const AuthProvider: ParentComponent = (props) => {
   const [authInfo, setAuthInfo] = createSignal<IAuthData>();
   const [token, setToken] = useLocalStorage<string | undefined>("auth-token");
 
+  let listenerKey: string | undefined;
+
+  const registerAuthEvent = async (employeeId: number) => {
+    await unregisterAuthEvent();
+    listenerKey = await appService.sc.addListener(
+      AuthChangeEvent,
+      { employeeId },
+      async () => {
+        await tryReloadAuth();
+      },
+    );
+  };
+
+  const unregisterAuthEvent = async () => {
+    if (listenerKey != null) {
+      await appService.sc.removeListener(listenerKey);
+      listenerKey = undefined;
+    }
+  };
+
   const login = async (email: string, password: string) => {
     const result = await appService.auth.login(email, password);
 
@@ -26,9 +47,11 @@ export const AuthProvider: ParentComponent = (props) => {
     await appService.sc.auth(newToken);
 
     setAuthInfo(authData);
+    await registerAuthEvent(authData.employeeId);
   };
 
-  const logout = () => {
+  const logout = async () => {
+    await unregisterAuthEvent();
     setToken(undefined);
     setAuthInfo(undefined);
   };
@@ -47,11 +70,13 @@ export const AuthProvider: ParentComponent = (props) => {
       await appService.sc.auth(newToken);
 
       setAuthInfo(authData);
+      await registerAuthEvent(authData.employeeId);
 
       return true;
     } catch (err) {
       // eslint-disable-next-line no-console
       console.warn("Failed to reload auth:", err);
+      await unregisterAuthEvent();
       setToken(undefined);
       return false;
     }

package/templates/init/packages/client-admin/src/providers/configureSharedData.ts.hbs

@@ -25,7 +25,7 @@ export function configureSharedData() {
 
   useSharedData<AppSharedData>().configure((_origin) => ({
     employee: {
-      fetch: async (changeKeys) => {
+      fetch: (changeKeys) => {
         return appService.orm.connect(async (db) => {
           let qr = db.employee().select((item) => ({
             id: item.id,
@@ -36,16 +36,16 @@ export function configureSharedData() {
           if (changeKeys) {
             qr = qr.where((item) => [expr.in(item.id, changeKeys)]);
           }
-          return qr.result();
+          return qr.execute();
         });
       },
       orderBy: [[(item) => item.name, "asc"]],
       getKey: (item) => item.id,
-      getSearchText: (item) => item.name,
-      getIsHidden: (item) => item.isDeleted,
+      getSearchText: (item: EmployeeSharedItem) => item.name,
+      getIsHidden: (item: EmployeeSharedItem) => item.isDeleted,
     },
     role: {
-      fetch: async (changeKeys) => {
+      fetch: (changeKeys) => {
         return appService.orm.connect(async (db) => {
           let qr = db.role().select((item) => ({
             id: item.id,
@@ -55,13 +55,13 @@ export function configureSharedData() {
           if (changeKeys) {
             qr = qr.where((item) => [expr.in(item.id, changeKeys)]);
           }
-          return qr.result();
+          return qr.execute();
         });
       },
       orderBy: [[(item) => item.name, "asc"]],
       getKey: (item) => item.id,
-      getSearchText: (item) => item.name,
-      getIsHidden: (item) => item.isDeleted,
+      getSearchText: (item: RoleSharedItem) => item.name,
+      getIsHidden: (item: RoleSharedItem) => item.isDeleted,
     },
   }));
 }

package/templates/init/packages/client-admin/src/views/auth/LoginView.tsx

@@ -67,11 +67,11 @@ export function LoginView() {
     >
       <div class={"max-w-sm"}>
         {/* Logo */}
-        <div class={clsx("flex justify-center", "mb-4", "animate-fade-in")}>
+        <div class={clsx("flex justify-center", "mb-4", "animate-[fade-in_0.6s_ease-out_both]")}>
           <img src="assets/logo.png" alt="logo" class="scale-75" />
         </div>
 
-        <Card class={clsx("rounded-2xl p-8", "animate-fade-in [animation-delay:0.3s]")}>
+        <Card class={clsx("rounded-2xl p-8", "animate-[fade-in_0.6s_ease-out_both] [animation-delay:0.3s]")}>
           {/* Form */}
           <form onSubmit={handleSubmit}>
             <FormGroup class={"w-full"}>
@@ -83,7 +83,7 @@ export function LoginView() {
                   required
                   lazyValidation
                   size="lg"
-                  autocomplete="employeename"
+                  autocomplete="username"
                   value={data.email}
                   onValueChange={(v) => setData("email", v)}
                 >
@@ -116,7 +116,7 @@ export function LoginView() {
                   variant="solid"
                   class="w-full"
                   type="submit"
-                  size="xl"
+                  size="lg"
                   disabled={busyCount() > 0}
                 >
                   로그인

package/templates/init/packages/client-admin/src/views/home/HomeView.tsx

@@ -36,8 +36,8 @@ function HomeContent(props: RouteSectionProps) {
     },
     {
       title: "로그아웃",
-      onClick: () => {
-        auth.logout();
+      onClick: async () => {
+        await auth.logout();
         navigate("/login", { replace: true });
       },
     },

package/templates/init/packages/db-main/package.json.hbs

@@ -7,7 +7,7 @@
     ".": "./src/index.ts"
   },
   "dependencies": {
-    "@simplysm/core-common": "~13.0.85",
-    "@simplysm/orm-common": "~13.0.85"
+    "@simplysm/core-common": "~13.0.87",
+    "@simplysm/orm-common": "~13.0.87"
   }
 }

package/templates/init/packages/db-main/src/MainDbContext.ts

@@ -1,10 +1,12 @@
 import { defineDbContext, type DbContextInstance } from "@simplysm/orm-common";
-import { Employee } from "./tables/Employee";
-import { Role } from "./tables/Role";
-import { RolePermission } from "./tables/RolePermission";
-import { EmployeeConfig } from "./tables/EmployeeConfig";
-import { _Log } from "./tables/_Log";
-import { _DataLog } from "./tables/_DataLog";
+// base
+import { Employee } from "./tables/base/Employee";
+import { Role } from "./tables/base/Role";
+import { RolePermission } from "./tables/base/RolePermission";
+import { EmployeeConfig } from "./tables/base/EmployeeConfig";
+// system
+import { _Log } from "./tables/system/_Log";
+import { _DataLog } from "./tables/system/_DataLog";
 
 export const MainDbContext = defineDbContext({
   tables: {

package/templates/init/packages/db-main/src/dataLogExt.ts

@@ -6,7 +6,7 @@ import {
   queryable,
   type TableBuilder,
 } from "@simplysm/orm-common";
-import { _DataLog } from "./tables/_DataLog";
+import { _DataLog } from "./tables/system/_DataLog";
 
 // ── Type Declarations ──
 

package/templates/init/packages/db-main/src/index.ts

@@ -1,9 +1,13 @@
-export { Role } from "./tables/Role";
-export { Employee } from "./tables/Employee";
-export { RolePermission } from "./tables/RolePermission";
-export { EmployeeConfig } from "./tables/EmployeeConfig";
-export { _Log } from "./tables/_Log";
-export { _DataLog } from "./tables/_DataLog";
+// base
+export * from "./tables/base/Role";
+export * from "./tables/base/RolePermission";
+export * from "./tables/base/Employee";
+export * from "./tables/base/EmployeeConfig";
+
+// system
+export * from "./tables/system/_Log";
+export * from "./tables/system/_DataLog";
+
 export { MainDbContext } from "./MainDbContext";
 export { expr } from "@simplysm/orm-common";
 import "./dataLogExt";

package/templates/init/packages/server/package.json.hbs

@@ -5,11 +5,11 @@
   "private": true,
   "dependencies": {
     "@{{projectName}}/db-main": "workspace:*",
-    "@simplysm/core-common": "~13.0.85",
+    "@simplysm/core-common": "~13.0.87",
     "@simplysm/excel": "^13.0.71",
-    "@simplysm/orm-common": "~13.0.85",
-    "@simplysm/orm-node": "~13.0.85",
-    "@simplysm/service-server": "~13.0.85",
+    "@simplysm/orm-common": "~13.0.87",
+    "@simplysm/orm-node": "~13.0.87",
+    "@simplysm/service-server": "~13.0.87",
     "bcrypt": "^6.0.0",
     "pg": "^8.19.0",
     "pg-copy-streams": "^7.0.0"

package/templates/init/pnpm-workspace.yaml

@@ -1,6 +1,7 @@
 packages:
   - packages/*
   - tests/*
+  - tests-e2e
 
 onlyBuiltDependencies:
   - "@simplysm/sd-claude"