@better-auth-ui/react 1.6.2 → 1.6.4

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

@@ -0,0 +1,158 @@
+import { authQueryKeys } from "@better-auth-ui/core"
+import {
+  type DataTag,
+  type QueryClient,
+  queryOptions,
+  skipToken,
+  useQuery
+} from "@tanstack/react-query"
+import type { BetterFetchError } from "better-auth/react"
+
+import type { AuthClient, InferData } from "../../lib/auth-client"
+import { useSession } from "../auth/session-query"
+
+export type AccountInfoData<TAuthClient extends AuthClient> = InferData<
+  TAuthClient["accountInfo"]
+>
+
+export type AccountInfoParams<TAuthClient extends AuthClient> = Parameters<
+  TAuthClient["accountInfo"]
+>[0]
+
+export type AccountInfo<TAuthClient extends AuthClient = AuthClient> =
+  NonNullable<AccountInfoData<TAuthClient>>
+
+export type AccountInfoOptions<TAuthClient extends AuthClient> = Omit<
+  ReturnType<typeof accountInfoOptions<TAuthClient>>,
+  "queryKey" | "queryFn"
+>
+
+/**
+ * Query options factory for provider-specific account info.
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed-in user's ID. Used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.accountInfo`.
+ */
+export function accountInfoOptions<TAuthClient extends AuthClient>(
+  authClient: TAuthClient,
+  userId: string | undefined,
+  params?: AccountInfoParams<TAuthClient>
+) {
+  type TData = AccountInfoData<TAuthClient>
+  const queryKey = authQueryKeys.accountInfo(userId, params?.query)
+
+  const options = queryOptions<TData, BetterFetchError, TData, typeof queryKey>(
+    {
+      queryKey,
+      queryFn: ({ signal }) =>
+        authClient.accountInfo({
+          ...params,
+          fetchOptions: { ...params?.fetchOptions, signal, throw: true }
+        }) as Promise<TData>
+    }
+  )
+
+  return options as typeof options & {
+    queryKey: DataTag<typeof queryKey, TData, BetterFetchError>
+  }
+}
+
+/**
+ * Get the current user's provider-specific account info from the query
+ * cache, calling `fetchAccountInfo` under the hood if no cached entry
+ * exists. Resolves with the data, making it ideal for loaders or
+ * `beforeLoad` guards.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.accountInfo`.
+ */
+export const ensureAccountInfo = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: AccountInfoParams<TAuthClient>
+) => queryClient.ensureQueryData(accountInfoOptions(authClient, userId, params))
+
+/**
+ * Prefetch the current user's provider-specific account info into the query
+ * cache. Behaves like `fetchAccountInfo`, but does not throw on error and
+ * does not return the data — use this to warm the cache without blocking
+ * navigation.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.accountInfo`.
+ */
+export const prefetchAccountInfo = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: AccountInfoParams<TAuthClient>
+) => queryClient.prefetchQuery(accountInfoOptions(authClient, userId, params))
+
+/**
+ * Fetch and cache the current user's provider-specific account info,
+ * resolving with the data or throwing on error. If a cached entry exists
+ * and is neither invalidated nor older than `staleTime`, the cached value
+ * is returned without a network call; otherwise the latest data is fetched.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.accountInfo`.
+ */
+export const fetchAccountInfo = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: AccountInfoParams<TAuthClient>
+) => queryClient.fetchQuery(accountInfoOptions(authClient, userId, params))
+
+export type UseAccountInfoOptions<TAuthClient extends AuthClient> =
+  AccountInfoOptions<TAuthClient> & AccountInfoParams<TAuthClient>
+
+/**
+ * Subscribe to provider-specific info for a linked account via TanStack Query.
+ *
+ * Shares a query key with the server-side `accountInfoOptions`, so
+ * SSR-hydrated data is reused from the cache without an immediate refetch.
+ * The query is gated on both a signed-in user and a resolved `accountId`;
+ * until both are present, the underlying `queryFn` is replaced with
+ * `skipToken`.
+ *
+ * @param authClient - The Better Auth client.
+ * @param options - `accountInfo` params (`query`, `fetchOptions`) merged
+ *   with `useQuery` options (e.g. `enabled`, `staleTime`, `select`).
+ * @param queryClient - Optional custom `QueryClient`. Defaults to the client
+ *   from the nearest `QueryClientProvider`.
+ */
+export function useAccountInfo<TAuthClient extends AuthClient>(
+  authClient: TAuthClient,
+  options: UseAccountInfoOptions<TAuthClient> = {},
+  queryClient?: QueryClient
+) {
+  const { data: session } = useSession(authClient, undefined, queryClient)
+  const userId = session?.user.id
+
+  const { query, fetchOptions, ...queryOptions } = options
+
+  const baseOptions = accountInfoOptions(authClient, userId, {
+    query,
+    fetchOptions
+  })
+
+  const canFetch = Boolean(userId && query?.accountId)
+
+  return useQuery(
+    {
+      ...queryOptions,
+      ...baseOptions,
+      queryFn: canFetch ? baseOptions.queryFn : skipToken
+    },
+    queryClient
+  )
+}

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

