Data Retrieval Hooks

Under the hood, the React Native SDK leverages `react-query` (https://tanstack.com/query/v4/docs/overview) for data fetching and caching. In order to pass as much power to the end developer, the React Native SDK includes optionally declaring query options for each hook that uses `react-query.` Additionally, every hook that uses `react-query` returns an object that contains the result as well as `fetchDetails,` which passes along useful information such as when the query is fetching, when it has reached an error, and much more.

📄️ Fetch Details

Every hook that leverages react-query behind the scenes returns an object which contains the requested information, as well as information on the request itself. This looks like:

📄️ Query Keys

React query leverages query keys to simplify caching and rehydrating queries. In most cases the React Native SDK is responsible for knowing when to invalidated a query and refetch it. However, if there a specific case where a query needs to be invalidated then each query has its own query key that can be used to invalidate it like so:

📄️ Query Options

Every hook that leverages react-query behind the scenes exposes an optional argument to override details about the query.