@insforge/react 0.6.4 → 0.6.6

package/dist/hooks.cjs

@@ -11,9 +11,10 @@ function useInsforge() {
   const context = react.useContext(react$1.InsforgeContext);
   if (!context) {
     return {
-      user: null,
+      user: void 0,
+      userId: void 0,
       isLoaded: false,
-      isSignedIn: false,
+      isSignedIn: void 0,
       setUser: () => {
       },
       signIn: () => Promise.resolve({ error: "SSR mode" }),

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/navigation/NavigationContext.tsx","../src/provider/InsforgeProvider.tsx","../src/hooks/useAuth.ts","../src/hooks/useUser.ts","../src/hooks/usePublicAuthConfig.ts"],"names":["createContext","useContext","InsforgeContext","useState","useEffect"],"mappings":"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","file":"hooks.cjs","sourcesContent":["import { createContext, useContext, ReactNode } from 'react';\nimport type { NavigationAdapter } from './types';\n\nconst NavigationContext = createContext<NavigationAdapter | null>(null);\n\nexport interface NavigationProviderProps {\n  adapter: NavigationAdapter;\n  children: ReactNode;\n}\n\n/**\n * Navigation Provider\n * Injects navigation adapter into the component tree\n */\nexport function NavigationProvider({ adapter, children }: NavigationProviderProps) {\n  return <NavigationContext.Provider value={adapter}>{children}</NavigationContext.Provider>;\n}\n\n/**\n * Hook to access navigation adapter\n * @throws Error if used outside NavigationProvider\n */\nexport function useNavigationAdapter(): NavigationAdapter {\n  const adapter = useContext(NavigationContext);\n\n  if (!adapter) {\n    return {\n      useSearchParams: () => new URLSearchParams(),\n      Link: ({ href, children }) => <a href={href}>{children}</a>,\n    };\n  }\n\n  return adapter;\n}\n","import { useContext, useEffect, useState, useMemo, type ReactNode } from 'react';\nimport type { InsforgeUser, OAuthProvider } from '../types';\nimport { NavigationProvider, BrowserNavigationAdapter } from '../navigation';\nimport { InsforgeManager, type InsforgeManagerState } from '../core/InsforgeManager';\nimport { InsforgeContext, type InsforgeContextValue } from '../contexts';\n\nexport interface InsforgeProviderProps {\n  children: ReactNode;\n  baseUrl: string;\n  /**\n   * URL to redirect to after successful sign in (when token is detected in URL)\n   * @default '/'\n   */\n  afterSignInUrl?: string;\n  onAuthChange?: (user: InsforgeUser | null) => void;\n  onSignIn?: (authToken: string) => Promise<void>;\n  onSignOut?: () => Promise<void>;\n}\n\n/**\n * Unified Insforge Provider - manages authentication state and configuration\n *\n * Uses singleton InsforgeManager to manage state across packages.\n * Context only subscribes to Manager and triggers React re-renders.\n *\n * @example\n * ```tsx\n * // Basic usage (React/Vite)\n * import { InsforgeProvider } from '@insforge/react';\n *\n * export default function App() {\n *   return (\n *     <InsforgeProvider\n *       baseUrl={import.meta.env.VITE_INSFORGE_BASE_URL}\n *     >\n *       {children}\n *     </InsforgeProvider>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With cookie sync (Next.js optimization)\n * <InsforgeProvider\n *   baseUrl={baseUrl}\n *   onSignIn={async (authToken) => {\n *     await signIn(authToken);\n *   }}\n *   onSignOut={async () => {\n *     await signOut();\n *   }}\n * >\n *   {children}\n * </InsforgeProvider>\n * ```\n */\nexport function InsforgeProviderCore({\n  children,\n  baseUrl,\n  afterSignInUrl = '/',\n  onAuthChange,\n  onSignIn,\n  onSignOut,\n}: InsforgeProviderProps) {\n  // Get singleton Manager instance\n  const manager = useMemo(\n    () =>\n      InsforgeManager.getInstance({\n        baseUrl,\n        afterSignInUrl,\n        onAuthChange,\n        onSignIn,\n        onSignOut,\n      }),\n    [baseUrl, afterSignInUrl, onAuthChange, onSignIn, onSignOut]\n  );\n\n  // Subscribe to Manager state\n  const [state, setState] = useState<InsforgeManagerState>(() => manager.getState());\n\n  useEffect(() => {\n    const unsubscribe = manager.subscribe((newState) => {\n      setState(newState);\n    });\n\n    // Initialize auth state (only runs once due to isLoaded check in Manager)\n    void manager.initialize();\n\n    return () => {\n      unsubscribe();\n    };\n  }, [manager]);\n\n  // Handle auth redirect after successful authentication\n  useEffect(() => {\n    if (typeof window !== 'undefined') {\n      manager.handleAuthRedirect(state.isLoaded, state.user);\n    }\n  }, [manager, state.isLoaded, state.user]);\n\n  // Create stable method references that delegate to manager\n  const contextValue = useMemo<InsforgeContextValue>(\n    () => ({\n      // State from Manager\n      user: state.user,\n      isLoaded: state.isLoaded,\n      isSignedIn: state.isSignedIn,\n\n      // Methods delegated to Manager\n      setUser: (user: InsforgeUser | null) => manager.setUser(user),\n      signIn: (email: string, password: string) => manager.signIn(email, password),\n      signUp: (email: string, password: string) => manager.signUp(email, password),\n      signOut: () => manager.signOut(),\n      updateUser: (data: Partial<InsforgeUser>) => manager.updateUser(data),\n      reloadAuth: () => manager.reloadAuth(),\n      sendVerificationEmail: (email: string) => manager.sendVerificationEmail(email),\n      sendResetPasswordEmail: (email: string) => manager.sendResetPasswordEmail(email),\n      resetPassword: (token: string, newPassword: string) =>\n        manager.resetPassword(token, newPassword),\n      verifyEmail: (otp: string, email?: string) => manager.verifyEmail(otp, email),\n      exchangeResetPasswordToken: (email: string, code: string) =>\n        manager.exchangeResetPasswordToken(email, code),\n      loginWithOAuth: (provider: OAuthProvider, redirectTo: string) =>\n        manager.loginWithOAuth(provider, redirectTo),\n      getPublicAuthConfig: () => manager.getPublicAuthConfig(),\n\n      // Config\n      baseUrl: manager.getConfig().baseUrl,\n      afterSignInUrl: manager.getConfig().afterSignInUrl || '/',\n    }),\n    [state, manager]\n  );\n\n  return <InsforgeContext.Provider value={contextValue}>{children}</InsforgeContext.Provider>;\n}\n\nexport function InsforgeProvider(props: InsforgeProviderProps) {\n  return (\n    <NavigationProvider adapter={BrowserNavigationAdapter}>\n      <InsforgeProviderCore {...props} />\n    </NavigationProvider>\n  );\n}\n\n/**\n * Hook to access Insforge context\n *\n * Works seamlessly across packages thanks to singleton Manager.\n * Context instance is guaranteed to be consistent.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { user, isSignedIn, signOut } = useInsforge();\n *\n *   if (!isSignedIn) return <SignIn />;\n *\n *   return (\n *     <div>\n *       <p>Welcome {user.email}</p>\n *       <button onClick={signOut}>Sign Out</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useInsforge(): InsforgeContextValue {\n  const context = useContext(InsforgeContext);\n\n  if (!context) {\n    return {\n      user: null,\n      isLoaded: false,\n      isSignedIn: false,\n      setUser: () => {},\n      signIn: () => Promise.resolve({ error: 'SSR mode' }),\n      signUp: () => Promise.resolve({ error: 'SSR mode' }),\n      signOut: () => Promise.resolve(),\n      updateUser: () => Promise.resolve({ error: 'SSR mode' }),\n      reloadAuth: () => Promise.resolve({ success: false, error: 'SSR mode' }),\n      sendVerificationEmail: () => Promise.resolve(null),\n      sendResetPasswordEmail: () => Promise.resolve(null),\n      resetPassword: () => Promise.resolve(null),\n      verifyEmail: () => Promise.resolve(null),\n      exchangeResetPasswordToken: () => Promise.resolve({ error: { message: 'SSR mode' } }),\n      loginWithOAuth: () => Promise.resolve(),\n      getPublicAuthConfig: () => Promise.resolve(null),\n      baseUrl: '',\n      afterSignInUrl: '/',\n    };\n  }\n\n  return context;\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access authentication methods\n *\n * @returns Object containing:\n *   - `signIn`: Function to sign in with email and password\n *   - `signUp`: Function to sign up with email and password\n *   - `signOut`: Function to sign out the current user\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `isSignedIn`: Boolean indicating if user is currently signed in\n *\n * @example\n * ```tsx\n * function LoginForm() {\n *   const { signIn, signUp, signOut, isLoaded, isSignedIn } = useAuth();\n *\n *   async function handleLogin(email: string, password: string) {\n *     try {\n *       await signIn(email, password);\n *       // User is now signed in\n *     } catch (error) {\n *       console.error('Sign in failed:', error);\n *     }\n *   }\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); handleLogin(email, password); }}>\n *       {/* form fields *\\/}\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useAuth() {\n  const { signIn, signUp, signOut, isLoaded, isSignedIn } = useInsforge();\n  return { signIn, signUp, signOut, isLoaded, isSignedIn };\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access current user data\n *\n * @returns Object containing:\n *   - `user`: Current user object (InsforgeUser | null)\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `updateUser`: Function to update user profile data (returns { error: string } | null)\n *   - `setUser`: Internal function to manually set user state\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const { user, isLoaded, updateUser } = useUser();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *   if (!user) return <div>Not signed in</div>;\n *\n *   async function handleUpdate(name: string) {\n *     const result = await updateUser({ name });\n *     if (result?.error) {\n *       console.error(result.error);\n *     } else {\n *       console.log('User updated successfully');\n *     }\n *   }\n *\n *   return (\n *     <div>\n *       <p>Email: {user.email}</p>\n *       {user.name && <p>Name: {user.name}</p>}\n *       {user.avatarUrl && <img src={user.avatarUrl} alt=\"Avatar\" />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useUser() {\n  const { user, isLoaded, updateUser, setUser } = useInsforge();\n  return { user, isLoaded, updateUser, setUser };\n}\n","import { useState, useEffect } from 'react';\nimport type { GetPublicAuthConfigResponse } from '@insforge/shared-schemas';\nimport { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to get all public authentication configuration (OAuth + Email) from Insforge backend\n *\n * **IMPORTANT: This hook should ONLY be used in SignIn and SignUp components.**\n *\n * This hook lazily fetches all public authentication configuration from the backend\n * only when the component mounts. Using it in other components will cause unnecessary\n * API calls on every page load.\n *\n * @returns Object containing OAuth providers, email auth config, and loading state\n * - `authConfig`: Email authentication configuration object with password rules\n * - `isLoaded`: Boolean indicating if the config has been fetched\n *\n * @example\n * ```tsx\n * // ✅ Correct usage - only in SignIn/SignUp components\n * function SignUp() {\n *   const { authConfig, isLoaded } = usePublicAuthConfig();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <div>\n *       <p>OAuth providers: {authConfig?.oauthProviders.length}</p>\n *       <p>Password min length: {authConfig?.passwordMinLength}</p>\n *     </div>\n *   );\n * }\n * ```\n *\n * @requires Must be used within InsforgeProvider\n */\nexport function usePublicAuthConfig(): {\n  authConfig: GetPublicAuthConfigResponse | null;\n  isLoaded: boolean;\n} {\n  const { getPublicAuthConfig } = useInsforge();\n  const [authConfig, setAuthConfig] = useState<GetPublicAuthConfigResponse | null>(null);\n  const [isLoaded, setIsLoaded] = useState(false);\n\n  useEffect(() => {\n    async function fetchConfig() {\n      const result = await getPublicAuthConfig();\n      if (result) {\n        setAuthConfig(result);\n      } else {\n        console.error('[usePublicAuthConfig] Failed to get public auth config');\n        setAuthConfig(null);\n      }\n      setIsLoaded(true);\n    }\n\n    void fetchConfig();\n  }, [getPublicAuthConfig]);\n\n  return { authConfig, isLoaded };\n}\n"]}
+{"version":3,"sources":["../src/navigation/NavigationContext.tsx","../src/provider/InsforgeProvider.tsx","../src/hooks/useAuth.ts","../src/hooks/useUser.ts","../src/hooks/usePublicAuthConfig.ts"],"names":["createContext","useContext","InsforgeContext","useState","useEffect"],"mappings":"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","file":"hooks.cjs","sourcesContent":["import { createContext, useContext, ReactNode } from 'react';\nimport type { NavigationAdapter } from './types';\n\nconst NavigationContext = createContext<NavigationAdapter | null>(null);\n\nexport interface NavigationProviderProps {\n  adapter: NavigationAdapter;\n  children: ReactNode;\n}\n\n/**\n * Navigation Provider\n * Injects navigation adapter into the component tree\n */\nexport function NavigationProvider({ adapter, children }: NavigationProviderProps) {\n  return <NavigationContext.Provider value={adapter}>{children}</NavigationContext.Provider>;\n}\n\n/**\n * Hook to access navigation adapter\n * @throws Error if used outside NavigationProvider\n */\nexport function useNavigationAdapter(): NavigationAdapter {\n  const adapter = useContext(NavigationContext);\n\n  if (!adapter) {\n    return {\n      useSearchParams: () => new URLSearchParams(),\n      Link: ({ href, children }) => <a href={href}>{children}</a>,\n    };\n  }\n\n  return adapter;\n}\n","import { useContext, useEffect, useState, useMemo, type ReactNode } from 'react';\nimport type { InsforgeUser, OAuthProvider } from '../types';\nimport { NavigationProvider, BrowserNavigationAdapter } from '../navigation';\nimport { InsforgeManager, type InsforgeManagerState } from '../core/InsforgeManager';\nimport { InsforgeContext, type InsforgeContextValue } from '../contexts';\n\nexport interface InitialAuthState {\n  user?: InsforgeUser | null;\n  userId?: string | null;\n}\n\nexport interface InsforgeProviderProps {\n  children: ReactNode;\n  baseUrl: string;\n  /**\n   * URL to redirect to after successful sign in (when token is detected in URL)\n   * @default '/'\n   */\n  afterSignInUrl?: string;\n  onAuthChange?: (user: InsforgeUser | null) => void;\n  onSignIn?: (authToken: string) => Promise<void>;\n  onSignOut?: () => Promise<void>;\n  /**\n   * Initial auth state from server (for SSR hydration)\n   * @internal - Not intended for public use, used by Next.js package\n   */\n  initialState?: InitialAuthState;\n}\n\n/**\n * Unified Insforge Provider - manages authentication state and configuration\n *\n * Uses singleton InsforgeManager to manage state across packages.\n * Context only subscribes to Manager and triggers React re-renders.\n *\n * @example\n * ```tsx\n * // Basic usage (React/Vite)\n * import { InsforgeProvider } from '@insforge/react';\n *\n * export default function App() {\n *   return (\n *     <InsforgeProvider\n *       baseUrl={import.meta.env.VITE_INSFORGE_BASE_URL}\n *     >\n *       {children}\n *     </InsforgeProvider>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With cookie sync (Next.js optimization)\n * <InsforgeProvider\n *   baseUrl={baseUrl}\n *   onSignIn={async (authToken) => {\n *     await signIn(authToken);\n *   }}\n *   onSignOut={async () => {\n *     await signOut();\n *   }}\n * >\n *   {children}\n * </InsforgeProvider>\n * ```\n */\nexport function InsforgeProviderCore({\n  children,\n  baseUrl,\n  afterSignInUrl = '/',\n  onAuthChange,\n  onSignIn,\n  onSignOut,\n  initialState,\n}: InsforgeProviderProps) {\n  // Get singleton Manager instance\n  const manager = useMemo(\n    () =>\n      InsforgeManager.getInstance({\n        baseUrl,\n        afterSignInUrl,\n        onAuthChange,\n        onSignIn,\n        onSignOut,\n      }),\n    [baseUrl, afterSignInUrl, onAuthChange, onSignIn, onSignOut]\n  );\n\n  // Set initialState if provided (from Server Component)\n  // This must happen during render, before useState initialization\n  if (initialState) {\n    const currentState = manager.getState();\n    if (currentState.userId === undefined && initialState.userId !== undefined) {\n      manager.setInitialState(initialState);\n    }\n  }\n\n  // Subscribe to Manager state\n  // Start with initial state from manager (will include initialState if set above)\n  const [state, setState] = useState<InsforgeManagerState>(() => manager.getState());\n\n  useEffect(() => {\n    // Subscribe to state changes\n    const unsubscribe = manager.subscribe((newState) => {\n      setState(newState);\n    });\n\n    // Initialize auth state only on client side (after hydration)\n    // This prevents hydration mismatches by ensuring SSR and client initial render match\n    void manager.initialize();\n\n    return () => {\n      unsubscribe();\n    };\n  }, [manager]);\n\n  // Handle auth redirect after successful authentication\n  useEffect(() => {\n    if (typeof window !== 'undefined') {\n      manager.handleAuthRedirect(state.isLoaded, state.user);\n    }\n  }, [manager, state.isLoaded, state.user]);\n\n  // Create stable method references that delegate to manager\n  const contextValue = useMemo<InsforgeContextValue>(\n    () => ({\n      // State from Manager\n      user: state.user,\n      userId: state.userId,\n      isLoaded: state.isLoaded,\n      isSignedIn: state.isSignedIn,\n\n      // Methods delegated to Manager\n      setUser: (user: InsforgeUser | null) => manager.setUser(user),\n      signIn: (email: string, password: string) => manager.signIn(email, password),\n      signUp: (email: string, password: string) => manager.signUp(email, password),\n      signOut: () => manager.signOut(),\n      updateUser: (data: Partial<InsforgeUser>) => manager.updateUser(data),\n      reloadAuth: () => manager.reloadAuth(),\n      sendVerificationEmail: (email: string) => manager.sendVerificationEmail(email),\n      sendResetPasswordEmail: (email: string) => manager.sendResetPasswordEmail(email),\n      resetPassword: (token: string, newPassword: string) =>\n        manager.resetPassword(token, newPassword),\n      verifyEmail: (otp: string, email?: string) => manager.verifyEmail(otp, email),\n      exchangeResetPasswordToken: (email: string, code: string) =>\n        manager.exchangeResetPasswordToken(email, code),\n      loginWithOAuth: (provider: OAuthProvider, redirectTo: string) =>\n        manager.loginWithOAuth(provider, redirectTo),\n      getPublicAuthConfig: () => manager.getPublicAuthConfig(),\n\n      // Config\n      baseUrl: manager.getConfig().baseUrl,\n      afterSignInUrl: manager.getConfig().afterSignInUrl || '/',\n    }),\n    [state, manager]\n  );\n\n  return <InsforgeContext.Provider value={contextValue}>{children}</InsforgeContext.Provider>;\n}\n\nexport function InsforgeProvider(props: InsforgeProviderProps) {\n  return (\n    <NavigationProvider adapter={BrowserNavigationAdapter}>\n      <InsforgeProviderCore {...props} />\n    </NavigationProvider>\n  );\n}\n\n/**\n * Hook to access Insforge context\n *\n * Works seamlessly across packages thanks to singleton Manager.\n * Context instance is guaranteed to be consistent.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { user, isSignedIn, signOut } = useInsforge();\n *\n *   if (!isSignedIn) return <SignIn />;\n *\n *   return (\n *     <div>\n *       <p>Welcome {user.email}</p>\n *       <button onClick={signOut}>Sign Out</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useInsforge(): InsforgeContextValue {\n  const context = useContext(InsforgeContext);\n\n  if (!context) {\n    return {\n      user: undefined,\n      userId: undefined,\n      isLoaded: false,\n      isSignedIn: undefined,\n      setUser: () => {},\n      signIn: () => Promise.resolve({ error: 'SSR mode' }),\n      signUp: () => Promise.resolve({ error: 'SSR mode' }),\n      signOut: () => Promise.resolve(),\n      updateUser: () => Promise.resolve({ error: 'SSR mode' }),\n      reloadAuth: () => Promise.resolve({ success: false, error: 'SSR mode' }),\n      sendVerificationEmail: () => Promise.resolve(null),\n      sendResetPasswordEmail: () => Promise.resolve(null),\n      resetPassword: () => Promise.resolve(null),\n      verifyEmail: () => Promise.resolve(null),\n      exchangeResetPasswordToken: () => Promise.resolve({ error: { message: 'SSR mode' } }),\n      loginWithOAuth: () => Promise.resolve(),\n      getPublicAuthConfig: () => Promise.resolve(null),\n      baseUrl: '',\n      afterSignInUrl: '/',\n    };\n  }\n\n  return context;\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access authentication methods\n *\n * @returns Object containing:\n *   - `signIn`: Function to sign in with email and password\n *   - `signUp`: Function to sign up with email and password\n *   - `signOut`: Function to sign out the current user\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `isSignedIn`: Boolean indicating if user is currently signed in\n *\n * @example\n * ```tsx\n * function LoginForm() {\n *   const { signIn, signUp, signOut, isLoaded, isSignedIn } = useAuth();\n *\n *   async function handleLogin(email: string, password: string) {\n *     try {\n *       await signIn(email, password);\n *       // User is now signed in\n *     } catch (error) {\n *       console.error('Sign in failed:', error);\n *     }\n *   }\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); handleLogin(email, password); }}>\n *       {/* form fields *\\/}\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useAuth() {\n  const { signIn, signUp, signOut, isLoaded, isSignedIn } = useInsforge();\n  return { signIn, signUp, signOut, isLoaded, isSignedIn };\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access current user data\n *\n * @returns Object containing:\n *   - `user`: Current user object (InsforgeUser | null)\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `updateUser`: Function to update user profile data (returns { error: string } | null)\n *   - `setUser`: Internal function to manually set user state\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const { user, isLoaded, updateUser } = useUser();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *   if (!user) return <div>Not signed in</div>;\n *\n *   async function handleUpdate(name: string) {\n *     const result = await updateUser({ name });\n *     if (result?.error) {\n *       console.error(result.error);\n *     } else {\n *       console.log('User updated successfully');\n *     }\n *   }\n *\n *   return (\n *     <div>\n *       <p>Email: {user.email}</p>\n *       {user.name && <p>Name: {user.name}</p>}\n *       {user.avatarUrl && <img src={user.avatarUrl} alt=\"Avatar\" />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useUser() {\n  const { user, isLoaded, updateUser, setUser } = useInsforge();\n  return { user, isLoaded, updateUser, setUser };\n}\n","import { useState, useEffect } from 'react';\nimport type { GetPublicAuthConfigResponse } from '@insforge/shared-schemas';\nimport { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to get all public authentication configuration (OAuth + Email) from Insforge backend\n *\n * **IMPORTANT: This hook should ONLY be used in SignIn and SignUp components.**\n *\n * This hook lazily fetches all public authentication configuration from the backend\n * only when the component mounts. Using it in other components will cause unnecessary\n * API calls on every page load.\n *\n * @returns Object containing OAuth providers, email auth config, and loading state\n * - `authConfig`: Email authentication configuration object with password rules\n * - `isLoaded`: Boolean indicating if the config has been fetched\n *\n * @example\n * ```tsx\n * // ✅ Correct usage - only in SignIn/SignUp components\n * function SignUp() {\n *   const { authConfig, isLoaded } = usePublicAuthConfig();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <div>\n *       <p>OAuth providers: {authConfig?.oauthProviders.length}</p>\n *       <p>Password min length: {authConfig?.passwordMinLength}</p>\n *     </div>\n *   );\n * }\n * ```\n *\n * @requires Must be used within InsforgeProvider\n */\nexport function usePublicAuthConfig(): {\n  authConfig: GetPublicAuthConfigResponse | null;\n  isLoaded: boolean;\n} {\n  const { getPublicAuthConfig } = useInsforge();\n  const [authConfig, setAuthConfig] = useState<GetPublicAuthConfigResponse | null>(null);\n  const [isLoaded, setIsLoaded] = useState(false);\n\n  useEffect(() => {\n    async function fetchConfig() {\n      const result = await getPublicAuthConfig();\n      if (result) {\n        setAuthConfig(result);\n      } else {\n        console.error('[usePublicAuthConfig] Failed to get public auth config');\n        setAuthConfig(null);\n      }\n      setIsLoaded(true);\n    }\n\n    void fetchConfig();\n  }, [getPublicAuthConfig]);\n\n  return { authConfig, isLoaded };\n}\n"]}

package/dist/hooks.d.cts

@@ -49,7 +49,7 @@ declare function useAuth(): {
     }>;
     signOut: () => Promise<void>;
     isLoaded: boolean;
-    isSignedIn: boolean;
+    isSignedIn: boolean | undefined;
 };
 
 /**
@@ -89,7 +89,7 @@ declare function useAuth(): {
  * ```
  */
 declare function useUser(): {
-    user: _insforge_shared.InsforgeUser | null;
+    user: _insforge_shared.InsforgeUser | null | undefined;
     isLoaded: boolean;
     updateUser: (data: Partial<_insforge_shared.InsforgeUser>) => Promise<{
         error: string;

package/dist/hooks.d.ts

@@ -49,7 +49,7 @@ declare function useAuth(): {
     }>;
     signOut: () => Promise<void>;
     isLoaded: boolean;
-    isSignedIn: boolean;
+    isSignedIn: boolean | undefined;
 };
 
 /**
@@ -89,7 +89,7 @@ declare function useAuth(): {
  * ```
  */
 declare function useUser(): {
-    user: _insforge_shared.InsforgeUser | null;
+    user: _insforge_shared.InsforgeUser | null | undefined;
     isLoaded: boolean;
     updateUser: (data: Partial<_insforge_shared.InsforgeUser>) => Promise<{
         error: string;

package/dist/hooks.js

@@ -9,9 +9,10 @@ function useInsforge() {
   const context = useContext(InsforgeContext);
   if (!context) {
     return {
-      user: null,
+      user: void 0,
+      userId: void 0,
       isLoaded: false,
-      isSignedIn: false,
+      isSignedIn: void 0,
       setUser: () => {
       },
       signIn: () => Promise.resolve({ error: "SSR mode" }),

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/navigation/NavigationContext.tsx","../src/provider/InsforgeProvider.tsx","../src/hooks/useAuth.ts","../src/hooks/useUser.ts","../src/hooks/usePublicAuthConfig.ts"],"names":["useContext","useState","useEffect"],"mappings":";;;;;;AAG0B,cAAwC,IAAI;ACoK/D,SAAS,WAAA,GAAoC;AAClD,EAAA,MAAM,OAAA,GAAUA,WAAW,eAAe,CAAA;AAE1C,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,IAAA;AAAA,MACN,QAAA,EAAU,KAAA;AAAA,MACV,UAAA,EAAY,KAAA;AAAA,MACZ,SAAS,MAAM;AAAA,MAAC,CAAA;AAAA,MAChB,QAAQ,MAAM,OAAA,CAAQ,QAAQ,EAAE,KAAA,EAAO,YAAY,CAAA;AAAA,MACnD,QAAQ,MAAM,OAAA,CAAQ,QAAQ,EAAE,KAAA,EAAO,YAAY,CAAA;AAAA,MACnD,OAAA,EAAS,MAAM,OAAA,CAAQ,OAAA,EAAQ;AAAA,MAC/B,YAAY,MAAM,OAAA,CAAQ,QAAQ,EAAE,KAAA,EAAO,YAAY,CAAA;AAAA,MACvD,UAAA,EAAY,MAAM,OAAA,CAAQ,OAAA,CAAQ,EAAE,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,UAAA,EAAY,CAAA;AAAA,MACvE,qBAAA,EAAuB,MAAM,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA;AAAA,MACjD,sBAAA,EAAwB,MAAM,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA;AAAA,MAClD,aAAA,EAAe,MAAM,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA;AAAA,MACzC,WAAA,EAAa,MAAM,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA;AAAA,MACvC,0BAAA,EAA4B,MAAM,OAAA,CAAQ,OAAA,CAAQ,EAAE,OAAO,EAAE,OAAA,EAAS,UAAA,EAAW,EAAG,CAAA;AAAA,MACpF,cAAA,EAAgB,MAAM,OAAA,CAAQ,OAAA,EAAQ;AAAA,MACtC,mBAAA,EAAqB,MAAM,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA;AAAA,MAC/C,OAAA,EAAS,EAAA;AAAA,MACT,cAAA,EAAgB;AAAA,KAClB;AAAA,EACF;AAEA,EAAA,OAAO,OAAA;AACT;;;AC9JO,SAAS,OAAA,GAAU;AACxB,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,SAAS,QAAA,EAAU,UAAA,KAAe,WAAA,EAAY;AACtE,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,OAAA,EAAS,UAAU,UAAA,EAAW;AACzD;;;ACDO,SAAS,OAAA,GAAU;AACxB,EAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,OAAA,KAAY,WAAA,EAAY;AAC5D,EAAA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,OAAA,EAAQ;AAC/C;ACLO,SAAS,mBAAA,GAGd;AACA,EAAA,MAAM,EAAE,mBAAA,EAAoB,GAAI,WAAA,EAAY;AAC5C,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAIC,SAA6C,IAAI,CAAA;AACrF,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIA,SAAS,KAAK,CAAA;AAE9C,EAAAC,UAAU,MAAM;AACd,IAAA,eAAe,WAAA,GAAc;AAC3B,MAAA,MAAM,MAAA,GAAS,MAAM,mBAAA,EAAoB;AACzC,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,aAAA,CAAc,MAAM,CAAA;AAAA,MACtB,CAAA,MAAO;AACL,QAAA,OAAA,CAAQ,MAAM,wDAAwD,CAAA;AACtE,QAAA,aAAA,CAAc,IAAI,CAAA;AAAA,MACpB;AACA,MAAA,WAAA,CAAY,IAAI,CAAA;AAAA,IAClB;AAEA,IAAA,KAAK,WAAA,EAAY;AAAA,EACnB,CAAA,EAAG,CAAC,mBAAmB,CAAC,CAAA;AAExB,EAAA,OAAO,EAAE,YAAY,QAAA,EAAS;AAChC","file":"hooks.js","sourcesContent":["import { createContext, useContext, ReactNode } from 'react';\nimport type { NavigationAdapter } from './types';\n\nconst NavigationContext = createContext<NavigationAdapter | null>(null);\n\nexport interface NavigationProviderProps {\n  adapter: NavigationAdapter;\n  children: ReactNode;\n}\n\n/**\n * Navigation Provider\n * Injects navigation adapter into the component tree\n */\nexport function NavigationProvider({ adapter, children }: NavigationProviderProps) {\n  return <NavigationContext.Provider value={adapter}>{children}</NavigationContext.Provider>;\n}\n\n/**\n * Hook to access navigation adapter\n * @throws Error if used outside NavigationProvider\n */\nexport function useNavigationAdapter(): NavigationAdapter {\n  const adapter = useContext(NavigationContext);\n\n  if (!adapter) {\n    return {\n      useSearchParams: () => new URLSearchParams(),\n      Link: ({ href, children }) => <a href={href}>{children}</a>,\n    };\n  }\n\n  return adapter;\n}\n","import { useContext, useEffect, useState, useMemo, type ReactNode } from 'react';\nimport type { InsforgeUser, OAuthProvider } from '../types';\nimport { NavigationProvider, BrowserNavigationAdapter } from '../navigation';\nimport { InsforgeManager, type InsforgeManagerState } from '../core/InsforgeManager';\nimport { InsforgeContext, type InsforgeContextValue } from '../contexts';\n\nexport interface InsforgeProviderProps {\n  children: ReactNode;\n  baseUrl: string;\n  /**\n   * URL to redirect to after successful sign in (when token is detected in URL)\n   * @default '/'\n   */\n  afterSignInUrl?: string;\n  onAuthChange?: (user: InsforgeUser | null) => void;\n  onSignIn?: (authToken: string) => Promise<void>;\n  onSignOut?: () => Promise<void>;\n}\n\n/**\n * Unified Insforge Provider - manages authentication state and configuration\n *\n * Uses singleton InsforgeManager to manage state across packages.\n * Context only subscribes to Manager and triggers React re-renders.\n *\n * @example\n * ```tsx\n * // Basic usage (React/Vite)\n * import { InsforgeProvider } from '@insforge/react';\n *\n * export default function App() {\n *   return (\n *     <InsforgeProvider\n *       baseUrl={import.meta.env.VITE_INSFORGE_BASE_URL}\n *     >\n *       {children}\n *     </InsforgeProvider>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With cookie sync (Next.js optimization)\n * <InsforgeProvider\n *   baseUrl={baseUrl}\n *   onSignIn={async (authToken) => {\n *     await signIn(authToken);\n *   }}\n *   onSignOut={async () => {\n *     await signOut();\n *   }}\n * >\n *   {children}\n * </InsforgeProvider>\n * ```\n */\nexport function InsforgeProviderCore({\n  children,\n  baseUrl,\n  afterSignInUrl = '/',\n  onAuthChange,\n  onSignIn,\n  onSignOut,\n}: InsforgeProviderProps) {\n  // Get singleton Manager instance\n  const manager = useMemo(\n    () =>\n      InsforgeManager.getInstance({\n        baseUrl,\n        afterSignInUrl,\n        onAuthChange,\n        onSignIn,\n        onSignOut,\n      }),\n    [baseUrl, afterSignInUrl, onAuthChange, onSignIn, onSignOut]\n  );\n\n  // Subscribe to Manager state\n  const [state, setState] = useState<InsforgeManagerState>(() => manager.getState());\n\n  useEffect(() => {\n    const unsubscribe = manager.subscribe((newState) => {\n      setState(newState);\n    });\n\n    // Initialize auth state (only runs once due to isLoaded check in Manager)\n    void manager.initialize();\n\n    return () => {\n      unsubscribe();\n    };\n  }, [manager]);\n\n  // Handle auth redirect after successful authentication\n  useEffect(() => {\n    if (typeof window !== 'undefined') {\n      manager.handleAuthRedirect(state.isLoaded, state.user);\n    }\n  }, [manager, state.isLoaded, state.user]);\n\n  // Create stable method references that delegate to manager\n  const contextValue = useMemo<InsforgeContextValue>(\n    () => ({\n      // State from Manager\n      user: state.user,\n      isLoaded: state.isLoaded,\n      isSignedIn: state.isSignedIn,\n\n      // Methods delegated to Manager\n      setUser: (user: InsforgeUser | null) => manager.setUser(user),\n      signIn: (email: string, password: string) => manager.signIn(email, password),\n      signUp: (email: string, password: string) => manager.signUp(email, password),\n      signOut: () => manager.signOut(),\n      updateUser: (data: Partial<InsforgeUser>) => manager.updateUser(data),\n      reloadAuth: () => manager.reloadAuth(),\n      sendVerificationEmail: (email: string) => manager.sendVerificationEmail(email),\n      sendResetPasswordEmail: (email: string) => manager.sendResetPasswordEmail(email),\n      resetPassword: (token: string, newPassword: string) =>\n        manager.resetPassword(token, newPassword),\n      verifyEmail: (otp: string, email?: string) => manager.verifyEmail(otp, email),\n      exchangeResetPasswordToken: (email: string, code: string) =>\n        manager.exchangeResetPasswordToken(email, code),\n      loginWithOAuth: (provider: OAuthProvider, redirectTo: string) =>\n        manager.loginWithOAuth(provider, redirectTo),\n      getPublicAuthConfig: () => manager.getPublicAuthConfig(),\n\n      // Config\n      baseUrl: manager.getConfig().baseUrl,\n      afterSignInUrl: manager.getConfig().afterSignInUrl || '/',\n    }),\n    [state, manager]\n  );\n\n  return <InsforgeContext.Provider value={contextValue}>{children}</InsforgeContext.Provider>;\n}\n\nexport function InsforgeProvider(props: InsforgeProviderProps) {\n  return (\n    <NavigationProvider adapter={BrowserNavigationAdapter}>\n      <InsforgeProviderCore {...props} />\n    </NavigationProvider>\n  );\n}\n\n/**\n * Hook to access Insforge context\n *\n * Works seamlessly across packages thanks to singleton Manager.\n * Context instance is guaranteed to be consistent.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { user, isSignedIn, signOut } = useInsforge();\n *\n *   if (!isSignedIn) return <SignIn />;\n *\n *   return (\n *     <div>\n *       <p>Welcome {user.email}</p>\n *       <button onClick={signOut}>Sign Out</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useInsforge(): InsforgeContextValue {\n  const context = useContext(InsforgeContext);\n\n  if (!context) {\n    return {\n      user: null,\n      isLoaded: false,\n      isSignedIn: false,\n      setUser: () => {},\n      signIn: () => Promise.resolve({ error: 'SSR mode' }),\n      signUp: () => Promise.resolve({ error: 'SSR mode' }),\n      signOut: () => Promise.resolve(),\n      updateUser: () => Promise.resolve({ error: 'SSR mode' }),\n      reloadAuth: () => Promise.resolve({ success: false, error: 'SSR mode' }),\n      sendVerificationEmail: () => Promise.resolve(null),\n      sendResetPasswordEmail: () => Promise.resolve(null),\n      resetPassword: () => Promise.resolve(null),\n      verifyEmail: () => Promise.resolve(null),\n      exchangeResetPasswordToken: () => Promise.resolve({ error: { message: 'SSR mode' } }),\n      loginWithOAuth: () => Promise.resolve(),\n      getPublicAuthConfig: () => Promise.resolve(null),\n      baseUrl: '',\n      afterSignInUrl: '/',\n    };\n  }\n\n  return context;\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access authentication methods\n *\n * @returns Object containing:\n *   - `signIn`: Function to sign in with email and password\n *   - `signUp`: Function to sign up with email and password\n *   - `signOut`: Function to sign out the current user\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `isSignedIn`: Boolean indicating if user is currently signed in\n *\n * @example\n * ```tsx\n * function LoginForm() {\n *   const { signIn, signUp, signOut, isLoaded, isSignedIn } = useAuth();\n *\n *   async function handleLogin(email: string, password: string) {\n *     try {\n *       await signIn(email, password);\n *       // User is now signed in\n *     } catch (error) {\n *       console.error('Sign in failed:', error);\n *     }\n *   }\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); handleLogin(email, password); }}>\n *       {/* form fields *\\/}\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useAuth() {\n  const { signIn, signUp, signOut, isLoaded, isSignedIn } = useInsforge();\n  return { signIn, signUp, signOut, isLoaded, isSignedIn };\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access current user data\n *\n * @returns Object containing:\n *   - `user`: Current user object (InsforgeUser | null)\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `updateUser`: Function to update user profile data (returns { error: string } | null)\n *   - `setUser`: Internal function to manually set user state\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const { user, isLoaded, updateUser } = useUser();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *   if (!user) return <div>Not signed in</div>;\n *\n *   async function handleUpdate(name: string) {\n *     const result = await updateUser({ name });\n *     if (result?.error) {\n *       console.error(result.error);\n *     } else {\n *       console.log('User updated successfully');\n *     }\n *   }\n *\n *   return (\n *     <div>\n *       <p>Email: {user.email}</p>\n *       {user.name && <p>Name: {user.name}</p>}\n *       {user.avatarUrl && <img src={user.avatarUrl} alt=\"Avatar\" />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useUser() {\n  const { user, isLoaded, updateUser, setUser } = useInsforge();\n  return { user, isLoaded, updateUser, setUser };\n}\n","import { useState, useEffect } from 'react';\nimport type { GetPublicAuthConfigResponse } from '@insforge/shared-schemas';\nimport { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to get all public authentication configuration (OAuth + Email) from Insforge backend\n *\n * **IMPORTANT: This hook should ONLY be used in SignIn and SignUp components.**\n *\n * This hook lazily fetches all public authentication configuration from the backend\n * only when the component mounts. Using it in other components will cause unnecessary\n * API calls on every page load.\n *\n * @returns Object containing OAuth providers, email auth config, and loading state\n * - `authConfig`: Email authentication configuration object with password rules\n * - `isLoaded`: Boolean indicating if the config has been fetched\n *\n * @example\n * ```tsx\n * // ✅ Correct usage - only in SignIn/SignUp components\n * function SignUp() {\n *   const { authConfig, isLoaded } = usePublicAuthConfig();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <div>\n *       <p>OAuth providers: {authConfig?.oauthProviders.length}</p>\n *       <p>Password min length: {authConfig?.passwordMinLength}</p>\n *     </div>\n *   );\n * }\n * ```\n *\n * @requires Must be used within InsforgeProvider\n */\nexport function usePublicAuthConfig(): {\n  authConfig: GetPublicAuthConfigResponse | null;\n  isLoaded: boolean;\n} {\n  const { getPublicAuthConfig } = useInsforge();\n  const [authConfig, setAuthConfig] = useState<GetPublicAuthConfigResponse | null>(null);\n  const [isLoaded, setIsLoaded] = useState(false);\n\n  useEffect(() => {\n    async function fetchConfig() {\n      const result = await getPublicAuthConfig();\n      if (result) {\n        setAuthConfig(result);\n      } else {\n        console.error('[usePublicAuthConfig] Failed to get public auth config');\n        setAuthConfig(null);\n      }\n      setIsLoaded(true);\n    }\n\n    void fetchConfig();\n  }, [getPublicAuthConfig]);\n\n  return { authConfig, isLoaded };\n}\n"]}
+{"version":3,"sources":["../src/navigation/NavigationContext.tsx","../src/provider/InsforgeProvider.tsx","../src/hooks/useAuth.ts","../src/hooks/useUser.ts","../src/hooks/usePublicAuthConfig.ts"],"names":["useContext","useState","useEffect"],"mappings":"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","file":"hooks.js","sourcesContent":["import { createContext, useContext, ReactNode } from 'react';\nimport type { NavigationAdapter } from './types';\n\nconst NavigationContext = createContext<NavigationAdapter | null>(null);\n\nexport interface NavigationProviderProps {\n  adapter: NavigationAdapter;\n  children: ReactNode;\n}\n\n/**\n * Navigation Provider\n * Injects navigation adapter into the component tree\n */\nexport function NavigationProvider({ adapter, children }: NavigationProviderProps) {\n  return <NavigationContext.Provider value={adapter}>{children}</NavigationContext.Provider>;\n}\n\n/**\n * Hook to access navigation adapter\n * @throws Error if used outside NavigationProvider\n */\nexport function useNavigationAdapter(): NavigationAdapter {\n  const adapter = useContext(NavigationContext);\n\n  if (!adapter) {\n    return {\n      useSearchParams: () => new URLSearchParams(),\n      Link: ({ href, children }) => <a href={href}>{children}</a>,\n    };\n  }\n\n  return adapter;\n}\n","import { useContext, useEffect, useState, useMemo, type ReactNode } from 'react';\nimport type { InsforgeUser, OAuthProvider } from '../types';\nimport { NavigationProvider, BrowserNavigationAdapter } from '../navigation';\nimport { InsforgeManager, type InsforgeManagerState } from '../core/InsforgeManager';\nimport { InsforgeContext, type InsforgeContextValue } from '../contexts';\n\nexport interface InitialAuthState {\n  user?: InsforgeUser | null;\n  userId?: string | null;\n}\n\nexport interface InsforgeProviderProps {\n  children: ReactNode;\n  baseUrl: string;\n  /**\n   * URL to redirect to after successful sign in (when token is detected in URL)\n   * @default '/'\n   */\n  afterSignInUrl?: string;\n  onAuthChange?: (user: InsforgeUser | null) => void;\n  onSignIn?: (authToken: string) => Promise<void>;\n  onSignOut?: () => Promise<void>;\n  /**\n   * Initial auth state from server (for SSR hydration)\n   * @internal - Not intended for public use, used by Next.js package\n   */\n  initialState?: InitialAuthState;\n}\n\n/**\n * Unified Insforge Provider - manages authentication state and configuration\n *\n * Uses singleton InsforgeManager to manage state across packages.\n * Context only subscribes to Manager and triggers React re-renders.\n *\n * @example\n * ```tsx\n * // Basic usage (React/Vite)\n * import { InsforgeProvider } from '@insforge/react';\n *\n * export default function App() {\n *   return (\n *     <InsforgeProvider\n *       baseUrl={import.meta.env.VITE_INSFORGE_BASE_URL}\n *     >\n *       {children}\n *     </InsforgeProvider>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With cookie sync (Next.js optimization)\n * <InsforgeProvider\n *   baseUrl={baseUrl}\n *   onSignIn={async (authToken) => {\n *     await signIn(authToken);\n *   }}\n *   onSignOut={async () => {\n *     await signOut();\n *   }}\n * >\n *   {children}\n * </InsforgeProvider>\n * ```\n */\nexport function InsforgeProviderCore({\n  children,\n  baseUrl,\n  afterSignInUrl = '/',\n  onAuthChange,\n  onSignIn,\n  onSignOut,\n  initialState,\n}: InsforgeProviderProps) {\n  // Get singleton Manager instance\n  const manager = useMemo(\n    () =>\n      InsforgeManager.getInstance({\n        baseUrl,\n        afterSignInUrl,\n        onAuthChange,\n        onSignIn,\n        onSignOut,\n      }),\n    [baseUrl, afterSignInUrl, onAuthChange, onSignIn, onSignOut]\n  );\n\n  // Set initialState if provided (from Server Component)\n  // This must happen during render, before useState initialization\n  if (initialState) {\n    const currentState = manager.getState();\n    if (currentState.userId === undefined && initialState.userId !== undefined) {\n      manager.setInitialState(initialState);\n    }\n  }\n\n  // Subscribe to Manager state\n  // Start with initial state from manager (will include initialState if set above)\n  const [state, setState] = useState<InsforgeManagerState>(() => manager.getState());\n\n  useEffect(() => {\n    // Subscribe to state changes\n    const unsubscribe = manager.subscribe((newState) => {\n      setState(newState);\n    });\n\n    // Initialize auth state only on client side (after hydration)\n    // This prevents hydration mismatches by ensuring SSR and client initial render match\n    void manager.initialize();\n\n    return () => {\n      unsubscribe();\n    };\n  }, [manager]);\n\n  // Handle auth redirect after successful authentication\n  useEffect(() => {\n    if (typeof window !== 'undefined') {\n      manager.handleAuthRedirect(state.isLoaded, state.user);\n    }\n  }, [manager, state.isLoaded, state.user]);\n\n  // Create stable method references that delegate to manager\n  const contextValue = useMemo<InsforgeContextValue>(\n    () => ({\n      // State from Manager\n      user: state.user,\n      userId: state.userId,\n      isLoaded: state.isLoaded,\n      isSignedIn: state.isSignedIn,\n\n      // Methods delegated to Manager\n      setUser: (user: InsforgeUser | null) => manager.setUser(user),\n      signIn: (email: string, password: string) => manager.signIn(email, password),\n      signUp: (email: string, password: string) => manager.signUp(email, password),\n      signOut: () => manager.signOut(),\n      updateUser: (data: Partial<InsforgeUser>) => manager.updateUser(data),\n      reloadAuth: () => manager.reloadAuth(),\n      sendVerificationEmail: (email: string) => manager.sendVerificationEmail(email),\n      sendResetPasswordEmail: (email: string) => manager.sendResetPasswordEmail(email),\n      resetPassword: (token: string, newPassword: string) =>\n        manager.resetPassword(token, newPassword),\n      verifyEmail: (otp: string, email?: string) => manager.verifyEmail(otp, email),\n      exchangeResetPasswordToken: (email: string, code: string) =>\n        manager.exchangeResetPasswordToken(email, code),\n      loginWithOAuth: (provider: OAuthProvider, redirectTo: string) =>\n        manager.loginWithOAuth(provider, redirectTo),\n      getPublicAuthConfig: () => manager.getPublicAuthConfig(),\n\n      // Config\n      baseUrl: manager.getConfig().baseUrl,\n      afterSignInUrl: manager.getConfig().afterSignInUrl || '/',\n    }),\n    [state, manager]\n  );\n\n  return <InsforgeContext.Provider value={contextValue}>{children}</InsforgeContext.Provider>;\n}\n\nexport function InsforgeProvider(props: InsforgeProviderProps) {\n  return (\n    <NavigationProvider adapter={BrowserNavigationAdapter}>\n      <InsforgeProviderCore {...props} />\n    </NavigationProvider>\n  );\n}\n\n/**\n * Hook to access Insforge context\n *\n * Works seamlessly across packages thanks to singleton Manager.\n * Context instance is guaranteed to be consistent.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { user, isSignedIn, signOut } = useInsforge();\n *\n *   if (!isSignedIn) return <SignIn />;\n *\n *   return (\n *     <div>\n *       <p>Welcome {user.email}</p>\n *       <button onClick={signOut}>Sign Out</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useInsforge(): InsforgeContextValue {\n  const context = useContext(InsforgeContext);\n\n  if (!context) {\n    return {\n      user: undefined,\n      userId: undefined,\n      isLoaded: false,\n      isSignedIn: undefined,\n      setUser: () => {},\n      signIn: () => Promise.resolve({ error: 'SSR mode' }),\n      signUp: () => Promise.resolve({ error: 'SSR mode' }),\n      signOut: () => Promise.resolve(),\n      updateUser: () => Promise.resolve({ error: 'SSR mode' }),\n      reloadAuth: () => Promise.resolve({ success: false, error: 'SSR mode' }),\n      sendVerificationEmail: () => Promise.resolve(null),\n      sendResetPasswordEmail: () => Promise.resolve(null),\n      resetPassword: () => Promise.resolve(null),\n      verifyEmail: () => Promise.resolve(null),\n      exchangeResetPasswordToken: () => Promise.resolve({ error: { message: 'SSR mode' } }),\n      loginWithOAuth: () => Promise.resolve(),\n      getPublicAuthConfig: () => Promise.resolve(null),\n      baseUrl: '',\n      afterSignInUrl: '/',\n    };\n  }\n\n  return context;\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access authentication methods\n *\n * @returns Object containing:\n *   - `signIn`: Function to sign in with email and password\n *   - `signUp`: Function to sign up with email and password\n *   - `signOut`: Function to sign out the current user\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `isSignedIn`: Boolean indicating if user is currently signed in\n *\n * @example\n * ```tsx\n * function LoginForm() {\n *   const { signIn, signUp, signOut, isLoaded, isSignedIn } = useAuth();\n *\n *   async function handleLogin(email: string, password: string) {\n *     try {\n *       await signIn(email, password);\n *       // User is now signed in\n *     } catch (error) {\n *       console.error('Sign in failed:', error);\n *     }\n *   }\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); handleLogin(email, password); }}>\n *       {/* form fields *\\/}\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useAuth() {\n  const { signIn, signUp, signOut, isLoaded, isSignedIn } = useInsforge();\n  return { signIn, signUp, signOut, isLoaded, isSignedIn };\n}\n","import { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to access current user data\n *\n * @returns Object containing:\n *   - `user`: Current user object (InsforgeUser | null)\n *   - `isLoaded`: Boolean indicating if auth state has been loaded\n *   - `updateUser`: Function to update user profile data (returns { error: string } | null)\n *   - `setUser`: Internal function to manually set user state\n *\n * @example\n * ```tsx\n * function UserProfile() {\n *   const { user, isLoaded, updateUser } = useUser();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *   if (!user) return <div>Not signed in</div>;\n *\n *   async function handleUpdate(name: string) {\n *     const result = await updateUser({ name });\n *     if (result?.error) {\n *       console.error(result.error);\n *     } else {\n *       console.log('User updated successfully');\n *     }\n *   }\n *\n *   return (\n *     <div>\n *       <p>Email: {user.email}</p>\n *       {user.name && <p>Name: {user.name}</p>}\n *       {user.avatarUrl && <img src={user.avatarUrl} alt=\"Avatar\" />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useUser() {\n  const { user, isLoaded, updateUser, setUser } = useInsforge();\n  return { user, isLoaded, updateUser, setUser };\n}\n","import { useState, useEffect } from 'react';\nimport type { GetPublicAuthConfigResponse } from '@insforge/shared-schemas';\nimport { useInsforge } from '../provider/InsforgeProvider';\n\n/**\n * Hook to get all public authentication configuration (OAuth + Email) from Insforge backend\n *\n * **IMPORTANT: This hook should ONLY be used in SignIn and SignUp components.**\n *\n * This hook lazily fetches all public authentication configuration from the backend\n * only when the component mounts. Using it in other components will cause unnecessary\n * API calls on every page load.\n *\n * @returns Object containing OAuth providers, email auth config, and loading state\n * - `authConfig`: Email authentication configuration object with password rules\n * - `isLoaded`: Boolean indicating if the config has been fetched\n *\n * @example\n * ```tsx\n * // ✅ Correct usage - only in SignIn/SignUp components\n * function SignUp() {\n *   const { authConfig, isLoaded } = usePublicAuthConfig();\n *\n *   if (!isLoaded) return <div>Loading...</div>;\n *\n *   return (\n *     <div>\n *       <p>OAuth providers: {authConfig?.oauthProviders.length}</p>\n *       <p>Password min length: {authConfig?.passwordMinLength}</p>\n *     </div>\n *   );\n * }\n * ```\n *\n * @requires Must be used within InsforgeProvider\n */\nexport function usePublicAuthConfig(): {\n  authConfig: GetPublicAuthConfigResponse | null;\n  isLoaded: boolean;\n} {\n  const { getPublicAuthConfig } = useInsforge();\n  const [authConfig, setAuthConfig] = useState<GetPublicAuthConfigResponse | null>(null);\n  const [isLoaded, setIsLoaded] = useState(false);\n\n  useEffect(() => {\n    async function fetchConfig() {\n      const result = await getPublicAuthConfig();\n      if (result) {\n        setAuthConfig(result);\n      } else {\n        console.error('[usePublicAuthConfig] Failed to get public auth config');\n        setAuthConfig(null);\n      }\n      setIsLoaded(true);\n    }\n\n    void fetchConfig();\n  }, [getPublicAuthConfig]);\n\n  return { authConfig, isLoaded };\n}\n"]}

package/dist/index.cjs

@@ -69,7 +69,7 @@ var InsforgeManager = class _InsforgeManager {
   // Static private instance
   static instance = null;
   // State storage
-  user = null;
+  user = void 0;
   isLoaded = false;
   isInitializing = false;
   sdk;
@@ -82,11 +82,8 @@ var InsforgeManager = class _InsforgeManager {
   constructor(config) {
     this.config = config;
     this.sdk = sdk.createClient({ baseUrl: config.baseUrl });
-    const session = this.sdk.auth.getCurrentSession();
-    if (!session.data?.session?.accessToken) {
-      this.isLoaded = true;
-      this.user = null;
-    }
+    this.user = void 0;
+    this.isLoaded = false;
   }
   // Public access method (Singleton core)
   static getInstance(config) {
@@ -109,26 +106,36 @@ var InsforgeManager = class _InsforgeManager {
     this.config = { ...this.config, ...config };
   }
   // Public initialization method
+  // Following Clerk's pattern: Even if we have initialState (isLoaded=true from cookies),
+  // we still need to load full user data from SDK/API
   async initialize() {
-    if (this.isLoaded) {
-      return;
-    }
     if (this.isInitializing) {
       return;
     }
     this.isInitializing = true;
     try {
-      await this.loadAuthState();
+      const sessionResult = this.sdk.auth.getCurrentSession();
+      const hasToken = !!sessionResult.data?.session?.accessToken;
+      if (hasToken) {
+        await this.loadAuthState();
+      } else if (this.user === void 0) {
+        this.user = null;
+        this.isLoaded = true;
+        this.notifyListeners();
+      }
     } finally {
       this.isInitializing = false;
     }
   }
   // Get current state
   getState() {
+    const userId = this.user === void 0 ? void 0 : this.user === null ? null : this.user.id;
+    const isSignedIn = this.user === void 0 ? void 0 : this.user !== null;
     return {
       user: this.user,
+      userId,
       isLoaded: this.isLoaded,
-      isSignedIn: !!this.user
+      isSignedIn
     };
   }
   // Subscription mechanism
@@ -141,6 +148,8 @@ var InsforgeManager = class _InsforgeManager {
     this.listeners.forEach((listener) => listener(state));
   }
   // Load auth state
+  // This loads the FULL user data from SDK (including complete profile)
+  // Called after hydration to get complete user information beyond what's in cookies
   async loadAuthState() {
     try {
       const sessionResult = this.sdk.auth.getCurrentSession();
@@ -163,6 +172,7 @@ var InsforgeManager = class _InsforgeManager {
           email: userResult.data.user.email,
           name: profile?.nickname || "",
           avatarUrl: profile?.avatarUrl || ""
+          // You can add more profile fields here as needed
         };
         this.user = userData;
         if (this.config.onAuthChange) {
@@ -423,6 +433,22 @@ var InsforgeManager = class _InsforgeManager {
     }
     this.notifyListeners();
   }
+  // Set initial state from server (for SSR hydration)
+  // This is ONLY basic user info from cookies, not full profile
+  // Following Clerk's pattern: initialState prevents hydration mismatch
+  // but full user data is still loaded via initialize()
+  setInitialState(initialState) {
+    if (this.user !== void 0) {
+      return;
+    }
+    if (initialState.userId) {
+      this.user = initialState.user ?? null;
+    } else {
+      this.user = null;
+    }
+    this.isLoaded = true;
+    this.notifyListeners();
+  }
   getConfig() {
     return this.config;
   }
@@ -463,7 +489,8 @@ function InsforgeProviderCore({
   afterSignInUrl = "/",
   onAuthChange,
   onSignIn,
-  onSignOut
+  onSignOut,
+  initialState
 }) {
   const manager = react.useMemo(
     () => InsforgeManager.getInstance({
@@ -475,6 +502,12 @@ function InsforgeProviderCore({
     }),
     [baseUrl, afterSignInUrl, onAuthChange, onSignIn, onSignOut]
   );
+  if (initialState) {
+    const currentState = manager.getState();
+    if (currentState.userId === void 0 && initialState.userId !== void 0) {
+      manager.setInitialState(initialState);
+    }
+  }
   const [state, setState] = react.useState(() => manager.getState());
   react.useEffect(() => {
     const unsubscribe = manager.subscribe((newState) => {
@@ -494,6 +527,7 @@ function InsforgeProviderCore({
     () => ({
       // State from Manager
       user: state.user,
+      userId: state.userId,
       isLoaded: state.isLoaded,
       isSignedIn: state.isSignedIn,
       // Methods delegated to Manager
@@ -525,9 +559,10 @@ function useInsforge() {
   const context = react.useContext(react$1.InsforgeContext);
   if (!context) {
     return {
-      user: null,
+      user: void 0,
+      userId: void 0,
       isLoaded: false,
-      isSignedIn: false,
+      isSignedIn: void 0,
       setUser: () => {
       },
       signIn: () => Promise.resolve({ error: "SSR mode" }),
@@ -2507,16 +2542,16 @@ function Protect({
   condition,
   onRedirect
 }) {
-  const { isSignedIn, isLoaded, user } = useInsforge();
+  const { userId, user } = useInsforge();
   const resolvedRedirectTo = react.useMemo(() => resolveAuthPath(redirectTo), [redirectTo]);
   react.useEffect(() => {
-    if (isLoaded && !isSignedIn) {
+    if (userId === null) {
       if (onRedirect) {
         onRedirect(resolvedRedirectTo);
       } else {
         window.location.href = resolvedRedirectTo;
       }
-    } else if (isLoaded && isSignedIn && condition && user) {
+    } else if (userId && condition && user) {
       if (!condition(user)) {
         if (onRedirect) {
           onRedirect(resolvedRedirectTo);
@@ -2525,11 +2560,11 @@ function Protect({
         }
       }
     }
-  }, [isLoaded, isSignedIn, resolvedRedirectTo, condition, user, onRedirect]);
-  if (!isLoaded) {
+  }, [userId, resolvedRedirectTo, condition, user, onRedirect]);
+  if (userId === void 0) {
     return fallback || /* @__PURE__ */ jsxRuntime.jsx("div", { className: "insforge-loading", children: "Loading..." });
   }
-  if (!isSignedIn) {
+  if (userId === null) {
     return fallback || null;
   }
   if (condition && user && !condition(user)) {
@@ -2538,24 +2573,18 @@ function Protect({
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
 }
 function SignedIn({ children }) {
-  const { isSignedIn, isLoaded } = useInsforge();
-  if (!isLoaded) {
-    return null;
+  const { userId } = useInsforge();
+  if (userId) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
   }
-  if (!isSignedIn) {
-    return null;
-  }
-  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  return null;
 }
 function SignedOut({ children }) {
-  const { isSignedIn, isLoaded } = useInsforge();
-  if (!isLoaded) {
-    return null;
+  const { userId } = useInsforge();
+  if (userId === null) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
   }
-  if (isSignedIn) {
-    return null;
-  }
-  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  return null;
 }
 function SignInButton({ children, className }) {
   const { afterSignInUrl, baseUrl } = useInsforge();