@sonhoseong/mfa-lib 1.3.7 → 1.3.10

package/dist/utils/query-string.js

@@ -0,0 +1,136 @@
+/**
+ * QueryString 유틸리티
+ * URL 쿼리 파라미터 파싱 및 생성
+ * KOMCA 패턴 업그레이드 버전 (lodash 의존성 제거)
+ */
+/**
+ * URL 쿼리 스트링을 객체로 파싱
+ * @example
+ * parseQueryString('?name=홍길동&age=30')
+ * // { name: '홍길동', age: '30' }
+ */
+export function parseQueryString(searchStr) {
+    const search = searchStr
+        ? searchStr.replace(/^\?/, '')
+        : (typeof window !== 'undefined' ? window.location.search.replace(/^\?/, '') : '');
+    if (!search) {
+        return {};
+    }
+    return search.split('&').reduce((acc, token) => {
+        const [key, value] = token.split('=');
+        if (key) {
+            acc[decodeURIComponent(key)] = value !== undefined
+                ? decodeURIComponent(value)
+                : undefined;
+        }
+        return acc;
+    }, {});
+}
+/**
+ * 객체를 쿼리 스트링으로 변환
+ * @example
+ * createQueryString({ name: '홍길동', age: 30 })
+ * // 'name=%ED%99%8D%EA%B8%B8%EB%8F%99&age=30'
+ */
+export function createQueryString(params) {
+    const entries = Object.entries(params)
+        .filter(([_, value]) => value !== undefined && value !== null && value !== '')
+        .map(([key, value]) => {
+        return `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`;
+    });
+    return entries.join('&');
+}
+/**
+ * 현재 URL에 쿼리 파라미터 추가/업데이트
+ * @example
+ * updateQueryParams({ page: 2, sort: 'name' })
+ * // 현재 URL에 ?page=2&sort=name 추가
+ */
+export function updateQueryParams(params, options) {
+    if (typeof window === 'undefined')
+        return;
+    const currentParams = parseQueryString();
+    const newParams = { ...currentParams };
+    // 새 파라미터 추가/업데이트
+    Object.entries(params).forEach(([key, value]) => {
+        if (value === undefined || value === null) {
+            delete newParams[key];
+        }
+        else {
+            newParams[key] = String(value);
+        }
+    });
+    const queryString = createQueryString(newParams);
+    const newUrl = `${window.location.pathname}${queryString ? `?${queryString}` : ''}`;
+    if (options?.replace) {
+        window.history.replaceState(null, '', newUrl);
+    }
+    else {
+        window.history.pushState(null, '', newUrl);
+    }
+}
+/**
+ * 특정 쿼리 파라미터 값 가져오기
+ * @example
+ * getQueryParam('page') // '1'
+ * getQueryParam('page', '1') // 기본값 '1'
+ */
+export function getQueryParam(key, defaultValue) {
+    const params = parseQueryString();
+    return params[key] ?? defaultValue;
+}
+/**
+ * 특정 쿼리 파라미터 삭제
+ * @example removeQueryParam('page')
+ */
+export function removeQueryParam(key, options) {
+    updateQueryParams({ [key]: undefined }, options);
+}
+/**
+ * 모든 쿼리 파라미터 삭제
+ */
+export function clearQueryParams(options) {
+    if (typeof window === 'undefined')
+        return;
+    const newUrl = window.location.pathname;
+    if (options?.replace) {
+        window.history.replaceState(null, '', newUrl);
+    }
+    else {
+        window.history.pushState(null, '', newUrl);
+    }
+}
+/**
+ * URL에 쿼리 스트링 추가
+ * @example
+ * appendQueryString('/users', { page: 1, size: 10 })
+ * // '/users?page=1&size=10'
+ */
+export function appendQueryString(url, params) {
+    const queryString = createQueryString(params);
+    if (!queryString)
+        return url;
+    const separator = url.includes('?') ? '&' : '?';
+    return `${url}${separator}${queryString}`;
+}
+/**
+ * 쿼리 파라미터를 숫자로 파싱
+ * @example getQueryParamAsNumber('page', 1) // 1
+ */
+export function getQueryParamAsNumber(key, defaultValue = 0) {
+    const value = getQueryParam(key);
+    if (value === undefined)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * 쿼리 파라미터를 boolean으로 파싱
+ * @example getQueryParamAsBoolean('active', false) // true
+ */
+export function getQueryParamAsBoolean(key, defaultValue = false) {
+    const value = getQueryParam(key);
+    if (value === undefined)
+        return defaultValue;
+    return value === 'true' || value === '1';
+}

package/dist/utils/storage.d.ts

@@ -1,5 +1,5 @@
 /**
- * Storage 유틸리티 - KOMCA 패턴
+ * Storage 유틸리티
  * localStorage/sessionStorage 관리
  */
 import { User, RecentMenu } from '../types';

package/dist/utils/storage.js

@@ -1,5 +1,5 @@
 /**
- * Storage 유틸리티 - KOMCA 패턴
+ * Storage 유틸리티
  * localStorage/sessionStorage 관리
  */
 // Storage 키 상수

package/dist/utils/validation.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Validation 유틸리티
+ * 이메일, 비밀번호, 전화번호 등 검증 함수
+ * KOMCA 패턴 업그레이드 버전
+ */
+/**
+ * 이메일 형식 검증
+ * @example isValidEmail('test@example.com') // true
+ */
+export declare function isValidEmail(email: string): boolean;
+export interface PasswordValidationResult {
+    isValid: boolean;
+    errors: string[];
+    strength: 'weak' | 'medium' | 'strong';
+}
+export interface PasswordOptions {
+    minLength?: number;
+    maxLength?: number;
+    requireUppercase?: boolean;
+    requireLowercase?: boolean;
+    requireNumber?: boolean;
+    requireSpecialChar?: boolean;
+}
+/**
+ * 비밀번호 검증 (상세 결과)
+ * @example
+ * const result = validatePassword('Test1234!');
+ * // { isValid: true, errors: [], strength: 'strong' }
+ */
+export declare function validatePassword(password: string, options?: PasswordOptions): PasswordValidationResult;
+/**
+ * 비밀번호 형식 검증 (간단)
+ * @example isValidPassword('Test1234!') // true
+ */
+export declare function isValidPassword(password: string, options?: PasswordOptions): boolean;
+/**
+ * 한국 전화번호 검증
+ * @example isValidPhone('010-1234-5678') // true
+ * @example isValidPhone('01012345678') // true
+ */
+export declare function isValidPhone(phone: string): boolean;
+/**
+ * 휴대폰 번호만 검증
+ * @example isValidMobile('010-1234-5678') // true
+ */
+export declare function isValidMobile(phone: string): boolean;
+/**
+ * URL 형식 검증
+ * @example isValidUrl('https://example.com') // true
+ */
+export declare function isValidUrl(url: string): boolean;
+/**
+ * IPv4 주소 검증
+ * @example isValidIPv4('192.168.0.1') // true
+ */
+export declare function isValidIPv4(ip: string): boolean;
+/**
+ * 사업자등록번호 검증 (한국)
+ * @example isValidBusinessNumber('123-45-67890') // true
+ */
+export declare function isValidBusinessNumber(number: string): boolean;
+/**
+ * 주민등록번호 형식 검증 (실제 유효성은 검증하지 않음)
+ * @example isValidResidentNumber('900101-1234567') // 형식만 검증
+ */
+export declare function isValidResidentNumberFormat(number: string): boolean;
+/**
+ * 빈 값 검증
+ * @example isEmpty('') // true
+ * @example isEmpty(null) // true
+ * @example isEmpty([]) // true
+ */
+export declare function isEmpty(value: any): boolean;
+/**
+ * 빈 값이 아닌지 검증
+ */
+export declare function isNotEmpty(value: any): boolean;
+/**
+ * 숫자만 포함하는지 검증
+ * @example isNumericOnly('12345') // true
+ */
+export declare function isNumericOnly(value: string): boolean;
+/**
+ * 한글만 포함하는지 검증
+ * @example isKoreanOnly('홍길동') // true
+ */
+export declare function isKoreanOnly(value: string): boolean;
+/**
+ * 영문만 포함하는지 검증
+ * @example isAlphaOnly('abc') // true
+ */
+export declare function isAlphaOnly(value: string): boolean;
+/**
+ * 영문+숫자만 포함하는지 검증
+ * @example isAlphanumeric('abc123') // true
+ */
+export declare function isAlphanumeric(value: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAInD;AAMD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAWD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC5B,wBAAwB,CAsD1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAEpF;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAcnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIpD;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ/C;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAI/C;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB7D;AAMD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUnE;AAMD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAM3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGrD"}

package/dist/utils/validation.js

@@ -0,0 +1,260 @@
+/**
+ * Validation 유틸리티
+ * 이메일, 비밀번호, 전화번호 등 검증 함수
+ * KOMCA 패턴 업그레이드 버전
+ */
+// ============================================
+// 이메일 검증
+// ============================================
+/**
+ * 이메일 형식 검증
+ * @example isValidEmail('test@example.com') // true
+ */
+export function isValidEmail(email) {
+    if (!email || typeof email !== 'string')
+        return false;
+    const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+    return emailRegex.test(email.trim());
+}
+const DEFAULT_PASSWORD_OPTIONS = {
+    minLength: 8,
+    maxLength: 50,
+    requireUppercase: true,
+    requireLowercase: true,
+    requireNumber: true,
+    requireSpecialChar: true,
+};
+/**
+ * 비밀번호 검증 (상세 결과)
+ * @example
+ * const result = validatePassword('Test1234!');
+ * // { isValid: true, errors: [], strength: 'strong' }
+ */
+export function validatePassword(password, options = {}) {
+    const opts = { ...DEFAULT_PASSWORD_OPTIONS, ...options };
+    const errors = [];
+    if (!password || typeof password !== 'string') {
+        return { isValid: false, errors: ['비밀번호를 입력해주세요.'], strength: 'weak' };
+    }
+    // 길이 검증
+    if (opts.minLength && password.length < opts.minLength) {
+        errors.push(`비밀번호는 ${opts.minLength}자 이상이어야 합니다.`);
+    }
+    if (opts.maxLength && password.length > opts.maxLength) {
+        errors.push(`비밀번호는 ${opts.maxLength}자 이하여야 합니다.`);
+    }
+    // 대문자 검증
+    if (opts.requireUppercase && !/[A-Z]/.test(password)) {
+        errors.push('대문자를 포함해야 합니다.');
+    }
+    // 소문자 검증
+    if (opts.requireLowercase && !/[a-z]/.test(password)) {
+        errors.push('소문자를 포함해야 합니다.');
+    }
+    // 숫자 검증
+    if (opts.requireNumber && !/[0-9]/.test(password)) {
+        errors.push('숫자를 포함해야 합니다.');
+    }
+    // 특수문자 검증
+    if (opts.requireSpecialChar && !/[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?]/.test(password)) {
+        errors.push('특수문자를 포함해야 합니다.');
+    }
+    // 강도 계산
+    let strength = 'weak';
+    let score = 0;
+    if (password.length >= 8)
+        score++;
+    if (password.length >= 12)
+        score++;
+    if (/[A-Z]/.test(password))
+        score++;
+    if (/[a-z]/.test(password))
+        score++;
+    if (/[0-9]/.test(password))
+        score++;
+    if (/[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?]/.test(password))
+        score++;
+    if (score >= 5)
+        strength = 'strong';
+    else if (score >= 3)
+        strength = 'medium';
+    return {
+        isValid: errors.length === 0,
+        errors,
+        strength,
+    };
+}
+/**
+ * 비밀번호 형식 검증 (간단)
+ * @example isValidPassword('Test1234!') // true
+ */
+export function isValidPassword(password, options) {
+    return validatePassword(password, options).isValid;
+}
+// ============================================
+// 전화번호 검증
+// ============================================
+/**
+ * 한국 전화번호 검증
+ * @example isValidPhone('010-1234-5678') // true
+ * @example isValidPhone('01012345678') // true
+ */
+export function isValidPhone(phone) {
+    if (!phone || typeof phone !== 'string')
+        return false;
+    const cleaned = phone.replace(/[^0-9]/g, '');
+    // 휴대폰 (010, 011, 016, 017, 018, 019)
+    if (/^01[0-9]\d{7,8}$/.test(cleaned))
+        return true;
+    // 서울 지역번호
+    if (/^02\d{7,8}$/.test(cleaned))
+        return true;
+    // 기타 지역번호
+    if (/^0[3-6][0-9]\d{7,8}$/.test(cleaned))
+        return true;
+    return false;
+}
+/**
+ * 휴대폰 번호만 검증
+ * @example isValidMobile('010-1234-5678') // true
+ */
+export function isValidMobile(phone) {
+    if (!phone || typeof phone !== 'string')
+        return false;
+    const cleaned = phone.replace(/[^0-9]/g, '');
+    return /^01[016789]\d{7,8}$/.test(cleaned);
+}
+// ============================================
+// URL 검증
+// ============================================
+/**
+ * URL 형식 검증
+ * @example isValidUrl('https://example.com') // true
+ */
+export function isValidUrl(url) {
+    if (!url || typeof url !== 'string')
+        return false;
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================
+// IP 주소 검증
+// ============================================
+/**
+ * IPv4 주소 검증
+ * @example isValidIPv4('192.168.0.1') // true
+ */
+export function isValidIPv4(ip) {
+    if (!ip || typeof ip !== 'string')
+        return false;
+    const ipv4Regex = /^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+    return ipv4Regex.test(ip);
+}
+// ============================================
+// 사업자등록번호 검증
+// ============================================
+/**
+ * 사업자등록번호 검증 (한국)
+ * @example isValidBusinessNumber('123-45-67890') // true
+ */
+export function isValidBusinessNumber(number) {
+    if (!number || typeof number !== 'string')
+        return false;
+    const cleaned = number.replace(/[^0-9]/g, '');
+    if (cleaned.length !== 10)
+        return false;
+    const checkSum = [1, 3, 7, 1, 3, 7, 1, 3, 5];
+    let sum = 0;
+    for (let i = 0; i < 9; i++) {
+        sum += parseInt(cleaned[i]) * checkSum[i];
+    }
+    sum += Math.floor((parseInt(cleaned[8]) * 5) / 10);
+    const remainder = (10 - (sum % 10)) % 10;
+    return remainder === parseInt(cleaned[9]);
+}
+// ============================================
+// 주민등록번호 검증
+// ============================================
+/**
+ * 주민등록번호 형식 검증 (실제 유효성은 검증하지 않음)
+ * @example isValidResidentNumber('900101-1234567') // 형식만 검증
+ */
+export function isValidResidentNumberFormat(number) {
+    if (!number || typeof number !== 'string')
+        return false;
+    const cleaned = number.replace(/[^0-9]/g, '');
+    if (cleaned.length !== 13)
+        return false;
+    // 성별 코드 검증 (1~4)
+    const genderCode = parseInt(cleaned[6]);
+    if (genderCode < 1 || genderCode > 4)
+        return false;
+    return true;
+}
+// ============================================
+// 공통 유틸리티
+// ============================================
+/**
+ * 빈 값 검증
+ * @example isEmpty('') // true
+ * @example isEmpty(null) // true
+ * @example isEmpty([]) // true
+ */
+export function isEmpty(value) {
+    if (value === null || value === undefined)
+        return true;
+    if (typeof value === 'string')
+        return value.trim() === '';
+    if (Array.isArray(value))
+        return value.length === 0;
+    if (typeof value === 'object')
+        return Object.keys(value).length === 0;
+    return false;
+}
+/**
+ * 빈 값이 아닌지 검증
+ */
+export function isNotEmpty(value) {
+    return !isEmpty(value);
+}
+/**
+ * 숫자만 포함하는지 검증
+ * @example isNumericOnly('12345') // true
+ */
+export function isNumericOnly(value) {
+    if (!value || typeof value !== 'string')
+        return false;
+    return /^\d+$/.test(value);
+}
+/**
+ * 한글만 포함하는지 검증
+ * @example isKoreanOnly('홍길동') // true
+ */
+export function isKoreanOnly(value) {
+    if (!value || typeof value !== 'string')
+        return false;
+    return /^[가-힣]+$/.test(value);
+}
+/**
+ * 영문만 포함하는지 검증
+ * @example isAlphaOnly('abc') // true
+ */
+export function isAlphaOnly(value) {
+    if (!value || typeof value !== 'string')
+        return false;
+    return /^[a-zA-Z]+$/.test(value);
+}
+/**
+ * 영문+숫자만 포함하는지 검증
+ * @example isAlphanumeric('abc123') // true
+ */
+export function isAlphanumeric(value) {
+    if (!value || typeof value !== 'string')
+        return false;
+    return /^[a-zA-Z0-9]+$/.test(value);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sonhoseong/mfa-lib",
-  "version": "1.3.7",
-  "description": "MFA 공통 라이브러리 - KOMCA 패턴",
+  "version": "1.3.10",
+  "description": "MFA 공통 라이브러리",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -9,16 +9,18 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && copyfiles -u 1 \"src/**/*.css\" dist",
     "watch": "tsc --watch"
   },
   "dependencies": {
     "@reduxjs/toolkit": "^2.11.2",
+    "@supabase/supabase-js": "^2.93.3",
     "axios": "^1.7.9",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
     "@types/uuid": "^10.0.0",
+    "copyfiles": "^2.4.1",
     "typescript": "^5.0.0"
   },
   "peerDependencies": {