@molecule/app-react 1.0.0

package/dist/hooks/useAuth.d.ts

@@ -0,0 +1,43 @@
+/**
+ * React hook for authentication.
+ *
+ * @module
+ */
+import type { AuthClient } from '@molecule/app-auth';
+import type { UseAuthOptions, UseAuthResult } from '../types.js';
+/**
+ * Hook to access the auth client from context.
+ *
+ * @returns The auth client from context
+ * @throws {Error} Error if used outside of AuthProvider
+ */
+export declare function useAuthClient<T = unknown>(): AuthClient<T>;
+/**
+ * Hook for authentication state and actions.
+ *
+ * @param options - Hook options
+ * @returns Auth state and action methods
+ *
+ * @example
+ * ```tsx
+ * const { user, isAuthenticated, login, logout } = useAuth()
+ *
+ * if (isAuthenticated) {
+ *   return <div>Welcome, {user.name}!</div>
+ * }
+ * ```
+ */
+export declare function useAuth<T = unknown>(options?: UseAuthOptions): UseAuthResult<T>;
+/**
+ * Hook to get just the authenticated user.
+ *
+ * @returns The authenticated user or null
+ */
+export declare function useUser<T = unknown>(): T | null;
+/**
+ * Hook to check if user is authenticated.
+ *
+ * @returns Whether the user is authenticated
+ */
+export declare function useIsAuthenticated(): boolean;
+//# sourceMappingURL=useAuth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useAuth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAA6C,MAAM,oBAAoB,CAAA;AAI/F,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,CAU1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC,CAgE/E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,IAAI,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAG5C"}

package/dist/hooks/useAuth.js

@@ -0,0 +1,106 @@
+/**
+ * React hook for authentication.
+ *
+ * @module
+ */
+import { useCallback, useContext, useEffect, useRef, useSyncExternalStore } from 'react';
+import { t } from '@molecule/app-i18n';
+import { AuthContext } from '../contexts.js';
+/**
+ * Hook to access the auth client from context.
+ *
+ * @returns The auth client from context
+ * @throws {Error} Error if used outside of AuthProvider
+ */
+export function useAuthClient() {
+    const client = useContext(AuthContext);
+    if (!client) {
+        throw new Error(t('react.error.useAuthOutsideProvider', undefined, {
+            defaultValue: 'useAuthClient must be used within an AuthProvider',
+        }));
+    }
+    return client;
+}
+/**
+ * Hook for authentication state and actions.
+ *
+ * @param options - Hook options
+ * @returns Auth state and action methods
+ *
+ * @example
+ * ```tsx
+ * const { user, isAuthenticated, login, logout } = useAuth()
+ *
+ * if (isAuthenticated) {
+ *   return <div>Welcome, {user.name}!</div>
+ * }
+ * ```
+ */
+export function useAuth(options) {
+    const client = useAuthClient();
+    const { autoRefresh = false } = options ?? {};
+    // Subscribe to auth state changes with cached snapshot
+    const cachedStateRef = useRef(null);
+    const getSnapshot = useCallback(() => {
+        const next = client.getState();
+        const prev = cachedStateRef.current;
+        if (prev !== null &&
+            prev.initialized === next.initialized &&
+            prev.authenticated === next.authenticated &&
+            prev.user === next.user &&
+            prev.loading === next.loading &&
+            prev.error === next.error) {
+            return prev;
+        }
+        cachedStateRef.current = next;
+        return next;
+    }, [client]);
+    const subscribe = useCallback((onStateChange) => {
+        return client.onAuthChange(() => onStateChange());
+    }, [client]);
+    const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    // Auto-refresh on mount if requested
+    useEffect(() => {
+        if (autoRefresh && !state.authenticated && !state.loading) {
+            client.refresh().catch(() => {
+                // Silently fail - user is just not authenticated
+            });
+        }
+    }, [autoRefresh, client, state.authenticated, state.loading]);
+    // Memoized action wrappers
+    const login = useCallback((credentials) => client.login(credentials), [client]);
+    const logout = useCallback(() => client.logout(), [client]);
+    const register = useCallback((data) => client.register(data), [client]);
+    const refresh = useCallback(() => client.refresh(), [client]);
+    const setUser = useCallback((user) => client.setUser(user), [client]);
+    return {
+        state,
+        login,
+        logout,
+        register,
+        refresh,
+        setUser,
+        isAuthenticated: state.authenticated,
+        isLoading: state.loading,
+        user: state.user,
+    };
+}
+/**
+ * Hook to get just the authenticated user.
+ *
+ * @returns The authenticated user or null
+ */
+export function useUser() {
+    const { user } = useAuth();
+    return user;
+}
+/**
+ * Hook to check if user is authenticated.
+ *
+ * @returns Whether the user is authenticated
+ */
+export function useIsAuthenticated() {
+    const { isAuthenticated } = useAuth();
+    return isAuthenticated;
+}
+//# sourceMappingURL=useAuth.js.map

