@better-auth-ui/react 1.6.9 → 1.6.11

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

@@ -1,15 +0,0 @@
-import { useSession } from "../../queries/auth/session-query";
-/**
- * Retrieve the current authenticated user. Thin wrapper over `useSession`
- * that returns `session.user` as `data`.
- *
- * @param authClient - The Better Auth client.
- * @param options - `getSession` params & `useQuery` options.
- */
-export function useUser(authClient, options) {
-    const { data, ...rest } = useSession(authClient, options);
-    return {
-        data: data?.user,
-        ...rest
-    };
-}

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

@@ -1,19 +0,0 @@
-import { useMutation } from "@tanstack/react-query";
-import { authMutationOptions } from "../mutations/auth-mutation-options";
-/**
- * Escape-hatch hook for Better Auth write endpoints that don't have a
- * purpose-built mutation hook in this library yet. Thin wrapper over
- * `useMutation` and `authMutationOptions`.
- *
- * @param authFn - Better Auth client method (e.g. `authClient.emailOtp.sendVerificationOtp`).
- * @param mutationKey - Stable key for the mutation. Prefer an entry from
- *   `authMutationKeys` over an inline tuple so `useIsMutating` and global
- *   `MutationCache` observers line up.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useAuthMutation(authFn, mutationKey, options) {
-    return useMutation({
-        ...authMutationOptions(authFn, mutationKey),
-        ...options
-    });
-}

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

@@ -1,28 +0,0 @@
-"use client";
-import { useAuth } from "../components/auth/auth-provider";
-/**
- * Access a registered plugin by passing its factory.
- *
- * Use inside plugin slot components to read plugin state (localization,
- * config, etc.) without prop drilling.
- *
- * Throws if the plugin isn't registered on `AuthProvider` — this is an
- * invariant: plugin slot components only render when their plugin is in
- * `plugins`.
- *
- * @example
- * ```tsx
- * function PasskeyButton() {
- *   const { localization } = useAuthPlugin(passkeyPlugin)
- *   return <button>{localization.passkey}</button>
- * }
- * ```
- */
-export function useAuthPlugin(pluginFactory) {
-    const { plugins } = useAuth();
-    const plugin = plugins?.find((p) => p.id === pluginFactory.id);
-    if (!plugin) {
-        throw new Error(`[Better Auth UI] useAuthPlugin: plugin "${pluginFactory.id}" is not registered on AuthProvider.`);
-    }
-    return plugin;
-}

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

@@ -1,21 +0,0 @@
-import { useQuery } from "@tanstack/react-query";
-import { authQueryOptions } from "../queries/auth-query-options";
-/**
- * Escape-hatch hook for Better Auth endpoints that don't have a purpose-built
- * hook in this library yet. Thin wrapper over `useQuery` and `authQueryOptions`.
- *
- * @param authFn - Better Auth client method (e.g. `authClient.magicLink.list`).
- * @param queryKey - Scope prefix for the key. `options.query` is appended automatically.
- * @param options - Better Auth params (`query`, `fetchOptions`) and React
- *   Query options forwarded to `useQuery`.
- */
-export function useAuthQuery(authFn, queryKey, options) {
-    const { query, fetchOptions, ...queryOptions } = options ?? {};
-    return useQuery({
-        ...authQueryOptions(authFn, queryKey, {
-            query,
-            fetchOptions
-        }),
-        ...queryOptions
-    });
-}

package/dist/lib/auth-client.js

@@ -1 +0,0 @@
-export {};

package/dist/lib/auth-plugin.js

@@ -1 +0,0 @@
-export {};

package/dist/lib/auth-server.js

@@ -1 +0,0 @@
-export {};

package/dist/lib/provider-icons.js

