@korajs/auth 0.1.0

package/dist/react.cjs

@@ -0,0 +1,206 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react.ts
+var react_exports = {};
+__export(react_exports, {
+  AuthContext: () => AuthContext,
+  AuthProvider: () => AuthProvider,
+  useAuth: () => useAuth,
+  useAuthStatus: () => useAuthStatus,
+  useCurrentUser: () => useCurrentUser
+});
+module.exports = __toCommonJS(react_exports);
+
+// src/react/AuthProvider.tsx
+var import_react2 = require("react");
+
+// src/react/auth-context.ts
+var import_react = require("react");
+var AuthContext = (0, import_react.createContext)(null);
+
+// src/react/AuthProvider.tsx
+function AuthProvider({ client, children, fallback }) {
+  const [state, setState] = (0, import_react2.useState)(client.state);
+  const [isLoading, setIsLoading] = (0, import_react2.useState)(true);
+  const [initError, setInitError] = (0, import_react2.useState)(null);
+  (0, import_react2.useEffect)(() => {
+    let cancelled = false;
+    const unsubscribe = client.onAuthChange((newState) => {
+      if (!cancelled) {
+        setState(newState);
+      }
+    });
+    client.initialize().then(() => {
+      if (!cancelled) {
+        setState(client.state);
+        setIsLoading(false);
+      }
+    }).catch((error) => {
+      if (!cancelled) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        console.error("[Kora Auth] Initialization failed:", err);
+        setInitError(err);
+        setIsLoading(false);
+      }
+    });
+    return () => {
+      cancelled = true;
+      unsubscribe();
+    };
+  }, [client]);
+  if (initError) {
+    return (0, import_react2.createElement)(
+      "div",
+      {
+        style: { color: "red", padding: "1rem", fontFamily: "monospace" },
+        role: "alert"
+      },
+      (0, import_react2.createElement)("strong", null, "Kora Auth initialization error: "),
+      initError.message
+    );
+  }
+  if (isLoading && fallback !== void 0) {
+    return fallback;
+  }
+  const contextValue = {
+    client,
+    state,
+    isLoading
+  };
+  return (0, import_react2.createElement)(AuthContext.Provider, { value: contextValue }, children);
+}
+
+// src/react/hooks.ts
+var import_react3 = require("react");
+function useAuthContext() {
+  const ctx = (0, import_react3.useContext)(AuthContext);
+  if (ctx === null) {
+    throw new Error(
+      "useAuth / useCurrentUser / useAuthStatus must be used within an <AuthProvider>. Wrap your component tree with <AuthProvider client={authClient}>."
+    );
+  }
+  return ctx;
+}
+function useAuth() {
+  const { client, state, isLoading } = useAuthContext();
+  const [error, setError] = (0, import_react3.useState)(null);
+  const userSnapshotRef = (0, import_react3.useRef)(client.currentUser);
+  const stateSerializedRef = (0, import_react3.useRef)(JSON.stringify(client.currentUser));
+  const subscribe = (0, import_react3.useCallback)(
+    (onStoreChange) => {
+      return client.onAuthChange(() => {
+        const newUser = client.currentUser;
+        const newSerialized = JSON.stringify(newUser);
+        if (newSerialized !== stateSerializedRef.current) {
+          userSnapshotRef.current = newUser;
+          stateSerializedRef.current = newSerialized;
+          onStoreChange();
+        }
+      });
+    },
+    [client]
+  );
+  const getSnapshot = (0, import_react3.useCallback)(() => {
+    return userSnapshotRef.current;
+  }, []);
+  const user = (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot);
+  const signUp = (0, import_react3.useCallback)(
+    async (params) => {
+      setError(null);
+      try {
+        await client.signUp(params);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        setError(message);
+      }
+    },
+    [client]
+  );
+  const signIn = (0, import_react3.useCallback)(
+    async (params) => {
+      setError(null);
+      try {
+        await client.signIn(params);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        setError(message);
+      }
+    },
+    [client]
+  );
+  const signOut = (0, import_react3.useCallback)(async () => {
+    setError(null);
+    try {
+      await client.signOut();
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      setError(message);
+    }
+  }, [client]);
+  return {
+    user,
+    isAuthenticated: state === "authenticated",
+    isLoading,
+    signUp,
+    signIn,
+    signOut,
+    error
+  };
+}
+function useCurrentUser() {
+  const { client } = useAuthContext();
+  const userSnapshotRef = (0, import_react3.useRef)(client.currentUser);
+  const stateSerializedRef = (0, import_react3.useRef)(JSON.stringify(client.currentUser));
+  const subscribe = (0, import_react3.useCallback)(
+    (onStoreChange) => {
+      return client.onAuthChange(() => {
+        const newUser = client.currentUser;
+        const newSerialized = JSON.stringify(newUser);
+        if (newSerialized !== stateSerializedRef.current) {
+          userSnapshotRef.current = newUser;
+          stateSerializedRef.current = newSerialized;
+          onStoreChange();
+        }
+      });
+    },
+    [client]
+  );
+  const getSnapshot = (0, import_react3.useCallback)(() => {
+    return userSnapshotRef.current;
+  }, []);
+  return (0, import_react3.useSyncExternalStore)(subscribe, getSnapshot);
+}
+function useAuthStatus() {
+  const { state, isLoading } = useAuthContext();
+  return {
+    state,
+    isAuthenticated: state === "authenticated",
+    isLoading
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthContext,
+  AuthProvider,
+  useAuth,
+  useAuthStatus,
+  useCurrentUser
+});
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts","../src/react/AuthProvider.tsx","../src/react/auth-context.ts","../src/react/hooks.ts"],"sourcesContent":["// @korajs/auth/react — React-specific public API\n// Every export here is a public API commitment. Be explicit.\n\n// === Provider ===\nexport { AuthProvider } from './react/AuthProvider'\nexport type { AuthProviderProps } from './react/AuthProvider'\n\n// === Hooks ===\nexport { useAuth, useCurrentUser, useAuthStatus } from './react/hooks'\nexport type { UseAuthResult, AuthStatus } from './react/hooks'\n\n// === Context (for advanced use cases) ===\nexport { AuthContext } from './react/auth-context'\nexport type { AuthContextValue } from './react/auth-context'\n","import { createElement, useEffect, useState } from 'react'\nimport type { ReactElement, ReactNode } from 'react'\nimport type { AuthClient, AuthState } from '../client/auth-client'\nimport { AuthContext } from './auth-context'\n\n/**\n * Props for the AuthProvider component.\n */\ninterface AuthProviderProps {\n\t/** The AuthClient instance to provide to child components */\n\tclient: AuthClient\n\n\t/** Child components that will have access to auth context */\n\tchildren: ReactNode\n\n\t/**\n\t * Optional fallback content to render while the auth client is initializing.\n\t * If not provided, children are rendered with `isLoading: true` in the context.\n\t */\n\tfallback?: ReactNode\n}\n\n/**\n * React context provider that wraps the AuthClient for use with auth hooks.\n *\n * Calls `client.initialize()` on mount to restore any existing session from\n * stored tokens. Subscribes to auth state changes and re-renders children\n * when the state transitions.\n *\n * Must be placed above any component that uses {@link useAuth},\n * {@link useCurrentUser}, or {@link useAuthStatus}.\n *\n * @param props - Provider props including the AuthClient instance and children\n * @returns A React element wrapping children in the AuthContext\n *\n * @example\n * ```typescript\n * import { AuthClient } from '@korajs/auth'\n * import { AuthProvider } from '@korajs/auth/react'\n *\n * const authClient = new AuthClient({ serverUrl: 'http://localhost:3001' })\n *\n * function App() {\n *   return (\n *     <AuthProvider client={authClient} fallback={<div>Loading...</div>}>\n *       <MyApp />\n *     </AuthProvider>\n *   )\n * }\n * ```\n */\nfunction AuthProvider({ client, children, fallback }: AuthProviderProps): ReactElement {\n\tconst [state, setState] = useState<AuthState>(client.state)\n\tconst [isLoading, setIsLoading] = useState(true)\n\tconst [initError, setInitError] = useState<Error | null>(null)\n\n\t// Initialize the auth client on mount\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\n\t\t// Subscribe to auth state changes\n\t\tconst unsubscribe = client.onAuthChange((newState) => {\n\t\t\tif (!cancelled) {\n\t\t\t\tsetState(newState)\n\t\t\t}\n\t\t})\n\n\t\tclient\n\t\t\t.initialize()\n\t\t\t.then(() => {\n\t\t\t\tif (!cancelled) {\n\t\t\t\t\tsetState(client.state)\n\t\t\t\t\tsetIsLoading(false)\n\t\t\t\t}\n\t\t\t})\n\t\t\t.catch((error: unknown) => {\n\t\t\t\tif (!cancelled) {\n\t\t\t\t\tconst err = error instanceof Error ? error : new Error(String(error))\n\t\t\t\t\tconsole.error('[Kora Auth] Initialization failed:', err)\n\t\t\t\t\tsetInitError(err)\n\t\t\t\t\tsetIsLoading(false)\n\t\t\t\t}\n\t\t\t})\n\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t\tunsubscribe()\n\t\t}\n\t}, [client])\n\n\t// Show error if initialization failed\n\tif (initError) {\n\t\treturn createElement(\n\t\t\t'div',\n\t\t\t{\n\t\t\t\tstyle: { color: 'red', padding: '1rem', fontFamily: 'monospace' },\n\t\t\t\trole: 'alert',\n\t\t\t},\n\t\t\tcreateElement('strong', null, 'Kora Auth initialization error: '),\n\t\t\tinitError.message,\n\t\t)\n\t}\n\n\t// Show fallback while loading\n\tif (isLoading && fallback !== undefined) {\n\t\treturn fallback as ReactElement\n\t}\n\n\tconst contextValue = {\n\t\tclient,\n\t\tstate,\n\t\tisLoading,\n\t}\n\n\treturn createElement(AuthContext.Provider, { value: contextValue }, children)\n}\n\nexport { AuthProvider }\nexport type { AuthProviderProps }\n","import { createContext } from 'react'\nimport type { AuthClient } from '../client/auth-client'\n\n/**\n * Possible authentication states for the client.\n * - 'loading': Initial state while restoring tokens from storage\n * - 'authenticated': User is signed in with a valid session\n * - 'unauthenticated': No valid session exists\n */\ntype AuthState = 'loading' | 'authenticated' | 'unauthenticated'\n\n/**\n * Shape of the value provided by the AuthContext.\n * Includes the AuthClient instance, reactive state, and a loading flag.\n */\ninterface AuthContextValue {\n\t/** The underlying AuthClient instance for direct access */\n\tclient: AuthClient\n\n\t/** Current authentication state */\n\tstate: AuthState\n\n\t/** Whether the client is still initializing (restoring session from storage) */\n\tisLoading: boolean\n}\n\n/**\n * React context for Kora authentication.\n *\n * Provides the AuthClient and reactive auth state to child components.\n * Must be provided by an AuthProvider higher in the component tree.\n * Defaults to null — hooks that consume this context throw if it is missing.\n */\nconst AuthContext = createContext<AuthContextValue | null>(null)\n\nexport { AuthContext }\nexport type { AuthContextValue, AuthState }\n","import { useCallback, useContext, useEffect, useRef, useState, useSyncExternalStore } from 'react'\nimport type { AuthUser, AuthState } from '../client/auth-client'\nimport { AuthContext } from './auth-context'\n\n// ---------------------------------------------------------------------------\n// Internal context accessor\n// ---------------------------------------------------------------------------\n\n/**\n * Internal hook that reads and validates the AuthContext.\n * Throws a descriptive error if used outside an AuthProvider.\n */\nfunction useAuthContext(): { client: import('../client/auth-client').AuthClient; state: AuthState; isLoading: boolean } {\n\tconst ctx = useContext(AuthContext)\n\tif (ctx === null) {\n\t\tthrow new Error(\n\t\t\t'useAuth / useCurrentUser / useAuthStatus must be used within an <AuthProvider>. ' +\n\t\t\t\t'Wrap your component tree with <AuthProvider client={authClient}>.',\n\t\t)\n\t}\n\treturn ctx\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Return value of the {@link useAuth} hook.\n */\ninterface UseAuthResult {\n\t/** Current authenticated user, or null if not signed in */\n\tuser: AuthUser | null\n\n\t/** Whether the user is currently authenticated */\n\tisAuthenticated: boolean\n\n\t/** Whether the auth client is still initializing (restoring session) */\n\tisLoading: boolean\n\n\t/** Sign up a new user account */\n\tsignUp: (params: { email: string; password: string; name?: string }) => Promise<void>\n\n\t/** Sign in with email and password */\n\tsignIn: (params: { email: string; password: string }) => Promise<void>\n\n\t/** Sign out the current user */\n\tsignOut: () => Promise<void>\n\n\t/** Last error message from a sign-up, sign-in, or sign-out attempt, or null */\n\terror: string | null\n}\n\n/**\n * Auth status information returned by {@link useAuthStatus}.\n */\ninterface AuthStatus {\n\t/** Current authentication state */\n\tstate: AuthState\n\n\t/** Whether the user is currently authenticated */\n\tisAuthenticated: boolean\n\n\t/** Whether the auth client is still initializing */\n\tisLoading: boolean\n}\n\n// ---------------------------------------------------------------------------\n// useAuth\n// ---------------------------------------------------------------------------\n\n/**\n * React hook providing full authentication functionality.\n *\n * Returns the current user, loading state, error state, and methods for\n * sign-up, sign-in, and sign-out. Re-renders when auth state changes.\n *\n * Must be used within an {@link AuthProvider}.\n *\n * @returns An object with user info, auth methods, and status flags\n *\n * @example\n * ```typescript\n * function LoginPage() {\n *   const { user, isAuthenticated, isLoading, signIn, error } = useAuth()\n *\n *   if (isLoading) return <div>Loading...</div>\n *   if (isAuthenticated) return <div>Welcome, {user?.name}</div>\n *\n *   return (\n *     <form onSubmit={async (e) => {\n *       e.preventDefault()\n *       await signIn({ email: 'user@example.com', password: 'secret' })\n *     }}>\n *       {error && <p>{error}</p>}\n *       <button type=\"submit\">Sign In</button>\n *     </form>\n *   )\n * }\n * ```\n */\nfunction useAuth(): UseAuthResult {\n\tconst { client, state, isLoading } = useAuthContext()\n\tconst [error, setError] = useState<string | null>(null)\n\n\t// Use useSyncExternalStore to track the user reactively via auth state changes\n\tconst userSnapshotRef = useRef<AuthUser | null>(client.currentUser)\n\tconst stateSerializedRef = useRef<string>(JSON.stringify(client.currentUser))\n\n\tconst subscribe = useCallback(\n\t\t(onStoreChange: () => void): (() => void) => {\n\t\t\treturn client.onAuthChange(() => {\n\t\t\t\tconst newUser = client.currentUser\n\t\t\t\tconst newSerialized = JSON.stringify(newUser)\n\t\t\t\tif (newSerialized !== stateSerializedRef.current) {\n\t\t\t\t\tuserSnapshotRef.current = newUser\n\t\t\t\t\tstateSerializedRef.current = newSerialized\n\t\t\t\t\tonStoreChange()\n\t\t\t\t}\n\t\t\t})\n\t\t},\n\t\t[client],\n\t)\n\n\tconst getSnapshot = useCallback((): AuthUser | null => {\n\t\treturn userSnapshotRef.current\n\t}, [])\n\n\tconst user = useSyncExternalStore(subscribe, getSnapshot)\n\n\tconst signUp = useCallback(\n\t\tasync (params: { email: string; password: string; name?: string }): Promise<void> => {\n\t\t\tsetError(null)\n\t\t\ttry {\n\t\t\t\tawait client.signUp(params)\n\t\t\t} catch (err: unknown) {\n\t\t\t\tconst message = err instanceof Error ? err.message : String(err)\n\t\t\t\tsetError(message)\n\t\t\t}\n\t\t},\n\t\t[client],\n\t)\n\n\tconst signIn = useCallback(\n\t\tasync (params: { email: string; password: string }): Promise<void> => {\n\t\t\tsetError(null)\n\t\t\ttry {\n\t\t\t\tawait client.signIn(params)\n\t\t\t} catch (err: unknown) {\n\t\t\t\tconst message = err instanceof Error ? err.message : String(err)\n\t\t\t\tsetError(message)\n\t\t\t}\n\t\t},\n\t\t[client],\n\t)\n\n\tconst signOut = useCallback(async (): Promise<void> => {\n\t\tsetError(null)\n\t\ttry {\n\t\t\tawait client.signOut()\n\t\t} catch (err: unknown) {\n\t\t\tconst message = err instanceof Error ? err.message : String(err)\n\t\t\tsetError(message)\n\t\t}\n\t}, [client])\n\n\treturn {\n\t\tuser,\n\t\tisAuthenticated: state === 'authenticated',\n\t\tisLoading,\n\t\tsignUp,\n\t\tsignIn,\n\t\tsignOut,\n\t\terror,\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// useCurrentUser\n// ---------------------------------------------------------------------------\n\n/**\n * React hook that returns the currently authenticated user, or null.\n *\n * A lightweight alternative to {@link useAuth} when you only need the user\n * object and do not need auth methods or error state.\n *\n * Must be used within an {@link AuthProvider}.\n *\n * @returns The current AuthUser or null if not authenticated\n *\n * @example\n * ```typescript\n * function UserAvatar() {\n *   const user = useCurrentUser()\n *   if (!user) return null\n *   return <span>{user.name ?? user.email}</span>\n * }\n * ```\n */\nfunction useCurrentUser(): AuthUser | null {\n\tconst { client } = useAuthContext()\n\n\tconst userSnapshotRef = useRef<AuthUser | null>(client.currentUser)\n\tconst stateSerializedRef = useRef<string>(JSON.stringify(client.currentUser))\n\n\tconst subscribe = useCallback(\n\t\t(onStoreChange: () => void): (() => void) => {\n\t\t\treturn client.onAuthChange(() => {\n\t\t\t\tconst newUser = client.currentUser\n\t\t\t\tconst newSerialized = JSON.stringify(newUser)\n\t\t\t\tif (newSerialized !== stateSerializedRef.current) {\n\t\t\t\t\tuserSnapshotRef.current = newUser\n\t\t\t\t\tstateSerializedRef.current = newSerialized\n\t\t\t\t\tonStoreChange()\n\t\t\t\t}\n\t\t\t})\n\t\t},\n\t\t[client],\n\t)\n\n\tconst getSnapshot = useCallback((): AuthUser | null => {\n\t\treturn userSnapshotRef.current\n\t}, [])\n\n\treturn useSyncExternalStore(subscribe, getSnapshot)\n}\n\n// ---------------------------------------------------------------------------\n// useAuthStatus\n// ---------------------------------------------------------------------------\n\n/**\n * React hook that returns the current authentication status.\n *\n * Re-renders only when the auth state changes, not on every auth event.\n * Use this for status indicators, route guards, and conditional rendering.\n *\n * Must be used within an {@link AuthProvider}.\n *\n * @returns An AuthStatus object with state, isAuthenticated, and isLoading flags\n *\n * @example\n * ```typescript\n * function AuthGuard({ children }: { children: React.ReactNode }) {\n *   const { isAuthenticated, isLoading } = useAuthStatus()\n *   if (isLoading) return <Spinner />\n *   if (!isAuthenticated) return <Navigate to=\"/login\" />\n *   return <>{children}</>\n * }\n * ```\n */\nfunction useAuthStatus(): AuthStatus {\n\tconst { state, isLoading } = useAuthContext()\n\n\treturn {\n\t\tstate,\n\t\tisAuthenticated: state === 'authenticated',\n\t\tisLoading,\n\t}\n}\n\nexport { useAuth, useCurrentUser, useAuthStatus }\nexport type { UseAuthResult, AuthStatus }\n"],"mappings":"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","names":["import_react","import_react"]}

