@molecule/app-react 1.0.0

package/dist/hooks/useHttp.d.ts

@@ -0,0 +1,103 @@
+/**
+ * React hook for HTTP requests.
+ *
+ * @module
+ */
+import type { HttpClient, RequestConfig } from '@molecule/app-http';
+/**
+ * Hook to access the HTTP client from context.
+ *
+ * @returns The HTTP client from context
+ * @throws {Error} Error if used outside of HttpProvider
+ */
+export declare function useHttpClient(): HttpClient;
+/**
+ * State for async HTTP operations.
+ */
+export interface UseHttpState<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Result of useHttp hook.
+ */
+export interface UseHttpResult<T> extends UseHttpState<T> {
+    execute: () => Promise<T | null>;
+    reset: () => void;
+}
+/**
+ * Options for useHttp hook.
+ */
+export interface UseHttpOptions<T> extends RequestConfig {
+    /**
+     * Whether to execute the request immediately on mount.
+     */
+    immediate?: boolean;
+    /**
+     * Callback when request succeeds.
+     */
+    onSuccess?: (data: T) => void;
+    /**
+     * Callback when request fails.
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Hook for making HTTP requests with state management.
+ *
+ * @param method - HTTP method
+ * @param url - Request URL
+ * @param options - Request options
+ * @returns Request state and execute function
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, error, execute } = useHttp<User[]>('GET', '/api/users')
+ *
+ * useEffect(() => {
+ *   execute()
+ * }, [])
+ *
+ * if (loading) return <Spinner />
+ * if (error) return <Error message={error.message} />
+ * return <UserList users={data} />
+ * ```
+ */
+export declare function useHttp<T>(method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', url: string, options?: UseHttpOptions<T>): UseHttpResult<T>;
+/**
+ * Hook for GET requests.
+ * @param url - Request URL to fetch from.
+ * @param options - HTTP request options including callbacks and request config.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export declare function useGet<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>;
+/**
+ * Hook for POST requests.
+ * @param url - Request URL to post to.
+ * @param options - HTTP request options including body data and callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export declare function usePost<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>;
+/**
+ * Hook for PUT requests.
+ * @param url - Request URL to send the PUT request to.
+ * @param options - HTTP request options including body data and callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export declare function usePut<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>;
+/**
+ * Hook for PATCH requests.
+ * @param url - Request URL to send the PATCH request to.
+ * @param options - HTTP request options including partial body data and callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export declare function usePatch<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>;
+/**
+ * Hook for DELETE requests.
+ * @param url - Request URL of the resource to delete.
+ * @param options - HTTP request options including callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export declare function useDelete<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>;
+//# sourceMappingURL=useHttp.d.ts.map

package/dist/hooks/useHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHttp.d.ts","sourceRoot":"","sources":["../../src/hooks/useHttp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAgB,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAKjF;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAU1C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAChC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,aAAa;IACtD;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,EACnD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAqFlB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEtF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEvF"}

package/dist/hooks/useHttp.js

@@ -0,0 +1,161 @@
+/**
+ * React hook for HTTP requests.
+ *
+ * @module
+ */
+import { useCallback, useContext, useEffect, useRef, useState } from 'react';
+import { t } from '@molecule/app-i18n';
+import { HttpContext } from '../contexts.js';
+/**
+ * Hook to access the HTTP client from context.
+ *
+ * @returns The HTTP client from context
+ * @throws {Error} Error if used outside of HttpProvider
+ */
+export function useHttpClient() {
+    const client = useContext(HttpContext);
+    if (!client) {
+        throw new Error(t('react.error.useHttpOutsideProvider', undefined, {
+            defaultValue: 'useHttpClient must be used within an HttpProvider',
+        }));
+    }
+    return client;
+}
+/**
+ * Hook for making HTTP requests with state management.
+ *
+ * @param method - HTTP method
+ * @param url - Request URL
+ * @param options - Request options
+ * @returns Request state and execute function
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, error, execute } = useHttp<User[]>('GET', '/api/users')
+ *
+ * useEffect(() => {
+ *   execute()
+ * }, [])
+ *
+ * if (loading) return <Spinner />
+ * if (error) return <Error message={error.message} />
+ * return <UserList users={data} />
+ * ```
+ */
+export function useHttp(method, url, options) {
+    const client = useHttpClient();
+    const { immediate = false, onSuccess, onError, ...requestConfig } = options ?? {};
+    const [state, setState] = useState({
+        data: null,
+        loading: immediate,
+        error: null,
+    });
+    // Track mounted state to avoid state updates after unmount
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const execute = useCallback(async () => {
+        if (!mountedRef.current)
+            return null;
+        setState((prev) => ({ ...prev, loading: true, error: null }));
+        try {
+            let response;
+            switch (method) {
+                case 'GET':
+                    response = await client.get(url, requestConfig);
+                    break;
+                case 'POST':
+                    response = await client.post(url, requestConfig.data, requestConfig);
+                    break;
+                case 'PUT':
+                    response = await client.put(url, requestConfig.data, requestConfig);
+                    break;
+                case 'PATCH':
+                    response = await client.patch(url, requestConfig.data, requestConfig);
+                    break;
+                case 'DELETE':
+                    response = await client.delete(url, requestConfig);
+                    break;
+                default:
+                    throw new Error(t('react.error.unsupportedMethod', { method }, { defaultValue: `Unsupported method: ${method}` }));
+            }
+            if (mountedRef.current) {
+                setState({ data: response.data, loading: false, error: null });
+                onSuccess?.(response.data);
+            }
+            return response.data;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            if (mountedRef.current) {
+                setState({ data: null, loading: false, error: err });
+                onError?.(err);
+            }
+            return null;
+        }
+    }, [client, method, url, requestConfig, onSuccess, onError]);
+    const reset = useCallback(() => {
+        setState({ data: null, loading: false, error: null });
+    }, []);
+    // Execute immediately if requested
+    useEffect(() => {
+        if (immediate) {
+            execute();
+        }
+    }, []);
+    return {
+        ...state,
+        execute,
+        reset,
+    };
+}
+/**
+ * Hook for GET requests.
+ * @param url - Request URL to fetch from.
+ * @param options - HTTP request options including callbacks and request config.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export function useGet(url, options) {
+    return useHttp('GET', url, options);
+}
+/**
+ * Hook for POST requests.
+ * @param url - Request URL to post to.
+ * @param options - HTTP request options including body data and callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export function usePost(url, options) {
+    return useHttp('POST', url, options);
+}
+/**
+ * Hook for PUT requests.
+ * @param url - Request URL to send the PUT request to.
+ * @param options - HTTP request options including body data and callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export function usePut(url, options) {
+    return useHttp('PUT', url, options);
+}
+/**
+ * Hook for PATCH requests.
+ * @param url - Request URL to send the PATCH request to.
+ * @param options - HTTP request options including partial body data and callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export function usePatch(url, options) {
+    return useHttp('PATCH', url, options);
+}
+/**
+ * Hook for DELETE requests.
+ * @param url - Request URL of the resource to delete.
+ * @param options - HTTP request options including callbacks.
+ * @returns Request state (data, loading, error) and controls (execute, reset).
+ */
+export function useDelete(url, options) {
+    return useHttp('DELETE', url, options);
+}
+//# sourceMappingURL=useHttp.js.map

package/dist/hooks/useHttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHttp.js","sourceRoot":"","sources":["../../src/hooks/useHttp.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useLogger.d.ts

@@ -0,0 +1,68 @@
+/**
+ * React hook for logging.
+ *
+ * @module
+ */
+import type { Logger, LoggerConfig, LoggerProvider } from '@molecule/app-logger';
+/**
+ * Hook to access the logger provider from context.
+ *
+ * @returns The logger provider from context
+ * @throws {Error} Error if used outside of LoggerProvider
+ */
+export declare function useLoggerProvider(): LoggerProvider;
+/**
+ * Hook to get a logger instance.
+ *
+ * @param name - Logger name (usually component or module name)
+ * @param config - Optional logger configuration
+ * @returns Logger instance
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const logger = useLogger('UserProfile')
+ *
+ *   useEffect(() => {
+ *     logger.info('Component mounted')
+ *     return () => logger.info('Component unmounting')
+ *   }, [])
+ *
+ *   const handleError = (error: Error) => {
+ *     logger.error('Failed to load user', error)
+ *   }
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export declare function useLogger(name: string, config?: Partial<LoggerConfig>): Logger;
+/**
+ * Hook to get the root logger.
+ *
+ * @returns Root logger instance
+ */
+export declare function useRootLogger(): Logger;
+/**
+ * Hook to create a child logger with additional context.
+ *
+ * @param parentName - Parent logger name
+ * @param context - Additional context to include in logs
+ * @returns Child logger instance
+ *
+ * @example
+ * ```tsx
+ * function UserList() {
+ *   const logger = useChildLogger('UserList', { component: 'UserList' })
+ *
+ *   const handleUserClick = (userId: string) => {
+ *     // Logs will include { component: 'UserList', userId }
+ *     logger.withContext({ userId }).info('User clicked')
+ *   }
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export declare function useChildLogger(parentName: string, context: Record<string, unknown>): Logger;
+//# sourceMappingURL=useLogger.d.ts.map

package/dist/hooks/useLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.d.ts","sourceRoot":"","sources":["../../src/hooks/useLogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIhF;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAUlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAS9E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAO3F"}

package/dist/hooks/useLogger.js

@@ -0,0 +1,95 @@
+/**
+ * React hook for logging.
+ *
+ * @module
+ */
+import { useContext, useMemo } from 'react';
+import { t } from '@molecule/app-i18n';
+import { LoggerContext } from '../contexts.js';
+/**
+ * Hook to access the logger provider from context.
+ *
+ * @returns The logger provider from context
+ * @throws {Error} Error if used outside of LoggerProvider
+ */
+export function useLoggerProvider() {
+    const provider = useContext(LoggerContext);
+    if (!provider) {
+        throw new Error(t('react.error.useLoggerOutsideProvider', undefined, {
+            defaultValue: 'useLoggerProvider must be used within a LoggerProvider',
+        }));
+    }
+    return provider;
+}
+/**
+ * Hook to get a logger instance.
+ *
+ * @param name - Logger name (usually component or module name)
+ * @param config - Optional logger configuration
+ * @returns Logger instance
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const logger = useLogger('UserProfile')
+ *
+ *   useEffect(() => {
+ *     logger.info('Component mounted')
+ *     return () => logger.info('Component unmounting')
+ *   }, [])
+ *
+ *   const handleError = (error: Error) => {
+ *     logger.error('Failed to load user', error)
+ *   }
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export function useLogger(name, config) {
+    const provider = useLoggerProvider();
+    return useMemo(() => {
+        if (config) {
+            return provider.createLogger({ name, ...config });
+        }
+        return provider.getLogger(name);
+    }, [provider, name, config]);
+}
+/**
+ * Hook to get the root logger.
+ *
+ * @returns Root logger instance
+ */
+export function useRootLogger() {
+    const provider = useLoggerProvider();
+    return useMemo(() => provider.getLogger(), [provider]);
+}
+/**
+ * Hook to create a child logger with additional context.
+ *
+ * @param parentName - Parent logger name
+ * @param context - Additional context to include in logs
+ * @returns Child logger instance
+ *
+ * @example
+ * ```tsx
+ * function UserList() {
+ *   const logger = useChildLogger('UserList', { component: 'UserList' })
+ *
+ *   const handleUserClick = (userId: string) => {
+ *     // Logs will include { component: 'UserList', userId }
+ *     logger.withContext({ userId }).info('User clicked')
+ *   }
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export function useChildLogger(parentName, context) {
+    const provider = useLoggerProvider();
+    return useMemo(() => {
+        const parent = provider.getLogger(parentName);
+        return parent.withContext(context);
+    }, [provider, parentName, context]);
+}
+//# sourceMappingURL=useLogger.js.map

package/dist/hooks/useLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.js","sourceRoot":"","sources":["../../src/hooks/useLogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,CAAC,CAAC,sCAAsC,EAAE,SAAS,EAAE;YACnD,YAAY,EAAE,wDAAwD;SACvE,CAAC,CACH,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAA8B;IACpE,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IAEpC,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QACnD,CAAC;QACD,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,OAAgC;IACjF,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IAEpC,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QAC7C,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;AACrC,CAAC"}

package/dist/hooks/useLogin.d.ts

@@ -0,0 +1,35 @@
+/**
+ * React hook for login with async state tracking.
+ *
+ * @module
+ */
+import type { AuthResult, LoginCredentials } from '@molecule/app-auth';
+import { type UsePromiseState } from './usePromise.js';
+/**
+ * Return type for useLogin hook.
+ */
+export interface UseLoginReturn<T = unknown> {
+    status: UsePromiseState<AuthResult<T>>['status'];
+    value: UsePromiseState<AuthResult<T>>['value'];
+    error: UsePromiseState<AuthResult<T>>['error'];
+    login: (credentials: LoginCredentials) => Promise<AuthResult<T>>;
+    reset: () => void;
+}
+/**
+ * Hook for login with async state tracking.
+ *
+ * @returns Login state and action
+ *
+ * @example
+ * ```tsx
+ * const { status, error, login } = useLogin()
+ *
+ * return (
+ *   <button onClick={() => login({ email, password })} disabled={status === 'pending'}>
+ *     {status === 'pending' ? 'Logging in...' : 'Login'}
+ *   </button>
+ * )
+ * ```
+ */
+export declare function useLogin<T = unknown>(): UseLoginReturn<T>;
+//# sourceMappingURL=useLogin.d.ts.map

package/dist/hooks/useLogin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogin.d.ts","sourceRoot":"","sources":["../../src/hooks/useLogin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGtE,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IAChD,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC9C,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC9C,KAAK,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAChE,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,CAiBzD"}

package/dist/hooks/useLogin.js

@@ -0,0 +1,37 @@
+/**
+ * React hook for login with async state tracking.
+ *
+ * @module
+ */
+import { useCallback } from 'react';
+import { useAuthClient } from './useAuth.js';
+import { usePromise } from './usePromise.js';
+/**
+ * Hook for login with async state tracking.
+ *
+ * @returns Login state and action
+ *
+ * @example
+ * ```tsx
+ * const { status, error, login } = useLogin()
+ *
+ * return (
+ *   <button onClick={() => login({ email, password })} disabled={status === 'pending'}>
+ *     {status === 'pending' ? 'Logging in...' : 'Login'}
+ *   </button>
+ * )
+ * ```
+ */
+export function useLogin() {
+    const client = useAuthClient();
+    const loginFn = useCallback((credentials) => client.login(credentials), [client]);
+    const [state, call] = usePromise(loginFn);
+    return {
+        status: state.status,
+        value: state.value,
+        error: state.error,
+        login: call,
+        reset: state.reset,
+    };
+}
+//# sourceMappingURL=useLogin.js.map

package/dist/hooks/useLogin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogin.js","sourceRoot":"","sources":["../../src/hooks/useLogin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAInC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAA;AAalE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,MAAM,GAAG,aAAa,EAAK,CAAA;IAEjC,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,WAA6B,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAC5D,CAAC,MAAM,CAAC,CACT,CAAA;IAED,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IAEzC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAA;AACH,CAAC"}

package/dist/hooks/useOAuth.d.ts

@@ -0,0 +1,83 @@
+/**
+ * React hook for OAuth authentication.
+ *
+ * Supports two initiation modes that share ONE callback path:
+ *   - {@link UseOAuthReturn.redirect} — full-page redirect (the default; unchanged).
+ *   - {@link UseOAuthReturn.loginViaPopup} — opens the provider in a popup so the
+ *     opener page never navigates (used by in-app auth modals). On completion the
+ *     popup relays the result to the opener via a STRICTLY-validated `postMessage`
+ *     and closes itself; the opener establishes the session in place.
+ *
+ * Security model for the popup relay (see inline notes at each gate):
+ *   - The popup posts ONLY to its own origin (`targetOrigin = location.origin`),
+ *     never `'*'`, so the bearer token can never be delivered to another origin.
+ *   - The opener accepts a result ONLY when ALL hold: `event.origin === location.origin`,
+ *     `event.source === thePopupWindowWeOpened`, and `event.data.type` matches our
+ *     private message type. Anything else is ignored — a forged cross-origin (or
+ *     wrong-window) message cannot inject a session.
+ *   - The popup-relay path is gated on `window.name === OAUTH_POPUP_WINDOW_NAME`
+ *     AND `window.opener`, so an ordinary full-page callback is completely
+ *     unaffected (it still establishes the session inline as before).
+ *   - The opener tears down its listener + timers on result, on user-close, and on
+ *     a hard timeout, so no stale handler lingers.
+ *
+ * @module
+ */
+/**
+ * Return type for useOAuth hook.
+ */
+export interface UseOAuthReturn {
+    providers: string[];
+    getOAuthUrl: (provider: string) => string;
+    /** Full-page redirect to the provider (default). The opener page navigates away. */
+    redirect: (provider: string) => void;
+    /**
+     * Open the provider in a popup so the opener page does NOT navigate. On success
+     * the session is established in the opener in place and `config.onSuccess` fires;
+     * on failure `config.onError` fires. Falls back to a full-page {@link redirect}
+     * when the popup is blocked.
+     */
+    loginViaPopup: (provider: string) => void;
+}
+/**
+ * Hook for OAuth authentication.
+ *
+ * Reads OAuth configuration from the provided config and provides
+ * helpers to build OAuth URLs and start a login (full-page or popup).
+ * Automatically handles OAuth callbacks by detecting `code` and `state`
+ * URL parameters and exchanging them for a session — and, when the callback is
+ * running inside a popup we opened, relaying the result to the opener instead.
+ *
+ * @param config - Optional OAuth configuration override.
+ * @param config.baseURL - Base URL for the API server (e.g. "https://api.example.com").
+ * @param config.oauthProviders - List of supported OAuth provider names (e.g. ["google", "github"]).
+ * @param config.oauthEndpoint - Path prefix for OAuth routes (defaults to "/oauth").
+ * @param config.loginEndpoint - Path for the OAuth login POST endpoint (defaults to "/users/log-in/oauth").
+ * @param config.onSuccess - Callback after successful OAuth login.
+ * @param config.onError - Callback on OAuth login failure.
+ *
+ * @example
+ * ```tsx
+ * const { providers, redirect, loginViaPopup } = useOAuth()
+ *
+ * return (
+ *   <div>
+ *     {providers.map(provider => (
+ *       <button key={provider} onClick={() => loginViaPopup(provider)}>
+ *         Login with {provider}
+ *       </button>
+ *     ))}
+ *   </div>
+ * )
+ * ```
+ * @returns OAuth helpers: providers, getOAuthUrl, redirect, and loginViaPopup.
+ */
+export declare function useOAuth(config?: {
+    baseURL?: string;
+    oauthProviders?: string[];
+    oauthEndpoint?: string;
+    loginEndpoint?: string;
+    onSuccess?: () => void;
+    onError?: (error: string) => void;
+}): UseOAuthReturn;
+//# sourceMappingURL=useOAuth.d.ts.map

package/dist/hooks/useOAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useOAuth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAiCH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IACzC,oFAAoF;IACpF,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC;;;;;OAKG;IACH,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC,GAAG,cAAc,CA2SjB"}