@better-auth-ui/react 1.6.1 → 1.6.3

package/src/mutations/settings/revoke-session-options.ts

@@ -0,0 +1,14 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authMutationOptions } from "../auth-mutation-options"
+
+/**
+ * Mutation options factory for revoking a user session.
+ *
+ * @param authClient - The Better Auth client.
+ */
+export function revokeSessionOptions(authClient: AuthClient) {
+  return authMutationOptions(authClient.revokeSession, [
+    "auth",
+    "revokeSession"
+  ])
+}

package/src/mutations/settings/set-active-session-options.ts

@@ -0,0 +1,15 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authMutationOptions } from "../auth-mutation-options"
+
+/**
+ * Mutation options factory for switching the active device session.
+ *
+ * @param authClient - The Better Auth client.
+ */
+export function setActiveSessionOptions(authClient: AuthClient) {
+  return authMutationOptions(authClient.multiSession.setActive, [
+    "auth",
+    "multiSession",
+    "setActive"
+  ])
+}

package/src/mutations/settings/unlink-account-options.ts

@@ -0,0 +1,14 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authMutationOptions } from "../auth-mutation-options"
+
+/**
+ * Mutation options factory for unlinking a social provider from the current user.
+ *
+ * @param authClient - The Better Auth client.
+ */
+export function unlinkAccountOptions(authClient: AuthClient) {
+  return authMutationOptions(authClient.unlinkAccount, [
+    "auth",
+    "unlinkAccount"
+  ])
+}

package/src/mutations/settings/update-user-options.ts

@@ -0,0 +1,15 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authMutationOptions } from "../auth-mutation-options"
+
+/**
+ * Mutation options factory for updating the authenticated user's profile.
+ *
+ * The returned `mutationKey` (`["auth", "updateUser"]`) 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 updateUserOptions(authClient: AuthClient) {
+  return authMutationOptions(authClient.updateUser, ["auth", "updateUser"])
+}

package/src/queries/auth/session-options.ts

@@ -0,0 +1,18 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authQueryOptions } from "../auth-query-options"
+
+/**
+ * Query options factory for the current session.
+ *
+ * Access `.queryKey` on the returned options for cache seeding or
+ * invalidation: `queryClient.setQueryData(sessionOptions(authClient).queryKey, session)`.
+ *
+ * @param authClient - The Better Auth client.
+ * @param params - Parameters forwarded to `authClient.getSession`.
+ */
+export function sessionOptions(
+  authClient: AuthClient,
+  params?: Parameters<AuthClient["getSession"]>[0]
+) {
+  return authQueryOptions(authClient.getSession, ["auth", "getSession"], params)
+}

package/src/queries/auth-query-options.ts

@@ -0,0 +1,34 @@
+import { type QueryKey, queryOptions } from "@tanstack/react-query"
+import type { BetterFetchError, BetterFetchOption } from "better-auth/client"
+
+export type AuthFn<TData = unknown> = (params: {
+  query?: Record<string, unknown>
+  fetchOptions?: BetterFetchOption
+}) => Promise<{ data: TData }>
+
+type AuthFnData<TFn> = TFn extends AuthFn<infer TData> ? TData : never
+
+/**
+ * Build `queryOptions` for a Better Auth endpoint.
+ *
+ * Appends `params.query` (or `null`) to the supplied `queryKey` so cache
+ * identity tracks endpoint inputs. Wires `throw: true` and the React Query
+ * `AbortSignal` into `fetchOptions`.
+ *
+ * @param authFn - Better Auth client method (e.g. `authClient.getSession`).
+ * @param queryKey - Scope prefix for the key. `params.query` is appended automatically.
+ * @param params - Parameters forwarded to `authFn`.
+ */
+export function authQueryOptions<
+  TFn extends AuthFn,
+  const TQueryKey extends QueryKey
+>(authFn: TFn, queryKey: TQueryKey, params?: Parameters<TFn>[0]) {
+  return queryOptions<AuthFnData<TFn>, BetterFetchError>({
+    queryKey: [...queryKey, params?.query ?? null] as const,
+    queryFn: ({ signal }) =>
+      authFn({
+        ...params,
+        fetchOptions: { ...params?.fetchOptions, signal, throw: true }
+      }) as Promise<AuthFnData<TFn>>
+  })
+}

