import { Identifier, PaginationPayload, SortPayload, Record } from '../types'; import { Refetch } from './useQueryWithStore'; interface UseGetMatchingOptions { onSuccess?: (args?: any) => void; onFailure?: (error: any) => void; enabled?: boolean; [key: string]: any; } /** * Call the dataProvider.getList() method return the resolved result * as well as the loading state. * * React-admin uses a different store location for the result of this query * than for useGetList(). Therefore, calling useGetMatching() does not modify * the ids and total for the resource. * * The return value updates according to the request state: * * - start: { loading: true, loaded: false, refetch } * - success: { data: [data from store], ids: [ids from response], total: [total from response], loading: false, loaded: true, refetch } * - error: { error: [error from response], loading: false, loaded: 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 referenced resource name, e.g. 'tags' * @param {Object} pagination The request pagination { page, perPage }, e.g. { page: 1, perPage: 10 } * @param {Object} sort The request sort { field, order }, e.g. { field: 'id', order: 'DESC' } * @param {Object} filter The request filters, e.g. { title: 'hello, world' } * @param {string} source The field in resource containing the ids of the referenced records, e.g. 'tag_ids' * @param {string} referencingResource The resource name, e.g. 'posts'. Used to build a cache key * @param {Object} options Options object to pass to the dataProvider. * @param {boolean} options.enabled Flag to conditionally run the query. If it's false, the query will not run * @param {Function} options.onSuccess Side effect function to be executed upon success, e.g. { onSuccess: { refresh: true } } * @param {Function} options.onFailure Side effect function to be executed upon failure, e.g. { onFailure: error => notify(error.message) } * * @returns The current request state. Destructure as { data, total, ids, error, loading, loaded, refetch }. * * @example * * import { useGetMatching } from '../app'; * * const PostTags = () => { * // call dataProvider.getList('tags', { pagination: { page: 1, perPage: 10 }, sort: { { field: 'published_at', order: 'DESC' } } }) * const { data, loading, error } = useGetMatching( * 'tags', * { page: 1, perPage: 10 }, * { field: 'published_at', order: 'DESC' }, * {}, * 'tag_ids', * 'posts', * ); * if (loading) { return ; } * if (error) { return

ERROR

; } * return ; * }; */ declare const useGetMatching: (resource: string, pagination: PaginationPayload, sort: SortPayload, filter: object, source: string, referencingResource: string, options?: UseGetMatchingOptions) => UseGetMatchingResult; interface UseGetMatchingResult { data: Record[]; ids: Identifier[]; total: number; error?: any; loading: boolean; loaded: boolean; refetch: Refetch; } export default useGetMatching;