@sonhoseong/mfa-lib 1.3.7 → 1.3.10

package/dist/hooks/use-global-loading.js

@@ -1,5 +1,5 @@
 /**
- * Global Loading Hook - KOMCA 패턴
+ * Global Loading Hook
  * API 호출 시 전역 로딩 표시
  */
 import { useCallback } from 'react';

package/dist/hooks/use-initialize.d.ts

@@ -1,5 +1,5 @@
 /**
- * Initialize Hook - KOMCA 패턴
+ * Initialize Hook
  * 앱 시작시 초기화 (토큰 갱신, 사용자 정보 로드)
  */
 import { User } from '../types';
@@ -23,4 +23,11 @@ export declare function useInitialize(options?: InitializeOptions): {
 export declare function useSimpleInitialize(): {
     initialized: boolean;
 };
+/**
+ * Supabase 초기화 Hook
+ * 앱 시작 시 Supabase 세션 복구 및 Auth 상태 변경 구독
+ */
+export declare function useSupabaseInitialize(): {
+    initialized: boolean;
+};
 //# sourceMappingURL=use-initialize.d.ts.map

package/dist/hooks/use-initialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-initialize.d.ts","sourceRoot":"","sources":["../../src/hooks/use-initialize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGhC,MAAM,WAAW,iBAAiB;IAEhC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE5C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAE3C,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAE3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,iBAAsB;;;;EAyE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;EA4BlC"}
+{"version":3,"file":"use-initialize.d.ts","sourceRoot":"","sources":["../../src/hooks/use-initialize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAiBhC,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,iBAAsB;;;;EAmE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;EAyBlC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB;;EAgHpC"}

package/dist/hooks/use-initialize.js

@@ -1,10 +1,23 @@
 /**
- * Initialize Hook - KOMCA 패턴
+ * Initialize Hook
  * 앱 시작시 초기화 (토큰 갱신, 사용자 정보 로드)
  */
 import { useEffect, useState } from 'react';
-import { dispatchToHost } from '../store/store-access';
+import { getStore, setAccessToken, setUser, logout } from '../store/app-store';
 import { storage } from '../utils/storage';
+import { getSupabase } from '../network/supabase-client';
+/**
+ * Supabase User를 앱 User 타입으로 변환
+ */
+function mapSupabaseUser(supabaseUser) {
+    return {
+        id: supabaseUser.id,
+        email: supabaseUser.email || '',
+        name: supabaseUser.user_metadata?.name || supabaseUser.email?.split('@')[0] || '',
+        role: supabaseUser.user_metadata?.role || 'user',
+        avatar: supabaseUser.user_metadata?.avatar_url,
+    };
+}
 /**
  * 앱 초기화 Hook
  */
@@ -16,28 +29,25 @@ export function useInitialize(options = {}) {
         const initialize = async () => {
             try {
                 setLoading(true);
-                // 1. Storage에서 기존 토큰 복구
+                const store = getStore();
                 const savedToken = storage.getAccessToken();
                 const savedUser = storage.getUser();
                 if (savedToken) {
-                    // Store에 복구
-                    dispatchToHost({ type: 'app/setAccessToken', payload: savedToken });
+                    store.dispatch(setAccessToken(savedToken));
                     if (savedUser) {
-                        dispatchToHost({ type: 'app/setUser', payload: savedUser });
+                        store.dispatch(setUser(savedUser));
                     }
-                    // 2. 토큰 갱신 시도 (옵션)
                     if (options.refreshToken) {
                         try {
                             const newToken = await options.refreshToken();
                             if (newToken) {
-                                dispatchToHost({ type: 'app/setAccessToken', payload: newToken });
+                                store.dispatch(setAccessToken(newToken));
                                 storage.setAccessToken(newToken);
                                 console.log('[Initialize] 토큰 갱신 성공');
-                                // 3. 사용자 정보 갱신 (옵션)
                                 if (options.fetchUserInfo) {
                                     const userInfo = await options.fetchUserInfo();
                                     if (userInfo) {
-                                        dispatchToHost({ type: 'app/setUser', payload: userInfo });
+                                        store.dispatch(setUser(userInfo));
                                         storage.setUser(userInfo);
                                         console.log('[Initialize] 사용자 정보 갱신:', userInfo.email);
                                     }
@@ -49,13 +59,10 @@ export function useInitialize(options = {}) {
                         }
                     }
                 }
-                // 4. Recent Menu 복구
+                // Recent Menu 복구
                 const savedRecentMenu = storage.getRecentMenu();
                 if (savedRecentMenu.length > 0) {
-                    dispatchToHost({
-                        type: 'recentMenu/setRecentMenu',
-                        payload: { list: savedRecentMenu },
-                    });
+                    store.dispatch({ type: 'recentMenu/setRecentMenu', payload: { list: savedRecentMenu } });
                 }
                 setInitialized(true);
                 options.onInitialized?.();
@@ -81,24 +88,120 @@ export function useInitialize(options = {}) {
 export function useSimpleInitialize() {
     const [initialized, setInitialized] = useState(false);
     useEffect(() => {
-        // Storage에서 복구
+        const store = getStore();
         const savedToken = storage.getAccessToken();
         const savedUser = storage.getUser();
         if (savedToken) {
-            dispatchToHost({ type: 'app/setAccessToken', payload: savedToken });
+            store.dispatch(setAccessToken(savedToken));
         }
         if (savedUser) {
-            dispatchToHost({ type: 'app/setUser', payload: savedUser });
+            store.dispatch(setUser(savedUser));
         }
-        // Recent Menu 복구
         const savedRecentMenu = storage.getRecentMenu();
         if (savedRecentMenu.length > 0) {
-            dispatchToHost({
-                type: 'recentMenu/setRecentMenu',
-                payload: { list: savedRecentMenu },
-            });
+            store.dispatch({ type: 'recentMenu/setRecentMenu', payload: { list: savedRecentMenu } });
         }
         setInitialized(true);
     }, []);
     return { initialized };
 }
+/**
+ * Supabase 초기화 Hook
+ * 앱 시작 시 Supabase 세션 복구 및 Auth 상태 변경 구독
+ */
+export function useSupabaseInitialize() {
+    const [initialized, setInitialized] = useState(false);
+    useEffect(() => {
+        let cleanup;
+        const initialize = async () => {
+            const store = getStore();
+            try {
+                // Supabase 클라이언트 가져오기 (없으면 fallback)
+                let supabase;
+                try {
+                    supabase = getSupabase();
+                }
+                catch {
+                    // Supabase가 초기화되지 않은 경우 localStorage에서 복구
+                    console.warn('[Supabase Init] Supabase 미초기화, localStorage fallback');
+                    const savedToken = storage.getAccessToken();
+                    const savedUser = storage.getUser();
+                    if (savedToken) {
+                        store.dispatch(setAccessToken(savedToken));
+                    }
+                    if (savedUser) {
+                        store.dispatch(setUser(savedUser));
+                    }
+                    // Recent Menu 복구
+                    const savedRecentMenu = storage.getRecentMenu();
+                    if (savedRecentMenu.length > 0) {
+                        store.dispatch({ type: 'recentMenu/setRecentMenuList', payload: savedRecentMenu });
+                    }
+                    setInitialized(true);
+                    return;
+                }
+                // 1. 현재 세션 확인
+                const { data: { session }, error } = await supabase.auth.getSession();
+                if (error) {
+                    console.warn('[Supabase Init] 세션 가져오기 실패:', error.message);
+                }
+                if (session) {
+                    const user = mapSupabaseUser(session.user);
+                    store.dispatch(setAccessToken(session.access_token));
+                    store.dispatch(setUser(user));
+                    storage.setAccessToken(session.access_token);
+                    storage.setUser(user);
+                    console.log('[Supabase Init] 세션 복구:', user.email);
+                }
+                else {
+                    // 세션 없으면 localStorage에서 복구 시도
+                    const savedToken = storage.getAccessToken();
+                    const savedUser = storage.getUser();
+                    if (savedToken) {
+                        store.dispatch(setAccessToken(savedToken));
+                    }
+                    if (savedUser) {
+                        store.dispatch(setUser(savedUser));
+                    }
+                }
+                // 2. Recent Menu 복구
+                const savedRecentMenu = storage.getRecentMenu();
+                if (savedRecentMenu.length > 0) {
+                    store.dispatch({ type: 'recentMenu/setRecentMenuList', payload: savedRecentMenu });
+                }
+                // 3. Auth 상태 변경 구독
+                const { data: { subscription } } = supabase.auth.onAuthStateChange((event, session) => {
+                    if (session) {
+                        const user = mapSupabaseUser(session.user);
+                        store.dispatch(setAccessToken(session.access_token));
+                        store.dispatch(setUser(user));
+                        storage.setAccessToken(session.access_token);
+                        storage.setUser(user);
+                    }
+                    else if (event === 'SIGNED_OUT') {
+                        store.dispatch(logout());
+                        storage.clearAuth();
+                    }
+                });
+                cleanup = () => subscription.unsubscribe();
+                setInitialized(true);
+            }
+            catch (err) {
+                console.error('[Supabase Init] 초기화 실패:', err);
+                // 에러 발생해도 localStorage에서 복구 시도
+                const savedToken = storage.getAccessToken();
+                const savedUser = storage.getUser();
+                if (savedToken) {
+                    store.dispatch(setAccessToken(savedToken));
+                }
+                if (savedUser) {
+                    store.dispatch(setUser(savedUser));
+                }
+                setInitialized(true);
+            }
+        };
+        initialize();
+        return () => cleanup?.();
+    }, []);
+    return { initialized };
+}

package/dist/hooks/use-modal.d.ts

@@ -1,5 +1,5 @@
 /**
- * Modal Hooks - KOMCA 패턴
+ * Modal Hooks
  * Alert, Confirm 모달 관리
  */
 export interface SimpleModalOptions {
@@ -29,11 +29,27 @@ export declare function useAlertModal(): AlertModalResult;
  */
 export declare function useConfirmModal(): ConfirmModalResult;
 /**
- * 비동기 Alert 모달 - 간편 사용
+ * 비동기 Alert 모달 - ModalContext 연동
+ * KOMCA 패턴 업그레이드: Context 기반으로 커스텀 모달 사용
+ *
+ * @example
+ * const alert = useAsyncAlert();
+ * await alert('저장되었습니다.');
+ * await alert('오류가 발생했습니다.', '오류');
  */
-export declare function useAsyncAlertModal(): (message: string, title?: string) => Promise<void>;
+export declare function useAsyncAlert(): (message: string, title?: string) => Promise<void>;
 /**
- * 비동기 Confirm 모달 - 간편 사용
+ * 비동기 Confirm 모달 - ModalContext 연동
+ * KOMCA 패턴 업그레이드: Context 기반으로 커스텀 모달 사용
+ *
+ * @example
+ * const confirm = useAsyncConfirm();
+ * const result = await confirm('삭제하시겠습니까?');
+ * if (result) {
+ *   // 삭제 처리
+ * }
  */
-export declare function useAsyncConfirmModal(): (message: string, title?: string) => Promise<boolean>;
+export declare function useAsyncConfirm(): (message: string, title?: string) => Promise<boolean>;
+export declare const useAsyncAlertModal: typeof useAsyncAlert;
+export declare const useAsyncConfirmModal: typeof useAsyncConfirm;
 //# sourceMappingURL=use-modal.d.ts.map

package/dist/hooks/use-modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-modal.d.ts","sourceRoot":"","sources":["../../src/hooks/use-modal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAGD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CA4BhD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,CA4BpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,cACH,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,cACL,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC,CAOvE"}
+{"version":3,"file":"use-modal.d.ts","sourceRoot":"","sources":["../../src/hooks/use-modal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAGD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CA4BhD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,CA4BpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,cAYQ,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAQ1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,cAWM,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC,CAQ7E;AAGD,eAAO,MAAM,kBAAkB,sBAAgB,CAAC;AAChD,eAAO,MAAM,oBAAoB,wBAAkB,CAAC"}

package/dist/hooks/use-modal.js

@@ -1,5 +1,5 @@
 /**
- * Modal Hooks - KOMCA 패턴
+ * Modal Hooks
  * Alert, Confirm 모달 관리
  */
 import { useCallback, useState } from 'react';
@@ -58,26 +58,66 @@ export function useConfirmModal() {
     return { isOpen, options, show, close };
 }
 /**
- * 비동기 Alert 모달 - 간편 사용
+ * 비동기 Alert 모달 - ModalContext 연동
+ * KOMCA 패턴 업그레이드: Context 기반으로 커스텀 모달 사용
+ *
+ * @example
+ * const alert = useAsyncAlert();
+ * await alert('저장되었습니다.');
+ * await alert('오류가 발생했습니다.', '오류');
  */
-export function useAsyncAlertModal() {
-    return useCallback((message, title) => {
-        return new Promise((resolve) => {
-            // 브라우저 기본 alert 사용 (커스텀 모달로 교체 가능)
-            alert(title ? `${title}\n\n${message}` : message);
-            resolve();
-        });
+export function useAsyncAlert() {
+    // ModalContext를 직접 import하지 않고 동적으로 가져옴 (순환 참조 방지)
+    const getModalContext = useCallback(() => {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { useModalContext } = require('../components/modal/ModalContext');
+            return useModalContext();
+        }
+        catch {
+            return null;
+        }
     }, []);
+    return useCallback(async (message, title) => {
+        const context = getModalContext();
+        if (context?.alert) {
+            return context.alert(message, title);
+        }
+        // fallback: 브라우저 기본 alert
+        alert(title ? `${title}\n\n${message}` : message);
+    }, [getModalContext]);
 }
 /**
- * 비동기 Confirm 모달 - 간편 사용
+ * 비동기 Confirm 모달 - ModalContext 연동
+ * KOMCA 패턴 업그레이드: Context 기반으로 커스텀 모달 사용
+ *
+ * @example
+ * const confirm = useAsyncConfirm();
+ * const result = await confirm('삭제하시겠습니까?');
+ * if (result) {
+ *   // 삭제 처리
+ * }
  */
-export function useAsyncConfirmModal() {
-    return useCallback((message, title) => {
-        return new Promise((resolve) => {
-            // 브라우저 기본 confirm 사용 (커스텀 모달로 교체 가능)
-            const result = confirm(title ? `${title}\n\n${message}` : message);
-            resolve(result);
-        });
+export function useAsyncConfirm() {
+    const getModalContext = useCallback(() => {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { useModalContext } = require('../components/modal/ModalContext');
+            return useModalContext();
+        }
+        catch {
+            return null;
+        }
     }, []);
+    return useCallback(async (message, title) => {
+        const context = getModalContext();
+        if (context?.confirm) {
+            return context.confirm(message, title);
+        }
+        // fallback: 브라우저 기본 confirm
+        return confirm(title ? `${title}\n\n${message}` : message);
+    }, [getModalContext]);
 }
+// 하위 호환성을 위한 alias
+export const useAsyncAlertModal = useAsyncAlert;
+export const useAsyncConfirmModal = useAsyncConfirm;

package/dist/hooks/use-navigate.d.ts

@@ -1,5 +1,5 @@
 /**
- * MFA Navigate Hook - KOMCA 패턴
+ * MFA Navigate Hook
  * 서비스 인식 네비게이션
  */
 import { NavigateOptions } from 'react-router-dom';

package/dist/hooks/use-navigate.js

@@ -1,5 +1,5 @@
 /**
- * MFA Navigate Hook - KOMCA 패턴
+ * MFA Navigate Hook
  * 서비스 인식 네비게이션
  */
 import { useCallback, useMemo } from 'react';

package/dist/hooks/use-network-status.d.ts

@@ -0,0 +1,15 @@
+export type ConnectionType = 'slow-2g' | '2g' | '3g' | '4g' | 'unknown';
+interface NetworkStatus {
+    connectionType: ConnectionType;
+    isSlowNetwork: boolean;
+    isOnline: boolean;
+}
+/**
+ * 사용자의 네트워크 상태를 감지하는 훅
+ * - effectiveType: 연결 품질 (slow-2g, 2g, 3g, 4g)
+ * - isSlowNetwork: 느린 네트워크 여부 (slow-2g, 2g, 3g)
+ * - isOnline: 온라인 상태
+ */
+declare const useNetworkStatus: () => NetworkStatus;
+export default useNetworkStatus;
+//# sourceMappingURL=use-network-status.d.ts.map

package/dist/hooks/use-network-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-network-status.d.ts","sourceRoot":"","sources":["../../src/hooks/use-network-status.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;AAExE,UAAU,aAAa;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,QAAO,aAiD5B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/hooks/use-network-status.js

@@ -0,0 +1,49 @@
+import { useEffect, useState } from 'react';
+/**
+ * 사용자의 네트워크 상태를 감지하는 훅
+ * - effectiveType: 연결 품질 (slow-2g, 2g, 3g, 4g)
+ * - isSlowNetwork: 느린 네트워크 여부 (slow-2g, 2g, 3g)
+ * - isOnline: 온라인 상태
+ */
+const useNetworkStatus = () => {
+    const getConnectionType = () => {
+        if ('connection' in navigator) {
+            const nav = navigator;
+            if (nav.connection?.effectiveType) {
+                return nav.connection.effectiveType;
+            }
+        }
+        return 'unknown';
+    };
+    const [connectionType, setConnectionType] = useState(getConnectionType());
+    const [isOnline, setIsOnline] = useState(navigator.onLine);
+    useEffect(() => {
+        // Network Information API
+        if ('connection' in navigator) {
+            const nav = navigator;
+            if (nav.connection) {
+                const updateConnectionStatus = () => {
+                    setConnectionType(nav.connection?.effectiveType || 'unknown');
+                };
+                nav.connection.addEventListener('change', updateConnectionStatus);
+                return () => {
+                    nav.connection?.removeEventListener('change', updateConnectionStatus);
+                };
+            }
+        }
+    }, []);
+    useEffect(() => {
+        // Online/Offline 상태
+        const handleOnline = () => setIsOnline(true);
+        const handleOffline = () => setIsOnline(false);
+        window.addEventListener('online', handleOnline);
+        window.addEventListener('offline', handleOffline);
+        return () => {
+            window.removeEventListener('online', handleOnline);
+            window.removeEventListener('offline', handleOffline);
+        };
+    }, []);
+    const isSlowNetwork = ['slow-2g', '2g', '3g'].includes(connectionType);
+    return { connectionType, isSlowNetwork, isOnline };
+};
+export default useNetworkStatus;

package/dist/hooks/use-permission.d.ts

@@ -0,0 +1,22 @@
+/**
+ * usePermission Hook
+ * 권한 기반 접근 제어를 위한 훅
+ */
+import { UserRole, PermissionAction, MenuItem, MenuPermission } from '../types';
+/**
+ * usePermission Hook
+ * 현재 사용자의 권한을 확인하는 훅
+ */
+export declare function usePermission(): {
+    user: import("../types").User | null;
+    can: (code: string, action?: PermissionAction) => boolean;
+    canAny: (codes: string[], action?: PermissionAction) => boolean;
+    canAll: (codes: string[], action?: PermissionAction) => boolean;
+    isRole: (roles: UserRole | UserRole[]) => boolean;
+    isAdmin: boolean;
+    checkMenu: (permission?: MenuPermission) => boolean;
+    filterMenus: (menus: MenuItem[]) => MenuItem[];
+    canAccess: (menus: MenuItem[], path: string) => boolean;
+};
+export default usePermission;
+//# sourceMappingURL=use-permission.d.ts.map

package/dist/hooks/use-permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-permission.d.ts","sourceRoot":"","sources":["../../src/hooks/use-permission.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,aAAa;;gBAOlB,MAAM,WAAU,gBAAgB,KAAY,OAAO;oBAUlD,MAAM,EAAE,WAAU,gBAAgB,KAAY,OAAO;oBAUrD,MAAM,EAAE,WAAU,gBAAgB,KAAY,OAAO;oBAUrD,QAAQ,GAAG,QAAQ,EAAE,KAAG,OAAO;;6BAezB,cAAc,KAAG,OAAO;yBAU9B,QAAQ,EAAE,KAAG,QAAQ,EAAE;uBAUvB,QAAQ,EAAE,QAAQ,MAAM,KAAG,OAAO;EAiB7C;AAED,eAAe,aAAa,CAAC"}

package/dist/hooks/use-permission.js

@@ -0,0 +1,73 @@
+/**
+ * usePermission Hook
+ * 권한 기반 접근 제어를 위한 훅
+ */
+import { useMemo, useCallback } from 'react';
+import { useSelector } from 'react-redux';
+import { selectUser } from '../store/app-store';
+import { hasPermission, hasAnyPermission, hasAllPermissions, hasRole, checkMenuPermission, filterMenusByPermission, canAccessPath, } from '../utils/permission';
+/**
+ * usePermission Hook
+ * 현재 사용자의 권한을 확인하는 훅
+ */
+export function usePermission() {
+    const user = useSelector(selectUser);
+    /**
+     * 특정 코드에 대한 권한 확인
+     */
+    const can = useCallback((code, action = 'read') => {
+        return hasPermission(user, code, action);
+    }, [user]);
+    /**
+     * 여러 코드 중 하나라도 권한이 있는지 확인
+     */
+    const canAny = useCallback((codes, action = 'read') => {
+        return hasAnyPermission(user, codes, action);
+    }, [user]);
+    /**
+     * 모든 코드에 대한 권한이 있는지 확인
+     */
+    const canAll = useCallback((codes, action = 'read') => {
+        return hasAllPermissions(user, codes, action);
+    }, [user]);
+    /**
+     * 특정 역할인지 확인
+     */
+    const isRole = useCallback((roles) => {
+        return hasRole(user, roles);
+    }, [user]);
+    /**
+     * 관리자 여부
+     */
+    const isAdmin = useMemo(() => user?.role === 'admin', [user]);
+    /**
+     * 메뉴 권한 체크
+     */
+    const checkMenu = useCallback((permission) => {
+        return checkMenuPermission(user, permission);
+    }, [user]);
+    /**
+     * 메뉴 필터링
+     */
+    const filterMenus = useCallback((menus) => {
+        return filterMenusByPermission(menus, user);
+    }, [user]);
+    /**
+     * 특정 경로 접근 가능 여부
+     */
+    const canAccess = useCallback((menus, path) => {
+        return canAccessPath(menus, path, user);
+    }, [user]);
+    return {
+        user,
+        can,
+        canAny,
+        canAll,
+        isRole,
+        isAdmin,
+        checkMenu,
+        filterMenus,
+        canAccess,
+    };
+}
+export default usePermission;

package/dist/hooks/use-recent-menu.d.ts

@@ -0,0 +1,46 @@
+/**
+ * useRecentMenu Hook
+ * 최근 방문 메뉴 상태 저장/복구
+ */
+import { RecentMenu } from '../types';
+export interface UseRecentMenuOptions {
+    /** 자동으로 현재 경로를 최근 메뉴에 추가할지 여부 */
+    autoTrack?: boolean;
+    /** 제외할 경로 패턴 */
+    excludePaths?: (string | RegExp)[];
+    /** 메뉴 제목 생성 함수 */
+    getTitleFromPath?: (pathname: string) => string;
+}
+/**
+ * useRecentMenu Hook
+ */
+export declare function useRecentMenu(options?: UseRecentMenuOptions): {
+    /** 최근 메뉴 목록 */
+    list: RecentMenu[];
+    /** 현재 활성 메뉴 */
+    current: RecentMenu | null;
+    /** 현재 활성 메뉴 ID */
+    currentId: string;
+    /** 메뉴 추가 */
+    add: (menu: Omit<RecentMenu, "id"> & {
+        id?: string;
+    }) => void;
+    /** 메뉴 제거 */
+    remove: (id: string) => void;
+    /** 현재 메뉴 설정 */
+    setCurrent: (id: string) => void;
+    /** 메뉴로 이동 */
+    goTo: (id: string) => void;
+    /** 메뉴 상태 업데이트 */
+    updateState: (id: string, state: any) => void;
+    /** 메뉴 데이터 업데이트 */
+    updateData: (id: string, data: any) => void;
+    /** 현재 메뉴 상태 업데이트 */
+    updateCurrentState: (state: any) => void;
+    /** 모든 메뉴 닫기 */
+    closeAll: () => void;
+    /** 다른 메뉴 모두 닫기 */
+    closeOthers: () => void;
+};
+export default useRecentMenu;
+//# sourceMappingURL=use-recent-menu.d.ts.map

package/dist/hooks/use-recent-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-recent-menu.d.ts","sourceRoot":"","sources":["../../src/hooks/use-recent-menu.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB;IAChB,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACnC,kBAAkB;IAClB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB;IAoL5D,eAAe;;IAEf,eAAe;;IAEf,kBAAkB;;IAElB,YAAY;gBArGL,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE;IAuG/C,YAAY;iBA5FP,MAAM;IA8FX,eAAe;qBApFV,MAAM;IAsFX,aAAa;eA5ER,MAAM;IA8EX,iBAAiB;sBAzDZ,MAAM,SAAS,GAAG;IA2DvB,kBAAkB;qBAjDb,MAAM,QAAQ,GAAG;IAmDtB,oBAAoB;gCAzCZ,GAAG;IA2CX,eAAe;;IAEf,kBAAkB;;EAGrB;AAED,eAAe,aAAa,CAAC"}