package/src/queries/settings/account-info-options.ts

@@ -0,0 +1,25 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authQueryOptions } from "../auth-query-options"
+
+/**
+ * Query options factory for provider-specific account info.
+ *
+ * Keyed per-user. `userId` and `params` are both optional so the factory can
+ * build stable options before either is known — the consumer swaps `queryFn`
+ * for `skipToken` until ready.
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed in user's ID.
+ * @param params - Parameters forwarded to `authClient.accountInfo`.
+ */
+export function accountInfoOptions(
+  authClient: AuthClient,
+  userId?: string,
+  params?: Parameters<AuthClient["accountInfo"]>[0]
+) {
+  return authQueryOptions(
+    authClient.accountInfo,
+    ["auth", "user", userId, "accountInfo"],
+    params
+  )
+}

package/src/queries/settings/list-accounts-options.ts

@@ -0,0 +1,26 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authQueryOptions } from "../auth-query-options"
+
+/**
+ * Query options factory for a user's linked social accounts.
+ *
+ * Keyed per-user (enables offline account switching with a persister).
+ * `userId` is optional so the factory can build stable options before the
+ * active session resolves — the consumer swaps `queryFn` for `skipToken`
+ * until ready.
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed in user's ID.
+ * @param params - Parameters forwarded to `authClient.listAccounts`.
+ */
+export function listAccountsOptions(
+  authClient: AuthClient,
+  userId?: string,
+  params?: Parameters<AuthClient["listAccounts"]>[0]
+) {
+  return authQueryOptions(
+    authClient.listAccounts,
+    ["auth", "user", userId, "listAccounts"],
+    params
+  )
+}

package/src/queries/settings/list-device-sessions-options.ts

@@ -0,0 +1,24 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authQueryOptions } from "../auth-query-options"
+
+/**
+ * Query options factory for the current user's device sessions
+ * (multi-session account switcher).
+ *
+ * Keyed per-user (enables offline account switching with a persister).
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed in user's ID.
+ * @param params - Parameters forwarded to `authClient.multiSession.listDeviceSessions`.
+ */
+export function listDeviceSessionsOptions(
+  authClient: AuthClient,
+  userId?: string,
+  params?: Parameters<AuthClient["multiSession"]["listDeviceSessions"]>[0]
+) {
+  return authQueryOptions(
+    authClient.multiSession.listDeviceSessions,
+    ["auth", "user", userId, "listDeviceSessions"],
+    params
+  )
+}

package/src/queries/settings/list-sessions-options.ts

@@ -0,0 +1,23 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authQueryOptions } from "../auth-query-options"
+
+/**
+ * Query options factory for the current user's active sessions.
+ *
+ * Keyed per-user (enables offline account switching with a persister).
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed in user's ID.
+ * @param params - Parameters forwarded to `authClient.listSessions`.
+ */
+export function listSessionsOptions(
+  authClient: AuthClient,
+  userId?: string,
+  params?: Parameters<AuthClient["listSessions"]>[0]
+) {
+  return authQueryOptions(
+    authClient.listSessions,
+    ["auth", "user", userId, "listSessions"],
+    params
+  )
+}

package/src/queries/settings/list-user-passkeys-options.ts

@@ -0,0 +1,23 @@
+import type { AuthClient } from "../../lib/auth-client"
+import { authQueryOptions } from "../auth-query-options"
+
+/**
+ * Query options factory for the current user's passkeys.
+ *
+ * Keyed per-user (enables offline account switching with a persister).
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed in user's ID.
+ * @param params - Parameters forwarded to `authClient.passkey.listUserPasskeys`.
+ */
+export function listUserPasskeysOptions(
+  authClient: AuthClient,
+  userId?: string,
+  params?: Parameters<AuthClient["passkey"]["listUserPasskeys"]>[0]
+) {
+  return authQueryOptions(
+    authClient.passkey.listUserPasskeys,
+    ["auth", "user", userId, "listUserPasskeys"],
+    params
+  )
+}

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

