@simplysm/service-common 14.0.26 → 14.0.27

package/dist/app-structure/app-structure.types.d.ts

@@ -0,0 +1,33 @@
+export type AppStructureItem<TModule = unknown> = AppStructureGroupItem<TModule> | AppStructureLeafItem<TModule>;
+export interface AppStructureGroupItem<TModule> {
+    code: string;
+    title: string;
+    modules?: TModule[];
+    requiredModules?: TModule[];
+    icon?: string;
+    children: AppStructureItem<TModule>[];
+}
+export interface AppStructureLeafItem<TModule> {
+    code: string;
+    title: string;
+    modules?: TModule[];
+    requiredModules?: TModule[];
+    perms?: ("use" | "edit")[];
+    subPerms?: AppStructureSubPermission<TModule>[];
+    icon?: string;
+    url?: string;
+    isNotMenu?: boolean;
+}
+export interface AppStructureSubPermission<TModule> {
+    code: string;
+    title: string;
+    modules?: TModule[];
+    requiredModules?: TModule[];
+    perms: ("use" | "edit")[];
+}
+export interface FlatPermission<TModule = unknown> {
+    titleChain: string[];
+    codeChain: string[];
+    modulesChain: TModule[][];
+}
+//# sourceMappingURL=app-structure.types.d.ts.map

package/dist/app-structure/app-structure.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-structure.types.d.ts","sourceRoot":"","sources":["../../src/app-structure/app-structure.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,OAAO,GAAG,OAAO,IAC1C,qBAAqB,CAAC,OAAO,CAAC,GAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAElC,MAAM,WAAW,qBAAqB,CAAC,OAAO;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB,CAAC,OAAO;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,KAAK,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;CAC3B"}

package/dist/app-structure/app-structure.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-structure.types.js.map

package/dist/app-structure/app-structure.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-structure.types.js","sourceRoot":"","sources":["../../src/app-structure/app-structure.types.ts"],"names":[],"mappings":""}

package/dist/app-structure/app-structure.utils.d.ts

@@ -0,0 +1,5 @@
+import type { AppStructureItem, FlatPermission } from "./app-structure.types";
+export declare function isUsableModules<TModule>(modules: TModule[] | undefined, requiredModules: TModule[] | undefined, usableModules: TModule[] | undefined): boolean;
+export declare function isUsableModulesChain<TModule>(modulesChain: TModule[][], requiredModulesChain: TModule[][], usableModules: TModule[] | undefined): boolean;
+export declare function getFlatPermissions<TModule>(items: AppStructureItem<TModule>[], usableModules: TModule[] | undefined): FlatPermission<TModule>[];
+//# sourceMappingURL=app-structure.utils.d.ts.map

package/dist/app-structure/app-structure.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-structure.utils.d.ts","sourceRoot":"","sources":["../../src/app-structure/app-structure.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,wBAAgB,eAAe,CAAC,OAAO,EACrC,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,EAC9B,eAAe,EAAE,OAAO,EAAE,GAAG,SAAS,EACtC,aAAa,EAAE,OAAO,EAAE,GAAG,SAAS,GACnC,OAAO,CAYT;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAC1C,YAAY,EAAE,OAAO,EAAE,EAAE,EACzB,oBAAoB,EAAE,OAAO,EAAE,EAAE,EACjC,aAAa,EAAE,OAAO,EAAE,GAAG,SAAS,GACnC,OAAO,CAgBT;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EACxC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAClC,aAAa,EAAE,OAAO,EAAE,GAAG,SAAS,GACnC,cAAc,CAAC,OAAO,CAAC,EAAE,CAyE3B"}

package/dist/app-structure/app-structure.utils.js