package/dist/react.d.cts

@@ -0,0 +1,189 @@
+import * as react from 'react';
+import { ReactNode, ReactElement } from 'react';
+import { A as AuthClient, c as AuthState$1, d as AuthUser } from './auth-client-CrDNuh10.cjs';
+import '@korajs/core';
+
+/**
+ * Props for the AuthProvider component.
+ */
+interface AuthProviderProps {
+    /** The AuthClient instance to provide to child components */
+    client: AuthClient;
+    /** Child components that will have access to auth context */
+    children: ReactNode;
+    /**
+     * Optional fallback content to render while the auth client is initializing.
+     * If not provided, children are rendered with `isLoading: true` in the context.
+     */
+    fallback?: ReactNode;
+}
+/**
+ * React context provider that wraps the AuthClient for use with auth hooks.
+ *
+ * Calls `client.initialize()` on mount to restore any existing session from
+ * stored tokens. Subscribes to auth state changes and re-renders children
+ * when the state transitions.
+ *
+ * Must be placed above any component that uses {@link useAuth},
+ * {@link useCurrentUser}, or {@link useAuthStatus}.
+ *
+ * @param props - Provider props including the AuthClient instance and children
+ * @returns A React element wrapping children in the AuthContext
+ *
+ * @example
+ * ```typescript
+ * import { AuthClient } from '@korajs/auth'
+ * import { AuthProvider } from '@korajs/auth/react'
+ *
+ * const authClient = new AuthClient({ serverUrl: 'http://localhost:3001' })
+ *
+ * function App() {
+ *   return (
+ *     <AuthProvider client={authClient} fallback={<div>Loading...</div>}>
+ *       <MyApp />
+ *     </AuthProvider>
+ *   )
+ * }
+ * ```
+ */
+declare function AuthProvider({ client, children, fallback }: AuthProviderProps): ReactElement;
+
+/**
+ * Return value of the {@link useAuth} hook.
+ */
+interface UseAuthResult {
+    /** Current authenticated user, or null if not signed in */
+    user: AuthUser | null;
+    /** Whether the user is currently authenticated */
+    isAuthenticated: boolean;
+    /** Whether the auth client is still initializing (restoring session) */
+    isLoading: boolean;
+    /** Sign up a new user account */
+    signUp: (params: {
+        email: string;
+        password: string;
+        name?: string;
+    }) => Promise<void>;
+    /** Sign in with email and password */
+    signIn: (params: {
+        email: string;
+        password: string;
+    }) => Promise<void>;
+    /** Sign out the current user */
+    signOut: () => Promise<void>;
+    /** Last error message from a sign-up, sign-in, or sign-out attempt, or null */
+    error: string | null;
+}
+/**
+ * Auth status information returned by {@link useAuthStatus}.
+ */
+interface AuthStatus {
+    /** Current authentication state */
+    state: AuthState$1;
+    /** Whether the user is currently authenticated */
+    isAuthenticated: boolean;
+    /** Whether the auth client is still initializing */
+    isLoading: boolean;
+}
+/**
+ * React hook providing full authentication functionality.
+ *
+ * Returns the current user, loading state, error state, and methods for
+ * sign-up, sign-in, and sign-out. Re-renders when auth state changes.
+ *
+ * Must be used within an {@link AuthProvider}.
+ *
+ * @returns An object with user info, auth methods, and status flags
+ *
+ * @example
+ * ```typescript
+ * function LoginPage() {
+ *   const { user, isAuthenticated, isLoading, signIn, error } = useAuth()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (isAuthenticated) return <div>Welcome, {user?.name}</div>
+ *
+ *   return (
+ *     <form onSubmit={async (e) => {
+ *       e.preventDefault()
+ *       await signIn({ email: 'user@example.com', password: 'secret' })
+ *     }}>
+ *       {error && <p>{error}</p>}
+ *       <button type="submit">Sign In</button>
+ *     </form>
+ *   )
+ * }
+ * ```
+ */
+declare function useAuth(): UseAuthResult;
+/**
+ * React hook that returns the currently authenticated user, or null.
+ *
+ * A lightweight alternative to {@link useAuth} when you only need the user
+ * object and do not need auth methods or error state.
+ *
+ * Must be used within an {@link AuthProvider}.
+ *
+ * @returns The current AuthUser or null if not authenticated
+ *
+ * @example
+ * ```typescript
+ * function UserAvatar() {
+ *   const user = useCurrentUser()
+ *   if (!user) return null
+ *   return <span>{user.name ?? user.email}</span>
+ * }
+ * ```
+ */
+declare function useCurrentUser(): AuthUser | null;
+/**
+ * React hook that returns the current authentication status.
+ *
+ * Re-renders only when the auth state changes, not on every auth event.
+ * Use this for status indicators, route guards, and conditional rendering.
+ *
+ * Must be used within an {@link AuthProvider}.
+ *
+ * @returns An AuthStatus object with state, isAuthenticated, and isLoading flags
+ *
+ * @example
+ * ```typescript
+ * function AuthGuard({ children }: { children: React.ReactNode }) {
+ *   const { isAuthenticated, isLoading } = useAuthStatus()
+ *   if (isLoading) return <Spinner />
+ *   if (!isAuthenticated) return <Navigate to="/login" />
+ *   return <>{children}</>
+ * }
+ * ```
+ */
+declare function useAuthStatus(): AuthStatus;
+
+/**
+ * Possible authentication states for the client.
+ * - 'loading': Initial state while restoring tokens from storage
+ * - 'authenticated': User is signed in with a valid session
+ * - 'unauthenticated': No valid session exists
+ */
+type AuthState = 'loading' | 'authenticated' | 'unauthenticated';
+/**
+ * Shape of the value provided by the AuthContext.
+ * Includes the AuthClient instance, reactive state, and a loading flag.
+ */
+interface AuthContextValue {
+    /** The underlying AuthClient instance for direct access */
+    client: AuthClient;
+    /** Current authentication state */
+    state: AuthState;
+    /** Whether the client is still initializing (restoring session from storage) */
+    isLoading: boolean;
+}
+/**
+ * React context for Kora authentication.
+ *
+ * Provides the AuthClient and reactive auth state to child components.
+ * Must be provided by an AuthProvider higher in the component tree.
+ * Defaults to null — hooks that consume this context throw if it is missing.
+ */
+declare const AuthContext: react.Context<AuthContextValue | null>;
+
+export { AuthContext, type AuthContextValue, AuthProvider, type AuthProviderProps, type AuthStatus, type UseAuthResult, useAuth, useAuthStatus, useCurrentUser };

