Groups & cache access

Invalidate a group of queries

A factory registers every query it creates, so you can refetch them together — the effector-flavored equivalent of queryClient.invalidateQueries:

import { createQueryFactory } from 'effector-refetch';

const { createQuery, invalidate } = createQueryFactory();

const todos = createQuery({ effect: fetchTodosFx });
const profile = createQuery({ effect: fetchProfileFx });

// refetch every query that has run
invalidate();

// or narrow with a predicate (receives the query object)
invalidate({ predicate: (q) => q === todos });

invalidate is a plain event — scope-correct (allSettled(invalidate, { scope }) for SSR/tests) and composable: sample({ clock: loggedOut, target: invalidate }). Only queries that have already run are refetched, with their last params.

Need separate groups? Use multiple factories.

Read & write cache imperatively

import { getQueryData, setQueryData } from 'effector-refetch';

const todos = getQueryData(todosQuery); // current $data
setQueryData(todosQuery, (prev) => [...(prev ?? []), newTodo]); // value or (prev) => next

These read/write the no-scope store — for a single client app. In scoped code read scope.getState(query.$data), and prefer the update / optimisticUpdate operators (they're scope-correct).

gcTime?

TanStack's gcTime evicts cache entries once they have no observers. effector-refetch doesn't track observers (queries are plain units, not subscriptions), so the closest knob is age-based eviction on the adapter: inMemoryCache({ maxAge }) / localStorageCache({ maxAge }), plus maxEntries for an LRU cap.