@better-auth-ui/react 1.6.0

package/dist/hooks/auth/use-sign-up-email.js

@@ -0,0 +1,24 @@
+import { useAuth, useAuthMutation, useSession } from "@better-auth-ui/react";
+export { useAuthMutation } from "./use-auth-mutation";
+/**
+ * Hook that creates a mutation for email/password sign-up.
+ *
+ * The mutation sends an email/password sign-up request and
+ * refetches the session on success.
+ *
+ * @returns The `useMutation` result.
+ */
+export function useSignUpEmail(options) {
+    const { authClient } = useAuth();
+    const { refetch } = useSession({ refetchOnMount: false });
+    return useAuthMutation({
+        authFn: authClient.signUp.email,
+        options: {
+            ...options,
+            onSuccess: async (...args) => {
+                await refetch();
+                await options?.onSuccess?.(...args);
+            }
+        }
+    });
+}

package/dist/hooks/auth/use-user.d.ts

@@ -0,0 +1,513 @@
+import type { AuthClient } from "@better-auth-ui/react";
+import type { UseAuthQueryOptions } from "./use-auth-query";
+/**
+ * Retrieve the current authenticated user.
+ *
+ * @param options - Options to merge into the React Query configuration for the session query.
+ * @returns The React Query result with `data` containing the user object from the session.
+ */
+export declare function useUser(options?: Partial<UseAuthQueryOptions<AuthClient["getSession"]>>): {
+    error: import("better-auth/react").BetterFetchError;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: import("better-auth/react").BetterFetchError | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null, import("better-auth/react").BetterFetchError>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null>;
+    data: import("better-auth").StripEmptyObjects<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+    } & {} & {
+        username?: string | null | undefined;
+        displayUsername?: string | null | undefined;
+    }> | undefined;
+} | {
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: import("better-auth/react").BetterFetchError | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null, import("better-auth/react").BetterFetchError>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null>;
+    data: import("better-auth").StripEmptyObjects<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+    } & {} & {
+        username?: string | null | undefined;
+        displayUsername?: string | null | undefined;
+    }> | undefined;
+} | {
+    error: import("better-auth/react").BetterFetchError;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: import("better-auth/react").BetterFetchError | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null, import("better-auth/react").BetterFetchError>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null>;
+    data: import("better-auth").StripEmptyObjects<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+    } & {} & {
+        username?: string | null | undefined;
+        displayUsername?: string | null | undefined;
+    }> | undefined;
+} | {
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: import("better-auth/react").BetterFetchError | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null, import("better-auth/react").BetterFetchError>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null>;
+    data: import("better-auth").StripEmptyObjects<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+    } & {} & {
+        username?: string | null | undefined;
+        displayUsername?: string | null | undefined;
+    }> | undefined;
+} | {
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: import("better-auth/react").BetterFetchError | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null, import("better-auth/react").BetterFetchError>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null>;
+    data: import("better-auth").StripEmptyObjects<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+    } & {} & {
+        username?: string | null | undefined;
+        displayUsername?: string | null | undefined;
+    }> | undefined;
+} | {
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: import("better-auth/react").BetterFetchError | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null, import("better-auth/react").BetterFetchError>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        user: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        } & {} & {
+            username?: string | null | undefined;
+            displayUsername?: string | null | undefined;
+        }>;
+        session: import("better-auth").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null>;
+    data: import("better-auth").StripEmptyObjects<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+    } & {} & {
+        username?: string | null | undefined;
+        displayUsername?: string | null | undefined;
+    }> | undefined;
+};

package/dist/hooks/auth/use-user.js

@@ -0,0 +1,14 @@
+import { useSession } from "./use-session";
+/**
+ * Retrieve the current authenticated user.
+ *
+ * @param options - Options to merge into the React Query configuration for the session query.
+ * @returns The React Query result with `data` containing the user object from the session.
+ */
+export function useUser(options) {
+    const { data, ...rest } = useSession(options);
+    return {
+        data: data?.user,
+        ...rest
+    };
+}

package/dist/hooks/settings/use-account-info.d.ts

