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 ListSessionsData = Awaited< ReturnType > export type ListSessionsParams = Parameters< TAuth["api"]["listSessions"] >[0] export type ListSession = NonNullable< ListSessionsData >[number] /** * Query options factory for the current user's active sessions. * * @param auth - The Better Auth server instance. * @param userId - The signed-in user's ID. Used for cache partitioning so * the key matches the client-side `listSessionsOptions` for SSR hydration. * @param params - Parameters forwarded to `auth.api.listSessions`. */ export function listSessionsOptions( auth: TAuth, userId: string, params: ListSessionsParams ) { type TData = ListSessionsData const queryKey = authQueryKeys.listSessions(userId, params?.query) const options = queryOptions({ queryKey, queryFn: () => auth.api.listSessions(params) 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 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. * @param userId - The signed-in user's ID, used for cache partitioning. * @param params - Parameters forwarded to `auth.api.listSessions`. */ export const ensureListSessions = ( queryClient: QueryClient, auth: TAuth, userId: string, params: ListSessionsParams ) => queryClient.ensureQueryData(listSessionsOptions(auth, 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 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 userId - The signed-in user's ID, used for cache partitioning. * @param params - Parameters forwarded to `auth.api.listSessions`. */ export const prefetchListSessions = ( queryClient: QueryClient, auth: TAuth, userId: string, params: ListSessionsParams ) => queryClient.prefetchQuery(listSessionsOptions(auth, 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 used for SSR hydration. * @param auth - The Better Auth server instance. * @param userId - The signed-in user's ID, used for cache partitioning. * @param params - Parameters forwarded to `auth.api.listSessions`. */ export const fetchListSessions = ( queryClient: QueryClient, auth: TAuth, userId: string, params: ListSessionsParams ) => queryClient.fetchQuery(listSessionsOptions(auth, userId, params))