@sonhoseong/mfa-lib 1.3.7 → 1.3.10

package/dist/utils/classnames.js

@@ -0,0 +1,98 @@
+/**
+ * ClassName 유틸리티
+ * 조건부 클래스 이름 결합 (clsx/classnames 대체)
+ * 외부 의존성 없이 구현
+ */
+/**
+ * 여러 클래스 이름을 조건부로 결합
+ *
+ * @example
+ * // 기본 사용
+ * cn('foo', 'bar') // 'foo bar'
+ *
+ * @example
+ * // 조건부 클래스
+ * cn('btn', { 'btn-primary': isPrimary, 'btn-disabled': isDisabled })
+ * // isPrimary=true, isDisabled=false -> 'btn btn-primary'
+ *
+ * @example
+ * // 배열 사용
+ * cn(['foo', 'bar'], 'baz') // 'foo bar baz'
+ *
+ * @example
+ * // falsy 값 무시
+ * cn('foo', null, undefined, false, 'bar') // 'foo bar'
+ */
+export function cn(...inputs) {
+    const classes = [];
+    for (const input of inputs) {
+        if (!input)
+            continue;
+        if (typeof input === 'string') {
+            classes.push(input);
+        }
+        else if (typeof input === 'number') {
+            classes.push(String(input));
+        }
+        else if (Array.isArray(input)) {
+            const nested = cn(...input);
+            if (nested)
+                classes.push(nested);
+        }
+        else if (typeof input === 'object') {
+            for (const [key, value] of Object.entries(input)) {
+                if (value)
+                    classes.push(key);
+            }
+        }
+    }
+    return classes.join(' ');
+}
+/**
+ * cn의 별칭 (classNames)
+ */
+export const classNames = cn;
+/**
+ * cn의 별칭 (clsx 호환)
+ */
+export const clsx = cn;
+/**
+ * 조건부 클래스 생성 헬퍼
+ *
+ * @example
+ * const buttonClass = createClassVariants({
+ *   base: 'btn',
+ *   variants: {
+ *     variant: {
+ *       primary: 'btn-primary',
+ *       secondary: 'btn-secondary',
+ *     },
+ *     size: {
+ *       sm: 'btn-sm',
+ *       md: 'btn-md',
+ *       lg: 'btn-lg',
+ *     },
+ *   },
+ * });
+ *
+ * buttonClass({ variant: 'primary', size: 'lg' })
+ * // 'btn btn-primary btn-lg'
+ */
+export function createClassVariants(config) {
+    const { base, variants } = config;
+    return (options) => {
+        const classes = [];
+        if (base)
+            classes.push(base);
+        for (const [variantKey, variantValue] of Object.entries(options)) {
+            const variantConfig = variants[variantKey];
+            if (variantConfig && variantValue) {
+                const className = variantConfig[variantValue];
+                if (className)
+                    classes.push(className);
+            }
+        }
+        return classes.join(' ');
+    };
+}
+export default cn;

