@blastlabs/utils 1.12.0 → 1.12.1

package/dist/hooks/auth/useAuth.d.ts

@@ -0,0 +1,275 @@
+/**
+ * 인증 상태
+ */
+export interface AuthUser {
+    [key: string]: any;
+}
+/**
+ * 로그인 credentials
+ */
+export interface LoginCredentials {
+    [key: string]: any;
+}
+/**
+ * 회원가입 데이터
+ */
+export interface RegisterData {
+    [key: string]: any;
+}
+/**
+ * useAuth 옵션
+ */
+export interface UseAuthOptions<TUser extends AuthUser = AuthUser> {
+    /** 로그인 API 함수 */
+    loginFn?: (credentials: LoginCredentials) => Promise<{
+        user: TUser;
+        token?: string;
+    }>;
+    /** 로그아웃 API 함수 */
+    logoutFn?: () => Promise<void>;
+    /** 회원가입 API 함수 */
+    registerFn?: (data: RegisterData) => Promise<{
+        user: TUser;
+        token?: string;
+    }>;
+    /** 현재 사용자 정보 가져오기 */
+    getUserFn?: () => Promise<TUser>;
+    /** 토큰 갱신 함수 */
+    refreshTokenFn?: () => Promise<{
+        token: string;
+    }>;
+    /** 로그인 성공 시 콜백 */
+    onLoginSuccess?: (user: TUser) => void;
+    /** 로그아웃 성공 시 콜백 */
+    onLogoutSuccess?: () => void;
+    /** 회원가입 성공 시 콜백 */
+    onRegisterSuccess?: (user: TUser) => void;
+    /** 에러 발생 시 콜백 */
+    onError?: (error: Error, action: 'login' | 'logout' | 'register' | 'refresh') => void;
+    /**
+     * localStorage에 저장할 토큰 키 (기본값: 'auth_token')
+     *
+     * @example
+     * ```
+     * // localStorage 저장 예시:
+     * localStorage.setItem('auth_token', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...')
+     * ```
+     */
+    storageKey?: string;
+    /**
+     * 사용자 정보 저장 키 (기본값: 'auth_user')
+     *
+     * @example
+     * ```
+     * // localStorage 저장 예시:
+     * localStorage.setItem('auth_user', '{"id":"123","name":"John Doe","email":"john@example.com"}')
+     * ```
+     */
+    userStorageKey?: string;
+    /**
+     * localStorage 대신 sessionStorage 사용 여부 (기본값: false)
+     *
+     * - false (기본값): localStorage 사용 → 브라우저 종료 후에도 유지
+     * - true: sessionStorage 사용 → 브라우저/탭 종료 시 삭제
+     *
+     * 참고: login() 함수의 rememberMe 옵션으로 동적 선택도 가능합니다.
+     */
+    useSessionStorage?: boolean;
+    /** 자동 토큰 갱신 여부 (기본값: false) */
+    autoRefresh?: boolean;
+    /** 토큰 갱신 간격 (밀리초, 기본값: 300000 = 5분) */
+    refreshInterval?: number;
+    /** 초기화 시 사용자 정보 자동 로드 여부 (기본값: true) */
+    autoLoadUser?: boolean;
+}
+/**
+ * useAuth 반환 타입
+ */
+export interface UseAuthReturn<TUser extends AuthUser = AuthUser> {
+    /** 현재 로그인한 사용자 */
+    user: TUser | null;
+    /** 인증 여부 */
+    isAuthenticated: boolean;
+    /** 로딩 중 여부 */
+    isLoading: boolean;
+    /** 로그인 진행 중 여부 */
+    isLoggingIn: boolean;
+    /** 로그아웃 진행 중 여부 */
+    isLoggingOut: boolean;
+    /** 회원가입 진행 중 여부 */
+    isRegistering: boolean;
+    /** 에러 */
+    error: Error | null;
+    /** 로그인 함수 */
+    login: (credentials: LoginCredentials, options?: {
+        rememberMe?: boolean;
+    }) => Promise<void>;
+    /** 로그아웃 함수 */
+    logout: () => Promise<void>;
+    /** 회원가입 함수 */
+    register: (data: RegisterData, options?: {
+        rememberMe?: boolean;
+    }) => Promise<void>;
+    /** 토큰 갱신 함수 */
+    refreshToken: () => Promise<void>;
+    /** 사용자 정보 새로고침 */
+    refetchUser: () => Promise<void>;
+    /** 현재 토큰 */
+    token: string | null;
+    /** 토큰 수동 설정 */
+    setToken: (token: string | null) => void;
+    /** 사용자 정보 수동 설정 */
+    setUser: (user: TUser | null) => void;
+}
+/**
+ * 인증 관리 Hook
+ *
+ * 로그인, 로그아웃, 회원가입, 토큰 관리 등 인증 관련 기능을 제공합니다.
+ *
+ * @example
+ * ```tsx
+ * // 기본 사용 (로그인 유지 옵션 포함)
+ * function LoginPage() {
+ *   const [rememberMe, setRememberMe] = useState(false);
+ *   const { login, isLoggingIn, error, isAuthenticated } = useAuth({
+ *     loginFn: (credentials) => api.login(credentials),
+ *     onLoginSuccess: (user) => {
+ *       console.log('로그인 성공:', user);
+ *       navigate('/dashboard');
+ *     },
+ *   });
+ *
+ *   const handleSubmit = async (e) => {
+ *     e.preventDefault();
+ *     // rememberMe가 true면 localStorage, false면 sessionStorage 사용
+ *     await login({ email, password }, { rememberMe });
+ *   };
+ *
+ *   if (isAuthenticated) {
+ *     return <Navigate to="/dashboard" />;
+ *   }
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input type="email" value={email} onChange={(e) => setEmail(e.target.value)} />
+ *       <input type="password" value={password} onChange={(e) => setPassword(e.target.value)} />
+ *       <label>
+ *         <input type="checkbox" checked={rememberMe} onChange={(e) => setRememberMe(e.target.checked)} />
+ *         로그인 유지
+ *       </label>
+ *       <button type="submit" disabled={isLoggingIn}>
+ *         {isLoggingIn ? '로그인 중...' : '로그인'}
+ *       </button>
+ *       {error && <div>{error.message}</div>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 자동 토큰 갱신과 함께 사용
+ * function App() {
+ *   const { user, isAuthenticated, isLoading, logout } = useAuth({
+ *     getUserFn: () => api.getMe(),
+ *     logoutFn: () => api.logout(),
+ *     refreshTokenFn: () => api.refreshToken(),
+ *     autoRefresh: true,
+ *     refreshInterval: 300000, // 5분마다 갱신
+ *     onLogoutSuccess: () => navigate('/login'),
+ *   });
+ *
+ *   if (isLoading) return <div>로딩중...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {isAuthenticated ? (
+ *         <>
+ *           <div>환영합니다, {user?.name}님</div>
+ *           <button onClick={logout}>로그아웃</button>
+ *         </>
+ *       ) : (
+ *         <LoginPage />
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 회원가입 포함
+ * function RegisterPage() {
+ *   const { register, isRegistering, error } = useAuth({
+ *     registerFn: (data) => api.register(data),
+ *     onRegisterSuccess: (user) => {
+ *       toast.success('회원가입 성공!');
+ *       navigate('/');
+ *     },
+ *   });
+ *
+ *   const handleSubmit = async (data) => {
+ *     await register(data);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input name="email" />
+ *       <input name="password" type="password" />
+ *       <input name="name" />
+ *       <button type="submit" disabled={isRegistering}>
+ *         회원가입
+ *       </button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Storage에 저장되는 값 확인하기
+ * function DebugAuth() {
+ *   const { login, user, token } = useAuth({
+ *     loginFn: api.login,
+ *     storageKey: 'my_app_token',      // 커스텀 키 사용 가능
+ *     userStorageKey: 'my_app_user',
+ *   });
+ *
+ *   const handleLogin = async () => {
+ *     await login({ email, password }, { rememberMe: true });
+ *
+ *     // 로그인 후 storage 확인
+ *     console.log('Token:', localStorage.getItem('my_app_token'));
+ *     // 출력: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+ *
+ *     console.log('User:', localStorage.getItem('my_app_user'));
+ *     // 출력: {"id":"123","name":"John Doe","email":"john@example.com"}
+ *   };
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // rememberMe에 따른 storage 동작
+ * function LoginWithRememberMe() {
+ *   const [rememberMe, setRememberMe] = useState(false);
+ *   const { login } = useAuth({ loginFn: api.login });
+ *
+ *   const handleLogin = async () => {
+ *     await login({ email, password }, { rememberMe });
+ *
+ *     if (rememberMe) {
+ *       // localStorage에 저장 (브라우저 종료해도 유지)
+ *       console.log(localStorage.getItem('auth_token'));    // "eyJ..."
+ *       console.log(sessionStorage.getItem('auth_token'));  // null
+ *     } else {
+ *       // sessionStorage에 저장 (브라우저 종료 시 삭제)
+ *       console.log(localStorage.getItem('auth_token'));    // null
+ *       console.log(sessionStorage.getItem('auth_token'));  // "eyJ..."
+ *     }
+ *   };
+ * }
+ * ```
+ */
+export declare function useAuth<TUser extends AuthUser = AuthUser>(options?: UseAuthOptions<TUser>): UseAuthReturn<TUser>;
+//# sourceMappingURL=useAuth.d.ts.map