@@ -1,18 +0,0 @@
-import { type UseMutationOptions, type UseMutationResult } from "@tanstack/react-query";
-import type { BetterFetchError } from "better-auth/react";
-type AuthFn = (...args: any) => Promise<any>;
-type MutationParams<TFn extends AuthFn> = undefined extends Parameters<TFn>[0] ? // biome-ignore lint/suspicious/noConfusingVoidType: void is needed for mutations with optional params
-void | Omit<NonNullable<Parameters<TFn>[0]>, "fetchOptions"> : Omit<Parameters<TFn>[0], "fetchOptions">;
-type InferMutationData<TFn extends AuthFn> = TFn extends (...args: infer _A) => infer R ? Extract<Awaited<R>, {
-    error: null;
-}> extends {
-    data: infer D;
-} ? D : Awaited<R> : Awaited<ReturnType<TFn>>;
-export type UseAuthMutationOptions<TFn extends AuthFn> = Omit<UseMutationOptions<InferMutationData<TFn>, BetterFetchError, MutationParams<TFn>>, "mutationFn">;
-export type UseAuthMutationResult<TFn extends AuthFn> = UseMutationResult<InferMutationData<TFn>, BetterFetchError, MutationParams<TFn>>;
-type UseAuthMutationProps<TFn extends AuthFn> = {
-    authFn: TFn;
-    options?: UseAuthMutationOptions<TFn>;
-};
-export declare function useAuthMutation<TFn extends AuthFn>({ authFn, options }: UseAuthMutationProps<TFn>): UseAuthMutationResult<TFn>;
-export {};

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

@@ -1,10 +0,0 @@
-import { useMutation } from "@tanstack/react-query";
-export function useAuthMutation({ authFn, options }) {
-    return useMutation({
-        mutationFn: (params) => authFn({
-            ...params,
-            fetchOptions: { throw: true }
-        }),
-        ...options
-    });
-}

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

@@ -1,24 +0,0 @@
-import { type UseQueryOptions, type UseQueryResult } from "@tanstack/react-query";
-import type { BetterFetchError, BetterFetchOption } from "better-auth/react";
-type BetterFetchFn = (options: {
-    fetchOptions?: BetterFetchOption;
-}) => Promise<{
-    data: unknown;
-}>;
-type InferData<TFn> = TFn extends (options: {
-    fetchOptions?: BetterFetchOption;
-}) => Promise<{
-    data: infer TData;
-}> ? TData : never;
-type OmitFetchOptions<T> = {
-    [K in keyof T as K extends "fetchOptions" ? never : K]: T[K];
-};
-export type UseAuthQueryOptions<TFn extends BetterFetchFn> = Omit<UseQueryOptions<InferData<TFn>, BetterFetchError>, "queryFn">;
-export type UseAuthQueryResult<TFn extends BetterFetchFn> = UseQueryResult<InferData<TFn>, BetterFetchError>;
-type UseAuthQueryProps<TFn extends BetterFetchFn> = {
-    authFn: TFn;
-    params?: OmitFetchOptions<Parameters<TFn>[0]>;
-    options: UseAuthQueryOptions<TFn>;
-};
-export declare function useAuthQuery<TFn extends BetterFetchFn>({ authFn, params, options }: UseAuthQueryProps<TFn>): UseQueryResult<import("@tanstack/react-query").NoInfer<InferData<TFn>>, BetterFetchError>;
-export {};

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

@@ -1,10 +0,0 @@
-import { useQuery } from "@tanstack/react-query";
-export function useAuthQuery({ authFn, params, options }) {
-    return useQuery({
-        queryFn: async () => {
-            const result = await authFn({ ...params, fetchOptions: { throw: true } });
-            return result;
-        },
-        ...options
-    });
-}