@@ -1,48 +0,0 @@
-import { Apple, Atlassian, Cognito, Discord, Dropbox, Facebook, Figma, GitHub, GitLab, Google, HuggingFace, Kakao, Kick, Line, Linear, LinkedIn, Microsoft, Naver, Notion, Paybin, PayPal, Polar, Railway, Reddit, Roblox, Salesforce, Slack, Spotify, TikTok, Twitch, Vercel, VK, WeChat, X, Zoom } from "../components/icons";
-/**
- * Mapping of social authentication provider names to their corresponding icon components.
- *
- * Provides React SVG icon components for all supported social authentication providers.
- * Each icon is a React component that accepts standard SVG props and can be customized
- * with className, size, color, etc.
- *
- * Supported providers include: Apple, Google, GitHub, Microsoft, Discord, Facebook,
- * Twitter/X, and many others.
- */
-export const providerIcons = {
-    apple: Apple,
-    atlassian: Atlassian,
-    cognito: Cognito,
-    discord: Discord,
-    dropbox: Dropbox,
-    facebook: Facebook,
-    figma: Figma,
-    github: GitHub,
-    gitlab: GitLab,
-    google: Google,
-    huggingface: HuggingFace,
-    kakao: Kakao,
-    kick: Kick,
-    line: Line,
-    linear: Linear,
-    linkedin: LinkedIn,
-    microsoft: Microsoft,
-    naver: Naver,
-    notion: Notion,
-    paybin: Paybin,
-    paypal: PayPal,
-    polar: Polar,
-    railway: Railway,
-    reddit: Reddit,
-    roblox: Roblox,
-    salesforce: Salesforce,
-    slack: Slack,
-    spotify: Spotify,
-    tiktok: TikTok,
-    twitch: Twitch,
-    twitter: X,
-    vercel: Vercel,
-    vk: VK,
-    wechat: WeChat,
-    zoom: Zoom
-};

package/dist/lib/settings-tab.js

@@ -1 +0,0 @@
-export {};

package/dist/lib/utils.js