package/dist/hooks/auth/useAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../../src/hooks/auth/useAuth.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAC/D,iBAAiB;IACjB,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEtF,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,kBAAkB;IAClB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE9E,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAEjC,eAAe;IACf,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElD,kBAAkB;IAClB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IAEvC,mBAAmB;IACnB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAE7B,mBAAmB;IACnB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IAE1C,iBAAiB;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,KAAK,IAAI,CAAC;IAEtF;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAC9D,kBAAkB;IAClB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAEnB,YAAY;IACZ,eAAe,EAAE,OAAO,CAAC;IAEzB,cAAc;IACd,SAAS,EAAE,OAAO,CAAC;IAEnB,kBAAkB;IAClB,WAAW,EAAE,OAAO,CAAC;IAErB,mBAAmB;IACnB,YAAY,EAAE,OAAO,CAAC;IAEtB,mBAAmB;IACnB,aAAa,EAAE,OAAO,CAAC;IAEvB,SAAS;IACT,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,aAAa;IACb,KAAK,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F,cAAc;IACd,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,cAAc;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,eAAe;IACf,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,kBAAkB;IAClB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC,YAAY;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,eAAe;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAEzC,mBAAmB;IACnB,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqJG;AACH,wBAAgB,OAAO,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACvD,OAAO,GAAE,cAAc,CAAC,KAAK,CAAM,GAClC,aAAa,CAAC,KAAK,CAAC,CA2QtB"}

