@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

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

@@ -0,0 +1,583 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,p:`p`,pre:`pre`,strong:`strong`,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 API/Query/Generic Resource`}),`
+`,(0,c.jsxs)(t.h1,{id:`generic-resources-через-ryuzaki13react-foundation-apiresource`,children:[`Generic resources через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/resource`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль описывает transport-agnostic ресурс поверх TanStack Query: стабильные query keys, проверку scope, произвольные read/write operations и cache strategies после mutation.`}),`
+`,(0,c.jsx)(t.h2,{id:`для-кого-этот-документ`,children:`Для кого этот документ`}),`
+`,(0,c.jsx)(t.p,{children:`Здесь термины используются так:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`resource`}),` — технически связанная группа данных, например `,(0,c.jsx)(t.code,{children:`orders`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`scope`}),` — контекст, внутри которого данные уникальны, например `,(0,c.jsx)(t.code,{children:`{ companyId }`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`query/read operation`}),` — чтение без изменения server state;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`mutation/write operation`}),` — создание/изменение/удаление;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`descriptor`}),` — объект, объединяющий identity, operations и правила доступности;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`query key`}),` — сериализуемый identity записи в TanStack Query cache.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не выполняет HTTP/OData сам. Transport находится внутри `,(0,c.jsx)(t.code,{children:`operation.execute`}),` или создаётся adapter-ом `,(0,c.jsx)(t.code,{children:`/server-fn`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`/resource`}),`, когда названия операций произвольны: `,(0,c.jsx)(t.code,{children:`search`}),`, `,(0,c.jsx)(t.code,{children:`detail`}),`, `,(0,c.jsx)(t.code,{children:`archive`}),`, `,(0,c.jsx)(t.code,{children:`recalculate`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для стандартной модели сохранённых записей `,(0,c.jsx)(t.code,{children:`list/latest/history/save/create/delete`}),` удобнее `,(0,c.jsx)(t.a,{href:`../persisted/README.mdx`,children:(0,c.jsx)(t.code,{children:`/persisted`})}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте `,(0,c.jsx)(t.code,{children:`/resource`}),`, если нужен один приватный request в одной feature и descriptor не даёт повторного использования. Абстракция полезна, когда resource имеет устойчивое имя, несколько consumers/operations и общую cache policy.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ментальная-модель`,children:`Ментальная модель`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Descriptor
+├── namespace + resource ───────────────► base query key
+├── scope policy ───────────────────────► можно ли выполнять operation
+├── query operations
+│   ├── search(args) ───────────────────► Promise<SearchResult>
+│   └── detail(args) ───────────────────► Promise<Order>
+└── mutation operations
+    ├── save(input) ────────────────────► Promise<Order>
+    └── archive(input) ─────────────────► Promise<void>
+                                            │
+                                            ▼
+                                      cache strategy
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Descriptor не хранит данные. Данные хранятся в QueryClient по keys descriptor-а.`}),`
+`,(0,c.jsx)(t.h3,{id:`что-является-identity`,children:`Что является identity`}),`
+`,(0,c.jsx)(t.p,{children:`Для query:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`namespace + resource + normalized scope + operation name + normalized args
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для mutation key:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`namespace + resource + normalized scope + operation name
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Mutation input в key не входит. Он передаётся `,(0,c.jsx)(t.code,{children:`mutationFn`}),` в момент `,(0,c.jsx)(t.code,{children:`mutate(input)`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`query-cache--server-snapshot`,children:`Query cache — server snapshot`}),`
+`,(0,c.jsx)(t.p,{children:`Query data — копия последнего известного server state. Не редактируйте её как form draft:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Нельзя: in-place mutation cache object.
+query.data.title = draftTitle;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Draft формы должен быть отдельным state. После save cache synchronizes через strategy.`}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-provider`,children:`Установка и provider`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-api @ryuzaki13/react-foundation-lib @tanstack/react-query react
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`React hooks работают только внутри `,(0,c.jsx)(t.code,{children:`QueryClientProvider`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+
+const queryClient = new QueryClient();
+
+export function App() {
+	return <QueryClientProvider client={queryClient}>{/* routes */}</QueryClientProvider>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Создайте client один раз, а не внутри render.`}),`
+`,(0,c.jsx)(t.h2,{id:`импорт`,children:`Импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	applyResourceCacheStrategy,
+	buildResourceQueryOptions,
+	composeResourceCacheStrategies,
+	createInvalidateResourceScopeCacheStrategy,
+	createResourceDescriptor,
+	createResourceKeys,
+	createResourceMutationOperation,
+	createResourceQueryOperation,
+	createSetResourceQueryDataCacheStrategy,
+	getResourceQueryData,
+	normalizeResourceKeyValue,
+	useResourceMutation,
+	useResourceQuery
+} from "@ryuzaki13/react-foundation-api/resource";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Типы экспортируются из того же subpath.`}),`
+`,(0,c.jsx)(t.h2,{id:`пошаговый-пример`,children:`Пошаговый пример`}),`
+`,(0,c.jsx)(t.h3,{id:`1-описать-scope-и-данные`,children:`1. Описать scope и данные`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type OrdersScope = {
+	companyId: string;
+};
+
+type SearchOrdersArgs = {
+	search: string;
+	limit: number;
+};
+
+type Order = {
+	id: string;
+	title: string;
+};
+
+type SaveOrderInput = {
+	id: string;
+	title: string;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`2-создать-operations`,children:`2. Создать operations`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const searchOperation = createResourceQueryOperation<
+	OrdersScope,
+	SearchOrdersArgs,
+	Order[]
+>({
+	async execute({ scope, args, signal }) {
+		const query = new URLSearchParams({
+			companyId: scope.companyId,
+			search: args.search,
+			limit: String(args.limit)
+		});
+
+		const response = await fetch(\`/api/orders?\${query}\`, { signal });
+		if (!response.ok) throw new Error(\`HTTP \${response.status}\`);
+		return response.json() as Promise<Order[]>;
+	},
+	isEnabled: (scope, args) => Boolean(scope?.companyId && args.limit > 0),
+	staleTime: 60_000,
+	gcTime: 5 * 60_000
+});
+
+const saveOperation = createResourceMutationOperation<
+	OrdersScope,
+	SaveOrderInput,
+	Order,
+	unknown
+>({
+	async execute({ scope, input }) {
+		const response = await fetch(\`/api/companies/\${scope.companyId}/orders/\${input.id}\`, {
+			method: "PUT",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(input)
+		});
+
+		if (!response.ok) throw new Error(\`HTTP \${response.status}\`);
+		return response.json() as Promise<Order>;
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Factories `,(0,c.jsx)(t.code,{children:`createResourceQueryOperation`}),` и `,(0,c.jsx)(t.code,{children:`createResourceMutationOperation`}),` не изменяют объект. Они помогают TypeScript сохранить generic types.`]}),`
+`,(0,c.jsx)(t.p,{children:`Они также не добавляют retry, validation, transport headers или cache behavior. Всё перечисленное должно быть явно в operation/adapter/QueryClient policy.`}),`
+`,(0,c.jsx)(t.h3,{id:`query-operation-contract`,children:`Query operation contract`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ResourceQueryOperation<TScope, TArgs, TResult> {
+	execute(context: {
+		scope: TScope;
+		args: TArgs;
+		client: QueryClient;
+		signal?: AbortSignal;
+	}): Promise<TResult>;
+	isEnabled?(scope: TScope | null | undefined, args: TArgs): boolean;
+	readonly staleTime?: number;
+	readonly gcTime?: number;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`client`}),` позволяет operation переиспользовать другие query snapshots или metadata. Не создавайте новый QueryClient внутри execute.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`signal`}),` нужно передавать transport-у:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const response = await fetch(url, { signal });
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`mutation-operation-contract`,children:`Mutation operation contract`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ResourceMutationOperation<TScope, TInput, TResult, TDescriptor> {
+	execute(context: {
+		scope: TScope;
+		input: TInput;
+		client: QueryClient;
+	}): Promise<TResult>;
+	readonly cacheStrategy?: ResourceCacheStrategy<
+		TScope,
+		TInput,
+		TResult,
+		TDescriptor
+	>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Generic mutation contract не содержит AbortSignal. Не обещайте automatic cancellation mutation.`}),`
+`,(0,c.jsx)(t.h3,{id:`3-создать-descriptor`,children:`3. Создать descriptor`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ordersResource = createResourceDescriptor({
+	namespace: "sales",
+	resource: "orders",
+	normalizeScope: (scope: OrdersScope | null | undefined) => ({
+		companyId: scope?.companyId.trim() ?? ""
+	}),
+	operations: {
+		queries: { search: searchOperation },
+		mutations: { save: saveOperation }
+	},
+	isEnabled: (scope) => Boolean(scope?.companyId),
+	getScopeError: () => "Не выбрана компания"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`namespace + resource`}),` должны быть устойчивыми и уникальными. Не включайте локализованные labels или случайные значения.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeScope`}),` влияет только на query key. В `,(0,c.jsx)(t.code,{children:`execute`}),` приходит исходный literal scope. Например, key получит trimmed `,(0,c.jsx)(t.code,{children:`companyId`}),`, но operation увидит строку ровно в переданном object. Это позволяет нормализовать identity, не переписывая draft/input.`]}),`
+`,(0,c.jsx)(t.h3,{id:`поля-descriptor-а`,children:`Поля descriptor-а`}),`
+`,(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.jsx)(t.code,{children:`namespace`})}),(0,c.jsxs)(t.td,{children:[`Верхний технический namespace keys, например `,(0,c.jsx)(t.code,{children:`sales`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resource`})}),(0,c.jsxs)(t.td,{children:[`Устойчивое имя resource, например `,(0,c.jsx)(t.code,{children:`orders`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`operations.queries`})}),(0,c.jsx)(t.td,{children:`Record read operations с произвольными names`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`operations.mutations`})}),(0,c.jsx)(t.td,{children:`Record write operations`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`keys`})}),(0,c.jsx)(t.td,{children:`Custom key factory или generated factory`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeScope`})}),(0,c.jsx)(t.td,{children:`Настройка generated key factory`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isEnabled`})}),(0,c.jsx)(t.td,{children:`Общая доступность resource scope`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getScopeError`})}),(0,c.jsx)(t.td,{children:`Error message для фактического execute invalid scope`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Operations можно опустить с одной стороны:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createResourceDescriptor({
+	namespace: "catalog",
+	resource: "countries",
+	operations: {
+		queries: { list: listCountriesOperation }
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`В runtime отсутствующая группа превращается в пустой object.`}),`
+`,(0,c.jsx)(t.h3,{id:`descriptor-создаётся-один-раз`,children:`Descriptor создаётся один раз`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// На уровне module — правильно.
+export const ordersResource = createResourceDescriptor(...);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не создавайте его внутри component render: descriptor и callbacks должны иметь устойчивую identity, а module-level definition проще тестировать и переиспользовать.`}),`
+`,(0,c.jsx)(t.h3,{id:`4-использовать-query-hook`,children:`4. Использовать query hook`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function OrdersList({ companyId, search }: Props) {
+	const query = useResourceQuery(
+		ordersResource,
+		"search",
+		{ companyId },
+		{ search, limit: 50 }
+	);
+
+	if (query.isPending) return <p>Загрузка…</p>;
+	if (query.isError) return <p>Ошибка загрузки</p>;
+
+	return query.data.map((order) => <div key={order.id}>{order.title}</div>);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Rules of Hooks применяются полностью: hook нельзя вызывать условно или в callback.`}),`
+`,(0,c.jsx)(t.h3,{id:`5-использовать-mutation-hook`,children:`5. Использовать mutation hook`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const mutation = useResourceMutation(
+	ordersResource,
+	"save",
+	{ companyId },
+	{
+		onSuccess(savedOrder) {
+			showSuccess(\`Сохранён \${savedOrder.title}\`);
+		}
+	}
+);
+
+mutation.mutate({ id: "42", title: "Новый заголовок" });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Mutation key содержит resource/scope/operation, но не input. Input передаётся только в `,(0,c.jsx)(t.code,{children:`mutationFn`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`несколько-одновременных-mutations`,children:`Несколько одновременных mutations`}),`
+`,(0,c.jsxs)(t.p,{children:[`Две `,(0,c.jsx)(t.code,{children:`save`}),` mutations одного scope имеют одинаковый mutation key, но разные inputs и отдельные mutation instances. Mutation key группирует operations для наблюдения/diagnostics; это не Query cache slot с data.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`scope-проверяется-при-mutate`,children:[`Scope проверяется при `,(0,c.jsx)(t.code,{children:`mutate`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook можно создать с nullable scope, но actual mutation вызовет `,(0,c.jsx)(t.code,{children:`assertResourceScope`}),`. Если scope invalid, server execute не начнётся и mutation получит error.`]}),`
+`,(0,c.jsx)(t.h2,{id:`query-lifecycle`,children:`Query lifecycle`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildResourceQueryOptions(descriptor, name, scope, args)`}),` создаёт TanStack `,(0,c.jsx)(t.code,{children:`queryOptions`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`key из `,(0,c.jsx)(t.code,{children:`descriptor.keys.operation`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`query function с `,(0,c.jsx)(t.code,{children:`{ scope, args, client, signal }`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`enabled`}),` из descriptor и operation;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`staleTime`}),`/`,(0,c.jsx)(t.code,{children:`gcTime`}),` из operation.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const options = buildResourceQueryOptions(
+	ordersResource,
+	"search",
+	{ companyId: "1000" },
+	{ search: "", limit: 50 }
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`enabled`}),` сначала проверяет `,(0,c.jsx)(t.code,{children:`descriptor.isEnabled(scope)`}),`, затем `,(0,c.jsx)(t.code,{children:`operation.isEnabled(scope, args)`}),`. Если одна проверка вернула `,(0,c.jsx)(t.code,{children:`false`}),`, React query не стартует автоматически.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Перед фактическим `,(0,c.jsx)(t.code,{children:`execute`}),` scope обязан быть не `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` и пройти descriptor policy. Иначе выбрасывается `,(0,c.jsx)(t.code,{children:`getScopeError`}),` или стандартная ошибка.`]}),`
+`,(0,c.jsx)(t.h3,{id:`критическое-правило-nullable-scope`,children:`Критическое правило nullable scope`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если scope может быть `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),`, descriptor обязан иметь `,(0,c.jsx)(t.code,{children:`isEnabled`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isEnabled: (scope) => Boolean(scope?.companyId)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Без него default enabled равен `,(0,c.jsx)(t.code,{children:`true`}),`, даже для `,(0,c.jsx)(t.code,{children:`undefined`}),`. TanStack Query попытается запустить query, а query function выбросит scope error.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Operation-level `,(0,c.jsx)(t.code,{children:`isEnabled`}),` не заменяет общую scope policy, хотя тоже может проверить scope. Хорошая структура:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isEnabled: (scope) => Boolean(scope?.companyId),
+
+// В operation:
+isEnabled: (_scope, args) => args.limit > 0 && args.search.length >= 2
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`стандартная-scope-error`,children:`Стандартная scope error`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если custom `,(0,c.jsx)(t.code,{children:`getScopeError`}),` отсутствует:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Недостаточно данных scope для ресурса 'orders'.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getScopeError`}),` вызывается только при попытке actual execution invalid scope. Возвращаемое `,(0,c.jsx)(t.code,{children:`null`}),` приводит к standard fallback из-за `,(0,c.jsx)(t.code,{children:`??`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`отсутствующая-operation`,children:`Отсутствующая operation`}),`
+`,(0,c.jsx)(t.p,{children:`При неверном runtime descriptor-е error возникает до transport:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Ресурс 'orders' не поддерживает read-операцию 'detail'.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Runtime guard проверяет object и callable `,(0,c.jsx)(t.code,{children:`execute`}),`. TypeScript обычно ловит неверное name раньше, если descriptor types сохранены.`]}),`
+`,(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.jsx)(t.p,{children:`Значения просто передаются TanStack Query:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`staleTime`}),` не является HTTP TTL;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`gcTime`}),` отсчитывается для неактивного query;`]}),`
+`,(0,c.jsx)(t.li,{children:`отсутствие значения означает default QueryClient policy;`}),`
+`,(0,c.jsx)(t.li,{children:`они не влияют на mutation.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`императивная-загрузка`,children:`Императивная загрузка`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const orders = await getResourceQueryData(
+	ordersResource,
+	"search",
+	{ companyId: "1000" },
+	{ search: "", limit: 50 },
+	queryClient
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция использует `,(0,c.jsx)(t.code,{children:`queryClient.fetchQuery`}),`, поэтому переиспользует query cache. Передавайте только валидный scope: imperative `,(0,c.jsx)(t.code,{children:`fetchQuery`}),` нельзя воспринимать как disabled React observer; query function всё равно защищает scope и может бросить ошибку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`loaderpreload`,children:`Loader/preload`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`export async function loadOrdersRoute({
+	companyId,
+	queryClient
+}: {
+	companyId: string;
+	queryClient: QueryClient;
+}) {
+	return getResourceQueryData(
+		ordersResource,
+		"search",
+		{ companyId },
+		{ search: "", limit: 50 },
+		queryClient
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Component с теми же exact inputs получит тот же query key и переиспользует snapshot.`}),`
+`,(0,c.jsx)(t.h2,{id:`query-keys`,children:`Query keys`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const keys = createResourceKeys<OrdersScope, "search" | "save">({
+	namespace: "sales",
+	resource: "orders",
+	normalizeScope: (scope) => ({ companyId: scope?.companyId ?? "" })
+});
+
+keys.all;
+// ["sales", "orders"]
+
+keys.scope({ companyId: "1000" });
+// ["sales", "orders", { companyId: "1000" }]
+
+keys.operation("search", { companyId: "1000" }, { limit: 50 });
+// ["sales", "orders", { companyId: "1000" }, "search", { limit: 50 }]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`args === undefined`}),` не добавляется в key. `,(0,c.jsx)(t.code,{children:`args === null`}),` добавляется как `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizeresourcekeyvalue`,children:(0,c.jsx)(t.code,{children:`normalizeResourceKeyValue`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализация рекурсивна:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` → `,(0,c.jsx)(t.code,{children:`null`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`string → `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`number/boolean остаются без изменения;`}),`
+`,(0,c.jsx)(t.li,{children:`array нормализуется по элементам, порядок сохраняется;`}),`
+`,(0,c.jsx)(t.li,{children:`object keys сортируются, значения нормализуются;`}),`
+`,(0,c.jsxs)(t.li,{children:[`другие значения превращаются через `,(0,c.jsx)(t.code,{children:`String(value)`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeResourceKeyValue({ b: " x ", a: undefined });
+// { a: null, b: "x" }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ограничения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Date`}),`, `,(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`}),` и class instances не имеют специальной сериализации; обычный `,(0,c.jsx)(t.code,{children:`Date`}),` превратится в `,(0,c.jsx)(t.code,{children:`{}`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`cyclic object приведёт к рекурсивной ошибке;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`NaN`}),`/`,(0,c.jsx)(t.code,{children:`Infinity`}),` остаются number, но их cache semantics могут быть неочевидны;`]}),`
+`,(0,c.jsx)(t.li,{children:`function/symbol/bigint превращаются в строки и могут collision-иться.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Нормализуйте специальные значения сами, например Date → ISO string. Query key не должен содержать secrets, DOM nodes или огромные payload.`}),`
+`,(0,c.jsx)(t.h3,{id:`дополнительные-примеры-normalization`,children:`Дополнительные примеры normalization`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeResourceKeyValue(undefined);
+// null
+
+normalizeResourceKeyValue([" a ", undefined, false]);
+// ["a", null, false]
+
+normalizeResourceKeyValue({ z: 1, a: { b: " x " } });
+// { a: { b: "x" }, z: 1 }
+
+normalizeResourceKeyValue(new Date("2026-08-21T00:00:00Z"));
+// {} — Date не поддерживается специально
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`object-key-order`,children:`Object key order`}),`
+`,(0,c.jsx)(t.p,{children:`Эти scopes создадут одинаковую normalized identity:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{ companyId: "1000", plant: "1100" }
+{ plant: "1100", companyId: "1000" }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Object keys сортируются рекурсивно. Array order при этом значим:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`["1000", "2000"] !== ["2000", "1000"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если array представляет set, отсортируйте его в `,(0,c.jsx)(t.code,{children:`normalizeScope`}),`/до args.`]}),`
+`,(0,c.jsx)(t.h3,{id:`custom-keys`,children:`Custom keys`}),`
+`,(0,c.jsxs)(t.p,{children:[`Можно передать полностью свою `,(0,c.jsx)(t.code,{children:`ResourceKeys`}),`, например для совместимости с существующей cache taxonomy. Factory обязана сохранять prefix semantics:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const keys = createResourceKeys<OrdersScope, "search" | "save">({
+	namespace: "sales-v2",
+	resource: "orders"
+});
+
+createResourceDescriptor({
+	// ...
+	keys
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не собирайте key ad hoc в cache strategy: используйте `,(0,c.jsx)(t.code,{children:`descriptor.keys`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`cache-strategies-после-mutation`,children:`Cache strategies после mutation`}),`
+`,(0,c.jsx)(t.h3,{id:`инвалидация-scope`,children:`Инвалидация scope`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const invalidateScope = createInvalidateResourceScopeCacheStrategy();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Стратегия вызывает `,(0,c.jsx)(t.code,{children:`client.invalidateQueries`}),` по `,(0,c.jsx)(t.code,{children:`descriptor.keys.scope(scope)`}),`. Все query этого resource/scope становятся stale и активные observers могут refetch.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`точечный-setquerydata`,children:[`Точечный `,(0,c.jsx)(t.code,{children:`setQueryData`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const updateDetail = createSetResourceQueryDataCacheStrategy<
+	OrdersScope,
+	SaveOrderInput,
+	Order,
+	Order[],
+	typeof ordersResource
+>({
+	getQueryKey: ({ descriptor, scope }) =>
+		descriptor.keys.operation("search", scope, { search: "", limit: 50 }),
+	update: (current = [], { result }) =>
+		current.map((order) => (order.id === result.id ? result : order))
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`update`}),` получает текущее cache data или `,(0,c.jsx)(t.code,{children:`undefined`}),`, а также descriptor/scope/input/result/client. Оно должно возвращать новое значение и не мутировать старое.`]}),`
+`,(0,c.jsx)(t.h3,{id:`композиция`,children:`Композиция`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const strategy = composeResourceCacheStrategies(
+	updateDetail,
+	invalidateScope
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Strategies выполняются последовательно в переданном порядке. Если одна бросила ошибку, следующие и custom `,(0,c.jsx)(t.code,{children:`onSuccess`}),` mutation hook не выполнятся; сама server mutation при этом уже могла успешно завершиться.`]}),`
+`,(0,c.jsx)(t.h3,{id:`override-в-hook`,children:`Override в hook`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`useResourceMutation(descriptor, "save", scope, {
+	cacheStrategy: undefined // Использовать strategy операции.
+});
+
+useResourceMutation(descriptor, "save", scope, {
+	cacheStrategy: null // Полностью отключить strategy операции.
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Переданная strategy заменяет operation strategy, а не дополняет её. Для объединения используйте `,(0,c.jsx)(t.code,{children:`composeResourceCacheStrategies`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`applyResourceCacheStrategy(strategy, context)`}),` — низкоуровневый helper для ручного применения optional strategy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`полный-cache-context`,children:`Полный cache context`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface ResourceCacheStrategyContext<TScope, TInput, TResult, TDescriptor> {
+	readonly client: QueryClient;
+	readonly descriptor: TDescriptor;
+	readonly scope: TScope;
+	readonly input: TInput;
+	readonly result: TResult;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Strategy имеет все данные для точного key/update, но не должна содержать domain network side effects. Server write уже завершён.`}),`
+`,(0,c.jsx)(t.h3,{id:`порядок-mutation-success`,children:`Порядок mutation success`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`operation.execute success
+        │
+        ▼
+resolved scope повторно проверяется
+        │
+        ▼
+selected cache strategy
+        │ await
+        ▼
+hook options.onSuccess(result, input)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`options.cacheStrategy`}),` выбирается так:`]}),`
+`,(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.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`Использовать strategy operation`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})}),(0,c.jsx)(t.td,{children:`Не выполнять strategy`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`object`}),(0,c.jsx)(t.td,{children:`Полностью заменить operation strategy`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`invalidate-или-set-data`,children:`Invalidate или set data`}),`
+`,(0,c.jsx)(t.p,{children:`Используйте invalidation, если server:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`вычисляет дополнительные fields;`}),`
+`,(0,c.jsx)(t.li,{children:`меняет сортировку/агрегации;`}),`
+`,(0,c.jsx)(t.li,{children:`write затрагивает несколько неизвестных queries.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`setQueryData`}),`, если response содержит authoritative готовую запись и точный key известен.`]}),`
+`,(0,c.jsx)(t.p,{children:`Композиция полезна, когда detail можно обновить сразу, а lists безопаснее refetch-нуть.`}),`
+`,(0,c.jsxs)(t.h3,{id:`current-data-может-быть-undefined`,children:[`Current data может быть `,(0,c.jsx)(t.code,{children:`undefined`})]}),`
+`,(0,c.jsx)(t.p,{children:`Updater обязан это учесть:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`update: (current, { result }) => {
+	if (!current) return [result];
+	return current.map((item) => item.id === result.id ? result : item);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращайте новое значение. Не делайте `,(0,c.jsx)(t.code,{children:`current.push(...)`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибка-cache-strategy-после-server-success`,children:`Ошибка cache strategy после server success`}),`
+`,(0,c.jsx)(t.p,{children:`Server mutation уже могла примениться. Если strategy бросила error:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`следующие composed strategies не выполняются;`}),`
+`,(0,c.jsxs)(t.li,{children:[`hook custom `,(0,c.jsx)(t.code,{children:`onSuccess`}),` не вызывается;`]}),`
+`,(0,c.jsx)(t.li,{children:`caller может получить rejected async lifecycle.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не повторяйте write автоматически только из-за cache error: это может создать duplicate. Разделяйте retry server operation и cache recovery.`}),`
+`,(0,c.jsx)(t.h2,{id:`transport-adapters`,children:`Transport adapters`}),`
+`,(0,c.jsx)(t.p,{children:`Generic operation может использовать:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`/http`}),` для обычного REST;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`/odata`}),` для metadata-aware SAP operation;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`/server-fn`}),` для функций `,(0,c.jsx)(t.code,{children:`{ data }`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`тестовый in-memory executor.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Resource не должен знать бизнес transport автоматически. Это позволяет одному descriptor pattern работать с разными infrastructures без смешивания contracts.`}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`key-factory`,children:`Key factory`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("нормализует scope и args", () => {
+	const key = ordersResource.keys.operation(
+		"search",
+		{ companyId: " 1000 " },
+		{ limit: 50, search: " test " }
+	);
+
+	expect(key).toEqual([
+		"sales",
+		"orders",
+		{ companyId: "1000" },
+		"search",
+		{ limit: 50, search: "test" }
+	]);
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`query-operation-context`,children:`Query operation context`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("передаёт scope, args, client и signal", async () => {
+	const execute = vi.fn().mockResolvedValue([]);
+	const operation = createResourceQueryOperation({ execute });
+	const descriptor = createResourceDescriptor({
+		namespace: "test",
+		resource: "orders",
+		operations: { queries: { list: operation } },
+		isEnabled: (scope) => Boolean(scope)
+	});
+
+	await queryClient.fetchQuery(
+		buildResourceQueryOptions(descriptor, "list", "scope-1", {})
+	);
+
+	expect(execute).toHaveBeenCalledWith(
+		expect.objectContaining({
+			scope: "scope-1",
+			args: {},
+			client: queryClient,
+			signal: expect.any(AbortSignal)
+		})
+	);
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Покройте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`nullable/invalid scope disabled;`}),`
+`,(0,c.jsx)(t.li,{children:`custom scope error при imperative execution;`}),`
+`,(0,c.jsx)(t.li,{children:`descriptor + operation enabled policies;`}),`
+`,(0,c.jsx)(t.li,{children:`missing operation runtime error;`}),`
+`,(0,c.jsx)(t.li,{children:`same normalized inputs → same key;`}),`
+`,(0,c.jsx)(t.li,{children:`meaningful inputs → different keys;`}),`
+`,(0,c.jsx)(t.li,{children:`signal передаётся query transport;`}),`
+`,(0,c.jsx)(t.li,{children:`mutation success strategy order;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),`/`,(0,c.jsx)(t.code,{children:`null`}),`/override strategy semantics;`]}),`
+`,(0,c.jsx)(t.li,{children:`setQueryData не мутирует old snapshot;`}),`
+`,(0,c.jsx)(t.li,{children:`composed strategy прекращается на error.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`descriptor-без-isenabled-при-nullable-scope`,children:[`Descriptor без `,(0,c.jsx)(t.code,{children:`isEnabled`}),` при nullable scope`]}),`
+`,(0,c.jsx)(t.p,{children:`Query будет enabled и затем упадёт на scope assertion.`}),`
+`,(0,c.jsx)(t.h3,{id:`date-прямо-в-args`,children:`Date прямо в args`}),`
+`,(0,c.jsxs)(t.p,{children:[`Default normalizer превратит Date в `,(0,c.jsx)(t.code,{children:`{}`}),`. Передавайте ISO string.`]}),`
+`,(0,c.jsx)(t.h3,{id:`нормализовать-scope-и-ожидать-изменённый-execute-input`,children:`Нормализовать scope и ожидать изменённый execute input`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeScope`}),` меняет только key identity.`]}),`
+`,(0,c.jsx)(t.h3,{id:`не-включить-args-влияющие-на-response`,children:`Не включить args, влияющие на response`}),`
+`,(0,c.jsx)(t.p,{children:`Factory включает переданный args целиком. Не прячьте server filter во внешнем closure, отсутствующем в args/key.`}),`
+`,(0,c.jsx)(t.h3,{id:`создавать-descriptor-в-render`,children:`Создавать descriptor в render`}),`
+`,(0,c.jsx)(t.p,{children:`Держите его на module boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`повторить-mutation-после-cache-error`,children:`Повторить mutation после cache error`}),`
+`,(0,c.jsx)(t.p,{children:`Server write уже мог завершиться. Восстановите cache отдельно.`}),`
+`,(0,c.jsx)(t.h3,{id:`deep-import-operation-type`,children:`Deep import operation type`}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте public subpath `,(0,c.jsx)(t.code,{children:`/resource`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-границы`,children:`Ошибки и границы`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Отсутствующая operation даёт раннюю ошибку с именем resource/operation.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Невалидный scope блокирует hook через `,(0,c.jsx)(t.code,{children:`enabled`}),`, но ручное выполнение бросает ошибку.`]}),`
+`,(0,c.jsx)(t.li,{children:`Error transport-а сохраняется TanStack Query без автоматического преобразования.`}),`
+`,(0,c.jsx)(t.li,{children:`Descriptor лучше создавать на уровне module, чтобы ссылка не менялась на каждом render.`}),`
+`,(0,c.jsx)(t.li,{children:`Args/scope должны быть сериализуемыми и описывать все данные, влияющие на query result.`}),`
+`,(0,c.jsx)(t.li,{children:`Не используйте query cache как authoritative persistent storage.`}),`
+`,(0,c.jsx)(t.li,{children:`Cache strategy выполняется только после успешной mutation.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`faq`,children:`FAQ`}),`
+`,(0,c.jsx)(t.h3,{id:`resource-сам-выполняет-http`,children:`Resource сам выполняет HTTP?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Transport находится в `,(0,c.jsx)(t.code,{children:`operation.execute`}),` или adapter factory.`]}),`
+`,(0,c.jsx)(t.h3,{id:`может-ли-scope-быть-primitive`,children:`Может ли scope быть primitive?`}),`
+`,(0,c.jsx)(t.p,{children:`Да: string/number и другие типы разрешены generic-ом. Он должен устойчиво описывать tenant/user/entity boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-args-входят-в-query-key-автоматически`,children:`Почему args входят в query key автоматически?`}),`
+`,(0,c.jsx)(t.p,{children:`Потому что разные args обычно означают разные server snapshots.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-mutation-input-не-входит-в-mutation-key`,children:`Почему mutation input не входит в mutation key?`}),`
+`,(0,c.jsx)(t.p,{children:`Mutation key описывает семейство operation, а конкретный input хранится в mutation instance execution state.`}),`
+`,(0,c.jsx)(t.h3,{id:`как-отключить-operation-cache-strategy-для-одного-hook`,children:`Как отключить operation cache strategy для одного hook?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Передать `,(0,c.jsx)(t.code,{children:`cacheStrategy: null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-без-react-hook`,children:`Можно ли использовать без React hook?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Queries — через `,(0,c.jsx)(t.code,{children:`getResourceQueryData`}),`/`,(0,c.jsx)(t.code,{children:`buildResourceQueryOptions`}),`. Для mutations public convenience API сейчас hook-oriented; operation можно orchestrate на корректной owner boundary.`]}),`
+`,(0,c.jsx)(t.h2,{id:`полный-api`,children:`Полный API`}),`
+`,(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:`Exports`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Descriptor/operations`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createResourceDescriptor`}),`, `,(0,c.jsx)(t.code,{children:`createResourceQueryOperation`}),`, `,(0,c.jsx)(t.code,{children:`createResourceMutationOperation`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Query/mutation`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`buildResourceQueryOptions`}),`, `,(0,c.jsx)(t.code,{children:`useResourceQuery`}),`, `,(0,c.jsx)(t.code,{children:`getResourceQueryData`}),`, `,(0,c.jsx)(t.code,{children:`useResourceMutation`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Keys`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`normalizeResourceKeyValue`}),`, `,(0,c.jsx)(t.code,{children:`createResourceKeys`}),`, `,(0,c.jsx)(t.code,{children:`ResourceKeyValue`}),`, `,(0,c.jsx)(t.code,{children:`ResourceKeys`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Cache`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`applyResourceCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`createInvalidateResourceScopeCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`createSetResourceQueryDataCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`composeResourceCacheStrategies`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Contracts`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ResourceQueryOperationContext`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationOperationContext`}),`, `,(0,c.jsx)(t.code,{children:`ResourceQueryOperation`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationOperation`}),`, `,(0,c.jsx)(t.code,{children:`ResourceDescriptor`}),`, `,(0,c.jsx)(t.code,{children:`CreateResourceDescriptorOptions`}),`, `,(0,c.jsx)(t.code,{children:`ResourceCacheStrategyContext`}),`, `,(0,c.jsx)(t.code,{children:`ResourceCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`UseResourceMutationOptions`}),`, `,(0,c.jsx)(t.code,{children:`ResourceSetQueryDataStrategyOptions`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Type extraction`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ResourceQueryArgs`}),`, `,(0,c.jsx)(t.code,{children:`ResourceQueryResult`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationInput`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationResult`})]})]})]})]})]})}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};