@@ -0,0 +1,156 @@
+import { authQueryKeys } from "@better-auth-ui/core"
+import {
+  type DataTag,
+  type QueryClient,
+  queryOptions,
+  skipToken,
+  useQuery
+} from "@tanstack/react-query"
+import type { BetterFetchError } from "better-auth/react"
+
+import type { AuthClient, InferData } from "../../lib/auth-client"
+import { useSession } from "../auth/session-query"
+
+export type ListAccountsData<TAuthClient extends AuthClient> = InferData<
+  TAuthClient["listAccounts"]
+>
+
+export type ListAccountsParams<TAuthClient extends AuthClient> = Parameters<
+  TAuthClient["listAccounts"]
+>[0]
+
+export type ListAccount<TAuthClient extends AuthClient = AuthClient> =
+  NonNullable<ListAccountsData<TAuthClient>>[number]
+
+export type ListAccountsOptions<TAuthClient extends AuthClient> = Omit<
+  ReturnType<typeof listAccountsOptions<TAuthClient>>,
+  "queryKey" | "queryFn"
+>
+
+/**
+ * Query options factory for a user's linked social accounts.
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed-in user's ID. Used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listAccounts`.
+ */
+export function listAccountsOptions<TAuthClient extends AuthClient>(
+  authClient: TAuthClient,
+  userId: string | undefined,
+  params?: ListAccountsParams<TAuthClient>
+) {
+  type TData = ListAccountsData<TAuthClient>
+  const queryKey = authQueryKeys.listAccounts(userId, params?.query)
+
+  const options = queryOptions<TData, BetterFetchError, TData, typeof queryKey>(
+    {
+      queryKey,
+      queryFn: ({ signal }) =>
+        authClient.listAccounts({
+          ...params,
+          fetchOptions: { ...params?.fetchOptions, signal, throw: true }
+        }) as Promise<TData>
+    }
+  )
+
+  return options as typeof options & {
+    queryKey: DataTag<typeof queryKey, TData, BetterFetchError>
+  }
+}
+
+/**
+ * Get the current user's linked social accounts from the query cache,
+ * calling `fetchListAccounts` under the hood if no cached entry exists.
+ * Resolves with the account list, making it ideal for loaders or
+ * `beforeLoad` guards.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listAccounts`.
+ */
+export const ensureListAccounts = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListAccountsParams<TAuthClient>
+) =>
+  queryClient.ensureQueryData(listAccountsOptions(authClient, userId, params))
+
+/**
+ * Prefetch the current user's linked social accounts into the query cache.
+ * Behaves like `fetchListAccounts`, but does not throw on error and does
+ * not return the data — use this to warm the cache without blocking
+ * navigation.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listAccounts`.
+ */
+export const prefetchListAccounts = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListAccountsParams<TAuthClient>
+) => queryClient.prefetchQuery(listAccountsOptions(authClient, userId, params))
+
+/**
+ * Fetch and cache the current user's linked social accounts, resolving
+ * with the data or throwing on error. If a cached entry exists and is
+ * neither invalidated nor older than `staleTime`, the cached value is
+ * returned without a network call; otherwise the latest data is fetched.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listAccounts`.
+ */
+export const fetchListAccounts = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListAccountsParams<TAuthClient>
+) => queryClient.fetchQuery(listAccountsOptions(authClient, userId, params))
+
+export type UseListAccountsOptions<TAuthClient extends AuthClient> =
+  ListAccountsOptions<TAuthClient> & ListAccountsParams<TAuthClient>
+
+/**
+ * Subscribe to the current user's linked social accounts via TanStack Query.
+ *
+ * Shares a query key with the server-side `listAccountsOptions`, so
+ * SSR-hydrated data is reused from the cache without an immediate refetch.
+ * The query is gated on a signed-in user; while the session is loading or
+ * absent, the underlying `queryFn` is replaced with `skipToken`.
+ *
+ * @param authClient - The Better Auth client.
+ * @param options - `listAccounts` params (`query`, `fetchOptions`) merged
+ *   with `useQuery` options (e.g. `enabled`, `staleTime`, `select`).
+ * @param queryClient - Optional custom `QueryClient`. Defaults to the client
+ *   from the nearest `QueryClientProvider`.
+ */
+export function useListAccounts<TAuthClient extends AuthClient>(
+  authClient: TAuthClient,
+  options: UseListAccountsOptions<TAuthClient> = {},
+  queryClient?: QueryClient
+) {
+  const { data: session } = useSession(authClient, undefined, queryClient)
+  const userId = session?.user.id
+
+  const { query, fetchOptions, ...queryOptions } = options
+
+  const baseOptions = listAccountsOptions(authClient, userId, {
+    query,
+    fetchOptions
+  })
+
+  return useQuery(
+    {
+      ...queryOptions,
+      ...baseOptions,
+      queryFn: userId ? baseOptions.queryFn : skipToken
+    },
+    queryClient
+  )
+}

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