package/dist/lib/auth-config.js

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

package/src/hooks/auth/use-auth-mutation.ts

@@ -1,56 +0,0 @@
-import {
-  type UseMutationOptions,
-  type UseMutationResult,
-  useMutation
-} from "@tanstack/react-query"
-import type { BetterFetchError } from "better-auth/react"
-
-// biome-ignore lint/suspicious/noExplicitAny: any
-type AuthFn = (...args: any) => Promise<any>
-
-type MutationParams<TFn extends AuthFn> = undefined extends Parameters<TFn>[0]
-  ? // biome-ignore lint/suspicious/noConfusingVoidType: void is needed for mutations with optional params
-    void | Omit<NonNullable<Parameters<TFn>[0]>, "fetchOptions">
-  : Omit<Parameters<TFn>[0], "fetchOptions">
-
-type InferMutationData<TFn extends AuthFn> = TFn extends (
-  ...args: infer _A
-) => infer R
-  ? Extract<Awaited<R>, { error: null }> extends { data: infer D }
-    ? D
-    : Awaited<R>
-  : Awaited<ReturnType<TFn>>
-
-export type UseAuthMutationOptions<TFn extends AuthFn> = Omit<
-  UseMutationOptions<
-    InferMutationData<TFn>,
-    BetterFetchError,
-    MutationParams<TFn>
-  >,
-  "mutationFn"
->
-
-export type UseAuthMutationResult<TFn extends AuthFn> = UseMutationResult<
-  InferMutationData<TFn>,
-  BetterFetchError,
-  MutationParams<TFn>
->
-
-type UseAuthMutationProps<TFn extends AuthFn> = {
-  authFn: TFn
-  options?: UseAuthMutationOptions<TFn>
-}
-
-export function useAuthMutation<TFn extends AuthFn>({
-  authFn,
-  options
-}: UseAuthMutationProps<TFn>): UseAuthMutationResult<TFn> {
-  return useMutation({
-    mutationFn: (params) =>
-      authFn({
-        ...params,
-        fetchOptions: { throw: true }
-      }),
-    ...options
-  })
-}

package/src/hooks/auth/use-auth-query.ts

@@ -1,50 +0,0 @@
-import {
-  type UseQueryOptions,
-  type UseQueryResult,
-  useQuery
-} from "@tanstack/react-query"
-import type { BetterFetchError, BetterFetchOption } from "better-auth/react"
-
-type BetterFetchFn = (options: {
-  fetchOptions?: BetterFetchOption
-}) => Promise<{ data: unknown }>
-
-type InferData<TFn> = TFn extends (options: {
-  fetchOptions?: BetterFetchOption
-}) => Promise<{ data: infer TData }>
-  ? TData
-  : never
-
-type OmitFetchOptions<T> = {
-  [K in keyof T as K extends "fetchOptions" ? never : K]: T[K]
-}
-
-export type UseAuthQueryOptions<TFn extends BetterFetchFn> = Omit<
-  UseQueryOptions<InferData<TFn>, BetterFetchError>,
-  "queryFn"
->
-
-export type UseAuthQueryResult<TFn extends BetterFetchFn> = UseQueryResult<
-  InferData<TFn>,
-  BetterFetchError
->
-
-type UseAuthQueryProps<TFn extends BetterFetchFn> = {
-  authFn: TFn
-  params?: OmitFetchOptions<Parameters<TFn>[0]>
-  options: UseAuthQueryOptions<TFn>
-}
-
-export function useAuthQuery<TFn extends BetterFetchFn>({
-  authFn,
-  params,
-  options
-}: UseAuthQueryProps<TFn>) {
-  return useQuery<InferData<TFn>, BetterFetchError>({
-    queryFn: async () => {
-      const result = await authFn({ ...params, fetchOptions: { throw: true } })
-      return result as InferData<TFn>
-    },
-    ...options
-  })
-}