@@ -0,0 +1,85 @@
+export function isUsableModules(modules, requiredModules, usableModules) {
+    // 1. requiredModules: 모두 있어야 함 (AND)
+    if (requiredModules && requiredModules.length > 0) {
+        if (!requiredModules.every((m) => usableModules?.includes(m))) {
+            return false;
+        }
+    }
+    // 2. modules: 하나라도 있으면 됨 (OR)
+    return (modules == null || modules.length === 0 || modules.some((m) => usableModules?.includes(m)));
+}
+export function isUsableModulesChain(modulesChain, requiredModulesChain, usableModules) {
+    // 각 레벨의 modules (OR) 체크
+    for (const modules of modulesChain) {
+        if (!isUsableModules(modules, undefined, usableModules)) {
+            return false;
+        }
+    }
+    // 각 레벨의 requiredModules (AND) 체크
+    for (const requiredModules of requiredModulesChain) {
+        if (!isUsableModules(undefined, requiredModules, usableModules)) {
+            return false;
+        }
+    }
+    return true;
+}
+export function getFlatPermissions(items, usableModules) {
+    const results = [];
+    const queue = items.map((item) => ({
+        item,
+        titleChain: [],
+        codeChain: [],
+        modulesChain: [],
+        requiredModulesChain: [],
+    }));
+    while (queue.length > 0) {
+        const { item, titleChain, codeChain, modulesChain, requiredModulesChain } = queue.shift();
+        const currTitleChain = [...titleChain, item.title];
+        const currCodeChain = [...codeChain, item.code];
+        const currModulesChain = item.modules ? [...modulesChain, item.modules] : modulesChain;
+        const currRequiredModulesChain = item.requiredModules
+            ? [...requiredModulesChain, item.requiredModules]
+            : requiredModulesChain;
+        if (!isUsableModulesChain(currModulesChain, currRequiredModulesChain, usableModules))
+            continue;
+        // 1. 자식 enqueue
+        if ("children" in item) {
+            for (const child of item.children) {
+                queue.push({
+                    item: child,
+                    titleChain: currTitleChain,
+                    codeChain: currCodeChain,
+                    modulesChain: currModulesChain,
+                    requiredModulesChain: currRequiredModulesChain,
+                });
+            }
+        }
+        // 1. 직접 perms 처리
+        if ("perms" in item) {
+            for (const perm of item.perms ?? []) {
+                results.push({
+                    titleChain: currTitleChain,
+                    codeChain: [...currCodeChain, perm],
+                    modulesChain: currModulesChain,
+                });
+            }
+        }
+        // 2. subPerms 처리
+        if ("subPerms" in item) {
+            for (const subPerm of item.subPerms ?? []) {
+                // subPerm도 모듈 체크
+                if (!isUsableModules(subPerm.modules, subPerm.requiredModules, usableModules))
+                    continue;
+                for (const perm of subPerm.perms) {
+                    results.push({
+                        titleChain: currTitleChain,
+                        codeChain: [...currCodeChain, subPerm.code, perm],
+                        modulesChain: [...currModulesChain, subPerm.modules ?? []],
+                    });
+                }
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=app-structure.utils.js.map

package/dist/app-structure/app-structure.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-structure.utils.js","sourceRoot":"","sources":["../../src/app-structure/app-structure.utils.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,6 +2,9 @@ export * from "./protocol/protocol.types";
 export * from "./protocol/create-service-protocol";
 export * from "./service-types/orm-service.types";
 export * from "./service-types/auto-update-service.types";
+export * from "./service-types/app-structure-service.types";
 export * from "./types";
+export * from "./app-structure/app-structure.types";
+export * from "./app-structure/app-structure.utils";
 export * from "./define-event";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAE1D,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAE5D,cAAc,SAAS,CAAC;AAGxB,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AAGpD,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -4,8 +4,12 @@ export * from "./protocol/create-service-protocol.js";
 // 서비스 타입
 export * from "./service-types/orm-service.types.js";
 export * from "./service-types/auto-update-service.types.js";
+export * from "./service-types/app-structure-service.types.js";
 // 타입
 export * from "./types.js";
+// App Structure
+export * from "./app-structure/app-structure.types.js";
+export * from "./app-structure/app-structure.utils.js";
 // 정의
 export * from "./define-event.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAEnD,SAAS;AACT,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,KAAK;AACL,cAAc,SAAS,CAAC;AAExB,KAAK;AACL,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAEnD,SAAS;AACT,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAC5D,KAAK;AACL,cAAc,SAAS,CAAC;AAExB,gBAAgB;AAChB,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AAEpD,KAAK;AACL,cAAc,gBAAgB,CAAC"}

package/dist/service-types/app-structure-service.types.d.ts

@@ -0,0 +1,10 @@
+import type { AppStructureItem } from "../app-structure/app-structure.types";
+/**
+ * AppStructure 서비스 인터페이스
+ *
+ * 서버에 등록된 앱 구조 항목을 클라이언트명 기준 맵으로 조회한다.
+ */
+export interface AppStructureService {
+    getItems(): Record<string, AppStructureItem[]>;
+}
+//# sourceMappingURL=app-structure-service.types.d.ts.map

package/dist/service-types/app-structure-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-structure-service.types.d.ts","sourceRoot":"","sources":["../../src/service-types/app-structure-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAChD"}

package/dist/service-types/app-structure-service.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-structure-service.types.js.map

package/dist/service-types/app-structure-service.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-structure-service.types.js","sourceRoot":"","sources":["../../src/service-types/app-structure-service.types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/service-common",
-  "version": "14.0.26",
+  "version": "14.0.27",
   "description": "심플리즘 패키지 - 서비스 (common)",
   "author": "심플리즘",
   "license": "Apache-2.0",
@@ -21,7 +21,7 @@
     "@types/node": "^20.19.39"
   },
   "dependencies": {
-    "@simplysm/core-common": "14.0.26",
-    "@simplysm/orm-common": "14.0.26"
+    "@simplysm/core-common": "14.0.27",
+    "@simplysm/orm-common": "14.0.27"
   }
 }

package/src/app-structure/app-structure.types.ts

@@ -0,0 +1,38 @@
+export type AppStructureItem<TModule = unknown> =
+  | AppStructureGroupItem<TModule>
+  | AppStructureLeafItem<TModule>;
+
+export interface AppStructureGroupItem<TModule> {
+  code: string;
+  title: string;
+  modules?: TModule[];
+  requiredModules?: TModule[];
+  icon?: string;
+  children: AppStructureItem<TModule>[];
+}
+
+export interface AppStructureLeafItem<TModule> {
+  code: string;
+  title: string;
+  modules?: TModule[];
+  requiredModules?: TModule[];
+  perms?: ("use" | "edit")[];
+  subPerms?: AppStructureSubPermission<TModule>[];
+  icon?: string;
+  url?: string;
+  isNotMenu?: boolean;
+}
+
+export interface AppStructureSubPermission<TModule> {
+  code: string;
+  title: string;
+  modules?: TModule[];
+  requiredModules?: TModule[];
+  perms: ("use" | "edit")[];
+}
+
+export interface FlatPermission<TModule = unknown> {
+  titleChain: string[];
+  codeChain: string[];
+  modulesChain: TModule[][];
+}

package/src/app-structure/app-structure.utils.ts

@@ -0,0 +1,122 @@
+import type {
+  AppStructureItem,
+  FlatPermission,
+} from "./app-structure.types";
+
+export function isUsableModules<TModule>(
+  modules: TModule[] | undefined,
+  requiredModules: TModule[] | undefined,
+  usableModules: TModule[] | undefined,
+): boolean {
+  // 1. requiredModules: 모두 있어야 함 (AND)
+  if (requiredModules && requiredModules.length > 0) {
+    if (!requiredModules.every((m) => usableModules?.includes(m))) {
+      return false;
+    }
+  }
+
+  // 2. modules: 하나라도 있으면 됨 (OR)
+  return (
+    modules == null || modules.length === 0 || modules.some((m) => usableModules?.includes(m))
+  );
+}
+
+export function isUsableModulesChain<TModule>(
+  modulesChain: TModule[][],
+  requiredModulesChain: TModule[][],
+  usableModules: TModule[] | undefined,
+): boolean {
+  // 각 레벨의 modules (OR) 체크
+  for (const modules of modulesChain) {
+    if (!isUsableModules(modules, undefined, usableModules)) {
+      return false;
+    }
+  }
+
+  // 각 레벨의 requiredModules (AND) 체크
+  for (const requiredModules of requiredModulesChain) {
+    if (!isUsableModules(undefined, requiredModules, usableModules)) {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+export function getFlatPermissions<TModule>(
+  items: AppStructureItem<TModule>[],
+  usableModules: TModule[] | undefined,
+): FlatPermission<TModule>[] {
+  const results: FlatPermission<TModule>[] = [];
+
+  type QueueItem = {
+    item: AppStructureItem<TModule>;
+    titleChain: string[];
+    codeChain: string[];
+    modulesChain: TModule[][];
+    requiredModulesChain: TModule[][];
+  };
+
+  const queue: QueueItem[] = items.map((item) => ({
+    item,
+    titleChain: [],
+    codeChain: [],
+    modulesChain: [],
+    requiredModulesChain: [],
+  }));
+
+  while (queue.length > 0) {
+    const { item, titleChain, codeChain, modulesChain, requiredModulesChain } = queue.shift()!;
+
+    const currTitleChain = [...titleChain, item.title];
+    const currCodeChain = [...codeChain, item.code];
+    const currModulesChain = item.modules ? [...modulesChain, item.modules] : modulesChain;
+    const currRequiredModulesChain = item.requiredModules
+      ? [...requiredModulesChain, item.requiredModules]
+      : requiredModulesChain;
+
+    if (!isUsableModulesChain(currModulesChain, currRequiredModulesChain, usableModules)) continue;
+
+    // 1. 자식 enqueue
+    if ("children" in item) {
+      for (const child of item.children) {
+        queue.push({
+          item: child,
+          titleChain: currTitleChain,
+          codeChain: currCodeChain,
+          modulesChain: currModulesChain,
+          requiredModulesChain: currRequiredModulesChain,
+        });
+      }
+    }
+
+    // 1. 직접 perms 처리
+    if ("perms" in item) {
+      for (const perm of item.perms ?? []) {
+        results.push({
+          titleChain: currTitleChain,
+          codeChain: [...currCodeChain, perm],
+          modulesChain: currModulesChain,
+        });
+      }
+    }
+
+    // 2. subPerms 처리
+    if ("subPerms" in item) {
+      for (const subPerm of item.subPerms ?? []) {
+        // subPerm도 모듈 체크
+        if (!isUsableModules(subPerm.modules, subPerm.requiredModules, usableModules)) continue;
+
+        for (const perm of subPerm.perms) {
+          results.push({
+            titleChain: currTitleChain,
+            codeChain: [...currCodeChain, subPerm.code, perm],
+            modulesChain: [...currModulesChain, subPerm.modules ?? []],
+          });
+        }
+      }
+    }
+  }
+
+  return results;
+}

package/src/index.ts

@@ -5,8 +5,13 @@ export * from "./protocol/create-service-protocol";
 // 서비스 타입
 export * from "./service-types/orm-service.types";
 export * from "./service-types/auto-update-service.types";
+export * from "./service-types/app-structure-service.types";
 // 타입
 export * from "./types";
 
+// App Structure
+export * from "./app-structure/app-structure.types";
+export * from "./app-structure/app-structure.utils";
+
 // 정의
 export * from "./define-event";

package/src/service-types/app-structure-service.types.ts

@@ -0,0 +1,10 @@
+import type { AppStructureItem } from "../app-structure/app-structure.types";
+
+/**
+ * AppStructure 서비스 인터페이스
+ *
+ * 서버에 등록된 앱 구조 항목을 클라이언트명 기준 맵으로 조회한다.
+ */
+export interface AppStructureService {
+  getItems(): Record<string, AppStructureItem[]>;
+}