package/dist/hooks/useAuth.js.map

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

package/dist/hooks/useCapacitorApp.d.ts

@@ -0,0 +1,35 @@
+/**
+ * React hook for Capacitor app initialization.
+ *
+ * @module
+ */
+import { type CapacitorAppOptions, type CapacitorAppState } from '@molecule/app-platform';
+/**
+ * Hook return type.
+ */
+export type UseCapacitorAppResult = CapacitorAppState & {
+    initialize: () => Promise<void>;
+};
+/**
+ * Hook for Capacitor app initialization and state management.
+ *
+ * Creates a `CapacitorApp` coordinator on mount, subscribes to state changes,
+ * and auto-initializes. Cleans up listeners on unmount via `destroy()`.
+ *
+ * @param options - Capacitor app configuration options
+ * @returns Current app state and an `initialize` function for manual re-initialization
+ *
+ * @example
+ * ```tsx
+ * const { ready, deviceReady, pushReady, error } = useCapacitorApp({
+ *   pushNotifications: true,
+ *   deepLinks: true,
+ *   onDeepLink: (url) => navigate(url),
+ * })
+ *
+ * if (!ready) return <SplashScreen />
+ * if (error) return <ErrorScreen error={error} />
+ * ```
+ */
+export declare function useCapacitorApp(options?: CapacitorAppOptions): UseCapacitorAppResult;
+//# sourceMappingURL=useCapacitorApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCapacitorApp.d.ts","sourceRoot":"","sources":["../../src/hooks/useCapacitorApp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAA;AAE/B;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,qBAAqB,CAuCxF"}

package/dist/hooks/useCapacitorApp.js

@@ -0,0 +1,61 @@
+/**
+ * React hook for Capacitor app initialization.
+ *
+ * @module
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { createCapacitorApp, } from '@molecule/app-platform';
+/**
+ * Hook for Capacitor app initialization and state management.
+ *
+ * Creates a `CapacitorApp` coordinator on mount, subscribes to state changes,
+ * and auto-initializes. Cleans up listeners on unmount via `destroy()`.
+ *
+ * @param options - Capacitor app configuration options
+ * @returns Current app state and an `initialize` function for manual re-initialization
+ *
+ * @example
+ * ```tsx
+ * const { ready, deviceReady, pushReady, error } = useCapacitorApp({
+ *   pushNotifications: true,
+ *   deepLinks: true,
+ *   onDeepLink: (url) => navigate(url),
+ * })
+ *
+ * if (!ready) return <SplashScreen />
+ * if (error) return <ErrorScreen error={error} />
+ * ```
+ */
+export function useCapacitorApp(options = {}) {
+    const appRef = useRef(null);
+    // Lazy-init the app instance so it's only created once
+    if (!appRef.current) {
+        appRef.current = createCapacitorApp(options);
+    }
+    const [state, setState] = useState(() => appRef.current.getState());
+    const initialize = useCallback(async () => {
+        if (appRef.current) {
+            await appRef.current.initialize();
+        }
+    }, []);
+    useEffect(() => {
+        const app = appRef.current;
+        // Subscribe to state changes
+        const unsubscribe = app.subscribe((newState) => {
+            setState(newState);
+        });
+        // Auto-initialize on mount
+        app.initialize().catch(() => {
+            // Error is captured in state via the coordinator
+        });
+        return () => {
+            unsubscribe();
+            app.destroy();
+        };
+    }, []);
+    return {
+        ...state,
+        initialize,
+    };
+}
+//# sourceMappingURL=useCapacitorApp.js.map

package/dist/hooks/useCapacitorApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCapacitorApp.js","sourceRoot":"","sources":["../../src/hooks/useCapacitorApp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhE,OAAO,EAIL,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAS/B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,UAA+B,EAAE;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAA;IAEhD,uDAAuD;IACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAoB,GAAG,EAAE,CAAC,MAAM,CAAC,OAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IAEvF,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,GAAG,GAAG,MAAM,CAAC,OAAQ,CAAA;QAE3B,6BAA6B;QAC7B,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7C,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;QAEF,2BAA2B;QAC3B,GAAG,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YAC1B,iDAAiD;QACnD,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAA;YACb,GAAG,CAAC,OAAO,EAAE,CAAA;QACf,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,GAAG,KAAK;QACR,UAAU;KACX,CAAA;AACH,CAAC"}