@@ -1,5 +0,0 @@
-import { clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
-export function cn(...inputs) {
-    return twMerge(clsx(inputs));
-}

package/dist/mutations/api-key/create-api-key-mutation.js

@@ -1,39 +0,0 @@
-import { apiKeyMutationKeys, apiKeyQueryKeys } from "@better-auth-ui/core/plugins";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-import { useSession } from "../../queries/auth/session-query";
-/**
- * Mutation options factory for creating an API key.
- *
- * @param authClient - The Better Auth client with the API key plugin.
- */
-export function createApiKeyOptions(authClient) {
-    const mutationKey = apiKeyMutationKeys.create;
-    const mutationFn = (params) => authClient.apiKey.create({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for creating an API key.
- *
- * On success, `MutationInvalidator` awaits invalidation of the user's API key
- * list queries (see `meta.awaits`).
- *
- * @param authClient - The Better Auth client with the API key plugin.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useCreateApiKey(authClient, options, queryClient) {
-    const { data: session } = useSession(authClient, undefined, queryClient);
-    const userId = session?.user.id;
-    return useMutation({
-        ...createApiKeyOptions(authClient),
-        ...options,
-        meta: {
-            awaits: [apiKeyQueryKeys.lists(userId)]
-        }
-    }, queryClient);
-}

package/dist/mutations/api-key/delete-api-key-mutation.js

@@ -1,39 +0,0 @@
-import { apiKeyMutationKeys, apiKeyQueryKeys } from "@better-auth-ui/core/plugins";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-import { useSession } from "../../queries/auth/session-query";
-/**
- * Mutation options factory for deleting an API key.
- *
- * @param authClient - The Better Auth client with the API key plugin.
- */
-export function deleteApiKeyOptions(authClient) {
-    const mutationKey = apiKeyMutationKeys.delete;
-    const mutationFn = (params) => authClient.apiKey.delete({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for deleting an API key.
- *
- * On success, `MutationInvalidator` awaits invalidation of the user's API key
- * list queries (see `meta.awaits`).
- *
- * @param authClient - The Better Auth client with the API key plugin.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useDeleteApiKey(authClient, options, queryClient) {
-    const { data: session } = useSession(authClient, undefined, queryClient);
-    const userId = session?.user.id;
-    return useMutation({
-        ...deleteApiKeyOptions(authClient),
-        ...options,
-        meta: {
-            awaits: [apiKeyQueryKeys.lists(userId)]
-        }
-    }, queryClient);
-}

package/dist/mutations/auth/request-password-reset-mutation.js

@@ -1,33 +0,0 @@
-import { authMutationKeys } from "@better-auth-ui/core";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-/**
- * Mutation options factory for requesting a password reset email.
- *
- * @param authClient - The Better Auth client.
- */
-export function requestPasswordResetOptions(authClient) {
-    const mutationKey = authMutationKeys.requestPasswordReset;
-    const mutationFn = (params) => authClient.requestPasswordReset({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for requesting a password reset email.
- *
- * Wraps `authClient.requestPasswordReset` and forwards React Query mutation
- * options such as `onSuccess`, `onError`, and `retry`.
- *
- * @param authClient - The Better Auth client.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useRequestPasswordReset(authClient, options) {
-    return useMutation({
-        ...requestPasswordResetOptions(authClient),
-        ...options
-    });
-}

package/dist/mutations/auth/reset-password-mutation.js

@@ -1,34 +0,0 @@
-import { authMutationKeys } from "@better-auth-ui/core";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-/**
- * Mutation options factory for completing a password reset.
- *
- * @param authClient - The Better Auth client.
- */
-export function resetPasswordOptions(authClient) {
-    const mutationKey = authMutationKeys.resetPassword;
-    const mutationFn = (params) => authClient.resetPassword({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for completing a password reset.
- *
- * Wraps `authClient.resetPassword` (using the token from the reset email)
- * and forwards React Query mutation options such as `onSuccess`, `onError`,
- * and `retry`.
- *
- * @param authClient - The Better Auth client.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useResetPassword(authClient, options) {
-    return useMutation({
-        ...resetPasswordOptions(authClient),
-        ...options
-    });
-}

package/dist/mutations/auth/send-verification-email-mutation.js

@@ -1,33 +0,0 @@
-import { authMutationKeys } from "@better-auth-ui/core";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-/**
- * Mutation options factory for sending a verification email.
- *
- * @param authClient - The Better Auth client.
- */
-export function sendVerificationEmailOptions(authClient) {
-    const mutationKey = authMutationKeys.sendVerificationEmail;
-    const mutationFn = (params) => authClient.sendVerificationEmail({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for sending an email-verification link.
- *
- * Wraps `authClient.sendVerificationEmail` and forwards React Query mutation
- * options such as `onSuccess`, `onError`, and `retry`.
- *
- * @param authClient - The Better Auth client.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useSendVerificationEmail(authClient, options) {
-    return useMutation({
-        ...sendVerificationEmailOptions(authClient),
-        ...options
-    });
-}

package/dist/mutations/auth/sign-in-email-mutation.js

@@ -1,40 +0,0 @@
-import { authMutationKeys, authQueryKeys } from "@better-auth-ui/core";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-/**
- * Mutation options factory for email/password sign-in.
- *
- * The returned `mutationKey` (`authMutationKeys.signIn.email`) is stable and
- * can be passed to `useIsMutating` or matched inside a global
- * `MutationCache` observer for toast handling.
- *
- * @param authClient - The Better Auth client.
- */
-export function signInEmailOptions(authClient) {
-    const mutationKey = authMutationKeys.signIn.email;
-    const mutationFn = (params) => authClient.signIn.email({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for email/password sign-in.
- *
- * On success, `MutationInvalidator` awaits invalidation of the session
- * query so the new session is refetched (see `meta.awaits`).
- *
- * @param authClient - The Better Auth client.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useSignInEmail(authClient, options, queryClient) {
-    return useMutation({
-        ...signInEmailOptions(authClient),
-        ...options,
-        meta: {
-            awaits: [authQueryKeys.session]
-        }
-    }, queryClient);
-}

package/dist/mutations/auth/sign-in-social-mutation.js

@@ -1,38 +0,0 @@
-import { authMutationKeys } from "@better-auth-ui/core";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-/**
- * Mutation options factory for social sign-in.
- *
- * The returned `mutationKey` (`["auth", "signIn", "social"]`) is stable and
- * can be passed to `useIsMutating` or matched inside a global
- * `MutationCache` observer for toast handling.
- *
- * @param authClient - The Better Auth client.
- */
-export function signInSocialOptions(authClient) {
-    const mutationKey = authMutationKeys.signIn.social;
-    const mutationFn = (params) => authClient.signIn.social({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for social sign-in.
- *
- * Wraps `authClient.signIn.social` to initiate a provider redirect and
- * forwards React Query mutation options such as `onSuccess`, `onError`,
- * and `retry`.
- *
- * @param authClient - The Better Auth client.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useSignInSocial(authClient, options) {
-    return useMutation({
-        ...signInSocialOptions(authClient),
-        ...options
-    });
-}

package/dist/mutations/auth/sign-out-mutation.js

@@ -1,41 +0,0 @@
-import { authMutationKeys, authQueryKeys } from "@better-auth-ui/core";
-import { mutationOptions, useMutation, useQueryClient } from "@tanstack/react-query";
-/**
- * Mutation options factory for signing out.
- *
- * @param authClient - The Better Auth client.
- */
-export function signOutOptions(authClient) {
-    const mutationKey = authMutationKeys.signOut;
-    // biome-ignore lint/suspicious/noConfusingVoidType: void allows no-arg mutate
-    const mutationFn = (params) => authClient.signOut({
-        ...(params ?? {}),
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for signing the current user out.
- *
- * On success, removes every cached auth query so no stale data leaks across
- * accounts. Sign-out uses a direct `removeQueries` call (rather than the
- * `meta.awaits` / `meta.invalidates` pattern) because the goal is to drop
- * cache entries entirely, not to refetch them.
- *
- * @param authClient - The Better Auth client.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useSignOut(authClient, options, queryClient) {
-    const defaultQueryClient = useQueryClient(queryClient);
-    return useMutation({
-        ...signOutOptions(authClient),
-        ...options,
-        onSuccess: async (...args) => {
-            defaultQueryClient.removeQueries({ queryKey: authQueryKeys.all });
-            await options?.onSuccess?.(...args);
-        }
-    }, queryClient);
-}

package/dist/mutations/auth/sign-up-email-mutation.js

@@ -1,36 +0,0 @@
-import { authMutationKeys, authQueryKeys } from "@better-auth-ui/core";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-/**
- * Mutation options factory for email/password sign-up.
- *
- * @param authClient - The Better Auth client.
- */
-export function signUpEmailOptions(authClient) {
-    const mutationKey = authMutationKeys.signUp.email;
-    const mutationFn = (params) => authClient.signUp.email({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for email/password sign-up.
- *
- * On success, `MutationInvalidator` awaits invalidation of the session
- * query so the new session is refetched (see `meta.awaits`).
- *
- * @param authClient - The Better Auth client.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useSignUpEmail(authClient, options, queryClient) {
-    return useMutation({
-        ...signUpEmailOptions(authClient),
-        ...options,
-        meta: {
-            awaits: [authQueryKeys.session]
-        }
-    }, queryClient);
-}

package/dist/mutations/auth-mutation-options.js

@@ -1,23 +0,0 @@
-import { mutationOptions } from "@tanstack/react-query";
-/**
- * Build `mutationOptions` for a write-style Better Auth endpoint.
- *
- * Injects `throw: true` into `fetchOptions` so the promise rejects with a
- * `BetterFetchError` on failure instead of resolving to `{ data, error }`.
- *
- * @param authFn - Better Auth client method (e.g. `authClient.emailOtp.sendVerificationOtp`).
- * @param mutationKey - Stable key for the mutation (used by `useIsMutating`, `MutationCache`, …).
- */
-export function authMutationOptions(authFn, mutationKey) {
-    const mutationFn = (variables) => {
-        const vars = (variables ?? {});
-        return authFn({
-            ...vars,
-            fetchOptions: { ...vars.fetchOptions, throw: true }
-        });
-    };
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}

package/dist/mutations/magic-link/sign-in-magic-link-mutation.js

@@ -1,33 +0,0 @@
-import { magicLinkMutationKeys } from "@better-auth-ui/core/plugins";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-/**
- * Mutation options factory for magic-link sign-in.
- *
- * @param authClient - The Better Auth client.
- */
-export function signInMagicLinkOptions(authClient) {
-    const mutationKey = magicLinkMutationKeys.signIn;
-    const mutationFn = (params) => authClient.signIn.magicLink({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for requesting a magic-link sign-in email.
- *
- * Wraps `authClient.signIn.magicLink` and forwards React Query mutation
- * options such as `onSuccess`, `onError`, and `retry`.
- *
- * @param authClient - The Better Auth client with the magic-link plugin.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useSignInMagicLink(authClient, options) {
-    return useMutation({
-        ...signInMagicLinkOptions(authClient),
-        ...options
-    });
-}

package/dist/mutations/multi-session/revoke-multi-session-mutation.js

@@ -1,39 +0,0 @@
-import { multiSessionMutationKeys, multiSessionQueryKeys } from "@better-auth-ui/core/plugins";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-import { useSession } from "../../queries/auth/session-query";
-/**
- * Mutation options factory for revoking a device session in multi-session mode.
- *
- * @param authClient - The Better Auth client with the multi-session plugin.
- */
-export function revokeMultiSessionOptions(authClient) {
-    const mutationKey = multiSessionMutationKeys.revoke;
-    const mutationFn = (params) => authClient.multiSession.revoke({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for revoking a device session in multi-session mode.
- *
- * On success, `MutationInvalidator` awaits invalidation of the device
- * sessions list (see `meta.awaits`).
- *
- * @param authClient - The Better Auth client with the multi-session plugin.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useRevokeMultiSession(authClient, options, queryClient) {
-    const { data: session } = useSession(authClient, undefined, queryClient);
-    const userId = session?.user.id;
-    return useMutation({
-        ...revokeMultiSessionOptions(authClient),
-        ...options,
-        meta: {
-            awaits: [multiSessionQueryKeys.lists(userId)]
-        }
-    }, queryClient);
-}

package/dist/mutations/multi-session/set-active-session-mutation.js

@@ -1,40 +0,0 @@
-import { authQueryKeys } from "@better-auth-ui/core";
-import { multiSessionMutationKeys, multiSessionQueryKeys } from "@better-auth-ui/core/plugins";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-import { useSession } from "../../queries/auth/session-query";
-/**
- * Mutation options factory for switching the active device session.
- *
- * @param authClient - The Better Auth client with the multi-session plugin.
- */
-export function setActiveSessionOptions(authClient) {
-    const mutationKey = multiSessionMutationKeys.setActive;
-    const mutationFn = (params) => authClient.multiSession.setActive({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-/**
- * Create a mutation for switching the active device session.
- *
- * On success, `MutationInvalidator` awaits invalidation of the session
- * and device sessions queries (see `meta.awaits`).
- *
- * @param authClient - The Better Auth client with the multi-session plugin.
- * @param options - React Query options forwarded to `useMutation`.
- */
-export function useSetActiveSession(authClient, options, queryClient) {
-    const { data: session } = useSession(authClient, undefined, queryClient);
-    const userId = session?.user.id;
-    return useMutation({
-        ...setActiveSessionOptions(authClient),
-        ...options,
-        meta: {
-            awaits: [authQueryKeys.session, multiSessionQueryKeys.lists(userId)]
-        }
-    }, queryClient);
-}

package/dist/mutations/organization/accept-invitation-mutation.js

@@ -1,32 +0,0 @@
-import { organizationMutationKeys, organizationQueryKeys } from "@better-auth-ui/core/plugins";
-import { mutationOptions, useMutation } from "@tanstack/react-query";
-import { useSession } from "../../queries/auth/session-query";
-export function acceptInvitationOptions(authClient) {
-    const mutationKey = organizationMutationKeys.acceptInvitation;
-    const mutationFn = (params) => authClient.organization.acceptInvitation({
-        ...params,
-        fetchOptions: { ...params?.fetchOptions, throw: true }
-    });
-    return mutationOptions({
-        mutationKey,
-        mutationFn
-    });
-}
-export function useAcceptInvitation(authClient, options, queryClient) {
-    const { data: session } = useSession(authClient, undefined, queryClient);
-    const userId = session?.user.id;
-    return useMutation({
-        ...acceptInvitationOptions(authClient),
-        ...options,
-        meta: {
-            awaits: [
-                organizationQueryKeys.userInvitations.all(userId),
-                organizationQueryKeys.lists(userId)
-            ],
-            invalidates: [
-                organizationQueryKeys.fullDetails(userId),
-                organizationQueryKeys.activeOrganizations(userId)
-            ]
-        }
-    }, queryClient);
-}