QueryClient

An enhanced version of TanStack's Query QueryClient.
Adds specialized configurations for library entities like Query or Mutation.

Reference to source code

API Signature

import { QueryClient } from "@tanstack/query-core";

class QueryClient extends QueryClient {
  constructor(config?: QueryClientConfig);
}

Configuration

When creating an instance, you can provide:

import { DefaultOptions } from '@tanstack/query-core';

interface QueryClientConfig {
  defaultOptions?: DefaultOptions & {
    queries: QueryFeatures;
    mutations: MobxMutatonFeatures;
  };
  hooks?: QueryClientHooks;
}

Key methods and properties

queryFeatures

Features configurations exclusively for Query/InfiniteQuery

mutationFeatures

Features configurations exclusively for Mutation

hooks

Entity lifecycle events. Available hooks:

Hook	Description
onQueryInit	Triggered when a Query is created
onInfiniteQueryInit	Triggered when a InfiniteQuery is created
onMutationInit	Triggered when a Mutation is created
onQueryDestroy	Triggered when a Query is destroyed
onInfiniteQueryDestroy	Triggered when a InfiniteQuery is destroyed
onMutationDestroy	Triggered when a Mutation is destroyed

Inheritance

QueryClient inherits all methods and properties from QueryClient, including:

• getQueryData()
• setQueryData()
• invalidateQueries()
• prefetchQuery()
• cancelQueries()
• And others (see official documentation)

Usage Example

import { QueryClient } from 'mobx-tanstack-query';

// Create a client with custom hooks
const client = new QueryClient({
  hooks: {
    onQueryInit: (query) => {
      console.log('[Init] Query:', query.queryKey);
    },
    onMutationDestroy: (mutation) => {
      console.log('[Destroy] Mutation:', mutation.options.mutationKey);
    }
  },
  defaultOptions: {
    queries: {
      enableOnDemand: true,
    },
    mutations: {
      invalidateByKey: true,
    }
  },
});

// Use standard QueryClient methods
const data = client.getQueryData(['todos']);

When to Use?

Use QueryClient if you need:

• Customization of query/mutation lifecycle
• Tracking entity initialization/destruction events
• Advanced configuration for MobX-powered queries and mutations.