package/dist/hooks/useChangePassword.d.ts

@@ -0,0 +1,34 @@
+/**
+ * React hook for changing password with async state tracking.
+ *
+ * @module
+ */
+import { type UsePromiseState } from './usePromise.js';
+/**
+ * Return type for useChangePassword hook.
+ */
+export interface UseChangePasswordReturn {
+    status: UsePromiseState<void>['status'];
+    error: UsePromiseState<void>['error'];
+    changePassword: (oldPassword: string, newPassword: string) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Hook for changing password with async state tracking.
+ *
+ * @returns Change password state and action
+ *
+ * @example
+ * ```tsx
+ * const { status, error, changePassword } = useChangePassword()
+ *
+ * <button
+ *   onClick={() => changePassword(oldPassword, newPassword)}
+ *   disabled={status === 'pending'}
+ * >
+ *   {status === 'pending' ? 'Changing...' : 'Change Password'}
+ * </button>
+ * ```
+ */
+export declare function useChangePassword(): UseChangePasswordReturn;
+//# sourceMappingURL=useChangePassword.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChangePassword.d.ts","sourceRoot":"","sources":["../../src/hooks/useChangePassword.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;IACvC,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;IACrC,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3E,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAgB3D"}

package/dist/hooks/useChangePassword.js

@@ -0,0 +1,37 @@
+/**
+ * React hook for changing password with async state tracking.
+ *
+ * @module
+ */
+import { useCallback } from 'react';
+import { useAuthClient } from './useAuth.js';
+import { usePromise } from './usePromise.js';
+/**
+ * Hook for changing password with async state tracking.
+ *
+ * @returns Change password state and action
+ *
+ * @example
+ * ```tsx
+ * const { status, error, changePassword } = useChangePassword()
+ *
+ * <button
+ *   onClick={() => changePassword(oldPassword, newPassword)}
+ *   disabled={status === 'pending'}
+ * >
+ *   {status === 'pending' ? 'Changing...' : 'Change Password'}
+ * </button>
+ * ```
+ */
+export function useChangePassword() {
+    const client = useAuthClient();
+    const changeFn = useCallback((oldPassword, newPassword) => client.changePassword(oldPassword, newPassword), [client]);
+    const [state, call] = usePromise(changeFn);
+    return {
+        status: state.status,
+        error: state.error,
+        changePassword: call,
+        reset: state.reset,
+    };
+}
+//# sourceMappingURL=useChangePassword.js.map

package/dist/hooks/useChangePassword.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChangePassword.js","sourceRoot":"","sources":["../../src/hooks/useChangePassword.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAA;AAYlE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAE9B,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,WAAmB,EAAE,WAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,EAC7F,CAAC,MAAM,CAAC,CACT,CAAA;IAED,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAE1C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAA;AACH,CAAC"}

package/dist/hooks/useChat.d.ts

@@ -0,0 +1,30 @@
+/**
+ * React hook for AI chat provider.
+ *
+ * @module
+ */
+import type { ChatProvider } from '@molecule/app-ai-chat';
+import type { UseChatOptions, UseChatResult } from '../types.js';
+/**
+ * Test-only: clear all conversation stores. The store is module-level (it must
+ * outlive component mounts), so it persists across test cases — reset it in a
+ * `beforeEach` the same way tests clear `sessionStorage`.
+ */
+export declare function resetChatStoresForTests(): void;
+/**
+ * Access the chat provider from context.
+ * @returns The ChatProvider instance from the nearest ChatContext.
+ * @throws {Error} If called outside a ChatProvider.
+ */
+export declare function useChatProvider(): ChatProvider;
+/**
+ * Hook for AI chat with streaming support.
+ *
+ * Manages message state, sends messages to the backend, and handles
+ * SSE streaming responses.
+ *
+ * @param options - Chat configuration including endpoint URL, project ID, and whether to load history on mount.
+ * @returns Chat state and controls: messages, isLoading, error, sendMessage, abort, and clearHistory.
+ */
+export declare function useChat(options: UseChatOptions): UseChatResult;
+//# sourceMappingURL=useChat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useChat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EAIV,YAAY,EAGb,MAAM,uBAAuB,CAAA;AAK9B,OAAO,KAAK,EAAsB,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAiUpF;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAK9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAU9C;AA6CD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAg4C9D"}