@@ -0,0 +1,154 @@
+import { authQueryKeys } from "@better-auth-ui/core"
+import {
+  type DataTag,
+  type QueryClient,
+  queryOptions,
+  skipToken,
+  useQuery
+} from "@tanstack/react-query"
+import type { BetterFetchError } from "better-auth/react"
+
+import type { AuthClient, InferData } from "../../lib/auth-client"
+import { useSession } from "../auth/session-query"
+
+export type ListSessionsData<TAuthClient extends AuthClient> = InferData<
+  TAuthClient["listSessions"]
+>
+
+export type ListSessionsParams<TAuthClient extends AuthClient> = Parameters<
+  TAuthClient["listSessions"]
+>[0]
+
+export type ListSession<TAuthClient extends AuthClient = AuthClient> =
+  NonNullable<ListSessionsData<TAuthClient>>[number]
+
+export type ListSessionsOptions<TAuthClient extends AuthClient> = Omit<
+  ReturnType<typeof listSessionsOptions<TAuthClient>>,
+  "queryKey" | "queryFn"
+>
+
+/**
+ * Query options factory for the current user's active sessions.
+ *
+ * @param authClient - The Better Auth client.
+ * @param userId - The current signed-in user's ID. Used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listSessions`.
+ */
+export function listSessionsOptions<TAuthClient extends AuthClient>(
+  authClient: TAuthClient,
+  userId: string | undefined,
+  params?: ListSessionsParams<TAuthClient>
+) {
+  type TData = ListSessionsData<TAuthClient>
+  const queryKey = authQueryKeys.listSessions(userId, params?.query)
+
+  const options = queryOptions<TData, BetterFetchError, TData, typeof queryKey>(
+    {
+      queryKey,
+      queryFn: ({ signal }) =>
+        authClient.listSessions({
+          ...params,
+          fetchOptions: { ...params?.fetchOptions, signal, throw: true }
+        }) as Promise<TData>
+    }
+  )
+
+  return options as typeof options & {
+    queryKey: DataTag<typeof queryKey, TData, BetterFetchError>
+  }
+}
+
+/**
+ * Get the current user's active sessions from the query cache, calling
+ * `fetchListSessions` under the hood if no cached entry exists. Resolves
+ * with the session list, making it ideal for loaders or `beforeLoad` guards.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listSessions`.
+ */
+export const ensureListSessions = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListSessionsParams<TAuthClient>
+) =>
+  queryClient.ensureQueryData(listSessionsOptions(authClient, userId, params))
+
+/**
+ * Prefetch the current user's active sessions into the query cache. Behaves
+ * like `fetchListSessions`, but does not throw on error and does not return
+ * the data — use this to warm the cache without blocking navigation.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listSessions`.
+ */
+export const prefetchListSessions = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListSessionsParams<TAuthClient>
+) => queryClient.prefetchQuery(listSessionsOptions(authClient, userId, params))
+
+/**
+ * Fetch and cache the current user's active sessions, resolving with the
+ * data or throwing on error. If a cached entry exists and is neither
+ * invalidated nor older than `staleTime`, the cached value is returned
+ * without a network call; otherwise the latest data is fetched.
+ *
+ * @param queryClient - The React Query client.
+ * @param authClient - The Better Auth client.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.listSessions`.
+ */
+export const fetchListSessions = <TAuthClient extends AuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListSessionsParams<TAuthClient>
+) => queryClient.fetchQuery(listSessionsOptions(authClient, userId, params))
+
+export type UseListSessionsOptions<TAuthClient extends AuthClient> =
+  ListSessionsOptions<TAuthClient> & ListSessionsParams<TAuthClient>
+
+/**
+ * Subscribe to the current user's active sessions via TanStack Query.
+ *
+ * Shares a query key with the server-side `listSessionsOptions`, so
+ * SSR-hydrated data is reused from the cache without an immediate refetch.
+ * The query is gated on a signed-in user; while the session is loading or
+ * absent, the underlying `queryFn` is replaced with `skipToken`.
+ *
+ * @param authClient - The Better Auth client.
+ * @param options - `listSessions` params (`query`, `fetchOptions`) merged
+ *   with `useQuery` options (e.g. `enabled`, `staleTime`, `select`).
+ * @param queryClient - Optional custom `QueryClient`. Defaults to the client
+ *   from the nearest `QueryClientProvider`.
+ */
+export function useListSessions<TAuthClient extends AuthClient>(
+  authClient: TAuthClient,
+  options: UseListSessionsOptions<TAuthClient> = {},
+  queryClient?: QueryClient
+) {
+  const { data: session } = useSession(authClient, undefined, queryClient)
+  const userId = session?.user.id
+
+  const { query, fetchOptions, ...queryOptions } = options
+
+  const baseOptions = listSessionsOptions(authClient, userId, {
+    query,
+    fetchOptions
+  })
+
+  return useQuery(
+    {
+      ...queryOptions,
+      ...baseOptions,
+      queryFn: userId ? baseOptions.queryFn : skipToken
+    },
+    queryClient
+  )
+}

