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 = InferData< TAuthClient["listSessions"] > export type ListSessionsParams = Parameters< TAuthClient["listSessions"] >[0] export type ListSession = NonNullable>[number] export type ListSessionsOptions = Omit< ReturnType>, "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( authClient: TAuthClient, userId: string | undefined, params?: ListSessionsParams ) { type TData = ListSessionsData const queryKey = authQueryKeys.listSessions(userId, params?.query) const options = queryOptions( { queryKey, queryFn: ({ signal }) => authClient.listSessions({ ...params, fetchOptions: { ...params?.fetchOptions, signal, throw: true } }) as Promise } ) return options as typeof options & { queryKey: DataTag } } /** * 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 = ( queryClient: QueryClient, authClient: TAuthClient, userId: string, params?: ListSessionsParams ) => 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 = ( queryClient: QueryClient, authClient: TAuthClient, userId: string, params?: ListSessionsParams ) => 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 = ( queryClient: QueryClient, authClient: TAuthClient, userId: string, params?: ListSessionsParams ) => queryClient.fetchQuery(listSessionsOptions(authClient, userId, params)) export type UseListSessionsOptions = ListSessionsOptions & ListSessionsParams /** * 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( authClient: TAuthClient, options: UseListSessionsOptions = {}, 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 ) }