package/dist/hooks/auth/useAuth.js

@@ -0,0 +1,384 @@
+import { useState, useEffect, useCallback, useRef } from 'react';
+/**
+ * 인증 관리 Hook
+ *
+ * 로그인, 로그아웃, 회원가입, 토큰 관리 등 인증 관련 기능을 제공합니다.
+ *
+ * @example
+ * ```tsx
+ * // 기본 사용 (로그인 유지 옵션 포함)
+ * function LoginPage() {
+ *   const [rememberMe, setRememberMe] = useState(false);
+ *   const { login, isLoggingIn, error, isAuthenticated } = useAuth({
+ *     loginFn: (credentials) => api.login(credentials),
+ *     onLoginSuccess: (user) => {
+ *       console.log('로그인 성공:', user);
+ *       navigate('/dashboard');
+ *     },
+ *   });
+ *
+ *   const handleSubmit = async (e) => {
+ *     e.preventDefault();
+ *     // rememberMe가 true면 localStorage, false면 sessionStorage 사용
+ *     await login({ email, password }, { rememberMe });
+ *   };
+ *
+ *   if (isAuthenticated) {
+ *     return <Navigate to="/dashboard" />;
+ *   }
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input type="email" value={email} onChange={(e) => setEmail(e.target.value)} />
+ *       <input type="password" value={password} onChange={(e) => setPassword(e.target.value)} />
+ *       <label>
+ *         <input type="checkbox" checked={rememberMe} onChange={(e) => setRememberMe(e.target.checked)} />
+ *         로그인 유지
+ *       </label>
+ *       <button type="submit" disabled={isLoggingIn}>
+ *         {isLoggingIn ? '로그인 중...' : '로그인'}
+ *       </button>
+ *       {error && <div>{error.message}</div>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 자동 토큰 갱신과 함께 사용
+ * function App() {
+ *   const { user, isAuthenticated, isLoading, logout } = useAuth({
+ *     getUserFn: () => api.getMe(),
+ *     logoutFn: () => api.logout(),
+ *     refreshTokenFn: () => api.refreshToken(),
+ *     autoRefresh: true,
+ *     refreshInterval: 300000, // 5분마다 갱신
+ *     onLogoutSuccess: () => navigate('/login'),
+ *   });
+ *
+ *   if (isLoading) return <div>로딩중...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {isAuthenticated ? (
+ *         <>
+ *           <div>환영합니다, {user?.name}님</div>
+ *           <button onClick={logout}>로그아웃</button>
+ *         </>
+ *       ) : (
+ *         <LoginPage />
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 회원가입 포함
+ * function RegisterPage() {
+ *   const { register, isRegistering, error } = useAuth({
+ *     registerFn: (data) => api.register(data),
+ *     onRegisterSuccess: (user) => {
+ *       toast.success('회원가입 성공!');
+ *       navigate('/');
+ *     },
+ *   });
+ *
+ *   const handleSubmit = async (data) => {
+ *     await register(data);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input name="email" />
+ *       <input name="password" type="password" />
+ *       <input name="name" />
+ *       <button type="submit" disabled={isRegistering}>
+ *         회원가입
+ *       </button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Storage에 저장되는 값 확인하기
+ * function DebugAuth() {
+ *   const { login, user, token } = useAuth({
+ *     loginFn: api.login,
+ *     storageKey: 'my_app_token',      // 커스텀 키 사용 가능
+ *     userStorageKey: 'my_app_user',
+ *   });
+ *
+ *   const handleLogin = async () => {
+ *     await login({ email, password }, { rememberMe: true });
+ *
+ *     // 로그인 후 storage 확인
+ *     console.log('Token:', localStorage.getItem('my_app_token'));
+ *     // 출력: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+ *
+ *     console.log('User:', localStorage.getItem('my_app_user'));
+ *     // 출력: {"id":"123","name":"John Doe","email":"john@example.com"}
+ *   };
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // rememberMe에 따른 storage 동작
+ * function LoginWithRememberMe() {
+ *   const [rememberMe, setRememberMe] = useState(false);
+ *   const { login } = useAuth({ loginFn: api.login });
+ *
+ *   const handleLogin = async () => {
+ *     await login({ email, password }, { rememberMe });
+ *
+ *     if (rememberMe) {
+ *       // localStorage에 저장 (브라우저 종료해도 유지)
+ *       console.log(localStorage.getItem('auth_token'));    // "eyJ..."
+ *       console.log(sessionStorage.getItem('auth_token'));  // null
+ *     } else {
+ *       // sessionStorage에 저장 (브라우저 종료 시 삭제)
+ *       console.log(localStorage.getItem('auth_token'));    // null
+ *       console.log(sessionStorage.getItem('auth_token'));  // "eyJ..."
+ *     }
+ *   };
+ * }
+ * ```
+ */
+export function useAuth(options = {}) {
+    const { loginFn, logoutFn, registerFn, getUserFn, refreshTokenFn, onLoginSuccess, onLogoutSuccess, onRegisterSuccess, onError, storageKey = 'auth_token', userStorageKey = 'auth_user', useSessionStorage = false, autoRefresh = false, refreshInterval = 300000, // 5분
+    autoLoadUser = true, } = options;
+    const [user, setUser] = useState(null);
+    const [token, setTokenState] = useState(() => {
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined')
+            return null;
+        // 초기 로드 시 localStorage와 sessionStorage 모두 확인
+        return localStorage.getItem(storageKey) || sessionStorage.getItem(storageKey);
+    });
+    const [isLoading, setIsLoading] = useState(autoLoadUser);
+    const [isLoggingIn, setIsLoggingIn] = useState(false);
+    const [isLoggingOut, setIsLoggingOut] = useState(false);
+    const [isRegistering, setIsRegistering] = useState(false);
+    const [error, setError] = useState(null);
+    const refreshIntervalRef = useRef(null);
+    // 토큰 설정 함수 (storage 타입 동적 선택 가능)
+    const setToken = useCallback((newToken, rememberMe = !useSessionStorage) => {
+        setTokenState(newToken);
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined')
+            return;
+        const storage = rememberMe ? localStorage : sessionStorage;
+        const otherStorage = rememberMe ? sessionStorage : localStorage;
+        if (newToken) {
+            storage.setItem(storageKey, newToken);
+            // 다른 storage에서는 제거 (중복 방지)
+            otherStorage.removeItem(storageKey);
+        }
+        else {
+            // 로그아웃 시 양쪽 모두 제거
+            localStorage.removeItem(storageKey);
+            sessionStorage.removeItem(storageKey);
+        }
+    }, [storageKey, useSessionStorage]);
+    // 사용자 정보 저장 (rememberMe 옵션 추가)
+    const saveUser = useCallback((userData, rememberMe = !useSessionStorage) => {
+        setUser(userData);
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined')
+            return;
+        const storage = rememberMe ? localStorage : sessionStorage;
+        const otherStorage = rememberMe ? sessionStorage : localStorage;
+        if (userData) {
+            storage.setItem(userStorageKey, JSON.stringify(userData));
+            // 다른 storage에서는 제거
+            otherStorage.removeItem(userStorageKey);
+        }
+        else {
+            // 로그아웃 시 양쪽 모두 제거
+            localStorage.removeItem(userStorageKey);
+            sessionStorage.removeItem(userStorageKey);
+        }
+    }, [userStorageKey, useSessionStorage]);
+    // 사용자 정보 로드
+    const loadUser = useCallback(async () => {
+        if (!getUserFn || !token) {
+            setIsLoading(false);
+            return;
+        }
+        try {
+            const userData = await getUserFn();
+            saveUser(userData);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to load user');
+            setError(error);
+            setToken(null);
+            saveUser(null);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [getUserFn, token, saveUser, setToken]);
+    // 초기 로드
+    useEffect(() => {
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined') {
+            setIsLoading(false);
+            return;
+        }
+        if (autoLoadUser && token) {
+            // localStorage와 sessionStorage 모두 확인
+            const savedUser = localStorage.getItem(userStorageKey) || sessionStorage.getItem(userStorageKey);
+            if (savedUser) {
+                try {
+                    setUser(JSON.parse(savedUser));
+                    setIsLoading(false);
+                }
+                catch {
+                    // JSON 파싱 실패 시 API에서 다시 가져오기
+                    loadUser();
+                }
+            }
+            else {
+                loadUser();
+            }
+        }
+        else {
+            setIsLoading(false);
+        }
+    }, []);
+    // 로그인
+    const login = useCallback(async (credentials, loginOptions) => {
+        if (!loginFn) {
+            throw new Error('loginFn is required for login');
+        }
+        const rememberMe = loginOptions?.rememberMe ?? !useSessionStorage;
+        setIsLoggingIn(true);
+        setError(null);
+        try {
+            const result = await loginFn(credentials);
+            if (result.token) {
+                setToken(result.token, rememberMe);
+            }
+            saveUser(result.user, rememberMe);
+            onLoginSuccess?.(result.user);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Login failed');
+            setError(error);
+            onError?.(error, 'login');
+            throw error;
+        }
+        finally {
+            setIsLoggingIn(false);
+        }
+    }, [loginFn, setToken, saveUser, onLoginSuccess, onError, useSessionStorage]);
+    // 로그아웃
+    const logout = useCallback(async () => {
+        setIsLoggingOut(true);
+        setError(null);
+        try {
+            if (logoutFn) {
+                await logoutFn();
+            }
+            setToken(null);
+            saveUser(null);
+            onLogoutSuccess?.();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Logout failed');
+            setError(error);
+            onError?.(error, 'logout');
+            throw error;
+        }
+        finally {
+            setIsLoggingOut(false);
+        }
+    }, [logoutFn, setToken, saveUser, onLogoutSuccess, onError]);
+    // 회원가입
+    const register = useCallback(async (data, registerOptions) => {
+        if (!registerFn) {
+            throw new Error('registerFn is required for register');
+        }
+        const rememberMe = registerOptions?.rememberMe ?? !useSessionStorage;
+        setIsRegistering(true);
+        setError(null);
+        try {
+            const result = await registerFn(data);
+            if (result.token) {
+                setToken(result.token, rememberMe);
+            }
+            saveUser(result.user, rememberMe);
+            onRegisterSuccess?.(result.user);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Registration failed');
+            setError(error);
+            onError?.(error, 'register');
+            throw error;
+        }
+        finally {
+            setIsRegistering(false);
+        }
+    }, [registerFn, setToken, saveUser, onRegisterSuccess, onError, useSessionStorage]);
+    // 토큰 갱신
+    const refreshToken = useCallback(async () => {
+        if (!refreshTokenFn) {
+            return;
+        }
+        try {
+            const result = await refreshTokenFn();
+            setToken(result.token);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Token refresh failed');
+            setError(error);
+            onError?.(error, 'refresh');
+            // 토큰 갱신 실패 시 로그아웃
+            await logout();
+        }
+    }, [refreshTokenFn, setToken, onError, logout]);
+    // 자동 토큰 갱신
+    useEffect(() => {
+        if (autoRefresh && token && refreshTokenFn) {
+            refreshIntervalRef.current = setInterval(() => {
+                refreshToken();
+            }, refreshInterval);
+            return () => {
+                if (refreshIntervalRef.current) {
+                    clearInterval(refreshIntervalRef.current);
+                }
+            };
+        }
+    }, [autoRefresh, token, refreshTokenFn, refreshToken, refreshInterval]);
+    // 사용자 정보 새로고침
+    const refetchUser = useCallback(async () => {
+        if (!getUserFn) {
+            throw new Error('getUserFn is required for refetchUser');
+        }
+        setIsLoading(true);
+        await loadUser();
+    }, [getUserFn, loadUser]);
+    return {
+        user,
+        isAuthenticated: !!user,
+        isLoading,
+        isLoggingIn,
+        isLoggingOut,
+        isRegistering,
+        error,
+        login,
+        logout,
+        register,
+        refreshToken,
+        refetchUser,
+        token,
+        setToken,
+        setUser: saveUser,
+    };
+}