package/src/server/queries/auth/session-query.ts

@@ -0,0 +1,94 @@
+import { authQueryKeys } from "@better-auth-ui/core"
+import {
+  type DataTag,
+  type QueryClient,
+  queryOptions
+} from "@tanstack/react-query"
+import type { APIError } from "better-auth"
+
+import type { AuthServer } from "../../../lib/auth-server"
+
+export type SessionData<TAuth extends AuthServer = AuthServer> = Awaited<
+  ReturnType<TAuth["api"]["getSession"]>
+>
+
+export type Session<TAuth extends AuthServer = AuthServer> = NonNullable<
+  SessionData<TAuth>
+>
+
+export type SessionParams<TAuth extends AuthServer> = Parameters<
+  TAuth["api"]["getSession"]
+>[0]
+
+/**
+ * Query options factory for the current session on the server.
+ *
+ * Uses the same query key as the client-side `sessionOptions` so that data
+ * fetched during SSR hydrates seamlessly into the client's React Query cache.
+ *
+ * @param auth - The Better Auth server instance.
+ * @param params - Parameters forwarded to `auth.api.getSession` (typically
+ *   includes request `headers` for cookie-based session resolution).
+ */
+export function sessionOptions<TAuth extends AuthServer>(
+  auth: TAuth,
+  params: SessionParams<TAuth>
+) {
+  type TData = SessionData<TAuth>
+  const queryKey = authQueryKeys.session
+
+  const options = queryOptions<TData, APIError, TData, typeof queryKey>({
+    queryKey,
+    queryFn: () => auth.api.getSession(params) as Promise<TData>
+  })
+
+  return options as typeof options & {
+    queryKey: DataTag<typeof queryKey, TData, APIError>
+  }
+}
+
+/**
+ * Get the current session from the query cache, calling `fetchSession` under
+ * the hood if no cached entry exists. Resolves with the session data, making
+ * it suitable for reading the value directly in a server component.
+ *
+ * @param queryClient - The React Query client used for SSR hydration.
+ * @param auth - The Better Auth server instance.
+ * @param params - Parameters forwarded to `auth.api.getSession`.
+ */
+export const ensureSession = <TAuth extends AuthServer>(
+  queryClient: QueryClient,
+  auth: TAuth,
+  params: SessionParams<TAuth>
+) => queryClient.ensureQueryData(sessionOptions(auth, params))
+
+/**
+ * Prefetch the current session into the query cache. Behaves like
+ * `fetchSession`, but does not throw on error and does not return the data —
+ * use this when you only need the value to be available after hydration.
+ *
+ * @param queryClient - The React Query client used for SSR hydration.
+ * @param auth - The Better Auth server instance.
+ * @param params - Parameters forwarded to `auth.api.getSession`.
+ */
+export const prefetchSession = <TAuth extends AuthServer>(
+  queryClient: QueryClient,
+  auth: TAuth,
+  params: SessionParams<TAuth>
+) => queryClient.prefetchQuery(sessionOptions(auth, params))
+
+/**
+ * Fetch and cache the current session, resolving with the data or throwing
+ * on error. If a cached entry exists and is neither invalidated nor older
+ * than `staleTime`, the cached value is returned without a network call;
+ * otherwise the latest data is fetched.
+ *
+ * @param queryClient - The React Query client used for SSR hydration.
+ * @param auth - The Better Auth server instance.
+ * @param params - Parameters forwarded to `auth.api.getSession`.
+ */
+export const fetchSession = <TAuth extends AuthServer>(
+  queryClient: QueryClient,
+  auth: TAuth,
+  params: SessionParams<TAuth>
+) => queryClient.fetchQuery(sessionOptions(auth, params))

