@krymskyimaksym/react-api-client 2.0.0-beta.0 → 2.0.0-beta.1

package/dist/index.d.mts

@@ -34,11 +34,23 @@ type QueryEntry<T> = {
     state: QueryState<T>;
     subscribers: Set<Listener$2>;
     inflight: Promise<T> | null;
+    inflightController: AbortController | null;
     gcTimer: ReturnType<typeof setTimeout> | null;
     staleTime: number;
     gcTime: number;
 };
-type QueryFn<T> = () => Promise<T>;
+type QueryFnContext = {
+    signal: AbortSignal;
+};
+/**
+ * queryFn принимает контекст с AbortSignal. Если HTTP-клиент его
+ * использует — отмена будет реальной; если игнорирует — поведение
+ * деградирует до текущего (запрос идёт до конца, но кэш игнорирует результат).
+ *
+ * Для обратной совместимости старая сигнатура `() => Promise<T>` тоже
+ * принимается — пакет просто не передаст signal внутрь.
+ */
+type QueryFn<T> = (ctx: QueryFnContext) => Promise<T>;
 type FetchOptions = {
     staleTime?: number;
     gcTime?: number;
@@ -51,6 +63,14 @@ type FetchOptions = {
  */
 declare class QueryCache {
     private entries;
+    private globalListeners;
+    /**
+     * Подписка на любое изменение кэша: setData, invalidate, remove,
+     * успешный/ошибочный fetch. Используется persistQueryClient и
+     * devtools-подобными адаптерами. Не дублирует `subscribe(key, ...)`.
+     */
+    subscribeAll(listener: Listener$2): () => void;
+    private notifyGlobal;
     private ensureEntry;
     getState<T>(key: QueryKey): QueryState<T> | undefined;
     getData<T>(key: QueryKey): T | undefined;
@@ -136,6 +156,18 @@ type ResponseWrapper<DataType, ErrorsType = unknown> = {
     errors?: ErrorsType;
 } & DataType;
 type UseFetchOptions<T, TSelected = T> = {
+    /**
+     * При `false`:
+     * - запрос НЕ инициируется (ни на mount, ни на focus/reconnect/poll);
+     * - но хук **подписан на ключ кэша** и перерисуется, если данные
+     *   обновит другой источник (другой `useFetch` с тем же ключом,
+     *   `setQueryData` / `invalidateQueries`, мутация, push-handler).
+     *
+     * То есть `enabled: false` превращает хук в read-only слушателя.
+     * Если нужно полностью «потушить» хук — просто не вызывай его.
+     *
+     * По умолчанию `true`.
+     */
     enabled?: boolean;
     refetchOnMount?: boolean;
     /** Refetch при возврате на экран / в браузерное окно. */
@@ -240,10 +272,12 @@ type UseMutationResult<TData, TVariables> = {
 interface IHttpClient {
     get<T>(url: string, config?: {
         params?: Record<string, unknown>;
+        signal?: AbortSignal;
     }): Promise<T>;
     request<T>(url: string, config: {
         method?: string;
         data?: Record<string, unknown>;
+        signal?: AbortSignal;
     }): Promise<T>;
 }
 type ApiClientConfig = {
@@ -260,7 +294,7 @@ type ApiClientConfig = {
 };
 type ApiClientReturn<ResponseType, RequestParamsType, ErrorResponseType = unknown> = {
     fetch: (params?: RequestParamsType) => Promise<ResponseWrapper<ResponseType, ErrorResponseType>>;
-    useFetch: (params?: RequestParamsType, options?: UseFetchOptions<ResponseWrapper<ResponseType, ErrorResponseType>>) => UseFetchResult<ResponseWrapper<ResponseType, ErrorResponseType>>;
+    useFetch: <TSelected = ResponseWrapper<ResponseType, ErrorResponseType>>(params?: RequestParamsType, options?: UseFetchOptions<ResponseWrapper<ResponseType, ErrorResponseType>, TSelected>) => UseFetchResult<TSelected>;
 };
 type ApiMutationReturn<ResponseType, RequestParamsType, ErrorResponseType = unknown> = {
     mutate: (params?: RequestParamsType) => Promise<ResponseWrapper<ResponseType, ErrorResponseType>>;
@@ -320,6 +354,21 @@ declare class ApiError<E = unknown> extends Error {
     readonly raw: unknown;
     constructor(init: ApiErrorInit<E>);
 }
+/**
+ * Конвертация произвольного throw'нутого значения в `ApiError`.
+ * Покрывает 4 кейса:
+ * - `ApiError` → passthrough
+ * - axios-like `{ response: { status, data } }` → ApiError с полями из data
+ * - `Error` (сетевая ошибка, таймаут) → ApiError(isNetworkError, status: 0)
+ * - неизвестный объект → ApiError(message: 'Unknown error', status: 0)
+ */
+declare function toApiError(thrown: unknown): ApiError;
+/**
+ * Для 2xx ответа, в теле которого Laravel-style `{ status: false }`.
+ * Возвращает ApiError(status: 200, ...). Вызывается из executeRequest
+ * только при `throwOnError: true`.
+ */
+declare function businessErrorToApiError(response: unknown): ApiError;
 
 /**
  * Storage-адаптер. Совместим с AsyncStorage и expo-secure-store:
@@ -350,14 +399,17 @@ type PersistOptions = {
 };
 /**
  * Подключает QueryClient к persistent storage.
- * Возвращает { restore, persist, unsubscribe }:
- * - `restore()` — гидратирует кэш из storage (вызывать на старте приложения).
+ *
+ * С версии 2.0.0 — подписан на `cache.subscribeAll`, поэтому
+ * автоматически сохраняет состояние через `throttleMs` после любого
+ * изменения (setData, успешный fetch, invalidate, remove). Ручной
+ * `persist()` остаётся доступным для критичных моментов (logout,
+ * shutdown), но в обычном потоке не нужен.
+ *
+ * Возвращает:
+ * - `restore()` — гидратирует кэш из storage. Вызывать на старте.
  * - `persist()` — форс-запись текущего состояния.
  * - `unsubscribe()` — отключить авто-сохранение.
- *
- * Простая модель: на каждое изменение через client.cache._debugEntries
- * нет подписки, поэтому persist вызываем вручную из мутаций / по таймеру.
- * Здесь — таймер по throttleMs. Этого хватает для чатов/архива.
  */
 declare function persistQueryClient(options: PersistOptions): {
     restore: () => Promise<void>;
@@ -494,4 +546,4 @@ declare function apiPaginate<ResponseType extends {
     totalExtractor?: (response: ResponseType) => number;
 }): ApiPaginateReturn<ResponseType, RequestParamsType, TData, ErrorResponseType>;
 
-export { type ApiClientConfig, ApiClientProvider, type ApiClientProviderProps, ApiError, type ApiErrorInit, type CacheEntrySnapshot, type DehydratedQuery, type DehydratedState, type FetchOptions, type IHttpClient, type PersistOptions, type PersistStorage, QueryCache, QueryClient, type QueryFn, type QueryKey, type QueryState, type QueryStatus, type ResponseWrapper, type UseFetchOptions, type UseFetchResult, type UseMutationOptions, type UseMutationResult, type UsePaginateOptions, type UsePaginateResult, apiMutation, apiPaginate, configureApiClient, apiClient as default, focusManager, getConfig, getQueryClient, hashQueryKey, inspectCache, invalidateAll, isConfigured, matchQueryKey, onlineManager, persistQueryClient, setQueryClient, summarizeCache, useQueryClient };
+export { type ApiClientConfig, ApiClientProvider, type ApiClientProviderProps, ApiError, type ApiErrorInit, type CacheEntrySnapshot, type DehydratedQuery, type DehydratedState, type FetchOptions, type IHttpClient, type PersistOptions, type PersistStorage, QueryCache, QueryClient, type QueryFn, type QueryKey, type QueryState, type QueryStatus, type ResponseWrapper, type UseFetchOptions, type UseFetchResult, type UseMutationOptions, type UseMutationResult, type UsePaginateOptions, type UsePaginateResult, apiMutation, apiPaginate, businessErrorToApiError, configureApiClient, apiClient as default, focusManager, getConfig, getQueryClient, hashQueryKey, inspectCache, invalidateAll, isConfigured, matchQueryKey, onlineManager, persistQueryClient, setQueryClient, summarizeCache, toApiError, useQueryClient };

package/dist/index.d.ts

@@ -34,11 +34,23 @@ type QueryEntry<T> = {
     state: QueryState<T>;
     subscribers: Set<Listener$2>;
     inflight: Promise<T> | null;
+    inflightController: AbortController | null;
     gcTimer: ReturnType<typeof setTimeout> | null;
     staleTime: number;
     gcTime: number;
 };
-type QueryFn<T> = () => Promise<T>;
+type QueryFnContext = {
+    signal: AbortSignal;
+};
+/**
+ * queryFn принимает контекст с AbortSignal. Если HTTP-клиент его
+ * использует — отмена будет реальной; если игнорирует — поведение
+ * деградирует до текущего (запрос идёт до конца, но кэш игнорирует результат).
+ *
+ * Для обратной совместимости старая сигнатура `() => Promise<T>` тоже
+ * принимается — пакет просто не передаст signal внутрь.
+ */
+type QueryFn<T> = (ctx: QueryFnContext) => Promise<T>;
 type FetchOptions = {
     staleTime?: number;
     gcTime?: number;
@@ -51,6 +63,14 @@ type FetchOptions = {
  */
 declare class QueryCache {
     private entries;
+    private globalListeners;
+    /**
+     * Подписка на любое изменение кэша: setData, invalidate, remove,
+     * успешный/ошибочный fetch. Используется persistQueryClient и
+     * devtools-подобными адаптерами. Не дублирует `subscribe(key, ...)`.
+     */
+    subscribeAll(listener: Listener$2): () => void;
+    private notifyGlobal;
     private ensureEntry;
     getState<T>(key: QueryKey): QueryState<T> | undefined;
     getData<T>(key: QueryKey): T | undefined;
@@ -136,6 +156,18 @@ type ResponseWrapper<DataType, ErrorsType = unknown> = {
     errors?: ErrorsType;
 } & DataType;
 type UseFetchOptions<T, TSelected = T> = {
+    /**
+     * При `false`:
+     * - запрос НЕ инициируется (ни на mount, ни на focus/reconnect/poll);
+     * - но хук **подписан на ключ кэша** и перерисуется, если данные
+     *   обновит другой источник (другой `useFetch` с тем же ключом,
+     *   `setQueryData` / `invalidateQueries`, мутация, push-handler).
+     *
+     * То есть `enabled: false` превращает хук в read-only слушателя.
+     * Если нужно полностью «потушить» хук — просто не вызывай его.
+     *
+     * По умолчанию `true`.
+     */
     enabled?: boolean;
     refetchOnMount?: boolean;
     /** Refetch при возврате на экран / в браузерное окно. */
@@ -240,10 +272,12 @@ type UseMutationResult<TData, TVariables> = {
 interface IHttpClient {
     get<T>(url: string, config?: {
         params?: Record<string, unknown>;
+        signal?: AbortSignal;
     }): Promise<T>;
     request<T>(url: string, config: {
         method?: string;
         data?: Record<string, unknown>;
+        signal?: AbortSignal;
     }): Promise<T>;
 }
 type ApiClientConfig = {
@@ -260,7 +294,7 @@ type ApiClientConfig = {
 };
 type ApiClientReturn<ResponseType, RequestParamsType, ErrorResponseType = unknown> = {
     fetch: (params?: RequestParamsType) => Promise<ResponseWrapper<ResponseType, ErrorResponseType>>;
-    useFetch: (params?: RequestParamsType, options?: UseFetchOptions<ResponseWrapper<ResponseType, ErrorResponseType>>) => UseFetchResult<ResponseWrapper<ResponseType, ErrorResponseType>>;
+    useFetch: <TSelected = ResponseWrapper<ResponseType, ErrorResponseType>>(params?: RequestParamsType, options?: UseFetchOptions<ResponseWrapper<ResponseType, ErrorResponseType>, TSelected>) => UseFetchResult<TSelected>;
 };
 type ApiMutationReturn<ResponseType, RequestParamsType, ErrorResponseType = unknown> = {
     mutate: (params?: RequestParamsType) => Promise<ResponseWrapper<ResponseType, ErrorResponseType>>;
@@ -320,6 +354,21 @@ declare class ApiError<E = unknown> extends Error {
     readonly raw: unknown;
     constructor(init: ApiErrorInit<E>);
 }
+/**
+ * Конвертация произвольного throw'нутого значения в `ApiError`.
+ * Покрывает 4 кейса:
+ * - `ApiError` → passthrough
+ * - axios-like `{ response: { status, data } }` → ApiError с полями из data
+ * - `Error` (сетевая ошибка, таймаут) → ApiError(isNetworkError, status: 0)
+ * - неизвестный объект → ApiError(message: 'Unknown error', status: 0)
+ */
+declare function toApiError(thrown: unknown): ApiError;
+/**
+ * Для 2xx ответа, в теле которого Laravel-style `{ status: false }`.
+ * Возвращает ApiError(status: 200, ...). Вызывается из executeRequest
+ * только при `throwOnError: true`.
+ */
+declare function businessErrorToApiError(response: unknown): ApiError;
 
 /**
  * Storage-адаптер. Совместим с AsyncStorage и expo-secure-store:
@@ -350,14 +399,17 @@ type PersistOptions = {
 };
 /**
  * Подключает QueryClient к persistent storage.
- * Возвращает { restore, persist, unsubscribe }:
- * - `restore()` — гидратирует кэш из storage (вызывать на старте приложения).
+ *
+ * С версии 2.0.0 — подписан на `cache.subscribeAll`, поэтому
+ * автоматически сохраняет состояние через `throttleMs` после любого
+ * изменения (setData, успешный fetch, invalidate, remove). Ручной
+ * `persist()` остаётся доступным для критичных моментов (logout,
+ * shutdown), но в обычном потоке не нужен.
+ *
+ * Возвращает:
+ * - `restore()` — гидратирует кэш из storage. Вызывать на старте.
  * - `persist()` — форс-запись текущего состояния.
  * - `unsubscribe()` — отключить авто-сохранение.
- *
- * Простая модель: на каждое изменение через client.cache._debugEntries
- * нет подписки, поэтому persist вызываем вручную из мутаций / по таймеру.
- * Здесь — таймер по throttleMs. Этого хватает для чатов/архива.
  */
 declare function persistQueryClient(options: PersistOptions): {
     restore: () => Promise<void>;
@@ -494,4 +546,4 @@ declare function apiPaginate<ResponseType extends {
     totalExtractor?: (response: ResponseType) => number;
 }): ApiPaginateReturn<ResponseType, RequestParamsType, TData, ErrorResponseType>;
 
-export { type ApiClientConfig, ApiClientProvider, type ApiClientProviderProps, ApiError, type ApiErrorInit, type CacheEntrySnapshot, type DehydratedQuery, type DehydratedState, type FetchOptions, type IHttpClient, type PersistOptions, type PersistStorage, QueryCache, QueryClient, type QueryFn, type QueryKey, type QueryState, type QueryStatus, type ResponseWrapper, type UseFetchOptions, type UseFetchResult, type UseMutationOptions, type UseMutationResult, type UsePaginateOptions, type UsePaginateResult, apiMutation, apiPaginate, configureApiClient, apiClient as default, focusManager, getConfig, getQueryClient, hashQueryKey, inspectCache, invalidateAll, isConfigured, matchQueryKey, onlineManager, persistQueryClient, setQueryClient, summarizeCache, useQueryClient };
+export { type ApiClientConfig, ApiClientProvider, type ApiClientProviderProps, ApiError, type ApiErrorInit, type CacheEntrySnapshot, type DehydratedQuery, type DehydratedState, type FetchOptions, type IHttpClient, type PersistOptions, type PersistStorage, QueryCache, QueryClient, type QueryFn, type QueryKey, type QueryState, type QueryStatus, type ResponseWrapper, type UseFetchOptions, type UseFetchResult, type UseMutationOptions, type UseMutationResult, type UsePaginateOptions, type UsePaginateResult, apiMutation, apiPaginate, businessErrorToApiError, configureApiClient, apiClient as default, focusManager, getConfig, getQueryClient, hashQueryKey, inspectCache, invalidateAll, isConfigured, matchQueryKey, onlineManager, persistQueryClient, setQueryClient, summarizeCache, toApiError, useQueryClient };

package/dist/index.js

@@ -36,6 +36,52 @@ var ApiError = class _ApiError extends Error {
     Object.setPrototypeOf(this, _ApiError.prototype);
   }
 };
+var isObject = (v) => typeof v === "object" && v !== null;
+function toApiError(thrown) {
+  if (thrown instanceof ApiError) return thrown;
+  if (isObject(thrown) && "response" in thrown && isObject(thrown.response)) {
+    const r = thrown.response;
+    const status = typeof r.status === "number" ? r.status : 0;
+    const data = isObject(r.data) ? r.data : void 0;
+    const message = (data && typeof data.message === "string" ? data.message : void 0) ?? (thrown instanceof Error ? thrown.message : void 0) ?? `HTTP ${status}`;
+    return new ApiError({
+      message,
+      status,
+      code: data && typeof data.code === "string" ? data.code : void 0,
+      errors: data?.errors,
+      isNetworkError: status === 0,
+      isUnauthorized: status === 401,
+      isValidationError: status === 422 || data?.errors !== void 0,
+      raw: r.data ?? thrown
+    });
+  }
+  if (thrown instanceof Error) {
+    return new ApiError({
+      message: thrown.message,
+      status: 0,
+      isNetworkError: true,
+      raw: thrown
+    });
+  }
+  return new ApiError({
+    message: "Unknown error",
+    status: 0,
+    raw: thrown
+  });
+}
+function businessErrorToApiError(response) {
+  if (!isObject(response)) {
+    return new ApiError({ message: "Request failed", status: 200, raw: response });
+  }
+  return new ApiError({
+    message: typeof response.message === "string" ? response.message : "Request failed",
+    status: 200,
+    code: typeof response.code === "string" ? response.code : void 0,
+    errors: response.errors,
+    isValidationError: response.errors !== void 0,
+    raw: response
+  });
+}
 
 // src/utils.ts
 function buildEndpoint(endpoint, params) {
@@ -44,7 +90,7 @@ function buildEndpoint(endpoint, params) {
   }
   return endpoint;
 }
-async function executeRequest(endpoint, fetchConfig, params) {
+async function executeRequest(endpoint, fetchConfig, params, signal) {
   const url = buildEndpoint(endpoint, params);
   const config = getConfig();
   try {
@@ -55,7 +101,8 @@ async function executeRequest(endpoint, fetchConfig, params) {
         params: {
           ...requestConfig.requestParams,
           ...params
-        }
+        },
+        signal
       });
     } else {
       response = await config.httpClient.request(url, {
@@ -63,38 +110,29 @@ async function executeRequest(endpoint, fetchConfig, params) {
         data: {
           ...requestConfig.requestParams,
           ...params
-        }
+        },
+        signal
       });
     }
     const hasExplicitStatus = response && typeof response === "object" && "status" in response && typeof response.status === "boolean";
     if (config.throwOnError && hasExplicitStatus && response.status === false) {
-      const body = response;
-      throw new ApiError({
-        message: body.message ?? "Request failed",
-        status: 200,
-        errors: body.errors,
-        raw: response
-      });
+      throw businessErrorToApiError(response);
     }
     return { ...response, status: true };
   } catch (e) {
-    if (e instanceof ApiError) throw e;
+    if (e instanceof ApiError) {
+      if (e.status === 401 && config.onUnauthorized) {
+        await config.onUnauthorized();
+      }
+      throw e;
+    }
     const error = e;
     const httpStatus = error.response?.status;
     if (httpStatus === 401 && config.onUnauthorized) {
       await config.onUnauthorized();
     }
     if (config.throwOnError) {
-      const data = error.response?.data;
-      const isNetwork = httpStatus === void 0;
-      throw new ApiError({
-        message: data?.message ?? (e instanceof Error ? e.message : void 0) ?? (isNetwork ? "Network error" : "Request error"),
-        status: httpStatus ?? 0,
-        code: data?.code,
-        errors: data,
-        isNetworkError: isNetwork,
-        raw: e
-      });
+      throw toApiError(e);
     }
     if (error.response?.data) {
       return {
@@ -255,6 +293,21 @@ var DEFAULT_STALE_TIME = 0;
 var QueryCache = class {
   constructor() {
     this.entries = /* @__PURE__ */ new Map();
+    this.globalListeners = /* @__PURE__ */ new Set();
+  }
+  /**
+   * Подписка на любое изменение кэша: setData, invalidate, remove,
+   * успешный/ошибочный fetch. Используется persistQueryClient и
+   * devtools-подобными адаптерами. Не дублирует `subscribe(key, ...)`.
+   */
+  subscribeAll(listener) {
+    this.globalListeners.add(listener);
+    return () => {
+      this.globalListeners.delete(listener);
+    };
+  }
+  notifyGlobal() {
+    for (const listener of this.globalListeners) listener();
   }
   ensureEntry(key, staleTime, gcTime) {
     const hash = hashQueryKey(key);
@@ -271,6 +324,7 @@ var QueryCache = class {
         },
         subscribers: /* @__PURE__ */ new Set(),
         inflight: null,
+        inflightController: null,
         gcTimer: null,
         staleTime: staleTime ?? DEFAULT_STALE_TIME,
         gcTime: gcTime ?? DEFAULT_GC_TIME
@@ -319,6 +373,7 @@ var QueryCache = class {
   }
   notify(entry) {
     for (const listener of entry.subscribers) listener();
+    this.notifyGlobal();
   }
   scheduleGc(entry) {
     if (entry.gcTimer) clearTimeout(entry.gcTimer);
@@ -347,12 +402,14 @@ var QueryCache = class {
     if (entry.inflight) return entry.inflight;
     entry.state = { ...entry.state, status: "loading", error: null };
     this.notify(entry);
+    const controller = new AbortController();
     const token = Symbol("inflight");
     entry.inflightToken = token;
+    entry.inflightController = controller;
     const isCurrent = () => entry.inflightToken === token;
     const myPromise = (async () => {
       try {
-        const data = await queryFn();
+        const data = await queryFn({ signal: controller.signal });
         if (!isCurrent()) return data;
         entry.state = {
           data,
@@ -373,7 +430,10 @@ var QueryCache = class {
         this.notify(entry);
         throw err;
       } finally {
-        if (isCurrent()) entry.inflight = null;
+        if (isCurrent()) {
+          entry.inflight = null;
+          entry.inflightController = null;
+        }
       }
     })();
     entry.inflight = myPromise;
@@ -405,6 +465,8 @@ var QueryCache = class {
     const match = typeof predicate === "function" ? predicate : (k) => matchQueryKey(predicate, k);
     for (const entry of this.entries.values()) {
       if (match(entry.key) && entry.inflight) {
+        entry.inflightController?.abort();
+        entry.inflightController = null;
         entry.inflight = null;
         entry.inflightToken = void 0;
         if (entry.state.status === "loading") {
@@ -420,12 +482,15 @@ var QueryCache = class {
    */
   remove(predicate) {
     const match = typeof predicate === "function" ? predicate : (k) => matchQueryKey(predicate, k);
+    let removed = false;
     for (const [hash, entry] of [...this.entries]) {
       if (match(entry.key)) {
         if (entry.gcTimer) clearTimeout(entry.gcTimer);
         this.entries.delete(hash);
+        removed = true;
       }
     }
+    if (removed) this.notifyGlobal();
   }
   /** Только для тестов / DevTools. */
   _debugEntries() {
@@ -530,18 +595,26 @@ function createUseFetch(endpoint, fetchConfig) {
     }, [customKey ? hashQueryKey(customKey) : null, serializedParams]);
     const client = getQueryClient();
     const cache = client.cache;
-    const queryFn = react.useCallback(() => {
-      const parsedParams = serializedParams ? JSON.parse(serializedParams) : void 0;
-      return executeRequest(endpoint, fetchConfig, parsedParams);
-    }, [serializedParams]);
+    const queryFn = react.useCallback(
+      ({ signal }) => {
+        const parsedParams = serializedParams ? JSON.parse(serializedParams) : void 0;
+        return executeRequest(endpoint, fetchConfig, parsedParams, signal);
+      },
+      [serializedParams]
+    );
     const initialState = cache.getState(queryKey);
     const [, forceRender] = react.useState(0);
     const rerender = react.useCallback(() => forceRender((v) => v + 1), []);
     react.useEffect(() => {
-      if (!enabled) return;
       const unsub = cache.subscribe(queryKey, rerender);
-      return unsub;
-    }, [cache, enabled, hashQueryKey(queryKey), rerender]);
+      return () => {
+        unsub();
+        const state2 = cache._debugEntries().get(hashQueryKey(queryKey));
+        if (state2 && state2.subscribers.size === 0 && state2.inflight) {
+          cache.cancelQueries(queryKey);
+        }
+      };
+    }, [cache, hashQueryKey(queryKey), rerender]);
     const lastNotifiedRef = react.useRef({});
     const runFetch = react.useCallback(
       async (force) => {
@@ -801,14 +874,14 @@ function createUsePaginate(endpoint, fetchConfig, options) {
       [keyPrefix, limit]
     );
     const pageQueryFn = react.useCallback(
-      (page) => () => {
+      (page) => ({ signal }) => {
         const parsedParams = serializedParams ? JSON.parse(serializedParams) : {};
         const requestParams = {
           ...parsedParams,
           page,
           limit
         };
-        return executeRequest(endpoint, fetchConfig, requestParams);
+        return executeRequest(endpoint, fetchConfig, requestParams, signal);
       },
       [serializedParams, limit]
     );
@@ -939,19 +1012,26 @@ function persistQueryClient(options) {
     maxAge,
     version
   } = options;
-  let timer = null;
+  let pendingTimer = null;
   let lastSerialized = null;
+  let unsubscribed = false;
   const persist = async () => {
     const state = client.cache.dehydrate(allowList);
-    if (state.queries.length === 0) {
-      return;
-    }
+    if (state.queries.length === 0) return;
     const snap = { version, savedAt: Date.now(), state };
     const serialized = JSON.stringify(snap);
     if (serialized === lastSerialized) return;
     lastSerialized = serialized;
     await storage.setItem(storageKey, serialized);
   };
+  const scheduleWrite = () => {
+    if (unsubscribed) return;
+    if (pendingTimer) return;
+    pendingTimer = setTimeout(() => {
+      pendingTimer = null;
+      void persist();
+    }, throttleMs);
+  };
   const restore = async () => {
     const raw = await storage.getItem(storageKey);
     if (!raw) return;
@@ -970,15 +1050,17 @@ function persistQueryClient(options) {
       await storage.removeItem(storageKey);
     }
   };
-  timer = setInterval(() => {
-    void persist();
-  }, throttleMs);
+  const unsubscribeFromCache = client.cache.subscribeAll(scheduleWrite);
   return {
     restore,
     persist,
     unsubscribe: () => {
-      if (timer) clearInterval(timer);
-      timer = null;
+      unsubscribed = true;
+      unsubscribeFromCache();
+      if (pendingTimer) {
+        clearTimeout(pendingTimer);
+        pendingTimer = null;
+      }
     }
   };
 }
@@ -1085,6 +1167,7 @@ exports.QueryCache = QueryCache;
 exports.QueryClient = QueryClient;
 exports.apiMutation = apiMutation;
 exports.apiPaginate = apiPaginate;
+exports.businessErrorToApiError = businessErrorToApiError;
 exports.configureApiClient = configureApiClient;
 exports.default = index_default;
 exports.focusManager = focusManager;
@@ -1099,6 +1182,7 @@ exports.onlineManager = onlineManager;
 exports.persistQueryClient = persistQueryClient;
 exports.setQueryClient = setQueryClient;
 exports.summarizeCache = summarizeCache;
+exports.toApiError = toApiError;
 exports.useQueryClient = useQueryClient;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map