package/dist/utils/formatter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Formatter 유틸리티 (KOMCA 패턴)
+ * 전화번호, 날짜, 숫자 등의 포맷팅 함수 제공
+ */
+/**
+ * 전화번호 포맷팅
+ * @example phoneFormatter('01012345678') // '010-1234-5678'
+ * @example phoneFormatter('0212345678') // '02-1234-5678'
+ */
+export declare function phoneFormatter(value: string | null | undefined): string;
+/**
+ * 날짜 포맷팅 (YYYYMMDD → YYYY.MM.DD 또는 YYYY-MM-DD)
+ * @example dateFormatter('20240315') // '2024.03.15'
+ * @example dateFormatter('20240315', '-') // '2024-03-15'
+ */
+export declare function dateFormatter(value: string | null | undefined, separator?: string): string;
+/**
+ * 날짜/시간 포맷팅 (Date 객체 → 문자열)
+ * @example dateTimeFormatter(new Date()) // '2024.03.15 14:30:00'
+ */
+export declare function dateTimeFormatter(date: Date | null | undefined, options?: {
+    dateOnly?: boolean;
+    timeOnly?: boolean;
+    separator?: string;
+}): string;
+/**
+ * 숫자 콤마 포맷팅
+ * @example numberFormatter(1234567) // '1,234,567'
+ * @example numberFormatter(1234567.89) // '1,234,567.89'
+ */
+export declare function numberFormatter(value: number | string | null | undefined): string;
+/**
+ * 통화 포맷팅 (원화)
+ * @example currencyFormatter(1234567) // '1,234,567원'
+ * @example currencyFormatter(1234567, { prefix: '₩' }) // '₩1,234,567'
+ */
+export declare function currencyFormatter(value: number | string | null | undefined, options?: {
+    prefix?: string;
+    suffix?: string;
+}): string;
+/**
+ * 바이트 사이즈 포맷팅
+ * @example byteSizeFormatter(1024) // '1 KB'
+ * @example byteSizeFormatter(1048576) // '1 MB'
+ */
+export declare function byteSizeFormatter(bytes: number | null | undefined): string;
+/**
+ * 마스킹 포맷팅 (개인정보 보호)
+ * @example maskEmail('test@example.com') // 'te**@example.com'
+ */
+export declare function maskEmail(email: string | null | undefined): string;
+/**
+ * 이름 마스킹
+ * @example maskName('홍길동') // '홍*동'
+ */
+export declare function maskName(name: string | null | undefined): string;
+/**
+ * 전화번호 마스킹
+ * @example maskPhone('010-1234-5678') // '010-****-5678'
+ */
+export declare function maskPhone(phone: string | null | undefined): string;
+/**
+ * 상대 시간 포맷팅
+ * @example relativeTimeFormatter(new Date(Date.now() - 60000)) // '1분 전'
+ */
+export declare function relativeTimeFormatter(date: Date | string | null | undefined): string;
+/**
+ * 퍼센트 포맷팅
+ * @example percentFormatter(0.1234) // '12.34%'
+ * @example percentFormatter(0.1234, 0) // '12%'
+ */
+export declare function percentFormatter(value: number | null | undefined, decimals?: number): string;
+/**
+ * 문자열 자르기 (말줄임)
+ * @example truncate('안녕하세요 반갑습니다', 5) // '안녕하세...'
+ */
+export declare function truncate(str: string | null | undefined, maxLength: number, suffix?: string): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/utils/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAgCvE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,SAAS,GAAE,MAAY,GACtB,MAAM,CAaR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,MAAM,CAuBR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQjF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAa1E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAWlE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAYhE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAWlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAmBpF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,GAAE,MAAU,GACnB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAc,GACrB,MAAM,CAMR"}

package/dist/utils/formatter.js