package/src/server/queries/multi-session/list-device-sessions-query.ts

@@ -0,0 +1,102 @@
+import { authQueryKeys } from "@better-auth-ui/core"
+import {
+  type DataTag,
+  type QueryClient,
+  queryOptions
+} from "@tanstack/react-query"
+import type { APIError } from "better-auth"
+
+import type { MultiSessionAuthServer } from "../../../lib/auth-server"
+
+export type ListDeviceSessionsData<TAuth extends MultiSessionAuthServer> =
+  Awaited<ReturnType<TAuth["api"]["listDeviceSessions"]>>
+
+export type ListDeviceSession<
+  TAuth extends MultiSessionAuthServer = MultiSessionAuthServer
+> = NonNullable<ListDeviceSessionsData<TAuth>>[number]
+
+export type ListDeviceSessionsParams<TAuth extends MultiSessionAuthServer> =
+  Parameters<TAuth["api"]["listDeviceSessions"]>[0]
+
+/**
+ * Query options factory for the current user's device sessions.
+ *
+ * @param auth - The Better Auth server instance with the multi-session plugin.
+ * @param userId - The signed-in user's ID. Used for cache partitioning so
+ *   the key matches the client-side `listDeviceSessionsOptions` for SSR hydration.
+ * @param params - Parameters forwarded to `auth.api.listDeviceSessions`.
+ */
+export function listDeviceSessionsOptions<TAuth extends MultiSessionAuthServer>(
+  auth: TAuth,
+  userId: string,
+  params: ListDeviceSessionsParams<TAuth>
+) {
+  type TData = ListDeviceSessionsData<TAuth>
+  const queryKey = authQueryKeys.listDeviceSessions(userId, params?.query)
+
+  const options = queryOptions<TData, APIError, TData, typeof queryKey>({
+    queryKey,
+    queryFn: () => auth.api.listDeviceSessions(params) as Promise<TData>
+  })
+
+  return options as typeof options & {
+    queryKey: DataTag<typeof queryKey, TData, APIError>
+  }
+}
+
+/**
+ * Get the current user's device sessions from the query cache, calling
+ * `fetchListDeviceSessions` under the hood if no cached entry exists.
+ * Resolves with the device session list, making it suitable for reading
+ * directly in a server component.
+ *
+ * @param queryClient - The React Query client used for SSR hydration.
+ * @param auth - The Better Auth server instance with the multi-session plugin.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `auth.api.listDeviceSessions`.
+ */
+export const ensureListDeviceSessions = <TAuth extends MultiSessionAuthServer>(
+  queryClient: QueryClient,
+  auth: TAuth,
+  userId: string,
+  params: ListDeviceSessionsParams<TAuth>
+) =>
+  queryClient.ensureQueryData(listDeviceSessionsOptions(auth, userId, params))
+
+/**
+ * Prefetch the current user's device sessions into the query cache. Behaves
+ * like `fetchListDeviceSessions`, but does not throw on error and does not
+ * return the data — use this when you only need the value to be available
+ * after hydration.
+ *
+ * @param queryClient - The React Query client used for SSR hydration.
+ * @param auth - The Better Auth server instance with the multi-session plugin.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `auth.api.listDeviceSessions`.
+ */
+export const prefetchListDeviceSessions = <
+  TAuth extends MultiSessionAuthServer
+>(
+  queryClient: QueryClient,
+  auth: TAuth,
+  userId: string,
+  params: ListDeviceSessionsParams<TAuth>
+) => queryClient.prefetchQuery(listDeviceSessionsOptions(auth, userId, params))
+
+/**
+ * Fetch and cache the current user's device sessions, resolving with the
+ * data or throwing on error. If a cached entry exists and is neither
+ * invalidated nor older than `staleTime`, the cached value is returned
+ * without a network call; otherwise the latest data is fetched.
+ *
+ * @param queryClient - The React Query client used for SSR hydration.
+ * @param auth - The Better Auth server instance with the multi-session plugin.
+ * @param userId - The signed-in user's ID, used for cache partitioning.
+ * @param params - Parameters forwarded to `auth.api.listDeviceSessions`.
+ */
+export const fetchListDeviceSessions = <TAuth extends MultiSessionAuthServer>(
+  queryClient: QueryClient,
+  auth: TAuth,
+  userId: string,
+  params: ListDeviceSessionsParams<TAuth>
+) => queryClient.fetchQuery(listDeviceSessionsOptions(auth, userId, params))