import { useMemo } from 'react'; import { useQuery, UseQueryOptions, UseQueryResult, useQueryClient, } from 'react-query'; import { RaRecord, GetListParams, GetListResult } from '../types'; import { useDataProvider } from './useDataProvider'; /** * Call the dataProvider.getList() method and return the resolved result * as well as the loading state. * * The return value updates according to the request state: * * - start: { isLoading: true, refetch } * - success: { data: [data from store], total: [total from response], isLoading: false, refetch } * - error: { error: [error from response], isLoading: false, refetch } * * This hook will return the cached result when called a second time * with the same parameters, until the response arrives. * * @param {string} resource The resource name, e.g. 'posts' * @param {Params} params The getList parameters { pagination, sort, filter, meta } * @param {Object} options Options object to pass to the queryClient. * May include side effects to be executed upon success or failure, e.g. { onSuccess: () => { refresh(); } } * * @typedef Params * @prop params.pagination The request pagination { page, perPage }, e.g. { page: 1, perPage: 10 } * @prop params.sort The request sort { field, order }, e.g. { field: 'id', order: 'DESC' } * @prop params.filter The request filters, e.g. { title: 'hello, world' } * @prop params.meta Optional meta parameters * * @returns The current request state. Destructure as { data, total, error, isLoading, refetch }. * * @example * * import { useGetList } from 'mv-tmp'; * * const LatestNews = () => { * const { data, total, isLoading, error } = useGetList( * 'posts', * { pagination: { page: 1, perPage: 10 }, sort: { field: 'published_at', order: 'DESC' } } * ); * if (isLoading) { return ; } * if (error) { return

ERROR

; } * return ; * }; */ export const useGetList = ( resource: string, params: Partial = {}, options?: UseQueryOptions, Error> ): UseGetListHookValue => { const { pagination = { page: 1, perPage: 25 }, sort = { field: 'id', order: 'DESC' }, filter = {}, meta, } = params; const dataProvider = useDataProvider(); const queryClient = useQueryClient(); const result = useQuery< GetListResult, Error, GetListResult >( [resource, 'getList', { pagination, sort, filter, meta }], () => dataProvider .getList(resource, { pagination, sort, filter, meta, }) .then(({ data, total, pageInfo }) => ({ data, total, pageInfo, })), { ...options, onSuccess: value => { const { data } = value; // optimistically populate the getOne cache data.forEach(record => { queryClient.setQueryData( [resource, 'getOne', { id: String(record.id), meta }], oldRecord => oldRecord ?? record ); }); // execute call-time onSuccess if provided if (options?.onSuccess) { options.onSuccess(value); } }, } ); return useMemo( () => result.data ? { ...result, data: result.data?.data, total: result.data?.total, pageInfo: result.data?.pageInfo, } : result, [result] ) as UseQueryResult & { total?: number; pageInfo?: { hasNextPage?: boolean; hasPreviousPage?: boolean; }; }; }; export type UseGetListHookValue< RecordType extends RaRecord = any > = UseQueryResult & { total?: number; pageInfo?: { hasNextPage?: boolean; hasPreviousPage?: boolean; }; };