@@ -0,0 +1,216 @@
+/**
+ * Formatter 유틸리티 (KOMCA 패턴)
+ * 전화번호, 날짜, 숫자 등의 포맷팅 함수 제공
+ */
+/**
+ * 전화번호 포맷팅
+ * @example phoneFormatter('01012345678') // '010-1234-5678'
+ * @example phoneFormatter('0212345678') // '02-1234-5678'
+ */
+export function phoneFormatter(value) {
+    if (!value)
+        return '';
+    // 숫자만 추출
+    const numbers = value.replace(/[^0-9]/g, '');
+    // 휴대폰 번호 (010, 011, 016, 017, 018, 019)
+    if (numbers.match(/^01[0-9]/)) {
+        if (numbers.length === 11) {
+            return numbers.replace(/(\d{3})(\d{4})(\d{4})/, '$1-$2-$3');
+        }
+        else if (numbers.length === 10) {
+            return numbers.replace(/(\d{3})(\d{3})(\d{4})/, '$1-$2-$3');
+        }
+    }
+    // 서울 지역번호 (02)
+    if (numbers.startsWith('02')) {
+        if (numbers.length === 10) {
+            return numbers.replace(/(\d{2})(\d{4})(\d{4})/, '$1-$2-$3');
+        }
+        else if (numbers.length === 9) {
+            return numbers.replace(/(\d{2})(\d{3})(\d{4})/, '$1-$2-$3');
+        }
+    }
+    // 기타 지역번호 (031, 032, ...)
+    if (numbers.length === 11) {
+        return numbers.replace(/(\d{3})(\d{4})(\d{4})/, '$1-$2-$3');
+    }
+    else if (numbers.length === 10) {
+        return numbers.replace(/(\d{3})(\d{3})(\d{4})/, '$1-$2-$3');
+    }
+    return numbers;
+}
+/**
+ * 날짜 포맷팅 (YYYYMMDD → YYYY.MM.DD 또는 YYYY-MM-DD)
+ * @example dateFormatter('20240315') // '2024.03.15'
+ * @example dateFormatter('20240315', '-') // '2024-03-15'
+ */
+export function dateFormatter(value, separator = '.') {
+    if (!value)
+        return '';
+    const numbers = value.replace(/[^0-9]/g, '');
+    if (numbers.length === 8) {
+        const year = numbers.substring(0, 4);
+        const month = numbers.substring(4, 6);
+        const day = numbers.substring(6, 8);
+        return `${year}${separator}${month}${separator}${day}`;
+    }
+    return value;
+}
+/**
+ * 날짜/시간 포맷팅 (Date 객체 → 문자열)
+ * @example dateTimeFormatter(new Date()) // '2024.03.15 14:30:00'
+ */
+export function dateTimeFormatter(date, options) {
+    if (!date)
+        return '';
+    const { dateOnly = false, timeOnly = false, separator = '.' } = options || {};
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    if (timeOnly) {
+        return `${hours}:${minutes}:${seconds}`;
+    }
+    const dateStr = `${year}${separator}${month}${separator}${day}`;
+    if (dateOnly) {
+        return dateStr;
+    }
+    return `${dateStr} ${hours}:${minutes}:${seconds}`;
+}
+/**
+ * 숫자 콤마 포맷팅
+ * @example numberFormatter(1234567) // '1,234,567'
+ * @example numberFormatter(1234567.89) // '1,234,567.89'
+ */
+export function numberFormatter(value) {
+    if (value === null || value === undefined || value === '')
+        return '';
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num))
+        return '';
+    return num.toLocaleString('ko-KR');
+}
+/**
+ * 통화 포맷팅 (원화)
+ * @example currencyFormatter(1234567) // '1,234,567원'
+ * @example currencyFormatter(1234567, { prefix: '₩' }) // '₩1,234,567'
+ */
+export function currencyFormatter(value, options) {
+    const { prefix = '', suffix = '원' } = options || {};
+    const formatted = numberFormatter(value);
+    if (!formatted)
+        return '';
+    return `${prefix}${formatted}${suffix}`;
+}
+/**
+ * 바이트 사이즈 포맷팅
+ * @example byteSizeFormatter(1024) // '1 KB'
+ * @example byteSizeFormatter(1048576) // '1 MB'
+ */
+export function byteSizeFormatter(bytes) {
+    if (bytes === null || bytes === undefined)
+        return '';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let unitIndex = 0;
+    let size = bytes;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(unitIndex === 0 ? 0 : 2)} ${units[unitIndex]}`;
+}
+/**
+ * 마스킹 포맷팅 (개인정보 보호)
+ * @example maskEmail('test@example.com') // 'te**@example.com'
+ */
+export function maskEmail(email) {
+    if (!email)
+        return '';
+    const [localPart, domain] = email.split('@');
+    if (!domain)
+        return email;
+    const maskedLocal = localPart.length > 2
+        ? localPart.substring(0, 2) + '*'.repeat(localPart.length - 2)
+        : localPart;
+    return `${maskedLocal}@${domain}`;
+}
+/**
+ * 이름 마스킹
+ * @example maskName('홍길동') // '홍*동'
+ */
+export function maskName(name) {
+    if (!name)
+        return '';
+    if (name.length === 2) {
+        return name.charAt(0) + '*';
+    }
+    if (name.length > 2) {
+        return name.charAt(0) + '*'.repeat(name.length - 2) + name.charAt(name.length - 1);
+    }
+    return name;
+}
+/**
+ * 전화번호 마스킹
+ * @example maskPhone('010-1234-5678') // '010-****-5678'
+ */
+export function maskPhone(phone) {
+    if (!phone)
+        return '';
+    const formatted = phoneFormatter(phone);
+    const parts = formatted.split('-');
+    if (parts.length === 3) {
+        return `${parts[0]}-****-${parts[2]}`;
+    }
+    return formatted;
+}
+/**
+ * 상대 시간 포맷팅
+ * @example relativeTimeFormatter(new Date(Date.now() - 60000)) // '1분 전'
+ */
+export function relativeTimeFormatter(date) {
+    if (!date)
+        return '';
+    const targetDate = typeof date === 'string' ? new Date(date) : date;
+    const now = new Date();
+    const diffMs = now.getTime() - targetDate.getTime();
+    const diffSec = Math.floor(diffMs / 1000);
+    const diffMin = Math.floor(diffSec / 60);
+    const diffHour = Math.floor(diffMin / 60);
+    const diffDay = Math.floor(diffHour / 24);
+    const diffMonth = Math.floor(diffDay / 30);
+    const diffYear = Math.floor(diffMonth / 12);
+    if (diffSec < 60)
+        return '방금 전';
+    if (diffMin < 60)
+        return `${diffMin}분 전`;
+    if (diffHour < 24)
+        return `${diffHour}시간 전`;
+    if (diffDay < 30)
+        return `${diffDay}일 전`;
+    if (diffMonth < 12)
+        return `${diffMonth}개월 전`;
+    return `${diffYear}년 전`;
+}
+/**
+ * 퍼센트 포맷팅
+ * @example percentFormatter(0.1234) // '12.34%'
+ * @example percentFormatter(0.1234, 0) // '12%'
+ */
+export function percentFormatter(value, decimals = 2) {
+    if (value === null || value === undefined)
+        return '';
+    return `${(value * 100).toFixed(decimals)}%`;
+}
+/**
+ * 문자열 자르기 (말줄임)
+ * @example truncate('안녕하세요 반갑습니다', 5) // '안녕하세...'
+ */
+export function truncate(str, maxLength, suffix = '...') {
+    if (!str)
+        return '';
+    if (str.length <= maxLength)
+        return str;
+    return str.substring(0, maxLength) + suffix;
+}

package/dist/utils/index.d.ts

@@ -1,2 +1,7 @@
 export * from './storage';
+export * from './permission';
+export * from './formatter';
+export * from './validation';
+export * from './query-string';
+export * from './classnames';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -1 +1,6 @@
 export * from './storage';
+export * from './permission';
+export * from './formatter';
+export * from './validation';
+export * from './query-string';
+export * from './classnames';

package/dist/utils/permission.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 권한 관련 유틸리티 (KOMCA 패턴)
+ */
+import { User, UserRole, PermissionAction, MenuItem, MenuPermission } from '../types';
+/**
+ * 특정 코드에 대한 권한이 있는지 확인
+ */
+export declare function hasPermission(user: User | null, code: string, action?: PermissionAction): boolean;
+/**
+ * 여러 코드 중 하나라도 권한이 있는지 확인 (OR)
+ */
+export declare function hasAnyPermission(user: User | null, codes: string[], action?: PermissionAction): boolean;
+/**
+ * 모든 코드에 대한 권한이 있는지 확인 (AND)
+ */
+export declare function hasAllPermissions(user: User | null, codes: string[], action?: PermissionAction): boolean;
+/**
+ * 특정 역할인지 확인
+ */
+export declare function hasRole(user: User | null, roles: UserRole | UserRole[]): boolean;
+/**
+ * 메뉴 권한 요구사항 충족 여부 확인
+ */
+export declare function checkMenuPermission(user: User | null, permission?: MenuPermission): boolean;
+/**
+ * 권한에 따라 메뉴 목록 필터링
+ */
+export declare function filterMenusByPermission(menus: MenuItem[], user: User | null): MenuItem[];
+/**
+ * 메뉴에서 특정 경로 접근 권한 확인
+ */
+export declare function canAccessPath(menus: MenuItem[], path: string, user: User | null): boolean;
+//# sourceMappingURL=permission.d.ts.map

package/dist/utils/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../src/utils/permission.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAc,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAMlG;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,gBAAyB,GAChC,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,GAAE,gBAAyB,GAChC,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,GAAE,gBAAyB,GAChC,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,OAAO,CAKhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAyBT;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,EAAE,IAAI,GAAG,IAAI,GAChB,QAAQ,EAAE,CA4BZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,GAAG,IAAI,GAChB,OAAO,CAmBT"}

package/dist/utils/permission.js

@@ -0,0 +1,132 @@
+/**
+ * 권한 관련 유틸리티 (KOMCA 패턴)
+ */
+// ============================================
+// 권한 체크 함수
+// ============================================
+/**
+ * 특정 코드에 대한 권한이 있는지 확인
+ */
+export function hasPermission(user, code, action = 'read') {
+    if (!user)
+        return false;
+    // admin은 모든 권한
+    if (user.role === 'admin')
+        return true;
+    // 권한 목록에서 확인
+    const permission = user.permissions?.find((p) => p.code === code);
+    if (!permission)
+        return false;
+    return permission.actions.includes(action);
+}
+/**
+ * 여러 코드 중 하나라도 권한이 있는지 확인 (OR)
+ */
+export function hasAnyPermission(user, codes, action = 'read') {
+    if (!user)
+        return false;
+    if (user.role === 'admin')
+        return true;
+    return codes.some((code) => hasPermission(user, code, action));
+}
+/**
+ * 모든 코드에 대한 권한이 있는지 확인 (AND)
+ */
+export function hasAllPermissions(user, codes, action = 'read') {
+    if (!user)
+        return false;
+    if (user.role === 'admin')
+        return true;
+    return codes.every((code) => hasPermission(user, code, action));
+}
+/**
+ * 특정 역할인지 확인
+ */
+export function hasRole(user, roles) {
+    if (!user || !user.role)
+        return false;
+    const roleArray = Array.isArray(roles) ? roles : [roles];
+    return roleArray.includes(user.role);
+}
+/**
+ * 메뉴 권한 요구사항 충족 여부 확인
+ */
+export function checkMenuPermission(user, permission) {
+    // 권한 요구사항이 없으면 모두 접근 가능
+    if (!permission)
+        return true;
+    if (!user)
+        return false;
+    // admin은 모든 권한
+    if (user.role === 'admin')
+        return true;
+    const { requiredCodes, requiredRoles, requiredAction = 'read' } = permission;
+    // 역할 체크 (OR 조건)
+    if (requiredRoles && requiredRoles.length > 0) {
+        if (!hasRole(user, requiredRoles)) {
+            return false;
+        }
+    }
+    // 코드 체크 (OR 조건)
+    if (requiredCodes && requiredCodes.length > 0) {
+        if (!hasAnyPermission(user, requiredCodes, requiredAction)) {
+            return false;
+        }
+    }
+    return true;
+}
+// ============================================
+// 메뉴 필터링 함수
+// ============================================
+/**
+ * 권한에 따라 메뉴 목록 필터링
+ */
+export function filterMenusByPermission(menus, user) {
+    return menus
+        .filter((menu) => {
+        // hidden 메뉴 제외
+        if (menu.hidden)
+            return false;
+        // 권한 체크
+        return checkMenuPermission(user, menu.permission);
+    })
+        .map((menu) => {
+        // 자식 메뉴도 재귀적으로 필터링
+        if (menu.children && menu.children.length > 0) {
+            const filteredChildren = filterMenusByPermission(menu.children, user);
+            // 자식이 모두 필터링되면 부모도 제외
+            if (filteredChildren.length === 0) {
+                return null;
+            }
+            return {
+                ...menu,
+                children: filteredChildren,
+            };
+        }
+        return menu;
+    })
+        .filter((menu) => menu !== null);
+}
+/**
+ * 메뉴에서 특정 경로 접근 권한 확인
+ */
+export function canAccessPath(menus, path, user) {
+    // 메뉴에서 해당 경로 찾기
+    const findMenu = (items) => {
+        for (const item of items) {
+            if (item.path === path)
+                return item;
+            if (item.children) {
+                const found = findMenu(item.children);
+                if (found)
+                    return found;
+            }
+        }
+        return undefined;
+    };
+    const menu = findMenu(menus);
+    // 메뉴에 없는 경로는 기본 허용 (또는 거부로 변경 가능)
+    if (!menu)
+        return true;
+    return checkMenuPermission(user, menu.permission);
+}

package/dist/utils/query-string.d.ts

@@ -0,0 +1,67 @@
+/**
+ * QueryString 유틸리티
+ * URL 쿼리 파라미터 파싱 및 생성
+ * KOMCA 패턴 업그레이드 버전 (lodash 의존성 제거)
+ */
+export type QueryParams = Record<string, string | number | boolean | null | undefined>;
+/**
+ * URL 쿼리 스트링을 객체로 파싱
+ * @example
+ * parseQueryString('?name=홍길동&age=30')
+ * // { name: '홍길동', age: '30' }
+ */
+export declare function parseQueryString(searchStr?: string): Record<string, string | undefined>;
+/**
+ * 객체를 쿼리 스트링으로 변환
+ * @example
+ * createQueryString({ name: '홍길동', age: 30 })
+ * // 'name=%ED%99%8D%EA%B8%B8%EB%8F%99&age=30'
+ */
+export declare function createQueryString(params: QueryParams): string;
+/**
+ * 현재 URL에 쿼리 파라미터 추가/업데이트
+ * @example
+ * updateQueryParams({ page: 2, sort: 'name' })
+ * // 현재 URL에 ?page=2&sort=name 추가
+ */
+export declare function updateQueryParams(params: QueryParams, options?: {
+    replace?: boolean;
+}): void;
+/**
+ * 특정 쿼리 파라미터 값 가져오기
+ * @example
+ * getQueryParam('page') // '1'
+ * getQueryParam('page', '1') // 기본값 '1'
+ */
+export declare function getQueryParam(key: string, defaultValue?: string): string | undefined;
+/**
+ * 특정 쿼리 파라미터 삭제
+ * @example removeQueryParam('page')
+ */
+export declare function removeQueryParam(key: string, options?: {
+    replace?: boolean;
+}): void;
+/**
+ * 모든 쿼리 파라미터 삭제
+ */
+export declare function clearQueryParams(options?: {
+    replace?: boolean;
+}): void;
+/**
+ * URL에 쿼리 스트링 추가
+ * @example
+ * appendQueryString('/users', { page: 1, size: 10 })
+ * // '/users?page=1&size=10'
+ */
+export declare function appendQueryString(url: string, params: QueryParams): string;
+/**
+ * 쿼리 파라미터를 숫자로 파싱
+ * @example getQueryParamAsNumber('page', 1) // 1
+ */
+export declare function getQueryParamAsNumber(key: string, defaultValue?: number): number;
+/**
+ * 쿼리 파라미터를 boolean으로 파싱
+ * @example getQueryParamAsBoolean('active', false) // true
+ */
+export declare function getQueryParamAsBoolean(key: string, defaultValue?: boolean): boolean;
+//# sourceMappingURL=query-string.d.ts.map

package/dist/utils/query-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-string.d.ts","sourceRoot":"","sources":["../../src/utils/query-string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEvF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAkBvF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,IAAI,CAuBN;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAEnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAUtE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAM1E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU,GAAG,MAAM,CAKnF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAI1F"}