@@ -0,0 +1,17 @@
+import { type AuthClient } from "@better-auth-ui/react";
+import { type UseAuthQueryOptions } from "../auth/use-auth-query";
+/**
+ * Retrieve provider-specific account info for a given account ID.
+ *
+ * Uses the `accountInfo` API endpoint to fetch detailed information
+ * from the social provider. The provider is automatically detected
+ * from the account ID.
+ *
+ * @param accountId - The provider-given account ID to fetch info for
+ * @param options - Optional react-query options forwarded to `useQuery`
+ * @returns The react-query result containing account info data, loading state, and error state
+ */
+export declare function useAccountInfo(accountId?: string, options?: Partial<UseAuthQueryOptions<AuthClient["accountInfo"]>>): import("@tanstack/react-query").UseQueryResult<{
+    user: import("better-auth").OAuth2UserInfo;
+    data: Record<string, any>;
+} | null, import("better-auth/react").BetterFetchError>;

package/dist/hooks/settings/use-account-info.js

@@ -0,0 +1,25 @@
+import { useAuth } from "@better-auth-ui/react";
+import { useAuthQuery } from "../auth/use-auth-query";
+/**
+ * Retrieve provider-specific account info for a given account ID.
+ *
+ * Uses the `accountInfo` API endpoint to fetch detailed information
+ * from the social provider. The provider is automatically detected
+ * from the account ID.
+ *
+ * @param accountId - The provider-given account ID to fetch info for
+ * @param options - Optional react-query options forwarded to `useQuery`
+ * @returns The react-query result containing account info data, loading state, and error state
+ */
+export function useAccountInfo(accountId, options) {
+    const { authClient } = useAuth();
+    return useAuthQuery({
+        authFn: authClient.accountInfo,
+        params: { query: { accountId } },
+        options: {
+            queryKey: ["auth", "accountInfo", accountId],
+            enabled: !!accountId,
+            ...options
+        }
+    });
+}

package/dist/hooks/settings/use-change-email.d.ts

@@ -0,0 +1,24 @@
+import { type AuthClient } from "@better-auth-ui/react";
+import type { UseAuthMutationOptions } from "../auth/use-auth-mutation";
+/**
+ * Hook that creates a mutation for changing the current user's email address.
+ *
+ * The mutation sends an email-change request and shows success or error toasts.
+ * On success the callback URL is set to the account settings view.
+ *
+ * @returns The `useMutation` result.
+ */
+export declare function useChangeEmail(options?: UseAuthMutationOptions<AuthClient["changeEmail"]>): import("../auth/use-auth-mutation").UseAuthMutationResult<(<FetchOptions extends import("better-auth").ClientFetchOption<Partial<{
+    newEmail: string;
+    callbackURL?: string | undefined;
+}> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import("better-auth").Prettify<{
+    newEmail: string;
+    callbackURL?: string | undefined;
+} & {
+    fetchOptions?: FetchOptions | undefined;
+}>, data_1?: FetchOptions | undefined) => Promise<import("better-auth/react").BetterFetchResponse<{
+    status: boolean;
+}, {
+    code?: string | undefined;
+    message?: string | undefined;
+}, FetchOptions["throw"] extends true ? true : false>>)>;

package/dist/hooks/settings/use-change-email.js

@@ -0,0 +1,23 @@
+import { useAuth, useAuthMutation, useSession } from "@better-auth-ui/react";
+/**
+ * Hook that creates a mutation for changing the current user's email address.
+ *
+ * The mutation sends an email-change request and shows success or error toasts.
+ * On success the callback URL is set to the account settings view.
+ *
+ * @returns The `useMutation` result.
+ */
+export function useChangeEmail(options) {
+    const { authClient } = useAuth();
+    const { refetch } = useSession({ refetchOnMount: false });
+    return useAuthMutation({
+        authFn: authClient.changeEmail,
+        options: {
+            ...options,
+            onSuccess: async (...args) => {
+                refetch();
+                await options?.onSuccess?.(...args);
+            }
+        }
+    });
+}