Performance

// Import only what you need
import { QueryClient } from '@soulcache/core';
import { useQuery } from '@soulcache/react';

// Good: Import specific exports
import { QueryClient, CacheEngine } from '@soulcache/core';
import { useQuery } from '@soulcache/react';
 
// All packages declare sideEffects: false

const client = new QueryClient({
  defaultOptions: {
    staleTime: 5 * 60 * 1000, // 5 minutes
    gcTime: 30 * 60 * 1000, // 30 minutes
  },
});

// staleTime is configured on the QueryClient
const client = new QueryClient({
  defaultOptions: {
    staleTime: 5 * 60 * 1000, // 5 minutes
  },
});

// Manual garbage collection
client.getCache().collectGarbage();
 
// Automatic with gcTime
const client = new QueryClient({
  defaultOptions: {
    gcTime: 5 * 60 * 1000, // 5 minutes (override)
  },
});

// Always unsubscribe
const unsubscribe = client.subscribe(['users'], callback);
 
// Cleanup when done
unsubscribe();

// Automatic deduplication
const p1 = client.fetchQuery({ queryKey: ['users'], queryFn });
const p2 = client.fetchQuery({ queryKey: ['users'], queryFn });
 
// Only one network request
const [data1, data2] = await Promise.all([p1, p2]);

// Requests are coalesced automatically
for (let i = 0; i < 10; i++) {
  client.fetchQuery({ queryKey: ['users'], queryFn });
}
// Only one network request

// Get cache statistics
const stats = client.getCache().getStats();
console.log('Cache size:', stats.size);
console.log('Active entries:', stats.activeEntries);
 
// Get query metrics
const metrics = client.getScheduler().getMetrics();
console.log('Tasks completed:', metrics.totalCompleted);