package/dist/react.d.ts

@@ -0,0 +1,189 @@
+import * as react from 'react';
+import { ReactNode, ReactElement } from 'react';
+import { A as AuthClient, c as AuthState$1, d as AuthUser } from './auth-client-CrDNuh10.js';
+import '@korajs/core';
+
+/**
+ * Props for the AuthProvider component.
+ */
+interface AuthProviderProps {
+    /** The AuthClient instance to provide to child components */
+    client: AuthClient;
+    /** Child components that will have access to auth context */
+    children: ReactNode;
+    /**
+     * Optional fallback content to render while the auth client is initializing.
+     * If not provided, children are rendered with `isLoading: true` in the context.
+     */
+    fallback?: ReactNode;
+}
+/**
+ * React context provider that wraps the AuthClient for use with auth hooks.
+ *
+ * Calls `client.initialize()` on mount to restore any existing session from
+ * stored tokens. Subscribes to auth state changes and re-renders children
+ * when the state transitions.
+ *
+ * Must be placed above any component that uses {@link useAuth},
+ * {@link useCurrentUser}, or {@link useAuthStatus}.
+ *
+ * @param props - Provider props including the AuthClient instance and children
+ * @returns A React element wrapping children in the AuthContext
+ *
+ * @example
+ * ```typescript
+ * import { AuthClient } from '@korajs/auth'
+ * import { AuthProvider } from '@korajs/auth/react'
+ *
+ * const authClient = new AuthClient({ serverUrl: 'http://localhost:3001' })
+ *
+ * function App() {
+ *   return (
+ *     <AuthProvider client={authClient} fallback={<div>Loading...</div>}>
+ *       <MyApp />
+ *     </AuthProvider>
+ *   )
+ * }
+ * ```
+ */
+declare function AuthProvider({ client, children, fallback }: AuthProviderProps): ReactElement;
+
+/**
+ * Return value of the {@link useAuth} hook.
+ */
+interface UseAuthResult {
+    /** Current authenticated user, or null if not signed in */
+    user: AuthUser | null;
+    /** Whether the user is currently authenticated */
+    isAuthenticated: boolean;
+    /** Whether the auth client is still initializing (restoring session) */
+    isLoading: boolean;
+    /** Sign up a new user account */
+    signUp: (params: {
+        email: string;
+        password: string;
+        name?: string;
+    }) => Promise<void>;
+    /** Sign in with email and password */
+    signIn: (params: {
+        email: string;
+        password: string;
+    }) => Promise<void>;
+    /** Sign out the current user */
+    signOut: () => Promise<void>;
+    /** Last error message from a sign-up, sign-in, or sign-out attempt, or null */
+    error: string | null;
+}
+/**
+ * Auth status information returned by {@link useAuthStatus}.
+ */
+interface AuthStatus {
+    /** Current authentication state */
+    state: AuthState$1;
+    /** Whether the user is currently authenticated */
+    isAuthenticated: boolean;
+    /** Whether the auth client is still initializing */
+    isLoading: boolean;
+}
+/**
+ * React hook providing full authentication functionality.
+ *
+ * Returns the current user, loading state, error state, and methods for
+ * sign-up, sign-in, and sign-out. Re-renders when auth state changes.
+ *
+ * Must be used within an {@link AuthProvider}.
+ *
+ * @returns An object with user info, auth methods, and status flags
+ *
+ * @example
+ * ```typescript
+ * function LoginPage() {
+ *   const { user, isAuthenticated, isLoading, signIn, error } = useAuth()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (isAuthenticated) return <div>Welcome, {user?.name}</div>
+ *
+ *   return (
+ *     <form onSubmit={async (e) => {
+ *       e.preventDefault()
+ *       await signIn({ email: 'user@example.com', password: 'secret' })
+ *     }}>
+ *       {error && <p>{error}</p>}
+ *       <button type="submit">Sign In</button>
+ *     </form>
+ *   )
+ * }
+ * ```
+ */
+declare function useAuth(): UseAuthResult;
+/**
+ * React hook that returns the currently authenticated user, or null.
+ *
+ * A lightweight alternative to {@link useAuth} when you only need the user
+ * object and do not need auth methods or error state.
+ *
+ * Must be used within an {@link AuthProvider}.
+ *
+ * @returns The current AuthUser or null if not authenticated
+ *
+ * @example
+ * ```typescript
+ * function UserAvatar() {
+ *   const user = useCurrentUser()
+ *   if (!user) return null
+ *   return <span>{user.name ?? user.email}</span>
+ * }
+ * ```
+ */
+declare function useCurrentUser(): AuthUser | null;
+/**
+ * React hook that returns the current authentication status.
+ *
+ * Re-renders only when the auth state changes, not on every auth event.
+ * Use this for status indicators, route guards, and conditional rendering.
+ *
+ * Must be used within an {@link AuthProvider}.
+ *
+ * @returns An AuthStatus object with state, isAuthenticated, and isLoading flags
+ *
+ * @example
+ * ```typescript
+ * function AuthGuard({ children }: { children: React.ReactNode }) {
+ *   const { isAuthenticated, isLoading } = useAuthStatus()
+ *   if (isLoading) return <Spinner />
+ *   if (!isAuthenticated) return <Navigate to="/login" />
+ *   return <>{children}</>
+ * }
+ * ```
+ */
+declare function useAuthStatus(): AuthStatus;
+
+/**
+ * Possible authentication states for the client.
+ * - 'loading': Initial state while restoring tokens from storage
+ * - 'authenticated': User is signed in with a valid session
+ * - 'unauthenticated': No valid session exists
+ */
+type AuthState = 'loading' | 'authenticated' | 'unauthenticated';
+/**
+ * Shape of the value provided by the AuthContext.
+ * Includes the AuthClient instance, reactive state, and a loading flag.
+ */
+interface AuthContextValue {
+    /** The underlying AuthClient instance for direct access */
+    client: AuthClient;
+    /** Current authentication state */
+    state: AuthState;
+    /** Whether the client is still initializing (restoring session from storage) */
+    isLoading: boolean;
+}
+/**
+ * React context for Kora authentication.
+ *
+ * Provides the AuthClient and reactive auth state to child components.
+ * Must be provided by an AuthProvider higher in the component tree.
+ * Defaults to null — hooks that consume this context throw if it is missing.
+ */
+declare const AuthContext: react.Context<AuthContextValue | null>;
+
+export { AuthContext, type AuthContextValue, AuthProvider, type AuthProviderProps, type AuthStatus, type UseAuthResult, useAuth, useAuthStatus, useCurrentUser };