@ryuzaki13/react-foundation-ui 1.8.10 → 1.8.12

package/storybook-static/assets/README-Dl92E69Z.js

@@ -0,0 +1,1704 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,blockquote:`blockquote`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,h4:`h4`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Infrastructure/Query Client`}),`
+`,(0,c.jsx)(t.h1,{id:`query-client`,children:`Query Client`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/query-client`}),` предоставляет общую инфраструктуру TanStack Query для browser-приложения:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`создаёт настроенный `,(0,c.jsx)(t.code,{children:`QueryClient`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`подключает глобальную обработку query/mutation errors;`}),`
+`,(0,c.jsx)(t.li,{children:`сохраняет только явно разрешённые query в IndexedDB;`}),`
+`,(0,c.jsx)(t.li,{children:`разделяет публичный persistent cache и данные текущей серверной сессии;`}),`
+`,(0,c.jsx)(t.li,{children:`сбрасывает session-scoped query при смене пользователя или авторизации;`}),`
+`,(0,c.jsx)(t.li,{children:`синхронизирует cache data и invalidation между вкладками;`}),`
+`,(0,c.jsx)(t.li,{children:`предоставляет низкоуровневые helpers для optimistic update и rollback.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика без доступа к исходному коду и с минимальным знанием JavaScript, TypeScript и TanStack Query. Здесь описаны установка, инициализация, жизненный цикл данных, точное поведение функций, ограничения browser API и полный публичный API.`}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsx)(t.p,{children:`Ранее optimistic update был описан отдельным документом. Теперь весь смысл, примеры, ограничения и API находятся только на этой странице.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,children:`Назначение и границы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-build-time-constants`,children:`Обязательные build-time constants`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F-tanstack-query`,children:`Основные понятия TanStack Query`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%B0%D0%BA-%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C-cache-strategy`,children:`Как выбрать cache strategy`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82`,children:`Быстрый старт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-queryclient`,children:`Создание QueryClient`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#query-metadata`,children:`Query metadata`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-project-adapter`,children:`Настройка project adapter`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#indexeddb-persistence`,children:`IndexedDB persistence`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#session-scoped-query`,children:`Session-scoped query`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%81%D0%B8%D0%BD%D1%85%D1%80%D0%BE%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D0%BC%D0%B5%D0%B6%D0%B4%D1%83-%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B0%D0%BC%D0%B8`,children:`Синхронизация между вкладками`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#optimistic-update`,children:`Optimistic update`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D0%B8-%D1%81%D0%B5%D1%80%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F`,children:`Безопасность и сериализация`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#browser-ssr-%D0%B8-lifecycle`,children:`Browser, SSR и lifecycle`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-consumer-%D0%BA%D0%BE%D0%B4%D0%B0`,children:`Тестирование consumer-кода`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D0%B0%D1%8F-%D0%BA%D0%B0%D1%80%D1%82%D0%B0-api`,children:`Полная карта API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D0%B0%D1%81%D1%82%D1%8B%D0%B5-%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D1%8B`,children:`Частые вопросы`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsx)(t.h3,{id:`что-делает-модуль`,children:`Что делает модуль`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`queryOptions/useQuery/useMutation
+             │
+             ▼
+        QueryClient
+       /     │      \\
+      /      │       \\
+ IndexedDB  Broadcast  session reset
+ persistence  channels  и optimistic cache
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль управляет инфраструктурным поведением TanStack Query cache. Он знает, как создать client, где хранить opt-in query, как передать cache event другой вкладке и как откатить optimistic patch.`}),`
+`,(0,c.jsx)(t.h3,{id:`что-модуль-не-делает`,children:`Что модуль не делает`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не является transport или бизнес-слоем:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`не выполняет `,(0,c.jsx)(t.code,{children:`fetch`}),` сам по себе;`]}),`
+`,(0,c.jsx)(t.li,{children:`не знает URL backend;`}),`
+`,(0,c.jsx)(t.li,{children:`не добавляет SSO credentials и X-CSRF token;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не строит OData path, `,(0,c.jsx)(t.code,{children:`$filter`}),` или payload;`]}),`
+`,(0,c.jsx)(t.li,{children:`не создаёт query keys конкретной entity;`}),`
+`,(0,c.jsx)(t.li,{children:`не решает, какие данные безопасно сохранять;`}),`
+`,(0,c.jsx)(t.li,{children:`не показывает notification пользователю;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не заменяет `,(0,c.jsx)(t.code,{children:`QueryClientProvider`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не создаёт singleton автоматически.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Используйте правильного владельца:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Задача`}),(0,c.jsx)(t.th,{children:`Владелец`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`QueryClient, persistence, broadcast, session reset`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/query-client`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`HTTP/OData transport и operation`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),` или `,(0,c.jsx)(t.code,{children:`/http`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Query key и query options сущности`}),(0,c.jsx)(t.td,{children:`entity/feature API consumer-проекта`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`UI loading/error/empty state`}),(0,c.jsx)(t.td,{children:`component/feature consumer-проекта`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Service Worker HTTP cache`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/pwa`}),` и host SW policy`]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`три-разных-cache-механизма`,children:`Три разных cache-механизма`}),`
+`,(0,c.jsx)(t.p,{children:`Не смешивайте:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Механизм`}),(0,c.jsx)(t.th,{children:`Что хранит`}),(0,c.jsx)(t.th,{children:`Где живёт`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Query cache`}),(0,c.jsx)(t.td,{children:`Backend snapshot и состояние query`}),(0,c.jsx)(t.td,{children:`В памяти текущей вкладки`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Query persistence`}),(0,c.jsx)(t.td,{children:`Выбранные уже полученные query data`}),(0,c.jsx)(t.td,{children:`IndexedDB`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Service Worker cache`}),(0,c.jsx)(t.td,{children:`HTTP response/request на transport-уровне`}),(0,c.jsx)(t.td,{children:`Cache Storage в Service Worker`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Broadcast не является четвёртым хранилищем. Он только передаёт изменения между уже работающими вкладками.`}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.p,{children:`Установите foundation-пакет и совместимые peer dependencies:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib
+npm install react @tanstack/react-query \\
+  @tanstack/query-persist-client-core \\
+  @tanstack/query-broadcast-client-experimental
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Публичный импорт:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createQueryClient, persistedQueryMeta, sessionScopedQueryMeta } from "@ryuzaki13/react-foundation-lib/query-client";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Типы импортируйте через `,(0,c.jsx)(t.code,{children:`import type`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { AppQueryMeta, OptimisticContext, QueryBroadcastOptions } from "@ryuzaki13/react-foundation-lib/query-client";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Неверные импорты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Корневой entrypoint пакета не опубликован.
+import { createQueryClient } from "@ryuzaki13/react-foundation-lib";
+
+// Внутреннее устройство dist не является публичным API.
+import { createQueryClient } from "@ryuzaki13/react-foundation-lib/dist/query-client/queryClient";
+
+// Это локальный alias чужого приложения, а не package contract.
+import { createQueryClient } from "@/shared/lib";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль распространяется как ESM. Используйте `,(0,c.jsx)(t.code,{children:`import`}),`, а не CommonJS `,(0,c.jsx)(t.code,{children:`require`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`обязательные-build-time-constants`,children:`Обязательные build-time constants`}),`
+`,(0,c.jsx)(t.p,{children:`Entry point использует constants, которые host-сборка должна определить:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare const __APP_ID__: string;
+declare const __DEV__: boolean;
+declare const __REACT_QUERY_PERSISTENCE_BUSTER__: string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Они нужны для namespacing IndexedDB и cache busting.`}),`
+`,(0,c.jsx)(t.h3,{id:`пример-vite-define`,children:`Пример Vite define`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { defineConfig } from "vite";
+
+export default defineConfig(({ mode }) => ({
+	define: {
+		__APP_ID__: JSON.stringify("sales-app"),
+		__DEV__: JSON.stringify(mode === "development"),
+		__REACT_QUERY_PERSISTENCE_BUSTER__: JSON.stringify("sales-app.query-cache.v1")
+	}
+}));
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это compile-time replacement. Не нужно писать:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`window.__APP_ID__ = "sales-app";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Такое присваивание не заменяет Vite `,(0,c.jsx)(t.code,{children:`define`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`REACT_QUERY_PERSISTENCE_BUSTER`}),` вычисляется на верхнем уровне модуля из `,(0,c.jsx)(t.code,{children:`__REACT_QUERY_PERSISTENCE_BUSTER__`}),`. Поэтому buster должен быть определён уже при сборке/import entrypoint, даже если persistence позже не включится из-за отсутствия IndexedDB.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-выбирать-buster`,children:`Как выбирать buster`}),`
+`,(0,c.jsx)(t.p,{children:`Buster — строковая версия формата persistent cache:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sales-app.query-cache.v1
+sales-app.query-cache.v2
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Повышайте версию, когда старые записи несовместимы с новым приложением:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`изменилась структура persisted data;`}),`
+`,(0,c.jsx)(t.li,{children:`изменился mapping ответа;`}),`
+`,(0,c.jsx)(t.li,{children:`изменился смысл query key;`}),`
+`,(0,c.jsx)(t.li,{children:`старый cache нельзя безопасно использовать.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не меняйте buster при каждой сборке без причины: это уничтожит пользу persistence.`}),`
+`,(0,c.jsx)(t.h2,{id:`основные-понятия-tanstack-query`,children:`Основные понятия TanStack Query`}),`
+`,(0,c.jsx)(t.h3,{id:`query`,children:`Query`}),`
+`,(0,c.jsx)(t.p,{children:`Query — описание чтения backend data:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const options = {
+	queryKey: ["products", { company: "1000" }],
+	queryFn: fetchProducts
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Query содержит key, функцию загрузки, состояние, data, timestamps и metadata.`}),`
+`,(0,c.jsx)(t.h3,{id:`query-key`,children:`Query key`}),`
+`,(0,c.jsx)(t.p,{children:`Query key — identity данных в cache:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const productsKey = ["products", { company: "1000" }] as const;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Все параметры, влияющие на результат, должны входить в key. Иначе разные запросы могут записать данные в одну cache entry.`}),`
+`,(0,c.jsx)(t.p,{children:`Хороший key:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`стабилен;`}),`
+`,(0,c.jsx)(t.li,{children:`сериализуем;`}),`
+`,(0,c.jsx)(t.li,{children:`не содержит token, password или session secret;`}),`
+`,(0,c.jsx)(t.li,{children:`различает все варианты результата;`}),`
+`,(0,c.jsx)(t.li,{children:`принадлежит owner-у query.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`queryclient`,children:`QueryClient`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`QueryClient`}),` управляет query/mutation cache:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryClient.getQueryData(queryKey);
+queryClient.setQueryData(queryKey, nextData);
+queryClient.invalidateQueries({ queryKey });
+queryClient.cancelQueries({ queryKey });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В SPA обычно создают один экземпляр на всё приложение и передают в `,(0,c.jsx)(t.code,{children:`QueryClientProvider`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`observer-и-active-query`,children:`Observer и active query`}),`
+`,(0,c.jsxs)(t.p,{children:[`Query считается active, когда у неё есть активный observer — обычно смонтированный `,(0,c.jsx)(t.code,{children:`useQuery`}),` с `,(0,c.jsx)(t.code,{children:`enabled !== false`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Query может оставаться в cache без component-подписки. Тогда она inactive.`}),`
+`,(0,c.jsx)(t.p,{children:`Различие важно для:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`refetchType`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`session reset;`}),`
+`,(0,c.jsx)(t.li,{children:`garbage collection;`}),`
+`,(0,c.jsx)(t.li,{children:`фонового обновления.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`fresh-stale-и-invalidated`,children:`Fresh, stale и invalidated`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Fresh: данные моложе `,(0,c.jsx)(t.code,{children:`staleTime`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Stale: данные можно показывать, но TanStack Query может обновить их.`}),`
+`,(0,c.jsx)(t.li,{children:`Invalidated: client явно отметил query устаревшей.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Stale не означает «удалена». Data может продолжать отображаться до refetch.`}),`
+`,(0,c.jsxs)(t.h3,{id:`staletime-и-gctime`,children:[(0,c.jsx)(t.code,{children:`staleTime`}),` и `,(0,c.jsx)(t.code,{children:`gcTime`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`staleTime`}),` отвечает за свежесть.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`gcTime`}),` отвечает за время хранения неактивной query в памяти до garbage collection.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Они не задают срок хранения IndexedDB. Persistent срок отдельно задаёт `,(0,c.jsx)(t.code,{children:`REACT_QUERY_PERSISTENCE_MAX_AGE`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`query-data--backend-state`,children:`Query data — backend state`}),`
+`,(0,c.jsx)(t.p,{children:`Не копируйте backend snapshot одновременно в Query cache, Zustand и React state. Обычно:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`backend data живёт в Query cache;`}),`
+`,(0,c.jsx)(t.li,{children:`draft формы — в React/form state;`}),`
+`,(0,c.jsx)(t.li,{children:`URL filters — в Router search;`}),`
+`,(0,c.jsx)(t.li,{children:`устойчивые пользовательские preferences — в Zustand/store.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-cache-strategy`,children:`Как выбрать cache strategy`}),`
+`,(0,c.jsx)(t.p,{children:`Перед созданием query ответьте на вопросы:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Вопрос`}),(0,c.jsx)(t.th,{children:`Решение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужны данные только пока открыта вкладка?`}),(0,c.jsxs)(t.td,{children:[`Обычная query без `,(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Данные публичные, тяжёлые и могут пережить reload?`}),(0,c.jsxs)(t.td,{children:[`Рассмотреть `,(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Данные зависят от пользователя, роли или server session?`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`sessionScopedQueryMeta`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужно передать обновление другой открытой вкладке?`}),(0,c.jsx)(t.td,{children:`Broadcast installation и подходящее cache event.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`UI должен измениться до ответа mutation?`}),(0,c.jsx)(t.td,{children:`Optimistic update с обязательным rollback policy.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Server response авторитетен и уже содержит новое состояние?`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`setQueryData`}),`/`,(0,c.jsx)(t.code,{children:`onSuccessOptimistic`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`После mutation нужен свежий server snapshot?`}),(0,c.jsxs)(t.td,{children:[`Scoped `,(0,c.jsx)(t.code,{children:`invalidateQueries`}),` с выбранным `,(0,c.jsx)(t.code,{children:`refetchType`}),`.`]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),` и `,(0,c.jsx)(t.code,{children:`sessionScopedQueryMeta`}),` взаимоисключающие. Session data не должна переживать смену пользователя.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.h3,{id:`bootstrap`,children:`Bootstrap`}),`
+`,(0,c.jsx)(t.p,{children:`Инициализация выполняется один раз до обычного render приложения:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { QueryClientProvider } from "@tanstack/react-query";
+
+import {
+	configureQueryPersistenceProjectAdapter,
+	createQueryClient,
+	installReactQueryBroadcast,
+	installSessionScopedQueryReset,
+	setBroadcastFn
+} from "@ryuzaki13/react-foundation-lib/query-client";
+
+configureQueryPersistenceProjectAdapter({
+	persistenceBuster: "sales-app.query-cache.v1",
+	resolveSystemIdentifier: () => "production:300"
+});
+
+const queryClient = createQueryClient({
+	onQueryError: (error, query) => {
+		console.error("Query завершилась ошибкой", query.queryKey, error);
+	},
+	onMutationError: (error) => {
+		console.error("Mutation завершилась ошибкой", error);
+	}
+});
+
+const cacheBroadcast = installReactQueryBroadcast(queryClient, {
+	queriesChannel: "sales-app:query-data",
+	eventsChannel: "sales-app:query-events"
+});
+
+setBroadcastFn(cacheBroadcast.broadcast);
+
+const sessionReset = installSessionScopedQueryReset(queryClient, {
+	channelName: "sales-app:session-query-reset"
+});
+
+createRoot(document.getElementById("root")!).render(
+	<StrictMode>
+		<QueryClientProvider client={queryClient}>
+			<App />
+		</QueryClientProvider>
+	</StrictMode>
+);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`В обычной SPA эти installations живут до закрытия страницы. В тесте, story, microfrontend или явно размонтируемом shell вызовите cleanup:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`cacheBroadcast.cleanup();
+sessionReset.cleanup();
+setBroadcastFn(() => undefined);
+queryClient.clear();
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`обычная-query`,children:`Обычная query`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { queryOptions, useQuery } from "@tanstack/react-query";
+
+export function productsQueryOptions(company: string) {
+	return queryOptions({
+		queryKey: ["products", { company }] as const,
+		queryFn: () => fetchProducts(company)
+	});
+}
+
+export function useProducts(company: string) {
+	return useQuery(productsQueryOptions(company));
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Она использует default options созданного client, но не сохраняется в IndexedDB без явной meta.`}),`
+`,(0,c.jsx)(t.h2,{id:`создание-queryclient`,children:`Создание QueryClient`}),`
+`,(0,c.jsx)(t.h3,{id:`createqueryclient`,children:(0,c.jsx)(t.code,{children:`createQueryClient`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function createQueryClient(options: QueryBroadcastOptions): QueryClient;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Несмотря на старый комментарий «создаёт singleton», функция не кеширует экземпляр. Каждый вызов возвращает новый `,(0,c.jsx)(t.code,{children:`QueryClient`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = createQueryClient({});
+const second = createQueryClient({});
+
+console.log(first === second); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Singleton — ответственность host bootstrap:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`export const queryClient = createQueryClient({});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не вызывайте `,(0,c.jsx)(t.code,{children:`createQueryClient`}),` внутри React component. Иначе render может создать новый cache и потерять предыдущие данные.`]}),`
+`,(0,c.jsx)(t.h3,{id:`default-query-options`,children:`Default query options`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  staleTime: 10 * 60 * 1000,
+  gcTime: 30 * 60 * 1000,
+  throwOnError: false,
+  retry: false,
+  persister: /* только если доступен IndexedDB */
+}
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Option`}),(0,c.jsx)(t.th,{children:`Default`}),(0,c.jsx)(t.th,{children:`Смысл`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`staleTime`})}),(0,c.jsx)(t.td,{children:`10 минут`}),(0,c.jsx)(t.td,{children:`Данные считаются fresh после успеха.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`gcTime`})}),(0,c.jsx)(t.td,{children:`30 минут`}),(0,c.jsx)(t.td,{children:`Неактивная query остаётся в памяти до GC.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`throwOnError`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`Query error не пробрасывается в render/Error Boundary автоматически.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`retry`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`Автоматический повтор query отключён.`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Конкретная query может переопределить defaults:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`useQuery({
+	queryKey,
+	queryFn,
+	staleTime: Infinity
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`default-mutation-options`,children:`Default mutation options`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  throwOnError: false,
+  retry: false
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Mutation не повторяется автоматически. Это особенно важно для create/update/delete: повтор небезопасной операции может создать дубль.`}),`
+`,(0,c.jsx)(t.h3,{id:`глобальные-error-callbacks`,children:`Глобальные error callbacks`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type QueryBroadcastOptions = {
+	onQueryError?: (error: DefaultError, query: Query<unknown, unknown, unknown>) => void;
+
+	onMutationError?: (
+		error: DefaultError,
+		variables: unknown,
+		onMutateResult: unknown,
+		mutation: Mutation<unknown, unknown, unknown>,
+		context: MutationFunctionContext
+	) => Promise<unknown> | unknown;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Callbacks устанавливаются в `,(0,c.jsx)(t.code,{children:`QueryCache`}),` и `,(0,c.jsx)(t.code,{children:`MutationCache`}),`. Они подходят для общей диагностики, auth recovery и единой error policy.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не помещайте в log:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`access/session tokens;`}),`
+`,(0,c.jsx)(t.li,{children:`raw credentials;`}),`
+`,(0,c.jsx)(t.li,{children:`персональные payloads;`}),`
+`,(0,c.jsx)(t.li,{children:`секреты из mutation variables;`}),`
+`,(0,c.jsx)(t.li,{children:`полный cache dump.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Локальный `,(0,c.jsx)(t.code,{children:`onError`}),` mutation/query и global cache callback — разные уровни. Локальный handler может выполнить rollback/UI recovery, а глобальный — записать diagnostics. Не считайте один автоматической заменой другого.`]}),`
+`,(0,c.jsx)(t.h3,{id:`persistence-подключается-автоматически`,children:`Persistence подключается автоматически`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createQueryClient`}),` вызывает `,(0,c.jsx)(t.code,{children:`createReactQueryPersister`}),`.`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Если `,(0,c.jsx)(t.code,{children:`indexedDB`}),` доступен, `,(0,c.jsx)(t.code,{children:`persisterFn`}),` становится default query persister.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если `,(0,c.jsx)(t.code,{children:`indexedDB`}),` отсутствует, client создаётся без persister.`]}),`
+`,(0,c.jsx)(t.li,{children:`Даже с persister сохраняются только opt-in query.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`query-metadata`,children:`Query metadata`}),`
+`,(0,c.jsx)(t.h3,{id:`appquerymeta`,children:(0,c.jsx)(t.code,{children:`AppQueryMeta`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль расширяет TanStack Query `,(0,c.jsx)(t.code,{children:`Register.queryMeta`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type AppQueryMeta = {
+	readonly persist?: boolean;
+	readonly sessionScoped?: boolean;
+} & Record<string, unknown>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`После импорта package TypeScript понимает эти fields в `,(0,c.jsx)(t.code,{children:`queryOptions`}),`, `,(0,c.jsx)(t.code,{children:`useQuery`}),` и Query object:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryOptions({
+	queryKey: ["dictionary"],
+	queryFn: fetchDictionary,
+	meta: {
+		persist: true,
+		source: "dictionary"
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Record<string, unknown>`}),` разрешает consumer-проекту добавлять собственную metadata. Infrastructure этого модуля читает только `,(0,c.jsx)(t.code,{children:`persist`}),` и `,(0,c.jsx)(t.code,{children:`sessionScoped`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`persistedquerymeta`,children:(0,c.jsx)(t.code,{children:`persistedQueryMeta`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const persistedQueryMeta = { persist: true } as const;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Применение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { queryOptions } from "@tanstack/react-query";
+import { persistedQueryMeta } from "@ryuzaki13/react-foundation-lib/query-client";
+
+export function dictionaryQueryOptions(dictionaryId: string) {
+	return queryOptions({
+		queryKey: ["dictionary", dictionaryId] as const,
+		queryFn: () => fetchDictionary(dictionaryId),
+		meta: persistedQueryMeta,
+		staleTime: 8 * 60 * 60 * 1000
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Meta только разрешает persistence. Она не гарантирует, что IndexedDB доступен и запись уже создана.`}),`
+`,(0,c.jsx)(t.h3,{id:`sessionscopedquerymeta`,children:(0,c.jsx)(t.code,{children:`sessionScopedQueryMeta`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const sessionScopedQueryMeta = { sessionScoped: true } as const;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте для data, содержимое или доступность которых зависит от server session, пользователя или роли:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryOptions({
+	queryKey: ["current-user", "permissions"] as const,
+	queryFn: fetchCurrentPermissions,
+	meta: sessionScopedQueryMeta
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При смене сессии host обязан вызвать `,(0,c.jsx)(t.code,{children:`resetSessionScopedQueries`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`meta-нельзя-совмещать`,children:`Meta нельзя совмещать`}),`
+`,(0,c.jsx)(t.p,{children:`Неверно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`meta: {
+  persist: true,
+  sessionScoped: true
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`shouldPersistQuery`}),` всё равно не сохранит такую query, потому что session scope имеет приоритет безопасности.`]}),`
+`,(0,c.jsx)(t.p,{children:`Используйте один смысл:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`публичный/безопасный долгоживущий справочник → `,(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`auth/session dependent data → `,(0,c.jsx)(t.code,{children:`sessionScopedQueryMeta`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`обычные transient data → meta не нужна.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`настройка-project-adapter`,children:`Настройка project adapter`}),`
+`,(0,c.jsx)(t.h3,{id:`зачем-нужен-adapter`,children:`Зачем нужен adapter`}),`
+`,(0,c.jsxs)(t.p,{children:[`Foundation-пакет не знает имя SAP system, client, tenant или окружение конкретного приложения. `,(0,c.jsx)(t.code,{children:`QueryPersistenceProjectAdapter`}),` позволяет host передать устойчивый namespace и собственный buster:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type QueryPersistenceProjectAdapter = {
+	persistenceBuster?: string;
+	resolveSystemIdentifier?: () => string | null | undefined;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`configurequerypersistenceprojectadapter`,children:(0,c.jsx)(t.code,{children:`configureQueryPersistenceProjectAdapter`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`configureQueryPersistenceProjectAdapter({
+	persistenceBuster: "sales-app.query.v2",
+	resolveSystemIdentifier: () => {
+		return "sap-prd:300";
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Вызов заменяет весь текущий adapter. Это global module state, а не merge:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`configureQueryPersistenceProjectAdapter({
+	persistenceBuster: "v2"
+});
+
+// Предыдущий resolveSystemIdentifier больше не установлен.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`порядок-инициализации`,children:`Порядок инициализации`}),`
+`,(0,c.jsxs)(t.p,{children:[`Настройте adapter до первого `,(0,c.jsx)(t.code,{children:`createQueryClient`}),` или `,(0,c.jsx)(t.code,{children:`createIndexedDbQueryStorage`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`configureQueryPersistenceProjectAdapter(adapter);
+const queryClient = createQueryClient({});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Иначе storage/persister уже получит default namespace и buster.`}),`
+`,(0,c.jsx)(t.h3,{id:`getquerypersistenceprojectadapter`,children:(0,c.jsx)(t.code,{children:`getQueryPersistenceProjectAdapter`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const adapter = getQueryPersistenceProjectAdapter();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает текущий object по ссылке. Не мутируйте его. Для изменения вызывайте `,(0,c.jsx)(t.code,{children:`configureQueryPersistenceProjectAdapter`}),` с новым object.`]}),`
+`,(0,c.jsx)(t.h3,{id:`выбор-system-identifier`,children:`Выбор system identifier`}),`
+`,(0,c.jsx)(t.p,{children:`Правило по умолчанию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`development: dev:{APP_ID}
+
+production:
+  adapter.resolveSystemIdentifier() → если вернулась непустая строка
+  иначе {APP_ID}:{window.location.hostname}
+
+server-like runtime без window:
+  {APP_ID}:server
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Примеры:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`dev:sales-app
+sap-prd:300
+sales-app:portal.company.local
+sales-app:server
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Identifier становится именем IndexedDB database и prefix persisted query keys. Он должен разделять окружения, между которыми нельзя переиспользовать data.`}),`
+`,(0,c.jsx)(t.p,{children:`Resolver может быть вызван больше одного раза при создании storage и persister. Он должен быть чистым и возвращать одинаковый identifier в рамках одного application runtime.`}),`
+`,(0,c.jsx)(t.p,{children:`Не включайте в identifier username, token или персональные данные. Для пользовательских данных persistence вообще не должна использоваться.`}),`
+`,(0,c.jsx)(t.h3,{id:`выбор-buster`,children:`Выбор buster`}),`
+`,(0,c.jsx)(t.p,{children:`При создании persister используется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`adapter.persistenceBuster ?? REACT_QUERY_PERSISTENCE_BUSTER
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустая строка считается явным adapter value, потому что используется `,(0,c.jsx)(t.code,{children:`??`}),`, а не truthy-проверка. На практике задавайте непустую версионированную строку.`]}),`
+`,(0,c.jsx)(t.h2,{id:`indexeddb-persistence`,children:`IndexedDB persistence`}),`
+`,(0,c.jsx)(t.h3,{id:`зачем-indexeddb`,children:`Зачем IndexedDB`}),`
+`,(0,c.jsxs)(t.p,{children:[`IndexedDB подходит для больших асинхронных browser data лучше, чем `,(0,c.jsx)(t.code,{children:`localStorage`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`операции асинхронные;`}),`
+`,(0,c.jsx)(t.li,{children:`значения хранятся через structured clone;`}),`
+`,(0,c.jsx)(t.li,{children:`можно хранить object без ручного JSON stringify;`}),`
+`,(0,c.jsxs)(t.li,{children:[`storage не блокирует основной поток синхронным API `,(0,c.jsx)(t.code,{children:`localStorage`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`объём обычно лучше подходит тяжёлым справочникам.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Persistence не означает, что любой большой payload автоматически безопасен. Объём, чувствительность и свежесть остаются решением consumer-а.`}),`
+`,(0,c.jsx)(t.h3,{id:`opt-in-правило`,children:`Opt-in правило`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function shouldPersistQuery(query: Pick<Query, "meta">): boolean;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат `,(0,c.jsx)(t.code,{children:`true`}),` только когда:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`query.meta?.persist === true && query.meta.sessionScoped !== true;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Примеры:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Meta`}),(0,c.jsx)(t.th,{children:`Сохраняется`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ persist: false }`})}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ persist: true }`})}),(0,c.jsx)(t.td,{children:`Да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ sessionScoped: true }`})}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ persist: true, sessionScoped: true }`})}),(0,c.jsx)(t.td,{children:`Нет`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`createindexeddbquerystorage`,children:(0,c.jsx)(t.code,{children:`createIndexedDbQueryStorage`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const storage = createIndexedDbQueryStorage<MyValue>({
+	dbName: "sales-query-cache",
+	storeName: "queries",
+	indexedDB: customFactory
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Options structurally имеют форму:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Options = {
+	dbName?: string;
+	storeName?: string;
+	indexedDB?: IDBFactory;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сам тип options не экспортируется, но TypeScript выводит его из signature.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если explicit `,(0,c.jsx)(t.code,{children:`indexedDB`}),` не передан, используется `,(0,c.jsx)(t.code,{children:`globalThis.indexedDB`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если factory отсутствует, возвращается `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const storage = createIndexedDbQueryStorage();
+
+if (!storage) {
+	console.info("IndexedDB недоступен, persistence отключена");
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`default-database-и-object-store`,children:`Default database и object store`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`dbName`}),` по умолчанию равен system identifier;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`storeName`}),` по умолчанию равен `,(0,c.jsx)(t.code,{children:`queries`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`database открывается с версией `,(0,c.jsx)(t.code,{children:`1`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`object store создаётся в `,(0,c.jsx)(t.code,{children:`onupgradeneeded`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`открытая database promise переиспользуется внутри storage instance.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если вы выбираете custom `,(0,c.jsx)(t.code,{children:`storeName`}),` для уже существующей database версии `,(0,c.jsx)(t.code,{children:`1`}),`, browser может не вызвать upgrade, и store не будет создан. Для custom layout используйте отдельный `,(0,c.jsx)(t.code,{children:`dbName`}),` либо заранее управляемую migration/version strategy.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`У storage нет публичного `,(0,c.jsx)(t.code,{children:`close()`}),`. Обычно instance живёт вместе с persister всё время работы SPA.`]}),`
+`,(0,c.jsx)(t.h3,{id:`storage-api`,children:`Storage API`}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращаемый adapter совместим с TanStack `,(0,c.jsx)(t.code,{children:`AsyncStorage`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type QueryStorage<T> = {
+	getItem(key: string): Promise<T | undefined | null>;
+	setItem(key: string, value: T): Promise<unknown>;
+	removeItem(key: string): Promise<void>;
+	entries?(): Promise<Array<[key: string, value: T]>>;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример прямой работы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const storage = createIndexedDbQueryStorage<string>({
+	dbName: "query-storage-demo"
+});
+
+if (storage) {
+	await storage.setItem("first", "один");
+	const value = await storage.getItem("first");
+	const all = await storage.entries?.();
+	await storage.removeItem("first");
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`setItem`}),` завершается после окончания write transaction, а не сразу после `,(0,c.jsx)(t.code,{children:`store.put`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`entries`}),` читает object store через cursor. Не завязывайте бизнес-логику на предполагаемый insertion order: порядок определяется IndexedDB keys/cursor.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибки-indexeddb`,children:`Ошибки IndexedDB`}),`
+`,(0,c.jsx)(t.p,{children:`Storage не скрывает ошибки. Promise отклоняется, если:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`database open заблокирован;`}),`
+`,(0,c.jsx)(t.li,{children:`browser отказал в storage;`}),`
+`,(0,c.jsx)(t.li,{children:`transaction завершилась error/abort;`}),`
+`,(0,c.jsx)(t.li,{children:`значение не поддерживает structured clone;`}),`
+`,(0,c.jsx)(t.li,{children:`object store отсутствует;`}),`
+`,(0,c.jsx)(t.li,{children:`превышена quota.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не превращайте такую ошибку молча в успешную запись. На уровне приложения выберите diagnostics и degradation policy.`}),`
+`,(0,c.jsx)(t.h3,{id:`createreactquerypersister`,children:(0,c.jsx)(t.code,{children:`createReactQueryPersister`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const persister = createReactQueryPersister();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает результат `,(0,c.jsx)(t.code,{children:`experimental_createQueryPersister`}),` либо `,(0,c.jsx)(t.code,{children:`undefined`}),`, если IndexedDB недоступен.`]}),`
+`,(0,c.jsx)(t.p,{children:`Настройки foundation wrapper:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  serialize: (query) => query,
+  deserialize: (query) => query,
+  prefix: systemIdentifier,
+  buster: adapterBuster ?? buildTimeBuster,
+  maxAge: 90 * 24 * 60 * 60 * 1000,
+  refetchOnRestore: true,
+  filters: { predicate: shouldPersistQuery }
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`API TanStack помечено `,(0,c.jsx)(t.code,{children:`experimental`}),`. При обновлении major/minor версии peer dependency повторно проверяйте совместимость.`]}),`
+`,(0,c.jsx)(t.h3,{id:`constants`,children:`Constants`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`REACT_QUERY_PERSISTENCE_BUSTER;
+REACT_QUERY_PERSISTENCE_MAX_AGE;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`REACT_QUERY_PERSISTENCE_MAX_AGE`}),` равен 90 дням в миллисекундах:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`90 * 24 * 60 * 60 * 1000;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это максимальный возраст persisted записи, а не `,(0,c.jsx)(t.code,{children:`staleTime`}),` и не `,(0,c.jsx)(t.code,{children:`gcTime`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ключ-записи`,children:`Ключ записи`}),`
+`,(0,c.jsx)(t.p,{children:`TanStack persister использует форму:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`{prefix}-{queryHash}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Например:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sap-prd:300-["odata","metadata",{"service":"REPORT_SRV"}]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Фактический `,(0,c.jsx)(t.code,{children:`queryHash`}),` создаёт TanStack Query. Не собирайте persistent key вручную.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-хранится`,children:`Что хранится`}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждая запись содержит `,(0,c.jsx)(t.code,{children:`PersistedQuery`}),` с query key, hash, state и buster. `,(0,c.jsx)(t.code,{children:`state`}),` включает data и timestamps TanStack Query.`]}),`
+`,(0,c.jsx)(t.p,{children:`Wrapper не делает JSON serialization:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`serialize: (query) => query;
+deserialize: (query) => query;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Следствие: data должна поддерживать browser structured clone.`}),`
+`,(0,c.jsx)(t.p,{children:`Не сохраняйте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`functions;`}),`
+`,(0,c.jsx)(t.li,{children:`DOM nodes;`}),`
+`,(0,c.jsx)(t.li,{children:`React elements;`}),`
+`,(0,c.jsx)(t.li,{children:`QueryClient;`}),`
+`,(0,c.jsx)(t.li,{children:`AbortController/Signal как часть data;`}),`
+`,(0,c.jsx)(t.li,{children:`class instances с важным prototype behavior;`}),`
+`,(0,c.jsx)(t.li,{children:`несериализуемые runtime handles.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`жизненный-цикл-восстановления`,children:`Жизненный цикл восстановления`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для query с `,(0,c.jsx)(t.code,{children:`meta: persistedQueryMeta`}),`:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`TanStack Query создаёт query в памяти.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Persister проверяет `,(0,c.jsx)(t.code,{children:`shouldPersistQuery`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`По `,(0,c.jsx)(t.code,{children:`prefix-queryHash`}),` читается IndexedDB.`]}),`
+`,(0,c.jsx)(t.li,{children:`Проверяются buster и возраст записи.`}),`
+`,(0,c.jsx)(t.li,{children:`Подходящее state восстанавливается в Query cache.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Если восстановленная query stale, `,(0,c.jsx)(t.code,{children:`refetchOnRestore: true`}),` запускает обновление.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если записи нет/она протухла/не совпал buster, выполняется обычный `,(0,c.jsx)(t.code,{children:`queryFn`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Успешный результат планируется к записи в IndexedDB.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Восстановление per-query ленивое. Модуль не гидратирует весь persistent cache целиком при старте приложения.`}),`
+`,(0,c.jsx)(t.h3,{id:`freshness-три-разных-времени`,children:`Freshness: три разных времени`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Время`}),(0,c.jsx)(t.th,{children:`Отвечает за`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`staleTime`}),` query`]}),(0,c.jsx)(t.td,{children:`Когда data перестаёт считаться fresh.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`gcTime`}),` query`]}),(0,c.jsx)(t.td,{children:`Когда неактивная query удаляется из memory cache.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`REACT_QUERY_PERSISTENCE_MAX_AGE`})}),(0,c.jsx)(t.td,{children:`Когда IndexedDB запись слишком стара для restore.`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryOptions({
+	queryKey: ["dictionary", "materials"],
+	queryFn: fetchMaterials,
+	meta: persistedQueryMeta,
+	staleTime: 2 * 60 * 60 * 1000,
+	gcTime: 30 * 60 * 1000
+});
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Через reload в течение двух часов data может восстановиться fresh без немедленного refetch.`}),`
+`,(0,c.jsx)(t.li,{children:`После двух часов data может восстановиться, но stale query будет обновлена.`}),`
+`,(0,c.jsx)(t.li,{children:`После 90 дней запись не должна использоваться.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`хорошие-кандидаты-для-persistence`,children:`Хорошие кандидаты для persistence`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`публичные справочники;`}),`
+`,(0,c.jsx)(t.li,{children:`metadata/schema, одинаковые для пользователей в namespace;`}),`
+`,(0,c.jsx)(t.li,{children:`тяжёлые редко меняющиеся reference data;`}),`
+`,(0,c.jsx)(t.li,{children:`data с ясной invalidation/version strategy;`}),`
+`,(0,c.jsx)(t.li,{children:`payload без чувствительной информации.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`плохие-кандидаты`,children:`Плохие кандидаты`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`текущий пользователь и permissions;`}),`
+`,(0,c.jsx)(t.li,{children:`персональные списки;`}),`
+`,(0,c.jsx)(t.li,{children:`form draft;`}),`
+`,(0,c.jsx)(t.li,{children:`результаты поиска с большим числом уникальных keys;`}),`
+`,(0,c.jsx)(t.li,{children:`быстро меняющиеся balances/statuses;`}),`
+`,(0,c.jsx)(t.li,{children:`auth/session dependent response;`}),`
+`,(0,c.jsx)(t.li,{children:`data без понятного срока свежести;`}),`
+`,(0,c.jsx)(t.li,{children:`огромные таблицы, сохраняемые «на всякий случай».`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`devtools`,children:`DevTools`}),`
+`,(0,c.jsx)(t.p,{children:`В browser DevTools:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Откройте `,(0,c.jsx)(t.code,{children:`Application`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Выберите `,(0,c.jsx)(t.code,{children:`IndexedDB`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Найдите database по system identifier.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Откройте object store `,(0,c.jsx)(t.code,{children:`queries`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Проверьте keys, buster и query state.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Удаление database в DevTools — ручной способ очистить persistent cache текущего namespace. Не делайте автоматическую очистку всех databases другого приложения.`}),`
+`,(0,c.jsx)(t.h2,{id:`session-scoped-query`,children:`Session-scoped query`}),`
+`,(0,c.jsx)(t.h3,{id:`когда-нужна-session-scope`,children:`Когда нужна session scope`}),`
+`,(0,c.jsx)(t.p,{children:`Query считается session-scoped, если data или право на чтение меняется вместе с server session:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`текущий пользователь;`}),`
+`,(0,c.jsx)(t.li,{children:`permissions/roles;`}),`
+`,(0,c.jsx)(t.li,{children:`персональные настройки с backend;`}),`
+`,(0,c.jsx)(t.li,{children:`доступные пользователю операции;`}),`
+`,(0,c.jsx)(t.li,{children:`auth-dependent списки;`}),`
+`,(0,c.jsx)(t.li,{children:`данные, которые нельзя показывать следующему вошедшему пользователю.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { sessionScopedQueryMeta } from "@ryuzaki13/react-foundation-lib/query-client";
+
+const permissionsOptions = queryOptions({
+	queryKey: ["session", "permissions"] as const,
+	queryFn: fetchPermissions,
+	meta: sessionScopedQueryMeta,
+	staleTime: Infinity
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Meta сама ничего не сбрасывает. Host должен вызвать reset на boundary смены сессии.`}),`
+`,(0,c.jsx)(t.h3,{id:`issessionscopedquery`,children:(0,c.jsx)(t.code,{children:`isSessionScopedQuery`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function isSessionScopedQuery(query: Pick<Query, "meta">): boolean;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),` только для строгого `,(0,c.jsx)(t.code,{children:`meta.sessionScoped === true`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`resetsessionscopedqueries`,children:(0,c.jsx)(t.code,{children:`resetSessionScopedQueries`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await resetSessionScopedQueries(queryClient);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Вызывайте после:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`успешного входа другим пользователем;`}),`
+`,(0,c.jsx)(t.li,{children:`выхода;`}),`
+`,(0,c.jsx)(t.li,{children:`обновления server session, меняющего доступ;`}),`
+`,(0,c.jsx)(t.li,{children:`потери авторизации;`}),`
+`,(0,c.jsx)(t.li,{children:`смены роли/контекста, если старые данные более недопустимы.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Порядок работы:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Находит только query с `,(0,c.jsx)(t.code,{children:`sessionScoped === true`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Отменяет их незавершённые requests.`}),`
+`,(0,c.jsx)(t.li,{children:`Неактивные query полностью удаляет из QueryCache.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Query с observer очищает: reset + `,(0,c.jsx)(t.code,{children:`data: undefined`}),`, `,(0,c.jsx)(t.code,{children:`dataUpdatedAt: 0`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Повторно запрашивает только active session-scoped query.`}),`
+`,(0,c.jsx)(t.li,{children:`По умолчанию отправляет другим вкладкам команду такого же reset.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Обычные публичные query остаются нетронутыми.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-observed-query-не-удаляется`,children:`Почему observed query не удаляется`}),`
+`,(0,c.jsxs)(t.p,{children:[`Смонтированный `,(0,c.jsx)(t.code,{children:`useQuery`}),` владеет observer. Удаление query прямо из-под активного observer может привести к сложному lifecycle. Поэтому entry сохраняется, но старые data явно очищаются и active query перезапрашивается.`]}),`
+`,(0,c.jsx)(t.h3,{id:`disabled-query`,children:`Disabled query`}),`
+`,(0,c.jsxs)(t.p,{children:[`Query с observer и `,(0,c.jsx)(t.code,{children:`enabled: false`}),` очищается, но не refetch-ится:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`до reset: cache data есть, observer disabled
+после reset: query entry есть, data = undefined
+queryFn повторно не вызвана
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это ожидаемо: disabled query не считается active для refetch.`}),`
+`,(0,c.jsx)(t.h3,{id:`hydrated-data`,children:`Hydrated data`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль явно обнуляет `,(0,c.jsx)(t.code,{children:`data`}),` после `,(0,c.jsx)(t.code,{children:`query.reset()`}),`. Это защищает от ситуации, когда hydrated initial state прежней сессии мог бы вернуться после обычного reset.`]}),`
+`,(0,c.jsx)(t.p,{children:`Foundation-пакет не включает SSR самостоятельно, но helper безопасно очищает такой cache state, если consumer использует TanStack dehydration/hydration.`}),`
+`,(0,c.jsx)(t.h3,{id:`options`,children:`Options`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ResetSessionScopedQueriesOptions = {
+	readonly broadcast?: boolean;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию `,(0,c.jsx)(t.code,{children:`broadcast`}),` включён:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await resetSessionScopedQueries(queryClient);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для обработки уже полученной remote-команды нужен `,(0,c.jsx)(t.code,{children:`false`}),`, чтобы не создать цикл:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await resetSessionScopedQueries(queryClient, { broadcast: false });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычно consumer вручную не передаёт `,(0,c.jsx)(t.code,{children:`false`}),`: это делает `,(0,c.jsx)(t.code,{children:`installSessionScopedQueryReset`}),` внутри message handler.`]}),`
+`,(0,c.jsx)(t.h3,{id:`installsessionscopedqueryreset`,children:(0,c.jsx)(t.code,{children:`installSessionScopedQueryReset`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const installed = installSessionScopedQueryReset(queryClient, {
+	channelName: "sales-app:session-cache-reset"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Типы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type InstallSessionScopedQueryResetOptions = {
+	readonly channelName: string;
+};
+
+type InstalledSessionScopedQueryReset = {
+	readonly cleanup: () => void;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Канал передаёт только command:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	type: "session-scoped-query-cache-reset";
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Он не передаёт:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`query data;`}),`
+`,(0,c.jsx)(t.li,{children:`user id;`}),`
+`,(0,c.jsx)(t.li,{children:`auth payload;`}),`
+`,(0,c.jsx)(t.li,{children:`token;`}),`
+`,(0,c.jsx)(t.li,{children:`session details.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это безопаснее полной передачи session cache между вкладками.`}),`
+`,(0,c.jsx)(t.h3,{id:`browser-fallback`,children:`Browser fallback`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если отсутствует `,(0,c.jsx)(t.code,{children:`window`}),` или `,(0,c.jsx)(t.code,{children:`BroadcastChannel`}),`, installation возвращает no-op cleanup:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const { cleanup } = installSessionScopedQueryReset(queryClient, options);
+cleanup(); // безопасно
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Локальный `,(0,c.jsx)(t.code,{children:`resetSessionScopedQueries`}),` всё равно работает без browser channel.`]}),`
+`,(0,c.jsx)(t.h3,{id:`lifecycle-и-global-sender`,children:`Lifecycle и global sender`}),`
+`,(0,c.jsxs)(t.p,{children:[`Внутри модуля хранится одна global функция рассылки session reset. Последняя успешная installation становится активной для `,(0,c.jsx)(t.code,{children:`resetSessionScopedQueries`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому в одном application runtime обычно устанавливают один session channel.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cleanup()`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`удаляет `,(0,c.jsx)(t.code,{children:`onmessage`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`закрывает BroadcastChannel;`}),`
+`,(0,c.jsx)(t.li,{children:`очищает global sender, если он всё ещё принадлежит этой installation.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`пример-auth-boundary`,children:`Пример auth boundary`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function completeLogin() {
+	await establishServerSession();
+	await resetSessionScopedQueries(queryClient);
+}
+
+async function logout() {
+	await closeServerSession();
+	await resetSessionScopedQueries(queryClient);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сначала измените server session, затем перезапрашивайте active query. Иначе refetch может снова получить data старой сессии.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-session-query-нельзя-persist`,children:`Почему session query нельзя persist`}),`
+`,(0,c.jsx)(t.p,{children:`IndexedDB переживает reload и может остаться после logout. Даже если UI очищает memory cache, persisted персональная запись представляет риск утечки следующей сессии.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`shouldPersistQuery`}),` защищает от случайного сочетания flags, но правильная metadata остаётся ответственностью owner-а query.`]}),`
+`,(0,c.jsx)(t.h2,{id:`синхронизация-между-вкладками`,children:`Синхронизация между вкладками`}),`
+`,(0,c.jsx)(t.h3,{id:`две-задачи-два-канала`,children:`Две задачи, два канала`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`installReactQueryBroadcast`}),` создаёт два разных механизма:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`queriesChannel
+  └─ experimental broadcastQueryClient
+     синхронизирует query cache data/state
+
+eventsChannel
+  └─ собственный BroadcastChannel
+     передаёт invalidate/setQueryData commands
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Разделение нужно потому, что experimental TanStack broadcast не обязан передавать прикладное invalidation так, как требуется host-приложению.`}),`
+`,(0,c.jsx)(t.h3,{id:`установка`,children:`Установка`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const installed = installReactQueryBroadcast(queryClient, {
+	queriesChannel: "sales-app:query-data",
+	eventsChannel: "sales-app:query-events"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Структурные options:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type InstallBroadcastOptions = {
+	queriesChannel: string;
+	eventsChannel: string;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type InstalledReactQueryBroadcast = {
+	broadcast: (event: CacheSyncEvent) => void;
+	cleanup: () => void;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Эти types не экспортируются отдельными именами, но TypeScript выводит их из function signature.`}),`
+`,(0,c.jsx)(t.h3,{id:`имена-каналов`,children:`Имена каналов`}),`
+`,(0,c.jsx)(t.p,{children:`Выбирайте стабильные и уникальные имена:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`{app}:{environment}:query-data
+{app}:{environment}:query-events
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте один channel name для несвязанных приложений на одном origin. Иначе они могут прочитать чужие cache events.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`queriesChannel`}),` и `,(0,c.jsx)(t.code,{children:`eventsChannel`}),` должны различаться: у них разные wire protocols.`]}),`
+`,(0,c.jsx)(t.h3,{id:`cache-data-sync`,children:`Cache data sync`}),`
+`,(0,c.jsx)(t.p,{children:`Foundation wrapper вызывает:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`broadcastQueryClient({
+	queryClient,
+	broadcastChannel: queriesChannel
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Успешные изменения Query cache, включая подходящий `,(0,c.jsx)(t.code,{children:`setQueryData`}),`, могут появиться в другой вкладке через experimental TanStack adapter.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это не сетевой refetch. Data передаётся browser channel между вкладками одного origin.`}),`
+`,(0,c.jsx)(t.h3,{id:`автоматическая-invalidation`,children:`Автоматическая invalidation`}),`
+`,(0,c.jsxs)(t.p,{children:[`Wrapper подписывается на `,(0,c.jsx)(t.code,{children:`queryClient.getQueryCache()`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Когда локальная query получает action `,(0,c.jsx)(t.code,{children:`invalidate`}),`, wrapper автоматически отправляет event:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  type: "invalidate",
+  keys: [query.queryKey],
+  refetchType: "none"
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Remote вкладка вызывает `,(0,c.jsx)(t.code,{children:`invalidateQueries`}),` для каждого key.`]}),`
+`,(0,c.jsx)(t.p,{children:`Широкая локальная invalidation превращается в набор точечных events для query, которые реально обновились в cache отправителя.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Автоматическая отправка всегда использует `,(0,c.jsx)(t.code,{children:`refetchType: "none"`}),`. Если другой вкладке нужен active/inactive/all refetch, отправьте explicit event.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`event-invalidate`,children:[`Event `,(0,c.jsx)(t.code,{children:`invalidate`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`installed.broadcast({
+	type: "invalidate",
+	keys: [["products"], ["products", "summary"]],
+	refetchType: "active"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поддерживаемые `,(0,c.jsx)(t.code,{children:`refetchType`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"none"`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"active"`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"inactive"`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"all"`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если field отсутствует, receiver использует `,(0,c.jsx)(t.code,{children:`"none"`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`event-setquerydata`,children:[`Event `,(0,c.jsx)(t.code,{children:`setQueryData`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`installed.broadcast({
+	type: "setQueryData",
+	key: ["products", "summary"],
+	data: { count: 42 }
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Receiver вызывает:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryClient.setQueryData(event.key, event.data);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Event принимает `,(0,c.jsx)(t.code,{children:`data: unknown`}),`. TypeScript не может доказать, что data соответствует cache type receiver-а. Sender обязан использовать правильный query key/data contract.`]}),`
+`,(0,c.jsx)(t.h3,{id:`глобальный-imperative-api`,children:`Глобальный imperative API`}),`
+`,(0,c.jsxs)(t.p,{children:[`Чтобы не передавать `,(0,c.jsx)(t.code,{children:`installed.broadcast`}),` через все слои:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`setBroadcastFn(installed.broadcast);
+
+broadcastCacheEvent({
+	type: "invalidate",
+	keys: [["products"]],
+	refetchType: "none"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`setBroadcastFn`}),` заменяет одну global handler-функцию. Это singleton module state.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`До установки handler `,(0,c.jsx)(t.code,{children:`broadcastCacheEvent`}),` ничего не делает:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`broadcastCacheEvent(event); // no-op, если handler ещё null
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`cleanup-global-handler`,children:`Cleanup global handler`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`installed.cleanup()`}),` закрывает каналы, но не знает, передавали ли вы `,(0,c.jsx)(t.code,{children:`installed.broadcast`}),` в `,(0,c.jsx)(t.code,{children:`setBroadcastFn`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Перед/после cleanup сбросьте global handler:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`setBroadcastFn(() => undefined);
+installed.cleanup();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Иначе поздний `,(0,c.jsx)(t.code,{children:`broadcastCacheEvent`}),` может попытаться использовать функцию, связанную с уже закрытым channel.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-делает-cleanup`,children:`Что делает cleanup`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`installed.cleanup();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Cleanup:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`отписывается от QueryCache events;`}),`
+`,(0,c.jsx)(t.li,{children:`вызывает cleanup TanStack broadcast adapter;`}),`
+`,(0,c.jsx)(t.li,{children:`закрывает custom BroadcastChannel.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Вызывайте его в тестах, stories, microfrontend teardown и при повторной installation.`}),`
+`,(0,c.jsx)(t.h3,{id:`защита-от-циклов`,children:`Защита от циклов`}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждая installation получает `,(0,c.jsx)(t.code,{children:`tabId`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Receiver:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`игнорирует message с собственным `,(0,c.jsx)(t.code,{children:`tabId`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`на время применения remote event включает `,(0,c.jsx)(t.code,{children:`isApplyingRemoteEvent`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не пересылает вызванную remote message invalidation обратно.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это предотвращает бесконечное эхо между вкладками.`}),`
+`,(0,c.jsx)(t.h3,{id:`проверка-входящих-messages`,children:`Проверка входящих messages`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль проверяет:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`message является record;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`tabId`}),` является string;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`event имеет известный `,(0,c.jsx)(t.code,{children:`type`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`invalidate содержит array `,(0,c.jsx)(t.code,{children:`keys`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`refetchType`}),` входит в allowlist;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`setQueryData содержит fields `,(0,c.jsx)(t.code,{children:`key`}),` и `,(0,c.jsx)(t.code,{children:`data`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверка намеренно не является полной schema validation QueryKey/data. Например, каждый элемент `,(0,c.jsx)(t.code,{children:`keys`}),` отдельно глубоко не валидируется.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это защита от случайных/устаревших messages, но не security boundary между приложениями одного origin. Используйте уникальные channel names и не отправляйте secrets.`}),`
+`,(0,c.jsx)(t.h3,{id:`browser-support`,children:`Browser support`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`window`}),` отсутствует, `,(0,c.jsx)(t.code,{children:`installReactQueryBroadcast`}),` возвращает no-op `,(0,c.jsx)(t.code,{children:`broadcast`}),` и `,(0,c.jsx)(t.code,{children:`cleanup`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Но если `,(0,c.jsx)(t.code,{children:`window`}),` существует, а `,(0,c.jsx)(t.code,{children:`BroadcastChannel`}),` отсутствует, текущая implementation попытается вызвать constructor и может выбросить `,(0,c.jsx)(t.code,{children:`ReferenceError`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для старого/ограниченного browser сделайте feature check до installation:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const installed =
+	typeof BroadcastChannel === "undefined"
+		? { broadcast: () => undefined, cleanup: () => undefined }
+		: installReactQueryBroadcast(queryClient, options);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`structured-clone`,children:`Structured clone`}),`
+`,(0,c.jsxs)(t.p,{children:[`BroadcastChannel использует structured clone. В `,(0,c.jsx)(t.code,{children:`setQueryData.data`}),` не передавайте:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`functions;`}),`
+`,(0,c.jsx)(t.li,{children:`DOM nodes;`}),`
+`,(0,c.jsx)(t.li,{children:`React elements;`}),`
+`,(0,c.jsx)(t.li,{children:`QueryClient;`}),`
+`,(0,c.jsx)(t.li,{children:`non-cloneable runtime handles.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Ошибка clone может возникнуть при `,(0,c.jsx)(t.code,{children:`postMessage`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`same-origin-граница`,children:`Same-origin граница`}),`
+`,(0,c.jsx)(t.p,{children:`BroadcastChannel работает между browsing contexts одного origin и channel name. Он не синхронизирует разные domains, browser profiles или devices.`}),`
+`,(0,c.jsx)(t.h3,{id:`когда-нужен-ручной-event`,children:`Когда нужен ручной event`}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычный `,(0,c.jsx)(t.code,{children:`queryClient.setQueryData`}),` уже может синхронизироваться TanStack adapter-ом. Не дублируйте manual `,(0,c.jsx)(t.code,{children:`setQueryData`}),` event автоматически везде.`]}),`
+`,(0,c.jsx)(t.p,{children:`Ручной event нужен, когда:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`требуется explicit прикладная команда;`}),`
+`,(0,c.jsxs)(t.li,{children:[`нужен особый `,(0,c.jsx)(t.code,{children:`refetchType`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`нужно одной командой перечислить несколько keys;`}),`
+`,(0,c.jsx)(t.li,{children:`consumer сознательно не полагается только на experimental data sync.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`broadcast-и-session-data`,children:`Broadcast и session data`}),`
+`,(0,c.jsxs)(t.p,{children:[`Полная cache synchronization потенциально передаёт query data между вкладками. Для команды очистки auth/session cache используйте отдельный `,(0,c.jsx)(t.code,{children:`installSessionScopedQueryReset`}),`: он передаёт только reset command.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не отправляйте session token или чувствительный payload через `,(0,c.jsx)(t.code,{children:`broadcastCacheEvent`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`optimistic-update`,children:`Optimistic update`}),`
+`,(0,c.jsx)(t.h3,{id:`что-это-такое`,children:`Что это такое`}),`
+`,(0,c.jsx)(t.p,{children:`Обычная mutation:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`действие пользователя
+       ↓
+HTTP request
+       ↓
+server response
+       ↓
+обновление UI
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пользователь ждёт сеть до визуального результата.`}),`
+`,(0,c.jsx)(t.p,{children:`Optimistic update сначала меняет локальный Query cache:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`действие пользователя
+       ↓
+UI/cache меняются сразу
+       ↓
+HTTP request
+       ├─ успех  → подтвердить/слить server data
+       └─ ошибка → откатить предыдущий snapshot
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Мы предполагаем, что server примет изменение. Если предположение неверно, cache возвращается к предыдущему состоянию.`}),`
+`,(0,c.jsx)(t.h3,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsx)(t.p,{children:`Хорошие сценарии:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`toggle/checkbox;`}),`
+`,(0,c.jsx)(t.li,{children:`изменение видимости;`}),`
+`,(0,c.jsx)(t.li,{children:`простое inline-edit;`}),`
+`,(0,c.jsx)(t.li,{children:`drag-and-drop reorder;`}),`
+`,(0,c.jsx)(t.li,{children:`добавление элемента с временным id;`}),`
+`,(0,c.jsx)(t.li,{children:`действие с высокой вероятностью успеха и понятным rollback.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте автоматически для:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`финансовых операций;`}),`
+`,(0,c.jsx)(t.li,{children:`сложной server validation;`}),`
+`,(0,c.jsx)(t.li,{children:`действия с большим количеством side effects;`}),`
+`,(0,c.jsx)(t.li,{children:`mutation, где server радикально меняет результат;`}),`
+`,(0,c.jsx)(t.li,{children:`нескольких параллельных изменений одного cache key без concurrency strategy;`}),`
+`,(0,c.jsx)(t.li,{children:`операции, для которой невозможно корректно восстановить UI.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Optimistic UI не означает, что операция завершилась успешно. Показывайте error/recovery, если server отказал.`}),`
+`,(0,c.jsx)(t.h3,{id:`роль-lifecycle-handlers`,children:`Роль lifecycle handlers`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`mutate(variables)
+      │
+      ▼
+onMutate
+  1. cancelQueries
+  2. snapshot previous cache
+  3. optimistic patch
+  4. return { previous }
+      │
+      ▼
+mutationFn
+      ├─ success → onSuccess
+      │             server data merge, если нужно
+      │
+      ├─ error   → onError
+      │             rollback previous
+      │
+      └─ always  → onSettled
+                    scoped invalidation/refetch policy
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`TanStack Query передаёт результат `,(0,c.jsx)(t.code,{children:`onMutate`}),` в следующие lifecycle callbacks.`]}),`
+`,(0,c.jsx)(t.h3,{id:`публичные-helpers`,children:`Публичные helpers`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Helper`}),(0,c.jsx)(t.th,{children:`Lifecycle`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onMutateOptimistic`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onMutate`})}),(0,c.jsx)(t.td,{children:`Cancel + snapshot + patch.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onErrorOptimistic`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onError`})}),(0,c.jsx)(t.td,{children:`Restore предыдущего snapshot.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onSuccessOptimistic`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onSuccess`})}),(0,c.jsx)(t.td,{children:`Merge authoritative server response.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onSettledOptimistic`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onSettled`})}),(0,c.jsx)(t.td,{children:`Invalidate один или несколько keys.`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Helpers низкоуровневые: они не создают `,(0,c.jsx)(t.code,{children:`useMutation`}),`, не выполняют request, не показывают notification и не выбирают query key.`]}),`
+`,(0,c.jsx)(t.h3,{id:`optimisticcontext`,children:(0,c.jsx)(t.code,{children:`OptimisticContext`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type OptimisticContext<TQueryCacheData> = {
+	previous: TQueryCacheData | undefined;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`TQueryCacheData`}),` — тип data именно в Query cache, не request variables и не обязательно server response.`]}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Task = {
+	id: string;
+	title: string;
+	done: boolean;
+};
+
+type TaskCache = Task[];
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`onmutateoptimistic`,children:(0,c.jsx)(t.code,{children:`onMutateOptimistic`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const context = await onMutateOptimistic<TaskCache>(queryClient, tasksQueryKey, (oldCache) => {
+	return oldCache?.map((task) => (task.id === taskId ? { ...task, done: true } : task));
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Signature:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function onMutateOptimistic<TQueryCacheData>(
+	queryClient: QueryClient,
+	queryKey: QueryKey,
+	patcher: (oldCache: TQueryCacheData | undefined) => TQueryCacheData | undefined
+): Promise<OptimisticContext<TQueryCacheData>>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Три шага выполняются последовательно:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cancelQueries({ queryKey })`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`getQueryData<TQueryCacheData>(queryKey)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`setQueryData<TQueryCacheData>(queryKey, patcher)`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`зачем-cancelqueries`,children:[`Зачем `,(0,c.jsx)(t.code,{children:`cancelQueries`})]}),`
+`,(0,c.jsx)(t.p,{children:`Без отмены background refetch может завершиться после optimistic patch и записать старый server snapshot:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`cache: done=false
+background request начат
+optimistic patch: done=true
+background response: done=false  ← patch потерян
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cancelQueries`}),` уменьшает эту race condition.`]}),`
+`,(0,c.jsx)(t.p,{children:`Он не отменяет другие mutation. Параллельные writes требуют отдельной стратегии.`}),`
+`,(0,c.jsx)(t.h3,{id:`exact-и-prefix-key`,children:`Exact и prefix key`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cancelQueries({ queryKey })`}),` по TanStack defaults может затронуть query, совпадающие по prefix.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getQueryData`}),` и `,(0,c.jsx)(t.code,{children:`setQueryData`}),` работают с конкретным cache key.`]}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому для optimistic patch передавайте exact owner key, а не слишком широкий prefix:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const key = ["tasks", { projectId }] as const;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`patcher-должен-быть-immutable`,children:`Patcher должен быть immutable`}),`
+`,(0,c.jsx)(t.p,{children:`Неверно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`(old) => {
+	const task = old?.find((item) => item.id === taskId);
+	if (task) task.done = true;
+	return old;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Объект из Query cache мутирован по существующей ссылке.`}),`
+`,(0,c.jsx)(t.p,{children:`Правильно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`(old) => old?.map((task) => (task.id === taskId ? { ...task, done: true } : task));
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Создаётся новый массив и новый изменённый object.`}),`
+`,(0,c.jsxs)(t.h3,{id:`что-означает-undefined-из-patcher`,children:[`Что означает `,(0,c.jsx)(t.code,{children:`undefined`}),` из patcher`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Patcher получает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если cache entry/data отсутствует.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`(old) => old?.map(...)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`вернёт `,(0,c.jsx)(t.code,{children:`undefined`}),` и не создаст data.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если нужно создать initial optimistic data:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`(old) => [...(old ?? []), optimisticTask];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Но тогда обязательно учтите ограничение rollback при отсутствующем previous snapshot.`}),`
+`,(0,c.jsx)(t.h3,{id:`onerroroptimistic`,children:(0,c.jsx)(t.code,{children:`onErrorOptimistic`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onErrorOptimistic(queryClient, tasksQueryKey, context);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Signature:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function onErrorOptimistic<TQueryCacheData>(
+	queryClient: QueryClient,
+	queryKey: QueryKey,
+	context: OptimisticContext<TQueryCacheData> | undefined
+): void;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`context?.previous !== undefined`}),`, helper вызывает:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryClient.setQueryData(queryKey, context.previous);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если context отсутствует, ничего не происходит. Это безопасно, когда `,(0,c.jsx)(t.code,{children:`onMutate`}),` сам завершился ошибкой до возврата context.`]}),`
+`,(0,c.jsx)(t.h3,{id:`важное-ограничение-rollback`,children:`Важное ограничение rollback`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если до mutation data была `,(0,c.jsx)(t.code,{children:`undefined`}),`, context содержит:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	previous: undefined;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`onErrorOptimistic`}),` ничего не делает. Он не удаляет созданную optimistic entry.`]}),`
+`,(0,c.jsx)(t.p,{children:`Проблемный сценарий:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Cache до mutation отсутствует.
+onMutateOptimistic<Task[]>(queryClient, key, (old) => [...(old ?? []), optimisticTask]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`При error optimistic task останется, если вызвать только standard helper.`}),`
+`,(0,c.jsx)(t.p,{children:`Варианты решения:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`До optimistic create заранее обеспечить существующий cache snapshot, например `,(0,c.jsx)(t.code,{children:`[]`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`В `,(0,c.jsx)(t.code,{children:`onError`}),` отдельно удалить/очистить query, если `,(0,c.jsx)(t.code,{children:`context.previous === undefined`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не применять optimistic create для изначально отсутствующей query.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Пример explicit rollback:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onError: (_error, _variables, context) => {
+	if (context?.previous === undefined) {
+		queryClient.removeQueries({ queryKey: tasksQueryKey, exact: true });
+		return;
+	}
+
+	onErrorOptimistic(queryClient, tasksQueryKey, context);
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Выбирайте удаление только для exact key, которым владеет mutation.`}),`
+`,(0,c.jsx)(t.h3,{id:`onsuccessoptimistic`,children:(0,c.jsx)(t.code,{children:`onSuccessOptimistic`})}),`
+`,(0,c.jsx)(t.p,{children:`Когда server возвращает authoritative data:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSuccessOptimistic<Task[], Task>(queryClient, tasksQueryKey, serverTask, (cache, task) => {
+	return cache?.map((item) => (item.id === task.id ? task : item));
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Signature:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function onSuccessOptimistic<TQueryCacheData, TServerData>(
+	queryClient: QueryClient,
+	queryKey: QueryKey,
+	serverData: TServerData,
+	merger: (cache: TQueryCacheData | undefined, serverData: TServerData) => TQueryCacheData | undefined
+): void;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`TServerData`}),` может отличаться от cache data. Merger является явным type-safe мостом.`]}),`
+`,(0,c.jsx)(t.h3,{id:`полная-замена-ответом-server`,children:`Полная замена ответом server`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSuccessOptimistic<Task[], Task[]>(queryClient, tasksQueryKey, serverTasks, (_cache, data) => data);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`merge-одного-элемента`,children:`Merge одного элемента`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSuccessOptimistic<Task[], Task>(queryClient, tasksQueryKey, updatedTask, (cache, data) =>
+	cache?.map((task) => (task.id === data.id ? data : task))
+);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Merger тоже должен быть immutable.`}),`
+`,(0,c.jsxs)(t.h3,{id:`server-возвращает-void`,children:[`Server возвращает `,(0,c.jsx)(t.code,{children:`void`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если request только подтверждает изменение, а optimistic cache уже отражает точное состояние, `,(0,c.jsx)(t.code,{children:`onSuccessOptimistic`}),` не нужен:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSuccess: () => {
+	// Нечего сливать: server response void.
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`После этого выберите onSettled invalidation strategy. Не вызывайте merger с `,(0,c.jsx)(t.code,{children:`void`}),` только ради формальности.`]}),`
+`,(0,c.jsx)(t.h3,{id:`onsettledoptimistic`,children:(0,c.jsx)(t.code,{children:`onSettledOptimistic`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await onSettledOptimistic(queryClient, tasksQueryKey);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Или несколько keys:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await onSettledOptimistic(queryClient, [tasksQueryKey, taskSummaryQueryKey], { refetchType: "active" });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Signature:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type OnSettledOptimisticOptions = {
+	refetchType?: "none" | "active" | "inactive" | "all";
+};
+
+async function onSettledOptimistic(
+	queryClient: QueryClient,
+	queryKeys: QueryKey | QueryKey[],
+	options?: OnSettledOptimisticOptions
+): Promise<void>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper вызывает `,(0,c.jsx)(t.code,{children:`invalidateQueries`}),` для всех normalized keys через `,(0,c.jsx)(t.code,{children:`Promise.all`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`refetchtype`,children:(0,c.jsx)(t.code,{children:`refetchType`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Value`}),(0,c.jsx)(t.th,{children:`Поведение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"none"`})}),(0,c.jsx)(t.td,{children:`Только invalidation, немедленного refetch нет. Default helper-а.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"active"`})}),(0,c.jsx)(t.td,{children:`Refetch active matching query.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"inactive"`})}),(0,c.jsx)(t.td,{children:`Refetch inactive matching query.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"all"`})}),(0,c.jsx)(t.td,{children:`Refetch active и inactive matching query.`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`"none"`}),` подходит, когда optimistic/server merge уже дал достаточное текущее состояние.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`"active"`}),` нужен, если server применяет дополнительную логику и видимый UI должен быстро получить authoritative snapshot.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не ставьте `,(0,c.jsx)(t.code,{children:`"all"`}),` автоматически: это может создать много HTTP requests.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-передавать-один-и-несколько-keys`,children:`Как передавать один и несколько keys`}),`
+`,(0,c.jsx)(t.p,{children:`Один key:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSettledOptimistic(queryClient, ["tasks"]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Несколько keys:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSettledOptimistic(queryClient, [["tasks"], ["task-summary"]]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Runtime различает формы по первому элементу: если первый элемент сам array, значение считается массивом keys.`}),`
+`,(0,c.jsx)(t.p,{children:`Избегайте необычного одиночного QueryKey, у которого первый segment является array:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ambiguousKey = [["nested"]] as const;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Он будет воспринят как список query keys.`}),`
+`,(0,c.jsxs)(t.h3,{id:`полный-пример-toggle-server-возвращает-void`,children:[`Полный пример: toggle, server возвращает `,(0,c.jsx)(t.code,{children:`void`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { onErrorOptimistic, onMutateOptimistic, onSettledOptimistic } from "@ryuzaki13/react-foundation-lib/query-client";
+
+type Task = {
+	id: string;
+	title: string;
+	done: boolean;
+};
+
+type ToggleTaskInput = {
+	id: string;
+	done: boolean;
+};
+
+const tasksQueryKey = ["tasks"] as const;
+
+export function useToggleTaskMutation() {
+	const queryClient = useQueryClient();
+
+	return useMutation({
+		mutationFn: updateTaskOnServer,
+
+		onMutate: async (input: ToggleTaskInput) => {
+			return onMutateOptimistic<Task[]>(queryClient, tasksQueryKey, (old) =>
+				old?.map((task) => (task.id === input.id ? { ...task, done: input.done } : task))
+			);
+		},
+
+		onError: (_error, _input, context) => {
+			onErrorOptimistic(queryClient, tasksQueryKey, context);
+		},
+
+		onSettled: () => {
+			return onSettledOptimistic(queryClient, tasksQueryKey);
+		}
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Cache timeline:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`до:       [{ id: "1", done: false }]
+onMutate: [{ id: "1", done: true  }]
+
+success:  optimistic data остаётся, query помечается stale
+error:    previous snapshot восстанавливается
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`полный-пример-create-с-authoritative-object`,children:`Полный пример: create с authoritative object`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Task = {
+	id: string;
+	title: string;
+	createdAt: string;
+};
+
+type NewTask = {
+	title: string;
+};
+
+const TEMP_ID = "optimistic:task";
+
+export function useCreateTaskMutation() {
+	const queryClient = useQueryClient();
+
+	return useMutation({
+		mutationFn: createTaskOnServer,
+
+		onMutate: async (input: NewTask) => {
+			return onMutateOptimistic<Task[]>(queryClient, tasksQueryKey, (old) => [
+				...(old ?? []),
+				{ id: TEMP_ID, title: input.title, createdAt: "" }
+			]);
+		},
+
+		onError: (_error, _input, context) => {
+			if (context?.previous === undefined) {
+				queryClient.removeQueries({
+					queryKey: tasksQueryKey,
+					exact: true
+				});
+				return;
+			}
+
+			onErrorOptimistic(queryClient, tasksQueryKey, context);
+		},
+
+		onSuccess: (createdTask: Task) => {
+			onSuccessOptimistic<Task[], Task>(
+				queryClient,
+				tasksQueryKey,
+				createdTask,
+				(cache, serverTask) => cache?.map((task) => (task.id === TEMP_ID ? serverTask : task)) ?? [serverTask]
+			);
+		},
+
+		onSettled: () => {
+			return onSettledOptimistic(queryClient, tasksQueryKey, { refetchType: "active" });
+		}
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Timeline:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`до:
+[{ id: "server-1", title: "Первая", createdAt: "..." }]
+
+optimistic:
+[
+  { id: "server-1", ... },
+  { id: "optimistic:task", title: "Вторая", createdAt: "" }
+]
+
+server success:
+[
+  { id: "server-1", ... },
+  { id: "server-2", title: "Вторая", createdAt: "2026-08-18..." }
+]
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`несколько-связанных-keys`,children:`Несколько связанных keys`}),`
+`,(0,c.jsx)(t.p,{children:`Mutation может влиять на detail, list и counters:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSettled: () =>
+	onSettledOptimistic(
+		queryClient,
+		[
+			["orders", orderId],
+			["orders", "list"],
+			["orders", "counters"]
+		],
+		{ refetchType: "active" }
+	);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Указывайте только keys реальных owners. Не инвалидируйте весь cache приложения.`}),`
+`,(0,c.jsx)(t.h3,{id:`optimistic-update-и-broadcast`,children:`Optimistic update и broadcast`}),`
+`,(0,c.jsxs)(t.p,{children:[`Optimistic helpers сами не вызывают `,(0,c.jsx)(t.code,{children:`broadcastCacheEvent`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При установленном `,(0,c.jsx)(t.code,{children:`installReactQueryBroadcast`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`обычный Query cache update может уйти через TanStack data channel;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`onSettledOptimistic`}),` вызывает local invalidation;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`wrapper автоматически передаст конкретную invalidation другой вкладке с `,(0,c.jsx)(t.code,{children:`refetchType: "none"`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Manual event нужен только для осознанного другого поведения:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onSettled: async () => {
+	await onSettledOptimistic(queryClient, tasksQueryKey, { refetchType: "active" });
+
+	broadcastCacheEvent({
+		type: "invalidate",
+		keys: [tasksQueryKey],
+		refetchType: "active"
+	});
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Такой explicit event может дублировать automatic `,(0,c.jsx)(t.code,{children:`"none"`}),` invalidation message. Делайте это только если remote active refetch действительно требуется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`параллельные-mutation-одного-key`,children:`Параллельные mutation одного key`}),`
+`,(0,c.jsx)(t.p,{children:`Helpers хранят один snapshot на каждую mutation, но не координируют порядок нескольких writes.`}),`
+`,(0,c.jsx)(t.p,{children:`Проблема:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`cache = A
+
+mutation 1 snapshot A → patch B
+mutation 2 snapshot B → patch C
+mutation 2 success
+mutation 1 error → rollback A
+
+успешный результат mutation 2 потерян
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cancelQueries`}),` отменяет reads, а не соседние mutations.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для concurrent writes выберите стратегию:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`сериализовать mutation по entity/key;`}),`
+`,(0,c.jsx)(t.li,{children:`блокировать повторное действие до settlement;`}),`
+`,(0,c.jsx)(t.li,{children:`хранить более богатый optimistic context/patch stack;`}),`
+`,(0,c.jsx)(t.li,{children:`использовать mutation id и условный rollback;`}),`
+`,(0,c.jsx)(t.li,{children:`отказаться от optimistic update и refetch server snapshot.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Текущие helpers лучше подходят одной последовательной mutation для одного exact cache key.`}),`
+`,(0,c.jsx)(t.h3,{id:`server-validation-и-merge`,children:`Server validation и merge`}),`
+`,(0,c.jsx)(t.p,{children:`Если server:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`округляет число;`}),`
+`,(0,c.jsx)(t.li,{children:`добавляет id/timestamp;`}),`
+`,(0,c.jsx)(t.li,{children:`меняет status;`}),`
+`,(0,c.jsx)(t.li,{children:`пересчитывает totals;`}),`
+`,(0,c.jsx)(t.li,{children:`сортирует list;`}),`
+`,(0,c.jsx)(t.li,{children:`применяет permissions/business rules,`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`то optimistic value не является authoritative. Используйте `,(0,c.jsx)(t.code,{children:`onSuccessOptimistic`}),` либо active invalidation.`]}),`
+`,(0,c.jsx)(t.h3,{id:`error-handling`,children:`Error handling`}),`
+`,(0,c.jsxs)(t.p,{children:[`Rollback восстанавливает cache, но не объясняет ошибку пользователю. В `,(0,c.jsx)(t.code,{children:`onError`}),` обычно нужны:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`rollback;`}),`
+`,(0,c.jsx)(t.li,{children:`безопасное notification;`}),`
+`,(0,c.jsx)(t.li,{children:`diagnostics без sensitive data;`}),`
+`,(0,c.jsx)(t.li,{children:`понятная возможность повторить действие.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`onError: (error, _variables, context) => {
+	onErrorOptimistic(queryClient, key, context);
+	notifyError("Изменение не сохранено");
+	reportError(error);
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не оставляйте пустой `,(0,c.jsx)(t.code,{children:`catch`}),` и не показывайте success до фактического server confirmation, если это может ввести пользователя в заблуждение.`]}),`
+`,(0,c.jsx)(t.h3,{id:`типовые-ошибки`,children:`Типовые ошибки`}),`
+`,(0,c.jsx)(t.h4,{id:`мутировать-old-cache`,children:`Мутировать old cache`}),`
+`,(0,c.jsx)(t.p,{children:`Всегда возвращайте новые изменённые containers/objects.`}),`
+`,(0,c.jsx)(t.h4,{id:`забыть-rollback`,children:`Забыть rollback`}),`
+`,(0,c.jsxs)(t.p,{children:[`Optimistic patch без `,(0,c.jsx)(t.code,{children:`onError`}),` оставит ложное состояние при отказе server.`]}),`
+`,(0,c.jsxs)(t.h4,{id:`считать-context-обязательным`,children:[`Считать `,(0,c.jsx)(t.code,{children:`context`}),` обязательным`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`onMutate`}),` выбросил ошибку, context может быть `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsxs)(t.h4,{id:`не-учесть-previous-undefined`,children:[`Не учесть `,(0,c.jsx)(t.code,{children:`previous: undefined`})]}),`
+`,(0,c.jsx)(t.p,{children:`Standard rollback helper не удаляет новую cache entry.`}),`
+`,(0,c.jsxs)(t.h4,{id:`refetch-all-после-каждой-mutation`,children:[`Refetch `,(0,c.jsx)(t.code,{children:`all`}),` после каждой mutation`]}),`
+`,(0,c.jsx)(t.p,{children:`Создаёт лишний network traffic и может ухудшить UX сильнее обычной non-optimistic mutation.`}),`
+`,(0,c.jsx)(t.h4,{id:`использовать-широкий-query-prefix-как-exact-data-key`,children:`Использовать широкий query prefix как exact data key`}),`
+`,(0,c.jsx)(t.p,{children:`Cancel и patch начнут относиться к разным наборам cache entries.`}),`
+`,(0,c.jsx)(t.h4,{id:`игнорировать-параллельные-writes`,children:`Игнорировать параллельные writes`}),`
+`,(0,c.jsx)(t.p,{children:`Поздний rollback старой mutation может затереть более новое успешное изменение.`}),`
+`,(0,c.jsx)(t.h2,{id:`безопасность-и-сериализация`,children:`Безопасность и сериализация`}),`
+`,(0,c.jsx)(t.h3,{id:`query-key-не-должен-содержать-secrets`,children:`Query key не должен содержать secrets`}),`
+`,(0,c.jsx)(t.p,{children:`Query key может попасть:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`в memory cache;`}),`
+`,(0,c.jsx)(t.li,{children:`в IndexedDB persistent key/state;`}),`
+`,(0,c.jsx)(t.li,{children:`в broadcast message;`}),`
+`,(0,c.jsx)(t.li,{children:`в DevTools;`}),`
+`,(0,c.jsx)(t.li,{children:`в diagnostics/error report.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Нельзя помещать:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`token;`}),`
+`,(0,c.jsx)(t.li,{children:`password;`}),`
+`,(0,c.jsx)(t.li,{children:`session cookie;`}),`
+`,(0,c.jsx)(t.li,{children:`raw authorization header;`}),`
+`,(0,c.jsx)(t.li,{children:`секретный payload.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Используйте безопасные business identifiers и нормализованные параметры.`}),`
+`,(0,c.jsx)(t.h3,{id:`persistence--явное-разрешение`,children:`Persistence — явное разрешение`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),` означает, что data может пережить reload и оставаться в browser storage долгое время.`]}),`
+`,(0,c.jsx)(t.p,{children:`Перед включением проверьте:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Data не персональная и не session-scoped.`}),`
+`,(0,c.jsx)(t.li,{children:`Namespace разделяет несовместимые system/client/tenant.`}),`
+`,(0,c.jsx)(t.li,{children:`Query key включает все влияющие параметры.`}),`
+`,(0,c.jsx)(t.li,{children:`Есть freshness/invalidation policy.`}),`
+`,(0,c.jsx)(t.li,{children:`Data поддерживает structured clone.`}),`
+`,(0,c.jsx)(t.li,{children:`Объём не создаёт неконтролируемый storage growth.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`namespace-не-является-authorization`,children:`Namespace не является authorization`}),`
+`,(0,c.jsxs)(t.p,{children:[`Разные `,(0,c.jsx)(t.code,{children:`dbName`}),`/prefix уменьшают случайное смешение environments, но не защищают от JavaScript того же origin.`]}),`
+`,(0,c.jsx)(t.p,{children:`При XSS вредоносный code может читать browser storage и channels. Не сохраняйте sensitive data, полагаясь только на необычное имя database.`}),`
+`,(0,c.jsx)(t.h3,{id:`broadcast-не-является-доверенным-transport`,children:`Broadcast не является доверенным transport`}),`
+`,(0,c.jsx)(t.p,{children:`Message приходит от другого context того же origin. Runtime guards фильтруют явный мусор, но не проверяют business authorization или точный data schema.`}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте broadcast вместо backend confirmation.`}),`
+`,(0,c.jsx)(t.h3,{id:`structured-clone-ограничения`,children:`Structured clone ограничения`}),`
+`,(0,c.jsx)(t.p,{children:`И IndexedDB, и BroadcastChannel используют structured clone. Plain serializable data — самый предсказуемый вариант:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SafeCacheData = {
+	id: string;
+	count: number;
+	labels: string[];
+	updatedAt: string;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сложные instances могут потерять ожидаемое поведение или не клонироваться.`}),`
+`,(0,c.jsx)(t.h3,{id:`error-callbacks-и-персональные-данные`,children:`Error callbacks и персональные данные`}),`
+`,(0,c.jsx)(t.p,{children:`Global error handler получает query/mutation objects и variables. Не логируйте их целиком без sanitization.`}),`
+`,(0,c.jsx)(t.p,{children:`Хороший diagnostics context:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  operation: "update-task",
+  queryKeyOwner: "tasks",
+  errorName: error.name,
+  message: error.message
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Плохой context:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  mutationVariables,
+  allQueryCache: queryClient.getQueryCache().getAll(),
+  token
+}
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`browser-ssr-и-lifecycle`,children:`Browser, SSR и lifecycle`}),`
+`,(0,c.jsx)(t.h3,{id:`основная-среда--browser-spa`,children:`Основная среда — browser SPA`}),`
+`,(0,c.jsx)(t.p,{children:`Persistence и broadcast предназначены для browser runtime:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`IndexedDB;`}),`
+`,(0,c.jsx)(t.li,{children:`BroadcastChannel;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`window.location.hostname`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`несколько вкладок одного origin.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Pure QueryClient/optimistic helpers сами используют TanStack Query API, но единый entrypoint всё равно требует корректных build-time constants.`}),`
+`,(0,c.jsx)(t.h3,{id:`поведение-без-indexeddb`,children:`Поведение без IndexedDB`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createIndexedDbQueryStorage(); // undefined
+createReactQueryPersister(); // undefined
+createQueryClient({}); // работает без default persister
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Приложение продолжает работать с обычным memory cache.`}),`
+`,(0,c.jsxs)(t.h3,{id:`поведение-без-window`,children:[`Поведение без `,(0,c.jsx)(t.code,{children:`window`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`installReactQueryBroadcast`}),` возвращает no-op.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`installSessionScopedQueryReset`}),` возвращает no-op cleanup.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`resetSessionScopedQueries`}),` продолжает локально работать с QueryClient.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Production system identifier fallback без window — `,(0,c.jsx)(t.code,{children:`{APP_ID}:server`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`window-есть-broadcastchannel-нет`,children:[(0,c.jsx)(t.code,{children:`window`}),` есть, BroadcastChannel нет`]}),`
+`,(0,c.jsx)(t.p,{children:`Session reset installation проверяет оба globals и деградирует в no-op.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Общая cache broadcast installation проверяет только `,(0,c.jsx)(t.code,{children:`window`}),`. Сделайте дополнительный feature check в host, если поддерживаются browsers без BroadcastChannel.`]}),`
+`,(0,c.jsx)(t.h3,{id:`global-module-state`,children:`Global module state`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль хранит:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`текущий persistence project adapter;`}),`
+`,(0,c.jsx)(t.li,{children:`global cache broadcast function;`}),`
+`,(0,c.jsx)(t.li,{children:`global session-reset sender.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это process/module singletons. В обычной SPA они удобны, но в tests, HMR и microfrontends требуют lifecycle discipline.`}),`
+`,(0,c.jsx)(t.h3,{id:`повторная-installation`,children:`Повторная installation`}),`
+`,(0,c.jsx)(t.p,{children:`Перед повторной установкой:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`сбросьте imperative broadcast handler;`}),`
+`,(0,c.jsx)(t.li,{children:`вызовите cleanup предыдущего broadcast;`}),`
+`,(0,c.jsx)(t.li,{children:`вызовите cleanup session channel;`}),`
+`,(0,c.jsx)(t.li,{children:`установите новые channels;`}),`
+`,(0,c.jsx)(t.li,{children:`сохраните новый handler.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Иначе останутся дублированные subscriptions/channels.`}),`
+`,(0,c.jsx)(t.h3,{id:`react-provider`,children:`React Provider`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createQueryClient`}),` не рендерит Provider:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<QueryClientProvider client={queryClient}>
+	<App />
+</QueryClientProvider>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useQueryClient`}),`, `,(0,c.jsx)(t.code,{children:`useQuery`}),` и `,(0,c.jsx)(t.code,{children:`useMutation`}),` требуют этот provider в component tree.`]}),`
+`,(0,c.jsx)(t.h3,{id:`react-strict-mode`,children:`React Strict Mode`}),`
+`,(0,c.jsx)(t.p,{children:`Не устанавливайте channels внутри component render/effect без уверенного cleanup. В development Strict Mode effect setup может выполняться повторно.`}),`
+`,(0,c.jsx)(t.p,{children:`Предпочтительно устанавливать application-wide QueryClient/channels в bootstrap module или в отдельной lifecycle boundary с симметричным cleanup.`}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование-consumer-кода`,children:`Тестирование consumer-кода`}),`
+`,(0,c.jsx)(t.h3,{id:`test-queryclient-без-retry`,children:`Test QueryClient без retry`}),`
+`,(0,c.jsx)(t.p,{children:`Для unit test создавайте отдельный client:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { QueryClient } from "@tanstack/react-query";
+
+export function createTestQueryClient() {
+	return new QueryClient({
+		defaultOptions: {
+			queries: { retry: false },
+			mutations: { retry: false }
+		}
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это изолирует cache каждого test.`}),`
+`,(0,c.jsx)(t.p,{children:`После test:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`queryClient.clear();
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`test-createqueryclient`,children:[`Test `,(0,c.jsx)(t.code,{children:`createQueryClient`})]}),`
+`,(0,c.jsx)(t.p,{children:`Проверьте defaults и error callbacks:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const client = createQueryClient({});
+
+expect(client.getDefaultOptions().queries).toMatchObject({
+	staleTime: 10 * 60 * 1000,
+	gcTime: 30 * 60 * 1000,
+	retry: false,
+	throwOnError: false
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В environment без IndexedDB `,(0,c.jsx)(t.code,{children:`persister`}),` должен отсутствовать.`]}),`
+`,(0,c.jsx)(t.h3,{id:`indexeddb-test`,children:`IndexedDB test`}),`
+`,(0,c.jsx)(t.p,{children:`Передайте factory явно, не полагаясь на browser global:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { indexedDB } from "fake-indexeddb";
+
+const storage = createIndexedDbQueryStorage<string>({
+	indexedDB,
+	dbName: "query-client-test"
+});
+
+expect(storage).toBeDefined();
+await storage?.setItem("key", "value");
+await expect(storage?.getItem("key")).resolves.toBe("value");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте уникальный `,(0,c.jsx)(t.code,{children:`dbName`}),` между несвязанными tests, чтобы data не протекала.`]}),`
+`,(0,c.jsx)(t.h3,{id:`test-opt-in-persistence`,children:`Test opt-in persistence`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(shouldPersistQuery({ meta: persistedQueryMeta })).toBe(true);
+expect(shouldPersistQuery({ meta: undefined })).toBe(false);
+expect(shouldPersistQuery({ meta: sessionScopedQueryMeta })).toBe(false);
+expect(
+	shouldPersistQuery({
+		meta: { persist: true, sessionScoped: true }
+	})
+).toBe(false);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`test-optimistic-rollback`,children:`Test optimistic rollback`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const client = createTestQueryClient();
+const key = ["tasks"] as const;
+const initial = [{ id: "1", done: false }];
+
+client.setQueryData(key, initial);
+
+const context = await onMutateOptimistic<typeof initial>(client, key, (old) => old?.map((task) => ({ ...task, done: true })));
+
+expect(client.getQueryData(key)).toEqual([{ id: "1", done: true }]);
+
+onErrorOptimistic(client, key, context);
+expect(client.getQueryData(key)).toEqual(initial);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Отдельно тестируйте `,(0,c.jsx)(t.code,{children:`previous: undefined`}),`, если mutation способна создать cache entry.`]}),`
+`,(0,c.jsx)(t.h3,{id:`test-session-reset`,children:`Test session reset`}),`
+`,(0,c.jsx)(t.p,{children:`Создайте public и session query, выполните reset и проверьте их отдельно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await client.fetchQuery({
+	queryKey: ["public"],
+	queryFn: () => "public"
+});
+
+await client.fetchQuery({
+	queryKey: ["session"],
+	queryFn: () => "private",
+	meta: sessionScopedQueryMeta
+});
+
+await resetSessionScopedQueries(client, { broadcast: false });
+
+expect(client.getQueryData(["public"])).toBe("public");
+expect(client.getQueryData(["session"])).toBeUndefined();
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`test-broadcastchannel`,children:`Test BroadcastChannel`}),`
+`,(0,c.jsx)(t.p,{children:`Для unit test предоставьте fake implementation, которая:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`регистрирует channels по имени;`}),`
+`,(0,c.jsx)(t.li,{children:`отправляет message другим instances, но не себе;`}),`
+`,(0,c.jsxs)(t.li,{children:[`вызывает `,(0,c.jsx)(t.code,{children:`onmessage`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`умеет `,(0,c.jsx)(t.code,{children:`close`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`очищает registry после test.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Всегда вызывайте installation cleanup.`}),`
+`,(0,c.jsx)(t.h3,{id:`сброс-global-state-между-tests`,children:`Сброс global state между tests`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`setBroadcastFn(() => undefined);
+configureQueryPersistenceProjectAdapter({});
+installedBroadcast?.cleanup();
+installedSessionReset?.cleanup();
+queryClient.clear();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Без cleanup test order может влиять на результат.`}),`
+`,(0,c.jsx)(t.h3,{id:`проверки-самого-пакета`,children:`Проверки самого пакета`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm run typecheck
+npm run lint
+node_modules/.bin/vitest run src/query-client
+npm run build
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Profile tests подтверждают:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`IndexedDB CRUD и opt-in filtering;`}),`
+`,(0,c.jsx)(t.li,{children:`условное подключение persister;`}),`
+`,(0,c.jsx)(t.li,{children:`broadcast no-op вне browser;`}),`
+`,(0,c.jsx)(t.li,{children:`cache data/invalidation sync;`}),`
+`,(0,c.jsx)(t.li,{children:`игнорирование невалидных messages;`}),`
+`,(0,c.jsx)(t.li,{children:`отсутствие remote event loop;`}),`
+`,(0,c.jsx)(t.li,{children:`optimistic snapshot/patch/rollback/merge/invalidation;`}),`
+`,(0,c.jsx)(t.li,{children:`session reset active/inactive/disabled/hydrated query;`}),`
+`,(0,c.jsx)(t.li,{children:`межвкладочную reset command без cache data.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`полная-карта-api`,children:`Полная карта API`}),`
+`,(0,c.jsx)(t.p,{children:`Раздел перечисляет все публичные symbols entrypoint. Не импортируйте другие names через private path.`}),`
+`,(0,c.jsx)(t.h3,{id:`queryclient-1`,children:`QueryClient`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`QueryBroadcastOptions`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Global query/mutation error callbacks.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createQueryClient`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Создаёт новый настроенный QueryClient.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`query-metadata-1`,children:`Query metadata`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AppQueryMeta`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`persist`}),`, `,(0,c.jsx)(t.code,{children:`sessionScoped`}),` и consumer metadata.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`persistedQueryMeta`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Opt-in public persistence marker.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sessionScopedQueryMeta`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Session reset marker.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`persistence-project-adapter`,children:`Persistence project adapter`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`QueryPersistenceProjectAdapter`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Buster и system identifier resolver.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`configureQueryPersistenceProjectAdapter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Заменяет global adapter.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getQueryPersistenceProjectAdapter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Возвращает текущий adapter.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`indexeddb-persistence-1`,children:`IndexedDB persistence`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`REACT_QUERY_PERSISTENCE_BUSTER`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Build-time default buster.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`REACT_QUERY_PERSISTENCE_MAX_AGE`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Persistent max age: 90 дней.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`shouldPersistQuery`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Opt-in predicate с session safety.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createIndexedDbQueryStorage`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`AsyncStorage поверх IndexedDB.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createReactQueryPersister`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Настроенный per-query TanStack persister.`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Options type `,(0,c.jsx)(t.code,{children:`createIndexedDbQueryStorage`}),` не экспортируется отдельным symbol; используйте структурный object или `,(0,c.jsx)(t.code,{children:`Parameters<typeof createIndexedDbQueryStorage>[0]`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`broadcast`,children:`Broadcast`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`installReactQueryBroadcast`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Устанавливает data + event channels.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`setBroadcastFn`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Устанавливает global imperative sender.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`broadcastCacheEvent`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Отправляет event через текущий sender.`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`CacheSyncEvent`}),`, installation options и result types не экспортируются отдельными именами. Они доступны через inference:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type BroadcastEvent = Parameters<typeof broadcastCacheEvent>[0];
+type BroadcastOptions = Parameters<typeof installReactQueryBroadcast>[1];
+type InstalledBroadcast = ReturnType<typeof installReactQueryBroadcast>;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`session-scoped-cache`,children:`Session-scoped cache`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ResetSessionScopedQueriesOptions`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Управляет broadcast reset.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`InstallSessionScopedQueryResetOptions`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Имя command channel.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`InstalledSessionScopedQueryReset`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Cleanup contract.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isSessionScopedQuery`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Predicate по query meta.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resetSessionScopedQueries`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Cancel/clear/refetch session query.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`installSessionScopedQueryReset`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Межвкладочная reset-command installation.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`optimistic-update-1`,children:`Optimistic update`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`OptimisticContext`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Previous cache snapshot.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`OnSettledOptimisticOptions`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Invalidation refetchType.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onMutateOptimistic`})}),(0,c.jsx)(t.td,{children:`async function`}),(0,c.jsx)(t.td,{children:`Cancel, snapshot и optimistic patch.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onErrorOptimistic`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Rollback defined previous snapshot.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onSuccessOptimistic`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Merge server data в текущий cache.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onSettledOptimistic`})}),(0,c.jsx)(t.td,{children:`async function`}),(0,c.jsx)(t.td,{children:`Invalidate один/несколько keys.`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-вопросы`,children:`Частые вопросы`}),`
+`,(0,c.jsxs)(t.h3,{id:`createqueryclient-действительно-singleton`,children:[(0,c.jsx)(t.code,{children:`createQueryClient`}),` действительно singleton?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Функция создаёт новый client при каждом вызове. Host должен вызвать её один раз и экспортировать instance.`}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-помечать-каждую-query-persistedquerymeta`,children:[`Нужно ли помечать каждую query `,(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Persistence строго opt-in и подходит только проверенным публичным долгоживущим data.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-query-с-persistedquerymeta-не-появилась-в-indexeddb`,children:[`Почему query с `,(0,c.jsx)(t.code,{children:`persistedQueryMeta`}),` не появилась в IndexedDB?`]}),`
+`,(0,c.jsx)(t.p,{children:`Проверьте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`доступен ли IndexedDB;`}),`
+`,(0,c.jsx)(t.li,{children:`query завершилась ли успешно;`}),`
+`,(0,c.jsxs)(t.li,{children:[`meta действительно `,(0,c.jsx)(t.code,{children:`persist: true`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`нет ли `,(0,c.jsx)(t.code,{children:`sessionScoped: true`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не возникла ли quota/transaction error;`}),`
+`,(0,c.jsx)(t.li,{children:`вызывается ли query через client с подключённым default persister;`}),`
+`,(0,c.jsx)(t.li,{children:`под каким dbName/system identifier открыт storage.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-после-restore-всё-равно-идёт-request`,children:`Почему после restore всё равно идёт request?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`refetchOnRestore: true`}),` обновляет восстановленную stale query. Проверьте `,(0,c.jsx)(t.code,{children:`staleTime`}),`, возраст data, buster и maxAge.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-persist-permissions`,children:`Можно ли persist permissions?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Permissions зависят от session/role. Используйте `,(0,c.jsx)(t.code,{children:`sessionScopedQueryMeta`}),` и reset при смене сессии.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`чем-sessionscopedquerymeta-отличается-от-gctime-0`,children:[`Чем `,(0,c.jsx)(t.code,{children:`sessionScopedQueryMeta`}),` отличается от `,(0,c.jsx)(t.code,{children:`gcTime: 0`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`gcTime`}),` управляет garbage collection неактивной query. Session reset является явной security/lifecycle boundary: cancel, очистка old data, refetch active query и команда другим вкладкам.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-вручную-broadcast-обычный-setquerydata`,children:[`Нужно ли вручную broadcast обычный `,(0,c.jsx)(t.code,{children:`setQueryData`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Не всегда. Установленный TanStack broadcast синхронизирует cache data. Manual event используйте только для explicit policy.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-другая-вкладка-только-стала-stale-но-не-сделала-request`,children:`Почему другая вкладка только стала stale, но не сделала request?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Automatic invalidation использует `,(0,c.jsx)(t.code,{children:`refetchType: "none"`}),`. Для немедленного remote refetch отправьте explicit invalidate event с `,(0,c.jsx)(t.code,{children:`"active"`}),` или другой подходящей policy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-broadcast-не-работает-в-другом-domain`,children:`Почему broadcast не работает в другом domain?`}),`
+`,(0,c.jsx)(t.p,{children:`BroadcastChannel ограничен одним origin и channel name.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-передавать-date-в-indexeddb`,children:`Можно ли передавать Date в IndexedDB?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Browser structured clone поддерживает `,(0,c.jsx)(t.code,{children:`Date`}),`, но убедитесь, что consumer mapping и cache contract ожидают Date после restore. Для transport/domain snapshots часто предсказуемее serializable ISO string.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-rollback-не-удалил-созданный-optimistic-item`,children:`Почему rollback не удалил созданный optimistic item?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если до mutation cache была `,(0,c.jsx)(t.code,{children:`undefined`}),`, standard context не отличает «entry отсутствовала» от undefined data и `,(0,c.jsx)(t.code,{children:`onErrorOptimistic`}),` ничего не делает. Добавьте explicit exact-key removal или заранее создайте empty cache snapshot.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`достаточно-ли-cancelqueries-для-параллельных-mutation`,children:[`Достаточно ли `,(0,c.jsx)(t.code,{children:`cancelQueries`}),` для параллельных mutation?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Оно отменяет matching queries/refetches, а не mutation. Параллельные writes требуют serialization, mutation id, patch stack или отказа от optimistic update.`}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-всегда-вызывать-onsettledoptimistic`,children:[`Нужно ли всегда вызывать `,(0,c.jsx)(t.code,{children:`onSettledOptimistic`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не механически. Выберите cache strategy. Если server response полностью записан через `,(0,c.jsx)(t.code,{children:`setQueryData`}),` и invalidation не нужна, дополнительная invalidation может быть лишней. Если server мог изменить другие fields/data, invalidation полезна.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-произойдёт-без-build-time-buster`,children:`Что произойдёт без build-time buster?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Import entrypoint может завершиться `,(0,c.jsx)(t.code,{children:`ReferenceError`}),`, потому что constant читается на верхнем уровне. Настройте host bundler `,(0,c.jsx)(t.code,{children:`define`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-очистить-channels-при-hmrtest`,children:`Как очистить channels при HMR/test?`}),`
+`,(0,c.jsx)(t.p,{children:`Сбросьте global broadcast handler, вызовите оба cleanup и очистите test QueryClient.`}),`
+`,(0,c.jsx)(t.h2,{id:`связанные-модули`,children:`Связанные модули`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),` — OData reads/mutations и TanStack integration.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/http`}),` — обычные HTTP query/mutation functions.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`}),` — чистые metadata/value/path/filter helpers.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/pwa`}),` — Service Worker update и HTTP cache policy.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/error-report`}),` — подготовка и диагностика error reports.`]}),`
+`]})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};